import {z} from 'zod' export type StartDate = string; export type EndDate = string; export type ApiId = string; 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 VisitsFrequencyRequest = {startDate: StartDate, endDate: EndDate, apiId: ApiId, filter?: VmFilterObject | undefined, nearbyRadius?: NearbyRadius | undefined}; export type CreateApiV1ReportsLoyaltyVisitsFrequencyArgs = {body: VisitsFrequencyRequest}; export type CreateApiV1ReportsLoyaltyVisitsFrequencyOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const requestId = z.string(); export const startDate = z.string(); export const endDate = z.string(); export const apiId = z.string(); 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 visitsFrequencyResponse = z.object({requestId: requestId, data: z.object({startDate: startDate, endDate: endDate, apiId: apiId, avgVisitsPerCustomer: z.number().optional(), medianVisitsPerCustomer: z.number().int().optional(), bins: z.array(z.number().int()).optional(), visitors: z.array(z.number().int()).optional(), visitorsPercentage: z.array(z.number()).optional(), visits: z.array(z.number().int()).optional(), visitsPercentage: z.array(z.number()).optional(), nearbyRadius: nearbyRadius.optional()}).optional(), filters: responseFilters.optional(), visitDurationSegmentation: visitDurationSegmentationRespReports.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 }; /** * Visits by Frequency Report * * POST /v1/reports/loyalty/visits-frequency */ export const createApiV1ReportsLoyaltyVisitsFrequency = async (args: CreateApiV1ReportsLoyaltyVisitsFrequencyArgs, options?: CreateApiV1ReportsLoyaltyVisitsFrequencyOptions) => { 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/loyalty/visits-frequency${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(visitsFrequencyResponse, await res.json()) };