@naylence/runtime 0.3.5-test.940 → 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.940
+// 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.940';
+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.940
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.940';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9909,6 +9909,24 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         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('broadcast_channel_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('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
@@ -9917,6 +9935,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 document_hidden: document.hidden,
                 visibility_state: document.visibilityState,
                 has_focus: document.hasFocus(),
+                timestamp: new Date().toISOString(),
             });
         }
     }
@@ -10674,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(),
@@ -10685,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(),
@@ -20229,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()
@@ -20316,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) {
@@ -20365,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.940
+// Generated from package.json version: 0.3.5-test.942
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.940';
+const VERSION = '0.3.5-test.942';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -9908,6 +9908,24 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         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('broadcast_channel_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('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
@@ -9916,6 +9934,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 document_hidden: document.hidden,
                 visibility_state: document.visibilityState,
                 has_focus: document.hasFocus(),
+                timestamp: new Date().toISOString(),
             });
         }
     }
@@ -10673,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(),
@@ -10684,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(),
@@ -20228,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()
@@ -20315,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) {
@@ -20364,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);