@wildo-ai/saas-models 1.0.1

package/dist/esm/external-providers/feature-mapping.shared.schemas.js.map

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

package/dist/esm/external-providers/wildo-features.shared.schemas.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Engine Capabilities Enum
+ *
+ * Unified enum representing all capabilities the engine can provide to applications.
+ * Each capability may support one or more fulfillment kinds (EXTERNAL_PROVIDER
+ * and/or PLATFORM_SERVICE). The supported fulfillment kinds are metadata on the
+ * definition (in EngineCapability_Definitions), not baked into the enum itself.
+ *
+ * - Managed capabilities: Framework provides standardized interfaces and transformers
+ * - Unmanaged capabilities: Apps use providers directly
+ */
+/**
+ * How an EngineCapability can be fulfilled at runtime.
+ *
+ * A capability may support multiple fulfillment kinds (e.g., document generation
+ * can be a self-hosted Gotenberg container OR an external API like Adobe PDF Services).
+ * The actual fulfillment is determined by the app's `capabilities` configuration.
+ *
+ * - EXTERNAL_PROVIDER: An external third-party provider (e.g., Resend, Twilio, Stripe)
+ *   whose secret bindings live in provider env/K8s materialization and whose
+ *   protocol is in external-connectors.
+ * - PLATFORM_SERVICE: A Wildo platform microservice (e.g., file-generator for document generation)
+ *   that the engine communicates with via internal JWT-authenticated calls.
+ */
+export declare enum EngineCapabilityFulfillmentKind {
+    EXTERNAL_PROVIDER = "EXTERNAL_PROVIDER",
+    PLATFORM_SERVICE = "PLATFORM_SERVICE"
+}
+/**
+ * Engine Capabilities
+ *
+ * Capabilities that applications can declare they need.
+ * Each EngineCapability may map to an ExternalProvider_Capability or a platform service.
+ *
+ * - Managed capabilities: Framework provides standardized interfaces and transformers
+ * - Unmanaged capabilities: Apps use providers directly
+ */
+export declare enum EngineCapability {
+    /**
+     * Transactional email sending - password resets, receipts, notifications.
+     * Standard interface: StandardEmail_SendRequest/Response
+     * Transformer: EmailTransactional_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EMAIL_TRANSACTIONAL = "EMAIL_TRANSACTIONAL",
+    /**
+     * Marketing email campaigns - newsletters, promotions.
+     * Standard interface: StandardMarketing_CampaignRequest/Response
+     * Transformer: EmailMarketing_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EMAIL_MARKETING = "EMAIL_MARKETING",
+    /**
+     * Maps and geolocation services.
+     * Apps use providers directly (Google Maps, Mapbox, etc.)
+     * Managed: false | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    MAPS_GEOLOCATION = "MAPS_GEOLOCATION",
+    /**
+     * SMS sending - OTP codes, phone verification, notifications.
+     * Standard interface: StandardSMS_SendRequest/Response
+     * Transformer: SMS_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    SMS = "SMS",
+    /**
+     * Billing provider - subscriptions, payments, invoices, metered usage.
+     * Standard interface: StandardBilling_Interface
+     * Transformer: Billing_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    BILLING = "BILLING",
+    /**
+     * AI/LLM text generation capabilities.
+     * Apps use providers directly through external-connectors LLM protocol.
+     * Managed: false | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    AI_LLM = "AI_LLM",
+    /**
+     * Document generation (PDF, DOCX, etc.).
+     * Primarily fulfilled by platform's file-generator service (Gotenberg),
+     * but could also be fulfilled by an external API (e.g., Adobe PDF Services).
+     * Managed: true | FulfillmentKinds: [PLATFORM_SERVICE, EXTERNAL_PROVIDER]
+     */
+    DOCUMENT_GENERATION = "DOCUMENT_GENERATION",
+    /**
+     * Antivirus / malware scanning for uploaded files.
+     * Primarily fulfilled by platform's ClamAV integration,
+     * but could also be fulfilled by an external API (e.g., VirusTotal).
+     * Managed: true | FulfillmentKinds: [PLATFORM_SERVICE, EXTERNAL_PROVIDER]
+     */
+    ANTIVIRUS_SCANNING = "ANTIVIRUS_SCANNING"
+}
+/**
+ * @deprecated Use `EngineCapability` instead. Kept as alias for migration period.
+ */
+export declare const PlatformCapability: typeof EngineCapability;
+/**
+ * @deprecated Use `EngineCapability` instead.
+ */
+export type PlatformCapability = EngineCapability;
+//# sourceMappingURL=wildo-features.shared.schemas.d.ts.map

