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

package/dist/.build-stamp

@@ -1 +1 @@
-d2641f050887af0afe7e26844778e4a66660b2f17d7ded07dc67cb60d62c29b0
+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";
@@ -4023,12 +4036,12 @@ var PlanChangePreviewService = class {
     const landsAt = ctx.canceledEffectiveAt ?? ctx.canceledAt;
     if (landsAt !== null && landsAt <= now) {
       blockers.push({
-        code: "SUBSCRIPTION_ENDED",
+        code: import_core17.BILLING_ERROR_CODES.SUBSCRIPTION_ENDED,
         message: "This subscription has ended. Its plan can no longer be changed."
       });
     } else if (landsAt !== null && cycleDirection !== "SAME") {
       blockers.push({
-        code: "CANCELLATION_LOCKS_THE_CYCLE",
+        code: import_core17.BILLING_ERROR_CODES.CANCELLATION_LOCKS_THE_CYCLE,
         message: "This subscription is cancelled, so its billing cycle cannot change. The plan can."
       });
     }
@@ -4036,47 +4049,74 @@ var PlanChangePreviewService = class {
     const blockedSources = this.blockedPlans?.asSource ?? [];
     if (blockedTargets.includes(targetPlan)) {
       blockers.push({
-        code: `${targetPlan}_NOT_SELF_SERVICE`,
-        message: `${targetSnap.name} is only activated via a special contract. Please contact the contract manager.`
+        code: import_core17.BILLING_ERROR_CODES.PLAN_NOT_SELF_SERVICE,
+        message: `${targetSnap.name} is only activated via a special contract. Please contact the contract manager.`,
+        params: {
+          planName: targetSnap.name,
+          planKey: targetPlan
+        }
       });
     }
     if (blockedSources.includes(sub.plan)) {
       blockers.push({
-        code: `${sub.plan}_LOCKED`,
-        message: `Active ${currentSnap.name} special contract \u2014 please contact the contract manager to change plans.`
+        code: import_core17.BILLING_ERROR_CODES.PLAN_LOCKED,
+        message: `Active ${currentSnap.name} special contract \u2014 please contact the contract manager to change plans.`,
+        params: {
+          planName: currentSnap.name,
+          planKey: sub.plan
+        }
       });
     }
     for (const [key, row] of Object.entries(limitsCheck)) {
       if (!row.exceeded) continue;
       const usedDisplay = isFloatQuota(key) ? row.used.toFixed(1) : row.used.toString();
       blockers.push({
-        code: `${key.toUpperCase()}_OVER_TARGET`,
-        message: `Current usage ${usedDisplay} exceeds the target limit ${row.targetMax} (${key}) in the ${targetSnap.name} plan. Please reduce usage first.`
+        code: import_core17.BILLING_ERROR_CODES.QUOTA_OVER_TARGET,
+        message: `Current usage ${usedDisplay} exceeds the target limit ${row.targetMax} (${key}) in the ${targetSnap.name} plan. Please reduce usage first.`,
+        params: {
+          used: usedDisplay,
+          targetMax: row.targetMax,
+          quotaKey: key,
+          planName: targetSnap.name
+        }
       });
     }
     if (featuresLost.length > 0) {
       warnings.push({
-        code: "FEATURES_LOST",
-        message: `Switching means losing access to ${featuresLost.length} feature${featuresLost.length === 1 ? "" : "s"}. Existing data is retained and never deleted \u2014 upgrading again unlocks it.`
+        code: featuresLost.length === 1 ? import_core17.BILLING_ERROR_CODES.FEATURE_LOST : import_core17.BILLING_ERROR_CODES.FEATURES_LOST,
+        message: `Switching means losing access to ${featuresLost.length} feature${featuresLost.length === 1 ? "" : "s"}. Existing data is retained and never deleted \u2014 upgrading again unlocks it.`,
+        params: {
+          count: featuresLost.length
+        }
       });
     }
     if (changeType === "NOOP") {
       warnings.push({
-        code: "NO_CHANGE",
+        code: import_core17.BILLING_ERROR_CODES.NO_CHANGE,
         message: "Target plan and billing cycle already match the current state."
       });
     }
     if (planDirection === "UP" && cycleDirection === "SHORTER") {
       warnings.push({
-        code: "CYCLE_SHORTENS_AT_TERM_END",
-        message: `A ${targetCycle.toLowerCase()} ${targetSnap.name} cannot start inside the ${sub.billingCycle.toLowerCase()} term you are in. The upgrade takes effect when that term ends; to have it today, keep the ${sub.billingCycle.toLowerCase()} cycle.`
+        code: import_core17.BILLING_ERROR_CODES.CYCLE_SHORTENS_AT_TERM_END,
+        message: `A ${targetCycle.toLowerCase()} ${targetSnap.name} cannot start inside the ${sub.billingCycle.toLowerCase()} term you are in. The upgrade takes effect when that term ends; to have it today, keep the ${sub.billingCycle.toLowerCase()} cycle.`,
+        params: {
+          targetCycle: targetCycle.toLowerCase(),
+          currentCycle: sub.billingCycle.toLowerCase(),
+          planName: targetSnap.name
+        }
       });
     }
     const changeLandsAt = effectiveAt ?? now;
     for (const booking of await this.bookingsOutlastingCycle(sub, targetCycle, changeLandsAt)) {
       blockers.push({
-        code: import_core17.BILLING_ERROR_CODES.BUNDLE_CYCLE_EXCEEDS_PLAN,
-        message: `A yearly add-on is booked until ${booking.until}. A ${targetCycle.toLowerCase()} plan cannot carry it \u2014 cancel the add-on first, or keep the yearly cycle.`
+        code: import_core17.BILLING_ERROR_CODES.BUNDLE_BOOKING_OUTLASTS_TARGET_CYCLE,
+        message: `A yearly bundle is booked until ${booking.until}. A monthly plan cannot carry it \u2014 cancel the bundle first, or keep the yearly cycle.`,
+        params: {
+          billingCycle: "yearly",
+          planCycle: targetCycle.toLowerCase(),
+          until: booking.until
+        }
       });
     }
     const projectedTrialEndsAt = this.trialProjection && sub.status === "TRIAL" ? await this.trialProjection.projectTrialEndsAt({
@@ -6101,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;
@@ -6210,8 +6250,19 @@ var TenantBillingController = class _TenantBillingController {
     if (blockedTargets.includes(dto.plan)) {
       throw new import_common34.ForbiddenException({
         code: import_core22.BILLING_ERROR_CODES.PLAN_NOT_SELF_SERVICE,
-        message: `${dto.plan} is not activated via self-service.`,
+        // Says what the shipped catalogue says, so an app that has not
+        // translated this code and one that has do not refuse in two
+        // different sentences.
+        message: `${dto.plan} is only activated via a special contract. Please contact the contract manager.`,
+        // `planName` is the key here, and that is the best label this
+        // check has: it decides before any catalogue is read, from
+        // nothing but the key the request sent. The plan-change
+        // preview does have a catalogue and passes the real name,
+        // which is the one a tenant recognises. Either way the
+        // template's `{planName}` resolves to a word rather than a
+        // brace — `error-params-contract.test.js` holds that.
         params: {
+          planName: dto.plan,
           planKey: dto.plan
         }
       });
@@ -6345,8 +6396,10 @@ var TenantBillingController = class _TenantBillingController {
     if (blockedTargets.includes(dto.plan)) {
       throw new import_common34.ForbiddenException({
         code: import_core22.BILLING_ERROR_CODES.PLAN_NOT_SELF_SERVICE,
-        message: `${dto.plan} is not activated via self-service.`,
+        message: `${dto.plan} is only activated via a special contract. Please contact the contract manager.`,
+        // The key as the label — see the note on the plan-change route.
         params: {
+          planName: dto.plan,
           planKey: dto.plan
         }
       });
@@ -6911,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);
@@ -6918,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");
@@ -6932,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));
     }
@@ -7616,6 +7693,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
   ], GeneratedTenantSubscriptionBundlesController.prototype, "prices", null);
   _ts_decorate39([
     (0, import_common38.Post)(),
+    (0, import_common38.UseGuards)(TenantAdminGuard),
     _ts_param26(0, (0, import_common38.Req)()),
     _ts_param26(1, (0, import_common38.Body)()),
     _ts_metadata29("design:type", Function),
@@ -7639,6 +7717,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
   ], GeneratedTenantSubscriptionBundlesController.prototype, "preview", null);
   _ts_decorate39([
     (0, import_common38.Delete)(":id"),
+    (0, import_common38.UseGuards)(TenantAdminGuard),
     (0, import_common38.HttpCode)(import_common38.HttpStatus.OK),
     _ts_param26(0, (0, import_common38.Req)()),
     _ts_param26(1, (0, import_common38.Param)("id", new import_common38.ParseUUIDPipe())),
@@ -7653,6 +7732,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
   ], GeneratedTenantSubscriptionBundlesController.prototype, "cancel", null);
   _ts_decorate39([
     (0, import_common38.Post)(":id/reactivate"),
+    (0, import_common38.UseGuards)(TenantAdminGuard),
     (0, import_common38.HttpCode)(import_common38.HttpStatus.OK),
     _ts_param26(0, (0, import_common38.Req)()),
     _ts_param26(1, (0, import_common38.Param)("id", new import_common38.ParseUUIDPipe())),
@@ -14526,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",
@@ -16177,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
@@ -18616,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/admin/index.js

@@ -25,15 +25,15 @@ import {
   SuperAdminGuard,
   SuspendTenantDto,
   buildAdminStatsController
-} from "../chunk-3Y4USRJS.js";
+} from "../chunk-LTT736P3.js";
 import {
   AUDIT_PORT_TOKEN,
   AdminAuditService,
   MFA_PORT_TOKEN,
   RLS_BYPASS_PORT_TOKEN
 } from "../chunk-O2J2HDXA.js";
-import "../chunk-57V6ZTI6.js";
 import "../chunk-YSC46BGM.js";
+import "../chunk-57V6ZTI6.js";
 import "../chunk-SABTXESR.js";
 import "../chunk-SHUYVCID.js";
 export {

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-CGfCLtzu.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'];
 }
@@ -941,8 +956,7 @@ declare const SUBSCRIPTION_BUNDLE_CONFIG_TOKEN: unique symbol;
 
 /**
  * Factory analogous to `buildBundlesController` etc. — the consumer can pass
- * additional guards (e.g. RoleGuard) in addition to the platform default
- * `ComposedTenantAuthGuard`.
+ * additional guards (e.g. RoleGuard) in addition to the platform defaults.
  */
 declare function buildTenantSubscriptionBundlesController(extraGuards?: Array<Type<CanActivate>>): Type;
 

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-D9rtguyx.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'];
 }
@@ -941,8 +956,7 @@ declare const SUBSCRIPTION_BUNDLE_CONFIG_TOKEN: unique symbol;
 
 /**
  * Factory analogous to `buildBundlesController` etc. — the consumer can pass
- * additional guards (e.g. RoleGuard) in addition to the platform default
- * `ComposedTenantAuthGuard`.
+ * additional guards (e.g. RoleGuard) in addition to the platform defaults.
  */
 declare function buildTenantSubscriptionBundlesController(extraGuards?: Array<Type<CanActivate>>): Type;
 

package/dist/billing/index.js

@@ -24,7 +24,7 @@ import {
   decideRenewal,
   loadPlanCatalogFromFile,
   loadPlanCatalogFromString
-} from "../chunk-BYINBUNY.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,9 +79,9 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "../chunk-NT4ZGXPA.js";
-import "../chunk-7JEXCHMU.js";
-import "../chunk-65ADCLHU.js";
+} from "../chunk-W67WBRW5.js";
+import "../chunk-6FQ3G4IF.js";
+import "../chunk-F7P2X2DR.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
   CANCELLATION_NOTICE_DAYS_TOKEN,
@@ -99,10 +100,12 @@ import {
   resolveBundlePriceNet
 } from "../chunk-X7CWHRSK.js";
 import "../chunk-O2J2HDXA.js";
+import "../chunk-BSK6YBLI.js";
+import "../chunk-YSC46BGM.js";
 import {
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "../chunk-SO2NH2A6.js";
+} from "../chunk-5LE5AZUP.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
   PLAN_CATALOG_TOKEN,
@@ -117,15 +120,13 @@ import {
   getPlanQuota,
   isFeatureInPlan,
   isFeaturePlannedOnly
-} from "../chunk-UUFUSKX2.js";
+} from "../chunk-H7SF4EUR.js";
 import "../chunk-VBRYPU7V.js";
 import "../chunk-57V6ZTI6.js";
 import "../chunk-OUDSQ3PU.js";
