@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/features/services/feature-resolution.backend.service.js

@@ -0,0 +1,550 @@
+/**
+ * Feature Resolution Backend Service
+ *
+ * Resolves effective features for a given execution context by walking the scope hierarchy
+ * and merging multiple sources: defaults → profile → provider-derived → billing-derived → manual overrides.
+ *
+ * The output is a CONSOLIDATED ResolvedFeatures object that merges ALL applicable scope levels.
+ * The gate service checks this single object — no per-scope lookup at gate time.
+ *
+ * Cache: Redis with configurable TTL. Key format: `features:{scopeType}:{entityId}`.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'inversify';
+import { FEATURES_UNLIMITED, FeatureValueType, ResourcePrimaryScope, EngineCapability, ExecutionContext_ExecutionType, } from '@wildo-ai/saas-models';
+import { CoreResourceType, CoreResourceOperation, } from '@wildo-ai/saas-models';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { mergeLimit } from '../../billing/services/billing.utils.js';
+// =====================================================
+// Cache Configuration
+// =====================================================
+/** Default TTL values (in seconds) for different scope types */
+const DEFAULT_CACHE_TTL = {
+    [ResourcePrimaryScope.APPLICATION]: 3600, // 1 hour (changes only on provider binding changes)
+    [ResourcePrimaryScope.ORGANIZATIONS]: 300, // 5 minutes
+    [ResourcePrimaryScope.USER_SELF]: 300, // 5 minutes
+};
+/** Sentinel entity ID for application-scope features */
+const APP_SCOPE_ENTITY_ID = '__global__';
+// =====================================================
+// Merge Utilities
+// =====================================================
+/**
+ * Merge two ScopeFeatures objects (union for features, most permissive for limits).
+ */
+function mergeScopeFeatures(base, overlay) {
+    // Features: union (deduplicated)
+    const mergedFeatures = [...new Set([...base.features, ...overlay.features])];
+    // Limits: most permissive value wins
+    const mergedLimits = { ...base.limits };
+    for (const [key, value] of Object.entries(overlay.limits)) {
+        if (key in mergedLimits) {
+            mergedLimits[key] = mergeLimit(mergedLimits[key], value);
+        }
+        else {
+            mergedLimits[key] = value;
+        }
+    }
+    return { features: mergedFeatures, limits: mergedLimits };
+}
+// =====================================================
+// Feature Resolution Service
+// =====================================================
+let FeatureResolutionBackendService = class FeatureResolutionBackendService {
+    logger;
+    redisService;
+    featureRegistry;
+    capabilityBindings;
+    appConfigService;
+    container;
+    executionContextCreator;
+    resourcesRegistry;
+    logDebug;
+    _servicesRegistry = null;
+    constructor(logger, redisService, featureRegistry, capabilityBindings, appConfigService, container, executionContextCreator, resourcesRegistry) {
+        this.logger = logger;
+        this.redisService = redisService;
+        this.featureRegistry = featureRegistry;
+        this.capabilityBindings = capabilityBindings;
+        this.appConfigService = appConfigService;
+        this.container = container;
+        this.executionContextCreator = executionContextCreator;
+        this.resourcesRegistry = resourcesRegistry;
+        this.logDebug = this.logger.debugByType('FeatureResolutionBackendService');
+    }
+    get servicesRegistry() {
+        if (!this._servicesRegistry) {
+            this._servicesRegistry = this.container.get(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService);
+        }
+        return this._servicesRegistry;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Public API
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Resolve effective features for the current execution context.
+     * Walks the scope hierarchy based on ExecutionType and returns a CONSOLIDATED result.
+     */
+    async resolve(executionContext) {
+        const execType = executionContext.executionType;
+        // Internal calls bypass feature resolution entirely
+        if (execType === ExecutionContext_ExecutionType.INTERNALLY_INITIATED_REQUEST) {
+            this.logDebug('Internal call — returning all features enabled');
+            return this.buildAllFeaturesEnabled();
+        }
+        // Public executions get minimal features (defaults only, no scope)
+        if (execType === ExecutionContext_ExecutionType.PUBLIC_EXECUTION) {
+            this.logDebug('Public execution — returning defaults only');
+            return this.buildDefaults(ResourcePrimaryScope.APPLICATION);
+        }
+        // Determine scope chain based on execution type
+        const scopeChain = this.buildScopeChain(executionContext);
+        this.logDebug('Resolving features for scope chain', { execType, scopeChain: scopeChain.map(s => s.scopeType) });
+        // Walk the scope chain, layering features at each level
+        let consolidated = { features: [], limits: {} };
+        for (const scope of scopeChain) {
+            const scopeResolved = await this.resolveForScopeInternal(scope.scopeType, scope.entityId, consolidated);
+            consolidated = scopeResolved;
+        }
+        this.logDebug('Resolution complete', {
+            featuresCount: consolidated.features.length,
+            limitsCount: Object.keys(consolidated.limits).length,
+        });
+        // Cache on the context to avoid re-resolution within the same request
+        executionContext.setResolvedFeatures(consolidated);
+        return consolidated;
+    }
+    /**
+     * Resolve effective features for a specific scope entity (standalone, not context-aware).
+     * Does NOT walk the scope hierarchy — resolves a single scope starting from defaults.
+     */
+    async resolveForScope(scopeType, scopeEntityId) {
+        return this.resolveForScopeInternal(scopeType, scopeEntityId, { features: [], limits: {} });
+    }
+    /**
+     * Check if a boolean feature is enabled for the given execution context.
+     */
+    async isFeatureEnabled(featureId, executionContext) {
+        const resolved = await this.resolve(executionContext);
+        return resolved.features.includes(featureId);
+    }
+    /**
+     * Get the limit value for a LIMIT feature.
+     * Returns FEATURES_UNLIMITED if the feature is not found (permissive default).
+     */
+    async getLimit(featureId, executionContext) {
+        const resolved = await this.resolve(executionContext);
+        return resolved.limits[featureId] ?? FEATURES_UNLIMITED;
+    }
+    /**
+     * Get resolved features WITH current usage placeholder.
+     * Actual usage population is done in FeaturesControllerBackendService, which injects
+     * FeatureGateBackendService directly (no circular dependency at the controller level).
+     */
+    async resolveWithUsage(executionContext) {
+        const resolved = await this.resolve(executionContext);
+        return {
+            ...resolved,
+            currentUsage: {},
+        };
+    }
+    /**
+     * Invalidate cached features for a scope entity.
+     * Call on: feature override changes, subscription changes, provider binding changes.
+     */
+    async invalidateCache(scopeType, entityId) {
+        const cacheKey = this.buildCacheKey(scopeType, entityId);
+        this.logDebug('Invalidating feature cache', { cacheKey });
+        await this.redisService.del(cacheKey);
+    }
+    /**
+     * Invalidate cached features for all scope levels of an execution context.
+     * Convenience method for when a change affects the entire resolution chain.
+     */
+    async invalidateCacheForContext(executionContext) {
+        const scopeChain = this.buildScopeChain(executionContext);
+        for (const scope of scopeChain) {
+            await this.invalidateCache(scope.scopeType, scope.entityId);
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Internal Resolution
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Resolve features for a single scope level, starting from a base (parent scope's features).
+     * Checks cache first, then resolves from sources if cache miss.
+     */
+    async resolveForScopeInternal(scopeType, entityId, parentFeatures) {
+        const cacheKey = this.buildCacheKey(scopeType, entityId);
+        // Check cache
+        const cached = await this.redisService.get(cacheKey);
+        if (cached) {
+            this.logDebug('Cache hit', { cacheKey });
+            // Merge cached scope-level features with parent and then prune across the
+            // full effective layer so child-scope overrides can depend on parent
+            // entitlements.
+            return this.mergeAndPruneEffectiveFeatures(parentFeatures, cached);
+        }
+        this.logDebug('Cache miss — resolving', { scopeType, entityId });
+        // Step A: Start with feature definition defaults
+        let scopeFeatures = this.buildDefaults(scopeType);
+        // Step B: Layer config profile (when billing is disabled)
+        scopeFeatures = this.applyProfile(scopeFeatures, scopeType);
+        // Step C: Layer provider-derived features (APPLICATION scope only)
+        if (scopeType === ResourcePrimaryScope.APPLICATION) {
+            scopeFeatures = this.applyProviderDerivedFeatures(scopeFeatures);
+        }
+        // Steps D + E: Layer billing-derived features AND apply manual overrides.
+        // Both come from the same scope features document (single DB read).
+        // Billing sync writes to `features`/`limits`; admin overrides live in `manualOverrides`.
+        scopeFeatures = await this.applyBillingAndManualOverrides(scopeType, entityId, scopeFeatures);
+        // Cache the raw scope-level result before parent merge. Dependency pruning
+        // must run on the full effective set so child-scope features can depend on
+        // app/org features from broader scope layers.
+        const ttl = DEFAULT_CACHE_TTL[scopeType] ?? 300;
+        await this.redisService.set(cacheKey, scopeFeatures, { ttl });
+        this.logDebug('Cached scope features', { cacheKey, ttl });
+        // Merge with parent scope features and then prune across the full effective set.
+        return this.mergeAndPruneEffectiveFeatures(parentFeatures, scopeFeatures);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Resolution Steps
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Step A: Build defaults from feature definitions.
+     * Boolean features with defaultValue=true → enabled.
+     * Limit features → default numeric value.
+     */
+    buildDefaults(scopeType) {
+        const definitions = this.featureRegistry.getAllDefinitions();
+        const features = [];
+        const limits = {};
+        for (const def of definitions) {
+            if (!this.isDefinitionApplicableToScope(def.identifier, scopeType)) {
+                continue;
+            }
+            if (def.valueType === FeatureValueType.BOOLEAN && def.defaultValue === true) {
+                features.push(def.identifier);
+            }
+            if (def.valueType === FeatureValueType.LIMIT && typeof def.defaultValue === 'number') {
+                limits[def.identifier] = def.defaultValue;
+            }
+        }
+        return { features, limits };
+    }
+    /**
+     * Step B: Apply config profile.
+     * When billing is DISABLED: applies the defaultProfile from FeatureConfiguration.
+     * When billing is ENABLED: profiles are NOT used (features come from subscriptions).
+     */
+    applyProfile(base, scopeType) {
+        const config = this.featureRegistry.getConfiguration();
+        if (!config?.defaultProfile || !config?.profiles)
+            return base;
+        if (this.appConfigService.config?.billing?.enabled)
+            return base;
+        const profile = config.profiles[config.defaultProfile];
+        if (!profile)
+            return base;
+        this.logDebug('Applying profile', { profileKey: config.defaultProfile });
+        return mergeScopeFeatures(base, this.filterScopeFeaturesForScope(profile, scopeType));
+    }
+    /**
+     * Step C: Layer provider-derived features (APPLICATION scope only).
+     * Checks CapabilityBindingsBackendService for all EngineCapabilities with active providers.
+     * Each bound EngineCapability becomes an enabled boolean feature.
+     */
+    applyProviderDerivedFeatures(base) {
+        const providerFeatures = [];
+        for (const capability of Object.values(EngineCapability)) {
+            if (this.capabilityBindings.isCapabilityAvailable(capability)) {
+                providerFeatures.push(capability);
+            }
+        }
+        if (providerFeatures.length === 0)
+            return base;
+        this.logDebug('Provider-derived features', { count: providerFeatures.length });
+        return mergeScopeFeatures(base, { features: providerFeatures, limits: {} });
+    }
+    /**
+     * Steps D + E: Read the scope features document and apply billing-derived features
+     * AND manual overrides in a single DB read.
+     *
+     * The scope features document (e.g., ORGANIZATION_FEATURES) has:
+     * - `features` / `limits`: written by BillingFeatureSyncBackendService on subscription changes
+     * - `manualOverrides`: written by admin actions (ENABLE_FEATURE, DISABLE_FEATURE, etc.)
+     *
+     * Resolution order:
+     * 1. Merge billing-derived `features`/`limits` onto base (union/most-permissive)
+     * 2. Apply manual overrides on top (addedFeatures, removedFeatures, limitOverrides)
+     *    → Manual overrides always win.
+     */
+    async applyBillingAndManualOverrides(scopeType, entityId, base) {
+        // APPLICATION scope has no entity-level features document
+        if (scopeType === ResourcePrimaryScope.APPLICATION)
+            return base;
+        const scopeDoc = await this.getScopeFeatureDocument(scopeType, entityId);
+        if (!scopeDoc)
+            return base;
+        // Step D: Merge billing-derived features (stored in the document's `features`/`limits`)
+        let result = mergeScopeFeatures(base, this.filterScopeFeaturesForScope({
+            features: scopeDoc.features ?? [],
+            limits: scopeDoc.limits ?? {},
+        }, scopeType));
+        // Step E: Apply manual overrides on top (always win)
+        if (scopeDoc.manualOverrides) {
+            result = this.applyOverridesFromDocument(result, scopeDoc.manualOverrides);
+        }
+        return this.filterScopeFeaturesForScope(result, scopeType);
+    }
+    /**
+     * Read the scope features document for a given scope entity.
+     * Returns null if no document exists (entity has no features record yet).
+     *
+     * Uses READ operation (not LIST) because all scope features resources
+     * have READ configured, while USER_FEATURES does not expose LIST. The repository's `read` method accepts a filter
+     * object (uses MongoDB `findOne` internally), which is exactly what we need.
+     */
+    async getScopeFeatureDocument(scopeType, entityId) {
+        const resourceType = this.getScopeFeaturesResourceType(scopeType);
+        if (!resourceType)
+            return null;
+        const foreignKeyField = this.getScopeForeignKeyField(scopeType);
+        try {
+            const operationPath = this.resourcesRegistry.getOperationPathDefault(resourceType, CoreResourceOperation.READ);
+            const ctx = await this.executionContextCreator.createForInternalOperation({
+                operation: operationPath,
+                contextResourcesFieldIdentifier: new Map(),
+                initiatorIds: null,
+                initiatorRoles: [],
+            });
+            // Use read with a filter object (not an ID) — repository findOne under the hood
+            return await this.servicesRegistry.read(resourceType, ctx, { [foreignKeyField]: entityId });
+        }
+        catch (error) {
+            // Expected when no features document exists yet for this entity
+            this.logDebug('No scope features document found (or read failed)', {
+                scopeType, entityId, error: error.message,
+            });
+            return null;
+        }
+    }
+    /**
+     * Map scope type to the corresponding features resource type.
+     */
+    getScopeFeaturesResourceType(scopeType) {
+        switch (scopeType) {
+            case ResourcePrimaryScope.ORGANIZATIONS:
+                return CoreResourceType.ORGANIZATION_FEATURES;
+            case ResourcePrimaryScope.USER_SELF:
+                return CoreResourceType.USER_FEATURES;
+            default:
+                return null;
+        }
+    }
+    /**
+     * Map scope type to the foreign key field name used in the features resource.
+     */
+    getScopeForeignKeyField(scopeType) {
+        switch (scopeType) {
+            case ResourcePrimaryScope.ORGANIZATIONS:
+                return 'organizationId';
+            case ResourcePrimaryScope.USER_SELF:
+                return 'userId';
+            default:
+                return 'entityId';
+        }
+    }
+    /**
+     * Apply manual overrides from a ScopeFeaturesWithOverrides document.
+     * Manual overrides always win: addedFeatures are unioned, removedFeatures are excluded,
+     * limitOverrides directly replace computed values.
+     */
+    applyOverridesFromDocument(base, overrides) {
+        let features = [...base.features];
+        const limits = { ...base.limits };
+        // Add manually added features
+        if (overrides.addedFeatures?.length) {
+            features = [...new Set([...features, ...overrides.addedFeatures])];
+        }
+        // Remove manually removed features
+        if (overrides.removedFeatures?.length) {
+            const removedSet = new Set(overrides.removedFeatures);
+            features = features.filter(f => !removedSet.has(f));
+        }
+        // Apply limit overrides (always win)
+        if (overrides.limitOverrides) {
+            for (const [key, value] of Object.entries(overrides.limitOverrides)) {
+                limits[key] = value;
+            }
+        }
+        return { features, limits };
+    }
+    mergeAndPruneEffectiveFeatures(parentFeatures, scopeFeatures) {
+        return this.pruneDependencies(mergeScopeFeatures(parentFeatures, scopeFeatures));
+    }
+    /**
+     * Keep every resolution source honest about the shared `applicableScopes`
+     * contract so defaults, profiles, and persisted scope docs cannot leak
+     * app-only or org-only feature ids into the wrong resolution layer.
+     */
+    filterScopeFeaturesForScope(scopeFeatures, scopeType) {
+        const filteredFeatures = scopeFeatures.features.filter(featureId => this.isDefinitionApplicableToScope(featureId, scopeType));
+        const filteredLimits = Object.fromEntries(Object.entries(scopeFeatures.limits).filter(([featureId]) => this.isDefinitionApplicableToScope(featureId, scopeType)));
+        return {
+            features: filteredFeatures,
+            limits: filteredLimits,
+        };
+    }
+    isDefinitionApplicableToScope(featureId, scopeType) {
+        const definition = this.featureRegistry.getDefinition(featureId);
+        if (!definition?.applicableScopes || definition.applicableScopes.length === 0) {
+            return true;
+        }
+        return definition.applicableScopes.includes(scopeType);
+    }
+    /**
+     * Step F: Prune features whose dependencies are not met.
+     * A feature is disabled if any of its dependencies is not in the enabled set.
+     *
+     * Uses iterative pruning (not single-pass) to handle transitive dependencies:
+     * If A depends on B and B depends on C, removing C must also remove B and then A.
+     * Loops until no more features are pruned (stable set).
+     */
+    pruneDependencies(resolved) {
+        let currentFeatures = [...resolved.features];
+        let changed = true;
+        while (changed) {
+            changed = false;
+            const enabledSet = new Set(currentFeatures);
+            const nextFeatures = [];
+            for (const featureId of currentFeatures) {
+                const def = this.featureRegistry.getDefinition(featureId);
+                if (!def || !def.dependencies || def.dependencies.length === 0) {
+                    nextFeatures.push(featureId);
+                    continue;
+                }
+                const allDepsMet = def.dependencies.every(dep => enabledSet.has(dep));
+                if (allDepsMet) {
+                    nextFeatures.push(featureId);
+                }
+                else {
+                    changed = true;
+                    this.logDebug('Feature pruned (unmet dependencies)', {
+                        featureId,
+                        missingDeps: def.dependencies.filter(d => !enabledSet.has(d)),
+                    });
+                }
+            }
+            currentFeatures = nextFeatures;
+        }
+        return { features: currentFeatures, limits: resolved.limits };
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Scope Chain Builder
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Build the scope chain to resolve based on execution type.
+     * Returns scope levels from broadest (app) to most specific (user).
+     */
+    buildScopeChain(executionContext) {
+        const execType = executionContext.executionType;
+        const chain = [];
+        // App-level features are always the first layer
+        chain.push({
+            scopeType: ResourcePrimaryScope.APPLICATION,
+            entityId: APP_SCOPE_ENTITY_ID,
+        });
+        switch (execType) {
+            case ExecutionContext_ExecutionType.USER_REQUEST: {
+                // JWT: app → org → user
+                const orgId = executionContext.organizationId;
+                if (orgId) {
+                    chain.push({ scopeType: ResourcePrimaryScope.ORGANIZATIONS, entityId: orgId });
+                }
+                const userId = executionContext.userId;
+                if (userId) {
+                    chain.push({ scopeType: ResourcePrimaryScope.USER_SELF, entityId: userId });
+                }
+                break;
+            }
+            case ExecutionContext_ExecutionType.ORG_API_KEY: {
+                // Org API key: app → org (no user)
+                const orgId = executionContext.organizationId;
+                if (orgId) {
+                    chain.push({ scopeType: ResourcePrimaryScope.ORGANIZATIONS, entityId: orgId });
+                }
+                else {
+                    this.logger.warn('ORG_API_KEY execution without organizationId — org features skipped');
+                }
+                break;
+            }
+            case ExecutionContext_ExecutionType.APP_API_KEY: {
+                // App API key: app only (no org or user)
+                break;
+            }
+            case ExecutionContext_ExecutionType.CONSUMABLE_TOKEN: {
+                // Consumable token: app → org (if org context available)
+                const orgId = executionContext.organizationId;
+                if (orgId) {
+                    chain.push({ scopeType: ResourcePrimaryScope.ORGANIZATIONS, entityId: orgId });
+                }
+                break;
+            }
+            default:
+                this.logDebug('Unknown execution type for scope chain', { execType });
+        }
+        return chain;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Helpers
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Build a cache key for a scope entity.
+     * Format: `features:{scopeType}:{entityId}`
+     */
+    buildCacheKey(scopeType, entityId) {
+        return `features:${scopeType}:${entityId}`;
+    }
+    /**
+     * Build a ResolvedFeatures with ALL features enabled and all limits set to UNLIMITED.
+     * Used for internal/system calls that bypass feature gating.
+     */
+    buildAllFeaturesEnabled() {
+        const definitions = this.featureRegistry.getAllDefinitions();
+        const features = [];
+        const limits = {};
+        for (const def of definitions) {
+            features.push(def.identifier);
+            if (def.valueType === FeatureValueType.LIMIT) {
+                limits[def.identifier] = FEATURES_UNLIMITED;
+            }
+        }
+        return { features, limits };
+    }
+};
+FeatureResolutionBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.RedisService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.FeatureDefinitionRegistryService)),
+    __param(3, inject(SAAS_SERVICE_TYPES.CapabilityBindingsService)),
+    __param(4, inject(SAAS_SERVICE_TYPES.AppConfigService)),
+    __param(5, inject('Container')),
+    __param(6, inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService)),
+    __param(7, inject(SAAS_SERVICE_TYPES.ResourceRegistryService)),
+    __metadata("design:paramtypes", [Function, Function, Function, Function, Function, Function, Function, Function])
+], FeatureResolutionBackendService);
+export { FeatureResolutionBackendService };
+//# sourceMappingURL=feature-resolution.backend.service.js.map

package/dist/esm/features/services/feature-resolution.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-resolution.backend.service.js","sourceRoot":"","sources":["../../../../src/features/services/feature-resolution.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/features/testing/feature-test-utils.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Feature Test Utilities
+ *
+ * Helpers for testing feature gating in both engine and custom app tests.
+ * Bypasses the resolution service for deterministic, isolated testing.
+ *
+ * **Naming:** `createTestOperation` / `createTestOperationNoFeatures` here are **feature-gate**
+ * operation stubs (requiredFeatures, etc.). For **resource / DTO** test configs, use
+ * `createTestOperation` from `@wildo-ai/saas-models/testing` (`resource-config-builders.ts`).
+ */
+import { ExecutionContext_ExecutionType, type ResolvedFeatures } from '@wildo-ai/saas-models';
+import { ExecutionContext } from '../../runtime/models/execution-context.backend.schemas.js';
+export interface TestFeaturesOptions {
+    /** Boolean features to enable */
+    features?: string[];
+    /** Limit features to set (featureId → limit value). Use FEATURES_UNLIMITED for unlimited. */
+    limits?: Record<string, number>;
+    /** Execution type. Defaults to USER_INITIATED. */
+    executionType?: ExecutionContext_ExecutionType;
+    /**
+     * Organization ID for the initiator.
+     * For `INTERNALLY_INITIATED_REQUEST` / `PUBLIC_EXECUTION`, defaults to undefined (platform contract).
+     */
+    organizationId?: string;
+    /**
+     * User ID for the initiator.
+     * For `INTERNALLY_INITIATED_REQUEST` / `PUBLIC_EXECUTION`, defaults to undefined (platform contract).
+     */
+    userId?: string;
+}
+/**
+ * Create an ExecutionContext with specific features pre-resolved.
+ * Bypasses the resolution service for deterministic testing.
+ *
+ * @example
+ * ```ts
+ * const ctx = createTestExecutionContextWithFeatures({
+ *   features: ['AI_ASSISTANT', 'BULK_EXPORT'],
+ *   limits: { MAX_PROJECTS: 10 },
+ * });
+ * await gate.checkOperationFeatures(operation, ctx);
+ * ```
+ */
+export declare function createTestExecutionContextWithFeatures(options?: TestFeaturesOptions): ExecutionContext<any>;
+/**
+ * Assert that calling `fn` throws a feature gate error with the expected type.
+ *
+ * @example
+ * ```ts
+ * await expectFeatureGateBlock(
+ *   () => gate.checkOperationFeatures(operation, ctx),
+ *   'FEATURE_NOT_AVAILABLE',
+ * );
+ * ```
+ */
+export declare function expectFeatureGateBlock(fn: () => Promise<void>, expectedErrorType: 'FEATURE_NOT_AVAILABLE' | 'FEATURE_LIMIT_EXCEEDED'): Promise<void>;
+/**
+ * Assert that calling `fn` passes without throwing (feature is available).
+ *
+ * @example
+ * ```ts
+ * await expectFeatureGatePass(() => gate.checkOperationFeatures(operation, ctx));
+ * ```
+ */
+export declare function expectFeatureGatePass(fn: () => Promise<void>): Promise<void>;
+/**
+ * Create a minimal operation config with requiredFeatures for testing.
+ */
+export declare function createTestOperation(requiredFeatures: {
+    features?: string[];
+    mode?: 'OR' | 'AND';
+    limitChecks?: Array<{
+        featureId: string;
+        increment?: number;
+    }>;
+}): any;
+/**
+ * Create a test operation with no feature requirements (should always pass the gate).
+ */
+export declare function createTestOperationNoFeatures(): any;
+/**
+ * Convenience: create a resolved features object.
+ */
+export declare function createResolvedFeatures(features?: string[], limits?: Record<string, number>): ResolvedFeatures;
+//# sourceMappingURL=feature-test-utils.d.ts.map

package/dist/esm/features/testing/feature-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-test-utils.d.ts","sourceRoot":"","sources":["../../../../src/features/testing/feature-test-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,8BAA8B,EAI9B,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qEAAqE,CAAC;AAMvG,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,kDAAkD;IAClD,aAAa,CAAC,EAAE,8BAA8B,CAAC;IAC/C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sCAAsC,CACpD,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAAC,GAAG,CAAC,CA8CvB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,iBAAiB,EAAE,uBAAuB,GAAG,wBAAwB,GACpE,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE,GAAG,GAAG,CAYN;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,GAAG,CAOnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAM,EAAO,EACvB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,gBAAgB,CAElB"}