@etohq/utils 1.5.1-alpha.4 → 1.5.1-alpha.5

package/dist/dev-server/handlers/subscriber-handler.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriberHandler = void 0;
+class SubscriberHandler {
+    constructor() {
+        this.type = "subscriber";
+    }
+    validate(data) {
+        if (!data.id) {
+            throw new Error(`Subscriber registration requires id. Received: ${JSON.stringify(data)}`);
+        }
+        if (!data.sourcePath) {
+            throw new Error(`Subscriber registration requires sourcePath. Received: ${JSON.stringify(data)}`);
+        }
+        if (!data.subscriberId) {
+            throw new Error(`Subscriber registration requires subscriberId. Received: ${JSON.stringify(data)}`);
+        }
+        if (!data.events) {
+            throw new Error(`Subscriber registration requires events. Received: ${JSON.stringify(data)}`);
+        }
+        if (!Array.isArray(data.events)) {
+            throw new Error(`Subscriber registration requires events to be an array. Received: ${JSON.stringify(data)}`);
+        }
+    }
+    resolveSourcePath(data) {
+        return data.sourcePath;
+    }
+    createEntry(data) {
+        return {
+            id: data.id,
+            subscriberId: data.subscriberId,
+            events: data.events,
+        };
+    }
+    getInverseKey(data) {
+        return `${this.type}:${data.subscriberId}`;
+    }
+}
+exports.SubscriberHandler = SubscriberHandler;
+//# sourceMappingURL=subscriber-handler.js.map

package/dist/dev-server/handlers/subscriber-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-handler.js","sourceRoot":"","sources":["../../../src/dev-server/handlers/subscriber-handler.ts"],"names":[],"mappings":";;;AAMA,MAAa,iBAAiB;IAA9B;QAGW,SAAI,GAAG,YAAY,CAAA;IAyD9B,CAAC;IAvDC,QAAQ,CAAC,IAA4B;QACnC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kDAAkD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CACzE,CAAA;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0DAA0D,IAAI,CAAC,SAAS,CACtE,IAAI,CACL,EAAE,CACJ,CAAA;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,4DAA4D,IAAI,CAAC,SAAS,CACxE,IAAI,CACL,EAAE,CACJ,CAAA;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,sDAAsD,IAAI,CAAC,SAAS,CAClE,IAAI,CACL,EAAE,CACJ,CAAA;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,qEAAqE,IAAI,CAAC,SAAS,CACjF,IAAI,CACL,EAAE,CACJ,CAAA;QACH,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,IAA4B;QAC5C,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,WAAW,CAAC,IAA4B;QACtC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAA;IACH,CAAC;IAED,aAAa,CAAC,IAA4B;QACxC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAA;IAC5C,CAAC;CACF;AA5DD,8CA4DC"}

package/dist/dev-server/handlers/workflow-handler.d.ts

@@ -0,0 +1,9 @@
+import { ResourceEntry, ResourceTypeHandler, WorkflowResourceData } from "../types";
+export declare class WorkflowHandler implements ResourceTypeHandler<WorkflowResourceData> {
+    readonly type = "workflow";
+    validate(data: WorkflowResourceData): void;
+    resolveSourcePath(data: WorkflowResourceData): string;
+    createEntry(data: WorkflowResourceData): ResourceEntry;
+    getInverseKey(data: WorkflowResourceData): string;
+}
+//# sourceMappingURL=workflow-handler.d.ts.map

package/dist/dev-server/handlers/workflow-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-handler.d.ts","sourceRoot":"","sources":["../../../src/dev-server/handlers/workflow-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AAEjB,qBAAa,eACX,YAAW,mBAAmB,CAAC,oBAAoB,CAAC;IAEpD,QAAQ,CAAC,IAAI,cAAa;IAE1B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAgB1C,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM;IAIrD,WAAW,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa;IAOtD,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM;CAGlD"}

package/dist/dev-server/handlers/workflow-handler.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowHandler = void 0;
+class WorkflowHandler {
+    constructor() {
+        this.type = "workflow";
+    }
+    validate(data) {
+        if (!data.sourcePath) {
+            throw new Error(`Workflow registration requires sourcePath. Received: ${JSON.stringify(data)}`);
+        }
+        if (!data.id) {
+            throw new Error(`Workflow registration requires id. Received: ${JSON.stringify(data)}`);
+        }
+    }
+    resolveSourcePath(data) {
+        return data.sourcePath;
+    }
+    createEntry(data) {
+        return {
+            id: data.id,
+            workflowId: data.id,
+        };
+    }
+    getInverseKey(data) {
+        return `${this.type}:${data.id}`;
+    }
+}
+exports.WorkflowHandler = WorkflowHandler;
+//# sourceMappingURL=workflow-handler.js.map