package/dist/esm/external-providers/wildo-features.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildo-features.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/external-providers/wildo-features.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;;;;;;;GAYG;AACH,oBAAY,+BAA+B;IACzC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;CACtC;AAMD;;;;;;;;GAQG;AACH,oBAAY,gBAAgB;IAK1B;;;;;OAKG;IACH,mBAAmB,wBAAwB;IAE3C;;;;;OAKG;IACH,eAAe,oBAAoB;IAMnC;;;;OAIG;IACH,gBAAgB,qBAAqB;IAMrC;;;;;OAKG;IACH,GAAG,QAAQ;IAMX;;;;;OAKG;IACH,OAAO,YAAY;IAMnB;;;;OAIG;IACH,MAAM,WAAW;IAMjB;;;;;OAKG;IACH,mBAAmB,wBAAwB;IAE3C;;;;;OAKG;IACH,kBAAkB,uBAAuB;CAC1C;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,yBAAmB,CAAC;AACnD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC"}

package/dist/esm/external-providers/wildo-features.shared.schemas.js

@@ -0,0 +1,124 @@
+/**
+ * Engine Capabilities Enum
+ *
+ * Unified enum representing all capabilities the engine can provide to applications.
+ * Each capability may support one or more fulfillment kinds (EXTERNAL_PROVIDER
+ * and/or PLATFORM_SERVICE). The supported fulfillment kinds are metadata on the
+ * definition (in EngineCapability_Definitions), not baked into the enum itself.
+ *
+ * - Managed capabilities: Framework provides standardized interfaces and transformers
+ * - Unmanaged capabilities: Apps use providers directly
+ */
+// =====================================================
+// EngineCapabilityFulfillmentKind
+// =====================================================
+/**
+ * How an EngineCapability can be fulfilled at runtime.
+ *
+ * A capability may support multiple fulfillment kinds (e.g., document generation
+ * can be a self-hosted Gotenberg container OR an external API like Adobe PDF Services).
+ * The actual fulfillment is determined by the app's `capabilities` configuration.
+ *
+ * - EXTERNAL_PROVIDER: An external third-party provider (e.g., Resend, Twilio, Stripe)
+ *   whose secret bindings live in provider env/K8s materialization and whose
+ *   protocol is in external-connectors.
+ * - PLATFORM_SERVICE: A Wildo platform microservice (e.g., file-generator for document generation)
+ *   that the engine communicates with via internal JWT-authenticated calls.
+ */
+export var EngineCapabilityFulfillmentKind;
+(function (EngineCapabilityFulfillmentKind) {
+    EngineCapabilityFulfillmentKind["EXTERNAL_PROVIDER"] = "EXTERNAL_PROVIDER";
+    EngineCapabilityFulfillmentKind["PLATFORM_SERVICE"] = "PLATFORM_SERVICE";
+})(EngineCapabilityFulfillmentKind || (EngineCapabilityFulfillmentKind = {}));
+// =====================================================
+// EngineCapability Enum
+// =====================================================
+/**
+ * Engine Capabilities
+ *
+ * Capabilities that applications can declare they need.
+ * Each EngineCapability may map to an ExternalProvider_Capability or a platform service.
+ *
+ * - Managed capabilities: Framework provides standardized interfaces and transformers
+ * - Unmanaged capabilities: Apps use providers directly
+ */
+export var EngineCapability;
+(function (EngineCapability) {
+    // ─────────────────────────────────────────────────────────────
+    // Email Capabilities (Framework-managed, EXTERNAL_PROVIDER)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Transactional email sending - password resets, receipts, notifications.
+     * Standard interface: StandardEmail_SendRequest/Response
+     * Transformer: EmailTransactional_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EngineCapability["EMAIL_TRANSACTIONAL"] = "EMAIL_TRANSACTIONAL";
+    /**
+     * Marketing email campaigns - newsletters, promotions.
+     * Standard interface: StandardMarketing_CampaignRequest/Response
+     * Transformer: EmailMarketing_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EngineCapability["EMAIL_MARKETING"] = "EMAIL_MARKETING";
+    // ─────────────────────────────────────────────────────────────
+    // Maps & Geolocation (NOT Framework-managed, EXTERNAL_PROVIDER)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Maps and geolocation services.
+     * Apps use providers directly (Google Maps, Mapbox, etc.)
+     * Managed: false | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EngineCapability["MAPS_GEOLOCATION"] = "MAPS_GEOLOCATION";
+    // ─────────────────────────────────────────────────────────────
+    // SMS Capabilities (Framework-managed, EXTERNAL_PROVIDER)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * SMS sending - OTP codes, phone verification, notifications.
+     * Standard interface: StandardSMS_SendRequest/Response
+     * Transformer: SMS_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EngineCapability["SMS"] = "SMS";
+    // ─────────────────────────────────────────────────────────────
+    // Billing (Framework-managed, EXTERNAL_PROVIDER)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Billing provider - subscriptions, payments, invoices, metered usage.
+     * Standard interface: StandardBilling_Interface
+     * Transformer: Billing_Transformer
+     * Managed: true | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EngineCapability["BILLING"] = "BILLING";
+    // ─────────────────────────────────────────────────────────────
+    // AI / LLM (NOT Framework-managed, EXTERNAL_PROVIDER — future: also PLATFORM_SERVICE for self-hosted)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * AI/LLM text generation capabilities.
+     * Apps use providers directly through external-connectors LLM protocol.
+     * Managed: false | FulfillmentKinds: [EXTERNAL_PROVIDER]
+     */
+    EngineCapability["AI_LLM"] = "AI_LLM";
+    // ─────────────────────────────────────────────────────────────
+    // Platform Services (primarily PLATFORM_SERVICE, some may also support EXTERNAL_PROVIDER)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Document generation (PDF, DOCX, etc.).
+     * Primarily fulfilled by platform's file-generator service (Gotenberg),
+     * but could also be fulfilled by an external API (e.g., Adobe PDF Services).
+     * Managed: true | FulfillmentKinds: [PLATFORM_SERVICE, EXTERNAL_PROVIDER]
+     */
+    EngineCapability["DOCUMENT_GENERATION"] = "DOCUMENT_GENERATION";
+    /**
+     * Antivirus / malware scanning for uploaded files.
+     * Primarily fulfilled by platform's ClamAV integration,
+     * but could also be fulfilled by an external API (e.g., VirusTotal).
+     * Managed: true | FulfillmentKinds: [PLATFORM_SERVICE, EXTERNAL_PROVIDER]
+     */
+    EngineCapability["ANTIVIRUS_SCANNING"] = "ANTIVIRUS_SCANNING";
+})(EngineCapability || (EngineCapability = {}));
+/**
+ * @deprecated Use `EngineCapability` instead. Kept as alias for migration period.
+ */
+export const PlatformCapability = EngineCapability;
+//# sourceMappingURL=wildo-features.shared.schemas.js.map

