@naylence/runtime 0.3.5-test.937 → 0.3.5-test.939

package/dist/browser/index.cjs

@@ -98,12 +98,12 @@ installProcessEnvShim();
 // --- END ENV SHIM ---
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.937';
+const VERSION = '0.3.5-test.939';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9993,11 +9993,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger$_.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -10178,6 +10181,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             logger$_.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time
@@ -10476,6 +10482,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -10900,15 +10907,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === core.ConnectorState.PAUSED) {
+            if (currentState === core.ConnectorState.PAUSED) {
                 logger$Z.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === core.ConnectorState.PAUSED && currentState === core.ConnectorState.STARTED) {
+                logger$Z.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$Z.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -12643,7 +12661,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== core.ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== core.ConnectorState.STARTED && connector.state !== core.ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/browser/index.mjs

@@ -96,12 +96,12 @@ installProcessEnvShim();
 // --- END ENV SHIM ---
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.937';
+const VERSION = '0.3.5-test.939';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9991,11 +9991,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger$_.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -10176,6 +10179,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             logger$_.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time
@@ -10474,6 +10480,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -10898,15 +10905,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === ConnectorState.PAUSED) {
+            if (currentState === ConnectorState.PAUSED) {
                 logger$Z.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === ConnectorState.PAUSED && currentState === ConnectorState.STARTED) {
+                logger$Z.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$Z.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -12641,7 +12659,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== ConnectorState.STARTED && connector.state !== ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/cjs/naylence/fame/connector/broadcast-channel-connector.browser.js

@@ -181,11 +181,14 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -366,6 +369,9 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             logger.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time

package/dist/cjs/naylence/fame/node/admission/default-node-attach-client.js

@@ -202,7 +202,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== core_1.ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== core_1.ConnectorState.STARTED && connector.state !== core_1.ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/cjs/naylence/fame/node/upstream-session-manager.js

@@ -112,6 +112,7 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions(optionsInput);
         this.node = options.node;
@@ -536,15 +537,26 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === core_1.ConnectorState.PAUSED) {
+            if (currentState === core_1.ConnectorState.PAUSED) {
                 logger.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === core_1.ConnectorState.PAUSED && currentState === core_1.ConnectorState.STARTED) {
+                logger.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,

package/dist/cjs/version.js

@@ -1,10 +1,10 @@
 "use strict";
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /**
  * The package version, injected at build time.
  * @internal
  */
-exports.VERSION = '0.3.5-test.937';
+exports.VERSION = '0.3.5-test.939';

package/dist/esm/naylence/fame/connector/broadcast-channel-connector.browser.js

@@ -178,11 +178,14 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -363,6 +366,9 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             logger.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time

package/dist/esm/naylence/fame/node/admission/default-node-attach-client.js

@@ -199,7 +199,8 @@ export class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== ConnectorState.STARTED && connector.state !== ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/esm/naylence/fame/node/upstream-session-manager.js

@@ -109,6 +109,7 @@ export class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions(optionsInput);
         this.node = options.node;
@@ -533,15 +534,26 @@ export class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === ConnectorState.PAUSED) {
+            if (currentState === ConnectorState.PAUSED) {
                 logger.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === ConnectorState.PAUSED && currentState === ConnectorState.STARTED) {
+                logger.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,

package/dist/esm/version.js

@@ -1,7 +1,7 @@
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-export const VERSION = '0.3.5-test.937';
+export const VERSION = '0.3.5-test.939';

package/dist/node/index.cjs

@@ -14,12 +14,12 @@ var fastify = require('fastify');
 var websocketPlugin = require('@fastify/websocket');
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.937';
+const VERSION = '0.3.5-test.939';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9909,11 +9909,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger$_.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -10094,6 +10097,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             logger$_.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time
@@ -10392,6 +10398,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -10816,15 +10823,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === core.ConnectorState.PAUSED) {
+            if (currentState === core.ConnectorState.PAUSED) {
                 logger$Z.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === core.ConnectorState.PAUSED && currentState === core.ConnectorState.STARTED) {
+                logger$Z.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$Z.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -12559,7 +12577,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== core.ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== core.ConnectorState.STARTED && connector.state !== core.ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/node/index.mjs

@@ -13,12 +13,12 @@ import fastify from 'fastify';
 import websocketPlugin from '@fastify/websocket';
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.937';
+const VERSION = '0.3.5-test.939';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9908,11 +9908,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger$_.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -10093,6 +10096,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             logger$_.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time
@@ -10391,6 +10397,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -10815,15 +10822,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === ConnectorState.PAUSED) {
+            if (currentState === ConnectorState.PAUSED) {
                 logger$Z.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === ConnectorState.PAUSED && currentState === ConnectorState.STARTED) {
+                logger$Z.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$Z.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -12558,7 +12576,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== ConnectorState.STARTED && connector.state !== ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/node/node.cjs

@@ -5478,12 +5478,12 @@ for (const [name, config] of Object.entries(SQLITE_PROFILES)) {
 }
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.937';
+const VERSION = '0.3.5-test.939';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11646,11 +11646,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger$10.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -11831,6 +11834,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             logger$10.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time
@@ -12084,6 +12090,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -12508,15 +12515,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === core.ConnectorState.PAUSED) {
+            if (currentState === core.ConnectorState.PAUSED) {
                 logger$$.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === core.ConnectorState.PAUSED && currentState === core.ConnectorState.STARTED) {
+                logger$$.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$$.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -14251,7 +14269,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== core.ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== core.ConnectorState.STARTED && connector.state !== core.ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/node/node.mjs

@@ -5477,12 +5477,12 @@ for (const [name, config] of Object.entries(SQLITE_PROFILES)) {
 }
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.937
+// Generated from package.json version: 0.3.5-test.939
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.937';
+const VERSION = '0.3.5-test.939';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11645,11 +11645,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
-            // Log initial state
+            // Log initial state with detailed visibility info
             logger$10.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
             });
         }
     }
@@ -11830,6 +11833,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             logger$10.debug('broadcast_channel_start_in_hidden_tab', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                document_hidden: document.hidden,
+                visibility_state: document.visibilityState,
+                has_focus: document.hasFocus(),
                 timestamp: new Date().toISOString(),
             });
             // Immediately pause if tab is hidden at start time
@@ -12083,6 +12089,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -12507,15 +12514,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === ConnectorState.PAUSED) {
+            if (currentState === ConnectorState.PAUSED) {
                 logger$$.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === ConnectorState.PAUSED && currentState === ConnectorState.STARTED) {
+                logger$$.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$$.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -14250,7 +14268,8 @@ class DefaultNodeAttachClient {
     async awaitAck(connector) {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
-            if (connector.state !== ConnectorState.STARTED) {
+            // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
+            if (connector.state !== ConnectorState.STARTED && connector.state !== ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;

package/dist/types/naylence/fame/node/upstream-session-manager.d.ts

@@ -65,6 +65,7 @@ export declare class UpstreamSessionManager extends TaskSpawner implements Sessi
     private lastHeartbeatAckTime;
     private lastSeenEpoch;
     private hadSuccessfulAttach;
+    private lastConnectorState;
     private connectEpoch;
     constructor(optionsInput: UpstreamSessionManagerOptionsInput);
     get systemId(): string | null;

package/dist/types/version.d.ts

@@ -2,4 +2,4 @@
  * The package version, injected at build time.
  * @internal
  */
-export declare const VERSION = "0.3.5-test.937";
+export declare const VERSION = "0.3.5-test.939";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naylence/runtime",
-  "version": "0.3.5-test.937",
+  "version": "0.3.5-test.939",
   "type": "module",
   "description": "Naylence Runtime - Complete TypeScript runtime",
   "author": "Naylence Dev <naylencedev@gmail.com>",