package/dist/dev-server/handlers/workflow-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-handler.js","sourceRoot":"","sources":["../../../src/dev-server/handlers/workflow-handler.ts"],"names":[],"mappings":";;;AAMA,MAAa,eAAe;IAA5B;QAGW,SAAI,GAAG,UAAU,CAAA;IAgC5B,CAAC;IA9BC,QAAQ,CAAC,IAA0B;QACjC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,wDAAwD,IAAI,CAAC,SAAS,CACpE,IAAI,CACL,EAAE,CACJ,CAAA;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,gDAAgD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CACvE,CAAA;QACH,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,IAA0B;QAC1C,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,WAAW,CAAC,IAA0B;QACpC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,UAAU,EAAE,IAAI,CAAC,EAAE;SACpB,CAAA;IACH,CAAC;IAED,aAAa,CAAC,IAA0B;QACtC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAA;IAClC,CAAC;CACF;AAnCD,0CAmCC"}

package/dist/dev-server/index.d.ts

@@ -0,0 +1,8 @@
+import { BaseResourceData, ResourceMap, ResourceRegistrationData, ResourceTypeHandler } from "./types";
+export type { BaseResourceData, ResourceEntry, ResourceMap, ResourcePath, ResourceType, ResourceTypeHandler, } from "./types";
+export declare const globalDevServerRegistry: Map<string, ResourceMap>;
+export declare const inverseDevServerRegistry: Map<string, string[]>;
+export declare function registerResourceTypeHandler(handler: ResourceTypeHandler): void;
+export declare function registerDevServerResource(data: ResourceRegistrationData): void;
+export declare function registerDevServerResource<T extends BaseResourceData>(data: T): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/dev-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev-server/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,WAAW,EAEX,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,uBAAuB,0BAAuC,CAAA;AAC3E,eAAO,MAAM,wBAAwB,uBAA0C,CAAA;AAI/E,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CAQN;AAOD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAAA;AAC/E,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,gBAAgB,EAClE,IAAI,EAAE,CAAC,GACN,IAAI,CAAA"}

