import {z} from 'zod' export type GetApiApiV1LiveTrackingGuildIlvlHistoryArgs = {access_key?: string | undefined, raid: 'the-unbinding-of-kithix' | 'the-venomous-abyss' | 'the-tidebound-grotto' | 'sporefall' | 'tier-mn-1' | 'manaforge-omega' | 'liberation-of-undermine' | 'nerubar-palace' | 'blackrock-depths' | 'awakened-amirdrassil-the-dreams-hope' | 'awakened-aberrus-the-shadowed-crucible' | 'awakened-vault-of-the-incarnates' | 'amirdrassil-the-dreams-hope' | 'aberrus-the-shadowed-crucible' | 'vault-of-the-incarnates' | 'fated-sepulcher-of-the-first-ones' | 'fated-sanctum-of-domination' | 'fated-castle-nathria' | 'sepulcher-of-the-first-ones' | 'sanctum-of-domination' | 'castle-nathria' | 'nyalotha-the-waking-city' | 'the-eternal-palace' | 'crucible-of-storms' | 'battle-of-dazaralor' | 'uldir' | 'antorus-the-burning-throne' | 'tomb-of-sargeras' | 'the-nighthold' | 'trial-of-valor' | 'the-emerald-nightmare' | 'latest', top_n?: number | undefined, difficulty?: ('mythic' | 'heroic' | 'normal' | 'latest') | undefined, include_pulls?: boolean | undefined, pulls_difficulty?: string | undefined, pulls_scope?: ('cohort' | 'all') | undefined, bucket?: ('15min' | 'hour' | '6hour' | 'day') | undefined, scope?: ('all' | 'mains') | undefined, min_date?: string | undefined, max_date?: string | undefined, region: 'us' | 'eu' | 'tw' | 'kr' | 'cn', realm: string, guild: string}; export type GetApiApiV1LiveTrackingGuildIlvlHistoryOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const faction = z.enum(["horde", "alliance"]); export const realmSummary = z.object({id: z.number().int(), connectedRealmId: z.number().int(), wowRealmId: z.number().int().nullable(), wowConnectedRealmId: z.number().int().nullable(), name: z.string(), altName: z.string().nullable(), slug: z.string(), altSlug: z.string(), locale: z.string().nullable(), isConnected: z.boolean(), realmType: z.string()}); export const regionSummary = z.object({name: z.string(), short_name: z.string(), slug: z.string()}); export const guildSummary = z.object({id: z.number().int(), name: z.string(), faction: faction, realm: realmSummary.optional(), region: regionSummary.optional(), path: z.string(), logo: z.string().optional(), isDefaultLogo: z.boolean().optional(), color: z.string().optional(), displayName: z.string(), alt_name: z.string().optional()}); export const raidSummary = z.object({id: z.number().int().optional(), slug: z.string().optional(), name: z.string().optional(), short_name: z.string().optional(), icon: z.string().optional(), expansion_id: z.number().int().optional()}); export const guildIlvlHistoryWindow = z.object({start: z.string().optional(), end: z.string().optional()}); export const weeklyResets = z.array(z.string()); export const guildIlvlHistoryRoster = z.object({size: z.number().int().optional(), eligible: z.number().int().optional()}); export const guildIlvlHistoryPoint = z.object({t: z.string().optional(), ilvl: z.number().optional(), sampleSize: z.number().int().optional(), p10: z.number().nullable().optional(), p90: z.number().nullable().optional(), startIlvl: z.number().nullable().optional()}); export const series = z.array(guildIlvlHistoryPoint); export const guildIlvlHistoryKill = z.object({bossSlug: z.string().optional(), bossName: z.string().optional(), bossShortName: z.string().optional(), bossIcon: z.string().optional(), bossOrdinal: z.number().int().optional(), difficulty: z.string().optional(), defeatedAt: z.string().optional(), itemLevelAvg: z.number().nullable().optional()}); export const kills = z.array(guildIlvlHistoryKill); export const cohortMemberIds = z.array(z.number().int()); export const guildIlvlHistoryPull = z.object({pullStartedAt: z.string().optional(), itemLevelAvg: z.number().optional(), numMembers: z.number().int().optional(), bossSlug: z.string().optional(), difficulty: z.string().optional(), cohortMemberIds: cohortMemberIds.optional()}); export const pulls1 = z.array(guildIlvlHistoryPull).nullable(); export const cohortMembers = z.object({}).nullable(); export const pullsError = z.object({code: z.number().int().optional(), error: z.string().optional()}).nullable(); export const guildIlvlHistoryPrivacy = z.object({shareRaidUntil: z.string().nullable().optional()}).nullable(); export const viewGuildIlvlHistoryResponse = z.object({guild: guildSummary.optional(), raid: raidSummary.optional(), window: guildIlvlHistoryWindow.optional(), raceStart: z.string().optional(), bucket: z.string().optional(), bossCount: z.number().int().optional(), difficulty: z.string().optional(), weeklyResets: weeklyResets.optional(), topN: z.number().int().optional(), scope: z.string().optional(), roster: guildIlvlHistoryRoster.optional(), series: series.optional(), kills: kills.optional(), pulls: pulls1.optional(), cohortMembers: cohortMembers.optional(), cohortUnavailable: z.boolean().optional(), pullsError: pullsError.optional(), guildPrivacy: guildIlvlHistoryPrivacy.optional(), widgetVersion: 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 }; /** * Retrieve a guild's average item level over time during a raid tier, reconstructed from armory and combat-log observations for the top N geared roster characters. Optionally overlay the logged per-pull raid group item level. * * GET /api/v1/live-tracking/guild/ilvl-history */ export const getApiApiV1LiveTrackingGuildIlvlHistory = async (args: GetApiApiV1LiveTrackingGuildIlvlHistoryArgs, options?: GetApiApiV1LiveTrackingGuildIlvlHistoryOptions) => { const {baseUrl = "http://raider.io", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.access_key != null) query.append("access_key", String(args.access_key)) if (args.raid != null) query.append("raid", String(args.raid)) if (args.top_n != null) query.append("top_n", String(args.top_n)) if (args.difficulty != null) query.append("difficulty", String(args.difficulty)) if (args.include_pulls != null) query.append("include_pulls", String(args.include_pulls)) if (args.pulls_difficulty != null) query.append("pulls_difficulty", String(args.pulls_difficulty)) if (args.pulls_scope != null) query.append("pulls_scope", String(args.pulls_scope)) if (args.bucket != null) query.append("bucket", String(args.bucket)) if (args.scope != null) query.append("scope", String(args.scope)) if (args.min_date != null) query.append("min_date", String(args.min_date)) if (args.max_date != null) query.append("max_date", String(args.max_date)) if (args.region != null) query.append("region", String(args.region)) if (args.realm != null) query.append("realm", String(args.realm)) if (args.guild != null) query.append("guild", String(args.guild)) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/live-tracking/guild/ilvl-history${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(viewGuildIlvlHistoryResponse, await res.json()) };