@m4l/gclick-realtime 1.1.0 → 1.2.0

package/web/consumer/store.js

@@ -1,105 +1,221 @@
-import { immer as l } from "../../node_modules/zustand/esm/middleware/immer.js";
-import R from "../../node_modules/lodash-es/merge.js";
-import { REALTIME_CONSUMER_SOTORE_ID as p } from "../shared/constants.js";
-import { ObjectQueue as h } from "@m4l/realtime-runtime";
-import { recordRealtimePerformanceMetric as m } from "../shared/performanceMetrics.js";
-import { createConsumerDevtools as M, drainQueuedMessages as T, applyConsumerMessage as C, decorateAllResourcesOfType as D } from "./store.helpers.js";
-import { createStore as E } from "../../node_modules/zustand/esm/vanilla.js";
-function _(n, u = !1) {
-  const i = {
-    ...n,
+import { immer as T } from "../../node_modules/zustand/esm/middleware/immer.js";
+import y from "../../node_modules/lodash-es/merge.js";
+import { REALTIME_CONSUMER_SOTORE_ID as Q } from "../shared/constants.js";
+import { recordRealtimePerformanceMetric as u, getRealtimePerformanceNowMs as _, isRealtimePerformanceMetricsEnabled as E } from "../shared/performanceMetrics.js";
+import { createConsumerDevtools as d, drainQueuedMessages as v, applyConsumerMessage as H, createConsumerResourceKey as b, createConsumerSnapshotEntries as x, createConsumerMessageManager as K, decorateAllResourcesOfType as U, applyConsumerSnapshotEntriesChunk as w } from "./store.helpers.js";
+import { createStore as z } from "../../node_modules/zustand/esm/vanilla.js";
+const N = 200, B = 250;
+function C() {
+  return E() ? _() : 0;
+}
+function p(c, m) {
+  E() && u(
+    c,
+    Math.max(0, _() - m)
+  );
+}
+function Y(c) {
+  globalThis.setTimeout(c, 0);
+}
+function g(c, m) {
+  E() && u(
+    "consumerResourceCount",
+    Object.keys(m().hasResourcesTypes[c]?.hasResources ?? {}).length
+  );
+}
+function G(c, m = !1) {
+  const O = {
+    ...c,
     hasResourcesTypes: {},
     customData: {}
-  }, a = {};
-  return E(
-    M(
-      l((t, c) => ({
-        ...i,
+  }, h = {}, M = {}, l = {};
+  function P(e) {
+    const n = (M[e] ?? 0) + 1;
+    return M[e] = n, l[e] = /* @__PURE__ */ new Set(), n;
+  }
+  function S(e, n) {
+    return M[e] === n;
+  }
+  function A(e, n) {
+    S(e, n) && (l[e] = void 0);
+  }
+  function L(e, n) {
+    const s = l[e];
+    s && n.forEach((o) => {
+      s.add(b(o));
+    });
+  }
+  function D(e, n, s, o, t, a) {
+    if (!S(s, a))
+      return;
+    const r = Math.min(
+      t + N,
+      o.length
+    ), i = C();
+    if (e((f) => {
+      if (!S(s, a))
+        return;
+      const R = f.hasResourcesTypes[s];
+      R && w(
+        R.hasResources,
+        o,
+        t,
+        r,
+        f.hasResourcesTypesDecorators?.[s],
+        l[s]
+      );
+    }), p(
+      "consumerSnapshotApplyDurationMs",
+      i
+    ), u(
+      "consumerSnapshotChunkSize",
+      r - t
+    ), g(s, n), r >= o.length) {
+      A(s, a);
+      return;
+    }
+    u("consumerSnapshotYieldCount"), Y(() => {
+      D(
+        e,
+        n,
+        s,
+        o,
+        r,
+        a
+      );
+    });
+  }
+  function k(e, n, s, o) {
+    const t = P(s), a = x(o);
+    if (h[s] = K(), u(
+      "consumerSnapshotChunkCount",
+      Math.max(
+        1,
+        Math.ceil(
+          a.length / N
+        )
+      )
+    ), a.length <= B) {
+      const r = U(
+        o,
+        n().hasResourcesTypesDecorators?.[s]
+      );
+      e((i) => {
+        i.hasResourcesTypes[s] = {
+          hasResources: r || {}
+        };
+      }), g(s, n), A(s, t);
+      return;
+    }
+    e((r) => {
+      r.hasResourcesTypes[s] = {
+        hasResources: {}
+      };
+    }), D(
+      e,
+      n,
+      s,
+      a,
+      0,
+      t
+    );
+  }
+  return z(
+    d(
+      T((e, n) => ({
+        ...O,
         realTimeConsumerActions: {
           /**
            * Seed one resource type with the current producer-side hash.
            */
-          loadResourceType: (e, s) => {
-            const o = D(
+          loadResourceType: (s, o) => {
+            k(
+              e,
+              n,
               s,
-              c().hasResourcesTypesDecorators?.[e]
+              o
             );
-            t((r) => {
-              r.hasResourcesTypes[e] = {
-                hasResources: o || {}
-              }, a[e] = {
-                messagesToProcces: [],
-                messagesQueue: new h(),
-                statusProccesing: !1
-              };
-            });
           },
           /**
            * Enqueue one incoming realtime batch and start draining the queue.
            */
-          onMessages: (e, s) => {
-            m(
+          onMessages: (s, o) => {
+            u(
               "consumerIncomingBatch",
-              s.length
-            ), s.forEach((o) => {
-              a[e].messagesQueue.enqueue(
-                o
+              o.length
+            ), o.forEach((t) => {
+              h[s].messagesQueue.enqueue(
+                t
               );
-            }), c().realTimeConsumerActions.processMessages(e);
+            }), u(
+              "consumerQueueLength",
+              h[s].messagesQueue.size()
+            ), n().realTimeConsumerActions.processMessages(s);
           },
           /**
            * Drain the queued messages in one store transaction while preserving order.
            */
-          processMessages: (e) => {
-            const s = a[e];
-            if (s.statusProccesing)
+          processMessages: (s) => {
+            const o = C(), t = h[s];
+            if (t.statusProccesing)
               return;
-            s.statusProccesing = !0;
-            const o = T(
-              s.messagesQueue
+            t.statusProccesing = !0;
+            const a = v(
+              t.messagesQueue
             );
-            if (!o.length) {
-              s.statusProccesing = !1;
+            if (!a.length) {
+              t.statusProccesing = !1;
               return;
             }
-            m(
+            u(
               "consumerDrainSet",
-              o.length
+              a.length
+            ), L(
+              s,
+              a.map((r) => r.resourceSerialId)
             );
             try {
-              t((r) => {
-                const g = r.hasResourcesTypes[e].hasResources;
-                o.forEach((f) => {
-                  C(
-                    g,
-                    e,
+              const r = C();
+              e((i) => {
+                const f = i.hasResourcesTypes[s].hasResources;
+                a.forEach((R) => {
+                  H(
                     f,
-                    r.hasResourcesTypesDecorators
+                    s,
+                    R,
+                    i.hasResourcesTypesDecorators
                   );
                 });
-              });
+              }), p(
+                "consumerApplyNotifyDurationMs",
+                r
+              ), g(s, n);
             } finally {
-              s.statusProccesing = !1;
+              p(
+                "consumerProcessDurationMs",
+                o
+              ), t.statusProccesing = !1;
             }
-            s.messagesQueue.isEmpty() || c().realTimeConsumerActions.processMessages(e);
+            t.messagesQueue.isEmpty() || n().realTimeConsumerActions.processMessages(s);
           },
           /**
            * Merge partial custom data into the consumer store.
            */
-          setCustomData: (e) => {
-            t((s) => {
-              R(s.customData, e);
+          setCustomData: (s) => {
+            e((o) => {
+              y(o.customData, s);
             });
           }
         }
       })),
       {
-        name: `${p}: ${n.storeId}`,
-        enabled: u
+        name: `${Q}: ${c.storeId}`,
+        enabled: m
       }
     )
   );
 }
 export {
-  _ as createRealTimeConsumerStore
+  N as REALTIME_CONSUMER_SNAPSHOT_CHUNK_SIZE,
+  G as createRealTimeConsumerStore
 };

package/web/consumer/types.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { RealTimeProducerTools } from '@m4l/realtime-runtime';
-import { OnRealTimeConsumerMessageCallback, OnRealtimeConsumerSubscribeCallback, RealTimeMessagePayload, RealTimeResourceSerialId, RealTimeResourceTypeId } from '../shared/runtimeTypes';
+import { OnRealTimeConsumerMessageCallback, OnRealtimeConsumerSubscribeCallback, RealTimeMessagePayload, RealTimeReadonlyResourceHash, RealTimeResourceSerialId, RealTimeResourceTypeId } from '../shared/runtimeTypes';
 /**
  * Realtime message decorator. Only the payload is decorated.
  */
@@ -39,8 +39,9 @@ export interface RealTimeConsumerStoreStateWithActions extends RealTimeConsumerS
     realTimeConsumerActions: {
         /**
          * Seed one resource type with the current producer-side hash.
+         * Large snapshots may load incrementally so the UI can keep responding.
          */
-        loadResourceType(resourceTypeId: RealTimeResourceTypeId, hasResources: Record<RealTimeResourceSerialId, RealTimeMessagePayload>): void;
+        loadResourceType(resourceTypeId: RealTimeResourceTypeId, hasResources: RealTimeReadonlyResourceHash): void;
         /**
          * Accept a raw incoming batch and enqueue it for consumer-side processing.
          */

package/web/consumer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/consumer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,iCAAiC,EACjC,mCAAmC,EACnC,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,gBAAgB,EAAE,wBAAwB,EAC1C,OAAO,EAAE,sBAAsB,KAC5B,sBAAsB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,wBAAwB,EAAE,sBAAsB,CAAC,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,CAAC;IACpE;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAClC,sBAAsB,EACtB,wBAAwB,EAAE,CAC3B,CAAC;IACF;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,qCACf,SAAQ,0BAA0B;IAClC,uBAAuB,EAAE;QACvB;;WAEG;QACH,gBAAgB,CACd,cAAc,EAAE,sBAAsB,EACtC,YAAY,EAAE,MAAM,CAAC,wBAAwB,EAAE,sBAAsB,CAAC,GACrE,IAAI,CAAC;QACR;;WAEG;QACH,UAAU,EAAE,iCAAiC,CAAC;QAC9C;;WAEG;QACH,eAAe,EAAE,CAAC,cAAc,EAAE,sBAAsB,KAAK,IAAI,CAAC;QAClE;;WAEG;QACH,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;CACH;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,0BAA0B,EAC1B,YAAY,GAAG,mBAAmB,CACnC,CAAC;AAEF,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC;IAClD;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,EAAE,qBAAqB,CAAC;IACrC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAC1D,oBAAoB,CAAC,EAAE,mCAAmC,EAAE,CAAC;IAC7D,QAAQ,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/consumer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,iCAAiC,EACjC,mCAAmC,EACnC,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,gBAAgB,EAAE,wBAAwB,EAC1C,OAAO,EAAE,sBAAsB,KAC5B,sBAAsB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,wBAAwB,EAAE,sBAAsB,CAAC,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,CAAC;IACpE;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAClC,sBAAsB,EACtB,wBAAwB,EAAE,CAC3B,CAAC;IACF;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,qCACf,SAAQ,0BAA0B;IAClC,uBAAuB,EAAE;QACvB;;;WAGG;QACH,gBAAgB,CACd,cAAc,EAAE,sBAAsB,EACtC,YAAY,EAAE,4BAA4B,GACzC,IAAI,CAAC;QACR;;WAEG;QACH,UAAU,EAAE,iCAAiC,CAAC;QAC9C;;WAEG;QACH,eAAe,EAAE,CAAC,cAAc,EAAE,sBAAsB,KAAK,IAAI,CAAC;QAClE;;WAEG;QACH,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;CACH;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,0BAA0B,EAC1B,YAAY,GAAG,mBAAmB,CACnC,CAAC;AAEF,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC;IAClD;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,EAAE,qBAAqB,CAAC;IACrC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAC1D,oBAAoB,CAAC,EAAE,mCAAmC,EAAE,CAAC;IAC7D,QAAQ,EAAE,SAAS,CAAC;CACrB"}

package/web/host/devicesResourceType.d.ts

@@ -0,0 +1,70 @@
+import { RealTimeMessage, RealTimeResourceMessageNormalizeStrategy, RealTimeResourceTypeId } from '../shared/runtimeTypes';
+import { GClickRealtimeResourceStartupSnapshotConfig } from './startupSnapshots';
+import { GClickRealtimeAtmosphereResourceTypeLaunchConfig } from './launchContract';
+/**
+ * Snapshot loader used by host shells to fetch a full devices startup payload.
+ */
+export type GClickDevicesStartupSnapshotLoader = () => Promise<unknown> | unknown;
+export interface CreateGClickDevicesStartupSnapshotProps {
+    loadSnapshot: GClickDevicesStartupSnapshotLoader;
+    resourceTypeId?: RealTimeResourceTypeId;
+}
+/**
+ * Network request shape used by the standard hot devices startup snapshot helper.
+ */
+export interface GClickDevicesHotStartupSnapshotRequest {
+    database?: string;
+    endPoint: string;
+    isExternalUrl?: true;
+    method: 'GET';
+    parms: {
+        hot: true;
+    };
+    responseToCamelCase: true;
+}
+/**
+ * Structural network operation contract supplied by shells without coupling this package to @m4l/core.
+ */
+export type GClickDevicesHotStartupSnapshotNetworkOperation = <T = unknown>(request: GClickDevicesHotStartupSnapshotRequest) => Promise<T>;
+export interface CreateGClickDevicesHotStartupSnapshotProps {
+    database?: string;
+    endPoint?: string;
+    networkOperation: GClickDevicesHotStartupSnapshotNetworkOperation;
+    resourceTypeId?: RealTimeResourceTypeId;
+    startupSnapshotHostApiRemote?: string;
+}
+type CreateGClickDevicesAtmosphereResourceTypeBaseProps = Omit<Partial<GClickRealtimeAtmosphereResourceTypeLaunchConfig>, 'mergePayloadStrategy' | 'resourceTypeId' | 'startupSnapshot'> & {
+    database?: string;
+    endPoint?: string;
+    resourceTypeId: RealTimeResourceTypeId;
+    startupSnapshotHostApiRemote?: string;
+};
+export type CreateGClickDevicesAtmosphereResourceTypeProps = CreateGClickDevicesAtmosphereResourceTypeBaseProps & {
+    networkOperation: GClickDevicesHotStartupSnapshotNetworkOperation;
+    startupSnapshot?: never;
+} | CreateGClickDevicesAtmosphereResourceTypeBaseProps & {
+    networkOperation?: never;
+    startupSnapshot: GClickRealtimeResourceStartupSnapshotConfig;
+};
+/**
+ * Normalize one live `rt_devices` realtime message to the shared hash-key and payload identity contract.
+ */
+export declare const normalizeGClickDevicesRealtimeMessage: RealTimeResourceMessageNormalizeStrategy;
+/**
+ * Convert a backend devices snapshot response into replayable `rt_devices` realtime messages.
+ */
+export declare function createGClickDevicesStartupSnapshotMessages(response: unknown, resourceTypeId?: RealTimeResourceTypeId): RealTimeMessage[];
+/**
+ * Create one `rt_devices` startup snapshot from a shell-owned snapshot loader.
+ */
+export declare function createGClickDevicesStartupSnapshot(props: CreateGClickDevicesStartupSnapshotProps): GClickRealtimeResourceStartupSnapshotConfig;
+/**
+ * Create one standard `rt_devices` hot startup snapshot from a shell network operation.
+ */
+export declare function createGClickDevicesHotStartupSnapshot(props: CreateGClickDevicesHotStartupSnapshotProps): GClickRealtimeResourceStartupSnapshotConfig;
+/**
+ * Create the Atmosphere launch config for the devices resource type with its own merge and snapshot policy.
+ */
+export declare function createGClickDevicesAtmosphereResourceType(props: CreateGClickDevicesAtmosphereResourceTypeProps): GClickRealtimeAtmosphereResourceTypeLaunchConfig;
+export {};
+//# sourceMappingURL=devicesResourceType.d.ts.map

package/web/host/devicesResourceType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devicesResourceType.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/devicesResourceType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,wCAAwC,EAGxC,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAE,2CAA2C,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EACV,gDAAgD,EACjD,MAAM,kBAAkB,CAAC;AAS1B;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,MAC/C,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE7B,MAAM,WAAW,uCAAuC;IACtD,YAAY,EAAE,kCAAkC,CAAC;IACjD,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE;QACL,GAAG,EAAE,IAAI,CAAC;KACX,CAAC;IACF,mBAAmB,EAAE,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,GAAG,OAAO,EACxE,OAAO,EAAE,sCAAsC,KAC5C,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,+CAA+C,CAAC;IAClE,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,KAAK,kDAAkD,GACrD,IAAI,CACF,OAAO,CAAC,gDAAgD,CAAC,EACzD,sBAAsB,GAAG,gBAAgB,GAAG,iBAAiB,CAC9D,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,sBAAsB,CAAC;IACvC,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC,CAAC;AAEJ,MAAM,MAAM,8CAA8C,GACtD,kDAAkD,GAAG;IACrD,gBAAgB,EAAE,+CAA+C,CAAC;IAClE,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB,GACC,kDAAkD,GAAG;IACrD,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,eAAe,EAAE,2CAA2C,CAAC;CAC9D,CAAC;AAwKJ;;GAEG;AACH,eAAO,MAAM,qCAAqC,EAAE,wCAwCnD,CAAC;AAwCF;;GAEG;AACH,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,sBAAqD,GACpE,eAAe,EAAE,CAiCnB;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,uCAAuC,GAC7C,2CAA2C,CAY7C;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,0CAA0C,GAChD,2CAA2C,CA2B7C;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,8CAA8C,GACpD,gDAAgD,CAyBlD"}

package/web/host/devicesResourceType.js

@@ -0,0 +1,196 @@
+import { EnumResourceTypesIds as c } from "../shared/constants.js";
+import { mergeDevicePayloadWithUpdatedAtGuard as f } from "../../payload/mergeDevicePayloadWithUpdatedAtGuard.js";
+const I = [
+  "devices",
+  "resources",
+  "items",
+  "results"
+], y = "operative", m = "devices/";
+function D(...e) {
+  const [r = "", ...t] = e, n = r.replace(/\/+$/u, ""), o = t.map((i) => i.replace(/^\/+|\/+$/gu, "")).filter(Boolean);
+  return [n, ...o].join("/");
+}
+function h(e) {
+  return e.startupSnapshotHostApiRemote?.trim() ? D(
+    e.startupSnapshotHostApiRemote,
+    e.database,
+    e.endPoint
+  ) : e.endPoint;
+}
+function a(e) {
+  return typeof e == "object" && e !== null && !Array.isArray(e);
+}
+function A(e) {
+  return a(e) && "data" in e ? e.data : e;
+}
+function l(e) {
+  return typeof e == "string" && e.trim() ? e : null;
+}
+function d(e) {
+  return typeof e == "number" && Number.isSafeInteger(e);
+}
+function P(e) {
+  return typeof e == "string" && !!e.trim();
+}
+function E(e) {
+  const r = Number(e);
+  return Number.isSafeInteger(r) ? r : null;
+}
+function p(e, r) {
+  return l(
+    e.resourceSerialId ?? e.serialId ?? r
+  );
+}
+function T(e, r) {
+  if ("id" in e && !d(e.id))
+    return null;
+  const t = { ...e };
+  if (delete t.resourceId, delete t.resourceSerialId, delete t.serialId, !("id" in t)) {
+    const n = E(r);
+    if (n === null)
+      return null;
+    t.id = n;
+  }
+  return t;
+}
+function v(e) {
+  if (!d(e.id) || !P(e.serialId))
+    return null;
+  const r = { ...e };
+  return delete r.resourceId, delete r.resourceSerialId, delete r.serialId, r.alias === null && delete r.alias, r;
+}
+const R = (e) => {
+  const r = l(e.resourceSerialId);
+  if (!r)
+    return null;
+  if (e.type === "delete")
+    return e.resourceSerialId === r ? e : {
+      ...e,
+      resourceSerialId: r
+    };
+  if (!a(e.payload))
+    return null;
+  const t = T(
+    e.payload,
+    r
+  );
+  return t ? r === e.resourceSerialId && t === e.payload ? e : {
+    ...e,
+    payload: t,
+    resourceSerialId: r
+  } : null;
+};
+function C(e) {
+  const r = A(e);
+  if (Array.isArray(r))
+    return r.map((t) => ({
+      deviceCandidate: t
+    }));
+  if (!a(r))
+    return [];
+  if (p(r))
+    return [{ deviceCandidate: r }];
+  for (const t of I) {
+    const n = r[t];
+    if (Array.isArray(n))
+      return n.map((o) => ({
+        deviceCandidate: o
+      }));
+  }
+  return Object.entries(r).map(([t, n]) => ({
+    deviceCandidate: n,
+    resourceSerialId: t
+  }));
+}
+function _(e, r = c.devices) {
+  return C(e).flatMap(({
+    deviceCandidate: t,
+    resourceSerialId: n
+  }) => {
+    if (!a(t))
+      return [];
+    const o = p(
+      t,
+      n
+    );
+    if (o === null)
+      return [];
+    const i = v(t);
+    return i === null ? [] : [
+      {
+        payload: i,
+        resourceSerialId: o,
+        resourceTypeId: r,
+        type: "update"
+      }
+    ];
+  });
+}
+function N(e) {
+  const {
+    loadSnapshot: r,
+    resourceTypeId: t = c.devices
+  } = e;
+  return {
+    loadMessages: async () => _(
+      await r(),
+      t
+    )
+  };
+}
+function b(e) {
+  const {
+    database: r = y,
+    endPoint: t = m,
+    networkOperation: n,
+    resourceTypeId: o = c.devices,
+    startupSnapshotHostApiRemote: i
+  } = e, s = h({
+    database: r,
+    endPoint: t,
+    startupSnapshotHostApiRemote: i
+  }), u = !!i?.trim();
+  return N({
+    loadSnapshot: () => n({
+      ...u ? { isExternalUrl: !0 } : { database: r },
+      endPoint: s,
+      method: "GET",
+      parms: {
+        hot: !0
+      },
+      responseToCamelCase: !0
+    }),
+    resourceTypeId: o
+  });
+}
+function H(e) {
+  const {
+    database: r,
+    endPoint: t,
+    networkOperation: n,
+    resourceTypeId: o,
+    startupSnapshot: i,
+    startupSnapshotHostApiRemote: s,
+    ...u
+  } = e, S = i ?? b({
+    database: r,
+    endPoint: t,
+    networkOperation: n,
+    resourceTypeId: o,
+    startupSnapshotHostApiRemote: s
+  });
+  return {
+    ...u,
+    normalizeMessageStrategy: R,
+    startupSnapshot: S,
+    resourceTypeId: o,
+    mergePayloadStrategy: f
+  };
+}
+export {
+  H as createGClickDevicesAtmosphereResourceType,
+  b as createGClickDevicesHotStartupSnapshot,
+  N as createGClickDevicesStartupSnapshot,
+  _ as createGClickDevicesStartupSnapshotMessages,
+  R as normalizeGClickDevicesRealtimeMessage
+};

package/web/host/hostRuntime.d.ts

@@ -1,6 +1,7 @@
 import { RealTimeProducerTools } from '@m4l/realtime-runtime';
 import { RealTimeDummySimulationPresetId } from '../../dummy/index';
 import { RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceTypeId } from '../shared/runtimeTypes';
+import { GClickRealtimeStartupSnapshotConfig } from './startupSnapshots';
 /**
  * Host-runtime realtime payload forwarded from the host into one gclick MF instance.
  *
@@ -8,6 +9,10 @@ import { RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceTypeId
  * package does not depend on MF shell runtime types from another workspace package.
  */
 export interface GClickRealtimeHostRuntime {
+    /**
+     * Release the shell-owned realtime runtime and stop its active sources.
+     */
+    dispose?: () => void;
     realtime?: {
         producerTools?: RealTimeProducerTools;
     };
@@ -31,6 +36,8 @@ export interface LaunchGClickAtmosphereHostRuntimeProps {
     runtimeKey: string;
     storeId?: string;
     storeDevtoolsEnabled?: boolean;
+    startSourceData?: boolean;
+    startupSnapshots?: GClickRealtimeStartupSnapshotConfig[];
 }
 /**
  * Create one host-runtime bag from a deterministic dummy preset without rebuilding MF-local runtime wiring.

package/web/host/hostRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostRuntime.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/hostRuntime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,+CAA+C,EAC/C,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,qBAAqB,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,+CAA+C,EAAE,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,yBAAyB,CAyB3B;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,yBAAyB,CAQ3B;AACD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,CAAC,EAAE,yBAAyB,GACtC,qBAAqB,CAevB"}
+{"version":3,"file":"hostRuntime.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/hostRuntime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,+CAA+C,EAC/C,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,qBAAqB,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,+CAA+C,EAAE,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,mCAAmC,EAAE,CAAC;CAC1D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,yBAAyB,CA4B3B;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,yBAAyB,CAqB3B;AACD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,CAAC,EAAE,yBAAyB,GACtC,qBAAqB,CAiBvB"}