import {z} from 'zod' export type CreateApiV1BillingAttachArgs = {'x-api-version': string, body: {customer_id: string, entity_id?: string | undefined, plan_id: string, feature_quantities?: (Array<{feature_id: string, quantity?: number | undefined, adjustable?: boolean | undefined}>) | undefined, version?: number | undefined, customize?: ({price?: ({amount: number, interval: 'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined, additional_currencies?: Array<{currency: string, amount: number}> | undefined} | null) | undefined, items?: (Array<{feature_id: string, included?: number | undefined, unlimited?: boolean | undefined, reset?: ({interval: 'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined}) | undefined, price?: ({amount?: number | undefined, additional_currencies?: Array<{currency: string, amount: number}> | undefined, tiers?: (Array<{to: number | 'inf', amount?: number | undefined, flat_amount?: number | undefined, additional_currencies?: (Array<{currency: string, amount?: number | undefined, flat_amount?: number | undefined}>) | undefined}>) | undefined, tier_behavior?: ('graduated' | 'volume') | undefined, interval: 'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined, billing_units?: number | undefined, billing_method: 'prepaid' | 'usage_based', max_purchase?: (number | null) | undefined}) | undefined, proration?: ({on_increase: 'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle', on_decrease: 'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'}) | undefined, rollover?: ({max?: number | undefined, max_percentage?: number | undefined, expiry_duration_type: 'month' | 'forever', expiry_duration_length?: number | undefined}) | undefined}>) | undefined, add_items?: (Array<{feature_id: string, included?: number | undefined, unlimited?: boolean | undefined, reset?: ({interval: 'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined}) | undefined, price?: ({amount?: number | undefined, additional_currencies?: Array<{currency: string, amount: number}> | undefined, tiers?: (Array<{to: number | 'inf', amount?: number | undefined, flat_amount?: number | undefined, additional_currencies?: (Array<{currency: string, amount?: number | undefined, flat_amount?: number | undefined}>) | undefined}>) | undefined, tier_behavior?: ('graduated' | 'volume') | undefined, interval: 'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined, billing_units?: number | undefined, billing_method: 'prepaid' | 'usage_based', max_purchase?: (number | null) | undefined}) | undefined, proration?: ({on_increase: 'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle', on_decrease: 'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'}) | undefined, rollover?: ({max?: number | undefined, max_percentage?: number | undefined, expiry_duration_type: 'month' | 'forever', expiry_duration_length?: number | undefined}) | undefined}>) | undefined, remove_items?: (Array<{feature_id?: string | undefined, billing_method?: ('prepaid' | 'usage_based') | undefined, interval?: ('one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year' | 'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year') | undefined, interval_count?: number | undefined}>) | undefined, free_trial?: ({duration_length: number, duration_type?: ('day' | 'month' | 'year') | undefined, card_required?: boolean | undefined, on_end?: ('bill' | 'revert') | undefined} | null) | undefined, billing_controls?: ({auto_topups?: (Array<{feature_id: string, enabled?: boolean | undefined, threshold: number, quantity: number, purchase_limit?: ({interval: 'hour' | 'day' | 'week' | 'month', interval_count?: number | undefined, limit: number, count?: number | undefined}) | undefined, invoice_mode?: boolean | undefined}>) | undefined, spend_limits?: (Array<{feature_id?: string | undefined, enabled?: boolean | undefined, limit_type?: ('absolute' | 'usage_percentage') | undefined, overage_limit?: number | undefined, skip_overage_billing?: boolean | undefined}>) | undefined, usage_limits?: (Array<{feature_id: string, enabled?: boolean | undefined, limit: number, interval: 'day' | 'week' | 'month' | 'year', filter?: ({properties: {[key: string]: string | number | boolean}}) | undefined}>) | undefined, usage_alerts?: (Array<{feature_id?: string | undefined, enabled?: boolean | undefined, threshold: number, threshold_type: 'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage', name?: string | undefined}>) | undefined, overage_allowed?: (Array<{feature_id: string, enabled?: boolean | undefined}>) | undefined}) | undefined, upsert_licenses?: (Array<{license_plan_id: string, included?: number | undefined, prepaid_only?: boolean | undefined, customize?: ({price?: ({amount: number, interval: 'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined, additional_currencies?: Array<{currency: string, amount: number}> | undefined} | null) | undefined, add_items?: (Array<{feature_id: string, included?: number | undefined, unlimited?: boolean | undefined, reset?: ({interval: 'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined}) | undefined, price?: ({amount?: number | undefined, additional_currencies?: Array<{currency: string, amount: number}> | undefined, tiers?: (Array<{to?: (unknown | unknown) | undefined, amount?: number | undefined, flat_amount?: number | undefined, additional_currencies?: Array | undefined}>) | undefined, tier_behavior?: ('graduated' | 'volume') | undefined, interval: 'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year', interval_count?: number | undefined, billing_units?: number | undefined, billing_method: 'prepaid' | 'usage_based', max_purchase?: (number | null) | undefined}) | undefined, proration?: ({on_increase: 'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle', on_decrease: 'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'}) | undefined, rollover?: ({max?: number | undefined, max_percentage?: number | undefined, expiry_duration_type: 'month' | 'forever', expiry_duration_length?: number | undefined}) | undefined}>) | undefined, remove_items?: (Array<{feature_id?: string | undefined, billing_method?: ('prepaid' | 'usage_based') | undefined, interval?: ('one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year' | 'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year') | undefined, interval_count?: number | undefined}>) | undefined} | null) | undefined, metadata?: {[key: string]: unknown} | undefined}>) | undefined}) | undefined, invoice_mode?: ({enabled: boolean, enable_plan_immediately?: boolean | undefined, finalize?: boolean | undefined, invoice_template_id?: string | undefined, net_terms_days?: number | undefined}) | undefined, proration_behavior?: ('prorate_immediately' | 'none') | undefined, redirect_mode?: ('always' | 'if_required' | 'never') | undefined, subscription_id?: string | undefined, discounts?: (Array<{reward_id?: string | undefined, promotion_code?: string | undefined}>) | undefined, success_url?: string | undefined, new_billing_subscription?: boolean | undefined, billing_cycle_anchor?: 'now' | undefined, plan_schedule?: ('immediate' | 'end_of_cycle') | undefined, starts_at?: number | undefined, ends_at?: number | undefined, checkout_session_params?: {[key: string]: unknown} | undefined, long_lived_checkout?: boolean | undefined, custom_line_items?: Array<{amount: number, description: string}> | undefined, processor_subscription_id?: string | undefined, carry_over_balances?: ({enabled: boolean, feature_ids?: Array | undefined}) | undefined, carry_over_usages?: ({enabled: boolean, feature_ids?: Array | undefined}) | undefined, license_quantities?: Array<{license_plan_id: string, quantity: number}> | undefined, metadata?: {[key: string]: string} | undefined, no_billing_changes?: boolean | undefined, enable_plan_immediately?: boolean | undefined, tax_rate_id?: string | undefined, currency?: string | undefined}}; export type CreateApiV1BillingAttachOptions = {baseUrl?: string | undefined, secretKey?: string | undefined, fetch?: typeof fetch | undefined}; export const createApiV1BillingAttachResponse = z.object({customer_id: z.string(), entity_id: z.string().optional(), invoice: z.object({status: z.string().nullable(), stripe_id: z.string(), total: z.number(), currency: z.string(), hosted_invoice_url: z.string().nullable()}).optional(), payment_url: z.string().nullable(), required_action: z.object({code: z.enum(["3ds_required", "payment_method_required", "payment_failed", "payment_processing"]), reason: 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 }; /** * Attaches a plan to a customer. Handles new subscriptions, upgrades and downgrades. * * POST /v1/billing.attach */ export const createApiV1BillingAttach = async (args: CreateApiV1BillingAttachArgs, options?: CreateApiV1BillingAttachOptions) => { const {baseUrl = "https://api.useautumn.com", fetch: fetchFn = fetch, secretKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args['x-api-version'] != null) headers.set("x-api-version", String(args['x-api-version'])) if (secretKey !== undefined) headers.set('authorization', `Bearer ${secretKey}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/billing.attach${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(createApiV1BillingAttachResponse, await res.json()) };