package/dist/esm/external-providers/wildo-features.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildo-features.shared.schemas.js","sourceRoot":"","sources":["../../../src/external-providers/wildo-features.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wDAAwD;AACxD,kCAAkC;AAClC,wDAAwD;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,+BAGX;AAHD,WAAY,+BAA+B;IACzC,0EAAuC,CAAA;IACvC,wEAAqC,CAAA;AACvC,CAAC,EAHW,+BAA+B,KAA/B,+BAA+B,QAG1C;AAED,wDAAwD;AACxD,wBAAwB;AACxB,wDAAwD;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,gBAsFX;AAtFD,WAAY,gBAAgB;IAC1B,gEAAgE;IAChE,4DAA4D;IAC5D,gEAAgE;IAEhE;;;;;OAKG;IACH,+DAA2C,CAAA;IAE3C;;;;;OAKG;IACH,uDAAmC,CAAA;IAEnC,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAEhE;;;;OAIG;IACH,yDAAqC,CAAA;IAErC,gEAAgE;IAChE,0DAA0D;IAC1D,gEAAgE;IAEhE;;;;;OAKG;IACH,+BAAW,CAAA;IAEX,gEAAgE;IAChE,iDAAiD;IACjD,gEAAgE;IAEhE;;;;;OAKG;IACH,uCAAmB,CAAA;IAEnB,gEAAgE;IAChE,sGAAsG;IACtG,gEAAgE;IAEhE;;;;OAIG;IACH,qCAAiB,CAAA;IAEjB,gEAAgE;IAChE,0FAA0F;IAC1F,gEAAgE;IAEhE;;;;;OAKG;IACH,+DAA2C,CAAA;IAE3C;;;;;OAKG;IACH,6DAAyC,CAAA;AAC3C,CAAC,EAtFW,gBAAgB,KAAhB,gBAAgB,QAsF3B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC"}

