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

package/dist/catalog/index.d.cts

@@ -1,6 +1,6 @@
-export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-BM7lKLr1.cjs';
+export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService } from '../plan-versions.service-DARLh-qI.cjs';
 import { Type, CanActivate } from '@nestjs/common';
-export { a as CatalogControllerConfig, b as CatalogModule, C as CatalogModuleOptions } from '../catalog.module-DKVvsPsl.cjs';
+export { a as CatalogControllerConfig, b as CatalogModule, C as CatalogModuleOptions, N as NewPaymentMethodsSource, P as PublicMarketingCatalogOptions, c as PublicMarketingCatalogService } from '../catalog.module-T-I5Ricz.cjs';
 import { StrictModeWarningCode, StrictModeWarning, DiscoverySnapshot, ApprovedCatalogKeys, DiscoveredQuota, CatalogEntryRepository, PlanVersionRow, BundleVersionRow, DiscoveryStatus, CatalogEntryI18n, PromotionType, PromotionValue, PromotionTargetType, PromotionBillingCycle, PromotionI18n } from '@saasicat/core';
 import '../discovery.scanner-DXKc6JkV.cjs';
 import '@nestjs/core';
@@ -68,6 +68,13 @@ declare const CATALOG_SERVICE_CONFIG_TOKEN: unique symbol;
  * is namespaced accordingly so the two never collide.
  */
 declare const CATALOG_FEATURE_UI_REGISTRY_TOKEN: unique symbol;
