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

package/dist/index.js

@@ -871,12 +871,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}`;
 }
@@ -913,7 +987,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];
@@ -943,17 +1017,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,
@@ -971,7 +1054,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;
@@ -1088,6 +1171,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 {
@@ -1578,6 +1670,7 @@ export {
   ERROR_MESSAGES_DE,
   ERROR_MESSAGES_EN,
   FEATURE_NOT_LICENSED,
+  LEGAL_IDENTITY_FIELDS,
   MARKETING_PRIORITY_MAX,
   MARKETING_PRIORITY_MIN,
   OTP_RATE_LIMIT_MAX_SENDS,
@@ -1601,7 +1694,6 @@ export {
   SETTINGS_ERROR_CODES,
   SETUP_ERROR_CODES,
   SUBSCRIBER_ERROR_CODES,
-  SUBSCRIBER_IDENTITY_FIELDS,
   applyPromo,
   assertPersistenceCapabilities,
   buildActivePlanVersionWhere,
@@ -1611,6 +1703,7 @@ export {
   bundleStemDefaults,
   canonicalJson,
   classifyBundleVersionDiff,
+  classifyIssuerChange,
   classifyPlanDiff,
   collectUnsatisfiedRequires,
   contractPartiesOf,
@@ -1624,16 +1717,20 @@ export {
   isPaymentCallbackRejectedError,
   isPlatformUserExistsError,
   isVersionEditable,
+  issuerIdentityOf,
   keepOneRecommended,
   missingRequiresFor,
+  movedIdentityFields,
   pickActivePromo,
   planCatalogSettingsOf,
   previousUtcDay,
   promoStatus,
   readQuotaRecord,
   readQuotaValue,
+  recordedIssuerIdentity,
   resolveBundleAvailability,
   resolveErrorMessage,
+  sameLegalIdentity,
   selectChargeableBundles,
   settingsSubtreeOf,
   startOfUtcDay,
@@ -1643,6 +1740,7 @@ export {
   toContractLineItemRecord,
   toPlanRow,
   toPlanVersionRow,
+  toRunningContractIssuer,
   toSubscriberCorrectionRecord,
   toSubscriberPaymentMethodRecord,
   toSubscriberRecord,

package/package.json

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