@saasicat/nest 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/{plan-versions.service-TPEtbN0r.d.cts → plan-versions.service-DARLh-qI.d.cts}

@@ -1,6 +1,6 @@
-import { BundleRepository, DiscoverySnapshot, SubscriptionRepository, PlanRepository, CatalogEntryRepository, BundleRow, BundleVersionRow, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, PublishBundleVersionData, MarketingProjectionRepository, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, FeatureUiRegistry, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, SyncDiscoveryResult, PromotionRepository, PromotionRow, CreatePromotionData, UpdatePromotionData, MarketingSettingsRepository, MarketingSettingsRow, UpdateMarketingSettingsData, PublicMarketingCatalogResponse, PlanRow, CreatePlanData, UpdatePlanData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PublishPlanVersionData } from '@saasicat/core';
+import { BundleRepository, DiscoverySnapshot, SubscriptionRepository, PlanRepository, CatalogEntryRepository, BundleRow, BundleVersionRow, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, PublishBundleVersionData, MarketingProjectionRepository, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, FeatureUiRegistry, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, SyncDiscoveryResult, PromotionRepository, PromotionRow, CreatePromotionData, UpdatePromotionData, MarketingSettingsRepository, MarketingSettingsRow, UpdateMarketingSettingsData, PlanRow, CreatePlanData, UpdatePlanData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PublishPlanVersionData } from '@saasicat/core';
 import { OnApplicationBootstrap } from '@nestjs/common';
-import { c as DiscoveryScanner } from './discovery.scanner-9cMqF95o.cjs';
+import { a as DiscoveryScanner } from './discovery.scanner-DXKc6JkV.cjs';
 
 /**
  * Configuration for the mutating operations.
@@ -36,7 +36,7 @@ declare class BundlesService {
     private mode;
     private readonly marketedOnly;
     constructor(repo: BundleRepository, snapshot?: DiscoverySnapshot | null, config?: CatalogServiceConfig, subscriptions?: SubscriptionRepository | null, planRepo?: PlanRepository | null, scanner?: DiscoveryScanner | null, catalogEntries?: CatalogEntryRepository | null);
-    listBundles(projectKey: string): Promise<BundleRow[]>;
+    listBundles(): Promise<BundleRow[]>;
     getBundle(bundleId: string): Promise<{
         bundle: BundleRow;
         versions: BundleVersionRow[];
@@ -90,6 +90,26 @@ declare class BundlesService {
      */
     publishBundleVersion(versionId: string, publishMeta: PublishBundleVersionData): Promise<BundleVersionMutationResult>;
     private runStrictCheck;
+    /**
+     * Refuses a version that a plan it is offered to could not actually buy.
+     *
+     * "Some price resolves" is not the same as "this plan, in the rhythm it is
+     * sold in, resolves one". A bundle priced monthly only, offered to a plan
+     * that is sold yearly, passes the first test and fails the second — and the
+     * failure surfaces at a tenant's checkout rather than at the operator's
+     * desk, which is the wrong end of the mistake.
+     *
+     * The expectation comes from the catalog, not from a list: the plans are
+     * whichever the compatibility declares (empty = every plan), and the cycles
+     * are whichever each plan version carries a price for. Add a third cycle to
+     * the catalog one day and this asks about it without being told.
+     *
+     * Skipped where no plan repository is bound — a consumer without one has no
+     * catalog to derive from, and guessing would refuse valid bundles.
+     */
+    private refuseUnsellableToACompatiblePlan;
+    /** The live version of a plan, or null where the port cannot answer. */
+    private liveVersionOf;
     private gateOrPass;
     private assertBundleVersionWindowUpdate;
     private findPreviousBundleVersion;
