@peable.to/contracts 2.0.0 → 3.0.0

package/dist/cjs/resources/catalog/billing.js

@@ -1,753 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.billingRoutes = exports.cancelBillingSubscriptionParams = exports.billingFaircoinFxQuoteSchema = exports.billingFaircoinRenewalChoiceSchema = exports.billingFaircoinRenewalRevocationSchema = exports.billingFaircoinRenewalConsentSchema = exports.retrieveBillingInvoiceAuthorityQuery = exports.billingFinalInvoiceAuthoritySchema = exports.billingFinalInvoiceSchema = exports.billingInvoiceAuthoritySourceSchema = exports.billingInvoiceTaxLineSchema = exports.billingInvoiceStateSchema = exports.billingPaidInvoiceSchema = exports.createBillingPortalParams = exports.billingCheckoutOperationRecoverySchema = exports.billingCheckoutOperationSourceSchema = exports.billingCheckoutOperationParams = exports.retrieveBillingCheckoutOperationQuery = exports.billingCheckoutObservationSchema = exports.billingSubscriptionSchema = exports.billingEmbeddedCheckoutBindingSchema = exports.billingEmbeddedCheckoutActionSchema = exports.billingEmbeddedCheckoutConfigurationSchema = exports.billingEmbeddedCheckoutScopeSchema = exports.billingEmbeddedCheckoutSessionSchema = exports.billingCheckoutSessionSchema = exports.billingHostedSessionSchema = exports.createBillingCheckoutParams = exports.billingTaxQuoteSchema = exports.createBillingTaxQuoteParams = exports.billingCustomerSchema = exports.ensureBillingCustomerParams = exports.billingRailListSchema = exports.billingRailOptionSchema = exports.billingRailOfferSchema = exports.billingPriceRef = exports.billingCustomerRef = exports.billingInstant = exports.billingReturnUrl = exports.billingRailId = exports.billingIdempotencyKey = exports.billingReference = void 0;
-const zod_1 = require("zod");
-const objects_1 = require("../../common/objects");
-const primitives_1 = require("../../common/primitives");
-const route_1 = require("../../route");
-const catalog_1 = require("../../vocabulary/catalog");
-/**
- * The recurring billing transport (`/v1/billing/*`): an Oxy app's own
- * subscription checkout — Oxy One, Mention Plus — over a configured settlement
- * rail (a fiat provider such as Stripe, or FairCoin). Store and plan references
- * belong to the authenticated app; they do not identify an Oxy payer or convey
- * entitlements. Payment success and access require the authoritative backend
- * outcome read here — never a closed sheet or a browser callback.
- *
- * Every write takes an `Idempotency-Key` header, which the route REQUIRES
- * (a missing or malformed key is a 400): the key is the operation's identity
- * at the provider, not a replay convenience.
- */
-// ---- Shared pieces ---------------------------------------------------------------
-/** An opaque app or provider reference: 1–128 of `A–Z a–z 0–9 _ . : -`. */
-exports.billingReference = zod_1.z
-    .string()
-    .min(1)
-    .max(128)
-    .regex(/^[A-Za-z0-9_.:-]+$/);
-/** The `Idempotency-Key` of a billing write: 1–200 of `A–Z a–z 0–9 _ . : -`. */
-exports.billingIdempotencyKey = zod_1.z
-    .string()
-    .min(1)
-    .max(200)
-    .regex(/^[A-Za-z0-9_.:-]+$/);
-/**
- * A configured settlement rail's name (`stripe`, `faircoin`, a further fiat
- * provider). Selecting one never configures it: an unconfigured rail is
- * refused.
- */
-exports.billingRailId = zod_1.z
-    .string()
-    .regex(/^[a-z][a-z0-9_]{1,31}$/)
-    .describe('A settlement rail: `stripe`, `faircoin`, or a further fiat provider.');
-/** HTTPS destinations only; the authenticated app supplies its own return page. */
-exports.billingReturnUrl = zod_1.z
-    .string()
-    .url()
-    .max(2048)
-    .refine((value) => {
-    const url = new URL(value);
-    return url.protocol === 'https:' && !url.username && !url.password;
-}, 'An HTTPS return URL without credentials is required');
-/** An instant in signed billing evidence: integer Unix seconds that stay a safe integer. */
-exports.billingInstant = zod_1.z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
-/** A billing customer reference (`cus_…`). */
-exports.billingCustomerRef = zod_1.z
-    .string()
-    .regex(/^cus_[A-Za-z0-9]+$/)
-    .max(128);
-/** A billing price reference (`price_…`). */
-exports.billingPriceRef = zod_1.z
-    .string()
-    .regex(/^price_[A-Za-z0-9]+$/)
-    .max(128);
-const mode = zod_1.z.enum(['test', 'live']);
-const environment = zod_1.z.enum(['development', 'staging', 'production']);
-const taxTreatment = zod_1.z.enum(['inclusive', 'exclusive']);
-const billingInterval = zod_1.z.enum(['month', 'year']);
-const ed25519Signature = zod_1.z
-    .object({
-    algorithm: zod_1.z.literal('Ed25519'),
-    key_id: exports.billingReference,
-    value: zod_1.z.string().regex(/^[A-Za-z0-9_-]{86}$/),
-})
-    .strict()
-    .describe('Ed25519 over the canonical JSON (v1) of everything beside it.');
-// ---- Rails -------------------------------------------------------------------------
-/**
- * One offer a rail can sell. Fiat provider rails bind their prices from the
- * app's own provider catalogue, so they list `offers: null`.
- */
-exports.billingRailOfferSchema = (0, objects_1.defineComponent)('BillingRailOffer', zod_1.z
-    .object({
-    provider_price_id: zod_1.z.string(),
-    plan_id: zod_1.z.string(),
-    interval: billingInterval,
-    currency: zod_1.z.string(),
-    gross_minor_units: primitives_1.amount,
-    tax_treatment: taxTreatment,
-})
-    .strict());
-exports.billingRailOptionSchema = (0, objects_1.defineComponent)('BillingRailOption', zod_1.z
-    .object({
-    rail: zod_1.z.string().describe('The rail: `stripe`, `faircoin`, or a further fiat provider.'),
-    settlement: zod_1.z.enum(catalog_1.BILLING_RAIL_SETTLEMENTS),
-    default: zod_1.z
-        .boolean()
-        .describe('The rail a request that names none is served by: the first configured.'),
-    tax_quotes: zod_1.z.boolean().describe('Whether `POST /v1/billing/tax_quotes` answers for it.'),
-    renewal: zod_1.z
-        .enum(catalog_1.BILLING_RAIL_RENEWALS)
-        .describe('`automatic`: the provider charges each period. `payer_initiated`: each period is an explicit payment (`renew`).'),
-    offers: zod_1.z.array(exports.billingRailOfferSchema).nullable(),
-})
-    .strict());
-/** Every rail this merchant's payers can choose between, default first. A complete set. */
-exports.billingRailListSchema = (0, objects_1.defineComponent)('BillingRailList', zod_1.z.object({ object: zod_1.z.literal('list'), data: zod_1.z.array(exports.billingRailOptionSchema) }).strict());
-// ---- Customers ---------------------------------------------------------------------
-exports.ensureBillingCustomerParams = zod_1.z
-    .object({
-    store_id: exports.billingReference.describe("The app's own store / account reference."),
-    store_name: zod_1.z.string().min(1).max(200),
-    rail: exports.billingRailId
-        .optional()
-        .describe("The payer's chosen rail; default: the merchant's first. A customer belongs to one rail, and its checkouts and subscriptions follow it."),
-})
-    .strict();
-exports.billingCustomerSchema = (0, objects_1.defineComponent)('BillingCustomer', zod_1.z.object({ provider_customer_id: zod_1.z.string() }).strict());
-// ---- Tax quotes ----------------------------------------------------------------------
-/**
- * A merchant asks Peable to quote a registered product. Monetary and fiscal
- * configuration is resolved inside Peable, never supplied by a consumer.
- */
-exports.createBillingTaxQuoteParams = zod_1.z
-    .object({
-    rail: exports.billingRailId
-        .optional()
-        .describe("Default: the first of the merchant's rails that answers tax quotes."),
-    store_id: exports.billingReference,
-    plan_id: exports.billingReference,
-    provider_price_id: exports.billingReference
-        .optional()
-        .describe('Selects one offer when a plan is sold at several prices.'),
-    customer_location_evidence_id: exports.billingReference.describe('A `tax.location_evidence` id (`taxloc_…`) recorded for this `store_id`.'),
-})
-    .strict();
-/** A signed, immutable, single-use Peable Tax quote (schema version 3). */
-exports.billingTaxQuoteSchema = (0, objects_1.defineComponent)('BillingTaxQuote', zod_1.z
-    .object({
-    schema_version: zod_1.z.literal(3),
-    source: zod_1.z
-        .object({
-        merchant_id: exports.billingReference,
-        app_id: exports.billingReference,
-        store_id: exports.billingReference,
-        plan_id: exports.billingReference,
-        mode,
-        environment,
-    })
-        .strict(),
-    quote: zod_1.z
-        .object({
-        id: exports.billingReference,
-        currency: zod_1.z.string().regex(/^[A-Z]{3}$/),
-        gross_minor_units: primitives_1.amount,
-        net_minor_units: primitives_1.amount,
-        tax_minor_units: primitives_1.amount,
-        tax_treatment: taxTreatment,
-        seller_id: exports.billingReference,
-        invoice_issuer_id: exports.billingReference,
-        tax_remitter_id: exports.billingReference,
-        tax_service_ref: exports.billingReference,
-        country: zod_1.z.string().regex(/^[A-Z]{2}$/),
-        coverage_evidence_id: exports.billingReference,
-        tax_rate_evidence_id: exports.billingReference,
-        customer_location_evidence_id: exports.billingReference,
-        quoted_at: exports.billingInstant,
-        expires_at: exports.billingInstant,
-    })
-        .strict(),
-    signature: ed25519Signature,
-})
-    .strict());
-// ---- Checkout ------------------------------------------------------------------------
-exports.createBillingCheckoutParams = zod_1.z
-    .object({
-    rail: exports.billingRailId
-        .optional()
-        .describe('An assertion of the rail; it must be the rail of `provider_customer_id`.'),
-    provider_customer_id: exports.billingCustomerRef,
-    provider_price_id: exports.billingPriceRef,
-    trial_days: zod_1.z.number().int().min(0).max(730),
-    tax_quote: exports.billingTaxQuoteSchema
-        .optional()
-        .describe('Opt-in fiscal checkout: the complete signed quote, immutable and single-use. Peable validates its pinned authority and retains immutable evidence before creating a session.'),
-    return_url: exports.billingReturnUrl,
-    store_id: exports.billingReference,
-    plan_id: exports.billingReference,
-})
-    .strict();
-/** A sensitive, owner-only URL. The gateway refuses replay after `expires_at`. */
-exports.billingHostedSessionSchema = (0, objects_1.defineComponent)('BillingHostedSession', zod_1.z.object({ url: zod_1.z.string(), expires_at: zod_1.z.number().int() }).strict());
-/** An owned recurring checkout. Completing it is not paid evidence. */
-exports.billingCheckoutSessionSchema = (0, objects_1.defineComponent)('BillingCheckoutSession', zod_1.z.object({ id: zod_1.z.string(), url: zod_1.z.string(), expires_at: zod_1.z.number().int() }).strict());
-/** A durable embedded-session reference. Provider secrets are never in it. */
-exports.billingEmbeddedCheckoutSessionSchema = (0, objects_1.defineComponent)('BillingEmbeddedCheckoutSession', zod_1.z
-    .object({
-    id: zod_1.z.string(),
-    presentation: zod_1.z.literal('embedded'),
-    expires_at: zod_1.z.number().int(),
-})
-    .strict());
-exports.billingEmbeddedCheckoutScopeSchema = (0, objects_1.defineComponent)('BillingEmbeddedCheckoutScope', zod_1.z
-    .object({
-    merchant_id: zod_1.z.string(),
-    app_id: zod_1.z.string(),
-    environment,
-    mode,
-})
-    .strict());
-exports.billingEmbeddedCheckoutConfigurationSchema = (0, objects_1.defineComponent)('BillingEmbeddedCheckoutConfiguration', zod_1.z
-    .object({
-    scope: exports.billingEmbeddedCheckoutScopeSchema,
-    publishable_key: zod_1.z.string(),
-    payment_methods: zod_1.z.array(zod_1.z.object({ id: zod_1.z.literal('card'), available: zod_1.z.boolean() }).strict()),
-})
-    .strict());
-/** An ephemeral processor capability, released only to the authenticated owning workload. */
-exports.billingEmbeddedCheckoutActionSchema = (0, objects_1.defineComponent)('BillingEmbeddedCheckoutAction', zod_1.z
-    .object({
-    kind: zod_1.z.literal('checkout_session'),
-    provider: zod_1.z.literal('stripe'),
-    session_id: zod_1.z.string(),
-    client_secret: zod_1.z.string(),
-    publishable_key: zod_1.z.string(),
-    amount_minor_units: primitives_1.amount,
-    currency: zod_1.z.string(),
-})
-    .strict());
-exports.billingEmbeddedCheckoutBindingSchema = (0, objects_1.defineComponent)('BillingEmbeddedCheckoutBinding', zod_1.z
-    .object({
-    status: zod_1.z.enum(['open', 'complete', 'expired']),
-    action: exports.billingEmbeddedCheckoutActionSchema
-        .nullable()
-        .describe('`null` once the session is complete or expired.'),
-    scope: exports.billingEmbeddedCheckoutScopeSchema
-        .extend({
-        store_id: zod_1.z.string(),
-        plan_id: zod_1.z.string(),
-        provider_customer_id: zod_1.z.string(),
-        provider_price_id: zod_1.z.string(),
-    })
-        .strict(),
-    tax_quote: exports.billingTaxQuoteSchema,
-    expires_at: zod_1.z.number().int(),
-})
-    .strict());
-// ---- Subscriptions -------------------------------------------------------------------
-/** Provider observations only. Consumers own plan, status and entitlement interpretation. */
-exports.billingSubscriptionSchema = (0, objects_1.defineComponent)('BillingSubscription', zod_1.z
-    .object({
-    provider_subscription_id: zod_1.z.string(),
-    latest_invoice_id: zod_1.z
-        .string()
-        .nullable()
-        .optional()
-        .describe('Discovery only: the invoice must still be read and proven paid.'),
-    provider_customer_id: zod_1.z.string(),
-    provider_price_id: zod_1.z.string(),
-    store_id: zod_1.z.string(),
-    plan_id: zod_1.z.string(),
-    livemode: zod_1.z.boolean(),
-    status: zod_1.z.enum(catalog_1.BILLING_SUBSCRIPTION_STATUSES),
-    interval: billingInterval,
-    cancel_at_period_end: zod_1.z.boolean(),
-    current_period_start: zod_1.z.number().int(),
-    current_period_end: zod_1.z.number().int(),
-    trial_ends_at: zod_1.z.number().int().nullable(),
-    cancel_at: zod_1.z.number().int().nullable(),
-    cancelled_at: zod_1.z.number().int().nullable(),
-})
-    .strict());
-exports.billingCheckoutObservationSchema = (0, objects_1.defineComponent)('BillingCheckoutObservation', zod_1.z
-    .object({
-    initial_invoice_id: zod_1.z
-        .string()
-        .nullable()
-        .describe('The immutable `subscription_create` invoice proven for this exact checkout. Discovery only, never paid authority.'),
-    id: zod_1.z.string(),
-    status: zod_1.z.enum(['open', 'complete', 'expired']),
-    store_id: zod_1.z.string(),
-    plan_id: zod_1.z.string(),
-    provider_customer_id: zod_1.z.string(),
-    provider_price_id: zod_1.z.string(),
-    subscription: exports.billingSubscriptionSchema.nullable(),
-})
-    .strict());
-// ---- Checkout operation recovery -----------------------------------------------------
-/** The query of a recovery read; the `Idempotency-Key` is its path. */
-exports.retrieveBillingCheckoutOperationQuery = zod_1.z
-    .object({
-    provider_customer_id: exports.billingReference,
-    provider_price_id: exports.billingReference,
-    store_id: exports.billingReference,
-    plan_id: exports.billingReference,
-})
-    .strict();
-/** A recovery read as a caller names it: the key and the operation it keyed. */
-exports.billingCheckoutOperationParams = exports.retrieveBillingCheckoutOperationQuery
-    .extend({ idempotency_key: exports.billingIdempotencyKey })
-    .strict();
-const checkoutOperationSource = zod_1.z
-    .object({
-    idempotency_key: zod_1.z.string(),
-    provider_customer_id: zod_1.z.string(),
-    provider_price_id: zod_1.z.string(),
-    store_id: zod_1.z.string(),
-    plan_id: zod_1.z.string(),
-    tax_quote_id: zod_1.z.string().nullable(),
-    merchant_id: zod_1.z.string(),
-    app_id: zod_1.z.string(),
-    mode,
-    environment,
-})
-    .strict();
-exports.billingCheckoutOperationSourceSchema = (0, objects_1.defineComponent)('BillingCheckoutOperationSource', checkoutOperationSource);
-/**
- * Read-only recovery of one previously attempted recurring checkout. Neither
- * absence nor uncertainty permits cancellation or another financial operation.
- */
-exports.billingCheckoutOperationRecoverySchema = (0, objects_1.defineComponent)('BillingCheckoutOperationRecovery', zod_1.z.union([
-    zod_1.z
-        .object({
-        state: zod_1.z.enum(['not_found', 'pending', 'indeterminate']),
-        source: exports.billingCheckoutOperationSourceSchema,
-    })
-        .strict(),
-    zod_1.z
-        .object({
-        state: zod_1.z.literal('succeeded'),
-        source: exports.billingCheckoutOperationSourceSchema,
-        checkout: zod_1.z
-            .object({ id: zod_1.z.string(), expires_at: zod_1.z.number().int(), url: zod_1.z.string().optional() })
-            .strict(),
-    })
-        .strict(),
-]));
-// ---- Portal ----------------------------------------------------------------------------
-exports.createBillingPortalParams = zod_1.z
-    .object({ provider_customer_id: exports.billingCustomerRef, return_url: exports.billingReturnUrl })
-    .strict();
-// ---- Invoices ---------------------------------------------------------------------------
-/** An authenticated authoritative read: one settled, full, non-prorated line only. */
-exports.billingPaidInvoiceSchema = (0, objects_1.defineComponent)('BillingPaidInvoice', zod_1.z
-    .object({
-    invoice_id: zod_1.z.string(),
-    line_id: zod_1.z.string(),
-    payment_intent_id: zod_1.z.string(),
-    provider_subscription_id: zod_1.z.string(),
-    provider_customer_id: zod_1.z.string(),
-    provider_price_id: zod_1.z.string(),
-    store_id: zod_1.z.string(),
-    plan_id: zod_1.z.string(),
-    livemode: zod_1.z.boolean(),
-    currency: zod_1.z.string(),
-    amount_paid: primitives_1.amount,
-    net_amount: primitives_1.amount.nullable(),
-    tax_amount: primitives_1.amount
-        .nullable()
-        .describe('A provider observation, not a tax quote or seller configuration.'),
-    period_start: zod_1.z.number().int(),
-    period_end: zod_1.z.number().int(),
-    paid_at: zod_1.z.number().int(),
-    observed_at: zod_1.z.number().int(),
-})
-    .strict());
-exports.billingInvoiceStateSchema = (0, objects_1.defineComponent)('BillingInvoiceState', exports.billingPaidInvoiceSchema
-    .extend({
-    charge_id: zod_1.z.string(),
-    amount_refunded: primitives_1.amount,
-    state: zod_1.z.enum(['paid', 'fully_refunded', 'partially_refunded']),
-})
-    .strict());
-/** One frozen Peable Tax line behind a signed invoice's tax amount. */
-exports.billingInvoiceTaxLineSchema = (0, objects_1.defineComponent)('BillingInvoiceTaxLine', zod_1.z
-    .object({
-    calculation_id: exports.billingReference,
-    country: zod_1.z.string().regex(/^[A-Z]{2}$/),
-    state: zod_1.z.string().nullable(),
-    tax_type: zod_1.z.string().nullable(),
-    rate_percentage: zod_1.z.string().nullable(),
-    taxable_minor_units: primitives_1.amount,
-    tax_minor_units: primitives_1.amount,
-    inclusive: zod_1.z.boolean(),
-    taxability_reason: zod_1.z.string().min(1),
-})
-    .strict());
-/**
- * Provider-independent fiscal evidence. Values come from the configured
- * authority, never from invoice amounts, merchant metadata, or an application
- * tax guess.
- */
-exports.billingInvoiceAuthoritySourceSchema = (0, objects_1.defineComponent)('BillingInvoiceAuthoritySource', zod_1.z
-    .object({
-    invoice_id: exports.billingReference,
-    payment_intent_id: exports.billingReference,
-    customer_id: exports.billingReference,
-    subscription_id: exports.billingReference,
-    price_id: exports.billingReference,
-    plan_id: exports.billingReference,
-    merchant_id: exports.billingReference,
-    app_id: exports.billingReference,
-    mode,
-    environment,
-})
-    .strict());
-exports.billingFinalInvoiceSchema = (0, objects_1.defineComponent)('BillingFinalInvoice', zod_1.z
-    .object({
-    platform: zod_1.z.literal('peable'),
-    currency: zod_1.z.string().regex(/^[A-Z]{3}$/),
-    gross_minor_units: primitives_1.amount,
-    net_minor_units: primitives_1.amount,
-    tax_minor_units: primitives_1.amount,
-    merchant_fee_minor_units: primitives_1.amount,
-    tax_treatment: taxTreatment,
-    seller_id: exports.billingReference,
-    invoice_issuer_id: exports.billingReference,
-    tax_quote_id: exports.billingReference,
-    customer_location_evidence_id: exports.billingReference,
-    tax_rate_evidence_id: exports.billingReference,
-    context: zod_1.z
-        .object({
-        payer_account_id: exports.billingReference,
-        beneficiary_account_id: exports.billingReference,
-        provider_subscription_id: exports.billingReference,
-        offer_id: exports.billingReference,
-        offer_version: zod_1.z.number().int().positive(),
-        period_start: exports.billingInstant,
-        period_end: exports.billingInstant,
-        mode,
-        environment,
-    })
-        .strict(),
-    issued_at: exports.billingInstant,
-    expires_at: exports.billingInstant,
-    faircoin_quote: zod_1.z
-        .object({
-        id: exports.billingReference,
-        amount_base_units: zod_1.z
-            .string()
-            .regex(/^[1-9][0-9]*$/)
-            .max(80),
-        quoted_at: exports.billingInstant,
-        expires_at: exports.billingInstant,
-        rounding_evidence_id: exports.billingReference,
-    })
-        .strict()
-        .optional()
-        .describe('On a FairCoin invoice: the FX quote that bounds the payment.'),
-    tax_lines: zod_1.z
-        .array(exports.billingInvoiceTaxLineSchema)
-        .max(500)
-        .optional()
-        .describe('Present only when asked for (`include=tax_lines`): the frozen Peable Tax lines behind `tax_minor_units`, covered by the same signature.'),
-})
-    .strict());
-/** A signed final invoice authority (schema version 3). Verify it against the pinned keys. */
-exports.billingFinalInvoiceAuthoritySchema = (0, objects_1.defineComponent)('BillingFinalInvoiceAuthority', zod_1.z
-    .object({
-    schema_version: zod_1.z.literal(3),
-    source: exports.billingInvoiceAuthoritySourceSchema,
-    invoice: exports.billingFinalInvoiceSchema,
-    method: zod_1.z.enum(['card', 'faircoin']),
-    signature: ed25519Signature,
-})
-    .strict());
-exports.retrieveBillingInvoiceAuthorityQuery = zod_1.z.object({
-    include: zod_1.z
-        .literal('tax_lines')
-        .optional()
-        .describe('`tax_lines`: include the frozen Peable Tax lines, inside the signature.'),
-});
-// ---- FairCoin renewal authority -------------------------------------------------------
-const positiveBaseUnits = zod_1.z
-    .string()
-    .regex(/^[1-9][0-9]*$/)
-    .max(80);
-/**
- * An automatic FairCoin renewal authorization: an explicit, bounded
- * instruction. Transporting it creates no mandate and authorizes no custody of
- * payer keys.
- */
-exports.billingFaircoinRenewalConsentSchema = (0, objects_1.defineComponent)('BillingFaircoinRenewalConsent', zod_1.z
-    .object({
-    authorization_id: exports.billingReference,
-    payer_account_id: exports.billingReference,
-    merchant_id: exports.billingReference,
-    app_id: exports.billingReference,
-    subscription_id: exports.billingReference,
-    plan_id: exports.billingReference,
-    mode,
-    environment,
-    explicit_consent: zod_1.z.literal(true),
-    consent_evidence_id: exports.billingReference,
-    maximum_amount_base_units: positiveBaseUnits,
-    interval: zod_1.z.literal('month'),
-    interval_count: zod_1.z.literal(1),
-    starts_at: exports.billingInstant,
-    expires_at: exports.billingInstant,
-    accepted_at: exports.billingInstant,
-})
-    .strict()
-    .refine((value) => value.expires_at > value.starts_at &&
-    value.accepted_at <= value.starts_at &&
-    (value.mode === 'live') === (value.environment === 'production'), 'Invalid consent period or environment'));
-exports.billingFaircoinRenewalRevocationSchema = (0, objects_1.defineComponent)('BillingFaircoinRenewalRevocation', zod_1.z
-    .object({
-    authorization_id: exports.billingReference,
-    revoked_at: exports.billingInstant,
-    revocation_evidence_id: exports.billingReference,
-})
-    .strict());
-exports.billingFaircoinRenewalChoiceSchema = (0, objects_1.defineComponent)('BillingFaircoinRenewalChoice', zod_1.z.union([
-    zod_1.z.object({ method: zod_1.z.literal('faircoin'), renewal: zod_1.z.literal('manual_monthly') }).strict(),
-    zod_1.z
-        .object({
-        method: zod_1.z.literal('faircoin'),
-        renewal: zod_1.z.literal('automatic'),
-        consent: exports.billingFaircoinRenewalConsentSchema,
-    })
-        .strict(),
-]));
-/** A FAIR/USD quote: the FAIR a USD amount costs, ceiled to a base unit, for a bounded time. */
-exports.billingFaircoinFxQuoteSchema = (0, objects_1.defineComponent)('BillingFaircoinFxQuote', zod_1.z
-    .object({
-    id: zod_1.z.string(),
-    currency: zod_1.z.literal('USD'),
-    gross_minor_units: primitives_1.amount,
-    amount_base_units: zod_1.z.string(),
-    usd_per_fair: zod_1.z.string(),
-    source: zod_1.z.string(),
-    observed_at: zod_1.z.number().int(),
-    quoted_at: zod_1.z.number().int(),
-    expires_at: zod_1.z.number().int(),
-    rounding: zod_1.z.literal('ceil_to_base_unit'),
-})
-    .strict());
-// ---- Routes ----------------------------------------------------------------------------
-/** The body of `cancel_at_period_end`: nothing. */
-exports.cancelBillingSubscriptionParams = zod_1.z.object({}).strict();
-const requiresKey = 'Requires an `Idempotency-Key` header: it is the operation’s identity at the provider.';
-const subscription = { id: 'The provider subscription (`provider_subscription_id`).' };
-const invoice = {
-    ...subscription,
-    invoiceId: 'The invoice of that subscription.',
-};
-exports.billingRoutes = [
-    (0, route_1.defineRoute)({
-        operationId: 'listBillingRails',
-        method: 'get',
-        path: '/v1/billing/rails',
-        tag: 'Recurring billing',
-        summary: 'List the settlement rails',
-        description: "The rails this merchant's payers can choose between (card and other fiat providers, FairCoin), default first, with each rail's offers. Pass the payer's choice as `rail` to `ensureCustomer`.",
-        auth: 'service',
-        scope: 'payments:read',
-        response: exports.billingRailListSchema,
-        sdk: 'billing.listRails',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'createBillingTaxQuote',
-        method: 'post',
-        path: '/v1/billing/tax_quotes',
-        tag: 'Recurring billing',
-        summary: 'Quote the tax of a plan',
-        description: 'A signed Peable Tax quote for one plan and one customer location. Verify its signature against the pinned keys before passing it to a checkout.',
-        auth: 'service',
-        scope: 'payments:read',
-        body: exports.createBillingTaxQuoteParams,
-        response: exports.billingTaxQuoteSchema,
-        sdk: 'billing.createTaxQuote',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'ensureBillingCustomer',
-        method: 'post',
-        path: '/v1/billing/customers',
-        tag: 'Recurring billing',
-        summary: 'Ensure the billing customer of a store',
-        description: `The same store always answers the same customer. ${requiresKey}`,
-        auth: 'service',
-        scope: 'payments:write',
-        body: exports.ensureBillingCustomerParams,
-        response: exports.billingCustomerSchema,
-        sdk: 'billing.ensureCustomer',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'createBillingCheckoutSession',
-        method: 'post',
-        path: '/v1/billing/checkout_sessions',
-        tag: 'Recurring billing',
-        summary: 'Create a subscription checkout',
-        description: `A hosted checkout for one plan. Completing it is not paid evidence: read the subscription and its paid invoice. ${requiresKey}`,
-        auth: 'service',
-        scope: 'payments:write',
-        body: exports.createBillingCheckoutParams,
-        response: exports.billingCheckoutSessionSchema,
-        sdk: 'billing.createCheckoutSession',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingEmbeddedCheckoutConfiguration',
-        method: 'get',
-        path: '/v1/billing/embedded_checkout_configuration',
-        tag: 'Recurring billing',
-        summary: 'Retrieve the embedded checkout configuration',
-        auth: 'service',
-        scope: 'payments:read',
-        response: exports.billingEmbeddedCheckoutConfigurationSchema,
-        sdk: 'billing.embeddedCheckoutConfiguration',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'createBillingEmbeddedCheckoutSession',
-        method: 'post',
-        path: '/v1/billing/embedded_checkout_sessions',
-        tag: 'Recurring billing',
-        summary: 'Create an embedded subscription checkout',
-        description: `Fiscal checkout only: \`tax_quote\` is required. ${requiresKey}`,
-        auth: 'service',
-        scope: 'payments:write',
-        body: exports.createBillingCheckoutParams,
-        response: exports.billingEmbeddedCheckoutSessionSchema,
-        sdk: 'billing.createEmbeddedCheckoutSession',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingEmbeddedCheckoutAction',
-        method: 'get',
-        path: '/v1/billing/embedded_checkout_sessions/{id}/client_action',
-        tag: 'Recurring billing',
-        summary: 'Retrieve an embedded checkout’s client action',
-        description: 'The ephemeral processor capability to mount the embedded checkout, released only to the owning workload; `action` is `null` once the session is complete or expired.',
-        auth: 'service',
-        scope: 'payments:read',
-        params: { id: 'The embedded checkout session (`cs_…`).' },
-        response: exports.billingEmbeddedCheckoutBindingSchema,
-        sdk: 'billing.retrieveEmbeddedCheckoutAction',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'createRecurringBillingPortalSession',
-        method: 'post',
-        path: '/v1/billing/portal_sessions',
-        tag: 'Recurring billing',
-        summary: "Open the provider's billing portal",
-        description: `A short-lived, owner-only URL. ${requiresKey}`,
-        auth: 'service',
-        scope: 'payments:write',
-        body: exports.createBillingPortalParams,
-        response: exports.billingHostedSessionSchema,
-        sdk: 'billing.createPortalSession',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingCheckoutOperation',
-        method: 'get',
-        path: '/v1/billing/checkout_operations/{key}',
-        tag: 'Recurring billing',
-        summary: 'Recover a checkout operation',
-        description: 'Reads the state of a checkout attempted under this `Idempotency-Key`, even after its quote or session expired. Missing, pending or indeterminate never authorizes another create or a cancellation.',
-        auth: 'service',
-        scope: 'payments:read',
-        params: { key: 'The `Idempotency-Key` the checkout was created with.' },
-        query: exports.retrieveBillingCheckoutOperationQuery,
-        response: exports.billingCheckoutOperationRecoverySchema,
-        sdk: 'billing.retrieveCheckoutOperation',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingCheckoutSession',
-        method: 'get',
-        path: '/v1/billing/checkout_sessions/{id}',
-        tag: 'Recurring billing',
-        summary: 'Retrieve a subscription checkout',
-        auth: 'service',
-        scope: 'payments:read',
-        params: { id: 'The checkout session (`cs_…`).' },
-        response: exports.billingCheckoutObservationSchema,
-        sdk: 'billing.retrieveCheckout',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingInvoiceAuthority',
-        method: 'get',
-        path: '/v1/billing/subscriptions/{id}/invoice_authorities/{invoiceId}',
-        tag: 'Recurring billing',
-        summary: 'Retrieve the signed final invoice authority',
-        description: 'Signed fiscal evidence of one paid invoice. Verify the signature against the pinned keys (`PEABLE_BILLING_AUTHORITY_KEYS`).',
-        auth: 'service',
-        scope: 'payments:read',
-        params: invoice,
-        query: exports.retrieveBillingInvoiceAuthorityQuery,
-        response: exports.billingFinalInvoiceAuthoritySchema,
-        sdk: 'billing.retrieveFinalInvoiceAuthority',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingInvoiceState',
-        method: 'get',
-        path: '/v1/billing/subscriptions/{id}/invoice_states/{invoiceId}',
-        tag: 'Recurring billing',
-        summary: 'Retrieve the refund state of a paid invoice',
-        auth: 'service',
-        scope: 'payments:read',
-        params: invoice,
-        response: exports.billingInvoiceStateSchema,
-        sdk: 'billing.retrieveInvoiceState',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingPaidInvoice',
-        method: 'get',
-        path: '/v1/billing/subscriptions/{id}/paid_invoices/{invoiceId}',
-        tag: 'Recurring billing',
-        summary: 'Retrieve a paid invoice',
-        description: 'Paid-period evidence: answers only for a settled, full, non-prorated invoice.',
-        auth: 'service',
-        scope: 'payments:read',
-        params: invoice,
-        response: exports.billingPaidInvoiceSchema,
-        sdk: 'billing.retrievePaidInvoice',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'retrieveBillingSubscription',
-        method: 'get',
-        path: '/v1/billing/subscriptions/{id}',
-        tag: 'Recurring billing',
-        summary: 'Retrieve a subscription',
-        auth: 'service',
-        scope: 'payments:read',
-        params: subscription,
-        response: exports.billingSubscriptionSchema,
-        sdk: 'billing.retrieveSubscription',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'renewBillingSubscription',
-        method: 'post',
-        path: '/v1/billing/subscriptions/{id}/renew',
-        tag: 'Recurring billing',
-        summary: 'Renew a payer-initiated subscription',
-        description: `Opens a new expiring FAIR payment for one monthly period. Never auto-debits. ${requiresKey}`,
-        auth: 'service',
-        scope: 'payments:write',
-        params: subscription,
-        body: exports.createBillingCheckoutParams,
-        response: exports.billingCheckoutSessionSchema,
-        sdk: 'billing.renewSubscription',
-    }),
-    (0, route_1.defineRoute)({
-        operationId: 'cancelBillingSubscriptionAtPeriodEnd',
-        method: 'post',
-        path: '/v1/billing/subscriptions/{id}/cancel_at_period_end',
-        tag: 'Recurring billing',
-        summary: 'Cancel a subscription at period end',
-        description: `Access continues to the end of the paid period. ${requiresKey}`,
-        auth: 'service',
-        scope: 'payments:write',
-        params: subscription,
-        body: exports.cancelBillingSubscriptionParams,
-        response: exports.billingSubscriptionSchema,
-        sdk: 'billing.cancelAtPeriodEnd',
-    }),
-];