@loomwork/projection-runtime 0.0.0-stage → 0.1.1

package/dist/InMemoryProjectionRuntime.js.map

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

package/dist/esm/InMemoryProjectionRuntime.js

@@ -0,0 +1,301 @@
+/**
+ * Cap on how many matching events a lazy projection buffers while its fold code loads. A local
+ * `import()` resolves in well under this window; exceeding it means the load is stuck or broken,
+ * so we stop buffering (the projection is a read-model, rebuildable from the log) rather than
+ * grow memory without bound. Generous so normal bursts never hit it.
+ */
+const LAZY_BUFFER_LIMIT = 10_000;
+/**
+ * How many least-recently-touched executions eviction will step over looking for an
+ * unsubscribed one. Bounds the per-event cost of `touch`; see its comment for why giving up
+ * (and sitting one entry over the cap) is the right failure direction.
+ */
+const EVICTION_SCAN_LIMIT = 64;
+export class InMemoryProjectionRuntime {
+    projections = new Map();
+    states = new Map();
+    subscribers = new Map();
+    // Selector-subscribers, keyed like `subscribers`. Kept separate so whole-state
+    // subscription stays a zero-overhead fast path when no selector-subscribers exist.
+    selectorSubscribers = new Map();
+    coalesce;
+    dirtyKeys = new Set();
+    flushScheduled = false;
+    // Insertion order = LRU order over distinct executions, for the retention bound.
+    maxExecutions;
+    execOrder = new Map();
+    constructor(config) {
+        this.coalesce = config?.coalesceNotifications ?? false;
+        this.maxExecutions = config?.maxExecutions ?? 10_000;
+    }
+    /** Drop all retained state + subscribers for an execution (e.g. after it completes). */
+    forget(executionId) {
+        for (const projectionId of this.projections.keys()) {
+            const key = this.stateKey(projectionId, executionId);
+            this.states.delete(key);
+            this.subscribers.delete(key);
+            this.selectorSubscribers.delete(key);
+        }
+        this.execOrder.delete(executionId);
+    }
+    /** True if anything is currently subscribed to any projection of this execution. */
+    hasSubscribers(executionId) {
+        for (const projectionId of this.projections.keys()) {
+            const key = this.stateKey(projectionId, executionId);
+            if (this.subscribers.has(key) || this.selectorSubscribers.has(key))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Drop an execution's retained STATE only — never its subscriber registries.
+     *
+     * The distinction is the whole point. `forget` is an explicit "this execution is done"
+     * from a caller who knows it; eviction is a cache decision the caller never made, and
+     * dropping a live subscriber's registry there does not degrade — it disconnects. The
+     * handler set is captured by closure in `subscribe`, so once the map entry is gone
+     * `notify` looks up a key that no longer exists and that subscriber never fires again.
+     */
+    evictState(executionId) {
+        for (const projectionId of this.projections.keys()) {
+            this.states.delete(this.stateKey(projectionId, executionId));
+        }
+        this.execOrder.delete(executionId);
+    }
+    touch(executionId) {
+        this.execOrder.delete(executionId);
+        this.execOrder.set(executionId, true);
+        if (this.execOrder.size <= this.maxExecutions)
+            return;
+        // Evict least-recently-touched first, but SKIP anything with a live subscriber:
+        // evicting a state someone is folding into resets it to `initialState`, which is
+        // corruption rather than a cache miss (the same rule `AgentSurfaceRuntime` follows).
+        //
+        // The scan is bounded rather than exhaustive: if the oldest entries are all subscribed,
+        // giving up costs one over-cap entry, while scanning on would make `touch` — which runs
+        // once per event — O(retained). Over the cap is the safe direction; `forget` is the
+        // explicit remedy.
+        let examined = 0;
+        for (const candidate of this.execOrder.keys()) {
+            if (examined++ >= EVICTION_SCAN_LIMIT)
+                return;
+            if (this.hasSubscribers(candidate))
+                continue;
+            this.evictState(candidate);
+            return;
+        }
+    }
+    stateKey(projectionId, executionId) {
+        return `${projectionId}::${executionId}`;
+    }
+    register(projection) {
+        const active = {
+            id: projection.id,
+            initialState: projection.initialState,
+            ...(projection.version !== undefined && { version: projection.version }),
+            loading: false,
+            buffer: [],
+            ...(projection.handlers !== undefined && {
+                handlers: projection.handlers,
+            }),
+            ...(projection.lazy !== undefined && {
+                eventTypes: new Set(projection.lazy.eventTypes),
+                load: projection.lazy.load,
+            }),
+        };
+        this.projections.set(projection.id, active);
+    }
+    getState(projectionId, executionId) {
+        const key = this.stateKey(projectionId, executionId);
+        if (this.states.has(key)) {
+            return this.states.get(key);
+        }
+        const projection = this.projections.get(projectionId);
+        if (!projection) {
+            throw new Error(`Projection "${projectionId}" is not registered`);
+        }
+        return projection.initialState;
+    }
+    subscribe(projectionId, executionId, handler) {
+        const key = this.stateKey(projectionId, executionId);
+        if (!this.subscribers.has(key)) {
+            this.subscribers.set(key, new Set());
+        }
+        const handlers = this.subscribers.get(key);
+        const wrapper = (s) => handler(s);
+        handlers.add(wrapper);
+        return () => {
+            handlers.delete(wrapper);
+            // Only retire the map entry if it is still OUR set. After an explicit `forget`, a later
+            // subscriber installs a fresh set under the same key; without this identity check a
+            // stale unsubscribe would empty its own orphaned set and then delete the live one,
+            // silently disconnecting a subscriber that did nothing wrong.
+            if (handlers.size === 0 && this.subscribers.get(key) === handlers) {
+                this.subscribers.delete(key);
+            }
+        };
+    }
+    subscribeSelector(projectionId, executionId, selector, handler, isEqual = Object.is) {
+        const key = this.stateKey(projectionId, executionId);
+        let set = this.selectorSubscribers.get(key);
+        if (!set) {
+            set = new Set();
+            this.selectorSubscribers.set(key, set);
+        }
+        const sel = selector;
+        const entry = {
+            selector: sel,
+            isEqual: isEqual,
+            handler: handler,
+            // Seed from current state so change-only holds from the first event on.
+            last: sel(this.peekState(projectionId, executionId)),
+        };
+        set.add(entry);
+        return () => {
+            set.delete(entry);
+            // Same identity check as `subscribe` — never retire a set that is no longer ours.
+            if (set.size === 0 && this.selectorSubscribers.get(key) === set) {
+                this.selectorSubscribers.delete(key);
+            }
+        };
+    }
+    // Current state without throwing for an unregistered/unseen projection (unlike
+    // getState) — used to seed a selector-subscription's `last`. resolve-by-path
+    // selectors are null-safe, so an absent state seeds cleanly to `undefined`.
+    peekState(projectionId, executionId) {
+        const key = this.stateKey(projectionId, executionId);
+        if (this.states.has(key))
+            return this.states.get(key);
+        return this.projections.get(projectionId)?.initialState;
+    }
+    handleEvent(event) {
+        for (const [, projection] of this.projections) {
+            if (projection.handlers !== undefined) {
+                // Eager (or an already-loaded lazy) projection — fold synchronously as before.
+                this.apply(projection, projection.handlers, event);
+                continue;
+            }
+            // Lazy projection: gate on the compiler-recorded event types WITHOUT loading the
+            // fold code. A non-matching event never touches this projection (0 code loaded).
+            // A projection whose load already failed permanently is skipped (no buffer, no retry).
+            if (projection.loadFailed === true)
+                continue;
+            if (projection.eventTypes?.has(event.eventType) !== true)
+                continue;
+            // First matching event: buffer it (and any that arrive during load), kick the
+            // one-time import, and drain the buffer in arrival order once the code is ready.
+            // Bounded so a stuck/broken load can't grow the buffer without limit.
+            if (projection.buffer.length < LAZY_BUFFER_LIMIT)
+                projection.buffer.push(event);
+            if (!projection.loading) {
+                projection.loading = true;
+                projection.load()
+                    .then((handlers) => {
+                    projection.handlers = handlers;
+                    projection.eventTypes = undefined; // resolved — the eager path takes over
+                    projection.loading = false;
+                    const buffered = projection.buffer;
+                    projection.buffer = [];
+                    for (const buf of buffered)
+                        this.apply(projection, handlers, buf);
+                })
+                    .catch((err) => {
+                    // A chunk load failure is not transient (missing/broken module). Abandon the
+                    // projection: free the buffer and stop retrying, rather than leak memory and
+                    // re-import on every matching event. The read-model can be rebuilt from the log.
+                    projection.loading = false;
+                    projection.loadFailed = true;
+                    projection.buffer = [];
+                    console.warn(`[loom] projection "${projection.id}" failed to load its fold code — it will not update: ${String(err)}`);
+                });
+            }
+        }
+        this.touch(event.executionId);
+    }
+    /** Fold one event into a projection's state via the matching handler, then notify. */
+    apply(projection, handlers, event) {
+        // Own-key lookup: the fold map is user-authored and the event type is caller-controlled,
+        // so `handlers["__proto__"]` would resolve to `Object.prototype` — truthy, defeating the
+        // `!handler` guard, and then called as a function. Mirrors `getHandler` in @loomwork/replay-vm.
+        if (!Object.hasOwn(handlers, event.eventType))
+            return;
+        const handler = handlers[event.eventType];
+        if (typeof handler !== "function")
+            return;
+        const key = this.stateKey(projection.id, event.executionId);
+        // One `get` on the hot path (this runs per event per projection); `has` is consulted only
+        // in the rare case where the retained state is itself `undefined`.
+        const retained = this.states.get(key);
+        const currentState = retained !== undefined || this.states.has(key) ? retained : projection.initialState;
+        const nextState = handler(currentState, event);
+        this.states.set(key, nextState);
+        this.notify(key, nextState);
+    }
+    seedState(projectionId, executionId, state) {
+        const key = this.stateKey(projectionId, executionId);
+        this.states.set(key, state);
+        this.touch(executionId);
+    }
+    /**
+     * ADR 0095 — the declared `version` of every registered projection that has one.
+     *
+     * Projections that declare nothing are ABSENT rather than present-and-empty: the caller
+     * compares this against what an artifact recorded, and a key mapped to `""` would compare
+     * equal to another empty declaration and read as a verified match.
+     */
+    pins() {
+        // No prototype: a projection registered as `__proto__` would otherwise set one instead
+        // of adding a key, and vanish from every comparison without a finding.
+        const pins = Object.create(null);
+        for (const [id, projection] of this.projections) {
+            if (projection.version !== undefined)
+                pins[id] = projection.version;
+        }
+        return pins;
+    }
+    notify(key, state) {
+        if (!this.coalesce) {
+            this.emit(key, state);
+            return;
+        }
+        // Defer: mark dirty and flush once per microtask with the latest state.
+        this.dirtyKeys.add(key);
+        if (!this.flushScheduled) {
+            this.flushScheduled = true;
+            queueMicrotask(() => this.flush());
+        }
+    }
+    flush() {
+        this.flushScheduled = false;
+        const keys = Array.from(this.dirtyKeys);
+        this.dirtyKeys.clear();
+        for (const key of keys) {
+            // Read the current state so subscribers always see the latest value even
+            // when many events for the same key arrived within the batch.
+            this.emit(key, this.states.get(key));
+        }
+    }
+    emit(key, state) {
+        const handlers = this.subscribers.get(key);
+        if (handlers) {
+            for (const handler of handlers) {
+                handler(state);
+            }
+        }
+        // Selector-subscribers: recompute each slice against the latest state and fire
+        // only those whose slice actually changed — so an unrelated slice's update never
+        // wakes this subscriber. Snapshot the set so an unsubscribe during iteration
+        // (a handler tearing itself down) can't mutate the live set mid-loop.
+        const selectors = this.selectorSubscribers.get(key);
+        if (selectors) {
+            for (const entry of [...selectors]) {
+                const next = entry.selector(state);
+                if (!entry.isEqual(entry.last, next)) {
+                    entry.last = next;
+                    entry.handler(next);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=InMemoryProjectionRuntime.js.map

package/dist/esm/InMemoryProjectionRuntime.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { InMemoryProjectionRuntime, } from "./InMemoryProjectionRuntime";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAE1B,MAAM,6BAA6B,CAAC"}

package/dist/esm/types.js

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

package/dist/esm/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { InMemoryProjectionRuntime, type InMemoryProjectionRuntimeConfig, } from "./InMemoryProjectionRuntime";
+export type { Projection, ProjectionRuntime } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,+BAA+B,GACrC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryProjectionRuntime = void 0;
+var InMemoryProjectionRuntime_1 = require("./InMemoryProjectionRuntime");
+Object.defineProperty(exports, "InMemoryProjectionRuntime", { enumerable: true, get: function () { return InMemoryProjectionRuntime_1.InMemoryProjectionRuntime; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yEAGqC;AAFnC,sIAAA,yBAAyB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+import type { EventEnvelope } from "@loomwork/core";
+export type ProjectionFoldMap<TState> = {
+    [eventType: string]: (state: TState, event: EventEnvelope) => TState;
+};
+export interface Projection<TState> {
+    id: string;
+    /**
+     * ADR 0095 — the declared semantics of this fold. An artifact that binds to `id` (a
+     * blueprint's `DataBinding`, a saved report) records this string, and `checkVersionPins`
+     * compares what was recorded against what is registered: a changed query, filter,
+     * aggregation or window then reads as a finding instead of a silently different number.
+     *
+     * Bump it when the fold's MEANING changes — a refactor producing the same state is not a
+     * new version. Declared rather than derived, for the reason `flowContentHash` excludes
+     * handler code: a fold closure has no stable fingerprint.
+     */
+    version?: string;
+    initialState: TState;
+    /** The eager fold map — present when handlers are inline / already resolved. */
+    handlers?: ProjectionFoldMap<TState>;
+    /**
+     * Event-type-gated lazy form: the fold code stays unloaded until an event whose type
+     * is in `eventTypes` first arrives, at which point `load()` is `import()`-ed once (its
+     * events buffered until ready). A projection whose event types never fire never loads
+     * its code. Exactly one of `handlers` / `lazy` should be set.
+     */
+    lazy?: {
+        eventTypes: string[];
+        load: () => Promise<ProjectionFoldMap<TState>>;
+    };
+}
+export interface ProjectionRuntime {
+    register<TState>(projection: Projection<TState>): void;
+    getState<TState>(projectionId: string, executionId: string): TState;
+    subscribe<TState>(projectionId: string, executionId: string, handler: (state: TState) => void): () => void;
+    /**
+     * Fine-grained ("selector") subscription: invoke `handler` only when
+     * `selector(state)` changes — by `isEqual`, default `Object.is` — rather than on
+     * every projection event. The framework-agnostic building block for live rendering
+     * surfaces (terminal, editor webview, TUI, …): each derives a slice-granular,
+     * memoized subscription from the shared read-model without reimplementing the diff.
+     *
+     * Change-only, exactly like {@link subscribe}: it does NOT fire on subscribe. The
+     * last slice is seeded from current state at subscribe time, so the first `handler`
+     * call is the first genuine change. Read the initial value via `getState` + selector.
+     * Participates in `coalesceNotifications` — a burst collapses to one call per changed
+     * slice per microtask.
+     */
+    subscribeSelector<TState, TSlice>(projectionId: string, executionId: string, selector: (state: TState) => TSlice, handler: (slice: TSlice) => void, isEqual?: (a: TSlice, b: TSlice) => boolean): () => void;
+    handleEvent(event: EventEnvelope): void;
+    seedState(projectionId: string, executionId: string, state: unknown): void;
+    /**
+     * ADR 0095 — the declared `version` of every registered projection that has one, by id.
+     *
+     * OPTIONAL on the interface so an existing implementation stays valid; a runtime that
+     * omits it simply cannot answer the question, and `checkVersionPins` reports that as
+     * `unpinned` rather than as a pass.
+     */
+    pins?(): Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,iBAAiB,CAAC,MAAM,IAAI;IACtC,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,MAAM,CAAC;CACtE,CAAC;AAEF,MAAM,WAAW,UAAU,CAAC,MAAM;IAChC,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrC;;;;;OAKG;IACH,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;KAChD,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IACpE,SAAS,CAAC,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B,MAAM,IAAI,CAAC;IACd;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAC9B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACnC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAC1C,MAAM,IAAI,CAAC;IACd,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3E;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@loomwork/projection-runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Event-to-projection transformation runtime with live subscriptions",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "node": "./dist/index.js",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@loomwork/core": "^0.1.1",
+    "@loomwork/event-runtime": "^0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chhetrisushil/loom.git",
+    "directory": "packages/projection-runtime"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "!src/**/__fixtures__",
+    "!src/**/__snapshots__",
+    "!src/**/__golden__",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build && rm -rf dist/esm && tsc -p tsconfig.esm.json",
+    "build:esm": "rm -rf dist/esm && tsc -p tsconfig.esm.json",
+    "dev": "tsc --build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bench": "vitest bench --run",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck:tests": "tsc -p tsconfig.test.json"
+  }
 }