@m4l/realtime-runtime 1.3.0 → 1.4.0

package/contracts/index.d.ts

@@ -1,2 +1,2 @@
-export type { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeConsumerMessageCallback, OnRealtimeConsumerSubscribeCallback, RealTimeMessage, RealTimeMessageIngressReason, RealTimeResourceMessageNormalizeContext, RealTimeResourceMessageNormalizeStrategy, RealTimeMessagePayload, RealTimeProducerTools, RealTimeProducerMetricName, RealTimeReadonlyResourceHash, RealTimeResourceMergeContext, RealTimeResourceHash, RealTimeResourcePayloadMergeStrategy, RealTimeResourceRuntimeMeta, RealTimeResourceSerialId, RealTimeResourceSourceMechanismConfig, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceSourceMechanismConfigBase, RealTimeResourceType, RealTimeResourceTypeId, RealTimeStatus, ResourceTypeSourceDataMechanism, SubscribeOptions, SubscribeResourceTypeOptions, Subscriber, } from './types';
+export type { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeTransportReconnectCallback, OnRealTimeConsumerMessageCallback, OnRealtimeConsumerSubscribeCallback, RealTimeMessage, RealTimeMessageIngressReason, RealTimeResourceMessageNormalizeContext, RealTimeResourceMessageNormalizeStrategy, RealTimeMessagePayload, RealTimeProducerTools, RealTimeProducerMetricName, RealTimeReadonlyResourceHash, RealTimeResourceMergeContext, RealTimeResourceHash, RealTimeResourcePayloadMergeStrategy, RealTimeResourceRuntimeMeta, RealTimeResourceSerialId, RealTimeResourceSourceMechanismConfig, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceSourceMechanismConfigBase, RealTimeTransportBrowserRecoveryTrigger, RealTimeTransportReconnectEvent, RealTimeTransportReconnectReason, RealTimeResourceType, RealTimeResourceTypeId, RealTimeStatus, ResourceTypeSourceDataMechanism, SubscribeOptions, SubscribeResourceTypeOptions, Subscriber, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/contracts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,EACnC,eAAe,EACf,4BAA4B,EAC5B,uCAAuC,EACvC,wCAAwC,EACxC,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oCAAoC,EACpC,2BAA2B,EAC3B,wBAAwB,EACxB,qCAAqC,EACrC,+CAA+C,EAC/C,yCAAyC,EACzC,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,+BAA+B,EAC/B,gBAAgB,EAChB,4BAA4B,EAC5B,UAAU,GACX,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/contracts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,gCAAgC,EAChC,oCAAoC,EACpC,iCAAiC,EACjC,mCAAmC,EACnC,eAAe,EACf,4BAA4B,EAC5B,uCAAuC,EACvC,wCAAwC,EACxC,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oCAAoC,EACpC,2BAA2B,EAC3B,wBAAwB,EACxB,qCAAqC,EACrC,+CAA+C,EAC/C,yCAAyC,EACzC,uCAAuC,EACvC,+BAA+B,EAC/B,gCAAgC,EAChC,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,+BAA+B,EAC/B,gBAAgB,EAChB,4BAA4B,EAC5B,UAAU,GACX,MAAM,SAAS,CAAC"}

package/contracts/types.d.ts

@@ -290,6 +290,33 @@ export interface RealTimeResourceType {
  * Callback used by realtime source mechanisms to forward messages into the store.
  */
 export type OnMessagesStoreCallback = (resourceTypeId: RealTimeResourceTypeId, message: RealTimeMessage[]) => void;
+/**
+ * Low-cardinality reconnect reasons emitted by browser realtime transports.
+ */
+export type RealTimeTransportReconnectReason = 'browser_recovery' | 'failure_to_reconnect' | 'open_timeout' | 'transport_closed' | 'transport_error' | 'transport_failure';
+/**
+ * Browser lifecycle triggers that can force one stale transport recovery.
+ */
+export type RealTimeTransportBrowserRecoveryTrigger = 'focus' | 'online' | 'visibilitychange';
+/**
+ * Host-owned reconnect event emitted when one browser realtime transport recovers.
+ */
+export interface RealTimeTransportReconnectEvent {
+    browserRecoveryTrigger?: RealTimeTransportBrowserRecoveryTrigger;
+    reconnectDurationMs: number;
+    reconnectReason: RealTimeTransportReconnectReason;
+    resourceTypeIds: RealTimeResourceTypeId[];
+    responseError?: string;
+    responseReason?: string;
+    responseState?: string;
+    sourceDataMechanism: 'atmosphere';
+    transport?: string;
+    transportAttempt: number;
+}
+/**
+ * Optional callback used by browser runtimes to report one recovered transport.
+ */
+export type OnRealTimeTransportReconnectCallback = (event: RealTimeTransportReconnectEvent) => void;
 /**
  * Producer-runtime metric names emitted by the generic engine.
  */

package/contracts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/contracts/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/contracts/types.ts"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -6,5 +6,5 @@ export { createAtmosphereSourceData } from './transport';
 export { createAtmosphereSourceDataFactory } from './transport';
 export { SourceDataAtmosphere } from './transport';
 export type { AtmosphereMessage } from './transport';
-export type { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeConsumerMessageCallback, OnRealtimeConsumerSubscribeCallback, RealTimeMessage, RealTimeMessageIngressReason, RealTimeResourceMessageNormalizeContext, RealTimeResourceMessageNormalizeStrategy, RealTimeMessagePayload, RealTimeProducerTools, RealTimeProducerMetricName, RealTimeReadonlyResourceHash, RealTimeResourceMergeContext, RealTimeResourceHash, RealTimeResourcePayloadMergeStrategy, RealTimeResourceRuntimeMeta, RealTimeResourceSerialId, RealTimeResourceSourceMechanismConfig, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceSourceMechanismConfigBase, RealTimeResourceType, RealTimeResourceTypeId, RealTimeStatus, ResourceTypeSourceDataMechanism, SubscribeOptions, SubscribeResourceTypeOptions, Subscriber, } from './contracts';
+export type { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeTransportReconnectCallback, OnRealTimeConsumerMessageCallback, OnRealtimeConsumerSubscribeCallback, RealTimeMessage, RealTimeMessageIngressReason, RealTimeResourceMessageNormalizeContext, RealTimeResourceMessageNormalizeStrategy, RealTimeMessagePayload, RealTimeProducerTools, RealTimeProducerMetricName, RealTimeReadonlyResourceHash, RealTimeResourceMergeContext, RealTimeResourceHash, RealTimeResourcePayloadMergeStrategy, RealTimeResourceRuntimeMeta, RealTimeResourceSerialId, RealTimeResourceSourceMechanismConfig, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceSourceMechanismConfigBase, RealTimeTransportBrowserRecoveryTrigger, RealTimeTransportReconnectEvent, RealTimeTransportReconnectReason, RealTimeResourceType, RealTimeResourceTypeId, RealTimeStatus, ResourceTypeSourceDataMechanism, SubscribeOptions, SubscribeResourceTypeOptions, Subscriber, } from './contracts';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/realtime-runtime/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EACV,uBAAuB,EACvB,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,EACnC,eAAe,EACf,4BAA4B,EAC5B,uCAAuC,EACvC,wCAAwC,EACxC,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oCAAoC,EACpC,2BAA2B,EAC3B,wBAAwB,EACxB,qCAAqC,EACrC,+CAA+C,EAC/C,yCAAyC,EACzC,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,+BAA+B,EAC/B,gBAAgB,EAChB,4BAA4B,EAC5B,UAAU,GACX,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/realtime-runtime/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EACV,uBAAuB,EACvB,gCAAgC,EAChC,oCAAoC,EACpC,iCAAiC,EACjC,mCAAmC,EACnC,eAAe,EACf,4BAA4B,EAC5B,uCAAuC,EACvC,wCAAwC,EACxC,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,oCAAoC,EACpC,2BAA2B,EAC3B,wBAAwB,EACxB,qCAAqC,EACrC,+CAA+C,EAC/C,yCAAyC,EACzC,uCAAuC,EACvC,+BAA+B,EAC/B,gCAAgC,EAChC,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,+BAA+B,EAC/B,gBAAgB,EAChB,4BAA4B,EAC5B,UAAU,GACX,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l/realtime-runtime",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "publishConfig": {
     "access": "public"
   },

package/transport/atmosphere/SourceDataAtmosphere.d.ts

@@ -1,4 +1,4 @@
-import { OnRealTimeProducerMetricCallback, OnMessagesStoreCallback, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceTypeId } from '../../contracts';
+import { OnRealTimeProducerMetricCallback, OnRealTimeTransportReconnectCallback, OnMessagesStoreCallback, RealTimeResourceSourceMechanismConfigAtmosphere, RealTimeResourceTypeId } from '../../contracts';
 import { SourceDataBase } from '../SourceDataBase';
 /**
  * Normalize the Atmosphere request base URL so websocket upgrades and HTTP fallback transports share one safe origin.
@@ -10,13 +10,16 @@ declare function resolveAtmosphereRequestUrl(config: RealTimeResourceSourceMecha
 export declare class SharedAtmosphereTransport {
     private readonly onMessages;
     private readonly onPerformanceMetric?;
+    private readonly onTransportReconnect?;
     private subSocket;
     private reconnectTimeout;
     private transportOpenTimeout;
     private transportAttempt;
     private browserRecoveryListenersBound;
     private isTransportOpen;
+    private hasCompletedOneTransportOpen;
     private lastMessageTime;
+    private pendingReconnect;
     private connectionSignature;
     private readonly activeConfigs;
     /**
@@ -31,7 +34,7 @@ export declare class SharedAtmosphereTransport {
      * Recheck the current transport when the tab becomes visible again.
      */
     private readonly handleBrowserVisibilityChange;
-    constructor(onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback | undefined);
+    constructor(onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback | undefined, onTransportReconnect?: OnRealTimeTransportReconnectCallback | undefined);
     /**
      * Register one resource type in the active shared transport group.
      */
@@ -84,6 +87,14 @@ export declare class SharedAtmosphereTransport {
      * Mark the transport as healthy again after one successful open or message.
      */
     private markTransportHealthy;
+    /**
+     * Remember why the next successful open should count as one recovered transport.
+     */
+    private armPendingReconnect;
+    /**
+     * Emit one host-owned reconnect event after the transport becomes healthy again.
+     */
+    private emitTransportReconnect;
     /**
      * Force one fresh reconnect when the current transport never reaches onOpen.
      */
@@ -110,7 +121,7 @@ export declare class SharedAtmosphereTransport {
  */
 export declare class SourceDataAtmosphere extends SourceDataBase {
     private readonly sharedTransport;
-    constructor(config: RealTimeResourceSourceMechanismConfigAtmosphere, onMessages: OnMessagesStoreCallback, sharedTransport?: SharedAtmosphereTransport, onPerformanceMetric?: OnRealTimeProducerMetricCallback);
+    constructor(config: RealTimeResourceSourceMechanismConfigAtmosphere, onMessages: OnMessagesStoreCallback, sharedTransport?: SharedAtmosphereTransport, onPerformanceMetric?: OnRealTimeProducerMetricCallback, onTransportReconnect?: OnRealTimeTransportReconnectCallback);
     /**
      * Start the realtime transport connection.
      */
@@ -121,5 +132,5 @@ export declare class SourceDataAtmosphere extends SourceDataBase {
     stop(): void;
 }
 export default SourceDataAtmosphere;
-export { resolveAtmosphereRequestUrl, };
+export { resolveAtmosphereRequestUrl };
 //# sourceMappingURL=SourceDataAtmosphere.d.ts.map

package/transport/atmosphere/SourceDataAtmosphere.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceDataAtmosphere.d.ts","sourceRoot":"","sources":["../../../../../../packages/realtime-runtime/src/transport/atmosphere/SourceDataAtmosphere.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,uBAAuB,EAEvB,+CAA+C,EAC/C,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwGnD;;GAEG;AACH,iBAAS,2BAA2B,CAClC,MAAM,EAAE,+CAA+C,UA0BxD;AAED;;GAEG;AACH,qBAAa,yBAAyB;IAuClC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAtCvC,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,gBAAgB,CAAyD;IACjF,OAAO,CAAC,oBAAoB,CAAyD;IACrF,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,6BAA6B,CAAS;IAC9C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEjC;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAElC;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAI5C;gBAGiB,UAAU,EAAE,uBAAuB,EACnC,mBAAmB,CAAC,EAAE,gCAAgC,YAAA;IAGzE;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,+CAA+C;IAoB7D;;OAEG;IACH,IAAI,CAAC,cAAc,EAAE,sBAAsB;IAW3C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAOjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAWjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAWpC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAWtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAuBxC;;OAEG;IACH,OAAO,CAAC,OAAO;IAmMf;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAe1B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;gBAG1D,MAAM,EAAE,+CAA+C,EACvD,UAAU,EAAE,uBAAuB,EACnC,eAAe,CAAC,EAAE,yBAAyB,EAC3C,mBAAmB,CAAC,EAAE,gCAAgC;IAUxD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,IAAI;CAGb;AAED,eAAe,oBAAoB,CAAC;AACpC,OAAO,EACL,2BAA2B,GAC5B,CAAC"}
+{"version":3,"file":"SourceDataAtmosphere.d.ts","sourceRoot":"","sources":["../../../../../../packages/realtime-runtime/src/transport/atmosphere/SourceDataAtmosphere.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,uBAAuB,EAIvB,+CAA+C,EAC/C,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA+GnD;;GAEG;AACH,iBAAS,2BAA2B,CAClC,MAAM,EAAE,+CAA+C,UA0BxD;AAED;;GAEG;AACH,qBAAa,yBAAyB;IA6ClC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IA9CxC,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,gBAAgB,CACjB;IACP,OAAO,CAAC,oBAAoB,CAEZ;IAChB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,6BAA6B,CAAS;IAC9C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,4BAA4B,CAAS;IAC7C,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEjC;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAElC;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAM5C;gBAGiB,UAAU,EAAE,uBAAuB,EACnC,mBAAmB,CAAC,EAAE,gCAAgC,YAAA,EACtD,oBAAoB,CAAC,EAAE,oCAAoC,YAAA;IAG9E;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,+CAA+C;IAoB7D;;OAEG;IACH,IAAI,CAAC,cAAc,EAAE,sBAAsB;IAW3C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAWjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAiBtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAwCxC;;OAEG;IACH,OAAO,CAAC,OAAO;IA6Of;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAgB1B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;gBAG1D,MAAM,EAAE,+CAA+C,EACvD,UAAU,EAAE,uBAAuB,EACnC,eAAe,CAAC,EAAE,yBAAyB,EAC3C,mBAAmB,CAAC,EAAE,gCAAgC,EACtD,oBAAoB,CAAC,EAAE,oCAAoC;IAY7D;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,IAAI;CAGb;AAED,eAAe,oBAAoB,CAAC;AACpC,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/transport/atmosphere/SourceDataAtmosphere.js

@@ -1,24 +1,24 @@
-import { SourceDataBase as y } from "../SourceDataBase.js";
-import * as A from "atmosphere.js";
-import S from "camelcase-keys";
-const g = "warn", R = 2e3, O = 1e4, M = 6e4, d = "2.0.0";
+import { SourceDataBase as g } from "../SourceDataBase.js";
+import * as w from "atmosphere.js";
+import y from "camelcase-keys";
+const A = "warn", S = 2e3, O = 1e4, M = 6e4, f = "2.0.0";
 function E() {
-  const t = A;
+  const t = w;
   return t.subscribe ?? t.default?.subscribe;
 }
-function f() {
+function o() {
   return typeof globalThis.performance?.now == "function" ? globalThis.performance.now() : Date.now();
 }
-function c(t) {
-  return t ? f() : 0;
+function u(t) {
+  return t ? o() : 0;
 }
-function u(t, e, s) {
+function p(t, e, s) {
   t && t(
     e,
-    Math.max(0, f() - s)
+    Math.max(0, o() - s)
   );
 }
-function L(t) {
+function C(t) {
   return {
     action: t.action,
     session_id: t.sessionId,
@@ -36,23 +36,23 @@ function L(t) {
     }))
   };
 }
-function m(t) {
+function d(t) {
   return JSON.stringify({
     database: t.database,
     fallbackTransport: t.fallbackTransport ?? "long-polling",
     requestUrl: T(t),
     sessionId: t.sessionId,
     accountId: t.accountId,
-    version: t.version ?? d
+    version: t.version ?? f
   });
 }
 function T(t) {
   const e = t.host.trim(), r = `${e.endsWith(t.path) ? "" : t.path}${t.topic}`;
   return e ? e.startsWith("wss://") ? `https://${e.slice(6)}${r}` : e.startsWith("ws://") ? `http://${e.slice(5)}${r}` : e.startsWith("https://") || e.startsWith("http://") ? `${e}${r}` : `https://${e}${r}` : `${t.path}${t.topic}`;
 }
-class B {
-  constructor(e, s) {
-    this.onMessages = e, this.onPerformanceMetric = s;
+class L {
+  constructor(e, s, r) {
+    this.onMessages = e, this.onPerformanceMetric = s, this.onTransportReconnect = r;
   }
   subSocket = null;
   reconnectTimeout = null;
@@ -60,7 +60,9 @@ class B {
   transportAttempt = 0;
   browserRecoveryListenersBound = !1;
   isTransportOpen = !1;
-  lastMessageTime = performance.now();
+  hasCompletedOneTransportOpen = !1;
+  lastMessageTime = o();
+  pendingReconnect = null;
   connectionSignature = null;
   activeConfigs = /* @__PURE__ */ new Map();
   /**
@@ -86,7 +88,7 @@ class B {
    */
   start(e) {
     const s = this.activeConfigs.size === 0;
-    if (this.assertCompatibleConfig(e), this.activeConfigs.set(e.resourceTypeId, e), this.connectionSignature = this.connectionSignature ?? m(e), s) {
+    if (this.assertCompatibleConfig(e), this.activeConfigs.set(e.resourceTypeId, e), this.connectionSignature = this.connectionSignature ?? d(e), s) {
       this.bindBrowserRecoveryListeners(), this.connect();
       return;
     }
@@ -102,7 +104,7 @@ class B {
    * Keep one shared transport restricted to a single Atmosphere connection contract per runtime.
    */
   assertCompatibleConfig(e) {
-    if (!(!this.connectionSignature || m(e) === this.connectionSignature))
+    if (!(!this.connectionSignature || d(e) === this.connectionSignature))
       throw new Error(
         "Atmosphere runtime factory only supports one shared Atmosphere connection per runtime. Received one incompatible resource config that would require a second socket."
       );
@@ -114,7 +116,7 @@ class B {
     const e = this.getRepresentativeConfig();
     if (!e || !this.subSocket)
       return;
-    this.lastMessageTime = performance.now();
+    this.lastMessageTime = o();
     const s = {
       action: "subscribe",
       database: e.database,
@@ -128,11 +130,11 @@ class B {
       })),
       sessionId: e.sessionId,
       accountId: e.accountId,
-      version: e.version ?? d
+      version: e.version ?? f
     };
-    this.subSocket.push?.(JSON.stringify(
-      L(s)
-    ));
+    this.subSocket.push?.(
+      JSON.stringify(C(s))
+    );
   }
   /**
    * Return the current compatibility config that defines the shared connection details.
@@ -174,26 +176,62 @@ class B {
    * Attach browser lifecycle listeners that can recover one stale tab transport.
    */
   bindBrowserRecoveryListeners() {
-    this.browserRecoveryListenersBound || !this.hasBrowserRecoverySupport() || (window.addEventListener("focus", this.handleBrowserFocus), window.addEventListener("online", this.handleBrowserOnline), document.addEventListener("visibilitychange", this.handleBrowserVisibilityChange), this.browserRecoveryListenersBound = !0);
+    this.browserRecoveryListenersBound || !this.hasBrowserRecoverySupport() || (window.addEventListener("focus", this.handleBrowserFocus), window.addEventListener("online", this.handleBrowserOnline), document.addEventListener(
+      "visibilitychange",
+      this.handleBrowserVisibilityChange
+    ), this.browserRecoveryListenersBound = !0);
   }
   /**
    * Remove browser lifecycle listeners during transport shutdown.
    */
   unbindBrowserRecoveryListeners() {
-    !this.browserRecoveryListenersBound || !this.hasBrowserRecoverySupport() || (window.removeEventListener("focus", this.handleBrowserFocus), window.removeEventListener("online", this.handleBrowserOnline), document.removeEventListener("visibilitychange", this.handleBrowserVisibilityChange), this.browserRecoveryListenersBound = !1);
+    !this.browserRecoveryListenersBound || !this.hasBrowserRecoverySupport() || (window.removeEventListener("focus", this.handleBrowserFocus), window.removeEventListener("online", this.handleBrowserOnline), document.removeEventListener(
+      "visibilitychange",
+      this.handleBrowserVisibilityChange
+    ), this.browserRecoveryListenersBound = !1);
   }
   /**
    * Mark the transport as healthy again after one successful open or message.
    */
   markTransportHealthy() {
-    this.isTransportOpen = !0, this.lastMessageTime = performance.now(), this.clearTransportOpenTimeout(), this.clearReconnectTimeout();
+    this.isTransportOpen = !0, this.lastMessageTime = o(), this.clearTransportOpenTimeout(), this.clearReconnectTimeout();
+  }
+  /**
+   * Remember why the next successful open should count as one recovered transport.
+   */
+  armPendingReconnect(e, s = {}) {
+    this.pendingReconnect || (this.pendingReconnect = {
+      reconnectReason: e,
+      startedAtMs: o(),
+      ...s
+    });
+  }
+  /**
+   * Emit one host-owned reconnect event after the transport becomes healthy again.
+   */
+  emitTransportReconnect(e) {
+    if (!this.pendingReconnect)
+      return;
+    const s = this.pendingReconnect;
+    this.pendingReconnect = null, this.onTransportReconnect?.({
+      ...s,
+      reconnectDurationMs: Math.max(
+        0,
+        o() - s.startedAtMs
+      ),
+      resourceTypeIds: Array.from(this.activeConfigs.keys()),
+      sourceDataMechanism: "atmosphere",
+      transportAttempt: e
+    });
   }
   /**
    * Force one fresh reconnect when the current transport never reaches onOpen.
    */
   armTransportOpenTimeout(e) {
     this.clearTransportOpenTimeout(), this.transportOpenTimeout = setTimeout(() => {
-      this.transportOpenTimeout = null, this.isActiveAttempt(e) && (console.warn("Atmosphere: transport open timed out; scheduling reconnect"), this.tryReconnect());
+      this.transportOpenTimeout = null, this.isActiveAttempt(e) && (console.warn(
+        "Atmosphere: transport open timed out; scheduling reconnect"
+      ), this.armPendingReconnect("open_timeout"), this.tryReconnect());
     }, O);
   }
   /**
@@ -203,15 +241,25 @@ class B {
     if (!this.activeConfigs.size)
       return;
     if (!this.subSocket) {
-      console.warn("Atmosphere: browser recovery found no active socket; scheduling reconnect", {
-        reason: e
+      console.warn(
+        "Atmosphere: browser recovery found no active socket; scheduling reconnect",
+        {
+          reason: e
+        }
+      ), this.armPendingReconnect("browser_recovery", {
+        browserRecoveryTrigger: e
       }), this.tryReconnect();
       return;
     }
-    const s = performance.now() - this.lastMessageTime;
-    s < M || (console.warn("Atmosphere: browser recovery found one stale transport; scheduling reconnect", {
-      reason: e,
-      silenceDurationMs: s
+    const s = o() - this.lastMessageTime;
+    s < M || (console.warn(
+      "Atmosphere: browser recovery found one stale transport; scheduling reconnect",
+      {
+        reason: e,
+        silenceDurationMs: s
+      }
+    ), this.armPendingReconnect("browser_recovery", {
+      browserRecoveryTrigger: e
     }), this.tryReconnect());
   }
   /**
@@ -223,10 +271,10 @@ class B {
       return;
     const s = T(e), r = this.transportAttempt + 1;
     this.transportAttempt = r, this.isTransportOpen = !1;
-    const h = {
+    const l = {
       url: s,
       contentType: "application/json",
-      logLevel: g,
+      logLevel: A,
       transport: "websocket",
       fallbackTransport: e.fallbackTransport ?? "long-polling",
       reconnectInterval: 2e3,
@@ -234,13 +282,13 @@ class B {
        * Resubscribe as soon as the connection opens.
        */
       onOpen: () => {
-        this.isActiveAttempt(r) && (this.markTransportHealthy(), this.sendSubscribe());
+        this.isActiveAttempt(r) && (this.markTransportHealthy(), this.sendSubscribe(), this.hasCompletedOneTransportOpen ? this.emitTransportReconnect(r) : this.hasCompletedOneTransportOpen = !0);
       },
       /**
        * Resubscribe after an Atmosphere reconnect event.
        */
       onReopen: () => {
-        this.isActiveAttempt(r) && (this.markTransportHealthy(), this.sendSubscribe());
+        this.isActiveAttempt(r) && (this.markTransportHealthy(), this.sendSubscribe(), this.hasCompletedOneTransportOpen || (this.hasCompletedOneTransportOpen = !0), this.emitTransportReconnect(r));
       },
       /**
        * Decode one transport message and forward event batches into the producer store.
@@ -249,64 +297,64 @@ class B {
         if (!this.isActiveAttempt(r))
           return;
         this.markTransportHealthy();
-        const o = c(
+        const i = u(
           this.onPerformanceMetric
         );
         try {
-          let a;
-          const v = c(
+          let h;
+          const v = u(
             this.onPerformanceMetric
           );
           try {
-            a = JSON.parse(n.responseBody ?? "");
+            h = JSON.parse(n.responseBody ?? "");
           } finally {
-            u(
+            p(
               this.onPerformanceMetric,
               "producerTransportParseDurationMs",
               v
             );
           }
-          const b = c(
+          const b = u(
             this.onPerformanceMetric
-          ), i = S(
-            a,
+          ), a = y(
+            h,
             { deep: !0 }
           );
-          if (u(
+          if (p(
             this.onPerformanceMetric,
             "producerTransportNormalizeDurationMs",
             b
-          ), i.type === "event") {
-            const l = this.getRepresentativeConfig()?.resourceTypeId;
-            if (!l) {
+          ), a.type === "event") {
+            const m = this.getRepresentativeConfig()?.resourceTypeId;
+            if (!m) {
               console.error(
                 "Atmosphere: received one event batch without any active runtime resourceTypeId context.",
-                i
+                a
               );
               return;
             }
-            const w = c(
+            const R = u(
               this.onPerformanceMetric
             );
             this.onMessages(
-              l,
-              i.data.messages
-            ), u(
+              m,
+              a.data.messages
+            ), p(
               this.onPerformanceMetric,
               "producerTransportEmitDurationMs",
-              w
+              R
             );
-          } else i.type !== "success" && console.error(
-            `Atmosphere: subscription error after ${performance.now() - this.lastMessageTime}ms`,
-            i
+          } else a.type !== "success" && console.error(
+            `Atmosphere: subscription error after ${o() - this.lastMessageTime}ms`,
+            a
           );
-        } catch (a) {
-          console.error("Atmosphere: invalid JSON message", a);
+        } catch (h) {
+          console.error("Atmosphere: invalid JSON message", h);
         } finally {
-          u(
+          p(
             this.onPerformanceMetric,
             "producerTransportMessageDurationMs",
-            o
+            i
           );
         }
       },
@@ -318,6 +366,10 @@ class B {
           reason: n?.reasonPhrase,
           state: n?.state,
           transport: n?.transport
+        }), this.armPendingReconnect("transport_closed", {
+          responseReason: n?.reasonPhrase,
+          responseState: n?.state,
+          transport: n?.transport
         }), this.tryReconnect());
       },
       /**
@@ -329,24 +381,34 @@ class B {
           reason: n?.reasonPhrase,
           state: n?.state,
           transport: n?.transport
+        }), this.armPendingReconnect("transport_error", {
+          responseError: n?.error,
+          responseReason: n?.reasonPhrase,
+          responseState: n?.state,
+          transport: n?.transport
         }), this.tryReconnect());
       },
       /**
        * Schedule one fresh reconnect when Atmosphere cannot preserve the transport.
        */
-      onTransportFailure: (n, o) => {
+      onTransportFailure: (n, i) => {
         this.isActiveAttempt(r) && (this.isTransportOpen = !1, console.warn("Atmosphere: transport failure", {
           reason: n,
-          responseError: o?.error,
-          responseState: o?.state,
-          transport: o?.transport
+          responseError: i?.error,
+          responseState: i?.state,
+          transport: i?.transport
+        }), this.armPendingReconnect("transport_failure", {
+          responseError: i?.error,
+          responseReason: n,
+          responseState: i?.state,
+          transport: i?.transport
         }), this.tryReconnect());
       },
       /**
        * Trigger one fresh reconnect after Atmosphere gives up on its own retry loop.
        */
       onFailureToReconnect: () => {
-        this.isActiveAttempt(r) && (this.isTransportOpen = !1, this.tryReconnect());
+        this.isActiveAttempt(r) && (this.isTransportOpen = !1, this.armPendingReconnect("failure_to_reconnect"), this.tryReconnect());
       }
     };
     if (this.subSocket) {
@@ -356,11 +418,11 @@ class B {
       }
       this.subSocket = null;
     }
-    const p = E();
-    if (p) {
-      this.lastMessageTime = performance.now(), this.armTransportOpenTimeout(r);
+    const c = E();
+    if (c) {
+      this.lastMessageTime = o(), this.armTransportOpenTimeout(r);
       try {
-        this.subSocket = p(h);
+        this.subSocket = c(l);
       } catch (n) {
         console.error("Atmosphere: failed to subscribe", n), this.tryReconnect();
       }
@@ -372,13 +434,13 @@ class B {
   tryReconnect() {
     this.activeConfigs.size && (this.clearTransportOpenTimeout(), !this.reconnectTimeout && (this.reconnectTimeout = setTimeout(() => {
       this.reconnectTimeout = null, this.connect();
-    }, R)));
+    }, S)));
   }
   /**
    * Stop the shared transport and cancel any pending reconnect attempt.
    */
   shutdownTransport() {
-    if (this.transportAttempt += 1, this.isTransportOpen = !1, this.unbindBrowserRecoveryListeners(), this.clearReconnectTimeout(), this.clearTransportOpenTimeout(), this.subSocket) {
+    if (this.transportAttempt += 1, this.isTransportOpen = !1, this.pendingReconnect = null, this.unbindBrowserRecoveryListeners(), this.clearReconnectTimeout(), this.clearTransportOpenTimeout(), this.subSocket) {
       try {
         this.subSocket.close?.();
       } catch {
@@ -387,12 +449,13 @@ class B {
     }
   }
 }
-class _ extends y {
+class B extends g {
   sharedTransport;
-  constructor(e, s, r, h) {
-    super(e, s), this.sharedTransport = r ?? new B(
+  constructor(e, s, r, l, c) {
+    super(e, s), this.sharedTransport = r ?? new L(
       s,
-      h
+      l,
+      c
     );
   }
   /**
@@ -411,8 +474,8 @@ class _ extends y {
   }
 }
 export {
-  B as SharedAtmosphereTransport,
-  _ as SourceDataAtmosphere,
-  _ as default,
+  L as SharedAtmosphereTransport,
+  B as SourceDataAtmosphere,
+  B as default,
   T as resolveAtmosphereRequestUrl
 };

package/transport/atmosphere/createAtmosphereSourceData.d.ts

@@ -1,11 +1,11 @@
-import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, RealTimeResourceSourceMechanismConfig } from '../../contracts';
+import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeTransportReconnectCallback, RealTimeResourceSourceMechanismConfig } from '../../contracts';
 import { SourceDataBase } from '../SourceDataBase';
 /**
  * Create one dedicated source mechanism restricted to the real Atmosphere transport.
  */
-export declare function createAtmosphereSourceData(config: RealTimeResourceSourceMechanismConfig, onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback): SourceDataBase;
+export declare function createAtmosphereSourceData(config: RealTimeResourceSourceMechanismConfig, onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback, onTransportReconnect?: OnRealTimeTransportReconnectCallback): SourceDataBase;
 /**
  * Create one runtime-scoped Atmosphere source factory that reuses a single shared socket for the whole app/runtime.
  */
-export declare function createAtmosphereSourceDataFactory(): (config: RealTimeResourceSourceMechanismConfig, onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback) => SourceDataBase;
+export declare function createAtmosphereSourceDataFactory(): (config: RealTimeResourceSourceMechanismConfig, onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback, onTransportReconnect?: OnRealTimeTransportReconnectCallback) => SourceDataBase;
 //# sourceMappingURL=createAtmosphereSourceData.d.ts.map

package/transport/atmosphere/createAtmosphereSourceData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createAtmosphereSourceData.d.ts","sourceRoot":"","sources":["../../../../../../packages/realtime-runtime/src/transport/atmosphere/createAtmosphereSourceData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAEhC,qCAAqC,EACtC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qCAAqC,EAC7C,UAAU,EAAE,uBAAuB,EACnC,mBAAmB,CAAC,EAAE,gCAAgC,GACrD,cAAc,CAahB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,KAK7C,QAAQ,qCAAqC,EAC7C,YAAY,uBAAuB,EACnC,sBAAsB,gCAAgC,KACrD,cAAc,CAyBlB"}
+{"version":3,"file":"createAtmosphereSourceData.d.ts","sourceRoot":"","sources":["../../../../../../packages/realtime-runtime/src/transport/atmosphere/createAtmosphereSourceData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,oCAAoC,EAEpC,qCAAqC,EACtC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qCAAqC,EAC7C,UAAU,EAAE,uBAAuB,EACnC,mBAAmB,CAAC,EAAE,gCAAgC,EACtD,oBAAoB,CAAC,EAAE,oCAAoC,GAC1D,cAAc,CAchB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,KAQ7C,QAAQ,qCAAqC,EAC7C,YAAY,uBAAuB,EACnC,sBAAsB,gCAAgC,EACtD,uBAAuB,oCAAoC,KAC1D,cAAc,CA+BlB"}

package/transport/atmosphere/createAtmosphereSourceData.js

@@ -1,40 +1,48 @@
-import { SourceDataAtmosphere as n, SharedAtmosphereTransport as u } from "./SourceDataAtmosphere.js";
-function c(e, r, o) {
+import { SourceDataAtmosphere as c, SharedAtmosphereTransport as p } from "./SourceDataAtmosphere.js";
+function i(e, r, t, s) {
   if (e.sourceDataMechanism !== "atmosphere")
     throw new Error(
       "Atmosphere-only realtime runtime does not support non-atmosphere resource types."
     );
-  return new n(
+  return new c(
     e,
     r,
     void 0,
-    o
+    t,
+    s
   );
 }
-function m() {
-  let e = null, r = null;
-  return function(a, t, s) {
-    if (a.sourceDataMechanism !== "atmosphere")
+function h() {
+  let e = null, r = null, t;
+  return function(n, o, u, a) {
+    if (n.sourceDataMechanism !== "atmosphere")
       throw new Error(
         "Atmosphere-only realtime runtime does not support non-atmosphere resource types."
       );
     if (!e)
-      r = t, e = new u(
-        t,
-        s
+      r = o, t = a, e = new p(
+        o,
+        u,
+        a
       );
-    else if (r !== t)
-      throw new Error(
-        "Atmosphere source-data factory is scoped to one runtime callback and cannot be reused across runtimes."
-      );
-    return new n(
-      a,
-      t,
+    else {
+      if (r !== o)
+        throw new Error(
+          "Atmosphere source-data factory is scoped to one runtime callback and cannot be reused across runtimes."
+        );
+      if (t !== a)
+        throw new Error(
+          "Atmosphere source-data factory is scoped to one transport reconnect callback and cannot be reused across runtimes."
+        );
+    }
+    return new c(
+      n,
+      o,
       e
     );
   };
 }
 export {
-  c as createAtmosphereSourceData,
-  m as createAtmosphereSourceDataFactory
+  i as createAtmosphereSourceData,
+  h as createAtmosphereSourceDataFactory
 };

package/web/store.d.ts

@@ -1,10 +1,10 @@
-import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback } from '../contracts';
+import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeTransportReconnectCallback } 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, onPerformanceMetric?: OnRealTimeProducerMetricCallback) => SourceDataBase;
+export type CreateRealTimeSourceData = (config: InitialRealTimeProducerStoreProps['resourceTypesConfig'][number], onMessages: OnMessagesStoreCallback, onPerformanceMetric?: OnRealTimeProducerMetricCallback, onTransportReconnect?: OnRealTimeTransportReconnectCallback) => 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,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"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,oCAAoC,EAOrC,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,EACtD,oBAAoB,CAAC,EAAE,oCAAoC,KACxD,cAAc,CAAC;AAoEpB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,wBAAwB,EACnC,oBAAoB,qBAAQ,EAC5B,gBAAgB,EAAE,wBAAwB;;EAgc3C;AACD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACvE,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,GAClC,CAAC"}

package/web/store.js

@@ -1,16 +1,16 @@
-import { createStore as B } from "zustand";
-import { immer as x } from "zustand/middleware/immer";
-import { ObjectQueue as H } from "../engine/ObjectQueue.js";
-import { REALTIME_PRODUCER_STORE_ID as L } from "./constants.js";
+import { createStore as x } from "zustand";
+import { immer as H } from "zustand/middleware/immer";
+import { ObjectQueue as L } from "../engine/ObjectQueue.js";
+import { REALTIME_PRODUCER_STORE_ID as _ } from "./constants.js";
 import { cloneDeep as z } from "lodash-es";
-import { createProducerDevtools as _, drainQueuedMessages as N, sanitizeProducerMessage as $, createRealtimePatchedResourceSnapshot as U, applyProducerMessage as W, notifySubscribersWithBatch as F, groupMessagesByResourceTypeId as G, normalizeProducerMessage as J } from "./store.helpers.js";
+import { createProducerDevtools as N, drainQueuedMessages as $, sanitizeProducerMessage as U, createRealtimePatchedResourceSnapshot as W, applyProducerMessage as F, notifySubscribersWithBatch as G, groupMessagesByResourceTypeId as J, normalizeProducerMessage as K } from "./store.helpers.js";
 function Q() {
   return typeof globalThis.performance?.now == "function" ? globalThis.performance.now() : Date.now();
 }
 function T(d) {
   return d ? Q() : 0;
 }
-function R(d, p, M) {
+function m(d, p, M) {
   d?.(p, M);
 }
 function P(d, p, M) {
@@ -22,19 +22,20 @@ function P(d, p, M) {
 function O(d, p) {
   return typeof p == "object" && p !== null && "resourceSerialId" in p && typeof p.resourceSerialId == "string" ? p.resourceSerialId : d;
 }
-function ee(d, p = !1, M) {
+function se(d, p = !1, M) {
   const {
     onPerformanceMetric: o,
-    startSourceData: k = !0,
+    onTransportReconnect: k,
+    startSourceData: v = !0,
     ...w
-  } = d, v = {
+  } = d, j = {
     ...w,
     hasResourcesTypes: {}
   }, A = {}, C = {};
-  return B(
-    _(
-      x((S, a) => ({
-        ...v,
+  return x(
+    N(
+      H((S, a) => ({
+        ...j,
         realTimeProducerActions: {
           /**
            * Initialize the configured resources and start their source mechanisms.
@@ -56,21 +57,22 @@ function ee(d, p = !1, M) {
                   sourceDataClass: M(
                     r,
                     s,
-                    o
+                    o,
+                    k
                   ),
                   status: "init",
                   hasResources: n,
                   subscribedClients: {}
                 }, A[r.resourceTypeId] = {
                   messagesToProcces: [],
-                  messagesQueue: new H(),
+                  messagesQueue: new L(),
                   statusProccesing: !1
                 }, C[r.resourceTypeId] = new Map(
                   Object.entries(n).map(([l, u]) => [
                     O(l, u),
                     c
                   ])
-                ), k && i.hasResourcesTypes[r.resourceTypeId].sourceDataClass.start();
+                ), v && i.hasResourcesTypes[r.resourceTypeId].sourceDataClass.start();
               }
             });
           },
@@ -127,11 +129,11 @@ function ee(d, p = !1, M) {
            * Enqueue one incoming batch with explicit ingress metadata and start draining the matching queues.
            */
           ingestMessages: (e, t, s) => {
-            R(
+            m(
               o,
               "producerIncomingBatch",
               t.length
-            ), G(
+            ), J(
               e,
               t,
               s
@@ -149,7 +151,7 @@ function ee(d, p = !1, M) {
                 return;
               }
               c.forEach((u) => {
-                const f = l ? J(
+                const f = l ? K(
                   u.message,
                   l,
                   u.reason
@@ -158,7 +160,7 @@ function ee(d, p = !1, M) {
                   ...u,
                   message: f
                 });
-              }), R(
+              }), m(
                 o,
                 "producerQueueLength",
                 n.messagesQueue.size()
@@ -192,51 +194,51 @@ function ee(d, p = !1, M) {
             if (s.statusProccesing)
               return;
             s.statusProccesing = !0;
-            const c = N(s.messagesQueue);
+            const c = $(s.messagesQueue);
             if (!c.length) {
               s.statusProccesing = !1;
               return;
             }
-            R(
+            m(
               o,
               "producerDrainSet",
               c.length
             );
             const r = Date.now(), n = a().hasResourcesTypes[e], l = /* @__PURE__ */ new Map();
             c.forEach(({ message: h }) => {
-              const m = h.resourceSerialId;
+              const R = h.resourceSerialId;
               l.set(
-                m,
-                (l.get(m) ?? 0) + 1
+                R,
+                (l.get(R) ?? 0) + 1
               );
             });
             let u = 0;
             l.forEach((h) => {
               h > 1 && (u += 1);
-            }), R(
+            }), m(
               o,
               "producerRepeatedResourceCount",
               u
-            ), o && R(
+            ), o && m(
               o,
               "producerSubscriberCount",
               Object.keys(n.subscribedClients).length
             );
-            const f = /* @__PURE__ */ new Map(), b = /* @__PURE__ */ new Set(), j = T(
+            const f = /* @__PURE__ */ new Map(), b = /* @__PURE__ */ new Set(), I = T(
               o
             ), E = c.map(({
               message: h,
-              reason: m
+              reason: R
             }) => {
-              const g = h.resourceSerialId, D = b.has(g) ? f.get(g) : n.hasResources[g], y = $(
+              const g = h.resourceSerialId, D = b.has(g) ? f.get(g) : n.hasResources[g], y = U(
                 D,
                 h,
                 n.config,
-                m
+                R
               );
               return (l.get(g) ?? 0) > 1 && (b.add(g), y.type === "delete" ? f.set(g, void 0) : f.set(
                 g,
-                U(
+                W(
                   D ?? {},
                   y.payload,
                   g
@@ -246,7 +248,7 @@ function ee(d, p = !1, M) {
             P(
               o,
               "producerSanitizeDurationMs",
-              j
+              I
             );
             try {
               const h = T(
@@ -254,11 +256,11 @@ function ee(d, p = !1, M) {
               );
               S((g) => {
                 const y = g.hasResourcesTypes[e].hasResources;
-                E.forEach((I) => {
-                  W(
+                E.forEach((B) => {
+                  F(
                     y,
                     i,
-                    I,
+                    B,
                     r
                   );
                 });
@@ -266,22 +268,22 @@ function ee(d, p = !1, M) {
                 o,
                 "producerApplyDurationMs",
                 h
-              ), o && R(
+              ), o && m(
                 o,
                 "producerResourceCount",
                 Object.keys(a().hasResourcesTypes[e].hasResources).length
               );
-              const m = T(
+              const R = T(
                 o
               );
-              F(
+              G(
                 e,
                 a().hasResourcesTypes[e].subscribedClients,
                 E
               ), P(
                 o,
                 "producerNotifyDurationMs",
-                m
+                R
               );
             } finally {
               P(
@@ -319,10 +321,10 @@ function ee(d, p = !1, M) {
           }
         }
       })),
-      { name: `${L}: ${w.storeId}`, enabled: p }
+      { name: `${_}: ${w.storeId}`, enabled: p }
     )
   );
 }
 export {
-  ee as createRealTimeStore
+  se as createRealTimeStore
 };

package/web/types.d.ts

@@ -1,5 +1,5 @@
 import { ObjectQueue } from '../engine/ObjectQueue';
-import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, RealTimeMessage, RealTimeMessageIngressReason, RealTimeReadonlyResourceHash, RealTimeResourceHash, RealTimeResourceSourceMechanismConfig, RealTimeResourceTypeId, RealTimeStatus, Subscriber, SubscribeOptions, SubscribeResourceTypeOptions } from '../contracts';
+import { OnMessagesStoreCallback, OnRealTimeProducerMetricCallback, OnRealTimeTransportReconnectCallback, RealTimeMessage, RealTimeMessageIngressReason, RealTimeReadonlyResourceHash, RealTimeResourceHash, RealTimeResourceSourceMechanismConfig, RealTimeResourceTypeId, RealTimeStatus, Subscriber, SubscribeOptions, SubscribeResourceTypeOptions } from '../contracts';
 /**
  * Internal queued message entry that preserves the ingress reason across async producer draining.
  */
@@ -125,12 +125,16 @@ export interface RealTimeProducerStoreStateWithActions extends RealTimeProducerS
 /**
  * Initial store props accepted by the current web adapter store factory.
  */
-export type InitialRealTimeProducerStoreProps = Omit<RealTimeProducerStoreState, 'hasResourcesTypes'>;
+export type InitialRealTimeProducerStoreProps = Omit<RealTimeProducerStoreState, "hasResourcesTypes">;
 /**
  * Input contract used to create one generic producer store.
  */
 export interface CreateRealTimeStoreProps extends InitialRealTimeProducerStoreProps {
     onPerformanceMetric?: OnRealTimeProducerMetricCallback;
+    /**
+     * Optional host-owned callback fired when the active browser transport recovers after a reconnect path.
+     */
+    onTransportReconnect?: OnRealTimeTransportReconnectCallback;
     /**
      * Whether resource source mechanisms should start during store initialization.
      */

package/web/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,eAAe,EACf,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,qCAAqC,EACrC,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,4BAA4B,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,eAAe;IAC7D;;OAEG;IACH,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC;;OAEG;IACH,aAAa,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACrC;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,MAAM,EAAE,qCAAqC,CAAC;IAC9C;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,eAAe,EAAE;QACf,KAAK,IAAI,IAAI,CAAC;QACd,IAAI,IAAI,IAAI,CAAC;KACd,CAAC;IACF;;OAEG;IACH,YAAY,EAAE,oBAAoB,CAAC;IACnC;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,mBAAmB,EAAE,qCAAqC,EAAE,CAAC;IAC7D;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC,sBAAsB,EAAE,iCAAiC,CAAC,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,qCAAsC,SAAQ,0BAA0B;IACvF,uBAAuB,EAAE;QACvB;;WAEG;QACH,IAAI,IAAI,IAAI,CAAC;QACb;;WAEG;QACH,SAAS,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;QAC9C;;WAEG;QACH,uBAAuB,EAAE,CACvB,cAAc,EAAE,sBAAsB,KACnC,4BAA4B,CAAC;QAClC;;WAEG;QACH,SAAS,EAAE,CAAC,cAAc,EAAE,sBAAsB,EAAE,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;QACvF;;WAEG;QACH,qBAAqB,EAAE,CACrB,cAAc,EAAE,sBAAsB,EACtC,OAAO,EAAE,4BAA4B,KAClC,4BAA4B,CAAC;QAClC;;WAEG;QACH,WAAW,EAAE,CAAC,cAAc,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAChF;;WAEG;QACH,UAAU,EAAE,uBAAuB,CAAC;QACpC;;WAEG;QACH,cAAc,EAAE,CACd,cAAc,EAAE,sBAAsB,EACtC,QAAQ,EAAE,eAAe,EAAE,EAC3B,MAAM,EAAE,4BAA4B,KACjC,IAAI,CAAC;QACV;;WAEG;QACH,eAAe,EAAE,CAAC,cAAc,EAAE,sBAAsB,KAAK,IAAI,CAAC;QAClE;;WAEG;QACH,qBAAqB,EAAE,CAAC,cAAc,EAAE,sBAAsB,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;KACnG,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,0BAA0B,EAC1B,mBAAmB,CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iCAAiC;IACjF,mBAAmB,CAAC,EAAE,gCAAgC,CAAC;IACvD;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,wBAAwB;IAC1E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/realtime-runtime/src/web/types.ts"],"names":[],"mappings":"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"}