@saasicat/nest 0.2.0

package/dist/platform/index.d.cts

@@ -0,0 +1,118 @@
+import { P as PlanResolverPort } from '../saas-platform.module-CgZ2omgg.cjs';
+export { a as PLAN_RESOLVER_PORT_TOKEN, b as SaasPlatformAdapters, c as SaasPlatformModule, S as SaasPlatformModuleOptions, d as StaticPlanResolver, T as TenantManifestControllerOptions, e as buildTenantManifestController } from '../saas-platform.module-CgZ2omgg.cjs';
+import { PlanCatalog, QuotaProvider } from '@saasicat/types';
+import { CanActivate, ExecutionContext, NestInterceptor, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import '../di-CcNeq9v-.cjs';
+import '../admin-manifest.config-DyrQNT7M.cjs';
+import '../discovery.scanner-CUYLKlYT.cjs';
+import '../plan-resolution-CFCoUkrE.cjs';
+
+interface StaticEntitlementSnapshot {
+    planId: string | null;
+    features: readonly string[];
+    /** quotaKey → limit (`-1` = unlimited). */
+    quotas: Readonly<Record<string, number>>;
+}
+declare class StaticEntitlementService {
+    private readonly catalog;
+    private readonly resolver;
+    constructor(catalog: PlanCatalog, resolver: PlanResolverPort);
+    /**
+     * Returns the effective features + quotas of a tenant from the
+     * plan catalog. When the plan is missing: an empty snapshot (no feature,
+     * all quotas at 0).
+     */
+    snapshot(tenantId: string): Promise<StaticEntitlementSnapshot>;
+    /** Convenience helper for tests / synchronous checks in the UI manifest. */
+    hasFeature(tenantId: string, featureKey: string): Promise<boolean>;
+    quotaLimit(tenantId: string, quotaKey: string): Promise<number | null>;
+    private findPlan;
+}
+
+declare const STATIC_FEATURE_GUARD_CONFIG_TOKEN: unique symbol;
+interface StaticFeatureGuardConfig {
+    /**
+     * Resolver for the user role (e.g. `(user) => user.platformRole`).
+     * SUPER_ADMIN gets a bypass.
+     */
+    userRoleResolver?: (user: unknown) => string | undefined;
+    /**
+     * Resolver for the tenant ID from the request. Default:
+     * `request.tenantId ?? request.user?.tenantId`.
+     */
+    tenantIdResolver?: (request: unknown) => string | undefined;
+}
+declare class StaticFeatureGuard implements CanActivate {
+    private readonly reflector;
+    private readonly entitlements;
+    private readonly config;
+    constructor(reflector: Reflector, entitlements: StaticEntitlementService, config?: StaticFeatureGuardConfig | null);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}
+
+declare const QUOTA_PROVIDERS_TOKEN: unique symbol;
+declare class EnforceQuotaInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly entitlements;
+    private readonly providers;
+    constructor(reflector: Reflector, entitlements: StaticEntitlementService, providers?: ReadonlyArray<QuotaProvider> | null);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    private check;
+}
+
+interface TenantNavItem {
+    /** Unique slug, e.g. "notes", "billing", "settings". */
+    id: string;
+    /** Display label (translatable — see AdminManifest for the pattern). */
+    label: string;
+    /** Frontend route, e.g. "/notes". */
+    path: string;
+    /** Optional: Quasar/Material icon. */
+    icon?: string;
+    /** Sort priority, lower = higher up. Default 100. */
+    order?: number;
+    /**
+     * When set, the item is only visible if the tenant has **one** of these
+     * features. The backend filters server-side — the app can rely on only
+     * permitted items being present in the manifest.
+     */
+    requiresFeature?: string | readonly string[];
+}
+interface TenantManifest {
+    schemaVersion: 1;
+    /** Tenant identity the manifest is bound to. */
+    tenant: {
+        id: string;
+    };
+    /** Active plan (from PlanResolverPort or SubscriptionContract). */
+    planId: string | null;
+    /** Unlocked features (set as array). */
+    features: readonly string[];
+    /** quotaKey → limit (`-1` = unlimited). */
+    quotas: Readonly<Record<string, number>>;
+    /** Visible navigation, already filtered by feature. */
+    navigation: TenantNavItem[];
+}
+
+declare class TenantManifestService {
+    private readonly entitlements;
+    private readonly navItems;
+    constructor(entitlements: StaticEntitlementService);
+    /**
+     * Call in the app's `OnModuleInit`: registers app navigation for the
+     * Tenant UI. Idempotent: the same `id` overwrites.
+     */
+    registerNavItem(item: TenantNavItem): void;
+    /** Bulk variant. */
+    registerNavItems(items: TenantNavItem[]): void;
+    /**
+     * Returns the filtered manifest for a Tenant. NavItems with
+     * `requiresFeature` are filtered out server-side as soon as none of the
+     * required features are present in the entitlement snapshot.
+     */
+    getManifest(tenantId: string): Promise<TenantManifest>;
+}
+
+export { EnforceQuotaInterceptor, PlanResolverPort, QUOTA_PROVIDERS_TOKEN, STATIC_FEATURE_GUARD_CONFIG_TOKEN, StaticEntitlementService, type StaticEntitlementSnapshot, StaticFeatureGuard, type StaticFeatureGuardConfig, type TenantManifest, TenantManifestService, type TenantNavItem };

