@m4l/gclick-realtime 1.1.0 → 1.2.0

package/web/host/hostRuntime.js

@@ -1,47 +1,63 @@
-import { getOrCreateGClickRealtimeRuntime as s } from "../runtime/runtimeRegistry.js";
-import { getOrCreateGClickAtmosphereRealtimeRuntime as u } from "../runtime/runtimeRegistryAtmosphereOnly.js";
-import { createRealTimeDummyResourceTypeConfigFromPreset as m } from "../../dummy/runtime/simulation.js";
-function f(o) {
+import { getOrCreateGClickRealtimeRuntime as m } from "../runtime/runtimeRegistry.js";
+import { getOrCreateGClickAtmosphereRealtimeRuntime as c } from "../runtime/runtimeRegistryAtmosphereOnly.js";
+import { createRealTimeDummyResourceTypeConfigFromPreset as l } from "../../dummy/runtime/simulation.js";
+import { replayGClickRealtimeStartupSnapshotsOnce as p } from "./startupSnapshots.js";
+import { disposeGClickRealtimeRuntime as s } from "../runtime/runtimeRegistry.shared.js";
+function T(o) {
   const {
     presetId: e,
-    resourceTypeId: t,
-    storeDevtoolsEnabled: r = !1,
-    storeId: i,
-    runtimeKey: n
-  } = o;
+    resourceTypeId: r,
+    storeDevtoolsEnabled: t = !1,
+    storeId: n,
+    runtimeKey: i
+  } = o, u = m({
+    runtimeKey: i,
+    storeId: n,
+    storeDevtoolsEnabled: t,
+    resourceTypesConfig: [
+      l({
+        presetId: e,
+        resourceTypeId: r
+      })
+    ]
+  });
   return {
+    dispose: () => {
+      s(i);
+    },
     realtime: {
-      producerTools: s({
-        runtimeKey: n,
-        storeId: i,
-        storeDevtoolsEnabled: r,
-        resourceTypesConfig: [
-          m({
-            presetId: e,
-            resourceTypeId: t
-          })
-        ]
-      }).tools
+      producerTools: u.tools
     }
   };
 }
