@m4l/realtime-runtime 1.1.0 → 1.2.0

package/web/runtime.js

@@ -1,95 +1,97 @@
 import { cloneDeep as l } from "lodash-es";
 import { createRealTimeStore as m } from "./store.js";
-import { createGetOrCreateRuntime as R } from "../engine/runtimeRegistry.js";
+import { createGetOrCreateRuntime as p } from "../engine/runtimeRegistry.js";
 import { disposeRealtimeRuntime as A } from "../engine/runtimeRegistry.js";
-import { createRealtimeRuntimeApi as p } from "../engine/runtimeCore.js";
+import { createRealtimeRuntimeApi as R } from "../engine/runtimeCore.js";
 import { createRealTimeProducerTools as d } from "./tools.js";
-function f(r, s) {
-  return s.reduce((n, t) => {
-    const e = t.staleResourceTtlMs;
-    if (e === void 0 || e <= 0)
+function f(s, r) {
+  return r.reduce((n, e) => {
+    const t = e.staleResourceTtlMs;
+    if (t === void 0 || t <= 0)
       return n;
-    const o = t.staleResourceCleanupIntervalMs ?? Math.max(5e3, Math.min(e, 3e4)), u = globalThis.setInterval(() => {
-      r.getState().realTimeProducerActions.cleanupStaleResources(
-        t.resourceTypeId
+    const o = e.staleResourceCleanupIntervalMs ?? Math.max(5e3, Math.min(t, 3e4)), u = globalThis.setInterval(() => {
+      s.getState().realTimeProducerActions.cleanupStaleResources(
+        e.resourceTypeId
       );
     }, o);
     return n.push(u), n;
   }, []);
 }
-function T(r) {
-  Object.values(r.getState().hasResourcesTypes).forEach((s) => {
-    s.sourceDataClass.stop();
+function T(s) {
+  Object.values(s.getState().hasResourcesTypes).forEach((r) => {
+    r.sourceDataClass.stop();
   });
 }
-function b(r, s) {
+function b(s, r) {
   let n = !1;
   return function() {
-    n || (n = !0, s.forEach((e) => {
-      globalThis.clearInterval(e);
-    }), T(r));
+    n || (n = !0, r.forEach((t) => {
+      globalThis.clearInterval(t);
+    }), T(s));
   };
 }
-function h(r, s, n) {
-  return p({
+function h(s, r, n) {
+  return R({
     dispose: n,
-    getSnapshot: (t) => l(
-      r.getState().hasResourcesTypes[t]?.hasResources ?? {}
+    getResourceTypeSnapshot: (e) => r.getResourceTypeSnapshot(e),
+    getSnapshot: (e) => l(
+      r.getResourceTypeSnapshot(e)
     ),
-    getStatus: (t) => r.getState().hasResourcesTypes[t]?.status,
-    subscribe: (t, e) => {
-      s.subscribe(t, e);
+    getStatus: (e) => s.getState().hasResourcesTypes[e]?.status,
+    subscribe: (e, t) => {
+      r.subscribe(e, t);
     },
-    unsubscribe: (t, e) => {
-      s.unsubscribe(t, e);
+    subscribeResourceType: (e, t) => r.subscribeResourceType(e, t),
+    unsubscribe: (e, t) => {
+      r.unsubscribe(e, t);
     }
   });
 }
-function i(r, s) {
-  const { storeDevtoolsEnabled: n = !1, ...t } = r, e = m(
-    t,
+function a(s, r) {
+  const { storeDevtoolsEnabled: n = !1, ...e } = s, t = m(
+    e,
     n,
-    s
+    r
   ), o = f(
-    e,
-    t.resourceTypesConfig
-  ), u = b(e, o), a = d(e), c = h(e, a, u);
-  return e.getState().realTimeProducerActions.init(), {
+    t,
+    e.resourceTypesConfig
+  ), u = b(t, o), i = d(t), c = h(t, i, u);
+  return t.getState().realTimeProducerActions.init(), {
     runtime: c,
-    store: e,
-    tools: a
+    store: t,
+    tools: i
   };
 }
-function C(r, s) {
-  return i(
-    r,
-    s
+function P(s, r) {
+  return a(
+    s,
+    r
   ).runtime;
 }
-function M(r, s) {
-  const { runtime: n, store: t, tools: e } = i(r, s);
+function C(s, r) {
+  const { runtime: n, store: e, tools: t } = a(s, r);
   return {
     ...n,
-    store: t,
-    tools: e
+    store: e,
+    tools: t
   };
 }
-function D(r) {
-  const s = R(r);
-  return function(t) {
-    const { runtimeKey: e, ...o } = t;
-    return s({
+function M(s) {
+  const r = p(s);
+  return function(e) {
+    const { runtimeKey: t, ...o } = e;
+    return r({
       createProps: {
         ...o,
-        storeId: o.storeId ?? e
+        storeId: o.storeId ?? t
       },
-      runtimeKey: e
+      runtimeKey: t
     });
   };
 }
 export {
-  D as createGetOrCreateRealtimeRuntime,
-  C as createRealtimeRuntime,
-  M as createRealtimeRuntimeBundle,
+  M as createGetOrCreateRealtimeRuntime,
+  P as createRealtimeRuntime,
+  C as createRealtimeRuntimeBundle,
   A as disposeRealtimeRuntime
 };

package/web/store.d.ts

@@ -1,10 +1,10 @@
-import { OnMessagesStoreCallback } from '../contracts';
+import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback } from '../contracts';
 import { SourceDataBase } from '../transport/SourceDataBase';
 import { CreateRealTimeStoreProps, CreateRealtimeRuntimeProps, InitialRealTimeProducerStoreProps, RealTimeProducerStoreStateWithActions } from './types';
 /**
  * Factory contract used to create one source  mechanism without forcing one global implementation.
  */
-export type CreateRealTimeSourceData = (config: InitialRealTimeProducerStoreProps['resourceTypesConfig'][number], onMessages: OnMessagesStoreCallback) => SourceDataBase;
+export type CreateRealTimeSourceData = (config: InitialRealTimeProducerStoreProps['resourceTypesConfig'][number], onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback) => SourceDataBase;
 /**
  * Create the producer-side realtime store.
  */

package/web/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EAIxB,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAQlE,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,EAGjC,qCAAqC,EACtC,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,iCAAiC,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,EACxE,UAAU,EAAE,uBAAuB,KAChC,cAAc,CAAC;AAqBpB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,wBAAwB,EACnC,oBAAoB,qBAAQ,EAC5B,gBAAgB,EAAE,wBAAwB;;EAgM3C;AACD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACvE,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,GAClC,CAAC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAOjC,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAYlE,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,EAIjC,qCAAqC,EACtC,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,iCAAiC,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,EACxE,UAAU,EAAE,uBAAuB,EACnC,mBAAmB,CAAC,EAAE,gCAAgC,KACnD,cAAc,CAAC;AAoEpB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,wBAAwB,EACnC,oBAAoB,qBAAQ,EAC5B,gBAAgB,EAAE,wBAAwB;;EA8b3C;AACD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACvE,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,GAClC,CAAC"}

package/web/store.helpers.d.ts

@@ -1,14 +1,34 @@
 import { DevtoolsOptions } from 'zustand/middleware';
 import { StateCreator } from 'zustand';
 import { ObjectQueue } from '../engine/ObjectQueue';
-import { RealTimeMessage, RealTimeResourceHash, RealTimeResourceSerialId, RealTimeResourceTypeId, Subscriber } from '../contracts';
-import { RealTimeProducerStoreStateWithActions } from './types';
+import { RealTimeMessage, RealTimeMessageIngressReason, RealTimeMessagePayload, RealTimeResourceHash, RealTimeResourceSourceMechanismConfig, RealTimeResourceSerialId, RealTimeResourceTypeId, Subscriber } from '../contracts';
+import { QueuedRealTimeMessage, RealTimeProducerStoreStateWithActions } from './types';
+/**
+ * Apply one realtime patch into a mutable target using the runtime patch contract.
+ */
+export declare function mergeRealtimePatch(target: RealTimeMessagePayload, patch: RealTimeMessagePayload): RealTimeMessagePayload;
+/**
+ * Build a read-only working snapshot by copying only the root and patched branches.
+ */
+export declare function createRealtimePatchedResourceSnapshot(currentResource: RealTimeMessagePayload | undefined, patch: RealTimeMessagePayload, resourceSerialId: RealTimeResourceSerialId): RealTimeMessagePayload;
 /**
  * Drain all queued realtime messages while preserving arrival order.
  */
-export declare function drainQueuedMessages(messagesQueue: ObjectQueue<RealTimeMessage>): RealTimeMessage[];
+export declare function drainQueuedMessages(messagesQueue: ObjectQueue<QueuedRealTimeMessage>): QueuedRealTimeMessage[];
+/**
+ * Group one incoming batch by its canonical per-message resource type before enqueueing it into producer queues.
+ */
+export declare function groupMessagesByResourceTypeId(routingContextResourceTypeId: RealTimeResourceTypeId, messages: RealTimeMessage[], reason: RealTimeMessageIngressReason): Map<string, QueuedRealTimeMessage[]>;
+/**
+ * Resolve the message that should be queued after resource-specific normalization.
+ */
+export declare function normalizeProducerMessage(message: RealTimeMessage, resourceTypeConfig: RealTimeResourceSourceMechanismConfig, reason: RealTimeMessageIngressReason): RealTimeMessage;
+/**
+ * Resolve the message that should be applied and emitted after resource-specific sanitization.
+ */
+export declare function sanitizeProducerMessage(currentResource: RealTimeMessagePayload | undefined, message: RealTimeMessage, resourceTypeConfig: RealTimeResourceSourceMechanismConfig, reason: RealTimeMessageIngressReason): RealTimeMessage;
 /**
- * Apply one realtime message to the producer-side resource hash.
+ * Apply one already-sanitized realtime message to the producer-side resource hash.
  */
 export declare function applyProducerMessage(hasResources: RealTimeResourceHash, lastSeenByResource: Map<RealTimeResourceSerialId, number>, message: RealTimeMessage, receivedAtMs: number): void;
 /**

package/web/store.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.helpers.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/store.helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,SAAS,CAAC;AAErE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,WAAW,CAAC,eAAe,CAAC,qBAY9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,oBAAoB,EAClC,kBAAkB,EAAE,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,EACzD,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,QAiBrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,sBAAsB,EACtC,iBAAiB,EAAE,MAAM,CAAC,wBAAwB,EAAE,UAAU,CAAC,EAC/D,eAAe,EAAE,eAAe,EAAE,QAOnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,YAAY,CAAC,qCAAqC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,EACpG,MAAM,EAAE,eAAe,GACtB,YAAY,CAAC,qCAAqC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,CAYrF"}
+{"version":3,"file":"store.helpers.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/store.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC5B,sBAAsB,EACtB,oBAAoB,EACpB,qCAAqC,EACrC,wBAAwB,EACxB,sBAAsB,EACtB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,qBAAqB,EACrB,qCAAqC,EACtC,MAAM,SAAS,CAAC;AAgEjB;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,sBAAsB,0BAmB9B;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,sBAAsB,GAAG,SAAS,EACnD,KAAK,EAAE,sBAAsB,EAC7B,gBAAgB,EAAE,wBAAwB,0BAO3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,WAAW,CAAC,qBAAqB,CAAC,2BAYpF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,4BAA4B,EAAE,sBAAsB,EACpD,QAAQ,EAAE,eAAe,EAAE,EAC3B,MAAM,EAAE,4BAA4B,wCAgCrC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,EACxB,kBAAkB,EAAE,qCAAqC,EACzD,MAAM,EAAE,4BAA4B,mBASrC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,sBAAsB,GAAG,SAAS,EACnD,OAAO,EAAE,eAAe,EACxB,kBAAkB,EAAE,qCAAqC,EACzD,MAAM,EAAE,4BAA4B,mBA0BrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,oBAAoB,EAClC,kBAAkB,EAAE,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,EACzD,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,QAoBrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,sBAAsB,EACtC,iBAAiB,EAAE,MAAM,CAAC,wBAAwB,EAAE,UAAU,CAAC,EAC/D,eAAe,EAAE,eAAe,EAAE,QAOnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,YAAY,CAAC,qCAAqC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,EACpG,MAAM,EAAE,eAAe,GACtB,YAAY,CAAC,qCAAqC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,CAYrF"}

package/web/store.helpers.js

@@ -1,35 +1,138 @@
-import { cloneDeep as c, merge as i } from "lodash-es";
-import { devtools as l } from "zustand/middleware";
-function p(e) {
-  const t = [];
+import { devtools as f } from "zustand/middleware";
+function u(e) {
+  if (typeof e != "object" || e === null || Array.isArray(e))
+    return !1;
+  const r = Object.getPrototypeOf(e);
+  return r === Object.prototype || r === null;
+}
+function a(e) {
+  return Array.isArray(e) ? e.map(a) : u(e) ? d({}, e) : e;
+}
+function p(e, r) {
+  const t = u(e) ? { ...e } : {};
+  return Object.entries(r).forEach(([o, n]) => {
+    if (n === void 0) {
+      delete t[o];
+      return;
+    }
+    const c = t[o];
+    if (u(c) && u(n)) {
+      t[o] = p(c, n);
+      return;
+    }
+    t[o] = a(n);
+  }), t;
+}
+function d(e, r) {
+  return Object.entries(r).forEach(([t, o]) => {
+    if (o === void 0) {
+      delete e[t];
+      return;
+    }
+    const n = e[t];
+    if (u(n) && u(o)) {
+      d(n, o);
+      return;
+    }
+    e[t] = a(o);
+  }), e;
+}
+function y(e, r, t) {
+  const o = p(e, r);
+  return o.resourceSerialId = t, o;
+}
+function b(e) {
+  const r = [];
   for (; !e.isEmpty(); ) {
-    const o = e.dequeue();
-    o && t.push(o);
+    const t = e.dequeue();
+    t && r.push(t);
   }
-  return t;
+  return r;
 }
-function u(e, t, o, s) {
-  const { payload: n, resourceSerialId: r, type: a } = o;
-  if (a === "delete") {
-    delete e[r], t.delete(r);
+function I(e, r, t) {
+  const o = /* @__PURE__ */ new Map();
+  return r.forEach((n) => {
+    if (!n.resourceTypeId) {
+      console.error(
+        "Realtime producer received one message without resourceTypeId; dropping it because every message must carry its own resourceTypeId.",
+        {
+          routingContextResourceTypeId: e,
+          message: n
+        }
+      );
+      return;
+    }
+    const c = {
+      message: n,
+      reason: t
+    }, i = o.get(n.resourceTypeId);
+    if (i) {
+      i.push(c);
+      return;
+    }
+    o.set(n.resourceTypeId, [c]);
+  }), o;
+}
+function h(e, r, t) {
+  return r.normalizeMessageStrategy?.(
+    e,
+    {
+      reason: t,
+      resourceTypeId: e.resourceTypeId
+    }
+  ) ?? e;
+}
+function P(e, r, t, o) {
+  const { payload: n, resourceSerialId: c, type: i } = r;
+  if (i === "delete")
+    return r;
+  const s = t.mergePayloadStrategy?.(
+    e,
+    n,
+    {
+      reason: o,
+      resourceSerialId: c,
+      resourceTypeId: r.resourceTypeId
+    }
+  ) ?? n;
+  return s === n ? r : {
+    ...r,
+    payload: s
+  };
+}
+function m(e, r, t, o) {
+  const { payload: n, resourceSerialId: c, type: i } = t;
+  if (i === "delete") {
+    delete e[c], r.delete(c);
     return;
   }
-  e[r] ? i(e[r], n) : e[r] = { ...c(n), resourceSerialId: r }, t.set(r, s);
+  if (e[c])
+    d(e[c], n);
+  else {
+    const s = {};
+    e[c] = d(s, n);
+  }
+  e[c].resourceSerialId = c, r.set(c, o);
 }
-function b(e, t, o) {
-  Object.values(t).forEach((s) => {
-    s.onMessageCallbacks.forEach((n) => {
-      n(e, o);
+function M(e, r, t) {
+  Object.values(r).forEach((o) => {
+    o.onMessageCallbacks.forEach((n) => {
+      n(e, t);
     });
   });
 }
-function m(e, t) {
-  const { enabled: o = !1 } = t;
-  return o && process.env.NODE_ENV === "development" ? l(e, t) : e;
+function O(e, r) {
+  const { enabled: t = !1 } = r;
+  return t && process.env.NODE_ENV === "development" ? f(e, r) : e;
 }
 export {
-  u as applyProducerMessage,
-  m as createProducerDevtools,
-  p as drainQueuedMessages,
-  b as notifySubscribersWithBatch
+  m as applyProducerMessage,
+  O as createProducerDevtools,
+  y as createRealtimePatchedResourceSnapshot,
+  b as drainQueuedMessages,
+  I as groupMessagesByResourceTypeId,
+  d as mergeRealtimePatch,
+  h as normalizeProducerMessage,
+  M as notifySubscribersWithBatch,
+  P as sanitizeProducerMessage
 };