@synkro/core 0.1.0

package/README.md

@@ -0,0 +1,146 @@
+# @synkro/core
+
+Lightweight workflow and state machine orchestrator powered by Redis. Define event-driven workflows via configuration or code.
+
+## Features
+
+- **Standalone Events** — Simple pub/sub event handlers with Redis
+- **Sequential Workflows** — Multi-step workflows that execute in order, with state tracked in Redis
+- **Simple API** — Single `Synkro` class with minimal configuration
+- **TypeScript** — Full type support out of the box
+
+## Installation
+
+```bash
+npm install @synkro/core
+```
+
+> Requires a running Redis instance.
+
+## Quick Start
+
+```ts
+import { Synkro } from "@synkro/core";
+
+const synkro = await Synkro.start({
+  redisUrl: "redis://localhost:6379",
+  events: [
+    {
+      type: "UserSignedUp",
+      handler: async (ctx) => {
+        console.log("New user:", ctx.payload);
+      },
+    },
+  ],
+});
+
+await synkro.publish("UserSignedUp", { email: "user@example.com" });
+```
+
+## Workflows
+
+Define multi-step sequential workflows. Each step runs after the previous one completes, with state persisted in Redis.
+
+```ts
+const synkro = await Synkro.start({
+  redisUrl: "redis://localhost:6379",
+  workflows: [
+    {
+      name: "ProcessOrder",
+      steps: [
+        {
+          type: "ValidateStock",
+          handler: async (ctx) => {
+            console.log("Checking stock for order:", ctx.requestId);
+          },
+        },
+        {
+          type: "ProcessPayment",
+          handler: async (ctx) => {
+            console.log("Processing payment...");
+          },
+        },
+        {
+          type: "SendConfirmation",
+          handler: async (ctx) => {
+            console.log("Order confirmed!");
+          },
+        },
+      ],
+    },
+  ],
+});
+
+// Triggers all 3 steps in sequence
+await synkro.publish("ProcessOrder", { orderId: "abc-123", amount: 49.99 });
+```
+
+## API
+
+### `Synkro.start(options): Promise<Synkro>`
+
+Creates and returns a running instance.
+
+```ts
+type SynkroOptions = {
+  redisUrl: string;
+  events?: SynkroEvent[];
+  workflows?: SynkroWorkflow[];
+};
+```
+
+### `synkro.on(eventType, handler): void`
+
+Registers an event handler at runtime.
+
+```ts
+synkro.on("StockUpdate", async (ctx) => {
+  console.log(ctx.requestId, ctx.payload);
+});
+```
+
+### `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.
+
+```ts
+// Auto-generated UUID
+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");
+```
+
+### `synkro.stop(): Promise<void>`
+
+Disconnects all Redis clients.
+
+## Types
+
+```ts
+type SynkroEvent = {
+  type: string;
+  handler: HandlerFunction;
+};
+
+type SynkroWorkflow = {
+  name: string;
+  steps: SynkroWorkflowStep[];
+};
+
+type SynkroWorkflowStep = {
+  type: string;
+  handler: HandlerFunction;
+};
+
+type HandlerCtx = {
+  requestId: string;
+  payload: unknown;
+};
+
+type HandlerFunction = (ctx: HandlerCtx) => void | Promise<void>;
+```
+
+## License
+
+ISC

package/dist/handler-registry.d.ts

@@ -0,0 +1,10 @@
+import type { RedisManager } from "./redis.js";
+import type { HandlerFunction } from "./types.js";
+export declare class HandlerRegistry {
+    private redis;
+    private handlers;
+    constructor(redis: RedisManager);
+    register(eventType: string, handlerFn: HandlerFunction): void;
+    private handleMessage;
+}
+//# sourceMappingURL=handler-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registry.d.ts","sourceRoot":"","sources":["../package/handler-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,qBAAa,eAAe;IAGd,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,QAAQ,CAAsC;gBAElC,KAAK,EAAE,YAAY;IAEvC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI;YAQ/C,aAAa;CAkB5B"}

package/dist/handler-registry.js

@@ -0,0 +1,23 @@
+export class HandlerRegistry {
+    redis;
+    handlers = new Map();
+    constructor(redis) {
+        this.redis = redis;
+    }
+    register(eventType, handlerFn) {
+        this.handlers.set(eventType, handlerFn);
+        this.redis.subscribeToChannel(eventType, (message) => {
+            this.handleMessage(eventType, message);
+        });
+    }
+    async handleMessage(eventType, message) {
+        const handler = this.handlers.get(eventType);
+        if (!handler) {
+            return;
+        }
+        const event = JSON.parse(message);
+        await handler({ requestId: event.requestId, payload: event.payload });
+        this.redis.publishMessage(`event:${eventType}:completed`, JSON.stringify({ requestId: event.requestId, payload: event.payload }));
+    }
+}
+//# sourceMappingURL=handler-registry.js.map