-function R(o) {
-  return {
+function C(o) {
+  const {
+    startupSnapshots: e,
+    ...r
+  } = o, t = c(r);
+  return p({
+    producerTools: t.tools,
+    runtimeKey: o.runtimeKey,
+    startupSnapshots: e
+  }), {
+    dispose: () => {
+      s(o.runtimeKey);
+    },
     realtime: {
-      producerTools: u(o).tools
+      producerTools: t.tools
     }
   };
 }
-function d(o) {
+function h(o) {
   const e = o?.realtime?.producerTools;
-  if (typeof e?.getResourceRuntimeMeta != "function" || typeof e?.publishMessages != "function" || typeof e?.subscribe != "function" || typeof e?.unsubscribe != "function")
+  if (typeof e?.getResourceRuntimeMeta != "function" || typeof e?.getResourceTypeSnapshot != "function" || typeof e?.publishMessages != "function" || typeof e?.subscribe != "function" || typeof e?.subscribeResourceType != "function" || typeof e?.unsubscribe != "function")
     throw new Error(
       "GClick realtime host runtime requires host-owned realtime producerTools."
     );
   return e;
 }
 export {
-  R as launchGClickAtmosphereHostRuntime,
-  f as launchGClickDummyHostRuntime,
-  d as resolveGClickRealtimeTools
+  C as launchGClickAtmosphereHostRuntime,
+  T as launchGClickDummyHostRuntime,
+  h as resolveGClickRealtimeTools
 };

package/web/host/index.d.ts

@@ -1,5 +1,8 @@
+export { createGClickDevicesStartupSnapshot, createGClickDevicesStartupSnapshotMessages, createGClickDevicesAtmosphereResourceType, createGClickDevicesHotStartupSnapshot, } from './devicesResourceType';
+export type { CreateGClickDevicesStartupSnapshotProps, CreateGClickDevicesAtmosphereResourceTypeProps, CreateGClickDevicesHotStartupSnapshotProps, GClickDevicesStartupSnapshotLoader, GClickDevicesHotStartupSnapshotNetworkOperation, GClickDevicesHotStartupSnapshotRequest, } from './devicesResourceType';
 export { launchGClickAtmosphereHostRuntime, launchGClickDummyHostRuntime, resolveGClickRealtimeTools, } from './hostRuntime';
+export type { GClickRealtimeResourceStartupSnapshotConfig, GClickRealtimeStartupSnapshotConfig, GClickRealtimeStartupSnapshotMessagesLoader, } from './startupSnapshots';
 export type { GClickRealtimeHostRuntime, LaunchGClickAtmosphereHostRuntimeProps, LaunchGClickDummyHostRuntimeProps, } from './hostRuntime';
-export { createGClickAtmosphereRuntimeConfig, createGClickAtmosphereRuntimeKey, createGClickDummyRuntimeKey, launchGClickRealtimeHostRuntime, normalizeGClickRealtimeFallbackTransport, normalizeGClickRealtimeSessionId, resolveGClickRealtimeAtmosphereHost, } from './launchContract';
-export type { GClickRealtimeAtmosphereFallbackTransport, GClickRealtimeAtmosphereHostLaunchContract, GClickRealtimeDummyHostLaunchContract, GClickRealtimeHostLaunchContract, } from './launchContract';
+export { createGClickAtmosphereRuntimeConfigs, createGClickAtmosphereRuntimeKey, createGClickAtmosphereStartupSnapshots, createGClickDummyRuntimeKey, launchGClickRealtimeHostRuntime, normalizeGClickRealtimeFallbackTransport, normalizeGClickRealtimeSessionId, resolveGClickRealtimeAtmosphereHost, } from './launchContract';
+export type { GClickRealtimeAtmosphereFallbackTransport, GClickRealtimeAtmosphereHostLaunchContract, GClickRealtimeAtmosphereResourceTypeLaunchConfig, GClickRealtimeDummyHostLaunchContract, GClickRealtimeHostLaunchContract, } from './launchContract';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,yBAAyB,EACzB,sCAAsC,EACtC,iCAAiC,GAClC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mCAAmC,EACnC,gCAAgC,EAChC,2BAA2B,EAC3B,+BAA+B,EAC/B,wCAAwC,EACxC,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,yCAAyC,EACzC,0CAA0C,EAC1C,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,0CAA0C,EAC1C,yCAAyC,EACzC,qCAAqC,GACtC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,uCAAuC,EACvC,8CAA8C,EAC9C,0CAA0C,EAC1C,kCAAkC,EAClC,+CAA+C,EAC/C,sCAAsC,GACvC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,2CAA2C,EAC3C,mCAAmC,EACnC,2CAA2C,GAC5C,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,yBAAyB,EACzB,sCAAsC,EACtC,iCAAiC,GAClC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,sCAAsC,EACtC,2BAA2B,EAC3B,+BAA+B,EAC/B,wCAAwC,EACxC,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,yCAAyC,EACzC,0CAA0C,EAC1C,gDAAgD,EAChD,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,kBAAkB,CAAC"}

package/web/host/launchContract.d.ts

@@ -1,10 +1,25 @@
 import { RealTimeDummySimulationPresetId } from '../../fixtures/index';
-import { RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceTypeId } from '../shared/runtimeTypes';
+import { RealTimeResourcePayloadMergeStrategy, RealTimeResourceMessageNormalizeStrategy, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceSerialId, RealTimeResourceTypeId } from '../shared/runtimeTypes';
+import { GClickRealtimeResourceStartupSnapshotConfig, GClickRealtimeStartupSnapshotConfig } from './startupSnapshots';
 import { GClickRealtimeHostRuntime } from './hostRuntime';
 /**
  * Supported fallback transports for the shared Atmosphere launch contract.
  */
 export type GClickRealtimeAtmosphereFallbackTransport = 'long-polling' | 'websocket';
+/**
+ * Resource-type entry requested by one shell-owned Atmosphere subscription.
+ */
+export interface GClickRealtimeAtmosphereResourceTypeLaunchConfig {
+    consumerType?: string;
+    mergePayloadStrategy?: RealTimeResourcePayloadMergeStrategy;
+    normalizeMessageStrategy?: RealTimeResourceMessageNormalizeStrategy;
+    publishParams?: Record<string, unknown>;
+    rateLimit?: number;
+    resourceTypeId: RealTimeResourceTypeId;
+    resourcesId?: Array<RealTimeResourceSerialId | 'all'>;
+    sizeLimit?: number;
+    startupSnapshot?: GClickRealtimeResourceStartupSnapshotConfig;
+}
 /**
  * Shared shell-to-runtime contract used when one shell boots a deterministic dummy runtime.
  */
@@ -24,9 +39,10 @@ export interface GClickRealtimeAtmosphereHostLaunchContract {
     fallbackTransport?: GClickRealtimeAtmosphereFallbackTransport;
     hostApiRemote?: string;
     path: string;
-    resourceTypeId: RealTimeResourceTypeId;
+    resourceTypes: GClickRealtimeAtmosphereResourceTypeLaunchConfig[];
     sessionId?: string;
     sessionIdFallback?: string;
+    snapshotOnly?: boolean;
     storeDevtoolsEnabled?: boolean;
     runtimeKeyPrefix: string;
     topic: string;
@@ -54,11 +70,15 @@ export declare function createGClickDummyRuntimeKey(props: Pick<GClickRealtimeDu
 /**
  * Build the runtime key for one Atmosphere-backed launch contract.
  */
-export declare function createGClickAtmosphereRuntimeKey(props: Pick<GClickRealtimeAtmosphereHostLaunchContract, 'fallbackTransport' | 'hostApiRemote' | 'sessionId' | 'sessionIdFallback' | 'runtimeKeyPrefix'>): string;
+export declare function createGClickAtmosphereRuntimeKey(props: Pick<GClickRealtimeAtmosphereHostLaunchContract, 'fallbackTransport' | 'hostApiRemote' | 'resourceTypes' | 'sessionId' | 'sessionIdFallback' | 'snapshotOnly' | 'runtimeKeyPrefix'>): string;
+/**
+ * Build the Atmosphere runtime configs derived from one shared shell launch contract.
+ */
+export declare function createGClickAtmosphereRuntimeConfigs(contract: GClickRealtimeAtmosphereHostLaunchContract): RealTimeResourceSourceMechanismConfigAtmosphere[] | undefined;
 /**
- * Build the Atmosphere runtime config derived from one shared shell launch contract.
+ * Resolve resource-owned startup snapshots into runtime replay registrations.
  */
-export declare function createGClickAtmosphereRuntimeConfig(contract: GClickRealtimeAtmosphereHostLaunchContract): RealTimeResourceSourceMechanismConfigAtmosphere | undefined;
+export declare function createGClickAtmosphereStartupSnapshots(contract: GClickRealtimeAtmosphereHostLaunchContract): GClickRealtimeStartupSnapshotConfig[] | undefined;
 /**
  * Boot one host-runtime bag from the shared shell launch contract.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"launchContract.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/launchContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EACV,+CAA+C,EAC/C,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAM/D;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG,cAAc,GAAG,WAAW,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,cAAc,EAAE,sBAAsB,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,0CAA0C;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,yCAAyC,CAAC;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,sBAAsB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,gCAAgC,GACxC,qCAAqC,GACrC,0CAA0C,CAAC;AAK/C;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,iBAAiB,CAAC,EAAE,yCAAyC,GAC5D,yCAAyC,CAI3C;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,CAAC,EAAE,MAAM,EAClB,iBAAiB,SAAuC,UAGzD;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,aAAa,EAAE,MAAM,UAKxE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,qCAAqC,EAAE,UAAU,GAAG,kBAAkB,CAAC,UAGpF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,IAAI,CACT,0CAA0C,EAC1C,mBAAmB,GAAG,eAAe,GAAG,WAAW,GAAG,mBAAmB,GAAG,kBAAkB,CAC/F,UAWF;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,0CAA0C,GACnD,+CAA+C,GAAG,SAAS,CAmB7D;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,gCAAgC,GACzC,yBAAyB,CA2B3B"}
+{"version":3,"file":"launchContract.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/launchContract.ts"],"names":[],"mappings":"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"}

package/web/host/launchContract.js

@@ -1,72 +1,109 @@
-import { launchGClickDummyHostRuntime as r, launchGClickAtmosphereHostRuntime as l } from "./hostRuntime.js";
-const u = "long-polling", a = "no-session-id";
-function t(e) {
-  return e === "websocket" ? "websocket" : u;
+import { launchGClickDummyHostRuntime as a, launchGClickAtmosphereHostRuntime as l } from "./hostRuntime.js";
+const m = "long-polling", u = "no-session-id";
+function r(e) {
+  return e === "websocket" ? "websocket" : m;
 }
-function n(e, s = a) {
-  return e?.trim() || s;
-}
-function m(e) {
-  const s = new URL(e), o = s.pathname.replace(/\/+$/u, "");
-  return `${s.host}${o}/wss`;
+function i(e, t = u) {
+  return e?.trim() || t;
 }
 function d(e) {
-  return `${e.runtimeKeyPrefix}:${e.presetId}`;
+  const t = e.map((s) => ({
+    consumerType: s.consumerType ?? "batch",
+    publishParams: s.publishParams ?? {},
+    rateLimit: s.rateLimit ?? 3,
+    resourceTypeId: s.resourceTypeId,
+    resourcesId: s.resourcesId ?? ["all"],
+    sizeLimit: s.sizeLimit ?? null
+  })).sort(
+    (s, o) => s.resourceTypeId.localeCompare(
+      o.resourceTypeId
+    )
+  );
+  return JSON.stringify(t);
 }
 function p(e) {
-  const s = t(
+  const t = new URL(e), s = t.pathname.replace(/\/+$/u, ""), o = `${t.host}${s}/wss`;
+  return t.protocol === "http:" ? `ws://${o}` : o;
+}
+function h(e) {
+  return `${e.runtimeKeyPrefix}:${e.presetId}`;
+}
+function c(e) {
+  const t = r(
     e.fallbackTransport
-  ), o = n(
+  ), s = i(
     e.sessionId,
     e.sessionIdFallback
-  );
-  return `${e.runtimeKeyPrefix}:${e.hostApiRemote}:${o}:${s}`;
+  ), o = d(
+    e.resourceTypes
+  ), n = e.snapshotOnly ? "snapshot-only" : "live";
+  return `${e.runtimeKeyPrefix}:${n}:${e.hostApiRemote}:${s}:${t}:${o}`;
 }
-function f(e) {
-  if (e.hostApiRemote)
-    return {
+function y(e) {
+  const { hostApiRemote: t } = e;
+  if (!(!t || e.resourceTypes.length === 0))
+    return e.resourceTypes.map((s) => ({
       sourceDataMechanism: "atmosphere",
-      resourceTypeId: e.resourceTypeId,
+      resourceTypeId: s.resourceTypeId,
+      consumerType: s.consumerType,
       database: e.database,
-      fallbackTransport: t(e.fallbackTransport),
-      host: m(e.hostApiRemote),
+      fallbackTransport: r(e.fallbackTransport),
+      host: p(t),
       port: "wss",
       path: e.path,
+      ...s.mergePayloadStrategy ? { mergePayloadStrategy: s.mergePayloadStrategy } : {},
+      ...s.normalizeMessageStrategy ? { normalizeMessageStrategy: s.normalizeMessageStrategy } : {},
+      publishParams: s.publishParams,
+      rateLimit: s.rateLimit,
+      resourcesId: s.resourcesId,
+      sizeLimit: s.sizeLimit,
       topic: e.topic,
-      sessionId: n(
+      sessionId: i(
         e.sessionId,
         e.sessionIdFallback
       )
-    };
+    }));
 }
-function c(e) {
+function I(e) {
+  const t = e.resourceTypes.flatMap((s) => s.startupSnapshot ? [
+    {
+      ...s.startupSnapshot,
+      resourceTypeId: s.resourceTypeId
+    }
+  ] : []);
+  return t.length ? t : void 0;
+}
+function g(e) {
   if (e.mode === "dummy") {
-    const i = d(e);
-    return r({
+    const o = h(e);
+    return a({
       presetId: e.presetId,
       resourceTypeId: e.resourceTypeId,
-      runtimeKey: i,
-      storeId: i,
+      runtimeKey: o,
+      storeId: o,
       storeDevtoolsEnabled: e.storeDevtoolsEnabled ?? !1
     });
   }
-  const s = f(e);
-  if (!s || !e.hostApiRemote)
+  const t = y(e);
+  if (!t || !e.hostApiRemote)
     return {};
-  const o = p(e);
+  const s = c(e);
   return l({
-    runtimeKey: o,
-    storeId: o,
+    runtimeKey: s,
+    storeId: s,
     storeDevtoolsEnabled: e.storeDevtoolsEnabled ?? !1,
-    resourceTypesConfig: [s]
+    resourceTypesConfig: t,
+    startSourceData: !e.snapshotOnly,
+    startupSnapshots: I(e)
   });
 }
 export {
-  f as createGClickAtmosphereRuntimeConfig,
-  p as createGClickAtmosphereRuntimeKey,
-  d as createGClickDummyRuntimeKey,
-  c as launchGClickRealtimeHostRuntime,
-  t as normalizeGClickRealtimeFallbackTransport,
-  n as normalizeGClickRealtimeSessionId,
-  m as resolveGClickRealtimeAtmosphereHost
+  y as createGClickAtmosphereRuntimeConfigs,
+  c as createGClickAtmosphereRuntimeKey,
+  I as createGClickAtmosphereStartupSnapshots,
+  h as createGClickDummyRuntimeKey,
+  g as launchGClickRealtimeHostRuntime,
+  r as normalizeGClickRealtimeFallbackTransport,
+  i as normalizeGClickRealtimeSessionId,
+  p as resolveGClickRealtimeAtmosphereHost
 };

package/web/host/startupSnapshots.d.ts

@@ -0,0 +1,32 @@
+import { RealTimeMessage, RealTimeResourceTypeId } from '../shared/runtimeTypes';
+import { RealTimeProducerTools } from '@m4l/realtime-runtime';
+/**
+ * Loader contract used by a shell to fetch one startup snapshot for a resource type.
+ */
+export type GClickRealtimeStartupSnapshotMessagesLoader = () => Promise<RealTimeMessage[]> | RealTimeMessage[];
+/**
+ * Startup snapshot definition owned by one resource-type launch entry.
+ */
+export interface GClickRealtimeResourceStartupSnapshotConfig {
+    loadMessages: GClickRealtimeStartupSnapshotMessagesLoader;
+}
+/**
+ * Runtime-level startup snapshot definition after the resource type owns its target id.
+ */
+export interface GClickRealtimeStartupSnapshotConfig extends GClickRealtimeResourceStartupSnapshotConfig {
+    resourceTypeId: RealTimeResourceTypeId;
+}
+export interface ReplayGClickRealtimeStartupSnapshotsOnceProps {
+    producerTools: RealTimeProducerTools;
+    runtimeKey: string;
+    startupSnapshots?: GClickRealtimeStartupSnapshotConfig[];
+}
+/**
+ * Replay all configured startup snapshots without blocking host-runtime creation.
+ */
+export declare function replayGClickRealtimeStartupSnapshotsOnce(props: ReplayGClickRealtimeStartupSnapshotsOnceProps): void;
+/**
+ * Clear startup snapshot idempotency state between focused unit tests.
+ */
+export declare function resetGClickRealtimeStartupSnapshotsForTesting(): void;
+//# sourceMappingURL=startupSnapshots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"startupSnapshots.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/host/startupSnapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,2CAA2C,GAAG,MACxD,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,2CAA2C;IAC1D,YAAY,EAAE,2CAA2C,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,mCACf,SAAQ,2CAA2C;IACnD,cAAc,EAAE,sBAAsB,CAAC;CACxC;AAED,MAAM,WAAW,6CAA6C;IAC5D,aAAa,EAAE,qBAAqB,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,mCAAmC,EAAE,CAAC;CAC1D;AAwDD;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,6CAA6C,GACnD,IAAI,CA2BN;AAED;;GAEG;AACH,wBAAgB,6CAA6C,IAAI,IAAI,CAGpE"}

package/web/host/startupSnapshots.js

@@ -0,0 +1,50 @@
+const p = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Set();
+function c(t, s) {
+  return `${t}:${s}`;
+}
+async function u(t) {
+  const {
+    producerTools: s,
+    startupSnapshot: a,
+    startupSnapshotKey: r
+  } = t;
+  try {
+    const e = await a.loadMessages();
+    e.length && s.publishMessages(
+      a.resourceTypeId,
+      e,
+      "bootstrap"
+    ), p.add(r);
+  } catch (e) {
+    console.warn(
+      "GClick realtime startup snapshot replay failed.",
+      {
+        error: e,
+        resourceTypeId: a.resourceTypeId
+      }
+    );
+  } finally {
+    n.delete(r);
+  }
+}
+function l(t) {
+  const {
+    producerTools: s,
+    runtimeKey: a,
+    startupSnapshots: r = []
+  } = t;
+  r.forEach((e) => {
+    const o = c(
+      a,
+      e.resourceTypeId
+    );
+    p.has(o) || n.has(o) || (n.add(o), u({
+      producerTools: s,
+      startupSnapshot: e,
+      startupSnapshotKey: o
+    }));
+  });
+}
+export {
+  l as replayGClickRealtimeStartupSnapshotsOnce
+};

package/web/index.js

@@ -1,57 +1,63 @@
-import { createRealTimeProducerTools as o } from "@m4l/realtime-runtime/web";
-import { REAL_TIME_DUMMY_DEFAULT_PRESET_ID as m, REAL_TIME_DUMMY_SIMULATION_PRESETS as i, createRealTimeDummySimulationConfigFromPreset as R } from "../dummy/catalogs/presets.js";
-import { createRealTimeDummyResourceTypeConfigFromPreset as l } from "../dummy/runtime/simulation.js";
-import { RealTimeDummySimulationPresetId as u } from "../fixtures/types.js";
-import { RealTimeProducerContext as C, RealTimeProducerProvider as n } from "./producer/RealTimeProducerContext.js";
+import { createRealTimeProducerTools as t } from "@m4l/realtime-runtime/web";
+import { REAL_TIME_DUMMY_DEFAULT_PRESET_ID as m, REAL_TIME_DUMMY_SIMULATION_PRESETS as i, createRealTimeDummySimulationConfigFromPreset as a } from "../dummy/catalogs/presets.js";
+import { createRealTimeDummyResourceTypeConfigFromPreset as c } from "../dummy/runtime/simulation.js";
+import { RealTimeDummySimulationPresetId as s } from "../fixtures/types.js";
+import { RealTimeProducerContext as p, RealTimeProducerProvider as C } from "./producer/RealTimeProducerContext.js";
 import { useRealTimeProducer as T } from "./producer/useRealTimeProducer.js";
-import { createRealTimeProducerStore as f } from "./producer/store.js";
-import { SourceDataFactory as S } from "./producer/sourceDataFactory.js";
-import { RealTimeConsumerContext as G, RealTimeConsumerProvider as k } from "./consumer/RealTimeConsumerContext.js";
+import { createRealTimeProducerStore as E } from "./producer/store.js";
+import { SourceDataFactory as x } from "./producer/sourceDataFactory.js";
+import { RealTimeConsumerContext as k, RealTimeConsumerProvider as _ } from "./consumer/RealTimeConsumerContext.js";
 import { useRealTimeConsumer as A } from "./consumer/useRealTimeConsumer.js";
-import { createRealTimeConsumerStore as I } from "./consumer/store.js";
-import { createRealtimeRuntime as d } from "./runtime/runtime.js";
-import { createAtmosphereRealtimeRuntime as y } from "./runtime/runtimeAtmosphereOnly.js";
-import { getOrCreateGClickRealtimeRuntime as L } from "./runtime/runtimeRegistry.js";
-import { createGetOrCreateGClickRealtimeRuntime as g, disposeGClickRealtimeRuntime as F } from "./runtime/runtimeRegistry.shared.js";
+import { createRealTimeConsumerStore as P } from "./consumer/store.js";
+import { createRealtimeRuntime as M } from "./runtime/runtime.js";
+import { createAtmosphereRealtimeRuntime as d } from "./runtime/runtimeAtmosphereOnly.js";
+import { getOrCreateGClickRealtimeRuntime as v } from "./runtime/runtimeRegistry.js";
+import { createGetOrCreateGClickRealtimeRuntime as U, disposeGClickRealtimeRuntime as g } from "./runtime/runtimeRegistry.shared.js";
 import { getOrCreateGClickAtmosphereRealtimeRuntime as H } from "./runtime/runtimeRegistryAtmosphereOnly.js";
-import { launchGClickAtmosphereHostRuntime as Y, launchGClickDummyHostRuntime as z, resolveGClickRealtimeTools as K } from "./host/hostRuntime.js";
-import { createGClickAtmosphereRuntimeConfig as b, createGClickAtmosphereRuntimeKey as j, createGClickDummyRuntimeKey as q, launchGClickRealtimeHostRuntime as w, normalizeGClickRealtimeFallbackTransport as B, normalizeGClickRealtimeSessionId as J, resolveGClickRealtimeAtmosphereHost as Q } from "./host/launchContract.js";
-import { EnumResourceTypesIds as X, PROCCESS_MESSAGES_INTERVAL as Z, REALTIME_CONSUMER_SOTORE_ID as $, REALTIME_PRODUCER_SOTORE_ID as ee, RESOURCE_TYPE_DEVICES as re } from "./shared/constants.js";
+import { createGClickDevicesAtmosphereResourceType as Y, createGClickDevicesHotStartupSnapshot as z, createGClickDevicesStartupSnapshot as K, createGClickDevicesStartupSnapshotMessages as V } from "./host/devicesResourceType.js";
+import { launchGClickAtmosphereHostRuntime as j, launchGClickDummyHostRuntime as q, resolveGClickRealtimeTools as w } from "./host/hostRuntime.js";
+import { createGClickAtmosphereRuntimeConfigs as J, createGClickAtmosphereRuntimeKey as Q, createGClickAtmosphereStartupSnapshots as W, createGClickDummyRuntimeKey as X, launchGClickRealtimeHostRuntime as Z, normalizeGClickRealtimeFallbackTransport as $, normalizeGClickRealtimeSessionId as ee, resolveGClickRealtimeAtmosphereHost as re } from "./host/launchContract.js";
+import { EnumResourceTypesIds as oe, PROCCESS_MESSAGES_INTERVAL as me, REALTIME_CONSUMER_SOTORE_ID as ie, REALTIME_PRODUCER_SOTORE_ID as ae, RESOURCE_TYPE_DEVICES as le } from "./shared/constants.js";
 export {
-  X as EnumResourceTypesIds,
-  Z as PROCCESS_MESSAGES_INTERVAL,
-  $ as REALTIME_CONSUMER_SOTORE_ID,
-  ee as REALTIME_PRODUCER_SOTORE_ID,
+  oe as EnumResourceTypesIds,
+  me as PROCCESS_MESSAGES_INTERVAL,
+  ie as REALTIME_CONSUMER_SOTORE_ID,
+  ae as REALTIME_PRODUCER_SOTORE_ID,
   m as REAL_TIME_DUMMY_DEFAULT_PRESET_ID,
   i as REAL_TIME_DUMMY_SIMULATION_PRESETS,
-  re as RESOURCE_TYPE_DEVICES,
-  G as RealTimeConsumerContext,
-  k as RealTimeConsumerProvider,
-  u as RealTimeDummySimulationPresetId,
-  C as RealTimeProducerContext,
-  n as RealTimeProducerProvider,
-  S as SourceDataFactory,
-  y as createAtmosphereRealtimeRuntime,
-  b as createGClickAtmosphereRuntimeConfig,
-  j as createGClickAtmosphereRuntimeKey,
-  q as createGClickDummyRuntimeKey,
-  g as createGetOrCreateGClickRealtimeRuntime,
-  I as createRealTimeConsumerStore,
-  l as createRealTimeDummyResourceTypeConfigFromPreset,
-  R as createRealTimeDummySimulationConfigFromPreset,
-  f as createRealTimeProducerStore,
-  o as createRealTimeProducerTools,
-  d as createRealtimeRuntime,
-  F as disposeGClickRealtimeRuntime,
+  le as RESOURCE_TYPE_DEVICES,
+  k as RealTimeConsumerContext,
+  _ as RealTimeConsumerProvider,
+  s as RealTimeDummySimulationPresetId,
+  p as RealTimeProducerContext,
+  C as RealTimeProducerProvider,
+  x as SourceDataFactory,
+  d as createAtmosphereRealtimeRuntime,
+  J as createGClickAtmosphereRuntimeConfigs,
+  Q as createGClickAtmosphereRuntimeKey,
+  W as createGClickAtmosphereStartupSnapshots,
+  Y as createGClickDevicesAtmosphereResourceType,
+  z as createGClickDevicesHotStartupSnapshot,
+  K as createGClickDevicesStartupSnapshot,
+  V as createGClickDevicesStartupSnapshotMessages,
+  X as createGClickDummyRuntimeKey,
+  U as createGetOrCreateGClickRealtimeRuntime,
+  P as createRealTimeConsumerStore,
+  c as createRealTimeDummyResourceTypeConfigFromPreset,
+  a as createRealTimeDummySimulationConfigFromPreset,
+  E as createRealTimeProducerStore,
+  t as createRealTimeProducerTools,
+  M as createRealtimeRuntime,
+  g as disposeGClickRealtimeRuntime,
   H as getOrCreateGClickAtmosphereRealtimeRuntime,
-  L as getOrCreateGClickRealtimeRuntime,
-  Y as launchGClickAtmosphereHostRuntime,
-  z as launchGClickDummyHostRuntime,
-  w as launchGClickRealtimeHostRuntime,
-  B as normalizeGClickRealtimeFallbackTransport,
-  J as normalizeGClickRealtimeSessionId,
-  Q as resolveGClickRealtimeAtmosphereHost,
-  K as resolveGClickRealtimeTools,
+  v as getOrCreateGClickRealtimeRuntime,
+  j as launchGClickAtmosphereHostRuntime,
+  q as launchGClickDummyHostRuntime,
+  Z as launchGClickRealtimeHostRuntime,
+  $ as normalizeGClickRealtimeFallbackTransport,
+  ee as normalizeGClickRealtimeSessionId,
+  re as resolveGClickRealtimeAtmosphereHost,
+  w as resolveGClickRealtimeTools,
   A as useRealTimeConsumer,
   T as useRealTimeProducer
 };

package/web/producer/sourceDataFactory.d.ts

@@ -1,13 +1,13 @@
-import { OnMessagesStoreCallback, SourceDataBase } from '@m4l/realtime-runtime';
+import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, SourceDataBase } from '@m4l/realtime-runtime';
 import { RealTimeResourceSourceMechanismConfigBase } from '../shared/runtimeTypes';
 /**
  * Source data factory.
  */
 export declare class SourceDataFactory {
     /**
-     * Create a source data object.
+     * Create a runtime-scoped source-data factory that reuses one Atmosphere transport per app/runtime.
      */
-    static createSourceData(config: RealTimeResourceSourceMechanismConfigBase, onMessages: OnMessagesStoreCallback): SourceDataBase;
+    static createSourceDataFactory(): (config: RealTimeResourceSourceMechanismConfigBase, onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback) => SourceDataBase;
 }
 export default SourceDataFactory;
 //# sourceMappingURL=sourceDataFactory.d.ts.map

package/web/producer/sourceDataFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sourceDataFactory.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/producer/sourceDataFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAEV,yCAAyC,EAC1C,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,yCAAyC,EACjD,UAAU,EAAE,uBAAuB,GAClC,cAAc;CAgBlB;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"sourceDataFactory.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/producer/sourceDataFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,cAAc,EACf,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAEV,yCAAyC,EAC1C,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,uBAAuB,KAI1B,QAAQ,yCAAyC,EACjD,YAAY,uBAAuB,EACnC,sBAAsB,gCAAgC,KACrD,cAAc;CAkBpB;AAED,eAAe,iBAAiB,CAAC"}

package/web/producer/sourceDataFactory.js

@@ -1,27 +1,31 @@
-import { SourceDataAtmosphere as t } from "@m4l/realtime-runtime";
-import { SourceDataDummy as a } from "../../dummy/runtime/dummy.js";
-class m {
+import { createAtmosphereSourceDataFactory as c } from "@m4l/realtime-runtime";
+import { SourceDataDummy as o } from "../../dummy/runtime/dummy.js";
+class D {
   /**
-   * Create a source data object.
+   * Create a runtime-scoped source-data factory that reuses one Atmosphere transport per app/runtime.
    */
-  static createSourceData(r, e) {
-    switch (r.sourceDataMechanism) {
-      case "dummy":
-        return new a(
-          r,
-          e
-        );
-      case "atmosphere":
-        return new t(
-          r,
-          e
-        );
-      default:
-        throw new Error("Unknown resource type");
-    }
+  static createSourceDataFactory() {
+    const t = c();
+    return function(r, e, a) {
+      switch (r.sourceDataMechanism) {
+        case "dummy":
+          return new o(
+            r,
+            e
+          );
+        case "atmosphere":
+          return t(
+            r,
+            e,
+            a
+          );
+        default:
+          throw new Error("Unknown resource type");
+      }
+    };
   }
 }
 export {
-  m as SourceDataFactory,
-  m as default
+  D as SourceDataFactory,
+  D as default
 };

package/web/runtime/resourceTypeMergeStrategies.d.ts

@@ -0,0 +1,10 @@
+import { RealTimeResourceSourceMechanismConfigBase } from '../shared/runtimeTypes';
+/**
+ * Attach the default GClick merge strategy for one resource type when the caller did not provide one.
+ */
+export declare function withGClickResourceTypeMergeStrategy<TConfig extends RealTimeResourceSourceMechanismConfigBase>(config: TConfig): TConfig;
+/**
+ * Attach default GClick merge strategies to all configured realtime resource types.
+ */
+export declare function withGClickResourceTypeMergeStrategies<TConfig extends RealTimeResourceSourceMechanismConfigBase>(resourceTypesConfig: TConfig[]): TConfig[];
+//# sourceMappingURL=resourceTypeMergeStrategies.d.ts.map

package/web/runtime/resourceTypeMergeStrategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTypeMergeStrategies.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick-realtime/src/web/runtime/resourceTypeMergeStrategies.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,yCAAyC,EAE1C,MAAM,wBAAwB,CAAC;AAShC;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,SAAS,yCAAyC,EACzD,MAAM,EAAE,OAAO,GAAG,OAAO,CAY1B;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,SAAS,yCAAyC,EACzD,mBAAmB,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAE3C"}