import {z} from 'zod' export type CreateApiV1BillingImportArgs = {'x-api-version': string, body: {customer_id: string, customer_data?: ({name?: string | undefined, email?: string | undefined, fingerprint?: string | undefined}) | undefined, processors?: (Array<{type: 'stripe' | 'revenuecat', id: string}>) | undefined, billables: Array<{processor?: ('stripe' | 'revenuecat') | undefined, link?: ({subscription_id?: string | undefined, schedule_id?: string | undefined}) | undefined, billing_cycle_anchor?: number | undefined, plan?: ({plan_id: string, version?: number | undefined, status?: ('active' | 'trialing' | 'past_due' | 'canceled' | 'expired') | undefined, started_at?: number | undefined, quantity?: number | undefined, feature_quantities?: Array<{feature_id: string, quantity: number}> | undefined, balances?: (Array<{feature_id: string, filter?: ({interval?: ('lifetime' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year' | null) | undefined, billing_behavior?: ('included' | 'prepaid' | 'usage_based') | undefined}) | undefined, usage?: number | undefined, balance?: number | undefined, next_reset_at?: number | undefined}>) | undefined}) | undefined}>, dry_run?: boolean | undefined}}; export type CreateApiV1BillingImportOptions = {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 balance = z.object({feature_id: z.string(), feature: z.object({id: z.string(), name: z.string(), type: z.enum(["boolean", "metered", "credit_system", "ai_credit_system"]), consumable: z.boolean(), event_names: z.array(z.string()).optional(), credit_schema: z.array(z.object({metered_feature_id: z.string(), credit_cost: z.number()})).optional(), model_markups: z.record(z.string(), z.object({markup: z.number().gte(-100).optional(), input_cost: z.number().gte(0).optional(), output_cost: z.number().gte(0).optional()})).nullable().optional(), default_markup: z.number().gte(-100).optional(), provider_markups: z.record(z.string(), z.object({markup: z.number().gte(-100)})).nullable().optional(), display: z.object({singular: z.string().nullable().optional(), plural: z.string().nullable().optional()}).optional(), archived: z.boolean()}).optional(), granted: z.number(), remaining: z.number().gte(0), usage: z.number(), unlimited: z.boolean(), overage_allowed: z.boolean(), max_purchase: z.number().nullable(), next_reset_at: z.number().nullable(), breakdown: z.array(z.object({id: z.string().optional(), plan_id: z.string().nullable(), included_grant: z.number(), prepaid_grant: z.number(), remaining: z.number(), usage: z.number(), unlimited: z.boolean(), reset: z.object({interval: z.union([z.enum(["one_off", "minute", "hour", "day", "week", "month", "quarter", "semi_annual", "year"]), z.literal("multiple")]), interval_count: z.number().optional(), resets_at: z.number().nullable()}).nullable(), price: z.object({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()})).optional(), tier_behavior: z.enum(["graduated", "volume"]).optional(), billing_units: z.number(), billing_method: z.enum(["prepaid", "usage_based"]), max_purchase: z.number().nullable()}).nullable(), expires_at: z.number().nullable()})).optional(), rollovers: z.array(z.object({balance: z.number(), expires_at: z.number()})).optional()}); export const customer = z.object({id: z.string().nullable(), name: z.string().nullable(), email: z.string().nullable(), created_at: z.number(), fingerprint: z.string().nullable(), stripe_id: z.string().nullable(), env: z.enum(["sandbox", "live"]), metadata: z.record(z.string(), z.unknown()), send_email_receipts: z.boolean(), 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.union([z.object({interval: z.enum(["hour", "day", "week", "month"]).nullable(), interval_count: z.number().gte(1).nullable(), limit: z.number().gte(1).nullable(), count: z.number(), next_reset_at: z.number()}), 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(), source: z.enum(["customer", "plan"]).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(), source: z.enum(["customer", "plan"]).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(), usage: z.number().gte(0).optional(), source: z.enum(["customer", "plan"]).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(), source: z.enum(["customer", "plan"]).optional()})).optional(), overage_allowed: z.array(z.object({feature_id: z.string(), enabled: z.boolean().optional(), source: z.enum(["customer", "plan"]).optional()})).optional()}), subscriptions: z.array(z.object({id: z.string(), plan: plan.optional(), plan_id: z.string(), auto_enable: z.boolean(), add_on: z.boolean(), status: z.enum(["active", "scheduled"]), past_due: z.boolean(), canceled_at: z.number().nullable(), expires_at: z.number().nullable(), trial_ends_at: z.number().nullable(), started_at: z.number(), current_period_start: z.number().nullable(), current_period_end: z.number().nullable(), quantity: z.number(), scope: z.enum(["customer", "entity"]).optional()})), purchases: z.array(z.object({plan: plan.optional(), plan_id: z.string(), expires_at: z.number().nullable(), started_at: z.number(), quantity: z.number(), scope: z.enum(["customer", "entity"]).optional()})), licenses: z.array(z.object({license_plan_id: z.string(), parent_plan_id: z.string(), license_plan_name: z.string(), granted: z.number(), usage: z.number(), remaining: z.number(), paid_quantity: z.number()})), balances: z.record(z.string(), balance), flags: z.record(z.string(), z.object({id: z.string(), plan_id: z.string().nullable(), expires_at: z.number().nullable(), feature_id: z.string(), feature: z.object({id: z.string(), name: z.string(), type: z.enum(["boolean", "metered", "credit_system", "ai_credit_system"]), consumable: z.boolean(), event_names: z.array(z.string()).optional(), credit_schema: z.array(z.object({metered_feature_id: z.string(), credit_cost: z.number()})).optional(), model_markups: z.record(z.string(), z.object({markup: z.number().gte(-100).optional(), input_cost: z.number().gte(0).optional(), output_cost: z.number().gte(0).optional()})).nullable().optional(), default_markup: z.number().gte(-100).optional(), provider_markups: z.record(z.string(), z.object({markup: z.number().gte(-100)})).nullable().optional(), display: z.object({singular: z.string().nullable().optional(), plural: z.string().nullable().optional()}).optional(), archived: z.boolean()}).optional()})), config: z.object({disable_pooled_balance: z.boolean().optional(), disable_overage_billing: z.boolean().optional()}).optional(), processors: z.object({stripe: z.object({id: z.string()}).optional(), vercel: z.object({installation_id: z.string(), account_id: z.string()}).optional(), revenuecat: z.object({id: z.string().nullable()}).optional()}).optional(), invoices: z.array(z.object({plan_ids: z.array(z.string()), stripe_id: z.string(), processor_type: z.enum(["stripe", "revenuecat"]).optional(), status: z.string(), total: z.number(), currency: z.string(), created_at: z.number(), hosted_invoice_url: z.string().nullable().optional()})).optional(), entities: z.array(z.object({id: z.string().nullable(), name: z.string().nullable(), customer_id: z.string().nullable().optional(), feature_id: z.string().nullable().optional(), created_at: z.number(), env: z.enum(["sandbox", "live"])})).optional(), trials_used: z.array(z.object({plan_id: z.string(), customer_id: z.string(), fingerprint: z.string().nullable().optional()})).optional(), rewards: z.object({discounts: z.array(z.object({id: z.string(), name: z.string(), type: z.enum(["percentage_discount", "fixed_discount", "free_product", "invoice_credits", "feature_grant"]), discount_value: z.number(), duration_type: z.enum(["one_off", "months", "forever"]), duration_value: z.number().nullable().optional(), currency: z.string().nullable().optional(), start: z.number().nullable().optional(), end: z.number().nullable().optional(), subscription_id: z.string().nullable().optional(), total_discount_amount: z.number().nullable().optional()}))}).nullable().optional(), referrals: z.array(z.object({program_id: z.string(), customer: z.object({id: z.string(), name: z.string().nullable().optional(), email: z.string().nullable().optional()}), reward_applied: z.boolean(), created_at: z.number()})).optional(), payment_method: z.unknown()}); export const createApiV1BillingImportResponse = z.object({customer_id: z.string(), flashed: z.array(z.object({plan_id: z.string(), processor: z.string(), customer_product_id: z.string().nullable(), status: z.string(), skipped: z.boolean(), expired: z.boolean().optional(), mismatch: z.boolean().optional(), reason: z.string().optional()})), customer: customer.nullable()}); 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 }; /** * Import * * POST /v1/billing.import */ export const createApiV1BillingImport = async (args: CreateApiV1BillingImportArgs, options?: CreateApiV1BillingImportOptions) => { 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.import${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(createApiV1BillingImportResponse, await res.json()) };