@saasicat/nest 1.0.0-rc.8 → 1.0.0-rc.9

package/dist/.build-stamp

@@ -1 +1 @@
-89d783a28230b3a9b77ff0cb7706f96197daa84bc359f5d1d8f0d643d33beffc
+aec99b9d672b86bd7310c62f4ec0587e8708c675222a1792a640af85a8cdd6b2

package/dist/_entries.cjs

@@ -1639,6 +1639,7 @@ __export(billing_exports, {
   FEATURE_GUARD_MARKER: () => FEATURE_GUARD_MARKER,
   FeatureGuard: () => FeatureGuard,
   LimitExceededFilter: () => LimitExceededFilter,
+  NO_NOTICE_PERIOD: () => NO_NOTICE_PERIOD,
   PENDING_PLAN_QUERY_PORT_TOKEN: () => PENDING_PLAN_QUERY_PORT_TOKEN,
   PLAN_CATALOG_IMPORT_SINK_TOKEN: () => PLAN_CATALOG_IMPORT_SINK_TOKEN,
   PLAN_CATALOG_READ_SINK_TOKEN: () => PLAN_CATALOG_READ_SINK_TOKEN,
@@ -1954,9 +1955,12 @@ function decideCancellation(input) {
   };
 }
 __name(decideCancellation, "decideCancellation");
+var NO_NOTICE_PERIOD = {
+  monthly: 0,
+  yearly: 0
+};
 function noticeDaysFor(periods, billingCycle) {
-  if (!periods) return 0;
-  return (billingCycle === "YEARLY" ? periods.yearly : periods.monthly) ?? 0;
+  return billingCycle === "YEARLY" ? periods.yearly : periods.monthly;
 }
 __name(noticeDaysFor, "noticeDaysFor");
 function decideCancellationFor(sub, now, noticePeriodDays) {
@@ -2144,6 +2148,7 @@ function buildPlanCatalogFromSnapshot(settings, snapshot) {
     app: settings.app,
     currency: settings.currency,
     vatRate: settings.vatRate,
+    tenantBilling: settings.tenantBilling,
     ...settings.marketing ? {
       marketing: settings.marketing
     } : {},
@@ -2183,6 +2188,7 @@ var PlanCatalogModule = class _PlanCatalogModule {
               app: options.app,
               currency: options.currency,
               vatRate: options.vatRate,
+              tenantBilling: options.tenantBilling,
               marketing: options.marketing
             }, snapshot);
           }, "useFactory"),
@@ -3174,6 +3180,13 @@ var import_js_yaml = __toESM(require("js-yaml"), 1);
 var import__ = __toESM(require("ajv/dist/2020.js"), 1);
 var import_ajv_formats = __toESM(require("ajv-formats"), 1);
 var import_spec = require("@saasicat/spec");
