import {z} from 'zod' export type CreateApiV1CustomersListArgs = {'x-api-version': string, body: {start_cursor?: string | undefined, limit?: number | undefined, plans?: (Array<{id: string, versions?: Array | undefined}>) | undefined, subscription_status?: ('active' | 'scheduled') | undefined, search?: string | undefined, processors?: (Array<'stripe' | 'revenuecat' | 'vercel'>) | undefined}}; export type CreateApiV1CustomersListOptions = {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 createApiV1CustomersListResponse = z.object({list: z.array(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()})), next_cursor: z.string().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 }; /** * Lists customers with cursor pagination and optional filters. Pass `start_cursor: ""` (or omit) for the first page; use `next_cursor` from a prior response for subsequent pages. * * POST /v1/customers.list */ export const createApiV1CustomersList = async (args: CreateApiV1CustomersListArgs, options?: CreateApiV1CustomersListOptions) => { 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/customers.list${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(createApiV1CustomersListResponse, await res.json()) };