import {z} from 'zod' export type GetApiV1IndexesIndexArgs = {index: string, limit?: number | undefined, offset?: number | undefined}; export type GetApiV1IndexesIndexOptions = {baseUrl?: string | undefined, ApiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const listingNotice = z.object({status: z.string().nullable().optional(), ticker: z.string().nullable().optional(), delistedOn: z.string().nullable().optional(), successorTicker: z.string().nullable().optional()}); export const indexConstituentDto = z.object({rank: z.number().int().optional(), ticker: z.string().nullable().optional(), name: z.string().nullable().optional(), isLinked: z.boolean().optional(), weight: z.number().optional(), fundShares: z.number().nullable().optional(), fundValueUsd: z.number().nullable().optional()}); export const pageMeta = z.object({limit: z.number().int().optional(), offset: z.number().int().optional(), count: z.number().int().optional(), hasMore: z.boolean().optional(), total: z.number().int().nullable().optional()}); export const indexConstituentsPagedResponse = z.object({slug: z.string().nullable().optional(), name: z.string().nullable().optional(), asOfDate: z.string().nullable().optional(), source: z.string().nullable().optional(), isDaily: z.boolean().optional(), constituentCount: z.number().int().optional(), unlinkedCount: z.number().int().optional(), listingNotice: listingNotice.optional(), data: z.array(indexConstituentDto).nullable().optional(), meta: pageMeta.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 }; /** * One index's current constituent list, heaviest first, with the fund and filing it came from. fundShares and fundValueUsd size the TRACKING FUND's position, never the company. Rows that could not be matched to a tracked company keep the name the fund reported and carry isLinked=false rather than being dropped. * * GET /v1/indexes/{index} */ export const getApiV1IndexesIndex = async (args: GetApiV1IndexesIndexArgs, options?: GetApiV1IndexesIndexOptions) => { const {baseUrl = "https://api.equibles.com", fetch: fetchFn = fetch, ApiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.limit != null) query.append("limit", String(args.limit)) if (args.offset != null) query.append("offset", String(args.offset)) if (ApiKey !== undefined) headers.set('authorization', `Bearer ${ApiKey}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/indexes/${encodeURIComponent(String(args.index))}${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(indexConstituentsPagedResponse, await res.json()) };