@saasicat/core 1.0.0-rc.14 → 1.0.0-rc.16

package/dist/index.d.cts

@@ -589,8 +589,38 @@ interface PlanCatalogNotifications {
     /** Addresses mailed when a start finds the applied settings changed. */
     settingsChanged?: string[];
 }
-interface PlanCatalog {
-    schemaVersion: 1;
+/**
+ * The legal entity on the operator's side of every contract the installation
+ * concludes. A contract copies it on the day it is concluded; only the legal
+ * name is required while nothing is invoiced.
+ */
+interface PlanCatalogIssuer {
+    legalName: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    postalCode?: string;
+    city?: string;
+    /** ISO 3166-1 alpha-2. */
+    country?: string;
+    vatId?: string;
+    taxNumber?: string;
+}
+/** How the parties contracts are concluded with are numbered. */
+interface PlanCatalogSubscribers {
+    /**
+     * Put in front of every customer number assigned from the next start on.
+     * A number keeps the prefix it was assigned with.
+     */
+    customerNumberPrefix?: string;
+}
+/**
+ * The part of `config/saas.yaml` that is configuration rather than catalogue.
+ *
+ * Declared apart so it can be handed on whole — a database catalogue takes its
+ * settings from the file and its plans from the database — without anybody
+ * listing the blocks again. `CATALOGUE_KEYS` names what is left over.
+ */
+interface PlanCatalogSettings {
     /** App identity (branding + version), see PlanCatalogApp. */
     app: PlanCatalogApp;
     /** ISO-4217 currency code. */
@@ -603,6 +633,13 @@ interface PlanCatalog {
     marketing?: PlanCatalogMarketing;
     /** Who is told when the settings change between two starts. Optional. */
     notifications?: PlanCatalogNotifications;
+    /** The operator's side of every contract. Optional until invoicing requires it. */
+    issuer?: PlanCatalogIssuer;
+    /** How subscribers are numbered. Optional. */
+    subscribers?: PlanCatalogSubscribers;
+}
+interface PlanCatalog extends PlanCatalogSettings {
+    schemaVersion: 1;
     features?: FeatureDef[];
     /**
      * Optional. When omitted, plans come exclusively from the
@@ -2125,6 +2162,14 @@ interface SettingsDifference {
  * property the schema declares lands on one side.
  */
 declare const CATALOGUE_KEYS: ReadonlySet<keyof PlanCatalog>;
+/**
+ * The settings of a catalogue, typed, for handing them on as a whole.
+ *
+ * The same selection as `settingsSubtreeOf`, which is why it is that function:
+ * a caller that listed the blocks it passes on would drop the next one the
+ * schema gains, and nothing would say so.
+ */
+declare function planCatalogSettingsOf(catalog: PlanCatalog): PlanCatalogSettings;
 /** Everything in the catalogue that is configuration, as it was resolved. */
 declare function settingsSubtreeOf(catalog: PlanCatalog): AppliedSettingsValues;
 /**
@@ -2758,6 +2803,130 @@ interface PromoRevenueDeductionAggregator {
     sumGrossForPromoCode(promoCodeId: string): Promise<string>;
 }
 
+/** The address lines a party is named with. Every one of them may be unknown. */
+interface PartyAddress {
+    /** Street and number. */
+    addressLine1: string | null;
+    /** A second line, such as a building or a c/o. */
+    addressLine2: string | null;
+    postalCode: string | null;
+    city: string | null;
+    /** ISO 3166-1 alpha-2, upper case. */
+    country: string | null;
+}
+/**
+ * What names a legal entity: the name it is registered under and the
+ * identifiers its tax office gave it.
+ *
+ * For a subscriber these are the party a contract was concluded with. Under a
+ * running contract they change only as a correction of that same entity,
+ * recorded with the values it replaced and the reason; contact details change
+ * freely.
+ */
+interface LegalIdentity {
+    /** The registered name, legal form included. */
+    legalName: string;
+    /** VAT identification number. */
+    vatId: string | null;
+    /** The national tax number, where one is stated beside or instead of the VAT id. */
+    taxNumber: string | null;
+}
+/** The fields of the legal identity, the ones a correction may change. */
+type SubscriberIdentityField = keyof LegalIdentity;
+/** How a subscriber is reached, which may change at any time. */
+interface SubscriberContact extends PartyAddress {
+    /** Where invoices will be sent. */
+    invoiceEmail: string | null;
+}
+/** A subscriber's master data, as it stands. */
+type SubscriberDetails = LegalIdentity & SubscriberContact;
+/**
+ * What a subscriber is created with.
+ *
+ * Only the legal name is required. The address, the tax identifiers and the
+ * invoice email stay optional until sign-up asks for them and invoicing
+ * requires them; an absent or blank value is recorded as unknown.
+ */
+type NewSubscriberDetails = Pick<SubscriberDetails, 'legalName'> & Partial<Omit<SubscriberDetails, 'legalName'>>;
+interface SubscriberRecord extends SubscriberDetails {
+    id: string;
+    /**
+     * Assigned when the subscriber is created and never changed: the number,
+     * counted per installation, behind the prefix configured at that moment.
+     */
+    customerNumber: string;
+    /** The tenant this subscriber is live for, or `null` once it has none. */
+    tenantId: string | null;
+    /**
+     * Created by the migration that gave every existing tenant its subscriber,
+     * from the application's own tenant record rather than from what a customer
+     * entered.
+     */
+    migrated: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** What a repository writes for a new subscriber, every detail already settled. */
+interface CreateSubscriberData extends SubscriberDetails {
+    /** The tenant the subscriber is created for and live with. */
+    tenantId: string;
+    /** Put in front of the assigned number; empty for the number alone. */
+    customerNumberPrefix: string;
+}
+/** Contact details to change; a member left out keeps its value. */
+type SubscriberContactChange = Partial<SubscriberContact>;
+/**
+ * A change to a subscriber's legal identity, and what the operator declares it
+ * to be.
+ *
+ * SaaSiCat cannot tell a misspelt name from another company taking over, so the
+ * operator says which: `correction` for the same legal entity — a typo, a wrong
+ * tax identifier, a change of name that entity went through — and `takeover`
+ * for another one, which is a transfer rather than an edit and is refused.
+ */
+interface SubscriberIdentityCorrection {
+    kind: 'correction' | 'takeover';
+    legalName?: string;
+    vatId?: string | null;
+    taxNumber?: string | null;
+    /** Why the identity is corrected. Part of the record. */
+    reason: string;
+    /** Who corrects it, as an actor tag the audit log would write. */
+    correctedBy: string;
+}
+/** Identity values by field, holding only the fields a correction changed. */
+type SubscriberIdentityValues = Partial<LegalIdentity>;
+/** What a correction replaces and what it writes, holding only the fields that move. */
+interface SubscriberIdentityDelta {
+    previous: SubscriberIdentityValues;
+    corrected: SubscriberIdentityValues;
+}
+/** What a repository writes for a correction the service has accepted. */
+interface SubscriberCorrectionData {
+    /** The new values; a field equal to what is stored is not recorded. */
+    corrected: SubscriberIdentityValues;
+    reason: string;
+    correctedBy: string;
+    correctedAt: Date;
+}
+/** One correction of a subscriber's legal identity, as it was recorded. */
+interface SubscriberCorrectionRecord {
+    id: string;
+    subscriberId: string;
+    /** The values the correction replaced. */
+    previous: SubscriberIdentityValues;
+    /** The values it wrote. */
+    corrected: SubscriberIdentityValues;
+    reason: string;
+    correctedBy: string;
+    correctedAt: Date;
+}
+/** The outcome of writing a correction: nothing is recorded when no value moved. */
+interface SubscriberCorrectionResult {
+    subscriber: SubscriberRecord;
+    correction: SubscriberCorrectionRecord | null;
+}
+
 type ContractLineItemKind = 'plan' | 'bundle' | 'discount';
 type SubscriptionContractStatus = 'active' | 'scheduled' | 'terminated' | 'superseded';
 /**
@@ -2832,9 +3001,40 @@ interface SubscriptionContractPriceSnapshot {
     vatRate: number;
     totalGross: number;
 }
-interface SubscriptionContractRecord {
+/**
+ * The subscriber as a contract copied it on the day it was concluded.
+ *
+ * The invoice email is not part of it: it says how the party is reached, not
+ * who the party is, and a contract is kept for years after an address like that
+ * stopped mattering.
+ */
+interface ContractSubscriberParty extends LegalIdentity, PartyAddress {
+    customerNumber: string;
+}
+/** The issuer as `config/saas.yaml` named it on the day a contract was concluded. */
+interface ContractIssuerParty extends LegalIdentity, PartyAddress {
+}
+/** Who a contract is between, copied when it is concluded. */
+interface SubscriptionContractParties {
+    subscriberId: string;
+    subscriber: ContractSubscriberParty;
+    /** `null` where `config/saas.yaml` named no issuer that day. */
+    issuer: ContractIssuerParty | null;
+}
+interface SubscriptionContractRecord extends SubscriptionContractParties {
     id: string;
+    /**
+     * The tenant the contract was concluded for, kept as a trace. The contract
+     * belongs to its subscriber and outlives the tenant.
+     */
     tenantId: string;
+    /**
+     * The parties were copied by the migration that attached contracts
+     * concluded before subscribers existed, not on the day the contract was
+     * concluded. Either party may have changed in between, so such a copy is
+     * never presented as what was agreed.
+     */
+    partiesMigrated: boolean;
     status: SubscriptionContractStatus;
     effectiveFrom: Date;
     effectiveUntil: Date | null;
@@ -2851,6 +3051,11 @@ interface SubscriptionContractRecord {
     updatedAt: Date;
 }
 type NewContractLineItemData = Omit<ContractLineItemRecord, 'id' | 'contractId' | 'createdAt'>;
+/**
+ * A contract as a caller asks for it. The parties are not among it: the
+ * platform copies them from the tenant's subscriber and the configuration when
+ * the contract is written, so no caller can name a party of its own.
+ */
 interface CreateSubscriptionContractData {
     tenantId: string;
     status?: SubscriptionContractStatus;
@@ -2866,6 +3071,10 @@ interface CreateSubscriptionContractData {
     termsSnapshot?: Record<string, unknown> | null;
     lineItems: NewContractLineItemData[];
 }
+/** What a repository writes: the contract as asked for, with the parties the platform copied. */
+interface NewSubscriptionContractData extends CreateSubscriptionContractData {
+    parties: SubscriptionContractParties;
+}
 interface TerminateSubscriptionContractData {
     effectiveUntil: Date;
     /**
@@ -3085,9 +3294,53 @@ interface SubscriptionContractRepository {
      * instead of drawing an extra pool connection (starvation guard, #70).
      */
     findActiveByTenantId(tenantId: string, asOf?: Date, tx?: TransactionContext): Promise<SubscriptionContractRecord | null>;
-    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    /**
+     * Writes the contract with the parties it names. With `tx`, the contract is
+     * written on that transaction and undone with it.
+     */
+    create(data: NewSubscriptionContractData, tx?: TransactionContext): Promise<SubscriptionContractRecord>;
+    /**
+     * The contract concluded from a checkout offer (`originalOfferId`), or
+     * `null` when none was. An offer is consumed once and so yields one
+     * contract (`SC-MKT-017`); where an application's own path wrote two, the
+     * earliest is returned, so the answer does not depend on read order.
+     */
+    findByOriginalOfferId(offerId: string, tx?: TransactionContext): Promise<SubscriptionContractRecord | null>;
     terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
 }
+/**
+ * The parties contracts are concluded with, their link to the tenant they are
+ * live for, and the corrections of their legal identity.
+ *
+ * A subscriber has at most one live tenant and a tenant at most one live
+ * subscriber; the database holds both, so two callers creating one for the
+ * same tenant at once end with one.
+ */
+interface SubscriberRepository {
+    /**
+     * Creates a subscriber, assigns its customer number, and makes it the
+     * tenant's live subscriber — all or nothing. `null` when the tenant already
+     * has a live subscriber, in which case nothing is written and the caller's
+     * transaction stays usable.
+     */
+    createForTenant(data: CreateSubscriberData, tx?: TransactionContext): Promise<SubscriberRecord | null>;
+    findById(subscriberId: string, tx?: TransactionContext): Promise<SubscriberRecord | null>;
+    /** The subscriber live for this tenant, or `null` when it has none. */
+    findByTenantId(tenantId: string, tx?: TransactionContext): Promise<SubscriberRecord | null>;
+    /** Writes the members given and keeps the rest; `null` when no such subscriber exists. */
+    updateContact(subscriberId: string, change: SubscriberContactChange, tx?: TransactionContext): Promise<SubscriberRecord | null>;
+    /**
+     * Writes a correction of the legal identity and records it, in one step:
+     * the subscriber is read and changed under a lock, so the values recorded
+     * as replaced are the ones this write replaced even when two corrections
+     * arrive at once. A field whose stored value already equals the corrected
+     * one is left out of the record, and when none differs nothing is written
+     * and `correction` is `null`. `null` when no such subscriber exists.
+     */
+    correctIdentity(subscriberId: string, data: SubscriberCorrectionData, tx?: TransactionContext): Promise<SubscriberCorrectionResult | null>;
+    /** Every correction of this subscriber, the latest first. */
+    listCorrections(subscriberId: string): Promise<SubscriberCorrectionRecord[]>;
+}
 /**
  * Display form of a subscription for the tenant self-service UI.
  * Richer than `SubscriptionRecord` (which is only the aggregation form); contains
@@ -4030,8 +4283,19 @@ interface CheckoutOfferRepository {
     findById(id: string): Promise<CheckoutOfferRow | null>;
     create(data: CreateCheckoutOfferData): Promise<CheckoutOfferRow>;
     update(id: string, data: UpdateCheckoutOfferData): Promise<CheckoutOfferRow>;
-    /** Sets `status = 'consumed'` + `consumedAt = NOW()`. */
-    consume(id: string): Promise<CheckoutOfferRow>;
+    /**
+     * Sets `status = 'consumed'` + `consumedAt = NOW()`, and only while the
+     * offer is still `open`: the write carries that condition, so of two
+     * callers consuming at once one succeeds and the other is refused with
+     * `CHECKOUT_OFFER_ALREADY_CONSUMED` (or `CHECKOUT_OFFER_EXPIRED`). A check
+     * before the write cannot decide it, because the status can change in
+     * between.
+     *
+     * With `tx`, the write runs on that transaction, so it is undone with
+     * everything else the transaction wrote. `CheckoutOfferService.conclude`
+     * depends on that; the persistence contract holds both.
+     */
+    consume(id: string, tx?: TransactionContext): Promise<CheckoutOfferRow>;
 }
 
 /** Which changes to list. */
@@ -4159,6 +4423,8 @@ interface SaaSiCatPersistenceEntitlement {
     subscriptionRepository: PersistenceProvider<SubscriptionRepository>;
     planVersionRepository: PersistenceProvider<PlanVersionRepository>;
     subscriptionContractRepository?: PersistenceProvider<SubscriptionContractRepository>;
+    /** The parties contracts are concluded with; required wherever contracts are written. */
+    subscriberRepository?: PersistenceProvider<SubscriberRepository>;
     subscriptionBundleRepository?: PersistenceProvider<SubscriptionBundleRepository>;
     bundleRepository?: PersistenceProvider<BundleRepository>;
 }
@@ -4461,11 +4727,40 @@ declare const CONTRACT_ERROR_CODES: {
     readonly CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED";
     readonly CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED";
     readonly CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED";
+    /**
+     * The offer changed between the checks of `conclude` and the transaction
+     * that consumed it, so the contract checked is not the one the offer now
+     * describes. Nothing was written; load the offer and conclude it again.
+     */
+    readonly CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED";
     readonly SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND";
     readonly NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT";
     readonly SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED";
 };
 type ContractErrorCode = (typeof CONTRACT_ERROR_CODES)[keyof typeof CONTRACT_ERROR_CODES];
+/** The parties contracts are concluded with (`SubscriberService`), and their absence. */
+declare const SUBSCRIBER_ERROR_CODES: {
+    /**
+     * A contract, a plan change or a booking for a tenant that has no
+     * subscriber. Nothing is agreed or charged without the party to it.
+     * Carries `tenantId`.
+     */
+    readonly SUBSCRIBER_REQUIRED: "SUBSCRIBER_REQUIRED";
+    /** The tenant already has a live subscriber. Carries `tenantId`. */
+    readonly SUBSCRIBER_ALREADY_EXISTS: "SUBSCRIBER_ALREADY_EXISTS";
+    readonly SUBSCRIBER_NOT_FOUND: "SUBSCRIBER_NOT_FOUND";
+    readonly SUBSCRIBER_LEGAL_NAME_REQUIRED: "SUBSCRIBER_LEGAL_NAME_REQUIRED";
+    /** A detail that has a form — the country, the invoice email — is not in it. Carries `field`. */
+    readonly SUBSCRIBER_DETAIL_INVALID: "SUBSCRIBER_DETAIL_INVALID";
+    /** A contact change named a field of the legal identity. Carries `field`. */
+    readonly SUBSCRIBER_IDENTITY_NOT_A_CONTACT: "SUBSCRIBER_IDENTITY_NOT_A_CONTACT";
+    readonly SUBSCRIBER_CORRECTION_REASON_REQUIRED: "SUBSCRIBER_CORRECTION_REASON_REQUIRED";
+    readonly SUBSCRIBER_CORRECTION_ACTOR_REQUIRED: "SUBSCRIBER_CORRECTION_ACTOR_REQUIRED";
+    readonly SUBSCRIBER_CORRECTION_CHANGES_NOTHING: "SUBSCRIBER_CORRECTION_CHANGES_NOTHING";
+    /** The operator declared another legal entity: that is a transfer, not an edit. */
+    readonly SUBSCRIBER_TAKEOVER_IS_A_TRANSFER: "SUBSCRIBER_TAKEOVER_IS_A_TRANSFER";
+};
+type SubscriberErrorCode = (typeof SUBSCRIBER_ERROR_CODES)[keyof typeof SUBSCRIBER_ERROR_CODES];
 /** Self-service registration funnel (`PendingRegistration`). */
 declare const REGISTRATION_ERROR_CODES: {
     readonly PENDING_REGISTRATION_NOT_FOUND: "PENDING_REGISTRATION_NOT_FOUND";
@@ -4555,6 +4850,25 @@ declare const PLATFORM_ERROR_CODES: {
     readonly PLAN_NOT_AVAILABLE: "PLAN_NOT_AVAILABLE";
     readonly PLAN_NOT_SELECTED: "PLAN_NOT_SELECTED";
     readonly MODEL_NOT_AVAILABLE: "MODEL_NOT_AVAILABLE";
+    /**
+     * A contract, a plan change or a booking for a tenant that has no
+     * subscriber. Nothing is agreed or charged without the party to it.
+     * Carries `tenantId`.
+     */
+    readonly SUBSCRIBER_REQUIRED: "SUBSCRIBER_REQUIRED";
+    /** The tenant already has a live subscriber. Carries `tenantId`. */
+    readonly SUBSCRIBER_ALREADY_EXISTS: "SUBSCRIBER_ALREADY_EXISTS";
+    readonly SUBSCRIBER_NOT_FOUND: "SUBSCRIBER_NOT_FOUND";
+    readonly SUBSCRIBER_LEGAL_NAME_REQUIRED: "SUBSCRIBER_LEGAL_NAME_REQUIRED";
+    /** A detail that has a form — the country, the invoice email — is not in it. Carries `field`. */
+    readonly SUBSCRIBER_DETAIL_INVALID: "SUBSCRIBER_DETAIL_INVALID";
+    /** A contact change named a field of the legal identity. Carries `field`. */
+    readonly SUBSCRIBER_IDENTITY_NOT_A_CONTACT: "SUBSCRIBER_IDENTITY_NOT_A_CONTACT";
+    readonly SUBSCRIBER_CORRECTION_REASON_REQUIRED: "SUBSCRIBER_CORRECTION_REASON_REQUIRED";
+    readonly SUBSCRIBER_CORRECTION_ACTOR_REQUIRED: "SUBSCRIBER_CORRECTION_ACTOR_REQUIRED";
+    readonly SUBSCRIBER_CORRECTION_CHANGES_NOTHING: "SUBSCRIBER_CORRECTION_CHANGES_NOTHING";
+    /** The operator declared another legal entity: that is a transfer, not an edit. */
+    readonly SUBSCRIBER_TAKEOVER_IS_A_TRANSFER: "SUBSCRIBER_TAKEOVER_IS_A_TRANSFER";
     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";
@@ -4576,6 +4890,12 @@ declare const PLATFORM_ERROR_CODES: {
     readonly CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED";
     readonly CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED";
     readonly CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED";
+    /**
+     * The offer changed between the checks of `conclude` and the transaction
+     * that consumed it, so the contract checked is not the one the offer now
+     * describes. Nothing was written; load the offer and conclude it again.
+     */
+    readonly CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED";
     readonly SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND";
     readonly NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT";
     readonly SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED";
@@ -4789,7 +5109,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 | RegistrationErrorCode | SettingsErrorCode;
+type PlatformErrorCode = SetupErrorCode | AuthErrorCode | PromoErrorCode | CatalogErrorCode | BillingErrorCode | ContractErrorCode | SubscriberErrorCode | RegistrationErrorCode | SettingsErrorCode;
 /**
  * Shape of a coded error response.
  *
@@ -5113,15 +5433,24 @@ interface FinalActivationResult {
     userId: string;
     tenantId: string;
     subscriptionId: string;
+    /**
+     * The subscriber created for the tenant in the same transaction — the party
+     * its contracts are concluded with. `subscriberFromRegistration(pending)`
+     * says what it is created with.
+     */
+    subscriberId: string;
 }
 /**
  * Adapter port: orchestrates the final creation of User + Tenant +
- * Subscription after successful payment. App-specific — each app has its
- * own schema (e.g. Tenant + TenantUser + Role + UserRole +
+ * Subscriber + Subscription after successful payment. App-specific — each app
+ * has its own schema (e.g. Tenant + TenantUser + Role + UserRole +
  * Subscription).
  *
  * Implementations MUST perform the creation in a DB transaction so that
- * partial creations are fully rolled back on errors.
+ * partial creations are fully rolled back on errors. The subscriber is created
+ * there too, before any contract: `SubscriberService.createForTenant(tenantId,
+ * details, tx)`, or `CheckoutOfferService.conclude` with `subscriber`, which
+ * creates it on the transaction it concludes the offer on.
  */
 interface ActivationOrchestrator {
     activate(pending: PendingRegistration): Promise<FinalActivationResult>;
@@ -5586,10 +5915,71 @@ declare function toPlanRow(row: CanonicalPlanRow): PlanRow;
  */
 declare function toPlanVersionRow(row: CanonicalPlanVersionRow, planKey: string, fields: PlanVersionMappingFields): PlanVersionRow;
 
+/** The fields a correction of the legal identity may change, in the order they are shown. */
+declare const SUBSCRIBER_IDENTITY_FIELDS: readonly SubscriberIdentityField[];
+/** A `subscribers` row as either adapter reads it back. */
+interface CanonicalSubscriberRow {
+    id: string;
+    customerSequence: number;
+    customerNumberPrefix: string;
+    legalName: string;
+    addressLine1: string | null;
+    addressLine2: string | null;
+    postalCode: string | null;
+    city: string | null;
+    country: string | null;
+    vatId: string | null;
+    taxNumber: string | null;
+    invoiceEmail: string | null;
+    migrated: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** A `subscriber_corrections` row as either adapter reads it back. */
+interface CanonicalSubscriberCorrectionRow {
+    id: string;
+    subscriberId: string;
+    previous: unknown;
+    corrected: unknown;
+    reason: string;
+    correctedBy: string;
+    correctedAt: Date;
+}
+/**
+ * The customer number a subscriber is known by: the prefix it was assigned
+ * with, then the number. Kept apart in storage so the number orders and the
+ * prefix stays what it was on the day it was assigned.
+ */
+declare function formatCustomerNumber(prefix: string, sequence: number): string;
+/** `tenantId` is the tenant the subscriber's live link names, read beside the row. */
+declare function toSubscriberRecord(row: CanonicalSubscriberRow, tenantId: string | null): SubscriberRecord;
+declare function toSubscriberCorrectionRecord(row: CanonicalSubscriberCorrectionRow): SubscriberCorrectionRecord;
+/**
+ * The part of a correction that changes something: every corrected field whose
+ * stored value differs, with the value it replaces. Both adapters decide this
+ * the same way, under the lock they read `current` with.
+ */
+declare function identityCorrectionDelta(current: Pick<SubscriberRecord, SubscriberIdentityField>, corrected: SubscriberIdentityValues): SubscriberIdentityDelta;
+/**
+ * Who a new contract is between: the subscriber as it stands, and the issuer as
+ * the running configuration names it — or no issuer, where it names none.
+ */
+declare function contractPartiesOf(subscriber: SubscriberRecord, issuer: PlanCatalog['issuer']): SubscriptionContractParties;
+/**
+ * The subscriber a completed sign-up is created with: the name the tenant was
+ * registered under as its legal name, and the address the registration was
+ * verified with as its invoice email. Sign-up collects nothing more yet.
+ */
+declare function subscriberFromRegistration(pending: Pick<PendingRegistration, 'tenantName' | 'email'>): NewSubscriberDetails;
+
 /** A `subscription_contracts` row as either adapter reads it back. */
 interface CanonicalContractRow {
     id: string;
     tenantId: string;
+    subscriberId: string;
+    subscriberSnapshot: unknown;
+    issuerSnapshot: unknown;
+    partiesMigrated: boolean;
     status: string;
     effectiveFrom: Date;
     effectiveUntil: Date | null;
@@ -5711,4 +6101,4 @@ declare function resolveErrorMessage(body: ResolvableErrorBody, overrides?: Part
 
 declare const ERROR_MESSAGES_DE: Record<PlatformErrorCode, string>;
 
-export { ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES, AUTH_ERROR_CODES, type ActionKey, type ActivationOrchestrator, type ActivePlanVersionWhere, type ActivePlanVersionWhereWithEndsAt, type ActiveVersionWhere, type ActiveVersionWhereWithEndsAt, type ActorTag, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminUserListFilter, type AdminUserListRow, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionRow, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type ChangeDirection, type CheckoutOfferFilter, type CheckoutOfferLineItem, type CheckoutOfferLineItemKind, type CheckoutOfferPriceBreakdown, type CheckoutOfferPromoCodeSnapshot, type CheckoutOfferPromotionSnapshot, type CheckoutOfferRepository, type CheckoutOfferRow, type CheckoutOfferSelection, type CheckoutOfferSelectionUpdate, type CheckoutOfferStatus, type CheckoutSession, type CleanupResult, type CliUserRow, type ComponentKey, type ConfiguratorCatalog, type ConfiguratorMarketingProvider, type ConfiguratorModel, type ConfiguratorPlanMarketing, type ConfiguratorPlanVersionRow, type ConfiguratorPriceBreakdown, type ConfiguratorSourcesLookup, type ContractErrorCode, type ContractLineItemKind, type ContractLineItemRecord, type CreateBundleData, type CreateBundleVersionDraftData, type CreateCheckoutOfferData, type CreateMarketingProjectionData, type CreatePlanData, type CreatePlanVersionDraftData, type CreatePromoCodeData, type CreatePromoCodeRequest, type CreatePromotionData, type CreateSubscriptionBundleData, type CreateSubscriptionContractData, type CreateSuperAdminCliInput, type CreateTenantInput, type DiffResult, type DiscoveredCapability, type DiscoveredFeature, type DiscoveredQuota, type DiscoveredQuotaPolicy, type DiscoveryCodeStatus, type DiscoverySnapshot, type DiscoveryStatus, ERROR_MESSAGES_DE, ERROR_MESSAGES_EN, type EffectiveLimitsSnapshot, type EmailPort, type ErrorMessageParams, FEATURE_NOT_LICENSED, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FinalActivationResult, type FirstTimeCustomerCheck, type HandlePaymentEventInput, type HandlePaymentEventReason, type HandlePaymentEventResult, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type KpiCardDef, type KpiDisplayHint, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MfaPort, type NewContractLineItemData, type NewSettingsChange, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, PASSWORD_RESET_TTL_MINUTES, PENDING_CHECKOUT_TTL_DAYS, PENDING_EMAIL_TTL_HOURS, PENDING_ONBOARDING_TTL_DAYS, PLATFORM_ERROR_CODES, PROMO_ERROR_CODES, type Paginated, type PasswordHasher, type PasswordResetCliResult, type PaymentEventLog, type PaymentEventStatus, type PaymentProvider, type PendingRegistration, type PendingRegistrationCreateInput, type PendingRegistrationRepository, type PendingRegistrationSnapshot, type PendingRegistrationUpdateInput, type PersistenceCapabilities, PersistenceCapabilityError, type PersistenceClassRef, type PersistenceInjectionToken, type PersistenceProvider, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMappingFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformRole, type PlatformUserDto, PlatformUserExistsError, type ProjectPageDef, type PromoCode, type PromoCodeDurationType, type PromoCodeFilter, type 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 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 PublicSignupPlan, type PublishBundleVersionData, type PublishBundleVersionMeta, type PublishPlanVersionData, type QuotaCatalogEntryRow, type QuotaEnforcementMode, type QuotaKey, type QuotaProvider, REGISTRATION_ERROR_CODES, REGISTRATION_RESUME_TTL_MINUTES, REGISTRATION_STEP_BY_STATUS, type ReassignTenantAdminCliResult, type RecommendablePlan, type RedeemPromoInTransactionCallback, type RegistrationAuditContext, type RegistrationAuditEvent, type RegistrationAuditEventType, type RegistrationAuditLogger, type RegistrationConfigSelection, type RegistrationConfiguratorLookup, type RegistrationErrorCode, type RegistrationOtpDelivery, type RegistrationPromoPreview, type RegistrationResumeDelivery, type RegistrationResumeTokenSigner, type RegistrationStatus, type RegistrationStep, type RequiredCapabilities, type ResolvableErrorBody, type ResumeRegistrationInput, type ResumeRegistrationResult, type ReviewCatalogEntryData, type RlsBypassPort, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledPlanChangeInput, type SelectPlanInput, type SelectPlanResult, type SelectableBundleShape, type SelfServiceBlockedPlans, type SetCatalogEntryReviewData, type SettingsChangeFilter, type SettingsChangeRecord, type SettingsDifference, type SettingsErrorCode, type SetupConfirmMfaRequest, type SetupConfirmMfaResponse, type SetupErrorCode, type SetupRequest, type SetupResult, type SetupStatusResponse, type SlugAvailabilityCheck, type StandardPageDef, type StandardPageKey, type StartCheckoutInput, type StartCheckoutResult, type StartRegistrationInput, type StartRegistrationResult, type StoredBundleStem, type StrictModeWarning, type StrictModeWarningCode, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SyncDiscoveryResult, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionWritePort, type TerminateSubscriptionContractData, type TopPromoCode, type TransactionContext, type TransactionRunner, type UpdateBundleData, type UpdateBundleVersionDraftData, type UpdateCatalogEntryBaseData, type UpdateCatalogEntryI18nData, type UpdateCheckoutOfferData, type UpdateMarketingProjectionData, type UpdateMarketingSettingsData, type UpdatePlanData, type UpdatePlanVersionDraftData, type UpdatePromoCodeData, type UpdatePromoCodeRequest, type UpdatePromotionData, type UpsellOffer, type UpsellOfferResolver, type UpsertCapabilityEntryData, type UpsertFeatureCatalogEntryInput, type UpsertFeatureEntryData, type UpsertPlanInput, type UpsertPlanVersionInput, type UpsertQuotaEntryData, type UpsertResult, type UsageSnapshotPort, type UserAccountLookup, type UserListFilter, type UserManagementPort, type UserPort, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleStemDefaults, canonicalJson, classifyBundleVersionDiff, classifyPlanDiff, collectUnsatisfiedRequires, coverageExcludingSelf, definedFields, diffSettings, formatErrorMessage, isBundleRedundant, isPlatformUserExistsError, isVersionEditable, keepOneRecommended, missingRequiresFor, pickActivePromo, previousUtcDay, promoStatus, readQuotaRecord, readQuotaValue, resolveBundleAvailability, resolveErrorMessage, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, toBundleStemRow, toContractLineItemRecord, toPlanRow, toPlanVersionRow, toSubscriptionContractRecord };
+export { ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES, AUTH_ERROR_CODES, type ActionKey, type ActivationOrchestrator, type ActivePlanVersionWhere, type ActivePlanVersionWhereWithEndsAt, type ActiveVersionWhere, type ActiveVersionWhereWithEndsAt, type ActorTag, type AdminActor, type AdminAuditListFilter, type AdminManifest, type AdminResourcesPort, type AdminSubscriptionListRow, type AdminTenantDetail, type AdminTenantListFilter, type AdminTenantListRow, type AdminTenantStateResult, type AdminUserListFilter, type AdminUserListRow, type AppliedSettingsPort, type AppliedSettingsRecord, type AppliedSettingsValues, type ApplyOnboardingSelectionInput, type ApplyOnboardingSelectionResult, type ApprovedCatalogKeys, type AuditActionDef, type AuditEntry, type AuditPort, type AuditQuery, type AuditQueryPort, type AuditStatsPort, type AuditStatsSnapshot, type AuthErrorCode, BILLING_ERROR_CODES, BUNDLE_PRICE_LOOKUP_LIMIT, type BillingCycle, type BillingErrorCode, type BundleAvailabilityState, type BundleCompatibility, type BundleFeatureShape, type BundleListFilter, type BundlePricingOverride, type BundleRepository, type BundleRow, type BundleVersionFields, type BundleVersionMutationResult, type BundleVersionRow, CATALOGUE_KEYS, CATALOG_ERROR_CODES, CONTRACT_ERROR_CODES, type CancelSubscriptionBundleData, type CancelSubscriptionInput, type CancelSubscriptionResult, type CancellationNoticePeriods, type CanonicalContractLineItemRow, type CanonicalContractRow, type CanonicalPlanRow, type CanonicalPlanVersionRow, type CanonicalSubscriberCorrectionRow, type CanonicalSubscriberRow, type CapabilityCatalogEntryRow, type CapabilityCodeStatus, type CapabilityKey, type CapabilityKind, type CatalogEntryFilter, type CatalogEntryI18n, type CatalogEntryI18nFields, type CatalogEntryRepository, type CatalogErrorCode, type ChangeDirection, type CheckoutOfferFilter, type CheckoutOfferLineItem, type CheckoutOfferLineItemKind, type CheckoutOfferPriceBreakdown, type CheckoutOfferPromoCodeSnapshot, type CheckoutOfferPromotionSnapshot, type CheckoutOfferRepository, type CheckoutOfferRow, type CheckoutOfferSelection, type CheckoutOfferSelectionUpdate, type CheckoutOfferStatus, type CheckoutSession, type CleanupResult, type CliUserRow, type ComponentKey, type ConfiguratorCatalog, type ConfiguratorMarketingProvider, type ConfiguratorModel, type ConfiguratorPlanMarketing, type ConfiguratorPlanVersionRow, type ConfiguratorPriceBreakdown, type ConfiguratorSourcesLookup, type ContractErrorCode, type ContractIssuerParty, type ContractLineItemKind, type ContractLineItemRecord, type ContractSubscriberParty, type CreateBundleData, type CreateBundleVersionDraftData, type CreateCheckoutOfferData, type CreateMarketingProjectionData, type CreatePlanData, type CreatePlanVersionDraftData, type CreatePromoCodeData, type CreatePromoCodeRequest, type CreatePromotionData, type CreateSubscriberData, type CreateSubscriptionBundleData, type CreateSubscriptionContractData, type CreateSuperAdminCliInput, type CreateTenantInput, type DiffResult, type DiscoveredCapability, type DiscoveredFeature, type DiscoveredQuota, type DiscoveredQuotaPolicy, type DiscoveryCodeStatus, type DiscoverySnapshot, type DiscoveryStatus, ERROR_MESSAGES_DE, ERROR_MESSAGES_EN, type EffectiveLimitsSnapshot, type EmailPort, type ErrorMessageParams, FEATURE_NOT_LICENSED, type FeatureCatalogEntryRow, type FeatureDef, type FeatureKey, type FeatureNotLicensedBody, type FeatureRequiresIndex, type FeatureTier, type FeatureUiMeta, type FeatureUiRegistry, type FinalActivationResult, type FirstTimeCustomerCheck, type HandlePaymentEventInput, type HandlePaymentEventReason, type HandlePaymentEventResult, type ImmediatePlanChangeInput, type InvoiceLineItemSnapshot, type KpiCardDef, type KpiDisplayHint, type LegalIdentity, MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN, type ManifestAccessPort, type ManifestContribution, type MarketingProjectionFilter, type MarketingProjectionRepository, type MarketingProjectionRow, type MarketingSettingsRepository, type MarketingSettingsRow, type MarketingTargetType, type MarketingTopFeature, type MfaPort, type NewContractLineItemData, type NewSettingsChange, type NewSubscriberDetails, type NewSubscriptionContractData, OTP_RATE_LIMIT_MAX_SENDS, OTP_RATE_LIMIT_WINDOW_MINUTES, OTP_TTL_MINUTES, OTP_VERIFY_MAX_ATTEMPTS, type OnboardingPromoRedemption, type OnboardingSelectionRequest, type OnboardingSelectionResponse, PASSWORD_RESET_TTL_MINUTES, 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, type PaymentEventLog, type PaymentEventStatus, type PaymentProvider, type PendingRegistration, type PendingRegistrationCreateInput, type PendingRegistrationRepository, type PendingRegistrationSnapshot, type PendingRegistrationUpdateInput, type PersistenceCapabilities, PersistenceCapabilityError, type PersistenceClassRef, type PersistenceInjectionToken, type PersistenceProvider, type PlanCatalog, type PlanCatalogApp, type PlanCatalogImportReport, type PlanCatalogImportSink, type PlanCatalogIssuer, type PlanCatalogLookup, type PlanCatalogMarketing, type PlanCatalogNotifications, type PlanCatalogReadSink, type PlanCatalogReadSnapshot, type PlanCatalogSettings, type PlanCatalogSubscribers, type PlanCatalogTenantBilling, type PlanDef, type PlanId, type PlanListFilter, type PlanRepository, type PlanRow, type PlanVersion, type PlanVersionFields, type PlanVersionMappingFields, type PlanVersionMutationResult, type PlanVersionRecord, type PlanVersionRepository, type PlanVersionRow, type PlatformErrorBody, type PlatformErrorCode, type PlatformRole, type PlatformUserDto, PlatformUserExistsError, type ProjectPageDef, type PromoCode, type PromoCodeDurationType, type PromoCodeFilter, type 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 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 PublicSignupPlan, type PublishBundleVersionData, type PublishBundleVersionMeta, type PublishPlanVersionData, type QuotaCatalogEntryRow, type QuotaEnforcementMode, type QuotaKey, type QuotaProvider, REGISTRATION_ERROR_CODES, REGISTRATION_RESUME_TTL_MINUTES, REGISTRATION_STEP_BY_STATUS, type ReassignTenantAdminCliResult, type RecommendablePlan, type RedeemPromoInTransactionCallback, type RegistrationAuditContext, type RegistrationAuditEvent, type RegistrationAuditEventType, type RegistrationAuditLogger, type RegistrationConfigSelection, type RegistrationConfiguratorLookup, type RegistrationErrorCode, type RegistrationOtpDelivery, type RegistrationPromoPreview, type RegistrationResumeDelivery, type RegistrationResumeTokenSigner, type RegistrationStatus, type RegistrationStep, type RequiredCapabilities, type ResolvableErrorBody, type ResumeRegistrationInput, type ResumeRegistrationResult, type ReviewCatalogEntryData, type RlsBypassPort, SETTINGS_ERROR_CODES, SETUP_ERROR_CODES, SUBSCRIBER_ERROR_CODES, SUBSCRIBER_IDENTITY_FIELDS, type SaaSiCatPersistenceAdapter, type SaaSiCatPersistenceAdminResources, type SaaSiCatPersistenceCatalog, type SaaSiCatPersistenceCore, type SaaSiCatPersistenceEntitlement, type SaaSiCatPersistencePromo, type SaaSiCatPersistenceTenantBilling, type SaveRegistrationConfigInput, type SaveRegistrationConfigResult, type ScheduledPlanChangeInput, type SelectPlanInput, type SelectPlanResult, type SelectableBundleShape, type SelfServiceBlockedPlans, type SetCatalogEntryReviewData, type SettingsChangeFilter, type SettingsChangeRecord, type SettingsDifference, type SettingsErrorCode, type SetupConfirmMfaRequest, type SetupConfirmMfaResponse, type SetupErrorCode, type SetupRequest, type SetupResult, type SetupStatusResponse, type SlugAvailabilityCheck, type StandardPageDef, type StandardPageKey, type StartCheckoutInput, type StartCheckoutResult, type StartRegistrationInput, type StartRegistrationResult, type StoredBundleStem, type StrictModeWarning, type StrictModeWarningCode, type SubscriberContact, type SubscriberContactChange, type SubscriberCorrectionData, type SubscriberCorrectionRecord, type SubscriberCorrectionResult, type SubscriberDetails, type SubscriberErrorCode, type SubscriberIdentityCorrection, type SubscriberIdentityDelta, type SubscriberIdentityField, type SubscriberIdentityValues, type SubscriberRecord, type SubscriberRepository, type Subscription, type SubscriptionBundleRecord, type SubscriptionBundleRepository, type SubscriptionBundleView, type SubscriptionContractFilter, type SubscriptionContractInvoiceSnapshot, type SubscriptionContractParties, type SubscriptionContractPriceSnapshot, type SubscriptionContractRecord, type SubscriptionContractRepository, type SubscriptionContractStatus, type SubscriptionRecord, type SubscriptionRepository, type SubscriptionStatsPort, type SubscriptionStatsSnapshot, type SubscriptionStatus, type SubscriptionUsagePort, type SubscriptionUsageRecord, type SuperAdminProvisioningPort, type SyncDiscoveryResult, type TenantActionDef, type TenantColumnDef, type TenantDto, type TenantListFilter, type TenantPort, type TenantSubscriptionWritePort, type TerminateSubscriptionContractData, type TopPromoCode, type TransactionContext, type TransactionRunner, type UpdateBundleData, type UpdateBundleVersionDraftData, type UpdateCatalogEntryBaseData, type UpdateCatalogEntryI18nData, type UpdateCheckoutOfferData, type UpdateMarketingProjectionData, type UpdateMarketingSettingsData, type UpdatePlanData, type UpdatePlanVersionDraftData, type UpdatePromoCodeData, type UpdatePromoCodeRequest, type UpdatePromotionData, type UpsellOffer, type UpsellOfferResolver, type UpsertCapabilityEntryData, type UpsertFeatureCatalogEntryInput, type UpsertFeatureEntryData, type UpsertPlanInput, type UpsertPlanVersionInput, type UpsertQuotaEntryData, type UpsertResult, type UsageSnapshotPort, type UserAccountLookup, type UserListFilter, type UserManagementPort, type UserPort, type VerifyRegistrationOtpResult, type VersionChange, type VersionChangeDirection, type VersionEditability, type VersionEditableReason, type VersionedEntityBase, applyPromo, assertPersistenceCapabilities, buildActivePlanVersionWhere, buildActiveVersionWhere, buildFeatureRequiresIndex, bundleDraftDefaults, bundleStemDefaults, canonicalJson, classifyBundleVersionDiff, classifyPlanDiff, collectUnsatisfiedRequires, contractPartiesOf, coverageExcludingSelf, definedFields, diffSettings, formatCustomerNumber, formatErrorMessage, identityCorrectionDelta, isBundleRedundant, isPlatformUserExistsError, isVersionEditable, keepOneRecommended, missingRequiresFor, pickActivePromo, planCatalogSettingsOf, previousUtcDay, promoStatus, readQuotaRecord, readQuotaValue, resolveBundleAvailability, resolveErrorMessage, selectChargeableBundles, settingsSubtreeOf, startOfUtcDay, subscriberFromRegistration, toBundleStemRow, toContractLineItemRecord, toPlanRow, toPlanVersionRow, toSubscriberCorrectionRecord, toSubscriberRecord, toSubscriptionContractRecord };