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

package/dist/admin/index.d.cts

@@ -1,13 +1,14 @@
-import { f as AdminStatsService, g as AdminStatsSnapshot } from '../admin-stats.service-BJdzHCtJ.cjs';
-export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, h as MfaGuard, M as MfaService, P as PLATFORM_CORE_CONTRIBUTION_TOKEN, R as REQUIRE_MFA_KEY, i as RequireMfa, S as SuperAdminGuard, T as TotpSetupResult, V as VerifyTotpInput } from '../admin-stats.service-BJdzHCtJ.cjs';
+import { f as AdminStatsService, g as AdminStatsSnapshot } from '../admin-stats.service-DrZrU8IJ.cjs';
+export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, h as MfaGuard, M as MfaService, P as PLATFORM_CORE_CONTRIBUTION_TOKEN, R as REQUIRE_MFA_KEY, i as RequireMfa, S as SuperAdminGuard, T as TotpSetupResult, V as VerifyTotpInput } from '../admin-stats.service-DrZrU8IJ.cjs';
 export { A as AdminAuditService } from '../admin-audit.service-4P3Djdxk.cjs';
-import { b as AdminManifestConfig } from '../admin-resources.module-aOJ_0rur.cjs';
-export { c as ADMIN_MANIFEST_CONFIG, d as ADMIN_RESOURCES_PORT_TOKEN, e as AdminResourcesModule, A as AdminResourcesModuleOptions, f as AdminResourcesService, g as AdminStatsModule, a as AdminStatsModuleOptions, S as SuspendTenantDto } from '../admin-resources.module-aOJ_0rur.cjs';
+import { b as AdminManifestConfig } from '../admin-resources.module-B4XNvdH-.cjs';
+export { c as ADMIN_MANIFEST_CONFIG, d as ADMIN_RESOURCES_PORT_TOKEN, e as AdminResourcesModule, A as AdminResourcesModuleOptions, f as AdminResourcesService, g as AdminStatsModule, a as AdminStatsModuleOptions, S as SuspendTenantDto } from '../admin-resources.module-B4XNvdH-.cjs';
 import { PublicBootResponse, ManifestContribution } from '@saasicat/core';
 import { Type, CanActivate } from '@nestjs/common';
 import '@nestjs/core';
 import 'rxjs';
 import '../di-CcNeq9v-.cjs';
+import '../plan-catalog-source-DWe-BGY1.cjs';
 
 declare const MFA_PORT_TOKEN: unique symbol;
 declare const AUDIT_PORT_TOKEN: unique symbol;

package/dist/admin/index.d.ts

@@ -1,13 +1,14 @@
-import { f as AdminStatsService, g as AdminStatsSnapshot } from '../admin-stats.service-cwLMrkGl.js';
-export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, h as MfaGuard, M as MfaService, P as PLATFORM_CORE_CONTRIBUTION_TOKEN, R as REQUIRE_MFA_KEY, i as RequireMfa, S as SuperAdminGuard, T as TotpSetupResult, V as VerifyTotpInput } from '../admin-stats.service-cwLMrkGl.js';
+import { f as AdminStatsService, g as AdminStatsSnapshot } from '../admin-stats.service-CsLNt19Z.js';
+export { A as AdminBypassRlsInterceptor, a as AdminManifestModule, b as AdminManifestModuleOptions, c as AdminManifestService, d as AdminModule, e as AdminModuleOptions, h as MfaGuard, M as MfaService, P as PLATFORM_CORE_CONTRIBUTION_TOKEN, R as REQUIRE_MFA_KEY, i as RequireMfa, S as SuperAdminGuard, T as TotpSetupResult, V as VerifyTotpInput } from '../admin-stats.service-CsLNt19Z.js';
 export { A as AdminAuditService } from '../admin-audit.service-4P3Djdxk.js';
-import { b as AdminManifestConfig } from '../admin-resources.module-BENMc0Wh.js';
-export { c as ADMIN_MANIFEST_CONFIG, d as ADMIN_RESOURCES_PORT_TOKEN, e as AdminResourcesModule, A as AdminResourcesModuleOptions, f as AdminResourcesService, g as AdminStatsModule, a as AdminStatsModuleOptions, S as SuspendTenantDto } from '../admin-resources.module-BENMc0Wh.js';
+import { b as AdminManifestConfig } from '../admin-resources.module-CWqdI9BV.js';
+export { c as ADMIN_MANIFEST_CONFIG, d as ADMIN_RESOURCES_PORT_TOKEN, e as AdminResourcesModule, A as AdminResourcesModuleOptions, f as AdminResourcesService, g as AdminStatsModule, a as AdminStatsModuleOptions, S as SuspendTenantDto } from '../admin-resources.module-CWqdI9BV.js';
 import { PublicBootResponse, ManifestContribution } from '@saasicat/core';
 import { Type, CanActivate } from '@nestjs/common';
 import '@nestjs/core';
 import 'rxjs';
 import '../di-CcNeq9v-.js';
+import '../plan-catalog-source-DWe-BGY1.js';
 
 declare const MFA_PORT_TOKEN: unique symbol;
 declare const AUDIT_PORT_TOKEN: unique symbol;

package/dist/admin/index.js