package/dist/handler-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registry.js","sourceRoot":"","sources":["../package/handler-registry.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IAGN;IAFZ,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD,YAAoB,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAE3C,QAAQ,CAAC,SAAiB,EAAE,SAA0B;QACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAExC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,OAAe,EAAE,EAAE;YAC3D,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,SAAiB,EACjB,OAAe;QAEf,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;QAEhD,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC,KAAK,CAAC,cAAc,CACvB,SAAS,SAAS,YAAY,EAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CACvE,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { HandlerFunction, SynkroOptions } from "./types.js";
+export declare class Synkro {
+    private redis;
+    private handlerRegistry;
+    private workflowRegistry;
+    private constructor();
+    static start(options: SynkroOptions): Promise<Synkro>;
+    on(eventType: string, handler: HandlerFunction): void;
+    publish(event: string, payload?: unknown, requestId?: string): Promise<string>;
+    stop(): Promise<void>;
+}
+export type { HandlerCtx, HandlerFunction, SynkroEvent, SynkroOptions, SynkroWorkflow, SynkroWorkflowStep, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../package/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;IAE3C,OAAO;WAMM,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB3D,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAI/C,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAeZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED,YAAY,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,45 @@
+import { randomUUID } from "node:crypto";
+import { HandlerRegistry } from "./handler-registry.js";
+import { setDebug } from "./logger.js";
+import { RedisManager } from "./redis.js";
+import { WorkflowRegistry } from "./workflow-registry.js";
+export class Synkro {
+    redis;
+    handlerRegistry;
+    workflowRegistry;
+    constructor(redis) {
+        this.redis = redis;
+        this.handlerRegistry = new HandlerRegistry(redis);
+        this.workflowRegistry = new WorkflowRegistry(redis, this.handlerRegistry);
+    }
+    static async start(options) {
+        setDebug(options.debug ?? false);
+        const redis = new RedisManager(options.redisUrl);
+        const instance = new Synkro(redis);
+        if (options.events) {
+            for (const event of options.events) {
+                instance.on(event.type, event.handler);
+            }
+        }
+        if (options.workflows) {
+            instance.workflowRegistry.registerWorkflows(options.workflows);
+        }
+        return instance;
+    }
+    on(eventType, handler) {
+        this.handlerRegistry.register(eventType, handler);
+    }
+    async publish(event, payload, requestId) {
+        requestId = requestId ?? randomUUID();
+        if (this.workflowRegistry.hasWorkflow(event)) {
+            await this.workflowRegistry.startWorkflow(event, requestId, payload);
+            return requestId;
+        }
+        this.redis.publishMessage(event, JSON.stringify({ requestId, payload }));
+        return requestId;
+    }
+    async stop() {
+        await this.redis.disconnect();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../package/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,MAAM,OAAO,MAAM;IACT,KAAK,CAAe;IACpB,eAAe,CAAkB;IACjC,gBAAgB,CAAmB;IAE3C,YAAoB,KAAmB;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAsB;QACvC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAEnC,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,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,EAAE,CAAC,SAAiB,EAAE,OAAwB;QAC5C,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,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,KAAK,CAAC,cAAc,CACvB,KAAK,EACL,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CACvC,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export declare function setDebug(enabled: boolean): void;
+export declare const logger: {
+    debug(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../package/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"}

package/dist/logger.js

@@ -0,0 +1,20 @@
+let debugEnabled = false;
+export function setDebug(enabled) {
+    debugEnabled = enabled;
+}
+export const logger = {
+    debug(...args) {
+        if (debugEnabled) {
+            console.log(...args);
+        }
+    },
+    warn(...args) {
+        if (debugEnabled) {
+            console.warn(...args);
+        }
+    },
+    error(...args) {
+        console.error(...args);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../package/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"}

package/dist/redis.d.ts

@@ -0,0 +1,13 @@
+export declare class RedisManager {
+    private publisher;
+    private subscriber;
+    private cacheClient;
+    constructor(redisUrl: string);
+    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>;
+    deleteCache(key: string): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../package/redis.ts"],"names":[],"mappings":"AAIA,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAQ;gBAEf,QAAQ,EAAE,MAAM;IAM5B,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAItD,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,IAAI;IAmBD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7C,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAQV,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAKlC"}

package/dist/redis.js

@@ -0,0 +1,50 @@
+import { Redis } from "ioredis";
+import { logger } from "./logger.js";
+export class RedisManager {
+    publisher;
+    subscriber;
+    cacheClient;
+    constructor(redisUrl) {
+        this.publisher = new Redis(redisUrl);
+        this.subscriber = new Redis(redisUrl);
+        this.cacheClient = new Redis(redisUrl);
+    }
+    publishMessage(channel, message) {
+        this.publisher.publish(channel, message);
+    }
+    subscribeToChannel(channel, callback) {
+        this.subscriber
+            .subscribe(channel)
+            .then((count) => {
+            logger.debug(`Subscribed to ${count} channel(s). Listening on "${channel}".`);
+        })
+            .catch((err) => {
+            logger.error(`Failed to subscribe to channel ${channel}:`, err);
+        });
+        this.subscriber.on("message", (chan, message) => {
+            if (chan === channel) {
+                callback(message);
+            }
+        });
+    }
+    async getCache(key) {
+        return await this.cacheClient.get(key);
+    }
+    async setCache(key, value, ttlSeconds) {
+        if (ttlSeconds) {
+            await this.cacheClient.set(key, value, "EX", ttlSeconds);
+        }
+        else {
+            await this.cacheClient.set(key, value);
+        }
+    }
+    async deleteCache(key) {
+        await this.cacheClient.del(key);
+    }
+    async disconnect() {
+        await this.publisher.quit();
+        await this.subscriber.quit();
+        await this.cacheClient.quit();
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../package/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,OAAO,YAAY;IACf,SAAS,CAAQ;IACjB,UAAU,CAAQ;IAClB,WAAW,CAAQ;IAE3B,YAAY,QAAgB;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,OAAe;QAC7C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,kBAAkB,CAChB,OAAe,EACf,QAAmC;QAEnC,IAAI,CAAC,UAAU;aACZ,SAAS,CAAC,OAAO,CAAC;aAClB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACd,MAAM,CAAC,KAAK,CACV,iBAAiB,KAAK,8BAA8B,OAAO,IAAI,CAChE,CAAC;QACJ,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,MAAM,CAAC,KAAK,CAAC,kCAAkC,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAY,EAAE,OAAe,EAAE,EAAE;YAC9D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,KAAa,EACb,UAAmB;QAEnB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export type SynkroEvent = {
+    type: string;
+    handler: HandlerFunction;
+};
+export type SynkroWorkflowStep = {
+    type: string;
+    handler: HandlerFunction;
+};
+export type SynkroWorkflow = {
+    name: string;
+    steps: SynkroWorkflowStep[];
+};
+export type SynkroOptions = {
+    redisUrl: string;
+    debug?: boolean;
+    events?: SynkroEvent[];
+    workflows?: SynkroWorkflow[];
+};
+export type HandlerCtx = {
+    requestId: string;
+    payload: unknown;
+};
+export type HandlerFunction = (ctx: HandlerCtx) => void | Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../package/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/workflow-registry.d.ts

@@ -0,0 +1,20 @@
+import type { HandlerRegistry } from "./handler-registry.js";
+import type { RedisManager } from "./redis.js";
+import type { SynkroWorkflow } from "./types.js";
+export declare class WorkflowRegistry {
+    private redis;
+    private handlerRegistry;
+    private workflows;
+    private eventToWorkflows;
+    constructor(redis: RedisManager, handlerRegistry: HandlerRegistry);
+    registerWorkflows(workflows: SynkroWorkflow[]): void;
+    hasWorkflow(name: string): boolean;
+    startWorkflow(workflowName: string, requestId: string, payload: unknown): Promise<void>;
+    private subscribeToWorkflowEvents;
+    private handleStepCompletion;
+    private stepChannel;
+    private stateKey;
+    private saveState;
+    private getState;
+}
+//# sourceMappingURL=workflow-registry.d.ts.map

package/dist/workflow-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-registry.d.ts","sourceRoot":"","sources":["../package/workflow-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,eAAe;IARzB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,gBAAgB,CAGpB;gBAGM,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,eAAe;IAG1C,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI;IAwBpD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI5B,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IA2BhB,OAAO,CAAC,yBAAyB;YAYnB,oBAAoB;IAiDlC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;YAIF,SAAS;YAWT,QAAQ;CAKvB"}

package/dist/workflow-registry.js

@@ -0,0 +1,98 @@
+import { logger } from "./logger.js";
+export class WorkflowRegistry {
+    redis;
+    handlerRegistry;
+    workflows = new Map();
+    eventToWorkflows = new Map();
+    constructor(redis, handlerRegistry) {
+        this.redis = redis;
+        this.handlerRegistry = handlerRegistry;
+    }
+    registerWorkflows(workflows) {
+        for (const workflow of workflows) {
+            this.workflows.set(workflow.name, workflow);
+            for (let i = 0; i < workflow.steps.length; i++) {
+                const step = workflow.steps[i];
+                const key = step.type;
+                if (!this.eventToWorkflows.has(key)) {
+                    this.eventToWorkflows.set(key, []);
+                }
+                this.eventToWorkflows.get(key).push({ workflow, stepIndex: i });
+                const channel = this.stepChannel(workflow.name, step.type);
+                this.handlerRegistry.register(channel, step.handler);
+            }
+            this.subscribeToWorkflowEvents(workflow);
+            logger.debug(`[WorkflowRegistry] - Workflow "${workflow.name}" registered with ${workflow.steps.length} steps`);
+        }
+    }
+    hasWorkflow(name) {
+        return this.workflows.has(name);
+    }
+    async startWorkflow(workflowName, requestId, payload) {
+        const workflow = this.workflows.get(workflowName);
+        if (!workflow) {
+            throw new Error(`[WorkflowRegistry] - Workflow "${workflowName}" not found`);
+        }
+        const state = {
+            workflowName,
+            currentStep: 0,
+            status: "running",
+        };
+        await this.saveState(requestId, state);
+        const firstStep = workflow.steps[0];
+        const channel = this.stepChannel(workflowName, firstStep.type);
+        logger.debug(`[WorkflowRegistry] - Starting workflow "${workflowName}" (requestId: ${requestId}), publishing "${firstStep.type}"`);
+        this.redis.publishMessage(channel, JSON.stringify({ requestId, payload }));
+    }
+    subscribeToWorkflowEvents(workflow) {
+        for (let i = 0; i < workflow.steps.length; i++) {
+            const step = workflow.steps[i];
+            const channel = this.stepChannel(workflow.name, step.type);
+            const completionChannel = `event:${channel}:completed`;
+            this.redis.subscribeToChannel(completionChannel, (message) => {
+                this.handleStepCompletion(workflow, i, message);
+            });
+        }
+    }
+    async handleStepCompletion(workflow, stepIndex, message) {
+        const { requestId, payload } = JSON.parse(message);
+        const state = await this.getState(requestId);
+        if (!state || state.workflowName !== workflow.name) {
+            return;
+        }
+        if (state.currentStep !== stepIndex) {
+            logger.warn(`[WorkflowRegistry] - Step mismatch for "${workflow.name}" (requestId: ${requestId}): expected step ${state.currentStep}, got ${stepIndex}`);
+            return;
+        }
+        const nextStepIndex = stepIndex + 1;
+        if (nextStepIndex >= workflow.steps.length) {
+            state.status = "completed";
+            state.currentStep = stepIndex;
+            await this.saveState(requestId, state);
+            logger.debug(`[WorkflowRegistry] - Workflow "${workflow.name}" completed (requestId: ${requestId})`);
+            return;
+        }
+        state.currentStep = nextStepIndex;
+        await this.saveState(requestId, state);
+        const nextStep = workflow.steps[nextStepIndex];
+        const nextChannel = this.stepChannel(workflow.name, nextStep.type);
+        logger.debug(`[WorkflowRegistry] - Workflow "${workflow.name}" advancing to step ${nextStepIndex}: "${nextStep.type}" (requestId: ${requestId})`);
+        this.redis.publishMessage(nextChannel, JSON.stringify({ requestId, payload }));
+    }
+    stepChannel(workflowName, stepType) {
+        return `workflow:${workflowName}:${stepType}`;
+    }
+    stateKey(requestId) {
+        return `workflow:state:${requestId}`;
+    }
+    async saveState(requestId, state) {
+        await this.redis.setCache(this.stateKey(requestId), JSON.stringify(state), 86400);
+    }
+    async getState(requestId) {
+        const raw = await this.redis.getCache(this.stateKey(requestId));
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+}
+//# sourceMappingURL=workflow-registry.js.map

package/dist/workflow-registry.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@synkro/core",
+  "version": "0.1.0",
+  "description": "Lightweight workflow and state machine orchestrator powered by Redis. Define event-driven workflows via configuration or code.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "workflow",
+    "state-machine",
+    "orchestrator",
+    "event-driven",
+    "redis"
+  ],
+  "author": "buemura",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/buemura/synkro.git"
+  },
+  "homepage": "https://github.com/buemura/synkro#readme",
+  "type": "module",
+  "dependencies": {
+    "ioredis": "^5.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}