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

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.934
+// Generated from package.json version: 0.3.5-test.937
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.937';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9291,6 +9291,48 @@ class BaseAsyncConnector extends TaskSpawner {
             connector_id: this._connectorFlowId,
         });
     }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger$$.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core.ConnectorState.STARTED) {
+            logger$$.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core.ConnectorState.PAUSED);
+        logger$$.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger$$.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core.ConnectorState.PAUSED) {
+            logger$$.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core.ConnectorState.STARTED);
+        logger$$.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
     /**
      * Close the connector with optional code and reason
      */
@@ -9626,7 +9668,7 @@ class BaseAsyncConnector extends TaskSpawner {
             });
             return;
         }
-        logger$$.info('connector_shutdown_starting', {
+        logger$$.debug('connector_shutdown_starting', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             code,
@@ -9656,19 +9698,19 @@ class BaseAsyncConnector extends TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
-        logger$$.info('connector_closing_transport', {
+        logger$$.debug('connector_closing_transport', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         await this._transportClose(code, reason);
-        logger$$.info('connector_transport_closed', {
+        logger$$.debug('connector_transport_closed', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         // Shutdown spawned tasks
-        logger$$.info('connector_shutting_down_tasks', {
+        logger$$.debug('connector_shutting_down_tasks', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             grace_period_ms: effectiveGracePeriod * 1000,
@@ -9680,7 +9722,7 @@ class BaseAsyncConnector extends TaskSpawner {
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
-            logger$$.info('connector_tasks_shutdown_complete', {
+            logger$$.debug('connector_tasks_shutdown_complete', {
                 connector_id: this._connectorFlowId,
                 connector_type: this.constructor.name,
                 timestamp: new Date().toISOString(),
@@ -9700,7 +9742,7 @@ class BaseAsyncConnector extends TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
-        logger$$.info('connector_shutdown_complete', {
+        logger$$.debug('connector_shutdown_complete', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             final_state: this._state,
@@ -9841,7 +9883,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        logger$_.info('broadcast_channel_connector_created', {
+        logger$_.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
             inbox_capacity: preferredCapacity,
@@ -9922,18 +9964,37 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         // Setup visibility change monitoring
         this.visibilityChangeHandler = () => {
             const isHidden = document.hidden;
-            logger$_.info('broadcast_channel_visibility_changed', {
+            logger$_.debug('broadcast_channel_visibility_changed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: isHidden ? 'hidden' : 'visible',
                 timestamp: new Date().toISOString(),
             });
+            // Pause/resume connector based on visibility
+            if (isHidden && this.state === core.ConnectorState.STARTED) {
+                this.pause().catch((err) => {
+                    logger$_.warning('broadcast_channel_pause_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+            else if (!isHidden && this.state === core.ConnectorState.PAUSED) {
+                this.resume().catch((err) => {
+                    logger$_.warning('broadcast_channel_resume_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
         };
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
             // Log initial state
-            logger$_.info('broadcast_channel_initial_visibility', {
+            logger$_.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
@@ -9983,7 +10044,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         return await this.inbox.dequeue();
     }
     async _transportClose(code, reason) {
-        logger$_.info('broadcast_channel_transport_closing', {
+        logger$_.debug('broadcast_channel_transport_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             code,
@@ -9992,14 +10053,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             timestamp: new Date().toISOString(),
         });
         if (this.listenerRegistered) {
-            logger$_.info('broadcast_channel_removing_listener', {
+            logger$_.debug('broadcast_channel_removing_listener', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
             });
             this.channel.removeEventListener('message', this.onMsg);
             this.listenerRegistered = false;
-            logger$_.info('broadcast_channel_listener_removed', {
+            logger$_.debug('broadcast_channel_listener_removed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
@@ -10010,13 +10071,13 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
         }
-        logger$_.info('broadcast_channel_closing', {
+        logger$_.debug('broadcast_channel_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
         });
         this.channel.close();
-        logger$_.info('broadcast_channel_closed', {
+        logger$_.debug('broadcast_channel_closed', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
@@ -10107,6 +10168,28 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         }
         return undefined;
     }
+    /**
+     * Override start() to check initial visibility state
+     */
+    async start(inboundHandler) {
+        await super.start(inboundHandler);
+        // After transitioning to STARTED, check if tab is already hidden
+        if (typeof document !== 'undefined' && document.hidden) {
+            logger$_.debug('broadcast_channel_start_in_hidden_tab', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
+            // Immediately pause if tab is hidden at start time
+            await this.pause().catch((err) => {
+                logger$_.warning('broadcast_channel_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];
@@ -10817,6 +10900,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            // 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) {
+                logger$Z.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$Z.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -10838,6 +10930,7 @@ class UpstreamSessionManager extends TaskSpawner {
                 throw error;
             }
             await this.node.dispatchEvent('onHeartbeatSent', this.node, envelope);
+            // Don't check heartbeat timeout when paused
             if (this.lastHeartbeatAckTime !== null &&
                 Date.now() - this.lastHeartbeatAckTime > graceMs) {
                 throw new FameConnectError('missed heartbeat acknowledgement');

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.934
+// Generated from package.json version: 0.3.5-test.937
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.937';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9289,6 +9289,48 @@ class BaseAsyncConnector extends TaskSpawner {
             connector_id: this._connectorFlowId,
         });
     }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger$$.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== ConnectorState.STARTED) {
+            logger$$.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(ConnectorState.PAUSED);
+        logger$$.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger$$.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== ConnectorState.PAUSED) {
+            logger$$.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(ConnectorState.STARTED);
+        logger$$.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
     /**
      * Close the connector with optional code and reason
      */
@@ -9624,7 +9666,7 @@ class BaseAsyncConnector extends TaskSpawner {
             });
             return;
         }
-        logger$$.info('connector_shutdown_starting', {
+        logger$$.debug('connector_shutdown_starting', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             code,
@@ -9654,19 +9696,19 @@ class BaseAsyncConnector extends TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
-        logger$$.info('connector_closing_transport', {
+        logger$$.debug('connector_closing_transport', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         await this._transportClose(code, reason);
-        logger$$.info('connector_transport_closed', {
+        logger$$.debug('connector_transport_closed', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         // Shutdown spawned tasks
-        logger$$.info('connector_shutting_down_tasks', {
+        logger$$.debug('connector_shutting_down_tasks', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             grace_period_ms: effectiveGracePeriod * 1000,
@@ -9678,7 +9720,7 @@ class BaseAsyncConnector extends TaskSpawner {
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
-            logger$$.info('connector_tasks_shutdown_complete', {
+            logger$$.debug('connector_tasks_shutdown_complete', {
                 connector_id: this._connectorFlowId,
                 connector_type: this.constructor.name,
                 timestamp: new Date().toISOString(),
@@ -9698,7 +9740,7 @@ class BaseAsyncConnector extends TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
-        logger$$.info('connector_shutdown_complete', {
+        logger$$.debug('connector_shutdown_complete', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             final_state: this._state,
@@ -9839,7 +9881,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        logger$_.info('broadcast_channel_connector_created', {
+        logger$_.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
             inbox_capacity: preferredCapacity,
@@ -9920,18 +9962,37 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         // Setup visibility change monitoring
         this.visibilityChangeHandler = () => {
             const isHidden = document.hidden;
-            logger$_.info('broadcast_channel_visibility_changed', {
+            logger$_.debug('broadcast_channel_visibility_changed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: isHidden ? 'hidden' : 'visible',
                 timestamp: new Date().toISOString(),
             });
+            // Pause/resume connector based on visibility
+            if (isHidden && this.state === ConnectorState.STARTED) {
+                this.pause().catch((err) => {
+                    logger$_.warning('broadcast_channel_pause_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+            else if (!isHidden && this.state === ConnectorState.PAUSED) {
+                this.resume().catch((err) => {
+                    logger$_.warning('broadcast_channel_resume_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
         };
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
             // Log initial state
-            logger$_.info('broadcast_channel_initial_visibility', {
+            logger$_.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
@@ -9981,7 +10042,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         return await this.inbox.dequeue();
     }
     async _transportClose(code, reason) {
-        logger$_.info('broadcast_channel_transport_closing', {
+        logger$_.debug('broadcast_channel_transport_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             code,
@@ -9990,14 +10051,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             timestamp: new Date().toISOString(),
         });
         if (this.listenerRegistered) {
-            logger$_.info('broadcast_channel_removing_listener', {
+            logger$_.debug('broadcast_channel_removing_listener', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
             });
             this.channel.removeEventListener('message', this.onMsg);
             this.listenerRegistered = false;
-            logger$_.info('broadcast_channel_listener_removed', {
+            logger$_.debug('broadcast_channel_listener_removed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
@@ -10008,13 +10069,13 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
         }
-        logger$_.info('broadcast_channel_closing', {
+        logger$_.debug('broadcast_channel_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
         });
         this.channel.close();
-        logger$_.info('broadcast_channel_closed', {
+        logger$_.debug('broadcast_channel_closed', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
@@ -10105,6 +10166,28 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         }
         return undefined;
     }
+    /**
+     * Override start() to check initial visibility state
+     */
+    async start(inboundHandler) {
+        await super.start(inboundHandler);
+        // After transitioning to STARTED, check if tab is already hidden
+        if (typeof document !== 'undefined' && document.hidden) {
+            logger$_.debug('broadcast_channel_start_in_hidden_tab', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
+            // Immediately pause if tab is hidden at start time
+            await this.pause().catch((err) => {
+                logger$_.warning('broadcast_channel_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];
@@ -10815,6 +10898,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            // 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) {
+                logger$Z.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$Z.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -10836,6 +10928,7 @@ class UpstreamSessionManager extends TaskSpawner {
                 throw error;
             }
             await this.node.dispatchEvent('onHeartbeatSent', this.node, envelope);
+            // Don't check heartbeat timeout when paused
             if (this.lastHeartbeatAckTime !== null &&
                 Date.now() - this.lastHeartbeatAckTime > graceMs) {
                 throw new FameConnectError('missed heartbeat acknowledgement');

package/dist/cjs/naylence/fame/connector/base-async-connector.js

@@ -169,6 +169,48 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
             connector_id: this._connectorFlowId,
         });
     }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core_1.ConnectorState.STARTED) {
+            logger.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core_1.ConnectorState.PAUSED);
+        logger.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core_1.ConnectorState.PAUSED) {
+            logger.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core_1.ConnectorState.STARTED);
+        logger.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
     /**
      * Close the connector with optional code and reason
      */
@@ -504,7 +546,7 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
             });
             return;
         }
-        logger.info('connector_shutdown_starting', {
+        logger.debug('connector_shutdown_starting', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             code,
@@ -534,19 +576,19 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
-        logger.info('connector_closing_transport', {
+        logger.debug('connector_closing_transport', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         await this._transportClose(code, reason);
-        logger.info('connector_transport_closed', {
+        logger.debug('connector_transport_closed', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         // Shutdown spawned tasks
-        logger.info('connector_shutting_down_tasks', {
+        logger.debug('connector_shutting_down_tasks', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             grace_period_ms: effectiveGracePeriod * 1000,
@@ -558,7 +600,7 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
-            logger.info('connector_tasks_shutdown_complete', {
+            logger.debug('connector_tasks_shutdown_complete', {
                 connector_id: this._connectorFlowId,
                 connector_type: this.constructor.name,
                 timestamp: new Date().toISOString(),
@@ -578,7 +620,7 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
-        logger.info('connector_shutdown_complete', {
+        logger.debug('connector_shutdown_complete', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             final_state: this._state,