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

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

@@ -148,6 +148,10 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
      * Stop the connector gracefully
      */
     async stop() {
+        logger.debug('stopping_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
         if (!core_1.ConnectorStateUtils.canStop(this._state)) {
             logger.debug('connector_stop_already_stopped', {
                 current_state: this._state,
@@ -160,6 +164,52 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
         if (this._lastError) {
             throw this._lastError;
         }
+        logger.debug('connector_stopped', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core_1.ConnectorState.STARTED) {
+            logger.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core_1.ConnectorState.PAUSED);
+        logger.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== core_1.ConnectorState.PAUSED) {
+            logger.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(core_1.ConnectorState.STARTED);
+        logger.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
     }
     /**
      * Close the connector with optional code and reason
@@ -490,8 +540,21 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
      */
     async _shutdown(code, reason, gracePeriod, exc) {
         if (this._closed) {
+            logger.debug('shutdown_already_closed', {
+                connector_id: this._connectorFlowId,
+                current_state: this._state,
+            });
             return;
         }
+        logger.info('connector_shutdown_starting', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            code,
+            reason,
+            current_state: this._state,
+            has_error: !!exc,
+            timestamp: new Date().toISOString(),
+        });
         this._closed = true;
         this._closeCode = code;
         this._closeReason = reason;
@@ -513,16 +576,39 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
+        logger.info('connector_closing_transport', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            timestamp: new Date().toISOString(),
+        });
         await this._transportClose(code, reason);
+        logger.info('connector_transport_closed', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            timestamp: new Date().toISOString(),
+        });
         // Shutdown spawned tasks
+        logger.info('connector_shutting_down_tasks', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            grace_period_ms: effectiveGracePeriod * 1000,
+            join_timeout_ms: this._shutdownJoinTimeout,
+            timestamp: new Date().toISOString(),
+        });
         try {
             await this.shutdownTasks({
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
+            logger.info('connector_tasks_shutdown_complete', {
+                connector_id: this._connectorFlowId,
+                connector_type: this.constructor.name,
+                timestamp: new Date().toISOString(),
+            });
         }
         catch (error) {
             logger.warning('task_shutdown_error', {
+                connector_id: this._connectorFlowId,
                 error: error instanceof Error ? error.message : String(error),
             });
         }
@@ -534,6 +620,12 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
+        logger.info('connector_shutdown_complete', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            final_state: this._state,
+            timestamp: new Date().toISOString(),
+        });
     }
     /**
      * Close the underlying transport

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

@@ -5,6 +5,7 @@ const base_async_connector_js_1 = require("./base-async-connector.js");
 const errors_js_1 = require("../errors/errors.js");
 const logging_js_1 = require("../util/logging.js");
 const bounded_async_queue_js_1 = require("../util/bounded-async-queue.js");
+const core_1 = require("@naylence/core");
 const logger = (0, logging_js_1.getLogger)('naylence.fame.connector.broadcast_channel_connector');
 exports.BROADCAST_CHANNEL_CONNECTOR_TYPE = 'broadcast-channel-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -70,12 +71,22 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         this.inbox = new bounded_async_queue_js_1.BoundedAsyncQueue(preferredCapacity);
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        logger.debug('broadcast_channel_connector_initialized', {
+        logger.info('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
             inbox_capacity: preferredCapacity,
+            timestamp: new Date().toISOString(),
         });
         this.onMsg = (event) => {
+            // Guard: Don't process if listener was unregistered
+            if (!this.listenerRegistered) {
+                logger.warning('broadcast_channel_message_after_unregister', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    timestamp: new Date().toISOString(),
+                });
+                return;
+            }
             const message = event.data;
             logger.debug('broadcast_channel_raw_event', {
                 channel: this.channelName,
@@ -147,6 +158,25 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
                 visibility: isHidden ? 'hidden' : 'visible',
                 timestamp: new Date().toISOString(),
             });
+            // Pause/resume connector based on visibility
+            if (isHidden && this.state === core_1.ConnectorState.STARTED) {
+                this.pause().catch((err) => {
+                    logger.warning('broadcast_channel_pause_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+            else if (!isHidden && this.state === core_1.ConnectorState.PAUSED) {
+                this.resume().catch((err) => {
+                    logger.warning('broadcast_channel_resume_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
         };
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
@@ -202,16 +232,44 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         return await this.inbox.dequeue();
     }
     async _transportClose(code, reason) {
+        logger.info('broadcast_channel_transport_closing', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            code,
+            reason,
+            listener_registered: this.listenerRegistered,
+            timestamp: new Date().toISOString(),
+        });
         if (this.listenerRegistered) {
+            logger.info('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.info('broadcast_channel_listener_removed', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
         }
         if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
         }
+        logger.info('broadcast_channel_closing', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            timestamp: new Date().toISOString(),
+        });
         this.channel.close();
+        logger.info('broadcast_channel_closed', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            timestamp: new Date().toISOString(),
+        });
         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

@@ -387,7 +387,22 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                await this.connector.stop().catch(() => undefined);
+                logger.info('upstream_stopping_old_connector', {
+                    connect_epoch: this.connectEpoch,
+                    target_system_id: this.targetSystemId,
+                    timestamp: new Date().toISOString(),
+                });
+                await this.connector.stop().catch((err) => {
+                    logger.warning('upstream_connector_stop_error', {
+                        connect_epoch: this.connectEpoch,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+                logger.info('upstream_old_connector_stopped', {
+                    connect_epoch: this.connectEpoch,
+                    target_system_id: this.targetSystemId,
+                    timestamp: new Date().toISOString(),
+                });
                 this.connector = null;
             }
         }
@@ -521,6 +536,15 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            // Skip heartbeat if connector is paused (e.g., tab is hidden)
+            // Keep ack time current so we don't timeout immediately after resuming
+            if (connector.state === core_1.ConnectorState.PAUSED) {
+                logger.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -542,6 +566,7 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
                 throw error;
             }
             await this.node.dispatchEvent('onHeartbeatSent', this.node, envelope);
+            // Don't check heartbeat timeout when paused
             if (this.lastHeartbeatAckTime !== null &&
                 Date.now() - this.lastHeartbeatAckTime > graceMs) {
                 throw new errors_js_1.FameConnectError('missed heartbeat acknowledgement');

package/dist/cjs/version.js

@@ -1,10 +1,10 @@
 "use strict";
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.933
+// Generated from package.json version: 0.3.5-test.936
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /**
  * The package version, injected at build time.
  * @internal
  */
-exports.VERSION = '0.3.5-test.933';
+exports.VERSION = '0.3.5-test.936';

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

@@ -144,6 +144,10 @@ export class BaseAsyncConnector extends TaskSpawner {
      * Stop the connector gracefully
      */
     async stop() {
+        logger.debug('stopping_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
         if (!ConnectorStateUtils.canStop(this._state)) {
             logger.debug('connector_stop_already_stopped', {
                 current_state: this._state,
@@ -156,6 +160,52 @@ export class BaseAsyncConnector extends TaskSpawner {
         if (this._lastError) {
             throw this._lastError;
         }
+        logger.debug('connector_stopped', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Pause the connector (suspends heartbeat and housekeeping, but keeps connection alive)
+     */
+    async pause() {
+        logger.debug('pausing_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== ConnectorState.STARTED) {
+            logger.debug('connector_pause_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(ConnectorState.PAUSED);
+        logger.debug('connector_paused', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+    }
+    /**
+     * Resume the connector from paused state
+     */
+    async resume() {
+        logger.debug('resuming_connector', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
+        if (this._state !== ConnectorState.PAUSED) {
+            logger.debug('connector_resume_invalid_state', {
+                current_state: this._state,
+                connector_id: this._connectorFlowId,
+            });
+            return;
+        }
+        this._setState(ConnectorState.STARTED);
+        logger.debug('connector_resumed', {
+            current_state: this._state,
+            connector_id: this._connectorFlowId,
+        });
     }
     /**
      * Close the connector with optional code and reason
@@ -486,8 +536,21 @@ export class BaseAsyncConnector extends TaskSpawner {
      */
     async _shutdown(code, reason, gracePeriod, exc) {
         if (this._closed) {
+            logger.debug('shutdown_already_closed', {
+                connector_id: this._connectorFlowId,
+                current_state: this._state,
+            });
             return;
         }
+        logger.info('connector_shutdown_starting', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            code,
+            reason,
+            current_state: this._state,
+            has_error: !!exc,
+            timestamp: new Date().toISOString(),
+        });
         this._closed = true;
         this._closeCode = code;
         this._closeReason = reason;
@@ -509,16 +572,39 @@ export class BaseAsyncConnector extends TaskSpawner {
             this._sendPromiseResolve = undefined;
         }
         // Close transport
+        logger.info('connector_closing_transport', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            timestamp: new Date().toISOString(),
+        });
         await this._transportClose(code, reason);
+        logger.info('connector_transport_closed', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            timestamp: new Date().toISOString(),
+        });
         // Shutdown spawned tasks
+        logger.info('connector_shutting_down_tasks', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            grace_period_ms: effectiveGracePeriod * 1000,
+            join_timeout_ms: this._shutdownJoinTimeout,
+            timestamp: new Date().toISOString(),
+        });
         try {
             await this.shutdownTasks({
                 gracePeriod: effectiveGracePeriod * 1000, // Convert to milliseconds
                 joinTimeout: this._shutdownJoinTimeout,
             });
+            logger.info('connector_tasks_shutdown_complete', {
+                connector_id: this._connectorFlowId,
+                connector_type: this.constructor.name,
+                timestamp: new Date().toISOString(),
+            });
         }
         catch (error) {
             logger.warning('task_shutdown_error', {
+                connector_id: this._connectorFlowId,
                 error: error instanceof Error ? error.message : String(error),
             });
         }
@@ -530,6 +616,12 @@ export class BaseAsyncConnector extends TaskSpawner {
         if (this._closeResolver) {
             this._closeResolver();
         }
+        logger.info('connector_shutdown_complete', {
+            connector_id: this._connectorFlowId,
+            connector_type: this.constructor.name,
+            final_state: this._state,
+            timestamp: new Date().toISOString(),
+        });
     }
     /**
      * Close the underlying transport

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

@@ -2,6 +2,7 @@ import { BaseAsyncConnector, } from './base-async-connector.js';
 import { FameTransportClose } from '../errors/errors.js';
 import { getLogger } from '../util/logging.js';
 import { BoundedAsyncQueue, QueueFullError, } from '../util/bounded-async-queue.js';
+import { ConnectorState } from '@naylence/core';
 const logger = getLogger('naylence.fame.connector.broadcast_channel_connector');
 export const BROADCAST_CHANNEL_CONNECTOR_TYPE = 'broadcast-channel-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -67,12 +68,22 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        logger.debug('broadcast_channel_connector_initialized', {
+        logger.info('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
             inbox_capacity: preferredCapacity,
+            timestamp: new Date().toISOString(),
         });
         this.onMsg = (event) => {
+            // Guard: Don't process if listener was unregistered
+            if (!this.listenerRegistered) {
+                logger.warning('broadcast_channel_message_after_unregister', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    timestamp: new Date().toISOString(),
+                });
+                return;
+            }
             const message = event.data;
             logger.debug('broadcast_channel_raw_event', {
                 channel: this.channelName,
@@ -144,6 +155,25 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 visibility: isHidden ? 'hidden' : 'visible',
                 timestamp: new Date().toISOString(),
             });
+            // Pause/resume connector based on visibility
+            if (isHidden && this.state === ConnectorState.STARTED) {
+                this.pause().catch((err) => {
+                    logger.warning('broadcast_channel_pause_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+            else if (!isHidden && this.state === ConnectorState.PAUSED) {
+                this.resume().catch((err) => {
+                    logger.warning('broadcast_channel_resume_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
         };
         if (typeof document !== 'undefined') {
             document.addEventListener('visibilitychange', this.visibilityChangeHandler);
@@ -199,16 +229,44 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         return await this.inbox.dequeue();
     }
     async _transportClose(code, reason) {
+        logger.info('broadcast_channel_transport_closing', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            code,
+            reason,
+            listener_registered: this.listenerRegistered,
+            timestamp: new Date().toISOString(),
+        });
         if (this.listenerRegistered) {
+            logger.info('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.info('broadcast_channel_listener_removed', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
         }
         if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
         }
+        logger.info('broadcast_channel_closing', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            timestamp: new Date().toISOString(),
+        });
         this.channel.close();
+        logger.info('broadcast_channel_closed', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            timestamp: new Date().toISOString(),
+        });
         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

@@ -2,7 +2,7 @@ import { ConnectorFactory } from '../connector/connector-factory.js';
 import { TaskSpawner } from '../util/task-spawner.js';
 import { AsyncEvent } from '../util/async-event.js';
 import { getLogger } from '../util/logging.js';
-import { DeliveryOriginType, FameFabric, generateId, } from '@naylence/core';
+import { ConnectorState, DeliveryOriginType, FameFabric, generateId, } from '@naylence/core';
 import { FameConnectError, FameMessageTooLarge, FameTransportClose, } from '../errors/errors.js';
 import { TaskCancelledError } from '../util/task-types.js';
 import { FameResponseType } from '@naylence/core';
@@ -384,7 +384,22 @@ export class UpstreamSessionManager extends TaskSpawner {
             this.currentStopSubtasks = null;
             await Promise.allSettled(tasks.map((task) => task.promise));
             if (this.connector) {
-                await this.connector.stop().catch(() => undefined);
+                logger.info('upstream_stopping_old_connector', {
+                    connect_epoch: this.connectEpoch,
+                    target_system_id: this.targetSystemId,
+                    timestamp: new Date().toISOString(),
+                });
+                await this.connector.stop().catch((err) => {
+                    logger.warning('upstream_connector_stop_error', {
+                        connect_epoch: this.connectEpoch,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+                logger.info('upstream_old_connector_stopped', {
+                    connect_epoch: this.connectEpoch,
+                    target_system_id: this.targetSystemId,
+                    timestamp: new Date().toISOString(),
+                });
                 this.connector = null;
             }
         }
@@ -518,6 +533,15 @@ export class UpstreamSessionManager extends TaskSpawner {
             if (stopEvt.isSet() || signal?.aborted) {
                 break;
             }
+            // Skip heartbeat if connector is paused (e.g., tab is hidden)
+            // Keep ack time current so we don't timeout immediately after resuming
+            if (connector.state === ConnectorState.PAUSED) {
+                logger.debug('skipping_heartbeat_connector_paused', {
+                    connector_state: connector.state,
+                });
+                this.lastHeartbeatAckTime = Date.now();
+                continue;
+            }
             const envelope = await this.makeHeartbeatEnvelope();
             logger.debug('sending_heartbeat', {
                 hb_corr_id: envelope.corrId,
@@ -539,6 +563,7 @@ export class UpstreamSessionManager extends TaskSpawner {
                 throw error;
             }
             await this.node.dispatchEvent('onHeartbeatSent', this.node, envelope);
+            // Don't check heartbeat timeout when paused
             if (this.lastHeartbeatAckTime !== null &&
                 Date.now() - this.lastHeartbeatAckTime > graceMs) {
                 throw new FameConnectError('missed heartbeat acknowledgement');

package/dist/esm/version.js

@@ -1,7 +1,7 @@
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.933
+// Generated from package.json version: 0.3.5-test.936
 /**
  * The package version, injected at build time.
  * @internal
  */
-export const VERSION = '0.3.5-test.933';
+export const VERSION = '0.3.5-test.936';