@saasicat/nest 0.7.0 → 0.9.0

package/dist/{enforce-quota.interceptor-cv7r80VM.d.cts → enforce-quota.interceptor-SqrQVF91.d.cts}

@@ -1,9 +1,12 @@
-import { Type, CanActivate, DynamicModule, ForwardReference, FactoryProvider, ExecutionContext, NestInterceptor, CallHandler } from '@nestjs/common';
-import { MfaPort, AuditPort, RlsBypassPort, PlanCatalogReadSink, SubscriptionRepository, PlanVersionRepository, TransactionRunner, PlanCatalog, SaasicatPersistenceAdapter, QuotaProvider } from '@saasicat/types';
+import { Type, CanActivate, DynamicModule, ForwardReference, FactoryProvider, Provider, ExecutionContext, NestInterceptor, CallHandler } from '@nestjs/common';
+import { PlanCatalog, SaasicatPersistenceAdapter, MfaPort, AuditPort, RlsBypassPort, PlanCatalogReadSink, SubscriptionRepository, PlanVersionRepository, TransactionRunner, QuotaProvider, FeatureUiRegistry, SubscriptionUsagePort, UsageSnapshotPort, TenantSubscriptionWritePort, AdminResourcesPort, FirstTimeCustomerCheck } from '@saasicat/types';
 import { P as ProviderSpec } from './di-CcNeq9v-.cjs';
-import { A as AdminManifestConfig } from './admin-manifest.config-DyrQNT7M.cjs';
-import { b as DiscoveryAppInfo } from './discovery.scanner-DLgEvuoy.cjs';
+import { A as AdminManifestConfig, d as AdminResourcesModuleOptions } from './admin-resources.module-BybEjZs-.cjs';
 import { E as EntitlementResolutionConfig } from './plan-resolution-CFCoUkrE.cjs';