package/dist/platform/index.d.ts

@@ -0,0 +1,118 @@
+import { P as PlanResolverPort } from '../saas-platform.module-DT9TnCzk.js';
+export { a as PLAN_RESOLVER_PORT_TOKEN, b as SaasPlatformAdapters, c as SaasPlatformModule, S as SaasPlatformModuleOptions, d as StaticPlanResolver, T as TenantManifestControllerOptions, e as buildTenantManifestController } from '../saas-platform.module-DT9TnCzk.js';
+import { PlanCatalog, QuotaProvider } from '@saasicat/types';
+import { CanActivate, ExecutionContext, NestInterceptor, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import '../di-CcNeq9v-.js';
+import '../admin-manifest.config-DyrQNT7M.js';
+import '../discovery.scanner-CUYLKlYT.js';
+import '../plan-resolution-CFCoUkrE.js';
+
+interface StaticEntitlementSnapshot {
+    planId: string | null;
+    features: readonly string[];
+    /** quotaKey → limit (`-1` = unlimited). */
+    quotas: Readonly<Record<string, number>>;
+}
+declare class StaticEntitlementService {
+    private readonly catalog;
+    private readonly resolver;
+    constructor(catalog: PlanCatalog, resolver: PlanResolverPort);
+    /**
+     * Returns the effective features + quotas of a tenant from the
+     * plan catalog. When the plan is missing: an empty snapshot (no feature,
+     * all quotas at 0).
+     */
+    snapshot(tenantId: string): Promise<StaticEntitlementSnapshot>;
+    /** Convenience helper for tests / synchronous checks in the UI manifest. */
+    hasFeature(tenantId: string, featureKey: string): Promise<boolean>;
+    quotaLimit(tenantId: string, quotaKey: string): Promise<number | null>;
+    private findPlan;
+}
+
+declare const STATIC_FEATURE_GUARD_CONFIG_TOKEN: unique symbol;
+interface StaticFeatureGuardConfig {
+    /**
+     * Resolver for the user role (e.g. `(user) => user.platformRole`).
+     * SUPER_ADMIN gets a bypass.
+     */
+    userRoleResolver?: (user: unknown) => string | undefined;
+    /**
+     * Resolver for the tenant ID from the request. Default:
+     * `request.tenantId ?? request.user?.tenantId`.
+     */
+    tenantIdResolver?: (request: unknown) => string | undefined;
+}
+declare class StaticFeatureGuard implements CanActivate {
+    private readonly reflector;
+    private readonly entitlements;
+    private readonly config;
+    constructor(reflector: Reflector, entitlements: StaticEntitlementService, config?: StaticFeatureGuardConfig | null);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}
+
+declare const QUOTA_PROVIDERS_TOKEN: unique symbol;
+declare class EnforceQuotaInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly entitlements;
+    private readonly providers;
+    constructor(reflector: Reflector, entitlements: StaticEntitlementService, providers?: ReadonlyArray<QuotaProvider> | null);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    private check;
+}
+
+interface TenantNavItem {
+    /** Unique slug, e.g. "notes", "billing", "settings". */
+    id: string;
+    /** Display label (translatable — see AdminManifest for the pattern). */
+    label: string;
+    /** Frontend route, e.g. "/notes". */
+    path: string;
+    /** Optional: Quasar/Material icon. */
+    icon?: string;
+    /** Sort priority, lower = higher up. Default 100. */
+    order?: number;
+    /**
+     * When set, the item is only visible if the tenant has **one** of these
+     * features. The backend filters server-side — the app can rely on only
+     * permitted items being present in the manifest.
+     */
+    requiresFeature?: string | readonly string[];
+}
+interface TenantManifest {
+    schemaVersion: 1;
+    /** Tenant identity the manifest is bound to. */
+    tenant: {
+        id: string;
+    };
+    /** Active plan (from PlanResolverPort or SubscriptionContract). */
+    planId: string | null;
+    /** Unlocked features (set as array). */
+    features: readonly string[];
+    /** quotaKey → limit (`-1` = unlimited). */
+    quotas: Readonly<Record<string, number>>;
+    /** Visible navigation, already filtered by feature. */
+    navigation: TenantNavItem[];
+}
+
+declare class TenantManifestService {
+    private readonly entitlements;
+    private readonly navItems;
+    constructor(entitlements: StaticEntitlementService);
+    /**
+     * Call in the app's `OnModuleInit`: registers app navigation for the
+     * Tenant UI. Idempotent: the same `id` overwrites.
+     */
+    registerNavItem(item: TenantNavItem): void;
+    /** Bulk variant. */
+    registerNavItems(items: TenantNavItem[]): void;
+    /**
+     * Returns the filtered manifest for a Tenant. NavItems with
+     * `requiresFeature` are filtered out server-side as soon as none of the
+     * required features are present in the entitlement snapshot.
+     */
+    getManifest(tenantId: string): Promise<TenantManifest>;
+}
+
+export { EnforceQuotaInterceptor, PlanResolverPort, QUOTA_PROVIDERS_TOKEN, STATIC_FEATURE_GUARD_CONFIG_TOKEN, StaticEntitlementService, type StaticEntitlementSnapshot, StaticFeatureGuard, type StaticFeatureGuardConfig, type TenantManifest, TenantManifestService, type TenantNavItem };

