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

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

@@ -49,6 +49,26 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         }
         return null;
     }
+    static normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    static normalizeTargetNodeId(value) {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        if (trimmed.length === 0) {
+            return undefined;
+        }
+        if (trimmed === '*') {
+            return '*';
+        }
+        return trimmed;
+    }
     constructor(config, baseConfig = {}) {
         ensureBroadcastEnvironment();
         super(baseConfig);
@@ -71,10 +91,18 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         this.inbox = new bounded_async_queue_js_1.BoundedAsyncQueue(preferredCapacity);
         this.inboxCapacity = preferredCapacity;
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
+        const normalizedLocalNodeId = BroadcastChannelConnector.normalizeNodeId(config.localNodeId);
+        if (!normalizedLocalNodeId) {
+            throw new Error('BroadcastChannelConnector requires a non-empty localNodeId');
+        }
+        this.localNodeId = normalizedLocalNodeId;
+        this.targetNodeId = BroadcastChannelConnector.normalizeTargetNodeId(config.initialTargetNodeId);
         this.channel = new BroadcastChannel(this.channelName);
         logger.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId ?? null,
             inbox_capacity: preferredCapacity,
             timestamp: new Date().toISOString(),
         });
@@ -96,15 +124,32 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
                     ? message.constructor?.name ?? typeof message
                     : typeof message,
                 has_sender_id: Boolean(message?.senderId),
+                has_sender_node_id: Boolean(message?.senderNodeId),
             });
             if (!message || typeof message !== 'object') {
                 return;
             }
             const busMessage = message;
-            if (typeof busMessage.senderId !== 'string' || busMessage.senderId.length === 0) {
+            const senderNodeId = BroadcastChannelConnector.normalizeNodeId(busMessage.senderNodeId);
+            if (!senderNodeId) {
+                logger.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'missing_sender_node_id',
+                });
+                return;
+            }
+            if (senderNodeId === this.localNodeId) {
+                logger.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'self_echo',
+                    sender_node_id: senderNodeId,
+                });
                 return;
             }
-            if (busMessage.senderId === this.connectorId) {
+            const incomingTargetNodeId = BroadcastChannelConnector.normalizeTargetNodeId(busMessage.targetNodeId);
+            if (!this._shouldAcceptMessageFromBus(senderNodeId, incomingTargetNodeId)) {
                 return;
             }
             const payload = BroadcastChannelConnector.coercePayload(busMessage.payload);
@@ -118,11 +163,13 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             }
             logger.debug('broadcast_channel_message_received', {
                 channel: this.channelName,
-                sender_id: busMessage.senderId,
+                sender_id: message?.senderId,
+                sender_node_id: senderNodeId,
+                target_node_id: incomingTargetNodeId ?? null,
                 connector_id: this.connectorId,
                 payload_length: payload.byteLength,
             });
-            if (this._shouldSkipDuplicateAck(busMessage.senderId, payload)) {
+            if (this._shouldSkipDuplicateAck(senderNodeId, payload)) {
                 return;
             }
             try {
@@ -266,12 +313,17 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
     }
     async _transportSendBytes(data) {
         ensureBroadcastEnvironment();
+        const targetNodeId = this.targetNodeId ?? '*';
         logger.debug('broadcast_channel_message_sending', {
             channel: this.channelName,
             sender_id: this.connectorId,
+            sender_node_id: this.localNodeId,
+            target_node_id: targetNodeId,
         });
         this.channel.postMessage({
             senderId: this.connectorId,
+            senderNodeId: this.localNodeId,
+            targetNodeId,
             payload: data,
         });
     }
@@ -334,6 +386,51 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         }
         return rawOrEnvelope;
     }
