import {z} from 'zod' export type GetApiV1HouseholdsArgs = {book_id?: string | undefined, household_type?: ('client' | 'prospect' | 'past_client') | undefined, type?: ('client' | 'prospect' | 'past_client') | undefined, updated_since?: string | undefined, email?: string | undefined, phone?: string | undefined, name?: string | undefined, page?: number | undefined, per_page?: number | undefined}; export type GetApiV1HouseholdsOptions = {baseUrl?: string | undefined, bearer?: string | undefined, fetch?: typeof fetch | undefined}; export const email = z.object({email: z.string(), email_type: z.enum(["personal", "business", "school", "other", "inactive"]), is_primary: z.boolean(), id: z.string().optional()}); export const phoneNumber = z.object({phone_number: z.string(), extension: z.string().nullable().optional(), phone_type: z.enum(["mobile", "work", "home", "fax", "other"]), is_primary: z.boolean(), id: z.string().optional()}); export const address = z.object({line1: z.string().nullable().optional(), line2: z.string().nullable().optional(), city: z.string().nullable().optional(), state: z.string().nullable().optional(), zip: z.string().nullable().optional(), country_code: z.string().nullable().optional(), address_type: z.enum(["home", "work", "mailing", "other"]), is_primary: z.boolean(), id: z.string().optional()}); export const employment = z.object({id: z.string().optional(), person_id: z.string().optional(), business_id: z.string().nullable().optional(), business_name: z.string(), role: z.string().nullable().optional(), start_date: z.string().nullable().optional(), end_date: z.string().nullable().optional(), actively_employed: z.boolean().optional()}); export const person = z.object({id: z.string(), book_id: z.string(), household_id: z.string().nullable().optional(), contact_id: z.string().nullable().optional(), role_type: z.enum(["client", "prospect", "contact", "past_client"]).nullable().optional(), created_at: z.string(), updated_at: z.string(), first_name: z.string(), middle_name: z.string().nullable().optional(), last_name: z.string(), salutation: z.string().nullable().optional(), suffix: z.string().nullable().optional(), maiden_name: z.string().nullable().optional(), gender: z.enum(["female", "male", "nonbinary", "other", "prefer_not_to_say"]).nullable().optional(), designations: z.string().nullable().optional(), household_role: z.enum(["head_of_household", "partner", "spouse", "dependent_child", "other_adult", "other_dependent", "unknown", "deceased", "non_dependent_child", "grandchild"]).nullable().optional(), preferred_name: z.string().nullable().optional(), date_of_birth: z.string().nullable().optional(), date_of_death: z.string().nullable().optional(), job_title: z.string().nullable().optional(), ssn: z.string().nullable().optional(), drivers_license_number: z.string().nullable().optional(), email_addresses: z.array(email).optional(), phone_numbers: z.array(phoneNumber).optional(), addresses: z.array(address).optional(), employments: z.array(employment).optional(), custom_fields: z.object({}).optional()}); export const household = z.object({id: z.string(), type: z.enum(["Client", "Prospect", "PastClient"]), name: z.string(), tier: z.string().nullable().optional(), became_client_at: z.string().nullable().optional(), book_id: z.string(), profile_picture_url: z.string().nullable().optional(), custom_fields: z.object({}).optional(), people: z.array(person), tags: z.array(z.object({id: z.string().optional(), name: z.string().optional()})).optional()}); export const getApiV1HouseholdsResponse = z.object({data: z.array(household), pagination: z.object({current_page: z.number().int().optional(), total_pages: z.number().int().optional(), total_count: z.number().int().optional(), per_page: 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 }; /** * List all households * * GET /v1/households */ export const getApiV1Households = async (args: GetApiV1HouseholdsArgs, options?: GetApiV1HouseholdsOptions) => { const {baseUrl = "https://api.slant.app", fetch: fetchFn = fetch, bearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.book_id != null) query.append("book_id", String(args.book_id)) if (args.household_type != null) query.append("household_type", String(args.household_type)) if (args.type != null) query.append("type", String(args.type)) if (args.updated_since != null) query.append("updated_since", String(args.updated_since)) if (args.email != null) query.append("email", String(args.email)) if (args.phone != null) query.append("phone", String(args.phone)) if (args.name != null) query.append("name", String(args.name)) if (args.page != null) query.append("page", String(args.page)) if (args.per_page != null) query.append("per_page", String(args.per_page)) if (bearer !== undefined) headers.set('authorization', `Bearer ${bearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/households${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(getApiV1HouseholdsResponse, await res.json()) };