+function locate(error) {
+  const segments = (error.instancePath ?? "").split("/").filter(Boolean);
+  const missing = error.params?.missingProperty;
+  if (missing) segments.push(missing);
+  return segments.length > 0 ? segments.join(".") : "(document root)";
+}
+__name(locate, "locate");
 var PLAN_CATALOG_UNREADABLE_ERROR = "PlanCatalogUnreadableError";
 var PlanCatalogValidationError = class extends Error {
   static {
@@ -3182,7 +3195,7 @@ var PlanCatalogValidationError = class extends Error {
   source;
   errors;
   constructor(source, errors) {
-    const messages = errors.map((e) => `${e.instancePath || "/"}: ${e.message ?? "unknown"}`).join("\n  ");
+    const messages = errors.map((e) => `${locate(e)}: ${e.message ?? "unknown"}`).join("\n  ");
     super(`Plan catalog validation failed for ${source}:
   ${messages}`), this.source = source, this.errors = errors;
     this.name = "PlanCatalogValidationError";
@@ -6128,7 +6141,7 @@ var TenantBillingController = class _TenantBillingController {
   contractFreeze;
   trialProjection;
   cancellationNoticeDays;
-  constructor(entitlements, planPreview, subscriptionUsage, usageSnapshot, subscriptionWrite, tenantIdResolver = null, userIdResolver = null, blockedPlans = null, promoCodes = null, auditService = null, userEmailResolver = null, auditContextResolver = null, subscriptionBundles = null, contractFreeze = null, trialProjection = null, cancellationNoticeDays = {}) {
+  constructor(entitlements, planPreview, subscriptionUsage, usageSnapshot, subscriptionWrite, tenantIdResolver = null, userIdResolver = null, blockedPlans = null, promoCodes = null, auditService = null, userEmailResolver = null, auditContextResolver = null, subscriptionBundles = null, contractFreeze = null, trialProjection = null, cancellationNoticeDays = NO_NOTICE_PERIOD) {
     this.entitlements = entitlements;
     this.planPreview = planPreview;
     this.subscriptionUsage = subscriptionUsage;
@@ -6951,6 +6964,7 @@ TenantBillingController = _ts_decorate35([
 
 // src/billing/tenant-billing.module.ts
 var import_common35 = require("@nestjs/common");
+var import_spec2 = require("@saasicat/spec");
 function _ts_decorate36(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);
@@ -6958,6 +6972,27 @@ function _ts_decorate36(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate36, "_ts_decorate");
+function settingFromCatalog(catalog, key) {
+  const settings = catalog.tenantBilling;
+  const value = settings?.[key];
+  if (value === void 0) {
+    throw new Error(`The plan catalogue carries no tenantBilling.${key}. It is a required section of config/saas.yaml and the loader refuses a file without it, so a catalogue that reaches here without one was built in code: check the \`dbCatalog\` block, which forwards \`tenantBilling\` from that same file, or the object passed to \`planCatalog\`.`);
+  }
+  return value;
+}
+__name(settingFromCatalog, "settingFromCatalog");
+var MOVED_TO_THE_FILE = Object.keys(import_spec2.planCatalogSchema.properties?.tenantBilling?.properties ?? // Refuses to guess rather than falling back to an empty list: an empty
+// one would turn this guard off without saying so.
+(() => {
+  throw new Error("plan-catalog.schema.json declares no tenantBilling properties \u2014 @saasicat/spec and @saasicat/nest are out of step.");
+})());
+function assertNoMovedOptions(options) {
+  const given = options;
+  const passed = MOVED_TO_THE_FILE.filter((key) => given[key] !== void 0);
+  if (passed.length === 0) return;
+  throw new Error(`TenantBillingModule.forRoot() no longer accepts ${passed.join(" and ")} \u2014 this moved to config/saas.yaml under \`tenantBilling:\`. Move the value there (both members of each setting are required) and delete it here. The file is the one place these live, so a fallback here would be the second home that change exists to close. See docs/guides/upgrade-to-1.0.md.`);
+}
+__name(assertNoMovedOptions, "assertNoMovedOptions");
 var TenantBillingModule = class _TenantBillingModule {
   static {
     __name(this, "TenantBillingModule");
@@ -6972,18 +7007,20 @@ var TenantBillingModule = class _TenantBillingModule {
       TenantAdminGuard,
       PlanChangePreviewService
     ];
-    if (options.cancellationNoticeDays) {
-      providers.push({
-        provide: CANCELLATION_NOTICE_DAYS_TOKEN,
-        useValue: options.cancellationNoticeDays
-      });
-    }
-    if (options.selfServiceBlockedPlans) {
-      providers.push({
-        provide: SELF_SERVICE_BLOCKED_PLANS_TOKEN,
-        useValue: options.selfServiceBlockedPlans
-      });
-    }
+    assertNoMovedOptions(options);
+    providers.push({
+      provide: CANCELLATION_NOTICE_DAYS_TOKEN,
+      useFactory: /* @__PURE__ */ __name((catalog) => settingFromCatalog(catalog, "cancellationNoticeDays"), "useFactory"),
+      inject: [
+        PLAN_CATALOG_TOKEN
+      ]
+    }, {
+      provide: SELF_SERVICE_BLOCKED_PLANS_TOKEN,
+      useFactory: /* @__PURE__ */ __name((catalog) => settingFromCatalog(catalog, "selfServiceBlockedPlans"), "useFactory"),
+      inject: [
+        PLAN_CATALOG_TOKEN
+      ]
+    });
     if (options.subscriptionBundleRepository) {
       providers.push(asProvider(SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, options.subscriptionBundleRepository));
     }
@@ -14569,7 +14606,7 @@ var RULE_SPECS = [
     id: "catalog.identity-or-sink",
     when: /* @__PURE__ */ __name((c) => !c.options.planCatalog, "when"),
     assert: /* @__PURE__ */ __name((c) => Boolean(c.adapters.planCatalogReadSink && c.options.dbCatalog), "assert"),
-    message: "no plan catalogue is reachable. Either set `planCatalog` (the quickstart YAML path) or, for DB hydration, BOTH a `planCatalogReadSink` (via `adapters` or `persistence`) AND `dbCatalog` ({ app, currency, vatRate }). Without the identity the app boots with a silently empty catalogue."
+    message: "no plan catalogue is reachable. Either set `planCatalog` (the quickstart YAML path) or, for DB hydration, BOTH a `planCatalogReadSink` (via `adapters` or `persistence`) AND `dbCatalog` ({ app, currency, vatRate, tenantBilling }). Without the identity the app boots with a silently empty catalogue."
   },
   {
     id: "catalog.app-is-named",
@@ -16220,6 +16257,7 @@ function composePlanCatalog(options, sink) {
     app: dbCatalog.app,
     currency: dbCatalog.currency,
     vatRate: dbCatalog.vatRate,
+    tenantBilling: dbCatalog.tenantBilling,
     marketing: dbCatalog.marketing,
     sink,
     imports: options.imports
@@ -18659,6 +18697,7 @@ __export(src_exports, {
   MarketingSettingsService: () => MarketingSettingsService,
   MfaGuard: () => MfaGuard,
   MfaService: () => MfaService,
+  NO_NOTICE_PERIOD: () => NO_NOTICE_PERIOD,
   PASSWORD_HASHER_TOKEN: () => PASSWORD_HASHER_TOKEN,
   PAYMENT_EVENT_LOG_TOKEN: () => PAYMENT_EVENT_LOG_TOKEN,
   PAYMENT_PROVIDER_TOKEN: () => PAYMENT_PROVIDER_TOKEN,

package/dist/billing/index.d.cts

@@ -1,18 +1,18 @@
 import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalog, PlanCatalogReadSink, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, ConfiguratorSourcesLookup, ConfiguratorMarketingProvider, ConfiguratorCatalog } from '@saasicat/core';
-export { BundleVersionFields, ChangeDirection, DiffResult, PlanVersionFields, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
-import { F as FEATURE_GUARD_MARKER, j as ContractFreezePort, k as ContractFreezeSourcePort } from '../tenant-billing.module-BVXDucZj.cjs';
-export { A as AUDIT_CONTEXT_RESOLVER_TOKEN, a as AuditContextResolver, b as AuthGuardList, C as CANCELLATION_NOTICE_DAYS_TOKEN, c as CONTRACT_FREEZE_PORT_TOKEN, d as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, e as CancellableSubscription, f as CancellationDecision, g as CancellationInput, h as CancellationNoticePeriods, i as ContractFreezeBundleSnapshot, D as DuePendingPlanChange, M as MarkedFeatureGuard, P as PENDING_PLAN_QUERY_PORT_TOKEN, l as PendingPlanQueryPort, S as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, m as SELF_SERVICE_BLOCKED_PLANS_TOKEN, n as SUBSCRIPTION_USAGE_PORT_TOKEN, o as SUBSCRIPTION_WRITE_PORT_TOKEN, p as SelfServiceBlockedBundles, q as SelfServiceBlockedPlans, r as SubscriptionBundleControllerOptions, s as SubscriptionBundleModule, t as SubscriptionBundleModuleOptions, T as TENANT_AUTH_GUARDS_TOKEN, u as TENANT_ID_RESOLVER_TOKEN, v as TRIAL_PROJECTION_PORT_TOKEN, w as TenantBillingModule, x as TenantBillingModuleOptions, y as TenantIdResolver, z as TrialProjectionInput, B as TrialProjectionPort, U as USAGE_SNAPSHOT_PORT_TOKEN, E as USER_EMAIL_RESOLVER_TOKEN, G as USER_ID_RESOLVER_TOKEN, H as UserEmailResolver, I as UserIdResolver, J as decideCancellation, K as decideCancellationFor, L as isPlatformFeatureGuard, N as noticeDaysFor } from '../tenant-billing.module-BVXDucZj.cjs';
+export { BundleVersionFields, CancellationNoticePeriods, ChangeDirection, DiffResult, PlanVersionFields, SelfServiceBlockedPlans, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
+export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as CancellableSubscription, c as CancellationDecision, d as CancellationInput, e as ChangePlanDto, f as CompleteOnboardingSubscriptionDto, g as ComposedTenantAuthGuard, h as CycleDirection, L as LimitsCheckRow, N as NO_NOTICE_PERIOD, P as PendingPlanMaterializationService, i as PlanChangeContext, j as PlanChangePreviewDto, k as PlanChangePreviewIssue, l as PlanChangePreviewService, m as PlanChangeType, n as PlanDirection, o as PlanSnapshotDto, p as PreviewPlanChangeDto, q as ProrationDto, r as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, s as SubscriptionBundleCancelPreviewDto, t as SubscriptionBundleConfig, u as SubscriptionBundlePreviewContext, v as SubscriptionBundlePreviewIssue, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController, U as UsageResponse, z as addMonths, D as clampToParent, E as computeProration, F as decideCancellation, G as decideCancellationFor, H as noticeDaysFor, I as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-BqYJjjRi.cjs';
+import { F as FEATURE_GUARD_MARKER, f as ContractFreezePort, g as ContractFreezeSourcePort } from '../tenant-billing.module-D96e9tYP.cjs';
+export { A as AUDIT_CONTEXT_RESOLVER_TOKEN, a as AuditContextResolver, b as AuthGuardList, C as CANCELLATION_NOTICE_DAYS_TOKEN, c as CONTRACT_FREEZE_PORT_TOKEN, d as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, e as ContractFreezeBundleSnapshot, D as DuePendingPlanChange, M as MarkedFeatureGuard, P as PENDING_PLAN_QUERY_PORT_TOKEN, h as PendingPlanQueryPort, S as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, i as SELF_SERVICE_BLOCKED_PLANS_TOKEN, j as SUBSCRIPTION_USAGE_PORT_TOKEN, k as SUBSCRIPTION_WRITE_PORT_TOKEN, l as SelfServiceBlockedBundles, m as SubscriptionBundleControllerOptions, n as SubscriptionBundleModule, o as SubscriptionBundleModuleOptions, T as TENANT_AUTH_GUARDS_TOKEN, p as TENANT_ID_RESOLVER_TOKEN, q as TRIAL_PROJECTION_PORT_TOKEN, r as TenantBillingModule, s as TenantBillingModuleOptions, t as TenantIdResolver, u as TrialProjectionInput, v as TrialProjectionPort, U as USAGE_SNAPSHOT_PORT_TOKEN, w as USER_EMAIL_RESOLVER_TOKEN, x as USER_ID_RESOLVER_TOKEN, y as UserEmailResolver, z as UserIdResolver, B as isPlatformFeatureGuard } from '../tenant-billing.module-D96e9tYP.cjs';
 import * as _nestjs_common from '@nestjs/common';
 import { CanActivate, ExecutionContext, ArgumentsHost, Type, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
 export { Type as NestType } from '@nestjs/common';
 import { Reflector, BaseExceptionFilter } from '@nestjs/core';
 import { c as EntitlementService } from '../aggregation-Bsg1g9Q0.cjs';
 import { P as ProviderSpec } from '../di-CcNeq9v-.cjs';
-export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as ChangePlanDto, c as CompleteOnboardingSubscriptionDto, d as ComposedTenantAuthGuard, e as CycleDirection, L as LimitsCheckRow, P as PendingPlanMaterializationService, f as PlanChangeContext, g as PlanChangePreviewDto, h as PlanChangePreviewIssue, i as PlanChangePreviewService, j as PlanChangeType, k as PlanDirection, l as PlanSnapshotDto, m as PreviewPlanChangeDto, n as ProrationDto, o as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, p as SubscriptionBundleCancelPreviewDto, q as SubscriptionBundleConfig, r as SubscriptionBundlePreviewContext, s as SubscriptionBundlePreviewIssue, t as SubscriptionBundlePreviewService, u as SubscriptionBundlesService, T as TenantAdminGuard, v as TenantBillingController, U as UsageResponse, w as addMonths, x as clampToParent, y as computeProration, z as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-DElYt3Aa.cjs';
 import { S as SubscriptionContractService } from '../subscription-contract.service-hD87MKyg.cjs';
-import '../plan-resolution-CwUy_OqC.cjs';
 import '../promo.service-BJbKAmw3.cjs';
 import '../admin-audit.service-4P3Djdxk.cjs';
+import '../plan-resolution-CwUy_OqC.cjs';
 
 /**
  * One period onwards, on `anchorDay` where the month has one.
@@ -550,6 +550,9 @@ interface AjvErrorLike {
     instancePath?: string;
     message?: string;
     schemaPath?: string;
+    params?: {
+        missingProperty?: string;
+    };
 }
 /**
  * `Error.name` for a document that could not be read as a catalog at all.
@@ -603,6 +606,12 @@ interface PlanCatalogModuleOptions {
     app: PlanCatalog['app'];
     currency: string;
     vatRate: number;
+    /**
+     * Commercial self-service settings from `config/saas.yaml#tenantBilling`.
+     * The read sink loads plans and features; settings are never in the
+     * database, so they can only come from the file.
+     */
+    tenantBilling: PlanCatalog['tenantBilling'];
     /**
      * App-wide marketing configuration — including the
      * `availableLocales` pool. Flows into `PLAN_CATALOG_TOKEN.marketing`
@@ -633,6 +642,12 @@ interface PlanCatalogBuildSettings {
     app: PlanCatalog['app'];
     currency: string;
     vatRate: number;
+    /**
+     * Commercial self-service settings from `config/saas.yaml#tenantBilling`.
+     * Required, like the two above: the database carries plans and features,
+     * never the settings, so this can only come from the file.
+     */
+    tenantBilling: PlanCatalog['tenantBilling'];
     /** App-wide marketing configuration. Optional. */
     marketing?: PlanCatalog['marketing'];
 }

package/dist/billing/index.d.ts

@@ -1,18 +1,18 @@
 import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalog, PlanCatalogReadSink, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, ConfiguratorSourcesLookup, ConfiguratorMarketingProvider, ConfiguratorCatalog } from '@saasicat/core';
-export { BundleVersionFields, ChangeDirection, DiffResult, PlanVersionFields, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
-import { F as FEATURE_GUARD_MARKER, j as ContractFreezePort, k as ContractFreezeSourcePort } from '../tenant-billing.module-C7rgy1jA.js';
-export { A as AUDIT_CONTEXT_RESOLVER_TOKEN, a as AuditContextResolver, b as AuthGuardList, C as CANCELLATION_NOTICE_DAYS_TOKEN, c as CONTRACT_FREEZE_PORT_TOKEN, d as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, e as CancellableSubscription, f as CancellationDecision, g as CancellationInput, h as CancellationNoticePeriods, i as ContractFreezeBundleSnapshot, D as DuePendingPlanChange, M as MarkedFeatureGuard, P as PENDING_PLAN_QUERY_PORT_TOKEN, l as PendingPlanQueryPort, S as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, m as SELF_SERVICE_BLOCKED_PLANS_TOKEN, n as SUBSCRIPTION_USAGE_PORT_TOKEN, o as SUBSCRIPTION_WRITE_PORT_TOKEN, p as SelfServiceBlockedBundles, q as SelfServiceBlockedPlans, r as SubscriptionBundleControllerOptions, s as SubscriptionBundleModule, t as SubscriptionBundleModuleOptions, T as TENANT_AUTH_GUARDS_TOKEN, u as TENANT_ID_RESOLVER_TOKEN, v as TRIAL_PROJECTION_PORT_TOKEN, w as TenantBillingModule, x as TenantBillingModuleOptions, y as TenantIdResolver, z as TrialProjectionInput, B as TrialProjectionPort, U as USAGE_SNAPSHOT_PORT_TOKEN, E as USER_EMAIL_RESOLVER_TOKEN, G as USER_ID_RESOLVER_TOKEN, H as UserEmailResolver, I as UserIdResolver, J as decideCancellation, K as decideCancellationFor, L as isPlatformFeatureGuard, N as noticeDaysFor } from '../tenant-billing.module-C7rgy1jA.js';
+export { BundleVersionFields, CancellationNoticePeriods, ChangeDirection, DiffResult, PlanVersionFields, SelfServiceBlockedPlans, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
+export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as CancellableSubscription, c as CancellationDecision, d as CancellationInput, e as ChangePlanDto, f as CompleteOnboardingSubscriptionDto, g as ComposedTenantAuthGuard, h as CycleDirection, L as LimitsCheckRow, N as NO_NOTICE_PERIOD, P as PendingPlanMaterializationService, i as PlanChangeContext, j as PlanChangePreviewDto, k as PlanChangePreviewIssue, l as PlanChangePreviewService, m as PlanChangeType, n as PlanDirection, o as PlanSnapshotDto, p as PreviewPlanChangeDto, q as ProrationDto, r as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, s as SubscriptionBundleCancelPreviewDto, t as SubscriptionBundleConfig, u as SubscriptionBundlePreviewContext, v as SubscriptionBundlePreviewIssue, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController, U as UsageResponse, z as addMonths, D as clampToParent, E as computeProration, F as decideCancellation, G as decideCancellationFor, H as noticeDaysFor, I as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-DhNqJDoU.js';
+import { F as FEATURE_GUARD_MARKER, f as ContractFreezePort, g as ContractFreezeSourcePort } from '../tenant-billing.module-ZBfERe3L.js';
+export { A as AUDIT_CONTEXT_RESOLVER_TOKEN, a as AuditContextResolver, b as AuthGuardList, C as CANCELLATION_NOTICE_DAYS_TOKEN, c as CONTRACT_FREEZE_PORT_TOKEN, d as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, e as ContractFreezeBundleSnapshot, D as DuePendingPlanChange, M as MarkedFeatureGuard, P as PENDING_PLAN_QUERY_PORT_TOKEN, h as PendingPlanQueryPort, S as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, i as SELF_SERVICE_BLOCKED_PLANS_TOKEN, j as SUBSCRIPTION_USAGE_PORT_TOKEN, k as SUBSCRIPTION_WRITE_PORT_TOKEN, l as SelfServiceBlockedBundles, m as SubscriptionBundleControllerOptions, n as SubscriptionBundleModule, o as SubscriptionBundleModuleOptions, T as TENANT_AUTH_GUARDS_TOKEN, p as TENANT_ID_RESOLVER_TOKEN, q as TRIAL_PROJECTION_PORT_TOKEN, r as TenantBillingModule, s as TenantBillingModuleOptions, t as TenantIdResolver, u as TrialProjectionInput, v as TrialProjectionPort, U as USAGE_SNAPSHOT_PORT_TOKEN, w as USER_EMAIL_RESOLVER_TOKEN, x as USER_ID_RESOLVER_TOKEN, y as UserEmailResolver, z as UserIdResolver, B as isPlatformFeatureGuard } from '../tenant-billing.module-ZBfERe3L.js';
 import * as _nestjs_common from '@nestjs/common';
 import { CanActivate, ExecutionContext, ArgumentsHost, Type, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
 export { Type as NestType } from '@nestjs/common';
 import { Reflector, BaseExceptionFilter } from '@nestjs/core';
 import { c as EntitlementService } from '../aggregation-53yv4-rr.js';
 import { P as ProviderSpec } from '../di-CcNeq9v-.js';
-export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as ChangePlanDto, c as CompleteOnboardingSubscriptionDto, d as ComposedTenantAuthGuard, e as CycleDirection, L as LimitsCheckRow, P as PendingPlanMaterializationService, f as PlanChangeContext, g as PlanChangePreviewDto, h as PlanChangePreviewIssue, i as PlanChangePreviewService, j as PlanChangeType, k as PlanDirection, l as PlanSnapshotDto, m as PreviewPlanChangeDto, n as ProrationDto, o as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, p as SubscriptionBundleCancelPreviewDto, q as SubscriptionBundleConfig, r as SubscriptionBundlePreviewContext, s as SubscriptionBundlePreviewIssue, t as SubscriptionBundlePreviewService, u as SubscriptionBundlesService, T as TenantAdminGuard, v as TenantBillingController, U as UsageResponse, w as addMonths, x as clampToParent, y as computeProration, z as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-CVDMTGx6.js';
 import { S as SubscriptionContractService } from '../subscription-contract.service-hD87MKyg.js';
-import '../plan-resolution-CwUy_OqC.js';
 import '../promo.service-BJbKAmw3.js';
 import '../admin-audit.service-4P3Djdxk.js';
+import '../plan-resolution-CwUy_OqC.js';
 
 /**
  * One period onwards, on `anchorDay` where the month has one.
@@ -550,6 +550,9 @@ interface AjvErrorLike {
     instancePath?: string;
     message?: string;
     schemaPath?: string;
+    params?: {
+        missingProperty?: string;
+    };
 }
 /**
  * `Error.name` for a document that could not be read as a catalog at all.
@@ -603,6 +606,12 @@ interface PlanCatalogModuleOptions {
     app: PlanCatalog['app'];
     currency: string;
     vatRate: number;
+    /**
+     * Commercial self-service settings from `config/saas.yaml#tenantBilling`.
+     * The read sink loads plans and features; settings are never in the
+     * database, so they can only come from the file.
+     */
+    tenantBilling: PlanCatalog['tenantBilling'];
     /**
      * App-wide marketing configuration — including the
      * `availableLocales` pool. Flows into `PLAN_CATALOG_TOKEN.marketing`
@@ -633,6 +642,12 @@ interface PlanCatalogBuildSettings {
     app: PlanCatalog['app'];
     currency: string;
     vatRate: number;
+    /**
+     * Commercial self-service settings from `config/saas.yaml#tenantBilling`.
+     * Required, like the two above: the database carries plans and features,
+     * never the settings, so this can only come from the file.
+     */
+    tenantBilling: PlanCatalog['tenantBilling'];
     /** App-wide marketing configuration. Optional. */
     marketing?: PlanCatalog['marketing'];
 }

package/dist/billing/index.js

@@ -24,7 +24,7 @@ import {
   decideRenewal,
   loadPlanCatalogFromFile,
   loadPlanCatalogFromString
-} from "../chunk-GHIECNF3.js";
+} from "../chunk-FVD4TGER.js";
 import {
   AddSubscriptionBundleDto,
   BILLING_FEATURE_UI_REGISTRY_TOKEN,
@@ -38,6 +38,7 @@ import {
   ComposedTenantAuthGuard,
   DEFAULT_BUNDLE_MINIMUM_TERM_MONTHS,
   FEATURE_GUARD_MARKER,
+  NO_NOTICE_PERIOD,
   PUBLIC_CATALOG_BUNDLE_REPOSITORY_TOKEN,
   PUBLIC_CATALOG_MARKETING_REPOSITORY_TOKEN,
   PendingPlanMaterializationService,
@@ -78,8 +79,8 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "../chunk-TJ5E42WX.js";
-import "../chunk-7JEXCHMU.js";
+} from "../chunk-W67WBRW5.js";
+import "../chunk-6FQ3G4IF.js";
 import "../chunk-F7P2X2DR.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
@@ -104,7 +105,7 @@ import "../chunk-YSC46BGM.js";
 import {
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "../chunk-IW5XGOEU.js";
+} from "../chunk-5LE5AZUP.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
   PLAN_CATALOG_TOKEN,
@@ -119,7 +120,7 @@ import {
   getPlanQuota,
   isFeatureInPlan,
   isFeaturePlannedOnly
-} from "../chunk-UUFUSKX2.js";
+} from "../chunk-H7SF4EUR.js";
 import "../chunk-VBRYPU7V.js";
 import "../chunk-57V6ZTI6.js";
 import "../chunk-OUDSQ3PU.js";
@@ -147,6 +148,7 @@ export {
   FEATURE_GUARD_MARKER,
   FeatureGuard,
   LimitExceededFilter,
+  NO_NOTICE_PERIOD,
   PENDING_PLAN_QUERY_PORT_TOKEN,
   PLAN_CATALOG_IMPORT_SINK_TOKEN,
   PLAN_CATALOG_READ_SINK_TOKEN,

package/dist/{chunk-IW5XGOEU.js → chunk-5LE5AZUP.js}

@@ -1,7 +1,7 @@
 import {
   PLAN_CATALOG_TOKEN,
   isFeaturePlannedOnly
-} from "./chunk-UUFUSKX2.js";
+} from "./chunk-H7SF4EUR.js";
 import {
   SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
 } from "./chunk-VBRYPU7V.js";

package/dist/{chunk-7JEXCHMU.js → chunk-6FQ3G4IF.js}

@@ -3,7 +3,7 @@ import {
   computeIncludedVat,
   getPlanPriceGross,
   round2
-} from "./chunk-UUFUSKX2.js";
+} from "./chunk-H7SF4EUR.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";

package/dist/{chunk-GHIECNF3.js → chunk-FVD4TGER.js}

@@ -4,11 +4,11 @@ import {
   PUBLIC_CATALOG_CATALOG_ENTRY_REPOSITORY_TOKEN,
   REQUIRE_FEATURE_KEY,
   periodEndAfter
-} from "./chunk-TJ5E42WX.js";
+} from "./chunk-W67WBRW5.js";
 import {
   EntitlementService,
   isLimitExceededError
-} from "./chunk-IW5XGOEU.js";
+} from "./chunk-5LE5AZUP.js";
 import {
   ENTITLEMENT_SERVICE_TOKEN
 } from "./chunk-OUDSQ3PU.js";
@@ -401,6 +401,13 @@ import yaml from "js-yaml";
 import Ajv2020 from "ajv/dist/2020.js";
 import addFormats from "ajv-formats";
 import { planCatalogSchema } from "@saasicat/spec";
+function locate(error) {
+  const segments = (error.instancePath ?? "").split("/").filter(Boolean);
+  const missing = error.params?.missingProperty;
+  if (missing) segments.push(missing);
+  return segments.length > 0 ? segments.join(".") : "(document root)";
+}
+__name(locate, "locate");
 var PLAN_CATALOG_UNREADABLE_ERROR = "PlanCatalogUnreadableError";
 var PlanCatalogValidationError = class extends Error {
   static {
@@ -409,7 +416,7 @@ var PlanCatalogValidationError = class extends Error {
   source;
   errors;
   constructor(source, errors) {
-    const messages = errors.map((e) => `${e.instancePath || "/"}: ${e.message ?? "unknown"}`).join("\n  ");
+    const messages = errors.map((e) => `${locate(e)}: ${e.message ?? "unknown"}`).join("\n  ");
     super(`Plan catalog validation failed for ${source}:
   ${messages}`), this.source = source, this.errors = errors;
     this.name = "PlanCatalogValidationError";

package/dist/{chunk-UUFUSKX2.js → chunk-H7SF4EUR.js}

@@ -62,6 +62,7 @@ function buildPlanCatalogFromSnapshot(settings, snapshot) {
     app: settings.app,
     currency: settings.currency,
     vatRate: settings.vatRate,
+    tenantBilling: settings.tenantBilling,
     ...settings.marketing ? {
       marketing: settings.marketing
     } : {},
@@ -102,6 +103,7 @@ var PlanCatalogModule = class _PlanCatalogModule {
               app: options.app,
               currency: options.currency,
               vatRate: options.vatRate,
+              tenantBilling: options.tenantBilling,
               marketing: options.marketing
             }, snapshot);
           }, "useFactory"),

package/dist/{chunk-JNONSUP3.js → chunk-HFQNSOIU.js}

@@ -8,7 +8,7 @@ import {
   PROMO_SUBSCRIPTION_LOOKUP_TOKEN,
   PROMO_TRANSACTION_RUNNER_TOKEN,
   PromoCodesService
-} from "./chunk-7JEXCHMU.js";
+} from "./chunk-6FQ3G4IF.js";
 import {
   AdminAuditService
 } from "./chunk-O2J2HDXA.js";

package/dist/{chunk-DQW3DHSD.js → chunk-KBRELZT4.js}

@@ -1,7 +1,7 @@
 import {
   EntitlementService,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "./chunk-IW5XGOEU.js";
+} from "./chunk-5LE5AZUP.js";
 import {
   SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
 } from "./chunk-VBRYPU7V.js";

package/dist/{chunk-2BNZK22P.js → chunk-OI7P6ZED.js}

@@ -1,6 +1,6 @@
 import {
   PromoCodesModule
-} from "./chunk-JNONSUP3.js";
+} from "./chunk-HFQNSOIU.js";
 import {
   SubscriptionContractModule
 } from "./chunk-L4VVZ4O5.js";
@@ -20,7 +20,7 @@ import {
   SubscriptionBundleModule,
   TenantBillingModule,
   isPlatformFeatureGuard
-} from "./chunk-TJ5E42WX.js";
+} from "./chunk-W67WBRW5.js";
 import {
   CatalogModule
 } from "./chunk-DFQETRBL.js";
@@ -35,15 +35,15 @@ import {
 } from "./chunk-XBYAFEOR.js";
 import {
   EntitlementModule
-} from "./chunk-DQW3DHSD.js";
+} from "./chunk-KBRELZT4.js";
 import {
   LimitExceededError,
   cancellationHasLanded
-} from "./chunk-IW5XGOEU.js";
+} from "./chunk-5LE5AZUP.js";
 import {
   PLAN_CATALOG_TOKEN,
   PlanCatalogModule
-} from "./chunk-UUFUSKX2.js";
+} from "./chunk-H7SF4EUR.js";
 import {
   codedError
 } from "./chunk-57V6ZTI6.js";
@@ -541,7 +541,7 @@ var RULE_SPECS = [
     id: "catalog.identity-or-sink",
     when: /* @__PURE__ */ __name((c) => !c.options.planCatalog, "when"),
     assert: /* @__PURE__ */ __name((c) => Boolean(c.adapters.planCatalogReadSink && c.options.dbCatalog), "assert"),
-    message: "no plan catalogue is reachable. Either set `planCatalog` (the quickstart YAML path) or, for DB hydration, BOTH a `planCatalogReadSink` (via `adapters` or `persistence`) AND `dbCatalog` ({ app, currency, vatRate }). Without the identity the app boots with a silently empty catalogue."
+    message: "no plan catalogue is reachable. Either set `planCatalog` (the quickstart YAML path) or, for DB hydration, BOTH a `planCatalogReadSink` (via `adapters` or `persistence`) AND `dbCatalog` ({ app, currency, vatRate, tenantBilling }). Without the identity the app boots with a silently empty catalogue."
   },
   {
     id: "catalog.app-is-named",
@@ -1615,6 +1615,7 @@ function composePlanCatalog(options, sink) {
     app: dbCatalog.app,
     currency: dbCatalog.currency,
     vatRate: dbCatalog.vatRate,
+    tenantBilling: dbCatalog.tenantBilling,
     marketing: dbCatalog.marketing,
     sink,
     imports: options.imports

package/dist/{chunk-TJ5E42WX.js → chunk-W67WBRW5.js}

@@ -1,6 +1,6 @@
 import {
   PromoCodesService
-} from "./chunk-7JEXCHMU.js";
+} from "./chunk-6FQ3G4IF.js";
 import {
   SubscriptionContractService
 } from "./chunk-F7P2X2DR.js";
@@ -30,13 +30,13 @@ import {
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN,
   cancellationHasLanded,
   toEffectiveLimitsSnapshot
-} from "./chunk-IW5XGOEU.js";
+} from "./chunk-5LE5AZUP.js";
 import {
   PLAN_CATALOG_TOKEN,
   findPlan,
   getMarketedPlans,
   getPlanPriceNet
-} from "./chunk-UUFUSKX2.js";
+} from "./chunk-H7SF4EUR.js";
 import {
   SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
 } from "./chunk-VBRYPU7V.js";
@@ -265,9 +265,12 @@ function decideCancellation(input) {
   };
 }
 __name(decideCancellation, "decideCancellation");
+var NO_NOTICE_PERIOD = {
+  monthly: 0,
+  yearly: 0
+};
 function noticeDaysFor(periods, billingCycle) {
-  if (!periods) return 0;
-  return (billingCycle === "YEARLY" ? periods.yearly : periods.monthly) ?? 0;
+  return billingCycle === "YEARLY" ? periods.yearly : periods.monthly;
 }
 __name(noticeDaysFor, "noticeDaysFor");
 function decideCancellationFor(sub, now, noticePeriodDays) {
@@ -1889,7 +1892,7 @@ var TenantBillingController = class _TenantBillingController {
   contractFreeze;
   trialProjection;
   cancellationNoticeDays;
-  constructor(entitlements, planPreview, subscriptionUsage, usageSnapshot, subscriptionWrite, tenantIdResolver = null, userIdResolver = null, blockedPlans = null, promoCodes = null, auditService = null, userEmailResolver = null, auditContextResolver = null, subscriptionBundles = null, contractFreeze = null, trialProjection = null, cancellationNoticeDays = {}) {
+  constructor(entitlements, planPreview, subscriptionUsage, usageSnapshot, subscriptionWrite, tenantIdResolver = null, userIdResolver = null, blockedPlans = null, promoCodes = null, auditService = null, userEmailResolver = null, auditContextResolver = null, subscriptionBundles = null, contractFreeze = null, trialProjection = null, cancellationNoticeDays = NO_NOTICE_PERIOD) {
     this.entitlements = entitlements;
     this.planPreview = planPreview;
     this.subscriptionUsage = subscriptionUsage;
@@ -2712,6 +2715,7 @@ TenantBillingController = _ts_decorate12([
 
 // src/billing/tenant-billing.module.ts
 import { Module as Module2 } from "@nestjs/common";
+import { planCatalogSchema } from "@saasicat/spec";
 function _ts_decorate13(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);
@@ -2719,6 +2723,27 @@ function _ts_decorate13(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate13, "_ts_decorate");
+function settingFromCatalog(catalog, key) {
+  const settings = catalog.tenantBilling;
+  const value = settings?.[key];
+  if (value === void 0) {
+    throw new Error(`The plan catalogue carries no tenantBilling.${key}. It is a required section of config/saas.yaml and the loader refuses a file without it, so a catalogue that reaches here without one was built in code: check the \`dbCatalog\` block, which forwards \`tenantBilling\` from that same file, or the object passed to \`planCatalog\`.`);
+  }
+  return value;
+}
+__name(settingFromCatalog, "settingFromCatalog");
+var MOVED_TO_THE_FILE = Object.keys(planCatalogSchema.properties?.tenantBilling?.properties ?? // Refuses to guess rather than falling back to an empty list: an empty
+// one would turn this guard off without saying so.
+(() => {
+  throw new Error("plan-catalog.schema.json declares no tenantBilling properties \u2014 @saasicat/spec and @saasicat/nest are out of step.");
+})());
+function assertNoMovedOptions(options) {
+  const given = options;
+  const passed = MOVED_TO_THE_FILE.filter((key) => given[key] !== void 0);
+  if (passed.length === 0) return;
+  throw new Error(`TenantBillingModule.forRoot() no longer accepts ${passed.join(" and ")} \u2014 this moved to config/saas.yaml under \`tenantBilling:\`. Move the value there (both members of each setting are required) and delete it here. The file is the one place these live, so a fallback here would be the second home that change exists to close. See docs/guides/upgrade-to-1.0.md.`);
+}
+__name(assertNoMovedOptions, "assertNoMovedOptions");
 var TenantBillingModule = class _TenantBillingModule {
   static {
     __name(this, "TenantBillingModule");
@@ -2733,18 +2758,20 @@ var TenantBillingModule = class _TenantBillingModule {
       TenantAdminGuard,
       PlanChangePreviewService
     ];
-    if (options.cancellationNoticeDays) {
-      providers.push({
-        provide: CANCELLATION_NOTICE_DAYS_TOKEN,
-        useValue: options.cancellationNoticeDays
-      });
-    }
-    if (options.selfServiceBlockedPlans) {
-      providers.push({
-        provide: SELF_SERVICE_BLOCKED_PLANS_TOKEN,
-        useValue: options.selfServiceBlockedPlans
-      });
-    }
+    assertNoMovedOptions(options);
+    providers.push({
+      provide: CANCELLATION_NOTICE_DAYS_TOKEN,
+      useFactory: /* @__PURE__ */ __name((catalog) => settingFromCatalog(catalog, "cancellationNoticeDays"), "useFactory"),
+      inject: [
+        PLAN_CATALOG_TOKEN
+      ]
+    }, {
+      provide: SELF_SERVICE_BLOCKED_PLANS_TOKEN,
+      useFactory: /* @__PURE__ */ __name((catalog) => settingFromCatalog(catalog, "selfServiceBlockedPlans"), "useFactory"),
+      inject: [
+        PLAN_CATALOG_TOKEN
+      ]
+    });
     if (options.subscriptionBundleRepository) {
       providers.push(asProvider(SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, options.subscriptionBundleRepository));
     }
@@ -3514,6 +3541,7 @@ export {
   bundleCycleFitsPlan,
   computeNextBundlePeriod,
   decideCancellation,
+  NO_NOTICE_PERIOD,
   noticeDaysFor,
   decideCancellationFor,
   FEATURE_GUARD_MARKER,

package/dist/{define-saasicat-DVKyc8oT.d.ts → define-saasicat-DKyoOmEC.d.ts}

@@ -3,7 +3,7 @@ import { ExecutionContext, DynamicModule } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { SuperAdminProvisioningPort, SetupStatusResponse, SetupRequest, SetupResult, SetupConfirmMfaRequest, SetupConfirmMfaResponse } from '@saasicat/core';
 import { h as MfaService } from './admin-stats.service-TYiSUwIR.js';
-import { e as SaaSiCatModuleOptions } from './module-options-DVmppjem.js';
+import { e as SaaSiCatModuleOptions } from './module-options-DF3H6q3A.js';
 
 /**
  * Shared metadata key for endpoints that intentionally run without application

package/dist/{define-saasicat-BrlUxP9g.d.cts → define-saasicat-j-CoHjoG.d.cts}

@@ -3,7 +3,7 @@ import { ExecutionContext, DynamicModule } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { SuperAdminProvisioningPort, SetupStatusResponse, SetupRequest, SetupResult, SetupConfirmMfaRequest, SetupConfirmMfaResponse } from '@saasicat/core';
 import { h as MfaService } from './admin-stats.service-DfKupywR.cjs';
-import { e as SaaSiCatModuleOptions } from './module-options-5-kVLwuv.cjs';
+import { e as SaaSiCatModuleOptions } from './module-options-BDb8Tam7.cjs';
 
 /**
  * Shared metadata key for endpoints that intentionally run without application