import {z} from 'zod' export type BillingSubscriptionItem = {price_id: string, quantity?: number | undefined}; export type BillingSubscriptionUpdate = {items: Array}; export type CreateApiBillingSubscriptionsSubscriptionIdPreviewArgs = {subscription_id: string, body: BillingSubscriptionUpdate}; export type CreateApiBillingSubscriptionsSubscriptionIdPreviewOptions = {baseUrl: string, JWTAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const paddleBillingSubscriptionStatus = z.enum(["active", "canceled", "past_due", "paused", "trialing"]); 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 paddleBillingProduct = z.object({id: z.string(), name: z.string(), type: z.string().optional(), tax_category: z.string().optional(), description: z.string().optional(), image_url: z.string().optional(), custom_data: z.object({}).optional(), status: z.string(), created_at: z.string().optional(), updated_at: z.string().optional(), import_meta: z.object({}).optional()}); export const paddleBillingSubscriptionItem = z.object({status: z.string(), quantity: z.number().int(), price: paddleBillingPrice, product: paddleBillingProduct, recurring: z.boolean().optional(), trial_dates: z.object({}).optional(), created_at: z.string().optional(), updated_at: z.string().optional(), next_billed_at: z.string().optional(), previously_billed_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 subscriptionUpdateTransaction = z.object({billing_period: billingPeriod, details: paddleBillingTransactionDetails}); export const billingTransactionPreview = z.object({id: z.string(), status: paddleBillingSubscriptionStatus, customer_id: z.string(), currency_code: z.string(), created_at: z.string(), updated_at: z.string(), started_at: z.string().optional(), first_billed_at: z.string().optional(), next_billed_at: z.string().optional(), paused_at: z.string().optional(), canceled_at: z.string().optional(), collection_mode: z.string().optional(), billing_details: z.object({}).optional(), current_billing_period: billingPeriod.optional(), billing_cycle: duration.optional(), scheduled_change: z.object({}).optional(), items: z.array(paddleBillingSubscriptionItem), custom_data: z.object({}).optional(), immediate_transaction: subscriptionUpdateTransaction.optional(), next_transaction: subscriptionUpdateTransaction.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 }; /** * Preview a Paddle Billing subscription transaction * * POST /billing/subscriptions/{subscription_id}/preview * * Also accepts auth: APIKeyAuth */ export const createApiBillingSubscriptionsSubscriptionIdPreview = async (args: CreateApiBillingSubscriptionsSubscriptionIdPreviewArgs, options: CreateApiBillingSubscriptionsSubscriptionIdPreviewOptions) => { const {baseUrl, fetch: fetchFn = fetch, JWTAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (JWTAuth !== undefined) headers.set('authorization', `Bearer ${JWTAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/billing/subscriptions/${encodeURIComponent(String(args.subscription_id))}/preview${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(billingTransactionPreview, await res.json()) };