+/**
+ * Where the public catalogue reads what a new payment method is taken with —
+ * `PaymentGatewayRegistry` where the application wired payments, and `null`
+ * where it did not. Always provided, so a catalogue that answers the question
+ * cannot be wired without an answer to it.
+ */
+declare const NEW_PAYMENT_METHODS_SOURCE_TOKEN: unique symbol;
 
 /**
  * Advisory warnings (#35): they inform but never block — not even in
@@ -345,6 +352,12 @@ declare class UpdateBundleDto {
         description?: string;
     }>;
 }
+/** One plan's own price for a bundle version, in `pricingOverrides`. */
+declare class BundlePricingOverrideDto {
+    planId?: string;
+    monthlyNet?: string | null;
+    yearlyNet?: string | null;
+}
 /**
  * Everything a version draft may carry apart from its feature list.
  *
@@ -363,11 +376,7 @@ declare class BundleVersionDraftFieldsDto {
     compatibility?: {
         planIds?: string[];
     };
-    pricingOverrides?: Array<{
-        planId?: string;
-        monthlyNet?: string | null;
-        yearlyNet?: string | null;
-    }>;
+    pricingOverrides?: BundlePricingOverrideDto[];
     monthlyNet?: string | null;
     yearlyNet?: string | null;
     marketed?: boolean;
@@ -567,4 +576,4 @@ declare class PublishPlanVersionDto {
     validUntil?: string | null;
 }
 
-export { ADVISORY_STRICT_MODE_CODES, BUNDLE_REPOSITORY_TOKEN, BUNDLE_VERSION_WINDOW_CODES, CATALOG_ENTRY_REPOSITORY_TOKEN, CATALOG_FEATURE_UI_REGISTRY_TOKEN, CATALOG_SERVICE_CONFIG_TOKEN, CreateBundleDto, CreateBundleVersionDraftDto, CreateMarketingProjectionDto, CreatePlanDto, CreatePlanVersionDraftDto, CreatePromotionDto, ListCatalogEntriesQueryDto, ListMarketingProjectionsQueryDto, MARKETING_PROJECTION_REPOSITORY_TOKEN, MARKETING_SETTINGS_REPOSITORY_TOKEN, PLAN_REPOSITORY_TOKEN, PLAN_VERSION_WINDOW_CODES, PROMOTION_REPOSITORY_TOKEN, type PreflightFinding, type PreflightInput, type PreflightReport, type PreviousWindow, PublishBundleVersionDto, PublishPlanVersionDto, ReviewCatalogEntryDto, type SeedBundleDraft, type SeedGateFinding, type SeedGateInput, type SeedGateMode, type SeedGateReport, type SeedGateRunOptions, type SeedPlanDraft, SyncDiscoveryDto, UpdateBundleDto, UpdateBundleVersionDraftDto, UpdateCatalogEntryI18nDto, UpdateMarketingProjectionDto, UpdateMarketingSettingsDto, UpdatePlanDto, UpdatePlanVersionDraftDto, UpdatePromotionDto, type ValidityWindowCodes, type ValidityWindowInput, blockingStrictModeWarnings, buildBundleVersionsController, buildBundlesController, buildCatalogEntriesController, buildMarketingProjectionsController, buildMarketingSettingsController, buildPlanVersionsController, buildPlansController, buildPromotionsController, buildPublicMarketingCatalogController, featureApprovalSignature, formatPreflightReport, formatSeedGateReport, loadApprovedCatalogKeys, preflightExitCode, quotaApprovalSignature, resolveValidityWindow, runPreflight, runSeedGateFromFile, seedGateExitCode, validateBundleDraft, validatePlanDraft, validateSeedAgainstSnapshot };
+export { ADVISORY_STRICT_MODE_CODES, BUNDLE_REPOSITORY_TOKEN, BUNDLE_VERSION_WINDOW_CODES, CATALOG_ENTRY_REPOSITORY_TOKEN, CATALOG_FEATURE_UI_REGISTRY_TOKEN, CATALOG_SERVICE_CONFIG_TOKEN, CreateBundleDto, CreateBundleVersionDraftDto, CreateMarketingProjectionDto, CreatePlanDto, CreatePlanVersionDraftDto, CreatePromotionDto, ListCatalogEntriesQueryDto, ListMarketingProjectionsQueryDto, MARKETING_PROJECTION_REPOSITORY_TOKEN, MARKETING_SETTINGS_REPOSITORY_TOKEN, NEW_PAYMENT_METHODS_SOURCE_TOKEN, PLAN_REPOSITORY_TOKEN, PLAN_VERSION_WINDOW_CODES, PROMOTION_REPOSITORY_TOKEN, type PreflightFinding, type PreflightInput, type PreflightReport, type PreviousWindow, PublishBundleVersionDto, PublishPlanVersionDto, ReviewCatalogEntryDto, type SeedBundleDraft, type SeedGateFinding, type SeedGateInput, type SeedGateMode, type SeedGateReport, type SeedGateRunOptions, type SeedPlanDraft, SyncDiscoveryDto, UpdateBundleDto, UpdateBundleVersionDraftDto, UpdateCatalogEntryI18nDto, UpdateMarketingProjectionDto, UpdateMarketingSettingsDto, UpdatePlanDto, UpdatePlanVersionDraftDto, UpdatePromotionDto, type ValidityWindowCodes, type ValidityWindowInput, blockingStrictModeWarnings, buildBundleVersionsController, buildBundlesController, buildCatalogEntriesController, buildMarketingProjectionsController, buildMarketingSettingsController, buildPlanVersionsController, buildPlansController, buildPromotionsController, buildPublicMarketingCatalogController, featureApprovalSignature, formatPreflightReport, formatSeedGateReport, loadApprovedCatalogKeys, preflightExitCode, quotaApprovalSignature, resolveValidityWindow, runPreflight, runSeedGateFromFile, seedGateExitCode, validateBundleDraft, validatePlanDraft, validateSeedAgainstSnapshot };

package/dist/catalog/index.d.ts

@@ -1,6 +1,6 @@
-export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService, e as PublicMarketingCatalogService } from '../plan-versions.service-BTlw-aEX.js';
+export { B as BundlesService, C as CatalogEntriesService, a as CatalogServiceConfig, M as MarketingProjectionsService, b as MarketingSettingsService, P as PlanVersionsService, c as PlansService, d as PromotionsService } from '../plan-versions.service-C0N-Em2W.js';
 import { Type, CanActivate } from '@nestjs/common';
-export { a as CatalogControllerConfig, b as CatalogModule, C as CatalogModuleOptions } from '../catalog.module-B5E8tsl7.js';
+export { a as CatalogControllerConfig, b as CatalogModule, C as CatalogModuleOptions, N as NewPaymentMethodsSource, P as PublicMarketingCatalogOptions, c as PublicMarketingCatalogService } from '../catalog.module-C9O7BxRq.js';
 import { StrictModeWarningCode, StrictModeWarning, DiscoverySnapshot, ApprovedCatalogKeys, DiscoveredQuota, CatalogEntryRepository, PlanVersionRow, BundleVersionRow, DiscoveryStatus, CatalogEntryI18n, PromotionType, PromotionValue, PromotionTargetType, PromotionBillingCycle, PromotionI18n } from '@saasicat/core';
 import '../discovery.scanner-DXKc6JkV.js';
 import '@nestjs/core';
@@ -68,6 +68,13 @@ declare const CATALOG_SERVICE_CONFIG_TOKEN: unique symbol;
  * is namespaced accordingly so the two never collide.
  */
 declare const CATALOG_FEATURE_UI_REGISTRY_TOKEN: unique symbol;
