import {z} from 'zod' export type CreateApiV1BillingPreviewMultiUpdateArgs = {'x-api-version': string, body: {customer_id: string, entity_id?: string | undefined, updates: Array<{plan_id?: string | undefined, subscription_id?: string | undefined, entity_id?: string | undefined, cancel_action: 'cancel_immediately' | 'cancel_end_of_cycle' | 'uncancel', proration_behavior?: ('prorate_immediately' | 'none') | undefined}>}}; export type CreateApiV1BillingPreviewMultiUpdateOptions = {baseUrl?: string | undefined, secretKey?: string | undefined, fetch?: typeof fetch | undefined}; export const plan = z.object({id: z.string(), name: z.string(), description: z.string().nullable(), group: z.string().nullable(), version: z.number(), add_on: z.boolean(), auto_enable: z.boolean(), price: z.object({amount: z.number(), additional_currencies: z.array(z.object({currency: z.string(), amount: z.number()})).optional(), interval: z.enum(["one_off", "week", "month", "quarter", "semi_annual", "year"]), interval_count: z.number().optional(), display: z.object({primary_text: z.string(), secondary_text: z.string().optional()}).optional()}).nullable(), items: z.array(z.object({feature_id: z.string(), feature: z.object({id: z.string(), name: z.string().nullable().optional(), type: z.enum(["static", "boolean", "single_use", "continuous_use", "credit_system", "ai_credit_system"]), display: z.object({singular: z.string(), plural: z.string()}).nullable().optional(), credit_schema: z.array(z.object({metered_feature_id: z.string(), credit_cost: z.number()})).nullable().optional(), archived: z.boolean().nullable().optional()}).optional(), included: z.number(), unlimited: z.boolean(), reset: z.object({interval: z.enum(["one_off", "minute", "hour", "day", "week", "month", "quarter", "semi_annual", "year"]), interval_count: z.number().optional()}).nullable(), price: z.object({amount: z.number().optional(), additional_currencies: z.array(z.object({currency: z.string(), amount: z.number()})).optional(), tiers: z.array(z.object({to: z.union([z.number(), z.literal("inf")]), amount: z.number(), flat_amount: z.number().optional(), additional_currencies: z.array(z.object({currency: z.string(), amount: z.number().optional(), flat_amount: z.number().optional()})).optional()})).optional(), tier_behavior: z.enum(["graduated", "volume"]).optional(), interval: z.enum(["one_off", "week", "month", "quarter", "semi_annual", "year"]), interval_count: z.number().optional(), billing_units: z.number(), billing_method: z.enum(["prepaid", "usage_based"]), max_purchase: z.number().nullable()}).nullable(), display: z.object({primary_text: z.string(), secondary_text: z.string().optional()}).optional(), rollover: z.object({max: z.number().nullable(), max_percentage: z.number().nullable().optional(), expiry_duration_type: z.enum(["month", "forever"]), expiry_duration_length: z.number().optional()}).optional()})), free_trial: z.object({duration_length: z.number(), duration_type: z.enum(["day", "month", "year"]), card_required: z.boolean(), on_end: z.enum(["bill", "revert"]).nullable().optional()}).optional(), created_at: z.number(), env: z.enum(["sandbox", "live"]), archived: z.boolean(), base_variant_id: z.string().nullable(), variant_details: z.object({base_plan_id: z.string(), customize: z.object({price: z.object({amount: z.number(), interval: z.enum(["one_off", "week", "month", "quarter", "semi_annual", "year"]), interval_count: z.number().optional(), additional_currencies: z.array(z.object({currency: z.string(), amount: z.number()})).optional()}).nullable().optional(), add_items: z.array(z.object({feature_id: z.string(), included: z.number().optional(), unlimited: z.boolean().optional(), reset: z.object({interval: z.enum(["one_off", "minute", "hour", "day", "week", "month", "quarter", "semi_annual", "year"]), interval_count: z.number().optional()}).optional(), price: z.object({amount: z.number().optional(), additional_currencies: z.array(z.object({currency: z.string(), amount: z.number()})).optional(), tiers: z.array(z.object({to: z.union([z.number(), z.literal("inf")]), amount: z.number(), flat_amount: z.number().optional(), additional_currencies: z.array(z.object({currency: z.string(), amount: z.number().optional(), flat_amount: z.number().optional()})).optional()})).optional(), tier_behavior: z.enum(["graduated", "volume"]).optional(), interval: z.enum(["one_off", "week", "month", "quarter", "semi_annual", "year"]), interval_count: z.number().optional(), billing_units: z.number().optional(), billing_method: z.enum(["prepaid", "usage_based"]), max_purchase: z.number().nullable().optional()}).optional(), proration: z.object({on_increase: z.enum(["bill_immediately", "prorate_immediately", "prorate_next_cycle", "bill_next_cycle"]), on_decrease: z.enum(["prorate", "prorate_immediately", "prorate_next_cycle", "none", "no_prorations"])}).optional(), rollover: z.object({max: z.number().optional(), max_percentage: z.number().optional(), expiry_duration_type: z.enum(["month", "forever"]), expiry_duration_length: z.number().optional()}).optional()})).optional(), remove_items: z.array(z.object({feature_id: z.string().optional(), billing_method: z.enum(["prepaid", "usage_based"]).optional(), interval: z.union([z.enum(["one_off", "week", "month", "quarter", "semi_annual", "year"]), z.enum(["one_off", "minute", "hour", "day", "week", "month", "quarter", "semi_annual", "year"])]).optional(), interval_count: z.number().int().gt(0).lte(9007199254740991).optional()})).optional(), free_trial: z.object({duration_length: z.number(), duration_type: z.enum(["day", "month", "year"]).optional(), card_required: z.boolean().optional(), on_end: z.enum(["bill", "revert"]).optional()}).nullable().optional(), billing_controls: z.object({auto_topups: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional(), threshold: z.number(), quantity: z.number().gte(1), purchase_limit: z.object({interval: z.enum(["hour", "day", "week", "month"]), interval_count: z.number().gte(1).optional(), limit: z.number().gte(1), count: z.number().gte(0).optional()}).optional(), invoice_mode: z.boolean().optional()})).optional(), spend_limits: z.array(z.object({feature_id: z.string().optional(), enabled: z.boolean().optional(), limit_type: z.enum(["absolute", "usage_percentage"]).optional(), overage_limit: z.number().gte(0).optional(), skip_overage_billing: z.boolean().optional()})).optional(), usage_limits: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional(), limit: z.number().gte(0), interval: z.enum(["day", "week", "month", "year"]), filter: z.object({properties: z.record(z.string(), z.unknown())}).optional()})).optional(), usage_alerts: z.array(z.object({feature_id: z.string().optional(), enabled: z.boolean().optional(), threshold: z.number().gte(0), threshold_type: z.enum(["usage", "usage_percentage", "remaining", "remaining_percentage"]), name: z.string().optional()})).optional(), overage_allowed: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional()})).optional()}).optional()}).optional()}).optional(), config: z.object({ignore_past_due: z.boolean().optional()}), billing_controls: z.object({auto_topups: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional(), threshold: z.number(), quantity: z.number().gte(1), purchase_limit: z.object({interval: z.enum(["hour", "day", "week", "month"]), interval_count: z.number().gte(1).optional(), limit: z.number().gte(1)}).optional(), invoice_mode: z.boolean().optional()})).optional(), spend_limits: z.array(z.object({feature_id: z.string().optional(), enabled: z.boolean().optional(), limit_type: z.enum(["absolute", "usage_percentage"]).optional(), overage_limit: z.number().gte(0).optional(), skip_overage_billing: z.boolean().optional()})).optional(), usage_limits: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional(), limit: z.number().gte(0), interval: z.enum(["day", "week", "month", "year"]), filter: z.object({properties: z.record(z.string(), z.unknown())}).optional()})).optional(), usage_alerts: z.array(z.object({feature_id: z.string().optional(), enabled: z.boolean().optional(), threshold: z.number().gte(0), threshold_type: z.enum(["usage", "usage_percentage", "remaining", "remaining_percentage"]), name: z.string().optional()})).optional(), overage_allowed: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional()})).optional()}).optional(), metadata: z.record(z.string(), z.unknown()), customer_eligibility: z.object({trial_available: z.boolean().optional(), status: z.enum(["active", "scheduled"]).optional(), canceling: z.boolean().optional(), trialing: z.boolean().optional(), attach_action: z.enum(["activate", "upgrade", "downgrade", "none", "purchase"])}).optional()}); export const createApiV1BillingPreviewMultiUpdateResponse = z.object({customer_id: z.string(), currency: z.string(), total: z.number(), subscriptions: z.array(z.object({customer_id: z.string(), line_items: z.array(z.object({display_name: z.string(), description: z.string(), subtotal: z.number(), total: z.number(), discounts: z.array(z.object({amount_off: z.number(), percent_off: z.number().optional(), reward_id: z.string().optional(), reward_name: z.string().optional()})).optional(), plan_id: z.string(), feature_id: z.string().nullable(), period: z.object({start: z.number(), end: z.number()}).optional(), quantity: z.number()})), subtotal: z.number(), total: z.number(), currency: z.string(), next_cycle: z.object({starts_at: z.number(), subtotal: z.number(), total: z.number(), line_items: z.array(z.object({display_name: z.string(), description: z.string(), subtotal: z.number(), total: z.number(), discounts: z.array(z.object({amount_off: z.number(), percent_off: z.number().optional(), reward_id: z.string().optional(), reward_name: z.string().optional()})).optional(), plan_id: z.string(), feature_id: z.string().nullable(), period: z.object({start: z.number(), end: z.number()}).optional(), quantity: z.number()})), usage_line_items: z.array(z.object({display_name: z.string(), plan_id: z.string(), feature_id: z.string().nullable(), period: z.object({start: z.number(), end: z.number()}).optional()}))}).optional(), expand: z.array(z.string()).optional(), incoming: z.array(z.object({plan_id: z.string(), plan: plan.optional(), feature_quantities: z.array(z.object({feature_id: z.string(), quantity: z.number()})), effective_at: z.number().nullable(), canceled_at: z.number().nullable(), expires_at: z.number().nullable()})), outgoing: z.array(z.object({plan_id: z.string(), plan: plan.optional(), feature_quantities: z.array(z.object({feature_id: z.string(), quantity: z.number()})), effective_at: z.number().nullable(), canceled_at: z.number().nullable(), expires_at: z.number().nullable()})), plan_ids: z.array(z.string())}))}); 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 }; /** * Previews the billing changes of a multi-plan update without making any changes. Returns one core preview per affected subscription. * * POST /v1/billing.preview_multi_update */ export const createApiV1BillingPreviewMultiUpdate = async (args: CreateApiV1BillingPreviewMultiUpdateArgs, options?: CreateApiV1BillingPreviewMultiUpdateOptions) => { 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.preview_multi_update${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(createApiV1BillingPreviewMultiUpdateResponse, await res.json()) };