+    _isWildcardTarget() {
+        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+    }
+    _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
+        if (this._isWildcardTarget()) {
+            if (targetNodeId && targetNodeId !== '*') {
+                logger.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'wildcard_target_mismatch',
+                    sender_node_id: senderNodeId,
+                    target_node_id: targetNodeId,
+                    local_node_id: this.localNodeId,
+                });
+                return false;
+            }
+            return true;
+        }
+        const expectedSender = this.targetNodeId;
+        if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+            logger.debug('broadcast_channel_message_rejected', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                reason: 'unexpected_sender',
+                expected_sender_node_id: expectedSender,
+                sender_node_id: senderNodeId,
+                local_node_id: this.localNodeId,
+            });
+            return false;
+        }
+        if (targetNodeId &&
+            targetNodeId !== '*' &&
+            targetNodeId !== this.localNodeId) {
+            logger.debug('broadcast_channel_message_rejected', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                reason: 'unexpected_target',
+                sender_node_id: senderNodeId,
+                target_node_id: targetNodeId,
+                local_node_id: this.localNodeId,
+            });
+            return false;
+        }
+        return true;
+    }
     _describeInboxItem(item) {
         if (item instanceof Uint8Array) {
             return 'bytes';
@@ -364,7 +461,7 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         const normalizedSenderId = typeof senderId === 'string' && senderId.length > 0
             ? senderId
             : undefined;
-        if (normalizedSenderId && normalizedSenderId !== this.connectorId) {
+        if (normalizedSenderId && normalizedSenderId !== this.localNodeId) {
             logger.debug('broadcast_channel_duplicate_ack_bypass_non_self', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
@@ -404,7 +501,7 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             return false;
         }
         const senderId = this._extractSenderIdFromInboxItem(item);
-        if (senderId && senderId !== this.connectorId) {
+        if (senderId && senderId !== this.localNodeId) {
             logger.debug('broadcast_channel_duplicate_ack_bypass_non_self', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
@@ -500,6 +597,34 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             });
         }
     }
+    setTargetNodeId(nodeId) {
+        const normalized = BroadcastChannelConnector.normalizeNodeId(nodeId);
+        if (!normalized) {
+            throw new Error('BroadcastChannelConnector target node id must be a non-empty string');
+        }
+        if (normalized === '*') {
+            this.setWildcardTarget();
+            return;
+        }
+        this.targetNodeId = normalized;
+        logger.debug('broadcast_channel_target_updated', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId,
+            target_mode: 'direct',
+        });
+    }
+    setWildcardTarget() {
+        this.targetNodeId = '*';
+        logger.debug('broadcast_channel_target_updated', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId,
+            target_mode: 'wildcard',
+        });
+    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];

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

@@ -328,7 +328,7 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
                 node: routingNode,
             });
             const selection = grant_selection_policy_js_1.defaultGrantSelectionPolicy.selectCallbackGrant(selectionContext);