+import { a as PromoCodesModuleOptions } from './module-DeH_Jkcq.cjs';
+import { b as DiscoveryAppInfo } from './discovery.scanner-DLgEvuoy.cjs';
+import { b as CatalogModuleOptions } from './catalog.module-Dw2Hrbyu.cjs';
+import { t as TenantBillingModuleOptions, p as SubscriptionBundleModuleOptions, n as SubscriptionBundleControllerOptions } from './subscription-bundles.module-DCpV-Pb5.cjs';
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 
@@ -67,8 +70,8 @@ interface SaasPlatformAdapters {
      * Optional — resolver `tenantId → planId`. The quickstart path uses this
      * together with the `StaticEntitlementService` to automatically check
      * `@RequireFeature` and `@EnforceQuota` against the plan catalog limit.
-     * If not set, `defaultPlanId` **must** be provided — a `StaticPlanResolver`
-     * then returns the same plan for all tenants.
+     * If not set, `tenantBilling` derives the resolver from the subscription
+     * repository. Lightweight setups can instead set `defaultPlanId`.
      */
     planResolver?: ProviderSpec<PlanResolverPort>;
     /**
@@ -79,6 +82,50 @@ interface SaasPlatformAdapters {
     planVersionRepository?: ProviderSpec<PlanVersionRepository>;
     transactionRunner?: ProviderSpec<TransactionRunner>;
 }
+type PlatformImports = Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+interface SaasPlatformCatalogOptions extends Pick<CatalogModuleOptions, 'strictModeCheckMode' | 'autoSyncDiscoveryAtBoot' | 'marketedOnlyFeatures' | 'publicMarketingCatalog' | 'extraProviders'> {
+    /** Labels/icons used by discovery review and the public catalog. */
+    featureUiRegistry: FeatureUiRegistry;
+    /** Mount the SuperAdmin catalog controllers. Default `true`. */
+    adminControllers?: boolean;
+    /** Mount `/billing/plans|bundles|feature-registry`. Default `true`. */
+    publicCatalog?: boolean;
+    /** Override the top-level module imports for catalog adapter factories. */
+    imports?: PlatformImports;
+}
+type SaasPlatformTenantAuthGuards = Array<Type<CanActivate>> | ProviderSpec<ReadonlyArray<CanActivate>>;
+interface SaasPlatformTenantBillingOptions extends Omit<TenantBillingModuleOptions, 'authGuards' | 'subscriptionUsagePort' | 'usageSnapshotPort' | 'subscriptionWritePort' | 'global'> {
+    /**
+     * Tenant guards as classes (the common path) or as a custom provider
+     * factory. Guard classes are resolved from `imports`.
+     */
+    authGuards: SaasPlatformTenantAuthGuards;
+    /** Optional overrides; otherwise the persistence bundle supplies them. */
+    subscriptionUsagePort?: ProviderSpec<SubscriptionUsagePort>;
+    usageSnapshotPort?: ProviderSpec<UsageSnapshotPort>;
+    subscriptionWritePort?: ProviderSpec<TenantSubscriptionWritePort>;
+}
+interface SaasPlatformSubscriptionBundlesOptions extends Omit<SubscriptionBundleModuleOptions, 'subscriptionBundleRepository' | 'bundleRepository' | 'controller' | 'imports' | 'extraProviders' | 'global'> {
+    /** Default mounts the tenant controller and reuses tenant-billing auth. */
+    controller?: false | Omit<SubscriptionBundleControllerOptions, 'authGuards' | 'subscriptionUsagePort'>;
+    imports?: PlatformImports;
+    extraProviders?: Provider[];
+}
+interface SaasPlatformAdminResourcesOptions extends Omit<AdminResourcesModuleOptions, 'resources' | 'guards' | 'global'> {
+    /** Override the default controller guards + `SuperAdminGuard` chain. */
+    guards?: Array<Type<CanActivate>>;
+    /** Custom schema override; the persistence bundle supplies the default. */
+    resources?: ProviderSpec<AdminResourcesPort>;
+}
+interface SaasPlatformPromoCodesOptions extends Omit<PromoCodesModuleOptions, 'promoCodeRepository' | 'redemptionRepository' | 'validationLogRepository' | 'subscriptionLookup' | 'revenueAggregator' | 'transactionRunner' | 'firstTimeCustomerCheck' | 'adminController' | 'global'> {
+    /**
+     * Required when the public preview/redeem flow is enabled. Admin-only
+     * setups do not need an app-specific customer-history check.
+     */
+    firstTimeCustomerCheck?: ProviderSpec<FirstTimeCustomerCheck>;
+    /** Override the default controller guards + `SuperAdminGuard` chain. */
+    adminGuards?: Array<Type<CanActivate>>;
+}
 interface SaasPlatformModuleOptions {
     /**
      * Plan catalog. Either as an already-loaded object (quickstart, comes
@@ -135,7 +182,7 @@ interface SaasPlatformModuleOptions {
      * Modules whose providers must be visible in the DI scope (typically:
      * `AuthModule` with the `JwtAuthGuard`).
      */
-    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+    imports?: PlatformImports;
     /**
      * App identity for the DiscoveryScanner. If omitted, `planCatalog.app` is
      * used (recommendation: simply declare it in the YAML).
@@ -154,10 +201,17 @@ interface SaasPlatformModuleOptions {
      */
     adminManifestConfig?: AdminManifestConfig | Pick<FactoryProvider<AdminManifestConfig>, 'useFactory' | 'inject'>;
     /**
-     * Default `false`. If `true`, `EntitlementModule.forRoot({...})` is called
+     * Infer manifest capabilities for platform endpoints mounted by this
+     * module. Default `true`; set `false` only when the app owns the complete
+     * manifest capability policy.
+     */
+    autoManifest?: boolean;
+    /**
+     * Default `false`. When set, `EntitlementModule.forRoot({...})` is called
      * with the repositories from `adapters` — only meaningful if the app
      * implements the V3 contract path (`subscriptionRepository` & co. must then
-     * be set).
+     * be set). `tenantBilling` and `subscriptionBundles` enable it
+     * automatically.
      */
     entitlement?: false | {
         resolutionConfig?: EntitlementResolutionConfig;
@@ -177,12 +231,40 @@ interface SaasPlatformModuleOptions {
      * `QUOTA_PROVIDERS_TOKEN`.
      */
     quotaProviders?: Array<Type<QuotaProvider>>;
+    /**
+     * Standard DB-backed catalog stack. Repositories are taken from
+     * `persistence.catalog`; no consumer forwarding module is needed.
+     */
+    catalog?: false | SaasPlatformCatalogOptions;
+    /**
+     * Standard tenant self-service stack. Subscription read/write adapters
+     * come from `persistence.tenantBilling`; usage is derived from
+     * `quotaProviders` unless explicitly overridden.
+     */
+    tenantBilling?: false | SaasPlatformTenantBillingOptions;
+    /**
+     * Add-on bundle service and tenant controller. `true` uses defaults and
+     * reuses tenant-billing auth/usage; an object customizes policy.
+     */
+    subscriptionBundles?: false | true | SaasPlatformSubscriptionBundlesOptions;
+    /**
+     * Standard SuperAdmin Tenant/User/Audit/Subscription endpoints. `true`
+     * uses `persistence.adminResources` and the standard guard chain.
+     */
+    adminResources?: false | true | SaasPlatformAdminResourcesOptions;
+    /**
+     * Promo-code domain and SuperAdmin CRUD. `true` enables the admin API
+     * without the public preview endpoint; pass an object to enable preview.
+     */
+    promoCodes?: false | true | SaasPlatformPromoCodesOptions;
     /**
      * Enable the tenant manifest — the app UI gets a filtered manifest per
      * tenant with features, quotas and visible navigation. Requires that
-     * `defaultPlanId` or `adapters.planResolver` is set.
+     * `defaultPlanId`, `adapters.planResolver` or `tenantBilling` is set.
+     * `true` reuses tenant-billing guard classes when available, otherwise
+     * `controller.guards`.
      */
-    tenantManifest?: TenantManifestControllerOptions;
+    tenantManifest?: true | TenantManifestControllerOptions;
 }
 /**
  * Bundles PlanCatalog + Discovery + Admin + AdminManifest (+ optionally
@@ -260,4 +342,4 @@ declare class EnforceQuotaInterceptor implements NestInterceptor {
     private check;
 }
 
-export { EnforceQuotaInterceptor as E, PLAN_RESOLVER_PORT_TOKEN as P, QUOTA_PROVIDERS_TOKEN as Q, StaticEntitlementService as S, type TenantManifestControllerOptions as T, type PlanResolverPort as a, STATIC_FEATURE_GUARD_CONFIG_TOKEN as b, type SaasPlatformAdapters as c, SaasPlatformModule as d, type SaasPlatformModuleOptions as e, type StaticEntitlementSnapshot as f, StaticFeatureGuard as g, type StaticFeatureGuardConfig as h, StaticPlanResolver as i, buildTenantManifestController as j };
+export { EnforceQuotaInterceptor as E, PLAN_RESOLVER_PORT_TOKEN as P, QUOTA_PROVIDERS_TOKEN as Q, type SaasPlatformAdapters as S, type TenantManifestControllerOptions as T, StaticEntitlementService as a, StaticFeatureGuard as b, StaticPlanResolver as c, type SaasPlatformModuleOptions as d, type PlanResolverPort as e, STATIC_FEATURE_GUARD_CONFIG_TOKEN as f, SaasPlatformModule as g, type SaasPlatformAdminResourcesOptions as h, type SaasPlatformCatalogOptions as i, type SaasPlatformPromoCodesOptions as j, type SaasPlatformSubscriptionBundlesOptions as k, type SaasPlatformTenantAuthGuards as l, type SaasPlatformTenantBillingOptions as m, type StaticEntitlementSnapshot as n, type StaticFeatureGuardConfig as o, buildTenantManifestController as p };

package/dist/entitlement/index.cjs

@@ -741,6 +741,7 @@ var EntitlementModule = class _EntitlementModule {
     return {
       module: _EntitlementModule,
       global: options.global ?? false,
+      imports: options.imports ?? [],
       providers,
       exports: [
         EntitlementService,

package/dist/entitlement/index.d.cts

@@ -2,7 +2,7 @@ export { C as CustomLimitsShape, E as EffectiveLimits, a as EffectiveLimitsSnaps
 import { DiscoveredFeature, SubscriptionRepository, PlanVersionRepository, TransactionRunner, SubscriptionContractRepository, SubscriptionBundleRepository, BundleRepository } from '@saasicat/types';
 import { E as EntitlementResolutionConfig } from '../plan-resolution-CFCoUkrE.cjs';
 export { a as EntitlementResolutionInput, r as resolveEntitlementPlan } from '../plan-resolution-CFCoUkrE.cjs';
-import { DynamicModule } from '@nestjs/common';
+import { Type, DynamicModule, ForwardReference } from '@nestjs/common';
 import { P as ProviderSpec } from '../di-CcNeq9v-.cjs';
 
 /** Old feature key → direct successor keys (from their `replaces`). */
@@ -61,6 +61,8 @@ interface EntitlementModuleOptions {
     subscriptionBundleRepository?: ProviderSpec<SubscriptionBundleRepository>;
     /** See `subscriptionBundleRepository` — resolves BundleVersion features/quotas. */
     bundleRepository?: ProviderSpec<BundleRepository>;
+    /** Modules required by repository factory `inject` tokens. */
+    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
     /** Register the module globally — default `false`. */
     global?: boolean;
 }

package/dist/entitlement/index.d.ts

@@ -2,7 +2,7 @@ export { C as CustomLimitsShape, E as EffectiveLimits, a as EffectiveLimitsSnaps
 import { DiscoveredFeature, SubscriptionRepository, PlanVersionRepository, TransactionRunner, SubscriptionContractRepository, SubscriptionBundleRepository, BundleRepository } from '@saasicat/types';
 import { E as EntitlementResolutionConfig } from '../plan-resolution-CFCoUkrE.js';
 export { a as EntitlementResolutionInput, r as resolveEntitlementPlan } from '../plan-resolution-CFCoUkrE.js';
-import { DynamicModule } from '@nestjs/common';
+import { Type, DynamicModule, ForwardReference } from '@nestjs/common';
 import { P as ProviderSpec } from '../di-CcNeq9v-.js';
 
 /** Old feature key → direct successor keys (from their `replaces`). */
@@ -61,6 +61,8 @@ interface EntitlementModuleOptions {
     subscriptionBundleRepository?: ProviderSpec<SubscriptionBundleRepository>;
     /** See `subscriptionBundleRepository` — resolves BundleVersion features/quotas. */
     bundleRepository?: ProviderSpec<BundleRepository>;
+    /** Modules required by repository factory `inject` tokens. */
+    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
     /** Register the module globally — default `false`. */
     global?: boolean;
 }

package/dist/entitlement/index.js

@@ -1,4 +1,3 @@
-import "../chunk-2FR6ZL7R.js";
 import {
   EntitlementModule,
   EntitlementService,
@@ -17,7 +16,7 @@ import {
   isLimitExceededError,
   resolveEntitlementPlan,
   toEffectiveLimitsSnapshot
-} from "../chunk-RZU4HIAN.js";
+} from "../chunk-GW2I3JZD.js";
 import "../chunk-R2QOSVAA.js";
 import "../chunk-NYLON2VC.js";
 import {