import {z} from 'zod' export type GetApiQuickbooksDesktopTransactionsArgs = {'Conductor-End-User-Id': string, ids?: Array | undefined, limit?: number | undefined, cursor?: string | undefined, refNumbers?: Array | undefined, refNumberContains?: string | undefined, refNumberStartsWith?: string | undefined, refNumberEndsWith?: string | undefined, refNumberFrom?: string | undefined, refNumberTo?: string | undefined, updatedAfter?: string | undefined, updatedBefore?: string | undefined, transactionDateFrom?: string | undefined, transactionDateTo?: string | undefined, entityIds?: Array | undefined, accountIds?: Array | undefined, itemIds?: Array | undefined, classIds?: Array | undefined, transactionTypes?: (Array<'all' | 'ar_refund_credit_card' | 'bill' | 'bill_payment_check' | 'bill_payment_credit_card' | 'build_assembly' | 'charge' | 'check' | 'credit_card_charge' | 'credit_card_credit' | 'credit_memo' | 'deposit' | 'estimate' | 'inventory_adjustment' | 'invoice' | 'item_receipt' | 'journal_entry' | 'liability_adjustment' | 'paycheck' | 'payroll_liability_check' | 'purchase_order' | 'receive_payment' | 'sales_order' | 'sales_receipt' | 'sales_tax_payment_check' | 'transfer' | 'vendor_credit' | 'ytd_adjustment'>) | undefined, detailLevel?: ('all' | 'transaction_lines_only' | 'transactions_without_lines') | undefined, postingStatus?: ('either' | 'non_posting' | 'posting') | undefined, paymentStatus?: ('closed' | 'either' | 'open') | undefined, currencyIds?: Array | undefined}; export type GetApiQuickbooksDesktopTransactionsOptions = {baseUrl?: string | undefined, BearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const qbdTransaction = z.object({transactionType: z.enum(["ar_refund_credit_card", "bill", "bill_payment_check", "bill_payment_credit_card", "build_assembly", "charge", "check", "credit_card_charge", "credit_card_credit", "credit_memo", "deposit", "estimate", "inventory_adjustment", "invoice", "item_receipt", "journal_entry", "liability_adjustment", "paycheck", "payroll_liability_check", "purchase_order", "receive_payment", "sales_order", "sales_receipt", "sales_tax_payment_check", "transfer", "vendor_credit", "ytd_adjustment", "transfer_inventory", "unknown"]), transactionId: z.string().max(36), transactionLineId: z.string().max(36).nullable(), createdAt: z.string(), updatedAt: z.string(), entity: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), account: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), transactionDate: z.string(), refNumber: z.string().nullable(), amount: z.string(), currency: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), exchangeRate: z.number().nullable(), amountInHomeCurrency: z.string().nullable(), memo: z.string().nullable()}); export const getApiQuickbooksDesktopTransactionsResponse = z.object({objectType: z.literal("list"), url: z.string(), data: z.array(qbdTransaction), nextCursor: z.string().nullable(), remainingCount: z.number().nullable(), hasMore: z.boolean()}); 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 transactions * * GET /quickbooks-desktop/transactions */ export const getApiQuickbooksDesktopTransactions = async (args: GetApiQuickbooksDesktopTransactionsArgs, options?: GetApiQuickbooksDesktopTransactionsOptions) => { const {baseUrl = "https://api.conductor.is/v1", fetch: fetchFn = fetch, BearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Conductor-End-User-Id'] != null) headers.set("Conductor-End-User-Id", String(args['Conductor-End-User-Id'])) for (const item of args.ids ?? []) query.append("ids", String(item)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.cursor != null) query.append("cursor", String(args.cursor)) for (const item of args.refNumbers ?? []) query.append("refNumbers", String(item)) if (args.refNumberContains != null) query.append("refNumberContains", String(args.refNumberContains)) if (args.refNumberStartsWith != null) query.append("refNumberStartsWith", String(args.refNumberStartsWith)) if (args.refNumberEndsWith != null) query.append("refNumberEndsWith", String(args.refNumberEndsWith)) if (args.refNumberFrom != null) query.append("refNumberFrom", String(args.refNumberFrom)) if (args.refNumberTo != null) query.append("refNumberTo", String(args.refNumberTo)) if (args.updatedAfter != null) query.append("updatedAfter", String(args.updatedAfter)) if (args.updatedBefore != null) query.append("updatedBefore", String(args.updatedBefore)) if (args.transactionDateFrom != null) query.append("transactionDateFrom", String(args.transactionDateFrom)) if (args.transactionDateTo != null) query.append("transactionDateTo", String(args.transactionDateTo)) for (const item of args.entityIds ?? []) query.append("entityIds", String(item)) for (const item of args.accountIds ?? []) query.append("accountIds", String(item)) for (const item of args.itemIds ?? []) query.append("itemIds", String(item)) for (const item of args.classIds ?? []) query.append("classIds", String(item)) for (const item of args.transactionTypes ?? []) query.append("transactionTypes", String(item)) if (args.detailLevel != null) query.append("detailLevel", String(args.detailLevel)) if (args.postingStatus != null) query.append("postingStatus", String(args.postingStatus)) if (args.paymentStatus != null) query.append("paymentStatus", String(args.paymentStatus)) for (const item of args.currencyIds ?? []) query.append("currencyIds", String(item)) if (BearerAuth !== undefined) headers.set('authorization', `Bearer ${BearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/quickbooks-desktop/transactions${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(getApiQuickbooksDesktopTransactionsResponse, await res.json()) };