-            connectorConfig = this._grantToConnectorConfig(selection.grant);
+            connectorConfig = this._grantToConnectorConfig(selection.grant, systemId);
         }
         catch (error) {
             logger.debug('broadcast_channel_listener_grant_selection_failed', {
@@ -337,13 +337,20 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
                 error: error instanceof Error ? error.message : String(error),
             });
             connectorConfig =
-                this._extractBroadcastConnectorConfig(frame) ??
-                    {
+                this._extractBroadcastConnectorConfig(frame, systemId) ??
+                    this._buildConnectorConfigForSystem(systemId, {
                         type: broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
                         passive: true,
-                    };
+                    });
+        }
+        if (!connectorConfig) {
+            logger.error('broadcast_channel_listener_missing_connector_config', {
+                sender_id: params.senderId,
+                system_id: systemId,
+            });
+            return null;
         }
         try {
             const connector = await routingNode.createOriginConnector({
@@ -369,7 +376,7 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
             return null;
         }
     }
-    _extractBroadcastConnectorConfig(frame) {
+    _extractBroadcastConnectorConfig(frame, systemId) {
         const rawGrants = frame.callbackGrants;
         if (!Array.isArray(rawGrants)) {
             return null;
@@ -380,7 +387,10 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
                 (grant.type === broadcast_channel_connection_grant_js_1.BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE ||
                     grant.type === broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE)) {
                 try {
-                    return this._grantToConnectorConfig(grant);
+                    if (grant.type === broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE) {
+                        return this._buildConnectorConfigForSystem(systemId, grant);
+                    }
+                    return this._buildConnectorConfigForSystem(systemId, (0, broadcast_channel_connection_grant_js_1.broadcastChannelGrantToConnectorConfig)(grant));
                 }
                 catch (error) {
                     logger.debug('broadcast_channel_listener_grant_normalization_failed', {
@@ -391,31 +401,87 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
         }
         return null;
     }
-    _grantToConnectorConfig(grant) {
-        if (grant.type !== broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE) {
-            if (grant.type === broadcast_channel_connection_grant_js_1.BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE) {
-                return (0, broadcast_channel_connection_grant_js_1.broadcastChannelGrantToConnectorConfig)(grant);
+    _grantToConnectorConfig(grant, systemId) {
+        if (grant.type === broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE) {
+            return this._buildConnectorConfigForSystem(systemId, grant);
+        }
+        if (grant.type === broadcast_channel_connection_grant_js_1.BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE) {
+            return this._buildConnectorConfigForSystem(systemId, (0, broadcast_channel_connection_grant_js_1.broadcastChannelGrantToConnectorConfig)(grant));
+        }
+        if ('toConnectorConfig' in grant &&
+            typeof grant.toConnectorConfig ===
+                'function') {
+            const normalized = grant.toConnectorConfig();
+            if (normalized.type !== broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE) {
+                throw new Error(`Unsupported grant connector type: ${normalized.type}`);
             }
-            throw new Error(`Unsupported grant type: ${grant.type}`);
+            return this._buildConnectorConfigForSystem(systemId, normalized);
         }
-        const candidate = grant;
-        const config = {
+        throw new Error(`Unsupported grant type: ${grant.type}`);
+    }
+    _buildConnectorConfigForSystem(systemId, baseConfig) {
+        const localNodeId = this._requireLocalNodeId();
+        const targetSystemId = this._normalizeNodeId(systemId);
+        if (!targetSystemId) {
+            throw new Error('BroadcastChannelListener requires a valid system id');
+        }
+        const candidate = baseConfig ?? null;
+        const channelCandidate = candidate && 'channelName' in candidate
+            ? candidate.channelName
+            : undefined;
+        const inboxCandidate = candidate && 'inboxCapacity' in candidate
+            ? candidate.inboxCapacity
+            : undefined;
+        const initialWindowCandidate = candidate && 'initialWindow' in candidate
+            ? candidate.initialWindow
+            : undefined;
+        const passiveCandidate = candidate && 'passive' in candidate
+            ? candidate.passive
+            : undefined;
+        const targetCandidate = candidate && 'initialTargetNodeId' in candidate
+            ? candidate.initialTargetNodeId
+            : undefined;
+        const channelName = typeof channelCandidate === 'string' && channelCandidate.trim().length > 0
+            ? channelCandidate.trim()
+            : this._channelName;
+        const inboxCapacity = typeof inboxCandidate === 'number' &&
+            Number.isFinite(inboxCandidate) &&
+            inboxCandidate > 0
+            ? Math.floor(inboxCandidate)
+            : this._inboxCapacity;
+        const initialWindow = typeof initialWindowCandidate === 'number' &&
+            Number.isFinite(initialWindowCandidate) &&
+            initialWindowCandidate > 0
+            ? Math.floor(initialWindowCandidate)
+            : undefined;
+        const initialTargetNodeId = this._normalizeNodeId(targetCandidate) ?? targetSystemId;
+        return {
             type: broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE,
-            channelName: this._channelName,
-            inboxCapacity: this._inboxCapacity,
-            passive: true,
+            channelName,
+            inboxCapacity,
+            passive: typeof passiveCandidate === 'boolean' ? passiveCandidate : true,
+            initialWindow,
+            localNodeId,
+            initialTargetNodeId,
         };
-        const channelCandidate = candidate.channelName ?? candidate['channel_name'];
-        if (typeof channelCandidate === 'string' && channelCandidate.trim().length > 0) {
-            config.channelName = channelCandidate.trim();
+    }
+    _requireLocalNodeId() {
+        if (!this._routingNode) {
+            throw new Error('BroadcastChannelListener requires routing node context');
         }
-        const inboxCandidate = candidate.inboxCapacity ?? candidate['inbox_capacity'];
-        if (typeof inboxCandidate === 'number' &&
-            Number.isFinite(inboxCandidate) &&
-            inboxCandidate > 0) {
-            config.inboxCapacity = Math.floor(inboxCandidate);
+        const normalized = this._normalizeNodeId(this._routingNode.sid) ??
+            this._normalizeNodeId(this._routingNode.id);
+        if (!normalized) {
+            throw new Error('BroadcastChannelListener requires routing node with a stable identifier');
+        }
+        return normalized;
+    }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
         }
-        return config;
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
     }
     _monitorConnectorLifecycle(senderId, systemId, connector) {
         const maybeClosable = connector;

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

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

@@ -72,8 +72,13 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
+        const localNodeId = this._normalizeNodeId(options.localNodeId);
+        if (!localNodeId) {
+            throw new Error('BroadcastChannelConnectorFactory requires a localNodeId in create() options');
+        }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY;
+        const resolvedTarget = this._normalizeTargetNodeId(options.initialTargetNodeId ?? normalized.initialTargetNodeId);
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -88,6 +93,8 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             channelName,
             inboxCapacity,
+            localNodeId,
+            initialTargetNodeId: resolvedTarget,
         };
         const connector = new BroadcastChannelConnector(connectorConfig, baseConfig);
         if (options.authorization) {
@@ -111,6 +118,13 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             normalized.channelName = channel.trim();
         }
         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 = '*';
+        }
         if (typeof capacity === 'number' &&
             Number.isFinite(capacity) &&
             capacity > 0) {
@@ -154,5 +168,18 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY;
         return normalized;
     }
+    _normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    _normalizeTargetNodeId(value) {
+        if (value === '*') {
+            return '*';
+        }
+        return this._normalizeNodeId(value) ?? '*';
+    }
 }
 export default BroadcastChannelConnectorFactory;

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

@@ -46,6 +46,26 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         }
         return null;
     }
+    static normalizeNodeId(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    static normalizeTargetNodeId(value) {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        if (trimmed.length === 0) {
+            return undefined;
+        }
+        if (trimmed === '*') {
+            return '*';
+        }
+        return trimmed;
+    }
     constructor(config, baseConfig = {}) {
         ensureBroadcastEnvironment();
         super(baseConfig);
@@ -68,10 +88,18 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
         this.inboxCapacity = preferredCapacity;
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
+        const normalizedLocalNodeId = BroadcastChannelConnector.normalizeNodeId(config.localNodeId);
+        if (!normalizedLocalNodeId) {
+            throw new Error('BroadcastChannelConnector requires a non-empty localNodeId');
+        }
+        this.localNodeId = normalizedLocalNodeId;
+        this.targetNodeId = BroadcastChannelConnector.normalizeTargetNodeId(config.initialTargetNodeId);
         this.channel = new BroadcastChannel(this.channelName);
         logger.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId ?? null,
             inbox_capacity: preferredCapacity,
             timestamp: new Date().toISOString(),
         });
@@ -93,15 +121,32 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                     ? message.constructor?.name ?? typeof message
                     : typeof message,
                 has_sender_id: Boolean(message?.senderId),
+                has_sender_node_id: Boolean(message?.senderNodeId),
             });
             if (!message || typeof message !== 'object') {
                 return;
             }
             const busMessage = message;
-            if (typeof busMessage.senderId !== 'string' || busMessage.senderId.length === 0) {
+            const senderNodeId = BroadcastChannelConnector.normalizeNodeId(busMessage.senderNodeId);
+            if (!senderNodeId) {
+                logger.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'missing_sender_node_id',
+                });
+                return;
+            }
+            if (senderNodeId === this.localNodeId) {
+                logger.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'self_echo',
+                    sender_node_id: senderNodeId,
+                });
                 return;
             }
