@wix/realtime 1.0.59 → 1.0.61

package/cjs/build/subscriber/errors.d.ts

@@ -8,6 +8,7 @@ export declare function invalidChannel(channel: Channel): RealtimeError;
 export declare function validateChannel(channel: Channel): void;
 export declare function disconnectedError(recoverable?: boolean, message?: string): RealtimeError;
 export declare function connectError(recoverable?: boolean, message?: string): RealtimeError;
+export declare function subscribeTimedOut(channel: SubscribeChannel, timeoutMs: number): RealtimeError;
 export declare function subscribeFailed(channel: SubscribeChannel, payload?: {
     status?: number;
     message?: string;

package/cjs/build/subscriber/errors.js

@@ -9,6 +9,7 @@ exports.invalidChannel = invalidChannel;
 exports.validateChannel = validateChannel;
 exports.disconnectedError = disconnectedError;
 exports.connectError = connectError;
+exports.subscribeTimedOut = subscribeTimedOut;
 exports.subscribeFailed = subscribeFailed;
 exports.resubscribeFailed = resubscribeFailed;
 exports.subscribeError = subscribeError;
@@ -72,6 +73,15 @@ function disconnectedError(recoverable, message) {
 function connectError(recoverable, message) {
     return new types_1.RealtimeError(types_1.RealtimeErrorCode.ConnectionError, message || 'connection error', { recoverable });
 }
+function subscribeTimedOut(channel, timeoutMs) {
+    const target = channel.resourceId
+        ? `"${channel.name}" / "${channel.resourceId}"`
+        : `"${channel.name}"`;
+    return new types_1.RealtimeError(types_1.RealtimeErrorCode.ConnectionError, `Subscription to ${target} did not connect within ${timeoutMs}ms. The realtime ` +
+        `socket has not been established — commonly a page served over http:// dialing ` +
+        `ws:// to a TLS-only host, or a blocked/offline network. The client keeps retrying, ` +
+        `so this may still succeed.`, { channel, recoverable: true });
+}
 function subscriptionFailed(prefix, channel, payload) {
     let msg = `${prefix} failed`;
     if (payload?.message) {

package/cjs/build/subscriber/subscriber.public.js

@@ -143,6 +143,8 @@ function cleanupConnectionIfIdle(socketAppId, siteId) {
         closeConnection(socketAppId, siteId);
     }
 }
+// Surface a stalled initial subscription after this long, via onSubscriptionError.
+const SUBSCRIBE_TIMEOUT_MS = 10_000;
 function getOrCreateConnection(httpClient, socketAppId, siteId) {
     const key = socketKey(socketAppId, siteId);
     const existing = instanceConnections.get(key);
@@ -206,8 +208,11 @@ async function setupSubscription(httpClient, subscriptionId, channel, messageHan
                 publisher: publisher?.uid ? { id: publisher.uid } : undefined,
             }, channel);
         };
+        // Cleared on subscribe success/failure; armed just after subscribe below.
+        let subscribeTimeout;
         // --- callback definitions (hoisted above subscribe for #6 race fix) ---
         function onSubscribeSucceeded(payload) {
+            clearTimeout(subscribeTimeout);
             subscribedChannel.off(realtime_common_1.DUPLEXER_EVENTS.subscriptionFailed, onSubscribeFailed);
             // If the subscription was removed (via unsubscribe) while waiting for
             // the duplexer to confirm, clean up the duplexer channel to avoid a
@@ -256,6 +261,7 @@ async function setupSubscription(httpClient, subscriptionId, channel, messageHan
             });
         }
         function onSubscribeFailed(payload) {
+            clearTimeout(subscribeTimeout);
             subscribedChannel.off(realtime_common_1.DUPLEXER_EVENTS.subscriptionSucceeded, onSubscribeSucceeded);
             const failedEntry = subscriptionManager.get(subscriptionId);
             subscriptionManager.delete(subscriptionId);
@@ -269,6 +275,14 @@ async function setupSubscription(httpClient, subscriptionId, channel, messageHan
         });
         subscribedChannel.once(realtime_common_1.DUPLEXER_EVENTS.subscriptionSucceeded, onSubscribeSucceeded);
         subscribedChannel.once(realtime_common_1.DUPLEXER_EVENTS.subscriptionFailed, onSubscribeFailed);
+        // If neither success nor failure fires in time, report a recoverable timeout
+        // but keep the subscription alive so a late connect can still succeed.
+        subscribeTimeout = setTimeout(() => {
+            const entry = subscriptionManager.get(subscriptionId);
+            if (entry && !entry.channelEmitter) {
+                entry.onSubscriptionError?.((0, errors_js_1.subscribeTimedOut)(channel, SUBSCRIBE_TIMEOUT_MS), subscriptionId);
+            }
+        }, SUBSCRIBE_TIMEOUT_MS);
     }
     catch (error) {
         const sub = subscriptionManager.get(subscriptionId);

package/es/build/subscriber/errors.d.ts

@@ -8,6 +8,7 @@ export declare function invalidChannel(channel: Channel): RealtimeError;
 export declare function validateChannel(channel: Channel): void;
 export declare function disconnectedError(recoverable?: boolean, message?: string): RealtimeError;
 export declare function connectError(recoverable?: boolean, message?: string): RealtimeError;
+export declare function subscribeTimedOut(channel: SubscribeChannel, timeoutMs: number): RealtimeError;
 export declare function subscribeFailed(channel: SubscribeChannel, payload?: {
     status?: number;
     message?: string;

package/es/build/subscriber/errors.js

@@ -58,6 +58,15 @@ export function disconnectedError(recoverable, message) {
 export function connectError(recoverable, message) {
     return new RealtimeError(RealtimeErrorCode.ConnectionError, message || 'connection error', { recoverable });
 }
+export function subscribeTimedOut(channel, timeoutMs) {
+    const target = channel.resourceId
+        ? `"${channel.name}" / "${channel.resourceId}"`
+        : `"${channel.name}"`;
+    return new RealtimeError(RealtimeErrorCode.ConnectionError, `Subscription to ${target} did not connect within ${timeoutMs}ms. The realtime ` +
+        `socket has not been established — commonly a page served over http:// dialing ` +
+        `ws:// to a TLS-only host, or a blocked/offline network. The client keeps retrying, ` +
+        `so this may still succeed.`, { channel, recoverable: true });
+}
 function subscriptionFailed(prefix, channel, payload) {
     let msg = `${prefix} failed`;
     if (payload?.message) {

package/es/build/subscriber/subscriber.public.js

@@ -3,7 +3,7 @@ import { DUPLEXER_EVENTS, MESSAGE_EVENT_NAME, getAppInfoFromAuthToken, tokenToAp
 import { v4 as uuidv4 } from 'uuid';
 import { resolveDuplexerChannelName } from '../channel-utils.js';
 import { DUPLEXER_HOST_URL } from '../constants.js';
-import { missingChannelOrSubscriptionId, channelMismatch, channelAppIdMismatch, unsubscribeRequiresAppId, unknownChannelAppId, disconnectedError, connectError, subscribeFailed, resubscribeFailed, subscribeError, validateChannel, } from './errors.js';
+import { missingChannelOrSubscriptionId, channelMismatch, channelAppIdMismatch, unsubscribeRequiresAppId, unknownChannelAppId, disconnectedError, connectError, subscribeFailed, resubscribeFailed, subscribeError, subscribeTimedOut, validateChannel, } from './errors.js';
 import { SubscriptionManager } from './subscription-manager.js';
 function socketKey(socketAppId, siteId) {
     return `${socketAppId}:${siteId}`;
@@ -138,6 +138,8 @@ function cleanupConnectionIfIdle(socketAppId, siteId) {
         closeConnection(socketAppId, siteId);
     }
 }
+// Surface a stalled initial subscription after this long, via onSubscriptionError.
+const SUBSCRIBE_TIMEOUT_MS = 10_000;
 function getOrCreateConnection(httpClient, socketAppId, siteId) {
     const key = socketKey(socketAppId, siteId);
     const existing = instanceConnections.get(key);
@@ -201,8 +203,11 @@ async function setupSubscription(httpClient, subscriptionId, channel, messageHan
                 publisher: publisher?.uid ? { id: publisher.uid } : undefined,
             }, channel);
         };
+        // Cleared on subscribe success/failure; armed just after subscribe below.
+        let subscribeTimeout;
         // --- callback definitions (hoisted above subscribe for #6 race fix) ---
         function onSubscribeSucceeded(payload) {
+            clearTimeout(subscribeTimeout);
             subscribedChannel.off(DUPLEXER_EVENTS.subscriptionFailed, onSubscribeFailed);
             // If the subscription was removed (via unsubscribe) while waiting for
             // the duplexer to confirm, clean up the duplexer channel to avoid a
@@ -251,6 +256,7 @@ async function setupSubscription(httpClient, subscriptionId, channel, messageHan
             });
         }
         function onSubscribeFailed(payload) {
+            clearTimeout(subscribeTimeout);
             subscribedChannel.off(DUPLEXER_EVENTS.subscriptionSucceeded, onSubscribeSucceeded);
             const failedEntry = subscriptionManager.get(subscriptionId);
             subscriptionManager.delete(subscriptionId);
@@ -264,6 +270,14 @@ async function setupSubscription(httpClient, subscriptionId, channel, messageHan
         });
         subscribedChannel.once(DUPLEXER_EVENTS.subscriptionSucceeded, onSubscribeSucceeded);
         subscribedChannel.once(DUPLEXER_EVENTS.subscriptionFailed, onSubscribeFailed);
+        // If neither success nor failure fires in time, report a recoverable timeout
+        // but keep the subscription alive so a late connect can still succeed.
+        subscribeTimeout = setTimeout(() => {
+            const entry = subscriptionManager.get(subscriptionId);
+            if (entry && !entry.channelEmitter) {
+                entry.onSubscriptionError?.(subscribeTimedOut(channel, SUBSCRIBE_TIMEOUT_MS), subscriptionId);
+            }
+        }, SUBSCRIBE_TIMEOUT_MS);
     }
     catch (error) {
         const sub = subscriptionManager.get(subscriptionId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/realtime",
-  "version": "1.0.59",
+  "version": "1.0.61",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -41,18 +41,18 @@
     "cjs"
   ],
   "dependencies": {
-    "@wix/auto_sdk_duplexer_publisher": "^1.0.10",
-    "@wix/auto_sdk_duplexer_realtime-permissions-provider": "^1.0.3",
-    "@wix/duplexer-js": "^2.0.6",
-    "@wix/realtime-common": "1.0.21",
-    "@wix/sdk": "^1.21.4",
-    "@wix/sdk-runtime": "^1.0.9",
-    "@wix/sdk-types": "^1.17.5",
-    "@wix/sdk_realtime_site": "1.0.42",
+    "@wix/auto_sdk_duplexer_publisher": "^1.0.12",
+    "@wix/auto_sdk_duplexer_realtime-permissions-provider": "^1.0.5",
+    "@wix/duplexer-js": "^2.0.11",
+    "@wix/realtime-common": "1.0.22",
+    "@wix/sdk": "^1.21.12",
+    "@wix/sdk-runtime": "^1.0.14",
+    "@wix/sdk-types": "^1.17.8",
+    "@wix/sdk_realtime_site": "1.0.43",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@wix/docs-ts-model": "^1.54.0",
+    "@wix/docs-ts-model": "^1.57.0",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5"
   },
@@ -72,5 +72,5 @@
       "isRootPublicSdk": true
     }
   },
-  "falconPackageHash": "8dcd02a38ba013d9e9178e133fb5311b12a9d7505e159d7db8a5516b"
+  "falconPackageHash": "7b67e0cc34259dcbee2e9480d36c7b75741db677d68b8020143e5bb7"
 }