@wildo-ai/saas-models 1.0.1

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

@@ -0,0 +1,239 @@
+/**
+ * Feature Definition Schemas
+ *
+ * Core schemas for the feature system. These define the structure of:
+ * - Feature definitions (what a feature is, how it's gated)
+ * - Feature configuration (all definitions + profiles + unavailability policy)
+ * - Supporting types (counting config, unavailability behavior, etc.)
+ *
+ * This is the DEFINITION layer — not the storage layer (that's ScopeFeaturesSchema in T1.3).
+ */
+import { z } from 'zod';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+export declare enum FeatureValueType {
+    /** On/off toggle: checked via features.includes(id) */
+    BOOLEAN = "boolean",
+    /** Numeric limit: checked via limits[id] vs current count */
+    LIMIT = "limit"
+}
+/**
+ * What happens in the frontend when a feature is unavailable.
+ * Used in FeatureDefinition.unavailability (per-feature) and FeatureConfiguration.unavailabilityPolicy (global).
+ * Defined here in shared models so both backend (for API contracts) and frontend (for UI) share it.
+ */
+export declare enum FeatureUnavailabilityBehavior {
+    /** Don't render the element at all */
+    HIDE = "hide",
+    /** Render disabled, no explanation */
+    DISABLE = "disable",
+    /** Render disabled with "Upgrade plan" CTA */
+    UPGRADE_PROMPT = "upgrade_prompt",
+    /** Render disabled with "Purchase add-on" CTA */
+    ADDON_PROMPT = "addon_prompt",
+    /** Render disabled with "Contact your admin" message */
+    CONTACT_ADMIN = "contact_admin",
+    /** Show remaining quota with "Upgrade for more" (for limits) */
+    LIMIT_UPGRADE_PROMPT = "limit_upgrade_prompt",
+    /** Custom: render a registered custom component (requires customComponentRef on the feature's unavailability config) */
+    CUSTOM = "custom"
+}
+/**
+ * Reason WHY a feature is unavailable. Used in FeatureAvailability.reason and as keys
+ * in FeatureConfiguration.unavailabilityPolicy.reasonDefaults.
+ */
+export declare enum FeatureUnavailabilityReason {
+    /** Boolean feature is not enabled for this scope */
+    FEATURE_NOT_ENABLED = "feature_not_enabled",
+    /** Limit-type feature has exceeded its capacity */
+    LIMIT_EXCEEDED = "limit_exceeded",
+    /** Feature has no definition or is not configured */
+    NOT_CONFIGURED = "not_configured"
+}
+/**
+ * Aggregation operation for limit counting (when using field aggregation instead of document count).
+ */
+export declare enum AggregationOperation {
+    SUM = "SUM",
+    AVG = "AVG",
+    MAX = "MAX"
+}
+/**
+ * How to measure current usage for a LIMIT feature.
+ * Defines the "counting" strategy: what to query, how to aggregate.
+ * When present, the gate can auto-check this limit. When absent, custom code handles it.
+ */
+export declare const LimitCountingConfigSchema: z.ZodObject<{
+    resourceType: z.ZodString;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    aggregate: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        operation: z.ZodEnum<typeof AggregationOperation>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type LimitCountingConfig = z.infer<typeof LimitCountingConfigSchema>;
+/**
+ * Rate limiting configuration for features (data model prepared, implementation deferred).
+ *
+ * FUTURE: For features that need time-windowed restrictions (e.g., "100 API calls per hour",
+ * "10 report generations per day"). This is distinct from:
+ *   - LIMIT features (total capacity, checked by counting resources)
+ *   - Usage metering (billing-side consumption for invoicing)
+ *
+ * Rate-limited features are about: "can they do this RIGHT NOW given recent activity?"
+ * Implementation will use a sliding-window counter in Redis.
+ *
+ * NOT IMPLEMENTED in Phase 1. The schema is reserved to ensure the FeatureDefinition
+ * shape doesn't need a breaking change when rate limiting is added.
+ */
+export declare enum RateWindowUnit {
+    MINUTE = "minute",
+    HOUR = "hour",
+    DAY = "day"
+}
+export declare const RateLimitConfigSchema: z.ZodOptional<z.ZodObject<{
+    maxPerWindow: z.ZodNumber;
+    window: z.ZodEnum<typeof RateWindowUnit>;
+    windowCount: z.ZodDefault<z.ZodNumber>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        per_user: "per_user";
+        per_org: "per_org";
+        per_api_key: "per_api_key";
+        per_scope_entity: "per_scope_entity";
+    }>>;
+}, z.core.$strip, core.$ZodObjectExtra>>;
+export type RateLimitConfig = z.infer<typeof RateLimitConfigSchema>;
+/**
+ * Per-feature unavailability behavior override.
+ * When this feature is not available, this config determines the frontend behavior.
+ * If not set, the global FeatureConfiguration.unavailabilityPolicy defaults are used.
+ */
+export declare const FeatureUnavailabilityOverrideSchema: z.ZodObject<{
+    behavior: z.ZodOptional<z.ZodEnum<typeof FeatureUnavailabilityBehavior>>;
+    byRole: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<typeof FeatureUnavailabilityBehavior>>>;
+    suggestedProductRef: z.ZodOptional<z.ZodString>;
+    customComponentRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type FeatureUnavailabilityOverride = z.infer<typeof FeatureUnavailabilityOverrideSchema>;
+export declare const FeatureDefinitionSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    valueType: z.ZodEnum<typeof FeatureValueType>;
+    applicableScopes: z.ZodArray<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    defaultValue: z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    counting: z.ZodOptional<z.ZodObject<{
+        resourceType: z.ZodString;
+        filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        aggregate: z.ZodOptional<z.ZodObject<{
+            field: z.ZodString;
+            operation: z.ZodEnum<typeof AggregationOperation>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        maxPerWindow: z.ZodNumber;
+        window: z.ZodEnum<typeof RateWindowUnit>;
+        windowCount: z.ZodDefault<z.ZodNumber>;
+        scope: z.ZodDefault<z.ZodEnum<{
+            per_user: "per_user";
+            per_org: "per_org";
+            per_api_key: "per_api_key";
+            per_scope_entity: "per_scope_entity";
+        }>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    unavailability: z.ZodOptional<z.ZodObject<{
+        behavior: z.ZodOptional<z.ZodEnum<typeof FeatureUnavailabilityBehavior>>;
+        byRole: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<typeof FeatureUnavailabilityBehavior>>>;
+        suggestedProductRef: z.ZodOptional<z.ZodString>;
+        customComponentRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type FeatureDefinition = z.infer<typeof FeatureDefinitionSchema>;
+/**
+ * Sentinel value for "unlimited" in limit-type features.
+ * Used everywhere limits are stored, resolved, checked, or displayed.
+ * Stored as an actual number in limits records, NOT as a magic number.
+ *
+ * Usage: limits[featureId] === FEATURES_UNLIMITED or a concrete number.
+ * All gate checks, resolution merges, and UI rendering use this constant.
+ */
+export declare const FEATURES_UNLIMITED = -1;
+/**
+ * Zod schema for RequiredFeaturesConfig — used in view definition schemas
+ * and anywhere a Zod-validated `requiredFeatures` field is needed.
+ *
+ * Matches the TypeScript type `RequiredFeaturesConfig` from resources-config.shared.schemas.ts.
+ * Supports both shorthand (`string[]`) and full config forms.
+ */
+export declare const RequiredFeaturesConfigSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        OR: "OR";
+        AND: "AND";
+    }>>;
+    limitChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        featureId: z.ZodString;
+        increment: z.ZodOptional<z.ZodNumber>;
+        countingOverride: z.ZodOptional<z.ZodObject<{
+            resourceType: z.ZodString;
+            filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            aggregate: z.ZodOptional<z.ZodObject<{
+                field: z.ZodString;
+                operation: z.ZodEnum<typeof AggregationOperation>;
+            }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+}, z.core.$strip, core.$ZodObjectExtra>]>;
+/**
+ * Central feature configuration — ONE object per app, shared between frontend and backend.
+ * Defines ALL feature definitions + the global unavailability policy.
+ *
+ * Custom apps export this from their shared lib.
+ * Framework provides CORE_FEATURE_CONFIGURATION with core features + sensible defaults.
+ * At startup, custom config is merged with core config.
+ */
+export declare const FeatureConfigurationSchema: z.ZodObject<{
+    definitions: z.ZodArray<z.ZodObject<{
+        identifier: z.ZodString;
+        valueType: z.ZodEnum<typeof FeatureValueType>;
+        applicableScopes: z.ZodArray<z.ZodEnum<typeof ResourcePrimaryScope>>;
+        defaultValue: z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        counting: z.ZodOptional<z.ZodObject<{
+            resourceType: z.ZodString;
+            filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            aggregate: z.ZodOptional<z.ZodObject<{
+                field: z.ZodString;
+                operation: z.ZodEnum<typeof AggregationOperation>;
+            }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+        rateLimit: z.ZodOptional<z.ZodObject<{
+            maxPerWindow: z.ZodNumber;
+            window: z.ZodEnum<typeof RateWindowUnit>;
+            windowCount: z.ZodDefault<z.ZodNumber>;
+            scope: z.ZodDefault<z.ZodEnum<{
+                per_user: "per_user";
+                per_org: "per_org";
+                per_api_key: "per_api_key";
+                per_scope_entity: "per_scope_entity";
+            }>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+        unavailability: z.ZodOptional<z.ZodObject<{
+            behavior: z.ZodOptional<z.ZodEnum<typeof FeatureUnavailabilityBehavior>>;
+            byRole: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<typeof FeatureUnavailabilityBehavior>>>;
+            suggestedProductRef: z.ZodOptional<z.ZodString>;
+            customComponentRef: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        features: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("../index.js").CoreFeature>, z.ZodEnum<typeof import("../index.js").EngineCapability>, z.ZodString]>>>>;
+        limits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    defaultProfile: z.ZodOptional<z.ZodString>;
+    unavailabilityPolicy: z.ZodDefault<z.ZodObject<{
+        defaultBehavior: z.ZodDefault<z.ZodEnum<typeof FeatureUnavailabilityBehavior>>;
+        whenBillingDisabled: z.ZodDefault<z.ZodEnum<typeof FeatureUnavailabilityBehavior>>;
+        roleDefaults: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<typeof FeatureUnavailabilityBehavior>>>;
+        reasonDefaults: z.ZodDefault<z.ZodRecord<z.ZodEnum<typeof FeatureUnavailabilityReason>, z.ZodEnum<typeof FeatureUnavailabilityBehavior>>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type FeatureConfiguration = z.infer<typeof FeatureConfigurationSchema>;
+//# sourceMappingURL=feature-definition.shared.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/features/feature-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAO7E,oBAAY,gBAAgB;IAC1B,uDAAuD;IACvD,OAAO,YAAY;IACnB,6DAA6D;IAC7D,KAAK,UAAU;CAChB;AAMD;;;;GAIG;AACH,oBAAY,6BAA6B;IACvC,sCAAsC;IACtC,IAAI,SAAS;IACb,sCAAsC;IACtC,OAAO,YAAY;IACnB,8CAA8C;IAC9C,cAAc,mBAAmB;IACjC,iDAAiD;IACjD,YAAY,iBAAiB;IAC7B,wDAAwD;IACxD,aAAa,kBAAkB;IAC/B,gEAAgE;IAChE,oBAAoB,yBAAyB;IAC7C,wHAAwH;IACxH,MAAM,WAAW;CAClB;AAMD;;;GAGG;AACH,oBAAY,2BAA2B;IACrC,oDAAoD;IACpD,mBAAmB,wBAAwB;IAC3C,mDAAmD;IACnD,cAAc,mBAAmB;IACjC,qDAAqD;IACrD,cAAc,mBAAmB;CAClC;AAMD;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAMD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;uCAgBpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;;;;;;;;;;;GAaG;AACH,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;wCASrB,CAAC;AACd,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;;;GAIG;AACH,eAAO,MAAM,mCAAmC;;;;;uCAS9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAMhG,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAqClC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAMrC;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;yCAWvC,CAAC;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA0DrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

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

@@ -0,0 +1,280 @@
+/**
+ * Feature Definition Schemas
+ *
+ * Core schemas for the feature system. These define the structure of:
+ * - Feature definitions (what a feature is, how it's gated)
+ * - Feature configuration (all definitions + profiles + unavailability policy)
+ * - Supporting types (counting config, unavailability behavior, etc.)
+ *
+ * This is the DEFINITION layer — not the storage layer (that's ScopeFeaturesSchema in T1.3).
+ */
+import { z } from 'zod';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { ScopeFeaturesSchema } from './scope-features.shared.schemas.js';
+// =====================================================
+// Feature Value Type
+// =====================================================
+export var FeatureValueType;
+(function (FeatureValueType) {
+    /** On/off toggle: checked via features.includes(id) */
+    FeatureValueType["BOOLEAN"] = "boolean";
+    /** Numeric limit: checked via limits[id] vs current count */
+    FeatureValueType["LIMIT"] = "limit";
+})(FeatureValueType || (FeatureValueType = {}));
+// =====================================================
+// Frontend Unavailability Behavior
+// =====================================================
+/**
+ * What happens in the frontend when a feature is unavailable.
+ * Used in FeatureDefinition.unavailability (per-feature) and FeatureConfiguration.unavailabilityPolicy (global).
+ * Defined here in shared models so both backend (for API contracts) and frontend (for UI) share it.
+ */
+export var FeatureUnavailabilityBehavior;
+(function (FeatureUnavailabilityBehavior) {
+    /** Don't render the element at all */
+    FeatureUnavailabilityBehavior["HIDE"] = "hide";
+    /** Render disabled, no explanation */
+    FeatureUnavailabilityBehavior["DISABLE"] = "disable";
+    /** Render disabled with "Upgrade plan" CTA */
+    FeatureUnavailabilityBehavior["UPGRADE_PROMPT"] = "upgrade_prompt";
+    /** Render disabled with "Purchase add-on" CTA */
+    FeatureUnavailabilityBehavior["ADDON_PROMPT"] = "addon_prompt";
+    /** Render disabled with "Contact your admin" message */
+    FeatureUnavailabilityBehavior["CONTACT_ADMIN"] = "contact_admin";
+    /** Show remaining quota with "Upgrade for more" (for limits) */
+    FeatureUnavailabilityBehavior["LIMIT_UPGRADE_PROMPT"] = "limit_upgrade_prompt";
+    /** Custom: render a registered custom component (requires customComponentRef on the feature's unavailability config) */
+    FeatureUnavailabilityBehavior["CUSTOM"] = "custom";
+})(FeatureUnavailabilityBehavior || (FeatureUnavailabilityBehavior = {}));
+// =====================================================
+// Unavailability Reason
+// =====================================================
+/**
+ * Reason WHY a feature is unavailable. Used in FeatureAvailability.reason and as keys
+ * in FeatureConfiguration.unavailabilityPolicy.reasonDefaults.
+ */
+export var FeatureUnavailabilityReason;
+(function (FeatureUnavailabilityReason) {
+    /** Boolean feature is not enabled for this scope */
+    FeatureUnavailabilityReason["FEATURE_NOT_ENABLED"] = "feature_not_enabled";
+    /** Limit-type feature has exceeded its capacity */
+    FeatureUnavailabilityReason["LIMIT_EXCEEDED"] = "limit_exceeded";
+    /** Feature has no definition or is not configured */
+    FeatureUnavailabilityReason["NOT_CONFIGURED"] = "not_configured";
+})(FeatureUnavailabilityReason || (FeatureUnavailabilityReason = {}));
+// =====================================================
+// Aggregation Operation
+// =====================================================
+/**
+ * Aggregation operation for limit counting (when using field aggregation instead of document count).
+ */
+export var AggregationOperation;
+(function (AggregationOperation) {
+    AggregationOperation["SUM"] = "SUM";
+    AggregationOperation["AVG"] = "AVG";
+    AggregationOperation["MAX"] = "MAX";
+})(AggregationOperation || (AggregationOperation = {}));
+// =====================================================
+// Limit Counting Config
+// =====================================================
+/**
+ * How to measure current usage for a LIMIT feature.
+ * Defines the "counting" strategy: what to query, how to aggregate.
+ * When present, the gate can auto-check this limit. When absent, custom code handles it.
+ */
+export const LimitCountingConfigSchema = z.object({
+    /** Resource type to count/aggregate in the current scope entity */
+    resourceType: z.string().min(1),
+    /** Optional static filter on resource fields (e.g., { status: 'ACTIVE' }) */
+    filter: z.record(z.string(), z.unknown()).optional(),
+    /**
+     * Field aggregation instead of document count.
+     * When absent: plain COUNT of matching documents.
+     * When present: aggregate the specified field.
+     */
+    aggregate: z.object({
+        field: z.string().min(1),
+        operation: z.enum(AggregationOperation),
+    }).optional(),
+});
+// =====================================================
+// Rate Limit Config (Reserved)
+// =====================================================
+/**
+ * Rate limiting configuration for features (data model prepared, implementation deferred).
+ *
+ * FUTURE: For features that need time-windowed restrictions (e.g., "100 API calls per hour",
+ * "10 report generations per day"). This is distinct from:
+ *   - LIMIT features (total capacity, checked by counting resources)
+ *   - Usage metering (billing-side consumption for invoicing)
+ *
+ * Rate-limited features are about: "can they do this RIGHT NOW given recent activity?"
+ * Implementation will use a sliding-window counter in Redis.
+ *
+ * NOT IMPLEMENTED in Phase 1. The schema is reserved to ensure the FeatureDefinition
+ * shape doesn't need a breaking change when rate limiting is added.
+ */
+export var RateWindowUnit;
+(function (RateWindowUnit) {
+    RateWindowUnit["MINUTE"] = "minute";
+    RateWindowUnit["HOUR"] = "hour";
+    RateWindowUnit["DAY"] = "day";
+})(RateWindowUnit || (RateWindowUnit = {}));
+export const RateLimitConfigSchema = z.object({
+    /** Maximum operations in the window */
+    maxPerWindow: z.number().min(1),
+    /** Window size */
+    window: z.enum(RateWindowUnit),
+    /** Window count (e.g., 2 + HOUR = per 2 hours) */
+    windowCount: z.number().min(1).default(1),
+    /** Scope of the rate limit (per-user, per-org, per-api-key) */
+    scope: z.enum(['per_user', 'per_org', 'per_api_key', 'per_scope_entity']).default('per_user'),
+}).optional();
+// =====================================================
+// Feature Unavailability Override
+// =====================================================
+/**
+ * Per-feature unavailability behavior override.
+ * When this feature is not available, this config determines the frontend behavior.
+ * If not set, the global FeatureConfiguration.unavailabilityPolicy defaults are used.
+ */
+export const FeatureUnavailabilityOverrideSchema = z.object({
+    /** Default behavior for this feature (overrides global default) */
+    behavior: z.enum(FeatureUnavailabilityBehavior).optional(),
+    /** Role-specific overrides for this feature */
+    byRole: z.record(z.string(), z.enum(FeatureUnavailabilityBehavior)).optional(),
+    /** Product to suggest when prompting upgrade/addon */
+    suggestedProductRef: z.string().optional(),
+    /** Component reference for CUSTOM behavior (must be registered in the component registry) */
+    customComponentRef: z.string().optional(),
+});
+// =====================================================
+// Feature Definition
+// =====================================================
+export const FeatureDefinitionSchema = z.object({
+    /** Unique identifier (e.g., 'ADVANCED_ANALYTICS', 'MAX_PROJECTS') */
+    identifier: z.string().min(1),
+    /** Value type - determines how the gate checks this feature */
+    valueType: z.enum(FeatureValueType),
+    /** Which scopes this feature can be applied to (uses existing ResourcePrimaryScope) */
+    applicableScopes: z.array(z.enum(ResourcePrimaryScope)).min(1),
+    /** Default value when not explicitly set (false for BOOLEAN, number for LIMIT) */
+    defaultValue: z.union([z.boolean(), z.number()]),
+    /** Feature dependencies: these feature identifiers must also be enabled for this feature to be active */
+    dependencies: z.array(z.string()).default([]),
+    /**
+     * For LIMIT features: how to measure current usage (the "counting" strategy).
+     * When present: the gate can auto-check limits using this config.
+     * When absent: limit checking must be done in custom service code.
+     * Ignored for BOOLEAN features.
+     */
+    counting: LimitCountingConfigSchema.optional(),
+    /**
+     * RESERVED: Rate limiting config (implementation deferred, field exists for schema stability).
+     * When implemented: gate will check sliding-window counter in Redis before allowing operation.
+     * Until then: ignored by the gate.
+     */
+    rateLimit: RateLimitConfigSchema,
+    /**
+     * Frontend behavior when this feature is unavailable.
+     * Overrides the global policy from FeatureConfiguration.unavailabilityPolicy.
+     * When absent: global defaults apply (role > reason > app default).
+     */
+    unavailability: FeatureUnavailabilityOverrideSchema.optional(),
+});
+// =====================================================
+// FEATURES_UNLIMITED Constant
+// =====================================================
+/**
+ * Sentinel value for "unlimited" in limit-type features.
+ * Used everywhere limits are stored, resolved, checked, or displayed.
+ * Stored as an actual number in limits records, NOT as a magic number.
+ *
+ * Usage: limits[featureId] === FEATURES_UNLIMITED or a concrete number.
+ * All gate checks, resolution merges, and UI rendering use this constant.
+ */
+export const FEATURES_UNLIMITED = -1;
+// =====================================================
+// Required Features Config Schema (Zod validation)
+// =====================================================
+/**
+ * Zod schema for RequiredFeaturesConfig — used in view definition schemas
+ * and anywhere a Zod-validated `requiredFeatures` field is needed.
+ *
+ * Matches the TypeScript type `RequiredFeaturesConfig` from resources-config.shared.schemas.ts.
+ * Supports both shorthand (`string[]`) and full config forms.
+ */
+export const RequiredFeaturesConfigSchema = z.union([
+    z.array(z.string()),
+    z.object({
+        features: z.array(z.string()).optional(),
+        mode: z.enum(['OR', 'AND']).optional(),
+        limitChecks: z.array(z.object({
+            featureId: z.string(),
+            increment: z.number().optional(),
+            countingOverride: LimitCountingConfigSchema.optional(),
+        })).optional(),
+    }),
+]);
+// =====================================================
+// Feature Configuration
+// =====================================================
+/**
+ * Central feature configuration — ONE object per app, shared between frontend and backend.
+ * Defines ALL feature definitions + the global unavailability policy.
+ *
+ * Custom apps export this from their shared lib.
+ * Framework provides CORE_FEATURE_CONFIGURATION with core features + sensible defaults.
+ * At startup, custom config is merged with core config.
+ */
+export const FeatureConfigurationSchema = z.object({
+    /** All feature definitions (core + custom merged at startup) */
+    definitions: z.array(FeatureDefinitionSchema),
+    /**
+     * Feature profiles: preset configurations for different deployment modes.
+     * Used by the resolution service as the "config profile" source (source #2 in resolution).
+     *
+     * When billing is DISABLED: the `defaultProfile` is applied to all scope entities.
+     * When billing is ENABLED: profiles are NOT used (features come from subscription products instead).
+     *
+     * Defined in the custom app shared lib alongside feature definitions.
+     * Keys are profile identifiers (e.g., 'enterprise', 'free', 'starter').
+     */
+    profiles: z.record(z.string(), ScopeFeaturesSchema).default({}),
+    /**
+     * Default profile key (references a key in `profiles` above).
+     * If undefined: no profile applied (only feature definition defaults are used).
+     * Typical values: 'enterprise' (all features enabled), 'free' (baseline).
+     */
+    defaultProfile: z.string().optional(),
+    /** Global unavailability policy defaults (frontend behavior) */
+    unavailabilityPolicy: z.object({
+        /** Fallback behavior when nothing else matches */
+        defaultBehavior: z.enum(FeatureUnavailabilityBehavior)
+            .default(FeatureUnavailabilityBehavior.UPGRADE_PROMPT),
+        /** When billing is NOT enabled (enterprise/internal deployment) */
+        whenBillingDisabled: z.enum(FeatureUnavailabilityBehavior)
+            .default(FeatureUnavailabilityBehavior.HIDE),
+        /** Role-specific defaults (key = role identifier) */
+        roleDefaults: z.record(z.string(), z.enum(FeatureUnavailabilityBehavior)).default({}),
+        /** Reason-specific defaults (keyed by FeatureUnavailabilityReason values) */
+        reasonDefaults: z.record(z.enum(FeatureUnavailabilityReason), z.enum(FeatureUnavailabilityBehavior)).default({
+            [FeatureUnavailabilityReason.FEATURE_NOT_ENABLED]: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
+            [FeatureUnavailabilityReason.LIMIT_EXCEEDED]: FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT,
+            [FeatureUnavailabilityReason.NOT_CONFIGURED]: FeatureUnavailabilityBehavior.HIDE,
+        }),
+    }).default({
+        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,
+        },
+    }),
+    // NOTE: The outer .default() must provide the full object because Zod 4's .default()
+    // requires a value that matches the schema's output type (all fields required).
+    // The inner .default() on each field still applies when parsing partial input.
+});
+//# sourceMappingURL=feature-definition.shared.schemas.js.map

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

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

package/dist/esm/features/feature-registry.shared.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 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 type { FeatureConfiguration, FeatureDefinition } from './feature-definition.shared.schemas.js';
+import type { ScopeFeatures } from './scope-features.shared.schemas.js';
+import type { RequiredFeaturesConfig } from '../resources/resources-config.shared.schemas.js';
+import { FeatureValueType } from './feature-definition.shared.schemas.js';
+/**
+ * Input for merging: the custom app's feature configuration.
+ * Fields are optional — core + platform definitions are always included.
+ */
+export interface CustomFeatureConfigurationInput {
+    /** Custom feature definitions (in addition to core + platform) */
+    definitions?: FeatureDefinition[];
+    /** Feature profiles (preset configurations for deployment modes) */
+    profiles?: Record<string, ScopeFeatures>;
+    /** Default profile key (references a key in profiles) */
+    defaultProfile?: string;
+    /** Override unavailability policy */
+    unavailabilityPolicy?: FeatureConfiguration['unavailabilityPolicy'];
+}
+/**
+ * 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 declare function mergeFeatureConfigurations(customConfig?: CustomFeatureConfigurationInput): FeatureConfiguration;
+/**
+ * Normalized feature-reference usage coming from any authored surface.
+ *
+ * `surface` should be human-readable and precise enough to point developers
+ * straight to the misconfigured authoring location in startup diagnostics.
+ */
+export interface FeatureReferenceUsage {
+    surface: string;
+    references: FeatureReferenceEntry[];
+}
+/**
+ * One authored feature reference together with the slot semantics that explain
+ * how runtime interprets it.
+ */
+export interface FeatureReferenceEntry {
+    featureId: string;
+    slotLabel: string;
+    expectedValueType?: FeatureValueType;
+}
+/** Unknown feature references grouped by the surface that authored them. */
+export interface UnknownFeatureReferenceIssue {
+    surface: string;
+    references: FeatureReferenceEntry[];
+}
+/** Known feature ids used in a slot whose semantics do not match the feature type. */
+export interface IncompatibleFeatureReferenceIssue {
+    surface: string;
+    references: Array<FeatureReferenceEntry & {
+        actualValueType: FeatureValueType;
+    }>;
+}
+/** Combined validation result for authored feature-reference surfaces. */
+export interface FeatureReferenceValidationIssues {
+    unknownIssues: UnknownFeatureReferenceIssue[];
+    incompatibleIssues: IncompatibleFeatureReferenceIssue[];
+}
+/**
+ * Shared slot builder for surfaces that separate boolean-style features from
+ * limit-style grants/checks.
+ */
+export declare function buildFeatureReferenceEntries(params: {
+    featureIds?: string[];
+    limitFeatureIds?: string[];
+    featureSlotLabel: string;
+    limitSlotLabel: string;
+}): FeatureReferenceEntry[];
+/**
+ * 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 declare function extractFeatureReferencesFromRequiredFeatures(requiredFeatures: RequiredFeaturesConfig | null | undefined, slotLabels?: {
+    featureSlotLabel?: string;
+    limitSlotLabel?: string;
+}): FeatureReferenceEntry[];
+/**
+ * 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 declare function extractFeatureReferencesFromScopeFeatures(scopeFeatures: ScopeFeatures | null | undefined, slotLabels?: {
+    featureSlotLabel?: string;
+    limitSlotLabel?: string;
+}): FeatureReferenceEntry[];
+/**
+ * Compares normalized usages against the known registry ids and returns the
+ * unknown references together with known-but-slot-incompatible usages.
+ */
+export declare function collectFeatureReferenceValidationIssues(params: {
+    definitions: Iterable<FeatureDefinition>;
+    usages: FeatureReferenceUsage[];
+}): FeatureReferenceValidationIssues;
+//# sourceMappingURL=feature-registry.shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-registry.shared.d.ts","sourceRoot":"","sources":["../../../src/features/feature-registry.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAGL,gBAAgB,EACjB,MAAM,qCAAqC,CAAC;AAQ7C;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,kEAAkE;IAClE,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;CACrE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,GAAE,+BAAoC,GACjD,oBAAoB,CA+BtB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED,4EAA4E;AAC5E,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,sFAAsF;AACtF,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC,qBAAqB,GAAG;QAAE,eAAe,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAC;CAClF;AAED,0EAA0E;AAC1E,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,4BAA4B,EAAE,CAAC;IAC9C,kBAAkB,EAAE,iCAAiC,EAAE,CAAC;CACzD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,qBAAqB,EAAE,CAa1B;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAC1D,gBAAgB,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EAC3D,UAAU,GAAE;IACV,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,qBAAqB,EAAE,CAmBzB;AAED;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAC/C,UAAU,GAAE;IACV,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,qBAAqB,EAAE,CAWzB;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE;IAC9D,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACzC,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,GAAG,gCAAgC,CA+CnC"}