@naylence/runtime 0.3.6 → 0.3.9

package/dist/cjs/naylence/fame/node/admission/default-node-attach-client.js

@@ -11,15 +11,30 @@ class DefaultNodeAttachClient {
     constructor(options = {}) {
         this.buffer = [];
         this.inHandshake = false;
+        this.expectedSystemId = null;
         this.timeoutMs = options.timeoutMs ?? 10000;
         this.attachmentKeyValidator = options.attachmentKeyValidator;
         this.replicaStickinessManager = options.replicaStickinessManager ?? null;
     }
     async attach(node, originType, connector, welcomeFrame, finalHandler, keys, callbackGrants) {
         this.inHandshake = true;
+        this.expectedSystemId = welcomeFrame.systemId;
         const interimHandler = async (envelope, context) => {
             if (this.inHandshake) {
-                this.buffer.push(envelope);
+                // Filter: only buffer frames related to our systemId or frames without systemId info
+                const frameSystemId = envelope.frame
+                    ?.systemId;
+                if (!frameSystemId || frameSystemId === this.expectedSystemId) {
+                    this.buffer.push(envelope);
+                }
+                else {
+                    // Silently ignore frames from other agents during concurrent handshakes
+                    logger.debug('handshake_ignoring_frame_from_different_system', {
+                        frame_type: envelope.frame.type,
+                        frame_system_id: frameSystemId,
+                        expected_system_id: this.expectedSystemId,
+                    });
+                }
                 return null;
             }
             return finalHandler(envelope, context);
@@ -146,6 +161,7 @@ class DefaultNodeAttachClient {
             parent_id: ackFrame.targetSystemId,
         });
         this.inHandshake = false;
+        this.expectedSystemId = null;
         await connector.replaceHandler(finalHandler);
         while (this.buffer.length > 0) {
             const bufferedEnvelope = this.buffer.shift();
@@ -203,7 +219,8 @@ class DefaultNodeAttachClient {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
             // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
-            if (connector.state !== core_1.ConnectorState.STARTED && connector.state !== core_1.ConnectorState.PAUSED) {
+            if (connector.state !== core_1.ConnectorState.STARTED &&
+                connector.state !== core_1.ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;
@@ -222,9 +239,21 @@ class DefaultNodeAttachClient {
                 if (envelope.frame.type === 'NodeAttachAck') {
                     return envelope;
                 }
-                logger.error('unexpected_frame_during_handshake', {
-                    frame_type: envelope.frame.type,
-                });
+                // NodeAttach frames during handshake are expected in multi-agent scenarios
+                // where multiple agents attach concurrently to the same channel
+                if (envelope.frame.type === 'NodeAttach') {
+                    logger.debug('handshake_ignoring_concurrent_attach', {
+                        frame_type: envelope.frame.type,
+                        frame_system_id: envelope.frame?.systemId ??
+                            'unknown',
+                    });
+                }
+                else {
+                    // Other unexpected frames are still logged as errors
+                    logger.error('unexpected_frame_during_handshake', {
+                        frame_type: envelope.frame.type,
+                    });
+                }
             }
             await (0, task_utils_js_1.delay)(HANDSHAKE_POLL_INTERVAL_MS);
         }

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

@@ -321,25 +321,56 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
         await connector.start(this.wrappedHandler);
         this.connector = connector;
         const callbackGrants = this.node.gatherSupportedCallbackGrants();
+        logger.debug('callback_grants_before_augmentation', {
+            count: callbackGrants.length,
+            types: callbackGrants.map((g) => g.type),
+        });
+        // Check if we should create a broadcast callback grant before processing connection grants
+        // This prevents adding duplicate broadcast grants
+        const shouldAddBroadcastGrant = this.shouldAdvertiseBroadcastGrant(grant, callbackGrants);
+        const broadcastCallbackGrant = shouldAddBroadcastGrant
+            ? this.createBroadcastCallbackGrant(grant)
+            : null;
+        logger.debug('broadcast_callback_grant_check', {
+            should_add: shouldAddBroadcastGrant,
+            grant_created: !!broadcastCallbackGrant,
+        });
         // Include admission client's connection grants as callback grants
         // This ensures DirectAdmissionClient grants are available for grant selection
-        if (welcome.frame.connectionGrants && Array.isArray(welcome.frame.connectionGrants)) {
+        if (welcome.frame.connectionGrants &&
+            Array.isArray(welcome.frame.connectionGrants)) {
             for (const grant of welcome.frame.connectionGrants) {
                 if (grant && typeof grant === 'object') {
                     // Avoid duplicates by checking if grant already exists
-                    const isDuplicate = callbackGrants.some(existing => JSON.stringify(existing) === JSON.stringify(grant));
+                    const isDuplicate = callbackGrants.some((existing) => JSON.stringify(existing) === JSON.stringify(grant));
                     if (!isDuplicate) {
                         callbackGrants.push(grant);
+                        logger.debug('added_connection_grant_as_callback', {
+                            type: grant.type,
+                        });
+                    }
+                    else {
+                        logger.debug('skipped_duplicate_connection_grant', {
+                            type: grant.type,
+                        });
                     }
                 }
             }
         }
-        if (this.shouldAdvertiseBroadcastGrant(grant, callbackGrants)) {
-            const augmented = this.createBroadcastCallbackGrant(grant);
-            if (augmented) {
-                callbackGrants.push(augmented);
-            }
+        // Add broadcast grant after connection grants to ensure we don't duplicate
+        // any broadcast grants that may have been in connectionGrants
+        if (broadcastCallbackGrant &&
+            this.shouldAdvertiseBroadcastGrant(grant, callbackGrants)) {
+            callbackGrants.push(broadcastCallbackGrant);
+            logger.debug('added_broadcast_callback_grant');
+        }
+        else if (broadcastCallbackGrant) {
+            logger.debug('skipped_duplicate_broadcast_callback_grant');
         }
+        logger.debug('callback_grants_after_augmentation', {
+            count: callbackGrants.length,
+            types: callbackGrants.map((g) => g.type),
+        });
         const attachInfo = await this.attachClient.attach(this.node, this.outboundOriginType, connector, welcome.frame, this.wrappedHandler, this.getKeys() ?? undefined, callbackGrants);
         this.targetSystemId = attachInfo.targetSystemId ?? null;
         if (this.targetSystemId) {
@@ -580,7 +611,8 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
                 continue;
             }
             // Reset ack time if just resumed from pause (prevents immediate timeout)
-            if (previousState === core_1.ConnectorState.PAUSED && currentState === core_1.ConnectorState.STARTED) {
+            if (previousState === core_1.ConnectorState.PAUSED &&
+                currentState === core_1.ConnectorState.STARTED) {
                 logger.debug('connector_just_resumed_resetting_ack_time', {
                     previous_state: previousState,
                     current_state: currentState,

package/dist/cjs/naylence/fame/security/auth/oauth2-pkce-token-provider-factory.js

@@ -94,19 +94,23 @@ function normalizeConfig(config) {
         normalized.clientSecretConfig = (0, secret_source_js_1.normalizeSecretSource)(clientSecretSource);
     }
     const audienceCandidate = candidate.audience ?? candidate.aud;
-    if (typeof audienceCandidate === 'string' && audienceCandidate.trim().length > 0) {
+    if (typeof audienceCandidate === 'string' &&
+        audienceCandidate.trim().length > 0) {
         normalized.audience = audienceCandidate.trim();
     }
     const codeChallengeMethod = candidate.codeChallengeMethod ?? candidate.code_challenge_method;
-    if (typeof codeChallengeMethod === 'string' && codeChallengeMethod.trim().length > 0) {
+    if (typeof codeChallengeMethod === 'string' &&
+        codeChallengeMethod.trim().length > 0) {
         normalized.codeChallengeMethod = codeChallengeMethod.trim();
     }
     const codeVerifierLength = candidate.codeVerifierLength ?? candidate.code_verifier_length;
-    if (typeof codeVerifierLength === 'number' && Number.isFinite(codeVerifierLength)) {
+    if (typeof codeVerifierLength === 'number' &&
+        Number.isFinite(codeVerifierLength)) {
         normalized.codeVerifierLength = codeVerifierLength;
     }
     const clockSkewSeconds = candidate.clockSkewSeconds ?? candidate.clock_skew_seconds;
-    if (typeof clockSkewSeconds === 'number' && Number.isFinite(clockSkewSeconds)) {
+    if (typeof clockSkewSeconds === 'number' &&
+        Number.isFinite(clockSkewSeconds)) {
         normalized.clockSkewSeconds = clockSkewSeconds;
     }
     const loginHintParam = candidate.loginHintParam ?? candidate.login_hint_param;
@@ -151,8 +155,8 @@ class OAuth2PkceTokenProviderFactory extends token_provider_factory_js_1.TokenPr
             options.audience = normalized.audience;
         }
         if (normalized.codeChallengeMethod) {
-            options.codeChallengeMethod = normalized.codeChallengeMethod
-                .toUpperCase();
+            options.codeChallengeMethod =
+                normalized.codeChallengeMethod.toUpperCase();
         }
         if (normalized.codeVerifierLength) {
             options.codeVerifierLength = normalized.codeVerifierLength;

package/dist/cjs/naylence/fame/security/auth/oauth2-pkce-token-provider.js

@@ -67,8 +67,7 @@ function normalizeOptions(raw) {
     const scopes = normalizeScopes(camel.scopes) ??
         normalizeScopes(snake.scopes ?? snake.scope) ??
         DEFAULT_SCOPES.slice();
-    const audience = coerceString(camel.audience) ??
-        coerceString(snake.audience ?? snake.aud);
+    const audience = coerceString(camel.audience) ?? coerceString(snake.audience ?? snake.aud);
     const fetchImpl = (camel.fetchImpl ?? snake.fetch_impl);
     const clockSkewSeconds = coerceNumber(camel.clockSkewSeconds) ??
         coerceNumber(snake.clock_skew_seconds) ??

package/dist/cjs/naylence/fame/security/default-security-manager.js

@@ -507,7 +507,8 @@ class DefaultSecurityManager {
             const hasSignature = Boolean(envelope.sec?.sig);
             if (!hasSignature) {
                 const nodeSid = node.sid;
-                const envelopeSid = envelope.sid;
+                const envelopeSid = envelope
+                    .sid;
                 const isLocalUnsignedSelfEnvelope = localContext.originType === core_1.DeliveryOriginType.LOCAL &&
                     typeof nodeSid === 'string' &&
                     nodeSid.length > 0 &&

package/dist/cjs/naylence/fame/security/trust-store/noop-trust-store-provider-factory.js

@@ -4,14 +4,14 @@ exports.NoopTrustStoreProviderFactory = exports.FACTORY_META = void 0;
 const trust_store_provider_factory_js_1 = require("./trust-store-provider-factory.js");
 exports.FACTORY_META = {
     base: trust_store_provider_factory_js_1.TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE,
-    key: "NoopTrustStoreProvider",
+    key: 'NoopTrustStoreProvider',
     isDefault: true,
     priority: 10,
 };
 class NoopTrustStoreProviderFactory extends trust_store_provider_factory_js_1.TrustStoreProviderFactory {
     constructor() {
         super(...arguments);
-        this.type = "NoopTrustStoreProvider";
+        this.type = 'NoopTrustStoreProvider';
         this.isDefault = true;
         this.priority = 10;
     }

package/dist/cjs/naylence/fame/security/trust-store/trust-store-provider-factory.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NoopTrustStoreProvider = exports.TrustStoreProviderFactory = exports.TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE = void 0;
 const factory_1 = require("@naylence/factory");
-const DEFAULT_UNCONFIGURED_MESSAGE = "Trust store is not configured. Set FAME_CA_CERTS to a PEM value, a file path, a data URI, or an HTTPS bundle URL.";
-exports.TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE = "TrustStoreProviderFactory";
+const DEFAULT_UNCONFIGURED_MESSAGE = 'Trust store is not configured. Set FAME_CA_CERTS to a PEM value, a file path, a data URI, or an HTTPS bundle URL.';
+exports.TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE = 'TrustStoreProviderFactory';
 class TrustStoreProviderFactory extends factory_1.AbstractResourceFactory {
     createUnconfiguredProvider(reason) {
         return new NoopTrustStoreProvider(reason ?? DEFAULT_UNCONFIGURED_MESSAGE);

package/dist/cjs/naylence/fame/util/index.js

@@ -5,7 +5,7 @@
  * Cross-platform structured logging, async task management, and general utilities for Naylence Fame runtime
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeEnvelopeSnapshot = exports.throttle = exports.debounce = exports.retryWithBackoff = exports.withTimeout = exports.delay = exports.waitForAllSettled = exports.waitForAll = exports.waitForAny = exports.withLock = exports.AsyncLock = exports.TaskSpawner = exports.EnvelopeContext = exports.withEnvelopeContextAsync = exports.withEnvelopeContext = exports.currentTraceId = exports.getCurrentEnvelope = exports.pinoTransport = exports.consoleTransport = exports.stringifyNonPrimitives = exports.dropEmpty = exports.addEnvelopeFields = exports.addLogLevel = exports.addTimestamp = exports.LogLevelNames = exports.LogLevel = exports.enableLogging = exports.basicConfig = exports.getLogger = void 0;
+exports.normalizeEnvelopeSnapshot = exports.safeImport = exports.throttle = exports.debounce = exports.retryWithBackoff = exports.withTimeout = exports.delay = exports.waitForAllSettled = exports.waitForAll = exports.waitForAny = exports.withLock = exports.AsyncLock = exports.TaskSpawner = exports.EnvelopeContext = exports.withEnvelopeContextAsync = exports.withEnvelopeContext = exports.currentTraceId = exports.getCurrentEnvelope = exports.pinoTransport = exports.consoleTransport = exports.stringifyNonPrimitives = exports.dropEmpty = exports.addEnvelopeFields = exports.addLogLevel = exports.addTimestamp = exports.LogLevelNames = exports.LogLevel = exports.enableLogging = exports.basicConfig = exports.getLogger = void 0;
 const tslib_1 = require("tslib");
 // Export the main logging API
 var logging_js_1 = require("./logging.js");
@@ -55,5 +55,7 @@ tslib_1.__exportStar(require("./metrics-emitter.js"), exports);
 tslib_1.__exportStar(require("./util.js"), exports);
 tslib_1.__exportStar(require("./logicals.js"), exports);
 tslib_1.__exportStar(require("./ttl-validation.js"), exports);
+var lazy_import_js_1 = require("./lazy-import.js");
+Object.defineProperty(exports, "safeImport", { enumerable: true, get: function () { return lazy_import_js_1.safeImport; } });
 var logging_types_js_1 = require("./logging-types.js");
 Object.defineProperty(exports, "normalizeEnvelopeSnapshot", { enumerable: true, get: function () { return logging_types_js_1.normalizeEnvelopeSnapshot; } });

package/dist/cjs/node.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runOAuth2Server = exports.createOAuth2ServerApp = exports.createOpenIDConfigurationRouter = exports.createOAuth2TokenRouter = exports.createJwksRouter = exports.normalizeExtendedFameConfig = exports.FAME_FABRIC_FACTORY_BASE_TYPE = exports.InProcessFameFabricFactory = exports.InProcessFameFabric = exports.getInPageListenerInstance = exports.InPageListener = exports.getHttpListenerInstance = exports.HttpListener = exports.WebSocketListener = exports.TRANSPORT_LISTENER_FACTORY_BASE_TYPE = exports.TransportListener = exports.getWebsocketListenerInstance = exports.DefaultHttpServer = exports.QueueFullError = exports.HttpStatelessConnector = void 0;
+exports.runOAuth2Server = exports.createOAuth2ServerApp = exports.createOpenIDConfigurationRouter = exports.createOAuth2TokenRouter = exports.createJwksRouter = exports.normalizeExtendedFameConfig = exports.FAME_FABRIC_FACTORY_BASE_TYPE = exports.InProcessFameFabricFactory = exports.InProcessFameFabric = exports.safeImport = exports.getInPageListenerInstance = exports.InPageListener = exports.getHttpListenerInstance = exports.HttpListener = exports.WebSocketListener = exports.TRANSPORT_LISTENER_FACTORY_BASE_TYPE = exports.TransportListenerFactory = exports.TransportListener = exports.getWebsocketListenerInstance = exports.DefaultHttpServer = exports.QueueFullError = exports.HttpStatelessConnector = void 0;
 const tslib_1 = require("tslib");
 require("./naylence/fame/connector/websocket-connector-node-ssl.js");
 // Ensure Node-specific registrations (storage, sqlite, etc.) happen before
@@ -25,12 +25,15 @@ Object.defineProperty(exports, "QueueFullError", { enumerable: true, get: functi
 Object.defineProperty(exports, "DefaultHttpServer", { enumerable: true, get: function () { return index_js_1.DefaultHttpServer; } });
 Object.defineProperty(exports, "getWebsocketListenerInstance", { enumerable: true, get: function () { return index_js_1.getWebsocketListenerInstance; } });
 Object.defineProperty(exports, "TransportListener", { enumerable: true, get: function () { return index_js_1.TransportListener; } });
+Object.defineProperty(exports, "TransportListenerFactory", { enumerable: true, get: function () { return index_js_1.TransportListenerFactory; } });
 Object.defineProperty(exports, "TRANSPORT_LISTENER_FACTORY_BASE_TYPE", { enumerable: true, get: function () { return index_js_1.TRANSPORT_LISTENER_FACTORY_BASE_TYPE; } });
 Object.defineProperty(exports, "WebSocketListener", { enumerable: true, get: function () { return index_js_1.WebSocketListener; } });
 Object.defineProperty(exports, "HttpListener", { enumerable: true, get: function () { return index_js_1.HttpListener; } });
 Object.defineProperty(exports, "getHttpListenerInstance", { enumerable: true, get: function () { return index_js_1.getHttpListenerInstance; } });
 Object.defineProperty(exports, "InPageListener", { enumerable: true, get: function () { return index_js_1.InPageListener; } });
 Object.defineProperty(exports, "getInPageListenerInstance", { enumerable: true, get: function () { return index_js_1.getInPageListenerInstance; } });
+var lazy_import_js_1 = require("./naylence/fame/util/lazy-import.js");
+Object.defineProperty(exports, "safeImport", { enumerable: true, get: function () { return lazy_import_js_1.safeImport; } });
 var index_js_2 = require("./naylence/fame/fabric/index.js");
 Object.defineProperty(exports, "InProcessFameFabric", { enumerable: true, get: function () { return index_js_2.InProcessFameFabric; } });
 Object.defineProperty(exports, "InProcessFameFabricFactory", { enumerable: true, get: function () { return index_js_2.InProcessFameFabricFactory; } });

package/dist/cjs/runtime-isomorphic.js

@@ -8,7 +8,7 @@
  * expect access to the Node.js standard library.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.__runtimePluginLoader = exports.ensureRuntimeFactoriesRegistered = exports.registerRuntimeFactories = exports.registerDefaultFactories = exports.isRegisterable = exports.operation = exports.RpcMixin = exports.createRpcProxy = exports.RpcProxy = exports.INPAGE_CONNECTOR_TYPE = exports.InPageConnector = exports._NoopFlowController = exports.WebSocketState = exports.WebSocketConnector = exports.createResource = exports.ConnectorFactory = exports.createConnectorConfig = exports.isConnectorConfig = exports.ConnectorConfigDefaults = exports.BaseAsyncConnector = exports.VERSION = void 0;
+exports.__runtimePluginLoader = exports.getFabricForNode = exports.ensureRuntimeFactoriesRegistered = exports.registerRuntimeFactories = exports.registerDefaultFactories = exports.isRegisterable = exports.operation = exports.RpcMixin = exports.createRpcProxy = exports.RpcProxy = exports.INPAGE_CONNECTOR_TYPE = exports.InPageConnector = exports._NoopFlowController = exports.WebSocketState = exports.WebSocketConnector = exports.createResource = exports.ConnectorFactory = exports.createConnectorConfig = exports.isConnectorConfig = exports.ConnectorConfigDefaults = exports.BaseAsyncConnector = exports.VERSION = void 0;
 const tslib_1 = require("tslib");
 // Re-export everything from naylence-core for protocol primitives
 tslib_1.__exportStar(require("@naylence/core"), exports);
@@ -69,6 +69,9 @@ tslib_1.__exportStar(require("./naylence/fame/placement/node-placement-strategy-
 tslib_1.__exportStar(require("./naylence/fame/transport/transport-provisioner.js"), exports);
 // Welcome service (isomorphic)
 tslib_1.__exportStar(require("./naylence/fame/welcome/index.js"), exports);
+// Fabric registry (for looking up fabric from node)
+var fabric_registry_js_1 = require("./naylence/fame/fabric/fabric-registry.js");
+Object.defineProperty(exports, "getFabricForNode", { enumerable: true, get: function () { return fabric_registry_js_1.getFabricForNode; } });
 const runtimePluginModulePromise = Promise.resolve().then(() => tslib_1.__importStar(require('./plugin.js')));
 const globalScope = globalThis;
 const FACTORY_MODULE_PREFIX = '@naylence/runtime/naylence/fame/';

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

package/dist/esm/_env-shim.js

@@ -14,7 +14,9 @@ export function installProcessEnvShim() {
         if (g.__ENV__ && typeof g.__ENV__ === 'object')
             Object.assign(out, g.__ENV__);
         try {
-            // @ts-ignore -- import.meta is only available in ESM builds
+            // import.meta is only available in ESM builds
+            // prettier-ignore
+            // @ts-ignore
             const ie = (typeof import.meta !== 'undefined' && import.meta.env) || undefined;
             if (ie && typeof ie === 'object')
                 Object.assign(out, ie);

package/dist/esm/browser.js

@@ -6,7 +6,7 @@ export { InPageConnector, INPAGE_CONNECTOR_TYPE, } from './naylence/fame/connect
 export { BroadcastChannelConnector, BROADCAST_CHANNEL_CONNECTOR_TYPE, } from './naylence/fame/connector/broadcast-channel-connector.js';
 export { InPageConnectorFactory, FACTORY_META as INPAGE_CONNECTOR_FACTORY_META, } from './naylence/fame/connector/inpage-connector-factory.js';
 export { BroadcastChannelConnectorFactory, FACTORY_META as BROADCAST_CHANNEL_CONNECTOR_FACTORY_META, } from './naylence/fame/connector/broadcast-channel-connector-factory.js';
-export { InPageListener, } from './naylence/fame/connector/inpage-listener.js';
+export { InPageListener } from './naylence/fame/connector/inpage-listener.js';
 export { InPageListenerFactory, FACTORY_META as INPAGE_LISTENER_FACTORY_META, } from './naylence/fame/connector/inpage-listener-factory.js';
-export { BroadcastChannelListener, } from './naylence/fame/connector/broadcast-channel-listener.js';
+export { BroadcastChannelListener } from './naylence/fame/connector/broadcast-channel-listener.js';
 export { BroadcastChannelListenerFactory, FACTORY_META as BROADCAST_CHANNEL_LISTENER_FACTORY_META, } from './naylence/fame/connector/broadcast-channel-listener-factory.js';

package/dist/esm/naylence/fame/config/extended-fame-config.js

@@ -50,7 +50,8 @@ function createFsShim() {
                 else if (options &&
                     typeof options === 'object' &&
                     'encoding' in options &&
-                    typeof options.encoding === 'string') {
+                    typeof options.encoding ===
+                        'string') {
                     encoding = options.encoding;
                 }
                 const data = fsBinding.readFileUtf8(pathOrDescriptor, 0);

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

@@ -44,10 +44,12 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
         };
         const channelCandidate = record.channelName ?? record['channel_name'];
-        if (typeof channelCandidate === 'string' && channelCandidate.trim().length > 0) {
+        if (typeof channelCandidate === 'string' &&
+            channelCandidate.trim().length > 0) {
             config.channelName = channelCandidate.trim();
         }
-        const inboxCandidate = record.inboxCapacity ?? record['inbox_capacity'];
+        const inboxCandidate = record.inboxCapacity ??
+            record['inbox_capacity'];
         if (typeof inboxCandidate === 'number' &&
             Number.isFinite(inboxCandidate) &&
             inboxCandidate > 0) {
@@ -71,9 +73,11 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             throw new Error('BroadcastChannelConnectorFactory requires a configuration');
         }
         const normalized = this._normalizeConfig(config);
-        const options = (factoryArgs[0] ?? {});
+        const options = (factoryArgs[0] ??
+            {});
         const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
-        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ??
+            normalizedLocalNodeFromConfig;
         if (!localNodeId) {
             throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
@@ -98,6 +102,7 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             inboxCapacity,
             localNodeId,
             initialTargetNodeId: resolvedTarget,
+            passive: normalized.passive,
         };
         const connector = new BroadcastChannelConnector(connectorConfig, baseConfig);
         if (options.authorization) {
@@ -136,6 +141,9 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
         if (normalizedLocalNodeId) {
             normalized.localNodeId = normalizedLocalNodeId;
         }
+        if (typeof candidate.passive === 'boolean') {
+            normalized.passive = candidate.passive;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }

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

@@ -17,7 +17,8 @@ const ensureBroadcastEnvironment = () => {
 };
 export class BroadcastChannelConnector extends BaseAsyncConnector {
     static generateConnectorId() {
-        const globalCrypto = globalThis.crypto;
+        const globalCrypto = globalThis
+            .crypto;
         if (globalCrypto?.randomUUID) {
             return globalCrypto.randomUUID();
         }
@@ -72,7 +73,8 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         this.listenerRegistered = false;
         this.visibilityChangeListenerRegistered = false;
         this.channelName =
-            typeof config.channelName === 'string' && config.channelName.trim().length > 0
+            typeof config.channelName === 'string' &&
+                config.channelName.trim().length > 0
                 ? config.channelName.trim()
                 : DEFAULT_CHANNEL;
         const preferredCapacity = typeof config.inboxCapacity === 'number' &&
@@ -96,6 +98,7 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             local_node_id: this.localNodeId,
             target_node_id: this.targetNodeId ?? null,
             inbox_capacity: preferredCapacity,
+            passive: config.passive ?? false,
             timestamp: new Date().toISOString(),
         });
         this.onMsg = (event) => {
@@ -113,7 +116,8 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 message_type: message && typeof message === 'object'
-                    ? message.constructor?.name ?? typeof message
+                    ? (message.constructor
+                        ?.name ?? typeof message)
                     : typeof message,
                 has_sender_id: Boolean(message?.senderId),
                 has_sender_node_id: Boolean(message?.senderNodeId),
@@ -343,7 +347,9 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 timestamp: new Date().toISOString(),
             });
         }
-        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+        if (this.visibilityChangeListenerRegistered &&
+            this.visibilityChangeHandler &&
+            typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
@@ -371,7 +377,7 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         return rawOrEnvelope;
     }
     _isWildcardTarget() {
-        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+        return (this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined');
     }
     _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
         if (this._isWildcardTarget()) {
@@ -391,7 +397,9 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             return true;
         }
         const expectedSender = this.targetNodeId;
-        if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+        if (expectedSender &&
+            expectedSender !== '*' &&
+            senderNodeId !== expectedSender) {
             logger.debug('broadcast_channel_message_rejected', {
                 channel: this.channelName,
                 connector_id: this.connectorId,

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

@@ -17,7 +17,9 @@ function normalizeConfig(config) {
         : DEFAULT_CHANNEL;
     const rawInbox = record.inboxCapacity ?? record['inbox_capacity'];
     let inboxCapacity = DEFAULT_INBOX_CAPACITY;
-    if (typeof rawInbox === 'number' && Number.isFinite(rawInbox) && rawInbox > 0) {
+    if (typeof rawInbox === 'number' &&
+        Number.isFinite(rawInbox) &&
+        rawInbox > 0) {
         inboxCapacity = Math.floor(rawInbox);
     }
     else if (typeof rawInbox === 'string') {

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

@@ -10,9 +10,7 @@ import { BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE, broadcastChannelGrantToConnect
 const logger = getLogger('naylence.fame.connector.broadcast_channel_listener');
 const DEFAULT_CHANNEL = 'naylence-fabric';
 const DEFAULT_INBOX_CAPACITY = 2048;
-const RESPONSE_TYPE_MASK = FameResponseType.ACK |
-    FameResponseType.REPLY |
-    FameResponseType.STREAM;
+const RESPONSE_TYPE_MASK = FameResponseType.ACK | FameResponseType.REPLY | FameResponseType.STREAM;
 const isBrowserEnvironment = () => typeof window !== 'undefined' &&
     typeof BroadcastChannel !== 'undefined' &&
     typeof MessageEvent !== 'undefined';
@@ -226,9 +224,7 @@ export class BroadcastChannelListener extends TransportListener {
                     return null;
                 }
             })();
-            if (error instanceof ZodError &&
-                decoded &&
-                decoded.length > 0) {
+            if (error instanceof ZodError && decoded && decoded.length > 0) {
                 try {
                     const reparsed = JSON.parse(decoded);
                     const candidate = reparsed.rtype;
@@ -451,11 +447,19 @@ export class BroadcastChannelListener extends TransportListener {
             ? Math.floor(initialWindowCandidate)
             : undefined;
         const initialTargetNodeId = this._normalizeNodeId(targetCandidate) ?? targetSystemId;
+        const passive = typeof passiveCandidate === 'boolean' ? passiveCandidate : true;
+        logger.debug('broadcast_channel_listener_building_connector_config', {
+            system_id: systemId,
+            channel_name: channelName,
+            passive,
+            has_base_config: !!baseConfig,
+            passive_candidate: passiveCandidate,
+        });
         return {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             channelName,
             inboxCapacity,
-            passive: typeof passiveCandidate === 'boolean' ? passiveCandidate : true,
+            passive,
             initialWindow,
             localNodeId,
             initialTargetNodeId,

package/dist/esm/naylence/fame/connector/index.js

@@ -24,9 +24,9 @@ export { BroadcastChannelConnector, BROADCAST_CHANNEL_CONNECTOR_TYPE, } from './
 export { _NoopFlowController } from './noop-flow-controller.js';
 // Transport listener
 export { TransportListener } from './transport-listener.js';
-export { TRANSPORT_LISTENER_FACTORY_BASE_TYPE } from './transport-listener-factory.js';
+export { TransportListenerFactory, TRANSPORT_LISTENER_FACTORY_BASE_TYPE, } from './transport-listener-factory.js';
 export { DefaultHttpServer } from './default-http-server.js';
 export { WebSocketListener, getWebsocketListenerInstance, } from './websocket-listener.js';
 export { HttpListener, getHttpListenerInstance } from './http-listener.js';
-export { InPageListener, getInPageListenerInstance } from './inpage-listener.js';
+export { InPageListener, getInPageListenerInstance, } from './inpage-listener.js';
 export { BroadcastChannelListener, getBroadcastChannelListenerInstance, } from './broadcast-channel-listener.js';

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

@@ -66,7 +66,8 @@ export class InPageConnectorFactory extends ConnectorFactory {
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
         const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
-        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ??
+            normalizedLocalNodeFromConfig;
         if (!localNodeId) {
             throw new Error('InPageConnectorFactory requires a localNodeId from config or create() options');
         }

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

@@ -87,7 +87,8 @@ export class InPageConnector extends BaseAsyncConnector {
         this.listenerRegistered = false;
         this.visibilityChangeListenerRegistered = false;
         this.channelName =
-            typeof config.channelName === 'string' && config.channelName.trim().length > 0
+            typeof config.channelName === 'string' &&
+                config.channelName.trim().length > 0
                 ? config.channelName.trim()
                 : DEFAULT_CHANNEL;
         const preferredCapacity = typeof config.inboxCapacity === 'number' &&
@@ -126,7 +127,8 @@ export class InPageConnector extends BaseAsyncConnector {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 message_type: message && typeof message === 'object'
-                    ? message.constructor?.name ?? typeof message
+                    ? (message.constructor
+                        ?.name ?? typeof message)
                     : typeof message,
                 has_sender_id: Boolean(message?.senderId),
                 has_sender_node_id: Boolean(message?.senderNodeId),
@@ -135,7 +137,8 @@ export class InPageConnector extends BaseAsyncConnector {
                 return;
             }
             const busMessage = message;
-            const senderId = typeof busMessage.senderId === 'string' && busMessage.senderId.length > 0
+            const senderId = typeof busMessage.senderId === 'string' &&
+                busMessage.senderId.length > 0
                 ? busMessage.senderId
                 : null;
             const senderNodeId = InPageConnector.normalizeNodeId(busMessage.senderNodeId);
@@ -386,7 +389,9 @@ export class InPageConnector extends BaseAsyncConnector {
                 timestamp: new Date().toISOString(),
             });
         }
-        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+        if (this.visibilityChangeListenerRegistered &&
+            this.visibilityChangeHandler &&
+            typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
@@ -403,7 +408,7 @@ export class InPageConnector extends BaseAsyncConnector {
         return rawOrEnvelope;
     }
     _isWildcardTarget() {
-        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+        return (this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined');
     }
     _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
         if (this._isWildcardTarget()) {
@@ -423,7 +428,9 @@ export class InPageConnector extends BaseAsyncConnector {
             return true;
         }
         const expectedSender = this.targetNodeId;
-        if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+        if (expectedSender &&
+            expectedSender !== '*' &&
+            senderNodeId !== expectedSender) {
             logger.debug('inpage_message_rejected', {
                 channel: this.channelName,
                 connector_id: this.connectorId,