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

package/dist/.build-stamp

@@ -1 +1 @@
-d2641f050887af0afe7e26844778e4a66660b2f17d7ded07dc67cb60d62c29b0
+89d783a28230b3a9b77ff0cb7706f96197daa84bc359f5d1d8f0d643d33beffc

package/dist/_entries.cjs

@@ -4023,12 +4023,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 +4036,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({
@@ -6210,8 +6237,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 +6383,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
         }
       });
@@ -7616,6 +7656,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 +7680,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 +7695,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())),

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

@@ -8,7 +8,7 @@ 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';
+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';
@@ -941,8 +941,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

@@ -8,7 +8,7 @@ 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';
+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';
@@ -941,8 +941,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-GHIECNF3.js";
 import {
   AddSubscriptionBundleDto,
   BILLING_FEATURE_UI_REGISTRY_TOKEN,
@@ -78,9 +78,9 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "../chunk-NT4ZGXPA.js";
+} from "../chunk-TJ5E42WX.js";
 import "../chunk-7JEXCHMU.js";
-import "../chunk-65ADCLHU.js";
+import "../chunk-F7P2X2DR.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
   CANCELLATION_NOTICE_DAYS_TOKEN,
@@ -99,10 +99,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-IW5XGOEU.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
   PLAN_CATALOG_TOKEN,
@@ -121,11 +123,9 @@ import {
 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,

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-RCZ7ZGKU.js → chunk-2BNZK22P.js}

@@ -1,9 +1,9 @@
 import {
   PromoCodesModule
-} from "./chunk-EASFDWXV.js";
+} from "./chunk-JNONSUP3.js";
 import {
   SubscriptionContractModule
-} from "./chunk-MEVY2ZZG.js";
+} from "./chunk-L4VVZ4O5.js";
 import {
   AdminManifestModule,
   AdminManifestService,
@@ -12,7 +12,7 @@ import {
   AdminStatsModule,
   MfaService,
   SuperAdminGuard
-} from "./chunk-3Y4USRJS.js";
+} from "./chunk-LTT736P3.js";
 import {
   FEATURE_GUARD_MARKER,
   PublicCatalogModule,
@@ -20,20 +20,26 @@ import {
   SubscriptionBundleModule,
   TenantBillingModule,
   isPlatformFeatureGuard
-} from "./chunk-NT4ZGXPA.js";
+} from "./chunk-TJ5E42WX.js";
 import {
   CatalogModule
-} from "./chunk-L33BM4EN.js";
+} from "./chunk-DFQETRBL.js";
+import {
+  CheckoutOfferModule
+} from "./chunk-RUTPEAZL.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   DiscoveryModule
 } from "./chunk-XBYAFEOR.js";
 import {
   EntitlementModule
-} from "./chunk-DRMSHMOB.js";
+} from "./chunk-DQW3DHSD.js";
 import {
   LimitExceededError,
   cancellationHasLanded
-} from "./chunk-SO2NH2A6.js";
+} from "./chunk-IW5XGOEU.js";
 import {
   PLAN_CATALOG_TOKEN,
   PlanCatalogModule
@@ -41,18 +47,12 @@ import {
 import {
   codedError
 } from "./chunk-57V6ZTI6.js";
-import {
-  ENFORCE_QUOTA_KEY
-} from "./chunk-QUZU2M33.js";
-import {
-  CheckoutOfferModule
-} from "./chunk-RUTPEAZL.js";
-import {
-  SaaSiCatPublicRoute
-} from "./chunk-YSC46BGM.js";
 import {
   asProvider
 } from "./chunk-SABTXESR.js";
+import {
+  ENFORCE_QUOTA_KEY
+} from "./chunk-QUZU2M33.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";

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

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

package/dist/{chunk-E74DRQJM.js → chunk-GG5NHRH5.js}

@@ -6,7 +6,7 @@ import {
   ADVISORY_STRICT_MODE_CODES,
   validateBundleDraft,
   validatePlanDraft
-} from "./chunk-L33BM4EN.js";
+} from "./chunk-DFQETRBL.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";

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

@@ -4,11 +4,11 @@ import {
   PUBLIC_CATALOG_CATALOG_ENTRY_REPOSITORY_TOKEN,
   REQUIRE_FEATURE_KEY,
   periodEndAfter
-} from "./chunk-NT4ZGXPA.js";
+} from "./chunk-TJ5E42WX.js";
 import {
   EntitlementService,
   isLimitExceededError
-} from "./chunk-SO2NH2A6.js";
+} from "./chunk-IW5XGOEU.js";
 import {
   ENTITLEMENT_SERVICE_TOKEN
 } from "./chunk-OUDSQ3PU.js";

