@yieldstar/core 0.2.2 → 0.4.0-alpha.1

package/dist/base/event.d.ts

@@ -12,4 +12,10 @@ export type ExecutionEvent<EventParams = any> = {
     executionId: string;
     params: EventParams;
 };
+export type WorkflowEvent<EventParams = any, Context extends ReadonlyMap<any, any> = ReadonlyMap<any, any>> = {
+    workflowId: string;
+    executionId: string;
+    params: EventParams;
+    context: Context;
+};
 //# sourceMappingURL=event.d.ts.map

package/dist/base/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/base/event.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CACtB,UAAU,SAAS,MAAM,EACzB,WAAW,GAAG,GAAG,IACf,WAAW,SAAS,IAAI,GACxB;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,cAAc,CAAC,WAAW,GAAG,GAAG,IAAI;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/base/event.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CACtB,UAAU,SAAS,MAAM,EACzB,WAAW,GAAG,GAAG,IACf,WAAW,SAAS,IAAI,GACxB;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,cAAc,CAAC,WAAW,GAAG,GAAG,IAAI;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,CACvB,WAAW,GAAG,GAAG,EACjB,OAAO,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAC3D;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/base/map.d.ts

@@ -0,0 +1,21 @@
+export declare class ReadOnlyMap<K, V> implements ReadonlyMap<K, V> {
+    private sourceMap;
+    constructor(sourceMap: Map<K, V>);
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    get size(): number;
+    entries(): ReturnType<Map<K, V>["entries"]>;
+    keys(): ReturnType<Map<K, V>["keys"]>;
+    values(): ReturnType<Map<K, V>["values"]>;
+    forEach(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: any): void;
+    [Symbol.iterator](): ReturnType<Map<K, V>[typeof Symbol.iterator]>;
+}
+export declare class FreezableMap<K, V> extends Map<K, V> {
+    private frozen;
+    freeze(): void;
+    isFrozen(): boolean;
+    set(key: K, value: V): this;
+    delete(key: K): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=map.d.ts.map

package/dist/base/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/base/map.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAI3C,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAIrC,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAIzC,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EACtD,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI;IAIP,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;CAGnE;AAED,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAS;IAEvB,MAAM,IAAI,IAAI;IAId,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAO3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAOvB,KAAK,IAAI,IAAI;CAMd"}

package/dist/base/map.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map.test.d.ts.map

package/dist/base/map.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.test.d.ts","sourceRoot":"","sources":["../../src/base/map.test.ts"],"names":[],"mappings":""}

package/dist/base/middleware.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from "pino";
+import { ExecutionEvent } from "./event";
+import { FreezableMap } from "../utils/map";
+export type MiddlewareEvent = ExecutionEvent & {
+    context: FreezableMap<string, any>;
+};
+export type MiddlewareNext = () => Promise<Response>;
+export type MiddlewareFunction = (req: Request, event: MiddlewareEvent, next: MiddlewareNext, logger: Logger) => Promise<Response>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/base/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/base/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/base/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { Logger } from "pino";
 import type { WorkflowResult } from "./step";
-import type { ExecutionEvent } from "./event";
-export type EventProcessor<EventParams = any, Result = any> = (event: ExecutionEvent<EventParams>, logger: Logger) => Promise<void | WorkflowResult<Result>>;
+import type { WorkflowEvent } from "./event";
+export type EventProcessor<EventParams = any, Result = any, Context extends ReadonlyMap<any, any> = ReadonlyMap<any, any>> = (event: WorkflowEvent<EventParams, Context>, logger: Logger) => Promise<void | WorkflowResult<Result>>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/base/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/base/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,cAAc,CAAC,WAAW,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,CAC5D,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,EAClC,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/base/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,cAAc,CACxB,WAAW,GAAG,GAAG,EACjB,MAAM,GAAG,GAAG,EACZ,OAAO,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAC3D,CACF,KAAK,EAAE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,EAC1C,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/base/workflow.d.ts

@@ -1,15 +1,15 @@
 import type { Logger } from "pino";
 import { HeapClient } from "./heap";
 import { StepResponse, WorkflowResult } from "./step";
-import type { ExecutionEvent } from "./event";
-export type WorkflowGeneratorParams<EventParams> = {
-    event: ExecutionEvent<EventParams>;
+import type { WorkflowEvent } from "./event";
+export type WorkflowGeneratorParams<EventParams, Context extends ReadonlyMap<any, any>> = {
+    event: WorkflowEvent<EventParams, Context>;
     heapClient: HeapClient;
     logger: Logger;
 };
-export type WorkflowGenerator<EventParams, Result> = (genParams: WorkflowGeneratorParams<EventParams>) => AsyncGenerator<StepResponse, WorkflowResult<Result>, StepResponse>;
-export type WorkflowGeneratorReturnType<CG> = CG extends WorkflowGenerator<infer EventParams, infer Result> ? Result : never;
-export type WorkflowRouter = Record<string, WorkflowGenerator<any, any>>;
-export type EventOfWorkflow<W extends WorkflowGenerator<any, any>> = Parameters<W>[0]["event"];
-export type EventParamsOf<W extends WorkflowGenerator<any, any>> = Parameters<W>[0]["event"]["params"];
+export type WorkflowGenerator<EventParams, Result, Context extends Map<any, any>> = (genParams: WorkflowGeneratorParams<EventParams, Context>) => AsyncGenerator<StepResponse, WorkflowResult<Result>, StepResponse>;
+export type WorkflowGeneratorReturnType<CG> = CG extends WorkflowGenerator<infer EventParams, infer Result, infer Context> ? Result : never;
+export type WorkflowRouter = Record<string, WorkflowGenerator<any, any, any>>;
+export type EventOfWorkflow<W extends WorkflowGenerator<any, any, any>> = Parameters<W>[0]["event"];
+export type EventParamsOf<W extends WorkflowGenerator<any, any, any>> = Parameters<W>[0]["event"]["params"];
 //# sourceMappingURL=workflow.d.ts.map

package/dist/base/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/base/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,uBAAuB,CAAC,WAAW,IAAI;IACjD,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,WAAW,EAAE,MAAM,IAAI,CACnD,SAAS,EAAE,uBAAuB,CAAC,WAAW,CAAC,KAC5C,cAAc,CAAC,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;AAExE,MAAM,MAAM,2BAA2B,CAAC,EAAE,IAAI,EAAE,SAAS,iBAAiB,CACxE,MAAM,WAAW,EACjB,MAAM,MAAM,CACb,GACG,MAAM,GACN,KAAK,CAAC;AAEV,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEzE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,IAC/D,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,IAC7D,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/base/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,uBAAuB,CACjC,WAAW,EACX,OAAO,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IACnC;IACF,KAAK,EAAE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3C,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,WAAW,EACX,MAAM,EACN,OAAO,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,IAC3B,CACF,SAAS,EAAE,uBAAuB,CAAC,WAAW,EAAE,OAAO,CAAC,KACrD,cAAc,CAAC,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;AAExE,MAAM,MAAM,2BAA2B,CAAC,EAAE,IAAI,EAAE,SAAS,iBAAiB,CACxE,MAAM,WAAW,EACjB,MAAM,MAAM,EACZ,MAAM,OAAO,CACd,GACG,MAAM,GACN,KAAK,CAAC;AAEV,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE9E,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IACpE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAClE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -2,8 +2,10 @@ export type { HeapClient, HeapRecord } from "./base/heap";
 export type { WorkflowInvoker } from "./base/invoker";
 export type { EventProcessor } from "./base/runtime";
 export type { SchedulerClient } from "./base/scheduler";
+export type { ExecutionEvent, TriggerEvent, WorkflowEvent } from "./base/event";
+export type { MiddlewareNext, MiddlewareEvent, MiddlewareFunction, } from "./base/middleware";
 export type { WorkflowGenerator, WorkflowGeneratorReturnType, WorkflowRouter, EventOfWorkflow, EventParamsOf, } from "./base/workflow";
-export type { TriggerEvent as TriggerEvent, ExecutionEvent as ExecutionEvent, } from "./base/event";
 export { StepCacheCheck, StepDelay, StepError, StepInvalid, StepKey, StepResponse, StepResult, WorkflowDelay, WorkflowRestart, WorkflowResult, } from "./base/step";
 export { WorkflowRunner } from "./lib/workflow-runner";
+export { ReadOnlyMap, FreezableMap } from "./utils/map";
 //# 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,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,IAAI,YAAY,EAC5B,cAAc,IAAI,cAAc,GACjC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhF,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -136,6 +136,65 @@ class WorkflowRunner {
     throw new Error("Workflow runner critical error. This is likely because your worklow and worker are referencing different versions of @yieldstar/core.");
   }
 }