package/dist/platform/index.js

@@ -0,0 +1,37 @@
+import {
+  EnforceQuotaInterceptor,
+  PLAN_RESOLVER_PORT_TOKEN,
+  QUOTA_PROVIDERS_TOKEN,
+  STATIC_FEATURE_GUARD_CONFIG_TOKEN,
+  SaasPlatformModule,
+  StaticEntitlementService,
+  StaticFeatureGuard,
+  StaticPlanResolver,
+  TenantManifestService,
+  buildTenantManifestController
+} from "../chunk-QJVPRD3R.js";
+import "../chunk-P6MYZMXQ.js";
+import "../chunk-Q53N43LQ.js";
+import "../chunk-E56W4U2P.js";
+import "../chunk-AJ3EPELS.js";
+import "../chunk-M6CZQYPY.js";
+import "../chunk-YXGHPILG.js";
+import "../chunk-MV6LW5UB.js";
+import "../chunk-NYLON2VC.js";
+import "../chunk-7MLGHWKO.js";
+import "../chunk-XCZ3TTFK.js";
+import "../chunk-SABTXESR.js";
+import "../chunk-L4SUWH5B.js";
+import "../chunk-SHUYVCID.js";
+export {
+  EnforceQuotaInterceptor,
+  PLAN_RESOLVER_PORT_TOKEN,
+  QUOTA_PROVIDERS_TOKEN,
+  STATIC_FEATURE_GUARD_CONFIG_TOKEN,
+  SaasPlatformModule,
+  StaticEntitlementService,
+  StaticFeatureGuard,
+  StaticPlanResolver,
+  TenantManifestService,
+  buildTenantManifestController
+};