@synkro/core 0.7.1 → 0.9.0

package/dist/handlers/decorators.d.ts

@@ -0,0 +1,14 @@
+import type { RetryConfig } from "../types.js";
+export declare const ON_EVENT_META: unique symbol;
+export declare const ON_WORKFLOW_STEP_META: unique symbol;
+export type OnEventMetadata = {
+    eventType: string;
+    retry?: RetryConfig;
+};
+export type OnWorkflowStepMetadata = {
+    workflowName: string;
+    stepType: string;
+};
+export declare function OnEvent(eventType: string, retry?: RetryConfig): <T extends Function>(target: T, _context: ClassMethodDecoratorContext) => T;
+export declare function OnWorkflowStep(workflowName: string, stepType: string): <T extends Function>(target: T, _context: ClassMethodDecoratorContext) => T;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/handlers/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/handlers/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,aAAa,eAAgC,CAAC;AAC3D,eAAO,MAAM,qBAAqB,eAAwC,CAAC;AAE3E,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,IAE3C,CAAC,SAAS,QAAQ,EACjC,QAAQ,CAAC,EACT,UAAU,2BAA2B,KACpC,CAAC,CAYL;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAElD,CAAC,SAAS,QAAQ,EACjC,QAAQ,CAAC,EACT,UAAU,2BAA2B,KACpC,CAAC,CAQL"}

package/dist/handlers/decorators.js

