@saasicat/core 1.0.0-rc.18 → 1.0.0-rc.19

package/dist/.build-stamp

@@ -1 +1 @@
-38b64b584100aa842f707e8c1a691762ba2ff699bf1d6069a06b09d86eb48375
+ddacfff58341810ccf3e690339f1e89ac04afebe5b2306f827ca21350b3a522b

package/dist/index.cjs

@@ -30,6 +30,7 @@ __export(index_exports, {
   ERROR_MESSAGES_DE: () => ERROR_MESSAGES_DE,
   ERROR_MESSAGES_EN: () => ERROR_MESSAGES_EN,
   FEATURE_NOT_LICENSED: () => FEATURE_NOT_LICENSED,
+  LEGAL_IDENTITY_FIELDS: () => LEGAL_IDENTITY_FIELDS,
   MARKETING_PRIORITY_MAX: () => MARKETING_PRIORITY_MAX,
   MARKETING_PRIORITY_MIN: () => MARKETING_PRIORITY_MIN,
   OTP_RATE_LIMIT_MAX_SENDS: () => OTP_RATE_LIMIT_MAX_SENDS,
@@ -53,7 +54,6 @@ __export(index_exports, {
   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,
@@ -63,6 +63,7 @@ __export(index_exports, {
   bundleStemDefaults: () => bundleStemDefaults,
   canonicalJson: () => canonicalJson,
   classifyBundleVersionDiff: () => classifyBundleVersionDiff,
+  classifyIssuerChange: () => classifyIssuerChange,
   classifyPlanDiff: () => classifyPlanDiff,
   collectUnsatisfiedRequires: () => collectUnsatisfiedRequires,
   contractPartiesOf: () => contractPartiesOf,
@@ -76,16 +77,20 @@ __export(index_exports, {
   isPaymentCallbackRejectedError: () => isPaymentCallbackRejectedError,
   isPlatformUserExistsError: () => isPlatformUserExistsError,
   isVersionEditable: () => isVersionEditable,
+  issuerIdentityOf: () => issuerIdentityOf,
   keepOneRecommended: () => keepOneRecommended,
   missingRequiresFor: () => missingRequiresFor,
+  movedIdentityFields: () => movedIdentityFields,
   pickActivePromo: () => pickActivePromo,
   planCatalogSettingsOf: () => planCatalogSettingsOf,
   previousUtcDay: () => previousUtcDay,
   promoStatus: () => promoStatus,
   readQuotaRecord: () => readQuotaRecord,
   readQuotaValue: () => readQuotaValue,
+  recordedIssuerIdentity: () => recordedIssuerIdentity,
   resolveBundleAvailability: () => resolveBundleAvailability,
   resolveErrorMessage: () => resolveErrorMessage,
+  sameLegalIdentity: () => sameLegalIdentity,
   selectChargeableBundles: () => selectChargeableBundles,
   settingsSubtreeOf: () => settingsSubtreeOf,
   startOfUtcDay: () => startOfUtcDay,
@@ -95,6 +100,7 @@ __export(index_exports, {
   toContractLineItemRecord: () => toContractLineItemRecord,
   toPlanRow: () => toPlanRow,
   toPlanVersionRow: () => toPlanVersionRow,
+  toRunningContractIssuer: () => toRunningContractIssuer,
   toSubscriberCorrectionRecord: () => toSubscriberCorrectionRecord,
   toSubscriberPaymentMethodRecord: () => toSubscriberPaymentMethodRecord,
   toSubscriberRecord: () => toSubscriberRecord,
@@ -975,12 +981,86 @@ function toQuotaEffects(value) {
   return quotas;
 }
 
-// src/subscriber-mapping.ts
-var SUBSCRIBER_IDENTITY_FIELDS = [
+// src/legal-identity.ts
+var LEGAL_IDENTITY_FIELDS = [
   "legalName",
   "vatId",
   "taxNumber"
 ];
+function sameLegalIdentity(before, after) {
+  return LEGAL_IDENTITY_FIELDS.every((field) => before[field] === after[field]);
+}
+function movedIdentityFields(before, after) {
+  return LEGAL_IDENTITY_FIELDS.filter((field) => before[field] !== after[field]);
+}
+
+// src/issuer-identity.ts
+function issuerIdentityOf(issuer) {
+  if (!issuer) return null;
+  return identityOf({
+    legalName: issuer.legalName,
+    vatId: issuer.vatId,
+    taxNumber: issuer.taxNumber
+  });
+}
+function recordedIssuerIdentity(settings) {
+  const issuer = settings?.issuer;
+  if (issuer === null || typeof issuer !== "object" || Array.isArray(issuer)) return null;
+  return identityOf(issuer);
+}
+function identityOf(source) {
+  const legalName = textOrNull(source.legalName);
+  if (legalName === null) return null;
+  return {
+    legalName,
+    vatId: textOrNull(source.vatId),
+    taxNumber: textOrNull(source.taxNumber)
+  };
+}
+function classifyIssuerChange(recorded, issuer) {
+  const current = issuerIdentityOf(issuer);
+  if (!recorded)
+    return current ? { kind: "first-naming", identity: current } : { kind: "none-named" };
+  if (current && sameLegalIdentity(recorded, current))
+    return { kind: "unchanged", identity: current };
+  if (!current) {
+    const moved2 = LEGAL_IDENTITY_FIELDS.filter((field) => recorded[field] !== null);
+    return {
+      kind: "undeclared",
+      recorded,
+      current: null,
+      moved: moved2,
+      fault: { kind: "names-no-issuer" }
+    };
+  }
+  const moved = movedIdentityFields(recorded, current);
+  const fault = faultIn(issuer?.correctionOf, recorded, moved);
+  if (fault) return { kind: "undeclared", recorded, current, moved, fault };
+  const declaration = issuer?.correctionOf;
+  return { kind: "corrected", recorded, current, moved, reason: declaration.reason };
+}
+function faultIn(declaration, recorded, moved) {
+  if (!declaration) return { kind: "absent" };
+  for (const field of LEGAL_IDENTITY_FIELDS) {
+    if (!Object.prototype.hasOwnProperty.call(declaration, field)) continue;
+    const declared = textOrNull(declaration[field]);
+    if (declared !== recorded[field]) {
+      return { kind: "names-another-value", field, declared, recorded: recorded[field] };
+    }
+  }
+  for (const field of moved) {
+    if (Object.prototype.hasOwnProperty.call(declaration, field)) continue;
+    return { kind: "leaves-a-field-out", field, recorded: recorded[field] };
+  }
+  return null;
+}
+function textOrNull(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed === "" ? null : trimmed;
+}
+
+// src/subscriber-mapping.ts
 function formatCustomerNumber(prefix, sequence) {
   return `${prefix}${sequence}`;
 }
@@ -1017,7 +1097,7 @@ function toSubscriberCorrectionRecord(row) {
 function identityCorrectionDelta(current, corrected) {
   const previous = {};
   const next = {};
-  for (const field of SUBSCRIBER_IDENTITY_FIELDS) {
+  for (const field of LEGAL_IDENTITY_FIELDS) {
     const value = corrected[field];
     if (value === void 0 || value === current[field]) continue;
     previous[field] = current[field];
@@ -1047,17 +1127,26 @@ function contractPartiesOf(subscriber, issuer) {
   };
 }
 function issuerPartyOf(issuer) {
+  const identity = issuerIdentityOf(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
+    legalName: identity?.legalName ?? "",
+    vatId: identity?.vatId ?? null,
+    taxNumber: identity?.taxNumber ?? null,
+    // Settled like the three above rather than copied verbatim: one copy
+    // whose halves were settled differently is a row that reads two ways,
+    // and a city written with a trailing space is not another city.
+    addressLine1: settledText(issuer.addressLine1),
+    addressLine2: settledText(issuer.addressLine2),
+    postalCode: settledText(issuer.postalCode),
+    city: settledText(issuer.city),
+    country: settledText(issuer.country)
   };
 }
+function settledText(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed === "" ? null : trimmed;
+}
 function subscriberFromRegistration(pending) {
   return {
     legalName: pending.tenantName,
@@ -1075,7 +1164,7 @@ 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) {
+  for (const field of LEGAL_IDENTITY_FIELDS) {
     if (!Object.prototype.hasOwnProperty.call(source, field)) continue;
     const entry = source[field];
     values[field] = typeof entry === "string" ? entry : null;
@@ -1192,6 +1281,15 @@ function toSubscriberParty(value) {
     ...toIssuerParty(source)
   };
 }
+function toRunningContractIssuer(row) {
+  const issuer = isPlainObject2(row.issuerSnapshot) ? row.issuerSnapshot : null;
+  return {
+    id: row.id,
+    tenantId: row.tenantId,
+    issuerLegalName: issuer ? stringOrNull(issuer.legalName) : null,
+    effectiveFrom: row.effectiveFrom
+  };
+}
 function toIssuerParty(value) {
   const source = value;
   return {
@@ -1683,6 +1781,7 @@ var ERROR_MESSAGES_DE = {
   ERROR_MESSAGES_DE,
   ERROR_MESSAGES_EN,
   FEATURE_NOT_LICENSED,
+  LEGAL_IDENTITY_FIELDS,
   MARKETING_PRIORITY_MAX,
   MARKETING_PRIORITY_MIN,
   OTP_RATE_LIMIT_MAX_SENDS,
@@ -1706,7 +1805,6 @@ var ERROR_MESSAGES_DE = {
   SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES,
   SUBSCRIBER_ERROR_CODES,
-  SUBSCRIBER_IDENTITY_FIELDS,
   applyPromo,
   assertPersistenceCapabilities,
   buildActivePlanVersionWhere,
@@ -1716,6 +1814,7 @@ var ERROR_MESSAGES_DE = {
   bundleStemDefaults,
   canonicalJson,
   classifyBundleVersionDiff,
+  classifyIssuerChange,
   classifyPlanDiff,
   collectUnsatisfiedRequires,
   contractPartiesOf,
@@ -1729,16 +1828,20 @@ var ERROR_MESSAGES_DE = {
   isPaymentCallbackRejectedError,
   isPlatformUserExistsError,
   isVersionEditable,
+  issuerIdentityOf,
   keepOneRecommended,
   missingRequiresFor,
+  movedIdentityFields,
   pickActivePromo,
   planCatalogSettingsOf,
   previousUtcDay,
   promoStatus,
   readQuotaRecord,
   readQuotaValue,
+  recordedIssuerIdentity,
   resolveBundleAvailability,
   resolveErrorMessage,
+  sameLegalIdentity,
   selectChargeableBundles,
   settingsSubtreeOf,
   startOfUtcDay,
@@ -1748,6 +1851,7 @@ var ERROR_MESSAGES_DE = {
   toContractLineItemRecord,
   toPlanRow,
   toPlanVersionRow,
+  toRunningContractIssuer,
   toSubscriberCorrectionRecord,
   toSubscriberPaymentMethodRecord,
   toSubscriberRecord,