@@ -123,25 +143,25 @@ declare class CatalogEntriesService implements OnApplicationBootstrap {
      * `POST /admin/catalog/discovery/sync` remains as a fallback.
      */
     onApplicationBootstrap(): Promise<void>;
-    listCapabilities(projectKey: string, codeStatus?: string): Promise<CapabilityCatalogEntryRow[]>;
-    listFeatures(projectKey: string, discoveryStatus?: string): Promise<FeatureCatalogEntryRow[]>;
-    listQuotas(projectKey: string, discoveryStatus?: string): Promise<QuotaCatalogEntryRow[]>;
+    listCapabilities(codeStatus?: string): Promise<CapabilityCatalogEntryRow[]>;
+    listFeatures(discoveryStatus?: string): Promise<FeatureCatalogEntryRow[]>;
+    listQuotas(discoveryStatus?: string): Promise<QuotaCatalogEntryRow[]>;
     /**
      * Approval transition of a feature (#20). Validates the state machine;
      * `approved` persists the approval signature from the current
      * snapshot, `pending` (revoke/reactivate) deletes it, `outdated`/
      * `obsolete` keep the last approval as history.
      */
-    reviewFeature(projectKey: string, featureKey: string, data: ReviewCatalogEntryData, reviewedBy: string | null): Promise<FeatureCatalogEntryRow>;
+    reviewFeature(featureKey: string, data: ReviewCatalogEntryData, reviewedBy: string | null): Promise<FeatureCatalogEntryRow>;
     /** Approval transition of a quota — same state machine as features (#20). */
-    reviewQuota(projectKey: string, quotaKey: string, data: ReviewCatalogEntryData, reviewedBy: string | null): Promise<QuotaCatalogEntryRow>;
+    reviewQuota(quotaKey: string, data: ReviewCatalogEntryData, reviewedBy: string | null): Promise<QuotaCatalogEntryRow>;
     private resolveReviewUpdate;
-    setFeatureI18n(projectKey: string, featureKey: string, i18n: CatalogEntryI18n): Promise<FeatureCatalogEntryRow>;
-    setQuotaI18n(projectKey: string, quotaKey: string, i18n: CatalogEntryI18n): Promise<QuotaCatalogEntryRow>;
+    setFeatureI18n(featureKey: string, i18n: CatalogEntryI18n): Promise<FeatureCatalogEntryRow>;
+    setQuotaI18n(quotaKey: string, i18n: CatalogEntryI18n): Promise<QuotaCatalogEntryRow>;
     /** Sets the editable default-locale label/description of a feature. */
-    setFeatureBase(projectKey: string, featureKey: string, data: UpdateCatalogEntryBaseData): Promise<FeatureCatalogEntryRow>;
+    setFeatureBase(featureKey: string, data: UpdateCatalogEntryBaseData): Promise<FeatureCatalogEntryRow>;
     /** Sets the editable default-locale label/description of a quota. */
-    setQuotaBase(projectKey: string, quotaKey: string, data: UpdateCatalogEntryBaseData): Promise<QuotaCatalogEntryRow>;
+    setQuotaBase(quotaKey: string, data: UpdateCatalogEntryBaseData): Promise<QuotaCatalogEntryRow>;
     /**
      * Synchronizes the catalog entries from a discovery snapshot.
      * Idempotent — can run against the same snapshot any number of times.
@@ -161,7 +181,7 @@ declare class CatalogEntriesService implements OnApplicationBootstrap {
 declare class PromotionsService {
     private readonly repo;
     constructor(repo: PromotionRepository);
-    list(projectKey: string): Promise<PromotionRow[]>;
+    list(): Promise<PromotionRow[]>;
     getById(id: string): Promise<PromotionRow>;
     create(data: CreatePromotionData): Promise<PromotionRow>;
     update(id: string, data: UpdatePromotionData): Promise<PromotionRow>;
@@ -172,54 +192,8 @@ declare class MarketingSettingsService {
     private readonly repo;
     constructor(repo: MarketingSettingsRepository);
     /** Returns the stored config or `null` (in which case the full pool applies). */
-    get(projectKey: string): Promise<MarketingSettingsRow | null>;
-    upsert(projectKey: string, data: UpdateMarketingSettingsData): Promise<MarketingSettingsRow>;
-}
-
-declare class PublicMarketingCatalogService {
-    private readonly planRepo;
-    private readonly marketingRepo;
-    private readonly promotionRepo;
-    private readonly catalogEntryRepo;
-    private readonly bundleRepo;
-    constructor(planRepo: PlanRepository, marketingRepo: MarketingProjectionRepository, promotionRepo: PromotionRepository, catalogEntryRepo?: CatalogEntryRepository | null, bundleRepo?: BundleRepository | null);
-    getCatalog(projectKey: string, locale: string, currency: string, vatRate: number, asOf?: Date): Promise<PublicMarketingCatalogResponse>;
-    /**
-     * Loads all published-and-live bundle versions for a project and
-     * filters on `marketed === true`. Without a registered
-     * `BundleRepository` (apps without the SuperAdmin bundle editor) the
-     * list is empty — the public catalog stays plan-only.
-     */
-    private loadMarketedBundles;
-    /**
-     * Maps BundleVersionRow → PublicMarketingBundle. Locale resolution
-     * runs via `MarketingProjectionRepository.findByTarget('BUNDLE',
-     * bundleVersionId, locale)` — on a miss it falls back to
-     * `DEFAULT_LOCALE`. If the fallback is missing too, label/description
-     * come directly from the bundle root (denormalized in `BundleVersionRow`).
-     *
-     * If the marketing projection is `visible === false`, the bundle is
-     * hidden from the public response (preparation phase).
-     */
-    private toPublicBundle;
-    /**
-     * Labels for bundle features ∪ their requires (#48): `comparison.features`
-     * only covers the plan-feature union — bundle-only features would
-     * otherwise get no label in the public payload. Curated keys only;
-     * without a CatalogEntryRepository the map stays empty (frontends fall
-     * back to the key).
-     */
-    private resolveBundleFeatureLabels;
-    /** Loads the translated feature/quota labels (+ sortOrder) for a locale. */
-    private loadLabelMeta;
-    /**
-     * Resolves the displayed label of a top feature: the `label` override
-     * wins; otherwise the translated label of the referenced `key`.
-     */
-    private resolveTopFeature;
-    /** Row definitions of the comparison matrix (feature/quota union + labels). */
-    private buildComparison;
-    private resolvePromo;
+    get(): Promise<MarketingSettingsRow | null>;
+    upsert(data: UpdateMarketingSettingsData): Promise<MarketingSettingsRow>;
 }
 
 declare class PlansService {
@@ -233,8 +207,8 @@ declare class PlansService {
      * `SubscriptionRepository` is registered or it does not implement
      * `countActiveByPlanKey`.
      */
-    getTenantCounts(projectKey: string): Promise<Record<string, number>>;
-    listPlans(projectKey: string, opts?: {
+    getTenantCounts(): Promise<Record<string, number>>;
+    listPlans(opts?: {
         onlyPublished?: boolean;
     }): Promise<PlanRow[]>;
     getPlan(planId: string): Promise<PlanRow>;
@@ -326,4 +300,4 @@ declare class PlanVersionsService {
     private gateOrPass;
 }
 
-export { BundlesService as B, CatalogEntriesService as C, MarketingProjectionsService as M, PlanVersionsService as P, type CatalogServiceConfig as a, MarketingSettingsService as b, PlansService as c, PromotionsService as d, PublicMarketingCatalogService as e };
+export { BundlesService as B, CatalogEntriesService as C, MarketingProjectionsService as M, PlanVersionsService as P, type CatalogServiceConfig as a, MarketingSettingsService as b, PlansService as c, PromotionsService as d };

package/dist/platform/index.d.cts

@@ -1,31 +1,36 @@
-export { a as SAASICAT_PUBLIC_ROUTE_KEY, d as SaaSiCatModule, e as SaaSiCatPublicRoute, S as SetupService, g as defineSaaSiCat, i as isSaaSiCatPublicRoute } from '../define-saasicat-vGBCkFys.cjs';
+export { I as IssuerIdentityCheck, a as IssuerIdentityInspector, b as IssuerIdentityVerdict, c as SAASICAT_PUBLIC_ROUTE_KEY, f as SaaSiCatModule, g as SaaSiCatPublicRoute, S as SetupService, i as defineSaaSiCat, j as isSaaSiCatPublicRoute } from '../issuer-identity.check-CBO0vcsq.cjs';
 import { CanActivate, DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
-import { SaaSiCatPersistenceAdapter, SubscriptionUsagePort, SubscriptionRepository, UsageSnapshotPort, QuotaProvider } from '@saasicat/core';
+import { SaaSiCatPersistenceAdapter, SubscriptionUsagePort, PlanCatalog, SubscriptionRepository, UsageSnapshotPort, QuotaProvider } from '@saasicat/core';
 import { P as ProviderSpec } from '../di-CcNeq9v-.cjs';
-import { b as DiscoveryAppInfo } from '../discovery.scanner-9cMqF95o.cjs';
-export { c as DiscoveryScanner } from '../discovery.scanner-9cMqF95o.cjs';
-import { e as SaaSiCatModuleOptions, S as SaaSiCatAdapters, o as PlanResolverPort } from '../module-options-BG3MzQva.cjs';
-export { P as PLAN_RESOLVER_PORT_TOKEN, a as SaaSiCatAdminResourcesOptions, b as SaaSiCatAdminStatsOptions, c as SaaSiCatCatalogOptions, d as SaaSiCatCheckoutOfferOptions, f as SaaSiCatPromoCodesOptions, g as SaaSiCatSetupOptions, h as SaaSiCatSubscriptionBundlesOptions, i as SaaSiCatSubscriptionContractOptions, j as SaaSiCatTenantAuthGuards, k as SaaSiCatTenantBillingOptions, l as SetupModule, m as SetupModuleOptions, n as StaticPlanResolver, T as TenantManifestControllerOptions, p as buildTenantManifestController } from '../module-options-BG3MzQva.cjs';
-import { S as StaticEntitlementService } from '../enforce-quota.interceptor-Df0e3OWe.cjs';
-export { E as EnforceQuotaInterceptor, Q as QUOTA_PROVIDERS_TOKEN, b as STATIC_FEATURE_GUARD_CONFIG_TOKEN, c as StaticEntitlementSnapshot, a as StaticFeatureGuard, d as StaticFeatureGuardConfig } from '../enforce-quota.interceptor-Df0e3OWe.cjs';
+import { D as DiscoveryAppInfo } from '../discovery.scanner-DXKc6JkV.cjs';
+export { a as DiscoveryScanner } from '../discovery.scanner-DXKc6JkV.cjs';
+import { c as SaaSiCatModuleOptions, S as SaaSiCatAdapters, b as PlanResolverPort } from '../module-options-qAOwinHR.cjs';
+export { D as DB_CATALOG_MEMBERS, p as DbCatalogOptions, P as PLAN_RESOLVER_PORT_TOKEN, d as SaaSiCatAdminResourcesOptions, e as SaaSiCatAdminStatsOptions, f as SaaSiCatCatalogOptions, g as SaaSiCatCheckoutOfferOptions, h as SaaSiCatPromoCodesOptions, i as SaaSiCatSetupOptions, j as SaaSiCatSubscriptionBundlesOptions, k as SaaSiCatSubscriptionContractOptions, l as SaaSiCatTenantAuthGuards, m as SaaSiCatTenantBillingOptions, n as SetupModule, o as SetupModuleOptions, a as StaticPlanResolver, T as TenantManifestControllerOptions, q as buildTenantManifestController } from '../module-options-qAOwinHR.cjs';
+import { S as StaticEntitlementService } from '../enforce-quota.interceptor-BFyVdWe8.cjs';
+export { E as EnforceQuotaInterceptor, Q as QUOTA_PROVIDERS_TOKEN, b as STATIC_FEATURE_GUARD_CONFIG_TOKEN, c as StaticEntitlementSnapshot, a as StaticFeatureGuard, d as StaticFeatureGuardConfig } from '../enforce-quota.interceptor-BFyVdWe8.cjs';
 import { DiscoveryService, MetadataScanner } from '@nestjs/core';
-export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, f as AdminStatsService, M as MfaGuard, h as MfaService, S as SuperAdminGuard } from '../admin-stats.service-DfKupywR.cjs';
+export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, f as AdminStatsService, h as MfaGuard, M as MfaService, S as SuperAdminGuard } from '../admin-stats.service-DrZrU8IJ.cjs';
 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-B3CD0v_d.cjs';
-export { d as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, h as PlanChangePreviewService, r as SubscriptionBundlePreviewService, s as SubscriptionBundlesService, T as TenantAdminGuard, t as TenantBillingController } from '../tenant-billing.controller-DS8kB8a7.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-TPEtbN0r.cjs';
+export { f as AdminResourcesService, g as AdminStatsModule, a as AdminStatsModuleOptions } from '../admin-resources.module-B4XNvdH-.cjs';
+export { c as EntitlementService } from '../aggregation-OpnhwzF5.cjs';
+export { g as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, l as PlanChangePreviewService, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController } from '../tenant-billing.controller-DKbAqTbM.cjs';
+export { B as BundlesService, C as CatalogEntriesService, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService } from '../plan-versions.service-DARLh-qI.cjs';
+export { c as PublicMarketingCatalogService } from '../catalog.module-T-I5Ricz.cjs';
 export { P as PromoCodeRateLimitGuard } from '../rate-limit.guard-dntqAlfZ.cjs';
-export { i as PromoCodesService } from '../promo.service-BJbKAmw3.cjs';
-export { a as CheckoutOfferModule, b as CheckoutOfferModuleOptions } from '../checkout-offer.module-CVpWrzbe.cjs';
-export { C as CheckoutOfferService } from '../checkout-offer.service-BLOv2HOo.cjs';
-export { S as SubscriptionContractModule, a as SubscriptionContractModuleOptions } from '../subscription-contract.module-CEK8HS5-.cjs';
-export { S as SubscriptionContractService } from '../subscription-contract.service-hD87MKyg.cjs';
-import '../tenant-billing.module-BznC3XtW.cjs';
-import '../catalog.module-BDDO6iwq.cjs';
-import '../plan-resolution-Cgo_TR1H.cjs';
-import '../promo.module-DtvIycpt.cjs';
+export { a as PromoCodesService } from '../promo.service-BYBu6dy3.cjs';
+export { c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-DFhGy6JO.cjs';
+export { C as CheckoutOfferPricing, b as CheckoutOfferService } from '../checkout-offer.service-CCVxG9b2.cjs';
+export { a as SubscriptionContractModule, S as SubscriptionContractModuleOptions } from '../subscription-contract.module-DTMuUJYd.cjs';
+export { S as SubscriptionContractService } from '../subscription-contract.service-CfNApLuP.cjs';
+import '../tenant-billing.module-ClbjzocC.cjs';
+import '../tenant-billing.tokens-G-1xOlMr.cjs';
+import '../contract-line-item-money-B0Z3Ogur.cjs';
+import '../plan-resolution-CwUy_OqC.cjs';
+import '../promo.module-CKkECmU8.cjs';
+import '../payments.module-BdUq9ot_.cjs';
 import 'rxjs';
+import '../plan-catalog-source-DWe-BGY1.cjs';
+import '../subscriber.service-5W6Gi-1B.cjs';
 
 /**
  * What `tenantBilling` resolved and its two dependants need.
@@ -90,6 +95,20 @@ interface PlatformConfiguration {
     readonly options: SaaSiCatModuleOptions;
     /** After the bundle slices and the explicit entries have been merged. */
     readonly adapters: SaaSiCatAdapters;
+    /**
+     * The catalogue as resolved before the database is asked: `planCatalog`
+     * as given, or the file `dbCatalog` names, loaded. Absent where nothing
+     * usable was configured — which is for the rules to say.
+     */
+    readonly catalog?: PlanCatalog;
+    /**
+     * Why the file `dbCatalog` named did not load, where it did not.
+     *
+     * A finding rather than a throw from inside the loader: the platform is
+     * the caller on this path, so an unreadable file would otherwise end the
+     * boot before any other rule had spoken.
+     */
+    readonly catalogFailure?: Error;
 }
 interface PlatformRule {
     /** Stable id — `<area>.<what-it-requires>`. Appears in the boot error. */
@@ -178,11 +197,21 @@ declare function assertConfiguration(configuration: PlatformConfiguration, rules
  * Standard `tenantId → planId` resolver backed by the canonical subscription
  * repository. This removes the identical resolver class most applications
  * previously had to write themselves.
+ *
+ * It answers for the DEFAULT enforcement stack — `StaticFeatureGuard` and
+ * `EnforceQuotaInterceptor` — which reaches its plan through here rather than
+ * through `EntitlementService`. Two paths, one rule, and the rule has to be
+ * written in both: an app that never registers tenant billing enforces
+ * entitlements entirely through this one.
  */
 declare class SubscriptionPlanResolver implements PlanResolverPort {
     private readonly subscriptions;
     private readonly activeStatuses;
-    constructor(subscriptions: SubscriptionRepository, activeStatuses?: ReadonlySet<string>);
+    /** The plan a subscription falls back to once its cancellation lands. */
+    private readonly canceledEntitlementPlan;
+    constructor(subscriptions: SubscriptionRepository, activeStatuses?: ReadonlySet<string>, 
+    /** The plan a subscription falls back to once its cancellation lands. */
+    canceledEntitlementPlan?: string | null);
     getPlanIdForTenant(tenantId: string): Promise<string | null>;
 }
 

package/dist/platform/index.d.ts

@@ -1,31 +1,36 @@
-export { a as SAASICAT_PUBLIC_ROUTE_KEY, d as SaaSiCatModule, e as SaaSiCatPublicRoute, S as SetupService, g as defineSaaSiCat, i as isSaaSiCatPublicRoute } from '../define-saasicat-DROBe-b1.js';
+export { I as IssuerIdentityCheck, a as IssuerIdentityInspector, b as IssuerIdentityVerdict, c as SAASICAT_PUBLIC_ROUTE_KEY, f as SaaSiCatModule, g as SaaSiCatPublicRoute, S as SetupService, i as defineSaaSiCat, j as isSaaSiCatPublicRoute } from '../issuer-identity.check-Cz9CEMkZ.js';
 import { CanActivate, DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
-import { SaaSiCatPersistenceAdapter, SubscriptionUsagePort, SubscriptionRepository, UsageSnapshotPort, QuotaProvider } from '@saasicat/core';
+import { SaaSiCatPersistenceAdapter, SubscriptionUsagePort, PlanCatalog, SubscriptionRepository, UsageSnapshotPort, QuotaProvider } from '@saasicat/core';
 import { P as ProviderSpec } from '../di-CcNeq9v-.js';
-import { b as DiscoveryAppInfo } from '../discovery.scanner-9cMqF95o.js';
-export { c as DiscoveryScanner } from '../discovery.scanner-9cMqF95o.js';
-import { e as SaaSiCatModuleOptions, S as SaaSiCatAdapters, o as PlanResolverPort } from '../module-options-COSEb0VW.js';
-export { P as PLAN_RESOLVER_PORT_TOKEN, a as SaaSiCatAdminResourcesOptions, b as SaaSiCatAdminStatsOptions, c as SaaSiCatCatalogOptions, d as SaaSiCatCheckoutOfferOptions, f as SaaSiCatPromoCodesOptions, g as SaaSiCatSetupOptions, h as SaaSiCatSubscriptionBundlesOptions, i as SaaSiCatSubscriptionContractOptions, j as SaaSiCatTenantAuthGuards, k as SaaSiCatTenantBillingOptions, l as SetupModule, m as SetupModuleOptions, n as StaticPlanResolver, T as TenantManifestControllerOptions, p as buildTenantManifestController } from '../module-options-COSEb0VW.js';
-import { S as StaticEntitlementService } from '../enforce-quota.interceptor-DW3etVyI.js';
-export { E as EnforceQuotaInterceptor, Q as QUOTA_PROVIDERS_TOKEN, b as STATIC_FEATURE_GUARD_CONFIG_TOKEN, c as StaticEntitlementSnapshot, a as StaticFeatureGuard, d as StaticFeatureGuardConfig } from '../enforce-quota.interceptor-DW3etVyI.js';
+import { D as DiscoveryAppInfo } from '../discovery.scanner-DXKc6JkV.js';
+export { a as DiscoveryScanner } from '../discovery.scanner-DXKc6JkV.js';
+import { c as SaaSiCatModuleOptions, S as SaaSiCatAdapters, b as PlanResolverPort } from '../module-options-DmQ3G4sZ.js';
+export { D as DB_CATALOG_MEMBERS, p as DbCatalogOptions, P as PLAN_RESOLVER_PORT_TOKEN, d as SaaSiCatAdminResourcesOptions, e as SaaSiCatAdminStatsOptions, f as SaaSiCatCatalogOptions, g as SaaSiCatCheckoutOfferOptions, h as SaaSiCatPromoCodesOptions, i as SaaSiCatSetupOptions, j as SaaSiCatSubscriptionBundlesOptions, k as SaaSiCatSubscriptionContractOptions, l as SaaSiCatTenantAuthGuards, m as SaaSiCatTenantBillingOptions, n as SetupModule, o as SetupModuleOptions, a as StaticPlanResolver, T as TenantManifestControllerOptions, q as buildTenantManifestController } from '../module-options-DmQ3G4sZ.js';
+import { S as StaticEntitlementService } from '../enforce-quota.interceptor-GaBXboGx.js';
+export { E as EnforceQuotaInterceptor, Q as QUOTA_PROVIDERS_TOKEN, b as STATIC_FEATURE_GUARD_CONFIG_TOKEN, c as StaticEntitlementSnapshot, a as StaticFeatureGuard, d as StaticFeatureGuardConfig } from '../enforce-quota.interceptor-GaBXboGx.js';
 import { DiscoveryService, MetadataScanner } from '@nestjs/core';
-export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, f as AdminStatsService, M as MfaGuard, h as MfaService, S as SuperAdminGuard } from '../admin-stats.service-TYiSUwIR.js';
+export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, f as AdminStatsService, h as MfaGuard, M as MfaService, S as SuperAdminGuard } from '../admin-stats.service-CsLNt19Z.js';
 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-BFzW07DE.js';
-export { d as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, h as PlanChangePreviewService, r as SubscriptionBundlePreviewService, s as SubscriptionBundlesService, T as TenantAdminGuard, t as TenantBillingController } from '../tenant-billing.controller-BQ67mlmI.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-DChhbK6h.js';
+export { f as AdminResourcesService, g as AdminStatsModule, a as AdminStatsModuleOptions } from '../admin-resources.module-CWqdI9BV.js';
+export { c as EntitlementService } from '../aggregation-ChpZDh0g.js';
+export { g as ComposedTenantAuthGuard, P as PendingPlanMaterializationService, l as PlanChangePreviewService, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController } from '../tenant-billing.controller-BLqbsONe.js';
+export { B as BundlesService, C as CatalogEntriesService, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService } from '../plan-versions.service-C0N-Em2W.js';
+export { c as PublicMarketingCatalogService } from '../catalog.module-C9O7BxRq.js';
 export { P as PromoCodeRateLimitGuard } from '../rate-limit.guard-dntqAlfZ.js';
-export { i as PromoCodesService } from '../promo.service-BJbKAmw3.js';
-export { a as CheckoutOfferModule, b as CheckoutOfferModuleOptions } from '../checkout-offer.module-CMtiQJTT.js';
-export { C as CheckoutOfferService } from '../checkout-offer.service-BLOv2HOo.js';
-export { S as SubscriptionContractModule, a as SubscriptionContractModuleOptions } from '../subscription-contract.module-fDFdQ0jm.js';
-export { S as SubscriptionContractService } from '../subscription-contract.service-hD87MKyg.js';
-import '../tenant-billing.module-wUbsQSFG.js';
-import '../catalog.module-BTnMsE6u.js';
-import '../plan-resolution-Cgo_TR1H.js';
-import '../promo.module-Z8h1PNX-.js';
+export { a as PromoCodesService } from '../promo.service-CFjfF0Xm.js';
+export { c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-x7SP_dX4.js';
+export { C as CheckoutOfferPricing, b as CheckoutOfferService } from '../checkout-offer.service-BeHgYikI.js';
+export { a as SubscriptionContractModule, S as SubscriptionContractModuleOptions } from '../subscription-contract.module-BfIRpc1o.js';
+export { S as SubscriptionContractService } from '../subscription-contract.service-CPZrTM9C.js';
+import '../tenant-billing.module-DohgJJ2m.js';
+import '../tenant-billing.tokens-G-1xOlMr.js';
+import '../contract-line-item-money-B0Z3Ogur.js';
+import '../plan-resolution-CwUy_OqC.js';
+import '../promo.module-DuIJdK3U.js';
+import '../payments.module-CQGv_VG7.js';
 import 'rxjs';
+import '../plan-catalog-source-DWe-BGY1.js';
+import '../subscriber.service-5W6Gi-1B.js';
 
 /**
  * What `tenantBilling` resolved and its two dependants need.
@@ -90,6 +95,20 @@ interface PlatformConfiguration {
     readonly options: SaaSiCatModuleOptions;
     /** After the bundle slices and the explicit entries have been merged. */
     readonly adapters: SaaSiCatAdapters;
+    /**
+     * The catalogue as resolved before the database is asked: `planCatalog`
+     * as given, or the file `dbCatalog` names, loaded. Absent where nothing
+     * usable was configured — which is for the rules to say.
+     */
+    readonly catalog?: PlanCatalog;
+    /**
+     * Why the file `dbCatalog` named did not load, where it did not.
+     *
+     * A finding rather than a throw from inside the loader: the platform is
+     * the caller on this path, so an unreadable file would otherwise end the
+     * boot before any other rule had spoken.
+     */
+    readonly catalogFailure?: Error;
 }
 interface PlatformRule {
     /** Stable id — `<area>.<what-it-requires>`. Appears in the boot error. */
@@ -178,11 +197,21 @@ declare function assertConfiguration(configuration: PlatformConfiguration, rules
  * Standard `tenantId → planId` resolver backed by the canonical subscription
  * repository. This removes the identical resolver class most applications
  * previously had to write themselves.
+ *
+ * It answers for the DEFAULT enforcement stack — `StaticFeatureGuard` and
+ * `EnforceQuotaInterceptor` — which reaches its plan through here rather than
+ * through `EntitlementService`. Two paths, one rule, and the rule has to be
+ * written in both: an app that never registers tenant billing enforces
+ * entitlements entirely through this one.
  */
 declare class SubscriptionPlanResolver implements PlanResolverPort {
     private readonly subscriptions;
     private readonly activeStatuses;
-    constructor(subscriptions: SubscriptionRepository, activeStatuses?: ReadonlySet<string>);
+    /** The plan a subscription falls back to once its cancellation lands. */
+    private readonly canceledEntitlementPlan;
+    constructor(subscriptions: SubscriptionRepository, activeStatuses?: ReadonlySet<string>, 
+    /** The plan a subscription falls back to once its cancellation lands. */
+    canceledEntitlementPlan?: string | null);
     getPlanIdForTenant(tenantId: string): Promise<string | null>;
 }
 

package/dist/platform/index.js

@@ -1,11 +1,14 @@
 import {
   defineSaaSiCat
-} from "../chunk-OYNHOY45.js";
+} from "../chunk-GAUEVIAE.js";
 import {
+  DB_CATALOG_MEMBERS,
   ENFORCEMENT_CHAIN_STATE_TOKEN,
   EnforceQuotaInterceptor,
   EnforcementChainCheck,
   FEATURE_COMPOSERS,
+  IssuerIdentityCheck,
+  IssuerIdentityInspector,
   MOUNTED_BUT_NOT_EXPORTED,
   PLAN_RESOLVER_PORT_TOKEN,
   PLATFORM_RULES,
@@ -28,13 +31,13 @@ import {
   docsUrlFor,
   findViolations,
   headingSlug
-} from "../chunk-RUNZ3X4C.js";
+} from "../chunk-AOS2JPDD.js";
 import {
   PromoCodeRateLimitGuard
-} from "../chunk-TXC3LHHB.js";
+} from "../chunk-4SDSYV4A.js";
 import {
   SubscriptionContractModule
-} from "../chunk-AU3OOREM.js";
+} from "../chunk-XSSWYPP5.js";
 import {
   AdminBypassRlsInterceptor,
   AdminManifestModule,
@@ -43,25 +46,16 @@ import {
   AdminResourcesService,
   AdminStatsModule,
   AdminStatsService,
-  MfaGuard,
-  MfaService,
   SuperAdminGuard
-} from "../chunk-LTT736P3.js";
+} from "../chunk-LLYVYRGJ.js";
 import {
-  ComposedTenantAuthGuard,
   PendingPlanMaterializationService,
   PlanChangePreviewService,
   SubscriptionBundlePreviewService,
   SubscriptionBundlesService,
   TenantAdminGuard,
   TenantBillingController
-} from "../chunk-6Z7JR4EW.js";
-import {
-  PromoCodesService
-} from "../chunk-VXEYLNIB.js";
-import {
-  SubscriptionContractService
-} from "../chunk-KFT5AIIH.js";
+} from "../chunk-M47BNEY2.js";
 import {
   BundlesService,
   CatalogEntriesService,
@@ -71,36 +65,59 @@ import {
   PlansService,
   PromotionsService,
   PublicMarketingCatalogService
-} from "../chunk-WOVQPXV4.js";
-import "../chunk-N3L3AICU.js";
+} from "../chunk-CQ2ZZMTD.js";
+import "../chunk-GZTL64QK.js";
+import {
+  MfaGuard,
+  MfaService
+} from "../chunk-34XVPR6P.js";
 import {
   AdminAuditService
-} from "../chunk-O2J2HDXA.js";
+} from "../chunk-OOTEXP47.js";
 import {
-  CheckoutOfferModule,
+  CheckoutOfferModule
+} from "../chunk-TOEFN7DN.js";
+import {
+  CheckoutOfferPricing,
   CheckoutOfferService
-} from "../chunk-WUDYIPYH.js";
-import "../chunk-BSK6YBLI.js";
+} from "../chunk-55QEDAMX.js";
 import {
-  SAASICAT_PUBLIC_ROUTE_KEY,
-  SaaSiCatPublicRoute,
-  isSaaSiCatPublicRoute
-} from "../chunk-YSC46BGM.js";
-import "../chunk-7ZEGFL42.js";
+  PromoCodesService
+} from "../chunk-3RLWML2S.js";
 import {
-  EntitlementService
-} from "../chunk-VIJ5NJWC.js";
-import "../chunk-DQKCK7DX.js";
-import "../chunk-VBRYPU7V.js";
-import "../chunk-57V6ZTI6.js";
-import "../chunk-OUDSQ3PU.js";
-import "../chunk-AOQJEYOL.js";
-import "../chunk-SABTXESR.js";
-import "../chunk-XBYAFEOR.js";
+  SubscriptionContractService
+} from "../chunk-NDLC5GYK.js";
+import "../chunk-KPEMTBOP.js";
+import "../chunk-S33SO5XX.js";
 import {
   DiscoveryScanner
-} from "../chunk-WXYJHZCN.js";
+} from "../chunk-JVAEKTJ4.js";
+import "../chunk-WHJSYKNC.js";
+import {
+  EntitlementService
+} from "../chunk-G6EZWECL.js";
+import "../chunk-OUDSQ3PU.js";
+import "../chunk-TBBZWZQT.js";
+import "../chunk-VBRYPU7V.js";
+import "../chunk-6PJE7EWO.js";
+import "../chunk-3QVGA6JX.js";
 import "../chunk-QUZU2M33.js";