package/dist/{chunk-MEVY2ZZG.js → chunk-L4VVZ4O5.js}

@@ -1,6 +1,6 @@
 import {
   SubscriptionContractService
-} from "./chunk-65ADCLHU.js";
+} from "./chunk-F7P2X2DR.js";
 import {
   SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
 } from "./chunk-VBRYPU7V.js";

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

@@ -3,7 +3,7 @@ import {
 } from "./chunk-7JEXCHMU.js";
 import {
   SubscriptionContractService
-} from "./chunk-65ADCLHU.js";
+} from "./chunk-F7P2X2DR.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
   CANCELLATION_NOTICE_DAYS_TOKEN,
@@ -21,13 +21,16 @@ import {
 import {
   AdminAuditService
 } from "./chunk-O2J2HDXA.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   EntitlementService,
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN,
   cancellationHasLanded,
   toEffectiveLimitsSnapshot
-} from "./chunk-SO2NH2A6.js";
+} from "./chunk-IW5XGOEU.js";
 import {
   PLAN_CATALOG_TOKEN,
   findPlan,
@@ -43,9 +46,6 @@ import {
 import {
   ENTITLEMENT_SERVICE_TOKEN
 } from "./chunk-OUDSQ3PU.js";
-import {
-  SaaSiCatPublicRoute
-} from "./chunk-YSC46BGM.js";
 import {
   BUNDLE_REPOSITORY_TOKEN,
   CATALOG_ENTRY_REPOSITORY_TOKEN,
@@ -810,12 +810,12 @@ var PlanChangePreviewService = class {
     const landsAt = ctx.canceledEffectiveAt ?? ctx.canceledAt;
     if (landsAt !== null && landsAt <= now) {
       blockers.push({
-        code: "SUBSCRIPTION_ENDED",
+        code: 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: BILLING_ERROR_CODES.CANCELLATION_LOCKS_THE_CYCLE,
         message: "This subscription is cancelled, so its billing cycle cannot change. The plan can."
       });
     }
@@ -823,47 +823,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: 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: 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: 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 ? BILLING_ERROR_CODES.FEATURE_LOST : 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: 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: 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: 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: 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({
@@ -1971,8 +1998,19 @@ var TenantBillingController = class _TenantBillingController {
     if (blockedTargets.includes(dto.plan)) {
       throw new ForbiddenException3({
         code: BILLING_ERROR_CODES3.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
         }
       });
@@ -2106,8 +2144,10 @@ var TenantBillingController = class _TenantBillingController {
     if (blockedTargets.includes(dto.plan)) {
       throw new ForbiddenException3({
         code: BILLING_ERROR_CODES3.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
         }
       });
@@ -3313,6 +3353,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
   ], GeneratedTenantSubscriptionBundlesController.prototype, "prices", null);
   _ts_decorate15([
     Post2(),
+    UseGuards2(TenantAdminGuard),
     _ts_param9(0, Req2()),
     _ts_param9(1, Body2()),
     _ts_metadata12("design:type", Function),
@@ -3336,6 +3377,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
   ], GeneratedTenantSubscriptionBundlesController.prototype, "preview", null);
   _ts_decorate15([
     Delete(":id"),
+    UseGuards2(TenantAdminGuard),
     HttpCode2(HttpStatus2.OK),
     _ts_param9(0, Req2()),
     _ts_param9(1, Param("id", new ParseUUIDPipe())),
@@ -3350,6 +3392,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
   ], GeneratedTenantSubscriptionBundlesController.prototype, "cancel", null);
   _ts_decorate15([
     Post2(":id/reactivate"),
+    UseGuards2(TenantAdminGuard),
     HttpCode2(HttpStatus2.OK),
     _ts_param9(0, Req2()),
     _ts_param9(1, Param("id", new ParseUUIDPipe())),

package/dist/entitlement/index.js

@@ -1,7 +1,7 @@
 import "../chunk-G7RQO2XO.js";
 import {
   EntitlementModule
-} from "../chunk-DRMSHMOB.js";
+} from "../chunk-DQW3DHSD.js";
 import {
   EntitlementService,
   LimitExceededError,
@@ -24,7 +24,7 @@ import {
   mergeSubscriptionBundlesIntoLimits,
   resolveEntitlementPlan,
   toEffectiveLimitsSnapshot
-} from "../chunk-SO2NH2A6.js";
+} from "../chunk-IW5XGOEU.js";
 import "../chunk-UUFUSKX2.js";
 import "../chunk-VBRYPU7V.js";
 import "../chunk-57V6ZTI6.js";
@@ -35,9 +35,9 @@ import {
   SUBSCRIPTION_REPOSITORY_TOKEN,
   TRANSACTION_RUNNER_TOKEN
 } from "../chunk-OUDSQ3PU.js";
-import "../chunk-QUZU2M33.js";
 import "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
+import "../chunk-QUZU2M33.js";
 import "../chunk-SHUYVCID.js";
 export {
   ENTITLEMENT_RESOLUTION_CONFIG_TOKEN,

package/dist/index.d.cts

@@ -9,7 +9,7 @@ export { AddSubscriptionBundleDto, AjvErrorLike, BILLING_FEATURE_UI_REGISTRY_TOK
 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, j as ContractFreezePort, k as ContractFreezeSourcePort, D as DuePendingPlanChange, F as FEATURE_GUARD_MARKER, 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';
 import { SetupStatusResponse, SetupResult, SetupConfirmMfaResponse, PlatformErrorCode, PlatformErrorBody } from '@saasicat/core';
 export { BundleVersionFields, ChangeDirection, DiffResult, DiscoveredCapability, DiscoveredFeature, DiscoveredQuota, DiscoverySnapshot, PasswordHasher, PlanVersionFields, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
-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';
+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';
 export { C as CustomLimitsShape, E as EffectiveLimits, a as EffectiveLimitsSnapshot, b as EnforceLimitInput, c as EntitlementService, P as PlanVersionSnapshot, S as SubscriptionBundleSnapshot, d as SubscriptionLimitsInput, e as aggregateContractLineItemEntitlements, f as aggregateLimits, g as aggregateSubscriptionBundleQuotas, h as applyCustomLimits, i as collectSubscriptionBundleFeatures, j as contractBundleVersionIds, k as contractLimits, l as filterActiveSubscriptionBundles, m as filterPlannedOnlyFeatures, n as hasAnyFeature, o as hasFeature, p as mergeSubscriptionBundlesIntoLimits, t as toEffectiveLimitsSnapshot } from './aggregation-Bsg1g9Q0.cjs';
 export { CancellationDates, ENTITLEMENT_RESOLUTION_CONFIG_TOKEN, ENTITLEMENT_SERVICE_TOKEN, EntitlementModule, EntitlementModuleOptions, LimitExceededError, PLAN_VERSION_REPOSITORY_TOKEN, ReplacedByIndex, SUBSCRIPTION_REPOSITORY_TOKEN, TRANSACTION_RUNNER_TOKEN, buildReplacedByIndex, cancellationHasLanded, cancellationLandsAt, expandReplacedFeatures, isLimitExceededError } from './entitlement/index.cjs';
 export { E as EntitlementResolutionConfig, a as EntitlementResolutionInput, r as resolveEntitlementPlan } from './plan-resolution-CwUy_OqC.cjs';

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export { AddSubscriptionBundleDto, AjvErrorLike, BILLING_FEATURE_UI_REGISTRY_TOK
 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, j as ContractFreezePort, k as ContractFreezeSourcePort, D as DuePendingPlanChange, F as FEATURE_GUARD_MARKER, 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';
 import { SetupStatusResponse, SetupResult, SetupConfirmMfaResponse, PlatformErrorCode, PlatformErrorBody } from '@saasicat/core';
 export { BundleVersionFields, ChangeDirection, DiffResult, DiscoveredCapability, DiscoveredFeature, DiscoveredQuota, DiscoverySnapshot, PasswordHasher, PlanVersionFields, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
-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';
+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';
 export { C as CustomLimitsShape, E as EffectiveLimits, a as EffectiveLimitsSnapshot, b as EnforceLimitInput, c as EntitlementService, P as PlanVersionSnapshot, S as SubscriptionBundleSnapshot, d as SubscriptionLimitsInput, e as aggregateContractLineItemEntitlements, f as aggregateLimits, g as aggregateSubscriptionBundleQuotas, h as applyCustomLimits, i as collectSubscriptionBundleFeatures, j as contractBundleVersionIds, k as contractLimits, l as filterActiveSubscriptionBundles, m as filterPlannedOnlyFeatures, n as hasAnyFeature, o as hasFeature, p as mergeSubscriptionBundlesIntoLimits, t as toEffectiveLimitsSnapshot } from './aggregation-53yv4-rr.js';
 export { CancellationDates, ENTITLEMENT_RESOLUTION_CONFIG_TOKEN, ENTITLEMENT_SERVICE_TOKEN, EntitlementModule, EntitlementModuleOptions, LimitExceededError, PLAN_VERSION_REPOSITORY_TOKEN, ReplacedByIndex, SUBSCRIPTION_REPOSITORY_TOKEN, TRANSACTION_RUNNER_TOKEN, buildReplacedByIndex, cancellationHasLanded, cancellationLandsAt, expandReplacedFeatures, isLimitExceededError } from './entitlement/index.js';
 export { E as EntitlementResolutionConfig, a as EntitlementResolutionInput, r as resolveEntitlementPlan } from './plan-resolution-CwUy_OqC.js';

package/dist/index.js

@@ -66,7 +66,7 @@ import {
   decideRenewal,
   loadPlanCatalogFromFile,
   loadPlanCatalogFromString
-} from "./chunk-BYINBUNY.js";
+} from "./chunk-GHIECNF3.js";
 import {
   formatPreflightReport,
   formatSeedGateReport,
@@ -75,7 +75,8 @@ import {
   runSeedGateFromFile,
   seedGateExitCode,
   validateSeedAgainstSnapshot
-} from "./chunk-E74DRQJM.js";
+} from "./chunk-GG5NHRH5.js";
+import "./chunk-DBZGV3HC.js";
 import {
   DefinesQuota,
   EnforceQuota,
@@ -88,7 +89,6 @@ import {
   loadDiscoverySnapshotFromFile
 } from "./chunk-74SCJ4HF.js";
 import "./chunk-G7RQO2XO.js";
-import "./chunk-DBZGV3HC.js";
 import {
   defineSaaSiCat
 } from "./chunk-OYNHOY45.js";
@@ -99,7 +99,7 @@ import {
   SetupController,
   SetupModule,
   SetupService
-} from "./chunk-RCZ7ZGKU.js";
+} from "./chunk-2BNZK22P.js";
 import {
   CreatePromoCodeDto,
   PreviewPromoCodeDto,
@@ -111,10 +111,10 @@ import {
   buildPromoCodeAdminController,
   hashIp,
   ipFingerprint
-} from "./chunk-EASFDWXV.js";
+} from "./chunk-JNONSUP3.js";
 import {
   SubscriptionContractModule
-} from "./chunk-MEVY2ZZG.js";
+} from "./chunk-L4VVZ4O5.js";
 import {
   ADMIN_MANIFEST_CONFIG,
   ADMIN_RESOURCES_PORT_TOKEN,
@@ -141,7 +141,7 @@ import {
   SuperAdminGuard,
   SuspendTenantDto,
   buildAdminStatsController
-} from "./chunk-3Y4USRJS.js";
+} from "./chunk-LTT736P3.js";
 import {
   AddSubscriptionBundleDto,
   BILLING_FEATURE_UI_REGISTRY_TOKEN,
@@ -195,7 +195,7 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "./chunk-NT4ZGXPA.js";
+} from "./chunk-TJ5E42WX.js";
 import {
   CODE_MAX_LENGTH,
   CODE_MIN_LENGTH,
@@ -220,7 +220,7 @@ import {
   contractLineItemToInvoiceLineItem,
   sortContractLineItemsForInvoice,
   subscriptionContractToInvoiceSnapshot
-} from "./chunk-65ADCLHU.js";
+} from "./chunk-F7P2X2DR.js";
 import {
   ADVISORY_STRICT_MODE_CODES,
   BUNDLE_VERSION_WINDOW_CODES,
@@ -270,7 +270,7 @@ import {
   resolveValidityWindow,
   validateBundleDraft,
   validatePlanDraft
-} from "./chunk-L33BM4EN.js";
+} from "./chunk-DFQETRBL.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
   CANCELLATION_NOTICE_DAYS_TOKEN,
@@ -294,6 +294,20 @@ import {
   MFA_PORT_TOKEN,
   RLS_BYPASS_PORT_TOKEN
 } from "./chunk-O2J2HDXA.js";
+import {
+  CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CheckoutOfferModule,
+  CheckoutOfferService,
+  CreateCheckoutOfferDto,
+  UpdateCheckoutOfferDto,
+  buildCheckoutOfferController
+} from "./chunk-RUTPEAZL.js";
+import "./chunk-BSK6YBLI.js";
+import {
+  SAASICAT_PUBLIC_ROUTE_KEY,
+  SaaSiCatPublicRoute,
+  isSaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   DiscoveryModule,
   buildDiscoveryController
@@ -306,7 +320,7 @@ import {
 } from "./chunk-WXYJHZCN.js";
 import {
   EntitlementModule
-} from "./chunk-DRMSHMOB.js";
+} from "./chunk-DQW3DHSD.js";
 import {
   EntitlementService,
   LimitExceededError,
@@ -331,7 +345,7 @@ import {
   mergeSubscriptionBundlesIntoLimits,
   resolveEntitlementPlan,
   toEffectiveLimitsSnapshot
-} from "./chunk-SO2NH2A6.js";
+} from "./chunk-IW5XGOEU.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
   PLAN_CATALOG_TOKEN,
@@ -363,27 +377,6 @@ import {
   SUBSCRIPTION_REPOSITORY_TOKEN,
   TRANSACTION_RUNNER_TOKEN
 } from "./chunk-OUDSQ3PU.js";
-import {
-  DEFINES_QUOTA_KEY,
-  DISCOVERY_SNAPSHOT_TOKEN,
-  ENFORCE_QUOTA_KEY,
-  IMPLEMENTS_CAPABILITY_KEY,
-  REQUIRES_CAPABILITY_KEY
-} from "./chunk-QUZU2M33.js";
-import {
-  CHECKOUT_OFFER_REPOSITORY_TOKEN,
-  CheckoutOfferModule,
-  CheckoutOfferService,
-  CreateCheckoutOfferDto,
-  UpdateCheckoutOfferDto,
-  buildCheckoutOfferController
-} from "./chunk-RUTPEAZL.js";
-import "./chunk-BSK6YBLI.js";
-import {
-  SAASICAT_PUBLIC_ROUTE_KEY,
-  SaaSiCatPublicRoute,
-  isSaaSiCatPublicRoute
-} from "./chunk-YSC46BGM.js";
 import {
   BUNDLE_REPOSITORY_TOKEN,
   CATALOG_ENTRY_REPOSITORY_TOKEN,
@@ -397,6 +390,13 @@ import {
 import {
   asProvider
 } from "./chunk-SABTXESR.js";
+import {
+  DEFINES_QUOTA_KEY,
+  DISCOVERY_SNAPSHOT_TOKEN,
+  ENFORCE_QUOTA_KEY,
+  IMPLEMENTS_CAPABILITY_KEY,
+  REQUIRES_CAPABILITY_KEY
+} from "./chunk-QUZU2M33.js";
 import "./chunk-SHUYVCID.js";
 export {
   ACTIVATION_ORCHESTRATOR_TOKEN,

package/dist/platform/index.d.cts

@@ -13,7 +13,7 @@ export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminMan
 export { A as AdminAuditService } from '../admin-audit.service-4P3Djdxk.cjs';
 export { e as AdminResourcesService, f as AdminStatsModule, g as AdminStatsModuleOptions } from '../admin-resources.module-CpvzcfCc.cjs';
 export { c as EntitlementService } from '../aggregation-Bsg1g9Q0.cjs';
-export { d as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, i as PlanChangePreviewService, t as SubscriptionBundlePreviewService, u as SubscriptionBundlesService, T as TenantAdminGuard, v as TenantBillingController } from '../tenant-billing.controller-CGfCLtzu.cjs';
+export { d as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, i as PlanChangePreviewService, t as SubscriptionBundlePreviewService, u as SubscriptionBundlesService, T as TenantAdminGuard, v as TenantBillingController } from '../tenant-billing.controller-DElYt3Aa.cjs';
 export { B as BundlesService, C as CatalogEntriesService, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-7z7fbLFe.cjs';
 export { P as PromoCodeRateLimitGuard } from '../rate-limit.guard-dntqAlfZ.cjs';
 export { i as PromoCodesService } from '../promo.service-BJbKAmw3.cjs';

package/dist/platform/index.d.ts

@@ -13,7 +13,7 @@ export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminMan
 export { A as AdminAuditService } from '../admin-audit.service-4P3Djdxk.js';
 export { e as AdminResourcesService, f as AdminStatsModule, g as AdminStatsModuleOptions } from '../admin-resources.module-DF5_Q7RD.js';
 export { c as EntitlementService } from '../aggregation-53yv4-rr.js';
-export { d as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, i as PlanChangePreviewService, t as SubscriptionBundlePreviewService, u as SubscriptionBundlesService, T as TenantAdminGuard, v as TenantBillingController } from '../tenant-billing.controller-D9rtguyx.js';
+export { d as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, i as PlanChangePreviewService, t as SubscriptionBundlePreviewService, u as SubscriptionBundlesService, T as TenantAdminGuard, v as TenantBillingController } from '../tenant-billing.controller-CVDMTGx6.js';
 export { B as BundlesService, C as CatalogEntriesService, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-tlRtuf2o.js';
 export { P as PromoCodeRateLimitGuard } from '../rate-limit.guard-dntqAlfZ.js';
 export { i as PromoCodesService } from '../promo.service-BJbKAmw3.js';

package/dist/platform/index.js

@@ -28,13 +28,13 @@ import {
   docsUrlFor,
   findViolations,
   headingSlug
-} from "../chunk-RCZ7ZGKU.js";
+} from "../chunk-2BNZK22P.js";
 import {
   PromoCodeRateLimitGuard
-} from "../chunk-EASFDWXV.js";
+} from "../chunk-JNONSUP3.js";
 import {
   SubscriptionContractModule
-} from "../chunk-MEVY2ZZG.js";
+} from "../chunk-L4VVZ4O5.js";
 import {
   AdminBypassRlsInterceptor,
   AdminManifestModule,
@@ -46,7 +46,7 @@ import {
   MfaGuard,
   MfaService,
   SuperAdminGuard
-} from "../chunk-3Y4USRJS.js";
+} from "../chunk-LTT736P3.js";
 import {
   ComposedTenantAuthGuard,
   PendingPlanMaterializationService,
@@ -55,13 +55,13 @@ import {
   SubscriptionBundlesService,
   TenantAdminGuard,
   TenantBillingController
-} from "../chunk-NT4ZGXPA.js";
+} from "../chunk-TJ5E42WX.js";
 import {
   PromoCodesService
 } from "../chunk-7JEXCHMU.js";
 import {
   SubscriptionContractService
-} from "../chunk-65ADCLHU.js";
+} from "../chunk-F7P2X2DR.js";
 import {
   BundlesService,
   CatalogEntriesService,
@@ -71,24 +71,11 @@ import {
   PlansService,
   PromotionsService,
   PublicMarketingCatalogService
-} from "../chunk-L33BM4EN.js";
+} from "../chunk-DFQETRBL.js";
 import "../chunk-X7CWHRSK.js";
 import {
   AdminAuditService
 } from "../chunk-O2J2HDXA.js";
-import "../chunk-XBYAFEOR.js";
-import {
-  DiscoveryScanner
-} from "../chunk-WXYJHZCN.js";
-import "../chunk-DRMSHMOB.js";
-import {
-  EntitlementService
-} from "../chunk-SO2NH2A6.js";
-import "../chunk-UUFUSKX2.js";
-import "../chunk-VBRYPU7V.js";
-import "../chunk-57V6ZTI6.js";
-import "../chunk-OUDSQ3PU.js";
-import "../chunk-QUZU2M33.js";
 import {
   CheckoutOfferModule,
   CheckoutOfferService
@@ -99,8 +86,21 @@ import {
   SaaSiCatPublicRoute,
   isSaaSiCatPublicRoute
 } from "../chunk-YSC46BGM.js";
+import "../chunk-XBYAFEOR.js";
+import {
+  DiscoveryScanner
+} from "../chunk-WXYJHZCN.js";
+import "../chunk-DQW3DHSD.js";
+import {
+  EntitlementService
+} from "../chunk-IW5XGOEU.js";
+import "../chunk-UUFUSKX2.js";
+import "../chunk-VBRYPU7V.js";
+import "../chunk-57V6ZTI6.js";
+import "../chunk-OUDSQ3PU.js";
 import "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
+import "../chunk-QUZU2M33.js";
 import "../chunk-SHUYVCID.js";
 export {
   AdminAuditService,

package/dist/promo/index.js

@@ -10,7 +10,7 @@ import {
   buildPromoCodeAdminController,
   hashIp,
   ipFingerprint
-} from "../chunk-EASFDWXV.js";
+} from "../chunk-JNONSUP3.js";
 import {
   CODE_MAX_LENGTH,
   CODE_MIN_LENGTH,
@@ -31,13 +31,13 @@ import {
   computeRegularStartsAt
 } from "../chunk-7JEXCHMU.js";
 import "../chunk-O2J2HDXA.js";
+import "../chunk-YSC46BGM.js";
 import {
   computeIncludedVat,
   grossFromNet,
   round2
 } from "../chunk-UUFUSKX2.js";
 import "../chunk-57V6ZTI6.js";
-import "../chunk-YSC46BGM.js";
 import "../chunk-SABTXESR.js";
 import "../chunk-SHUYVCID.js";
 export {

package/dist/subscription-contract/index.js

@@ -1,17 +1,17 @@
 import "../chunk-2SLTRKXC.js";
 import {
   SubscriptionContractModule
-} from "../chunk-MEVY2ZZG.js";
+} from "../chunk-L4VVZ4O5.js";
 import {
   SubscriptionContractService,
   contractLineItemToInvoiceLineItem,
   sortContractLineItemsForInvoice,
   subscriptionContractToInvoiceSnapshot
-} from "../chunk-65ADCLHU.js";
+} from "../chunk-F7P2X2DR.js";
+import "../chunk-BSK6YBLI.js";
 import {
   SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
 } from "../chunk-VBRYPU7V.js";
-import "../chunk-BSK6YBLI.js";
 import "../chunk-SABTXESR.js";
 import "../chunk-SHUYVCID.js";
 export {

package/dist/{tenant-billing.controller-D9rtguyx.d.ts → tenant-billing.controller-CVDMTGx6.d.ts}

@@ -90,7 +90,23 @@ interface LimitsCheckRow {
 }
 interface PlanChangePreviewIssue {
     code: string;
+    /**
+     * English display text, and the last rung of the ladder rather than the
+     * first: `resolveErrorMessage` prefers the reader's catalogue and reaches
+     * this only for a code nobody has translated. It stays on the wire because
+     * a blocker that renders as an empty line leaves someone with a disabled
+     * button and no reason.
+     */
     message: string;
+    /**
+     * The values the sentence needs, beside it rather than inside it.
+     *
+     * Without these a client holding the code still cannot rebuild the
+     * sentence — it would have to parse English prose for the numbers. Every
+     * template in the shipped catalogues names only what appears here, and
+     * `preview-issues-are-translatable.test.js` holds that.
+     */
+    params?: Record<string, string | number>;
 }
 interface PlanChangePreviewDto {
     changeType: PlanChangeType;

package/dist/{tenant-billing.controller-CGfCLtzu.d.cts → tenant-billing.controller-DElYt3Aa.d.cts}

@@ -90,7 +90,23 @@ interface LimitsCheckRow {
 }
 interface PlanChangePreviewIssue {
     code: string;
+    /**
+     * English display text, and the last rung of the ladder rather than the
+     * first: `resolveErrorMessage` prefers the reader's catalogue and reaches
+     * this only for a code nobody has translated. It stays on the wire because
+     * a blocker that renders as an empty line leaves someone with a disabled
+     * button and no reason.
+     */
     message: string;
+    /**
+     * The values the sentence needs, beside it rather than inside it.
+     *
+     * Without these a client holding the code still cannot rebuild the
+     * sentence — it would have to parse English prose for the numbers. Every
+     * template in the shipped catalogues names only what appears here, and
+     * `preview-issues-are-translatable.test.js` holds that.
+     */
+    params?: Record<string, string | number>;
 }
 interface PlanChangePreviewDto {
     changeType: PlanChangeType;

package/dist/testing/index.js

@@ -5,30 +5,30 @@ import {
   StaticEntitlementService,
   StaticFeatureGuard,
   StaticPlanResolver
-} from "../chunk-RCZ7ZGKU.js";
-import "../chunk-EASFDWXV.js";
-import "../chunk-MEVY2ZZG.js";
-import "../chunk-3Y4USRJS.js";
-import "../chunk-NT4ZGXPA.js";
+} from "../chunk-2BNZK22P.js";
+import "../chunk-JNONSUP3.js";
+import "../chunk-L4VVZ4O5.js";
+import "../chunk-LTT736P3.js";
+import "../chunk-TJ5E42WX.js";
 import "../chunk-7JEXCHMU.js";
-import "../chunk-65ADCLHU.js";
-import "../chunk-L33BM4EN.js";
+import "../chunk-F7P2X2DR.js";
+import "../chunk-DFQETRBL.js";
 import "../chunk-X7CWHRSK.js";
 import "../chunk-O2J2HDXA.js";
+import "../chunk-RUTPEAZL.js";
+import "../chunk-BSK6YBLI.js";
+import "../chunk-YSC46BGM.js";
 import "../chunk-XBYAFEOR.js";
 import "../chunk-WXYJHZCN.js";
-import "../chunk-DRMSHMOB.js";
-import "../chunk-SO2NH2A6.js";
+import "../chunk-DQW3DHSD.js";
+import "../chunk-IW5XGOEU.js";
 import "../chunk-UUFUSKX2.js";
 import "../chunk-VBRYPU7V.js";
 import "../chunk-57V6ZTI6.js";
 import "../chunk-OUDSQ3PU.js";
-import "../chunk-QUZU2M33.js";
-import "../chunk-RUTPEAZL.js";
-import "../chunk-BSK6YBLI.js";
-import "../chunk-YSC46BGM.js";
 import "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
+import "../chunk-QUZU2M33.js";
 import {
   __name
 } from "../chunk-SHUYVCID.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/nest",
-  "version": "1.0.0-rc.7",
+  "version": "1.0.0-rc.8",
   "description": "NestJS implementation of SaaSiCat: capability discovery, catalog packaging, contracts, entitlement enforcement, billing and admin APIs.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -138,8 +138,8 @@
     "js-yaml": "^4.3.1",
     "otplib": "^13.4.1",
     "qrcode": "^1.5.4",
-    "@saasicat/spec": "^1.0.0-rc.7",
-    "@saasicat/core": "^1.0.0-rc.7"
+    "@saasicat/spec": "^1.0.0-rc.8",
+    "@saasicat/core": "^1.0.0-rc.8"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",

package/dist/{chunk-L33BM4EN.js → chunk-DFQETRBL.js}

@@ -10,18 +10,15 @@ import {
 import {
   AdminAuditService
 } from "./chunk-O2J2HDXA.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   DiscoveryScanner
 } from "./chunk-WXYJHZCN.js";
 import {
   SUBSCRIPTION_REPOSITORY_TOKEN
 } from "./chunk-OUDSQ3PU.js";
-import {
-  DISCOVERY_SNAPSHOT_TOKEN
-} from "./chunk-QUZU2M33.js";
-import {
-  SaaSiCatPublicRoute
-} from "./chunk-YSC46BGM.js";
 import {
   BUNDLE_REPOSITORY_TOKEN,
   CATALOG_ENTRY_REPOSITORY_TOKEN,
@@ -35,6 +32,9 @@ import {
 import {
   asProvider
 } from "./chunk-SABTXESR.js";
+import {
+  DISCOVERY_SNAPSHOT_TOKEN
+} from "./chunk-QUZU2M33.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";

package/dist/{chunk-65ADCLHU.js → chunk-F7P2X2DR.js}

@@ -1,9 +1,9 @@
-import {
-  SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
-} from "./chunk-VBRYPU7V.js";
 import {
   appendImplicitDiscountLineItem
 } from "./chunk-BSK6YBLI.js";
+import {
+  SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN
+} from "./chunk-VBRYPU7V.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";

package/dist/{chunk-SO2NH2A6.js → chunk-IW5XGOEU.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-EASFDWXV.js → chunk-JNONSUP3.js}

@@ -12,12 +12,12 @@ import {
 import {
   AdminAuditService
 } from "./chunk-O2J2HDXA.js";
-import {
-  codedError
-} from "./chunk-57V6ZTI6.js";
 import {
   SaaSiCatPublicRoute
 } from "./chunk-YSC46BGM.js";
+import {
+  codedError
+} from "./chunk-57V6ZTI6.js";
 import {
   asProvider
 } from "./chunk-SABTXESR.js";

package/dist/{chunk-3Y4USRJS.js → chunk-LTT736P3.js}

@@ -4,12 +4,12 @@ import {
   MFA_PORT_TOKEN,
   RLS_BYPASS_PORT_TOKEN
 } from "./chunk-O2J2HDXA.js";
-import {
-  codedError
-} from "./chunk-57V6ZTI6.js";
 import {
   SaaSiCatPublicRoute
 } from "./chunk-YSC46BGM.js";
+import {
+  codedError
+} from "./chunk-57V6ZTI6.js";
 import {
   asProvider
 } from "./chunk-SABTXESR.js";