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

package/dist/node/node.cjs

@@ -2514,7 +2514,7 @@ class BaseAsyncConnector extends TaskSpawner {
             });
             return;
         }
-        logger$1f.info('connector_shutdown_starting', {
+        logger$1f.debug('connector_shutdown_starting', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             code,
@@ -2544,19 +2544,19 @@ class BaseAsyncConnector extends TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
-        logger$1f.info('connector_closing_transport', {
+        logger$1f.debug('connector_closing_transport', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         await this._transportClose(code, reason);
-        logger$1f.info('connector_transport_closed', {
+        logger$1f.debug('connector_transport_closed', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         // Shutdown spawned tasks
-        logger$1f.info('connector_shutting_down_tasks', {
+        logger$1f.debug('connector_shutting_down_tasks', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             grace_period_ms: effectiveGracePeriod * 1000,
@@ -2568,7 +2568,7 @@ class BaseAsyncConnector extends TaskSpawner {
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
-            logger$1f.info('connector_tasks_shutdown_complete', {
+            logger$1f.debug('connector_tasks_shutdown_complete', {
                 connector_id: this._connectorFlowId,
                 connector_type: this.constructor.name,
                 timestamp: new Date().toISOString(),
@@ -2588,7 +2588,7 @@ class BaseAsyncConnector extends TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
-        logger$1f.info('connector_shutdown_complete', {
+        logger$1f.debug('connector_shutdown_complete', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             final_state: this._state,
@@ -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.936
+// Generated from package.json version: 0.3.5-test.938
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.936';
+const VERSION = '0.3.5-test.938';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11536,7 +11536,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        logger$10.info('broadcast_channel_connector_created', {
+        logger$10.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
             inbox_capacity: preferredCapacity,
@@ -11617,7 +11617,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         // Setup visibility change monitoring
         this.visibilityChangeHandler = () => {
             const isHidden = document.hidden;
-            logger$10.info('broadcast_channel_visibility_changed', {
+            logger$10.debug('broadcast_channel_visibility_changed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: isHidden ? 'hidden' : 'visible',
@@ -11647,7 +11647,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
             // Log initial state
-            logger$10.info('broadcast_channel_initial_visibility', {
+            logger$10.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
@@ -11697,7 +11697,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         return await this.inbox.dequeue();
     }
     async _transportClose(code, reason) {
-        logger$10.info('broadcast_channel_transport_closing', {
+        logger$10.debug('broadcast_channel_transport_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             code,
@@ -11706,14 +11706,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             timestamp: new Date().toISOString(),
         });
         if (this.listenerRegistered) {
-            logger$10.info('broadcast_channel_removing_listener', {
+            logger$10.debug('broadcast_channel_removing_listener', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
             });
             this.channel.removeEventListener('message', this.onMsg);
             this.listenerRegistered = false;
-            logger$10.info('broadcast_channel_listener_removed', {
+            logger$10.debug('broadcast_channel_listener_removed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
@@ -11724,13 +11724,13 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
         }
-        logger$10.info('broadcast_channel_closing', {
+        logger$10.debug('broadcast_channel_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
         });
         this.channel.close();
-        logger$10.info('broadcast_channel_closed', {
+        logger$10.debug('broadcast_channel_closed', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
@@ -11821,6 +11821,28 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         }
         return undefined;
     }
+    /**
+     * Override start() to check initial visibility state
+     */
+    async start(inboundHandler) {
+        await super.start(inboundHandler);
+        // After transitioning to STARTED, check if tab is already hidden
+        if (typeof document !== 'undefined' && document.hidden) {
+            logger$10.debug('broadcast_channel_start_in_hidden_tab', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
+            // Immediately pause if tab is hidden at start time
+            await this.pause().catch((err) => {
+                logger$10.warning('broadcast_channel_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];
@@ -12062,6 +12084,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -12486,15 +12509,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === core.ConnectorState.PAUSED) {
+            if (currentState === core.ConnectorState.PAUSED) {
                 logger$$.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === core.ConnectorState.PAUSED && currentState === core.ConnectorState.STARTED) {
+                logger$$.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$$.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,

package/dist/node/node.mjs

@@ -2513,7 +2513,7 @@ class BaseAsyncConnector extends TaskSpawner {
             });
             return;
         }
-        logger$1f.info('connector_shutdown_starting', {
+        logger$1f.debug('connector_shutdown_starting', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             code,
@@ -2543,19 +2543,19 @@ class BaseAsyncConnector extends TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
-        logger$1f.info('connector_closing_transport', {
+        logger$1f.debug('connector_closing_transport', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         await this._transportClose(code, reason);
-        logger$1f.info('connector_transport_closed', {
+        logger$1f.debug('connector_transport_closed', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             timestamp: new Date().toISOString(),
         });
         // Shutdown spawned tasks
-        logger$1f.info('connector_shutting_down_tasks', {
+        logger$1f.debug('connector_shutting_down_tasks', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             grace_period_ms: effectiveGracePeriod * 1000,
@@ -2567,7 +2567,7 @@ class BaseAsyncConnector extends TaskSpawner {
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
-            logger$1f.info('connector_tasks_shutdown_complete', {
+            logger$1f.debug('connector_tasks_shutdown_complete', {
                 connector_id: this._connectorFlowId,
                 connector_type: this.constructor.name,
                 timestamp: new Date().toISOString(),
@@ -2587,7 +2587,7 @@ class BaseAsyncConnector extends TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
-        logger$1f.info('connector_shutdown_complete', {
+        logger$1f.debug('connector_shutdown_complete', {
             connector_id: this._connectorFlowId,
             connector_type: this.constructor.name,
             final_state: this._state,
@@ -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.936
+// Generated from package.json version: 0.3.5-test.938
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.936';
+const VERSION = '0.3.5-test.938';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11535,7 +11535,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        logger$10.info('broadcast_channel_connector_created', {
+        logger$10.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
             inbox_capacity: preferredCapacity,
@@ -11616,7 +11616,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         // Setup visibility change monitoring
         this.visibilityChangeHandler = () => {
             const isHidden = document.hidden;
-            logger$10.info('broadcast_channel_visibility_changed', {
+            logger$10.debug('broadcast_channel_visibility_changed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: isHidden ? 'hidden' : 'visible',
@@ -11646,7 +11646,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = true;
             // Log initial state
-            logger$10.info('broadcast_channel_initial_visibility', {
+            logger$10.debug('broadcast_channel_initial_visibility', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 visibility: document.hidden ? 'hidden' : 'visible',
@@ -11696,7 +11696,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         return await this.inbox.dequeue();
     }
     async _transportClose(code, reason) {
-        logger$10.info('broadcast_channel_transport_closing', {
+        logger$10.debug('broadcast_channel_transport_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             code,
@@ -11705,14 +11705,14 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             timestamp: new Date().toISOString(),
         });
         if (this.listenerRegistered) {
-            logger$10.info('broadcast_channel_removing_listener', {
+            logger$10.debug('broadcast_channel_removing_listener', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
             });
             this.channel.removeEventListener('message', this.onMsg);
             this.listenerRegistered = false;
-            logger$10.info('broadcast_channel_listener_removed', {
+            logger$10.debug('broadcast_channel_listener_removed', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 timestamp: new Date().toISOString(),
@@ -11723,13 +11723,13 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
         }
-        logger$10.info('broadcast_channel_closing', {
+        logger$10.debug('broadcast_channel_closing', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
         });
         this.channel.close();
-        logger$10.info('broadcast_channel_closed', {
+        logger$10.debug('broadcast_channel_closed', {
             channel: this.channelName,
             connector_id: this.connectorId,
             timestamp: new Date().toISOString(),
@@ -11820,6 +11820,28 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         }
         return undefined;
     }
+    /**
+     * Override start() to check initial visibility state
+     */
+    async start(inboundHandler) {
+        await super.start(inboundHandler);
+        // After transitioning to STARTED, check if tab is already hidden
+        if (typeof document !== 'undefined' && document.hidden) {
+            logger$10.debug('broadcast_channel_start_in_hidden_tab', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
+            // Immediately pause if tab is hidden at start time
+            await this.pause().catch((err) => {
+                logger$10.warning('broadcast_channel_initial_pause_failed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];
@@ -12061,6 +12083,7 @@ class UpstreamSessionManager extends TaskSpawner {
         this.lastHeartbeatAckTime = null;
         this.lastSeenEpoch = null;
         this.hadSuccessfulAttach = false;
+        this.lastConnectorState = null;
         this.connectEpoch = 0;
         const options = normalizeOptions$k(optionsInput);
         this.node = options.node;
@@ -12485,15 +12508,26 @@ class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            const currentState = connector.state;
+            const previousState = this.lastConnectorState;
+            this.lastConnectorState = currentState;
             // Skip heartbeat if connector is paused (e.g., tab is hidden)
             // Keep ack time current so we don't timeout immediately after resuming
-            if (connector.state === ConnectorState.PAUSED) {
+            if (currentState === ConnectorState.PAUSED) {
                 logger$$.debug('skipping_heartbeat_connector_paused', {
-                    connector_state: connector.state,
+                    connector_state: currentState,
                 });
                 this.lastHeartbeatAckTime = Date.now();
                 continue;
             }
+            // Reset ack time if just resumed from pause (prevents immediate timeout)
+            if (previousState === ConnectorState.PAUSED && currentState === ConnectorState.STARTED) {
+                logger$$.debug('connector_just_resumed_resetting_ack_time', {
+                    previous_state: previousState,
+                    current_state: currentState,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger$$.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,

package/dist/types/naylence/fame/connector/broadcast-channel-connector.browser.d.ts

@@ -1,6 +1,6 @@
 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 BROADCAST_CHANNEL_CONNECTOR_TYPE: "broadcast-channel-connector";
 export interface BroadcastChannelConnectorConfig extends ConnectorConfig {
     type: typeof BROADCAST_CHANNEL_CONNECTOR_TYPE;
@@ -35,6 +35,10 @@ export declare class BroadcastChannelConnector extends BaseAsyncConnector {
     private _checkDuplicateAck;
     private _extractEnvelopeFromInboxItem;
     private _extractSenderIdFromInboxItem;
+    /**
+     * Override start() to check initial visibility state
+     */
+    start(inboundHandler: FameEnvelopeHandler): Promise<void>;
     private _trimSeenAcks;
     private _extractAckDedupKey;
 }

package/dist/types/naylence/fame/node/upstream-session-manager.d.ts

@@ -65,6 +65,7 @@ export declare class UpstreamSessionManager extends TaskSpawner implements Sessi
     private lastHeartbeatAckTime;
     private lastSeenEpoch;
     private hadSuccessfulAttach;
+    private lastConnectorState;
     private connectEpoch;
     constructor(optionsInput: UpstreamSessionManagerOptionsInput);
     get systemId(): string | null;

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

package/package.json

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