@naylence/runtime 0.3.5-test.941 → 0.3.5-test.942

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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.941';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10777,7 +10777,7 @@ class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger$Z.info('upstream_stopping_old_connector', {
+                logger$Z.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -10788,7 +10788,7 @@ class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger$Z.info('upstream_old_connector_stopped', {
+                logger$Z.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -20332,6 +20332,7 @@ class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment$2();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -20419,6 +20420,92 @@ class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus$1().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger$G.debug('inpage_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$G.warning('inpage_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$G.warning('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger$G.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger$G.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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$G.debug('inpage_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
+            await this.pause().catch((err) => {
+                logger$G.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -20468,6 +20555,11 @@ class InPageConnector extends BaseAsyncConnector {
             getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, 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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.941';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10775,7 +10775,7 @@ class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger$Z.info('upstream_stopping_old_connector', {
+                logger$Z.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -10786,7 +10786,7 @@ class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger$Z.info('upstream_old_connector_stopped', {
+                logger$Z.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -20330,6 +20330,7 @@ class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment$2();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -20417,6 +20418,92 @@ class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus$1().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger$G.debug('inpage_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$G.warning('inpage_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$G.warning('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger$G.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger$G.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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$G.debug('inpage_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
+            await this.pause().catch((err) => {
+                logger$G.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -20466,6 +20553,11 @@ class InPageConnector extends BaseAsyncConnector {
             getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, closeCode);

package/dist/cjs/naylence/fame/connector/inpage-connector.js

@@ -9,6 +9,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.inpage_connector');
 exports.INPAGE_CONNECTOR_TYPE = 'inpage-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -67,6 +68,7 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
         ensureBrowserEnvironment();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -154,6 +156,92 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
         };
         getSharedBus().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger.debug('inpage_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_1.ConnectorState.STARTED) {
+                this.pause().catch((err) => {
+                    logger.warning('inpage_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('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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('inpage_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
+            await this.pause().catch((err) => {
+                logger.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -203,6 +291,11 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
             getSharedBus().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new errors_js_1.FameTransportClose(closeReason, closeCode);

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

@@ -388,7 +388,7 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger.info('upstream_stopping_old_connector', {
+                logger.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -399,7 +399,7 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger.info('upstream_old_connector_stopped', {
+                logger.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),

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

package/dist/esm/naylence/fame/connector/inpage-connector.js

@@ -6,6 +6,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.inpage_connector');
 export const INPAGE_CONNECTOR_TYPE = 'inpage-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -64,6 +65,7 @@ export class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -151,6 +153,92 @@ export class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger.debug('inpage_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('inpage_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('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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('inpage_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
+            await this.pause().catch((err) => {
+                logger.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -200,6 +288,11 @@ export class InPageConnector extends BaseAsyncConnector {
             getSharedBus().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, closeCode);

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

@@ -385,7 +385,7 @@ export class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger.info('upstream_stopping_old_connector', {
+                logger.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -396,7 +396,7 @@ export class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger.info('upstream_old_connector_stopped', {
+                logger.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),

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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-export const VERSION = '0.3.5-test.941';
+export const VERSION = '0.3.5-test.942';

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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.941';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10693,7 +10693,7 @@ class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger$Z.info('upstream_stopping_old_connector', {
+                logger$Z.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -10704,7 +10704,7 @@ class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger$Z.info('upstream_old_connector_stopped', {
+                logger$Z.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -20248,6 +20248,7 @@ class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment$2();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -20335,6 +20336,92 @@ class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus$1().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger$G.debug('inpage_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$G.warning('inpage_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$G.warning('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger$G.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger$G.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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$G.debug('inpage_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
+            await this.pause().catch((err) => {
+                logger$G.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -20384,6 +20471,11 @@ class InPageConnector extends BaseAsyncConnector {
             getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, 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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.941';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10692,7 +10692,7 @@ class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger$Z.info('upstream_stopping_old_connector', {
+                logger$Z.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -10703,7 +10703,7 @@ class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger$Z.info('upstream_old_connector_stopped', {
+                logger$Z.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -20247,6 +20247,7 @@ class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment$2();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -20334,6 +20335,92 @@ class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus$1().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger$G.debug('inpage_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$G.warning('inpage_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$G.warning('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger$G.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger$G.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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$G.debug('inpage_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
+            await this.pause().catch((err) => {
+                logger$G.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -20383,6 +20470,11 @@ class InPageConnector extends BaseAsyncConnector {
             getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, 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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.941';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -12385,7 +12385,7 @@ class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger$$.info('upstream_stopping_old_connector', {
+                logger$$.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -12396,7 +12396,7 @@ class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger$$.info('upstream_old_connector_stopped', {
+                logger$$.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -21426,6 +21426,7 @@ class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment$2();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -21513,6 +21514,92 @@ class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus$1().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger$J.debug('inpage_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$J.warning('inpage_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$J.warning('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger$J.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger$J.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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$J.debug('inpage_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
+            await this.pause().catch((err) => {
+                logger$J.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -21562,6 +21649,11 @@ class InPageConnector extends BaseAsyncConnector {
             getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, 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.941
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.941';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -12384,7 +12384,7 @@ class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                logger$$.info('upstream_stopping_old_connector', {
+                logger$$.debug('upstream_stopping_old_connector', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -12395,7 +12395,7 @@ class UpstreamSessionManager extends TaskSpawner {
                         error: err instanceof Error ? err.message : String(err),
                     });
                 });
-                logger$$.info('upstream_old_connector_stopped', {
+                logger$$.debug('upstream_old_connector_stopped', {
                     connect_epoch: this.connectEpoch,
                     target_system_id: this.targetSystemId,
                     timestamp: new Date().toISOString(),
@@ -21425,6 +21425,7 @@ class InPageConnector extends BaseAsyncConnector {
         ensureBrowserEnvironment$2();
         super(baseConfig);
         this.listenerRegistered = false;
+        this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
                 ? config.channelName.trim()
@@ -21512,6 +21513,92 @@ class InPageConnector extends BaseAsyncConnector {
         };
         getSharedBus$1().addEventListener(this.channelName, this.onMsg);
         this.listenerRegistered = true;
+        // Setup visibility change monitoring
+        this.visibilityChangeHandler = () => {
+            const isHidden = document.hidden;
+            logger$J.debug('inpage_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$J.warning('inpage_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$J.warning('inpage_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;
+            // Track page lifecycle events to detect browser unload/discard
+            if (typeof window !== 'undefined') {
+                const lifecycleLogger = (event) => {
+                    logger$J.info('inpage_page_lifecycle', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        event_type: event.type,
+                        visibility_state: document.visibilityState,
+                        timestamp: new Date().toISOString(),
+                    });
+                };
+                window.addEventListener('beforeunload', lifecycleLogger);
+                window.addEventListener('unload', lifecycleLogger);
+                window.addEventListener('pagehide', lifecycleLogger);
+                window.addEventListener('pageshow', lifecycleLogger);
+                document.addEventListener('freeze', lifecycleLogger);
+                document.addEventListener('resume', lifecycleLogger);
+            }
+            // Log initial state with detailed visibility info
+            logger$J.debug('inpage_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(),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 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$J.debug('inpage_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
+            await this.pause().catch((err) => {
+                logger$J.warning('inpage_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
     }
     // Allow listeners to feed envelopes directly into the in-page receive queue.
     async pushToReceive(rawOrEnvelope) {
@@ -21561,6 +21648,11 @@ class InPageConnector extends BaseAsyncConnector {
             getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
         }
+        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            this.visibilityChangeListenerRegistered = false;
+            this.visibilityChangeHandler = undefined;
+        }
         const closeCode = typeof code === 'number' ? code : 1000;
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new FameTransportClose(closeReason, closeCode);

package/dist/types/naylence/fame/connector/inpage-connector.d.ts

@@ -4,7 +4,7 @@
  */
 import { BaseAsyncConnector, type BaseAsyncConnectorConfig } from './base-async-connector.js';
 import type { ConnectorConfig } from './connector-config.js';
-import type { FameEnvelope, FameChannelMessage } from '@naylence/core';
+import type { FameEnvelope, FameChannelMessage, FameEnvelopeHandler } from '@naylence/core';
 export declare const INPAGE_CONNECTOR_TYPE: "inpage-connector";
 export interface InPageConnectorConfig extends ConnectorConfig {
     type: typeof INPAGE_CONNECTOR_TYPE;
@@ -18,9 +18,15 @@ export declare class InPageConnector extends BaseAsyncConnector {
     private listenerRegistered;
     private readonly connectorId;
     private readonly onMsg;
+    private visibilityChangeListenerRegistered;
+    private visibilityChangeHandler?;
     private static generateConnectorId;
     private static coercePayload;
     constructor(config: InPageConnectorConfig, baseConfig?: BaseAsyncConnectorConfig);
+    /**
+     * Override start() to check initial visibility state
+     */
+    start(inboundHandler: FameEnvelopeHandler): Promise<void>;
     pushToReceive(rawOrEnvelope: Uint8Array | FameEnvelope | FameChannelMessage): Promise<void>;
     protected _transportSendBytes(data: Uint8Array): Promise<void>;
     protected _transportReceive(): Promise<InPageInboxItem>;

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

package/package.json

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