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

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.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.936';
 
 /**
  * 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
      */
@@ -9928,6 +9970,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 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);
@@ -10817,6 +10878,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 +10908,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.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.936';
 
 /**
  * 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
      */
@@ -9926,6 +9968,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 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);
@@ -10815,6 +10876,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 +10906,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
      */

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

@@ -5,6 +5,7 @@ const base_async_connector_js_1 = require("./base-async-connector.js");
 const errors_js_1 = require("../errors/errors.js");
 const logging_js_1 = require("../util/logging.js");
 const bounded_async_queue_js_1 = require("../util/bounded-async-queue.js");
+const core_1 = require("@naylence/core");
 const logger = (0, logging_js_1.getLogger)('naylence.fame.connector.broadcast_channel_connector');
 exports.BROADCAST_CHANNEL_CONNECTOR_TYPE = 'broadcast-channel-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -157,6 +158,25 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
                 visibility: isHidden ? 'hidden' : 'visible',
                 timestamp: new Date().toISOString(),
             });
+            // Pause/resume connector based on visibility
+            if (isHidden && this.state === core_1.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_1.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);

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

@@ -536,6 +536,15 @@ class UpstreamSessionManager extends task_spawner_js_1.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_1.ConnectorState.PAUSED) {
+                logger.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -557,6 +566,7 @@ class UpstreamSessionManager extends task_spawner_js_1.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 errors_js_1.FameConnectError('missed heartbeat acknowledgement');

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.934
+// Generated from package.json version: 0.3.5-test.936
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /**
  * The package version, injected at build time.
  * @internal
  */
-exports.VERSION = '0.3.5-test.934';
+exports.VERSION = '0.3.5-test.936';

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

@@ -165,6 +165,48 @@ export 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
      */

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

@@ -2,6 +2,7 @@ import { BaseAsyncConnector, } from './base-async-connector.js';
 import { FameTransportClose } from '../errors/errors.js';
 import { getLogger } from '../util/logging.js';
 import { BoundedAsyncQueue, QueueFullError, } from '../util/bounded-async-queue.js';
+import { ConnectorState } from '@naylence/core';
 const logger = getLogger('naylence.fame.connector.broadcast_channel_connector');
 export const BROADCAST_CHANNEL_CONNECTOR_TYPE = 'broadcast-channel-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -154,6 +155,25 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 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);

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

@@ -2,7 +2,7 @@ import { ConnectorFactory } from '../connector/connector-factory.js';
 import { TaskSpawner } from '../util/task-spawner.js';
 import { AsyncEvent } from '../util/async-event.js';
 import { getLogger } from '../util/logging.js';
-import { DeliveryOriginType, FameFabric, generateId, } from '@naylence/core';
+import { ConnectorState, DeliveryOriginType, FameFabric, generateId, } from '@naylence/core';
 import { FameConnectError, FameMessageTooLarge, FameTransportClose, } from '../errors/errors.js';
 import { TaskCancelledError } from '../util/task-types.js';
 import { FameResponseType } from '@naylence/core';
@@ -533,6 +533,15 @@ export 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.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -554,6 +563,7 @@ export 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/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.934
+// Generated from package.json version: 0.3.5-test.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-export const VERSION = '0.3.5-test.934';
+export const VERSION = '0.3.5-test.936';

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.934
+// Generated from package.json version: 0.3.5-test.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.936';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9207,6 +9207,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
      */
@@ -9844,6 +9886,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 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);
@@ -10733,6 +10794,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,
@@ -10754,6 +10824,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/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.934
+// Generated from package.json version: 0.3.5-test.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.936';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9206,6 +9206,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
      */
@@ -9843,6 +9885,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 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);
@@ -10732,6 +10793,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,
@@ -10753,6 +10823,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/node/node.cjs

@@ -2137,6 +2137,48 @@ class BaseAsyncConnector extends TaskSpawner {
             connector_id: this._connectorFlowId,
         });
     }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger$1f.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core.ConnectorState.STARTED) {
+            logger$1f.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core.ConnectorState.PAUSED);
+        logger$1f.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger$1f.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core.ConnectorState.PAUSED) {
+            logger$1f.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core.ConnectorState.STARTED);
+        logger$1f.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
     /**
      * Close the connector with optional code and reason
      */
@@ -5436,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.934
+// Generated from package.json version: 0.3.5-test.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.936';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11581,6 +11623,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 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$10.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$10.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);
@@ -12425,6 +12486,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$$.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$$.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -12446,6 +12516,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/node/node.mjs

@@ -2136,6 +2136,48 @@ class BaseAsyncConnector extends TaskSpawner {
             connector_id: this._connectorFlowId,
         });
     }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger$1f.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== ConnectorState.STARTED) {
+            logger$1f.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(ConnectorState.PAUSED);
+        logger$1f.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger$1f.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== ConnectorState.PAUSED) {
+            logger$1f.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(ConnectorState.STARTED);
+        logger$1f.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
     /**
      * Close the connector with optional code and reason
      */
@@ -5435,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.934
+// Generated from package.json version: 0.3.5-test.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.934';
+const VERSION = '0.3.5-test.936';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11580,6 +11622,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 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$10.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$10.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);
@@ -12424,6 +12485,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$$.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$$.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -12445,6 +12515,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/types/naylence/fame/connector/base-async-connector.d.ts

@@ -103,6 +103,14 @@ export declare abstract class BaseAsyncConnector extends TaskSpawner implements
      * Stop the connector gracefully
      */
     stop(): Promise<void>;
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    pause(): Promise<void>;
+    /**
+     * Resume the connector from paused state
+     */
+    resume(): Promise<void>;
     /**
      * Close the connector with optional code and reason
      */

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.934";
+export declare const VERSION = "0.3.5-test.936";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naylence/runtime",
-  "version": "0.3.5-test.934",
+  "version": "0.3.5-test.936",
   "type": "module",
   "description": "Naylence Runtime - Complete TypeScript runtime",
   "author": "Naylence Dev <naylencedev@gmail.com>",
@@ -176,7 +176,7 @@
   "dependencies": {
     "@fastify/formbody": "^8.0.2",
     "@fastify/websocket": "^11.2.0",
-    "@naylence/core": "^0.3.4",
+    "@naylence/core": "^0.3.5",
     "@noble/ciphers": "^2.0.1",
     "@noble/curves": "^2.0.1",
     "@noble/ed25519": "^3.0.0",