@saasicat/nest 0.8.0 → 0.9.0

package/dist/chunk-7K5PT2LX.js

@@ -0,0 +1,211 @@
+import {
+  DiscoverySnapshotNotFoundError,
+  loadDiscoverySnapshotFromFile
+} from "./chunk-ABB2CRAS.js";
+import {
+  ADVISORY_STRICT_MODE_CODES,
+  validateBundleDraft,
+  validatePlanDraft
+} from "./chunk-PBQRPDO2.js";
+import {
+  __name
+} from "./chunk-SHUYVCID.js";
+
+// src/catalog/preflight.ts
+function runPreflight(input) {
+  const findings = [];
+  const approved = input.approved ?? null;
+  for (const pv of input.planVersions) {
+    const warns = validatePlanDraft({
+      features: pv.features,
+      quotas: pv.quotas ?? {}
+    }, input.snapshot, /* @__PURE__ */ new Set(), approved);
+    for (const w of warns) {
+      findings.push({
+        kind: "plan",
+        versionId: pv.id,
+        entityKey: pv.planId,
+        version: pv.version,
+        warning: w
+      });
+    }
+  }
+  for (const bv of input.bundleVersions) {
+    const warns = validateBundleDraft({
+      features: bv.features,
+      quotas: bv.quotas ?? {}
+    }, input.snapshot, null, /* @__PURE__ */ new Set(), approved);
+    for (const w of warns) {
+      findings.push({
+        kind: "bundle",
+        versionId: bv.id,
+        entityKey: bv.bundleKey,
+        version: bv.version,
+        warning: w
+      });
+    }
+  }
+  findings.sort((a, b) => {
+    if (a.kind !== b.kind) return a.kind.localeCompare(b.kind);
+    if (a.entityKey !== b.entityKey) return a.entityKey.localeCompare(b.entityKey);
+    if (a.version !== b.version) return a.version - b.version;
+    return a.warning.code.localeCompare(b.warning.code);
+  });
+  const counts = {
+    planFindings: findings.filter((f) => f.kind === "plan").length,
+    bundleFindings: findings.filter((f) => f.kind === "bundle").length,
+    total: findings.length
+  };
+  const hasBlockingFinding = findings.some((f) => !ADVISORY_STRICT_MODE_CODES.has(f.warning.code));
+  return {
+    overall: hasBlockingFinding ? "error" : "ok",
+    counts,
+    findings
+  };
+}
+__name(runPreflight, "runPreflight");
+function formatPreflightReport(report) {
+  const lines = [];
+  lines.push(`Preflight (Status: ${report.overall.toUpperCase()})`, `  Plans: ${report.counts.planFindings} \xB7 Bundles: ${report.counts.bundleFindings} \xB7 Gesamt: ${report.counts.total}`, "");
+  if (report.findings.length === 0) {
+    lines.push("  \u2713 Keine Strict-Mode-Verst\xF6\xDFe gefunden.");
+    return lines.join("\n");
+  }
+  let lastEntity = "";
+  for (const f of report.findings) {
+    const entityHeader = `${f.kind} ${f.entityKey} v${f.version}`;
+    if (entityHeader !== lastEntity) {
+      lines.push(`  \u2717 ${entityHeader} (${f.versionId})`);
+      lastEntity = entityHeader;
+    }
+    const fieldHint = f.warning.field ? ` [${f.warning.field}]` : "";
+    lines.push(`      ${f.warning.code}${fieldHint}: ${f.warning.message}`);
+  }
+  return lines.join("\n");
+}
+__name(formatPreflightReport, "formatPreflightReport");
+function preflightExitCode(report) {
+  return report.overall === "error" ? 4 : 0;
+}
+__name(preflightExitCode, "preflightExitCode");
+
+// src/catalog/seed-gate.ts
+function validateSeedAgainstSnapshot(input) {
+  const findings = [];
+  for (const plan of input.plans ?? []) {
+    const warns = validatePlanDraft({
+      features: plan.features,
+      quotas: plan.quotas ?? {}
+    }, input.snapshot, /* @__PURE__ */ new Set(), input.approved ?? null);
+    for (const warning of warns) {
+      findings.push({
+        kind: "plan",
+        entityKey: plan.planKey,
+        warning
+      });
+    }
+  }
+  for (const bundle of input.bundles ?? []) {
+    const warns = validateBundleDraft({
+      features: bundle.features,
+      quotas: bundle.quotas ?? {}
+    }, input.snapshot, null, /* @__PURE__ */ new Set(), input.approved ?? null);
+    for (const warning of warns) {
+      findings.push({
+        kind: "bundle",
+        entityKey: bundle.bundleKey,
+        warning
+      });
+    }
+  }
+  findings.sort((a, b) => {
+    if (a.kind !== b.kind) return a.kind.localeCompare(b.kind);
+    if (a.entityKey !== b.entityKey) return a.entityKey.localeCompare(b.entityKey);
+    return a.warning.code.localeCompare(b.warning.code);
+  });
+  const counts = {
+    planFindings: findings.filter((f) => f.kind === "plan").length,
+    bundleFindings: findings.filter((f) => f.kind === "bundle").length,
+    total: findings.length
+  };
+  const hasBlockingFinding = findings.some((f) => !ADVISORY_STRICT_MODE_CODES.has(f.warning.code));
+  return {
+    overall: hasBlockingFinding ? "error" : "ok",
+    counts,
+    findings
+  };
+}
+__name(validateSeedAgainstSnapshot, "validateSeedAgainstSnapshot");
+function formatSeedGateReport(report) {
+  const lines = [];
+  lines.push(`Seed-Gate (Status: ${report.overall.toUpperCase()})`, `  Plans: ${report.counts.planFindings} \xB7 Bundles: ${report.counts.bundleFindings} \xB7 Gesamt: ${report.counts.total}`, "");
+  if (report.findings.length === 0) {
+    lines.push("  \u2713 Alle geseedeten Plan-/Bundle-Features sind discovered (und, sofern gepr\xFCft, approved).");
+    return lines.join("\n");
+  }
+  let lastEntity = "";
+  for (const f of report.findings) {
+    const entityHeader = `${f.kind} ${f.entityKey}`;
+    if (entityHeader !== lastEntity) {
+      lines.push(`  \u2717 ${entityHeader}`);
+      lastEntity = entityHeader;
+    }
+    const fieldHint = f.warning.field ? ` [${f.warning.field}]` : "";
+    lines.push(`      ${f.warning.code}${fieldHint}: ${f.warning.message}`);
+  }
+  return lines.join("\n");
+}
+__name(formatSeedGateReport, "formatSeedGateReport");
+function seedGateExitCode(report) {
+  return report.overall === "error" ? 4 : 0;
+}
+__name(seedGateExitCode, "seedGateExitCode");
+
+// src/catalog/seed-gate-runner.ts
+function runSeedGateFromFile(options) {
+  const mode = options.mode ?? "report-only";
+  const log = options.log ?? ((line) => console.log(line));
+  const warn = options.warn ?? ((line) => console.warn(line));
+  const error = options.error ?? ((line) => console.error(line));
+  const exit = options.exit ?? ((code) => process.exit(code));
+  let snapshot;
+  try {
+    snapshot = loadDiscoverySnapshotFromFile(options.snapshotPath);
+  } catch (err) {
+    if (err instanceof DiscoverySnapshotNotFoundError) {
+      if (mode === "blocking") {
+        error(`[seed-gate] FEHLER: Kein Discovery-Snapshot unter ${options.snapshotPath} \u2014 im blocking-Modus Pflicht (Headless-Scan vor dem Seed ausf\xFChren, #23).`);
+        return exit(4);
+      }
+      warn(`[seed-gate] Kein Discovery-Snapshot unter ${options.snapshotPath} \u2014 \xFCbersprungen (report-only).`);
+      return null;
+    }
+    throw err;
+  }
+  const report = validateSeedAgainstSnapshot({
+    snapshot,
+    plans: options.plans,
+    bundles: options.bundles,
+    approved: options.approved ?? null
+  });
+  log(formatSeedGateReport(report));
+  if (report.overall === "error") {
+    if (mode === "blocking") {
+      error("[seed-gate] blocking: Verst\xF6\xDFe gefunden \u2014 Seed wird abgebrochen (#23).");
+      return exit(seedGateExitCode(report));
+    }
+    warn("[seed-gate] report-only: Verst\xF6\xDFe gefunden, Seed l\xE4uft trotzdem weiter.");
+  }
+  return report;
+}
+__name(runSeedGateFromFile, "runSeedGateFromFile");
+
+export {
+  runPreflight,
+  formatPreflightReport,
+  preflightExitCode,
+  validateSeedAgainstSnapshot,
+  formatSeedGateReport,
+  seedGateExitCode,
+  runSeedGateFromFile
+};

