@lensmcp/core 1.16.33 → 1.17.1

package/lib/event-bus.d.ts

@@ -7,6 +7,25 @@ export interface EventBusOptions {
     capacity?: number;
     /** Optional hook fired when one or more events are dropped. */
     onDrop?: (droppedCount: number) => void;
+    /**
+     * Applied to every event ONCE, before any subscriber sees it — the single
+     * choke point for admission policy.
+     *
+     * WHY here and not at `Session`'s storage subscription: reducers subscribe
+     * to this bus DIRECTLY, so they are SIBLINGS of storage, not downstream of
+     * it. A payload-size policy applied at the storage subscription would leave
+     * all 16 reducers holding the untrimmed object — and they do hold it
+     * (`apps/flow` + `apps/graph` retain whole events, `apps/runtime` retains
+     * `event.raw` verbatim, `apps/valtio` + `apps/react` + `apps/visual` retain
+     * raw sub-objects by reference). `publish` is the only point upstream of
+     * every holder, so that is where the ingest clamp goes; `Session` installs
+     * it.
+     *
+     * Must be cheap and must not throw — it runs per event at high frequency.
+     * Returning the input unchanged is the expected fast path. Event ORDER is
+     * unaffected: this is a 1:1 map, never a filter.
+     */
+    transform?: (event: BaseEvent) => BaseEvent;
 }
 /**
  * In-process, single-threaded, bounded event bus. Subscribers are notified
@@ -19,6 +38,7 @@ export interface EventBusOptions {
 export declare class EventBus {
     readonly capacity: number;
     private readonly onDrop?;
+    private readonly transform?;
     private readonly subs;
     private dropped;
     constructor(opts?: EventBusOptions);

package/lib/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/lib/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAOD;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,GAAE,eAAoB;IAKtC,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAqB/B,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW;IAQnE,mDAAmD;IACnD,YAAY,IAAI,MAAM;IAItB,kDAAkD;IAClD,eAAe,IAAI,MAAM;CAG1B"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/lib/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;CAC7C;AAOD;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,GAAE,eAAoB;IAMtC,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IA+B/B,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW;IAQnE,mDAAmD;IACnD,YAAY,IAAI,MAAM;IAItB,kDAAkD;IAClD,eAAe,IAAI,MAAM;CAG1B"}

package/lib/event-bus.js

@@ -12,6 +12,7 @@ export class EventBus {
         this.dropped = 0;
         this.capacity = opts.capacity ?? 10_000;
         this.onDrop = opts.onDrop;
+        this.transform = opts.transform;
     }
     publish(event) {
         if (this.subs.size > this.capacity) {
@@ -19,11 +20,22 @@ export class EventBus {
             this.onDrop?.(1);
             return;
         }
+        let delivered = event;
+        if (this.transform) {
+            try {
+                delivered = this.transform(event) ?? event;
+            }
+            catch {
+                // A misbehaving transform must never swallow an event: fall back to
+                // the original rather than dropping observability on the floor.
+                delivered = event;
+            }
+        }
         for (const sub of this.subs) {
-            if (sub.filter && !sub.filter(event))
+            if (sub.filter && !sub.filter(delivered))
                 continue;
             try {
-                const ret = sub.handler(event);
+                const ret = sub.handler(delivered);
                 if (ret && typeof ret.then === 'function') {
                     ret.catch(() => {
                         /* swallow async handler errors; reducers must not affect bus */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/core",
-  "version": "1.16.33",
+  "version": "1.17.1",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -14,7 +14,7 @@
     }
   },
   "dependencies": {
-    "@lensmcp/protocol-types": "1.16.33",
+    "@lensmcp/protocol-types": "1.17.1",
     "tslib": "^2.3.0"
   },
   "license": "Apache-2.0",