import {z} from 'zod' export type InvoiceMeta = {no: string, date: string, due_date?: string | undefined}; export type InvoiceOrganization = {name: string, email: string, phone?: string | undefined, logo?: string | undefined, street_address?: string | undefined, city?: string | undefined, state?: string | undefined, zip_code?: string | undefined, country?: string | undefined}; export type InvoiceRecipient = {name: string, email: string, phone?: string | undefined, street_address?: string | undefined, city?: string | undefined, state?: string | undefined, zip_code?: string | undefined, country?: string | undefined}; export type InvoiceItem = {id?: string | undefined, name: string, unitPrice: string, quantity: string, tax?: string | undefined, image?: string | undefined}; export type CreateInvoiceRequest = {id?: string | undefined, invoice: InvoiceMeta, from: InvoiceOrganization, recipient: InvoiceRecipient, items: Array, note?: string | undefined, is_public?: boolean | undefined}; export type CreateApiInvoicesArgs = {'Authorization-Signature': string, body: CreateInvoiceRequest}; export type CreateApiInvoicesOptions = {baseUrl?: string | undefined, Authorization?: string | undefined, fetch?: typeof fetch | undefined}; export const invoiceOrganization = z.object({name: z.string(), email: z.string(), phone: z.string().optional(), logo: z.string().optional(), street_address: z.string().optional(), city: z.string().optional(), state: z.string().optional(), zip_code: z.string().optional(), country: z.string().optional()}); export const invoiceMeta = z.object({no: z.string(), date: z.string(), due_date: z.string().optional()}); export const invoiceItem = z.object({id: z.string().optional(), name: z.string(), unitPrice: z.string(), quantity: z.string(), tax: z.string().optional(), image: z.string().optional()}); export const invoiceRecipient = z.object({name: z.string(), email: z.string(), phone: z.string().optional(), street_address: z.string().optional(), city: z.string().optional(), state: z.string().optional(), zip_code: z.string().optional(), country: z.string().optional()}); export const orderMode = z.enum(["SALE", "DEPOSIT", "REFUND", "SWAP", "FEE_CLAIM"]); export const orderStatus = z.enum(["PENDING", "EXPIRED", "FAILED", "AWAITING_PAYMENT", "OPTIMISTIC_CONFIRMED", "AWAITING_CONFIRMATION", "EXECUTING_ORDER", "COMPLETED", "REFUNDED", "PARTIAL_PAYMENT"]); export const chainID = z.union([z.literal(1), z.literal(10), z.literal(56), z.literal(137), z.literal(4663), z.literal(8453), z.literal(42161), z.literal(20000000000001), z.literal(20000000000002), z.literal(30000000000001), z.literal(30000000000002)]); export const currency = z.object({id: z.string(), chain_id: chainID, address: z.string().nullable().optional(), symbol: z.string(), name: z.string().optional(), decimals: z.number().int(), image_uri: z.string().nullable().optional(), chain_image_uri: z.string().nullable().optional(), price_usd: z.number().nullable().optional()}); export const bigInt = z.string(); export const amount = z.object({ui: z.string(), raw: bigInt, value_usd: z.number().nullable().optional()}); export const tradeType = z.enum(["EXACT_INPUT", "EXACT_OUTPUT"]); export const orderSwap = z.object({trade_type: tradeType.optional(), slippage_bps: z.number().int().nullable().optional()}); export const orderFulfillment = z.object({asset: currency.nullable().optional(), amount: amount, fiat_unit: z.string().nullable().optional(), rate_usd: z.string().nullable().optional(), recipient: z.string().nullable().optional(), custom_fee_bps: z.number().int().nullable().optional(), swap: orderSwap.nullable().optional()}); export const paymentRail = z.enum(["CRYPTO", "FIAT"]); export const quoteFees = z.object({total_fee: amount, protocol_fee: amount.nullable().optional(), custom_fee: amount.nullable().optional(), relayer_fee: amount.nullable().optional()}); export const quoteBreakdown = z.object({total: amount, base: amount, fees: quoteFees.nullable().optional(), gas: amount.nullable().optional()}); export const quoteInput = z.object({currency: currency, amount: amount, balance: amount.nullable().optional(), breakdown: quoteBreakdown.nullable().optional()}); export const quoteOutput = z.object({currency: currency, amount: amount, amount_out_minimum: amount.nullable().optional()}); export const paymentFundingTransaction = z.object({tx_hash: z.string(), amount: amount}); export const paymentFunding = z.object({required_amount: amount, received_amount: amount, remaining_amount: amount, transactions: z.array(paymentFundingTransaction)}); export const stepKind = z.enum(["deposit", "transaction", "stripe_onramp"]); export const currencyBase = z.object({address: z.string().nullable().optional(), chain_id: chainID}); export const depositStepData = z.object({deposit_address: z.string(), currency: currencyBase, amount: bigInt}); export const eVMPaymentData = z.object({from: z.string(), to: z.string(), data: z.string(), value: z.string(), chainId: chainID, maxFeePerGas: z.string().optional(), maxPriorityFeePerGas: z.string().optional()}); export const bitcoinPaymentData = z.object({transaction: z.string()}); export const solanaPaymentData = z.object({transaction: z.string()}); export const suiPaymentData = z.object({transaction: z.string()}); export const chainPaymentData = z.union([eVMPaymentData, bitcoinPaymentData, solanaPaymentData, suiPaymentData]); export const stripeOnrampCurrency = z.enum(["usd", "eur"]); export const stripeCryptoCurrency = z.enum(["usdc", "usdb", "usdsui", "usdt", "phantom_cash"]); export const stripeCryptoNetwork = z.enum(["arbitrum", "base", "bitcoin", "ethereum", "polygon", "solana", "sui", "tempo", "worldchain"]); export const stripeOnrampPaymentData = z.object({session_id: z.string().optional(), stripe_publishable_key: z.string(), status: z.string(), source_currency: stripeOnrampCurrency.nullable().optional(), destination_currency: stripeCryptoCurrency, destination_network: stripeCryptoNetwork, destination_amount: z.string(), wallet_address: z.string()}); export const paymentStep = z.object({id: z.string().optional(), purpose: z.string().optional(), status: z.string().optional(), expires_at: z.string().nullable().optional(), rail: paymentRail, kind: stepKind, action: z.string().optional(), description: z.string().optional(), data: z.union([depositStepData, chainPaymentData, stripeOnrampPaymentData]).optional()}); export const paymentRefund = z.object({address: z.string().nullable().optional(), tx_hash: z.string().nullable().optional(), reason: z.string().nullable().optional()}); export const paymentView = z.object({payment_rail: paymentRail, input: quoteInput, output: quoteOutput, funding: paymentFunding.nullable().optional(), recipient: z.string(), steps: z.array(paymentStep), expires_at: z.string(), estimated_duration_seconds: z.number().nullable().optional(), source_tx_hash: z.string().nullable().optional(), destination_tx_hash: z.string().nullable().optional(), fee_tx_hash: z.string().nullable().optional(), refund: paymentRefund.nullable().optional()}); export const metadataItems = z.object({name: z.string().nullable().optional(), description: z.string().nullable().optional(), image: z.string().nullable().optional(), quantity: z.number().int().nullable().optional(), unit_price: z.number().nullable().optional(), currency: z.string().nullable().optional()}); export const metadataRefund = z.object({name: z.string().nullable().optional(), reason: z.string().nullable().optional(), additional_info: z.string().nullable().optional(), refund_amount: z.number().nullable().optional(), currency: z.string().nullable().optional()}); export const orderMetadata = z.object({items: z.array(metadataItems).optional(), refund: metadataRefund.nullable().optional()}); export const organizationSettings = z.object({hide_footer: z.boolean().optional(), card_payments: z.boolean()}).and(z.record(z.string(), z.unknown())); export const orderResponse = z.object({id: z.string(), created_at: z.string(), updated_at: z.string(), organization_id: z.string(), mode: orderMode, status: orderStatus, fulfillment: orderFulfillment, payment: paymentView.nullable().optional(), metadata: orderMetadata.nullable().optional(), settings: organizationSettings.optional(), hosted_url: z.string()}); export const invoiceResponse = z.object({archived_at: z.string().nullable().optional(), created_at: z.string().optional(), data: z.object({from: invoiceOrganization.optional(), invoice: invoiceMeta.optional(), items: z.array(invoiceItem).optional(), recipient: invoiceRecipient.optional()}).optional(), id: z.string().optional(), order_id: z.string().optional(), orders: z.array(orderResponse).optional(), organization_id: z.string().optional(), payment_url: z.string().optional(), published_at: z.string().nullable().optional(), updated_at: z.string().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 }; /** * Create Invoice * * POST /invoices */ export const createApiInvoices = async (args: CreateApiInvoicesArgs, options?: CreateApiInvoicesOptions) => { const {baseUrl = "https://api.coinvoyage.io/v3", fetch: fetchFn = fetch, Authorization} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args['Authorization-Signature'] != null) headers.set("Authorization-Signature", String(args['Authorization-Signature'])) if (Authorization !== undefined) headers.set("Authorization", Authorization) const url = `${baseUrl.replace(/\/+$/, '')}/invoices${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(invoiceResponse, await res.json()) };