-import "../chunk-QUZU2M33.js";
-import "../chunk-BSK6YBLI.js";
-import "../chunk-YSC46BGM.js";
 import "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
+import "../chunk-QUZU2M33.js";
 import "../chunk-SHUYVCID.js";
 export {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
@@ -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/catalog/index.js

@@ -6,7 +6,7 @@ import {
   runSeedGateFromFile,
   seedGateExitCode,
   validateSeedAgainstSnapshot
-} from "../chunk-E74DRQJM.js";
+} from "../chunk-GG5NHRH5.js";
 import "../chunk-74SCJ4HF.js";
 import {
   ADVISORY_STRICT_MODE_CODES,
@@ -57,13 +57,12 @@ import {
   resolveValidityWindow,
   validateBundleDraft,
   validatePlanDraft
-} from "../chunk-L33BM4EN.js";
+} from "../chunk-DFQETRBL.js";
 import "../chunk-X7CWHRSK.js";
 import "../chunk-O2J2HDXA.js";
+import "../chunk-YSC46BGM.js";
 import "../chunk-WXYJHZCN.js";
 import "../chunk-OUDSQ3PU.js";
-import "../chunk-QUZU2M33.js";
-import "../chunk-YSC46BGM.js";
 import {
   BUNDLE_REPOSITORY_TOKEN,
   CATALOG_ENTRY_REPOSITORY_TOKEN,
@@ -75,6 +74,7 @@ import {
   PROMOTION_REPOSITORY_TOKEN
 } from "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
+import "../chunk-QUZU2M33.js";
 import "../chunk-SHUYVCID.js";
 export {
   ADVISORY_STRICT_MODE_CODES,

package/dist/{chunk-SO2NH2A6.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";
@@ -14,12 +14,12 @@ import {
   SUBSCRIPTION_REPOSITORY_TOKEN,
   TRANSACTION_RUNNER_TOKEN
 } from "./chunk-OUDSQ3PU.js";
-import {
-  DISCOVERY_SNAPSHOT_TOKEN
-} from "./chunk-QUZU2M33.js";
 import {
   BUNDLE_REPOSITORY_TOKEN
 } from "./chunk-AOQJEYOL.js";
+import {
+  DISCOVERY_SNAPSHOT_TOKEN
+} from "./chunk-QUZU2M33.js";
 import {
   __name
 } from "./chunk-SHUYVCID.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";