package/dist/esm/features/core-feature-definitions.shared.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Framework Core Feature Definitions
+ *
+ * These are business features managed by the engine (not tied to external providers).
+ * Enabled by config profiles, billing products, or manual admin overrides.
+ *
+ * Note: PRIORITY_SUPPORT, CUSTOM_INTEGRATIONS, ADVANCED_PERMISSIONS from the old CoreOrganizationFeature
+ * enum were dropped:
+ * - PRIORITY_SUPPORT → modeled as a custom app feature (not engine-level)
+ * - CUSTOM_INTEGRATIONS → covered by EngineCapability bindings (external connectors)
+ * - ADVANCED_PERMISSIONS → handled by RBAC system, not feature gating
+ */
+import type { FeatureDefinition } from './feature-definition.shared.schemas.js';
+/**
+ * Core feature definitions: every CoreFeature value + core LIMIT features.
+ * Merged with custom app feature definitions at startup.
+ */
+export declare const CORE_FEATURE_DEFINITIONS: FeatureDefinition[];
+//# sourceMappingURL=core-feature-definitions.shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-feature-definitions.shared.d.ts","sourceRoot":"","sources":["../../../src/features/core-feature-definitions.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAAiB,EA+CvD,CAAC"}

package/dist/esm/features/core-feature-definitions.shared.js

@@ -0,0 +1,69 @@
+/**
+ * Framework Core Feature Definitions
+ *
+ * These are business features managed by the engine (not tied to external providers).
+ * Enabled by config profiles, billing products, or manual admin overrides.
+ *
+ * Note: PRIORITY_SUPPORT, CUSTOM_INTEGRATIONS, ADVANCED_PERMISSIONS from the old CoreOrganizationFeature
+ * enum were dropped:
+ * - PRIORITY_SUPPORT → modeled as a custom app feature (not engine-level)
+ * - CUSTOM_INTEGRATIONS → covered by EngineCapability bindings (external connectors)
+ * - ADVANCED_PERMISSIONS → handled by RBAC system, not feature gating
+ */
+import { CoreFeature } from '../organizations/organization-features.shared.schemas.js';
+import { CoreResourceType } from '../resources/resources.shared.core.definitions.js';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { FeatureValueType } from './feature-definition.shared.schemas.js';
+/**
+ * Core feature definitions: every CoreFeature value + core LIMIT features.
+ * Merged with custom app feature definitions at startup.
+ */
+export const CORE_FEATURE_DEFINITIONS = [
+    // ─── BOOLEAN features (on/off toggles) ───
+    {
+        identifier: CoreFeature.CUSTOM_BRANDING,
+        valueType: FeatureValueType.BOOLEAN,
+        applicableScopes: [ResourcePrimaryScope.ORGANIZATIONS],
+        dependencies: [],
+        defaultValue: false,
+    },
+    {
+        identifier: CoreFeature.ADVANCED_ANALYTICS,
+        valueType: FeatureValueType.BOOLEAN,
+        applicableScopes: [ResourcePrimaryScope.ORGANIZATIONS],
+        dependencies: [],
+        defaultValue: false,
+    },
+    {
+        identifier: CoreFeature.SINGLE_SIGN_ON,
+        valueType: FeatureValueType.BOOLEAN,
+        applicableScopes: [ResourcePrimaryScope.ORGANIZATIONS],
+        dependencies: [],
+        defaultValue: false,
+    },
+    {
+        identifier: CoreFeature.AUDIT_LOGS,
+        valueType: FeatureValueType.BOOLEAN,
+        applicableScopes: [ResourcePrimaryScope.ORGANIZATIONS],
+        dependencies: [],
+        defaultValue: false,
+    },
+    // ─── LIMIT features with counting configs (auto-checked by gate) ───
+    {
+        identifier: 'MAX_MEMBERS',
+        valueType: FeatureValueType.LIMIT,
+        applicableScopes: [ResourcePrimaryScope.ORGANIZATIONS],
+        dependencies: [],
+        defaultValue: 5,
+        counting: { resourceType: CoreResourceType.ORGANIZATION_MEMBERS },
+    },
+    {
+        identifier: 'MAX_API_KEYS',
+        valueType: FeatureValueType.LIMIT,
+        applicableScopes: [ResourcePrimaryScope.ORGANIZATIONS],
+        dependencies: [],
+        defaultValue: 2,
+        counting: { resourceType: CoreResourceType.ORG_API_KEYS },
+    },
+];
+//# sourceMappingURL=core-feature-definitions.shared.js.map

