@naylence/runtime 0.3.5-test.962 → 0.3.5-test.963

package/dist/browser/index.cjs

@@ -98,12 +98,12 @@ installProcessEnvShim();
 // --- END ENV SHIM ---
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.962';
+const VERSION = '0.3.5-test.963';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10993,6 +10993,20 @@ class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -11014,6 +11028,8 @@ class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -11039,6 +11055,20 @@ class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger$Z.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -29058,13 +29088,16 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL$4;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$4;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -29105,17 +29138,20 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -29162,10 +29198,13 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 

package/dist/browser/index.mjs

@@ -96,12 +96,12 @@ installProcessEnvShim();
 // --- END ENV SHIM ---
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.962';
+const VERSION = '0.3.5-test.963';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10991,6 +10991,20 @@ class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -11012,6 +11026,8 @@ class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -11037,6 +11053,20 @@ class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger$Z.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -29056,13 +29086,16 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL$4;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$4;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -29103,17 +29136,20 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -29160,10 +29196,13 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 

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

@@ -75,13 +75,16 @@ class BroadcastChannelConnectorFactory extends connector_factory_js_1.ConnectorF
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -122,17 +125,20 @@ class BroadcastChannelConnectorFactory extends connector_factory_js_1.ConnectorF
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -179,10 +185,13 @@ class BroadcastChannelConnectorFactory extends connector_factory_js_1.ConnectorF
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 exports.BroadcastChannelConnectorFactory = BroadcastChannelConnectorFactory;

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

@@ -280,6 +280,20 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new errors_js_1.FameConnectError('Admission client is required to attach upstream');
@@ -301,6 +315,8 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await connector_factory_js_1.ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -326,6 +342,20 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)

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

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

@@ -72,13 +72,16 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -119,17 +122,20 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -176,10 +182,13 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 export default BroadcastChannelConnectorFactory;

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

@@ -277,6 +277,20 @@ export class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -298,6 +312,8 @@ export class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -323,6 +339,20 @@ export class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)

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.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-export const VERSION = '0.3.5-test.962';
+export const VERSION = '0.3.5-test.963';

package/dist/node/index.cjs

@@ -14,12 +14,12 @@ var fastify = require('fastify');
 var websocketPlugin = require('@fastify/websocket');
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.962';
+const VERSION = '0.3.5-test.963';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10909,6 +10909,20 @@ class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -10930,6 +10944,8 @@ class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -10955,6 +10971,20 @@ class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger$Z.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -28812,13 +28842,16 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL$5;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$5;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -28859,17 +28892,20 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -28916,10 +28952,13 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 

package/dist/node/index.mjs

@@ -13,12 +13,12 @@ import fastify from 'fastify';
 import websocketPlugin from '@fastify/websocket';
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.962';
+const VERSION = '0.3.5-test.963';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -10908,6 +10908,20 @@ class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -10929,6 +10943,8 @@ class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -10954,6 +10970,20 @@ class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger$Z.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -28811,13 +28841,16 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL$5;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$5;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -28858,17 +28891,20 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -28915,10 +28951,13 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 

package/dist/node/node.cjs

@@ -5563,12 +5563,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.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.962';
+const VERSION = '0.3.5-test.963';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -12601,6 +12601,20 @@ class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -12622,6 +12636,8 @@ class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -12647,6 +12663,20 @@ class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger$$.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -30745,13 +30775,16 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL$2;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$2;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -30792,17 +30825,20 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -30849,10 +30885,13 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 

package/dist/node/node.mjs

@@ -5562,12 +5562,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.962
+// Generated from package.json version: 0.3.5-test.963
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.962';
+const VERSION = '0.3.5-test.963';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -12600,6 +12600,20 @@ class UpstreamSessionManager extends TaskSpawner {
     waitEvent(event, signal) {
         return signal ? event.wait({ signal }) : event.wait();
     }
+    _getLocalNodeId() {
+        const normalized = this._normalizeNodeId(this.node.id);
+        if (!normalized) {
+            throw new Error('UpstreamSessionManager requires node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
     async connectCycle() {
         if (!this.admissionClient) {
             throw new FameConnectError('Admission client is required to attach upstream');
@@ -12621,6 +12635,8 @@ class UpstreamSessionManager extends TaskSpawner {
         await this.onWelcome(welcome.frame);
         const connector = await ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
+            localNodeId: this._getLocalNodeId(),
+            initialTargetNodeId: '*',
         });
         await connector.start(this.wrappedHandler);
         this.connector = connector;
@@ -12646,6 +12662,20 @@ class UpstreamSessionManager extends TaskSpawner {
         }
         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) {
+            const targetAware = connector;
+            if (typeof targetAware.setTargetNodeId === 'function') {
+                try {
+                    targetAware.setTargetNodeId(this.targetSystemId);
+                }
+                catch (error) {
+                    logger$$.warning('broadcast_channel_target_apply_failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                        target_node_id: this.targetSystemId,
+                    });
+                }
+            }
+        }
         await this.onAttach(attachInfo, connector);
         // Close the admission client immediately after attach completes
         // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -30744,13 +30774,16 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
-        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
         if (!localNodeId) {
-            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL$2;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$2;
-        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -30791,17 +30824,20 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
         const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
-        if (typeof initialTargetNodeId === 'string' && initialTargetNodeId.trim().length > 0) {
-            normalized.initialTargetNodeId = initialTargetNodeId.trim();
-        }
-        else if (initialTargetNodeId === '*') {
-            normalized.initialTargetNodeId = '*';
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
         }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
             normalized.inboxCapacity = Math.floor(capacity);
         }
+        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+        const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+        if (normalizedLocalNodeId) {
+            normalized.localNodeId = normalizedLocalNodeId;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -30848,10 +30884,13 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         return trimmed.length > 0 ? trimmed : null;
     }
     _normalizeTargetNodeId(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
         if (value === '*') {
             return '*';
         }
-        return this._normalizeNodeId(value) ?? '*';
+        return this._normalizeNodeId(value) ?? undefined;
     }
 }
 

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

@@ -7,11 +7,12 @@ export interface BroadcastChannelConnectorFactoryConfig extends ConnectorConfig,
     type: typeof BROADCAST_CHANNEL_CONNECTOR_TYPE;
     channelName?: string;
     inboxCapacity?: number;
+    localNodeId?: string;
     initialTargetNodeId?: string | '*';
 }
 export interface CreateBroadcastChannelConnectorOptions {
     authorization?: AuthorizationContext;
-    localNodeId: string;
+    localNodeId?: string;
     initialTargetNodeId?: string | '*';
 }
 export declare const FACTORY_META: {

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

@@ -82,6 +82,8 @@ export declare class UpstreamSessionManager extends TaskSpawner implements Sessi
     private sleepWithStop;
     private getNodeAttachGrant;
     private waitEvent;
+    private _getLocalNodeId;
+    private _normalizeNodeId;
     private connectCycle;
     private shouldAdvertiseBroadcastGrant;
     private createBroadcastCallbackGrant;

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

package/package.json

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