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

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.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 errors module - Fame protocol specific error classes
@@ -11646,6 +11646,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$10.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$10.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
@@ -11654,6 +11672,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 document_hidden: document.hidden,
                 visibility_state: document.visibilityState,
                 has_focus: document.hasFocus(),
+                timestamp: new Date().toISOString(),
             });
         }
     }
@@ -12366,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(),
@@ -12377,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(),
@@ -21407,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()
@@ -21494,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) {
@@ -21543,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.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 errors module - Fame protocol specific error classes
@@ -11645,6 +11645,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$10.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$10.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
@@ -11653,6 +11671,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 document_hidden: document.hidden,
                 visibility_state: document.visibilityState,
                 has_focus: document.hasFocus(),
+                timestamp: new Date().toISOString(),
             });
         }
     }
@@ -12365,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(),
@@ -12376,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(),
@@ -21406,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()
@@ -21493,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) {
@@ -21542,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.940";
+export declare const VERSION = "0.3.5-test.942";

package/package.json

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