+import "../chunk-QPVDCKYS.js";
+import "../chunk-7NJKVC5X.js";
+import {
+  ComposedTenantAuthGuard
+} from "../chunk-5CKC7O52.js";
+import "../chunk-GPQWGA6B.js";
+import "../chunk-SZ7RFPXA.js";
+import "../chunk-WOEJ6K7M.js";
+import "../chunk-LF6J4YYN.js";
+import {
+  SAASICAT_PUBLIC_ROUTE_KEY,
+  SaaSiCatPublicRoute,
+  isSaaSiCatPublicRoute
+} from "../chunk-YSC46BGM.js";
+import "../chunk-FEQZCWUL.js";
+import "../chunk-J7NJRK3K.js";
 import "../chunk-SHUYVCID.js";
 export {
   AdminAuditService,
@@ -114,14 +131,18 @@ export {
   BundlesService,
   CatalogEntriesService,
   CheckoutOfferModule,
+  CheckoutOfferPricing,
   CheckoutOfferService,
   ComposedTenantAuthGuard,
+  DB_CATALOG_MEMBERS,
   DiscoveryScanner,
   ENFORCEMENT_CHAIN_STATE_TOKEN,
   EnforceQuotaInterceptor,
   EnforcementChainCheck,
   EntitlementService,
   FEATURE_COMPOSERS,
+  IssuerIdentityCheck,
+  IssuerIdentityInspector,
   MOUNTED_BUT_NOT_EXPORTED,
   MarketingProjectionsService,
   MarketingSettingsService,

package/dist/promo/index.d.cts

@@ -1,9 +1,10 @@
-import { PromoCodeValueType, PromoCodeDurationType, BillingCycle, PromoCodeRepository, PromoCodeRedemptionRepository } from '@saasicat/core';
-import { i as PromoCodesService, f as PreviewResult } from '../promo.service-BJbKAmw3.cjs';
-export { C as CODE_MAX_LENGTH, a as CODE_MIN_LENGTH, b as CODE_PATTERN, c as PreviewInput, d as PreviewInvalid, e as PreviewReason, g as PreviewValid, h as PromoCodeStats, P as PromoServiceConfig, R as RedeemInput } from '../promo.service-BJbKAmw3.cjs';
+import { PromoCodeValueType, PromoCodeDurationType, BillingCycle, PromoCodeRepository, PromoCodeRedemptionRepository, PromoCodeHoldRepository } from '@saasicat/core';
+import { a as PromoCodesService, i as PreviewResult } from '../promo.service-BYBu6dy3.cjs';
+export { C as CODE_MAX_LENGTH, b as CODE_MIN_LENGTH, c as CODE_PATTERN, d as CheckoutHoldInput, e as PreviewInput, f as PreviewInvalid, g as PreviewOptions, h as PreviewReason, j as PreviewValid, k as PromoCodeStats, P as PromoServiceConfig, R as RedeemInput } from '../promo.service-BYBu6dy3.cjs';
 export { P as PromoCodeRateLimitGuard, h as hashIp, i as ipFingerprint } from '../rate-limit.guard-dntqAlfZ.cjs';
-export { P as PromoCodesModule, a as PromoCodesModuleOptions } from '../promo.module-DtvIycpt.cjs';
+export { a as PromoCodesModule, P as PromoCodesModuleOptions } from '../promo.module-CKkECmU8.cjs';
 import { Type, CanActivate } from '@nestjs/common';
+import '../plan-catalog-source-DWe-BGY1.cjs';
 import '../di-CcNeq9v-.cjs';
 
 /** Structural view of a PromoCode for the calculator functions.
@@ -80,20 +81,34 @@ interface PromoLabelOptions {
 declare function buildLabel(code: Pick<PromoCodeForCalc, 'valueType' | 'value' | 'durationType' | 'durationValue'>, cycle: BillingCycle, options?: PromoLabelOptions): string;
 
 declare function round2(n: number): number;
-/** Gross = net * (1 + vatRate/100). */
+/**
+ * Whether a tax rate is one SaaSiCat accepts. Every tax rate in SaaSiCat is a
+ * percentage — 19 means 19 % — wherever it is stated: the settings, the
+ * catalogue, an offer, a contract, a contract line.
+ *
+ * A percentage lies from 0 to 100, and none lies strictly between 0 and 1:
+ * that is the shape of a fraction such as 0.19, and a fraction is refused
+ * rather than taken for a fraction of a per cent.
+ */
+declare function isTaxRatePercent(rate: number): boolean;
+/** Gross = net * (1 + vatRate/100), with `vatRate` a percentage. */
 declare function grossFromNet(net: number, vatRate: number): number;
-/** VAT included in the gross amount: gross * (vatRate / (100 + vatRate)). */
+/** Net = gross * 100 / (100 + vatRate), with `vatRate` a percentage. */
+declare function netFromGross(gross: number, vatRate: number): number;
+/** VAT included in the gross amount: gross * vatRate / (100 + vatRate). */
 declare function computeIncludedVat(grossAmount: number, vatRate: number): number;
 
 declare class PromoCodeExpirer {
     private readonly promoRepo;
     private readonly redemptionRepo;
+    private readonly holds;
     private readonly logger;
-    constructor(promoRepo: PromoCodeRepository, redemptionRepo: PromoCodeRedemptionRepository);
+    constructor(promoRepo: PromoCodeRepository, redemptionRepo: PromoCodeRedemptionRepository, holds?: PromoCodeHoldRepository | null);
     expirePromoCodes(): Promise<void>;
 }
 
 declare const PROMO_CODE_REPOSITORY_TOKEN: unique symbol;
+declare const PROMO_CODE_HOLD_REPOSITORY_TOKEN: unique symbol;
 declare const PROMO_CODE_REDEMPTION_REPOSITORY_TOKEN: unique symbol;
 declare const PROMO_CODE_VALIDATION_LOG_REPOSITORY_TOKEN: unique symbol;
 declare const PROMO_FIRST_TIME_CUSTOMER_CHECK_TOKEN: unique symbol;
@@ -166,4 +181,4 @@ declare class UpdatePromoCodeDto {
     revenueDeductionAccount?: string | null;
 }
 
-export { CreatePromoCodeDto, PROMO_CODE_REDEMPTION_REPOSITORY_TOKEN, PROMO_CODE_REPOSITORY_TOKEN, PROMO_CODE_VALIDATION_LOG_REPOSITORY_TOKEN, PROMO_FIRST_TIME_CUSTOMER_CHECK_TOKEN, PROMO_REVENUE_DEDUCTION_AGGREGATOR_TOKEN, PROMO_SERVICE_CONFIG_TOKEN, PROMO_SUBSCRIPTION_LOOKUP_TOKEN, PROMO_TRANSACTION_RUNNER_TOKEN, PreviewPromoCodeDto, PreviewResult, PromoCodeExpirer, type PromoCodeForCalc, PromoCodePublicController, PromoCodesService, type PromoLabelOptions, UpdatePromoCodeDto, addCycles, buildLabel, buildPromoCodeAdminController, computeDiscountGross, computeDiscountedGross, computeIncludedVat, computeRegularStartsAt, grossFromNet, round2 };
+export { CreatePromoCodeDto, PROMO_CODE_HOLD_REPOSITORY_TOKEN, PROMO_CODE_REDEMPTION_REPOSITORY_TOKEN, PROMO_CODE_REPOSITORY_TOKEN, PROMO_CODE_VALIDATION_LOG_REPOSITORY_TOKEN, PROMO_FIRST_TIME_CUSTOMER_CHECK_TOKEN, PROMO_REVENUE_DEDUCTION_AGGREGATOR_TOKEN, PROMO_SERVICE_CONFIG_TOKEN, PROMO_SUBSCRIPTION_LOOKUP_TOKEN, PROMO_TRANSACTION_RUNNER_TOKEN, PreviewPromoCodeDto, PreviewResult, PromoCodeExpirer, type PromoCodeForCalc, PromoCodePublicController, PromoCodesService, type PromoLabelOptions, UpdatePromoCodeDto, addCycles, buildLabel, buildPromoCodeAdminController, computeDiscountGross, computeDiscountedGross, computeIncludedVat, computeRegularStartsAt, grossFromNet, isTaxRatePercent, netFromGross, round2 };