import {z} from 'zod' export type EntryTypes = 'Nothing' | 'Album' | 'Artist' | 'DiscussionTopic' | 'PV' | 'ReleaseEvent' | 'ReleaseEventSeries' | 'Song' | 'SongList' | 'Tag' | 'User' | 'Venue'; export type EntryStatus = 'Draft' | 'Finished' | 'Approved' | 'Locked'; export type EntrySortRule = 'None' | 'Name' | 'AdditionDate' | 'ActivityDate'; export type NameMatchMode = 'Auto' | 'Partial' | 'StartsWith' | 'Exact' | 'Words'; export type EntryOptionalFields = 'None' | 'AdditionalNames' | 'Description' | 'MainPicture' | 'Names' | 'PVs' | 'Tags' | 'WebLinks'; export type ContentLanguagePreference = 'Default' | 'Japanese' | 'Romaji' | 'English'; export type GetApiApiEntriesArgs = {query?: string | undefined, 'tagName[]'?: Array | undefined, 'tagId[]'?: Array | undefined, childTags?: boolean | undefined, entryTypes?: EntryTypes | undefined, status?: EntryStatus | undefined, start?: number | undefined, maxResults?: number | undefined, getTotalCount?: boolean | undefined, sort?: EntrySortRule | undefined, nameMatchMode?: NameMatchMode | undefined, fields?: EntryOptionalFields | undefined, lang?: ContentLanguagePreference | undefined}; export type GetApiApiEntriesOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const artistType = z.enum(["Unknown", "Circle", "Label", "Producer", "Animator", "Illustrator", "Lyricist", "Vocaloid", "UTAU", "CeVIO", "OtherVoiceSynthesizer", "OtherVocalist", "OtherGroup", "OtherIndividual", "Utaite", "Band", "Vocalist", "Character", "SynthesizerV", "CoverArtist", "NEUTRINO", "VoiSona", "NewType", "Voiceroid", "Instrumentalist", "Designer", "VOICEVOX", "ACEVirtualSinger", "AIVOICE"]); export const contentLanguageSelection = z.enum(["Unspecified", "Japanese", "Romaji", "English"]); export const discType = z.enum(["Unknown", "Album", "Single", "EP", "SplitAlbum", "Compilation", "Video", "Artbook", "Game", "Fanmade", "Instrumental", "Other", "Drama"]); export const entryType = z.enum(["Undefined", "Album", "Artist", "DiscussionTopic", "PV", "ReleaseEvent", "ReleaseEventSeries", "Song", "SongList", "Tag", "User", "Venue"]); export const eventCategory = z.enum(["Unspecified", "AlbumRelease", "Anniversary", "Club", "Concert", "Contest", "Convention", "Other", "Festival"]); export const entryThumbForApiContract = z.object({mime: z.string().nullable().optional(), name: z.string().nullable().optional(), urlOriginal: z.string().nullable().optional(), urlSmallThumb: z.string().nullable().optional(), urlThumb: z.string().nullable().optional(), urlTinyThumb: z.string().nullable().optional()}); export const localizedStringContract = z.object({language: contentLanguageSelection.optional(), value: z.string().nullable().optional()}); export const pVExtendedMetadata = z.object({json: z.string().nullable().optional()}); export const pVService = z.enum(["NicoNicoDouga", "Youtube", "SoundCloud", "Vimeo", "Piapro", "Bilibili", "File", "LocalFile", "Creofuga", "Bandcamp"]); export const pVType = z.enum(["Original", "Reprint", "Other"]); export const pVContract = z.object({author: z.string().nullable().optional(), createdBy: z.number().int().nullable().optional(), description: z.string().nullable().optional(), disabled: z.boolean().optional(), extendedMetadata: pVExtendedMetadata.optional(), id: z.number().int().optional(), length: z.number().int().optional(), name: z.string().nullable().optional(), publishDate: z.string().nullable().optional(), pvId: z.string().nullable().optional(), service: pVService.optional(), pvType: pVType.optional(), thumbUrl: z.string().nullable().optional(), url: z.string().nullable().optional()}); export const songListFeaturedCategory = z.enum(["Nothing", "Concerts", "VocaloidRanking", "Pools", "Other"]); export const songType = z.enum(["Unspecified", "Original", "Remaster", "Remix", "Cover", "Arrangement", "Instrumental", "Mashup", "MusicPV", "DramaPV", "Live", "Illustration", "Other", "Rearrangement", "ShortVersion"]); export const entryStatus = z.enum(["Draft", "Finished", "Approved", "Locked"]); export const tagBaseContract = z.object({additionalNames: z.string().nullable().optional(), categoryName: z.string().nullable().optional(), id: z.number().int().optional(), name: z.string().nullable().optional(), urlSlug: z.string().nullable().optional()}); export const tagUsageForApiContract = z.object({count: z.number().int().optional(), tag: tagBaseContract.optional()}); export const webLinkCategory = z.enum(["Official", "Commercial", "Reference", "Other"]); export const archivedWebLinkContract = z.object({category: webLinkCategory.optional(), description: z.string().nullable().optional(), disabled: z.boolean().optional(), url: z.string().nullable().optional()}); export const entryForApiContract = z.object({activityDate: z.string().nullable().optional(), additionalNames: z.string().nullable().optional(), artistString: z.string().nullable().optional(), artistType: artistType.optional(), createDate: z.string().optional(), defaultName: z.string().nullable().optional(), defaultNameLanguage: contentLanguageSelection.optional(), description: z.string().nullable().optional(), discType: discType.optional(), entryType: entryType.optional(), eventCategory: eventCategory.optional(), id: z.number().int().optional(), mainPicture: entryThumbForApiContract.optional(), name: z.string().nullable().optional(), names: z.array(localizedStringContract).nullable().optional(), pvs: z.array(pVContract).nullable().optional(), songListFeaturedCategory: songListFeaturedCategory.optional(), songType: songType.optional(), status: entryStatus.optional(), releaseEventSeriesName: z.string().nullable().optional(), tagCategoryName: z.string().nullable().optional(), tags: z.array(tagUsageForApiContract).nullable().optional(), urlSlug: z.string().nullable().optional(), version: z.number().int().optional(), webLinks: z.array(archivedWebLinkContract).nullable().optional()}); export const entryForApiContractPartialFindResult = z.object({items: z.array(entryForApiContract).nullable().optional(), term: z.string().nullable().optional(), totalCount: z.number().int().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * GET /api/entries */ export const getApiApiEntries = async (args: GetApiApiEntriesArgs, options: GetApiApiEntriesOptions) => { const {baseUrl, fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.query != null) query.append("query", String(args.query)) for (const item of args['tagName[]'] ?? []) query.append("tagName[]", String(item)) for (const item of args['tagId[]'] ?? []) query.append("tagId[]", String(item)) if (args.childTags != null) query.append("childTags", String(args.childTags)) if (args.entryTypes != null) query.append("entryTypes", String(args.entryTypes)) if (args.status != null) query.append("status", String(args.status)) if (args.start != null) query.append("start", String(args.start)) if (args.maxResults != null) query.append("maxResults", String(args.maxResults)) if (args.getTotalCount != null) query.append("getTotalCount", String(args.getTotalCount)) if (args.sort != null) query.append("sort", String(args.sort)) if (args.nameMatchMode != null) query.append("nameMatchMode", String(args.nameMatchMode)) if (args.fields != null) query.append("fields", String(args.fields)) if (args.lang != null) query.append("lang", String(args.lang)) const url = `${baseUrl.replace(/\/+$/, '')}/api/entries${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(entryForApiContractPartialFindResult, await res.json()) };