+/**
+ * Where the public catalogue reads what a new payment method is taken with —
+ * `PaymentGatewayRegistry` where the application wired payments, and `null`
+ * where it did not. Always provided, so a catalogue that answers the question
+ * cannot be wired without an answer to it.
+ */
+declare const NEW_PAYMENT_METHODS_SOURCE_TOKEN: unique symbol;
 
 /**
  * Advisory warnings (#35): they inform but never block — not even in
@@ -345,6 +352,12 @@ declare class UpdateBundleDto {
         description?: string;
     }>;
 }
+/** One plan's own price for a bundle version, in `pricingOverrides`. */
+declare class BundlePricingOverrideDto {
+    planId?: string;
+    monthlyNet?: string | null;
+    yearlyNet?: string | null;
+}
 /**
  * Everything a version draft may carry apart from its feature list.
  *
@@ -363,11 +376,7 @@ declare class BundleVersionDraftFieldsDto {
     compatibility?: {
         planIds?: string[];
     };
-    pricingOverrides?: Array<{
-        planId?: string;
-        monthlyNet?: string | null;
-        yearlyNet?: string | null;
-    }>;
+    pricingOverrides?: BundlePricingOverrideDto[];
     monthlyNet?: string | null;
     yearlyNet?: string | null;
     marketed?: boolean;
@@ -567,4 +576,4 @@ declare class PublishPlanVersionDto {
     validUntil?: string | null;
 }
 
-export { ADVISORY_STRICT_MODE_CODES, BUNDLE_REPOSITORY_TOKEN, BUNDLE_VERSION_WINDOW_CODES, CATALOG_ENTRY_REPOSITORY_TOKEN, CATALOG_FEATURE_UI_REGISTRY_TOKEN, CATALOG_SERVICE_CONFIG_TOKEN, CreateBundleDto, CreateBundleVersionDraftDto, CreateMarketingProjectionDto, CreatePlanDto, CreatePlanVersionDraftDto, CreatePromotionDto, ListCatalogEntriesQueryDto, ListMarketingProjectionsQueryDto, MARKETING_PROJECTION_REPOSITORY_TOKEN, MARKETING_SETTINGS_REPOSITORY_TOKEN, PLAN_REPOSITORY_TOKEN, PLAN_VERSION_WINDOW_CODES, PROMOTION_REPOSITORY_TOKEN, type PreflightFinding, type PreflightInput, type PreflightReport, type PreviousWindow, PublishBundleVersionDto, PublishPlanVersionDto, ReviewCatalogEntryDto, type SeedBundleDraft, type SeedGateFinding, type SeedGateInput, type SeedGateMode, type SeedGateReport, type SeedGateRunOptions, type SeedPlanDraft, SyncDiscoveryDto, UpdateBundleDto, UpdateBundleVersionDraftDto, UpdateCatalogEntryI18nDto, UpdateMarketingProjectionDto, UpdateMarketingSettingsDto, UpdatePlanDto, UpdatePlanVersionDraftDto, UpdatePromotionDto, type ValidityWindowCodes, type ValidityWindowInput, blockingStrictModeWarnings, buildBundleVersionsController, buildBundlesController, buildCatalogEntriesController, buildMarketingProjectionsController, buildMarketingSettingsController, buildPlanVersionsController, buildPlansController, buildPromotionsController, buildPublicMarketingCatalogController, featureApprovalSignature, formatPreflightReport, formatSeedGateReport, loadApprovedCatalogKeys, preflightExitCode, quotaApprovalSignature, resolveValidityWindow, runPreflight, runSeedGateFromFile, seedGateExitCode, validateBundleDraft, validatePlanDraft, validateSeedAgainstSnapshot };
+export { ADVISORY_STRICT_MODE_CODES, BUNDLE_REPOSITORY_TOKEN, BUNDLE_VERSION_WINDOW_CODES, CATALOG_ENTRY_REPOSITORY_TOKEN, CATALOG_FEATURE_UI_REGISTRY_TOKEN, CATALOG_SERVICE_CONFIG_TOKEN, CreateBundleDto, CreateBundleVersionDraftDto, CreateMarketingProjectionDto, CreatePlanDto, CreatePlanVersionDraftDto, CreatePromotionDto, ListCatalogEntriesQueryDto, ListMarketingProjectionsQueryDto, MARKETING_PROJECTION_REPOSITORY_TOKEN, MARKETING_SETTINGS_REPOSITORY_TOKEN, NEW_PAYMENT_METHODS_SOURCE_TOKEN, PLAN_REPOSITORY_TOKEN, PLAN_VERSION_WINDOW_CODES, PROMOTION_REPOSITORY_TOKEN, type PreflightFinding, type PreflightInput, type PreflightReport, type PreviousWindow, PublishBundleVersionDto, PublishPlanVersionDto, ReviewCatalogEntryDto, type SeedBundleDraft, type SeedGateFinding, type SeedGateInput, type SeedGateMode, type SeedGateReport, type SeedGateRunOptions, type SeedPlanDraft, SyncDiscoveryDto, UpdateBundleDto, UpdateBundleVersionDraftDto, UpdateCatalogEntryI18nDto, UpdateMarketingProjectionDto, UpdateMarketingSettingsDto, UpdatePlanDto, UpdatePlanVersionDraftDto, UpdatePromotionDto, type ValidityWindowCodes, type ValidityWindowInput, blockingStrictModeWarnings, buildBundleVersionsController, buildBundlesController, buildCatalogEntriesController, buildMarketingProjectionsController, buildMarketingSettingsController, buildPlanVersionsController, buildPlansController, buildPromotionsController, buildPublicMarketingCatalogController, featureApprovalSignature, formatPreflightReport, formatSeedGateReport, loadApprovedCatalogKeys, preflightExitCode, quotaApprovalSignature, resolveValidityWindow, runPreflight, runSeedGateFromFile, seedGateExitCode, validateBundleDraft, validatePlanDraft, validateSeedAgainstSnapshot };

package/dist/catalog/index.js

@@ -6,7 +6,7 @@ import {
   runSeedGateFromFile,
   seedGateExitCode,
   validateSeedAgainstSnapshot
-} from "../chunk-NEICZJE4.js";
+} from "../chunk-F5X66HF5.js";
 import {
   ADVISORY_STRICT_MODE_CODES,
   BUNDLE_VERSION_WINDOW_CODES,
@@ -56,7 +56,7 @@ import {
   resolveValidityWindow,
   validateBundleDraft,
   validatePlanDraft
-} from "../chunk-NCXGXNQK.js";
+} from "../chunk-CQ2ZZMTD.js";
 import "../chunk-GZTL64QK.js";
 import "../chunk-34XVPR6P.js";
 import "../chunk-OOTEXP47.js";
@@ -71,9 +71,10 @@ import {
   CATALOG_SERVICE_CONFIG_TOKEN,
   MARKETING_PROJECTION_REPOSITORY_TOKEN,
   MARKETING_SETTINGS_REPOSITORY_TOKEN,
+  NEW_PAYMENT_METHODS_SOURCE_TOKEN,
   PLAN_REPOSITORY_TOKEN,
   PROMOTION_REPOSITORY_TOKEN
-} from "../chunk-AOQJEYOL.js";
+} from "../chunk-3QVGA6JX.js";
 import "../chunk-QUZU2M33.js";
 import "../chunk-GPQWGA6B.js";
 import "../chunk-SZ7RFPXA.js";
@@ -102,6 +103,7 @@ export {
   MARKETING_SETTINGS_REPOSITORY_TOKEN,
   MarketingProjectionsService,
   MarketingSettingsService,
+  NEW_PAYMENT_METHODS_SOURCE_TOKEN,
   PLAN_REPOSITORY_TOKEN,
   PLAN_VERSION_WINDOW_CODES,
   PROMOTION_REPOSITORY_TOKEN,

package/dist/{catalog.module-B5E8tsl7.d.ts → catalog.module-C9O7BxRq.d.ts}

@@ -1,7 +1,84 @@
 import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
-import { BundleRepository, MarketingProjectionRepository, CatalogEntryRepository, PromotionRepository, MarketingSettingsRepository, PlanRepository, FeatureUiRegistry } from '@saasicat/core';
+import { PaymentMethodType, PlanRepository, MarketingProjectionRepository, PromotionRepository, CatalogEntryRepository, BundleRepository, PublicMarketingCatalogResponse, MarketingSettingsRepository, FeatureUiRegistry } from '@saasicat/core';
 import { P as ProviderSpec } from './di-CcNeq9v-.js';
 
+/**
+ * What the catalogue needs of whatever knows the payment accounts: the account
+ * new payment methods are taken at, or `null` where none takes them.
+ * `PaymentGatewayRegistry` satisfies it; the shape keeps this module free of a
+ * dependency on the payments module.
+ */
+interface NewPaymentMethodsSource {
+    forNewPaymentMethods(): {
+        methods: readonly PaymentMethodType[];
+    } | null;
+}
+declare class PublicMarketingCatalogService {
+    private readonly planRepo;
+    private readonly marketingRepo;
+    private readonly promotionRepo;
+    private readonly catalogEntryRepo;
+    private readonly bundleRepo;
+    private readonly newPaymentMethodsSource;
+    constructor(planRepo: PlanRepository, marketingRepo: MarketingProjectionRepository, promotionRepo: PromotionRepository, catalogEntryRepo: (CatalogEntryRepository | null) | undefined, bundleRepo: (BundleRepository | null) | undefined, newPaymentMethodsSource: NewPaymentMethodsSource | null);
+    /** What a new payment method is taken with here, for the page that offers the plans. */
+    private newPaymentMethods;
+    getCatalog(locale: string, currency: string, vatRate: number, asOf?: Date): Promise<PublicMarketingCatalogResponse>;
+    /**
+     * Loads all published-and-live bundle versions 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;
+}
+
+/** What the auth-free pricing-page endpoint is mounted with. */
+interface PublicMarketingCatalogOptions {
+    guards: Array<Type<CanActivate>>;
+    currency: string;
+    vatRate: number;
+    /**
+     * Where the catalogue reads what a new payment method is taken with —
+     * `PaymentGatewayRegistry` from `@saasicat/nest/payments` where the
+     * application wired payments, and `null` where nothing takes them.
+     *
+     * Required and nullable rather than optional, because leaving it out is not
+     * silence: the endpoint would publish that no payment method is taken,
+     * which is a claim, and an application whose form takes one would publish
+     * the opposite of what it does. `SaaSiCatModule` fills it from `payments`.
+     */
+    newPaymentMethodsFrom: Type<NewPaymentMethodsSource> | null;
+}
 interface CatalogControllerConfig {
     /**
      * Class-level guards for `BundlesController` and `BundleVersionsController`.
@@ -45,11 +122,7 @@ interface CatalogModuleOptions {
      *. Registered only when plan-, marketingProjection-
      * and promotionRepository are set. `guards` is usually `[]`.
      */
-    publicMarketingCatalog?: {
-        guards: Array<Type<CanActivate>>;
-        currency: string;
-        vatRate: number;
-    };
+    publicMarketingCatalog?: PublicMarketingCatalogOptions;
     /**
      * — adapter for `plans` master-record persistence.
      * Optional; if omitted, PlansService + controller are not
@@ -104,4 +177,4 @@ declare class CatalogModule {
     static forRoot(options: CatalogModuleOptions): DynamicModule;
 }
 
-export { type CatalogModuleOptions as C, type CatalogControllerConfig as a, CatalogModule as b };
+export { type CatalogModuleOptions as C, type NewPaymentMethodsSource as N, type PublicMarketingCatalogOptions as P, type CatalogControllerConfig as a, CatalogModule as b, PublicMarketingCatalogService as c };

package/dist/{catalog.module-DKVvsPsl.d.cts → catalog.module-T-I5Ricz.d.cts}

@@ -1,7 +1,84 @@
 import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
-import { BundleRepository, MarketingProjectionRepository, CatalogEntryRepository, PromotionRepository, MarketingSettingsRepository, PlanRepository, FeatureUiRegistry } from '@saasicat/core';
+import { PaymentMethodType, PlanRepository, MarketingProjectionRepository, PromotionRepository, CatalogEntryRepository, BundleRepository, PublicMarketingCatalogResponse, MarketingSettingsRepository, FeatureUiRegistry } from '@saasicat/core';
 import { P as ProviderSpec } from './di-CcNeq9v-.cjs';
 
+/**
+ * What the catalogue needs of whatever knows the payment accounts: the account
+ * new payment methods are taken at, or `null` where none takes them.
+ * `PaymentGatewayRegistry` satisfies it; the shape keeps this module free of a
+ * dependency on the payments module.
+ */
+interface NewPaymentMethodsSource {
+    forNewPaymentMethods(): {
+        methods: readonly PaymentMethodType[];
+    } | null;
+}
+declare class PublicMarketingCatalogService {
+    private readonly planRepo;
+    private readonly marketingRepo;
+    private readonly promotionRepo;
+    private readonly catalogEntryRepo;
+    private readonly bundleRepo;
+    private readonly newPaymentMethodsSource;
+    constructor(planRepo: PlanRepository, marketingRepo: MarketingProjectionRepository, promotionRepo: PromotionRepository, catalogEntryRepo: (CatalogEntryRepository | null) | undefined, bundleRepo: (BundleRepository | null) | undefined, newPaymentMethodsSource: NewPaymentMethodsSource | null);
+    /** What a new payment method is taken with here, for the page that offers the plans. */
+    private newPaymentMethods;
+    getCatalog(locale: string, currency: string, vatRate: number, asOf?: Date): Promise<PublicMarketingCatalogResponse>;
+    /**
+     * Loads all published-and-live bundle versions 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;
+}
+
+/** What the auth-free pricing-page endpoint is mounted with. */
+interface PublicMarketingCatalogOptions {
+    guards: Array<Type<CanActivate>>;
+    currency: string;
+    vatRate: number;
+    /**
+     * Where the catalogue reads what a new payment method is taken with —
+     * `PaymentGatewayRegistry` from `@saasicat/nest/payments` where the
+     * application wired payments, and `null` where nothing takes them.
+     *
+     * Required and nullable rather than optional, because leaving it out is not
+     * silence: the endpoint would publish that no payment method is taken,
+     * which is a claim, and an application whose form takes one would publish
+     * the opposite of what it does. `SaaSiCatModule` fills it from `payments`.
+     */
+    newPaymentMethodsFrom: Type<NewPaymentMethodsSource> | null;
+}
 interface CatalogControllerConfig {
     /**
      * Class-level guards for `BundlesController` and `BundleVersionsController`.
@@ -45,11 +122,7 @@ interface CatalogModuleOptions {
      *. Registered only when plan-, marketingProjection-
      * and promotionRepository are set. `guards` is usually `[]`.
      */
-    publicMarketingCatalog?: {
-        guards: Array<Type<CanActivate>>;
-        currency: string;
-        vatRate: number;
-    };
+    publicMarketingCatalog?: PublicMarketingCatalogOptions;
     /**
      * — adapter for `plans` master-record persistence.
      * Optional; if omitted, PlansService + controller are not
@@ -104,4 +177,4 @@ declare class CatalogModule {
     static forRoot(options: CatalogModuleOptions): DynamicModule;
 }
 
-export { type CatalogModuleOptions as C, type CatalogControllerConfig as a, CatalogModule as b };
+export { type CatalogModuleOptions as C, type NewPaymentMethodsSource as N, type PublicMarketingCatalogOptions as P, type CatalogControllerConfig as a, CatalogModule as b, PublicMarketingCatalogService as c };

package/dist/checkout-offer/index.d.cts

@@ -1,10 +1,11 @@
-export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferOptions, d as ConcludeCheckoutOfferWithin, e as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-Bk5mHEoR.cjs';
+export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferOptions, d as ConcludeCheckoutOfferWithin, e as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-CCVxG9b2.cjs';
 import { Type, CanActivate } from '@nestjs/common';
 export { a as CheckoutOfferConclusionOptions, b as CheckoutOfferControllerConfig, c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-DFhGy6JO.cjs';
 import { CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
-import '../subscription-contract.service-D7Qb_Ns-.cjs';
-import '../subscriber.service-BZsvHw1V.cjs';
-import '../promo.service-CBMm9RU7.cjs';
+import '../subscription-contract.service-CfNApLuP.cjs';
+import '../subscriber.service-5W6Gi-1B.cjs';
+import '../promo.service-BYBu6dy3.cjs';
+import '../plan-catalog-source-DWe-BGY1.cjs';
 import '../di-CcNeq9v-.cjs';
 
 declare function buildCheckoutOfferController(guards: Array<Type<CanActivate>>): Type;

package/dist/checkout-offer/index.d.ts

@@ -1,10 +1,11 @@
-export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferOptions, d as ConcludeCheckoutOfferWithin, e as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-BP4CoZle.js';
+export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferOptions, d as ConcludeCheckoutOfferWithin, e as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-BeHgYikI.js';
 import { Type, CanActivate } from '@nestjs/common';
 export { a as CheckoutOfferConclusionOptions, b as CheckoutOfferControllerConfig, c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-x7SP_dX4.js';
 import { CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
-import '../subscription-contract.service-Duv_Ns1W.js';
-import '../subscriber.service-BZsvHw1V.js';
-import '../promo.service-CBMm9RU7.js';
+import '../subscription-contract.service-CPZrTM9C.js';
+import '../subscriber.service-5W6Gi-1B.js';
+import '../promo.service-CFjfF0Xm.js';
+import '../plan-catalog-source-DWe-BGY1.js';
 import '../di-CcNeq9v-.js';
 
 declare function buildCheckoutOfferController(guards: Array<Type<CanActivate>>): Type;

package/dist/checkout-offer/index.js

@@ -1,26 +1,27 @@
 import "../chunk-DFOW3JVO.js";
 import {
-  CHECKOUT_OFFER_REPOSITORY_TOKEN,
-  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
   CheckoutOfferModule,
-  CheckoutOfferPricing,
-  CheckoutOfferService,
   CreateCheckoutOfferDto,
   UpdateCheckoutOfferDto,
   buildCheckoutOfferController
-} from "../chunk-X4PDUYBX.js";
-import "../chunk-XWAZNKAB.js";
-import "../chunk-U465NU23.js";
+} from "../chunk-TOEFN7DN.js";
+import {
+  CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
+  CheckoutOfferPricing,
+  CheckoutOfferService
+} from "../chunk-55QEDAMX.js";
+import "../chunk-3RLWML2S.js";
+import "../chunk-NDLC5GYK.js";
 import "../chunk-KPEMTBOP.js";
-import "../chunk-QBF7KLSA.js";
+import "../chunk-TBBZWZQT.js";
 import "../chunk-VBRYPU7V.js";
-import "../chunk-5BCYJ3QY.js";
-import "../chunk-QSBMFY4I.js";
-import "../chunk-AOQJEYOL.js";
-import "../chunk-U4X2YRRO.js";
-import "../chunk-3HT3REXB.js";
+import "../chunk-6PJE7EWO.js";
+import "../chunk-3QVGA6JX.js";
+import "../chunk-WOEJ6K7M.js";
+import "../chunk-LF6J4YYN.js";
 import "../chunk-YSC46BGM.js";
-import "../chunk-323FB6TD.js";
+import "../chunk-FEQZCWUL.js";
 import "../chunk-J7NJRK3K.js";
 import "../chunk-SHUYVCID.js";
 export {

package/dist/{checkout-offer.service-BP4CoZle.d.ts → checkout-offer.service-BeHgYikI.d.ts}

@@ -1,7 +1,7 @@
-import { PlanCatalog, PlanRepository, BundleRepository, PromotionRepository, CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot, CheckoutOfferRow, CheckoutOfferRepository, CatalogEntryRepository, TransactionRunner, CheckoutOfferFilter, CheckoutOfferSelection, CheckoutOfferSelectionUpdate, NewSubscriberDetails, TransactionContext, SubscriptionContractRecord } from '@saasicat/core';
-import { S as SubscriptionContractService, C as CreateContractFromOfferOptions } from './subscription-contract.service-Duv_Ns1W.js';
-import { S as SubscriberService } from './subscriber.service-BZsvHw1V.js';
-import { a as PromoCodesService } from './promo.service-CBMm9RU7.js';
+import { PlanCatalogSettings, PlanRepository, BundleRepository, PromotionRepository, CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot, CheckoutOfferRow, CheckoutOfferRepository, CatalogEntryRepository, TransactionRunner, CheckoutOfferFilter, CheckoutOfferSelection, CheckoutOfferSelectionUpdate, NewSubscriberDetails, TransactionContext, SubscriptionContractRecord } from '@saasicat/core';
+import { S as SubscriptionContractService, C as CreateContractFromOfferOptions } from './subscription-contract.service-CPZrTM9C.js';
+import { S as SubscriberService } from './subscriber.service-5W6Gi-1B.js';
+import { a as PromoCodesService } from './promo.service-CFjfF0Xm.js';
 
 type Cycle = 'monthly' | 'yearly';
 /** What pricing needs to know about a selection. */
@@ -11,6 +11,16 @@ interface CheckoutOfferPricingInput {
     bundleVersionIds: readonly string[];
     promoCode: string | null;
     locale: string;
+    /**
+     * The offer when it is priced again. A slot of its promo code held for its
+     * checkout is its own, not counted against it.
+     */
+    checkoutOfferId?: string;
+    /**
+     * Priced as the offer is concluded: its held slot also keeps the code as it
+     * stood when the slot was taken.
+     */
+    concluding?: boolean;
 }
 /** The part of a stored offer the server computes. */
 interface PricedCheckoutOffer {
@@ -25,12 +35,12 @@ interface PricedCheckoutOffer {
     promoCodeSnapshot: CheckoutOfferPromoCodeSnapshot | null;
 }
 declare class CheckoutOfferPricing {
-    private readonly catalog;
+    private readonly settings;
     private readonly plans;
     private readonly bundles;
     private readonly promotions;
     private readonly promoCodes;
-    constructor(catalog: PlanCatalog, plans: PlanRepository, bundles?: BundleRepository | null, promotions?: PromotionRepository | null, promoCodes?: PromoCodesService | null);
+    constructor(settings: PlanCatalogSettings, plans: PlanRepository, bundles?: BundleRepository | null, promotions?: PromotionRepository | null, promoCodes?: PromoCodesService | null);
     /** Prices a selection against the plan version on sale now. */
     price(input: CheckoutOfferPricingInput, asOf?: Date): Promise<PricedCheckoutOffer>;
     /**
@@ -98,16 +108,43 @@ declare class CheckoutOfferService {
     private readonly contracts;
     private readonly transactions;
     private readonly subscribers;
-    constructor(repo: CheckoutOfferRepository, pricing: CheckoutOfferPricing, bundles?: BundleRepository | null, plans?: PlanRepository | null, catalogEntries?: CatalogEntryRepository | null, contracts?: SubscriptionContractService | null, transactions?: TransactionRunner | null, subscribers?: SubscriberService | null);
+    private readonly promoCodes;
+    constructor(repo: CheckoutOfferRepository, pricing: CheckoutOfferPricing, bundles?: BundleRepository | null, plans?: PlanRepository | null, catalogEntries?: CatalogEntryRepository | null, contracts?: SubscriptionContractService | null, transactions?: TransactionRunner | null, subscribers?: SubscriberService | null, promoCodes?: PromoCodesService | null);
     list(filter: CheckoutOfferFilter): Promise<CheckoutOfferRow[]>;
     getById(id: string): Promise<CheckoutOfferRow>;
     /** Prices what the caller chose and stores it as an open offer. */
     create(selection: CheckoutOfferSelection): Promise<CheckoutOfferRow>;
     /**
      * Customization in onboarding — only while the offer is `open`. The plan
-     * stays; whatever else changes, the whole offer is priced again.
+     * stays; whatever else changes, the whole offer is priced again. A slot of
+     * its promo code held for its checkout stays with it while the code does,
+     * and is given back when the code is changed or removed.
      */
     update(id: string, change: CheckoutOfferSelectionUpdate): Promise<CheckoutOfferRow>;
+    /**
+     * Holds a slot of the offer's promo code for its checkout until `until` —
+     * what a sign-up does as its checkout starts, until a confirmation of its
+     * payment form can no longer arrive — so that the code cannot run out
+     * before the payment is confirmed and the offer concluded. A live slot the
+     * offer holds of that code already moves to `until`, never earlier. The
+     * conclusion turns the slot into the redemption; the slot goes back when
+     * the offer's code changes or `until` passes.
+     *
+     * Refused, and nothing held, when the offer is no longer open or its code
+     * cannot be held: `PROMO_CODE_NOT_REDEEMABLE` with the reason a preview
+     * gives, `EXHAUSTED` when every slot is redeemed or held. An offer without
+     * a code holds nothing.
+     */
+    holdPromoCode(id: string, hold: {
+        email?: string;
+        until: Date;
+    }): Promise<void>;
+    /**
+     * Gives back the slot held for the offer's checkout while it is still held
+     * until `heldUntil`, as the caller wrote it. A slot another start of the
+     * checkout moved later stays with the form that start opened.
+     */
+    releasePromoCodeHold(id: string, heldUntil: Date): Promise<void>;
     /**
      * Freezes the offer (`status = 'consumed'`). Returns the final
      * snapshot — the caller (registration/billing) writes it
@@ -158,6 +195,12 @@ declare class CheckoutOfferService {
      * where a refusal still undoes everything. Nothing checks the code again
      * after `within`, so a redemption that takes its last slot does not refuse
      * the offer it was redeemed for.
+     *
+     * A slot held for the offer's checkout (`holdPromoCode`) is the offer's own
+     * throughout: the checks before the transaction do not count it against
+     * the code and accept the code as it stood when the slot was held, and the
+     * redemption in `within` takes that slot rather than a free one. A slot
+     * `within` did not redeem is given back before the conclusion commits.
      */
     conclude(id: string, options: ConcludeCheckoutOfferOptions, within?: ConcludeCheckoutOfferWithin): Promise<ConcludedCheckoutOffer>;
     private assertConsumable;