-            if (busMessage.senderId === this.connectorId) {
+            const incomingTargetNodeId = BroadcastChannelConnector.normalizeTargetNodeId(busMessage.targetNodeId);
+            if (!this._shouldAcceptMessageFromBus(senderNodeId, incomingTargetNodeId)) {
                 return;
             }
             const payload = BroadcastChannelConnector.coercePayload(busMessage.payload);
@@ -115,11 +160,13 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             }
             logger.debug('broadcast_channel_message_received', {
                 channel: this.channelName,
-                sender_id: busMessage.senderId,
+                sender_id: message?.senderId,
+                sender_node_id: senderNodeId,
+                target_node_id: incomingTargetNodeId ?? null,
                 connector_id: this.connectorId,
                 payload_length: payload.byteLength,
             });
-            if (this._shouldSkipDuplicateAck(busMessage.senderId, payload)) {
+            if (this._shouldSkipDuplicateAck(senderNodeId, payload)) {
                 return;
             }
             try {
@@ -263,12 +310,17 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
     }
     async _transportSendBytes(data) {
         ensureBroadcastEnvironment();
+        const targetNodeId = this.targetNodeId ?? '*';
         logger.debug('broadcast_channel_message_sending', {
             channel: this.channelName,
             sender_id: this.connectorId,
+            sender_node_id: this.localNodeId,
+            target_node_id: targetNodeId,
         });
         this.channel.postMessage({
             senderId: this.connectorId,
+            senderNodeId: this.localNodeId,
+            targetNodeId,
             payload: data,
         });
     }
@@ -331,6 +383,51 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         }
         return rawOrEnvelope;
     }