package/dist/dev-server/index.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inverseDevServerRegistry = exports.globalDevServerRegistry = void 0;
+exports.registerResourceTypeHandler = registerResourceTypeHandler;
+exports.registerDevServerResource = registerDevServerResource;
+const feature_flags_1 = require("../feature-flags");
+const job_handler_1 = require("./handlers/job-handler");
+const step_handler_1 = require("./handlers/step-handler");
+const subscriber_handler_1 = require("./handlers/subscriber-handler");
+const workflow_handler_1 = require("./handlers/workflow-handler");
+const registry_helpers_1 = require("./registry-helpers");
+exports.globalDevServerRegistry = new Map();
+exports.inverseDevServerRegistry = new Map();
+const resourceHandlers = new Map();
+function registerResourceTypeHandler(handler) {
+    if (resourceHandlers.has(handler.type)) {
+        console.warn(`Resource type handler for "${handler.type}" is being overridden`);
+    }
+    resourceHandlers.set(handler.type, handler);
+}
+registerResourceTypeHandler(new workflow_handler_1.WorkflowHandler());
+registerResourceTypeHandler(new step_handler_1.StepHandler(exports.inverseDevServerRegistry));
+registerResourceTypeHandler(new subscriber_handler_1.SubscriberHandler());
+registerResourceTypeHandler(new job_handler_1.JobHandler());
+function registerDevServerResource(data) {
+    const isProduction = ["production", "prod"].includes(process.env.NODE_ENV || "");
+    if (!feature_flags_1.FeatureFlag.isFeatureEnabled("backend_hmr") || isProduction) {
+        return;
+    }
+    const handler = resourceHandlers.get(data.type);
+    if (!handler) {
+        throw new Error(`No handler registered for resource type "${data.type}". ` +
+            `Available types: ${Array.from(resourceHandlers.keys()).join(", ")}. ` +
+            `Use registerResourceTypeHandler() to add support for custom types.`);
+    }
+    try {
+        handler.validate(data);
+        const sourcePath = handler.resolveSourcePath(data);
+        const registry = (0, registry_helpers_1.getOrCreateRegistry)(exports.globalDevServerRegistry, sourcePath);
+        const entry = handler.createEntry(data);
+        (0, registry_helpers_1.addToRegistry)(registry, data.type, entry);
+        const inverseKey = handler.getInverseKey(data);
+        (0, registry_helpers_1.addToInverseRegistry)(exports.inverseDevServerRegistry, inverseKey, sourcePath);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to register ${data.type} resource "${data.id}": ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/dev-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev-server/index.ts"],"names":[],"mappings":";;;AAgCA,kEAUC;AAWD,8DAsCC;AA3FD,oDAA8C;AAC9C,wDAAmD;AACnD,0DAAqD;AACrD,sEAAiE;AACjE,kEAA6D;AAC7D,yDAI2B;AAkBd,QAAA,uBAAuB,GAAG,IAAI,GAAG,EAA6B,CAAA;AAC9D,QAAA,wBAAwB,GAAG,IAAI,GAAG,EAAgC,CAAA;AAE/E,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA+B,CAAA;AAE/D,SAAgB,2BAA2B,CACzC,OAA4B;IAE5B,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CACV,8BAA8B,OAAO,CAAC,IAAI,uBAAuB,CAClE,CAAA;IACH,CAAC;IAED,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED,2BAA2B,CAAC,IAAI,kCAAe,EAAE,CAAC,CAAA;AAClD,2BAA2B,CAAC,IAAI,0BAAW,CAAC,gCAAwB,CAAC,CAAC,CAAA;AACtE,2BAA2B,CAAC,IAAI,sCAAiB,EAAE,CAAC,CAAA;AACpD,2BAA2B,CAAC,IAAI,wBAAU,EAAE,CAAC,CAAA;AAM7C,SAAgB,yBAAyB,CACvC,IAAO;IAEP,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,QAAQ,CAClD,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAC3B,CAAA;IAED,IAAI,CAAC,2BAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,IAAI,YAAY,EAAE,CAAC;QACjE,OAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,IAAI,KAAK;YACxD,oBAAoB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACtE,oEAAoE,CACvE,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEtB,MAAM,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,QAAQ,GAAG,IAAA,sCAAmB,EAAC,+BAAuB,EAAE,UAAU,CAAC,CAAA;QACzE,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAEvC,IAAA,gCAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAEzC,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAA,uCAAoB,EAAC,gCAAwB,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3E,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,MAAM,YAAY,EAAE,CACzE,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/dev-server/registry-helpers.d.ts

@@ -0,0 +1,5 @@
+import { ResourceEntry, ResourceMap, ResourcePath } from "./types";
+export declare function getOrCreateRegistry(globalRegistry: Map<ResourcePath, ResourceMap>, sourcePath: string): ResourceMap;
+export declare function addToRegistry(registry: ResourceMap, type: string, entry: ResourceEntry): void;
+export declare function addToInverseRegistry(inverseRegistry: Map<string, string[]>, key: string, sourcePath: string): void;
+//# sourceMappingURL=registry-helpers.d.ts.map

package/dist/dev-server/registry-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-helpers.d.ts","sourceRoot":"","sources":["../../src/dev-server/registry-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAA;AAEhF,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,EAC9C,UAAU,EAAE,MAAM,GACjB,WAAW,CASb;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,GACnB,IAAI,CAGN;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACtC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN"}

package/dist/dev-server/registry-helpers.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrCreateRegistry = getOrCreateRegistry;
+exports.addToRegistry = addToRegistry;
+exports.addToInverseRegistry = addToInverseRegistry;
+function getOrCreateRegistry(globalRegistry, sourcePath) {
+    let registry = globalRegistry.get(sourcePath);
+    if (!registry) {
+        registry = new Map();
+        globalRegistry.set(sourcePath, registry);
+    }
+    return registry;
+}
+function addToRegistry(registry, type, entry) {
+    const entries = registry.get(type) || [];
+    registry.set(type, [...entries, entry]);
+}
+function addToInverseRegistry(inverseRegistry, key, sourcePath) {
+    const existing = inverseRegistry.get(key) || [];
+    const updated = Array.from(new Set([...existing, sourcePath]));
+    inverseRegistry.set(key, updated);
+}
+//# sourceMappingURL=registry-helpers.js.map

package/dist/dev-server/registry-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-helpers.js","sourceRoot":"","sources":["../../src/dev-server/registry-helpers.ts"],"names":[],"mappings":";;AAEA,kDAYC;AAED,sCAOC;AAED,oDAQC;AA/BD,SAAgB,mBAAmB,CACjC,cAA8C,EAC9C,UAAkB;IAElB,IAAI,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAA;QACnD,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAgB,aAAa,CAC3B,QAAqB,EACrB,IAAY,EACZ,KAAoB;IAEpB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IACxC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;AACzC,CAAC;AAED,SAAgB,oBAAoB,CAClC,eAAsC,EACtC,GAAW,EACX,UAAkB;IAElB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IAC9D,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AACnC,CAAC"}

package/dist/dev-server/types.d.ts

@@ -0,0 +1,44 @@
+export type ResourcePath = string;
+export type ResourceType = string;
+export type ResourceEntry = {
+    id: string;
+    workflowId?: string;
+    [key: string]: unknown;
+};
+export type ResourceMap = Map<ResourceType, ResourceEntry[]>;
+export interface BaseResourceData {
+    type: string;
+    id: string;
+    sourcePath?: string;
+}
+export interface WorkflowResourceData extends BaseResourceData {
+    type: "workflow";
+    sourcePath: string;
+}
+export interface StepResourceData extends BaseResourceData {
+    type: "step";
+    workflowId?: string;
+    sourcePath?: string;
+}
+export interface SubscriberResourceData extends BaseResourceData {
+    type: "subscriber";
+    sourcePath: string;
+    subscriberId: string;
+    events: string[];
+}
+export interface JobResourceData extends BaseResourceData {
+    type: "job";
+    sourcePath: string;
+    config: {
+        name: string;
+    };
+}
+export type ResourceRegistrationData = WorkflowResourceData | StepResourceData | SubscriberResourceData | JobResourceData;
+export interface ResourceTypeHandler<T extends BaseResourceData = BaseResourceData> {
+    readonly type: string;
+    validate(data: T): void;
+    resolveSourcePath(data: T): string;
+    createEntry(data: T): ResourceEntry;
+    getInverseKey(data: T): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/dev-server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dev-server/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AACjC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,CAAC,CAAA;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,IAAI,EAAE,UAAU,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,IAAI,EAAE,YAAY,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,IAAI,EAAE,KAAK,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AAED,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,gBAAgB,GAChB,sBAAsB,GACtB,eAAe,CAAA;AAEnB,MAAM,WAAW,mBAAmB,CAClC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAE7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IAEvB,iBAAiB,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAA;IAElC,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAA;IAEnC,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAA;CAC/B"}

package/dist/dev-server/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/dev-server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dev-server/types.ts"],"names":[],"mappings":""}

package/dist/event-bus/index.d.ts

@@ -1,12 +1,15 @@
-import { EventBusTypes, InternalModuleDeclaration } from "@etohq/types";
+import { EventBusTypes, InterceptorSubscriber, InternalModuleDeclaration } from "@etohq/types";
 export declare abstract class AbstractEventBusModuleService implements EventBusTypes.IEventBusModuleService {
     protected isWorkerMode: boolean;
     protected eventToSubscribersMap_: Map<string | symbol, EventBusTypes.SubscriberDescriptor[]>;
+    protected interceptorSubscribers_: Set<InterceptorSubscriber>;
     get eventToSubscribersMap(): Map<string | symbol, EventBusTypes.SubscriberDescriptor[]>;
     protected constructor(cradle: Record<string, unknown>, moduleOptions: {} | undefined, moduleDeclaration: InternalModuleDeclaration);
     abstract emit<T>(data: EventBusTypes.Message<T> | EventBusTypes.Message<T>[], options: Record<string, unknown>): Promise<void>;
     abstract releaseGroupedEvents(eventGroupId: string): Promise<void>;
-    abstract clearGroupedEvents(eventGroupId: string): Promise<void>;
+    abstract clearGroupedEvents(eventGroupId: string, options?: {
+        eventNames?: string[];
+    }): Promise<void>;
     protected storeSubscribers({ event, subscriberId, subscriber, }: {
         event: string | symbol;
         subscriberId: string;
@@ -14,6 +17,12 @@ export declare abstract class AbstractEventBusModuleService implements EventBusT
     }): void;
     subscribe(eventName: string | symbol, subscriber: EventBusTypes.Subscriber, context?: EventBusTypes.SubscriberContext): this;
     unsubscribe(eventName: string | symbol, subscriber: EventBusTypes.Subscriber, context?: EventBusTypes.SubscriberContext): this;
+    addInterceptor(interceptor: InterceptorSubscriber): this;
+    removeInterceptor(interceptor: InterceptorSubscriber): this;
+    protected callInterceptors<T = unknown>(message: EventBusTypes.Message<T>, context?: {
+        isGrouped?: boolean;
+        eventGroupId?: string;
+    }): Promise<void>;
 }
 export * from "./build-event-messages";
 export * from "./common-events";

package/dist/event-bus/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-bus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAGvE,8BAAsB,6BACpB,YAAW,aAAa,CAAC,sBAAsB;IAE/C,SAAS,CAAC,YAAY,EAAE,OAAO,CAAO;IAEtC,SAAS,CAAC,sBAAsB,EAAE,GAAG,CACnC,MAAM,GAAG,MAAM,EACf,aAAa,CAAC,oBAAoB,EAAE,CACrC,CAAY;IAEb,IAAW,qBAAqB,IAAI,GAAG,CACrC,MAAM,GAAG,MAAM,EACf,aAAa,CAAC,oBAAoB,EAAE,CACrC,CAEA;IAED,SAAS,aACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,gBAAK,EAClB,iBAAiB,EAAE,yBAAyB;IAK9C,QAAQ,CAAC,IAAI,CAAC,CAAC,EACb,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAC3D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAQhB,QAAQ,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE,QAAQ,CAAC,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE,SAAS,CAAC,gBAAgB,CAAC,EACzB,KAAK,EACL,YAAY,EACZ,UAAU,GACX,EAAE;QACD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;QACtB,YAAY,EAAE,MAAM,CAAA;QACpB,UAAU,EAAE,aAAa,CAAC,UAAU,CAAA;KACrC;IAmBM,SAAS,CACd,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,EACpC,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,GACxC,IAAI;IA2BP,WAAW,CACT,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,EACpC,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,GACxC,IAAI;CAuBR;AAED,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-bus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,cAAc,CAAA;AAGrB,8BAAsB,6BACpB,YAAW,aAAa,CAAC,sBAAsB;IAE/C,SAAS,CAAC,YAAY,EAAE,OAAO,CAAO;IAEtC,SAAS,CAAC,sBAAsB,EAAE,GAAG,CACnC,MAAM,GAAG,MAAM,EACf,aAAa,CAAC,oBAAoB,EAAE,CACrC,CAAY;IAEb,SAAS,CAAC,uBAAuB,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAY;IAEzE,IAAW,qBAAqB,IAAI,GAAG,CACrC,MAAM,GAAG,MAAM,EACf,aAAa,CAAC,oBAAoB,EAAE,CACrC,CAEA;IAED,SAAS,aACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,gBAAK,EAClB,iBAAiB,EAAE,yBAAyB;IAK9C,QAAQ,CAAC,IAAI,CAAC,CAAC,EACb,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAC3D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAQhB,QAAQ,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGlE,QAAQ,CAAC,kBAAkB,CACzB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KACtB,GACA,OAAO,CAAC,IAAI,CAAC;IAEhB,SAAS,CAAC,gBAAgB,CAAC,EACzB,KAAK,EACL,YAAY,EACZ,UAAU,GACX,EAAE;QACD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;QACtB,YAAY,EAAE,MAAM,CAAA;QACpB,UAAU,EAAE,aAAa,CAAC,UAAU,CAAA;KACrC;IAmBM,SAAS,CACd,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,EACpC,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,GACxC,IAAI;IA2BP,WAAW,CACT,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,EACpC,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,GACxC,IAAI;IAwBA,cAAc,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI;IAKxD,iBAAiB,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI;cAKlD,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,IAAI,CAAC;CASjB;AAED,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,SAAS,CAAA"}

package/dist/event-bus/index.js

@@ -23,6 +23,7 @@ class AbstractEventBusModuleService {
     constructor(cradle, moduleOptions = {}, moduleDeclaration) {
         this.isWorkerMode = true;
         this.eventToSubscribersMap_ = new Map();
+        this.interceptorSubscribers_ = new Set();
         this.isWorkerMode = moduleDeclaration.worker_mode !== "server";
     }
     storeSubscribers({ event, subscriberId, subscriber, }) {
@@ -74,6 +75,24 @@ class AbstractEventBusModuleService {
         }
         return this;
     }
+    addInterceptor(interceptor) {
+        this.interceptorSubscribers_.add(interceptor);
+        return this;
+    }
+    removeInterceptor(interceptor) {
+        this.interceptorSubscribers_.delete(interceptor);
+        return this;
+    }
+    async callInterceptors(message, context) {
+        Array.from(this.interceptorSubscribers_).map(async (interceptor) => {
+            try {
+                await interceptor(message, context);
+            }
+            catch (error) {
+                console.error("Error in event bus interceptor:", error);
+            }
+        });
+    }
 }
 exports.AbstractEventBusModuleService = AbstractEventBusModuleService;
 __exportStar(require("./build-event-messages"), exports);

package/dist/event-bus/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event-bus/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,+BAA2B;AAE3B,MAAsB,6BAA6B;IAUjD,IAAW,qBAAqB;QAI9B,OAAO,IAAI,CAAC,sBAAsB,CAAA;IACpC,CAAC;IAED,YACE,MAA+B,EAC/B,aAAa,GAAG,EAAE,EAClB,iBAA4C;QAjBpC,iBAAY,GAAY,IAAI,CAAA;QAE5B,2BAAsB,GAG5B,IAAI,GAAG,EAAE,CAAA;QAcX,IAAI,CAAC,YAAY,GAAG,iBAAiB,CAAC,WAAW,KAAK,QAAQ,CAAA;IAChE,CAAC;IAiBS,gBAAgB,CAAC,EACzB,KAAK,EACL,YAAY,EACZ,UAAU,GAKX;QACC,MAAM,uBAAuB,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,CAAA;QAEhE,MAAM,mBAAmB,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QAExE,MAAM,uBAAuB,GAAG,mBAAmB,CAAC,IAAI,CACtD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,YAAY,CACjC,CAAA;QAED,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC,sBAAsB,YAAY,iBAAiB,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE;YACrC,GAAG,mBAAmB;YACtB,uBAAuB;SACxB,CAAC,CAAA;IACJ,CAAC;IAEM,SAAS,CACd,SAA0B,EAC1B,UAAoC,EACpC,OAAyC;QAEzC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAClD,CAAC;QACD;;;WAGG;QAEH,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;QAClC,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,GAAG,KAAK,IAAI,IAAA,WAAI,GAAE,EAAE,CAEjE;QAAC,UAAkB,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhD,IAAI,CAAC,gBAAgB,CAAC;YACpB,KAAK;YACL,YAAY;YACZ,UAAU;SACX,CAAC,CAAA;QAEF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,WAAW,CACT,SAA0B,EAC1B,UAAoC,EACpC,OAAyC;QAEzC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACtE,MAAM,YAAY,GAChB,OAAO,EAAE,YAAY,IAAK,UAAkB,CAAC,YAAY,CAAA;QAE3D,IAAI,mBAAmB,EAAE,MAAM,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,SAAS,CAC7C,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,YAAY,CACjC,CAAA;YAED,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,sBAAsB;qBACxB,GAAG,CAAC,SAAS,CAAC;oBACf,EAAE,MAAM,CAAC,QAAkB,EAAE,CAAC,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AA7HD,sEA6HC;AAED,yDAAsC;AACtC,kDAA+B;AAC/B,uDAAoC;AACpC,0CAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event-bus/index.ts"],"names":[],"mappings":"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"}

package/dist/feature-flags/discover-and-register-feature-flags.d.ts

@@ -0,0 +1,15 @@
+import { Logger } from "@etohq/types";
+import { FlagRouter } from "./flag-router";
+export interface DiscoverAndRegisterOptions {
+    flagDir: string;
+    projectConfigFlags?: Record<string, any>;
+    router: FlagRouter;
+    logger?: Logger;
+    track?: (key: string) => void;
+    maxDepth?: number;
+}
+/**
+ * Utility function to discover and register feature flags from a directory
+ */
+export declare function discoverAndRegisterFeatureFlags(options: DiscoverAndRegisterOptions): Promise<void>;
+//# sourceMappingURL=discover-and-register-feature-flags.d.ts.map

package/dist/feature-flags/discover-and-register-feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-and-register-feature-flags.d.ts","sourceRoot":"","sources":["../../src/feature-flags/discover-and-register-feature-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/feature-flags/discover-and-register-feature-flags.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverAndRegisterFeatureFlags = discoverAndRegisterFeatureFlags;
+const discover_feature_flags_1 = require("./discover-feature-flags");
+const register_flag_1 = require("./register-flag");
+/**
+ * Utility function to discover and register feature flags from a directory
+ */
+async function discoverAndRegisterFeatureFlags(options) {
+    const { flagDir, projectConfigFlags = {}, router, logger, track, maxDepth, } = options;
+    const discovered = await (0, discover_feature_flags_1.discoverFeatureFlagsFromDir)(flagDir, maxDepth);
+    for (const def of discovered) {
+        const registerOptions = {
+            flag: def,
+            projectConfigFlags,
+            router,
+            logger,
+            track,
+        };
+        (0, register_flag_1.registerFeatureFlag)(registerOptions);
+    }
+}
+//# sourceMappingURL=discover-and-register-feature-flags.js.map

package/dist/feature-flags/discover-and-register-feature-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-and-register-feature-flags.js","sourceRoot":"","sources":["../../src/feature-flags/discover-and-register-feature-flags.ts"],"names":[],"mappings":";;AAiBA,0EAyBC;AAzCD,qEAAsE;AAEtE,mDAAqD;AAWrD;;GAEG;AACI,KAAK,UAAU,+BAA+B,CACnD,OAAmC;IAEnC,MAAM,EACJ,OAAO,EACP,kBAAkB,GAAG,EAAE,EACvB,MAAM,EACN,MAAM,EACN,KAAK,EACL,QAAQ,GACT,GAAG,OAAO,CAAA;IAEX,MAAM,UAAU,GAAG,MAAM,IAAA,oDAA2B,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAEvE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,eAAe,GAA8C;YACjE,IAAI,EAAE,GAAmB;YACzB,kBAAkB;YAClB,MAAM;YACN,MAAM;YACN,KAAK;SACN,CAAA;QAED,IAAA,mCAAmB,EAAC,eAAe,CAAC,CAAA;IACtC,CAAC;AACH,CAAC"}

package/dist/feature-flags/discover-feature-flags.d.ts

@@ -0,0 +1,6 @@
+import { FlagSettings } from "@etohq/types";
+/**
+ * Discover feature flag definitions from a directory and subdirectories
+ */
+export declare function discoverFeatureFlagsFromDir(sourcePath?: string, maxDepth?: number): Promise<FlagSettings[]>;
+//# sourceMappingURL=discover-feature-flags.d.ts.map

package/dist/feature-flags/discover-feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-feature-flags.d.ts","sourceRoot":"","sources":["../../src/feature-flags/discover-feature-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAa3C;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAkDzB"}

package/dist/feature-flags/discover-feature-flags.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverFeatureFlagsFromDir = discoverFeatureFlagsFromDir;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const common_1 = require("../common");
+const excludedFiles = ["index.js", "index.ts"];
+const excludedExtensions = [".d.ts", ".d.ts.map", ".js.map"];
+function isFeatureFlag(flag) {
+    const f = flag;
+    return !!f && (0, common_1.isString)(f.key) && (0, common_1.isString)(f.env_key);
+}
+/**
+ * Discover feature flag definitions from a directory and subdirectories
+ */
+async function discoverFeatureFlagsFromDir(sourcePath, maxDepth = 2) {
+    if (!sourcePath) {
+        return [];
+    }
+    const root = (0, path_1.normalize)(sourcePath);
+    const discovered = [];
+    const allEntries = await (0, common_1.readDirRecursive)(root, {
+        ignoreMissing: true,
+        maxDepth,
+    });
+    const featureFlagDirs = allEntries
+        .filter((e) => e.isDirectory() && e.name === "feature-flags")
+        .map((e) => (0, path_1.join)(e.path, e.name));
+    if (!featureFlagDirs.length) {
+        return discovered;
+    }
+    await Promise.all(featureFlagDirs.map(async (scanDir) => {
+        const entries = await (0, promises_1.readdir)(scanDir, { withFileTypes: true });
+        await Promise.all(entries.map(async (entry) => {
+            if (entry.isDirectory()) {
+                return;
+            }
+            if (excludedExtensions.some((ext) => entry.name.endsWith(ext)) ||
+                excludedFiles.includes(entry.name)) {
+                return;
+            }
+            const fileExports = await (0, common_1.dynamicImport)((0, path_1.join)(scanDir, entry.name));
+            const values = Object.values(fileExports);
+            for (const value of values) {
+                if (isFeatureFlag(value)) {
+                    discovered.push(value);
+                }
+            }
+        }));
+    }));
+    return discovered;
+}
+//# sourceMappingURL=discover-feature-flags.js.map

package/dist/feature-flags/discover-feature-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-feature-flags.js","sourceRoot":"","sources":["../../src/feature-flags/discover-feature-flags.ts"],"names":[],"mappings":";;AAgBA,kEAqDC;AApED,0CAAqC;AACrC,+BAAsC;AACtC,sCAAqE;AAErE,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAC9C,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;AAE5D,SAAS,aAAa,CAAC,IAAa;IAClC,MAAM,CAAC,GAAG,IAAW,CAAA;IACrB,OAAO,CAAC,CAAC,CAAC,IAAI,IAAA,iBAAQ,EAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAA,iBAAQ,EAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AACtD,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,2BAA2B,CAC/C,UAAmB,EACnB,WAAmB,CAAC;IAEpB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,gBAAS,EAAC,UAAU,CAAC,CAAA;IAClC,MAAM,UAAU,GAAmB,EAAE,CAAA;IAErC,MAAM,UAAU,GAAG,MAAM,IAAA,yBAAgB,EAAC,IAAI,EAAE;QAC9C,aAAa,EAAE,IAAI;QACnB,QAAQ;KACT,CAAC,CAAA;IAEF,MAAM,eAAe,GAAG,UAAU;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,WAAI,EAAE,CAAS,CAAC,IAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAEtD,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CACf,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/D,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAM;YACR,CAAC;YAED,IACE,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC1D,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAClC,CAAC;gBACD,OAAM;YACR,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,IAAA,sBAAa,EAAC,IAAA,WAAI,EAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;YAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;YACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACxB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CACH,CAAA;IACH,CAAC,CAAC,CACH,CAAA;IAED,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/feature-flags/flag-router.d.ts

@@ -0,0 +1,33 @@
+import { FeatureFlagTypes } from "@etohq/types";
+export declare class FlagRouter implements FeatureFlagTypes.IFlagRouter {
+    private readonly flags;
+    constructor(flags: Record<string, boolean | Record<string, boolean>>);
+    /**
+     * Check if a feature flag is enabled.
+     * There are two ways of using this method:
+     * 1. `isFeatureEnabled("myFeatureFlag")`
+     * 2. `isFeatureEnabled({ myNestedFeatureFlag: "someNestedFlag" })`
+     * We use 1. for top-level feature flags and 2. for nested feature flags. Almost all flags are top-level.
+     * An example of a nested flag is workflows. To use it, you would do:
+     * `isFeatureEnabled({ workflows: Workflows.CreateCart })`
+     * @param flag - The flag to check
+     * @return {boolean} - Whether the flag is enabled or not
+     */
+    isFeatureEnabled(flag: string | string[] | Record<string, string>): boolean;
+    /**
+     * Sets a feature flag.
+     * Flags take two shapes:
+     * `setFlag("myFeatureFlag", true)`
+     * `setFlag("myFeatureFlag", { nestedFlag: true })`
+     * These shapes are used for top-level and nested flags respectively, as explained in isFeatureEnabled.
+     * @param key - The key of the flag to set.
+     * @param value - The value of the flag to set.
+     * @return {void} - void
+     */
+    setFlag(key: string, value: boolean | {
+        [key: string]: boolean;
+    }): void;
+    listFlags(): FeatureFlagTypes.FeatureFlagsResponse;
+}
+export declare const FeatureFlag: FlagRouter;
+//# sourceMappingURL=flag-router.d.ts.map

package/dist/feature-flags/flag-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-router.d.ts","sourceRoot":"","sources":["../../src/feature-flags/flag-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,qBAAa,UAAW,YAAW,gBAAgB,CAAC,WAAW;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwD;gBAElE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIpE;;;;;;;;;;OAUG;IACI,gBAAgB,CACrB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/C,OAAO;IAkBV;;;;;;;;;OASG;IACI,OAAO,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAC1C,IAAI;IAgBA,SAAS,IAAI,gBAAgB,CAAC,oBAAoB;CAM1D;AAED,eAAO,MAAM,WAAW,YAAqB,CAAA"}

package/dist/feature-flags/flag-router.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlag = exports.FlagRouter = void 0;
+const common_1 = require("../common");
+class FlagRouter {
+    constructor(flags) {
+        this.flags = {};
+        this.flags = flags;
+    }
+    /**
+     * Check if a feature flag is enabled.
+     * There are two ways of using this method:
+     * 1. `isFeatureEnabled("myFeatureFlag")`
+     * 2. `isFeatureEnabled({ myNestedFeatureFlag: "someNestedFlag" })`
+     * We use 1. for top-level feature flags and 2. for nested feature flags. Almost all flags are top-level.
+     * An example of a nested flag is workflows. To use it, you would do:
+     * `isFeatureEnabled({ workflows: Workflows.CreateCart })`
+     * @param flag - The flag to check
+     * @return {boolean} - Whether the flag is enabled or not
+     */
+    isFeatureEnabled(flag) {
+        if ((0, common_1.isObject)(flag)) {
+            const [nestedFlag, value] = Object.entries(flag)[0];
+            if (typeof this.flags[nestedFlag] === "boolean") {
+                return this.flags[nestedFlag];
+            }
+            return !!this.flags[nestedFlag]?.[value];
+        }
+        const flags = (Array.isArray(flag) ? flag : [flag]);
+        return flags.every((flag_) => {
+            if (!(0, common_1.isString)(flag_)) {
+                throw Error("Flag must be a string an array of string or an object");
+            }
+            return !!this.flags[flag_];
+        });
+    }
+    /**
+     * Sets a feature flag.
+     * Flags take two shapes:
+     * `setFlag("myFeatureFlag", true)`
+     * `setFlag("myFeatureFlag", { nestedFlag: true })`
+     * These shapes are used for top-level and nested flags respectively, as explained in isFeatureEnabled.
+     * @param key - The key of the flag to set.
+     * @param value - The value of the flag to set.
+     * @return {void} - void
+     */
+    setFlag(key, value) {
+        if ((0, common_1.isObject)(value)) {
+            const existing = this.flags[key];
+            if (!existing) {
+                this.flags[key] = value;
+                return;
+            }
+            this.flags[key] = { ...this.flags[key], ...value };
+            return;
+        }
+        this.flags[key] = value;
+    }
+    listFlags() {
+        return Object.entries(this.flags || {}).map(([key, value]) => ({
+            key,
+            value,
+        }));
+    }
+}
+exports.FlagRouter = FlagRouter;
+exports.FeatureFlag = new FlagRouter({});
+//# sourceMappingURL=flag-router.js.map

package/dist/feature-flags/flag-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-router.js","sourceRoot":"","sources":["../../src/feature-flags/flag-router.ts"],"names":[],"mappings":";;;AACA,sCAA8C;AAE9C,MAAa,UAAU;IAGrB,YAAY,KAAwD;QAFnD,UAAK,GAAsD,EAAE,CAAA;QAG5E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED;;;;;;;;;;OAUG;IACI,gBAAgB,CACrB,IAAgD;QAEhD,IAAI,IAAA,iBAAQ,EAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACnD,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAY,CAAA;YAC1C,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAa,CAAA;QAC/D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3B,IAAI,CAAC,IAAA,iBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,CAAC,uDAAuD,CAAC,CAAA;YACtE,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;OASG;IACI,OAAO,CACZ,GAAW,EACX,KAA2C;QAE3C,IAAI,IAAA,iBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAEhC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;gBACvB,OAAM;YACR,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,EAAE,GAAG,KAAK,EAAE,CAAA;YAC9D,OAAM;QACR,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACzB,CAAC;IAEM,SAAS;QACd,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,GAAG;YACH,KAAK;SACN,CAAC,CAAC,CAAA;IACL,CAAC;CACF;AAzED,gCAyEC;AAEY,QAAA,WAAW,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA"}

package/dist/feature-flags/index.d.ts

@@ -2,4 +2,6 @@ export * from "./analytics";
 export * from "./publishable-api-keys";
 export * from "./utils";
 export * from "./workflows";
+import { FlagRouter } from "./utils";
+export declare const FeatureFlag: FlagRouter;
 //# sourceMappingURL=index.d.ts.map

package/dist/feature-flags/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feature-flags/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feature-flags/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpC,eAAO,MAAM,WAAW,YAAqB,CAAA"}

package/dist/feature-flags/index.js

@@ -14,8 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlag = void 0;
 __exportStar(require("./analytics"), exports);
 __exportStar(require("./publishable-api-keys"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./workflows"), exports);
+const utils_1 = require("./utils");
+exports.FeatureFlag = new utils_1.FlagRouter({});
 //# sourceMappingURL=index.js.map

package/dist/feature-flags/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feature-flags/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,yDAAsC;AACtC,0CAAuB;AACvB,8CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feature-flags/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,yDAAsC;AACtC,0CAAuB;AACvB,8CAA2B;AAE3B,mCAAoC;AAEvB,QAAA,WAAW,GAAG,IAAI,kBAAU,CAAC,EAAE,CAAC,CAAA"}