@blokjs/shared 0.4.0 → 0.6.0

package/__tests__/unit/NodeBase.test.ts

@@ -14,7 +14,10 @@ class TestNode extends NodeBase {
 	}
 }
 
-function createTestContext(overrides: Partial<Context> = {}): Context {
+// Loose `Record<string, unknown>` overrides so tests can pass shapes that
+// don't strictly match `Partial<Context>` (e.g. `config: { "<node>": ... }`,
+// which is the runtime layout but isn't reflected in the typed `ConfigContext`).
+function createTestContext(overrides: Record<string, unknown> = {}): Context {
 	return {
 		id: "test-ctx",
 		request: { body: {}, headers: {}, query: {}, params: {} },
@@ -27,7 +30,7 @@ function createTestContext(overrides: Partial<Context> = {}): Context {
 		eventLogger: null,
 		_PRIVATE_: null,
 		...overrides,
-	} as Context;
+	} as unknown as Context;
 }
 
 describe("NodeBase", () => {
@@ -46,10 +49,8 @@ describe("NodeBase", () => {
 			expect(n.name).toBe("");
 			expect(n.active).toBe(true);
 			expect(n.stop).toBe(false);
-			// set_var defaults to undefined (NOT false). false short-circuits
-			// PersistenceHelper.applyStepOutput and silently disables v2's
-			// default-store rule for every step that didn't explicitly set it.
-			expect(n.set_var).toBeUndefined();
+			expect(n.ephemeral).toBe(false);
+			expect(n.spread).toBe(false);
 			expect(n.contentType).toBe("");
 		});
 	});
@@ -162,7 +163,7 @@ describe("NodeBase", () => {
 
 		it("should access data parameter", () => {
 			const ctx = createTestContext();
-			const result = node.runJs("data.x", ctx, { x: 42 });
+			const result = node.runJs("data.x", ctx, { x: 42 } as unknown as Record<string, string>);
 			expect(result).toBe(42);
 		});
 
@@ -215,7 +216,7 @@ describe("NodeBase", () => {
 	describe("blueprintMapper()", () => {
 		it("should handle string input", () => {
 			const ctx = createTestContext();
-			const result = node.blueprintMapper("plain text", ctx);
+			const result = node.blueprintMapper("plain text" as unknown as Record<string, string>, ctx);
 			expect(result).toBe("plain text");
 		});
 
@@ -230,7 +231,7 @@ describe("NodeBase", () => {
 			const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {});
 			const ctx = createTestContext();
 			// null will cause mapper to fail
-			const result = node.blueprintMapper(null as unknown as Record<string, unknown>, ctx);
+			const result = node.blueprintMapper(null as unknown as Record<string, string>, ctx);
 			// Should not throw
 			expect(result).toBeNull();
 			consoleSpy.mockRestore();

package/__tests__/unit/utils/Mapper.test.ts

@@ -1,5 +1,6 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type Context from "../../../src/types/Context";
+import type ParamsDictionary from "../../../src/types/ParamsDictionary";
 import mapper from "../../../src/utils/Mapper";
 import { MapperResolutionError } from "../../../src/utils/MapperResolutionError";
 
@@ -66,7 +67,7 @@ describe("Mapper", () => {
 		it("handles nested data access via lodash.get", () => {
 			const ctx = createMockContext();
 			const data = { user: { name: "Alice" } };
-			const result = mapper.replaceString("Hi ${user.name}", ctx, data);
+			const result = mapper.replaceString("Hi ${user.name}", ctx, data as unknown as ParamsDictionary);
 			expect(result).toBe("Hi Alice");
 		});
 
@@ -100,22 +101,22 @@ describe("Mapper", () => {
 			// returned 0, the `||` fell through to runJs (which would throw
 			// for "count" not being in scope). Now `=== undefined` check
 			// preserves the 0.
-			expect(mapper.replaceString("${count}", ctx, { count: 0 })).toBe("0");
-			expect(mapper.replaceString("${flag}", ctx, { flag: false })).toBe("false");
-			expect(mapper.replaceString("${empty}", ctx, { empty: "" })).toBe("");
+			expect(mapper.replaceString("${count}", ctx, { count: 0 } as unknown as ParamsDictionary)).toBe("0");
+			expect(mapper.replaceString("${flag}", ctx, { flag: false } as unknown as ParamsDictionary)).toBe("false");
+			expect(mapper.replaceString("${empty}", ctx, { empty: "" } as unknown as ParamsDictionary)).toBe("");
 		});
 
 		it("JSON-encodes object values in interpolation (was: '[object Object]')", () => {
 			const ctx = createMockContext();
 			const data = { user: { id: 1, name: "Alice" } };
-			const result = mapper.replaceString("payload=${user}", ctx, data);
+			const result = mapper.replaceString("payload=${user}", ctx, data as unknown as ParamsDictionary);
 			// Pre-v0.3.x: `value as string` → "[object Object]". Now JSON.
 			expect(result).toBe('payload={"id":1,"name":"Alice"}');
 		});
 
 		it("renders null/undefined interpolation values as empty string", () => {
 			const ctx = createMockContext();
-			const result = mapper.replaceString("v=${x}", ctx, { x: null });
+			const result = mapper.replaceString("v=${x}", ctx, { x: null } as unknown as ParamsDictionary);
 			expect(result).toBe("v=");
 		});
 
@@ -220,7 +221,7 @@ describe("Mapper", () => {
 			setMode("strict");
 			const ctx = createMockContext();
 			expect(mapper.replaceString("js/1 + 2", ctx, {})).toBe(3);
-			expect(mapper.replaceString("${name}", ctx, { name: "ok" })).toBe("ok");
+			expect(mapper.replaceString("${name}", ctx, { name: "ok" } as unknown as ParamsDictionary)).toBe("ok");
 		});
 	});
 

package/dist/NodeBase.d.ts

@@ -13,17 +13,6 @@ export default abstract class NodeBase {
     active: boolean;
     stop: boolean;
     originalConfig: ParamsDictionary;
-    /**
-     * @deprecated v2 default-stores every step's output. `set_var: true` is
-     * a no-op (default behaviour); `set_var: false` is normalized to
-     * `ephemeral: true` at workflow load time. Reading this field is still
-     * supported for legacy code paths but new code should rely on `ephemeral`.
-     *
-     * Default is `undefined` (NOT `false`) — `false` here would short-circuit
-     * `PersistenceHelper.applyStepOutput` and disable the v2 default-store
-     * rule for every step that didn't explicitly set the field.
-     */
-    set_var?: boolean;
     /**
      * Alternative state key for this step's output. When set, the runner
      * stores result.data at `ctx.state[as]` instead of `ctx.state[name]`.

package/dist/NodeBase.js

@@ -9,17 +9,6 @@ export default class NodeBase {
     active = true;
     stop = false;
     originalConfig = {};
-    /**
-     * @deprecated v2 default-stores every step's output. `set_var: true` is
-     * a no-op (default behaviour); `set_var: false` is normalized to
-     * `ephemeral: true` at workflow load time. Reading this field is still
-     * supported for legacy code paths but new code should rely on `ephemeral`.
-     *
-     * Default is `undefined` (NOT `false`) — `false` here would short-circuit
-     * `PersistenceHelper.applyStepOutput` and disable the v2 default-store
-     * rule for every step that didn't explicitly set the field.
-     */
-    set_var;
     // =========================================================================
     // V2 persistence knobs — populated by Configuration.getSteps from the
     // step definition. Read by PersistenceHelper.applyStepOutput.

package/dist/NodeBase.js.map

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

package/dist/index.d.ts

@@ -5,7 +5,9 @@ import { Metrics, type MetricsType } from "./Metrics";
 import NodeBase from "./NodeBase";
 import Trigger from "./Trigger";
 import ConfigContext from "./types/ConfigContext";
+import type ConnectionContext from "./types/ConnectionContext";
 import Context from "./types/Context";
+import EnvContext from "./types/EnvContext";
 import ErrorContext from "./types/ErrorContext";
 import FunctionContext from "./types/FunctionContext";
 import LoggerContext from "./types/LoggerContext";
@@ -14,6 +16,8 @@ import RequestContext from "./types/RequestContext";
 import ResponseContext from "./types/ResponseContext";
 import StateContext from "./types/StateContext";
 import Step from "./types/Step";
+import type StreamContext from "./types/StreamContext";
 import VarsContext from "./types/VarsContext";
+import mapper from "./utils/Mapper";
 import MemoryUsage from "./utils/MemoryUsage";
-export { NodeBase, Context, RequestContext, ResponseContext, ErrorContext, LoggerContext, ConfigContext, Trigger, NodeConfigContext, FunctionContext, StateContext, VarsContext, Step, GlobalLogger, GlobalError, BlokError, type BlokErrorOpts, type NodeErrorPayload, ErrorCategory, ErrorSeverity, DEFAULT_HTTP_STATUS, DEFAULT_RETRYABLE, Metrics, MemoryUsage, type MetricsType, };
+export { NodeBase, Context, RequestContext, ResponseContext, EnvContext, ErrorContext, LoggerContext, ConfigContext, type ConnectionContext, type StreamContext, Trigger, NodeConfigContext, FunctionContext, StateContext, VarsContext, Step, GlobalLogger, GlobalError, BlokError, type BlokErrorOpts, type NodeErrorPayload, ErrorCategory, ErrorSeverity, DEFAULT_HTTP_STATUS, DEFAULT_RETRYABLE, Metrics, MemoryUsage, type MetricsType, mapper, };

package/dist/index.js

@@ -4,6 +4,7 @@ import GlobalLogger from "./GlobalLogger";
 import { Metrics } from "./Metrics";
 import NodeBase from "./NodeBase";
 import Trigger from "./Trigger";
+import mapper from "./utils/Mapper";
 import MemoryUsage from "./utils/MemoryUsage";
-export { NodeBase, Trigger, GlobalLogger, GlobalError, BlokError, ErrorCategory, ErrorSeverity, DEFAULT_HTTP_STATUS, DEFAULT_RETRYABLE, Metrics, MemoryUsage, };
+export { NodeBase, Trigger, GlobalLogger, GlobalError, BlokError, ErrorCategory, ErrorSeverity, DEFAULT_HTTP_STATUS, DEFAULT_RETRYABLE, Metrics, MemoryUsage, mapper, };
 //# 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,SAAS,EAAE,EAEjB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,aAAa,GAEb,MAAM,aAAa,CAAC;AACrB,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,OAAO,MAAM,WAAW,CAAC;AAYhC,OAAO,WAAW,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EACN,QAAQ,EAOR,OAAO,EAMP,YAAY,EACZ,WAAW,EACX,SAAS,EAGT,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,EACP,WAAW,GAEX,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAEjB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,aAAa,GAEb,MAAM,aAAa,CAAC;AACrB,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,OAAO,MAAM,WAAW,CAAC;AAehC,OAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,OAAO,WAAW,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EACN,QAAQ,EAUR,OAAO,EAMP,YAAY,EACZ,WAAW,EACX,SAAS,EAGT,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,EACP,WAAW,EAEX,MAAM,GACN,CAAC"}

package/dist/types/ConnectionContext.d.ts

@@ -0,0 +1,79 @@
+/**
+ * v0.7 — per-connection API exposed on `ctx.connection` for triggers
+ * that hold long-lived bidirectional channels (WebSocket today; SSE
+ * gets a streaming variant in PR 3).
+ *
+ * Authors interact with the connection through this object — the
+ * trigger wraps the underlying transport's send/close primitives and
+ * tracks per-connection state. Lifecycle:
+ *
+ *   - On `connect`: trigger creates the connection, runs the workflow
+ *     once with `ctx.connection` bound. Author can call
+ *     `setAttachment()` to store per-connection state.
+ *   - On `message`: trigger runs the workflow again with the same
+ *     `ctx.connection` instance — author reads `attachment` to recover
+ *     the per-connection state.
+ *   - On `disconnect`: same connection, last run. Cleanup happens here.
+ *
+ * Absent on contexts built for HTTP / Worker / Cron triggers.
+ */
+export interface ConnectionContext {
+    /** Stable connection identifier (uuid). Set once at connect. */
+    readonly id: string;
+    /**
+     * Send data to THIS connection.
+     * - Text payloads: send a string (typically `JSON.stringify(...)`).
+     * - Binary payloads: send a `Uint8Array` or `ArrayBuffer`.
+     *
+     * Buffered if the underlying socket is busy; backpressure visible
+     * via the trigger's `messageRateLimit` and Studio trace metrics.
+     */
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    /**
+     * Close THIS connection cleanly. Subsequent `send` calls are no-ops.
+     * Triggers the `disconnect` workflow run as a final step.
+     *
+     * @param code   Close code per RFC 6455 (default 1000 — normal).
+     * @param reason Human-readable reason (max 123 bytes per RFC).
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * Store per-connection state. Survives across message-event workflow
+     * runs on the same connection — the "userId + joinedAt + cursor"
+     * pattern. Reset by every call (no merge).
+     *
+     * Inspired by Cloudflare Durable Objects'
+     * `state.serializeAttachment()` API. Capped at 2 KB serialized JSON;
+     * larger values are rejected with a warning log (the connection
+     * stays open).
+     */
+    setAttachment(value: unknown): void;
+    /**
+     * Retrieve per-connection state set by `setAttachment()`. Returns
+     * `undefined` if nothing was set on this connection.
+     */
+    readonly attachment: unknown;
+    /**
+     * Channel/room membership for fan-out broadcasts. Multiple
+     * connections can join the same room; `@blokjs/ws-broadcast`
+     * targets every member.
+     */
+    joinRoom(name: string): void;
+    leaveRoom(name: string): void;
+    readonly rooms: ReadonlySet<string>;
+    /**
+     * v0.7 — broadcast a message to every connection in the named
+     * room (workflow-scoped). Returns the number of recipients
+     * the trigger successfully sent to.
+     *
+     * Set `exceptSelf: true` to skip the connection that triggered
+     * the current workflow run (the "send to everyone except me"
+     * pattern). Bound by the trigger via this `ctx.connection`
+     * accessor so helper nodes (`@blokjs/ws-broadcast`) don't need
+     * to import the trigger package directly.
+     */
+    broadcast(room: string, data: string | ArrayBuffer | Uint8Array, opts?: {
+        exceptSelf?: boolean;
+    }): number;
+}
+export default ConnectionContext;

package/dist/types/ConnectionContext.js

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

package/dist/types/ConnectionContext.js.map

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

package/dist/types/Context.d.ts

@@ -1,5 +1,6 @@
 import type GlobalLogger from "../GlobalLogger";
 import type ConfigContext from "./ConfigContext";
+import type ConnectionContext from "./ConnectionContext";
 import type EnvContext from "./EnvContext";
 import type ErrorContext from "./ErrorContext";
 import type FunctionContext from "./FunctionContext";
@@ -7,6 +8,7 @@ import type LoggerContext from "./LoggerContext";
 import type RequestContext from "./RequestContext";
 import type ResponseContext from "./ResponseContext";
 import type StateContext from "./StateContext";
+import type StreamContext from "./StreamContext";
 import type VarsContext from "./VarsContext";
 /**
  * The runtime context for a single workflow execution. One Context object
@@ -111,6 +113,38 @@ type Context = {
      * tests.
      */
     signal?: AbortSignal;
+    /**
+     * v0.7 — per-connection API for long-lived bidirectional triggers
+     * (WebSocket). Present on contexts dispatched by `WebSocketTrigger`;
+     * absent on HTTP / Worker / Cron contexts.
+     *
+     * Authors call `ctx.connection.send(...)` to push to the specific
+     * connection that fired the event, `ctx.connection.close(...)` to
+     * terminate it, or `ctx.connection.setAttachment(...)` to store
+     * per-connection state that survives across the connect → N×message
+     * → disconnect lifecycle.
+     *
+     * Helper nodes (`@blokjs/ws-reply`, `@blokjs/ws-broadcast`,
+     * `@blokjs/ws-close`) read this field to interact with the
+     * connection without authors having to thread the ws handle through
+     * step inputs.
+     */
+    connection?: ConnectionContext;
+    /**
+     * v0.7 — per-stream API for server-push HTTP triggers (SSE).
+     * Present on contexts dispatched by `SSETrigger` once per stream
+     * open; absent on HTTP / WebSocket / Worker / Cron contexts.
+     *
+     * Authors call `ctx.stream.writeSSE({ event, data, id, retry })`
+     * to emit frames, `ctx.stream.close()` to end the stream, and
+     * read `ctx.stream.signal.aborted` to detect client disconnects
+     * inside long-running loops.
+     *
+     * Helper nodes (`@blokjs/sse-stream`) read this field so workflow
+     * authors don't have to thread the stream handle through step
+     * inputs.
+     */
+    stream?: StreamContext;
     _PRIVATE_: unknown;
 };
 export default Context;

package/dist/types/StreamContext.d.ts

@@ -0,0 +1,92 @@
+/**
+ * v0.7 — per-stream API exposed on `ctx.stream` for triggers that hold
+ * a long-lived, server-push HTTP channel (SSE today; the `streaming`
+ * Hono helper underneath). Authors emit events through this object;
+ * the trigger owns the underlying `c.writeSSE` / drain handling.
+ *
+ * Lifecycle (Pattern A — one workflow run per stream open):
+ *
+ *   - The SSE trigger opens the HTTP stream via Hono's `streamSSE`,
+ *     creates this object, attaches it to `ctx.stream`, and dispatches
+ *     the workflow once.
+ *   - The workflow body writes zero or more events via
+ *     `writeSSE(...)`, typically via `@blokjs/sse-stream` consuming an
+ *     async iterator from `@blokjs/sse-subscribe`.
+ *   - The workflow returns when its iterator ends OR when
+ *     `ctx.stream.signal.aborted` flips (client closed). The trigger
+ *     ends the run with status `completed`.
+ *
+ * Absent on contexts built for HTTP (request/response), Worker, Cron,
+ * or WebSocket triggers.
+ */
+export interface StreamContext {
+    /** Stable stream/connection identifier (uuid). Set once at open. */
+    readonly id: string;
+    /**
+     * Write one SSE-framed event to the client. Each call produces a
+     * `data:` (and optional `event:`, `id:`, `retry:`) frame followed
+     * by a blank line.
+     *
+     * `data` is JSON-stringified when it's not a string. Pass a string
+     * to write the payload verbatim. Returns once the chunk has been
+     * accepted by Node's stream (honors backpressure via `drain`).
+     */
+    writeSSE(opts: {
+        event?: string;
+        data: unknown;
+        id?: string;
+        retry?: number;
+    }): Promise<void>;
+    /**
+     * Write an SSE comment line (`: <text>\n\n`). Used internally for
+     * heartbeats; authors rarely need this directly. Comments are
+     * ignored by `EventSource` clients but keep proxies from idling
+     * the connection.
+     */
+    writeComment(text: string): Promise<void>;
+    /**
+     * Close the stream cleanly. Subsequent `writeSSE` calls are no-ops.
+     * The workflow run ends at the next yield point.
+     */
+    close(): void;
+    /** True after `close()` is called or the client disconnects. */
+    readonly closed: boolean;
+    /**
+     * `AbortSignal` that fires when the client disconnects (browser tab
+     * closed, network drop, manual `EventSource.close()`). Long-running
+     * iterators / fetches should be bound to this signal so they unwind
+     * promptly:
+     *
+     *     for await (const evt of source) {
+     *       if (ctx.stream.signal.aborted) break;
+     *       await ctx.stream.writeSSE({ data: evt });
+     *     }
+     */
+    readonly signal: AbortSignal;
+    /**
+     * `Last-Event-Id` HTTP header value from the inbound request, if
+     * the client is reconnecting. Helper nodes (`@blokjs/sse-subscribe`)
+     * read this to resume from the indicated cursor.
+     */
+    readonly lastEventId: string | null;
+    /**
+     * v0.7 — subscribe to the in-process SSE event bus. Returns an
+     * async iterator that yields events published to any of the named
+     * channels. When `lastEventId` is provided (or omitted — defaults
+     * to `ctx.stream.lastEventId`), buffered events with `seq > lastEventId`
+     * are replayed before live events begin. Caller stops the
+     * subscription by exiting the for-await loop or calling
+     * `iterator.return()`.
+     *
+     * Bound by the trigger so helper nodes (`@blokjs/sse-subscribe`,
+     * `@blokjs/sse-stream`) don't have to import the trigger directly.
+     */
+    subscribe(channels: string[], lastEventId?: string | null): AsyncIterableIterator<{
+        channel: string;
+        id: string;
+        event?: string;
+        data: unknown;
+        timestamp: number;
+    }>;
+}
+export default StreamContext;

package/dist/types/StreamContext.js

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

package/dist/types/StreamContext.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blokjs/shared",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"description": "Shared class, interfaces and types",
 	"type": "module",
 	"main": "dist/index.js",