@@ -21,7 +21,7 @@ import {
   SuperAdminGuard,
   SuspendTenantDto,
   buildAdminStatsController
-} from "../chunk-OAUN2FPJ.js";
+} from "../chunk-LLYVYRGJ.js";
 import {
   MfaGuard,
   MfaService,
@@ -37,6 +37,7 @@ import {
   RLS_BYPASS_PORT_TOKEN
 } from "../chunk-SZ7RFPXA.js";
 import "../chunk-YSC46BGM.js";
+import "../chunk-FEQZCWUL.js";
 import "../chunk-J7NJRK3K.js";
 import "../chunk-SHUYVCID.js";
 export {

package/dist/{admin-resources.module-aOJ_0rur.d.cts → admin-resources.module-B4XNvdH-.d.cts}

@@ -7,7 +7,6 @@ declare const ADMIN_MANIFEST_CONFIG: unique symbol;
 interface AdminManifestConfig {
     project: AdminManifest['project'];
     build: Omit<AdminManifest['build'], 'manifestHash'>;
-    planCatalogSnapshot: AdminManifest['planCatalogSnapshot'];
 }
 
 interface AdminStatsModuleOptions {

package/dist/{admin-resources.module-BENMc0Wh.d.ts → admin-resources.module-CWqdI9BV.d.ts}

@@ -7,7 +7,6 @@ declare const ADMIN_MANIFEST_CONFIG: unique symbol;
 interface AdminManifestConfig {
     project: AdminManifest['project'];
     build: Omit<AdminManifest['build'], 'manifestHash'>;
-    planCatalogSnapshot: AdminManifest['planCatalogSnapshot'];
 }
 
 interface AdminStatsModuleOptions {

package/dist/{admin-stats.service-cwLMrkGl.d.ts → admin-stats.service-CsLNt19Z.d.ts}

@@ -3,7 +3,8 @@ import { Reflector } from '@nestjs/core';
 import { MfaPort, RlsBypassPort, AuditPort, ManifestContribution, AdminManifest, SubscriptionStatsPort, PromoCodeStatsPort, AuditStatsPort, SubscriptionStatsSnapshot, PromoCodeStatsSnapshot, AuditStatsSnapshot } from '@saasicat/core';
 import { Observable } from 'rxjs';
 import { P as ProviderSpec } from './di-CcNeq9v-.js';
-import { b as AdminManifestConfig } from './admin-resources.module-BENMc0Wh.js';
+import { P as PlanCatalogSource } from './plan-catalog-source-DWe-BGY1.js';
+import { b as AdminManifestConfig } from './admin-resources.module-CWqdI9BV.js';
 
 declare class SuperAdminGuard implements CanActivate {
     canActivate(context: ExecutionContext): boolean;
@@ -87,13 +88,16 @@ declare class AdminModule {
 declare const PLATFORM_CORE_CONTRIBUTION_TOKEN: unique symbol;
 declare class AdminManifestService {
     private readonly config;
+    private readonly planCatalogs;
     private readonly logger;
     private readonly contributions;
-    private cached;
-    constructor(config: AdminManifestConfig, platformCore?: ManifestContribution | null);
+    private merged;
+    private lastHash;
+    constructor(config: AdminManifestConfig, planCatalogs: PlanCatalogSource, platformCore?: ManifestContribution | null);
     register(contribution: ManifestContribution): void;
-    getManifest(): AdminManifest;
-    rebuild(): AdminManifest;
+    getManifest(): Promise<AdminManifest>;
+    /** Merges the contributions again, then serves the manifest as `getManifest` does. */
+    rebuild(): Promise<AdminManifest>;
     private build;
     private mergeContributions;
     /**
@@ -108,7 +112,7 @@ declare class AdminManifestService {
 
 type ConfigSpec = AdminManifestConfig | Pick<FactoryProvider<AdminManifestConfig>, 'useFactory' | 'inject'>;
 interface AdminManifestModuleOptions {
-    /** AdminManifestConfig as a value or via a factory (e.g. with a PLAN_CATALOG_TOKEN inject). */
+    /** AdminManifestConfig as a value or via a factory (e.g. with a PLAN_CATALOG_SETTINGS_TOKEN inject). */
     config: ConfigSpec;
     /**
      * Default `true`. Set to `false` when the consumer registers its own

package/dist/{admin-stats.service-BJdzHCtJ.d.cts → admin-stats.service-DrZrU8IJ.d.cts}

@@ -3,7 +3,8 @@ import { Reflector } from '@nestjs/core';
 import { MfaPort, RlsBypassPort, AuditPort, ManifestContribution, AdminManifest, SubscriptionStatsPort, PromoCodeStatsPort, AuditStatsPort, SubscriptionStatsSnapshot, PromoCodeStatsSnapshot, AuditStatsSnapshot } from '@saasicat/core';
 import { Observable } from 'rxjs';
 import { P as ProviderSpec } from './di-CcNeq9v-.cjs';
-import { b as AdminManifestConfig } from './admin-resources.module-aOJ_0rur.cjs';
+import { P as PlanCatalogSource } from './plan-catalog-source-DWe-BGY1.cjs';
+import { b as AdminManifestConfig } from './admin-resources.module-B4XNvdH-.cjs';
 
 declare class SuperAdminGuard implements CanActivate {
     canActivate(context: ExecutionContext): boolean;
@@ -87,13 +88,16 @@ declare class AdminModule {
 declare const PLATFORM_CORE_CONTRIBUTION_TOKEN: unique symbol;
 declare class AdminManifestService {
     private readonly config;
+    private readonly planCatalogs;
     private readonly logger;
     private readonly contributions;
-    private cached;
-    constructor(config: AdminManifestConfig, platformCore?: ManifestContribution | null);
+    private merged;
+    private lastHash;
+    constructor(config: AdminManifestConfig, planCatalogs: PlanCatalogSource, platformCore?: ManifestContribution | null);
     register(contribution: ManifestContribution): void;
-    getManifest(): AdminManifest;
-    rebuild(): AdminManifest;
+    getManifest(): Promise<AdminManifest>;
+    /** Merges the contributions again, then serves the manifest as `getManifest` does. */
+    rebuild(): Promise<AdminManifest>;
     private build;
     private mergeContributions;
     /**
@@ -108,7 +112,7 @@ declare class AdminManifestService {
 
 type ConfigSpec = AdminManifestConfig | Pick<FactoryProvider<AdminManifestConfig>, 'useFactory' | 'inject'>;
 interface AdminManifestModuleOptions {
-    /** AdminManifestConfig as a value or via a factory (e.g. with a PLAN_CATALOG_TOKEN inject). */
+    /** AdminManifestConfig as a value or via a factory (e.g. with a PLAN_CATALOG_SETTINGS_TOKEN inject). */
     config: ConfigSpec;
     /**
      * Default `true`. Set to `false` when the consumer registers its own

package/dist/{aggregation-CtIjlWHT.d.ts → aggregation-ChpZDh0g.d.ts}

@@ -1,4 +1,5 @@
-import { PlanId, QuotaKey, FeatureKey, PlanCatalog, SubscriptionRepository, PlanVersionRepository, TransactionRunner, SubscriptionBundleRepository, BundleRepository, SubscriptionContractRepository, DiscoverySnapshot, SubscriptionRecord, TransactionContext, ContractLineItemRecord, SubscriptionContractRecord } from '@saasicat/core';
+import { PlanId, QuotaKey, FeatureKey, SubscriptionRepository, PlanVersionRepository, TransactionRunner, SubscriptionBundleRepository, BundleRepository, SubscriptionContractRepository, DiscoverySnapshot, PlanCatalog, SubscriptionRecord, TransactionContext, ContractLineItemRecord, SubscriptionContractRecord } from '@saasicat/core';
+import { P as PlanCatalogSource } from './plan-catalog-source-DWe-BGY1.js';
 import { E as EntitlementResolutionConfig } from './plan-resolution-CwUy_OqC.js';
 
 /**
@@ -113,7 +114,7 @@ interface EnforceLimitInput<T> {
     now?: Date;
 }
 declare class EntitlementService {
-    private readonly catalog;
+    private readonly catalogs;
     private readonly subscriptions;
     private readonly planVersions;
     private readonly tx;
@@ -124,8 +125,16 @@ declare class EntitlementService {
     private readonly discoverySnapshot;
     private readonly cache;
     private replacedByIndex;
-    constructor(catalog: PlanCatalog, subscriptions: SubscriptionRepository, planVersions: PlanVersionRepository, tx: TransactionRunner, resolutionConfig?: EntitlementResolutionConfig | null, subscriptionBundles?: SubscriptionBundleRepository | null, bundles?: BundleRepository | null, subscriptionContracts?: SubscriptionContractRepository | null, discoverySnapshot?: DiscoverySnapshot | null);
-    computeLimits(tenantId: string, now?: Date): Promise<EffectiveLimits>;
+    constructor(catalogs: PlanCatalogSource, subscriptions: SubscriptionRepository, planVersions: PlanVersionRepository, tx: TransactionRunner, resolutionConfig?: EntitlementResolutionConfig | null, subscriptionBundles?: SubscriptionBundleRepository | null, bundles?: BundleRepository | null, subscriptionContracts?: SubscriptionContractRepository | null, discoverySnapshot?: DiscoverySnapshot | null);
+    /**
+     * The tenant's effective limits, answered from the cache for up to
+     * `CACHE_TTL_MS`. A caller that has already read the catalogue for its own
+     * operation passes it as `catalog`: the answer is then computed against
+     * that reading and kept out of the cache in both directions — not taken
+     * from it, and not written to it, since a reading the caller holds may be
+     * older than the one everybody else should be answered from.
+     */
+    computeLimits(tenantId: string, now?: Date, catalog?: PlanCatalog): Promise<EffectiveLimits>;
     /**
      * Clears a tenant's cache entry. MUST be called as soon as a mutation
      * changes the subscription, a bundle booking, or a PlanVersion binding —
@@ -140,6 +149,13 @@ declare class EntitlementService {
      * have a `SubscriptionRecord` (e.g. within a transaction).
      */
     deriveLimits(sub: SubscriptionRecord, now: Date, tx?: TransactionContext): Promise<EffectiveLimits>;
+    /**
+     * `deriveLimits` against a catalogue already read. The catalogue decides
+     * which features are `plannedOnly`, and it is read outside any transaction
+     * a caller holds, so that checking a limit does not wait for a second
+     * connection while the subscription row is locked.
+     */
+    private limitsFor;
     /**
      * The last thing every path does, so that no path can skip it.
      *

package/dist/{aggregation-BHo7a_In.d.cts → aggregation-OpnhwzF5.d.cts}

@@ -1,4 +1,5 @@
-import { PlanId, QuotaKey, FeatureKey, PlanCatalog, SubscriptionRepository, PlanVersionRepository, TransactionRunner, SubscriptionBundleRepository, BundleRepository, SubscriptionContractRepository, DiscoverySnapshot, SubscriptionRecord, TransactionContext, ContractLineItemRecord, SubscriptionContractRecord } from '@saasicat/core';
+import { PlanId, QuotaKey, FeatureKey, SubscriptionRepository, PlanVersionRepository, TransactionRunner, SubscriptionBundleRepository, BundleRepository, SubscriptionContractRepository, DiscoverySnapshot, PlanCatalog, SubscriptionRecord, TransactionContext, ContractLineItemRecord, SubscriptionContractRecord } from '@saasicat/core';
+import { P as PlanCatalogSource } from './plan-catalog-source-DWe-BGY1.cjs';
 import { E as EntitlementResolutionConfig } from './plan-resolution-CwUy_OqC.cjs';
 
 /**
@@ -113,7 +114,7 @@ interface EnforceLimitInput<T> {
     now?: Date;
 }
 declare class EntitlementService {
-    private readonly catalog;
+    private readonly catalogs;
     private readonly subscriptions;
     private readonly planVersions;
     private readonly tx;
@@ -124,8 +125,16 @@ declare class EntitlementService {
     private readonly discoverySnapshot;
     private readonly cache;
     private replacedByIndex;
-    constructor(catalog: PlanCatalog, subscriptions: SubscriptionRepository, planVersions: PlanVersionRepository, tx: TransactionRunner, resolutionConfig?: EntitlementResolutionConfig | null, subscriptionBundles?: SubscriptionBundleRepository | null, bundles?: BundleRepository | null, subscriptionContracts?: SubscriptionContractRepository | null, discoverySnapshot?: DiscoverySnapshot | null);
-    computeLimits(tenantId: string, now?: Date): Promise<EffectiveLimits>;
+    constructor(catalogs: PlanCatalogSource, subscriptions: SubscriptionRepository, planVersions: PlanVersionRepository, tx: TransactionRunner, resolutionConfig?: EntitlementResolutionConfig | null, subscriptionBundles?: SubscriptionBundleRepository | null, bundles?: BundleRepository | null, subscriptionContracts?: SubscriptionContractRepository | null, discoverySnapshot?: DiscoverySnapshot | null);
+    /**
+     * The tenant's effective limits, answered from the cache for up to
+     * `CACHE_TTL_MS`. A caller that has already read the catalogue for its own
+     * operation passes it as `catalog`: the answer is then computed against
+     * that reading and kept out of the cache in both directions — not taken
+     * from it, and not written to it, since a reading the caller holds may be
+     * older than the one everybody else should be answered from.
+     */
+    computeLimits(tenantId: string, now?: Date, catalog?: PlanCatalog): Promise<EffectiveLimits>;
     /**
      * Clears a tenant's cache entry. MUST be called as soon as a mutation
      * changes the subscription, a bundle booking, or a PlanVersion binding —
@@ -140,6 +149,13 @@ declare class EntitlementService {
      * have a `SubscriptionRecord` (e.g. within a transaction).
      */
     deriveLimits(sub: SubscriptionRecord, now: Date, tx?: TransactionContext): Promise<EffectiveLimits>;
+    /**
+     * `deriveLimits` against a catalogue already read. The catalogue decides
+     * which features are `plannedOnly`, and it is read outside any transaction
+     * a caller holds, so that checking a limit does not wait for a second
+     * connection while the subscription row is locked.
+     */
+    private limitsFor;
     /**
      * The last thing every path does, so that no path can skip it.
      *

package/dist/billing/index.d.cts

@@ -1,22 +1,24 @@
-import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalogSettings, PlanCatalogReadSink, PlanCatalog, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, ConfiguratorSourcesLookup, ConfiguratorMarketingProvider, ConfiguratorCatalog } from '@saasicat/core';
+import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalogSettings, PlanCatalogReadSink, PlanCatalog, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, TenantSubscriptionWritePort, ConfiguratorSourcesLookup, ConfiguratorMarketingProvider, ConfiguratorCatalog } from '@saasicat/core';
 export { BundleVersionFields, CancellationNoticePeriods, ChangeDirection, DiffResult, PlanVersionFields, SelfServiceBlockedPlans, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
-export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as CancellableSubscription, c as CancellationDecision, d as CancellationInput, e as ChangePlanDto, f as CompleteOnboardingSubscriptionDto, g as ComposedTenantAuthGuard, h as CycleDirection, L as LimitsCheckRow, N as NO_NOTICE_PERIOD, P as PendingPlanMaterializationService, i as PlanChangeContext, j as PlanChangePreviewDto, k as PlanChangePreviewIssue, l as PlanChangePreviewService, m as PlanChangeType, n as PlanDirection, o as PlanSnapshotDto, p as PreviewPlanChangeDto, q as ProrationDto, r as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, s as SubscriptionBundleCancelPreviewDto, t as SubscriptionBundleConfig, u as SubscriptionBundlePreviewContext, v as SubscriptionBundlePreviewIssue, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController, U as UsageResponse, z as addMonths, D as clampToParent, E as computeProration, F as decideCancellation, G as decideCancellationFor, H as noticeDaysFor, I as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-CN9DgasV.cjs';
-import { F as FEATURE_GUARD_MARKER, d as ContractFreezePort, e as ContractFreezeSourcePort } from '../tenant-billing.module-CPybDf7c.cjs';
-export { A as AjvErrorLike, C as CONTRACT_FREEZE_PORT_TOKEN, b as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, c as ContractFreezeBundleSnapshot, E as EnvironmentVariables, f as LoadPlanCatalogFromStringOptions, L as LoadPlanCatalogOptions, M as MarkedFeatureGuard, P as PLAN_CATALOG_UNREADABLE_ERROR, g as PlanCatalogValidationError, h as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, i as SELF_SERVICE_BLOCKED_PLANS_TOKEN, j as SelfServiceBlockedBundles, a as SubscriptionBundleControllerOptions, k as SubscriptionBundleModule, S as SubscriptionBundleModuleOptions, l as TenantBillingModule, T as TenantBillingModuleOptions, m as catalogSource, n as isPlatformFeatureGuard, o as loadPlanCatalogFromFile, p as loadPlanCatalogFromString } from '../tenant-billing.module-CPybDf7c.cjs';
+export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as CancellableSubscription, c as CancellationDecision, d as CancellationInput, e as ChangePlanDto, f as CompleteOnboardingSubscriptionDto, g as ComposedTenantAuthGuard, h as CycleDirection, L as LimitsCheckRow, N as NO_NOTICE_PERIOD, P as PendingPlanMaterializationService, i as PlanChangeContext, j as PlanChangePreviewDto, k as PlanChangePreviewIssue, l as PlanChangePreviewService, m as PlanChangeType, n as PlanDirection, o as PlanSnapshotDto, p as PreviewPlanChangeDto, q as ProrationDto, r as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, s as SubscriptionBundleCancelPreviewDto, t as SubscriptionBundleConfig, u as SubscriptionBundlePreviewContext, v as SubscriptionBundlePreviewIssue, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController, U as UsageResponse, z as addMonths, D as clampToParent, E as computeProration, F as decideCancellation, G as decideCancellationFor, H as noticeDaysFor, I as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-DKbAqTbM.cjs';
+import { F as FEATURE_GUARD_MARKER, d as ContractFreezePort, e as ContractFreezeSourcePort } from '../tenant-billing.module-ClbjzocC.cjs';
+export { A as AjvErrorLike, C as CONTRACT_FREEZE_PORT_TOKEN, b as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, c as ContractFreezeBundleSnapshot, E as EnvironmentVariables, f as LoadPlanCatalogFromStringOptions, L as LoadPlanCatalogOptions, M as MarkedFeatureGuard, P as PLAN_CATALOG_UNREADABLE_ERROR, g as PlanCatalogValidationError, h as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, i as SELF_SERVICE_BLOCKED_PLANS_TOKEN, j as SelfServiceBlockedBundles, a as SubscriptionBundleControllerOptions, k as SubscriptionBundleModule, S as SubscriptionBundleModuleOptions, l as TenantBillingModule, T as TenantBillingModuleOptions, m as catalogSource, n as isPlatformFeatureGuard, o as loadPlanCatalogFromFile, p as loadPlanCatalogFromString } from '../tenant-billing.module-ClbjzocC.cjs';
 import * as _nestjs_common from '@nestjs/common';
 import { CanActivate, ExecutionContext, ArgumentsHost, Type, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
 export { Type as NestType } from '@nestjs/common';
 import { Reflector, BaseExceptionFilter } from '@nestjs/core';
-import { c as EntitlementService } from '../aggregation-BHo7a_In.cjs';
+import { c as EntitlementService } from '../aggregation-OpnhwzF5.cjs';
 import { P as ProviderSpec } from '../di-CcNeq9v-.cjs';
+import { P as PlanCatalogSource } from '../plan-catalog-source-DWe-BGY1.cjs';
+export { a as PlanCatalogOrigin, g as givenPlanCatalogSource } from '../plan-catalog-source-DWe-BGY1.cjs';
 import { d as AuthGuardList } from '../tenant-billing.tokens-G-1xOlMr.cjs';
 export { c as AUDIT_CONTEXT_RESOLVER_TOKEN, A as AuditContextResolver, B as BILLING_PERMISSION_GUARDS_TOKEN, C as CANCELLATION_NOTICE_DAYS_TOKEN, D as DuePendingPlanChange, e as PENDING_PLAN_QUERY_PORT_TOKEN, P as PendingPlanQueryPort, S as SUBSCRIPTION_USAGE_PORT_TOKEN, f as SUBSCRIPTION_WRITE_PORT_TOKEN, g as TENANT_AUTH_GUARDS_TOKEN, h as TENANT_ID_RESOLVER_TOKEN, i as TRIAL_PROJECTION_PORT_TOKEN, T as TenantIdResolver, j as TrialProjectionInput, a as TrialProjectionPort, k as USAGE_SNAPSHOT_PORT_TOKEN, l as USER_EMAIL_RESOLVER_TOKEN, m as USER_ID_RESOLVER_TOKEN, U as UserEmailResolver, b as UserIdResolver } from '../tenant-billing.tokens-G-1xOlMr.cjs';
-import { S as SubscriptionContractService } from '../subscription-contract.service-D7Qb_Ns-.cjs';
-import '../promo.service-CBMm9RU7.cjs';
+import { S as SubscriptionContractService } from '../subscription-contract.service-CfNApLuP.cjs';
+import '../promo.service-BYBu6dy3.cjs';
 import '../admin-audit.service-4P3Djdxk.cjs';
-import '../contract-line-item-money-BWWQhRul.cjs';
+import '../contract-line-item-money-B0Z3Ogur.cjs';
 import '../plan-resolution-CwUy_OqC.cjs';
-import '../subscriber.service-BZsvHw1V.cjs';
+import '../subscriber.service-5W6Gi-1B.cjs';
 
 /**
  * One period onwards, on `anchorDay` where the month has one.
@@ -546,13 +548,16 @@ declare class LimitExceededFilter extends BaseExceptionFilter {
     catch(exception: unknown, host: ArgumentsHost): void;
 }
 
-declare const PLAN_CATALOG_TOKEN: unique symbol;
+/** The settings of `config/saas.yaml` — a `PlanCatalogSettings`, fixed while the process runs. */
+declare const PLAN_CATALOG_SETTINGS_TOKEN: unique symbol;
+/** A `PlanCatalogSource`: the plans and features as they stand when an operation asks. */
+declare const PLAN_CATALOG_SOURCE_TOKEN: unique symbol;
 declare const PLAN_CATALOG_READ_SINK_TOKEN: unique symbol;
 /**
  * Every settings block of `config/saas.yaml` — app identity, currency, VAT rate,
  * tenant billing and the rest — beside the read sink the plans and features
  * come from. The settings are handed on whole, so a block the schema gains
- * reaches `PLAN_CATALOG_TOKEN` without this module learning its name.
+ * reaches `PLAN_CATALOG_SETTINGS_TOKEN` without this module learning its name.
  */
 interface PlanCatalogModuleOptions extends PlanCatalogSettings {
     /** App-specific adapter for DB reads. */
@@ -652,6 +657,8 @@ declare function getMarketedPlans(catalog: PlanCatalog): PlanDef[];
  *   - the plan has no price for the cycle (`monthlyNet`/`yearlyNet === null`)
  */
 declare function getPlanPriceNet(catalog: PlanCatalog, planId: PlanId, cycle: BillingCycle): number | null;
+/** The same rule for a plan already in hand, whichever version it describes. */
+declare function listPriceNet(plan: PlanDef, cycle: BillingCycle): number | null;
 /**
  * Whether a plan on the list carries no price for a cycle, and so is not sold
  * in it: a plan without a yearly price is a monthly plan, one without either is
@@ -754,12 +761,12 @@ interface PublicBundleEntry {
     marketing?: MarketingFields;
 }
 declare class PublicCatalogController {
-    private readonly planCatalog;
+    private readonly planCatalogs;
     private readonly featureRegistry;
     private readonly marketingRepo;
     private readonly bundleRepo;
     private readonly catalogEntryRepo;
-    constructor(planCatalog: PlanCatalog, featureRegistry: FeatureUiRegistry, marketingRepo?: MarketingProjectionRepository | null, bundleRepo?: BundleRepository | null, catalogEntryRepo?: CatalogEntryRepository | null);
+    constructor(planCatalogs: PlanCatalogSource, featureRegistry: FeatureUiRegistry, marketingRepo?: MarketingProjectionRepository | null, bundleRepo?: BundleRepository | null, catalogEntryRepo?: CatalogEntryRepository | null);
     listPlans(lang?: string, localeParam?: string): Promise<PlanResponseEntry[]>;
     listFeatureRegistry(): Promise<FeatureUiRegistry>;
     /**
@@ -830,11 +837,11 @@ declare class BillingPermissionGuard implements CanActivate {
 }
 
 declare class SubscriptionContractFreezeService implements ContractFreezePort {
-    private readonly catalog;
+    private readonly catalogs;
     private readonly entitlements;
     private readonly contracts;
     private readonly source;
-    constructor(catalog: PlanCatalog, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort);
+    constructor(catalogs: PlanCatalogSource, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort, writes?: TenantSubscriptionWritePort | null);
     assertPartyFor(tenantId: string): Promise<void>;
     endOnCancellation(tenantId: string, effectiveAt: Date): Promise<void>;
     freezeOnPlanChange(tenantId: string, newPlan: string, billingCycle: BillingCycle, effectiveFrom: Date, endsAt?: Date | null): Promise<void>;
@@ -929,4 +936,4 @@ declare const SUBSCRIPTION_BUNDLE_CONFIG_TOKEN: unique symbol;
  */
 declare function buildTenantSubscriptionBundlesController(extraGuards?: Array<Type<CanActivate>>): Type;
 
-export { AddSubscriptionBundleDto, AuthGuardList, BILLING_FEATURE_UI_REGISTRY_TOKEN, BillingPermissionGuard, type BundleFirstPeriodInput, type BundlePeriodRollInput, type BundlePeriodWindow, type BundlePlanContext, BundlePriceLookupDto, CancelSubscriptionBundleDto, CatalogBundleUpsellResolver, ConfiguratorCatalogBuilder, ContractFreezePort, ContractFreezeSourcePort, DEFAULT_BUNDLE_MINIMUM_TERM_MONTHS, FEATURE_GUARD_CONFIG_TOKEN, FEATURE_GUARD_MARKER, FeatureGuard, type FeatureGuardConfig, LimitExceededFilter, type MarketingFields, type NextPeriodWindow, PLAN_CATALOG_IMPORT_SINK_TOKEN, PLAN_CATALOG_READ_SINK_TOKEN, PLAN_CATALOG_TOKEN, PUBLIC_CATALOG_BUNDLE_REPOSITORY_TOKEN, PUBLIC_CATALOG_MARKETING_REPOSITORY_TOKEN, type PeriodRollInput, type PlanAnchorSource, type PlanCatalogBuildSettings, PlanCatalogImportDto, type PlanCatalogImporterControllerConfig, PlanCatalogImporterModule, type PlanCatalogImporterModuleOptions, PlanCatalogImporterService, PlanCatalogModule, type PlanCatalogModuleOptions, type PlanResponseEntry, PreviewSubscriptionBundleDto, type PublicBundleEntry, PublicCatalogController, PublicCatalogModule, type PublicCatalogModuleOptions, PublishValidationError, type PublishablePlanVersion, REQUIRE_FEATURE_KEY, type RenewalDecision, type RenewalSubInput, RequireFeature, SUBSCRIPTION_BUNDLE_CONFIG_TOKEN, SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, SubscriptionContractFreezeService, UPSELL_OFFER_CURRENCY_TOKEN, UPSELL_OFFER_RESOLVER_TOKEN, advanceOneCycle, assertBaseVersionFresh, assertChangeNote, assertDraftPublishable, assertOptimisticLockHeld, billingAnchorDay, buildPlanCatalogFromSnapshot, buildPlanCatalogImporterController, buildTenantSubscriptionBundlesController, bundleCycleFitsPlan, bundleFirstPeriodEnd, bundleFirstPeriodStart, bundleNextPeriodEnd, clearPendingPlanVersionFields, computeCarriedTrialEndsAt, computeNextBundlePeriod, computeNextPeriod, cyclesSoldFor, decideRenewal, findPlan, getActiveFeatureKeys, getMarketedPlans, getPlanOrThrow, getPlanPriceGross, getPlanPriceNet, getPlanQuota, initialPeriodWindow, isFeatureInPlan, isFeaturePlannedOnly, isPlanNotSoldInCycle, periodEndAfter, periodEndWithMinLead, planNotSoldInCycle, resolveBundlePriceNet, resolvePlanAnchorDay, retreatOneCycle };
+export { AddSubscriptionBundleDto, AuthGuardList, BILLING_FEATURE_UI_REGISTRY_TOKEN, BillingPermissionGuard, type BundleFirstPeriodInput, type BundlePeriodRollInput, type BundlePeriodWindow, type BundlePlanContext, BundlePriceLookupDto, CancelSubscriptionBundleDto, CatalogBundleUpsellResolver, ConfiguratorCatalogBuilder, ContractFreezePort, ContractFreezeSourcePort, DEFAULT_BUNDLE_MINIMUM_TERM_MONTHS, FEATURE_GUARD_CONFIG_TOKEN, FEATURE_GUARD_MARKER, FeatureGuard, type FeatureGuardConfig, LimitExceededFilter, type MarketingFields, type NextPeriodWindow, PLAN_CATALOG_IMPORT_SINK_TOKEN, PLAN_CATALOG_READ_SINK_TOKEN, PLAN_CATALOG_SETTINGS_TOKEN, PLAN_CATALOG_SOURCE_TOKEN, PUBLIC_CATALOG_BUNDLE_REPOSITORY_TOKEN, PUBLIC_CATALOG_MARKETING_REPOSITORY_TOKEN, type PeriodRollInput, type PlanAnchorSource, type PlanCatalogBuildSettings, PlanCatalogImportDto, type PlanCatalogImporterControllerConfig, PlanCatalogImporterModule, type PlanCatalogImporterModuleOptions, PlanCatalogImporterService, PlanCatalogModule, type PlanCatalogModuleOptions, PlanCatalogSource, type PlanResponseEntry, PreviewSubscriptionBundleDto, type PublicBundleEntry, PublicCatalogController, PublicCatalogModule, type PublicCatalogModuleOptions, PublishValidationError, type PublishablePlanVersion, REQUIRE_FEATURE_KEY, type RenewalDecision, type RenewalSubInput, RequireFeature, SUBSCRIPTION_BUNDLE_CONFIG_TOKEN, SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, SubscriptionContractFreezeService, UPSELL_OFFER_CURRENCY_TOKEN, UPSELL_OFFER_RESOLVER_TOKEN, advanceOneCycle, assertBaseVersionFresh, assertChangeNote, assertDraftPublishable, assertOptimisticLockHeld, billingAnchorDay, buildPlanCatalogFromSnapshot, buildPlanCatalogImporterController, buildTenantSubscriptionBundlesController, bundleCycleFitsPlan, bundleFirstPeriodEnd, bundleFirstPeriodStart, bundleNextPeriodEnd, clearPendingPlanVersionFields, computeCarriedTrialEndsAt, computeNextBundlePeriod, computeNextPeriod, cyclesSoldFor, decideRenewal, findPlan, getActiveFeatureKeys, getMarketedPlans, getPlanOrThrow, getPlanPriceGross, getPlanPriceNet, getPlanQuota, initialPeriodWindow, isFeatureInPlan, isFeaturePlannedOnly, isPlanNotSoldInCycle, listPriceNet, periodEndAfter, periodEndWithMinLead, planNotSoldInCycle, resolveBundlePriceNet, resolvePlanAnchorDay, retreatOneCycle };

package/dist/billing/index.d.ts

@@ -1,22 +1,24 @@
-import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalogSettings, PlanCatalogReadSink, PlanCatalog, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, ConfiguratorSourcesLookup, ConfiguratorMarketingProvider, ConfiguratorCatalog } from '@saasicat/core';
+import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalogSettings, PlanCatalogReadSink, PlanCatalog, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, TenantSubscriptionWritePort, ConfiguratorSourcesLookup, ConfiguratorMarketingProvider, ConfiguratorCatalog } from '@saasicat/core';
 export { BundleVersionFields, CancellationNoticePeriods, ChangeDirection, DiffResult, PlanVersionFields, SelfServiceBlockedPlans, VersionChange, VersionChangeDirection, classifyBundleVersionDiff, classifyPlanDiff } from '@saasicat/core';
-export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as CancellableSubscription, c as CancellationDecision, d as CancellationInput, e as ChangePlanDto, f as CompleteOnboardingSubscriptionDto, g as ComposedTenantAuthGuard, h as CycleDirection, L as LimitsCheckRow, N as NO_NOTICE_PERIOD, P as PendingPlanMaterializationService, i as PlanChangeContext, j as PlanChangePreviewDto, k as PlanChangePreviewIssue, l as PlanChangePreviewService, m as PlanChangeType, n as PlanDirection, o as PlanSnapshotDto, p as PreviewPlanChangeDto, q as ProrationDto, r as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, s as SubscriptionBundleCancelPreviewDto, t as SubscriptionBundleConfig, u as SubscriptionBundlePreviewContext, v as SubscriptionBundlePreviewIssue, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController, U as UsageResponse, z as addMonths, D as clampToParent, E as computeProration, F as decideCancellation, G as decideCancellationFor, H as noticeDaysFor, I as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-0HZ_2DQH.js';
-import { F as FEATURE_GUARD_MARKER, d as ContractFreezePort, e as ContractFreezeSourcePort } from '../tenant-billing.module-C1sLBCW-.js';
-export { A as AjvErrorLike, C as CONTRACT_FREEZE_PORT_TOKEN, b as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, c as ContractFreezeBundleSnapshot, E as EnvironmentVariables, f as LoadPlanCatalogFromStringOptions, L as LoadPlanCatalogOptions, M as MarkedFeatureGuard, P as PLAN_CATALOG_UNREADABLE_ERROR, g as PlanCatalogValidationError, h as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, i as SELF_SERVICE_BLOCKED_PLANS_TOKEN, j as SelfServiceBlockedBundles, a as SubscriptionBundleControllerOptions, k as SubscriptionBundleModule, S as SubscriptionBundleModuleOptions, l as TenantBillingModule, T as TenantBillingModuleOptions, m as catalogSource, n as isPlatformFeatureGuard, o as loadPlanCatalogFromFile, p as loadPlanCatalogFromString } from '../tenant-billing.module-C1sLBCW-.js';
+export { A as AddBundleToSubscriptionInput, B as BundlePreviewSnapshot, C as CancelBundleFromSubscriptionInput, a as CancelSubscriptionDto, b as CancellableSubscription, c as CancellationDecision, d as CancellationInput, e as ChangePlanDto, f as CompleteOnboardingSubscriptionDto, g as ComposedTenantAuthGuard, h as CycleDirection, L as LimitsCheckRow, N as NO_NOTICE_PERIOD, P as PendingPlanMaterializationService, i as PlanChangeContext, j as PlanChangePreviewDto, k as PlanChangePreviewIssue, l as PlanChangePreviewService, m as PlanChangeType, n as PlanDirection, o as PlanSnapshotDto, p as PreviewPlanChangeDto, q as ProrationDto, r as ProrationInput, R as RedundantFeatureHint, S as SubscriptionBundleAddPreviewDto, s as SubscriptionBundleCancelPreviewDto, t as SubscriptionBundleConfig, u as SubscriptionBundlePreviewContext, v as SubscriptionBundlePreviewIssue, w as SubscriptionBundlePreviewService, x as SubscriptionBundlesService, T as TenantAdminGuard, y as TenantBillingController, U as UsageResponse, z as addMonths, D as clampToParent, E as computeProration, F as decideCancellation, G as decideCancellationFor, H as noticeDaysFor, I as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-BLqbsONe.js';
+import { F as FEATURE_GUARD_MARKER, d as ContractFreezePort, e as ContractFreezeSourcePort } from '../tenant-billing.module-DohgJJ2m.js';
+export { A as AjvErrorLike, C as CONTRACT_FREEZE_PORT_TOKEN, b as CONTRACT_FREEZE_SOURCE_PORT_TOKEN, c as ContractFreezeBundleSnapshot, E as EnvironmentVariables, f as LoadPlanCatalogFromStringOptions, L as LoadPlanCatalogOptions, M as MarkedFeatureGuard, P as PLAN_CATALOG_UNREADABLE_ERROR, g as PlanCatalogValidationError, h as SELF_SERVICE_BLOCKED_BUNDLES_TOKEN, i as SELF_SERVICE_BLOCKED_PLANS_TOKEN, j as SelfServiceBlockedBundles, a as SubscriptionBundleControllerOptions, k as SubscriptionBundleModule, S as SubscriptionBundleModuleOptions, l as TenantBillingModule, T as TenantBillingModuleOptions, m as catalogSource, n as isPlatformFeatureGuard, o as loadPlanCatalogFromFile, p as loadPlanCatalogFromString } from '../tenant-billing.module-DohgJJ2m.js';
 import * as _nestjs_common from '@nestjs/common';
 import { CanActivate, ExecutionContext, ArgumentsHost, Type, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
 export { Type as NestType } from '@nestjs/common';
 import { Reflector, BaseExceptionFilter } from '@nestjs/core';
-import { c as EntitlementService } from '../aggregation-CtIjlWHT.js';
+import { c as EntitlementService } from '../aggregation-ChpZDh0g.js';
 import { P as ProviderSpec } from '../di-CcNeq9v-.js';
+import { P as PlanCatalogSource } from '../plan-catalog-source-DWe-BGY1.js';
+export { a as PlanCatalogOrigin, g as givenPlanCatalogSource } from '../plan-catalog-source-DWe-BGY1.js';
 import { d as AuthGuardList } from '../tenant-billing.tokens-G-1xOlMr.js';
 export { c as AUDIT_CONTEXT_RESOLVER_TOKEN, A as AuditContextResolver, B as BILLING_PERMISSION_GUARDS_TOKEN, C as CANCELLATION_NOTICE_DAYS_TOKEN, D as DuePendingPlanChange, e as PENDING_PLAN_QUERY_PORT_TOKEN, P as PendingPlanQueryPort, S as SUBSCRIPTION_USAGE_PORT_TOKEN, f as SUBSCRIPTION_WRITE_PORT_TOKEN, g as TENANT_AUTH_GUARDS_TOKEN, h as TENANT_ID_RESOLVER_TOKEN, i as TRIAL_PROJECTION_PORT_TOKEN, T as TenantIdResolver, j as TrialProjectionInput, a as TrialProjectionPort, k as USAGE_SNAPSHOT_PORT_TOKEN, l as USER_EMAIL_RESOLVER_TOKEN, m as USER_ID_RESOLVER_TOKEN, U as UserEmailResolver, b as UserIdResolver } from '../tenant-billing.tokens-G-1xOlMr.js';
-import { S as SubscriptionContractService } from '../subscription-contract.service-Duv_Ns1W.js';
-import '../promo.service-CBMm9RU7.js';
+import { S as SubscriptionContractService } from '../subscription-contract.service-CPZrTM9C.js';
+import '../promo.service-CFjfF0Xm.js';
 import '../admin-audit.service-4P3Djdxk.js';
-import '../contract-line-item-money-BWWQhRul.js';
+import '../contract-line-item-money-B0Z3Ogur.js';
 import '../plan-resolution-CwUy_OqC.js';
-import '../subscriber.service-BZsvHw1V.js';
+import '../subscriber.service-5W6Gi-1B.js';
 
 /**
  * One period onwards, on `anchorDay` where the month has one.
@@ -546,13 +548,16 @@ declare class LimitExceededFilter extends BaseExceptionFilter {
     catch(exception: unknown, host: ArgumentsHost): void;
 }
 
-declare const PLAN_CATALOG_TOKEN: unique symbol;
+/** The settings of `config/saas.yaml` — a `PlanCatalogSettings`, fixed while the process runs. */
+declare const PLAN_CATALOG_SETTINGS_TOKEN: unique symbol;
+/** A `PlanCatalogSource`: the plans and features as they stand when an operation asks. */
+declare const PLAN_CATALOG_SOURCE_TOKEN: unique symbol;
 declare const PLAN_CATALOG_READ_SINK_TOKEN: unique symbol;
 /**
  * Every settings block of `config/saas.yaml` — app identity, currency, VAT rate,
  * tenant billing and the rest — beside the read sink the plans and features
  * come from. The settings are handed on whole, so a block the schema gains
- * reaches `PLAN_CATALOG_TOKEN` without this module learning its name.
+ * reaches `PLAN_CATALOG_SETTINGS_TOKEN` without this module learning its name.
  */
 interface PlanCatalogModuleOptions extends PlanCatalogSettings {
     /** App-specific adapter for DB reads. */
@@ -652,6 +657,8 @@ declare function getMarketedPlans(catalog: PlanCatalog): PlanDef[];
  *   - the plan has no price for the cycle (`monthlyNet`/`yearlyNet === null`)
  */
 declare function getPlanPriceNet(catalog: PlanCatalog, planId: PlanId, cycle: BillingCycle): number | null;
+/** The same rule for a plan already in hand, whichever version it describes. */
+declare function listPriceNet(plan: PlanDef, cycle: BillingCycle): number | null;
 /**
  * Whether a plan on the list carries no price for a cycle, and so is not sold
  * in it: a plan without a yearly price is a monthly plan, one without either is
@@ -754,12 +761,12 @@ interface PublicBundleEntry {
     marketing?: MarketingFields;
 }
 declare class PublicCatalogController {
-    private readonly planCatalog;
+    private readonly planCatalogs;
     private readonly featureRegistry;
     private readonly marketingRepo;
     private readonly bundleRepo;
     private readonly catalogEntryRepo;
-    constructor(planCatalog: PlanCatalog, featureRegistry: FeatureUiRegistry, marketingRepo?: MarketingProjectionRepository | null, bundleRepo?: BundleRepository | null, catalogEntryRepo?: CatalogEntryRepository | null);
+    constructor(planCatalogs: PlanCatalogSource, featureRegistry: FeatureUiRegistry, marketingRepo?: MarketingProjectionRepository | null, bundleRepo?: BundleRepository | null, catalogEntryRepo?: CatalogEntryRepository | null);
     listPlans(lang?: string, localeParam?: string): Promise<PlanResponseEntry[]>;
     listFeatureRegistry(): Promise<FeatureUiRegistry>;
     /**
@@ -830,11 +837,11 @@ declare class BillingPermissionGuard implements CanActivate {
 }
 
 declare class SubscriptionContractFreezeService implements ContractFreezePort {
-    private readonly catalog;
+    private readonly catalogs;
     private readonly entitlements;
     private readonly contracts;
     private readonly source;
-    constructor(catalog: PlanCatalog, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort);
+    constructor(catalogs: PlanCatalogSource, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort, writes?: TenantSubscriptionWritePort | null);
     assertPartyFor(tenantId: string): Promise<void>;
     endOnCancellation(tenantId: string, effectiveAt: Date): Promise<void>;
     freezeOnPlanChange(tenantId: string, newPlan: string, billingCycle: BillingCycle, effectiveFrom: Date, endsAt?: Date | null): Promise<void>;
@@ -929,4 +936,4 @@ declare const SUBSCRIPTION_BUNDLE_CONFIG_TOKEN: unique symbol;
  */
 declare function buildTenantSubscriptionBundlesController(extraGuards?: Array<Type<CanActivate>>): Type;
 
-export { AddSubscriptionBundleDto, AuthGuardList, BILLING_FEATURE_UI_REGISTRY_TOKEN, BillingPermissionGuard, type BundleFirstPeriodInput, type BundlePeriodRollInput, type BundlePeriodWindow, type BundlePlanContext, BundlePriceLookupDto, CancelSubscriptionBundleDto, CatalogBundleUpsellResolver, ConfiguratorCatalogBuilder, ContractFreezePort, ContractFreezeSourcePort, DEFAULT_BUNDLE_MINIMUM_TERM_MONTHS, FEATURE_GUARD_CONFIG_TOKEN, FEATURE_GUARD_MARKER, FeatureGuard, type FeatureGuardConfig, LimitExceededFilter, type MarketingFields, type NextPeriodWindow, PLAN_CATALOG_IMPORT_SINK_TOKEN, PLAN_CATALOG_READ_SINK_TOKEN, PLAN_CATALOG_TOKEN, PUBLIC_CATALOG_BUNDLE_REPOSITORY_TOKEN, PUBLIC_CATALOG_MARKETING_REPOSITORY_TOKEN, type PeriodRollInput, type PlanAnchorSource, type PlanCatalogBuildSettings, PlanCatalogImportDto, type PlanCatalogImporterControllerConfig, PlanCatalogImporterModule, type PlanCatalogImporterModuleOptions, PlanCatalogImporterService, PlanCatalogModule, type PlanCatalogModuleOptions, type PlanResponseEntry, PreviewSubscriptionBundleDto, type PublicBundleEntry, PublicCatalogController, PublicCatalogModule, type PublicCatalogModuleOptions, PublishValidationError, type PublishablePlanVersion, REQUIRE_FEATURE_KEY, type RenewalDecision, type RenewalSubInput, RequireFeature, SUBSCRIPTION_BUNDLE_CONFIG_TOKEN, SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, SubscriptionContractFreezeService, UPSELL_OFFER_CURRENCY_TOKEN, UPSELL_OFFER_RESOLVER_TOKEN, advanceOneCycle, assertBaseVersionFresh, assertChangeNote, assertDraftPublishable, assertOptimisticLockHeld, billingAnchorDay, buildPlanCatalogFromSnapshot, buildPlanCatalogImporterController, buildTenantSubscriptionBundlesController, bundleCycleFitsPlan, bundleFirstPeriodEnd, bundleFirstPeriodStart, bundleNextPeriodEnd, clearPendingPlanVersionFields, computeCarriedTrialEndsAt, computeNextBundlePeriod, computeNextPeriod, cyclesSoldFor, decideRenewal, findPlan, getActiveFeatureKeys, getMarketedPlans, getPlanOrThrow, getPlanPriceGross, getPlanPriceNet, getPlanQuota, initialPeriodWindow, isFeatureInPlan, isFeaturePlannedOnly, isPlanNotSoldInCycle, periodEndAfter, periodEndWithMinLead, planNotSoldInCycle, resolveBundlePriceNet, resolvePlanAnchorDay, retreatOneCycle };
+export { AddSubscriptionBundleDto, AuthGuardList, BILLING_FEATURE_UI_REGISTRY_TOKEN, BillingPermissionGuard, type BundleFirstPeriodInput, type BundlePeriodRollInput, type BundlePeriodWindow, type BundlePlanContext, BundlePriceLookupDto, CancelSubscriptionBundleDto, CatalogBundleUpsellResolver, ConfiguratorCatalogBuilder, ContractFreezePort, ContractFreezeSourcePort, DEFAULT_BUNDLE_MINIMUM_TERM_MONTHS, FEATURE_GUARD_CONFIG_TOKEN, FEATURE_GUARD_MARKER, FeatureGuard, type FeatureGuardConfig, LimitExceededFilter, type MarketingFields, type NextPeriodWindow, PLAN_CATALOG_IMPORT_SINK_TOKEN, PLAN_CATALOG_READ_SINK_TOKEN, PLAN_CATALOG_SETTINGS_TOKEN, PLAN_CATALOG_SOURCE_TOKEN, PUBLIC_CATALOG_BUNDLE_REPOSITORY_TOKEN, PUBLIC_CATALOG_MARKETING_REPOSITORY_TOKEN, type PeriodRollInput, type PlanAnchorSource, type PlanCatalogBuildSettings, PlanCatalogImportDto, type PlanCatalogImporterControllerConfig, PlanCatalogImporterModule, type PlanCatalogImporterModuleOptions, PlanCatalogImporterService, PlanCatalogModule, type PlanCatalogModuleOptions, PlanCatalogSource, type PlanResponseEntry, PreviewSubscriptionBundleDto, type PublicBundleEntry, PublicCatalogController, PublicCatalogModule, type PublicCatalogModuleOptions, PublishValidationError, type PublishablePlanVersion, REQUIRE_FEATURE_KEY, type RenewalDecision, type RenewalSubInput, RequireFeature, SUBSCRIPTION_BUNDLE_CONFIG_TOKEN, SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, SubscriptionContractFreezeService, UPSELL_OFFER_CURRENCY_TOKEN, UPSELL_OFFER_RESOLVER_TOKEN, advanceOneCycle, assertBaseVersionFresh, assertChangeNote, assertDraftPublishable, assertOptimisticLockHeld, billingAnchorDay, buildPlanCatalogFromSnapshot, buildPlanCatalogImporterController, buildTenantSubscriptionBundlesController, bundleCycleFitsPlan, bundleFirstPeriodEnd, bundleFirstPeriodStart, bundleNextPeriodEnd, clearPendingPlanVersionFields, computeCarriedTrialEndsAt, computeNextBundlePeriod, computeNextPeriod, cyclesSoldFor, decideRenewal, findPlan, getActiveFeatureKeys, getMarketedPlans, getPlanOrThrow, getPlanPriceGross, getPlanPriceNet, getPlanQuota, initialPeriodWindow, isFeatureInPlan, isFeaturePlannedOnly, isPlanNotSoldInCycle, listPriceNet, periodEndAfter, periodEndWithMinLead, planNotSoldInCycle, resolveBundlePriceNet, resolvePlanAnchorDay, retreatOneCycle };

package/dist/billing/index.js

@@ -20,7 +20,7 @@ import {
   computeCarriedTrialEndsAt,
   computeNextPeriod,
   decideRenewal
-} from "../chunk-IORLRWJZ.js";
+} from "../chunk-R5YCJBHY.js";
 import {
   AddSubscriptionBundleDto,
   BILLING_FEATURE_UI_REGISTRY_TOKEN,
@@ -79,15 +79,15 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "../chunk-6ISJMNW7.js";
+} from "../chunk-M47BNEY2.js";
 import {
   classifyBundleVersionDiff,
   classifyPlanDiff
 } from "../chunk-GZTL64QK.js";
 import "../chunk-34XVPR6P.js";
 import "../chunk-OOTEXP47.js";
-import "../chunk-XWAZNKAB.js";
-import "../chunk-U465NU23.js";
+import "../chunk-3RLWML2S.js";
+import "../chunk-NDLC5GYK.js";
 import {
   cyclesSoldFor,
   resolveBundlePriceNet
@@ -95,7 +95,7 @@ import {
 import {
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "../chunk-FQS5FPH2.js";
+} from "../chunk-G6EZWECL.js";
 import "../chunk-OUDSQ3PU.js";
 import {
   findPlan,
@@ -108,12 +108,12 @@ import {
   isFeatureInPlan,
   isFeaturePlannedOnly,
   isPlanNotSoldInCycle,
+  listPriceNet,
   planNotSoldInCycle
-} from "../chunk-QBF7KLSA.js";
+} from "../chunk-TBBZWZQT.js";
 import "../chunk-VBRYPU7V.js";
-import "../chunk-5BCYJ3QY.js";
-import "../chunk-QSBMFY4I.js";
-import "../chunk-AOQJEYOL.js";
+import "../chunk-6PJE7EWO.js";
+import "../chunk-3QVGA6JX.js";
 import "../chunk-QUZU2M33.js";
 import {
   BillingPermissionGuard,
@@ -134,15 +134,17 @@ import {
   USER_ID_RESOLVER_TOKEN
 } from "../chunk-GPQWGA6B.js";
 import "../chunk-SZ7RFPXA.js";
-import "../chunk-U4X2YRRO.js";
-import "../chunk-3HT3REXB.js";
+import "../chunk-WOEJ6K7M.js";
+import "../chunk-LF6J4YYN.js";
 import "../chunk-YSC46BGM.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
-  PLAN_CATALOG_TOKEN,
+  PLAN_CATALOG_SETTINGS_TOKEN,
+  PLAN_CATALOG_SOURCE_TOKEN,
   PlanCatalogModule,
-  buildPlanCatalogFromSnapshot
-} from "../chunk-323FB6TD.js";
+  buildPlanCatalogFromSnapshot,
+  givenPlanCatalogSource
+} from "../chunk-FEQZCWUL.js";
 import "../chunk-J7NJRK3K.js";
 import "../chunk-SHUYVCID.js";
 export {
@@ -171,7 +173,8 @@ export {
   PENDING_PLAN_QUERY_PORT_TOKEN,
   PLAN_CATALOG_IMPORT_SINK_TOKEN,
   PLAN_CATALOG_READ_SINK_TOKEN,
-  PLAN_CATALOG_TOKEN,
+  PLAN_CATALOG_SETTINGS_TOKEN,
+  PLAN_CATALOG_SOURCE_TOKEN,
   PLAN_CATALOG_UNREADABLE_ERROR,
   PUBLIC_CATALOG_BUNDLE_REPOSITORY_TOKEN,
   PUBLIC_CATALOG_MARKETING_REPOSITORY_TOKEN,
@@ -244,11 +247,13 @@ export {
   getPlanPriceGross,
   getPlanPriceNet,
   getPlanQuota,
+  givenPlanCatalogSource,
   initialPeriodWindow,
   isFeatureInPlan,
   isFeaturePlannedOnly,
   isPlanNotSoldInCycle,
   isPlatformFeatureGuard,
+  listPriceNet,
   loadPlanCatalogFromFile,
   loadPlanCatalogFromString,
   noticeDaysFor,