import {z} from 'zod' export type CreateApiV1BalancesCheckArgs = {'x-api-version': string, body: {customer_id: string, feature_id: string, entity_id?: string | undefined, required_balance?: number | undefined, properties?: {[key: string]: unknown} | undefined, send_event?: boolean | undefined, lock?: ({lock_id: string, enabled: unknown, expires_at?: number | undefined}) | undefined, with_preview?: boolean | undefined}}; export type CreateApiV1BalancesCheckOptions = {baseUrl?: string | undefined, secretKey?: string | undefined, fetch?: typeof fetch | undefined}; 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 createApiV1BalancesCheckResponse = z.object({allowed: z.boolean(), customer_id: z.string(), entity_id: z.string().nullable().optional(), required_balance: z.number().optional(), balance: balance.nullable(), balances: z.record(z.string(), balance.nullable()).optional(), flag: 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()}).nullable(), preview: z.object({scenario: z.enum(["usage_limit", "feature_flag"]), title: z.string(), message: z.string(), feature_id: z.string(), feature_name: z.string(), products: z.array(z.object({id: z.string(), name: z.string(), group: z.string().nullable(), env: z.enum(["sandbox", "live"]), is_add_on: z.boolean(), is_default: z.boolean(), archived: z.boolean(), version: z.number(), created_at: z.number(), items: z.array(z.object({type: z.enum(["feature", "priced_feature", "price"]).nullable().optional(), feature_id: z.string().nullable().optional(), feature_type: z.enum(["single_use", "continuous_use", "boolean", "static"]).nullable().optional(), included_usage: z.union([z.number(), z.literal("inf")]).nullable().optional(), interval: z.enum(["minute", "hour", "day", "week", "month", "quarter", "semi_annual", "year"]).nullable().optional(), interval_count: z.number().nullable().optional(), price: z.number().nullable().optional(), tiers: z.array(z.unknown()).nullable().optional(), tier_behavior: z.enum(["graduated", "volume"]).nullable().optional(), usage_model: z.enum(["prepaid", "pay_per_use"]).nullable().optional(), billing_units: z.number().nullable().optional(), reset_usage_when_enabled: z.boolean().nullable().optional(), entity_feature_id: z.string().nullable().optional(), display: z.object({primary_text: z.string(), secondary_text: z.string().nullable().optional()}).nullable().optional(), quantity: z.number().nullable().optional(), next_cycle_quantity: z.number().nullable().optional(), config: z.object({rollover: z.object({max: z.number().nullable().optional(), max_percentage: z.number().nullable().optional(), duration: z.enum(["month", "forever"]).optional(), length: z.number()}).nullable().optional(), on_increase: z.enum(["bill_immediately", "prorate_immediately", "prorate_next_cycle", "bill_next_cycle"]).nullable().optional(), on_decrease: z.enum(["prorate", "prorate_immediately", "prorate_next_cycle", "none", "no_prorations"]).nullable().optional()}).nullable().optional()})), free_trial: z.object({duration: z.enum(["day", "month", "year"]), length: z.number(), unique_fingerprint: z.boolean(), card_required: z.boolean(), on_end: z.enum(["bill", "revert"]).nullable().optional(), trial_available: z.boolean().nullable().optional()}).nullable(), base_variant_id: z.string().nullable(), 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(), scenario: z.enum(["scheduled", "active", "new", "renew", "upgrade", "update_prepaid_quantity", "downgrade", "cancel", "expired", "past_due"]).optional(), properties: z.object({is_free: z.boolean(), is_one_off: z.boolean(), interval_group: z.string().nullable().optional(), has_trial: z.boolean().nullable().optional(), updateable: z.boolean().nullable().optional()}).optional()}))}).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 }; /** * Checks whether a customer currently has enough balance to use a feature. * * POST /v1/balances.check */ export const createApiV1BalancesCheck = async (args: CreateApiV1BalancesCheckArgs, options?: CreateApiV1BalancesCheckOptions) => { 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/balances.check${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(createApiV1BalancesCheckResponse, await res.json()) };