package/dist/esm/features/core-feature-definitions.shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-feature-definitions.shared.js","sourceRoot":"","sources":["../../../src/features/core-feature-definitions.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uDAAuD,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGvE;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IAC3D,4CAA4C;IAC5C;QACE,UAAU,EAAE,WAAW,CAAC,eAAe;QACvC,SAAS,EAAE,gBAAgB,CAAC,OAAO;QACnC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACtD,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,KAAK;KACpB;IACD;QACE,UAAU,EAAE,WAAW,CAAC,kBAAkB;QAC1C,SAAS,EAAE,gBAAgB,CAAC,OAAO;QACnC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACtD,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,KAAK;KACpB;IACD;QACE,UAAU,EAAE,WAAW,CAAC,cAAc;QACtC,SAAS,EAAE,gBAAgB,CAAC,OAAO;QACnC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACtD,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,KAAK;KACpB;IACD;QACE,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,SAAS,EAAE,gBAAgB,CAAC,OAAO;QACnC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACtD,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,KAAK;KACpB;IACD,sEAAsE;IACtE;QACE,UAAU,EAAE,aAAa;QACzB,SAAS,EAAE,gBAAgB,CAAC,KAAK;QACjC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACtD,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,CAAC;QACf,QAAQ,EAAE,EAAE,YAAY,EAAE,gBAAgB,CAAC,oBAAoB,EAAE;KAClE;IACD;QACE,UAAU,EAAE,cAAc;QAC1B,SAAS,EAAE,gBAAgB,CAAC,KAAK;QACjC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACtD,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,CAAC;QACf,QAAQ,EAAE,EAAE,YAAY,EAAE,gBAAgB,CAAC,YAAY,EAAE;KAC1D;CACF,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * Feature Builder Utilities
+ *
+ * DX-oriented builder functions for defining features.
+ * These handle boilerplate: scope normalization, default values, counting config generation.
+ * Custom app developers should use these instead of raw FeatureDefinition objects.
+ */
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { type FeatureDefinition, type FeatureUnavailabilityOverride, type LimitCountingConfig } from './feature-definition.shared.schemas.js';
+/**
+ * Internal marker symbol for limit features that should auto-register
+ * a limitCheck on the counted resource's CREATE operation.
+ * Used by FeatureDefinitionRegistryBackendService at startup.
+ */
+export declare const AUTO_REGISTER_LIMIT_CHECK: unique symbol;
+/**
+ * Extended FeatureDefinition with auto-register metadata.
+ * This is the internal type returned by defineLimitFeature when countResource is provided.
+ */
+export type FeatureDefinitionWithAutoRegister = FeatureDefinition & {
+    [AUTO_REGISTER_LIMIT_CHECK]?: {
+        /** Resource type whose CREATE operation should get a limitCheck for this feature */
+        countResource: string;
+    };
+};
+/**
+ * Simple boolean feature builder.
+ *
+ * @example
+ * defineFeature('AI_ASSISTANT', { scope: ResourcePrimaryScope.ORGANIZATIONS })
+ *
+ * @example
+ * defineFeature('PREMIUM_THEMES', {
+ *   scope: ResourcePrimaryScope.USER_SELF,
+ *   unavailability: {
+ *     behavior: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
+ *   },
+ * })
+ */
+export declare function defineFeature(identifier: string, options: {
+    scope: ResourcePrimaryScope | ResourcePrimaryScope[];
+    defaultEnabled?: boolean;
+    dependencies?: string[];
+    unavailability?: FeatureUnavailabilityOverride;
+}): FeatureDefinition;
+/**
+ * Limit feature builder with auto-wiring support.
+ *
+ * Key DX improvement: when `countResource` is provided, the engine
+ * auto-registers a `limitChecks` entry on the CREATE operation of the
+ * referenced resource at startup (via FeatureDefinitionRegistryBackendService).
+ *
+ * This means: to add "max 10 projects per org", write ONE call and the
+ * gate is automatically enforced. No need to manually add limitChecks on
+ * the resource's operation variant.
+ *
+ * @example
+ * defineLimitFeature('MAX_PROJECTS', {
+ *   scope: ResourcePrimaryScope.ORGANIZATIONS,
+ *   default: 5,
+ *   countResource: CustomShared_ResourceType.PROJECTS,
+ * })
+ * // Equivalent to manually defining:
+ * //   { identifier: 'MAX_PROJECTS', valueType: LIMIT, applicableScopes: [ORGANIZATIONS],
+ * //     defaultValue: 5, counting: { resourceType: 'PROJECTS' } }
+ * //   + adding limitChecks: [{ featureId: 'MAX_PROJECTS' }] on PROJECTS.CREATE variant
+ *
+ * @example
+ * defineLimitFeature('MAX_STORAGE_GB', {
+ *   scope: ResourcePrimaryScope.ORGANIZATIONS,
+ *   default: 10,
+ *   counting: {
+ *     resourceType: 'FILES',
+ *     aggregate: { field: 'sizeBytes', operation: AggregationOperation.SUM },
+ *   },
+ * })
+ */
+export declare function defineLimitFeature(identifier: string, options: {
+    scope: ResourcePrimaryScope | ResourcePrimaryScope[];
+    default: number;
+    /** Resource to count. Auto-registers a limitCheck on CREATE for this resource. */
+    countResource?: string;
+    /** Advanced: filter + aggregation for counting (overrides simple resource count) */
+    counting?: LimitCountingConfig;
+    /** If true, skip auto-registration of limitChecks on the resource's CREATE operation */
+    skipAutoRegister?: boolean;
+    dependencies?: string[];
+    unavailability?: FeatureUnavailabilityOverride;
+}): FeatureDefinitionWithAutoRegister;
+//# sourceMappingURL=feature-builders.shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-builders.shared.d.ts","sourceRoot":"","sources":["../../../src/features/feature-builders.shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAM7C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,eAA0C,CAAC;AAEjF;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,iBAAiB,GAAG;IAClE,CAAC,yBAAyB,CAAC,CAAC,EAAE;QAC5B,oFAAoF;QACpF,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAcF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,6BAA6B,CAAC;CAChD,GACA,iBAAiB,CASnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,6BAA6B,CAAC;CAChD,GACA,iCAAiC,CAwBnC"}

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

