@saasicat/core 1.0.0-rc.21 → 1.0.0-rc.22

package/dist/.build-stamp

@@ -1 +1 @@
-369e8bc186ed4a646394a1f9b7c7dcc8605204b4bae0e8c40edc4f3b5dd5e378
+91754758b2193699e34b267e3d43034f1ffa6d651baee667fbdf3456d23db8b2

package/dist/index.cjs

@@ -54,6 +54,7 @@ __export(index_exports, {
   REGISTRATION_STEP_BY_STATUS: () => REGISTRATION_STEP_BY_STATUS,
   SETTINGS_ERROR_CODES: () => SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES: () => SETUP_ERROR_CODES,
+  SUBSCRIBER_ACCOUNT_CAPABILITY: () => SUBSCRIBER_ACCOUNT_CAPABILITY,
   SUBSCRIBER_ERROR_CODES: () => SUBSCRIBER_ERROR_CODES,
   applyPromo: () => applyPromo,
   assertPersistenceCapabilities: () => assertPersistenceCapabilities,
@@ -98,6 +99,7 @@ __export(index_exports, {
   selectChargeableBundles: () => selectChargeableBundles,
   settingsSubtreeOf: () => settingsSubtreeOf,
   startOfUtcDay: () => startOfUtcDay,
+  subscriberChargeColumns: () => subscriberChargeColumns,
   subscriberFromRegistration: () => subscriberFromRegistration,
   subscriberPaymentMethodColumns: () => subscriberPaymentMethodColumns,
   toBundleStemRow: () => toBundleStemRow,
@@ -105,9 +107,11 @@ __export(index_exports, {
   toPlanRow: () => toPlanRow,
   toPlanVersionRow: () => toPlanVersionRow,
   toRunningContractIssuer: () => toRunningContractIssuer,
+  toSubscriberChargeRecord: () => toSubscriberChargeRecord,
   toSubscriberCorrectionRecord: () => toSubscriberCorrectionRecord,
   toSubscriberPaymentMethodRecord: () => toSubscriberPaymentMethodRecord,
   toSubscriberRecord: () => toSubscriberRecord,
+  toSubscriptionBundleRecord: () => toSubscriptionBundleRecord,
   toSubscriptionContractRecord: () => toSubscriptionContractRecord
 });
 module.exports = __toCommonJS(index_exports);
@@ -825,7 +829,14 @@ var PAYMENT_ERROR_CODES = {
    * A success or cancel URL at an origin `config/saas.yaml#payments.returnUrlOrigins`
    * does not name. Carries `field`.
    */
-  PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED"
+  PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED",
+  /**
+   * The gateway failed — unreachable, refusing the account's keys, or
+   * answering with an error — while opening its form or reading a callback
+   * back. Answered with 502; what the gateway answered stays in the server
+   * log.
+   */
+  PAYMENT_GATEWAY_FAILED: "PAYMENT_GATEWAY_FAILED"
 };
 var SETTINGS_ERROR_CODES = {
   /** No recorded change has this id, or the installation keeps no record at all. */
@@ -1091,6 +1102,83 @@ function textOrNull(value) {
   return trimmed === "" ? null : trimmed;
 }
 
+// src/closed-value.ts
+function oneOf(allowed, value, source) {
+  const match = allowed.find((entry) => entry === value);
+  if (match === void 0) {
+    throw new Error(
+      `${source.table} row '${source.id}' holds ${source.column} '${value}', which is none of ${allowed.join(", ")}.`
+    );
+  }
+  return match;
+}
+
+// src/subscriber-ledger-mapping.ts
+var ORIGINS = {
+  activation: true,
+  renewal: true,
+  planChange: true,
+  bundleBooking: true,
+  credit: true,
+  correction: true
+};
+var SOURCES = {
+  plan: true,
+  bundle: true,
+  discount: true
+};
+var TABLE = "subscriber_ledger_entries";
+var CENT_TOLERANCE = 1e-6;
+function toSubscriberChargeRecord(row) {
+  const where = (column) => ({ table: TABLE, column, id: row.id });
+  return {
+    id: row.id,
+    subscriberId: row.subscriberId,
+    tenantId: row.tenantId,
+    subscriptionId: row.subscriptionId,
+    contractId: row.contractId,
+    contractLineItemId: row.contractLineItemId,
+    origin: oneOf(keysOf(ORIGINS), row.origin, where("origin")),
+    source: oneOf(keysOf(SOURCES), row.source, where("source")),
+    sourceRef: row.sourceRef,
+    periodStart: row.periodStart,
+    periodEnd: row.periodEnd,
+    currency: row.currency,
+    amountNet: Number(row.amountNet),
+    bookedAt: row.bookedAt,
+    createdAt: row.createdAt
+  };
+}
+function subscriberChargeColumns(charge) {
+  const cents = charge.amountNet * 100;
+  if (!Number.isFinite(cents) || Math.abs(cents - Math.round(cents)) > CENT_TOLERANCE) {
+    throw new Error(
+      `A charge of ${charge.amountNet} is not a whole number of cents; round it once where it is derived, before it is written.`
+    );
+  }
+  return {
+    subscriberId: charge.subscriberId,
+    tenantId: charge.tenantId,
+    subscriptionId: charge.subscriptionId,
+    contractId: charge.contractId,
+    contractLineItemId: charge.contractLineItemId,
+    origin: charge.origin,
+    source: charge.source,
+    sourceRef: charge.sourceRef,
+    periodStart: charge.periodStart,
+    periodEnd: charge.periodEnd,
+    currency: charge.currency,
+    amountNet: charge.amountNet.toFixed(2),
+    bookedAt: charge.bookedAt
+  };
+}
+function keysOf(record) {
+  return Object.keys(record);
+}
+
+// src/subscriber-ledger.types.ts
+var SUBSCRIBER_ACCOUNT_CAPABILITY = "charges.read";
+
 // src/subscriber-mapping.ts
 function formatCustomerNumber(prefix, sequence) {
   return `${prefix}${sequence}`;
@@ -1206,6 +1294,7 @@ function toIdentityValues(value) {
 // src/subscriber-payment-method-mapping.ts
 var PAYMENT_METHOD_TYPES = ["card", "sepa_debit"];
 var STATUSES = ["ACTIVE", "REPLACED"];
+var TABLE2 = "subscriber_payment_methods";
 function toSubscriberPaymentMethodRecord(row) {
   return {
     id: row.id,
@@ -1214,7 +1303,7 @@ function toSubscriberPaymentMethodRecord(row) {
     provider: row.provider,
     customerRef: row.customerRef,
     paymentMethodRef: row.paymentMethodRef,
-    type: oneOf(PAYMENT_METHOD_TYPES, row.type, "type", row.id),
+    type: oneOf(PAYMENT_METHOD_TYPES, row.type, { table: TABLE2, column: "type", id: row.id }),
     brand: row.brand,
     last4: row.last4,
     expiryMonth: row.expiryMonth,
@@ -1222,7 +1311,7 @@ function toSubscriberPaymentMethodRecord(row) {
     country: row.country,
     bankCode: row.bankCode,
     mandateReference: row.mandateReference,
-    status: oneOf(STATUSES, row.status, "status", row.id),
+    status: oneOf(STATUSES, row.status, { table: TABLE2, column: "status", id: row.id }),
     confirmedAt: row.confirmedAt,
     replacedAt: row.replacedAt,
     createdAt: row.createdAt
@@ -1246,15 +1335,6 @@ function subscriberPaymentMethodColumns(data) {
     confirmedAt: data.confirmedAt
   };
 }
-function oneOf(allowed, value, column, id) {
-  const match = allowed.find((entry) => entry === value);
-  if (match === void 0) {
-    throw new Error(
-      `subscriber_payment_methods row '${id}' holds ${column} '${value}', which is none of ${allowed.join(", ")}.`
-    );
-  }
-  return match;
-}
 var FOREIGN_PAYMENT_METHOD_REFERENCE = "FOREIGN_PAYMENT_METHOD_REFERENCE";
 var ForeignPaymentMethodReferenceError = class extends Error {
   constructor(gatewayAccount, paymentMethodRef) {
@@ -1280,6 +1360,30 @@ function refuseForeignPaymentMethodReference(recorded, subscriberId) {
   );
 }
 
+// src/subscription-bundle-mapping.ts
+var BILLING_CYCLES = ["MONTHLY", "YEARLY"];
+function toSubscriptionBundleRecord(row) {
+  const billingCycle = row.billingCycle ?? null;
+  return {
+    id: row.id,
+    subscriptionId: row.subscriptionId,
+    bundleVersionId: row.bundleVersionId,
+    startedAt: row.startedAt,
+    minimumTermEndsAt: row.minimumTermEndsAt,
+    billingCycle: billingCycle === null ? null : oneOf(BILLING_CYCLES, billingCycle, {
+      table: "subscription_bundles",
+      column: "billingCycle",
+      id: row.id
+    }),
+    currentPeriodStart: row.currentPeriodStart ?? null,
+    currentPeriodEnd: row.currentPeriodEnd ?? null,
+    canceledAt: row.canceledAt,
+    canceledEffectiveAt: row.canceledEffectiveAt,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt
+  };
+}
+
 // src/subscription-contract-mapping.ts
 function toSubscriptionContractRecord(row, lineItems) {
   return {
@@ -1615,6 +1719,7 @@ var ERROR_MESSAGES_EN = {
   PAYMENT_GATEWAY_ACCOUNT_UNKNOWN: "No payment gateway account is configured under '{account}'.",
   PAYMENT_CALLBACK_REJECTED: "The payment callback could not be verified.",
   PAYMENT_RETURN_URL_NOT_ALLOWED: "The {field} leads to a site this installation does not return to.",
+  PAYMENT_GATEWAY_FAILED: "The payment provider did not answer as expected. Please try again in a few minutes.",
   // ── entitlement (code lives in upsell.types.ts) ──
   [FEATURE_NOT_LICENSED]: "Feature {featureKeys} is not included in the current plan.",
   // ── settings ──
@@ -1825,6 +1930,7 @@ var ERROR_MESSAGES_DE = {
   PAYMENT_GATEWAY_ACCOUNT_UNKNOWN: "Unter '{account}' ist kein Konto eines Zahlungsanbieters eingerichtet.",
   PAYMENT_CALLBACK_REJECTED: "Die R\xFCckmeldung des Zahlungsanbieters lie\xDF sich nicht pr\xFCfen.",
   PAYMENT_RETURN_URL_NOT_ALLOWED: "Die {field} f\xFChrt auf eine Seite, zu der diese Installation nicht zur\xFCckleitet.",
+  PAYMENT_GATEWAY_FAILED: "Der Zahlungsanbieter hat nicht wie erwartet geantwortet. Bitte versuche es in ein paar Minuten noch einmal.",
   // ── entitlement (code lives in upsell.types.ts) ──
   [FEATURE_NOT_LICENSED]: "Das Feature {featureKeys} ist im aktuellen Plan nicht enthalten.",
   // ── settings ──
@@ -1866,6 +1972,7 @@ var ERROR_MESSAGES_DE = {
   REGISTRATION_STEP_BY_STATUS,
   SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES,
+  SUBSCRIBER_ACCOUNT_CAPABILITY,
   SUBSCRIBER_ERROR_CODES,
   applyPromo,
   assertPersistenceCapabilities,
@@ -1910,6 +2017,7 @@ var ERROR_MESSAGES_DE = {
   selectChargeableBundles,
   settingsSubtreeOf,
   startOfUtcDay,
+  subscriberChargeColumns,
   subscriberFromRegistration,
   subscriberPaymentMethodColumns,
   toBundleStemRow,
@@ -1917,8 +2025,10 @@ var ERROR_MESSAGES_DE = {
   toPlanRow,
   toPlanVersionRow,
   toRunningContractIssuer,
+  toSubscriberChargeRecord,
   toSubscriberCorrectionRecord,
   toSubscriberPaymentMethodRecord,
   toSubscriberRecord,
+  toSubscriptionBundleRecord,
   toSubscriptionContractRecord
 });

package/dist/index.d.cts

@@ -643,12 +643,19 @@ interface PaymentGateway {
     /**
      * Opens the gateway's form for a payment method. Nothing is confirmed until
      * the gateway says so through `readCallback`.
+     *
+     * A failure is thrown as the provider reported it: the platform answers the
+     * person with `PAYMENT_GATEWAY_FAILED` and keeps what the error carries —
+     * its kind, code, status and request id — in the server log.
      */
     startPaymentMethodSetup(input: StartPaymentMethodSetupInput): Promise<PaymentMethodSetupSession>;
     /**
      * Verifies a callback with the account's secret and translates it.
      * Throws `PaymentCallbackRejectedError` for anything the gateway did not
-     * send, before a single field of it is trusted.
+     * send, before a single field of it is trusted. Any other failure is
+     * answered with `PAYMENT_GATEWAY_FAILED` and 502, like one of
+     * `startPaymentMethodSetup` — to the gateway's webhook, or to the person
+     * an `immediateCallback` is read for.
      */
     readCallback(callback: PaymentGatewayCallback): Promise<PaymentGatewayEvent>;
 }
@@ -1103,7 +1110,7 @@ interface SubscriptionBundleRecord {
      * or on one whose plan has no period; readers fall back to the plan's
      * cycle, which is what every booking used before.
      */
-    billingCycle: string | null;
+    billingCycle: BillingCycle | null;
     currentPeriodStart: Date | null;
     currentPeriodEnd: Date | null;
     createdAt: Date;
@@ -1137,7 +1144,7 @@ interface CreateSubscriptionBundleData {
     /** Null unless a commitment was configured or asked for. */
     minimumTermEndsAt?: Date | null;
     /** The rhythm and window worked out above this port. */
-    billingCycle?: string | null;
+    billingCycle?: BillingCycle | null;
     currentPeriodStart?: Date | null;
     currentPeriodEnd?: Date | null;
 }
@@ -2206,6 +2213,16 @@ interface EffectiveLimitsSnapshot {
     plan: string;
     quotas: Record<string, number>;
     features: string[];
+    /**
+     * The add-ons a contract left out of these entitlements because their
+     * cancellation was already declared when it was written. Each is granted by
+     * its booking until its effective date, and by this snapshot never.
+     *
+     * Absent where nothing was left out — and on a snapshot written by an
+     * application, or before the platform left anything out, which then counts
+     * every add-on it names as its own.
+     */
+    leftOutBundleVersionIds?: string[];
 }
 
 interface FeatureUiMeta {
@@ -3511,6 +3528,128 @@ interface SubscriberCorrectionResult {
     correction: SubscriberCorrectionRecord | null;
 }
 
+/**
+ * What made the charge arise. activation: the first period of a subscription. renewal: a later period. planChange: what an immediate plan change adds. bundleBooking: the first, short period of an add-on. credit: a decision that reduces what is owed. correction: a counter-entry reversing an earlier charge, which is how the append-only journal answers a mistake.
+ */
+type SubscriberChargeOrigin = 'activation' | 'renewal' | 'planChange' | 'bundleBooking' | 'credit' | 'correction';
+/**
+ * Which kind of contract line the charge realises.
+ */
+type SubscriberChargeSource = 'plan' | 'bundle' | 'discount';
+/**
+ * One charge in a subscriber's account: an amount that became due for a period, derived from a line of the contract in force. The journal is append-only — a charge is never updated, and a mistake is answered with a counter-entry rather than an edit, so the account says what happened rather than what somebody thinks today. A charge is net: the tax is decided by the tax adapter when the charge is invoiced, from the subscriber's origin on that day, and computed once per rate on the invoice.
+ */
+interface SubscriberCharge {
+    /**
+     * The charge's own identifier. Never shown to a customer as an invoice number: invoice numbering is sequential, gapless and legally constrained per country, and an identifier somebody has already seen on a screen cannot become one later without confusion.
+     */
+    id: string;
+    /**
+     * The party the contract is concluded with, whose account this is. It outlives the tenant.
+     */
+    subscriberId: string;
+    /**
+     * The tenant the subscription belonged to when the charge arose.
+     */
+    tenantId: string;
+    /**
+     * The subscription the charge arose on. Part of the natural key.
+     */
+    subscriptionId: string;
+    /**
+     * The contract whose line the charge realises.
+     */
+    contractId: string;
+    /**
+     * The contract line the charge came from, so that every invoice line can be traced back to what was agreed.
+     */
+    contractLineItemId: string;
+    origin: SubscriberChargeOrigin;
+    source: SubscriberChargeSource;
+    /**
+     * Which thing of its source the charge is for, stable across contracts: the subscription id for the plan, the booking id for an add-on, the discount's key for a discount. Part of the natural key (subscriptionId, source, sourceRef, periodStart, origin), which is unique — a charge derived twice is written once.
+     */
+    sourceRef: string;
+    /**
+     * The start of the period the charge belongs to — the grouping key for an invoice.
+     */
+    periodStart: string;
+    periodEnd: string;
+    /**
+     * ISO 4217, as the contract line records it — recorded per charge so that a charge written in 2026 still means what it meant after the configured currency changes.
+     */
+    currency: string;
+    /**
+     * Net, rounded to the currency's decimal places once, when the charge is written; the written figure is the truth from then on. Negative for a discount.
+     */
+    amountNet: number;
+    /**
+     * When the amount became due. The account is ordered by this, not by when the row was written.
+     */
+    bookedAt: string;
+    createdAt: string;
+}
+
+/** A charge as a store reads it back: the wire format, with its dates as dates. */
+interface SubscriberChargeRecord {
+    id: string;
+    subscriberId: string;
+    tenantId: string;
+    subscriptionId: string;
+    contractId: string;
+    contractLineItemId: string;
+    origin: SubscriberChargeOrigin;
+    source: SubscriberChargeSource;
+    /** The subscription id for the plan, the booking id for an add-on, the discount's key. */
+    sourceRef: string;
+    periodStart: Date;
+    periodEnd: Date;
+    currency: string;
+    /** Net, rounded to the cent when written. Negative for a discount. */
+    amountNet: number;
+    /** When the amount became due. */
+    bookedAt: Date;
+    createdAt: Date;
+}
+/** A charge to write: everything but what the store assigns. */
+type NewSubscriberCharge = Omit<SubscriberChargeRecord, 'id' | 'createdAt'>;
+/**
+ * The manifest capability that announces the operator's view of an account.
+ * The platform sets it where it serves the view, and the admin UI shows the
+ * view only where it is set.
+ */
+declare const SUBSCRIBER_ACCOUNT_CAPABILITY = "charges.read";
+/** Whose account it is, as the operator is shown it. */
+interface AdminAccountHolder {
+    id: string;
+    /** What the customer quotes, and what an invoice will carry. */
+    customerNumber: string;
+    legalName: string;
+}
+/** One charge of an account, with the name its contract line gives it. */
+interface AdminAccountEntry {
+    /** The charge as the journal holds it. */
+    charge: SubscriberCharge;
+    /**
+     * The contract line's own title, as it was when the contract was
+     * concluded, or `null` where that line cannot be read.
+     */
+    title: string | null;
+}
+/**
+ * A tenant's account as the operator reads it: the charges of the subscription
+ * it holds, newest first — by when each became due, then by its period, then
+ * the plan before its add-ons before its discounts.
+ *
+ * No total: without invoices and payments, a sum would be what was charged so
+ * far, and it would be read as what is owed.
+ */
+interface AdminSubscriberAccount {
+    /** `null` for a tenant that has no subscriber. */
+    holder: AdminAccountHolder | null;
+    entries: AdminAccountEntry[];
+}
+
 /**
  * Snapshot form of a `Subscription` row for the EntitlementService
  * computation. The consumer maps its Prisma structure onto this form.
@@ -3758,6 +3897,27 @@ interface SubscriberRepository {
     /** Every correction of this subscriber, the latest first. */
     listCorrections(subscriberId: string): Promise<SubscriberCorrectionRecord[]>;
 }
+/**
+ * The subscriber's account: the charges that became due, one per contract line
+ * and period. Append-only — nothing here updates or deletes a charge, and a
+ * mistake is answered with a counter-entry (`SC-PRIC-020`).
+ *
+ * Owned by the subscriber rather than the tenant, so that it outlives the
+ * tenant it arose for (ADR 0012).
+ */
+interface SubscriberLedgerRepository {
+    /**
+     * Writes the charges that are not there yet and returns them.
+     *
+     * A charge whose natural key — subscription, source, source reference,
+     * period start and origin — is already written is left as it is and not
+     * returned, however often it is derived and whoever derives it at the same
+     * time: the unique index decides, not a read before the write.
+     */
+    recordCharges(charges: readonly NewSubscriberCharge[], tx?: TransactionContext): Promise<SubscriberChargeRecord[]>;
+    /** Every charge of one subscription, oldest period first. */
+    listBySubscription(subscriptionId: string, tx?: TransactionContext): Promise<SubscriberChargeRecord[]>;
+}
 /**
  * Display form of a subscription for the tenant self-service UI.
  * Richer than `SubscriptionRecord` (which is only the aggregation form); contains
@@ -5085,6 +5245,8 @@ interface SaaSiCatPersistenceEntitlement {
     subscriptionContractRepository?: PersistenceProvider<SubscriptionContractRepository>;
     /** The parties contracts are concluded with; required wherever contracts are written. */
     subscriberRepository?: PersistenceProvider<SubscriberRepository>;
+    /** The charges a subscriber's contracts give rise to (`tenantBilling.chargeJournal`). */
+    subscriberLedgerRepository?: PersistenceProvider<SubscriberLedgerRepository>;
     subscriptionBundleRepository?: PersistenceProvider<SubscriptionBundleRepository>;
     bundleRepository?: PersistenceProvider<BundleRepository>;
 }
@@ -5530,6 +5692,13 @@ declare const PAYMENT_ERROR_CODES: {
      * does not name. Carries `field`.
      */
     readonly PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED";
+    /**
+     * The gateway failed — unreachable, refusing the account's keys, or
+     * answering with an error — while opening its form or reading a callback
+     * back. Answered with 502; what the gateway answered stays in the server
+     * log.
+     */
+    readonly PAYMENT_GATEWAY_FAILED: "PAYMENT_GATEWAY_FAILED";
 };
 type PaymentErrorCode = (typeof PAYMENT_ERROR_CODES)[keyof typeof PAYMENT_ERROR_CODES];
 /** Codes of the settings record (`GET /admin/settings`, the acknowledgement). */
@@ -5562,6 +5731,13 @@ declare const PLATFORM_ERROR_CODES: {
      * does not name. Carries `field`.
      */
     readonly PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED";
+    /**
+     * The gateway failed — unreachable, refusing the account's keys, or
+     * answering with an error — while opening its form or reading a callback
+     * back. Answered with 502; what the gateway answered stays in the server
+     * log.
+     */
+    readonly PAYMENT_GATEWAY_FAILED: "PAYMENT_GATEWAY_FAILED";
     readonly PENDING_REGISTRATION_NOT_FOUND: "PENDING_REGISTRATION_NOT_FOUND";
     readonly PENDING_REGISTRATION_EXPIRED: "PENDING_REGISTRATION_EXPIRED";
     readonly INVALID_REGISTRATION_STATE: "INVALID_REGISTRATION_STATE";
@@ -6779,6 +6955,47 @@ type IssuerIdentityChange =
  */
 declare function classifyIssuerChange(recorded: LegalIdentity | null, issuer: PlanCatalogIssuer | undefined): IssuerIdentityChange;
 
+/**
+ * A `subscriber_ledger_entries` row as either adapter reads it back. The amount
+ * is `unknown` because a Prisma row carries a `Decimal` where a Drizzle row
+ * carries a numeric string.
+ */
+interface CanonicalSubscriberChargeRow {
+    id: string;
+    subscriberId: string;
+    tenantId: string;
+    subscriptionId: string;
+    contractId: string;
+    contractLineItemId: string;
+    origin: string;
+    source: string;
+    sourceRef: string;
+    periodStart: Date;
+    periodEnd: Date;
+    currency: string;
+    amountNet: unknown;
+    bookedAt: Date;
+    createdAt: Date;
+}
+/**
+ * Reads a row back as a record. The origin and the source are checked rather
+ * than cast: a value written by hand or by a later release would otherwise
+ * reach an invoice as a charge nobody knows how to read.
+ */
+declare function toSubscriberChargeRecord(row: CanonicalSubscriberChargeRow): SubscriberChargeRecord;
+/**
+ * The columns a charge is written with. The amount goes as a decimal string of
+ * two places, which both a Prisma `Decimal` and a PostgreSQL `numeric` take
+ * exactly — a JavaScript number on its way to either is where a cent is lost.
+ *
+ * An amount that is not already a whole number of cents is refused rather than
+ * rounded: a charge is rounded once, where it is derived, and a second rounding
+ * here would make the written figure differ from the one that was computed.
+ */
+declare function subscriberChargeColumns(charge: NewSubscriberCharge): Omit<CanonicalSubscriberChargeRow, 'id' | 'createdAt' | 'amountNet'> & {
+    amountNet: string;
+};
+
 /** A `subscribers` row as either adapter reads it back. */
 interface CanonicalSubscriberRow {
     id: string;
@@ -6907,6 +7124,37 @@ declare function isForeignPaymentMethodReferenceError(error: unknown): error is
  */
 declare function refuseForeignPaymentMethodReference(recorded: Pick<CanonicalSubscriberPaymentMethodRow, 'subscriberId' | 'gatewayAccount' | 'paymentMethodRef'>, subscriberId: string): void;
 
+/**
+ * A `subscription_bundles` row as either adapter reads it back.
+ *
+ * The three billing columns are optional because a Prisma client generated from
+ * a schema that predates them returns a row without them; an absent column
+ * reads as null, the same as a booking made before they existed.
+ */
+interface CanonicalSubscriptionBundleRow {
+    id: string;
+    subscriptionId: string;
+    bundleVersionId: string;
+    startedAt: Date;
+    minimumTermEndsAt: Date | null;
+    billingCycle?: string | null;
+    currentPeriodStart?: Date | null;
+    currentPeriodEnd?: Date | null;
+    canceledAt: Date | null;
+    canceledEffectiveAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Reads a row back as a record.
+ *
+ * `billingCycle` is a text column the platform only ever writes as `MONTHLY` or
+ * `YEARLY`, and a price is chosen by asking whether it is `YEARLY` — so any
+ * other value would be billed monthly without a word. It is checked rather than
+ * cast, and a value outside the two stops the read.
+ */
+declare function toSubscriptionBundleRecord(row: CanonicalSubscriptionBundleRow): SubscriptionBundleRecord;
+
 /** A `subscription_contracts` row as either adapter reads it back. */
 interface CanonicalContractRow {
     id: string;
@@ -7050,4 +7298,4 @@ declare function resolveErrorMessage(body: ResolvableErrorBody, overrides?: Part
 
 declare const ERROR_MESSAGES_DE: Record<PlatformErrorCode, string>;
 
-export { ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES, AUTH_ERROR_CODES, type ActionKey, type ActivationOrchestrator, type ActivePlanVersionWhere, type ActivePlanVersionWhereWithEndsAt, type ActiveVersionWhere, type ActiveVersionWhereWithEndsAt, type ActorTag, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminUserListFilter, type AdminUserListRow, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionRow, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalRunningContractRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberPaymentMethodRow, type CanonicalSubscriberRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type ChangeDirection, type CheckoutOfferFilter, type CheckoutOfferLineItem, type CheckoutOfferLineItemKind, type CheckoutOfferPriceBreakdown, type CheckoutOfferPromoCodeSnapshot, type CheckoutOfferPromotionSnapshot, type CheckoutOfferRepository, type CheckoutOfferRow, type CheckoutOfferSelection, type CheckoutOfferSelectionUpdate, type CheckoutOfferStatus, type CleanupResult, type CliUserRow, type ComponentKey, type ConfiguratorCatalog, type ConfiguratorMarketingProvider, type ConfiguratorModel, type ConfiguratorPlanMarketing, type ConfiguratorPlanVersionRow, type ConfiguratorPriceBreakdown, type ConfiguratorSourcesLookup, type ConfirmedPaymentMethod, type ContractErrorCode, type ContractIssuerParty, type ContractLineItemKind, type ContractLineItemRecord, type ContractSubscriberParty, type CreateBundleData, type CreateBundleVersionDraftData, type CreateCheckoutOfferData, type CreateMarketingProjectionData, type CreatePlanData, type CreatePlanVersionDraftData, type CreatePromoCodeData, type CreatePromoCodeRequest, type CreatePromotionData, type CreateSubscriberData, type CreateSubscriptionBundleData, type CreateSubscriptionContractData, type CreateSuperAdminCliInput, type CreateTenantInput, type DiffResult, type DiscoveredCapability, type DiscoveredFeature, type DiscoveredQuota, type DiscoveredQuotaPolicy, type DiscoveryCodeStatus, type DiscoverySnapshot, type DiscoveryStatus, ERROR_MESSAGES_DE, ERROR_MESSAGES_EN, type EffectiveLimitsSnapshot, type EmailPort, type ErrorMessageParams, FEATURE_NOT_LICENSED, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FinalActivationResult, type FirstTimeCustomerCheck, ForeignPaymentMethodReferenceError, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type IssuerCorrectionFault, type IssuerIdentityChange, type KpiCardDef, type KpiDisplayHint, LEGAL_IDENTITY_FIELDS, type LegalIdentity, type LegalIdentityField, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MaskedPaymentMethod, type MfaPort, type NewContractLineItemData, type NewSettingsChange, type NewSubscriberDetails, type NewSubscriptionContractData, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, PASSWORD_RESET_TTL_MINUTES, PAYMENT_ERROR_CODES, PAYMENT_METHOD_TYPES, PENDING_CHECKOUT_TTL_DAYS, PENDING_EMAIL_TTL_HOURS, PENDING_ONBOARDING_TTL_DAYS, PLATFORM_ERROR_CODES, PROMO_ERROR_CODES, type Paginated, type PartyAddress, type PasswordHasher, type PasswordResetCliResult, PaymentCallbackRejectedError, type PaymentErrorCode, type PaymentEventClaim, type PaymentEventLog, type PaymentGateway, type PaymentGatewayCallback, type PaymentGatewayEvent, type PaymentMethodHolder, type PaymentMethodSetupSession, type PaymentMethodSetupSubject, type PaymentMethodType, type PendingRegistration, type PendingRegistrationCreateInput, type PendingRegistrationRepository, type PendingRegistrationSnapshot, type PendingRegistrationUpdateInput, type PersistenceCapabilities, PersistenceCapabilityError, type PersistenceClassRef, type PersistenceInjectionToken, type PersistenceProvider, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogIssuer, type PlanCatalogIssuerCorrection, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogPaymentAccount, type PlanCatalogPayments, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogSettings, type PlanCatalogSubscribers, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMappingFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformRole, type PlatformUserDto, PlatformUserExistsError, type ProjectPageDef, type PromoCode, type PromoCodeDurationType, type PromoCodeFilter, type PromoCodeHoldRecord, type PromoCodeHoldRepository, type PromoCodeHoldTaken, type PromoCodeRecord, type PromoCodeRedemption, type PromoCodeRedemptionListItem, type PromoCodeRedemptionRecord, type PromoCodeRedemptionRepository, type PromoCodeRedemptionStatus, type PromoCodeRepository, type PromoCodeStatsPort, type PromoCodeStatsSnapshot, type PromoCodeStatus, type PromoCodeValidationLog, type PromoCodeValidationLogRepository, type PromoCodeValidationResult, type PromoCodeValueType, type PromoErrorCode, type PromoPreviewInvalidReason, type PromoPreviewRequest, type PromoPreviewResponse, type PromoPreviewValidResponse, type PromoRevenueDeductionAggregator, type PromoSubscriptionLookup, type PromotionBillingCycle, type PromotionI18n, type PromotionI18nFields, type PromotionOnPrice, type PromotionRepository, type PromotionResult, type PromotionRow, type PromotionStatus, type PromotionTargetType, type PromotionType, type PromotionValue, type PublicBootResponse, type PublicComparisonRow, type PublicMarketingBundle, type PublicMarketingCatalogResponse, type PublicMarketingPlan, type PublicMarketingPromo, type PublicNewPaymentMethods, type PublicSignupPlan, type PublishBundleVersionData, type PublishBundleVersionMeta, type PublishPlanVersionData, type QuotaCatalogEntryRow, type QuotaEnforcementMode, type QuotaKey, type QuotaProvider, REGISTRATION_ERROR_CODES, REGISTRATION_RESUME_TTL_MINUTES, REGISTRATION_STEP_BY_STATUS, type ReassignTenantAdminCliResult, type RecommendablePlan, type RecordSubscriberPaymentMethodData, type RecordSubscriberPaymentMethodOutcome, type RecordSubscriberPaymentMethodResult, type RedeemPromoInTransactionCallback, type RegistrationActivation, type RegistrationAuditContext, type RegistrationAuditEvent, type RegistrationAuditEventType, type RegistrationAuditLogger, type RegistrationBillingDetails, type RegistrationConfigSelection, type RegistrationConfiguratorLookup, type RegistrationErrorCode, type RegistrationOtpDelivery, type RegistrationPromoPreview, type RegistrationResumeDelivery, type RegistrationResumeTokenSigner, type RegistrationStatus, type RegistrationStep, type RequiredCapabilities, type ResolvableErrorBody, type ResumeRegistrationInput, type ResumeRegistrationResult, type ReviewCatalogEntryData, type RlsBypassPort, type RunningContractIssuer, type RunningContractIssuers, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ERROR_CODES, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePayments, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledPlanChangeInput, type SelectPlanInput, type SelectPlanResult, type SelectableBundleShape, type SelfServiceBlockedPlans, type SetCatalogEntryReviewData, type SettingsChangeFilter, type SettingsChangeRecord, type SettingsDifference, type SettingsErrorCode, type SetupConfirmMfaRequest, type SetupConfirmMfaResponse, type SetupErrorCode, type SetupRequest, type SetupResult, type SetupStatusResponse, type SlugAvailabilityCheck, type StandardPageDef, type StandardPageKey, type StartCheckoutInput, type StartCheckoutResult, type StartPaymentMethodSetupInput, type StartRegistrationInput, type StartRegistrationResult, type StoredBundleStem, type StrictModeWarning, type StrictModeWarningCode, type SubscriberContact, type SubscriberContactChange, type SubscriberCorrectionData, type SubscriberCorrectionRecord, type SubscriberCorrectionResult, type SubscriberDetails, type SubscriberErrorCode, type SubscriberIdentityCorrection, type SubscriberIdentityDelta, type SubscriberIdentityValues, type SubscriberPaymentMethodRecord, type SubscriberPaymentMethodReference, type SubscriberPaymentMethodRepository, type SubscriberPaymentMethodSetupData, type SubscriberPaymentMethodSetupMatch, type SubscriberPaymentMethodStatus, type SubscriberRecord, type SubscriberRepository, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SyncDiscoveryResult, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionWritePort, type TerminateSubscriptionContractData, type TopPromoCode, type TransactionContext, type TransactionRunner, type UpdateBundleData, type UpdateBundleVersionDraftData, type UpdateCatalogEntryBaseData, type UpdateCatalogEntryI18nData, type UpdateCheckoutOfferData, type UpdateMarketingProjectionData, type UpdateMarketingSettingsData, type UpdatePlanData, type UpdatePlanVersionDraftData, type UpdatePromoCodeData, type UpdatePromoCodeRequest, type UpdatePromotionData, type UpsellOffer, type UpsellOfferResolver, type UpsertCapabilityEntryData, type UpsertFeatureCatalogEntryInput, type UpsertFeatureEntryData, type UpsertPlanInput, type UpsertPlanVersionInput, type UpsertQuotaEntryData, type UpsertResult, type UsageSnapshotPort, type UserAccountLookup, type UserListFilter, type UserManagementPort, type UserPort, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleStemDefaults, canonicalJson, classifyBundleVersionDiff, classifyIssuerChange, classifyPlanDiff, collectUnsatisfiedRequires, contractPartiesOf, coverageExcludingSelf, definedFields, diffSettings, formatCustomerNumber, formatErrorMessage, identityCorrectionDelta, isBundleRedundant, isForeignPaymentMethodReferenceError, isPaymentCallbackRejectedError, isPlatformUserExistsError, isVersionEditable, issuerIdentityOf, keepOneRecommended, missingRequiresFor, movedIdentityFields, pickActivePromo, planCatalogSettingsOf, previousUtcDay, promoStatus, promotionOnPrice, readQuotaRecord, readQuotaValue, recordedIssuerIdentity, refuseForeignPaymentMethodReference, resolveBundleAvailability, resolveErrorMessage, sameLegalIdentity, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberFromRegistration, subscriberPaymentMethodColumns, toBundleStemRow, toContractLineItemRecord, toPlanRow, toPlanVersionRow, toRunningContractIssuer, toSubscriberCorrectionRecord, toSubscriberPaymentMethodRecord, toSubscriberRecord, toSubscriptionContractRecord };
+export { ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES, AUTH_ERROR_CODES, type ActionKey, type ActivationOrchestrator, type ActivePlanVersionWhere, type ActivePlanVersionWhereWithEndsAt, type ActiveVersionWhere, type ActiveVersionWhereWithEndsAt, type ActorTag, type AdminAccountEntry, type AdminAccountHolder, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriberAccount, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminUserListFilter, type AdminUserListRow, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionRow, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalRunningContractRow, type CanonicalSubscriberChargeRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberPaymentMethodRow, type CanonicalSubscriberRow, type CanonicalSubscriptionBundleRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type ChangeDirection, type CheckoutOfferFilter, type CheckoutOfferLineItem, type CheckoutOfferLineItemKind, type CheckoutOfferPriceBreakdown, type CheckoutOfferPromoCodeSnapshot, type CheckoutOfferPromotionSnapshot, type CheckoutOfferRepository, type CheckoutOfferRow, type CheckoutOfferSelection, type CheckoutOfferSelectionUpdate, type CheckoutOfferStatus, type CleanupResult, type CliUserRow, type ComponentKey, type ConfiguratorCatalog, type ConfiguratorMarketingProvider, type ConfiguratorModel, type ConfiguratorPlanMarketing, type ConfiguratorPlanVersionRow, type ConfiguratorPriceBreakdown, type ConfiguratorSourcesLookup, type ConfirmedPaymentMethod, type ContractErrorCode, type ContractIssuerParty, type ContractLineItemKind, type ContractLineItemRecord, type ContractSubscriberParty, type CreateBundleData, type CreateBundleVersionDraftData, type CreateCheckoutOfferData, type CreateMarketingProjectionData, type CreatePlanData, type CreatePlanVersionDraftData, type CreatePromoCodeData, type CreatePromoCodeRequest, type CreatePromotionData, type CreateSubscriberData, type CreateSubscriptionBundleData, type CreateSubscriptionContractData, type CreateSuperAdminCliInput, type CreateTenantInput, type DiffResult, type DiscoveredCapability, type DiscoveredFeature, type DiscoveredQuota, type DiscoveredQuotaPolicy, type DiscoveryCodeStatus, type DiscoverySnapshot, type DiscoveryStatus, ERROR_MESSAGES_DE, ERROR_MESSAGES_EN, type EffectiveLimitsSnapshot, type EmailPort, type ErrorMessageParams, FEATURE_NOT_LICENSED, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FinalActivationResult, type FirstTimeCustomerCheck, ForeignPaymentMethodReferenceError, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type IssuerCorrectionFault, type IssuerIdentityChange, type KpiCardDef, type KpiDisplayHint, LEGAL_IDENTITY_FIELDS, type LegalIdentity, type LegalIdentityField, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MaskedPaymentMethod, type MfaPort, type NewContractLineItemData, type NewSettingsChange, type NewSubscriberCharge, type NewSubscriberDetails, type NewSubscriptionContractData, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, PASSWORD_RESET_TTL_MINUTES, PAYMENT_ERROR_CODES, PAYMENT_METHOD_TYPES, PENDING_CHECKOUT_TTL_DAYS, PENDING_EMAIL_TTL_HOURS, PENDING_ONBOARDING_TTL_DAYS, PLATFORM_ERROR_CODES, PROMO_ERROR_CODES, type Paginated, type PartyAddress, type PasswordHasher, type PasswordResetCliResult, PaymentCallbackRejectedError, type PaymentErrorCode, type PaymentEventClaim, type PaymentEventLog, type PaymentGateway, type PaymentGatewayCallback, type PaymentGatewayEvent, type PaymentMethodHolder, type PaymentMethodSetupSession, type PaymentMethodSetupSubject, type PaymentMethodType, type PendingRegistration, type PendingRegistrationCreateInput, type PendingRegistrationRepository, type PendingRegistrationSnapshot, type PendingRegistrationUpdateInput, type PersistenceCapabilities, PersistenceCapabilityError, type PersistenceClassRef, type PersistenceInjectionToken, type PersistenceProvider, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogIssuer, type PlanCatalogIssuerCorrection, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogPaymentAccount, type PlanCatalogPayments, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogSettings, type PlanCatalogSubscribers, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMappingFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformRole, type PlatformUserDto, PlatformUserExistsError, type ProjectPageDef, type PromoCode, type PromoCodeDurationType, type PromoCodeFilter, type PromoCodeHoldRecord, type PromoCodeHoldRepository, type PromoCodeHoldTaken, type PromoCodeRecord, type PromoCodeRedemption, type PromoCodeRedemptionListItem, type PromoCodeRedemptionRecord, type PromoCodeRedemptionRepository, type PromoCodeRedemptionStatus, type PromoCodeRepository, type PromoCodeStatsPort, type PromoCodeStatsSnapshot, type PromoCodeStatus, type PromoCodeValidationLog, type PromoCodeValidationLogRepository, type PromoCodeValidationResult, type PromoCodeValueType, type PromoErrorCode, type PromoPreviewInvalidReason, type PromoPreviewRequest, type PromoPreviewResponse, type PromoPreviewValidResponse, type PromoRevenueDeductionAggregator, type PromoSubscriptionLookup, type PromotionBillingCycle, type PromotionI18n, type PromotionI18nFields, type PromotionOnPrice, type PromotionRepository, type PromotionResult, type PromotionRow, type PromotionStatus, type PromotionTargetType, type PromotionType, type PromotionValue, type PublicBootResponse, type PublicComparisonRow, type PublicMarketingBundle, type PublicMarketingCatalogResponse, type PublicMarketingPlan, type PublicMarketingPromo, type PublicNewPaymentMethods, type PublicSignupPlan, type PublishBundleVersionData, type PublishBundleVersionMeta, type PublishPlanVersionData, type QuotaCatalogEntryRow, type QuotaEnforcementMode, type QuotaKey, type QuotaProvider, REGISTRATION_ERROR_CODES, REGISTRATION_RESUME_TTL_MINUTES, REGISTRATION_STEP_BY_STATUS, type ReassignTenantAdminCliResult, type RecommendablePlan, type RecordSubscriberPaymentMethodData, type RecordSubscriberPaymentMethodOutcome, type RecordSubscriberPaymentMethodResult, type RedeemPromoInTransactionCallback, type RegistrationActivation, type RegistrationAuditContext, type RegistrationAuditEvent, type RegistrationAuditEventType, type RegistrationAuditLogger, type RegistrationBillingDetails, type RegistrationConfigSelection, type RegistrationConfiguratorLookup, type RegistrationErrorCode, type RegistrationOtpDelivery, type RegistrationPromoPreview, type RegistrationResumeDelivery, type RegistrationResumeTokenSigner, type RegistrationStatus, type RegistrationStep, type RequiredCapabilities, type ResolvableErrorBody, type ResumeRegistrationInput, type ResumeRegistrationResult, type ReviewCatalogEntryData, type RlsBypassPort, type RunningContractIssuer, type RunningContractIssuers, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ACCOUNT_CAPABILITY, SUBSCRIBER_ERROR_CODES, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePayments, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledPlanChangeInput, type SelectPlanInput, type SelectPlanResult, type SelectableBundleShape, type SelfServiceBlockedPlans, type SetCatalogEntryReviewData, type SettingsChangeFilter, type SettingsChangeRecord, type SettingsDifference, type SettingsErrorCode, type SetupConfirmMfaRequest, type SetupConfirmMfaResponse, type SetupErrorCode, type SetupRequest, type SetupResult, type SetupStatusResponse, type SlugAvailabilityCheck, type StandardPageDef, type StandardPageKey, type StartCheckoutInput, type StartCheckoutResult, type StartPaymentMethodSetupInput, type StartRegistrationInput, type StartRegistrationResult, type StoredBundleStem, type StrictModeWarning, type StrictModeWarningCode, type SubscriberCharge, type SubscriberChargeOrigin, type SubscriberChargeRecord, type SubscriberChargeSource, type SubscriberContact, type SubscriberContactChange, type SubscriberCorrectionData, type SubscriberCorrectionRecord, type SubscriberCorrectionResult, type SubscriberDetails, type SubscriberErrorCode, type SubscriberIdentityCorrection, type SubscriberIdentityDelta, type SubscriberIdentityValues, type SubscriberLedgerRepository, type SubscriberPaymentMethodRecord, type SubscriberPaymentMethodReference, type SubscriberPaymentMethodRepository, type SubscriberPaymentMethodSetupData, type SubscriberPaymentMethodSetupMatch, type SubscriberPaymentMethodStatus, type SubscriberRecord, type SubscriberRepository, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SyncDiscoveryResult, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionWritePort, type TerminateSubscriptionContractData, type TopPromoCode, type TransactionContext, type TransactionRunner, type UpdateBundleData, type UpdateBundleVersionDraftData, type UpdateCatalogEntryBaseData, type UpdateCatalogEntryI18nData, type UpdateCheckoutOfferData, type UpdateMarketingProjectionData, type UpdateMarketingSettingsData, type UpdatePlanData, type UpdatePlanVersionDraftData, type UpdatePromoCodeData, type UpdatePromoCodeRequest, type UpdatePromotionData, type UpsellOffer, type UpsellOfferResolver, type UpsertCapabilityEntryData, type UpsertFeatureCatalogEntryInput, type UpsertFeatureEntryData, type UpsertPlanInput, type UpsertPlanVersionInput, type UpsertQuotaEntryData, type UpsertResult, type UsageSnapshotPort, type UserAccountLookup, type UserListFilter, type UserManagementPort, type UserPort, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleStemDefaults, canonicalJson, classifyBundleVersionDiff, classifyIssuerChange, classifyPlanDiff, collectUnsatisfiedRequires, contractPartiesOf, coverageExcludingSelf, definedFields, diffSettings, formatCustomerNumber, formatErrorMessage, identityCorrectionDelta, isBundleRedundant, isForeignPaymentMethodReferenceError, isPaymentCallbackRejectedError, isPlatformUserExistsError, isVersionEditable, issuerIdentityOf, keepOneRecommended, missingRequiresFor, movedIdentityFields, pickActivePromo, planCatalogSettingsOf, previousUtcDay, promoStatus, promotionOnPrice, readQuotaRecord, readQuotaValue, recordedIssuerIdentity, refuseForeignPaymentMethodReference, resolveBundleAvailability, resolveErrorMessage, sameLegalIdentity, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberChargeColumns, subscriberFromRegistration, subscriberPaymentMethodColumns, toBundleStemRow, toContractLineItemRecord, toPlanRow, toPlanVersionRow, toRunningContractIssuer, toSubscriberChargeRecord, toSubscriberCorrectionRecord, toSubscriberPaymentMethodRecord, toSubscriberRecord, toSubscriptionBundleRecord, toSubscriptionContractRecord };

package/dist/index.d.ts

@@ -643,12 +643,19 @@ interface PaymentGateway {
     /**
      * Opens the gateway's form for a payment method. Nothing is confirmed until
      * the gateway says so through `readCallback`.
+     *
+     * A failure is thrown as the provider reported it: the platform answers the
+     * person with `PAYMENT_GATEWAY_FAILED` and keeps what the error carries —
+     * its kind, code, status and request id — in the server log.
      */
     startPaymentMethodSetup(input: StartPaymentMethodSetupInput): Promise<PaymentMethodSetupSession>;
     /**
      * Verifies a callback with the account's secret and translates it.
      * Throws `PaymentCallbackRejectedError` for anything the gateway did not
-     * send, before a single field of it is trusted.
+     * send, before a single field of it is trusted. Any other failure is
+     * answered with `PAYMENT_GATEWAY_FAILED` and 502, like one of
+     * `startPaymentMethodSetup` — to the gateway's webhook, or to the person
+     * an `immediateCallback` is read for.
      */
     readCallback(callback: PaymentGatewayCallback): Promise<PaymentGatewayEvent>;
 }
@@ -1103,7 +1110,7 @@ interface SubscriptionBundleRecord {
      * or on one whose plan has no period; readers fall back to the plan's
      * cycle, which is what every booking used before.
      */
-    billingCycle: string | null;
+    billingCycle: BillingCycle | null;
     currentPeriodStart: Date | null;
     currentPeriodEnd: Date | null;
     createdAt: Date;
@@ -1137,7 +1144,7 @@ interface CreateSubscriptionBundleData {
     /** Null unless a commitment was configured or asked for. */
     minimumTermEndsAt?: Date | null;
     /** The rhythm and window worked out above this port. */
-    billingCycle?: string | null;
+    billingCycle?: BillingCycle | null;
     currentPeriodStart?: Date | null;
     currentPeriodEnd?: Date | null;
 }
@@ -2206,6 +2213,16 @@ interface EffectiveLimitsSnapshot {
     plan: string;
     quotas: Record<string, number>;
     features: string[];
+    /**
+     * The add-ons a contract left out of these entitlements because their
+     * cancellation was already declared when it was written. Each is granted by
+     * its booking until its effective date, and by this snapshot never.
+     *
+     * Absent where nothing was left out — and on a snapshot written by an
+     * application, or before the platform left anything out, which then counts
+     * every add-on it names as its own.
+     */
+    leftOutBundleVersionIds?: string[];
 }
 
 interface FeatureUiMeta {
@@ -3511,6 +3528,128 @@ interface SubscriberCorrectionResult {
     correction: SubscriberCorrectionRecord | null;
 }
 
+/**
+ * What made the charge arise. activation: the first period of a subscription. renewal: a later period. planChange: what an immediate plan change adds. bundleBooking: the first, short period of an add-on. credit: a decision that reduces what is owed. correction: a counter-entry reversing an earlier charge, which is how the append-only journal answers a mistake.
+ */
+type SubscriberChargeOrigin = 'activation' | 'renewal' | 'planChange' | 'bundleBooking' | 'credit' | 'correction';
+/**
+ * Which kind of contract line the charge realises.
+ */
+type SubscriberChargeSource = 'plan' | 'bundle' | 'discount';
+/**
+ * One charge in a subscriber's account: an amount that became due for a period, derived from a line of the contract in force. The journal is append-only — a charge is never updated, and a mistake is answered with a counter-entry rather than an edit, so the account says what happened rather than what somebody thinks today. A charge is net: the tax is decided by the tax adapter when the charge is invoiced, from the subscriber's origin on that day, and computed once per rate on the invoice.
+ */
+interface SubscriberCharge {
+    /**
+     * The charge's own identifier. Never shown to a customer as an invoice number: invoice numbering is sequential, gapless and legally constrained per country, and an identifier somebody has already seen on a screen cannot become one later without confusion.
+     */
+    id: string;
+    /**
+     * The party the contract is concluded with, whose account this is. It outlives the tenant.
+     */
+    subscriberId: string;
+    /**
+     * The tenant the subscription belonged to when the charge arose.
+     */
+    tenantId: string;
+    /**
+     * The subscription the charge arose on. Part of the natural key.
+     */
+    subscriptionId: string;
+    /**
+     * The contract whose line the charge realises.
+     */
+    contractId: string;
+    /**
+     * The contract line the charge came from, so that every invoice line can be traced back to what was agreed.
+     */
+    contractLineItemId: string;
+    origin: SubscriberChargeOrigin;
+    source: SubscriberChargeSource;
+    /**
+     * Which thing of its source the charge is for, stable across contracts: the subscription id for the plan, the booking id for an add-on, the discount's key for a discount. Part of the natural key (subscriptionId, source, sourceRef, periodStart, origin), which is unique — a charge derived twice is written once.
+     */
+    sourceRef: string;
+    /**
+     * The start of the period the charge belongs to — the grouping key for an invoice.
+     */
+    periodStart: string;
+    periodEnd: string;
+    /**
+     * ISO 4217, as the contract line records it — recorded per charge so that a charge written in 2026 still means what it meant after the configured currency changes.
+     */
+    currency: string;
+    /**
+     * Net, rounded to the currency's decimal places once, when the charge is written; the written figure is the truth from then on. Negative for a discount.
+     */
+    amountNet: number;
+    /**
+     * When the amount became due. The account is ordered by this, not by when the row was written.
+     */
+    bookedAt: string;
+    createdAt: string;
+}
+
+/** A charge as a store reads it back: the wire format, with its dates as dates. */
+interface SubscriberChargeRecord {
+    id: string;
+    subscriberId: string;
+    tenantId: string;
+    subscriptionId: string;
+    contractId: string;
+    contractLineItemId: string;
+    origin: SubscriberChargeOrigin;
+    source: SubscriberChargeSource;
+    /** The subscription id for the plan, the booking id for an add-on, the discount's key. */
+    sourceRef: string;
+    periodStart: Date;
+    periodEnd: Date;
+    currency: string;
+    /** Net, rounded to the cent when written. Negative for a discount. */
+    amountNet: number;
+    /** When the amount became due. */
+    bookedAt: Date;
+    createdAt: Date;
+}
+/** A charge to write: everything but what the store assigns. */
+type NewSubscriberCharge = Omit<SubscriberChargeRecord, 'id' | 'createdAt'>;
+/**
+ * The manifest capability that announces the operator's view of an account.
+ * The platform sets it where it serves the view, and the admin UI shows the
+ * view only where it is set.
+ */
+declare const SUBSCRIBER_ACCOUNT_CAPABILITY = "charges.read";
+/** Whose account it is, as the operator is shown it. */
+interface AdminAccountHolder {
+    id: string;
+    /** What the customer quotes, and what an invoice will carry. */
+    customerNumber: string;
+    legalName: string;
+}
+/** One charge of an account, with the name its contract line gives it. */
+interface AdminAccountEntry {
+    /** The charge as the journal holds it. */
+    charge: SubscriberCharge;
+    /**
+     * The contract line's own title, as it was when the contract was
+     * concluded, or `null` where that line cannot be read.
+     */
+    title: string | null;
+}
+/**
+ * A tenant's account as the operator reads it: the charges of the subscription
+ * it holds, newest first — by when each became due, then by its period, then
+ * the plan before its add-ons before its discounts.
+ *
+ * No total: without invoices and payments, a sum would be what was charged so
+ * far, and it would be read as what is owed.
+ */
+interface AdminSubscriberAccount {
+    /** `null` for a tenant that has no subscriber. */
+    holder: AdminAccountHolder | null;
+    entries: AdminAccountEntry[];
+}
+
 /**
  * Snapshot form of a `Subscription` row for the EntitlementService
  * computation. The consumer maps its Prisma structure onto this form.
@@ -3758,6 +3897,27 @@ interface SubscriberRepository {
     /** Every correction of this subscriber, the latest first. */
     listCorrections(subscriberId: string): Promise<SubscriberCorrectionRecord[]>;
 }
+/**
+ * The subscriber's account: the charges that became due, one per contract line
+ * and period. Append-only — nothing here updates or deletes a charge, and a
+ * mistake is answered with a counter-entry (`SC-PRIC-020`).
+ *
+ * Owned by the subscriber rather than the tenant, so that it outlives the
+ * tenant it arose for (ADR 0012).
+ */
+interface SubscriberLedgerRepository {
+    /**
+     * Writes the charges that are not there yet and returns them.
+     *
+     * A charge whose natural key — subscription, source, source reference,
+     * period start and origin — is already written is left as it is and not
+     * returned, however often it is derived and whoever derives it at the same
+     * time: the unique index decides, not a read before the write.
+     */
+    recordCharges(charges: readonly NewSubscriberCharge[], tx?: TransactionContext): Promise<SubscriberChargeRecord[]>;
+    /** Every charge of one subscription, oldest period first. */
+    listBySubscription(subscriptionId: string, tx?: TransactionContext): Promise<SubscriberChargeRecord[]>;
+}
 /**
  * Display form of a subscription for the tenant self-service UI.
  * Richer than `SubscriptionRecord` (which is only the aggregation form); contains
@@ -5085,6 +5245,8 @@ interface SaaSiCatPersistenceEntitlement {
     subscriptionContractRepository?: PersistenceProvider<SubscriptionContractRepository>;
     /** The parties contracts are concluded with; required wherever contracts are written. */
     subscriberRepository?: PersistenceProvider<SubscriberRepository>;
+    /** The charges a subscriber's contracts give rise to (`tenantBilling.chargeJournal`). */
+    subscriberLedgerRepository?: PersistenceProvider<SubscriberLedgerRepository>;
     subscriptionBundleRepository?: PersistenceProvider<SubscriptionBundleRepository>;
     bundleRepository?: PersistenceProvider<BundleRepository>;
 }
@@ -5530,6 +5692,13 @@ declare const PAYMENT_ERROR_CODES: {
      * does not name. Carries `field`.
      */
     readonly PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED";
+    /**
+     * The gateway failed — unreachable, refusing the account's keys, or
+     * answering with an error — while opening its form or reading a callback
+     * back. Answered with 502; what the gateway answered stays in the server
+     * log.
+     */
+    readonly PAYMENT_GATEWAY_FAILED: "PAYMENT_GATEWAY_FAILED";
 };
 type PaymentErrorCode = (typeof PAYMENT_ERROR_CODES)[keyof typeof PAYMENT_ERROR_CODES];
 /** Codes of the settings record (`GET /admin/settings`, the acknowledgement). */
@@ -5562,6 +5731,13 @@ declare const PLATFORM_ERROR_CODES: {
      * does not name. Carries `field`.
      */
     readonly PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED";
+    /**
+     * The gateway failed — unreachable, refusing the account's keys, or
+     * answering with an error — while opening its form or reading a callback
+     * back. Answered with 502; what the gateway answered stays in the server
+     * log.
+     */
+    readonly PAYMENT_GATEWAY_FAILED: "PAYMENT_GATEWAY_FAILED";
     readonly PENDING_REGISTRATION_NOT_FOUND: "PENDING_REGISTRATION_NOT_FOUND";
     readonly PENDING_REGISTRATION_EXPIRED: "PENDING_REGISTRATION_EXPIRED";
     readonly INVALID_REGISTRATION_STATE: "INVALID_REGISTRATION_STATE";
@@ -6779,6 +6955,47 @@ type IssuerIdentityChange =
  */
 declare function classifyIssuerChange(recorded: LegalIdentity | null, issuer: PlanCatalogIssuer | undefined): IssuerIdentityChange;
 
+/**
+ * A `subscriber_ledger_entries` row as either adapter reads it back. The amount
+ * is `unknown` because a Prisma row carries a `Decimal` where a Drizzle row
+ * carries a numeric string.
+ */
+interface CanonicalSubscriberChargeRow {
+    id: string;
+    subscriberId: string;
+    tenantId: string;
+    subscriptionId: string;
+    contractId: string;
+    contractLineItemId: string;
+    origin: string;
+    source: string;
+    sourceRef: string;
+    periodStart: Date;
+    periodEnd: Date;
+    currency: string;
+    amountNet: unknown;
+    bookedAt: Date;
+    createdAt: Date;
+}
+/**
+ * Reads a row back as a record. The origin and the source are checked rather
+ * than cast: a value written by hand or by a later release would otherwise
+ * reach an invoice as a charge nobody knows how to read.
+ */
+declare function toSubscriberChargeRecord(row: CanonicalSubscriberChargeRow): SubscriberChargeRecord;
+/**
+ * The columns a charge is written with. The amount goes as a decimal string of
+ * two places, which both a Prisma `Decimal` and a PostgreSQL `numeric` take
+ * exactly — a JavaScript number on its way to either is where a cent is lost.
+ *
+ * An amount that is not already a whole number of cents is refused rather than
+ * rounded: a charge is rounded once, where it is derived, and a second rounding
+ * here would make the written figure differ from the one that was computed.
+ */
+declare function subscriberChargeColumns(charge: NewSubscriberCharge): Omit<CanonicalSubscriberChargeRow, 'id' | 'createdAt' | 'amountNet'> & {
+    amountNet: string;
+};
+
 /** A `subscribers` row as either adapter reads it back. */
 interface CanonicalSubscriberRow {
     id: string;
@@ -6907,6 +7124,37 @@ declare function isForeignPaymentMethodReferenceError(error: unknown): error is
  */
 declare function refuseForeignPaymentMethodReference(recorded: Pick<CanonicalSubscriberPaymentMethodRow, 'subscriberId' | 'gatewayAccount' | 'paymentMethodRef'>, subscriberId: string): void;
 
+/**
+ * A `subscription_bundles` row as either adapter reads it back.
+ *
+ * The three billing columns are optional because a Prisma client generated from
+ * a schema that predates them returns a row without them; an absent column
+ * reads as null, the same as a booking made before they existed.
+ */
+interface CanonicalSubscriptionBundleRow {
+    id: string;
+    subscriptionId: string;
+    bundleVersionId: string;
+    startedAt: Date;
+    minimumTermEndsAt: Date | null;
+    billingCycle?: string | null;
+    currentPeriodStart?: Date | null;
+    currentPeriodEnd?: Date | null;
+    canceledAt: Date | null;
+    canceledEffectiveAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Reads a row back as a record.
+ *
+ * `billingCycle` is a text column the platform only ever writes as `MONTHLY` or
+ * `YEARLY`, and a price is chosen by asking whether it is `YEARLY` — so any
+ * other value would be billed monthly without a word. It is checked rather than
+ * cast, and a value outside the two stops the read.
+ */
+declare function toSubscriptionBundleRecord(row: CanonicalSubscriptionBundleRow): SubscriptionBundleRecord;
+
 /** A `subscription_contracts` row as either adapter reads it back. */
 interface CanonicalContractRow {
     id: string;
@@ -7050,4 +7298,4 @@ declare function resolveErrorMessage(body: ResolvableErrorBody, overrides?: Part
 
 declare const ERROR_MESSAGES_DE: Record<PlatformErrorCode, string>;
 
-export { ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES, AUTH_ERROR_CODES, type ActionKey, type ActivationOrchestrator, type ActivePlanVersionWhere, type ActivePlanVersionWhereWithEndsAt, type ActiveVersionWhere, type ActiveVersionWhereWithEndsAt, type ActorTag, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminUserListFilter, type AdminUserListRow, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionRow, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalRunningContractRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberPaymentMethodRow, type CanonicalSubscriberRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type ChangeDirection, type CheckoutOfferFilter, type CheckoutOfferLineItem, type CheckoutOfferLineItemKind, type CheckoutOfferPriceBreakdown, type CheckoutOfferPromoCodeSnapshot, type CheckoutOfferPromotionSnapshot, type CheckoutOfferRepository, type CheckoutOfferRow, type CheckoutOfferSelection, type CheckoutOfferSelectionUpdate, type CheckoutOfferStatus, type CleanupResult, type CliUserRow, type ComponentKey, type ConfiguratorCatalog, type ConfiguratorMarketingProvider, type ConfiguratorModel, type ConfiguratorPlanMarketing, type ConfiguratorPlanVersionRow, type ConfiguratorPriceBreakdown, type ConfiguratorSourcesLookup, type ConfirmedPaymentMethod, type ContractErrorCode, type ContractIssuerParty, type ContractLineItemKind, type ContractLineItemRecord, type ContractSubscriberParty, type CreateBundleData, type CreateBundleVersionDraftData, type CreateCheckoutOfferData, type CreateMarketingProjectionData, type CreatePlanData, type CreatePlanVersionDraftData, type CreatePromoCodeData, type CreatePromoCodeRequest, type CreatePromotionData, type CreateSubscriberData, type CreateSubscriptionBundleData, type CreateSubscriptionContractData, type CreateSuperAdminCliInput, type CreateTenantInput, type DiffResult, type DiscoveredCapability, type DiscoveredFeature, type DiscoveredQuota, type DiscoveredQuotaPolicy, type DiscoveryCodeStatus, type DiscoverySnapshot, type DiscoveryStatus, ERROR_MESSAGES_DE, ERROR_MESSAGES_EN, type EffectiveLimitsSnapshot, type EmailPort, type ErrorMessageParams, FEATURE_NOT_LICENSED, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FinalActivationResult, type FirstTimeCustomerCheck, ForeignPaymentMethodReferenceError, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type IssuerCorrectionFault, type IssuerIdentityChange, type KpiCardDef, type KpiDisplayHint, LEGAL_IDENTITY_FIELDS, type LegalIdentity, type LegalIdentityField, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MaskedPaymentMethod, type MfaPort, type NewContractLineItemData, type NewSettingsChange, type NewSubscriberDetails, type NewSubscriptionContractData, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, PASSWORD_RESET_TTL_MINUTES, PAYMENT_ERROR_CODES, PAYMENT_METHOD_TYPES, PENDING_CHECKOUT_TTL_DAYS, PENDING_EMAIL_TTL_HOURS, PENDING_ONBOARDING_TTL_DAYS, PLATFORM_ERROR_CODES, PROMO_ERROR_CODES, type Paginated, type PartyAddress, type PasswordHasher, type PasswordResetCliResult, PaymentCallbackRejectedError, type PaymentErrorCode, type PaymentEventClaim, type PaymentEventLog, type PaymentGateway, type PaymentGatewayCallback, type PaymentGatewayEvent, type PaymentMethodHolder, type PaymentMethodSetupSession, type PaymentMethodSetupSubject, type PaymentMethodType, type PendingRegistration, type PendingRegistrationCreateInput, type PendingRegistrationRepository, type PendingRegistrationSnapshot, type PendingRegistrationUpdateInput, type PersistenceCapabilities, PersistenceCapabilityError, type PersistenceClassRef, type PersistenceInjectionToken, type PersistenceProvider, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogIssuer, type PlanCatalogIssuerCorrection, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogPaymentAccount, type PlanCatalogPayments, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogSettings, type PlanCatalogSubscribers, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMappingFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformRole, type PlatformUserDto, PlatformUserExistsError, type ProjectPageDef, type PromoCode, type PromoCodeDurationType, type PromoCodeFilter, type PromoCodeHoldRecord, type PromoCodeHoldRepository, type PromoCodeHoldTaken, type PromoCodeRecord, type PromoCodeRedemption, type PromoCodeRedemptionListItem, type PromoCodeRedemptionRecord, type PromoCodeRedemptionRepository, type PromoCodeRedemptionStatus, type PromoCodeRepository, type PromoCodeStatsPort, type PromoCodeStatsSnapshot, type PromoCodeStatus, type PromoCodeValidationLog, type PromoCodeValidationLogRepository, type PromoCodeValidationResult, type PromoCodeValueType, type PromoErrorCode, type PromoPreviewInvalidReason, type PromoPreviewRequest, type PromoPreviewResponse, type PromoPreviewValidResponse, type PromoRevenueDeductionAggregator, type PromoSubscriptionLookup, type PromotionBillingCycle, type PromotionI18n, type PromotionI18nFields, type PromotionOnPrice, type PromotionRepository, type PromotionResult, type PromotionRow, type PromotionStatus, type PromotionTargetType, type PromotionType, type PromotionValue, type PublicBootResponse, type PublicComparisonRow, type PublicMarketingBundle, type PublicMarketingCatalogResponse, type PublicMarketingPlan, type PublicMarketingPromo, type PublicNewPaymentMethods, type PublicSignupPlan, type PublishBundleVersionData, type PublishBundleVersionMeta, type PublishPlanVersionData, type QuotaCatalogEntryRow, type QuotaEnforcementMode, type QuotaKey, type QuotaProvider, REGISTRATION_ERROR_CODES, REGISTRATION_RESUME_TTL_MINUTES, REGISTRATION_STEP_BY_STATUS, type ReassignTenantAdminCliResult, type RecommendablePlan, type RecordSubscriberPaymentMethodData, type RecordSubscriberPaymentMethodOutcome, type RecordSubscriberPaymentMethodResult, type RedeemPromoInTransactionCallback, type RegistrationActivation, type RegistrationAuditContext, type RegistrationAuditEvent, type RegistrationAuditEventType, type RegistrationAuditLogger, type RegistrationBillingDetails, type RegistrationConfigSelection, type RegistrationConfiguratorLookup, type RegistrationErrorCode, type RegistrationOtpDelivery, type RegistrationPromoPreview, type RegistrationResumeDelivery, type RegistrationResumeTokenSigner, type RegistrationStatus, type RegistrationStep, type RequiredCapabilities, type ResolvableErrorBody, type ResumeRegistrationInput, type ResumeRegistrationResult, type ReviewCatalogEntryData, type RlsBypassPort, type RunningContractIssuer, type RunningContractIssuers, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ERROR_CODES, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePayments, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledPlanChangeInput, type SelectPlanInput, type SelectPlanResult, type SelectableBundleShape, type SelfServiceBlockedPlans, type SetCatalogEntryReviewData, type SettingsChangeFilter, type SettingsChangeRecord, type SettingsDifference, type SettingsErrorCode, type SetupConfirmMfaRequest, type SetupConfirmMfaResponse, type SetupErrorCode, type SetupRequest, type SetupResult, type SetupStatusResponse, type SlugAvailabilityCheck, type StandardPageDef, type StandardPageKey, type StartCheckoutInput, type StartCheckoutResult, type StartPaymentMethodSetupInput, type StartRegistrationInput, type StartRegistrationResult, type StoredBundleStem, type StrictModeWarning, type StrictModeWarningCode, type SubscriberContact, type SubscriberContactChange, type SubscriberCorrectionData, type SubscriberCorrectionRecord, type SubscriberCorrectionResult, type SubscriberDetails, type SubscriberErrorCode, type SubscriberIdentityCorrection, type SubscriberIdentityDelta, type SubscriberIdentityValues, type SubscriberPaymentMethodRecord, type SubscriberPaymentMethodReference, type SubscriberPaymentMethodRepository, type SubscriberPaymentMethodSetupData, type SubscriberPaymentMethodSetupMatch, type SubscriberPaymentMethodStatus, type SubscriberRecord, type SubscriberRepository, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SyncDiscoveryResult, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionWritePort, type TerminateSubscriptionContractData, type TopPromoCode, type TransactionContext, type TransactionRunner, type UpdateBundleData, type UpdateBundleVersionDraftData, type UpdateCatalogEntryBaseData, type UpdateCatalogEntryI18nData, type UpdateCheckoutOfferData, type UpdateMarketingProjectionData, type UpdateMarketingSettingsData, type UpdatePlanData, type UpdatePlanVersionDraftData, type UpdatePromoCodeData, type UpdatePromoCodeRequest, type UpdatePromotionData, type UpsellOffer, type UpsellOfferResolver, type UpsertCapabilityEntryData, type UpsertFeatureCatalogEntryInput, type UpsertFeatureEntryData, type UpsertPlanInput, type UpsertPlanVersionInput, type UpsertQuotaEntryData, type UpsertResult, type UsageSnapshotPort, type UserAccountLookup, type UserListFilter, type UserManagementPort, type UserPort, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleStemDefaults, canonicalJson, classifyBundleVersionDiff, classifyIssuerChange, classifyPlanDiff, collectUnsatisfiedRequires, contractPartiesOf, coverageExcludingSelf, definedFields, diffSettings, formatCustomerNumber, formatErrorMessage, identityCorrectionDelta, isBundleRedundant, isForeignPaymentMethodReferenceError, isPaymentCallbackRejectedError, isPlatformUserExistsError, isVersionEditable, issuerIdentityOf, keepOneRecommended, missingRequiresFor, movedIdentityFields, pickActivePromo, planCatalogSettingsOf, previousUtcDay, promoStatus, promotionOnPrice, readQuotaRecord, readQuotaValue, recordedIssuerIdentity, refuseForeignPaymentMethodReference, resolveBundleAvailability, resolveErrorMessage, sameLegalIdentity, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberFromRegistration, subscriberPaymentMethodColumns, toBundleStemRow, toContractLineItemRecord, toPlanRow, toPlanVersionRow, toRunningContractIssuer, toSubscriberCorrectionRecord, toSubscriberPaymentMethodRecord, toSubscriberRecord, toSubscriptionContractRecord };
+export { ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES, AUTH_ERROR_CODES, type ActionKey, type ActivationOrchestrator, type ActivePlanVersionWhere, type ActivePlanVersionWhereWithEndsAt, type ActiveVersionWhere, type ActiveVersionWhereWithEndsAt, type ActorTag, type AdminAccountEntry, type AdminAccountHolder, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriberAccount, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminUserListFilter, type AdminUserListRow, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionRow, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalRunningContractRow, type CanonicalSubscriberChargeRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberPaymentMethodRow, type CanonicalSubscriberRow, type CanonicalSubscriptionBundleRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type ChangeDirection, type CheckoutOfferFilter, type CheckoutOfferLineItem, type CheckoutOfferLineItemKind, type CheckoutOfferPriceBreakdown, type CheckoutOfferPromoCodeSnapshot, type CheckoutOfferPromotionSnapshot, type CheckoutOfferRepository, type CheckoutOfferRow, type CheckoutOfferSelection, type CheckoutOfferSelectionUpdate, type CheckoutOfferStatus, type CleanupResult, type CliUserRow, type ComponentKey, type ConfiguratorCatalog, type ConfiguratorMarketingProvider, type ConfiguratorModel, type ConfiguratorPlanMarketing, type ConfiguratorPlanVersionRow, type ConfiguratorPriceBreakdown, type ConfiguratorSourcesLookup, type ConfirmedPaymentMethod, type ContractErrorCode, type ContractIssuerParty, type ContractLineItemKind, type ContractLineItemRecord, type ContractSubscriberParty, type CreateBundleData, type CreateBundleVersionDraftData, type CreateCheckoutOfferData, type CreateMarketingProjectionData, type CreatePlanData, type CreatePlanVersionDraftData, type CreatePromoCodeData, type CreatePromoCodeRequest, type CreatePromotionData, type CreateSubscriberData, type CreateSubscriptionBundleData, type CreateSubscriptionContractData, type CreateSuperAdminCliInput, type CreateTenantInput, type DiffResult, type DiscoveredCapability, type DiscoveredFeature, type DiscoveredQuota, type DiscoveredQuotaPolicy, type DiscoveryCodeStatus, type DiscoverySnapshot, type DiscoveryStatus, ERROR_MESSAGES_DE, ERROR_MESSAGES_EN, type EffectiveLimitsSnapshot, type EmailPort, type ErrorMessageParams, FEATURE_NOT_LICENSED, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FinalActivationResult, type FirstTimeCustomerCheck, ForeignPaymentMethodReferenceError, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type IssuerCorrectionFault, type IssuerIdentityChange, type KpiCardDef, type KpiDisplayHint, LEGAL_IDENTITY_FIELDS, type LegalIdentity, type LegalIdentityField, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MaskedPaymentMethod, type MfaPort, type NewContractLineItemData, type NewSettingsChange, type NewSubscriberCharge, type NewSubscriberDetails, type NewSubscriptionContractData, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, PASSWORD_RESET_TTL_MINUTES, PAYMENT_ERROR_CODES, PAYMENT_METHOD_TYPES, PENDING_CHECKOUT_TTL_DAYS, PENDING_EMAIL_TTL_HOURS, PENDING_ONBOARDING_TTL_DAYS, PLATFORM_ERROR_CODES, PROMO_ERROR_CODES, type Paginated, type PartyAddress, type PasswordHasher, type PasswordResetCliResult, PaymentCallbackRejectedError, type PaymentErrorCode, type PaymentEventClaim, type PaymentEventLog, type PaymentGateway, type PaymentGatewayCallback, type PaymentGatewayEvent, type PaymentMethodHolder, type PaymentMethodSetupSession, type PaymentMethodSetupSubject, type PaymentMethodType, type PendingRegistration, type PendingRegistrationCreateInput, type PendingRegistrationRepository, type PendingRegistrationSnapshot, type PendingRegistrationUpdateInput, type PersistenceCapabilities, PersistenceCapabilityError, type PersistenceClassRef, type PersistenceInjectionToken, type PersistenceProvider, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogIssuer, type PlanCatalogIssuerCorrection, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogPaymentAccount, type PlanCatalogPayments, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogSettings, type PlanCatalogSubscribers, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMappingFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformRole, type PlatformUserDto, PlatformUserExistsError, type ProjectPageDef, type PromoCode, type PromoCodeDurationType, type PromoCodeFilter, type PromoCodeHoldRecord, type PromoCodeHoldRepository, type PromoCodeHoldTaken, type PromoCodeRecord, type PromoCodeRedemption, type PromoCodeRedemptionListItem, type PromoCodeRedemptionRecord, type PromoCodeRedemptionRepository, type PromoCodeRedemptionStatus, type PromoCodeRepository, type PromoCodeStatsPort, type PromoCodeStatsSnapshot, type PromoCodeStatus, type PromoCodeValidationLog, type PromoCodeValidationLogRepository, type PromoCodeValidationResult, type PromoCodeValueType, type PromoErrorCode, type PromoPreviewInvalidReason, type PromoPreviewRequest, type PromoPreviewResponse, type PromoPreviewValidResponse, type PromoRevenueDeductionAggregator, type PromoSubscriptionLookup, type PromotionBillingCycle, type PromotionI18n, type PromotionI18nFields, type PromotionOnPrice, type PromotionRepository, type PromotionResult, type PromotionRow, type PromotionStatus, type PromotionTargetType, type PromotionType, type PromotionValue, type PublicBootResponse, type PublicComparisonRow, type PublicMarketingBundle, type PublicMarketingCatalogResponse, type PublicMarketingPlan, type PublicMarketingPromo, type PublicNewPaymentMethods, type PublicSignupPlan, type PublishBundleVersionData, type PublishBundleVersionMeta, type PublishPlanVersionData, type QuotaCatalogEntryRow, type QuotaEnforcementMode, type QuotaKey, type QuotaProvider, REGISTRATION_ERROR_CODES, REGISTRATION_RESUME_TTL_MINUTES, REGISTRATION_STEP_BY_STATUS, type ReassignTenantAdminCliResult, type RecommendablePlan, type RecordSubscriberPaymentMethodData, type RecordSubscriberPaymentMethodOutcome, type RecordSubscriberPaymentMethodResult, type RedeemPromoInTransactionCallback, type RegistrationActivation, type RegistrationAuditContext, type RegistrationAuditEvent, type RegistrationAuditEventType, type RegistrationAuditLogger, type RegistrationBillingDetails, type RegistrationConfigSelection, type RegistrationConfiguratorLookup, type RegistrationErrorCode, type RegistrationOtpDelivery, type RegistrationPromoPreview, type RegistrationResumeDelivery, type RegistrationResumeTokenSigner, type RegistrationStatus, type RegistrationStep, type RequiredCapabilities, type ResolvableErrorBody, type ResumeRegistrationInput, type ResumeRegistrationResult, type ReviewCatalogEntryData, type RlsBypassPort, type RunningContractIssuer, type RunningContractIssuers, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ACCOUNT_CAPABILITY, SUBSCRIBER_ERROR_CODES, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePayments, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledPlanChangeInput, type SelectPlanInput, type SelectPlanResult, type SelectableBundleShape, type SelfServiceBlockedPlans, type SetCatalogEntryReviewData, type SettingsChangeFilter, type SettingsChangeRecord, type SettingsDifference, type SettingsErrorCode, type SetupConfirmMfaRequest, type SetupConfirmMfaResponse, type SetupErrorCode, type SetupRequest, type SetupResult, type SetupStatusResponse, type SlugAvailabilityCheck, type StandardPageDef, type StandardPageKey, type StartCheckoutInput, type StartCheckoutResult, type StartPaymentMethodSetupInput, type StartRegistrationInput, type StartRegistrationResult, type StoredBundleStem, type StrictModeWarning, type StrictModeWarningCode, type SubscriberCharge, type SubscriberChargeOrigin, type SubscriberChargeRecord, type SubscriberChargeSource, type SubscriberContact, type SubscriberContactChange, type SubscriberCorrectionData, type SubscriberCorrectionRecord, type SubscriberCorrectionResult, type SubscriberDetails, type SubscriberErrorCode, type SubscriberIdentityCorrection, type SubscriberIdentityDelta, type SubscriberIdentityValues, type SubscriberLedgerRepository, type SubscriberPaymentMethodRecord, type SubscriberPaymentMethodReference, type SubscriberPaymentMethodRepository, type SubscriberPaymentMethodSetupData, type SubscriberPaymentMethodSetupMatch, type SubscriberPaymentMethodStatus, type SubscriberRecord, type SubscriberRepository, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SyncDiscoveryResult, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionWritePort, type TerminateSubscriptionContractData, type TopPromoCode, type TransactionContext, type TransactionRunner, type UpdateBundleData, type UpdateBundleVersionDraftData, type UpdateCatalogEntryBaseData, type UpdateCatalogEntryI18nData, type UpdateCheckoutOfferData, type UpdateMarketingProjectionData, type UpdateMarketingSettingsData, type UpdatePlanData, type UpdatePlanVersionDraftData, type UpdatePromoCodeData, type UpdatePromoCodeRequest, type UpdatePromotionData, type UpsellOffer, type UpsellOfferResolver, type UpsertCapabilityEntryData, type UpsertFeatureCatalogEntryInput, type UpsertFeatureEntryData, type UpsertPlanInput, type UpsertPlanVersionInput, type UpsertQuotaEntryData, type UpsertResult, type UsageSnapshotPort, type UserAccountLookup, type UserListFilter, type UserManagementPort, type UserPort, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleStemDefaults, canonicalJson, classifyBundleVersionDiff, classifyIssuerChange, classifyPlanDiff, collectUnsatisfiedRequires, contractPartiesOf, coverageExcludingSelf, definedFields, diffSettings, formatCustomerNumber, formatErrorMessage, identityCorrectionDelta, isBundleRedundant, isForeignPaymentMethodReferenceError, isPaymentCallbackRejectedError, isPlatformUserExistsError, isVersionEditable, issuerIdentityOf, keepOneRecommended, missingRequiresFor, movedIdentityFields, pickActivePromo, planCatalogSettingsOf, previousUtcDay, promoStatus, promotionOnPrice, readQuotaRecord, readQuotaValue, recordedIssuerIdentity, refuseForeignPaymentMethodReference, resolveBundleAvailability, resolveErrorMessage, sameLegalIdentity, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberChargeColumns, subscriberFromRegistration, subscriberPaymentMethodColumns, toBundleStemRow, toContractLineItemRecord, toPlanRow, toPlanVersionRow, toRunningContractIssuer, toSubscriberChargeRecord, toSubscriberCorrectionRecord, toSubscriberPaymentMethodRecord, toSubscriberRecord, toSubscriptionBundleRecord, toSubscriptionContractRecord };

package/dist/index.js

@@ -711,7 +711,14 @@ var PAYMENT_ERROR_CODES = {
    * A success or cancel URL at an origin `config/saas.yaml#payments.returnUrlOrigins`
    * does not name. Carries `field`.
    */
-  PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED"
+  PAYMENT_RETURN_URL_NOT_ALLOWED: "PAYMENT_RETURN_URL_NOT_ALLOWED",
+  /**
+   * The gateway failed — unreachable, refusing the account's keys, or
+   * answering with an error — while opening its form or reading a callback
+   * back. Answered with 502; what the gateway answered stays in the server
+   * log.
+   */
+  PAYMENT_GATEWAY_FAILED: "PAYMENT_GATEWAY_FAILED"
 };
 var SETTINGS_ERROR_CODES = {
   /** No recorded change has this id, or the installation keeps no record at all. */
@@ -977,6 +984,83 @@ function textOrNull(value) {
   return trimmed === "" ? null : trimmed;
 }
 
+// src/closed-value.ts
+function oneOf(allowed, value, source) {
+  const match = allowed.find((entry) => entry === value);
+  if (match === void 0) {
+    throw new Error(
+      `${source.table} row '${source.id}' holds ${source.column} '${value}', which is none of ${allowed.join(", ")}.`
+    );
+  }
+  return match;
+}
+
+// src/subscriber-ledger-mapping.ts
+var ORIGINS = {
+  activation: true,
+  renewal: true,
+  planChange: true,
+  bundleBooking: true,
+  credit: true,
+  correction: true
+};
+var SOURCES = {
+  plan: true,
+  bundle: true,
+  discount: true
+};
+var TABLE = "subscriber_ledger_entries";
+var CENT_TOLERANCE = 1e-6;
+function toSubscriberChargeRecord(row) {
+  const where = (column) => ({ table: TABLE, column, id: row.id });
+  return {
+    id: row.id,
+    subscriberId: row.subscriberId,
+    tenantId: row.tenantId,
+    subscriptionId: row.subscriptionId,
+    contractId: row.contractId,
+    contractLineItemId: row.contractLineItemId,
+    origin: oneOf(keysOf(ORIGINS), row.origin, where("origin")),
+    source: oneOf(keysOf(SOURCES), row.source, where("source")),
+    sourceRef: row.sourceRef,
+    periodStart: row.periodStart,
+    periodEnd: row.periodEnd,
+    currency: row.currency,
+    amountNet: Number(row.amountNet),
+    bookedAt: row.bookedAt,
+    createdAt: row.createdAt
+  };
+}
+function subscriberChargeColumns(charge) {
+  const cents = charge.amountNet * 100;
+  if (!Number.isFinite(cents) || Math.abs(cents - Math.round(cents)) > CENT_TOLERANCE) {
+    throw new Error(
+      `A charge of ${charge.amountNet} is not a whole number of cents; round it once where it is derived, before it is written.`
+    );
+  }
+  return {
+    subscriberId: charge.subscriberId,
+    tenantId: charge.tenantId,
+    subscriptionId: charge.subscriptionId,
+    contractId: charge.contractId,
+    contractLineItemId: charge.contractLineItemId,
+    origin: charge.origin,
+    source: charge.source,
+    sourceRef: charge.sourceRef,
+    periodStart: charge.periodStart,
+    periodEnd: charge.periodEnd,
+    currency: charge.currency,
+    amountNet: charge.amountNet.toFixed(2),
+    bookedAt: charge.bookedAt
+  };
+}
+function keysOf(record) {
+  return Object.keys(record);
+}
+
+// src/subscriber-ledger.types.ts
+var SUBSCRIBER_ACCOUNT_CAPABILITY = "charges.read";
+
 // src/subscriber-mapping.ts
 function formatCustomerNumber(prefix, sequence) {
   return `${prefix}${sequence}`;
@@ -1092,6 +1176,7 @@ function toIdentityValues(value) {
 // src/subscriber-payment-method-mapping.ts
 var PAYMENT_METHOD_TYPES = ["card", "sepa_debit"];
 var STATUSES = ["ACTIVE", "REPLACED"];
+var TABLE2 = "subscriber_payment_methods";
 function toSubscriberPaymentMethodRecord(row) {
   return {
     id: row.id,
@@ -1100,7 +1185,7 @@ function toSubscriberPaymentMethodRecord(row) {
     provider: row.provider,
     customerRef: row.customerRef,
     paymentMethodRef: row.paymentMethodRef,
-    type: oneOf(PAYMENT_METHOD_TYPES, row.type, "type", row.id),
+    type: oneOf(PAYMENT_METHOD_TYPES, row.type, { table: TABLE2, column: "type", id: row.id }),
     brand: row.brand,
     last4: row.last4,
     expiryMonth: row.expiryMonth,
@@ -1108,7 +1193,7 @@ function toSubscriberPaymentMethodRecord(row) {
     country: row.country,
     bankCode: row.bankCode,
     mandateReference: row.mandateReference,
-    status: oneOf(STATUSES, row.status, "status", row.id),
+    status: oneOf(STATUSES, row.status, { table: TABLE2, column: "status", id: row.id }),
     confirmedAt: row.confirmedAt,
     replacedAt: row.replacedAt,
     createdAt: row.createdAt
@@ -1132,15 +1217,6 @@ function subscriberPaymentMethodColumns(data) {
     confirmedAt: data.confirmedAt
   };
 }
-function oneOf(allowed, value, column, id) {
-  const match = allowed.find((entry) => entry === value);
-  if (match === void 0) {
-    throw new Error(
-      `subscriber_payment_methods row '${id}' holds ${column} '${value}', which is none of ${allowed.join(", ")}.`
-    );
-  }
-  return match;
-}
 var FOREIGN_PAYMENT_METHOD_REFERENCE = "FOREIGN_PAYMENT_METHOD_REFERENCE";
 var ForeignPaymentMethodReferenceError = class extends Error {
   constructor(gatewayAccount, paymentMethodRef) {
@@ -1166,6 +1242,30 @@ function refuseForeignPaymentMethodReference(recorded, subscriberId) {
   );
 }
 
+// src/subscription-bundle-mapping.ts
+var BILLING_CYCLES = ["MONTHLY", "YEARLY"];
+function toSubscriptionBundleRecord(row) {
+  const billingCycle = row.billingCycle ?? null;
+  return {
+    id: row.id,
+    subscriptionId: row.subscriptionId,
+    bundleVersionId: row.bundleVersionId,
+    startedAt: row.startedAt,
+    minimumTermEndsAt: row.minimumTermEndsAt,
+    billingCycle: billingCycle === null ? null : oneOf(BILLING_CYCLES, billingCycle, {
+      table: "subscription_bundles",
+      column: "billingCycle",
+      id: row.id
+    }),
+    currentPeriodStart: row.currentPeriodStart ?? null,
+    currentPeriodEnd: row.currentPeriodEnd ?? null,
+    canceledAt: row.canceledAt,
+    canceledEffectiveAt: row.canceledEffectiveAt,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt
+  };
+}
+
 // src/subscription-contract-mapping.ts
 function toSubscriptionContractRecord(row, lineItems) {
   return {
@@ -1501,6 +1601,7 @@ var ERROR_MESSAGES_EN = {
   PAYMENT_GATEWAY_ACCOUNT_UNKNOWN: "No payment gateway account is configured under '{account}'.",
   PAYMENT_CALLBACK_REJECTED: "The payment callback could not be verified.",
   PAYMENT_RETURN_URL_NOT_ALLOWED: "The {field} leads to a site this installation does not return to.",
+  PAYMENT_GATEWAY_FAILED: "The payment provider did not answer as expected. Please try again in a few minutes.",
   // ── entitlement (code lives in upsell.types.ts) ──
   [FEATURE_NOT_LICENSED]: "Feature {featureKeys} is not included in the current plan.",
   // ── settings ──
@@ -1711,6 +1812,7 @@ var ERROR_MESSAGES_DE = {
   PAYMENT_GATEWAY_ACCOUNT_UNKNOWN: "Unter '{account}' ist kein Konto eines Zahlungsanbieters eingerichtet.",
   PAYMENT_CALLBACK_REJECTED: "Die R\xFCckmeldung des Zahlungsanbieters lie\xDF sich nicht pr\xFCfen.",
   PAYMENT_RETURN_URL_NOT_ALLOWED: "Die {field} f\xFChrt auf eine Seite, zu der diese Installation nicht zur\xFCckleitet.",
+  PAYMENT_GATEWAY_FAILED: "Der Zahlungsanbieter hat nicht wie erwartet geantwortet. Bitte versuche es in ein paar Minuten noch einmal.",
   // ── entitlement (code lives in upsell.types.ts) ──
   [FEATURE_NOT_LICENSED]: "Das Feature {featureKeys} ist im aktuellen Plan nicht enthalten.",
   // ── settings ──
@@ -1751,6 +1853,7 @@ export {
   REGISTRATION_STEP_BY_STATUS,
   SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES,
+  SUBSCRIBER_ACCOUNT_CAPABILITY,
   SUBSCRIBER_ERROR_CODES,
   applyPromo,
   assertPersistenceCapabilities,
@@ -1795,6 +1898,7 @@ export {
   selectChargeableBundles,
   settingsSubtreeOf,
   startOfUtcDay,
+  subscriberChargeColumns,
   subscriberFromRegistration,
   subscriberPaymentMethodColumns,
   toBundleStemRow,
@@ -1802,8 +1906,10 @@ export {
   toPlanRow,
   toPlanVersionRow,
   toRunningContractIssuer,
+  toSubscriberChargeRecord,
   toSubscriberCorrectionRecord,
   toSubscriberPaymentMethodRecord,
   toSubscriberRecord,
+  toSubscriptionBundleRecord,
   toSubscriptionContractRecord
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/core",
-  "version": "1.0.0-rc.21",
+  "version": "1.0.0-rc.22",
   "description": "TypeScript contracts for SaaSiCat — capabilities, catalogs, subscriptions, entitlements, admin manifests, persistence ports — and the pure domain logic both server and browser run: error catalogues, plan-diff classification, promo arithmetic, feature requirements.",
   "type": "module",
   "main": "./dist/index.cjs",