package/dist/{chunk-RZU4HIAN.js → chunk-GW2I3JZD.js}

@@ -25,10 +25,6 @@ import {
   __name
 } from "./chunk-SHUYVCID.js";
 
-// src/billing/subscription-bundles.tokens.ts
-var SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/SubscriptionBundleRepository");
-var SUBSCRIPTION_BUNDLE_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/SubscriptionBundleConfig");
-
 // src/entitlement/aggregation.ts
 function filterActiveSubscriptionBundles(bundles, now) {
   return bundles.filter((b) => b.canceledEffectiveAt === null || b.canceledEffectiveAt > now);
@@ -222,6 +218,24 @@ function assertNoReplacesCycle(index) {
 }
 __name(assertNoReplacesCycle, "assertNoReplacesCycle");
 
+// src/entitlement/plan-resolution.ts
+function resolveEntitlementPlan(input, config, now) {
+  if (input.isPilot && config.pilotEntitlementPlan !== void 0) {
+    return config.pilotEntitlementPlan;
+  }
+  if (input.status === "TRIAL") {
+    return input.trialEntitlementPlan ?? config.defaultTrialEntitlementPlan ?? input.plan;
+  }
+  if (input.status === "PENDING_SALES" && config.pendingSalesEntitlementPlan !== void 0) {
+    return config.pendingSalesEntitlementPlan;
+  }
+  if (input.pendingPlan && input.pendingEffectiveAt && input.pendingEffectiveAt <= now) {
+    return input.pendingPlan;
+  }
+  return input.plan;
+}
+__name(resolveEntitlementPlan, "resolveEntitlementPlan");
+
 // src/entitlement/limit-exceeded-error.ts
 var LIMIT_EXCEEDED = "LIMIT_EXCEEDED";
 var LimitExceededError = class extends Error {
@@ -242,26 +256,14 @@ function isLimitExceededError(err) {
 }
 __name(isLimitExceededError, "isLimitExceededError");
 
-// src/entitlement/plan-resolution.ts
-function resolveEntitlementPlan(input, config, now) {
-  if (input.isPilot && config.pilotEntitlementPlan !== void 0) {
-    return config.pilotEntitlementPlan;
-  }
-  if (input.status === "TRIAL") {
-    return input.trialEntitlementPlan ?? config.defaultTrialEntitlementPlan ?? input.plan;
-  }
-  if (input.status === "PENDING_SALES" && config.pendingSalesEntitlementPlan !== void 0) {
-    return config.pendingSalesEntitlementPlan;
-  }
-  if (input.pendingPlan && input.pendingEffectiveAt && input.pendingEffectiveAt <= now) {
-    return input.pendingPlan;
-  }
-  return input.plan;
-}
-__name(resolveEntitlementPlan, "resolveEntitlementPlan");
-
 // src/entitlement/service.ts
 import { Inject, Injectable, NotFoundException, Optional } from "@nestjs/common";
+
+// src/billing/subscription-bundles.tokens.ts
+var SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/SubscriptionBundleRepository");
+var SUBSCRIPTION_BUNDLE_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/SubscriptionBundleConfig");
+
+// src/entitlement/service.ts
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -552,6 +554,7 @@ var EntitlementModule = class _EntitlementModule {
     return {
       module: _EntitlementModule,
       global: options.global ?? false,
+      imports: options.imports ?? [],
       providers,
       exports: [
         EntitlementService,

package/dist/{chunk-6LP7CDS2.js → chunk-HXAWPPFW.js}

@@ -16,9 +16,6 @@ import {
   USER_EMAIL_RESOLVER_TOKEN,
   USER_ID_RESOLVER_TOKEN
 } from "./chunk-WPUVJRIN.js";
-import {
-  REQUIRE_FEATURE_KEY
-} from "./chunk-Q53N43LQ.js";
 import {
   AdminAuditService
 } from "./chunk-E56W4U2P.js";
@@ -28,7 +25,7 @@ import {
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN,
   isLimitExceededError,
   toEffectiveLimitsSnapshot
-} from "./chunk-RZU4HIAN.js";
+} from "./chunk-GW2I3JZD.js";
 import {
   PLAN_CATALOG_TOKEN,
   findPlan,
@@ -171,6 +168,11 @@ function computeNextPeriod(sub, now) {
 }
 __name(computeNextPeriod, "computeNextPeriod");
 
+// src/billing/require-feature.decorator.ts
+import { SetMetadata } from "@nestjs/common";
+var REQUIRE_FEATURE_KEY = "require-feature";
+var RequireFeature = /* @__PURE__ */ __name((...features) => SetMetadata(REQUIRE_FEATURE_KEY, features), "RequireFeature");
+
 // src/billing/feature-guard.tokens.ts
 var FEATURE_GUARD_CONFIG_TOKEN = /* @__PURE__ */ Symbol("FEATURE_GUARD_CONFIG");
 
@@ -2560,7 +2562,8 @@ var TenantBillingModule = class _TenantBillingModule {
         ] : [],
         ...hasContractFreeze ? [
           CONTRACT_FREEZE_PORT_TOKEN
-        ] : []
+        ] : [],
+        ...options.extraExports ?? []
       ]
     };
   }
@@ -3270,6 +3273,8 @@ export {
   decideRenewal,
   clearPendingPlanVersionFields,
   computeNextPeriod,
+  REQUIRE_FEATURE_KEY,
+  RequireFeature,
   FEATURE_GUARD_CONFIG_TOKEN,
   UPSELL_OFFER_RESOLVER_TOKEN,
   UPSELL_OFFER_CURRENCY_TOKEN,