@wildo-ai/saas-models 1.0.1

package/dist/esm/features/feature-registry.shared.js

@@ -0,0 +1,176 @@
+/**
+ * Feature Registration Utilities
+ *
+ * Merges core, platform capability, and custom feature definitions
+ * into a unified FeatureConfiguration object.
+ *
+ * Used at startup by both backend (FeatureDefinitionRegistryBackendService)
+ * and frontend (feature context initialization).
+ */
+import { FeatureUnavailabilityBehavior, FeatureUnavailabilityReason, FeatureValueType, } from './feature-definition.shared.schemas.js';
+import { CORE_FEATURE_DEFINITIONS } from './core-feature-definitions.shared.js';
+import { ENGINE_CAPABILITY_DEFINITIONS } from './platform-capability-definitions.shared.js';
+/**
+ * Merges core + platform capability + custom feature definitions into a single FeatureConfiguration.
+ *
+ * Merge order (later definitions with same identifier take precedence):
+ * 1. CORE_FEATURE_DEFINITIONS (engine business features)
+ * 2. ENGINE_CAPABILITY_DEFINITIONS (engine capability features)
+ * 3. Custom definitions (app-specific features)
+ *
+ * Duplicate identifiers: the LAST definition wins. This allows custom apps to
+ * override core feature defaults (e.g., change defaultValue, add unavailability config).
+ *
+ * @param customConfig - Custom app's feature configuration input
+ * @returns Merged FeatureConfiguration ready for use by the registry
+ */
+export function mergeFeatureConfigurations(customConfig = {}) {
+    // Merge definitions: core → platform → custom (last wins for duplicates)
+    const allDefinitions = [
+        ...CORE_FEATURE_DEFINITIONS,
+        ...ENGINE_CAPABILITY_DEFINITIONS,
+        ...(customConfig.definitions ?? []),
+    ];
+    // Deduplicate by identifier (last one wins)
+    const definitionMap = new Map();
+    for (const def of allDefinitions) {
+        definitionMap.set(def.identifier, def);
+    }
+    const definitions = Array.from(definitionMap.values());
+    // Build the merged configuration
+    return {
+        definitions,
+        profiles: customConfig.profiles ?? {},
+        defaultProfile: customConfig.defaultProfile,
+        unavailabilityPolicy: customConfig.unavailabilityPolicy ?? {
+            defaultBehavior: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
+            whenBillingDisabled: FeatureUnavailabilityBehavior.HIDE,
+            roleDefaults: {},
+            reasonDefaults: {
+                [FeatureUnavailabilityReason.FEATURE_NOT_ENABLED]: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
+                [FeatureUnavailabilityReason.LIMIT_EXCEEDED]: FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT,
+                [FeatureUnavailabilityReason.NOT_CONFIGURED]: FeatureUnavailabilityBehavior.HIDE,
+            },
+        },
+    };
+}
+/**
+ * Shared slot builder for surfaces that separate boolean-style features from
+ * limit-style grants/checks.
+ */
+export function buildFeatureReferenceEntries(params) {
+    return [
+        ...(params.featureIds ?? []).map((featureId) => ({
+            featureId,
+            slotLabel: params.featureSlotLabel,
+            expectedValueType: FeatureValueType.BOOLEAN,
+        })),
+        ...(params.limitFeatureIds ?? []).map((featureId) => ({
+            featureId,
+            slotLabel: params.limitSlotLabel,
+            expectedValueType: FeatureValueType.LIMIT,
+        })),
+    ];
+}
+/**
+ * Extracts every feature identifier referenced by a `requiredFeatures` block.
+ *
+ * This centralizes the shorthand-vs-full-config branching so backend startup
+ * diagnostics, frontend tooling, and future build-time validators all interpret
+ * authored feature refs consistently.
+ */
+export function extractFeatureReferencesFromRequiredFeatures(requiredFeatures, slotLabels = {}) {
+    if (!requiredFeatures) {
+        return [];
+    }
+    if (Array.isArray(requiredFeatures)) {
+        return buildFeatureReferenceEntries({
+            featureIds: requiredFeatures,
+            featureSlotLabel: slotLabels.featureSlotLabel ?? 'features[]',
+            limitSlotLabel: slotLabels.limitSlotLabel ?? 'limitChecks[].featureId',
+        });
+    }
+    return buildFeatureReferenceEntries({
+        featureIds: requiredFeatures.features ?? [],
+        limitFeatureIds: requiredFeatures.limitChecks?.map(limitCheck => limitCheck.featureId) ?? [],
+        featureSlotLabel: slotLabels.featureSlotLabel ?? 'features[]',
+        limitSlotLabel: slotLabels.limitSlotLabel ?? 'limitChecks[].featureId',
+    });
+}
+/**
+ * Extracts feature references from a scope-state config surface such as a
+ * feature profile. Boolean entries live in `features[]`, while limit grants are
+ * represented by the keys of `limits`.
+ */
+export function extractFeatureReferencesFromScopeFeatures(scopeFeatures, slotLabels = {}) {
+    if (!scopeFeatures) {
+        return [];
+    }
+    return buildFeatureReferenceEntries({
+        featureIds: scopeFeatures.features ?? [],
+        limitFeatureIds: Object.keys(scopeFeatures.limits ?? {}),
+        featureSlotLabel: slotLabels.featureSlotLabel ?? 'features[]',
+        limitSlotLabel: slotLabels.limitSlotLabel ?? 'limits{}',
+    });
+}
+/**
+ * Compares normalized usages against the known registry ids and returns the
+ * unknown references together with known-but-slot-incompatible usages.
+ */
+export function collectFeatureReferenceValidationIssues(params) {
+    const definitionValueTypes = new Map(Array.from(params.definitions, (definition) => [definition.identifier, definition.valueType]));
+    const unknownIssues = [];
+    const incompatibleIssues = [];
+    for (const usage of params.usages) {
+        const unknownReferences = dedupeFeatureReferenceEntries(usage.references.filter(reference => !definitionValueTypes.has(reference.featureId)));
+        if (unknownReferences.length > 0) {
+            unknownIssues.push({
+                surface: usage.surface,
+                references: unknownReferences,
+            });
+        }
+        const incompatibleReferences = dedupeIncompatibleFeatureReferenceEntries(usage.references.flatMap((reference) => {
+            if (!reference.expectedValueType) {
+                return [];
+            }
+            const actualValueType = definitionValueTypes.get(reference.featureId);
+            if (!actualValueType || actualValueType === reference.expectedValueType) {
+                return [];
+            }
+            return [{
+                    ...reference,
+                    actualValueType,
+                }];
+        }));
+        if (incompatibleReferences.length > 0) {
+            incompatibleIssues.push({
+                surface: usage.surface,
+                references: incompatibleReferences,
+            });
+        }
+    }
+    return { unknownIssues, incompatibleIssues };
+}
+function dedupeFeatureReferenceEntries(references) {
+    const seen = new Set();
+    return references.filter((reference) => {
+        const key = `${reference.featureId}::${reference.slotLabel}::${reference.expectedValueType ?? 'any'}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+function dedupeIncompatibleFeatureReferenceEntries(references) {
+    const seen = new Set();
+    return references.filter((reference) => {
+        const key = `${reference.featureId}::${reference.slotLabel}::${reference.expectedValueType ?? 'any'}::${reference.actualValueType}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=feature-registry.shared.js.map

package/dist/esm/features/feature-registry.shared.js.map

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

package/dist/esm/features/feature-resolution.shared.schemas.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Feature Resolution Shared Types
+ *
+ * Output types from the feature resolution service.
+ * Used by both backend (resolution service, gate service) and frontend (features API).
+ */
+import type { ScopeFeatures } from './scope-features.shared.schemas.js';
+/**
+ * Resolved effective features for a scope entity.
+ * This is the output of the resolution algorithm — same shape as ScopeFeatures
+ * (features: string[], limits: Record<string, number>).
+ *
+ * The resolved set is a CONSOLIDATED view across all applicable scope levels
+ * (e.g., app + org + user for a JWT request). The gate checks this single object.
+ */
+export type ResolvedFeatures = ScopeFeatures;
+/**
+ * Resolved features enriched with current usage for limit features.
+ * Used by the frontend API to show "7/10 projects" style indicators.
+ *
+ * `currentUsage` is keyed by feature identifier and contains the current count
+ * for features that have a `counting` configuration in their FeatureDefinition.
+ */
+export interface ResolvedFeaturesWithUsage extends ScopeFeatures {
+    /** Current usage for limit features with counting configs. Key = feature identifier, value = current count. */
+    currentUsage: Record<string, number>;
+}
+/**
+ * Upgrade path for a feature — describes how the user can get access.
+ */
+export interface FeatureUpgradeOption {
+    type: 'plan_upgrade' | 'addon';
+    productId: string;
+    productLabel: string;
+    /** Product key used for checkout (billing catalog identifier) */
+    productKey: string;
+    /** Default price ID for checkout */
+    priceId: string;
+}
+/**
+ * Full API response for `GET /api/v1/features/resolved`.
+ * Extends ResolvedFeaturesWithUsage with upgrade options (from billing product catalog).
+ */
+export interface ResolvedFeaturesResponse extends ResolvedFeaturesWithUsage {
+    /**
+     * Upgrade options per feature — describes how to unlock unavailable features.
+     * Populated by reverse-lookup from product catalog when billing is enabled.
+     * Empty object when billing is disabled.
+     */
+    upgradeOptions: Record<string, {
+        availableVia: FeatureUpgradeOption[];
+    }>;
+}
+//# sourceMappingURL=feature-resolution.shared.schemas.d.ts.map

package/dist/esm/features/feature-resolution.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-resolution.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/features/feature-resolution.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAMrE;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAM7C;;;;;;GAMG;AACH,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC9D,+GAA+G;IAC/G,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1E"}

package/dist/esm/features/feature-resolution.shared.schemas.js

@@ -0,0 +1,7 @@
+/**
+ * Feature Resolution Shared Types
+ *
+ * Output types from the feature resolution service.
+ * Used by both backend (resolution service, gate service) and frontend (features API).
+ */
+//# sourceMappingURL=feature-resolution.shared.schemas.js.map

package/dist/esm/features/feature-resolution.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-resolution.shared.schemas.js","sourceRoot":"","sources":["../../../src/features/feature-resolution.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/esm/features/platform-capability-definitions.shared.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Engine Capability Feature Definitions
+ *
+ * Auto-generates FeatureDefinitions from EngineCapability enum values.
+ * These are APPLICATION-scoped boolean features that become enabled when
+ * a provider is bound via CapabilityBindingsBackendService.
+ *
+ * When billing is enabled, these capabilities flow down from APPLICATION scope
+ * to child scopes (orgs, users).
+ */
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { FeatureValueType } from './feature-definition.shared.schemas.js';
+import type { FeatureDefinition } from './feature-definition.shared.schemas.js';
+/**
+ * Generate FeatureDefinitions for all EngineCapability entries.
+ * These are APPLICATION-scoped boolean features.
+ * They become enabled when a provider/service is bound via CapabilityBindingsBackendService.
+ */
+export declare const ENGINE_CAPABILITY_DEFINITIONS: FeatureDefinition[];
+/**
+ * @deprecated Use `ENGINE_CAPABILITY_DEFINITIONS` instead.
+ */
+export declare const PLATFORM_CAPABILITY_DEFINITIONS: {
+    identifier: string;
+    valueType: FeatureValueType;
+    applicableScopes: ResourcePrimaryScope[];
+    dependencies: string[];
+    defaultValue?: number | boolean;
+    counting?: {
+        resourceType: string;
+        filter?: Record<string, unknown>;
+        aggregate?: {
+            field: string;
+            operation: import("./feature-definition.shared.schemas.js").AggregationOperation;
+        };
+    };
+    rateLimit?: {
+        maxPerWindow: number;
+        window: import("./feature-definition.shared.schemas.js").RateWindowUnit;
+        windowCount: number;
+        scope: "per_user" | "per_org" | "per_api_key" | "per_scope_entity";
+    };
+    unavailability?: {
+        behavior?: import("./feature-definition.shared.schemas.js").FeatureUnavailabilityBehavior;
+        byRole?: Record<string, import("./feature-definition.shared.schemas.js").FeatureUnavailabilityBehavior>;
+        suggestedProductRef?: string;
+        customComponentRef?: string;
+    };
+}[];
+//# sourceMappingURL=platform-capability-definitions.shared.d.ts.map

package/dist/esm/features/platform-capability-definitions.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-capability-definitions.shared.d.ts","sourceRoot":"","sources":["../../../src/features/platform-capability-definitions.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,iBAAiB,EAQ5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;GAAgC,CAAC"}

package/dist/esm/features/platform-capability-definitions.shared.js

@@ -0,0 +1,30 @@
+/**
+ * Engine Capability Feature Definitions
+ *
+ * Auto-generates FeatureDefinitions from EngineCapability enum values.
+ * These are APPLICATION-scoped boolean features that become enabled when
+ * a provider is bound via CapabilityBindingsBackendService.
+ *
+ * When billing is enabled, these capabilities flow down from APPLICATION scope
+ * to child scopes (orgs, users).
+ */
+import { EngineCapability } from '../external-providers/wildo-features.shared.schemas.js';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { FeatureValueType } from './feature-definition.shared.schemas.js';
+/**
+ * Generate FeatureDefinitions for all EngineCapability entries.
+ * These are APPLICATION-scoped boolean features.
+ * They become enabled when a provider/service is bound via CapabilityBindingsBackendService.
+ */
+export const ENGINE_CAPABILITY_DEFINITIONS = Object.values(EngineCapability).map((cap) => ({
+    identifier: cap, // EngineCapability enum value IS the feature identifier
+    valueType: FeatureValueType.BOOLEAN,
+    applicableScopes: [ResourcePrimaryScope.APPLICATION],
+    defaultValue: false, // Disabled until a provider/service is bound
+    dependencies: [],
+}));
+/**
+ * @deprecated Use `ENGINE_CAPABILITY_DEFINITIONS` instead.
+ */
+export const PLATFORM_CAPABILITY_DEFINITIONS = ENGINE_CAPABILITY_DEFINITIONS;
+//# sourceMappingURL=platform-capability-definitions.shared.js.map

package/dist/esm/features/platform-capability-definitions.shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-capability-definitions.shared.js","sourceRoot":"","sources":["../../../src/features/platform-capability-definitions.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CACnG,CAAC,GAAG,EAAqB,EAAE,CAAC,CAAC;IAC3B,UAAU,EAAE,GAAG,EAAE,wDAAwD;IACzE,SAAS,EAAE,gBAAgB,CAAC,OAAO;IACnC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC;IACpD,YAAY,EAAE,KAAK,EAAE,6CAA6C;IAClE,YAAY,EAAE,EAAE;CACjB,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,6BAA6B,CAAC"}

package/dist/esm/features/scope-features.shared.schemas.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Scope Features State Schemas
+ *
+ * Scope-agnostic feature state: what features are enabled and what limits are set
+ * for any scope entity (org, user).
+ *
+ * Replaces the org-only OrganizationPlanFeaturesSchema with a universal shape.
+ * Used by:
+ * - Feature profiles in FeatureConfiguration
+ * - Resource storage (ORGANIZATION_FEATURES, USER_FEATURES)
+ * - Resolution service output
+ */
+import { z } from 'zod';
+import { CoreFeature } from '../organizations/organization-features.shared.schemas.js';
+import { EngineCapability } from '../external-providers/wildo-features.shared.schemas.js';
+/**
+ * Feature state for any scope entity (org, user).
+ * Same simple shape: boolean features (present = enabled) + numeric limits.
+ * Replaces the org-only OrganizationPlanFeaturesSchema.
+ */
+export declare const ScopeFeaturesSchema: z.ZodObject<{
+    features: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof CoreFeature>, z.ZodEnum<typeof EngineCapability>, z.ZodString]>>>>;
+    limits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ScopeFeatures = z.infer<typeof ScopeFeaturesSchema>;
+/**
+ * Extension on the scope features resource (not a separate resource).
+ * Stores admin manual overrides that survive billing changes.
+ *
+ * Used as the `mainSchema` for ORGANIZATION_FEATURES, USER_FEATURES resources.
+ * The resolution service computes `features` and `limits` (the effective state) from:
+ *   defaults + config profile + billing-derived + manual overrides.
+ * The `manualOverrides` field stores admin changes that survive subscription changes.
+ */
+export declare const ScopeFeaturesWithOverridesSchema: z.ZodObject<{
+    features: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof CoreFeature>, z.ZodEnum<typeof EngineCapability>, z.ZodString]>>>>;
+    limits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
+    manualOverrides: z.ZodDefault<z.ZodObject<{
+        addedFeatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        removedFeatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ScopeFeaturesWithOverrides = z.infer<typeof ScopeFeaturesWithOverridesSchema>;
+//# sourceMappingURL=scope-features.shared.schemas.d.ts.map

package/dist/esm/features/scope-features.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-features.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/features/scope-features.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uDAAuD,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAMvF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;uCAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;uCAO3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/esm/features/scope-features.shared.schemas.js

@@ -0,0 +1,50 @@
+/**
+ * Scope Features State Schemas
+ *
+ * Scope-agnostic feature state: what features are enabled and what limits are set
+ * for any scope entity (org, user).
+ *
+ * Replaces the org-only OrganizationPlanFeaturesSchema with a universal shape.
+ * Used by:
+ * - Feature profiles in FeatureConfiguration
+ * - Resource storage (ORGANIZATION_FEATURES, USER_FEATURES)
+ * - Resolution service output
+ */
+import { z } from 'zod';
+import { CoreFeature } from '../organizations/organization-features.shared.schemas.js';
+import { EngineCapability } from '../external-providers/wildo-features.shared.schemas.js';
+// =====================================================
+// Scope Features Schema
+// =====================================================
+/**
+ * Feature state for any scope entity (org, user).
+ * Same simple shape: boolean features (present = enabled) + numeric limits.
+ * Replaces the org-only OrganizationPlanFeaturesSchema.
+ */
+export const ScopeFeaturesSchema = z.object({
+    /** Boolean features - present in array = enabled */
+    features: z.array(z.union([z.enum(CoreFeature), z.enum(EngineCapability), z.string().min(1)])).default([]).isSummaryField(),
+    /** Numeric limits - key = feature identifier, value = limit (FEATURES_UNLIMITED = unlimited) */
+    limits: z.record(z.string(), z.number()).default({}).isSummaryField(),
+});
+// =====================================================
+// Scope Features With Overrides Schema
+// =====================================================
+/**
+ * Extension on the scope features resource (not a separate resource).
+ * Stores admin manual overrides that survive billing changes.
+ *
+ * Used as the `mainSchema` for ORGANIZATION_FEATURES, USER_FEATURES resources.
+ * The resolution service computes `features` and `limits` (the effective state) from:
+ *   defaults + config profile + billing-derived + manual overrides.
+ * The `manualOverrides` field stores admin changes that survive subscription changes.
+ */
+export const ScopeFeaturesWithOverridesSchema = ScopeFeaturesSchema.extend({
+    /** Manual overrides by admin (persisted across billing changes) */
+    manualOverrides: z.object({
+        addedFeatures: z.array(z.string()).default([]),
+        removedFeatures: z.array(z.string()).default([]),
+        limitOverrides: z.record(z.string(), z.number()).default({}),
+    }).default({ addedFeatures: [], removedFeatures: [], limitOverrides: {} }),
+});
+//# sourceMappingURL=scope-features.shared.schemas.js.map

package/dist/esm/features/scope-features.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-features.shared.schemas.js","sourceRoot":"","sources":["../../../src/features/scope-features.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uDAAuD,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAEvF,wDAAwD;AACxD,wBAAwB;AACxB,wDAAwD;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oDAAoD;IACpD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE;IAC3H,gGAAgG;IAChG,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE;CACtE,CAAC,CAAC;AAGH,wDAAwD;AACxD,uCAAuC;AACvC,wDAAwD;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACzE,mEAAmE;IACnE,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC;QACxB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC7D,CAAC,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;CAC3E,CAAC,CAAC"}

package/dist/esm/features/user-features.shared.resources-config.schemas.d.ts

@@ -0,0 +1,21 @@
+/**
+ * User Features Shared Resource Configuration
+ *
+ * Resource configuration for user-level feature management.
+ * Controls which features are available to individual users (overrides/additions).
+ * Uses ScopeFeaturesWithOverridesSchema as mainSchema (same pattern as org features).
+ */
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceRelationship } from '../resources/resources.shared.schemas.js';
+type UserFeaturesCoreOperations = CoreResourceOperation.READ | CoreResourceOperation.SEARCH | CoreResourceOperation.UPDATE;
+export declare const userFeaturesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("../index.js").ResourceConfiguration<Record<string, never>, UserFeaturesCoreOperations, import("zod").ZodObject<{
+    features: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodEnum<typeof import("../index.js").CoreFeature>, import("zod").ZodEnum<typeof import("../index.js").EngineCapability>, import("zod").ZodString]>>>>;
+    limits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>>>;
+    manualOverrides: import("zod").ZodDefault<import("zod").ZodObject<{
+        addedFeatures: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        removedFeatures: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        limitOverrides: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>>;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+}, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+export {};
+//# sourceMappingURL=user-features.shared.resources-config.schemas.d.ts.map

package/dist/esm/features/user-features.shared.resources-config.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-features.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/features/user-features.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAMzG,KAAK,0BAA0B,GAC3B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,uDAAuD,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;uDA0DpH,CAAC"}

package/dist/esm/features/user-features.shared.resources-config.schemas.js

@@ -0,0 +1,65 @@
+/**
+ * User Features Shared Resource Configuration
+ *
+ * Resource configuration for user-level feature management.
+ * Controls which features are available to individual users (overrides/additions).
+ * Uses ScopeFeaturesWithOverridesSchema as mainSchema (same pattern as org features).
+ */
+import { ScopeFeaturesWithOverridesSchema } from './scope-features.shared.schemas.js';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationRiskLevel } from '../resources/resources.shared.schemas.js';
+import { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationVariantType } from '../resources/resources.shared.schemas.js';
+import { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory.js';
+import { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+export const userFeaturesResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: ScopeFeaturesWithOverridesSchema,
+    resourceIdentifier: CoreResourceType.USER_FEATURES,
+    resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_FEATURES],
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: true,
+    coreOperations: [
+        CoreResourceOperation.READ,
+        CoreResourceOperation.SEARCH,
+        CoreResourceOperation.UPDATE,
+    ],
+    customOperation: {},
+    operationsConfiguration: {
+        [CoreResourceOperation.READ]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_MEMBER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }
+            ]
+        },
+        [CoreResourceOperation.SEARCH]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_MEMBER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                    isSearchable: false,
+                    searchableFields: [],
+                    searchableOptions: { caseSensitive: false, fullMatchOnly: false },
+                    filterFields: {},
+                    sortFields: [],
+                    maxPaginatedResultPerPageLimit: 50,
+                }],
+        },
+        [CoreResourceOperation.UPDATE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                    requestDto: ScopeFeaturesWithOverridesSchema.partial(),
+                }
+            ],
+        },
+    },
+});
+//# sourceMappingURL=user-features.shared.resources-config.schemas.js.map

