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

package/dist/.build-stamp

@@ -1 +1 @@
-ffbbf3de488fa65a264bc00b14097f9d84d9da3428b766d0c2c6b74ccac9b249
+ac1a4c0280cf9333a264b4d84b290ab32ab44dd67287ec6d1abd99c01bc863b9

package/dist/index.cjs

@@ -49,6 +49,8 @@ __export(index_exports, {
   REGISTRATION_STEP_BY_STATUS: () => REGISTRATION_STEP_BY_STATUS,
   SETTINGS_ERROR_CODES: () => SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES: () => SETUP_ERROR_CODES,
+  SUBSCRIBER_ERROR_CODES: () => SUBSCRIBER_ERROR_CODES,
+  SUBSCRIBER_IDENTITY_FIELDS: () => SUBSCRIBER_IDENTITY_FIELDS,
   applyPromo: () => applyPromo,
   assertPersistenceCapabilities: () => assertPersistenceCapabilities,
   buildActivePlanVersionWhere: () => buildActivePlanVersionWhere,
@@ -60,16 +62,20 @@ __export(index_exports, {
   classifyBundleVersionDiff: () => classifyBundleVersionDiff,
   classifyPlanDiff: () => classifyPlanDiff,
   collectUnsatisfiedRequires: () => collectUnsatisfiedRequires,
+  contractPartiesOf: () => contractPartiesOf,
   coverageExcludingSelf: () => coverageExcludingSelf,
   definedFields: () => definedFields,
   diffSettings: () => diffSettings,
+  formatCustomerNumber: () => formatCustomerNumber,
   formatErrorMessage: () => formatErrorMessage,
+  identityCorrectionDelta: () => identityCorrectionDelta,
   isBundleRedundant: () => isBundleRedundant,
   isPlatformUserExistsError: () => isPlatformUserExistsError,
   isVersionEditable: () => isVersionEditable,
   keepOneRecommended: () => keepOneRecommended,
   missingRequiresFor: () => missingRequiresFor,
   pickActivePromo: () => pickActivePromo,
+  planCatalogSettingsOf: () => planCatalogSettingsOf,
   previousUtcDay: () => previousUtcDay,
   promoStatus: () => promoStatus,
   readQuotaRecord: () => readQuotaRecord,
@@ -79,10 +85,13 @@ __export(index_exports, {
   selectChargeableBundles: () => selectChargeableBundles,
   settingsSubtreeOf: () => settingsSubtreeOf,
   startOfUtcDay: () => startOfUtcDay,
+  subscriberFromRegistration: () => subscriberFromRegistration,
   toBundleStemRow: () => toBundleStemRow,
   toContractLineItemRecord: () => toContractLineItemRecord,
   toPlanRow: () => toPlanRow,
   toPlanVersionRow: () => toPlanVersionRow,
+  toSubscriberCorrectionRecord: () => toSubscriberCorrectionRecord,
+  toSubscriberRecord: () => toSubscriberRecord,
   toSubscriptionContractRecord: () => toSubscriptionContractRecord
 });
 module.exports = __toCommonJS(index_exports);
@@ -364,6 +373,9 @@ var CATALOGUE_KEYS = /* @__PURE__ */ new Set([
   "features",
   "plans"
 ]);
+function planCatalogSettingsOf(catalog) {
+  return settingsSubtreeOf(catalog);
+}
 function settingsSubtreeOf(catalog) {
   const settings = {};
   for (const [key, value] of Object.entries(catalog)) {
@@ -664,10 +676,37 @@ var CONTRACT_ERROR_CODES = {
   CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED",
   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.
+   */
+  CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED"
 };
+var 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`.
+   */
+  SUBSCRIBER_REQUIRED: "SUBSCRIBER_REQUIRED",
+  /** The tenant already has a live subscriber. Carries `tenantId`. */
+  SUBSCRIBER_ALREADY_EXISTS: "SUBSCRIBER_ALREADY_EXISTS",
+  SUBSCRIBER_NOT_FOUND: "SUBSCRIBER_NOT_FOUND",
+  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`. */
+  SUBSCRIBER_DETAIL_INVALID: "SUBSCRIBER_DETAIL_INVALID",
+  /** A contact change named a field of the legal identity. Carries `field`. */
+  SUBSCRIBER_IDENTITY_NOT_A_CONTACT: "SUBSCRIBER_IDENTITY_NOT_A_CONTACT",
+  SUBSCRIBER_CORRECTION_REASON_REQUIRED: "SUBSCRIBER_CORRECTION_REASON_REQUIRED",
+  SUBSCRIBER_CORRECTION_ACTOR_REQUIRED: "SUBSCRIBER_CORRECTION_ACTOR_REQUIRED",
+  SUBSCRIBER_CORRECTION_CHANGES_NOTHING: "SUBSCRIBER_CORRECTION_CHANGES_NOTHING",
+  /** The operator declared another legal entity: that is a transfer, not an edit. */
+  SUBSCRIBER_TAKEOVER_IS_A_TRANSFER: "SUBSCRIBER_TAKEOVER_IS_A_TRANSFER"
+};
 var REGISTRATION_ERROR_CODES = {
   PENDING_REGISTRATION_NOT_FOUND: "PENDING_REGISTRATION_NOT_FOUND",
   PENDING_REGISTRATION_EXPIRED: "PENDING_REGISTRATION_EXPIRED",
@@ -731,6 +770,7 @@ var PLATFORM_ERROR_CODES = {
   ...CATALOG_ERROR_CODES,
   ...BILLING_ERROR_CODES,
   ...CONTRACT_ERROR_CODES,
+  ...SUBSCRIBER_ERROR_CODES,
   ...REGISTRATION_ERROR_CODES,
   ...SETTINGS_ERROR_CODES
 };
@@ -890,11 +930,113 @@ function toQuotaEffects(value) {
   return quotas;
 }
 
+// src/subscriber-mapping.ts
+var SUBSCRIBER_IDENTITY_FIELDS = [
+  "legalName",
+  "vatId",
+  "taxNumber"
+];
+function formatCustomerNumber(prefix, sequence) {
+  return `${prefix}${sequence}`;
+}
+function toSubscriberRecord(row, tenantId) {
+  return {
+    id: row.id,
+    customerNumber: formatCustomerNumber(row.customerNumberPrefix, row.customerSequence),
+    legalName: row.legalName,
+    addressLine1: row.addressLine1,
+    addressLine2: row.addressLine2,
+    postalCode: row.postalCode,
+    city: row.city,
+    country: row.country,
+    vatId: row.vatId,
+    taxNumber: row.taxNumber,
+    invoiceEmail: row.invoiceEmail,
+    tenantId,
+    migrated: row.migrated,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt
+  };
+}
+function toSubscriberCorrectionRecord(row) {
+  return {
+    id: row.id,
+    subscriberId: row.subscriberId,
+    previous: toIdentityValues(row.previous),
+    corrected: toIdentityValues(row.corrected),
+    reason: row.reason,
+    correctedBy: row.correctedBy,
+    correctedAt: row.correctedAt
+  };
+}
+function identityCorrectionDelta(current, corrected) {
+  const previous = {};
+  const next = {};
+  for (const field of SUBSCRIBER_IDENTITY_FIELDS) {
+    const value = corrected[field];
+    if (value === void 0 || value === current[field]) continue;
+    previous[field] = current[field];
+    next[field] = value;
+  }
+  return {
+    previous,
+    corrected: next
+  };
+}
+function contractPartiesOf(subscriber, issuer) {
+  const party = {
+    customerNumber: subscriber.customerNumber,
+    legalName: subscriber.legalName,
+    vatId: subscriber.vatId,
+    taxNumber: subscriber.taxNumber,
+    addressLine1: subscriber.addressLine1,
+    addressLine2: subscriber.addressLine2,
+    postalCode: subscriber.postalCode,
+    city: subscriber.city,
+    country: subscriber.country
+  };
+  return {
+    subscriberId: subscriber.id,
+    subscriber: party,
+    issuer: issuer ? issuerPartyOf(issuer) : null
+  };
+}
+function issuerPartyOf(issuer) {
+  return {
+    legalName: issuer.legalName,
+    vatId: issuer.vatId ?? null,
+    taxNumber: issuer.taxNumber ?? null,
+    addressLine1: issuer.addressLine1 ?? null,
+    addressLine2: issuer.addressLine2 ?? null,
+    postalCode: issuer.postalCode ?? null,
+    city: issuer.city ?? null,
+    country: issuer.country ?? null
+  };
+}
+function subscriberFromRegistration(pending) {
+  return { legalName: pending.tenantName, invoiceEmail: pending.email };
+}
+function toIdentityValues(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return {};
+  const source = value;
+  const values = {};
+  for (const field of SUBSCRIBER_IDENTITY_FIELDS) {
+    if (!Object.prototype.hasOwnProperty.call(source, field)) continue;
+    const entry = source[field];
+    values[field] = typeof entry === "string" ? entry : null;
+  }
+  return values;
+}
+
 // src/subscription-contract-mapping.ts
 function toSubscriptionContractRecord(row, lineItems) {
   return {
     id: row.id,
     tenantId: row.tenantId,
+    subscriberId: row.subscriberId,
+    subscriber: toSubscriberParty(row.subscriberSnapshot),
+    issuer: isPlainObject2(row.issuerSnapshot) ? toIssuerParty(row.issuerSnapshot) : null,
+    partiesMigrated: row.partiesMigrated,
     status: row.status,
     effectiveFrom: row.effectiveFrom,
     effectiveUntil: row.effectiveUntil,
@@ -935,6 +1077,32 @@ function toContractLineItemRecord(row) {
     createdAt: row.createdAt
   };
 }
+function toSubscriberParty(value) {
+  const source = isPlainObject2(value) ? value : {};
+  return {
+    customerNumber: stringOr(source.customerNumber, ""),
+    ...toIssuerParty(source)
+  };
+}
+function toIssuerParty(value) {
+  const source = value;
+  return {
+    legalName: stringOr(source.legalName, ""),
+    vatId: stringOrNull(source.vatId),
+    taxNumber: stringOrNull(source.taxNumber),
+    addressLine1: stringOrNull(source.addressLine1),
+    addressLine2: stringOrNull(source.addressLine2),
+    postalCode: stringOrNull(source.postalCode),
+    city: stringOrNull(source.city),
+    country: stringOrNull(source.country)
+  };
+}
+function stringOr(value, fallback) {
+  return typeof value === "string" ? value : fallback;
+}
+function stringOrNull(value) {
+  return typeof value === "string" ? value : null;
+}
 function isPlainObject2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -1147,9 +1315,21 @@ var ERROR_MESSAGES_EN = {
   CHECKOUT_OFFER_EXPIRED: "Checkout offer '{offerId}' has expired and cannot be {action}",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "Checkout offer '{offerId}' has already been consumed and cannot be {action}",
   CHECKOUT_OFFER_NOT_CONSUMED: "CheckoutOffer '{offerId}' must be consumed before the contract is created",
+  CHECKOUT_OFFER_CHANGED: "Checkout offer '{offerId}' changed while it was being concluded. Load it again.",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SubscriptionContract '{contractId}' not found",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "No active subscription contract for tenant {tenantId}",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SubscriptionContract '{contractId}' is already closed",
+  // ── subscriber ──
+  SUBSCRIBER_REQUIRED: "Tenant '{tenantId}' has no subscriber. Nothing is agreed or charged without the party to it: create the tenant's subscriber first.",
+  SUBSCRIBER_ALREADY_EXISTS: "Tenant '{tenantId}' already has a subscriber.",
+  SUBSCRIBER_NOT_FOUND: "Subscriber '{subscriberId}' not found",
+  SUBSCRIBER_LEGAL_NAME_REQUIRED: "A subscriber needs its legal name.",
+  SUBSCRIBER_DETAIL_INVALID: "The subscriber's {field} is not valid.",
+  SUBSCRIBER_IDENTITY_NOT_A_CONTACT: "{field} is part of the subscriber's legal identity and changes only as a correction, with a reason.",
+  SUBSCRIBER_CORRECTION_REASON_REQUIRED: "A correction of the legal identity needs a reason.",
+  SUBSCRIBER_CORRECTION_ACTOR_REQUIRED: "A correction of the legal identity has to say who makes it.",
+  SUBSCRIBER_CORRECTION_CHANGES_NOTHING: "The correction changes nothing: every value it names is already recorded.",
+  SUBSCRIBER_TAKEOVER_IS_A_TRANSFER: "Another legal entity taking over a subscriber is a transfer, not a correction, and cannot be recorded as an edit.",
   // ── registration ──
   PENDING_REGISTRATION_NOT_FOUND: "This registration could not be found. It may have already been completed or discarded.",
   PENDING_REGISTRATION_EXPIRED: "This registration has expired. Please start again.",
@@ -1336,9 +1516,21 @@ var ERROR_MESSAGES_DE = {
   CHECKOUT_OFFER_EXPIRED: "Checkout-Angebot '{offerId}' ist abgelaufen \u2014 '{action}' ist nicht mehr m\xF6glich",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "Checkout-Angebot '{offerId}' wurde bereits eingel\xF6st \u2014 '{action}' ist nicht mehr m\xF6glich",
   CHECKOUT_OFFER_NOT_CONSUMED: "CheckoutOffer '{offerId}' muss eingel\xF6st sein, bevor der Vertrag entsteht",
+  CHECKOUT_OFFER_CHANGED: "Checkout-Angebot '{offerId}' hat sich w\xE4hrend des Abschlusses ge\xE4ndert. Bitte neu laden.",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SubscriptionContract '{contractId}' nicht gefunden",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "Kein aktiver Abo-Vertrag f\xFCr Mandant {tenantId}",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SubscriptionContract '{contractId}' ist bereits geschlossen",
+  // ── subscriber ──
+  SUBSCRIBER_REQUIRED: "Mandant '{tenantId}' hat keinen Vertragspartner. Ohne ihn wird nichts vereinbart oder berechnet: Zuerst muss der Vertragspartner des Mandanten angelegt werden.",
+  SUBSCRIBER_ALREADY_EXISTS: "Mandant '{tenantId}' hat bereits einen Vertragspartner.",
+  SUBSCRIBER_NOT_FOUND: "Vertragspartner '{subscriberId}' nicht gefunden",
+  SUBSCRIBER_LEGAL_NAME_REQUIRED: "Ein Vertragspartner braucht seinen rechtlichen Namen.",
+  SUBSCRIBER_DETAIL_INVALID: "Das Feld {field} des Vertragspartners ist ung\xFCltig.",
+  SUBSCRIBER_IDENTITY_NOT_A_CONTACT: "{field} geh\xF6rt zur rechtlichen Identit\xE4t des Vertragspartners und \xE4ndert sich nur als Korrektur mit Begr\xFCndung.",
+  SUBSCRIBER_CORRECTION_REASON_REQUIRED: "Eine Korrektur der rechtlichen Identit\xE4t braucht eine Begr\xFCndung.",
+  SUBSCRIBER_CORRECTION_ACTOR_REQUIRED: "Eine Korrektur der rechtlichen Identit\xE4t muss nennen, wer sie vornimmt.",
+  SUBSCRIBER_CORRECTION_CHANGES_NOTHING: "Die Korrektur \xE4ndert nichts: Jeder genannte Wert ist bereits erfasst.",
+  SUBSCRIBER_TAKEOVER_IS_A_TRANSFER: "\xDCbernimmt eine andere Rechtsperson, ist das eine \xDCbertragung und keine Korrektur; sie l\xE4sst sich nicht als \xC4nderung erfassen.",
   // ── registration ──
   PENDING_REGISTRATION_NOT_FOUND: "Diese Registrierung konnten wir nicht finden. Vielleicht ist sie bereits abgeschlossen oder verworfen.",
   PENDING_REGISTRATION_EXPIRED: "Diese Registrierung ist abgelaufen. Bitte fange noch einmal von vorn an.",
@@ -1390,6 +1582,8 @@ var ERROR_MESSAGES_DE = {
   REGISTRATION_STEP_BY_STATUS,
   SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES,
+  SUBSCRIBER_ERROR_CODES,
+  SUBSCRIBER_IDENTITY_FIELDS,
   applyPromo,
   assertPersistenceCapabilities,
   buildActivePlanVersionWhere,
@@ -1401,16 +1595,20 @@ var ERROR_MESSAGES_DE = {
   classifyBundleVersionDiff,
   classifyPlanDiff,
   collectUnsatisfiedRequires,
+  contractPartiesOf,
   coverageExcludingSelf,
   definedFields,
   diffSettings,
+  formatCustomerNumber,
   formatErrorMessage,
+  identityCorrectionDelta,
   isBundleRedundant,
   isPlatformUserExistsError,
   isVersionEditable,
   keepOneRecommended,
   missingRequiresFor,
   pickActivePromo,
+  planCatalogSettingsOf,
   previousUtcDay,
   promoStatus,
   readQuotaRecord,
@@ -1420,9 +1618,12 @@ var ERROR_MESSAGES_DE = {
   selectChargeableBundles,
   settingsSubtreeOf,
   startOfUtcDay,
+  subscriberFromRegistration,
   toBundleStemRow,
   toContractLineItemRecord,
   toPlanRow,
   toPlanVersionRow,
+  toSubscriberCorrectionRecord,
+  toSubscriberRecord,
   toSubscriptionContractRecord
 });