@@ -0,0 +1,29 @@
+export const ON_EVENT_META = Symbol.for("synkro:on-event");
+export const ON_WORKFLOW_STEP_META = Symbol.for("synkro:on-workflow-step");
+export function OnEvent(eventType, retry) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    return function (target, _context) {
+        const metadata = { eventType };
+        if (retry !== undefined) {
+            metadata.retry = retry;
+        }
+        Object.defineProperty(target, ON_EVENT_META, {
+            value: metadata,
+            enumerable: false,
+            configurable: true,
+        });
+        return target;
+    };
+}
+export function OnWorkflowStep(workflowName, stepType) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    return function (target, _context) {
+        Object.defineProperty(target, ON_WORKFLOW_STEP_META, {
+            value: { workflowName, stepType },
+            enumerable: false,
+            configurable: true,
+        });
+        return target;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/handlers/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/handlers/decorators.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAY3E,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,KAAmB;IAC5D,sEAAsE;IACtE,OAAO,UACL,MAAS,EACT,QAAqC;QAErC,MAAM,QAAQ,GAAoB,EAAE,SAAS,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE;YAC3C,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,QAAgB;IACnE,sEAAsE;IACtE,OAAO,UACL,MAAS,EACT,QAAqC;QAErC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE;YACnD,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAmC;YAClE,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/handlers/handler-discovery.d.ts

@@ -0,0 +1,14 @@
+import type { HandlerFunction, RetryConfig } from "../types.js";
+export type DiscoveredEventHandler = {
+    eventType: string;
+    handler: HandlerFunction;
+    retry?: RetryConfig;
+};
+export type DiscoveredWorkflowStepHandler = {
+    workflowName: string;
+    stepType: string;
+    handler: HandlerFunction;
+};
+export declare function discoverEventHandlers(instance: object): DiscoveredEventHandler[];
+export declare function discoverWorkflowStepHandlers(instance: object): DiscoveredWorkflowStepHandler[];
+//# sourceMappingURL=handler-discovery.d.ts.map

package/dist/handlers/handler-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-discovery.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-discovery.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AASF,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GACf,sBAAsB,EAAE,CAoB1B;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,GACf,6BAA6B,EAAE,CAsBjC"}

package/dist/handlers/handler-discovery.js

@@ -0,0 +1,38 @@
+import { ON_EVENT_META, ON_WORKFLOW_STEP_META, } from "./decorators.js";
+function getDecoratedMethods(instance) {
+    const proto = Object.getPrototypeOf(instance);
+    return Object.getOwnPropertyNames(proto).filter((name) => name !== "constructor" && typeof proto[name] === "function");
+}
+export function discoverEventHandlers(instance) {
+    const handlers = [];
+    const proto = Object.getPrototypeOf(instance);
+    for (const name of getDecoratedMethods(instance)) {
+        const method = proto[name];
+        const metadata = method[ON_EVENT_META];
+        if (!metadata)
+            continue;
+        handlers.push({
+            eventType: metadata.eventType,
+            handler: method.bind(instance),
+            ...(metadata.retry !== undefined && { retry: metadata.retry }),
+        });
+    }
+    return handlers;
+}
+export function discoverWorkflowStepHandlers(instance) {
+    const handlers = [];
+    const proto = Object.getPrototypeOf(instance);
+    for (const name of getDecoratedMethods(instance)) {
+        const method = proto[name];
+        const metadata = method[ON_WORKFLOW_STEP_META];
+        if (!metadata)
+            continue;
+        handlers.push({
+            workflowName: metadata.workflowName,
+            stepType: metadata.stepType,
+            handler: method.bind(instance),
+        });
+    }
+    return handlers;
+}
+//# sourceMappingURL=handler-discovery.js.map

package/dist/handlers/handler-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-discovery.js","sourceRoot":"","sources":["../../src/handlers/handler-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC;AAezB,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAA4B,CAAC;IACzE,OAAO,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,MAAM,CAC7C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB;IAEhB,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAG3C,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAoB;YACjD,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAgB;IAEhB,MAAM,QAAQ,GAAoC,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAK3C,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,QAAQ,CAAC,IAAI,CAAC;YACZ,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAoB;SAClD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/{handler-registry.d.ts → handlers/handler-registry.d.ts}

@@ -1,9 +1,10 @@
-import type { TransportManager } from "./transport.js";
-import type { EventInfo, EventMetrics, HandlerFunction, PublishFunction, RetryConfig } from "./types.js";
+import type { TransportManager } from "../transport/transport.js";
+import type { EventInfo, EventMetrics, HandlerFunction, PublishFunction, RetryConfig } from "../types.js";
 export declare class HandlerRegistry {
     private redis;
     private handlers;
     private processingLocks;
+    private subscribedChannels;
     private publishFn;
     constructor(redis: TransportManager);
     setPublishFn(fn: PublishFunction): void;
@@ -11,5 +12,8 @@ export declare class HandlerRegistry {
     getRegisteredEvents(): EventInfo[];
     register(eventType: string, handlerFn: HandlerFunction, retry?: RetryConfig): void;
     private handleMessage;
+    private distributedLockKey;
+    private dedupeKey;
+    private executeHandler;
 }
 //# sourceMappingURL=handler-registry.d.ts.map

package/dist/handlers/handler-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAEZ,eAAe,EACf,eAAe,EACf,WAAW,EACZ,MAAM,aAAa,CAAC;AAUrB,qBAAa,eAAe;IAOd,OAAO,CAAC,KAAK;IANzB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,SAAS,CAAgC;gBAE7B,KAAK,EAAE,gBAAgB;IAE3C,YAAY,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIjC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAc/D,mBAAmB,IAAI,SAAS,EAAE;IAWlC,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,eAAe,EAC1B,KAAK,CAAC,EAAE,WAAW,GAClB,IAAI;YAiBO,aAAa;IAuF3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,SAAS;YAIH,cAAc;CAqC7B"}

package/dist/handlers/handler-registry.js

@@ -0,0 +1,141 @@
+import { logger } from "../logger.js";
+const PROCESSING_LOCK_TTL_SECONDS = 300;
+const DEDUPE_TTL_SECONDS = 86400;
+export class HandlerRegistry {
+    redis;
+    handlers = new Map();
+    processingLocks = new Set();
+    subscribedChannels = new Set();
+    publishFn = null;
+    constructor(redis) {
+        this.redis = redis;
+    }
+    setPublishFn(fn) {
+        this.publishFn = fn;
+    }
+    async getEventMetrics(eventType) {
+        const [received, completed, failed] = await Promise.all([
+            this.redis.getCache(`synkro:metrics:${eventType}:received`),
+            this.redis.getCache(`synkro:metrics:${eventType}:completed`),
+            this.redis.getCache(`synkro:metrics:${eventType}:failed`),
+        ]);
+        return {
+            type: eventType,
+            received: Number(received ?? 0),
+            completed: Number(completed ?? 0),
+            failed: Number(failed ?? 0),
+        };
+    }
+    getRegisteredEvents() {
+        return Array.from(this.handlers.entries())
+            .filter(([type]) => !type.startsWith("workflow:"))
+            .flatMap(([type, entries]) => Array.from(entries).map((entry) => ({
+            type,
+            ...(entry.retry && { retry: entry.retry }),
+        })));
+    }
+    register(eventType, handlerFn, retry) {
+        if (!this.handlers.has(eventType)) {
+            this.handlers.set(eventType, new Set());
+        }
+        this.handlers.get(eventType).add({
+            handler: handlerFn,
+            ...(retry && { retry }),
+        });
+        if (!this.subscribedChannels.has(eventType)) {
+            this.subscribedChannels.add(eventType);
+            this.redis.subscribeToChannel(eventType, (message) => {
+                void this.handleMessage(eventType, message);
+            });
+        }
+    }
+    async handleMessage(eventType, message) {
+        const entries = this.handlers.get(eventType);
+        if (!entries || entries.size === 0) {
+            return;
+        }
+        const event = JSON.parse(message);
+        const localLockKey = `${event.requestId}:${eventType}`;
+        if (this.processingLocks.has(localLockKey)) {
+            return;
+        }
+        const dedupeKey = this.dedupeKey(localLockKey);
+        const alreadyProcessed = await this.redis.getCache(dedupeKey);
+        if (alreadyProcessed === "1") {
+            logger.debug(`[HandlerRegistry] duplicate message ignored for "${eventType}" (requestId: ${event.requestId})`);
+            return;
+        }
+        this.processingLocks.add(localLockKey);
+        const distributedLockKey = this.distributedLockKey(localLockKey);
+        let distributedLockAcquired = false;
+        const trackMetrics = !eventType.startsWith("workflow:");
+        try {
+            distributedLockAcquired = await this.redis.setCacheIfNotExists(distributedLockKey, "1", PROCESSING_LOCK_TTL_SECONDS);
+            if (!distributedLockAcquired) {
+                logger.debug(`[HandlerRegistry] in-flight message ignored for "${eventType}" (requestId: ${event.requestId})`);
+                return;
+            }
+            logger.debug(`[HandlerRegistry] handleMessage("${eventType}") entries=${entries.size}`);
+            if (trackMetrics) {
+                await this.redis.incrementCache(`synkro:metrics:${eventType}:received`);
+            }
+            const results = await Promise.allSettled(Array.from(entries).map((entry) => this.executeHandler(eventType, entry, event)));
+            const allSucceeded = results.every((r) => r.status === "fulfilled");
+            if (trackMetrics) {
+                if (allSucceeded) {
+                    await this.redis.incrementCache(`synkro:metrics:${eventType}:completed`);
+                }
+                else {
+                    await this.redis.incrementCache(`synkro:metrics:${eventType}:failed`);
+                }
+            }
+            this.redis.publishMessage(`event:${eventType}:${allSucceeded ? "completed" : "failed"}`, JSON.stringify({
+                requestId: event.requestId,
+                payload: event.payload,
+            }));
+            await this.redis.setCache(dedupeKey, "1", DEDUPE_TTL_SECONDS);
+        }
+        finally {
+            this.processingLocks.delete(localLockKey);
+            if (distributedLockAcquired) {
+                await this.redis.deleteCache(distributedLockKey);
+            }
+        }
+    }
+    distributedLockKey(lockKey) {
+        return `synkro:lock:handler:${lockKey}`;
+    }
+    dedupeKey(lockKey) {
+        return `synkro:dedupe:handler:${lockKey}`;
+    }
+    async executeHandler(eventType, entry, event) {
+        const maxRetries = entry.retry?.maxRetries ?? 0;
+        const ctx = {
+            requestId: event.requestId,
+            payload: event.payload,
+            publish: this.publishFn,
+            setPayload(data) {
+                ctx.payload =
+                    typeof ctx.payload === "object" && ctx.payload !== null
+                        ? { ...ctx.payload, ...data }
+                        : data;
+            },
+        };
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                await entry.handler(ctx);
+                return;
+            }
+            catch (error) {
+                if (attempt < maxRetries) {
+                    logger.warn(`[HandlerRegistry] - Handler "${eventType}" failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying...`);
+                }
+                else {
+                    logger.error(`[HandlerRegistry] - Handler "${eventType}" failed after ${maxRetries + 1} attempt(s): ${error}`);
+                    throw error;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=handler-registry.js.map

package/dist/handlers/handler-registry.js.map

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

package/dist/handlers/index.d.ts

@@ -0,0 +1,4 @@
+export { OnEvent, OnWorkflowStep } from "./decorators.js";
+export { discoverEventHandlers, discoverWorkflowStepHandlers, } from "./handler-discovery.js";
+export { HandlerRegistry } from "./handler-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1,4 @@
+export { OnEvent, OnWorkflowStep } from "./decorators.js";
+export { discoverEventHandlers, discoverWorkflowStepHandlers, } from "./handler-discovery.js";
+export { HandlerRegistry } from "./handler-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -1,16 +1,5 @@
-import type { EventMetrics, HandlerFunction, RetryConfig, SynkroIntrospection, SynkroOptions } from "./types.js";
-export declare class Synkro {
-    private transport;
-    private handlerRegistry;
-    private workflowRegistry;
-    private constructor();
-    static start(options: SynkroOptions): Promise<Synkro>;
-    on(eventType: string, handler: HandlerFunction, retry?: RetryConfig): void;
-    publish(event: string, payload?: unknown, requestId?: string): Promise<string>;
-    getEventMetrics(eventType: string): Promise<EventMetrics>;
-    introspect(): SynkroIntrospection;
-    stop(): Promise<void>;
-}
-export type { TransportManager } from "./transport.js";
+export { Synkro } from "./synkro.js";
+export { OnEvent, OnWorkflowStep } from "./handlers/index.js";
+export type { TransportManager } from "./transport/index.js";
 export type { EventInfo, EventMetrics, HandlerCtx, HandlerFunction, PublishFunction, RetryConfig, SynkroEvent, SynkroIntrospection, SynkroOptions, SynkroWorkflow, SynkroWorkflowStep, WorkflowInfo, WorkflowStepInfo, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,qBAAa,MAAM;IACjB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;IAE3C,OAAO;WAOM,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B3D,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAIpE,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAeZ,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D,UAAU,IAAI,mBAAmB;IAO3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,65 +1,3 @@
-import { randomUUID } from "node:crypto";
-import { HandlerRegistry } from "./handler-registry.js";
-import { InMemoryManager } from "./in-memory.js";
-import { setDebug } from "./logger.js";
-import { RedisManager } from "./redis.js";
-import { WorkflowRegistry } from "./workflow-registry.js";
-export class Synkro {
-    transport;
-    handlerRegistry;
-    workflowRegistry;
-    constructor(transport) {
-        this.transport = transport;
-        this.handlerRegistry = new HandlerRegistry(transport);
-        this.workflowRegistry = new WorkflowRegistry(transport, this.handlerRegistry);
-        this.handlerRegistry.setPublishFn(this.publish.bind(this));
-    }
-    static async start(options) {
-        setDebug(options.debug ?? false);
-        let transport;
-        if (options.transport === "in-memory") {
-            transport = new InMemoryManager();
-        }
-        else {
-            if (!options.connectionUrl) {
-                throw new Error("connectionUrl is required when using Redis transport");
-            }
-            transport = new RedisManager(options.connectionUrl);
-        }
-        const instance = new Synkro(transport);
-        if (options.events) {
-            for (const event of options.events) {
-                instance.on(event.type, event.handler, event.retry);
-            }
-        }
-        if (options.workflows) {
-            instance.workflowRegistry.registerWorkflows(options.workflows);
-        }
-        return instance;
-    }
-    on(eventType, handler, retry) {
-        this.handlerRegistry.register(eventType, handler, retry);
-    }
-    async publish(event, payload, requestId) {
-        requestId = requestId ?? randomUUID();
-        if (this.workflowRegistry.hasWorkflow(event)) {
-            await this.workflowRegistry.startWorkflow(event, requestId, payload);
-            return requestId;
-        }
-        this.transport.publishMessage(event, JSON.stringify({ requestId, payload }));
-        return requestId;
-    }
-    async getEventMetrics(eventType) {
-        return this.handlerRegistry.getEventMetrics(eventType);
-    }
-    introspect() {
-        return {
-            events: this.handlerRegistry.getRegisteredEvents(),
-            workflows: this.workflowRegistry.getRegisteredWorkflows(),
-        };
-    }
-    async stop() {
-        await this.transport.disconnect();
-    }
-}
+export { Synkro } from "./synkro.js";
+export { OnEvent, OnWorkflowStep } from "./handlers/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED,eAAO,MAAM,MAAM;mBACF,OAAO,EAAE,GAAG,IAAI;kBAKjB,OAAO,EAAE,GAAG,IAAI;mBAKf,OAAO,EAAE,GAAG,IAAI;CAGhC,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED,eAAO,MAAM,MAAM;mBACF,OAAO,EAAE,GAAG,IAAI;kBAKjB,OAAO,EAAE,GAAG,IAAI;mBAGf,OAAO,EAAE,GAAG,IAAI;CAGhC,CAAC"}

package/dist/logger.js

@@ -9,9 +9,7 @@ export const logger = {
         }
     },
     warn(...args) {
-        if (debugEnabled) {
-            console.warn(...args);
-        }
+        console.warn(...args);
     },
     error(...args) {
         console.error(...args);

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,YAAY,GAAG,OAAO,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;CACF,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,YAAY,GAAG,OAAO,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;CACF,CAAC"}

package/dist/synkro.d.ts

@@ -0,0 +1,16 @@
+import type { EventMetrics, HandlerFunction, RetryConfig, SynkroIntrospection, SynkroOptions } from "./types.js";
+export declare class Synkro {
+    private transport;
+    private handlerRegistry;
+    private workflowRegistry;
+    private constructor();
+    static start(options: SynkroOptions): Promise<Synkro>;
+    register(...instances: object[]): void;
+    on(eventType: string, handler: HandlerFunction, retry?: RetryConfig): void;
+    publish(event: string, payload?: unknown, requestId?: string): Promise<string>;
+    getEventMetrics(eventType: string): Promise<EventMetrics>;
+    introspect(): SynkroIntrospection;
+    stop(): Promise<void>;
+    private patchWorkflowHandlers;
+}
+//# sourceMappingURL=synkro.d.ts.map

package/dist/synkro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synkro.d.ts","sourceRoot":"","sources":["../src/synkro.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,aAAa,EAEd,MAAM,YAAY,CAAC;AAGpB,qBAAa,MAAM;IACjB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;IAE3C,OAAO;WAOM,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAwC3D,QAAQ,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAYtC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAIpE,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAeZ,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D,UAAU,IAAI,mBAAmB;IAO3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,qBAAqB;CA4B9B"}

package/dist/synkro.js

@@ -0,0 +1,100 @@
+import { randomUUID } from "node:crypto";
+import { HandlerRegistry, discoverEventHandlers, discoverWorkflowStepHandlers, } from "./handlers/index.js";
+import { InMemoryManager, RedisManager } from "./transport/index.js";
+import { setDebug } from "./logger.js";
+import { WorkflowRegistry } from "./workflows/index.js";
+export class Synkro {
+    transport;
+    handlerRegistry;
+    workflowRegistry;
+    constructor(transport) {
+        this.transport = transport;
+        this.handlerRegistry = new HandlerRegistry(transport);
+        this.workflowRegistry = new WorkflowRegistry(transport, this.handlerRegistry);
+        this.handlerRegistry.setPublishFn(this.publish.bind(this));
+    }
+    static async start(options) {
+        setDebug(options.debug ?? false);
+        let transport;
+        if (options.transport === "in-memory") {
+            transport = new InMemoryManager();
+        }
+        else {
+            if (!options.connectionUrl) {
+                throw new Error("connectionUrl is required when using Redis transport");
+            }
+            transport = new RedisManager(options.connectionUrl);
+        }
+        const instance = new Synkro(transport);
+        // Patch decorated workflow step handlers before registering workflows
+        const workflows = options.workflows
+            ? instance.patchWorkflowHandlers(options.workflows, options.handlers ?? [])
+            : [];
+        if (options.events) {
+            for (const event of options.events) {
+                instance.on(event.type, event.handler, event.retry);
+            }
+        }
+        if (workflows.length > 0) {
+            instance.workflowRegistry.registerWorkflows(workflows);
+        }
+        // Register decorated event handlers
+        for (const handlerInstance of options.handlers ?? []) {
+            for (const { eventType, handler, retry } of discoverEventHandlers(handlerInstance)) {
+                instance.on(eventType, handler, retry);
+            }
+        }
+        return instance;
+    }
+    register(...instances) {
+        for (const instance of instances) {
+            for (const { eventType, handler, retry } of discoverEventHandlers(instance)) {
+                this.on(eventType, handler, retry);
+            }
+            for (const { workflowName, stepType, handler } of discoverWorkflowStepHandlers(instance)) {
+                this.workflowRegistry.registerStepHandler(workflowName, stepType, handler);
+            }
+        }
+    }
+    on(eventType, handler, retry) {
+        this.handlerRegistry.register(eventType, handler, retry);
+    }
+    async publish(event, payload, requestId) {
+        requestId = requestId ?? randomUUID();
+        if (this.workflowRegistry.hasWorkflow(event)) {
+            await this.workflowRegistry.startWorkflow(event, requestId, payload);
+            return requestId;
+        }
+        this.transport.publishMessage(event, JSON.stringify({ requestId, payload }));
+        return requestId;
+    }
+    async getEventMetrics(eventType) {
+        return this.handlerRegistry.getEventMetrics(eventType);
+    }
+    introspect() {
+        return {
+            events: this.handlerRegistry.getRegisteredEvents(),
+            workflows: this.workflowRegistry.getRegisteredWorkflows(),
+        };
+    }
+    async stop() {
+        await this.transport.disconnect();
+    }
+    patchWorkflowHandlers(workflows, handlerInstances) {
+        // Collect all decorated workflow step handlers
+        const stepHandlers = handlerInstances.flatMap((instance) => discoverWorkflowStepHandlers(instance));
+        return workflows.map((w) => ({
+            ...w,
+            steps: w.steps.map((s) => {
+                if (s.handler)
+                    return s;
+                const discovered = stepHandlers.find((h) => h.workflowName === w.name && h.stepType === s.type);
+                if (!discovered) {
+                    throw new Error(`Workflow "${w.name}" step "${s.type}" has no handler. Provide an inline handler or use the @OnWorkflowStep decorator.`);
+                }
+                return { ...s, handler: discovered.handler };
+            }),
+        }));
+    }
+}
+//# sourceMappingURL=synkro.js.map

package/dist/synkro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synkro.js","sourceRoot":"","sources":["../src/synkro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAYxD,MAAM,OAAO,MAAM;IACT,SAAS,CAAmB;IAC5B,eAAe,CAAkB;IACjC,gBAAgB,CAAmB;IAE3C,YAAoB,SAA2B;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9E,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAsB;QACvC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;QAEjC,IAAI,SAA2B,CAAC;QAChC,IAAI,OAAO,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;YACtC,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YACD,SAAS,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvC,sEAAsE;QACtE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;YACjC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC3E,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QAED,oCAAoC;QACpC,KAAK,MAAM,eAAe,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACrD,KAAK,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,qBAAqB,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnF,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,CAAC,GAAG,SAAmB;QAC7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,KAAK,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5E,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,KAAK,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,4BAA4B,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzF,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,EAAE,CAAC,SAAiB,EAAE,OAAwB,EAAE,KAAmB;QACjE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAa,EACb,OAAiB,EACjB,SAAkB;QAElB,SAAS,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,cAAc,CAC3B,KAAK,EACL,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CACvC,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAED,UAAU;QACR,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,mBAAmB,EAAE;YAClD,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,EAAE;SAC1D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IAEO,qBAAqB,CAC3B,SAA2B,EAC3B,gBAA0B;QAE1B,+CAA+C;QAC/C,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzD,4BAA4B,CAAC,QAAQ,CAAC,CACvC,CAAC;QAEF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,GAAG,CAAC;YACJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACvB,IAAI,CAAC,CAAC,OAAO;oBAAE,OAAO,CAAC,CAAC;gBAExB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,CAC1D,CAAC;gBAEF,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CACb,aAAa,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,IAAI,mFAAmF,CACxH,CAAC;gBACJ,CAAC;gBAED,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;YAC/C,CAAC,CAAC;SACH,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/{in-memory.d.ts → transport/in-memory.d.ts}

@@ -2,12 +2,16 @@ import type { TransportManager } from "./transport.js";
 export declare class InMemoryManager implements TransportManager {
     private subscriptions;
     private cache;
+    private cacheExpiry;
     publishMessage(channel: string, message: string): void;
     subscribeToChannel(channel: string, callback: (message: string) => void): void;
     getCache(key: string): Promise<string | null>;
-    setCache(key: string, value: string, _ttlSeconds?: number): Promise<void>;
+    setCacheIfNotExists(key: string, value: string, ttlSeconds?: number): Promise<boolean>;
+    setCache(key: string, value: string, ttlSeconds?: number): Promise<void>;
     deleteCache(key: string): Promise<void>;
     incrementCache(key: string): Promise<number>;
     disconnect(): Promise<void>;
+    private evictIfExpired;
+    private applyTtl;
 }
 //# sourceMappingURL=in-memory.d.ts.map

package/dist/transport/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/transport/in-memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,aAAa,CAAqD;IAC1E,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAA6B;IAEhD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWtD,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,IAAI;IAQD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK7C,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;IAWb,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAKV,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,QAAQ;CAQjB"}