+// src/utils/map.ts
+class ReadOnlyMap {
+  sourceMap;
+  constructor(sourceMap) {
+    this.sourceMap = sourceMap;
+  }
+  get(key) {
+    return this.sourceMap.get(key);
+  }
+  has(key) {
+    return this.sourceMap.has(key);
+  }
+  get size() {
+    return this.sourceMap.size;
+  }
+  entries() {
+    return this.sourceMap.entries();
+  }
+  keys() {
+    return this.sourceMap.keys();
+  }
+  values() {
+    return this.sourceMap.values();
+  }
+  forEach(callbackfn, thisArg) {
+    return this.sourceMap.forEach(callbackfn, thisArg);
+  }
+  [Symbol.iterator]() {
+    return this.sourceMap[Symbol.iterator]();
+  }
+}
+
+class FreezableMap extends Map {
+  frozen = false;
+  freeze() {
+    this.frozen = true;
+  }
+  isFrozen() {
+    return this.frozen;
+  }
+  set(key, value) {
+    if (this.frozen) {
+      throw new Error("Cannot call set on a frozen map");
+    }
+    return super.set(key, value);
+  }
+  delete(key) {
+    if (this.frozen) {
+      throw new Error("Cannot call delete on a frozen map");
+    }
+    return super.delete(key);
+  }
+  clear() {
+    if (this.frozen) {
+      throw new Error("Cannot call clear on a frozen map");
+    }
+    return super.clear();
+  }
+}
 export {
   WorkflowRunner,
   WorkflowResult,
@@ -147,5 +206,7 @@ export {
   StepInvalid,
   StepError,
   StepDelay,
-  StepCacheCheck
+  StepCacheCheck,
+  ReadOnlyMap,
+  FreezableMap
 };

package/dist/lib/workflow-runner.d.ts

@@ -1,6 +1,6 @@
 import type { Logger } from "pino";
 import type { WorkflowGenerator, HeapClient, SchedulerClient, EventProcessor } from "..";
-export declare class WorkflowRunner<Router extends Record<string, WorkflowGenerator<any, any>>> {
+export declare class WorkflowRunner<Router extends Record<string, WorkflowGenerator<any, any, any>>> {
     private heapClient;
     private schedulerClient;
     private router;

package/dist/lib/workflow-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,cAAc,EAEf,MAAM,IAAI,CAAC;AAGZ,qBAAa,cAAc,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE1D,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE;QAClB,UAAU,EAAE,UAAU,CAAC;QACvB,eAAe,EAAE,eAAe,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB;IAMD,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CA0B3B;YAEY,YAAY;CA4B3B"}
+{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,cAAc,EAEf,MAAM,IAAI,CAAC;AAGZ,qBAAa,cAAc,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE/D,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE;QAClB,UAAU,EAAE,UAAU,CAAC;QACvB,eAAe,EAAE,eAAe,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB;IAMD,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CA0B3B;YAEY,YAAY;CAgC3B"}

package/dist/utils/map.d.ts

@@ -0,0 +1,21 @@
+export declare class ReadOnlyMap<K, V> implements ReadonlyMap<K, V> {
+    private sourceMap;
+    constructor(sourceMap: Map<K, V>);
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    get size(): number;
+    entries(): ReturnType<Map<K, V>["entries"]>;
+    keys(): ReturnType<Map<K, V>["keys"]>;
+    values(): ReturnType<Map<K, V>["values"]>;
+    forEach(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: any): void;
+    [Symbol.iterator](): ReturnType<Map<K, V>[typeof Symbol.iterator]>;
+}
+export declare class FreezableMap<K, V> extends Map<K, V> {
+    private frozen;
+    freeze(): void;
+    isFrozen(): boolean;
+    set(key: K, value: V): this;
+    delete(key: K): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=map.d.ts.map

package/dist/utils/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/utils/map.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAI3C,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAIrC,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAIzC,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EACtD,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI;IAIP,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;CAGnE;AAED,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAS;IAEvB,MAAM,IAAI,IAAI;IAId,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAO3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAOvB,KAAK,IAAI,IAAI;CAMd"}

package/dist/utils/map.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map.test.d.ts.map

package/dist/utils/map.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.test.d.ts","sourceRoot":"","sources":["../../src/utils/map.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yieldstar/core",
-  "version": "0.2.2",
+  "version": "0.4.0-alpha.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/base/event.ts

@@ -18,3 +18,13 @@ export type ExecutionEvent<EventParams = any> = {
   executionId: string;
   params: EventParams;
 };
+
+export type WorkflowEvent<
+  EventParams = any,
+  Context extends ReadonlyMap<any, any> = ReadonlyMap<any, any>
+> = {
+  workflowId: string;
+  executionId: string;
+  params: EventParams;
+  context: Context;
+};

package/src/base/middleware.ts

@@ -0,0 +1,16 @@
+import type { Logger } from "pino";
+import { ExecutionEvent } from "./event";
+import { FreezableMap } from "../utils/map";
+
+export type MiddlewareEvent = ExecutionEvent & {
+  context: FreezableMap<string, any>;
+};
+
+export type MiddlewareNext = () => Promise<Response>;
+
+export type MiddlewareFunction = (
+  req: Request,
+  event: MiddlewareEvent,
+  next: MiddlewareNext,
+  logger: Logger
+) => Promise<Response>;

package/src/base/runtime.ts

@@ -1,8 +1,12 @@
 import type { Logger } from "pino";
 import type { WorkflowResult } from "./step";
-import type { ExecutionEvent } from "./event";
+import type { WorkflowEvent } from "./event";
 
-export type EventProcessor<EventParams = any, Result = any> = (
-  event: ExecutionEvent<EventParams>,
+export type EventProcessor<
+  EventParams = any,
+  Result = any,
+  Context extends ReadonlyMap<any, any> = ReadonlyMap<any, any>
+> = (
+  event: WorkflowEvent<EventParams, Context>,
   logger: Logger
 ) => Promise<void | WorkflowResult<Result>>;

package/src/base/workflow.ts

@@ -1,29 +1,37 @@
 import type { Logger } from "pino";
 import { HeapClient } from "./heap";
 import { StepResponse, WorkflowResult } from "./step";
-import type { ExecutionEvent } from "./event";
+import type { WorkflowEvent } from "./event";
 
-export type WorkflowGeneratorParams<EventParams> = {
-  event: ExecutionEvent<EventParams>;
+export type WorkflowGeneratorParams<
+  EventParams,
+  Context extends ReadonlyMap<any, any>
+> = {
+  event: WorkflowEvent<EventParams, Context>;
   heapClient: HeapClient;
   logger: Logger;
 };
 
-export type WorkflowGenerator<EventParams, Result> = (
-  genParams: WorkflowGeneratorParams<EventParams>
+export type WorkflowGenerator<
+  EventParams,
+  Result,
+  Context extends Map<any, any>
+> = (
+  genParams: WorkflowGeneratorParams<EventParams, Context>
 ) => AsyncGenerator<StepResponse, WorkflowResult<Result>, StepResponse>;
 
 export type WorkflowGeneratorReturnType<CG> = CG extends WorkflowGenerator<
   infer EventParams,
-  infer Result
+  infer Result,
+  infer Context
 >
   ? Result
   : never;
 
-export type WorkflowRouter = Record<string, WorkflowGenerator<any, any>>;
+export type WorkflowRouter = Record<string, WorkflowGenerator<any, any, any>>;
 
-export type EventOfWorkflow<W extends WorkflowGenerator<any, any>> =
+export type EventOfWorkflow<W extends WorkflowGenerator<any, any, any>> =
   Parameters<W>[0]["event"];
 
-export type EventParamsOf<W extends WorkflowGenerator<any, any>> =
+export type EventParamsOf<W extends WorkflowGenerator<any, any, any>> =
   Parameters<W>[0]["event"]["params"];

package/src/index.ts

@@ -2,6 +2,14 @@ export type { HeapClient, HeapRecord } from "./base/heap";
 export type { WorkflowInvoker } from "./base/invoker";
 export type { EventProcessor } from "./base/runtime";
 export type { SchedulerClient } from "./base/scheduler";
+export type { ExecutionEvent, TriggerEvent, WorkflowEvent } from "./base/event";
+
+export type {
+  MiddlewareNext,
+  MiddlewareEvent,
+  MiddlewareFunction,
+} from "./base/middleware";
+
 export type {
   WorkflowGenerator,
   WorkflowGeneratorReturnType,
@@ -9,10 +17,6 @@ export type {
   EventOfWorkflow,
   EventParamsOf,
 } from "./base/workflow";
-export type {
-  TriggerEvent as TriggerEvent,
-  ExecutionEvent as ExecutionEvent,
-} from "./base/event";
 
 export {
   StepCacheCheck,
@@ -28,3 +32,4 @@ export {
 } from "./base/step";
 
 export { WorkflowRunner } from "./lib/workflow-runner";
+export { ReadOnlyMap, FreezableMap } from "./utils/map";

package/src/lib/workflow-runner.ts

@@ -4,12 +4,12 @@ import type {
   HeapClient,
   SchedulerClient,
   EventProcessor,
-  ExecutionEvent,
+  WorkflowEvent,
 } from "..";
 import { StepDelay, WorkflowDelay, WorkflowResult } from "..";
 
 export class WorkflowRunner<
-  Router extends Record<string, WorkflowGenerator<any, any>>
+  Router extends Record<string, WorkflowGenerator<any, any, any>>
 > {
   private heapClient: HeapClient;
   private schedulerClient: SchedulerClient;
@@ -54,9 +54,13 @@ export class WorkflowRunner<
     }
   };
 
-  private async runWorkflows<EventParams, Result>(params: {
-    workflow: WorkflowGenerator<EventParams, Result>;
-    event: ExecutionEvent<EventParams>;
+  private async runWorkflows<
+    EventParams,
+    Result,
+    Context extends Map<any, any>
+  >(params: {
+    workflow: WorkflowGenerator<EventParams, Result, Context>;
+    event: WorkflowEvent<EventParams, Context>;
     logger: Logger;
   }): Promise<WorkflowResult<Result> | WorkflowDelay> {
     const { workflow, event, logger } = params;

package/src/utils/map.test.ts

@@ -0,0 +1,43 @@
+import { expect, test } from "bun:test";
+import { ReadOnlyMap, FreezableMap } from "./map";
+
+test("ReadOnlyMap", () => {
+  const originalMap = new Map<string, any>();
+  originalMap.set("key", "value");
+
+  const readOnlyMap = new ReadOnlyMap(originalMap);
+
+  // Reading should work
+  expect(readOnlyMap.get("key")).toBe("value");
+  expect(readOnlyMap.has("key")).toBe(true);
+  expect(readOnlyMap.size).toBe(1);
+
+  expect("set" in readOnlyMap).toBe(false);
+  expect("delete" in readOnlyMap).toBe(false);
+  expect("clear" in readOnlyMap).toBe(false);
+});
+
+test("FreezableMap", () => {
+  const freezableMap = new FreezableMap<string, any>();
+  freezableMap.set("key", "value");
+
+  // Before freezing, modifications should work
+  expect(freezableMap.get("key")).toBe("value");
+  freezableMap.set("key2", "value2");
+  expect(freezableMap.get("key2")).toBe("value2");
+
+  // Freeze the map
+  freezableMap.freeze();
+  expect(freezableMap.isFrozen()).toBe(true);
+
+  // After freezing, modifications should throw
+  expect(() => freezableMap.set("key3", "value3")).toThrow(
+    "Cannot call set on a frozen map"
+  );
+  expect(() => freezableMap.delete("key")).toThrow(
+    "Cannot call delete on a frozen map"
+  );
+  expect(() => freezableMap.clear()).toThrow(
+    "Cannot call clear on a frozen map"
+  );
+});

package/src/utils/map.ts

@@ -0,0 +1,75 @@
+export class ReadOnlyMap<K, V> implements ReadonlyMap<K, V> {
+  private sourceMap: Map<K, V>;
+
+  constructor(sourceMap: Map<K, V>) {
+    this.sourceMap = sourceMap;
+  }
+
+  get(key: K): V | undefined {
+    return this.sourceMap.get(key);
+  }
+
+  has(key: K): boolean {
+    return this.sourceMap.has(key);
+  }
+
+  get size(): number {
+    return this.sourceMap.size;
+  }
+
+  entries(): ReturnType<Map<K, V>["entries"]> {
+    return this.sourceMap.entries();
+  }
+
+  keys(): ReturnType<Map<K, V>["keys"]> {
+    return this.sourceMap.keys();
+  }
+
+  values(): ReturnType<Map<K, V>["values"]> {
+    return this.sourceMap.values();
+  }
+
+  forEach(
+    callbackfn: (value: V, key: K, map: Map<K, V>) => void,
+    thisArg?: any
+  ): void {
+    return this.sourceMap.forEach(callbackfn, thisArg);
+  }
+
+  [Symbol.iterator](): ReturnType<Map<K, V>[typeof Symbol.iterator]> {
+    return this.sourceMap[Symbol.iterator]();
+  }
+}
+
+export class FreezableMap<K, V> extends Map<K, V> {
+  private frozen = false;
+
+  freeze(): void {
+    this.frozen = true;
+  }
+
+  isFrozen(): boolean {
+    return this.frozen;
+  }
+
+  set(key: K, value: V): this {
+    if (this.frozen) {
+      throw new Error("Cannot call set on a frozen map");
+    }
+    return super.set(key, value);
+  }
+
+  delete(key: K): boolean {
+    if (this.frozen) {
+      throw new Error("Cannot call delete on a frozen map");
+    }
+    return super.delete(key);
+  }
+
+  clear(): void {
+    if (this.frozen) {
+      throw new Error("Cannot call clear on a frozen map");
+    }
+    return super.clear();
+  }
+}