import {z} from 'zod' export type GetApiBillingSubscriptionsSubscriptionIdTransactionsArgs = {subscription_id: string}; export type GetApiBillingSubscriptionsSubscriptionIdTransactionsOptions = {baseUrl: string, JWTAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const paymentTerms = z.object({interval: z.string(), frequency: z.number().int()}); export const billingDetails = z.object({enable_checkout: z.boolean(), payment_terms: paymentTerms, purchase_order_number: z.string().optional(), additional_information: z.string().optional()}); export const billingPeriod = z.object({starts_at: z.string(), ends_at: z.string()}); export const duration = z.object({interval: z.string(), frequency: z.number().int()}); export const moneyAmount = z.object({amount: z.string(), currency_code: z.string()}); export const quantityConstraints = z.object({minimum: z.number().int(), maximum: z.number().int()}); export const paddleBillingPrice = z.object({id: z.string(), product_id: z.string(), name: z.string().optional(), description: z.string().optional(), type: z.string().optional(), billing_cycle: duration.optional(), trial_period: duration.optional(), tax_mode: z.string().optional(), unit_price: moneyAmount, unit_price_overrides: z.array(z.object({})).optional(), quantity: quantityConstraints.optional(), status: z.string(), custom_data: z.object({}).optional(), created_at: z.string().optional(), updated_at: z.string().optional(), import_meta: z.object({}).optional()}); export const proration = z.object({rate: z.string(), billing_period: billingPeriod}); export const paddleBillingTransactionItem = z.object({price: paddleBillingPrice, quantity: z.number().int(), proration: proration.optional()}); export const paddleBillingCheckout = z.object({url: z.string().optional()}); export const paymentMethodDetails = z.object({type: z.string(), card: z.object({}).optional()}); export const transactionPayment = z.object({payment_attempt_id: z.string(), stored_payment_method_id: z.string().optional(), payment_method_id: z.string(), amount: z.string(), status: z.string(), error_code: z.unknown(), method_details: paymentMethodDetails, created_at: z.string(), captured_at: z.string().optional()}); export const paddleBillingTransactionProduct = z.object({id: z.string(), name: z.string(), description: z.string().optional(), custom_data: z.object({}).optional(), image_url: z.string().optional()}); export const transactionItemTotals = z.object({discount: z.number().int(), subtotal: z.number().int(), tax: z.number().int(), total: z.number().int()}); export const paddleBillingTransactionLineItem = z.object({price_id: z.string(), product: paddleBillingTransactionProduct, quantity: z.number().int(), totals: transactionItemTotals, unit_totals: transactionItemTotals, tax_rate: z.string().optional()}); export const transactionTotals = z.object({subtotal: z.string(), tax: z.string(), discount: z.string(), total: z.string(), grand_total: z.string(), fee: z.string().optional(), credit: z.string(), credit_to_balance: z.string(), balance: z.string(), earnings: z.string().optional(), currency_code: z.string()}); export const paddleBillingTransactionDetails = z.object({line_items: z.array(paddleBillingTransactionLineItem), totals: transactionTotals}); export const billingTransaction = z.object({id: z.string(), status: z.string(), customer_id: z.string().optional(), address_id: z.string().optional(), business_id: z.string().optional(), custom_data: z.object({}).optional(), origin: z.string(), collection_mode: z.string(), subscription_id: z.string().optional(), invoice_id: z.string().optional(), invoice_number: z.string().optional(), billing_details: billingDetails.optional(), billing_period: billingPeriod.optional(), currency_code: z.string(), discount_id: z.string().optional(), created_at: z.string(), updated_at: z.string(), billed_at: z.string().optional(), revised_at: z.string().optional(), items: z.array(paddleBillingTransactionItem), checkout: paddleBillingCheckout.optional(), payments: z.array(transactionPayment).optional(), details: paddleBillingTransactionDetails.optional()}); export const getApiBillingSubscriptionsSubscriptionIdTransactionsResponse = z.array(billingTransaction); 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 Paddle Billing transactions for a subscription * * GET /billing/subscriptions/{subscription_id}/transactions * * Also accepts auth: APIKeyAuth */ export const getApiBillingSubscriptionsSubscriptionIdTransactions = async (args: GetApiBillingSubscriptionsSubscriptionIdTransactionsArgs, options: GetApiBillingSubscriptionsSubscriptionIdTransactionsOptions) => { const {baseUrl, fetch: fetchFn = fetch, JWTAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (JWTAuth !== undefined) headers.set('authorization', `Bearer ${JWTAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/billing/subscriptions/${encodeURIComponent(String(args.subscription_id))}/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(getApiBillingSubscriptionsSubscriptionIdTransactionsResponse, await res.json()) };