@saasicat/nest 0.21.0 → 0.22.0

package/dist/_entries.cjs

@@ -771,7 +771,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
         enabled: true,
         requiredCapability: "dashboard.read"
       },
-      // SPEC_V2 §3.3 — discovery snapshot of the running backend.
+      // — discovery snapshot of the running backend.
       // Apps must set `discovery.read` in their manifest capabilities
       // to `true` so that the NavBuilder wires the page into the
       // sidebar; otherwise it is filtered out automatically.
@@ -779,7 +779,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
         enabled: true,
         requiredCapability: "discovery.read"
       },
-      // SPEC_V2 §11.1 M3 — Bundle editor in SuperAdmin.
+      // — Bundle editor in SuperAdmin.
       // Apps with a DB-driven catalog set `bundles.read = true`.
       bundles: {
         enabled: true,
@@ -789,7 +789,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
         enabled: true,
         requiredCapability: "plans.read"
       },
-      // SPEC_V2 §11.1 M3 — marketing catalog (locale pivot).
+      // — marketing catalog (locale pivot).
       // Apps that market a public catalog set
       // `marketingProjections.read = true`.
       marketingCatalog: {
@@ -2539,7 +2539,7 @@ var EntitlementService = class {
   // ---------------------------------------------------------------------
   /**
    * Plan fallback for TRIAL/PENDING_SALES: returns the PlanVersion active
-   * as of `asOf` (SPEC_V2 §4.2). If the repo does not implement
+   * as of `asOf`. If the repo does not implement
    * `findActive`, we fall back to `findLatestLive` (backward compat for
    * adapters without `validFrom` columns).
    */
@@ -3002,7 +3002,7 @@ function _ts_param14(paramIndex, decorator) {
 }
 __name(_ts_param14, "_ts_param");
 var PLAN_CATALOG_IMPORT_SINK_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/PlanCatalogImportSink");
-var IMPORT_CHANGE_NOTE = "Initial import from saas.yaml (SPEC_V2 \xA711.1 M6 Pack 2c)";
+var IMPORT_CHANGE_NOTE = "Initial import from saas.yaml";
 var PlanCatalogImporterService = class {
   static {
     __name(this, "PlanCatalogImporterService");
@@ -3293,7 +3293,7 @@ var PublicCatalogController = class {
     return merged;
   }
   /**
-   * SPEC_V2 §11.1 M6 Pack 2c — public catalog endpoint for bundles
+   * — public catalog endpoint for bundles
    * (stem list with live versions). If a `MarketingProjection` with
    * `targetType=BUNDLE` + matching locale exists, it is merged in.
    */
@@ -7840,7 +7840,7 @@ var BundlesService = class _BundlesService {
    * Publishes a draft version atomically. Steps:
    * 1. Strict check on the draft definition (warn-only or blocking)
    * 2. Enforce validFrom requirement + ordering against the predecessor
-   *    (SPEC_V2 §4.2 + §11.1 M6 Pack 2c, analogous to PlanVersion)
+   *    (analogous to PlanVersion)
    * 3. Compute the diff against the predecessor version (latest live) →
    *    `publishedChanges` + `nonRegressive` via `classifyBundleVersionDiff`
    * 4. Call Repository.publishDraft with the diff result + validity dates
@@ -7889,7 +7889,7 @@ var BundlesService = class _BundlesService {
     if (!validFromInput) {
       throw new import_common43.UnprocessableEntityException({
         code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_REQUIRED,
-        message: "validFrom must be set when publishing (on the draft or the publish call). SPEC_V2 \xA74.2."
+        message: "validFrom must be set when publishing (on the draft or the publish call).."
       });
     }
     const validFrom = new Date(validFromInput);
@@ -10125,7 +10125,7 @@ function buildPublicMarketingCatalogController(guards, projectKey, currency, vat
       this.service = service;
     }
     /**
-     * `?lang=de|tr|en` — alias `locale` accepted (SPEC_V2 §9).
+     * `?lang=de|tr|en` — alias `locale` accepted.
      * `?asOf=YYYY-MM-DD` — preview of a future or past catalog variant.
      *   Default = today. Returns the PlanVersion whose `validFrom`/`validUntil`
      *   span `asOf` inclusively by day (the validUntil day still counts,
@@ -10636,7 +10636,7 @@ var PlanVersionsService = class _PlanVersionsService {
     if (!validFromInput) {
       throw new import_common55.UnprocessableEntityException({
         code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_FROM_REQUIRED,
-        message: "validFrom must be set when publishing (on the draft or the publish call). SPEC_V2 \xA74.2."
+        message: "validFrom must be set when publishing (on the draft or the publish call).."
       });
     }
     const validFrom = new Date(validFromInput);
@@ -11153,7 +11153,7 @@ var PublishBundleVersionDto = class {
   allowZeroPrice;
   /**
    * Required on publish if the draft carries no `validFrom`
-   * (SPEC_V2 §4.2 + §11.1 M6 Pack 2c, analogous to PublishPlanVersionDto).
+   * (analogous to PublishPlanVersionDto).
    * Service strictly checks > `validFrom` of the predecessor version.
    */
   validFrom;
@@ -11939,7 +11939,7 @@ var CreatePlanVersionDraftDto = class {
   marketed;
   changeNote;
   baseVersionId;
-  /** Optional in the draft (required at publish). ISO date string. SPEC_V2 §4.2. */
+  /** Optional in the draft (required at publish). ISO date string.. */
   validFrom;
   /** Optional; null = unlimited. ISO date string. */
   validUntil;
@@ -12114,7 +12114,7 @@ var PublishPlanVersionDto = class {
   allowZeroPrice;
   /**
    * Required at publish (on the DTO or draft). The service strictly checks
-   * `validFrom > predecessor.validFrom`. SPEC_V2 §4.2.
+   * `validFrom > predecessor.validFrom`..
    */
   validFrom;
   validUntil;
@@ -15208,6 +15208,7 @@ function _ts_decorate89(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate89, "_ts_decorate");
+var PLATFORM_LOGGER = new import_common79.Logger("SaaSiCat");
 var PLATFORM_SUBSCRIPTION_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-nest/PlatformSubscriptionRepository");
 var STANDARD_MANIFEST_REGISTRATION_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-nest/StandardManifestRegistration");
 function buildStandardManifestContribution(catalog, adminResources, promoCodes) {
@@ -15672,6 +15673,11 @@ var SaasPlatformModule = class _SaasPlatformModule {
         useExisting: EnforceQuotaInterceptor
       });
       lightweightExports.push(PLAN_RESOLVER_PORT_TOKEN, StaticEntitlementService, StaticFeatureGuard, EnforceQuotaInterceptor, QUOTA_PROVIDERS_TOKEN);
+      if (options.globalFeatureGuard === false) {
+        PLATFORM_LOGGER.warn("globalFeatureGuard is off \u2014 the platform did NOT bind StaticFeatureGuard as an APP_GUARD. @RequireFeature only blocks on routes where you bound a feature guard yourself, behind your auth guard: @UseGuards(JwtAuthGuard, StaticFeatureGuard), or FeatureGuard from @saasicat/nest/billing on the V3 entitlement path. Any annotated route without one serves unlicensed traffic.");
+      }
+    } else {
+      PLATFORM_LOGGER.warn("No plan resolver configured \u2014 @RequireFeature and @EnforceQuota are INERT. The platform registered neither StaticFeatureGuard nor EnforceQuotaInterceptor, so every annotated route serves unlicensed traffic and every quota is unlimited. Set one of: adapters.planResolver, defaultPlanId, or tenantBilling.");
     }
     const tenantControllers = [];
     if (options.tenantManifest) {
@@ -17214,7 +17220,7 @@ var SaveRegistrationConfigSelectionDto = class {
   billingCycle;
   appliedPromoCode;
   /**
-   * METAMODELL §17a — Bundle consistency. ID of the `CheckoutOffer` that was
+   * — Bundle consistency. ID of the `CheckoutOffer` that was
    * created on the pricing page (`<app>/register?offer=<id>`). Passed
    * through unchanged in `configJson`; the ActivationOrchestrator freezes it
    * as `packageSnapshot` when the subscription is created and sets the offer
@@ -18354,7 +18360,7 @@ var FakePlanRepository = class {
       if (v.planId === existing.planKey) this.versions.delete(id);
     }
   }
-  // ─── Lifecycle (SPEC_V2 §11.1 M6 Pack 2a) ───
+  // ─── Lifecycle ───
   // Binding Plan ↔ PlanVersion: PlanVersion.planId === Plan.planKey
   // (soft string reference). Lifecycle methods take planKey
   // as input — the service resolves the plan UUID beforehand.

package/dist/admin/index.js

@@ -25,7 +25,7 @@ import {
   SuperAdminGuard,
   SuspendTenantDto,
   buildAdminStatsController
-} from "../chunk-FYWLPYBK.js";
+} from "../chunk-SN5UOC43.js";
 import {
   AUDIT_PORT_TOKEN,
   AdminAuditService,

package/dist/{aggregation-o0LMenvl.d.ts → aggregation-DP5zfKbU.d.ts}

@@ -16,7 +16,7 @@ interface PlanVersionSnapshot {
 }
 /**
  * Snapshot of an active SubscriptionBundle booking (P11.7.3 +
- * SPEC_V2 §11.1 M6 Pack 2e). Resolved by the EntitlementService from the
+ *). Resolved by the EntitlementService from the
  * `subscription_bundles` junction + BundleRepository.findVersionById and
  * passed to `aggregateLimits`.
  *
@@ -158,7 +158,7 @@ declare class EntitlementService {
     enforceLimit<T>(input: EnforceLimitInput<T>): Promise<T>;
     /**
      * Plan fallback for TRIAL/PENDING_SALES: returns the PlanVersion active
-     * as of `asOf` (SPEC_V2 §4.2). If the repo does not implement
+     * as of `asOf`. If the repo does not implement
      * `findActive`, we fall back to `findLatestLive` (backward compat for
      * adapters without `validFrom` columns).
      */
@@ -172,7 +172,7 @@ declare class EntitlementService {
  * point in time. Active = `canceledEffectiveAt === null` or
  * `canceledEffectiveAt > now`.
  *
- * Spec: SPEC_V2 §11.1 M6 Pack 2e + P11.7.3.
+ * Spec:
  */
 declare function filterActiveSubscriptionBundles(bundles: readonly SubscriptionBundleSnapshot[], now: Date): SubscriptionBundleSnapshot[];
 /**

package/dist/{aggregation-SKfXu09x.d.cts → aggregation-mZ7WZROK.d.cts}

@@ -16,7 +16,7 @@ interface PlanVersionSnapshot {
 }
 /**
  * Snapshot of an active SubscriptionBundle booking (P11.7.3 +
- * SPEC_V2 §11.1 M6 Pack 2e). Resolved by the EntitlementService from the
+ *). Resolved by the EntitlementService from the
  * `subscription_bundles` junction + BundleRepository.findVersionById and
  * passed to `aggregateLimits`.
  *
@@ -158,7 +158,7 @@ declare class EntitlementService {
     enforceLimit<T>(input: EnforceLimitInput<T>): Promise<T>;
     /**
      * Plan fallback for TRIAL/PENDING_SALES: returns the PlanVersion active
-     * as of `asOf` (SPEC_V2 §4.2). If the repo does not implement
+     * as of `asOf`. If the repo does not implement
      * `findActive`, we fall back to `findLatestLive` (backward compat for
      * adapters without `validFrom` columns).
      */
@@ -172,7 +172,7 @@ declare class EntitlementService {
  * point in time. Active = `canceledEffectiveAt === null` or
  * `canceledEffectiveAt > now`.
  *
- * Spec: SPEC_V2 §11.1 M6 Pack 2e + P11.7.3.
+ * Spec:
  */
 declare function filterActiveSubscriptionBundles(bundles: readonly SubscriptionBundleSnapshot[], now: Date): SubscriptionBundleSnapshot[];
 /**

package/dist/billing/index.d.cts

@@ -4,11 +4,11 @@ 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-SKfXu09x.cjs';
+import { c as EntitlementService } from '../aggregation-mZ7WZROK.cjs';
 import { P as ProviderSpec } from '../di-CcNeq9v-.cjs';
 import { f as ContractFreezePort, g as ContractFreezeSourcePort } from '../subscription-bundles.module-DCpV-Pb5.cjs';
 export { A as AUDIT_CONTEXT_RESOLVER_TOKEN, a as AuditContextResolver, b as AuthGuardList, C as CONTRACT_FREEZE_PORT_TOKEN, c as CONTRACT_FREEZE_PROJECT_KEY_TOKEN, d as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, e as ContractFreezeBundleSnapshot, D as DuePendingPlanChange, 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 SelfServiceBlockedPlans, n as SubscriptionBundleControllerOptions, o as SubscriptionBundleModule, p as SubscriptionBundleModuleOptions, T as TENANT_AUTH_GUARDS_TOKEN, q as TENANT_ID_RESOLVER_TOKEN, r as TRIAL_PROJECTION_PORT_TOKEN, s as TenantBillingModule, t as TenantBillingModuleOptions, u as TenantIdResolver, v as TrialProjectionInput, w as TrialProjectionPort, U as USAGE_SNAPSHOT_PORT_TOKEN, x as USER_EMAIL_RESOLVER_TOKEN, y as USER_ID_RESOLVER_TOKEN, z as UserEmailResolver, B as UserIdResolver } from '../subscription-bundles.module-DCpV-Pb5.cjs';
-export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as ChangePlanDto, c as CompleteOnboardingSubscriptionDto, d as ComposedTenantAuthGuard, L as LimitsCheckRow, P as PendingPlanMaterializationService, e as PlanChangeContext, f as PlanChangePreviewDto, g as PlanChangePreviewIssue, h as PlanChangePreviewService, i as PlanChangeType, j as PlanSnapshotDto, k as PreviewPlanChangeDto, l as ProrationDto, m as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, n as SubscriptionBundleCancelPreviewDto, o as SubscriptionBundleConfig, p as SubscriptionBundlePreviewContext, q as SubscriptionBundlePreviewIssue, r as SubscriptionBundlePreviewService, s as SubscriptionBundlesService, T as TenantAdminGuard, t as TenantBillingController, U as UsageResponse, u as addMonths, v as computeProration, w as resolveBundleCancelEffectiveAt, x as resolveBundlePriceNet } from '../tenant-billing.controller-BIF-mstX.cjs';
+export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as ChangePlanDto, c as CompleteOnboardingSubscriptionDto, d as ComposedTenantAuthGuard, L as LimitsCheckRow, P as PendingPlanMaterializationService, e as PlanChangeContext, f as PlanChangePreviewDto, g as PlanChangePreviewIssue, h as PlanChangePreviewService, i as PlanChangeType, j as PlanSnapshotDto, k as PreviewPlanChangeDto, l as ProrationDto, m as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, n as SubscriptionBundleCancelPreviewDto, o as SubscriptionBundleConfig, p as SubscriptionBundlePreviewContext, q as SubscriptionBundlePreviewIssue, r as SubscriptionBundlePreviewService, s as SubscriptionBundlesService, T as TenantAdminGuard, t as TenantBillingController, U as UsageResponse, u as addMonths, v as computeProration, w as resolveBundleCancelEffectiveAt, x as resolveBundlePriceNet } from '../tenant-billing.controller-DubP6-Md.cjs';
 import { S as SubscriptionContractService } from '../subscription-contract.service--cm47ZJJ.cjs';
 import '../plan-resolution-CFCoUkrE.cjs';
 import '../service-D48clObR.cjs';
@@ -304,7 +304,7 @@ interface PlanCatalogModuleOptions {
     currency: string;
     vatRate: number;
     /**
-     * App-wide marketing configuration (SPEC_V2 §6.5) — including the
+     * App-wide marketing configuration — including the
      * `availableLocales` pool. Flows into `PLAN_CATALOG_TOKEN.marketing`
      * and from there into the admin manifest (`project.availableLocales`).
      */
@@ -334,7 +334,7 @@ interface PlanCatalogBuildSettings {
     app?: PlanCatalog['app'];
     currency: string;
     vatRate: number;
-    /** App-wide marketing configuration (SPEC_V2 §6.5). Optional. */
+    /** App-wide marketing configuration. Optional. */
     marketing?: PlanCatalog['marketing'];
 }
 declare function buildPlanCatalogFromSnapshot(settings: PlanCatalogBuildSettings, snapshot: PlanCatalogReadSnapshot): PlanCatalog;
@@ -467,7 +467,7 @@ interface PlanResponseEntry {
     popular: boolean;
     quotas: Record<string, number>;
     features: string[];
-    /** SPEC_V2 §11.1 M6 — optional, present if a MarketingProjection exists. */
+    /** — optional, present if a MarketingProjection exists. */
     marketing?: MarketingFields;
 }
 interface PublicBundleEntry {
@@ -500,7 +500,7 @@ declare class PublicCatalogController {
     listPlans(lang?: string, localeParam?: string): Promise<PlanResponseEntry[]>;
     listFeatureRegistry(): Promise<FeatureUiRegistry>;
     /**
-     * SPEC_V2 §11.1 M6 Pack 2c — public catalog endpoint for bundles
+     * — public catalog endpoint for bundles
      * (stem list with live versions). If a `MarketingProjection` with
      * `targetType=BUNDLE` + matching locale exists, it is merged in.
      */
@@ -520,7 +520,7 @@ interface PublicCatalogModuleOptions {
     /** Required: consumer-specific FeatureUiRegistry. */
     featureUiRegistry: FeatureUiRegistry;
     /**
-     * SPEC_V2 §11.1 M6 Pack 2c — app identity (e.g. "clubapp"). Used
+     * — app identity (e.g. "clubapp"). Used
      * for marketing lookups + bundle filters.
      * Optional; if omitted, the new endpoints return empty lists.
      */

package/dist/billing/index.d.ts

@@ -4,11 +4,11 @@ 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-o0LMenvl.js';
+import { c as EntitlementService } from '../aggregation-DP5zfKbU.js';
 import { P as ProviderSpec } from '../di-CcNeq9v-.js';
 import { f as ContractFreezePort, g as ContractFreezeSourcePort } from '../subscription-bundles.module-BQmoozm5.js';
 export { A as AUDIT_CONTEXT_RESOLVER_TOKEN, a as AuditContextResolver, b as AuthGuardList, C as CONTRACT_FREEZE_PORT_TOKEN, c as CONTRACT_FREEZE_PROJECT_KEY_TOKEN, d as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, e as ContractFreezeBundleSnapshot, D as DuePendingPlanChange, 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 SelfServiceBlockedPlans, n as SubscriptionBundleControllerOptions, o as SubscriptionBundleModule, p as SubscriptionBundleModuleOptions, T as TENANT_AUTH_GUARDS_TOKEN, q as TENANT_ID_RESOLVER_TOKEN, r as TRIAL_PROJECTION_PORT_TOKEN, s as TenantBillingModule, t as TenantBillingModuleOptions, u as TenantIdResolver, v as TrialProjectionInput, w as TrialProjectionPort, U as USAGE_SNAPSHOT_PORT_TOKEN, x as USER_EMAIL_RESOLVER_TOKEN, y as USER_ID_RESOLVER_TOKEN, z as UserEmailResolver, B as UserIdResolver } from '../subscription-bundles.module-BQmoozm5.js';
-export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as ChangePlanDto, c as CompleteOnboardingSubscriptionDto, d as ComposedTenantAuthGuard, L as LimitsCheckRow, P as PendingPlanMaterializationService, e as PlanChangeContext, f as PlanChangePreviewDto, g as PlanChangePreviewIssue, h as PlanChangePreviewService, i as PlanChangeType, j as PlanSnapshotDto, k as PreviewPlanChangeDto, l as ProrationDto, m as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, n as SubscriptionBundleCancelPreviewDto, o as SubscriptionBundleConfig, p as SubscriptionBundlePreviewContext, q as SubscriptionBundlePreviewIssue, r as SubscriptionBundlePreviewService, s as SubscriptionBundlesService, T as TenantAdminGuard, t as TenantBillingController, U as UsageResponse, u as addMonths, v as computeProration, w as resolveBundleCancelEffectiveAt, x as resolveBundlePriceNet } from '../tenant-billing.controller-DT5UrnDX.js';
+export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as ChangePlanDto, c as CompleteOnboardingSubscriptionDto, d as ComposedTenantAuthGuard, L as LimitsCheckRow, P as PendingPlanMaterializationService, e as PlanChangeContext, f as PlanChangePreviewDto, g as PlanChangePreviewIssue, h as PlanChangePreviewService, i as PlanChangeType, j as PlanSnapshotDto, k as PreviewPlanChangeDto, l as ProrationDto, m as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, n as SubscriptionBundleCancelPreviewDto, o as SubscriptionBundleConfig, p as SubscriptionBundlePreviewContext, q as SubscriptionBundlePreviewIssue, r as SubscriptionBundlePreviewService, s as SubscriptionBundlesService, T as TenantAdminGuard, t as TenantBillingController, U as UsageResponse, u as addMonths, v as computeProration, w as resolveBundleCancelEffectiveAt, x as resolveBundlePriceNet } from '../tenant-billing.controller-7o4ObzGs.js';
 import { S as SubscriptionContractService } from '../subscription-contract.service--cm47ZJJ.js';
 import '../plan-resolution-CFCoUkrE.js';
 import '../service-D48clObR.js';
@@ -304,7 +304,7 @@ interface PlanCatalogModuleOptions {
     currency: string;
     vatRate: number;
     /**
-     * App-wide marketing configuration (SPEC_V2 §6.5) — including the
+     * App-wide marketing configuration — including the
      * `availableLocales` pool. Flows into `PLAN_CATALOG_TOKEN.marketing`
      * and from there into the admin manifest (`project.availableLocales`).
      */
@@ -334,7 +334,7 @@ interface PlanCatalogBuildSettings {
     app?: PlanCatalog['app'];
     currency: string;
     vatRate: number;
-    /** App-wide marketing configuration (SPEC_V2 §6.5). Optional. */
+    /** App-wide marketing configuration. Optional. */
     marketing?: PlanCatalog['marketing'];
 }
 declare function buildPlanCatalogFromSnapshot(settings: PlanCatalogBuildSettings, snapshot: PlanCatalogReadSnapshot): PlanCatalog;
@@ -467,7 +467,7 @@ interface PlanResponseEntry {
     popular: boolean;
     quotas: Record<string, number>;
     features: string[];
-    /** SPEC_V2 §11.1 M6 — optional, present if a MarketingProjection exists. */
+    /** — optional, present if a MarketingProjection exists. */
     marketing?: MarketingFields;
 }
 interface PublicBundleEntry {
@@ -500,7 +500,7 @@ declare class PublicCatalogController {
     listPlans(lang?: string, localeParam?: string): Promise<PlanResponseEntry[]>;
     listFeatureRegistry(): Promise<FeatureUiRegistry>;
     /**
-     * SPEC_V2 §11.1 M6 Pack 2c — public catalog endpoint for bundles
+     * — public catalog endpoint for bundles
      * (stem list with live versions). If a `MarketingProjection` with
      * `targetType=BUNDLE` + matching locale exists, it is merged in.
      */
@@ -520,7 +520,7 @@ interface PublicCatalogModuleOptions {
     /** Required: consumer-specific FeatureUiRegistry. */
     featureUiRegistry: FeatureUiRegistry;
     /**
-     * SPEC_V2 §11.1 M6 Pack 2c — app identity (e.g. "clubapp"). Used
+     * — app identity (e.g. "clubapp"). Used
      * for marketing lookups + bundle filters.
      * Optional; if omitted, the new endpoints return empty lists.
      */

package/dist/billing/index.js

@@ -58,7 +58,7 @@ import {
   periodEndWithMinLead,
   resolveBundleCancelEffectiveAt,
   resolveBundlePriceNet
-} from "../chunk-NZLAYCEX.js";
+} from "../chunk-UO64MK3Q.js";
 import "../chunk-VQQWF7MW.js";
 import "../chunk-B7NRY2LV.js";
 import {
@@ -81,7 +81,7 @@ import "../chunk-YSC46BGM.js";
 import {
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "../chunk-AGOG5B77.js";
+} from "../chunk-NNNXXUPT.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
   PLAN_CATALOG_TOKEN,

package/dist/catalog/index.d.cts

@@ -1,6 +1,6 @@
-export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-CUR2Whyr.cjs';
+export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-_saKzb50.cjs';
 import { Type, CanActivate } from '@nestjs/common';
-export { C as CatalogControllerConfig, a as CatalogModule, b as CatalogModuleOptions } from '../catalog.module-Dw2Hrbyu.cjs';
+export { C as CatalogControllerConfig, a as CatalogModule, b as CatalogModuleOptions } from '../catalog.module-D-_pQDNA.cjs';
 import { StrictModeWarningCode, StrictModeWarning, DiscoverySnapshot, ApprovedCatalogKeys, DiscoveredQuota, CatalogEntryRepository, PlanVersionRow, BundleVersionRow, DiscoveryStatus, CatalogEntryI18n, PromotionType, PromotionValue, PromotionTargetType, PromotionBillingCycle, PromotionI18n } from '@saasicat/types';
 import '../discovery.scanner-DLgEvuoy.cjs';
 import '@nestjs/core';
@@ -36,7 +36,7 @@ declare function buildPlansController(guards: Array<Type<CanActivate>>): Type;
  */
 declare function buildPlanVersionsController(guards: Array<Type<CanActivate>>): Type;
 
-/** Repository for `plans` (SPEC_V2 §11.1 M6 — Plan master CRUD). */
+/** Repository for `plans` (Plan master CRUD). */
 declare const PLAN_REPOSITORY_TOKEN: unique symbol;
 /** Repository for `bundles` + `bundle_versions`. */
 declare const BUNDLE_REPOSITORY_TOKEN: unique symbol;
@@ -44,12 +44,12 @@ declare const BUNDLE_REPOSITORY_TOKEN: unique symbol;
 declare const MARKETING_PROJECTION_REPOSITORY_TOKEN: unique symbol;
 /**
  * Repository for `capability_catalog_entries`, `feature_catalog_entries`
- * and `quota_catalog_entries` (Discovery review, SPEC_V2 §6.3).
+ * and `quota_catalog_entries` (Discovery review).
  */
 declare const CATALOG_ENTRY_REPOSITORY_TOKEN: unique symbol;
-/** Repository for `promotions` (time-scheduled price campaigns, SPEC_V2 §9a). */
+/** Repository for `promotions` (time-scheduled price campaigns). */
 declare const PROMOTION_REPOSITORY_TOKEN: unique symbol;
-/** Repository for `marketing_settings` (activeLocales, SPEC_V2 §6.5). */
+/** Repository for `marketing_settings` (activeLocales). */
 declare const MARKETING_SETTINGS_REPOSITORY_TOKEN: unique symbol;
 /**
  * Service configuration: current app identity, strict mode.
@@ -105,7 +105,7 @@ declare function validateBundleDraft(draft: {
 }, snapshot: DiscoverySnapshot, knownPlanKeys?: Set<string> | null, marketedOnlyFeatures?: ReadonlySet<string>, approved?: ApprovedCatalogKeys | null): StrictModeWarning[];
 /**
  * Validates a PlanVersion draft definition against the discovery snapshot
- * (SPEC_V2 §8.2 Pack 3a). Returns a (possibly empty) list of
+ *. Returns a (possibly empty) list of
  * warnings.
  *
  * Checked:
@@ -347,7 +347,7 @@ declare class PublishBundleVersionDto {
     allowZeroPrice?: boolean;
     /**
      * Required on publish if the draft carries no `validFrom`
-     * (SPEC_V2 §4.2 + §11.1 M6 Pack 2c, analogous to PublishPlanVersionDto).
+     * (analogous to PublishPlanVersionDto).
      * Service strictly checks > `validFrom` of the predecessor version.
      */
     validFrom?: string | null;
@@ -502,7 +502,7 @@ declare class CreatePlanVersionDraftDto {
     marketed?: boolean;
     changeNote?: string;
     baseVersionId?: string | null;
-    /** Optional in the draft (required at publish). ISO date string. SPEC_V2 §4.2. */
+    /** Optional in the draft (required at publish). ISO date string.. */
     validFrom?: string | null;
     /** Optional; null = unlimited. ISO date string. */
     validUntil?: string | null;
@@ -529,7 +529,7 @@ declare class PublishPlanVersionDto {
     allowZeroPrice?: boolean;
     /**
      * Required at publish (on the DTO or draft). The service strictly checks
-     * `validFrom > predecessor.validFrom`. SPEC_V2 §4.2.
+     * `validFrom > predecessor.validFrom`..
      */
     validFrom?: string | null;
     validUntil?: string | null;

package/dist/catalog/index.d.ts

@@ -1,6 +1,6 @@
-export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-BB36Q1bg.js';
+export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-B-YoE4SZ.js';
 import { Type, CanActivate } from '@nestjs/common';
-export { C as CatalogControllerConfig, a as CatalogModule, b as CatalogModuleOptions } from '../catalog.module-BKObceo0.js';
+export { C as CatalogControllerConfig, a as CatalogModule, b as CatalogModuleOptions } from '../catalog.module-CQr1FpkI.js';
 import { StrictModeWarningCode, StrictModeWarning, DiscoverySnapshot, ApprovedCatalogKeys, DiscoveredQuota, CatalogEntryRepository, PlanVersionRow, BundleVersionRow, DiscoveryStatus, CatalogEntryI18n, PromotionType, PromotionValue, PromotionTargetType, PromotionBillingCycle, PromotionI18n } from '@saasicat/types';
 import '../discovery.scanner-DLgEvuoy.js';
 import '@nestjs/core';
@@ -36,7 +36,7 @@ declare function buildPlansController(guards: Array<Type<CanActivate>>): Type;
  */
 declare function buildPlanVersionsController(guards: Array<Type<CanActivate>>): Type;
 
-/** Repository for `plans` (SPEC_V2 §11.1 M6 — Plan master CRUD). */
+/** Repository for `plans` (Plan master CRUD). */
 declare const PLAN_REPOSITORY_TOKEN: unique symbol;
 /** Repository for `bundles` + `bundle_versions`. */
 declare const BUNDLE_REPOSITORY_TOKEN: unique symbol;
@@ -44,12 +44,12 @@ declare const BUNDLE_REPOSITORY_TOKEN: unique symbol;
 declare const MARKETING_PROJECTION_REPOSITORY_TOKEN: unique symbol;
 /**
  * Repository for `capability_catalog_entries`, `feature_catalog_entries`
- * and `quota_catalog_entries` (Discovery review, SPEC_V2 §6.3).
+ * and `quota_catalog_entries` (Discovery review).
  */
 declare const CATALOG_ENTRY_REPOSITORY_TOKEN: unique symbol;
-/** Repository for `promotions` (time-scheduled price campaigns, SPEC_V2 §9a). */
+/** Repository for `promotions` (time-scheduled price campaigns). */
 declare const PROMOTION_REPOSITORY_TOKEN: unique symbol;
-/** Repository for `marketing_settings` (activeLocales, SPEC_V2 §6.5). */
+/** Repository for `marketing_settings` (activeLocales). */
 declare const MARKETING_SETTINGS_REPOSITORY_TOKEN: unique symbol;
 /**
  * Service configuration: current app identity, strict mode.
@@ -105,7 +105,7 @@ declare function validateBundleDraft(draft: {
 }, snapshot: DiscoverySnapshot, knownPlanKeys?: Set<string> | null, marketedOnlyFeatures?: ReadonlySet<string>, approved?: ApprovedCatalogKeys | null): StrictModeWarning[];
 /**
  * Validates a PlanVersion draft definition against the discovery snapshot
- * (SPEC_V2 §8.2 Pack 3a). Returns a (possibly empty) list of
+ *. Returns a (possibly empty) list of
  * warnings.
  *
  * Checked:
@@ -347,7 +347,7 @@ declare class PublishBundleVersionDto {
     allowZeroPrice?: boolean;
     /**
      * Required on publish if the draft carries no `validFrom`
-     * (SPEC_V2 §4.2 + §11.1 M6 Pack 2c, analogous to PublishPlanVersionDto).
+     * (analogous to PublishPlanVersionDto).
      * Service strictly checks > `validFrom` of the predecessor version.
      */
     validFrom?: string | null;
@@ -502,7 +502,7 @@ declare class CreatePlanVersionDraftDto {
     marketed?: boolean;
     changeNote?: string;
     baseVersionId?: string | null;
-    /** Optional in the draft (required at publish). ISO date string. SPEC_V2 §4.2. */
+    /** Optional in the draft (required at publish). ISO date string.. */
     validFrom?: string | null;
     /** Optional; null = unlimited. ISO date string. */
     validUntil?: string | null;
@@ -529,7 +529,7 @@ declare class PublishPlanVersionDto {
     allowZeroPrice?: boolean;
     /**
      * Required at publish (on the DTO or draft). The service strictly checks
-     * `validFrom > predecessor.validFrom`. SPEC_V2 §4.2.
+     * `validFrom > predecessor.validFrom`..
      */
     validFrom?: string | null;
     validUntil?: string | null;

package/dist/catalog/index.js

@@ -6,7 +6,7 @@ import {
   runSeedGateFromFile,
   seedGateExitCode,
   validateSeedAgainstSnapshot
-} from "../chunk-55QGAZRQ.js";
+} from "../chunk-7ZPFQXHM.js";
 import "../chunk-74SCJ4HF.js";
 import {
   ADVISORY_STRICT_MODE_CODES,
@@ -56,7 +56,7 @@ import {
   quotaApprovalSignature,
   validateBundleDraft,
   validatePlanDraft
-} from "../chunk-GC5AKN44.js";
+} from "../chunk-7X5MSAIL.js";
 import "../chunk-WPUVJRIN.js";
 import "../chunk-E56W4U2P.js";
 import "../chunk-YSC46BGM.js";

package/dist/{catalog.module-BKObceo0.d.ts → catalog.module-CQr1FpkI.d.ts}

@@ -21,23 +21,23 @@ interface CatalogModuleOptions {
     marketingProjectionRepository?: ProviderSpec<MarketingProjectionRepository>;
     /**
      * Adapter for `capability_/feature_/quota_catalog_entries` persistence
-     * (discovery review, SPEC_V2 §6.3). Optional — if omitted,
+     * (discovery review). Optional — if omitted,
      * CatalogEntriesService + controller are not registered.
      */
     catalogEntryRepository?: ProviderSpec<CatalogEntryRepository>;
     /**
-     * Adapter for `promotions` persistence (SPEC_V2 §9a). Optional — if
+     * Adapter for `promotions` persistence. Optional — if
      * omitted, PromotionsService + controller are not registered.
      */
     promotionRepository?: ProviderSpec<PromotionRepository>;
     /**
-     * Adapter for `marketing_settings` persistence (SPEC_V2 §6.5 —
+     * Adapter for `marketing_settings` persistence (
      * `activeLocales`). Optional.
      */
     marketingSettingsRepository?: ProviderSpec<MarketingSettingsRepository>;
     /**
      * Auth-free pricing-page endpoint `GET /public/marketing-catalog`
-     * (SPEC_V2 §9). Registered only when plan-, marketingProjection-
+     *. Registered only when plan-, marketingProjection-
      * and promotionRepository are set. `guards` is usually `[]`.
      */
     publicMarketingCatalog?: {
@@ -47,7 +47,7 @@ interface CatalogModuleOptions {
         vatRate: number;
     };
     /**
-     * SPEC_V2 §11.1 M6 (Pack 1) — adapter for `plans` master-record persistence.
+     * — adapter for `plans` master-record persistence.
      * Optional; if omitted, PlansService + controller are not
      * registered (apps without a need for the plan editor stay unchanged).
      */
@@ -82,7 +82,7 @@ interface CatalogModuleOptions {
      * per feature — the same one passed to `PublicCatalogModule.forRoot`). The
      * discovery auto-sync seeds EMPTY `FeatureCatalogEntry` fields
      * (label/description/icon) from it at boot; SuperAdmin edits stay untouched. This
-     * makes `FeatureCatalogEntry` the SSOT for UI metadata (SPEC_V2 §6.3 / #12).
+     * makes `FeatureCatalogEntry` the SSOT for UI metadata.
      */
     featureUiRegistry?: FeatureUiRegistry;
     /**

package/dist/{catalog.module-Dw2Hrbyu.d.cts → catalog.module-D-_pQDNA.d.cts}

@@ -21,23 +21,23 @@ interface CatalogModuleOptions {
     marketingProjectionRepository?: ProviderSpec<MarketingProjectionRepository>;
     /**
      * Adapter for `capability_/feature_/quota_catalog_entries` persistence
-     * (discovery review, SPEC_V2 §6.3). Optional — if omitted,
+     * (discovery review). Optional — if omitted,
      * CatalogEntriesService + controller are not registered.
      */
     catalogEntryRepository?: ProviderSpec<CatalogEntryRepository>;
     /**
-     * Adapter for `promotions` persistence (SPEC_V2 §9a). Optional — if
+     * Adapter for `promotions` persistence. Optional — if
      * omitted, PromotionsService + controller are not registered.
      */
     promotionRepository?: ProviderSpec<PromotionRepository>;
     /**
-     * Adapter for `marketing_settings` persistence (SPEC_V2 §6.5 —
+     * Adapter for `marketing_settings` persistence (
      * `activeLocales`). Optional.
      */
     marketingSettingsRepository?: ProviderSpec<MarketingSettingsRepository>;
     /**
      * Auth-free pricing-page endpoint `GET /public/marketing-catalog`
-     * (SPEC_V2 §9). Registered only when plan-, marketingProjection-
+     *. Registered only when plan-, marketingProjection-
      * and promotionRepository are set. `guards` is usually `[]`.
      */
     publicMarketingCatalog?: {
@@ -47,7 +47,7 @@ interface CatalogModuleOptions {
         vatRate: number;
     };
     /**
-     * SPEC_V2 §11.1 M6 (Pack 1) — adapter for `plans` master-record persistence.
+     * — adapter for `plans` master-record persistence.
      * Optional; if omitted, PlansService + controller are not
      * registered (apps without a need for the plan editor stay unchanged).
      */
@@ -82,7 +82,7 @@ interface CatalogModuleOptions {
      * per feature — the same one passed to `PublicCatalogModule.forRoot`). The
      * discovery auto-sync seeds EMPTY `FeatureCatalogEntry` fields
      * (label/description/icon) from it at boot; SuperAdmin edits stay untouched. This
-     * makes `FeatureCatalogEntry` the SSOT for UI metadata (SPEC_V2 §6.3 / #12).
+     * makes `FeatureCatalogEntry` the SSOT for UI metadata.
      */
     featureUiRegistry?: FeatureUiRegistry;
     /**