+    _isWildcardTarget() {
+        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+    }
+    _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
+        if (this._isWildcardTarget()) {
+            if (targetNodeId && targetNodeId !== '*') {
+                logger.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'wildcard_target_mismatch',
+                    sender_node_id: senderNodeId,
+                    target_node_id: targetNodeId,
+                    local_node_id: this.localNodeId,
+                });
+                return false;
+            }
+            return true;
+        }
+        const expectedSender = this.targetNodeId;
+        if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+            logger.debug('broadcast_channel_message_rejected', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                reason: 'unexpected_sender',
+                expected_sender_node_id: expectedSender,
+                sender_node_id: senderNodeId,
+                local_node_id: this.localNodeId,
+            });
+            return false;
+        }
+        if (targetNodeId &&
+            targetNodeId !== '*' &&
+            targetNodeId !== this.localNodeId) {
+            logger.debug('broadcast_channel_message_rejected', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                reason: 'unexpected_target',
+                sender_node_id: senderNodeId,
+                target_node_id: targetNodeId,
+                local_node_id: this.localNodeId,
+            });
+            return false;
+        }
+        return true;
+    }
     _describeInboxItem(item) {
         if (item instanceof Uint8Array) {
             return 'bytes';
@@ -361,7 +458,7 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         const normalizedSenderId = typeof senderId === 'string' && senderId.length > 0
             ? senderId
             : undefined;
-        if (normalizedSenderId && normalizedSenderId !== this.connectorId) {
+        if (normalizedSenderId && normalizedSenderId !== this.localNodeId) {
             logger.debug('broadcast_channel_duplicate_ack_bypass_non_self', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
@@ -401,7 +498,7 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             return false;
         }
         const senderId = this._extractSenderIdFromInboxItem(item);
-        if (senderId && senderId !== this.connectorId) {
+        if (senderId && senderId !== this.localNodeId) {
             logger.debug('broadcast_channel_duplicate_ack_bypass_non_self', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
@@ -497,6 +594,34 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             });
         }
     }
+    setTargetNodeId(nodeId) {
+        const normalized = BroadcastChannelConnector.normalizeNodeId(nodeId);
+        if (!normalized) {
+            throw new Error('BroadcastChannelConnector target node id must be a non-empty string');
+        }
+        if (normalized === '*') {
+            this.setWildcardTarget();
+            return;
+        }
+        this.targetNodeId = normalized;
+        logger.debug('broadcast_channel_target_updated', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId,
+            target_mode: 'direct',
+        });
+    }
+    setWildcardTarget() {
+        this.targetNodeId = '*';
+        logger.debug('broadcast_channel_target_updated', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId,
+            target_mode: 'wildcard',
+        });
+    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];