package/dist/esm/features/user-features.shared.resources-config.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-features.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/features/user-features.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAwB,MAAM,uCAAuC,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,kCAAkC,EAAE,MAAM,gDAAgD,CAAC;AACtH,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,0CAA0C,EAAE,MAAM,8CAA8C,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAOjG,MAAM,CAAC,MAAM,uDAAuD,GAAG,CAAC,sBAA8C,EAAE,EAAE,CAAC,0CAA0C,CAInK;IACA,UAAU,EAAE,gCAAgC;IAC5C,kBAAkB,EAAE,gBAAgB,CAAC,aAAa;IAClD,uBAAuB,EAAE,kCAAkC,CAAC,gBAAgB,CAAC,aAAa,CAAC;IAC3F,qBAAqB,EAAE,sBAAsB;IAC7C,gBAAgB,EAAE,IAAI;IAEtB,cAAc,EAAE;QACd,qBAAqB,CAAC,IAAI;QAC1B,qBAAqB,CAAC,MAAM;QAC5B,qBAAqB,CAAC,MAAM;KAC7B;IAED,eAAe,EAAE,EAA2B;IAE5C,uBAAuB,EAAE;QACvB,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE;YAC5B,QAAQ,EAAE;gBACR;oBACE,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC;oBAClC,SAAS,EAAE,0BAA0B,CAAC,GAAG;iBAC1C;aACF;SACF;QAED,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC;oBAClC,SAAS,EAAE,0BAA0B,CAAC,GAAG;oBACzC,YAAY,EAAE,KAAK;oBACnB,gBAAgB,EAAE,EAAE;oBACpB,iBAAiB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;oBACjE,YAAY,EAAE,EAAE;oBAChB,UAAU,EAAE,EAAE;oBACd,8BAA8B,EAAE,EAAE;iBACnC,CAAC;SACH;QAED,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE;gBACR;oBACE,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,qBAAqB,CAAC;oBAC7C,SAAS,EAAE,0BAA0B,CAAC,IAAI;oBAC1C,UAAU,EAAE,gCAAgC,CAAC,OAAO,EAAE;iBACvD;aACF;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/esm/files/files.shared.resources-config.schemas.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Files Resource Configuration (Repository-only)
+ *
+ * Provides repository operations for file metadata management.
+ * Files are managed internally by the file upload system.
+ *
+ * ## Scope Model
+ *
+ * Files use a **dynamic scope** that is derived from the parent resource's
+ * resourcePrimaryScope when linked. The FILES resource itself is configured
+ * with ORGANIZATIONS as default primaryScope, but individual file records
+ * store their actual scope in the `primaryScope` field.
+ *
+ * This allows files to be correctly scoped to:
+ * - APPLICATION: App-level shared files
+ * - ORGANIZATIONS: Org-scoped files (default)
+ * - USER_SELF: User-private files
+ *
+ */
+import { z } from 'zod';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceRelationship, ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+type FilesCoreOperations = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE | CoreResourceOperation.DELETE;
+/**
+ * Files Resource Configuration Factory
+ *
+ * Creates a REPOSITORY_ONLY resource configuration for file metadata.
+ * Files are managed internally by the file upload system and not exposed
+ * as standard REST API endpoints. Repository operations are used internally
+ * by FilesBackendService.
+ */
+export declare const filesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("../index.js").ResourceConfiguration<undefined, FilesCoreOperations, z.ZodObject<{
+    fileId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    filename: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    originalFilename: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+    mimeType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    size: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodNumber>;
+    extension: z.ZodOptional<z.ZodString>;
+    checksum: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    storageProvider: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").FileStorageAccepted>>>;
+    storageRef: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    storageKey: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+    url: z.ZodOptional<z.ZodURL>;
+    status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodEnum<typeof import("./files.shared.schemas.js").FileStatus>>>>;
+    nature: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").FileDisplayNature>>>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    thumbnailUrl: z.ZodOptional<z.ZodURL>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    pageCount: z.ZodOptional<z.ZodNumber>;
+    linkedResourceType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    linkedResourceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    linkedFieldName: z.ZodOptional<z.ZodString>;
+    primaryScope: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<{
+        user_self: ResourcePrimaryScope.USER_SELF;
+        organizations: ResourcePrimaryScope.ORGANIZATIONS;
+        applications: ResourcePrimaryScope.APPLICATION;
+    }>>>;
+    applicationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    organizationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    uploadedBy: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    uploadedByEntityType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/zod-decorators").FileUploaderEntityType>>>;
+    uploadedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>>;
+    deletedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>>;
+}, z.core.$strip, core.$ZodObjectExtra>>;
+export {};
+//# sourceMappingURL=files.shared.resources-config.schemas.d.ts.map

package/dist/esm/files/files.shared.resources-config.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/files/files.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAA4D,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAI7J,KAAK,mBAAmB,GACpB,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,gDAAgD,GAC3D,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA0E9C,CAAC"}