@saasicat/core 1.0.0-rc.6 → 1.0.0-rc.7

package/dist/index.js

@@ -2,6 +2,11 @@
 function startOfUtcDay(date) {
   return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
 }
+function previousUtcDay(value) {
+  const result = new Date(value);
+  result.setUTCDate(result.getUTCDate() - 1);
+  return result;
+}
 function buildActivePlanVersionWhere(asOf, options = {}) {
   const asOfDayStart = startOfUtcDay(asOf);
   const validityWindow = [
@@ -18,6 +23,53 @@ function buildActivePlanVersionWhere(asOf, options = {}) {
 }
 var buildActiveVersionWhere = buildActivePlanVersionWhere;
 
+// src/bundle-draft-defaults.ts
+function bundleDraftDefaults(data) {
+  return {
+    baseVersionId: data.baseVersionId ?? null,
+    features: data.features,
+    quotas: data.quotas ?? {},
+    compatibility: data.compatibility ?? {},
+    pricingOverrides: data.pricingOverrides ?? [],
+    monthlyNet: data.monthlyNet ?? null,
+    yearlyNet: data.yearlyNet ?? null,
+    marketed: data.marketed ?? true,
+    changeNote: data.changeNote ?? "",
+    createdByUserId: data.createdByUserId ?? null
+  };
+}
+function bundleStemDefaults(data) {
+  return {
+    bundleKey: data.bundleKey,
+    label: data.label,
+    description: data.description ?? null,
+    icon: data.icon ?? null,
+    sortOrder: data.sortOrder ?? 0,
+    i18n: data.i18n ?? {}
+  };
+}
+function toBundleStemRow(row) {
+  return {
+    id: row.id,
+    bundleKey: row.bundleKey,
+    label: row.label,
+    description: row.description,
+    icon: row.icon,
+    sortOrder: row.sortOrder,
+    i18n: row.i18n !== null && typeof row.i18n === "object" && !Array.isArray(row.i18n) ? row.i18n : {},
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+    deletedAt: row.deletedAt?.toISOString() ?? null
+  };
+}
+function definedFields(data, keys) {
+  const patch = {};
+  for (const key of keys) {
+    if (data[key] !== void 0) patch[key] = data[key];
+  }
+  return patch;
+}
+
 // src/catalog-entry.types.ts
 var MARKETING_PRIORITY_MIN = 0;
 var MARKETING_PRIORITY_MAX = 1e4;
@@ -273,6 +325,8 @@ var CATALOG_ERROR_CODES = {
   BUNDLE_VERSION_SUPERSEDED: "BUNDLE_VERSION_SUPERSEDED",
   BUNDLE_VERSION_REGRESSION: "BUNDLE_VERSION_REGRESSION",
   BUNDLE_VERSION_ZERO_PRICE: "BUNDLE_VERSION_ZERO_PRICE",
+  BUNDLE_VERSION_NO_PRICE: "BUNDLE_VERSION_NO_PRICE",
+  BUNDLE_VERSION_NOT_PRICED_FOR_PLAN: "BUNDLE_VERSION_NOT_PRICED_FOR_PLAN",
   BUNDLE_VERSION_DISCARD_NOT_IMPLEMENTED: "BUNDLE_VERSION_DISCARD_NOT_IMPLEMENTED",
   BUNDLE_VERSION_VALID_FROM_REQUIRED: "BUNDLE_VERSION_VALID_FROM_REQUIRED",
   BUNDLE_VERSION_VALID_FROM_INVALID: "BUNDLE_VERSION_VALID_FROM_INVALID",
@@ -319,6 +373,8 @@ var BILLING_ERROR_CODES = {
   BUNDLE_ALREADY_SUBSCRIBED: "BUNDLE_ALREADY_SUBSCRIBED",
   BUNDLE_INCOMPATIBLE_WITH_PLAN: "BUNDLE_INCOMPATIBLE_WITH_PLAN",
   BUNDLE_NOT_SELF_SERVICE: "BUNDLE_NOT_SELF_SERVICE",
+  BUNDLE_CYCLE_EXCEEDS_PLAN: "BUNDLE_CYCLE_EXCEEDS_PLAN",
+  BUNDLE_NOT_PRICED_FOR_THIS_PLAN: "BUNDLE_NOT_PRICED_FOR_THIS_PLAN",
   SUBSCRIPTION_BUNDLE_ALREADY_CANCELLED: "SUBSCRIPTION_BUNDLE_ALREADY_CANCELLED",
   SUBSCRIPTION_BUNDLE_NOT_CANCELLED: "SUBSCRIPTION_BUNDLE_NOT_CANCELLED",
   SUBSCRIPTION_BUNDLE_CANCELLATION_EFFECTIVE: "SUBSCRIPTION_BUNDLE_CANCELLATION_EFFECTIVE",
@@ -525,6 +581,137 @@ var REGISTRATION_STEP_BY_STATUS = {
 };
 var REGISTRATION_RESUME_TTL_MINUTES = 60;
 
+// src/plan-mapping.ts
+function toPlanRow(row) {
+  return {
+    id: row.id,
+    planKey: row.planKey,
+    label: row.label,
+    description: row.description,
+    icon: row.icon,
+    sortOrder: row.sortOrder,
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+    deletedAt: toIsoOrNull(row.deletedAt)
+  };
+}
+function toPlanVersionRow(row, planKey, fields) {
+  const mapped = {
+    id: row.id,
+    version: row.version,
+    baseVersionId: row.baseVersionId,
+    planId: planKey,
+    features: toFeatureKeys(row.features),
+    quotas: toQuotaEffects(row.quotas),
+    monthlyNet: String(row.monthlyNet),
+    yearlyNet: String(row.yearlyNet),
+    marketed: row.marketed,
+    publishedAt: toIsoOrNull(row.publishedAt),
+    supersededAt: toIsoOrNull(row.supersededAt),
+    publishedChanges: Array.isArray(row.publishedChanges) ? row.publishedChanges : null,
+    changeNote: row.changeNote,
+    nonRegressive: row.nonRegressive,
+    validFrom: fields.validityWindows ? toIsoOrNull(row.validFrom) : null,
+    validUntil: fields.validityWindows ? toIsoOrNull(row.validUntil) : null,
+    createdByUserId: row.createdByUserId,
+    publishedByUserId: row.publishedByUserId,
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString()
+  };
+  if (fields.endsAt) {
+    mapped.endsAt = toIsoOrNull(row.endsAt);
+  }
+  return mapped;
+}
+function toIsoOrNull(value) {
+  return value ? value.toISOString() : null;
+}
+function toFeatureKeys(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((entry) => typeof entry === "string");
+}
+function toQuotaEffects(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  const quotas = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (typeof entry === "number") quotas[key] = entry;
+  }
+  return quotas;
+}
+
+// src/subscription-contract-mapping.ts
+function toSubscriptionContractRecord(row, lineItems) {
+  return {
+    id: row.id,
+    tenantId: row.tenantId,
+    status: row.status,
+    effectiveFrom: row.effectiveFrom,
+    effectiveUntil: row.effectiveUntil,
+    originalOfferId: row.originalOfferId,
+    originalPlanVersionId: row.originalPlanVersionId,
+    originalBundleVersionIds: toStringArray(row.originalBundleVersionIds),
+    entitlementSnapshot: isPlainObject(row.entitlementSnapshot) ? row.entitlementSnapshot : null,
+    priceSnapshot: row.priceSnapshot,
+    promotionSnapshots: toUnknownArray(row.promotionSnapshots),
+    promoCodeSnapshots: toUnknownArray(row.promoCodeSnapshots),
+    termsSnapshot: toRecordOrNull(row.termsSnapshot),
+    lineItems: lineItems.map(toContractLineItemRecord),
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt
+  };
+}
+function toContractLineItemRecord(row) {
+  return {
+    id: row.id,
+    contractId: row.contractId,
+    kind: row.kind,
+    sourceKey: row.sourceKey,
+    sourceVersionId: row.sourceVersionId,
+    titleSnapshot: row.titleSnapshot,
+    descriptionSnapshot: row.descriptionSnapshot,
+    quantity: row.quantity,
+    unit: row.unit,
+    priceNet: Number(row.priceNet),
+    priceGross: Number(row.priceGross),
+    billingCycle: row.billingCycle,
+    minimumTermUntil: row.minimumTermUntil,
+    featuresSnapshot: toStringArray(row.featuresSnapshot),
+    quotaEffectsSnapshot: toQuotaEffects2(row.quotaEffectsSnapshot),
+    metadata: toRecordOrNull(row.metadata),
+    createdAt: row.createdAt
+  };
+}
+function isPlainObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function toUnknownArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function toRecordOrNull(value) {
+  return isPlainObject(value) ? value : null;
+}
+function toStringArray(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((entry) => typeof entry === "string");
+}
+function toQuotaEffects2(value) {
+  if (!isPlainObject(value)) return {};
+  const effects = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (typeof entry === "number") effects[key] = entry;
+  }
+  return effects;
+}
+
+// src/subscription-contract.types.ts
+var BUNDLE_PRICE_LOOKUP_LIMIT = 200;
+var ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES = [
+  "active",
+  "scheduled"
+];
+
 // src/version-editability.ts
 function isVersionEditable(v, now = /* @__PURE__ */ new Date()) {
   if (v.publishedAt === null) {
@@ -596,6 +783,8 @@ var ERROR_MESSAGES_EN = {
   BUNDLE_VERSION_SUPERSEDED: "BundleVersion '{bundleVersionId}' has been superseded by a newer version.",
   BUNDLE_VERSION_REGRESSION: "This bundle version is regressive (feature removed / quota lowered / price raised). Publishing requires an explicit `forceRegressive: true` (UI confirmation dialog with MFA).",
   BUNDLE_VERSION_ZERO_PRICE: "A bundle version cannot be published with an explicit price of 0.00 (guard against seed placeholders). For free bundles leave it null, or set allowZeroPrice.",
+  BUNDLE_VERSION_NO_PRICE: "This bundle version cannot be published without a price: neither a base price nor any plan override resolves one.",
+  BUNDLE_VERSION_NOT_PRICED_FOR_PLAN: "This bundle is offered to plan '{planKey}', which is sold {billingCycle}, and no {billingCycle} price resolves for it \u2014 neither a base price nor a plan override.",
   BUNDLE_VERSION_DISCARD_NOT_IMPLEMENTED: "Discard is not implemented in the current repository. Implement BundleRepository.deleteDraft.",
   BUNDLE_VERSION_VALID_FROM_REQUIRED: "Published bundle versions must keep a validFrom. Set a new future date, or edit the draft before publishing.",
   BUNDLE_VERSION_VALID_FROM_INVALID: "validFrom '{validFrom}' is not a valid date",
@@ -609,12 +798,12 @@ var ERROR_MESSAGES_EN = {
   PLAN_VERSION_NOT_FOUND: "PlanVersion '{versionId}' not found",
   BUNDLE_NOT_FOUND: "Bundle '{bundleId}' not found",
   BUNDLE_VERSION_NOT_FOUND: "BundleVersion '{bundleVersionId}' not found",
-  FEATURE_NOT_FOUND: "Feature '{featureKey}' not found in project '{projectKey}'",
-  QUOTA_NOT_FOUND: "Quota '{quotaKey}' not found in project '{projectKey}'",
+  FEATURE_NOT_FOUND: "Feature '{featureKey}' not found",
+  QUOTA_NOT_FOUND: "Quota '{quotaKey}' not found",
   PROMOTION_NOT_FOUND: "Promotion '{promotionId}' not found",
   MARKETING_PROJECTION_NOT_FOUND: "MarketingProjection '{projectionId}' not found",
-  PLAN_ALREADY_EXISTS: "Plan '{planKey}' already exists in project '{projectKey}'",
-  BUNDLE_ALREADY_EXISTS: "Bundle '{bundleKey}' already exists in project '{projectKey}'",
+  PLAN_ALREADY_EXISTS: "Plan '{planKey}' already exists",
+  BUNDLE_ALREADY_EXISTS: "Bundle '{bundleKey}' already exists",
   MARKETING_PROJECTION_ALREADY_EXISTS: "Marketing projection for {targetType}/{targetVersionId}/{locale} already exists \u2014 use PATCH to edit it",
   PLAN_DRAFT_ALREADY_EXISTS: "Plan '{planKey}' already has a draft version v{draftVersion}; publish or discard it first",
   BUNDLE_DRAFT_ALREADY_EXISTS: "Bundle '{bundleKey}' already has a draft version v{draftVersion}; publish or discard it first",
@@ -628,6 +817,8 @@ var ERROR_MESSAGES_EN = {
   BUNDLE_ALREADY_SUBSCRIBED: "Subscription '{subscriptionId}' has already actively booked this bundle.",
   BUNDLE_INCOMPATIBLE_WITH_PLAN: "BundleVersion '{bundleVersionId}' is not compatible with plan '{planKey}'. Allowed: [{allowedPlanKeys}].",
   BUNDLE_NOT_SELF_SERVICE: "Bundle '{bundleKey}' is only activated via a special contract. Please contact the contract manager.",
+  BUNDLE_CYCLE_EXCEEDS_PLAN: "A {billingCycle} bundle cannot run beside a {planCycle} plan: it would still be committed on every day the plan could end.",
+  BUNDLE_NOT_PRICED_FOR_THIS_PLAN: "This bundle has no {billingCycle} price for the {planKey} plan, so it cannot be booked from here.",
   SUBSCRIPTION_BUNDLE_ALREADY_CANCELLED: "SubscriptionBundle '{subscriptionBundleId}' is already cancelled.",
   SUBSCRIPTION_BUNDLE_NOT_CANCELLED: "SubscriptionBundle '{subscriptionBundleId}' is not cancelled.",
   SUBSCRIPTION_BUNDLE_CANCELLATION_EFFECTIVE: "Cancellation already in effect \u2014 book the bundle again.",
@@ -636,7 +827,7 @@ var ERROR_MESSAGES_EN = {
   SUBSCRIPTION_BUNDLE_NOT_FOUND: "SubscriptionBundle '{subscriptionBundleId}' not found",
   TENANT_NOT_FOUND: "Tenant {slug} not found",
   NO_ACTIVE_PLAN_VERSION: "No plan version for {planId} active as of {asOf} \u2014 neither the validFrom window is satisfied nor is a latest-live version available.",
-  PLAN_NOT_IN_CATALOG: 'Plan "{planKey}" is not in the catalog ({projectKey})',
+  PLAN_NOT_IN_CATALOG: 'Plan "{planKey}" is not in the catalog',
   PLAN_NOT_SELF_SERVICE: "{planKey} is not activated via self-service.",
   PLAN_CHANGE_BLOCKED: "Plan change during onboarding is blocked.",
   NO_PENDING_PLAN_VERSION: "There is no pending plan version awaiting confirmation.",
@@ -756,6 +947,8 @@ var ERROR_MESSAGES_DE = {
   BUNDLE_VERSION_SUPERSEDED: "BundleVersion '{bundleVersionId}' wurde durch eine neuere Version abgel\xF6st.",
   BUNDLE_VERSION_REGRESSION: "Diese Bundle-Version ist regressiv (Feature entfernt / Quota gesenkt / Preis erh\xF6ht). Das Ver\xF6ffentlichen erfordert ein ausdr\xFCckliches `forceRegressive: true` (Best\xE4tigungsdialog in der UI mit MFA).",
   BUNDLE_VERSION_ZERO_PRICE: "Eine Bundle-Version l\xE4sst sich nicht mit einem ausdr\xFCcklichen Preis von 0,00 ver\xF6ffentlichen (Schutz vor Seed-Platzhaltern). Kostenlose Bundles l\xE4sst du auf null, oder du setzt allowZeroPrice.",
+  BUNDLE_VERSION_NO_PRICE: "Diese Bundle-Version kann ohne Preis nicht ver\xF6ffentlicht werden: weder ein Grundpreis noch eine Plan-\xDCberschreibung ergibt einen.",
+  BUNDLE_VERSION_NOT_PRICED_FOR_PLAN: "Dieses Bundle wird dem Plan '{planKey}' angeboten, der {billingCycle} verkauft wird, und daf\xFCr ergibt sich kein {billingCycle} Preis \u2014 weder als Grundpreis noch als Plan-\xDCberschreibung.",
   BUNDLE_VERSION_DISCARD_NOT_IMPLEMENTED: "Das Verwerfen ist im aktuellen Repository nicht implementiert. Implementiere BundleRepository.deleteDraft.",
   BUNDLE_VERSION_VALID_FROM_REQUIRED: "Ver\xF6ffentlichte Bundle-Versionen m\xFCssen ein validFrom behalten. Setze ein neues Datum in der Zukunft, oder bearbeite den Entwurf vor dem Ver\xF6ffentlichen.",
   BUNDLE_VERSION_VALID_FROM_INVALID: "validFrom '{validFrom}' ist kein g\xFCltiges Datum",
@@ -769,12 +962,12 @@ var ERROR_MESSAGES_DE = {
   PLAN_VERSION_NOT_FOUND: "PlanVersion '{versionId}' nicht gefunden",
   BUNDLE_NOT_FOUND: "Bundle '{bundleId}' nicht gefunden",
   BUNDLE_VERSION_NOT_FOUND: "BundleVersion '{bundleVersionId}' nicht gefunden",
-  FEATURE_NOT_FOUND: "Feature '{featureKey}' im Projekt '{projectKey}' nicht gefunden",
-  QUOTA_NOT_FOUND: "Quota '{quotaKey}' im Projekt '{projectKey}' nicht gefunden",
+  FEATURE_NOT_FOUND: "Feature '{featureKey}' nicht gefunden",
+  QUOTA_NOT_FOUND: "Quota '{quotaKey}' nicht gefunden",
   PROMOTION_NOT_FOUND: "Promotion '{promotionId}' nicht gefunden",
   MARKETING_PROJECTION_NOT_FOUND: "MarketingProjection '{projectionId}' nicht gefunden",
-  PLAN_ALREADY_EXISTS: "Plan '{planKey}' gibt es im Projekt '{projectKey}' bereits",
-  BUNDLE_ALREADY_EXISTS: "Bundle '{bundleKey}' gibt es im Projekt '{projectKey}' bereits",
+  PLAN_ALREADY_EXISTS: "Plan '{planKey}' gibt es bereits",
+  BUNDLE_ALREADY_EXISTS: "Bundle '{bundleKey}' gibt es bereits",
   MARKETING_PROJECTION_ALREADY_EXISTS: "F\xFCr {targetType}/{targetVersionId}/{locale} gibt es bereits eine Marketing-Projektion \u2014 bearbeite sie per PATCH",
   PLAN_DRAFT_ALREADY_EXISTS: "Plan '{planKey}' hat bereits die Entwurfsversion v{draftVersion}; ver\xF6ffentliche oder verwirf sie zuerst",
   BUNDLE_DRAFT_ALREADY_EXISTS: "Bundle '{bundleKey}' hat bereits die Entwurfsversion v{draftVersion}; ver\xF6ffentliche oder verwirf sie zuerst",
@@ -788,6 +981,8 @@ var ERROR_MESSAGES_DE = {
   BUNDLE_ALREADY_SUBSCRIBED: "Abonnement '{subscriptionId}' hat dieses Bundle bereits aktiv gebucht.",
   BUNDLE_INCOMPATIBLE_WITH_PLAN: "BundleVersion '{bundleVersionId}' passt nicht zum Plan '{planKey}'. Erlaubt: [{allowedPlanKeys}].",
   BUNDLE_NOT_SELF_SERVICE: "Bundle '{bundleKey}' wird nur \xFCber einen Sondervertrag freigeschaltet. Bitte wende dich an die Vertragsverwaltung.",
+  BUNDLE_CYCLE_EXCEEDS_PLAN: "Ein {billingCycle} abgerechnetes Bundle passt nicht zu einem {planCycle} abgerechneten Plan: es w\xE4re an jedem Tag gebunden, an dem der Plan enden kann.",
+  BUNDLE_NOT_PRICED_FOR_THIS_PLAN: "F\xFCr dieses Bundle ist im Plan {planKey} kein {billingCycle} Preis hinterlegt, es kann hier deshalb nicht gebucht werden.",
   SUBSCRIPTION_BUNDLE_ALREADY_CANCELLED: "SubscriptionBundle '{subscriptionBundleId}' ist bereits gek\xFCndigt.",
   SUBSCRIPTION_BUNDLE_NOT_CANCELLED: "SubscriptionBundle '{subscriptionBundleId}' ist nicht gek\xFCndigt.",
   SUBSCRIPTION_BUNDLE_CANCELLATION_EFFECTIVE: "Die K\xFCndigung ist bereits wirksam \u2014 buche das Bundle einfach neu.",
@@ -796,7 +991,7 @@ var ERROR_MESSAGES_DE = {
   SUBSCRIPTION_BUNDLE_NOT_FOUND: "SubscriptionBundle '{subscriptionBundleId}' nicht gefunden",
   TENANT_NOT_FOUND: "Mandant {slug} nicht gefunden",
   NO_ACTIVE_PLAN_VERSION: "Zum {asOf} ist keine Planversion f\xFCr {planId} aktiv \u2014 weder ist das validFrom-Fenster erf\xFCllt, noch steht eine j\xFCngste Live-Version bereit.",
-  PLAN_NOT_IN_CATALOG: 'Plan "{planKey}" steht nicht im Katalog ({projectKey})',
+  PLAN_NOT_IN_CATALOG: 'Plan "{planKey}" steht nicht im Katalog',
   PLAN_NOT_SELF_SERVICE: "{planKey} wird nicht per Self-Service freigeschaltet.",
   PLAN_CHANGE_BLOCKED: "W\xE4hrend des Onboardings ist ein Planwechsel gesperrt.",
   NO_PENDING_PLAN_VERSION: "Es wartet keine Planversion auf eine Best\xE4tigung.",
@@ -857,8 +1052,10 @@ var ERROR_MESSAGES_DE = {
   [FEATURE_NOT_LICENSED]: "Das Feature {featureKeys} ist im aktuellen Plan nicht enthalten."
 };
 export {
+  ACTIVE_SUBSCRIPTION_CONTRACT_STATUSES,
   AUTH_ERROR_CODES,
   BILLING_ERROR_CODES,
+  BUNDLE_PRICE_LOOKUP_LIMIT,
   CATALOG_ERROR_CODES,
   CONTRACT_ERROR_CODES,
   ERROR_MESSAGES_DE,
@@ -887,19 +1084,28 @@ export {
   buildActivePlanVersionWhere,
   buildActiveVersionWhere,
   buildFeatureRequiresIndex,
+  bundleDraftDefaults,
+  bundleStemDefaults,
   classifyBundleVersionDiff,
   classifyPlanDiff,
   collectUnsatisfiedRequires,
   coverageExcludingSelf,
+  definedFields,
   formatErrorMessage,
   isBundleRedundant,
   isPlatformUserExistsError,
   isVersionEditable,
   missingRequiresFor,
   pickActivePromo,
+  previousUtcDay,
   promoStatus,
   resolveBundleAvailability,
   resolveErrorMessage,
   selectChargeableBundles,
-  startOfUtcDay
+  startOfUtcDay,
+  toBundleStemRow,
+  toContractLineItemRecord,
+  toPlanRow,
+  toPlanVersionRow,
+  toSubscriptionContractRecord
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/core",
-  "version": "1.0.0-rc.6",
+  "version": "1.0.0-rc.7",
   "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",