@synkro/core 0.15.1 → 0.17.0

package/README.md

@@ -17,6 +17,7 @@ Lightweight workflow and state machine orchestrator. Define event-driven workflo
 - **Workflow Cancellation** — Cancel running workflows programmatically
 - **Handler Unsubscribe** — Remove event handlers at runtime with `off()`
 - **Typed Payloads** — Generic `HandlerCtx<T>` for compile-time payload safety
+- **Event Versioning** — Versioned event types with automatic base-event fanout
 - **Simple API** — Single `Synkro` class with minimal configuration
 - **TypeScript** — Full type support out of the box
 
@@ -274,6 +275,40 @@ schemas: {
 }
 ```
 
+### Event Versioning
+
+Versioned event types follow the `base:event:vN` convention. When a versioned event is published, it is automatically delivered to both the versioned channel and the base channel:
+
+```ts
+// Handler on the base event receives ALL versions (catch-all)
+synkro.on("user:created", async (ctx) => {
+  console.log("Any version:", ctx.payload);
+});
+
+// Handler on a specific version receives only that version
+synkro.on("user:created:v2", async (ctx) => {
+  console.log("V2 only:", ctx.payload);
+});
+
+// Publishing a versioned event delivers to both handlers above
+await synkro.publish("user:created:v2", { name: "Alice", role: "admin" });
+
+// Publishing an unversioned event delivers only to the base handler
+await synkro.publish("user:created", { name: "Bob" });
+```
+
+Utility exports for working with versioned event types:
+
+```ts
+import { parseEventType, isVersionedEvent } from "@synkro/core";
+
+parseEventType("user:created:v2");
+// { base: "user:created", version: 2, raw: "user:created:v2" }
+
+isVersionedEvent("user:created:v2"); // true
+isVersionedEvent("user:created");    // false
+```
+
 ## API
 
 ### `Synkro.start(options): Promise<Synkro>`
@@ -306,7 +341,7 @@ synkro.on("StockUpdate", async (ctx) => {
 
 ### `synkro.publish(event, payload?, requestId?): Promise<string>`
 
-Publishes an event or starts a workflow. Returns a `requestId` for correlation. A UUID is generated by default, but you can provide your own ID.
+Publishes an event or starts a workflow. Returns a `requestId` for correlation. A UUID is generated by default, but you can provide your own ID. When the event type is versioned (e.g., `user:created:v2`), the event is also delivered to the base channel (`user:created`).
 
 ```ts
 // Auto-generated UUID
@@ -314,6 +349,9 @@ const id = await synkro.publish("UserSignedUp", { email: "user@example.com" });
 
 // Custom request ID
 const id = await synkro.publish("UserSignedUp", { email: "user@example.com" }, "my-custom-id");
