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

package/dist/admin/index.js

@@ -1,7 +1,6 @@
 import "../chunk-UF53DWWR.js";
 import {
   ADMIN_MANIFEST_CONFIG,
-  ADMIN_RESOURCES_PORT_TOKEN,
   ADMIN_STATS_AUDIT_WINDOW_DAYS_TOKEN,
   AUDIT_STATS_PORT_TOKEN,
   AdminBypassRlsInterceptor,
@@ -9,8 +8,6 @@ import {
   AdminManifestService,
   AdminModule,
   AdminPublicBootController,
-  AdminResourcesModule,
-  AdminResourcesService,
   AdminStatsController,
   AdminStatsModule,
   AdminStatsService,
@@ -19,9 +16,14 @@ import {
   PROMO_CODE_STATS_PORT_TOKEN,
   SUBSCRIPTION_STATS_PORT_TOKEN,
   SuperAdminGuard,
-  SuspendTenantDto,
   buildAdminStatsController
-} from "../chunk-LLYVYRGJ.js";
+} from "../chunk-F2PF4IXB.js";
+import {
+  ADMIN_RESOURCES_PORT_TOKEN,
+  AdminResourcesModule,
+  AdminResourcesService,
+  SuspendTenantDto
+} from "../chunk-OSOP4KWL.js";
 import {
   MfaGuard,
   MfaService,

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

@@ -88,6 +88,16 @@ interface EffectiveLimitsSnapshot {
     features: FeatureKey[];
 }
 
+/** What a contract frozen at a moment records as its entitlements. */
+interface ContractLimits {
+    limits: EffectiveLimits;
+    /**
+     * The add-ons left out of `limits` because their cancellation is declared.
+     * The contract names them in its snapshot, so that their bookings grant
+     * them until their effective date and a reader knows the snapshot does not.
+     */
+    leftOutBundleVersionIds: string[];
+}
 interface EnforceLimitInput<T> {
     /** Tenant whose subscription is checked. */
     tenantId: string;
@@ -135,6 +145,17 @@ declare class EntitlementService {
      * older than the one everybody else should be answered from.
      */
     computeLimits(tenantId: string, now?: Date, catalog?: PlanCatalog): Promise<EffectiveLimits>;
+    /**
+     * What a contract frozen at `now` records as its entitlements: what
+     * `computeLimits` grants, less the add-ons whose cancellation is declared.
+     *
+     * Those are granted until their effective date by the booking rather than
+     * by the contract (`mergeSubscriptionBundlesIntoLimits`), so their end
+     * needs nobody to write the contract again. Frozen into the snapshot, they
+     * would be granted for as long as the contract runs. Never cached, like
+     * `computeLimits` with a catalogue.
+     */
+    computeContractLimits(tenantId: string, now: Date, catalog: PlanCatalog): Promise<ContractLimits>;
     /**
      * Clears a tenant's cache entry. MUST be called as soon as a mutation
      * changes the subscription, a bundle booking, or a PlanVersion binding —
@@ -149,13 +170,14 @@ declare class EntitlementService {
      * have a `SubscriptionRecord` (e.g. within a transaction).
      */
     deriveLimits(sub: SubscriptionRecord, now: Date, tx?: TransactionContext): Promise<EffectiveLimits>;
+    private requireSubscription;
     /**
      * `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;
+    private answerFor;
     /**
      * The last thing every path does, so that no path can skip it.
      *
@@ -208,6 +230,11 @@ declare class EntitlementService {
  * Spec:
  */
 declare function filterActiveSubscriptionBundles(bundles: readonly SubscriptionBundleSnapshot[], now: Date): SubscriptionBundleSnapshot[];
+/**
+ * Whether a booking's end is already set. Such a booking is still active until
+ * that date, but it is not part of what a contract agrees to from here on.
+ */
+declare function isCancellationDeclared(booking: Pick<SubscriptionBundleSnapshot, 'canceledEffectiveAt'>): boolean;
 /**
  * Aggregates the quotas of all active SubscriptionBundle bookings:
  * Σ per QuotaKey, `-1` (unlimited) dominates. Bundle features +
@@ -232,9 +259,17 @@ declare function aggregateContractLineItemEntitlements(lineItems: readonly Pick<
 declare function contractLimits(contract: Pick<SubscriptionContractRecord, 'entitlementSnapshot' | 'lineItems'>): EffectiveLimits;
 /**
  * `BundleVersion`s the contract already accounts for — from the freeze
- * (`originalBundleVersionIds`) and from its bundle line items.
+ * (`originalBundleVersionIds`) and from its bundle line items — less the ones
+ * its entitlement snapshot says it left out.
+ *
+ * A contract written while an add-on's cancellation is declared keeps the
+ * add-on's line, because it is billed until its effective date, but leaves its
+ * features and quotas out of the snapshot and names it there. Such an add-on is
+ * not covered: its booking grants it until that date, and nothing does after.
+ * A snapshot that names nothing — written earlier, or by an application —
+ * covers every add-on its contract lists, so nothing is counted twice.
  */
-declare function contractBundleVersionIds(contract: Pick<SubscriptionContractRecord, 'originalBundleVersionIds' | 'lineItems'>): Set<string>;
+declare function contractBundleVersionIds(contract: Pick<SubscriptionContractRecord, 'originalBundleVersionIds' | 'lineItems' | 'entitlementSnapshot'>): Set<string>;
 /**
  * Adds bundle bookings on top of limits that came from a contract.
  *
@@ -290,4 +325,4 @@ declare function hasAnyFeature(limits: EffectiveLimits, features: readonly Featu
  */
 declare function toEffectiveLimitsSnapshot(limits: EffectiveLimits): EffectiveLimitsSnapshot;
 
-export { type CustomLimitsShape as C, type EffectiveLimits as E, type PlanVersionSnapshot as P, type SubscriptionBundleSnapshot as S, type EffectiveLimitsSnapshot as a, type EnforceLimitInput as b, EntitlementService as c, type SubscriptionLimitsInput as d, aggregateContractLineItemEntitlements as e, aggregateLimits as f, aggregateSubscriptionBundleQuotas as g, applyCustomLimits as h, collectSubscriptionBundleFeatures as i, contractBundleVersionIds as j, contractLimits as k, filterActiveSubscriptionBundles as l, filterPlannedOnlyFeatures as m, hasAnyFeature as n, hasFeature as o, mergeSubscriptionBundlesIntoLimits as p, toEffectiveLimitsSnapshot as t };
+export { type ContractLimits as C, type EffectiveLimits as E, type PlanVersionSnapshot as P, type SubscriptionBundleSnapshot as S, type CustomLimitsShape as a, type EffectiveLimitsSnapshot as b, type EnforceLimitInput as c, EntitlementService as d, type SubscriptionLimitsInput as e, aggregateContractLineItemEntitlements as f, aggregateLimits as g, aggregateSubscriptionBundleQuotas as h, applyCustomLimits as i, collectSubscriptionBundleFeatures as j, contractBundleVersionIds as k, contractLimits as l, filterActiveSubscriptionBundles as m, filterPlannedOnlyFeatures as n, hasAnyFeature as o, hasFeature as p, isCancellationDeclared as q, mergeSubscriptionBundlesIntoLimits as r, toEffectiveLimitsSnapshot as t };

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

@@ -88,6 +88,16 @@ interface EffectiveLimitsSnapshot {
     features: FeatureKey[];
 }
 
+/** What a contract frozen at a moment records as its entitlements. */
+interface ContractLimits {
+    limits: EffectiveLimits;
+    /**
+     * The add-ons left out of `limits` because their cancellation is declared.
+     * The contract names them in its snapshot, so that their bookings grant
+     * them until their effective date and a reader knows the snapshot does not.
+     */
+    leftOutBundleVersionIds: string[];
+}
 interface EnforceLimitInput<T> {
     /** Tenant whose subscription is checked. */
     tenantId: string;
@@ -135,6 +145,17 @@ declare class EntitlementService {
      * older than the one everybody else should be answered from.
      */
     computeLimits(tenantId: string, now?: Date, catalog?: PlanCatalog): Promise<EffectiveLimits>;
+    /**
+     * What a contract frozen at `now` records as its entitlements: what
+     * `computeLimits` grants, less the add-ons whose cancellation is declared.
+     *
+     * Those are granted until their effective date by the booking rather than
+     * by the contract (`mergeSubscriptionBundlesIntoLimits`), so their end
+     * needs nobody to write the contract again. Frozen into the snapshot, they
+     * would be granted for as long as the contract runs. Never cached, like
+     * `computeLimits` with a catalogue.
+     */
+    computeContractLimits(tenantId: string, now: Date, catalog: PlanCatalog): Promise<ContractLimits>;
     /**
      * Clears a tenant's cache entry. MUST be called as soon as a mutation
      * changes the subscription, a bundle booking, or a PlanVersion binding —
@@ -149,13 +170,14 @@ declare class EntitlementService {
      * have a `SubscriptionRecord` (e.g. within a transaction).
      */
     deriveLimits(sub: SubscriptionRecord, now: Date, tx?: TransactionContext): Promise<EffectiveLimits>;
+    private requireSubscription;
     /**
      * `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;
+    private answerFor;
     /**
      * The last thing every path does, so that no path can skip it.
      *
@@ -208,6 +230,11 @@ declare class EntitlementService {
  * Spec:
  */
 declare function filterActiveSubscriptionBundles(bundles: readonly SubscriptionBundleSnapshot[], now: Date): SubscriptionBundleSnapshot[];
+/**
+ * Whether a booking's end is already set. Such a booking is still active until
+ * that date, but it is not part of what a contract agrees to from here on.
+ */
+declare function isCancellationDeclared(booking: Pick<SubscriptionBundleSnapshot, 'canceledEffectiveAt'>): boolean;
 /**
  * Aggregates the quotas of all active SubscriptionBundle bookings:
  * Σ per QuotaKey, `-1` (unlimited) dominates. Bundle features +
@@ -232,9 +259,17 @@ declare function aggregateContractLineItemEntitlements(lineItems: readonly Pick<
 declare function contractLimits(contract: Pick<SubscriptionContractRecord, 'entitlementSnapshot' | 'lineItems'>): EffectiveLimits;
 /**
  * `BundleVersion`s the contract already accounts for — from the freeze
- * (`originalBundleVersionIds`) and from its bundle line items.
+ * (`originalBundleVersionIds`) and from its bundle line items — less the ones
+ * its entitlement snapshot says it left out.
+ *
+ * A contract written while an add-on's cancellation is declared keeps the
+ * add-on's line, because it is billed until its effective date, but leaves its
+ * features and quotas out of the snapshot and names it there. Such an add-on is
+ * not covered: its booking grants it until that date, and nothing does after.
+ * A snapshot that names nothing — written earlier, or by an application —
+ * covers every add-on its contract lists, so nothing is counted twice.
  */
-declare function contractBundleVersionIds(contract: Pick<SubscriptionContractRecord, 'originalBundleVersionIds' | 'lineItems'>): Set<string>;
+declare function contractBundleVersionIds(contract: Pick<SubscriptionContractRecord, 'originalBundleVersionIds' | 'lineItems' | 'entitlementSnapshot'>): Set<string>;
 /**
  * Adds bundle bookings on top of limits that came from a contract.
  *
@@ -290,4 +325,4 @@ declare function hasAnyFeature(limits: EffectiveLimits, features: readonly Featu
  */
 declare function toEffectiveLimitsSnapshot(limits: EffectiveLimits): EffectiveLimitsSnapshot;
 
-export { type CustomLimitsShape as C, type EffectiveLimits as E, type PlanVersionSnapshot as P, type SubscriptionBundleSnapshot as S, type EffectiveLimitsSnapshot as a, type EnforceLimitInput as b, EntitlementService as c, type SubscriptionLimitsInput as d, aggregateContractLineItemEntitlements as e, aggregateLimits as f, aggregateSubscriptionBundleQuotas as g, applyCustomLimits as h, collectSubscriptionBundleFeatures as i, contractBundleVersionIds as j, contractLimits as k, filterActiveSubscriptionBundles as l, filterPlannedOnlyFeatures as m, hasAnyFeature as n, hasFeature as o, mergeSubscriptionBundlesIntoLimits as p, toEffectiveLimitsSnapshot as t };
+export { type ContractLimits as C, type EffectiveLimits as E, type PlanVersionSnapshot as P, type SubscriptionBundleSnapshot as S, type CustomLimitsShape as a, type EffectiveLimitsSnapshot as b, type EnforceLimitInput as c, EntitlementService as d, type SubscriptionLimitsInput as e, aggregateContractLineItemEntitlements as f, aggregateLimits as g, aggregateSubscriptionBundleQuotas as h, applyCustomLimits as i, collectSubscriptionBundleFeatures as j, contractBundleVersionIds as k, contractLimits as l, filterActiveSubscriptionBundles as m, filterPlannedOnlyFeatures as n, hasAnyFeature as o, hasFeature as p, isCancellationDeclared as q, mergeSubscriptionBundlesIntoLimits as r, toEffectiveLimitsSnapshot as t };

package/dist/billing/index.d.cts

@@ -1,20 +1,20 @@
-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';
+import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalogSettings, PlanCatalogReadSink, PlanCatalog, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, TenantSubscriptionWritePort, SubscriptionUsagePort, SubscriberLedgerRepository, SubscriptionContractRepository, SubscriberRepository, AdminSubscriberAccount, 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-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';
+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 ProrationBasis, r as ProrationDto, s as ProrationInput, R as RedundantFeatureHint, S as SubscriberChargeService, t as SubscriptionBundleAddPreviewDto, u as SubscriptionBundleCancelPreviewDto, v as SubscriptionBundleConfig, w as SubscriptionBundlePreviewContext, x as SubscriptionBundlePreviewIssue, y as SubscriptionBundlePreviewService, z as SubscriptionBundlesService, T as TenantAdminGuard, D as TenantBillingController, U as UsageResponse, E as addMonths, F as clampToParent, G as computeNewPeriodCharge, H as computeProration, I as decideCancellation, J as decideCancellationFor, K as noticeDaysFor, M as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-BC6-S5cT.cjs';
+import { F as FEATURE_GUARD_MARKER, d as ContractFreezePort, e as ContractFreezeSourcePort } from '../tenant-billing.module-C6MFfCKq.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-C6MFfCKq.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-OpnhwzF5.cjs';
+import { d as EntitlementService } from '../aggregation-DjQUc7yd.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-CfNApLuP.cjs';
-import '../promo.service-BYBu6dy3.cjs';
+import { a as PromoCodesService } from '../promo.service-BextPvx5.cjs';
 import '../admin-audit.service-4P3Djdxk.cjs';
 import '../contract-line-item-money-B0Z3Ogur.cjs';
 import '../plan-resolution-CwUy_OqC.cjs';
@@ -277,7 +277,7 @@ declare function computeNextBundlePeriod(booking: BundlePeriodRollInput, plan: B
  * publish gate checks; what it cannot check is the combination, since that
  * depends on the plan the tenant is on and the rhythm they are billed in.
  */
-declare function resolveBundlePriceNet(bundleVersion: BundleVersionRow, planKey: string, billingCycle: string): number | null;
+declare function resolveBundlePriceNet(bundleVersion: BundleVersionRow, planKey: string, billingCycle: BillingCycle): number | null;
 /**
  * The cycles a plan version is actually sold in.
  *
@@ -841,12 +841,71 @@ declare class SubscriptionContractFreezeService implements ContractFreezePort {
     private readonly entitlements;
     private readonly contracts;
     private readonly source;
-    constructor(catalogs: PlanCatalogSource, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort, writes?: TenantSubscriptionWritePort | null);
+    private readonly subscriptions;
+    private readonly promoCodes;
+    constructor(catalogs: PlanCatalogSource, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort, writes?: TenantSubscriptionWritePort | null, subscriptions?: SubscriptionUsagePort | null, promoCodes?: PromoCodesService | 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>;
+    /**
+     * The code redeemed for the tenant's subscription, as a discount line, where
+     * no contract of the tenant records it yet.
+     *
+     * The first contract written after a redemption records it — at onboarding,
+     * or at the activation after a trial, where onboarding wrote none — and the
+     * ones after it do not repeat it: the discount runs from where it was first
+     * agreed, for the duration on its snapshot, counted from the first period
+     * that is paid. A contract concluded from an offer that carried the code
+     * already records it. Nothing is recorded without the promo module, for a
+     * reversed redemption, or where a contract written since the redemption
+     * does not record it: that was the first one, written before contracts
+     * recorded codes or by the application itself, and a later contract does
+     * not start the discount again.
+     */
+    private redeemedCodeNotYetRecorded;
+}
+
+interface SubscriberAccountModuleOptions {
+    /** The same chain the tenant routes of the administration run behind. */
+    guards: Array<Type<CanActivate>>;
+    /**
+     * Must bring `AdminResourcesService` and `SubscriberAccountService` into
+     * scope — the modules that already provide them, passed as the very objects
+     * the application imports, so that no adapter is built a second time. The
+     * `RlsBypassPort` has to be visible too; `SaaSiCatModule` provides it
+     * globally.
+     */
+    imports: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+}
+/**
+ * The operator's view of a subscriber's account, served beside the tenant it
+ * belongs to. Mounted where the platform keeps both the administration's
+ * tenants and a charge journal.
+ */
+declare class SubscriberAccountModule {
+    static forRoot(options: SubscriberAccountModuleOptions): DynamicModule;
 }
 
+/**
+ * Reads a subscriber's account for the operator: the charges its journal
+ * holds, each with the title of the contract line it came from.
+ *
+ * It reads only. Nothing here derives or writes a charge — that is
+ * `SubscriberChargeService`'s — so looking at an account never changes it.
+ */
+declare class SubscriberAccountService {
+    private readonly ledger;
+    private readonly contracts;
+    private readonly subscribers;
+    private readonly subscriptions;
+    constructor(ledger: SubscriberLedgerRepository, contracts: SubscriptionContractRepository, subscribers: SubscriberRepository, subscriptions: SubscriptionUsagePort);
+    /** The account of the tenant's subscriber; empty while it has no subscription. */
+    accountOf(tenantId: string): Promise<AdminSubscriberAccount>;
+}
+
+/** Adapter token: where the subscriber's charges are written (`tenantBilling.chargeJournal`). */
+declare const SUBSCRIBER_LEDGER_REPOSITORY_TOKEN: unique symbol;
+
 declare function computeCarriedTrialEndsAt(currentTrialDays: number, newTrialDays: number, currentTrialEndsAt: Date, now: Date): Date;
 
 declare class AddSubscriptionBundleDto {
@@ -936,4 +995,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_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 };
+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, SUBSCRIBER_LEDGER_REPOSITORY_TOKEN, SUBSCRIPTION_BUNDLE_CONFIG_TOKEN, SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, SubscriberAccountModule, type SubscriberAccountModuleOptions, SubscriberAccountService, 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,20 +1,20 @@
-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';
+import { BillingCycle, BundleVersionRow, FeatureKey, UpsellOfferResolver, BundleRepository, CatalogEntryRepository, UpsellOffer, PlanCatalogSettings, PlanCatalogReadSink, PlanCatalog, PlanCatalogReadSnapshot, PlanCatalogImportSink, PlanCatalogImportReport, PlanId, PlanDef, QuotaKey, MarketingTopFeature, FeatureUiRegistry, MarketingProjectionRepository, TenantSubscriptionWritePort, SubscriptionUsagePort, SubscriberLedgerRepository, SubscriptionContractRepository, SubscriberRepository, AdminSubscriberAccount, 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-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';
+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 ProrationBasis, r as ProrationDto, s as ProrationInput, R as RedundantFeatureHint, S as SubscriberChargeService, t as SubscriptionBundleAddPreviewDto, u as SubscriptionBundleCancelPreviewDto, v as SubscriptionBundleConfig, w as SubscriptionBundlePreviewContext, x as SubscriptionBundlePreviewIssue, y as SubscriptionBundlePreviewService, z as SubscriptionBundlesService, T as TenantAdminGuard, D as TenantBillingController, U as UsageResponse, E as addMonths, F as clampToParent, G as computeNewPeriodCharge, H as computeProration, I as decideCancellation, J as decideCancellationFor, K as noticeDaysFor, M as resolveBundleCancelEffectiveAt } from '../tenant-billing.controller-BuQDQ76i.js';
+import { F as FEATURE_GUARD_MARKER, d as ContractFreezePort, e as ContractFreezeSourcePort } from '../tenant-billing.module-CUCQL0-k.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-CUCQL0-k.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-ChpZDh0g.js';
+import { d as EntitlementService } from '../aggregation-6fPkeV8i.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-CPZrTM9C.js';
-import '../promo.service-CFjfF0Xm.js';
+import { a as PromoCodesService } from '../promo.service-Dqqh0JXn.js';
 import '../admin-audit.service-4P3Djdxk.js';
 import '../contract-line-item-money-B0Z3Ogur.js';
 import '../plan-resolution-CwUy_OqC.js';
@@ -277,7 +277,7 @@ declare function computeNextBundlePeriod(booking: BundlePeriodRollInput, plan: B
  * publish gate checks; what it cannot check is the combination, since that
  * depends on the plan the tenant is on and the rhythm they are billed in.
  */
-declare function resolveBundlePriceNet(bundleVersion: BundleVersionRow, planKey: string, billingCycle: string): number | null;
+declare function resolveBundlePriceNet(bundleVersion: BundleVersionRow, planKey: string, billingCycle: BillingCycle): number | null;
 /**
  * The cycles a plan version is actually sold in.
  *
@@ -841,12 +841,71 @@ declare class SubscriptionContractFreezeService implements ContractFreezePort {
     private readonly entitlements;
     private readonly contracts;
     private readonly source;
-    constructor(catalogs: PlanCatalogSource, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort, writes?: TenantSubscriptionWritePort | null);
+    private readonly subscriptions;
+    private readonly promoCodes;
+    constructor(catalogs: PlanCatalogSource, entitlements: EntitlementService, contracts: SubscriptionContractService, source: ContractFreezeSourcePort, writes?: TenantSubscriptionWritePort | null, subscriptions?: SubscriptionUsagePort | null, promoCodes?: PromoCodesService | 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>;
+    /**
+     * The code redeemed for the tenant's subscription, as a discount line, where
+     * no contract of the tenant records it yet.
+     *
+     * The first contract written after a redemption records it — at onboarding,
+     * or at the activation after a trial, where onboarding wrote none — and the
+     * ones after it do not repeat it: the discount runs from where it was first
+     * agreed, for the duration on its snapshot, counted from the first period
+     * that is paid. A contract concluded from an offer that carried the code
+     * already records it. Nothing is recorded without the promo module, for a
+     * reversed redemption, or where a contract written since the redemption
+     * does not record it: that was the first one, written before contracts
+     * recorded codes or by the application itself, and a later contract does
+     * not start the discount again.
+     */
+    private redeemedCodeNotYetRecorded;
+}
+
+interface SubscriberAccountModuleOptions {
+    /** The same chain the tenant routes of the administration run behind. */
+    guards: Array<Type<CanActivate>>;
+    /**
+     * Must bring `AdminResourcesService` and `SubscriberAccountService` into
+     * scope — the modules that already provide them, passed as the very objects
+     * the application imports, so that no adapter is built a second time. The
+     * `RlsBypassPort` has to be visible too; `SaaSiCatModule` provides it
+     * globally.
+     */
+    imports: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+}
+/**
+ * The operator's view of a subscriber's account, served beside the tenant it
+ * belongs to. Mounted where the platform keeps both the administration's
+ * tenants and a charge journal.
+ */
+declare class SubscriberAccountModule {
+    static forRoot(options: SubscriberAccountModuleOptions): DynamicModule;
 }
 
+/**
+ * Reads a subscriber's account for the operator: the charges its journal
+ * holds, each with the title of the contract line it came from.
+ *
+ * It reads only. Nothing here derives or writes a charge — that is
+ * `SubscriberChargeService`'s — so looking at an account never changes it.
+ */
+declare class SubscriberAccountService {
+    private readonly ledger;
+    private readonly contracts;
+    private readonly subscribers;
+    private readonly subscriptions;
+    constructor(ledger: SubscriberLedgerRepository, contracts: SubscriptionContractRepository, subscribers: SubscriberRepository, subscriptions: SubscriptionUsagePort);
+    /** The account of the tenant's subscriber; empty while it has no subscription. */
+    accountOf(tenantId: string): Promise<AdminSubscriberAccount>;
+}
+
+/** Adapter token: where the subscriber's charges are written (`tenantBilling.chargeJournal`). */
+declare const SUBSCRIBER_LEDGER_REPOSITORY_TOKEN: unique symbol;
+
 declare function computeCarriedTrialEndsAt(currentTrialDays: number, newTrialDays: number, currentTrialEndsAt: Date, now: Date): Date;
 
 declare class AddSubscriptionBundleDto {
@@ -936,4 +995,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_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 };
+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, SUBSCRIBER_LEDGER_REPOSITORY_TOKEN, SUBSCRIPTION_BUNDLE_CONFIG_TOKEN, SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN, SubscriberAccountModule, type SubscriberAccountModuleOptions, SubscriberAccountService, 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-R5YCJBHY.js";
+} from "../chunk-U5UPEFWC.js";
 import {
   AddSubscriptionBundleDto,
   BILLING_FEATURE_UI_REGISTRY_TOKEN,
@@ -48,6 +48,10 @@ import {
   RequireFeature,
   SELF_SERVICE_BLOCKED_BUNDLES_TOKEN,
   SELF_SERVICE_BLOCKED_PLANS_TOKEN,
+  SUBSCRIBER_LEDGER_REPOSITORY_TOKEN,
+  SubscriberAccountModule,
+  SubscriberAccountService,
+  SubscriberChargeService,
   SubscriptionBundleModule,
   SubscriptionBundlePreviewService,
   SubscriptionBundlesService,
@@ -65,6 +69,7 @@ import {
   bundleNextPeriodEnd,
   catalogSource,
   clampToParent,
+  computeNewPeriodCharge,
   computeNextBundlePeriod,
   computeProration,
   decideCancellation,
@@ -79,15 +84,16 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "../chunk-M47BNEY2.js";
+} from "../chunk-3YYLOYUT.js";
+import "../chunk-OSOP4KWL.js";
 import {
   classifyBundleVersionDiff,
   classifyPlanDiff
 } from "../chunk-GZTL64QK.js";
 import "../chunk-34XVPR6P.js";
 import "../chunk-OOTEXP47.js";
-import "../chunk-3RLWML2S.js";
-import "../chunk-NDLC5GYK.js";
+import "../chunk-QWKBOLBH.js";
+import "../chunk-EU4N5LET.js";
 import {
   cyclesSoldFor,
   resolveBundlePriceNet
@@ -95,7 +101,7 @@ import {
 import {
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "../chunk-G6EZWECL.js";
+} from "../chunk-B4YP7REK.js";
 import "../chunk-OUDSQ3PU.js";
 import {
   findPlan,
@@ -194,10 +200,14 @@ export {
   RequireFeature,
   SELF_SERVICE_BLOCKED_BUNDLES_TOKEN,
   SELF_SERVICE_BLOCKED_PLANS_TOKEN,
+  SUBSCRIBER_LEDGER_REPOSITORY_TOKEN,
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN,
   SUBSCRIPTION_USAGE_PORT_TOKEN,
   SUBSCRIPTION_WRITE_PORT_TOKEN,
+  SubscriberAccountModule,
+  SubscriberAccountService,
+  SubscriberChargeService,
   SubscriptionBundleModule,
   SubscriptionBundlePreviewService,
   SubscriptionBundlesService,
@@ -233,6 +243,7 @@ export {
   classifyPlanDiff,
   clearPendingPlanVersionFields,
   computeCarriedTrialEndsAt,
+  computeNewPeriodCharge,
   computeNextBundlePeriod,
   computeNextPeriod,
   computeProration,

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

@@ -1,10 +1,10 @@
-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';
+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-DmVGrT4v.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-CfNApLuP.cjs';
 import '../subscriber.service-5W6Gi-1B.cjs';
-import '../promo.service-BYBu6dy3.cjs';
+import '../promo.service-BextPvx5.cjs';
 import '../plan-catalog-source-DWe-BGY1.cjs';
 import '../di-CcNeq9v-.cjs';
 

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

@@ -1,10 +1,10 @@
-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';
+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-Yi30L4ry.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-CPZrTM9C.js';
 import '../subscriber.service-5W6Gi-1B.js';
-import '../promo.service-CFjfF0Xm.js';
+import '../promo.service-Dqqh0JXn.js';
 import '../plan-catalog-source-DWe-BGY1.js';
 import '../di-CcNeq9v-.js';
 

package/dist/checkout-offer/index.js

@@ -4,15 +4,15 @@ import {
   CreateCheckoutOfferDto,
   UpdateCheckoutOfferDto,
   buildCheckoutOfferController
-} from "../chunk-TOEFN7DN.js";
+} from "../chunk-FPMBQDW7.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";
+} from "../chunk-WTAS2CLM.js";
+import "../chunk-QWKBOLBH.js";
+import "../chunk-EU4N5LET.js";
 import "../chunk-KPEMTBOP.js";
 import "../chunk-TBBZWZQT.js";
 import "../chunk-VBRYPU7V.js";

package/dist/{checkout-offer.service-CCVxG9b2.d.cts → checkout-offer.service-DmVGrT4v.d.cts}

@@ -1,7 +1,7 @@
 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-CfNApLuP.cjs';
 import { S as SubscriberService } from './subscriber.service-5W6Gi-1B.cjs';
-import { a as PromoCodesService } from './promo.service-BYBu6dy3.cjs';
+import { a as PromoCodesService } from './promo.service-BextPvx5.cjs';
 
 type Cycle = 'monthly' | 'yearly';
 /** What pricing needs to know about a selection. */

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

@@ -1,7 +1,7 @@
 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';
+import { a as PromoCodesService } from './promo.service-Dqqh0JXn.js';
 
 type Cycle = 'monthly' | 'yearly';
 /** What pricing needs to know about a selection. */