@saasicat/core 1.0.0-rc.25 → 1.0.0-rc.26

package/dist/index.d.ts

@@ -859,6 +859,18 @@ interface PlanCatalogSubscribers {
      */
     customerNumberPrefix?: string;
 }
+/** `config/saas.yaml#invoicing`: how the invoices issued from the charge journal are numbered and when they are due. */
+interface PlanCatalogInvoicing {
+    /** Put in front of every invoice number: `AHP` gives `AHP-2026-000123`. */
+    numberPrefix: string;
+    /** Days from an invoice's issue date to the day it is due (`SC-PRIC-046`). */
+    paymentTermDays: number;
+    /**
+     * What a business letter of the issuer states beyond the invoice's own
+     * content, line by line — copied onto every invoice issued (`SC-PRIC-077`).
+     */
+    footer?: string[];
+}
 /** One account at a payment gateway, by the name `PlanCatalogPayments.accounts` gives it. */
 interface PlanCatalogPaymentAccount {
     /** The provider its bound adapter names itself as, e.g. `stripe`. */
@@ -916,6 +928,8 @@ interface PlanCatalogSettings {
     issuer?: PlanCatalogIssuer;
     /** How subscribers are numbered. Optional. */
     subscribers?: PlanCatalogSubscribers;
+    /** How invoices are numbered and when they are due; named exactly where invoices are issued. */
+    invoicing?: PlanCatalogInvoicing;
     /** The payment gateway accounts. Optional until payment methods are taken. */
     payments?: PlanCatalogPayments;
 }
@@ -2143,7 +2157,7 @@ interface AdminManifest {
         actions?: AuditActionDef[];
     };
 }