@@ -0,0 +1,107 @@
+/**
+ * Feature Builder Utilities
+ *
+ * DX-oriented builder functions for defining features.
+ * These handle boilerplate: scope normalization, default values, counting config generation.
+ * Custom app developers should use these instead of raw FeatureDefinition objects.
+ */
+import { FeatureValueType, } from './feature-definition.shared.schemas.js';
+// =====================================================
+// Internal: Auto-register marker
+// =====================================================
+/**
+ * Internal marker symbol for limit features that should auto-register
+ * a limitCheck on the counted resource's CREATE operation.
+ * Used by FeatureDefinitionRegistryBackendService at startup.
+ */
+export const AUTO_REGISTER_LIMIT_CHECK = Symbol.for('AUTO_REGISTER_LIMIT_CHECK');
+// =====================================================
+// Scope Normalization
+// =====================================================
+function normalizeScopes(scope) {
+    return Array.isArray(scope) ? scope : [scope];
+}
+// =====================================================
+// defineFeature() — Boolean Feature Builder
+// =====================================================
+/**
+ * Simple boolean feature builder.
+ *
+ * @example
+ * defineFeature('AI_ASSISTANT', { scope: ResourcePrimaryScope.ORGANIZATIONS })
+ *
+ * @example
+ * defineFeature('PREMIUM_THEMES', {
+ *   scope: ResourcePrimaryScope.USER_SELF,
+ *   unavailability: {
+ *     behavior: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
+ *   },
+ * })
+ */
+export function defineFeature(identifier, options) {
+    return {
+        identifier,
+        valueType: FeatureValueType.BOOLEAN,
+        applicableScopes: normalizeScopes(options.scope),
+        defaultValue: options.defaultEnabled ?? false,
+        dependencies: options.dependencies ?? [],
+        unavailability: options.unavailability,
+    };
+}
+// =====================================================
+// defineLimitFeature() — Limit Feature Builder
+// =====================================================
+/**
+ * Limit feature builder with auto-wiring support.
+ *
+ * Key DX improvement: when `countResource` is provided, the engine
+ * auto-registers a `limitChecks` entry on the CREATE operation of the
+ * referenced resource at startup (via FeatureDefinitionRegistryBackendService).
+ *
+ * This means: to add "max 10 projects per org", write ONE call and the
+ * gate is automatically enforced. No need to manually add limitChecks on
+ * the resource's operation variant.
+ *
+ * @example
+ * defineLimitFeature('MAX_PROJECTS', {
+ *   scope: ResourcePrimaryScope.ORGANIZATIONS,
+ *   default: 5,
+ *   countResource: CustomShared_ResourceType.PROJECTS,
+ * })
+ * // Equivalent to manually defining:
+ * //   { identifier: 'MAX_PROJECTS', valueType: LIMIT, applicableScopes: [ORGANIZATIONS],
+ * //     defaultValue: 5, counting: { resourceType: 'PROJECTS' } }
+ * //   + adding limitChecks: [{ featureId: 'MAX_PROJECTS' }] on PROJECTS.CREATE variant
+ *
+ * @example
+ * defineLimitFeature('MAX_STORAGE_GB', {
+ *   scope: ResourcePrimaryScope.ORGANIZATIONS,
+ *   default: 10,
+ *   counting: {
+ *     resourceType: 'FILES',
+ *     aggregate: { field: 'sizeBytes', operation: AggregationOperation.SUM },
+ *   },
+ * })
+ */
+export function defineLimitFeature(identifier, options) {
+    // Build counting config: explicit counting takes precedence, then countResource, then nothing
+    const counting = options.counting ??
+        (options.countResource ? { resourceType: options.countResource } : undefined);
+    const definition = {
+        identifier,
+        valueType: FeatureValueType.LIMIT,
+        applicableScopes: normalizeScopes(options.scope),
+        defaultValue: options.default,
+        dependencies: options.dependencies ?? [],
+        counting,
+        unavailability: options.unavailability,
+    };
+    // Add auto-register marker for limit features with countResource (unless skipped)
+    if (options.countResource && !options.skipAutoRegister) {
+        definition[AUTO_REGISTER_LIMIT_CHECK] = {
+            countResource: options.countResource,
+        };
+    }
+    return definition;
+}
+//# sourceMappingURL=feature-builders.shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-builders.shared.js","sourceRoot":"","sources":["../../../src/features/feature-builders.shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,GAKjB,MAAM,qCAAqC,CAAC;AAE7C,wDAAwD;AACxD,iCAAiC;AACjC,wDAAwD;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAajF,wDAAwD;AACxD,sBAAsB;AACtB,wDAAwD;AAExD,SAAS,eAAe,CAAC,KAAoD;IAC3E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,wDAAwD;AACxD,4CAA4C;AAC5C,wDAAwD;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,OAKC;IAED,OAAO;QACL,UAAU;QACV,SAAS,EAAE,gBAAgB,CAAC,OAAO;QACnC,gBAAgB,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;QAChD,YAAY,EAAE,OAAO,CAAC,cAAc,IAAI,KAAK;QAC7C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,+CAA+C;AAC/C,wDAAwD;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,OAWC;IAED,8FAA8F;IAC9F,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;QAChB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhF,MAAM,UAAU,GAAsC;QACpD,UAAU;QACV,SAAS,EAAE,gBAAgB,CAAC,KAAK;QACjC,gBAAgB,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;QAChD,YAAY,EAAE,OAAO,CAAC,OAAO;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,QAAQ;QACR,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;IAEF,kFAAkF;IAClF,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACvD,UAAU,CAAC,yBAAyB,CAAC,GAAG;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}