+
+// Versioned event — delivers to both "user:created:v2" and "user:created" channels
+const id = await synkro.publish("user:created:v2", { name: "Alice" });
 ```
 
 ### `ctx.publish(event, payload?, requestId?): Promise<string>`

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

@@ -1,6 +1,6 @@
 import { Logger } from "../logger.js";
 import type { TransportManager } from "../transport/transport.js";
-import type { HandlerFunction, PublishFunction, RetentionConfig, RetryConfig, SchemaValidator } from "../types.js";
+import type { EventFilter, HandlerFunction, PublishFunction, RetentionConfig, RetryConfig, SchemaValidator } from "../types.js";
 export type ExecuteHandlerOptions = {
     transport: TransportManager;
     eventType: string;
@@ -10,8 +10,10 @@ export type ExecuteHandlerOptions = {
     publishFn: PublishFunction;
     retry?: RetryConfig;
     schema?: SchemaValidator;
+    filter?: EventFilter;
     retention?: RetentionConfig;
     trackMetrics?: boolean;
+    dlqEnabled?: boolean;
     logger?: Logger;
 };
 export type ExecuteHandlerResult = {

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

@@ -1 +1 @@
-{"version":3,"file":"handler-execution.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAEV,eAAe,EACf,eAAe,EACf,eAAe,EAEf,WAAW,EACX,eAAe,EAChB,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AA6BF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyIlG"}
+{"version":3,"file":"handler-execution.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAEV,WAAW,EAEX,eAAe,EACf,eAAe,EACf,eAAe,EAEf,WAAW,EACX,eAAe,EAChB,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AA6BF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmLlG"}

package/dist/handlers/handler-execution.js

@@ -28,7 +28,15 @@ function serializeError(err) {
  * route handlers) where persistent subscriptions are not available.
  */
 export async function executeHandler(options) {
-    const { transport, eventType, requestId, payload, handler, publishFn, retry, schema, retention, trackMetrics = !eventType.startsWith("workflow:"), logger = new Logger(), } = options;
+    const { transport, eventType, requestId, payload, handler, publishFn, retry, schema, filter, retention, trackMetrics = !eventType.startsWith("workflow:"), logger = new Logger(), } = options;
+    // Apply filter before any locking/dedup work
+    if (filter && !filter(payload)) {
+        logger.debug("[executeHandler] Handler filtered out", {
+            eventType,
+            requestId,
+        });
+        return { success: true };
+    }
     const lockTtl = retention?.lockTtl ?? DEFAULT_LOCK_TTL;
     const dedupTtl = retention?.dedupTtl ?? DEFAULT_DEDUPE_TTL;
     const metricsTtl = retention?.metricsTtl;
@@ -38,13 +46,19 @@ export async function executeHandler(options) {
     // Check dedup
     const alreadyProcessed = await transport.getCache(dedupeKey);
     if (alreadyProcessed === "1") {
-        logger.debug(`[executeHandler] duplicate message ignored for "${eventType}" (requestId: ${requestId})`);
+        logger.debug("[executeHandler] Duplicate message ignored", {
+            eventType,
+            requestId,
+        });
         return { success: true };
     }
     // Acquire distributed lock
     const lockAcquired = await transport.setCacheIfNotExists(distributedLockKey, "1", lockTtl);
     if (!lockAcquired) {
-        logger.debug(`[executeHandler] in-flight message ignored for "${eventType}" (requestId: ${requestId})`);
+        logger.debug("[executeHandler] In-flight message ignored", {
+            eventType,
+            requestId,
+        });
         return { success: true };
     }
     try {
@@ -81,11 +95,23 @@ export async function executeHandler(options) {
                 const isRetryable = retry?.retryable ? retry.retryable(error) : true;
                 if (attempt < maxRetries && isRetryable) {
                     const delay = computeRetryDelay(attempt, retry?.backoff, retry?.delayMs, retry?.jitter);
-                    logger.warn(`[executeHandler] - Handler "${eventType}" failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms...`);
+                    logger.warn("[executeHandler] Handler failed, retrying", {
+                        eventType,
+                        requestId,
+                        attempt: attempt + 1,
+                        maxAttempts: maxRetries + 1,
+                        delayMs: delay,
+                    });
                     await sleep(delay);
                 }
                 else {
-                    logger.error(`[executeHandler] - Handler "${eventType}" failed after ${attempt + 1} attempt(s): ${error}`);
+                    logger.error("[executeHandler] Handler failed", {
+                        eventType,
+                        requestId,
+                        attempt: attempt + 1,
+                        maxAttempts: maxRetries + 1,
+                        error: String(error),
+                    });
                 }
             }
         }
@@ -103,10 +129,27 @@ export async function executeHandler(options) {
             requestId,
             payload: ctx.payload,
         };
-        if (!success) {
-            eventPayload.errors = [serializeError(lastError)];
+        const errors = !success ? [serializeError(lastError)] : undefined;
+        if (errors) {
+            eventPayload.errors = errors;
         }
         await transport.publishMessage(`event:${eventType}:${success ? "completed" : "failed"}`, JSON.stringify(eventPayload));
+        // Push to dead letter queue on failure
+        if (!success && options.dlqEnabled && trackMetrics) {
+            const dlqItem = {
+                eventType,
+                requestId,
+                payload,
+                errors: errors,
+                failedAt: new Date().toISOString(),
+                attempts: (retry?.maxRetries ?? 0) + 1,
+            };
+            await transport.pushToList(`synkro:dlq:${eventType}`, JSON.stringify(dlqItem));
+            logger.debug("[executeHandler] Event pushed to DLQ", {
+                eventType,
+                requestId,
+            });
+        }
         // Mark as processed
         await transport.setCache(dedupeKey, "1", dedupTtl);
         if (!success) {

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

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

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

@@ -1,9 +1,10 @@
 import { Logger } from "../logger.js";
 import type { TransportManager } from "../transport/transport.js";
-import type { EventInfo, EventMetrics, HandlerFunction, PublishFunction, RetentionConfig, RetryConfig, SchemaValidator } from "../types.js";
+import type { EventFilter, EventInfo, EventMetrics, HandlerFunction, PublishFunction, RetentionConfig, RetryConfig, SchemaValidator } from "../types.js";
 export declare class HandlerRegistry {
     private redis;
     private readonly logger;
+    private readonly dlqEnabled;
     private handlers;
     private processingLocks;
     private subscribedChannels;
@@ -12,14 +13,14 @@ export declare class HandlerRegistry {
     private readonly lockTtl;
     private readonly dedupTtl;
     private readonly metricsTtl;
-    constructor(redis: TransportManager, retention?: RetentionConfig, logger?: Logger);
+    constructor(redis: TransportManager, retention?: RetentionConfig, logger?: Logger, dlqEnabled?: boolean);
     get activeCount(): number;
     setPublishFn(fn: PublishFunction): void;
     registerSchema(eventType: string, schema: SchemaValidator): void;
     getSchema(eventType: string): SchemaValidator | undefined;
     getEventMetrics(eventType: string): Promise<EventMetrics>;
     getRegisteredEvents(): EventInfo[];
-    register(eventType: string, handlerFn: HandlerFunction, retry?: RetryConfig, schema?: SchemaValidator): void;
+    register(eventType: string, handlerFn: HandlerFunction, retry?: RetryConfig, schema?: SchemaValidator, filter?: EventFilter): void;
     unregister(eventType: string, handlerFn?: HandlerFunction): void;
     private handleMessage;
     private distributedLockKey;

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

@@ -1 +1 @@
-{"version":3,"file":"handler-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAEZ,eAAe,EACf,eAAe,EACf,eAAe,EAEf,WAAW,EACX,eAAe,EAChB,MAAM,aAAa,CAAC;AAwCrB,qBAAa,eAAe;IAYxB,OAAO,CAAC,KAAK;IAEb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,OAAO,CAAsC;IAErD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAGtC,KAAK,EAAE,gBAAgB,EAC/B,SAAS,CAAC,EAAE,eAAe,EACV,MAAM,GAAE,MAAqB;IAOhD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,YAAY,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIvC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAIhE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD,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,EACnB,MAAM,CAAC,EAAE,eAAe,GACvB,IAAI;IAkBP,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI;YAwBlD,aAAa;IA+H3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,SAAS;YAIH,cAAc;CAoD7B"}
+{"version":3,"file":"handler-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAEV,WAAW,EACX,SAAS,EACT,YAAY,EAEZ,eAAe,EACf,eAAe,EACf,eAAe,EAEf,WAAW,EACX,eAAe,EAChB,MAAM,aAAa,CAAC;AAyCrB,qBAAa,eAAe;IAYxB,OAAO,CAAC,KAAK;IAEb,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAd7B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,OAAO,CAAsC;IAErD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAGtC,KAAK,EAAE,gBAAgB,EAC/B,SAAS,CAAC,EAAE,eAAe,EACV,MAAM,GAAE,MAAqB,EAC7B,UAAU,GAAE,OAAe;IAO9C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,YAAY,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIvC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAIhE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD,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,EACnB,MAAM,CAAC,EAAE,eAAe,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,IAAI;IAmBP,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI;YAwBlD,aAAa;IA4K3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,SAAS;YAIH,cAAc;CA4D7B"}

package/dist/handlers/handler-registry.js

@@ -22,6 +22,7 @@ const DEFAULT_DEDUPE_TTL = 86400;
 export class HandlerRegistry {
     redis;
     logger;
+    dlqEnabled;
     handlers = new Map();
     processingLocks = new Set();
     subscribedChannels = new Set();
@@ -30,9 +31,10 @@ export class HandlerRegistry {
     lockTtl;
     dedupTtl;
     metricsTtl;
-    constructor(redis, retention, logger = new Logger()) {
+    constructor(redis, retention, logger = new Logger(), dlqEnabled = false) {
         this.redis = redis;
         this.logger = logger;
+        this.dlqEnabled = dlqEnabled;
         this.lockTtl = retention?.lockTtl ?? DEFAULT_LOCK_TTL;
         this.dedupTtl = retention?.dedupTtl ?? DEFAULT_DEDUPE_TTL;
         this.metricsTtl = retention?.metricsTtl;
@@ -70,7 +72,7 @@ export class HandlerRegistry {
             ...(entry.retry && { retry: entry.retry }),
         })));
     }
-    register(eventType, handlerFn, retry, schema) {
+    register(eventType, handlerFn, retry, schema, filter) {
         if (!this.handlers.has(eventType)) {
             this.handlers.set(eventType, new Set());
         }
@@ -78,6 +80,7 @@ export class HandlerRegistry {
             handler: handlerFn,
             ...(retry && { retry }),
             ...(schema && { schema }),
+            ...(filter && { filter }),
         });
         if (!this.subscribedChannels.has(eventType)) {
             this.subscribedChannels.add(eventType);
@@ -119,11 +122,16 @@ export class HandlerRegistry {
             event = JSON.parse(message);
         }
         catch {
-            this.logger.error(`[HandlerRegistry] - Malformed message on "${eventType}", dropping: ${message}`);
+            this.logger.error("[HandlerRegistry] Malformed message, dropping", {
+                eventType,
+                message,
+            });
             return;
         }
         if (!event.requestId || typeof event.requestId !== "string") {
-            this.logger.error(`[HandlerRegistry] - Missing or invalid requestId on "${eventType}", dropping message`);
+            this.logger.error("[HandlerRegistry] Missing or invalid requestId, dropping message", {
+                eventType,
+            });
             return;
         }
         const globalSchema = this.schemas.get(eventType);
@@ -132,7 +140,11 @@ export class HandlerRegistry {
                 globalSchema(event.payload);
             }
             catch (err) {
-                this.logger.error(`[HandlerRegistry] - Schema validation failed for "${eventType}" (requestId: ${event.requestId}): ${err}`);
+                this.logger.error("[HandlerRegistry] Schema validation failed", {
+                    eventType,
+                    requestId: event.requestId,
+                    error: String(err),
+                });
                 return;
             }
         }
@@ -143,12 +155,17 @@ export class HandlerRegistry {
         const dedupeKey = this.dedupeKey(localLockKey);
         const alreadyProcessed = await this.redis.getCache(dedupeKey);
         if (alreadyProcessed === "1") {
-            this.logger.debug(`[HandlerRegistry] duplicate message ignored for "${eventType}" (requestId: ${event.requestId})`);
+            this.logger.debug("[HandlerRegistry] Duplicate message ignored", {
+                eventType,
+                requestId: event.requestId,
+            });
             return;
         }
         this.processingLocks.add(localLockKey);
         if (this.processingLocks.size > 1000) {
-            this.logger.warn(`[HandlerRegistry] - processingLocks size exceeded 1000 (current: ${this.processingLocks.size})`);
+            this.logger.warn("[HandlerRegistry] processingLocks size exceeded 1000", {
+                size: this.processingLocks.size,
+            });
         }
         const distributedLockKey = this.distributedLockKey(localLockKey);
         let distributedLockAcquired = false;
@@ -156,14 +173,31 @@ export class HandlerRegistry {
         try {
             distributedLockAcquired = await this.redis.setCacheIfNotExists(distributedLockKey, "1", this.lockTtl);
             if (!distributedLockAcquired) {
-                this.logger.debug(`[HandlerRegistry] in-flight message ignored for "${eventType}" (requestId: ${event.requestId})`);
+                this.logger.debug("[HandlerRegistry] In-flight message ignored", {
+                    eventType,
+                    requestId: event.requestId,
+                });
                 return;
             }
-            this.logger.debug(`[HandlerRegistry] handleMessage("${eventType}") entries=${entries.size}`);
+            // Apply filters — only execute entries whose filter passes (or has no filter)
+            const eligibleEntries = Array.from(entries).filter((entry) => !entry.filter || entry.filter(event.payload));
+            if (eligibleEntries.length === 0) {
+                this.logger.debug("[HandlerRegistry] All handlers filtered out", {
+                    eventType,
+                    requestId: event.requestId,
+                    totalEntries: entries.size,
+                });
+                return;
+            }
+            this.logger.debug("[HandlerRegistry] handleMessage", {
+                eventType,
+                requestId: event.requestId,
+                entries: eligibleEntries.length,
+            });
             if (trackMetrics) {
                 await this.redis.incrementCache(`synkro:metrics:${eventType}:received`, this.metricsTtl);
             }
-            const results = await Promise.allSettled(Array.from(entries).map((entry) => this.executeHandler(eventType, entry, event)));
+            const results = await Promise.allSettled(eligibleEntries.map((entry) => this.executeHandler(eventType, entry, event)));
             const allSucceeded = results.every((r) => r.status === "fulfilled");
             if (trackMetrics) {
                 if (allSucceeded) {
@@ -177,12 +211,31 @@ export class HandlerRegistry {
                 requestId: event.requestId,
                 payload: event.payload,
             };
-            if (!allSucceeded) {
-                eventPayload.errors = results
+            const errors = !allSucceeded
+                ? results
                     .filter((r) => r.status === "rejected")
-                    .map((r) => serializeError(r.reason));
+                    .map((r) => serializeError(r.reason))
+                : undefined;
+            if (errors) {
+                eventPayload.errors = errors;
             }
             await this.redis.publishMessage(`event:${eventType}:${allSucceeded ? "completed" : "failed"}`, JSON.stringify(eventPayload));
+            // Push to dead letter queue on failure
+            if (!allSucceeded && this.dlqEnabled && trackMetrics) {
+                const dlqItem = {
+                    eventType,
+                    requestId: event.requestId,
+                    payload: event.payload,
+                    errors: errors,
+                    failedAt: new Date().toISOString(),
+                    attempts: Math.max(...eligibleEntries.map((e) => (e.retry?.maxRetries ?? 0) + 1)),
+                };
+                await this.redis.pushToList(`synkro:dlq:${eventType}`, JSON.stringify(dlqItem));
+                this.logger.debug("[HandlerRegistry] Event pushed to DLQ", {
+                    eventType,
+                    requestId: event.requestId,
+                });
+            }
             await this.redis.setCache(dedupeKey, "1", this.dedupTtl);
         }
         finally {
@@ -225,11 +278,23 @@ export class HandlerRegistry {
                     : true;
                 if (attempt < maxRetries && isRetryable) {
                     const delay = computeRetryDelay(attempt, entry.retry?.backoff, entry.retry?.delayMs, entry.retry?.jitter);
-                    this.logger.warn(`[HandlerRegistry] - Handler "${eventType}" failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms...`);
+                    this.logger.warn("[HandlerRegistry] Handler failed, retrying", {
+                        eventType,
+                        requestId: event.requestId,
+                        attempt: attempt + 1,
+                        maxAttempts: maxRetries + 1,
+                        delayMs: delay,
+                    });
                     await sleep(delay);
                 }
                 else {
-                    this.logger.error(`[HandlerRegistry] - Handler "${eventType}" failed after ${attempt + 1} attempt(s): ${error}`);
+                    this.logger.error("[HandlerRegistry] Handler failed", {
+                        eventType,
+                        requestId: event.requestId,
+                        attempt: attempt + 1,
+                        maxAttempts: maxRetries + 1,
+                        error: String(error),
+                    });
                     throw error;
                 }
             }

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

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

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { Synkro } from "./synkro.js";
 export { Logger } from "./logger.js";
 export { OnEvent, OnWorkflowStep, executeHandler } from "./handlers/index.js";
+export { parseEventType, isVersionedEvent } from "./versioning.js";
+export type { ParsedEventType } from "./versioning.js";
 export type { ExecuteHandlerOptions, ExecuteHandlerResult } from "./handlers/index.js";
 export type { TransportManager } from "./transport/index.js";
-export type { EventInfo, EventMetrics, HandlerCtx, HandlerFunction, PublishFunction, RetentionConfig, RetryBackoffStrategy, RetryConfig, SchemaValidator, SynkroEvent, SynkroIntrospection, SynkroOptions, SynkroWorkflow, SynkroWorkflowStep, WorkflowInfo, WorkflowStepInfo, } from "./types.js";
+export type { DeadLetterItem, EventFilter, EventInfo, EventMetrics, LogFormat, HandlerCtx, HandlerFunction, PublishFunction, RetentionConfig, RetryBackoffStrategy, RetryConfig, SchemaValidator, SynkroEvent, SynkroIntrospection, SynkroOptions, SynkroWorkflow, SynkroWorkflowStep, WorkflowInfo, WorkflowStepInfo, } from "./types.js";
 export type { WorkflowState } from "./workflows/index.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":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,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,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,UAAU,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { Synkro } from "./synkro.js";
 export { Logger } from "./logger.js";
 export { OnEvent, OnWorkflowStep, executeHandler } from "./handlers/index.js";
+export { parseEventType, isVersionedEvent } from "./versioning.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/logger.d.ts

@@ -1,14 +1,17 @@
+import type { LogFormat } from "./types.js";
 export declare class Logger {
     private debugEnabled;
-    constructor(debugEnabled?: boolean);
-    debug(...args: unknown[]): void;
-    warn(...args: unknown[]): void;
-    error(...args: unknown[]): void;
+    private format;
+    constructor(debugEnabled?: boolean, format?: LogFormat);
+    debug(msg: string, fields?: Record<string, unknown>): void;
+    warn(msg: string, fields?: Record<string, unknown>): void;
+    error(msg: string, fields?: Record<string, unknown>): void;
+    private output;
 }
 export declare function setDebug(enabled: boolean): void;
 export declare const logger: {
-    debug(...args: unknown[]): void;
-    warn(...args: unknown[]): void;
-    error(...args: unknown[]): void;
+    debug(msg: string, fields?: Record<string, unknown>): void;
+    warn(msg: string, fields?: Record<string, unknown>): void;
+    error(msg: string, fields?: Record<string, unknown>): void;
 };
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IACL,OAAO,CAAC,YAAY;gBAAZ,YAAY,GAAE,OAAe;IAEjD,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGhC;AAID,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"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,MAAM;IAEf,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;gBADN,YAAY,GAAE,OAAe,EAC7B,MAAM,GAAE,SAAkB;IAGpC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK1D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIzD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI1D,OAAO,CAAC,MAAM;CAsBf;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED,eAAO,MAAM,MAAM;eACN,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;cAShD,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;eAO9C,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAO3D,CAAC"}

package/dist/logger.js

@@ -1,18 +1,41 @@
 export class Logger {
     debugEnabled;
-    constructor(debugEnabled = false) {
+    format;
+    constructor(debugEnabled = false, format = "text") {
         this.debugEnabled = debugEnabled;
+        this.format = format;
     }
-    debug(...args) {
-        if (this.debugEnabled) {
-            console.log(...args);
-        }
+    debug(msg, fields) {
+        if (!this.debugEnabled)
+            return;
+        this.output("debug", msg, fields);
+    }
+    warn(msg, fields) {
+        this.output("warn", msg, fields);
     }
-    warn(...args) {
-        console.warn(...args);
+    error(msg, fields) {
+        this.output("error", msg, fields);
     }
-    error(...args) {
-        console.error(...args);
+    output(level, msg, fields) {
+        if (this.format === "json") {
+            const entry = { level, msg, ...fields, timestamp: new Date().toISOString() };
+            const line = JSON.stringify(entry);
+            if (level === "error")
+                console.error(line);
+            else if (level === "warn")
+                console.warn(line);
+            else
+                console.log(line);
+            return;
+        }
+        // Text mode
+        const fn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;
+        if (fields && Object.keys(fields).length > 0) {
+            fn(msg, fields);
+        }
+        else {
+            fn(msg);
+        }
     }
 }
 let debugEnabled = false;
@@ -20,16 +43,31 @@ export function setDebug(enabled) {
     debugEnabled = enabled;
 }
 export const logger = {
-    debug(...args) {
+    debug(msg, fields) {
         if (debugEnabled) {
-            console.log(...args);
+            if (fields && Object.keys(fields).length > 0) {
+                console.log(msg, fields);
+            }
+            else {
+                console.log(msg);
+            }
         }
     },
-    warn(...args) {
-        console.warn(...args);
+    warn(msg, fields) {
+        if (fields && Object.keys(fields).length > 0) {
+            console.warn(msg, fields);
+        }
+        else {
+            console.warn(msg);
+        }
     },
-    error(...args) {
-        console.error(...args);
+    error(msg, fields) {
+        if (fields && Object.keys(fields).length > 0) {
+            console.error(msg, fields);
+        }
+        else {
+            console.error(msg);
+        }
     },
 };
 //# sourceMappingURL=logger.js.map