-type StandardPageKey = 'dashboard' | 'tenants' | 'subscriptions' | 'promoCodes' | 'plans' | 'audit' | 'users' | 'pilots' | 'discovery' | 'bundles' | 'marketingCatalog' | 'platformEmail' | 'platformEmailHistory' | 'settings' | 'maintenance';
+type StandardPageKey = 'dashboard' | 'tenants' | 'subscriptions' | 'promoCodes' | 'plans' | 'audit' | 'users' | 'pilots' | 'discovery' | 'bundles' | 'marketingCatalog' | 'platformEmail' | 'platformEmailHistory' | 'settings' | 'maintenance' | 'featureWithdrawals';
 interface StandardPageDef {
     enabled: boolean;
     requiredCapability?: CapabilityKey;
@@ -2431,6 +2445,35 @@ declare function grossFromNet(net: number, vatRate: number): number;
 declare function netFromGross(gross: number, vatRate: number): number;
 /** The tax a gross amount includes at a rate in per cent: gross × rate / (100 + rate). */
 declare function computeIncludedVat(gross: number, vatRate: number): number;
+/** One tax rate's part of an invoice: the net of its lines and the tax on that net. */
+interface TaxAtRate {
+    /** In per cent. */
+    rate: number;
+    net: number;
+    tax: number;
+}
+/** An invoice's tax, rate by rate, and the totals it states. */
+interface TaxPerRate {
+    /** One entry per rate the lines carry, the lowest rate first. */
+    rates: TaxAtRate[];
+    net: number;
+    tax: number;
+    gross: number;
+}
+/**
+ * An invoice's tax by the rule of EN 16931: the lines' net is summed per rate,
+ * the rate is applied to each sum and rounded once, and the gross is the net
+ * plus that tax.
+ *
+ * Never the sum of the lines' own rounded taxes, which can differ by cents —
+ * ten lines of 12.34 at 19 % carry 2.34 each, 23.40 together, while 19 % of
+ * 123.40 is 23.45 — and an electronic invoice whose stated tax differs from
+ * the one its format computes is rejected.
+ */
+declare function taxPerRate(lines: readonly {
+    net: number;
+    rate: number;
+}[]): TaxPerRate;
 
 type CheckoutOfferLineItemKind = 'plan' | 'bundle' | 'discount';
 /** Frozen billable line item in the offer. */
@@ -2894,6 +2937,23 @@ interface FeatureUiMeta {
     plannedOnly?: boolean;
     /** true = base infrastructure, included in every plan (not bookable). */
     core?: boolean;
+    /**
+     * Set where the feature is withdrawn now or from a date ahead: each
+     * withdrawal of it not over yet, the earliest first — why, from when, and
+     * until when where it is lifted from a date ahead. A feature withdrawn
+     * again from the day it returns carries both. A page that shows the
+     * feature as part of a plan or an add-on shows this beside it, so whoever
+     * concludes knows before they do.
+     */
+    withdrawn?: readonly FeatureWithdrawalMark[];
+}
+/** One withdrawal of a feature, as a catalogue marks it beside the feature. */
+interface FeatureWithdrawalMark {
+    readonly reason: string;
+    /** ISO 8601. */
+    readonly effectiveFrom: string;
+    /** ISO 8601, where it is lifted from a date ahead. */
+    readonly liftedFrom: string | null;
 }
 /** Map FeatureKey → UI metadata. Consumer apps supply a complete table. */
 type FeatureUiRegistry = Record<string, FeatureUiMeta>;
@@ -3220,8 +3280,312 @@ interface BundleVersionSwitchResult {
     readonly takesEffectAt: string;
 }
 
+/** What a reduction is named for: a plan, or an add-on, by its key. */
+type FeatureWithdrawalLineKind = 'plan' | 'bundle';
+/**
+ * The net amount the price of a plan, or of an add-on, is reduced by for one
+ * whole period of `billingCycle` without the feature. A plan or an add-on that
+ * grants the feature and is not named is not reduced.
+ */
+interface FeatureWithdrawalReduction {
+    readonly kind: FeatureWithdrawalLineKind;
+    /** The plan key, or the add-on's (bundle's) key. */
+    readonly key: string;
+    readonly billingCycle: BillingCycle;
+    readonly amountNet: number;
+}
+/** The longest reason a withdrawal carries: the operator's words to the subscribers, not a document. */
+declare const FEATURE_WITHDRAWAL_REASON_MAX_LENGTH = 1000;
+/** A withdrawal as it is kept: one per announcement. */
+interface FeatureWithdrawalRecord {
+    readonly id: string;
+    readonly featureKey: string;
+    /** Why, in the operator's words, as the subscribers are shown it. */
+    readonly reason: string;
+    /** From when the feature is granted to nobody. */
+    readonly effectiveFrom: Date;
+    /** From when it is granted again, once the operator has lifted the withdrawal. */
+    readonly liftedFrom: Date | null;
+    readonly reductions: readonly FeatureWithdrawalReduction[];
+    readonly announcedAt: Date;
+    /** Who announced it — an actor tag, as the audit log writes it. */
+    readonly announcedBy: string;
+    readonly liftedAt: Date | null;
+    readonly liftedBy: string | null;
+    /**
+     * When the subscriptions it reaches were read and their notices recorded;
+     * null until then. Announcing records the withdrawal first and reads who it
+     * reaches once it is recorded, so that a change concluded while it was
+     * being announced is not missed — the quarter-hourly run tells the ones
+     * still null.
+     */
+    readonly toldAt: Date | null;
+}
+type NewFeatureWithdrawal = Pick<FeatureWithdrawalRecord, 'featureKey' | 'reason' | 'effectiveFrom' | 'reductions' | 'announcedAt' | 'announcedBy'>;
+/** What lifting a withdrawal records. */
+interface FeatureWithdrawalLift {
+    readonly liftedFrom: Date;
+    readonly liftedAt: Date;
+    readonly liftedBy: string;
+}
+/**
+ * Whether `withdrawal` takes its feature away at `at`. A withdrawal lifted
+ * before its date never does.
+ */
+declare function isFeatureWithdrawnAt(withdrawal: Pick<FeatureWithdrawalRecord, 'effectiveFrom' | 'liftedFrom'>, at: Date): boolean;
+/** The features `withdrawals` take away at `at`. */
+declare function featuresWithdrawnAt(withdrawals: readonly Pick<FeatureWithdrawalRecord, 'featureKey' | 'effectiveFrom' | 'liftedFrom'>[], at: Date): Set<string>;
+/**
+ * The first moment after `at` at which what `withdrawals` take away changes —
+ * one takes effect, or is lifted — or null where none is still to come.
+ */
+declare function nextWithdrawalChange(withdrawals: readonly Pick<FeatureWithdrawalRecord, 'effectiveFrom' | 'liftedFrom'>[], at: Date): Date | null;
+/**
+ * The manifest capability that announces withdrawing a feature. The platform
+ * sets it where it serves the routes, and the admin UI offers the action only
+ * where it is set.
+ */
+declare const FEATURE_WITHDRAWAL_CAPABILITY = "features.withdraw";
+/**
+ * A line of a subscription a withdrawal reaches: the plan in the rhythm it is
+ * billed in, or one booking of an add-on.
+ */
+interface FeatureWithdrawalLine {
+    readonly line: FeatureWithdrawalLineKind;
+    /** The plan key, or the add-on's key. */
+    readonly key: string;
+    /** The plan's or the add-on's name, as the subscriber reads it. */
+    readonly label: string;
+    /** The booking, where the line is an add-on's; null for the plan. */
+    readonly subscriptionBundleId: string | null;
+    readonly billingCycle: BillingCycle;
+}
+/** A line as the subscriber was told of it: with the reduction it carries, or null for none. */
+interface FeatureWithdrawalNoticeLine extends FeatureWithdrawalLine {
+    readonly reductionNet: number | null;
+}
+/**
+ * A feature the subscription holds is withdrawn. Sent once per subscription and
+ * withdrawal, at the announcement, and kept as it was sent: it is the record of
+ * which lines the withdrawal reached and what each is reduced by.
+ */
+interface FeatureWithdrawnNotice {
+    readonly kind: 'feature-withdrawn';
+    readonly tenantId: string;
+    readonly subscriptionId: string;
+    readonly withdrawalId: string;
+    readonly featureKey: string;
+    readonly featureLabel: string;
+    readonly reason: string;
+    /** ISO 8601. */
+    readonly effectiveFrom: string;
+    readonly lines: readonly FeatureWithdrawalNoticeLine[];
+    /**
+     * Whether the subscription holds the feature through special terms its
+     * contract records and through no line: then it may end at once, and no
+     * reduction applies by itself.
+     */
+    readonly specialTerms: boolean;
+}
+/** A withdrawn feature is granted again. Sent once to every subscription told of the withdrawal. */
+interface FeatureWithdrawalLiftedNotice {
+    readonly kind: 'feature-withdrawal-lifted';
+    readonly tenantId: string;
+    readonly subscriptionId: string;
+    readonly withdrawalId: string;
+    readonly featureKey: string;
+    readonly featureLabel: string;
+    /** ISO 8601. */
+    readonly liftedFrom: string;
+}
+/**
+ * The subscription, or one booking of it, ended at once while a feature it
+ * holds was withdrawn: what the account credits the unused rest of the period
+ * already charged from. Recorded by each attempt before it ends anything, so
+ * the credit never lacks its record; an attempt whose end did not happen leaves
+ * one behind, and only the one whose `endedAt` the subscription or the booking
+ * records is sent, counted or credited (`endedAtOnceSubjectOf`).
+ */
+interface EndedAtOnceNotice {
+    readonly kind: 'ended-at-once';
+    readonly tenantId: string;
+    readonly subscriptionId: string;
+    /** The booking that ended; null where the subscription did, and every booking with it. */
+    readonly subscriptionBundleId: string | null;
+    readonly withdrawalId: string;
+    readonly featureKey: string;
+    readonly featureLabel: string;
+    /** ISO 8601. */
+    readonly endedAt: string;
+}
+/** A blocker or a refusal a person reads: a stable code and the values its sentence names. */
+interface FeatureWithdrawalBlocker {
+    readonly code: string;
+    readonly message: string;
+    readonly params: Record<string, string | number>;
+}
+/** A subscription a withdrawal reaches, as the operator previews it. */
+interface FeatureWithdrawalReachedRow {
+    readonly tenantId: string;
+    readonly subscriptionId: string;
+    readonly status: string;
+    /** Each line with its price per period in its rhythm, net, or null where none is known. */
+    readonly lines: readonly (FeatureWithdrawalLine & {
+        readonly priceNet: number | null;
+    })[];
+    /** Whether it holds the feature through special terms its contract records, and through no line. */
+    readonly specialTerms: boolean;
+}
+/** A subscription holding the feature that the withdrawal does not reach: it ends by the date. */
+interface FeatureWithdrawalSkippedRow {
+    readonly tenantId: string;
+    readonly subscriptionId: string;
+    readonly reason: 'ends-before';
+}
+/**
+ * A plan or an add-on in a rhythm the withdrawal reaches, which the operator
+ * may name a reduction for: how many lines it reaches and the lowest price
+ * among them, which a reduction may not exceed.
+ */
+interface FeatureWithdrawalTarget {
+    readonly kind: FeatureWithdrawalLineKind;
+    readonly key: string;
+    readonly label: string;
+    readonly billingCycle: BillingCycle;
+    readonly lines: number;
+    readonly lowestPriceNet: number | null;
+}
+/** What announcing a withdrawal now would do. */
+interface FeatureWithdrawalPreview {
+    readonly feature: {
+        readonly key: string;
+        readonly label: string;
+    };
+    /** ISO 8601: the date it would take effect. */
+    readonly effectiveFrom: string;
+    /** ISO 8601: the moment it is computed for. */
+    readonly asOf: string;
+    readonly reached: readonly FeatureWithdrawalReachedRow[];
+    readonly skipped: readonly FeatureWithdrawalSkippedRow[];
+    readonly targets: readonly FeatureWithdrawalTarget[];
+    /** Empty where it may be announced as it stands. */
+    readonly blockers: readonly FeatureWithdrawalBlocker[];
+}
+/** A withdrawal as the administration reads it: the record, its dates as ISO 8601. */
+interface FeatureWithdrawalRow {
+    readonly id: string;
+    readonly featureKey: string;
+    readonly reason: string;
+    readonly effectiveFrom: string;
+    readonly liftedFrom: string | null;
+    readonly reductions: readonly FeatureWithdrawalReduction[];
+    readonly announcedAt: string;
+    readonly announcedBy: string;
+    readonly liftedAt: string | null;
+    readonly liftedBy: string | null;
+    /** When the subscriptions it reaches were told; null until then. */
+    readonly toldAt: string | null;
+}
+/** The row the administration reads for `record`. */
+declare function featureWithdrawalRowOf(record: FeatureWithdrawalRecord): FeatureWithdrawalRow;
+/** What an announcement did. */
+interface FeatureWithdrawalAnnounced {
+    readonly withdrawal: FeatureWithdrawalRow;
+    /** Notices sent now; the rest are sent by the next run. */
+    readonly told: number;
+    readonly failed: number;
+}
+/** What lifting a withdrawal did. */
+interface FeatureWithdrawalLifted {
+    readonly withdrawal: FeatureWithdrawalRow;
+    readonly told: number;
+    readonly failed: number;
+}
+/** A withdrawal as the administration lists it, with how far it has come. */
+interface FeatureWithdrawalView extends FeatureWithdrawalRow {
+    readonly featureLabel: string;
+    readonly progress: {
+        /** The subscriptions it reached. */
+        readonly reached: number;
+        /** Of those, the ones whose notice reached somebody. */
+        readonly told: number;
+        /** The subscriptions and bookings that ended at once under it. */
+        readonly endedAtOnce: number;
+    };
+}
+/** A line of the tenant's subscription a withdrawal reached, as the tenant sees it now. */
+interface TenantFeatureWithdrawalLine extends FeatureWithdrawalNoticeLine {
+    /**
+     * Whether the reduction still applies: the line runs as it was reached.
+     * A change of plan or rhythm the subscriber made ends it.
+     */
+    readonly reduced: boolean;
+    /**
+     * Where a change scheduled before the announcement brings the line and has
+     * not landed yet: when it lands, ISO 8601, from which the reduction
+     * applies. Null otherwise.
+     */
+    readonly fromChange: string | null;
+}
+/** A withdrawal reaching the tenant's subscription, beside its plan and its add-ons. */
+interface TenantFeatureWithdrawal {
+    readonly withdrawalId: string;
+    readonly featureKey: string;
+    readonly featureLabel: string;
+    readonly reason: string;
+    /** ISO 8601. */
+    readonly effectiveFrom: string;
+    /** ISO 8601, once the operator has lifted it. */
+    readonly liftedFrom: string | null;
+    /** Whether it takes the feature away now. */
+    readonly inEffect: boolean;
+    readonly lines: readonly TenantFeatureWithdrawalLine[];
+    readonly specialTerms: boolean;
+    /** What may be ended at once now: the subscription, and which bookings. */
+    readonly endable: {
+        readonly subscription: boolean;
+        readonly subscriptionBundleIds: readonly string[];
+    };
+}
+/**
+ * The features `withdrawals` take away at `now` or from a date ahead, and not
+ * lifted by then, the earliest first: what a catalogue marks beside every plan
+ * and add-on that grants them. A withdrawal lifted before its own date takes
+ * nothing away. One feature can appear twice — withdrawn until a date, and
+ * again from it.
+ */
+declare function withdrawnFeaturesOf(withdrawals: readonly FeatureWithdrawalRecord[], now: Date): WithdrawnFeature[];
+/**
+ * A feature withdrawn now or from a date ahead, as a catalogue marks it beside
+ * every plan and add-on that grants it, so whoever concludes is shown it first.
+ */
+interface WithdrawnFeature extends FeatureWithdrawalMark {
+    readonly featureKey: string;
+}
+/** What ending at once now would credit, before the subscriber confirms it. */
+interface EndAtOncePreview {
+    /** ISO 8601: the moment it ends. */
+    readonly endsAt: string;
+    /** The unused rest of what was charged, net, as a positive amount; 0 where nothing was charged. */
+    readonly creditNet: number;
+    /** ISO 4217, where anything is credited. */
+    readonly currency: string | null;
+}
+/** What ending at once did. */
+interface EndedAtOnce extends EndAtOncePreview {
+    readonly withdrawalId: string;
+    /** The booking that ended; null where the subscription did. */
+    readonly subscriptionBundleId: string | null;
+}
+/**
+ * The subject an end at once is recorded under: the subscription or the
+ * booking, and the moment the attempt names, so a later attempt records its
+ * own moment rather than inheriting one whose end never happened.
+ */
+declare function endedAtOnceSubjectOf(subscriptionOrBookingId: string, at: Date): string;
+
 /** What a notice is about. */
-type SubscriptionNoticeKind = 'version-offered' | 'version-retired' | 'version-retirement-reminder' | 'bundle-version-retired' | 'bundle-version-retirement-reminder' | 'bundle-version-offered';
+type SubscriptionNoticeKind = 'version-offered' | 'version-retired' | 'version-retirement-reminder' | 'bundle-version-retired' | 'bundle-version-retirement-reminder' | 'bundle-version-offered' | 'feature-withdrawn' | 'feature-withdrawal-lifted' | 'ended-at-once';
 /** Which notice: there is one per subscription, kind and subject. */
 interface SubscriptionNoticeKey {
     readonly tenantId: string;
@@ -3239,7 +3603,10 @@ interface SubscriptionNoticeKey {
      * the retirement once. For `bundle-version-retirement-reminder`, the id of
      * the add-on version retired as well: that booking is reminded of it once.
      * For `bundle-version-offered`, the id of the add-on version offered: that
-     * booking is told of the version once.
+     * booking is told of the version once. For `feature-withdrawn` and
+     * `feature-withdrawal-lifted`, the id of the withdrawal: a subscription is
+     * told of each once. For `ended-at-once`, the id of what ended — the
+     * subscription, or the booking — which ends once.
      */
     readonly subject: string;
 }
@@ -3292,7 +3659,7 @@ interface BundleVersionOfferedNotice {
     readonly offer: BundleVersionOfferView;
 }
 /** A notice handed to the application to send. */
-type SubscriptionNotice = VersionOfferedNotice | VersionRetiredNotice | VersionRetirementReminder | BundleVersionRetiredNotice | BundleVersionRetirementReminder | BundleVersionOfferedNotice;
+type SubscriptionNotice = VersionOfferedNotice | VersionRetiredNotice | VersionRetirementReminder | BundleVersionRetiredNotice | BundleVersionRetirementReminder | BundleVersionOfferedNotice | FeatureWithdrawnNotice | FeatureWithdrawalLiftedNotice | EndedAtOnceNotice;
 
 /**
  * A `subscription_notices` row as either adapter reads it back. The two JSON
@@ -3391,6 +3758,31 @@ interface CanonicalBundleVersionRetirementRow {
 /** Reads a row back as a record, naming each column rather than spreading the row. */
 declare function toBundleVersionRetirementRecord(row: CanonicalBundleVersionRetirementRow): BundleVersionRetirementRecord;
 
+/**
+ * A `feature_withdrawals` row as either adapter reads it back. `reductions` is
+ * `unknown`: the database holds whatever was written to the column.
+ */
+interface CanonicalFeatureWithdrawalRow {
+    id: string;
+    featureKey: string;
+    reason: string;
+    effectiveFrom: Date;
+    liftedFrom: Date | null;
+    reductions: unknown;
+    announcedAt: Date;
+    announcedBy: string;
+    liftedAt: Date | null;
+    liftedBy: string | null;
+    toldAt: Date | null;
+}
+/**
+ * Reads a row back as a record, naming each column rather than spreading the
+ * row. The reductions are checked rather than cast: they are what every
+ * subscription the withdrawal reached is charged less by, and a value nobody
+ * can read must stop at the read and name its row.
+ */
+declare function toFeatureWithdrawalRecord(row: CanonicalFeatureWithdrawalRow): FeatureWithdrawalRecord;
+
 /** A scheduled change as a subscription row holds it. */
 interface ScheduledChangeColumns {
     readonly pendingPlan: string | null;
@@ -3479,6 +3871,28 @@ declare function maintenanceRetryAfterSeconds(window: MaintenanceWindowRecord, n
  */
 declare function parseZonedInstant(text: string): Date | null;
 
+/** A calendar day, `YYYY-MM-DD`. */
+type CalendarDay = string;
+/**
+ * The day `at` falls on in `timeZone`. Throws a `RangeError` for a zone the
+ * runtime does not know, and for no zone at all — without one `Intl` would
+ * read the host's, and the day would depend on the machine.
+ */
+declare function dayInZone(at: Date, timeZone: string): CalendarDay;
+/**
+ * The last day a period covers in `timeZone`. A period ends before `until`, so
+ * its last moment is one millisecond earlier: a month from 1 October to
+ * 1 November covers 31 October as its last day.
+ */
+declare function lastDayInZone(period: {
+    from: Date;
+    until: Date;
+}, timeZone: string): CalendarDay;
+/** The day `days` calendar days after `day`; months and years roll over as the calendar does. */
+declare function addDaysToDay(day: CalendarDay, days: number): CalendarDay;
+/** The year a day belongs to. */
+declare function yearOfDay(day: CalendarDay): number;
+
 /**
  * The top-level blocks of `config/saas.yaml` that are the catalogue rather than
  * the configuration, and the format marker.
@@ -4275,6 +4689,331 @@ interface PromoRevenueDeductionAggregator {
     sumGrossForPromoCode(promoCodeId: string): Promise<string>;
 }
 
+/**
+ * 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. bundleChange: what an add-on's switch to a dearer version adds for the rest of its period. 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. reductionTakenBack: a reduction granted in advance, taken back for the days it no longer covers — the feature it was granted for came back, or what it reduced ended at once.
+ */
+type SubscriberChargeOrigin = 'activation' | 'renewal' | 'planChange' | 'bundleBooking' | 'bundleChange' | 'credit' | 'correction' | 'reductionTakenBack';
+/**
+ * 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[];
+}
+
+/** The issuer an invoice names, as of its issue date. */
+interface SubscriptionInvoiceIssuer extends LegalIdentity, PartyAddress {
+}
+/** The subscriber an invoice names, copied from its record on the issue date. */
+interface SubscriptionInvoiceSubscriber extends LegalIdentity, PartyAddress {
+    customerNumber: string;
+}
+/** One line of an invoice: one charge, as the invoice states it. */
+interface SubscriptionInvoiceLineRecord {
+    id: string;
+    invoiceId: string;
+    /** From 1, in the order the invoice lists its lines. */
+    position: number;
+    /** The charge the line invoices; a charge stands on one invoice (`SC-PRIC-022`). */
+    chargeId: string;
+    /** The contract line the charge came from (`SC-AUD-013`). */
+    contractLineItemId: string;
+    /** What the line is for, as the contract line names it. */
+    title: string;
+    origin: SubscriberChargeOrigin;
+    source: SubscriberChargeSource;
+    /** The first day the charge covers, in the installation's time zone. */
+    periodFrom: CalendarDay;
+    /** The last day the charge covers, in the installation's time zone. */
+    periodUntil: CalendarDay;
+    /** Net, as the charge was written. Negative for a discount. */
+    amountNet: number;
+    /** In per cent: the rate of the invoice's treatment. */
+    taxRate: number;
+}
+/** A line to write: everything but what the store assigns. */
+type NewSubscriptionInvoiceLine = Omit<SubscriptionInvoiceLineRecord, 'id' | 'invoiceId'>;
+/** An invoice as a store reads it back. */
+interface SubscriptionInvoiceRecord {
+    id: string;
+    /** `<prefix>-<year>-<sequence>`, e.g. `AHP-2026-000123` (`formatInvoiceNumber`). */
+    number: string;
+    numberPrefix: string;
+    /** The year of the issue date, which the sequence restarts with. */
+    numberYear: number;
+    /** From 1 each year, without gaps. */
+    numberSequence: number;
+    tenantId: string;
+    subscriberId: string;
+    subscriptionId: string;
+    /** The contract the invoiced charges belong to. */
+    contractId: string;
+    issuedAt: Date;
+    /** The day it was issued, in the installation's time zone. */
+    issueDate: CalendarDay;
+    /** The day it is due: the issue date plus the payment term (`SC-PRIC-046`). */
+    dueDate: CalendarDay;
+    /** The first day its charges cover. */
+    servicePeriodFrom: CalendarDay;
+    /** The last day its charges cover. */
+    servicePeriodUntil: CalendarDay;
+    currency: string;
+    issuer: SubscriptionInvoiceIssuer;
+    subscriber: SubscriptionInvoiceSubscriber;
+    /**
+     * The lines `config/saas.yaml` named under `invoicing.footer` on the issue
+     * date — what a business letter of the issuer states beyond the invoice's
+     * own content (`SC-PRIC-077`); none where it named none.
+     */
+    footer: string[];
+    /** The treatment the tax adapter decided when it was issued, with its name and version. */
+    taxTreatment: TaxTreatment;
+    /** The tax, rate by rate, computed once per rate (`SC-PRIC-041`). */
+    taxes: TaxAtRate[];
+    totalNet: number;
+    totalTax: number;
+    totalGross: number;
+    lines: SubscriptionInvoiceLineRecord[];
+    createdAt: Date;
+}
+/**
+ * An invoice to issue: everything but what the store assigns — the id, and
+ * the number, which the store draws when it writes the invoice.
+ */
+interface NewSubscriptionInvoice extends Omit<SubscriptionInvoiceRecord, 'id' | 'number' | 'numberSequence' | 'lines' | 'createdAt'> {
+    lines: NewSubscriptionInvoiceLine[];
+}
+/** How many digits an invoice number's sequence is written with, at least. */
+declare const INVOICE_SEQUENCE_DIGITS = 6;
+/**
+ * The number an invoice carries: the prefix `config/saas.yaml` names, the year
+ * the sequence counts in, and the sequence written with at least six digits —
+ * `formatInvoiceNumber('AHP', 2026, 123)` is `AHP-2026-000123`.
+ */
+declare function formatInvoiceNumber(prefix: string, year: number, sequence: number): string;
+
+/**
+ * The manifest capability that announces the operator's download of an
+ * invoice's archived document. The platform sets it where it serves the route.
+ */
+declare const INVOICE_DOCUMENT_CAPABILITY = "invoices.read";
+/** A rendered invoice: its bytes, as a file. */
+interface InvoiceDocument {
+    content: Uint8Array;
+    /** `application/pdf` for a ZUGFeRD invoice. */
+    mediaType: string;
+    /** What a person saving it would call it, such as `AHP-2026-000123.pdf`. */
+    fileName: string;
+}
+/**
+ * Renders an invoice into the file the tax adapter's law requires — the
+ * application's own renderer, or the default one SaaSiCat ships.
+ *
+ * Given the invoice as it was issued, it renders the same bytes every time, so
+ * a repeated attempt archives the file whose checksum was recorded. Whatever
+ * it would take from the clock, such as a PDF's creation date, it takes from
+ * the invoice's `issuedAt`. A renderer updated between two attempts renders
+ * other bytes; while nothing is archived, those take the place of the ones
+ * recorded, and the audit log says so (`SC-AUD-019`).
+ */
+interface InvoiceRenderer {
+    render(invoice: SubscriptionInvoiceRecord): Promise<InvoiceDocument>;
+}
+/** A document to archive: the file, under its invoice, with the checksum recorded for it. */
+interface InvoiceDocumentToArchive extends InvoiceDocument {
+    invoiceId: string;
+    /** SHA-256 of `content`, lower-case hex. */
+    checksum: string;
+    archivedAt: Date;
+}
+/** A document as the archive hands it back. */
+type ArchivedInvoiceDocument = InvoiceDocumentToArchive;
+/**
+ * Keeps each invoice's document, unalterable, for as long as the law asks —
+ * in Germany 8 years from the end of the calendar year it was issued in, in
+ * the European Union. The shipped adapters keep it in the database
+ * (`SubscriptionInvoiceArchive`, which refuses every update and delete);
+ * object storage with a retention lock is another way to implement it.
+ */
+interface InvoiceArchivePort {
+    /**
+     * Stores the document under its invoice. Storing it again with the same
+     * checksum is the same write and changes nothing; another checksum for an
+     * invoice already archived is refused with
+     * `SUBSCRIPTION_INVOICE_DOCUMENT_CHANGED`, and the first stays.
+     */
+    store(document: InvoiceDocumentToArchive): Promise<void>;
+    /** The document archived under the invoice, or `null` where none is. */
+    read(invoiceId: string): Promise<ArchivedInvoiceDocument | null>;
+    /**
+     * Why the archive would let a document it keeps be changed or removed, or
+     * `null` where it would not. Asked when invoices start, which are refused
+     * while it names a reason: an archive that is not unalterable keeps no
+     * document as the law asks, and would only be found out at an audit.
+     */
+    protectionProblem(): Promise<string | null>;
+}
+/** An invoice on its way to the subscriber. */
+interface InvoiceMail {
+    invoice: SubscriptionInvoiceRecord;
+    /** The invoice email on the subscriber's record. */
+    to: string;
+    /** The archived file, to attach. */
+    document: InvoiceDocument;
+}
+/**
+ * Sends an invoice to the subscriber with its file attached (`SC-PRIC-047`).
+ *
+ * The application words the message — in the subscriber's language, with a
+ * link to the tenant's sign-in rather than to the file itself — and sends it
+ * with its own mail infrastructure. It rejects where the message could not be
+ * handed on; the platform then shows the failure to the operator, with the
+ * rejection's message as the reason and the recipient's address taken out of
+ * it, and tries again on the next run. The invoice stays issued either way: delivery is not
+ * what makes it an invoice.
+ *
+ * A run claims the invoice before it calls this, so of several instances one
+ * sends it. One that does not answer within a minute holds the invoice for
+ * its answer: a late success is recorded, a late failure tried again.
+ */
+interface InvoiceMailPort {
+    deliver(mail: InvoiceMail): Promise<void>;
+}
+/** Where an invoice's document stands, as the invoice records it. */
+interface SubscriptionInvoiceDocumentRecord {
+    invoiceId: string;
+    /** SHA-256 of the rendered file, lower-case hex, recorded before it is archived. */
+    checksum: string;
+    mediaType: string;
+    fileName: string;
+    /** In bytes. */
+    size: number;
+    renderedAt: Date;
+    /** When the archive confirmed it; `null` while the invoice waits for its document. */
+    archivedAt: Date | null;
+    /**
+     * When the run that is mailing it took it on; `null` while no run holds it.
+     * A claim older than the lease is taken on by the next run.
+     */
+    deliveryClaimedAt: Date | null;
+    /** When it was handed to the mail; `null` until then. */
+    deliveredAt: Date | null;
+    /** The address it was sent to. */
+    deliveredTo: string | null;
+}
+/** What is recorded of a rendering before its file is archived. */
+type NewInvoiceRendering = Pick<SubscriptionInvoiceDocumentRecord, 'checksum' | 'mediaType' | 'fileName' | 'size' | 'renderedAt'>;
+
 /** The adapter that gave an answer, recorded beside the answer. */
 interface TaxAdapterIdentity {
     /** The adapter's package name, such as `@saasicat/tax-de`. */
@@ -4433,6 +5172,53 @@ interface TaxAdapter extends TaxAdapterIdentity {
      * an answer the adapter cannot read are each a check that did not complete.
      */
     checkVatId(vatId: string, issuer: TaxIssuer): Promise<VatIdCheckOutcome>;
+    /**
+     * An invoice's tax by the rule this adapter's law names (`SC-PRIC-041`):
+     * per rate, with the totals the invoice states. The amount it states is
+     * the amount collected and the amount a payment settles.
+     */
+    invoiceTax(lines: readonly InvoiceTaxLine[]): TaxPerRate;
+    /**
+     * What an invoice lacks of the content the law requires of it
+     * (`SC-PRIC-027`), as the fields it misses — `issuer.taxIdentifier`,
+     * `subscriber.postalCode` — or none where it is complete. Asked before the
+     * number is drawn; an invoice that lacks anything is not issued.
+     */
+    invoiceContentGaps(draft: InvoiceContentDraft): readonly string[];
+    /**
+     * What a rendered document lacks of the format the law requires
+     * (`SC-PRIC-042`), or disagrees with in the invoice it was rendered from —
+     * `format.embeddedXml`, `xml.totalGross` — or none where it is the file to
+     * issue. A document with anything here is not archived, sent or offered;
+     * the invoice keeps its number and waits for a document that passes.
+     */
+    invoiceDocumentGaps(document: InvoiceDocument, invoice: SubscriptionInvoiceRecord): Promise<readonly string[]>;
+}
+/** A line as an invoice's tax is computed from it. */
+interface InvoiceTaxLine {
+    net: number;
+    /** In per cent. */
+    rate: number;
+}
+/**
+ * What an invoice says, without its number: what the adapter checks against
+ * the content the law requires before the number is drawn.
+ */
+interface InvoiceContentDraft {
+    issuer: LegalIdentity & PartyAddress;
+    subscriber: LegalIdentity & PartyAddress;
+    treatment: TaxTreatment;
+    issueDate: string;
+    dueDate: string;
+    servicePeriod: {
+        from: string;
+        until: string;
+    };
+    lines: readonly {
+        title: string;
+        net: number;
+        rate: number;
+    }[];
 }
 
 type ContractLineItemKind = 'plan' | 'bundle' | 'discount';
@@ -5004,172 +5790,50 @@ type AdminVatIdCheckOutcome = {
     /** When the service answered, as an ISO string. */
     checkedAt: string;
     service: string;
-    /** Whether it is the check that counts for the number held now. */
-    counts: boolean;
-} | {
-    completed: false;
-    reason: string;
-};
-/**
- * The answer to an operator's correction or check: the subscriber as it now
- * stands, and the check a VAT identification number got, where one was made.
- */
-interface AdminSubscriberCorrected {
-    subscriber: AdminTenantSubscriber;
-    vatIdCheck: AdminVatIdCheckOutcome | null;
-}
-/**
- * One entry of a subscriber's history as the operator reads it, the latest
- * first: a correction of its legal identity, a change of its country or
- * business status, or a check of its VAT identification number. Dates are ISO
- * strings.
- */
-type AdminSubscriberHistoryEntry = {
-    kind: 'identity-corrected';
-    at: string;
-    by: string;
-    previous: SubscriberIdentityValues;
-    corrected: SubscriberIdentityValues;
-    reason: string;
-} | {
-    kind: 'tax-origin-changed';
-    at: string;
-    by: string;
-    previous: SubscriberTaxOriginValues;
-    changed: SubscriberTaxOriginValues;
-    /** `null` for a change of the country with the contact details. */
-    reason: string | null;
-} | {
-    kind: 'vat-id-checked';
-    at: string;
-    vatId: string;
-    valid: boolean;
-    service: string;
-    /** Whether it is the check that counts for the number held now. */
-    counts: boolean;
-};
-
-/**
- * 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. bundleChange: what an add-on's switch to a dearer version adds for the rest of its period. 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' | 'bundleChange' | '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'>;
+    /** Whether it is the check that counts for the number held now. */
+    counts: boolean;
+} | {
+    completed: false;
+    reason: string;
+};
 /**
- * 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.
+ * The answer to an operator's correction or check: the subscriber as it now
+ * stands, and the check a VAT identification number got, where one was made.
  */
-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;
+interface AdminSubscriberCorrected {
+    subscriber: AdminTenantSubscriber;
+    vatIdCheck: AdminVatIdCheckOutcome | 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.
+ * One entry of a subscriber's history as the operator reads it, the latest
+ * first: a correction of its legal identity, a change of its country or
+ * business status, or a check of its VAT identification number. Dates are ISO
+ * strings.
  */
-interface AdminSubscriberAccount {
-    /** `null` for a tenant that has no subscriber. */
-    holder: AdminAccountHolder | null;
-    entries: AdminAccountEntry[];
-}
+type AdminSubscriberHistoryEntry = {
+    kind: 'identity-corrected';
+    at: string;
+    by: string;
+    previous: SubscriberIdentityValues;
+    corrected: SubscriberIdentityValues;
+    reason: string;
+} | {
+    kind: 'tax-origin-changed';
+    at: string;
+    by: string;
+    previous: SubscriberTaxOriginValues;
+    changed: SubscriberTaxOriginValues;
+    /** `null` for a change of the country with the contact details. */
+    reason: string | null;
+} | {
+    kind: 'vat-id-checked';
+    at: string;
+    vatId: string;
+    valid: boolean;
+    service: string;
+    /** Whether it is the check that counts for the number held now. */
+    counts: boolean;
+};
 
 /**
  * Snapshot form of a `Subscription` row for the EntitlementService
@@ -5381,6 +6045,26 @@ interface SubscriptionBundleRepository {
      * them still move.
      */
     listScheduledVersionsDue?(asOf: Date): Promise<SubscriptionBundleRecord[]>;
+    /**
+     * Ends at `input.at` the booking `subscriptionBundleId` whose cancellation
+     * was declared for a later date, provided its effective date is still
+     * `input.expectedCanceledEffectiveAt`, and answers it as it now stands;
+     * null where its cancellation moved meanwhile, or it is gone. Both
+     * cancellation fields become `input.at`. What a feature withdrawn for an
+     * external reason lets a subscriber do, cancelled or not; a booking not
+     * cancelled is ended through `cancel`.
+     *
+     * Optional, so a repository written before it keeps working; without it, a
+     * booking already cancelled for a later date cannot be ended at once.
+     */
+    endNow?(subscriptionBundleId: string, input: EndNowInput): Promise<SubscriptionBundleRecord | null>;
+}
+/** What ending at once something cancelled for a later date is told to write. */
+interface EndNowInput {
+    /** The moment it ends, and the moment that is declared. */
+    readonly at: Date;
+    /** The effective date of the cancellation the caller read: the write is conditional on it. */
+    readonly expectedCanceledEffectiveAt: Date;
 }
 /**
  * Append-only repository for V3 SubscriptionContracts. Contracts are the
@@ -5565,6 +6249,113 @@ interface SubscriberLedgerRepository {
     /** Every charge of one subscription, oldest period first. */
     listBySubscription(subscriptionId: string, tx?: TransactionContext): Promise<SubscriberChargeRecord[]>;
 }
+/**
+ * The invoices issued from the charge journal, and the one number range they
+ * are numbered in (`SC-PRIC-072`).
+ *
+ * An invoice is written once and never changed. Its number is drawn when it is
+ * written, in the same transaction, so an invoice that fails to be written
+ * leaves no gap; the range restarts at 1 each year.
+ */
+interface SubscriptionInvoiceRepository {
+    /**
+     * The subscriptions with a charge to invoice: a charge on no invoice in a
+     * group — the charges booked at the same moment under the same contract —
+     * that carries an amount (`SC-PRIC-048`). By id, at most `limit`, after
+     * `after` where it is given, so a caller reads them page by page and a
+     * subscription held back on one run never keeps the others from the next.
+     */
+    listSubscriptionsWithUninvoicedCharges(page: {
+        limit: number;
+        after?: string;
+    }, tx?: TransactionContext): Promise<string[]>;
+    /** The charges of one subscription on no invoice, oldest period first. */
+    listUninvoicedCharges(subscriptionId: string, tx?: TransactionContext): Promise<SubscriberChargeRecord[]>;
+    /**
+     * Draws the next number of the invoice's year and writes the invoice with
+     * its lines, in one transaction — the caller's where it passes one. Two
+     * calls at once draw two numbers one after the other, never the same one
+     * and never with a gap between them.
+     *
+     * Refuses with `SUBSCRIPTION_INVOICE_CHARGE_INVOICED` (`moved`) where a
+     * charge already stands on an invoice: nothing is written, and the number
+     * is not drawn.
+     */
+    issue(invoice: NewSubscriptionInvoice, tx?: TransactionContext): Promise<SubscriptionInvoiceRecord>;
+    findById(id: string, tx?: TransactionContext): Promise<SubscriptionInvoiceRecord | null>;
+    /** Every invoice of one subscriber, the latest number first. */
+    listBySubscriber(subscriberId: string, tx?: TransactionContext): Promise<SubscriptionInvoiceRecord[]>;
+    /**
+     * The prefixes the issued invoices carry, at most two: one is the range,
+     * a second one says the prefix was changed under it (`SC-PRIC-024`).
+     */
+    listIssuedNumberPrefixes(tx?: TransactionContext): Promise<string[]>;
+    /**
+     * Records the rendering of an invoice's document before its file is
+     * archived (`SC-AUD-019`), once. A rendering recorded again with the same
+     * checksum is the same write and answers the record as it stands; another
+     * checksum is refused with `SUBSCRIPTION_INVOICE_DOCUMENT_CHANGED`
+     * (`moved`), and the first stays: `replaceRendering` is the one write that
+     * puts another in its place.
+     */
+    recordRendering(invoiceId: string, rendering: NewInvoiceRendering, tx?: TransactionContext): Promise<SubscriptionInvoiceDocumentRecord>;
+    /**
+     * Records a rendering in place of the one recorded with `replaced` as its
+     * checksum, while the invoice is not archived (`SC-AUD-019`): until the
+     * archive holds a file, nothing has been handed out. Answers the record as
+     * it stands now, or `null` where the recorded checksum is another by now or
+     * the invoice is archived — a run that read it before another one changed it.
+     */
+    replaceRendering(invoiceId: string, rendering: NewInvoiceRendering, replaced: string, tx?: TransactionContext): Promise<SubscriptionInvoiceDocumentRecord | null>;
+    /**
+     * Records that the archive confirmed the document whose checksum is
+     * `checksum`; `false` where it was already recorded, or the recorded
+     * checksum is another.
+     */
+    markArchived(invoiceId: string, at: Date, checksum: string, tx?: TransactionContext): Promise<boolean>;
+    /**
+     * Claims an archived invoice's mail for the run calling it at `at`: where
+     * it is not delivered and no run holds it, or the run that holds it took it
+     * on before `staleBefore`. `true` where this run holds it now — of two
+     * concurrent calls exactly one does — so that an invoice is mailed once
+     * however many instances run (`SC-PRIC-047`).
+     */
+    claimDelivery(invoiceId: string, at: Date, staleBefore: Date, tx?: TransactionContext): Promise<boolean>;
+    /**
+     * Records that the invoice was handed to the mail, provided it is still
+     * held by the claim taken at `claimedAt` and not delivered. `false` where it
+     * is not: the claim went stale and another run took the invoice on.
+     */
+    markDelivered(invoiceId: string, delivery: {
+        claimedAt: Date;
+        at: Date;
+        to: string;
+    }, tx?: TransactionContext): Promise<boolean>;
+    /**
+     * Lets go of the claim taken at `claimedAt`, so the next run tries again.
+     * Does nothing where the invoice is delivered or held by another claim.
+     */
+    releaseDelivery(invoiceId: string, claimedAt: Date, tx?: TransactionContext): Promise<void>;
+    /** Where the invoice's document stands, or `null` before it was rendered. */
+    findDocument(invoiceId: string, tx?: TransactionContext): Promise<SubscriptionInvoiceDocumentRecord | null>;
+    /**
+     * The invoices whose document the archive has not confirmed yet —
+     * not rendered, or rendered and not archived (`SC-PRIC-033`). By id, at
+     * most `limit`, after `after` where it is given.
+     */
+    listAwaitingDocument(page: {
+        limit: number;
+        after?: string;
+    }, tx?: TransactionContext): Promise<string[]>;
+    /**
+     * The invoices archived and not yet handed to the mail, page by page as
+     * above — whether or not a run holds them, which `claimDelivery` decides.
+     */
+    listAwaitingDelivery(page: {
+        limit: number;
+        after?: string;
+    }, tx?: TransactionContext): Promise<string[]>;
+}
 /**
  * Display form of a subscription for the tenant self-service UI.
  * Richer than `SubscriptionRecord` (which is only the aggregation form); contains
@@ -5907,6 +6698,14 @@ interface CancelSubscriptionInput {
     terminateNow: boolean;
     minimumTermUntil?: Date;
 }
+/** What `endNow` answers with. */
+interface EndSubscriptionNowResult {
+    /** False where the cancellation moved since it was read, and nothing was written. */
+    ended: boolean;
+    canceledAt: Date | null;
+    canceledEffectiveAt: Date | null;
+    status: string;
+}
 /** What `cancelSubscription` answers with. */
 interface CancelSubscriptionResult {
     canceledAt: Date | null;
@@ -5976,6 +6775,22 @@ interface TenantSubscriptionWritePort {
      * unchanged, which is the ordinary case.
      */
     cancelSubscription(tenantId: string, input: CancelSubscriptionInput): Promise<CancelSubscriptionResult>;
+    /**
+     * Ends at `input.at` a subscription whose cancellation was declared for a
+     * later date, provided its effective date is still
+     * `input.expectedCanceledEffectiveAt`: both cancellation fields become
+     * `input.at` and the status `CANCELED`. Answers `ended: false`, with the
+     * stored fields, where the cancellation moved meanwhile. A conditional
+     * claim, like `cancelSubscription`, so an end written in between is not
+     * written over.
+     *
+     * What a feature withdrawn for an external reason lets a subscriber do,
+     * cancelled or not; a subscription not cancelled is ended through
+     * `cancelSubscription` with `terminateNow`. Optional, so a port written
+     * before it keeps working; without it, a subscription already cancelled
+     * for a later date cannot be ended at once.
+     */
+    endNow?(tenantId: string, input: EndNowInput): Promise<EndSubscriptionNowResult>;
     /**
      * Atomic onboarding creation: sets plan + cycle + period window
      * AND optionally calls a promo-redeem callback — all in a
@@ -7104,6 +7919,45 @@ interface VersionRetirementRepository {
     findById(id: string): Promise<VersionRetirementRecord | null>;
 }
 
+/**
+ * Keeps every feature withdrawal: which feature, why, from when, the
+ * reductions the operator named, when it was lifted, and when the
+ * subscriptions it reaches were told. What it means for each of them is kept
+ * beside it as a notice of kind `feature-withdrawn`, written in the
+ * transaction that marks it told.
+ *
+ * An adapter translates. It does not decide whether a feature may be
+ * withdrawn; it holds a feature to one withdrawal not yet lifted, so that two
+ * operators announcing at once cannot both succeed, and makes lifting and
+ * marking it told conditional on neither having happened yet.
+ */
+interface FeatureWithdrawalRepository {
+    /**
+     * Records a withdrawal, in the caller's transaction where one is given, and
+     * returns it as stored — the id is the adapter's to assign. Returns null
+     * where a withdrawal of the same feature is recorded and not lifted: the
+     * database holds a feature to one, so of two concurrent calls exactly one
+     * lands.
+     */
+    create(data: NewFeatureWithdrawal, tx?: TransactionContext): Promise<FeatureWithdrawalRecord | null>;
+    /** Every withdrawal, the most recently announced first. */
+    list(): Promise<FeatureWithdrawalRecord[]>;
+    findById(id: string): Promise<FeatureWithdrawalRecord | null>;
+    /**
+     * Records that the withdrawal `id` is lifted, provided it is not lifted
+     * yet, and returns it as stored; null where it was lifted meanwhile or no
+     * withdrawal has that id.
+     */
+    lift(id: string, lift: FeatureWithdrawalLift, tx?: TransactionContext): Promise<FeatureWithdrawalRecord | null>;
+    /**
+     * Records that the subscriptions the withdrawal `id` reaches were told at
+     * `at`, provided nobody recorded it yet, in the caller's transaction where
+     * one is given. Returns whether this call recorded it: of an announcement
+     * and a run telling the same withdrawal at once, exactly one does.
+     */
+    markTold(id: string, at: Date, tx?: TransactionContext): Promise<boolean>;
+}
+
 /** Class reference usable as a DI token (e.g. the consumer's `PrismaService`). */
 type PersistenceClassRef = abstract new (...args: never[]) => unknown;
 /** DI token forms a persistence bundle may reference in `inject`. */
@@ -7191,6 +8045,10 @@ interface SaaSiCatPersistenceEntitlement {
     subscriberRepository?: PersistenceProvider<SubscriberRepository>;
     /** The charges a subscriber's contracts give rise to (`tenantBilling.chargeJournal`). */
     subscriberLedgerRepository?: PersistenceProvider<SubscriberLedgerRepository>;
+    /** The invoices issued from those charges (`tenantBilling.chargeJournal.invoices`). */
+    subscriptionInvoiceRepository?: PersistenceProvider<SubscriptionInvoiceRepository>;
+    /** The invoices' documents, kept in the database (`chargeJournal.invoices.archive`). */
+    subscriptionInvoiceArchive?: PersistenceProvider<InvoiceArchivePort>;
     subscriptionBundleRepository?: PersistenceProvider<SubscriptionBundleRepository>;
     bundleRepository?: PersistenceProvider<BundleRepository>;
 }
@@ -7234,6 +8092,11 @@ interface SaaSiCatPersistenceTenantBilling {
      * version is off, and retiring a plan version is not affected.
      */
     bundleVersionRetirements?: PersistenceProvider<BundleVersionRetirementRepository>;
+    /**
+     * The record of every feature withdrawal. Optional so an adapter written
+     * before it keeps working; without it, withdrawing a feature is off.
+     */
+    featureWithdrawals?: PersistenceProvider<FeatureWithdrawalRepository>;
 }
 /**
  * The record of payment gateway callbacks and the payment methods they confirm
@@ -7677,6 +8540,79 @@ declare const BILLING_ERROR_CODES: {
      * show it instead of guessing.
      */
     readonly BUNDLE_VERSION_OFFER_CHANGED: "BUNDLE_VERSION_OFFER_CHANGED";
+    /**
+     * Withdrawing a feature is not offered: the installation's stores cannot
+     * list everybody a withdrawal would reach.
+     */
+    readonly FEATURE_WITHDRAWAL_UNAVAILABLE: "FEATURE_WITHDRAWAL_UNAVAILABLE";
+    /** The catalogue knows no feature of that key, so there is nothing to withdraw. Carries `featureKey`. */
+    readonly FEATURE_WITHDRAWAL_FEATURE_UNKNOWN: "FEATURE_WITHDRAWAL_FEATURE_UNKNOWN";
+    /**
+     * The date names a moment before now. A feature is withdrawn from the
+     * moment it is announced or from a later date: the days before were
+     * delivered.
+     */
+    readonly FEATURE_WITHDRAWAL_DATE_IN_PAST: "FEATURE_WITHDRAWAL_DATE_IN_PAST";
+    /** A withdrawal of the feature is not lifted yet; one at a time. Carries `featureKey`. */
+    readonly FEATURE_WITHDRAWAL_OPEN: "FEATURE_WITHDRAWAL_OPEN";
+    /**
+     * A withdrawal of the feature is lifted only from a date after the one
+     * named, so the two would overlap. Carries `featureKey` and the `date` a
+     * new one may begin on.
+     */
+    readonly FEATURE_WITHDRAWAL_OVERLAPS: "FEATURE_WITHDRAWAL_OVERLAPS";
+    /**
+     * A reduction names a plan or an add-on, in a rhythm, that no line the
+     * withdrawal reaches is. Carries `kind`, `key` and `billingCycle`.
+     */
+    readonly FEATURE_WITHDRAWAL_REDUCTION_NOT_REACHED: "FEATURE_WITHDRAWAL_REDUCTION_NOT_REACHED";
+    /** A reduction is named twice. Carries `kind`, `key` and `billingCycle`. */
+    readonly FEATURE_WITHDRAWAL_REDUCTION_NAMED_TWICE: "FEATURE_WITHDRAWAL_REDUCTION_NAMED_TWICE";
+    /**
+     * A reduction is more than the lowest price among the lines it reduces:
+     * a price is reduced to nothing at most. Carries `key`, `billingCycle` and
+     * that `price`.
+     */
+    readonly FEATURE_WITHDRAWAL_REDUCTION_EXCEEDS_PRICE: "FEATURE_WITHDRAWAL_REDUCTION_EXCEEDS_PRICE";
+    /**
+     * The subscriptions the withdrawal reaches changed since the preview the
+     * operator looked at. Nothing was announced; carries the current `preview`.
+     */
+    readonly FEATURE_WITHDRAWAL_PREVIEW_CHANGED: "FEATURE_WITHDRAWAL_PREVIEW_CHANGED";
+    /** No withdrawal has that id. Carries `withdrawalId`. */
+    readonly FEATURE_WITHDRAWAL_NOT_FOUND: "FEATURE_WITHDRAWAL_NOT_FOUND";
+    /** The withdrawal was lifted already. Carries the `date` it is lifted from. */
+    readonly FEATURE_WITHDRAWAL_ALREADY_LIFTED: "FEATURE_WITHDRAWAL_ALREADY_LIFTED";
+    /**
+     * Nobody the withdrawal reaches has been told of it yet, and telling them
+     * failed just now: a withdrawal is lifted only once they were. Nothing was
+     * lifted; the next try, or the quarter-hourly run, tells them first.
+     */
+    readonly FEATURE_WITHDRAWAL_NOT_TOLD_YET: "FEATURE_WITHDRAWAL_NOT_TOLD_YET";
+    /**
+     * The date a withdrawal would be lifted from lies before now: what was
+     * withdrawn until then was withdrawn.
+     */
+    readonly FEATURE_WITHDRAWAL_LIFT_IN_PAST: "FEATURE_WITHDRAWAL_LIFT_IN_PAST";
+    /**
+     * The withdrawal does not take its feature away now — its date is ahead,
+     * or it was lifted — so nothing ends at once because of it. Carries
+     * `featureKey`.
+     */
+    readonly FEATURE_WITHDRAWAL_NOT_IN_EFFECT: "FEATURE_WITHDRAWAL_NOT_IN_EFFECT";
+    /**
+     * The withdrawal did not reach the subscription, or the line to end: it
+     * was not running at the announcement, or no longer holds the feature.
+     */
+    readonly FEATURE_WITHDRAWAL_DOES_NOT_REACH: "FEATURE_WITHDRAWAL_DOES_NOT_REACH";
+    /** What was to be ended at once has ended already. */
+    readonly FEATURE_WITHDRAWAL_ALREADY_ENDED: "FEATURE_WITHDRAWAL_ALREADY_ENDED";
+    /**
+     * A cancellation is declared for a later date, and the installation's
+     * subscription write or booking store cannot bring it forward (`endNow`).
+     * It ends as declared. Carries that `date`.
+     */
+    readonly FEATURE_WITHDRAWAL_END_NOW_UNSUPPORTED: "FEATURE_WITHDRAWAL_END_NOW_UNSUPPORTED";
     /** The subscription has ended; its plan can no longer be changed. */
     readonly SUBSCRIPTION_ENDED: "SUBSCRIPTION_ENDED";
     /** An active special contract blocks self-service plan changes. */
@@ -7823,6 +8759,57 @@ declare const CONTRACT_ERROR_CODES: {
     readonly SUBSCRIPTION_CONTRACT_TAX_RATE_NOT_DECIDED: "SUBSCRIPTION_CONTRACT_TAX_RATE_NOT_DECIDED";
 };
 type ContractErrorCode = (typeof CONTRACT_ERROR_CODES)[keyof typeof CONTRACT_ERROR_CODES];
+/** Invoices issued from the charge journal (`SubscriptionInvoiceService`). */
+declare const INVOICE_ERROR_CODES: {
+    /**
+     * A charge already stands on an invoice: a second run issuing the same
+     * charges lost the race. Nothing is written and no number is drawn.
+     */
+    readonly SUBSCRIPTION_INVOICE_CHARGE_INVOICED: "SUBSCRIPTION_INVOICE_CHARGE_INVOICED";
+    /**
+     * The invoice lacks content the tax adapter requires of it — `missing`
+     * names the fields, `adapter` the adapter. It draws no number and waits
+     * until what is missing is supplied (`SC-PRIC-027`).
+     */
+    readonly SUBSCRIPTION_INVOICE_CONTENT_INCOMPLETE: "SUBSCRIPTION_INVOICE_CONTENT_INCOMPLETE";
+    /**
+     * The contract's parties were copied by a migration and the operator has
+     * not confirmed them yet; its charges are not invoiced until then
+     * (`SC-AUD-012`).
+     */
+    readonly SUBSCRIPTION_INVOICE_PARTIES_UNCONFIRMED: "SUBSCRIPTION_INVOICE_PARTIES_UNCONFIRMED";
+    /**
+     * A file of the invoice's document has another checksum than the one
+     * recorded or archived for it (`invoiceId`, `recorded`, `rendered`), and
+     * the first stays. The run takes the archived file as the one issued, or —
+     * where nothing is archived — records the new rendering in place of the
+     * old (`SC-AUD-019`); the invoice waits only where another run changed the
+     * record or the archive in between, and the next run settles it.
+     */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_CHANGED: "SUBSCRIPTION_INVOICE_DOCUMENT_CHANGED";
+    /**
+     * The tax adapter refuses the rendered document — `missing` names what it
+     * lacks or disagrees with, `adapter` the adapter. The invoice keeps its
+     * number and waits for a document that passes (`SC-PRIC-042`).
+     */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_REFUSED: "SUBSCRIPTION_INVOICE_DOCUMENT_REFUSED";
+    /**
+     * The archived document does not match the checksum recorded when it was
+     * rendered (`invoiceId`). It is not handed out (`SC-AUD-019`).
+     */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_MISMATCH: "SUBSCRIPTION_INVOICE_DOCUMENT_MISMATCH";
+    /** The invoice's document is not archived yet (`invoiceId`); nothing is offered until it is (`SC-AUD-014`). */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_NOT_ARCHIVED: "SUBSCRIPTION_INVOICE_DOCUMENT_NOT_ARCHIVED";
+    /** No invoice with this id (`invoiceId`). */
+    readonly SUBSCRIPTION_INVOICE_NOT_FOUND: "SUBSCRIPTION_INVOICE_NOT_FOUND";
+    /**
+     * The subscriber's record holds no invoice email (`subscriberId`), so the
+     * archived invoice cannot be sent (`SC-PRIC-047`); it is sent once one is
+     * entered.
+     */
+    readonly SUBSCRIPTION_INVOICE_NO_INVOICE_EMAIL: "SUBSCRIPTION_INVOICE_NO_INVOICE_EMAIL";
+};
+type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[keyof typeof INVOICE_ERROR_CODES];
 /** The parties contracts are concluded with (`SubscriberService`), and their absence. */
 declare const SUBSCRIBER_ERROR_CODES: {
     /**
@@ -8140,6 +9127,53 @@ declare const PLATFORM_ERROR_CODES: {
     readonly SUBSCRIBER_BUSINESS_STATUS_REASON_REQUIRED: "SUBSCRIBER_BUSINESS_STATUS_REASON_REQUIRED";
     /** A check of the subscriber's VAT identification number was asked for, and it holds none. */
     readonly SUBSCRIBER_VAT_ID_MISSING: "SUBSCRIBER_VAT_ID_MISSING";
+    /**
+     * A charge already stands on an invoice: a second run issuing the same
+     * charges lost the race. Nothing is written and no number is drawn.
+     */
+    readonly SUBSCRIPTION_INVOICE_CHARGE_INVOICED: "SUBSCRIPTION_INVOICE_CHARGE_INVOICED";
+    /**
+     * The invoice lacks content the tax adapter requires of it — `missing`
+     * names the fields, `adapter` the adapter. It draws no number and waits
+     * until what is missing is supplied (`SC-PRIC-027`).
+     */
+    readonly SUBSCRIPTION_INVOICE_CONTENT_INCOMPLETE: "SUBSCRIPTION_INVOICE_CONTENT_INCOMPLETE";
+    /**
+     * The contract's parties were copied by a migration and the operator has
+     * not confirmed them yet; its charges are not invoiced until then
+     * (`SC-AUD-012`).
+     */
+    readonly SUBSCRIPTION_INVOICE_PARTIES_UNCONFIRMED: "SUBSCRIPTION_INVOICE_PARTIES_UNCONFIRMED";
+    /**
+     * A file of the invoice's document has another checksum than the one
+     * recorded or archived for it (`invoiceId`, `recorded`, `rendered`), and
+     * the first stays. The run takes the archived file as the one issued, or —
+     * where nothing is archived — records the new rendering in place of the
+     * old (`SC-AUD-019`); the invoice waits only where another run changed the
+     * record or the archive in between, and the next run settles it.
+     */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_CHANGED: "SUBSCRIPTION_INVOICE_DOCUMENT_CHANGED";
+    /**
+     * The tax adapter refuses the rendered document — `missing` names what it
+     * lacks or disagrees with, `adapter` the adapter. The invoice keeps its
+     * number and waits for a document that passes (`SC-PRIC-042`).
+     */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_REFUSED: "SUBSCRIPTION_INVOICE_DOCUMENT_REFUSED";
+    /**
+     * The archived document does not match the checksum recorded when it was
+     * rendered (`invoiceId`). It is not handed out (`SC-AUD-019`).
+     */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_MISMATCH: "SUBSCRIPTION_INVOICE_DOCUMENT_MISMATCH";
+    /** The invoice's document is not archived yet (`invoiceId`); nothing is offered until it is (`SC-AUD-014`). */
+    readonly SUBSCRIPTION_INVOICE_DOCUMENT_NOT_ARCHIVED: "SUBSCRIPTION_INVOICE_DOCUMENT_NOT_ARCHIVED";
+    /** No invoice with this id (`invoiceId`). */
+    readonly SUBSCRIPTION_INVOICE_NOT_FOUND: "SUBSCRIPTION_INVOICE_NOT_FOUND";
+    /**
+     * The subscriber's record holds no invoice email (`subscriberId`), so the
+     * archived invoice cannot be sent (`SC-PRIC-047`); it is sent once one is
+     * entered.
+     */
+    readonly SUBSCRIPTION_INVOICE_NO_INVOICE_EMAIL: "SUBSCRIPTION_INVOICE_NO_INVOICE_EMAIL";
     readonly CHECKOUT_OFFER_LINE_ITEMS_REQUIRED: "CHECKOUT_OFFER_LINE_ITEMS_REQUIRED";
     readonly CHECKOUT_OFFER_PLAN_LINE_ITEM_REQUIRED: "CHECKOUT_OFFER_PLAN_LINE_ITEM_REQUIRED";
     readonly CHECKOUT_OFFER_BUNDLE_LINE_ITEMS_REQUIRED: "CHECKOUT_OFFER_BUNDLE_LINE_ITEMS_REQUIRED";
@@ -8447,6 +9481,79 @@ declare const PLATFORM_ERROR_CODES: {
      * show it instead of guessing.
      */
     readonly BUNDLE_VERSION_OFFER_CHANGED: "BUNDLE_VERSION_OFFER_CHANGED";
+    /**
+     * Withdrawing a feature is not offered: the installation's stores cannot
+     * list everybody a withdrawal would reach.
+     */
+    readonly FEATURE_WITHDRAWAL_UNAVAILABLE: "FEATURE_WITHDRAWAL_UNAVAILABLE";
+    /** The catalogue knows no feature of that key, so there is nothing to withdraw. Carries `featureKey`. */
+    readonly FEATURE_WITHDRAWAL_FEATURE_UNKNOWN: "FEATURE_WITHDRAWAL_FEATURE_UNKNOWN";
+    /**
+     * The date names a moment before now. A feature is withdrawn from the
+     * moment it is announced or from a later date: the days before were
+     * delivered.
+     */
+    readonly FEATURE_WITHDRAWAL_DATE_IN_PAST: "FEATURE_WITHDRAWAL_DATE_IN_PAST";
+    /** A withdrawal of the feature is not lifted yet; one at a time. Carries `featureKey`. */
+    readonly FEATURE_WITHDRAWAL_OPEN: "FEATURE_WITHDRAWAL_OPEN";
+    /**
+     * A withdrawal of the feature is lifted only from a date after the one
+     * named, so the two would overlap. Carries `featureKey` and the `date` a
+     * new one may begin on.
+     */
+    readonly FEATURE_WITHDRAWAL_OVERLAPS: "FEATURE_WITHDRAWAL_OVERLAPS";
+    /**
+     * A reduction names a plan or an add-on, in a rhythm, that no line the
+     * withdrawal reaches is. Carries `kind`, `key` and `billingCycle`.
+     */
+    readonly FEATURE_WITHDRAWAL_REDUCTION_NOT_REACHED: "FEATURE_WITHDRAWAL_REDUCTION_NOT_REACHED";
+    /** A reduction is named twice. Carries `kind`, `key` and `billingCycle`. */
+    readonly FEATURE_WITHDRAWAL_REDUCTION_NAMED_TWICE: "FEATURE_WITHDRAWAL_REDUCTION_NAMED_TWICE";
+    /**
+     * A reduction is more than the lowest price among the lines it reduces:
+     * a price is reduced to nothing at most. Carries `key`, `billingCycle` and
+     * that `price`.
+     */
+    readonly FEATURE_WITHDRAWAL_REDUCTION_EXCEEDS_PRICE: "FEATURE_WITHDRAWAL_REDUCTION_EXCEEDS_PRICE";
+    /**
+     * The subscriptions the withdrawal reaches changed since the preview the
+     * operator looked at. Nothing was announced; carries the current `preview`.
+     */
+    readonly FEATURE_WITHDRAWAL_PREVIEW_CHANGED: "FEATURE_WITHDRAWAL_PREVIEW_CHANGED";
+    /** No withdrawal has that id. Carries `withdrawalId`. */
+    readonly FEATURE_WITHDRAWAL_NOT_FOUND: "FEATURE_WITHDRAWAL_NOT_FOUND";
+    /** The withdrawal was lifted already. Carries the `date` it is lifted from. */
+    readonly FEATURE_WITHDRAWAL_ALREADY_LIFTED: "FEATURE_WITHDRAWAL_ALREADY_LIFTED";
+    /**
+     * Nobody the withdrawal reaches has been told of it yet, and telling them
+     * failed just now: a withdrawal is lifted only once they were. Nothing was
+     * lifted; the next try, or the quarter-hourly run, tells them first.
+     */
+    readonly FEATURE_WITHDRAWAL_NOT_TOLD_YET: "FEATURE_WITHDRAWAL_NOT_TOLD_YET";
+    /**
+     * The date a withdrawal would be lifted from lies before now: what was
+     * withdrawn until then was withdrawn.
+     */
+    readonly FEATURE_WITHDRAWAL_LIFT_IN_PAST: "FEATURE_WITHDRAWAL_LIFT_IN_PAST";
+    /**
+     * The withdrawal does not take its feature away now — its date is ahead,
+     * or it was lifted — so nothing ends at once because of it. Carries
+     * `featureKey`.
+     */
+    readonly FEATURE_WITHDRAWAL_NOT_IN_EFFECT: "FEATURE_WITHDRAWAL_NOT_IN_EFFECT";
+    /**
+     * The withdrawal did not reach the subscription, or the line to end: it
+     * was not running at the announcement, or no longer holds the feature.
+     */
+    readonly FEATURE_WITHDRAWAL_DOES_NOT_REACH: "FEATURE_WITHDRAWAL_DOES_NOT_REACH";
+    /** What was to be ended at once has ended already. */
+    readonly FEATURE_WITHDRAWAL_ALREADY_ENDED: "FEATURE_WITHDRAWAL_ALREADY_ENDED";
+    /**
+     * A cancellation is declared for a later date, and the installation's
+     * subscription write or booking store cannot bring it forward (`endNow`).
+     * It ends as declared. Carries that `date`.
+     */
+    readonly FEATURE_WITHDRAWAL_END_NOW_UNSUPPORTED: "FEATURE_WITHDRAWAL_END_NOW_UNSUPPORTED";
     /** The subscription has ended; its plan can no longer be changed. */
     readonly SUBSCRIPTION_ENDED: "SUBSCRIPTION_ENDED";
     /** An active special contract blocks self-service plan changes. */
@@ -8674,7 +9781,7 @@ declare const PLATFORM_ERROR_CODES: {
     /** Email already taken (mapped from `PlatformUserExistsError`). */
     readonly EMAIL_EXISTS: "EMAIL_EXISTS";
 };
-type PlatformErrorCode = SetupErrorCode | AuthErrorCode | PromoErrorCode | CatalogErrorCode | BillingErrorCode | ContractErrorCode | SubscriberErrorCode | RegistrationErrorCode | PaymentErrorCode | SettingsErrorCode | MaintenanceErrorCode | TaxErrorCode;
+type PlatformErrorCode = SetupErrorCode | AuthErrorCode | PromoErrorCode | CatalogErrorCode | BillingErrorCode | ContractErrorCode | InvoiceErrorCode | SubscriberErrorCode | RegistrationErrorCode | PaymentErrorCode | SettingsErrorCode | MaintenanceErrorCode | TaxErrorCode;
 /**
  * Shape of a coded error response.
  *
@@ -8759,7 +9866,13 @@ declare const OPTIONAL_CANONICAL_MODELS: {
     readonly SubscriptionNotice: readonly ["tenantBilling.subscriptionNotices"];
     readonly VersionRetirement: readonly ["tenantBilling.versionRetirements"];
     readonly BundleVersionRetirement: readonly ["tenantBilling.bundleVersionRetirements"];
+    readonly FeatureWithdrawal: readonly ["tenantBilling.featureWithdrawals"];
     readonly SubscriberLedgerEntry: readonly ["entitlement.subscriberLedgerRepository"];
+    readonly SubscriptionInvoice: readonly ["entitlement.subscriptionInvoiceRepository"];
+    readonly SubscriptionInvoiceLine: readonly ["entitlement.subscriptionInvoiceRepository"];
+    readonly SubscriptionInvoiceNumber: readonly ["entitlement.subscriptionInvoiceRepository"];
+    readonly SubscriptionInvoiceDocument: readonly ["entitlement.subscriptionInvoiceRepository"];
+    readonly SubscriptionInvoiceArchive: readonly ["entitlement.subscriptionInvoiceArchive"];
     readonly PromoCodeHold: readonly ["promo.holdRepository"];
 };
 type OptionalCanonicalModel = keyof typeof OPTIONAL_CANONICAL_MODELS;
@@ -9765,6 +10878,10 @@ type IssuerIdentityChange =
  */
 declare function classifyIssuerChange(recorded: LegalIdentity | null, issuer: PlanCatalogIssuer | undefined): IssuerIdentityChange;
 
+/** Every origin a charge may name, as a record or a line that copies one is checked against. */
+declare const SUBSCRIBER_CHARGE_ORIGINS: readonly SubscriberChargeOrigin[];
+/** Every source a charge may name. */
+declare const SUBSCRIBER_CHARGE_SOURCES: readonly SubscriberChargeSource[];
 /**
  * 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
@@ -9806,6 +10923,252 @@ declare function subscriberChargeColumns(charge: NewSubscriberCharge): Omit<Cano
     amountNet: string;
 };
 
+/**
+ * A `subscription_invoices` row as either adapter reads it back. Amounts are
+ * `unknown` because a Prisma row carries a `Decimal` where a Drizzle row carries
+ * a numeric string, and days because one carries a `Date` at midnight UTC where
+ * the other carries the text.
+ */
+interface CanonicalSubscriptionInvoiceRow {
+    id: string;
+    number: string;
+    numberPrefix: string;
+    numberYear: number;
+    numberSequence: number;
+    tenantId: string;
+    subscriberId: string;
+    subscriptionId: string;
+    contractId: string;
+    issuedAt: Date;
+    issueDate: unknown;
+    dueDate: unknown;
+    servicePeriodFrom: unknown;
+    servicePeriodUntil: unknown;
+    currency: string;
+    issuerParty: unknown;
+    subscriberParty: unknown;
+    footer: unknown;
+    taxTreatment: unknown;
+    taxes: unknown;
+    totalNet: unknown;
+    totalTax: unknown;
+    totalGross: unknown;
+    createdAt: Date;
+}
+/** A `subscription_invoice_lines` row as either adapter reads it back. */
+interface CanonicalSubscriptionInvoiceLineRow {
+    id: string;
+    invoiceId: string;
+    position: number;
+    chargeId: string;
+    contractLineItemId: string;
+    title: string;
+    origin: string;
+    source: string;
+    periodFrom: unknown;
+    periodUntil: unknown;
+    amountNet: unknown;
+    taxRate: unknown;
+}
+/** Reads an invoice row and its lines back as a record, the lines in their order. */
+declare function toSubscriptionInvoiceRecord(row: CanonicalSubscriptionInvoiceRow, lines: readonly CanonicalSubscriptionInvoiceLineRow[]): SubscriptionInvoiceRecord;
+/**
+ * The columns an invoice is written with: amounts as decimal strings of two
+ * places, as a charge's are, and days as their text, which each adapter turns
+ * into what its date column takes.
+ */
+interface SubscriptionInvoiceColumns {
+    number: string;
+    numberPrefix: string;
+    numberYear: number;
+    numberSequence: number;
+    tenantId: string;
+    subscriberId: string;
+    subscriptionId: string;
+    contractId: string;
+    issuedAt: Date;
+    issueDate: CalendarDay;
+    dueDate: CalendarDay;
+    servicePeriodFrom: CalendarDay;
+    servicePeriodUntil: CalendarDay;
+    currency: string;
+    issuerParty: SubscriptionInvoiceIssuer;
+    subscriberParty: SubscriptionInvoiceSubscriber;
+    footer: string[];
+    taxTreatment: Record<string, unknown>;
+    taxes: TaxAtRate[];
+    totalNet: string;
+    totalTax: string;
+    totalGross: string;
+}
+/** The columns a line is written with, in the form `SubscriptionInvoiceColumns` describes. */
+interface SubscriptionInvoiceLineColumns {
+    invoiceId: string;
+    position: number;
+    chargeId: string;
+    contractLineItemId: string;
+    title: string;
+    origin: string;
+    source: string;
+    periodFrom: CalendarDay;
+    periodUntil: CalendarDay;
+    amountNet: string;
+    taxRate: string;
+}
+/** The columns an invoice is written with, given the number the store drew. */
+declare function subscriptionInvoiceColumns(invoice: NewSubscriptionInvoice, drawn: {
+    number: string;
+    numberSequence: number;
+}): SubscriptionInvoiceColumns;
+/** The columns a line is written with. */
+declare function subscriptionInvoiceLineColumns(line: NewSubscriptionInvoiceLine, invoiceId: string): SubscriptionInvoiceLineColumns;
+/** A day as the `Date` at midnight UTC a Prisma `@db.Date` column takes. */
+declare function utcMidnightOf(day: CalendarDay): Date;
+
+/**
+ * A charge that already stands on an invoice: what the unique `chargeId` of
+ * the invoice lines answers when two runs issue the same charges at once. The
+ * invoice is not written and its number not drawn.
+ */
+declare function subscriptionInvoiceChargeInvoiced(chargeId: string): PersistenceRefusal;
+/**
+ * A rendering of an invoice's document whose checksum is not the one recorded
+ * or archived for it, refused: the first stays. Only the run replaces a
+ * recorded rendering, and only while nothing is archived (`SC-AUD-019`).
+ */
+declare function subscriptionInvoiceDocumentChanged(invoiceId: string, recorded: string, rendered: string): PersistenceRefusal;
+
+/** The charges one invoice issues: booked at the same moment under the same contract. */
+interface InvoiceGroup {
+    contractId: string;
+    bookedAt: Date;
+    charges: SubscriberChargeRecord[];
+}
+/**
+ * A subscription's charges left to invoice, as the invoices that issue them.
+ *
+ * The charges a billing period opens with are booked together and issued
+ * together; a charge that arises later in the period is booked when it arises
+ * and issued on an invoice of its own (`SC-PRIC-022`). A contract is the
+ * agreement an invoice asks payment under, so charges of two contracts are
+ * never on one invoice. The oldest come first, so numbers follow the charges.
+ * A group whose charges are all zero issues no invoice (`SC-PRIC-048`) and is
+ * left out; a charge of zero beside one that is not stays on its invoice.
+ */
+declare function invoiceGroupsOf(charges: readonly SubscriberChargeRecord[]): InvoiceGroup[];
+/** What an invoice is drawn up from. */
+interface InvoiceDraftInput {
+    group: InvoiceGroup;
+    /** The contract the group's charges belong to: where each line takes its title and place. */
+    contractLines: readonly Pick<ContractLineItemRecord, 'id' | 'titleSnapshot'>[];
+    tenantId: string;
+    subscriberId: string;
+    subscriber: SubscriptionInvoiceSubscriber;
+    issuer: SubscriptionInvoiceIssuer;
+    /** The footer lines `config/saas.yaml` names now (`SC-PRIC-077`). */
+    footer: readonly string[];
+    /** The treatment the tax adapter decides for the subscriber now (`SC-PRIC-043`). */
+    treatment: TaxTreatment;
+    /** The adapter's rule for the tax of an invoice (`SC-PRIC-041`). */
+    tax: (lines: readonly InvoiceTaxLine[]) => TaxPerRate;
+    issuedAt: Date;
+    /** The installation's time zone, which every day the invoice states is read in (`SC-PRIC-045`). */
+    timeZone: string;
+    numberPrefix: string;
+    /** Days from the issue date to the due date (`SC-PRIC-046`). */
+    paymentTermDays: number;
+}
+/**
+ * The invoice `input.group` makes. Its lines follow the contract's lines, so
+ * the invoice reads in the order the contract does, each naming its charge and
+ * its contract line (`SC-AUD-013`) and taking the contract line's title. Every
+ * line carries the treatment's rate, and the tax is the adapter's, computed
+ * once per rate over the lines' net amounts.
+ *
+ * Throws where the charges contradict each other — a currency or a contract
+ * line the group cannot have — which no invoice can be drawn up from.
+ */
+declare function draftSubscriptionInvoice(input: InvoiceDraftInput): NewSubscriptionInvoice;
+/** What the tax adapter checks of an invoice before its number is drawn (`SC-PRIC-027`). */
+declare function invoiceContentDraftOf(invoice: NewSubscriptionInvoice): InvoiceContentDraft;
+
+/** A recorded settings change, as far as the issuer's history needs it. */
+type IssuerHistoryStep = Pick<SettingsChangeRecord, 'previous' | 'current'>;
+/**
+ * The issuer an invoice of a contract names.
+ *
+ * `copy` is the issuer the contract copied when it was concluded; `configured`
+ * the issuer `config/saas.yaml` names on the issue date, as a contract would
+ * copy it now (`contractPartiesOf`), or `null` where it names none; `history`
+ * the recorded settings changes, the oldest first.
+ */
+declare function invoiceIssuerOf(copy: ContractIssuerParty, configured: ContractIssuerParty | null, history: readonly IssuerHistoryStep[]): SubscriptionInvoiceIssuer;
+/**
+ * The footer lines an invoice carries (`SC-PRIC-077`): those `config/saas.yaml`
+ * names, where the invoice names the issuer the file names; none where it names
+ * the contract's copy of another entity, whose register and account the lines
+ * are not.
+ */
+declare function invoiceFooterOf(issuer: SubscriptionInvoiceIssuer, configured: ContractIssuerParty | null, footer: readonly string[]): string[];
+
+/** A `subscription_invoice_documents` row as either adapter reads it back. */
+interface CanonicalSubscriptionInvoiceDocumentRow {
+    invoiceId: string;
+    checksum: string;
+    mediaType: string;
+    fileName: string;
+    size: unknown;
+    renderedAt: Date;
+    archivedAt: Date | null;
+    deliveryClaimedAt: Date | null;
+    deliveredAt: Date | null;
+    deliveredTo: string | null;
+}
+/** A `subscription_invoice_archive` row as either adapter reads it back. */
+interface CanonicalSubscriptionInvoiceArchiveRow {
+    invoiceId: string;
+    checksum: string;
+    mediaType: string;
+    fileName: string;
+    content: Uint8Array;
+    archivedAt: Date;
+}
+/** Whether `value` is a checksum as the platform records one. */
+declare function isInvoiceDocumentChecksum(value: unknown): value is string;
+declare function toSubscriptionInvoiceDocumentRecord(row: CanonicalSubscriptionInvoiceDocumentRow): SubscriptionInvoiceDocumentRecord;
+declare function toArchivedInvoiceDocument(row: CanonicalSubscriptionInvoiceArchiveRow): ArchivedInvoiceDocument;
+/**
+ * The triggers of `subscription_invoice_archive` that keep a document as it
+ * was issued (`1.0-an-invoice-document-is-archived.postgres.sql`): one refuses
+ * every update and delete of a row, the other every truncate of the table.
+ */
+declare const INVOICE_ARCHIVE_TRIGGERS: readonly ["subscription_invoice_archive_is_kept", "subscription_invoice_archive_is_not_emptied"];
+/**
+ * Why the database archive would let a document be changed, given the
+ * triggers that fire on its table, or `null` where both of its own do. Shared
+ * by both adapters, which read the enabled triggers from the catalogue.
+ *
+ * A database created from the fragments by `db push` alone, or a migration run
+ * before the table existed, has none: the triggers are SQL the Prisma DSL
+ * cannot express.
+ */
+declare function invoiceArchiveProtectionProblem(enabledTriggers: readonly string[]): string | null;
+
+/** The VAT category of EN 16931 (UNTDID 5305) a line and a breakdown name. */
+type VatCategory = 'S' | 'E' | 'AE' | 'O';
+/** The category EN 16931 names for a treatment an adapter decides. */
+declare function vatCategoryOf(kind: TaxTreatmentKind): VatCategory;
+/** Whether `text` can stand in an XML document as it is. */
+declare function holdsOnlyXmlCharacters(text: string): boolean;
+/**
+ * `text` as an e-invoice's XML states it, which is what every XML parser reads
+ * back from it: a character XML cannot hold becomes `?`, as the page shows a
+ * character its font has no glyph for (`SC-PRIC-078`), and a carriage return
+ * is the line feed XML 1.0 hands over in its place (§ 2.11). The renderer
+ * writes this, and the adapter's check compares the record through it.
+ */
+declare function asXmlReadsIt(text: string): string;
+
 /** A `subscribers` row as either adapter reads it back. */
 interface CanonicalSubscriberRow {
     id: string;
@@ -10219,4 +11582,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 AdminAccountEntry, type AdminAccountHolder, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriberAccount, type AdminSubscriberAttention, type AdminSubscriberCorrected, type AdminSubscriberHistoryEntry, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminTenantSubscriber, type AdminUserListFilter, type AdminUserListRow, type AdminVatIdCheckOutcome, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditActor, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, BUNDLE_VERSION_RETIREMENT_CAPABILITY, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRetirementAnnounced, type BundleRetirementPreview, type BundleRetirementReachedRow, type BundleRetirementSkipReason, type BundleRetirementSkippedRow, type BundleRetirementSwitchResult, type BundleRetirementSwitchTerms, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionOfferView, type BundleVersionOfferedNotice, type BundleVersionRetiredNotice, type BundleVersionRetirementRecord, type BundleVersionRetirementReminder, type BundleVersionRetirementRepository, type BundleVersionRetirementView, type BundleVersionRow, type BundleVersionSide, type BundleVersionSwitchResult, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, CUSTOM_LIMITS_KEYS, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalBundleVersionRetirementRow, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalMaintenanceWindowRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalRunningContractRow, type CanonicalSubscriberChargeRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberPaymentMethodRow, type CanonicalSubscriberRow, type CanonicalSubscriberTaxOriginChangeRow, type CanonicalSubscriberVatIdCheckRow, type CanonicalSubscriptionBundleRow, type CanonicalSubscriptionNoticeRow, type CanonicalVersionRetirementRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type CatalogVersionKind, 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 ConcurrencyGate, 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 CustomLimits, 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 HeldVatId, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type IssuerCorrectionFault, type IssuerIdentityChange, type KpiCardDef, type KpiDisplayHint, LEGAL_IDENTITY_FIELDS, type LegalIdentity, type LegalIdentityField, MAINTENANCE_CAPABILITY, MAINTENANCE_ERROR_CODES, MAINTENANCE_MESSAGE_MAX_LENGTH, MAINTENANCE_STATE_MAX_AGE_SECONDS, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type MaintenanceErrorCode, type MaintenanceLockView, type MaintenanceNotificationPort, type MaintenanceOverview, type MaintenanceStatusView, type MaintenanceUnlockView, type MaintenanceWindowChanges, type MaintenanceWindowEvent, type MaintenanceWindowPort, type MaintenanceWindowRecord, type MaintenanceWindowStage, type MaintenanceWindowStatus, type MaintenanceWindowView, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MaskedPaymentMethod, type MfaPort, NO_SCHEDULED_CHANGE, type NewBundleVersionRetirement, type NewContractLineItemData, type NewMaintenanceWindow, type NewSettingsChange, type NewSubscriberCharge, type NewSubscriberDetails, type NewSubscriptionContractData, type NewVersionRetirement, type NotToldReasons, type NoticeToRecord, OPTIONAL_CANONICAL_MODELS, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, type OptionalBundleMember, type OptionalCanonicalModel, type OrderlyRetirementSettings, 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, PersistenceRefusal, type PersistenceRefusalReason, 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 PlanCatalogTax, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformJobActor, 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, RETIREMENT_REMINDER_LEAD_DAYS, type ReadCustomLimits, type ReassignTenantAdminCliResult, type RecommendablePlan, type RecordSubscriberPaymentMethodData, type RecordSubscriberPaymentMethodOutcome, type RecordSubscriberPaymentMethodResult, type RecordedVatIdCheck, 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 RetiredBundleVersionRef, type RetiredVersionRef, type RetirementAnnounced, type RetirementBlocker, type RetirementMoveRun, type RetirementPreview, type RetirementPricedSide, type RetirementProgress, type RetirementReachedRow, type RetirementSide, type RetirementSkipReason, type RetirementSkippedRow, type RetirementSwitchResult, type RetirementSwitchTerms, type ReviewCatalogEntryData, type RlsBypassPort, type RunningContractIssuer, type RunningContractIssuers, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ACCOUNT_CAPABILITY, SUBSCRIBER_ATTENTION_CAPABILITY, SUBSCRIBER_ATTENTION_PAGE_SIZE, SUBSCRIBER_CORRECTION_CAPABILITY, SUBSCRIBER_ERROR_CODES, SUBSCRIBER_INVOICE_ADDRESS_FIELDS, SUBSCRIBER_STANDING_CAPABILITY, SUBSCRIBER_TAX_ORIGIN_FIELDS, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePayments, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledChangeColumns, type ScheduledPlanChangeInput, type SecretSealer, 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 SubscriberBusinessStatusData, type SubscriberBusinessStatusResult, 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 SubscriberInvoiceAddressField, type SubscriberLedgerRepository, type SubscriberPaymentMethodRecord, type SubscriberPaymentMethodReference, type SubscriberPaymentMethodRepository, type SubscriberPaymentMethodSetupData, type SubscriberPaymentMethodSetupMatch, type SubscriberPaymentMethodStatus, type SubscriberReadiness, type SubscriberRecord, type SubscriberRepository, type SubscriberTaxOrigin, type SubscriberTaxOriginChangeRecord, type SubscriberTaxOriginField, type SubscriberTaxOriginValues, type SubscriberTaxStatus, type SubscriberVatIdCheckRecord, type SubscriberVatIdCheckResult, type SubscriberWithCurrentCheck, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionNotice, type SubscriptionNoticeDelivery, type SubscriptionNoticeKey, type SubscriptionNoticeKind, type SubscriptionNoticePort, type SubscriptionNoticeRecord, type SubscriptionNoticeRepository, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SupersedeSubscriptionContractData, type SyncDiscoveryResult, TAX_ERROR_CODES, TAX_TREATMENT_KINDS, type TaxAdapter, type TaxAdapterFactory, type TaxAdapterIdentity, type TaxDecision, type TaxDecisionRequest, type TaxErrorCode, type TaxIssuer, type TaxOriginWrite, type TaxTreatment, type TaxTreatmentKind, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionUsage, 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, VERSION_RETIREMENT_CAPABILITY, type VatIdCheck, type VatIdCheckOutcome, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionOffer, type VersionOfferClass, type VersionOfferFields, type VersionOfferSide, type VersionOfferView, type VersionOfferedNotice, type VersionRetiredNotice, type VersionRetirementRecord, type VersionRetirementReminder, type VersionRetirementRepository, type VersionRetirementView, type VersionSale, type VersionSaleDates, type VersionSaleKind, type VersionSwitchResult, type VersionWindow, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleKeyTaken, bundleStemDefaults, canonicalJson, canonicalVatId, catalogDraftExists, catalogVersionAlreadyPublished, catalogVersionGone, classifyBundleVersionDiff, classifyIssuerChange, classifyPlanDiff, classifyVersionOffer, collectUnsatisfiedRequires, computeIncludedVat, concurrencyGate, concurrencyGateOf, contractPartiesOf, coverageExcludingSelf, customLimitsReader, definedFields, diffSettings, formatCustomerNumber, formatErrorMessage, grossFromNet, identityCorrectionDelta, isBundleRedundant, isForeignPaymentMethodReferenceError, isMaintenanceAnnouncementLapsed, isMaintenanceOverrun, isPaymentCallbackRejectedError, isPersistenceRefusal, isPlatformUserExistsError, isVersionActiveAt, isVersionEditable, issuerIdentityOf, keepOneRecommended, keepsVatIdCheck, maintenanceRetryAfterSeconds, maintenanceStatusOf, maintenanceWindowStatusOf, maintenanceWindowViewOf, marketingProjectionTaken, membersLeftOut, missingRequiresFor, movedIdentityFields, netFromGross, noActivePlanVersion, parseZonedInstant, percentOf, pickActivePromo, planCatalogSettingsOf, planKeyTaken, planNotInCatalog, previousUtcDay, promoCodeTaken, promoStatus, promotionOnPrice, prorate, readCustomLimits, readQuotaRecord, readQuotaValue, recordedIssuerIdentity, refuseForeignPaymentMethodReference, resolveBundleAvailability, resolveErrorMessage, retirementCostsTheSubscription, retirementReminderDueAt, retirementReminderIsDue, retirementSwitchTerms, roundToCents, sameLegalIdentity, scheduledChangeAfterWrite, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberChargeColumns, subscriberFromRegistration, subscriberPaymentMethodColumns, subscriptionBundleAlreadyCancelled, subscriptionBundleGone, subscriptionContractGone, subscriptionGone, sumToCents, taxOriginOf, taxOriginWrite, taxTreatmentToJson, toBundleStemRow, toBundleVersionRetirementRecord, toCents, toContractLineItemRecord, toDecimalString, toMaintenanceWindowRecord, toPlanRow, toPlanVersionRow, toRunningContractIssuer, toSubscriberChargeRecord, toSubscriberCorrectionRecord, toSubscriberPaymentMethodRecord, toSubscriberRecord, toSubscriberTaxOriginChangeRecord, toSubscriberVatIdCheckRecord, toSubscriptionBundleRecord, toSubscriptionContractRecord, toSubscriptionNoticeRecord, toTaxOriginValues, toTaxTreatment, toVersionRetirementRecord, vatIdCheckFromStore, versionOnSale, versionOnSaleOrNext, versionSale };
+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 AdminSubscriberAttention, type AdminSubscriberCorrected, type AdminSubscriberHistoryEntry, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminTenantSubscriber, type AdminUserListFilter, type AdminUserListRow, type AdminVatIdCheckOutcome, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type ArchivedInvoiceDocument, type AuditActionDef, type AuditActor, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, BUNDLE_VERSION_RETIREMENT_CAPABILITY, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRetirementAnnounced, type BundleRetirementPreview, type BundleRetirementReachedRow, type BundleRetirementSkipReason, type BundleRetirementSkippedRow, type BundleRetirementSwitchResult, type BundleRetirementSwitchTerms, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionOfferView, type BundleVersionOfferedNotice, type BundleVersionRetiredNotice, type BundleVersionRetirementRecord, type BundleVersionRetirementReminder, type BundleVersionRetirementRepository, type BundleVersionRetirementView, type BundleVersionRow, type BundleVersionSide, type BundleVersionSwitchResult, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, CUSTOM_LIMITS_KEYS, type CalendarDay, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalBundleVersionRetirementRow, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalFeatureWithdrawalRow, type CanonicalMaintenanceWindowRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalRunningContractRow, type CanonicalSubscriberChargeRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberPaymentMethodRow, type CanonicalSubscriberRow, type CanonicalSubscriberTaxOriginChangeRow, type CanonicalSubscriberVatIdCheckRow, type CanonicalSubscriptionBundleRow, type CanonicalSubscriptionInvoiceArchiveRow, type CanonicalSubscriptionInvoiceDocumentRow, type CanonicalSubscriptionInvoiceLineRow, type CanonicalSubscriptionInvoiceRow, type CanonicalSubscriptionNoticeRow, type CanonicalVersionRetirementRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type CatalogVersionKind, 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 ConcurrencyGate, 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 CustomLimits, 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 EndAtOncePreview, type EndNowInput, type EndSubscriptionNowResult, type EndedAtOnce, type EndedAtOnceNotice, type ErrorMessageParams, FEATURE_NOT_LICENSED, FEATURE_WITHDRAWAL_CAPABILITY, FEATURE_WITHDRAWAL_REASON_MAX_LENGTH, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FeatureWithdrawalAnnounced, type FeatureWithdrawalBlocker, type FeatureWithdrawalLift, type FeatureWithdrawalLifted, type FeatureWithdrawalLiftedNotice, type FeatureWithdrawalLine, type FeatureWithdrawalLineKind, type FeatureWithdrawalMark, type FeatureWithdrawalNoticeLine, type FeatureWithdrawalPreview, type FeatureWithdrawalReachedRow, type FeatureWithdrawalRecord, type FeatureWithdrawalReduction, type FeatureWithdrawalRepository, type FeatureWithdrawalRow, type FeatureWithdrawalSkippedRow, type FeatureWithdrawalTarget, type FeatureWithdrawalView, type FeatureWithdrawnNotice, type FinalActivationResult, type FirstTimeCustomerCheck, ForeignPaymentMethodReferenceError, type HeldVatId, INVOICE_ARCHIVE_TRIGGERS, INVOICE_DOCUMENT_CAPABILITY, INVOICE_ERROR_CODES, INVOICE_SEQUENCE_DIGITS, type ImmediatePlanChangeInput, type InvoiceArchivePort, type InvoiceContentDraft, type InvoiceDocument, type InvoiceDocumentToArchive, type InvoiceDraftInput, type InvoiceErrorCode, type InvoiceGroup, type InvoiceLineItemSnapshot, type InvoiceMail, type InvoiceMailPort, type InvoiceRenderer, type InvoiceTaxLine, type IssuerCorrectionFault, type IssuerHistoryStep, type IssuerIdentityChange, type KpiCardDef, type KpiDisplayHint, LEGAL_IDENTITY_FIELDS, type LegalIdentity, type LegalIdentityField, MAINTENANCE_CAPABILITY, MAINTENANCE_ERROR_CODES, MAINTENANCE_MESSAGE_MAX_LENGTH, MAINTENANCE_STATE_MAX_AGE_SECONDS, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type MaintenanceErrorCode, type MaintenanceLockView, type MaintenanceNotificationPort, type MaintenanceOverview, type MaintenanceStatusView, type MaintenanceUnlockView, type MaintenanceWindowChanges, type MaintenanceWindowEvent, type MaintenanceWindowPort, type MaintenanceWindowRecord, type MaintenanceWindowStage, type MaintenanceWindowStatus, type MaintenanceWindowView, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MaskedPaymentMethod, type MfaPort, NO_SCHEDULED_CHANGE, type NewBundleVersionRetirement, type NewContractLineItemData, type NewFeatureWithdrawal, type NewInvoiceRendering, type NewMaintenanceWindow, type NewSettingsChange, type NewSubscriberCharge, type NewSubscriberDetails, type NewSubscriptionContractData, type NewSubscriptionInvoice, type NewSubscriptionInvoiceLine, type NewVersionRetirement, type NotToldReasons, type NoticeToRecord, OPTIONAL_CANONICAL_MODELS, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, type OptionalBundleMember, type OptionalCanonicalModel, type OrderlyRetirementSettings, 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, PersistenceRefusal, type PersistenceRefusalReason, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogInvoicing, type PlanCatalogIssuer, type PlanCatalogIssuerCorrection, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogPaymentAccount, type PlanCatalogPayments, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogSettings, type PlanCatalogSubscribers, type PlanCatalogTax, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformJobActor, 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, RETIREMENT_REMINDER_LEAD_DAYS, type ReadCustomLimits, type ReassignTenantAdminCliResult, type RecommendablePlan, type RecordSubscriberPaymentMethodData, type RecordSubscriberPaymentMethodOutcome, type RecordSubscriberPaymentMethodResult, type RecordedVatIdCheck, 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 RetiredBundleVersionRef, type RetiredVersionRef, type RetirementAnnounced, type RetirementBlocker, type RetirementMoveRun, type RetirementPreview, type RetirementPricedSide, type RetirementProgress, type RetirementReachedRow, type RetirementSide, type RetirementSkipReason, type RetirementSkippedRow, type RetirementSwitchResult, type RetirementSwitchTerms, type ReviewCatalogEntryData, type RlsBypassPort, type RunningContractIssuer, type RunningContractIssuers, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ACCOUNT_CAPABILITY, SUBSCRIBER_ATTENTION_CAPABILITY, SUBSCRIBER_ATTENTION_PAGE_SIZE, SUBSCRIBER_CHARGE_ORIGINS, SUBSCRIBER_CHARGE_SOURCES, SUBSCRIBER_CORRECTION_CAPABILITY, SUBSCRIBER_ERROR_CODES, SUBSCRIBER_INVOICE_ADDRESS_FIELDS, SUBSCRIBER_STANDING_CAPABILITY, SUBSCRIBER_TAX_ORIGIN_FIELDS, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePayments, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledChangeColumns, type ScheduledPlanChangeInput, type SecretSealer, 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 SubscriberBusinessStatusData, type SubscriberBusinessStatusResult, 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 SubscriberInvoiceAddressField, type SubscriberLedgerRepository, type SubscriberPaymentMethodRecord, type SubscriberPaymentMethodReference, type SubscriberPaymentMethodRepository, type SubscriberPaymentMethodSetupData, type SubscriberPaymentMethodSetupMatch, type SubscriberPaymentMethodStatus, type SubscriberReadiness, type SubscriberRecord, type SubscriberRepository, type SubscriberTaxOrigin, type SubscriberTaxOriginChangeRecord, type SubscriberTaxOriginField, type SubscriberTaxOriginValues, type SubscriberTaxStatus, type SubscriberVatIdCheckRecord, type SubscriberVatIdCheckResult, type SubscriberWithCurrentCheck, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionInvoiceColumns, type SubscriptionInvoiceDocumentRecord, type SubscriptionInvoiceIssuer, type SubscriptionInvoiceLineColumns, type SubscriptionInvoiceLineRecord, type SubscriptionInvoiceRecord, type SubscriptionInvoiceRepository, type SubscriptionInvoiceSubscriber, type SubscriptionNotice, type SubscriptionNoticeDelivery, type SubscriptionNoticeKey, type SubscriptionNoticeKind, type SubscriptionNoticePort, type SubscriptionNoticeRecord, type SubscriptionNoticeRepository, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SupersedeSubscriptionContractData, type SyncDiscoveryResult, TAX_ERROR_CODES, TAX_TREATMENT_KINDS, type TaxAdapter, type TaxAdapterFactory, type TaxAdapterIdentity, type TaxAtRate, type TaxDecision, type TaxDecisionRequest, type TaxErrorCode, type TaxIssuer, type TaxOriginWrite, type TaxPerRate, type TaxTreatment, type TaxTreatmentKind, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantFeatureWithdrawal, type TenantFeatureWithdrawalLine, type TenantListFilter, type TenantPort, type TenantSubscriptionUsage, 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, VERSION_RETIREMENT_CAPABILITY, type VatCategory, type VatIdCheck, type VatIdCheckOutcome, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionOffer, type VersionOfferClass, type VersionOfferFields, type VersionOfferSide, type VersionOfferView, type VersionOfferedNotice, type VersionRetiredNotice, type VersionRetirementRecord, type VersionRetirementReminder, type VersionRetirementRepository, type VersionRetirementView, type VersionSale, type VersionSaleDates, type VersionSaleKind, type VersionSwitchResult, type VersionWindow, type VersionedEntityBase, type WithdrawnFeature, addDaysToDay, applyPromo, asXmlReadsIt, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleKeyTaken, bundleStemDefaults, canonicalJson, canonicalVatId, catalogDraftExists, catalogVersionAlreadyPublished, catalogVersionGone, classifyBundleVersionDiff, classifyIssuerChange, classifyPlanDiff, classifyVersionOffer, collectUnsatisfiedRequires, computeIncludedVat, concurrencyGate, concurrencyGateOf, contractPartiesOf, coverageExcludingSelf, customLimitsReader, dayInZone, definedFields, diffSettings, draftSubscriptionInvoice, endedAtOnceSubjectOf, featureWithdrawalRowOf, featuresWithdrawnAt, formatCustomerNumber, formatErrorMessage, formatInvoiceNumber, grossFromNet, holdsOnlyXmlCharacters, identityCorrectionDelta, invoiceArchiveProtectionProblem, invoiceContentDraftOf, invoiceFooterOf, invoiceGroupsOf, invoiceIssuerOf, isBundleRedundant, isFeatureWithdrawnAt, isForeignPaymentMethodReferenceError, isInvoiceDocumentChecksum, isMaintenanceAnnouncementLapsed, isMaintenanceOverrun, isPaymentCallbackRejectedError, isPersistenceRefusal, isPlatformUserExistsError, isVersionActiveAt, isVersionEditable, issuerIdentityOf, keepOneRecommended, keepsVatIdCheck, lastDayInZone, maintenanceRetryAfterSeconds, maintenanceStatusOf, maintenanceWindowStatusOf, maintenanceWindowViewOf, marketingProjectionTaken, membersLeftOut, missingRequiresFor, movedIdentityFields, netFromGross, nextWithdrawalChange, noActivePlanVersion, parseZonedInstant, percentOf, pickActivePromo, planCatalogSettingsOf, planKeyTaken, planNotInCatalog, previousUtcDay, promoCodeTaken, promoStatus, promotionOnPrice, prorate, readCustomLimits, readQuotaRecord, readQuotaValue, recordedIssuerIdentity, refuseForeignPaymentMethodReference, resolveBundleAvailability, resolveErrorMessage, retirementCostsTheSubscription, retirementReminderDueAt, retirementReminderIsDue, retirementSwitchTerms, roundToCents, sameLegalIdentity, scheduledChangeAfterWrite, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberChargeColumns, subscriberFromRegistration, subscriberPaymentMethodColumns, subscriptionBundleAlreadyCancelled, subscriptionBundleGone, subscriptionContractGone, subscriptionGone, subscriptionInvoiceChargeInvoiced, subscriptionInvoiceColumns, subscriptionInvoiceDocumentChanged, subscriptionInvoiceLineColumns, sumToCents, taxOriginOf, taxOriginWrite, taxPerRate, taxTreatmentToJson, toArchivedInvoiceDocument, toBundleStemRow, toBundleVersionRetirementRecord, toCents, toContractLineItemRecord, toDecimalString, toFeatureWithdrawalRecord, toMaintenanceWindowRecord, toPlanRow, toPlanVersionRow, toRunningContractIssuer, toSubscriberChargeRecord, toSubscriberCorrectionRecord, toSubscriberPaymentMethodRecord, toSubscriberRecord, toSubscriberTaxOriginChangeRecord, toSubscriberVatIdCheckRecord, toSubscriptionBundleRecord, toSubscriptionContractRecord, toSubscriptionInvoiceDocumentRecord, toSubscriptionInvoiceRecord, toSubscriptionNoticeRecord, toTaxOriginValues, toTaxTreatment, toVersionRetirementRecord, utcMidnightOf, vatCategoryOf, vatIdCheckFromStore, versionOnSale, versionOnSaleOrNext, versionSale, withdrawnFeaturesOf, yearOfDay };