@saasicat/nest 0.13.0 → 0.15.0

package/dist/{checkout-offer.module-Y0hDOVrq.d.ts → checkout-offer.service-BX51dljL.d.cts}

@@ -1,6 +1,4 @@
 import { CheckoutOfferRepository, BundleRepository, PlanRepository, CatalogEntryRepository, CheckoutOfferFilter, CheckoutOfferRow, CreateCheckoutOfferData, UpdateCheckoutOfferData } from '@saasicat/types';
-import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
-import { P as ProviderSpec } from './di-CcNeq9v-.js';
 
 declare class CheckoutOfferService {
     private readonly repo;
@@ -48,38 +46,4 @@ declare class CheckoutOfferService {
     private isValidUntilExpired;
 }
 
-interface CheckoutOfferControllerConfig {
-    /** Class-level guards; `[]` for auth-free public endpoints. */
-    guards: Array<Type<CanActivate>>;
-}
-interface CheckoutOfferModuleOptions {
-    checkoutOfferRepository: ProviderSpec<CheckoutOfferRepository>;
-    /**
-     * Optional for V3 revalidation on consume: if set, the service checks
-     * whether referenced bundle versions are still bookable. Also provides
-     * the bundle features for the requires validation (#35 P6).
-     */
-    bundleRepository?: ProviderSpec<BundleRepository>;
-    /**
-     * Optional for the requires validation (#35 P6): plan features of the
-     * chosen plan version. Without wiring, falls back to the featuresSnapshot
-     * of the plan line item.
-     */
-    planRepository?: ProviderSpec<PlanRepository>;
-    /**
-     * Optional for the requires validation (#35 P6): requires source =
-     * curated FeatureCatalogEntries. Without wiring, the validation is
-     * skipped (graceful).
-     */
-    catalogEntryRepository?: ProviderSpec<CatalogEntryRepository>;
-    /** Controller mount for `/public/checkout-offer`. Omitted = service only. */
-    controller?: CheckoutOfferControllerConfig;
-    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
-    extraProviders?: Provider[];
-    global?: boolean;
-}
-declare class CheckoutOfferModule {
-    static forRoot(options: CheckoutOfferModuleOptions): DynamicModule;
-}
-
-export { type CheckoutOfferControllerConfig as C, CheckoutOfferModule as a, type CheckoutOfferModuleOptions as b, CheckoutOfferService as c };
+export { CheckoutOfferService as C };

package/dist/{checkout-offer.module-ZYF5IsDY.d.cts → checkout-offer.service-BX51dljL.d.ts}

@@ -1,6 +1,4 @@
 import { CheckoutOfferRepository, BundleRepository, PlanRepository, CatalogEntryRepository, CheckoutOfferFilter, CheckoutOfferRow, CreateCheckoutOfferData, UpdateCheckoutOfferData } from '@saasicat/types';
-import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
-import { P as ProviderSpec } from './di-CcNeq9v-.cjs';
 
 declare class CheckoutOfferService {
     private readonly repo;
@@ -48,38 +46,4 @@ declare class CheckoutOfferService {
     private isValidUntilExpired;
 }
 
-interface CheckoutOfferControllerConfig {
-    /** Class-level guards; `[]` for auth-free public endpoints. */
-    guards: Array<Type<CanActivate>>;
-}
-interface CheckoutOfferModuleOptions {
-    checkoutOfferRepository: ProviderSpec<CheckoutOfferRepository>;
-    /**
-     * Optional for V3 revalidation on consume: if set, the service checks
-     * whether referenced bundle versions are still bookable. Also provides
-     * the bundle features for the requires validation (#35 P6).
-     */
-    bundleRepository?: ProviderSpec<BundleRepository>;
-    /**
-     * Optional for the requires validation (#35 P6): plan features of the
-     * chosen plan version. Without wiring, falls back to the featuresSnapshot
-     * of the plan line item.
-     */
-    planRepository?: ProviderSpec<PlanRepository>;
-    /**
-     * Optional for the requires validation (#35 P6): requires source =
-     * curated FeatureCatalogEntries. Without wiring, the validation is
-     * skipped (graceful).
-     */
-    catalogEntryRepository?: ProviderSpec<CatalogEntryRepository>;
-    /** Controller mount for `/public/checkout-offer`. Omitted = service only. */
-    controller?: CheckoutOfferControllerConfig;
-    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
-    extraProviders?: Provider[];
-    global?: boolean;
-}
-declare class CheckoutOfferModule {
-    static forRoot(options: CheckoutOfferModuleOptions): DynamicModule;
-}
-
-export { type CheckoutOfferControllerConfig as C, CheckoutOfferModule as a, type CheckoutOfferModuleOptions as b, CheckoutOfferService as c };
+export { CheckoutOfferService as C };

package/dist/{chunk-2PNX2QL2.js → chunk-32EMXPU2.js}

@@ -322,6 +322,7 @@ var SubscriptionContractModule = class _SubscriptionContractModule {
     return {
       module: _SubscriptionContractModule,
       global: options.global ?? false,
+      imports: options.imports ?? [],
       providers: [
         asProvider(SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN, options.subscriptionContractRepository),
         SubscriptionContractService,

package/dist/{chunk-DVFPKVLO.js → chunk-5KH2O4SF.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-E7AJ42AB.js";
 import {
   SubscriptionContractService
-} from "./chunk-2PNX2QL2.js";
+} from "./chunk-32EMXPU2.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
   PENDING_PLAN_QUERY_PORT_TOKEN,
@@ -19,13 +19,16 @@ import {
 import {
   AdminAuditService
 } from "./chunk-E56W4U2P.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   EntitlementService,
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN,
   isLimitExceededError,
   toEffectiveLimitsSnapshot
-} from "./chunk-2WNM5THV.js";
+} from "./chunk-EXOLOJFZ.js";
 import {
   PLAN_CATALOG_TOKEN,
   findPlan,
@@ -954,6 +957,7 @@ _ts_decorate7([
 ], PublicCatalogController.prototype, "listBundles", null);
 PublicCatalogController = _ts_decorate7([
   Controller2("billing"),
+  SaaSiCatPublicRoute(),
   _ts_param5(0, Inject5(PLAN_CATALOG_TOKEN)),
   _ts_param5(1, Inject5(FEATURE_UI_REGISTRY_TOKEN)),
   _ts_param5(2, Optional3()),
@@ -3005,7 +3009,7 @@ function _ts_param13(paramIndex, decorator) {
 }
 __name(_ts_param13, "_ts_param");
 function buildTenantSubscriptionBundlesController(extraGuards = []) {
-  let GeneratedTenantSubscriptionBundlesController = class GeneratedTenantSubscriptionBundlesController {
+  let GeneratedTenantSubscriptionBundlesController = class GeneratedTenantSubscriptionBundlesController2 {
     static {
       __name(this, "GeneratedTenantSubscriptionBundlesController");
     }
@@ -3015,6 +3019,8 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
     tenantIdResolver;
     contractFreeze;
     logger = new Logger5("TenantSubscriptionBundlesController");
+    /** Keeps the "no contractFreeze hook" warning to one line per process. */
+    static warnedAboutMissingFreeze = false;
     constructor(service, previewService, subscriptionUsage, tenantIdResolver, contractFreeze = null) {
       this.service = service;
       this.previewService = previewService;
@@ -3106,7 +3112,13 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
      * only if the consumer has wired the ContractFreezePort.
      */
     async refreezeContract(tenantId, sub) {
-      if (!this.contractFreeze) return;
+      if (!this.contractFreeze) {
+        if (!GeneratedTenantSubscriptionBundlesController2.warnedAboutMissingFreeze) {
+          GeneratedTenantSubscriptionBundlesController2.warnedAboutMissingFreeze = true;
+          this.logger.warn("Bundle mutation without a configured contractFreeze hook \u2014 the SubscriptionContract is not re-materialized. Configure `contractFreeze` in TenantBillingModule.forRoot() if this app uses contracts.");
+        }
+        return;
+      }
       try {
         await this.contractFreeze.freezeOnPlanChange(tenantId, sub.planVersion.planId, sub.billingCycle, /* @__PURE__ */ new Date());
       } catch (err) {

package/dist/{chunk-TXDH4FUA.js → chunk-7RRWI5LH.js}

@@ -6,7 +6,7 @@ import {
   ADVISORY_STRICT_MODE_CODES,
   validateBundleDraft,
   validatePlanDraft
-} from "./chunk-33TP26MR.js";
+} from "./chunk-P3DP6GJE.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";

package/dist/chunk-EWPF57AG.js

@@ -0,0 +1,13 @@
+import {
+  __name
+} from "./chunk-SHUYVCID.js";
+
+// src/platform/define-saasicat.ts
+function defineSaaSiCat(options) {
+  return options;
+}
+__name(defineSaaSiCat, "defineSaaSiCat");
+
+export {
+  defineSaaSiCat
+};

package/dist/{chunk-2WNM5THV.js → chunk-EXOLOJFZ.js}

@@ -76,6 +76,53 @@ function aggregateContractLineItemEntitlements(lineItems, fallbackPlan = "UNKNOW
   };
 }
 __name(aggregateContractLineItemEntitlements, "aggregateContractLineItemEntitlements");
+function contractLimits(contract) {
+  if (contract.entitlementSnapshot) {
+    return {
+      plan: contract.entitlementSnapshot.plan,
+      quotas: {
+        ...contract.entitlementSnapshot.quotas
+      },
+      features: new Set(contract.entitlementSnapshot.features)
+    };
+  }
+  return aggregateContractLineItemEntitlements(contract.lineItems);
+}
+__name(contractLimits, "contractLimits");
+function contractBundleVersionIds(contract) {
+  const ids = new Set(contract.originalBundleVersionIds);
+  for (const item of contract.lineItems) {
+    if (item.kind === "bundle" && item.sourceVersionId) {
+      ids.add(item.sourceVersionId);
+    }
+  }
+  return ids;
+}
+__name(contractBundleVersionIds, "contractBundleVersionIds");
+function mergeSubscriptionBundlesIntoLimits(limits, bundles, coveredBundleVersionIds, catalog, now) {
+  const additional = filterActiveSubscriptionBundles(bundles, now).filter((b) => !coveredBundleVersionIds.has(b.bundleVersionId));
+  if (additional.length === 0) return limits;
+  const quotas = {
+    ...limits.quotas
+  };
+  for (const [key, value] of Object.entries(aggregateSubscriptionBundleQuotas(additional))) {
+    if (quotas[key] === -1 || value === -1) {
+      quotas[key] = -1;
+    } else {
+      quotas[key] = (quotas[key] ?? 0) + value;
+    }
+  }
+  const bundleFeatures = filterPlannedOnlyFeatures(new Set(collectSubscriptionBundleFeatures(additional)), catalog);
+  return {
+    plan: limits.plan,
+    quotas,
+    features: /* @__PURE__ */ new Set([
+      ...limits.features,
+      ...bundleFeatures
+    ])
+  };
+}
+__name(mergeSubscriptionBundlesIntoLimits, "mergeSubscriptionBundlesIntoLimits");
 function filterPlannedOnlyFeatures(features, catalog) {
   const out = /* @__PURE__ */ new Set();
   for (const f of features) {
@@ -348,8 +395,11 @@ var EntitlementService = class {
    * have a `SubscriptionRecord` (e.g. within a transaction).
    */
   async deriveLimits(sub, now, tx) {
-    const contractLimits = await this.deriveLimitsFromContract(sub.tenantId, now, tx);
-    if (contractLimits) return this.withReplacedFeatureAliases(contractLimits);
+    const contract = await this.findActiveContract(sub.tenantId, now, tx);
+    if (contract) {
+      const bundles = await this.loadSubscriptionBundleSnapshots(sub.id, now, tx);
+      return this.withReplacedFeatureAliases(mergeSubscriptionBundlesIntoLimits(contractLimits(contract), bundles, contractBundleVersionIds(contract), this.catalog, now));
+    }
     const effectivePlan = resolveEntitlementPlan(sub, this.resolutionConfig ?? {}, now);
     const planVersion = effectivePlan === sub.plan ? sub.planVersion : await this.findActivePlanVersionOrFallback(effectivePlan, now, tx);
     const subscriptionBundles = await this.loadSubscriptionBundleSnapshots(sub.id, now, tx);
@@ -376,20 +426,9 @@ var EntitlementService = class {
       features: expandReplacedFeatures(limits.features, this.replacedByIndex)
     };
   }
-  async deriveLimitsFromContract(tenantId, now, tx) {
+  async findActiveContract(tenantId, now, tx) {
     if (!this.subscriptionContracts) return null;
-    const contract = await this.subscriptionContracts.findActiveByTenantId(tenantId, now, tx);
-    if (!contract) return null;
-    if (contract.entitlementSnapshot) {
-      return {
-        plan: contract.entitlementSnapshot.plan,
-        quotas: {
-          ...contract.entitlementSnapshot.quotas
-        },
-        features: new Set(contract.entitlementSnapshot.features)
-      };
-    }
-    return aggregateContractLineItemEntitlements(contract.lineItems);
+    return this.subscriptionContracts.findActiveByTenantId(tenantId, now, tx);
   }
   /**
    * Loads a subscription's active bundle bookings and resolves the
@@ -409,6 +448,7 @@ var EntitlementService = class {
       }
       return {
         bundleKey: bv.bundleKey,
+        bundleVersionId: booking.bundleVersionId,
         features: bv.features,
         quotas: bv.quotas,
         canceledEffectiveAt: booking.canceledEffectiveAt
@@ -575,6 +615,9 @@ export {
   aggregateSubscriptionBundleQuotas,
   collectSubscriptionBundleFeatures,
   aggregateContractLineItemEntitlements,
+  contractLimits,
+  contractBundleVersionIds,
+  mergeSubscriptionBundlesIntoLimits,
   filterPlannedOnlyFeatures,
   applyCustomLimits,
   aggregateLimits,

package/dist/{chunk-HBFU5AN3.js → chunk-GJBXOCRZ.js}

@@ -1,6 +1,9 @@
 import {
   appendImplicitDiscountLineItem
 } from "./chunk-MDIZUVIK.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   BUNDLE_REPOSITORY_TOKEN,
   CATALOG_ENTRY_REPOSITORY_TOKEN,
@@ -613,6 +616,7 @@ function buildCheckoutOfferController(guards) {
   ], GeneratedCheckoutOfferController.prototype, "update", null);
   GeneratedCheckoutOfferController = _ts_decorate3([
     Controller("public/checkout-offer"),
+    SaaSiCatPublicRoute(),
     UseGuards(...guards),
     _ts_param2(0, Inject2(CheckoutOfferService)),
     _ts_metadata3("design:type", Function),

package/dist/{chunk-IRWZC3GC.js → chunk-GLLCB4BP.js}

@@ -12,6 +12,9 @@ import {
 import {
   AdminAuditService
 } from "./chunk-E56W4U2P.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   asProvider
 } from "./chunk-SABTXESR.js";
@@ -254,6 +257,7 @@ _ts_decorate4([
 ], PromoCodePublicController.prototype, "preview", null);
 PromoCodePublicController = _ts_decorate4([
   Controller("billing/promo"),
+  SaaSiCatPublicRoute(),
   _ts_param2(0, Inject2(PromoCodesService)),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [

package/dist/{chunk-33TP26MR.js → chunk-P3DP6GJE.js}

@@ -8,6 +8,9 @@ import {
 import {
   AdminAuditService
 } from "./chunk-E56W4U2P.js";
+import {
+  SaaSiCatPublicRoute
+} from "./chunk-YSC46BGM.js";
 import {
   DiscoveryScanner
 } from "./chunk-Z3FWN3HJ.js";
@@ -2607,6 +2610,7 @@ function buildPublicMarketingCatalogController(guards, projectKey, currency, vat
   ], GeneratedPublicMarketingCatalogController.prototype, "getCatalog", null);
   GeneratedPublicMarketingCatalogController = _ts_decorate14([
     Controller4("public/marketing-catalog"),
+    SaaSiCatPublicRoute(),
     UseGuards4(...guards),
     _ts_param11(0, Inject11(PublicMarketingCatalogService)),
     _ts_metadata14("design:type", Function),