import {z} from 'zod' export type GetApiDevicesArgs = {'Finix-Version'?: string | undefined, after_cursor?: string | undefined, application_id?: string | undefined, before_cursor?: string | undefined, 'created_at.gte'?: string | undefined, 'created_at.lte'?: string | undefined, description?: string | undefined, enabled?: boolean | undefined, limit?: number | undefined, merchant_id?: string | undefined, merchant_identity_id?: string | undefined, name?: string | undefined, model?: string | undefined, 'tags.key'?: string | undefined, 'tags.value'?: string | undefined, serial_number?: string | undefined, 'updated_at.gte'?: string | undefined, 'updated_at.lte'?: string | undefined}; export type GetApiDevicesOptions = {baseUrl?: string | undefined, BasicAuth?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const page = z.object({limit: z.number().int().optional(), next_cursor: z.string().nullable().optional()}); export const id = z.string().min(1); export const createdAt = z.string(); export const updatedAt = z.string(); export const deviceConfiguration = z.object({automatic_receipt_delivery_methods: z.array(z.string()).nullable().optional(), available_receipt_methods: z.array(z.string()).nullable().optional(), allow_debit: z.boolean().optional(), allow_standalone_authorizations: z.boolean().optional(), allow_standalone_refunds: z.boolean().optional(), allow_standalone_sales: z.boolean().optional(), bypass_device_on_capture: z.boolean().nullable().optional(), check_for_duplicate_transactions: z.boolean().optional(), display_tip_on_receipt: z.boolean().optional(), idle_image_file_id: z.string().nullable().optional(), idle_message: z.string().nullable().optional(), prompt_amount_confirmation: z.boolean().optional(), prompt_for_signature: z.enum(["ALWAYS", "NEVER", "ON_NETWORK_RECOMMENDATION", "ON_THRESHOLD_AMOUNT"]).optional(), prompt_manual_entry: z.boolean().optional(), prompt_receipt_confirmation: z.boolean().optional(), prompt_tip_on_receipt: z.boolean().optional(), prompt_tip_on_screen: z.boolean().optional(), signature_threshold_amount: z.unknown(), surcharge_basis_points: z.number().int().lte(300).nullable().optional(), tipping_details: z.object({allow_custom_tip: z.boolean().optional(), fixed_options: z.array(z.unknown()).optional(), percent_options: z.array(z.unknown()).optional(), percent_tipping_threshold: z.number().int().optional()}).optional()}); export const tags = z.record(z.string(), z.unknown()).nullable(); export const device = z.object({id: id.optional(), created_at: createdAt.optional(), updated_at: updatedAt.optional(), android_version: z.string().optional(), connection: z.string().nullable().optional(), configuration: deviceConfiguration.optional(), configuration_details: deviceConfiguration.nullable().optional(), description: z.string().nullable().optional(), enabled: z.boolean().optional(), firmware_version: z.string().optional(), idle_message: z.string().nullable().optional(), idle_image_file_id: z.string().nullable().optional(), integration_mode: z.enum(["PAYMENT_APP", "SDK"]).optional(), merchant: z.string().optional(), model: z.enum(["IOS_TAP_TO_PAY", "PAX_A35", "PAX_A800", "PAX_A3700", "PAX_A920PRO", "PAX_D135", "PAX_IM30"]).optional(), name: z.string().optional(), payment_app_version: z.string().optional(), prompt_signature: z.literal("ALWAYS").optional(), serial_number: z.string().nullable().optional(), tags: tags.optional(), _links: z.object({authorizations: z.object({href: z.string().optional()}).optional(), merchant: z.object({href: z.string().optional()}).optional(), self: z.object({href: z.string().optional()}).optional(), transfers: z.object({href: z.string().optional()}).optional()}).optional()}); export const self = z.object({href: z.string().min(1).optional()}); export const next = z.object({href: z.string().optional()}); export const getApiDevicesResponse = z.object({page: page.optional(), _embedded: z.object({devices: z.array(device).optional()}).optional(), _links: z.object({self: self.optional(), next: next.optional()}).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 Devices * * GET /devices */ export const getApiDevices = async (args: GetApiDevicesArgs, options?: GetApiDevicesOptions) => { const {baseUrl = "https://finix.sandbox-payments-api.com", fetch: fetchFn = fetch, BasicAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Finix-Version'] != null) headers.set("Finix-Version", String(args['Finix-Version'])) if (args.after_cursor != null) query.append("after_cursor", String(args.after_cursor)) if (args.application_id != null) query.append("application_id", String(args.application_id)) if (args.before_cursor != null) query.append("before_cursor", String(args.before_cursor)) if (args['created_at.gte'] != null) query.append("created_at.gte", String(args['created_at.gte'])) if (args['created_at.lte'] != null) query.append("created_at.lte", String(args['created_at.lte'])) if (args.description != null) query.append("description", String(args.description)) if (args.enabled != null) query.append("enabled", String(args.enabled)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.merchant_id != null) query.append("merchant_id", String(args.merchant_id)) if (args.merchant_identity_id != null) query.append("merchant_identity_id", String(args.merchant_identity_id)) if (args.name != null) query.append("name", String(args.name)) if (args.model != null) query.append("model", String(args.model)) if (args['tags.key'] != null) query.append("tags.key", String(args['tags.key'])) if (args['tags.value'] != null) query.append("tags.value", String(args['tags.value'])) if (args.serial_number != null) query.append("serial_number", String(args.serial_number)) if (args['updated_at.gte'] != null) query.append("updated_at.gte", String(args['updated_at.gte'])) if (args['updated_at.lte'] != null) query.append("updated_at.lte", String(args['updated_at.lte'])) if (BasicAuth !== undefined) headers.set('authorization', `Basic ${btoa(`${BasicAuth.username}:${BasicAuth.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/devices${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(getApiDevicesResponse, await res.json()) };