@peable.to/contracts 1.2.0 → 3.0.0

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

@@ -17,7 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.catalogRoutes = exports.queryIdList = exports.queryFlag = exports.baseUnitAmountParam = void 0;
 // Contracts of this group: one module per resource, re-exported here, and
 // their routes concatenated into `catalogRoutes`.
-const billing_1 = require("./billing");
 const billingSettings_1 = require("./billingSettings");
 const coupons_1 = require("./coupons");
 const entitlements_1 = require("./entitlements");
@@ -26,7 +25,6 @@ const prices_1 = require("./prices");
 const products_1 = require("./products");
 const promotionCodes_1 = require("./promotionCodes");
 const testClocks_1 = require("./testClocks");
-__exportStar(require("./billing"), exports);
 __exportStar(require("./billingSettings"), exports);
 __exportStar(require("./coupons"), exports);
 __exportStar(require("./entitlements"), exports);
@@ -42,8 +40,7 @@ Object.defineProperty(exports, "queryFlag", { enumerable: true, get: function ()
 Object.defineProperty(exports, "queryIdList", { enumerable: true, get: function () { return shared_1.queryIdList; } });
 /**
  * The catalog (products, prices, coupons, promotion codes), entitlements, the
- * billing engine's platform objects (test clocks, billing settings, meters)
- * and the recurring billing transport (`/v1/billing/*`).
+ * billing engine's platform objects (test clocks, billing settings, meters).
  */
 exports.catalogRoutes = [
     ...products_1.productRoutes,
@@ -54,5 +51,4 @@ exports.catalogRoutes = [
     ...testClocks_1.testClockRoutes,
     ...billingSettings_1.billingSettingsRoutes,
     ...meters_1.meterRoutes,
-    ...billing_1.billingRoutes,
 ];

package/dist/cjs/resources/checkout/checkoutSessions.js

@@ -4,7 +4,6 @@ exports.checkoutSessionRoutes = exports.expireCheckoutSessionTestHelperParams =
 const zod_1 = require("zod");
 const catalog_1 = require("../../vocabulary/catalog");
 const payments_1 = require("../../vocabulary/payments");
-const billing_1 = require("../catalog/billing");
 const objects_1 = require("../../common/objects");
 const envelopes_1 = require("../../common/envelopes");
 const objects_2 = require("../../common/objects");
@@ -183,9 +182,6 @@ exports.checkoutSessionPublicSchema = (0, objects_2.defineComponent)('CheckoutSe
         .string()
         .nullable()
         .describe("The card provider's PUBLIC key for this session's mode, so the payment fields can mount before the payment exists. `null` on FairCoin."),
-    billing_quote: billing_1.billingFaircoinFxQuoteSchema
-        .optional()
-        .describe('FairCoin billing invoices: the frozen USD price and FAIR settlement quote.'),
 })
     .strict());
 // ---- Merchant create/update ---------------------------------------------------

package/dist/cjs/resources/events/events.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eventRoutes = exports.WEBHOOK_EVENT_DESCRIPTIONS = exports.streamEventsQuery = exports.retrieveEventQuery = exports.listEventsQuery = exports.listEventsFilters = exports.eventSchema = exports.eventRequestSchema = exports.billingObservationSchema = void 0;
+exports.eventRoutes = exports.WEBHOOK_EVENT_DESCRIPTIONS = exports.streamEventsQuery = exports.retrieveEventQuery = exports.listEventsQuery = exports.listEventsFilters = exports.eventSchema = exports.eventRequestSchema = void 0;
 exports.eventSchemaOf = eventSchemaOf;
 const zod_1 = require("zod");
 const envelopes_1 = require("../../common/envelopes");
@@ -16,36 +16,6 @@ const events_1 = require("../../vocabulary/events");
  * every matching webhook endpoint: a delivery's body and `GET /v1/events/:id`
  * are byte for byte the same object.
  */
-/**
- * The payload of `billing.observation.updated`: a wake-up, never paid or grant
- * authority. Re-read the owner-bound resource it names.
- */
-exports.billingObservationSchema = (0, objects_1.defineObject)('billing_observation', 'BillingObservation', zod_1.z
-    .object({
-    object: zod_1.z.literal('billing_observation'),
-    livemode: primitives_1.livemode.describe('The mode of the billing cohort observed (ADR 0017).'),
-    resource_kind: zod_1.z.enum(['subscription', 'invoice']),
-    resource_id: zod_1.z.string().describe('The provider subscription or invoice observed.'),
-    subscription_id: zod_1.z
-        .string()
-        .optional()
-        .describe('Owner-scoped wake-up hint only; re-read the subscription before resolving a payer.'),
-    revision: zod_1.z.number().int().describe('The observation revision; later revisions are newer.'),
-    observed_at: primitives_1.unixSeconds,
-})
-    .strict(), {
-    examples: [
-        {
-            object: 'billing_observation',
-            livemode: false,
-            resource_kind: 'subscription',
-            resource_id: 'sub_1Q2w3E4r5T6y7U8i',
-            subscription_id: 'sub_1Q2w3E4r5T6y7U8i',
-            revision: 3,
-            observed_at: 1793750400,
-        },
-    ],
-});
 /**
  * What caused an event, when an API request did (Stripe's `event.request`).
  * Both `null` for an event caused by something else — the chain watcher, the
@@ -242,7 +212,6 @@ exports.WEBHOOK_EVENT_DESCRIPTIONS = {
     'setup_intent.succeeded': 'A SetupIntent succeeded: its PaymentMethod is saved.',
     'setup_intent.setup_failed': 'A SetupIntent attempt failed.',
     'setup_intent.canceled': 'A SetupIntent was canceled.',
-    'billing.observation.updated': 'A recurring billing resource was observed to change. A wake-up only: re-read the resource.',
     'connected_account.updated': "A seller's connected account changed — its readiness, in practice.",
     'product.created': 'A Product was created.',
     'product.updated': 'A Product was updated; `previous_attributes` names what moved.',

package/dist/cjs/resources/tax/calculations.js

@@ -6,7 +6,8 @@ const objects_1 = require("../../common/objects");
 const primitives_1 = require("../../common/primitives");
 const route_1 = require("../../route");
 const tax_1 = require("../../vocabulary/tax");
-const shared_1 = require("./shared");
+const shared_1 = require("../catalog/shared");
+const shared_2 = require("./shared");
 /**
  * A tax calculation (`taxcalc_…`, ADR 0011): a frozen answer. Peable decides
  * whether a registration covers the customer's evidenced location and asks
@@ -15,14 +16,14 @@ const shared_1 = require("./shared");
  */
 exports.taxBreakdownEntrySchema = (0, objects_1.defineComponent)('TaxBreakdownEntry', zod_1.z
     .object({
-    country: shared_1.taxCountry,
-    state: shared_1.taxState,
+    country: shared_2.taxCountry,
+    state: shared_2.taxState,
     level: primitives_1.nullableString.describe('The jurisdiction level (`country`, `state`, …).'),
     display_name: primitives_1.nullableString,
     tax_type: primitives_1.nullableString.describe('`vat`, `sales_tax`, …; `null` when no tax is imposed.'),
     rate_percentage: primitives_1.nullableString.describe('Decimal string, e.g. `"20.0"`; `null` when no tax is imposed.'),
-    taxable_amount: shared_1.taxMinorAmount,
-    amount: shared_1.taxMinorAmount,
+    taxable_amount: primitives_1.signedAmount,
+    amount: primitives_1.signedAmount,
     inclusive: zod_1.z.boolean(),
     taxability_reason: zod_1.z
         .string()
@@ -35,9 +36,9 @@ exports.taxCalculationLineItemSchema = (0, objects_1.defineComponent)('TaxCalcul
     quantity: zod_1.z.number().int(),
     tax_code: zod_1.z.string(),
     tax_behavior: zod_1.z.enum(tax_1.TAX_BEHAVIORS),
-    amount: shared_1.taxMinorAmount.describe('As given: includes tax when inclusive.'),
-    amount_tax: shared_1.taxMinorAmount,
-    amount_net: shared_1.taxMinorAmount.describe('Excluding tax.'),
+    amount: primitives_1.signedAmount.describe('As given: includes tax when inclusive.'),
+    amount_tax: primitives_1.signedAmount,
+    amount_net: primitives_1.signedAmount.describe('Excluding tax.'),
     breakdown: zod_1.z.array(exports.taxBreakdownEntrySchema),
 })
     .strict());
@@ -53,12 +54,12 @@ exports.taxCalculationSchema = (0, objects_1.defineObject)('tax.calculation', 'T
     provider: primitives_1.nullableString,
     provider_calculation_ref: primitives_1.nullableString,
     customer_location_evidence_id: zod_1.z.string().describe('`taxloc_…`.'),
-    country: shared_1.taxCountry,
-    state: shared_1.taxState,
-    amount_total: shared_1.taxMinorAmount.describe('What the customer pays.'),
-    amount_net: shared_1.taxMinorAmount,
-    tax_amount_exclusive: shared_1.taxMinorAmount,
-    tax_amount_inclusive: shared_1.taxMinorAmount,
+    country: shared_2.taxCountry,
+    state: shared_2.taxState,
+    amount_total: primitives_1.amount.describe('What the customer pays.'),
+    amount_net: primitives_1.amount,
+    tax_amount_exclusive: primitives_1.amount,
+    tax_amount_inclusive: primitives_1.amount,
     line_items: zod_1.z.array(exports.taxCalculationLineItemSchema),
     tax_date: primitives_1.unixSeconds,
     created: primitives_1.unixSeconds,
@@ -78,19 +79,19 @@ exports.taxCalculationSchema = (0, objects_1.defineObject)('tax.calculation', 'T
             customer_location_evidence_id: 'taxloc_0193b8f2c1a87d3e9f4a',
             country: 'DE',
             state: null,
-            amount_total: 1190,
-            amount_net: 1000,
-            tax_amount_exclusive: 190,
-            tax_amount_inclusive: 0,
+            amount_total: '1190',
+            amount_net: '1000',
+            tax_amount_exclusive: '190',
+            tax_amount_inclusive: '0',
             line_items: [
                 {
                     reference: 'plan_pro_monthly',
                     quantity: 1,
                     tax_code: 'txcd_10103001',
                     tax_behavior: 'exclusive',
-                    amount: 1000,
-                    amount_tax: 190,
-                    amount_net: 1000,
+                    amount: '1000',
+                    amount_tax: '190',
+                    amount_net: '1000',
                     breakdown: [
                         {
                             country: 'DE',
@@ -99,8 +100,8 @@ exports.taxCalculationSchema = (0, objects_1.defineObject)('tax.calculation', 'T
                             display_name: 'VAT',
                             tax_type: 'vat',
                             rate_percentage: '19.0',
-                            taxable_amount: 1000,
-                            amount: 190,
+                            taxable_amount: '1000',
+                            amount: '190',
                             inclusive: false,
                             taxability_reason: 'standard_rated',
                         },
@@ -114,15 +115,17 @@ exports.taxCalculationSchema = (0, objects_1.defineObject)('tax.calculation', 'T
         },
     ],
 });
+/**
+ * The largest line a tax provider is asked to price: the provider's own API
+ * counts amounts in integers that stay exact in a JS number (Stripe Tax).
+ */
+const TAX_LINE_AMOUNT_MAX = BigInt(Number.MAX_SAFE_INTEGER);
 exports.taxLineItemParams = zod_1.z
     .object({
     reference: zod_1.z.string().min(1).max(200),
-    amount: zod_1.z
-        .number()
-        .int()
-        .nonnegative()
-        .safe()
-        .describe('Unit amount × quantity, minor units. Includes tax when inclusive.'),
+    amount: shared_1.baseUnitAmountParam
+        .refine((value) => BigInt(value) <= TAX_LINE_AMOUNT_MAX, 'exceeds the largest amount a tax provider prices')
+        .describe('Unit amount × quantity, base units. Includes tax when inclusive.'),
     quantity: zod_1.z.number().int().positive().max(1000000).optional(),
     tax_code: zod_1.z
         .string()
@@ -137,7 +140,7 @@ exports.taxLineItemParams = zod_1.z
 exports.createTaxCalculationParams = zod_1.z
     .object({
     currency: zod_1.z.string().regex(/^[A-Za-z]{3}$/),
-    customer_location_evidence_id: shared_1.taxReferenceParam.describe('Sufficient, unexpired evidence (`taxloc_…`).'),
+    customer_location_evidence_id: shared_2.taxReferenceParam.describe('Sufficient, unexpired evidence (`taxloc_…`).'),
     line_items: zod_1.z
         .array(exports.taxLineItemParams)
         .min(1)

package/dist/cjs/resources/tax/reports.js

@@ -26,8 +26,8 @@ exports.taxReportRowSchema = (0, objects_1.defineComponent)('TaxReportRow', zod_
     currency: zod_1.z.string().describe('Uppercase ISO 4217.'),
     transactions: zod_1.z.number().int().nonnegative(),
     reversals: zod_1.z.number().int().nonnegative().describe('Reversals netted into this row.'),
-    taxable_amount: shared_1.taxMinorAmount,
-    tax_amount: shared_1.taxMinorAmount,
+    taxable_amount: primitives_1.signedAmount,
+    tax_amount: primitives_1.signedAmount,
 })
     .strict());
 exports.taxReportSchema = (0, objects_1.defineObject)('tax.report', 'TaxReport', zod_1.z
@@ -55,8 +55,8 @@ exports.taxReportSchema = (0, objects_1.defineObject)('tax.report', 'TaxReport',
                     currency: 'EUR',
                     transactions: 42,
                     reversals: 1,
-                    taxable_amount: 41000,
-                    tax_amount: 7790,
+                    taxable_amount: '41000',
+                    tax_amount: '7790',
                 },
             ],
         },

package/dist/cjs/resources/tax/shared.js

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.complianceIdParam = exports.complianceTextParam = exports.complianceStateParam = exports.complianceCountryParam = exports.taxFacts = exports.taxCoverageLimitSchema = exports.taxRuleSourceSchema = exports.taxInstantParam = exports.taxReferenceParam = exports.taxMinorAmount = exports.taxState = exports.taxCountry = void 0;
+exports.complianceIdParam = exports.complianceTextParam = exports.complianceStateParam = exports.complianceCountryParam = exports.taxFacts = exports.taxCoverageLimitSchema = exports.taxRuleSourceSchema = exports.taxInstantParam = exports.taxReferenceParam = exports.taxState = exports.taxCountry = void 0;
 const zod_1 = require("zod");
 const objects_1 = require("../../common/objects");
 const params_1 = require("../../common/params");
 /**
  * Building blocks every Peable Tax resource shares.
  *
- * Tax AMOUNTS (calculations, transactions, the report) are integer JSON
- * numbers in the currency's minor unit, as Peable Tax has always answered
- * them: unlike a FAIR amount, a tax amount is denominated in a fiat currency
- * and is bounded by the safe-integer checks the calculator applies. Business
- * compliance (ADR 0020) amounts are base-unit strings, as ADR 0014 D1 has it.
+ * Every tax amount — a calculation's, a transaction's, a reversal's, a report
+ * row's, a compliance measure's — is a base-unit integer STRING of its
+ * `currency`, as ADR 0014 D1 has it for every amount on the wire: `amount`
+ * where it cannot be negative, `signedAmount` where a reversal makes it so
+ * (a line item and its breakdown carry a reversal's negative share, and a
+ * report row nets them in).
  */
 /** ISO 3166-1 alpha-2, as returned. */
 exports.taxCountry = zod_1.z.string().describe('ISO 3166-1 alpha-2.');
@@ -20,11 +21,6 @@ exports.taxState = zod_1.z
     .string()
     .nullable()
     .describe('ISO 3166-2 subdivision without the country prefix (`CA`, `QC`).');
-/** A minor-unit integer amount (cents), signed: a reversal's amounts are negative. */
-exports.taxMinorAmount = zod_1.z
-    .number()
-    .int()
-    .describe('Minor units of `currency` (cents), as an integer.');
 /** A Peable-side reference: a product, a customer, a refund. */
 exports.taxReferenceParam = zod_1.z
     .string()

package/dist/cjs/resources/tax/transactions.js

@@ -8,8 +8,8 @@ const params_1 = require("../../common/params");
 const primitives_1 = require("../../common/primitives");
 const route_1 = require("../../route");
 const tax_1 = require("../../vocabulary/tax");
+const shared_1 = require("../catalog/shared");
 const calculations_1 = require("./calculations");
-const shared_1 = require("./shared");
 /**
  * A tax transaction (`taxtxn_…`, ADR 0011/0013): a calculation that was paid,
  * created by Peable when the payment it priced is accepted on its rail. The
@@ -24,9 +24,9 @@ const shared_1 = require("./shared");
  */
 exports.taxTransactionReversalSchema = (0, objects_1.defineComponent)('TaxTransactionReversal', zod_1.z
     .object({
-    amount_total: shared_1.taxMinorAmount,
-    amount_net: shared_1.taxMinorAmount,
-    tax_amount: shared_1.taxMinorAmount,
+    amount_total: primitives_1.signedAmount,
+    amount_net: primitives_1.signedAmount,
+    tax_amount: primitives_1.signedAmount,
     line_items: zod_1.z.array(calculations_1.taxCalculationLineItemSchema),
 })
     .strict());
@@ -59,13 +59,10 @@ exports.createTaxReversalParams = zod_1.z
         .max(200)
         .regex(/^[A-Za-z0-9_.:-]+$/)
         .describe("The refund's own reference; a repeated reference returns the same reversal."),
-    amount: zod_1.z
-        .number()
-        .int()
-        .positive()
-        .safe()
+    amount: shared_1.baseUnitAmountParam
+        .refine((value) => value !== '0', 'must be positive')
         .optional()
-        .describe('Gross minor units refunded (what the payer got back). Omitted: everything not yet reversed.'),
+        .describe('Gross base units refunded (what the payer got back). Omitted: everything not yet reversed.'),
 })
     .strict();
 exports.taxTransactionRoutes = [

package/dist/cjs/vocabulary/catalog.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BILLING_RAIL_RENEWALS = exports.BILLING_RAIL_SETTLEMENTS = exports.BILLING_SUBSCRIPTION_STATUSES = exports.METER_STATUSES = exports.METER_AGGREGATIONS = exports.BILLING_SETTINGS_LIMITS = exports.DUNNING_INVOICE_ACTIONS = exports.DUNNING_FINAL_ACTIONS = exports.TEST_CLOCK_STATUSES = exports.RECURRING_INTERVAL_COUNT_MAX = exports.CATALOG_MAX_WHOLE_UNITS = exports.CATALOG_LIMITS = exports.COUPON_DURATIONS = exports.TRANSFORM_QUANTITY_ROUNDS = exports.PRICE_TAX_BEHAVIORS = exports.RECURRING_USAGE_TYPES = exports.RECURRING_INTERVALS = exports.PRICE_TYPES = exports.PRICE_TIERS_MODES = exports.PRICE_BILLING_SCHEMES = void 0;
+exports.METER_STATUSES = exports.METER_AGGREGATIONS = exports.BILLING_SETTINGS_LIMITS = exports.DUNNING_INVOICE_ACTIONS = exports.DUNNING_FINAL_ACTIONS = exports.TEST_CLOCK_STATUSES = exports.RECURRING_INTERVAL_COUNT_MAX = exports.CATALOG_MAX_WHOLE_UNITS = exports.CATALOG_LIMITS = exports.COUPON_DURATIONS = exports.TRANSFORM_QUANTITY_ROUNDS = exports.PRICE_TAX_BEHAVIORS = exports.RECURRING_USAGE_TYPES = exports.RECURRING_INTERVALS = exports.PRICE_TYPES = exports.PRICE_TIERS_MODES = exports.PRICE_BILLING_SCHEMES = void 0;
 exports.maxBaseUnits = maxBaseUnits;
 // The catalog's and the billing engine platform's closed value sets (ADR 0016,
 // ADR 0018): what a price, a coupon, a test clock, a meter and the billing
@@ -91,20 +91,4 @@ exports.BILLING_SETTINGS_LIMITS = Object.freeze({
 /** How a meter combines a period's events into the quantity billed. */
 exports.METER_AGGREGATIONS = ['sum', 'count', 'last'];
 exports.METER_STATUSES = ['active', 'inactive'];
-// ---- Recurring billing transport (`/v1/billing/*`) ---------------------------
-/** A provider subscription's status, as the recurring transport observes it. */
-exports.BILLING_SUBSCRIPTION_STATUSES = [
-    'incomplete',
-    'incomplete_expired',
-    'trialing',
-    'active',
-    'past_due',
-    'canceled',
-    'unpaid',
-    'paused',
-];
-/** `fiat` (Stripe and any further provider) or `faircoin` (native, to the merchant's watch-only wallet). */
-exports.BILLING_RAIL_SETTLEMENTS = ['fiat', 'faircoin'];
-/** `automatic`: the provider charges each period. `payer_initiated`: each period is an explicit payment. */
-exports.BILLING_RAIL_RENEWALS = ['automatic', 'payer_initiated'];
 // Product tax codes are Peable Tax's vocabulary: `vocabulary/tax.ts` (`TAX_CODES`).

package/dist/cjs/vocabulary/errors.js

@@ -47,19 +47,15 @@ exports.ERROR_CODE_DESCRIPTIONS = {
     account_invalid: 'The `Peable-Account` header names no connected account of this platform.',
     account_missing: 'The merchant has no account object yet.',
     amount_not_representable: 'The amount does not fit the currency or the rail.',
-    billing_not_enabled: 'Billing is not enabled for this merchant.',
-    billing_provider_unavailable: 'The billing provider could not be reached; retry.',
     domain_taken: 'The domain is already registered by another merchant.',
     file_too_large: 'The uploaded file is larger than its purpose allows.',
     file_unavailable: 'The file exists but its contents cannot be served right now.',
     idempotency_error: 'The `Idempotency-Key` was used with a different request, or its first request is still running.',
     idempotency_key_invalid: 'The `Idempotency-Key` header is not a valid key.',
     insufficient_scope: 'The credential is valid but was not granted the Oxy scope this route requires (`payments:read`, `payments:write`, …); `message` names it.',
-    invalid_billing_request: 'The billing request is not valid for this subscription or offer.',
     keyless_recipient: 'The recipient has no receive key, so no address can be derived for them.',
     link_not_found: 'The link does not exist or is no longer active.',
     live_payments_gated: 'Live payments are not enabled for this application yet.',
-    local_test_request_required: 'This test helper only answers a local test request.',
     parameter_invalid: 'A parameter is invalid; `param` names it.',
     parameter_missing: 'A required parameter is missing; `param` names it.',
     parameter_unknown: 'The request carries a parameter this route does not accept; `param` names it.',
@@ -88,10 +84,7 @@ exports.ERROR_CODE_DESCRIPTIONS = {
     customer_location_invalid: "The tax provider could not use the customer's location.",
     dispute_already_submitted: 'Evidence for this dispute has already been submitted; it is one shot.',
     dispute_not_answerable: 'The dispute is in a status that no longer accepts evidence.',
-    idempotency_conflict: 'The same operation key was used for a different billing request.',
-    identity_conflict: 'The billing identity already belongs to another customer or subscription.',
     in_progress: 'The same operation is still running; retry with the same key.',
-    invalid_provider_response: 'The provider answered with something Peable cannot trust; the operation was not applied.',
     invalid_registration: 'The tax registration is not valid.',
     invalid_registration_declaration: 'The tax registration declaration is not valid.',
     invalid_tax_code: 'The tax code does not exist.',
@@ -106,12 +99,9 @@ exports.ERROR_CODE_DESCRIPTIONS = {
     product_in_use: 'The product is referenced by a subscription or a link.',
     promotion_code_invalid: 'The promotion code does not exist, is inactive or does not apply.',
     promotion_code_taken: 'Another active promotion code already uses this `code`.',
-    provider_unavailable: 'The payment provider could not be reached; retry.',
     rail_unavailable: 'The payment rail this request needs is not available.',
-    reconciliation_required: 'The billing operation has an unknown outcome at the provider and is being reconciled.',
     registration_immutable: 'An approved or ended tax registration cannot be deleted or changed this way; end it instead.',
     resource_already_exists: 'An object with this identity already exists.',
-    result_expired: 'The stored result of this operation has expired.',
     review_item_not_open: 'The review item is already resolved or dismissed.',
     rule_set_version_unavailable: 'The tax rule set version is not available.',
     subscription_line_invalid: 'A subscription line item is not valid for Checkout.',
@@ -119,9 +109,6 @@ exports.ERROR_CODE_DESCRIPTIONS = {
     tax_calculation_unavailable: 'Tax could not be calculated; a covered sale fails closed.',
     tax_provider_registration_mismatch: "The provider's registrations disagree with the ones Peable has approved.",
     tax_settings_not_active: 'Tax settings are not active for this merchant.',
-    local_test_unavailable: 'The local test checkout is not available.',
-    local_test_configuration_unavailable: 'The local test checkout has no provider configuration.',
-    local_test_subscription_unavailable: 'The local test subscription cannot be read.',
     rail_mismatch: 'The operation does not apply to the rail this payment uses.',
     checkout_session_changed: 'The Checkout Session changed while this request ran (a price, a discount, its tax); read it again and retry.',
     checkout_session_locked: 'The Checkout Session is being confirmed and cannot change.',

package/dist/cjs/vocabulary/events.js

@@ -61,7 +61,6 @@ exports.WEBHOOK_EVENT_OBJECTS = {
     'setup_intent.succeeded': 'setup_intent',
     'setup_intent.setup_failed': 'setup_intent',
     'setup_intent.canceled': 'setup_intent',
-    'billing.observation.updated': 'billing_observation',
     'connected_account.updated': 'connected_account',
     'product.created': 'product',
     'product.updated': 'product',

package/dist/esm/resources/catalog/index.js

@@ -1,6 +1,5 @@
 // Contracts of this group: one module per resource, re-exported here, and
 // their routes concatenated into `catalogRoutes`.
-import { billingRoutes } from './billing.js';
 import { billingSettingsRoutes } from './billingSettings.js';
 import { couponRoutes } from './coupons.js';
 import { entitlementRoutes } from './entitlements.js';
@@ -9,7 +8,6 @@ import { priceRoutes } from './prices.js';
 import { productRoutes } from './products.js';
 import { promotionCodeRoutes } from './promotionCodes.js';
 import { testClockRoutes } from './testClocks.js';
-export * from './billing.js';
 export * from './billingSettings.js';
 export * from './coupons.js';
 export * from './entitlements.js';
@@ -22,8 +20,7 @@ export * from './testClocks.js';
 export { baseUnitAmountParam, queryFlag, queryIdList } from './shared.js';
 /**
  * The catalog (products, prices, coupons, promotion codes), entitlements, the
- * billing engine's platform objects (test clocks, billing settings, meters)
- * and the recurring billing transport (`/v1/billing/*`).
+ * billing engine's platform objects (test clocks, billing settings, meters).
  */
 export const catalogRoutes = [
     ...productRoutes,
@@ -34,5 +31,4 @@ export const catalogRoutes = [
     ...testClockRoutes,
     ...billingSettingsRoutes,
     ...meterRoutes,
-    ...billingRoutes,
 ];

package/dist/esm/resources/checkout/checkoutSessions.js

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 import { CATALOG_LIMITS, PRICE_TAX_BEHAVIORS, RECURRING_INTERVALS } from '../../vocabulary/catalog.js';
 import { SETUP_INTENT_STATUSES } from '../../vocabulary/payments.js';
-import { billingFaircoinFxQuoteSchema } from '../catalog/billing.js';
 import { embedded } from '../../common/objects.js';
 import { listOf } from '../../common/envelopes.js';
 import { defineComponent, defineObject, expandable } from '../../common/objects.js';
@@ -180,9 +179,6 @@ export const checkoutSessionPublicSchema = defineComponent('CheckoutSessionPubli
         .string()
         .nullable()
         .describe("The card provider's PUBLIC key for this session's mode, so the payment fields can mount before the payment exists. `null` on FairCoin."),
-    billing_quote: billingFaircoinFxQuoteSchema
-        .optional()
-        .describe('FairCoin billing invoices: the frozen USD price and FAIR settlement quote.'),
 })
     .strict());
 // ---- Merchant create/update ---------------------------------------------------

package/dist/esm/resources/events/events.js

@@ -12,36 +12,6 @@ import { WEBHOOK_EVENT_OBJECTS, WEBHOOK_EVENT_TYPES, } from '../../vocabulary/ev
  * every matching webhook endpoint: a delivery's body and `GET /v1/events/:id`
  * are byte for byte the same object.
  */
-/**
- * The payload of `billing.observation.updated`: a wake-up, never paid or grant
- * authority. Re-read the owner-bound resource it names.
- */
-export const billingObservationSchema = defineObject('billing_observation', 'BillingObservation', z
-    .object({
-    object: z.literal('billing_observation'),
-    livemode: livemode.describe('The mode of the billing cohort observed (ADR 0017).'),
-    resource_kind: z.enum(['subscription', 'invoice']),
-    resource_id: z.string().describe('The provider subscription or invoice observed.'),
-    subscription_id: z
-        .string()
-        .optional()
-        .describe('Owner-scoped wake-up hint only; re-read the subscription before resolving a payer.'),
-    revision: z.number().int().describe('The observation revision; later revisions are newer.'),
-    observed_at: unixSeconds,
-})
-    .strict(), {
-    examples: [
-        {
-            object: 'billing_observation',
-            livemode: false,
-            resource_kind: 'subscription',
-            resource_id: 'sub_1Q2w3E4r5T6y7U8i',
-            subscription_id: 'sub_1Q2w3E4r5T6y7U8i',
-            revision: 3,
-            observed_at: 1793750400,
-        },
-    ],
-});
 /**
  * What caused an event, when an API request did (Stripe's `event.request`).
  * Both `null` for an event caused by something else — the chain watcher, the
@@ -238,7 +208,6 @@ export const WEBHOOK_EVENT_DESCRIPTIONS = {
     'setup_intent.succeeded': 'A SetupIntent succeeded: its PaymentMethod is saved.',
     'setup_intent.setup_failed': 'A SetupIntent attempt failed.',
     'setup_intent.canceled': 'A SetupIntent was canceled.',
-    'billing.observation.updated': 'A recurring billing resource was observed to change. A wake-up only: re-read the resource.',
     'connected_account.updated': "A seller's connected account changed — its readiness, in practice.",
     'product.created': 'A Product was created.',
     'product.updated': 'A Product was updated; `previous_attributes` names what moved.',

package/dist/esm/resources/tax/calculations.js

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { defineComponent, defineObject } from '../../common/objects.js';
-import { livemode, nullableString, unixSeconds } from '../../common/primitives.js';
+import { amount, livemode, nullableString, signedAmount, unixSeconds, } from '../../common/primitives.js';
 import { defineRoute } from '../../route.js';
 import { TAX_BEHAVIORS, TAX_COLLECTIONS } from '../../vocabulary/tax.js';
-import { taxCountry, taxMinorAmount, taxReferenceParam, taxState } from './shared.js';
+import { baseUnitAmountParam } from '../catalog/shared.js';
+import { taxCountry, taxReferenceParam, taxState } from './shared.js';
 /**
  * A tax calculation (`taxcalc_…`, ADR 0011): a frozen answer. Peable decides
  * whether a registration covers the customer's evidenced location and asks
@@ -18,8 +19,8 @@ export const taxBreakdownEntrySchema = defineComponent('TaxBreakdownEntry', z
     display_name: nullableString,
     tax_type: nullableString.describe('`vat`, `sales_tax`, …; `null` when no tax is imposed.'),
     rate_percentage: nullableString.describe('Decimal string, e.g. `"20.0"`; `null` when no tax is imposed.'),
-    taxable_amount: taxMinorAmount,
-    amount: taxMinorAmount,
+    taxable_amount: signedAmount,
+    amount: signedAmount,
     inclusive: z.boolean(),
     taxability_reason: z
         .string()
@@ -32,9 +33,9 @@ export const taxCalculationLineItemSchema = defineComponent('TaxCalculationLineI
     quantity: z.number().int(),
     tax_code: z.string(),
     tax_behavior: z.enum(TAX_BEHAVIORS),
-    amount: taxMinorAmount.describe('As given: includes tax when inclusive.'),
-    amount_tax: taxMinorAmount,
-    amount_net: taxMinorAmount.describe('Excluding tax.'),
+    amount: signedAmount.describe('As given: includes tax when inclusive.'),
+    amount_tax: signedAmount,
+    amount_net: signedAmount.describe('Excluding tax.'),
     breakdown: z.array(taxBreakdownEntrySchema),
 })
     .strict());
@@ -52,10 +53,10 @@ export const taxCalculationSchema = defineObject('tax.calculation', 'TaxCalculat
     customer_location_evidence_id: z.string().describe('`taxloc_…`.'),
     country: taxCountry,
     state: taxState,
-    amount_total: taxMinorAmount.describe('What the customer pays.'),
-    amount_net: taxMinorAmount,
-    tax_amount_exclusive: taxMinorAmount,
-    tax_amount_inclusive: taxMinorAmount,
+    amount_total: amount.describe('What the customer pays.'),
+    amount_net: amount,
+    tax_amount_exclusive: amount,
+    tax_amount_inclusive: amount,
     line_items: z.array(taxCalculationLineItemSchema),
     tax_date: unixSeconds,
     created: unixSeconds,
@@ -75,19 +76,19 @@ export const taxCalculationSchema = defineObject('tax.calculation', 'TaxCalculat
             customer_location_evidence_id: 'taxloc_0193b8f2c1a87d3e9f4a',
             country: 'DE',
             state: null,
-            amount_total: 1190,
-            amount_net: 1000,
-            tax_amount_exclusive: 190,
-            tax_amount_inclusive: 0,
+            amount_total: '1190',
+            amount_net: '1000',
+            tax_amount_exclusive: '190',
+            tax_amount_inclusive: '0',
             line_items: [
                 {
                     reference: 'plan_pro_monthly',
                     quantity: 1,
                     tax_code: 'txcd_10103001',
                     tax_behavior: 'exclusive',
-                    amount: 1000,
-                    amount_tax: 190,
-                    amount_net: 1000,
+                    amount: '1000',
+                    amount_tax: '190',
+                    amount_net: '1000',
                     breakdown: [
                         {
                             country: 'DE',
@@ -96,8 +97,8 @@ export const taxCalculationSchema = defineObject('tax.calculation', 'TaxCalculat
                             display_name: 'VAT',
                             tax_type: 'vat',
                             rate_percentage: '19.0',
-                            taxable_amount: 1000,
-                            amount: 190,
+                            taxable_amount: '1000',
+                            amount: '190',
                             inclusive: false,
                             taxability_reason: 'standard_rated',
                         },
@@ -111,15 +112,17 @@ export const taxCalculationSchema = defineObject('tax.calculation', 'TaxCalculat
         },
     ],
 });
+/**
+ * The largest line a tax provider is asked to price: the provider's own API
+ * counts amounts in integers that stay exact in a JS number (Stripe Tax).
+ */
+const TAX_LINE_AMOUNT_MAX = BigInt(Number.MAX_SAFE_INTEGER);
 export const taxLineItemParams = z
     .object({
     reference: z.string().min(1).max(200),
-    amount: z
-        .number()
-        .int()
-        .nonnegative()
-        .safe()
-        .describe('Unit amount × quantity, minor units. Includes tax when inclusive.'),
+    amount: baseUnitAmountParam
+        .refine((value) => BigInt(value) <= TAX_LINE_AMOUNT_MAX, 'exceeds the largest amount a tax provider prices')
+        .describe('Unit amount × quantity, base units. Includes tax when inclusive.'),
     quantity: z.number().int().positive().max(1000000).optional(),
     tax_code: z
         .string()