@peable.to/contracts 2.0.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/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/vocabulary/catalog.js

@@ -87,20 +87,4 @@ export const BILLING_SETTINGS_LIMITS = Object.freeze({
 /** How a meter combines a period's events into the quantity billed. */
 export const METER_AGGREGATIONS = ['sum', 'count', 'last'];
 export const METER_STATUSES = ['active', 'inactive'];
-// ---- Recurring billing transport (`/v1/billing/*`) ---------------------------
-/** A provider subscription's status, as the recurring transport observes it. */
-export const 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). */
-export const BILLING_RAIL_SETTLEMENTS = ['fiat', 'faircoin'];
-/** `automatic`: the provider charges each period. `payer_initiated`: each period is an explicit payment. */
-export const BILLING_RAIL_RENEWALS = ['automatic', 'payer_initiated'];
 // Product tax codes are Peable Tax's vocabulary: `vocabulary/tax.ts` (`TAX_CODES`).

package/dist/esm/vocabulary/errors.js

@@ -42,19 +42,15 @@ export const 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.',
@@ -83,10 +79,7 @@ export const 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.',
@@ -101,12 +94,9 @@ export const 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.',
@@ -114,9 +104,6 @@ export const 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/esm/vocabulary/events.js

@@ -58,7 +58,6 @@ export const 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',