import {z} from 'zod' export type StartDate = string; export type EndDate = string; export type ApiId = string; export type AllocationType = 'weightedCentroid' | 'centroid'; export type VmFilterObject = {audienceType?: (Array<'visitors' | 'employees' | 'residents'>) | undefined, dwellTime?: ({operator?: ('<' | '>=') | undefined, value?: number | undefined}) | undefined, hoursRange?: {fromHour: string, toHour: string} | undefined, daysOfWeek?: Array | undefined, distance?: ({from?: ('home' | 'work') | undefined, values?: ({le?: number | undefined, ge?: number | undefined, lt?: number | undefined, gt?: number | undefined, eq?: number | undefined}) | undefined}) | undefined}; export type NearbyRadius = 100 | 250 | 500 | 750 | 1000; export type TradeAreaDemographicsRequest = {startDate: StartDate, endDate: EndDate, apiId: ApiId, method?: ('tta' | 'mileRing' | 'driveTime') | undefined, benchmarkScope?: ('nationwide' | 'state') | undefined, audienceType?: ('potential' | 'captured') | undefined, allocationType?: AllocationType | undefined, trafficVolPct?: number | undefined, driveTime?: number | undefined, withinRadius?: number | undefined, ringRadius?: number | undefined, dataset?: ('census' | 'sti_popstats' | 'sti_landscape' | 'sti_market_outlook' | 'sti_spending_patterns' | 'sti_workplace' | 'spatial_ai_personalive' | 'spatial_ai_followgraph' | 'experian_mosaic') | undefined, template?: string | undefined, filters?: VmFilterObject | undefined, nearbyRadius?: NearbyRadius | undefined}; export type CreateApiV1ReportsTradeAreaDemographicsArgs = {body: TradeAreaDemographicsRequest}; export type CreateApiV1ReportsTradeAreaDemographicsOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const requestId = z.string(); export const demographicSubGroup = z.object({value: z.number(), variableIndex: z.number().optional(), percentage: z.number().optional(), variablePercentage: z.number().optional()}); export const demographicGroupEntry = z.record(z.string(), demographicSubGroup); export const nearbyRadius = z.union([z.literal(100), z.literal(250), z.literal(500), z.literal(750), z.literal(1000)]); export const responseFilters = z.object({audienceType: z.array(z.enum(["visitors", "employees", "residents"])).optional(), dwellTime: z.object({operator: z.enum(["<", ">="]).optional(), value: z.number().int().optional()}).optional(), hoursRange: z.object({fromHour: z.string().optional(), toHour: z.string().optional()}).optional(), daysOfWeek: z.array(z.unknown()).optional(), distance: z.object({from: z.enum(["home", "work"]).optional(), values: z.object({le: z.number().optional(), ge: z.number().optional(), lt: z.number().optional(), gt: z.number().optional(), eq: z.number().optional()}).optional()}).optional()}); export const visitDurationSegmentationRespReports = z.enum(["under10Min", "10MinOrLonger", "allVisits", "mixedSegments"]).nullable(); export const apiId = z.string(); export const tradeAreaDemographicsResponse = z.object({requestId: requestId, data: z.object({nearbyRadius: nearbyRadius.optional(), filters: responseFilters.optional(), visitDurationSegmentation: visitDurationSegmentationRespReports.optional()}).and(z.record(z.string(), demographicGroupEntry)), apiId: apiId.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 }; /** * Trade Area Demographics Profile Report * * POST /v1/reports/trade-area-demographics */ export const createApiV1ReportsTradeAreaDemographics = async (args: CreateApiV1ReportsTradeAreaDemographicsArgs, options?: CreateApiV1ReportsTradeAreaDemographicsOptions) => { const {baseUrl = "https://papi.placer.ai", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (apiKey !== undefined) headers.set("x-api-key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/v1/reports/trade-area-demographics${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(tradeAreaDemographicsResponse, await res.json()) };