@naylence/runtime 0.3.5-test.965 → 0.3.5-test.967

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

@@ -73,11 +73,6 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         ensureBroadcastEnvironment();
         super(baseConfig);
         this.listenerRegistered = false;
-        this.seenAckKeys = new Map();
-        this.seenAckOrder = [];
-        this.ackDedupTtlMs = 30000;
-        this.ackDedupMaxEntries = 4096;
-        this.textDecoder = new TextDecoder();
         this.visibilityChangeListenerRegistered = false;
         this.channelName =
             typeof config.channelName === 'string' && config.channelName.trim().length > 0
@@ -169,9 +164,6 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
                 connector_id: this.connectorId,
                 payload_length: payload.byteLength,
             });
-            if (this._shouldSkipDuplicateAck(senderNodeId, payload)) {
-                return;
-            }
             try {
                 if (typeof this.inbox.tryEnqueue === 'function') {
                     const accepted = this.inbox.tryEnqueue(payload);
@@ -275,9 +267,6 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
     }
     async pushToReceive(rawOrEnvelope) {
         const item = this._normalizeInboxItem(rawOrEnvelope);
-        if (this._shouldSkipDuplicateAckFromInboxItem(item)) {
-            return;
-        }
         try {
             if (typeof this.inbox.tryEnqueue === 'function') {
                 const accepted = this.inbox.tryEnqueue(item);
@@ -377,8 +366,6 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
         const shutdownError = new errors_js_1.FameTransportClose(closeReason, closeCode);
         this.inbox.drain(shutdownError);
-        this.seenAckKeys.clear();
-        this.seenAckOrder.length = 0;
     }
     _normalizeInboxItem(rawOrEnvelope) {
         if (rawOrEnvelope instanceof Uint8Array) {
@@ -455,125 +442,6 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             ...extra,
         });
     }
-    _shouldSkipDuplicateAck(senderId, payload) {
-        const dedupKey = this._extractAckDedupKey(payload);
-        if (!dedupKey) {
-            return false;
-        }
-        const normalizedSenderId = typeof senderId === 'string' && senderId.length > 0
-            ? senderId
-            : undefined;
-        if (normalizedSenderId && normalizedSenderId !== this.localNodeId) {
-            logger.debug('broadcast_channel_duplicate_ack_bypass_non_self', {
-                channel: this.channelName,
-                connector_id: this.connectorId,
-                sender_id: normalizedSenderId,
-                dedup_key: dedupKey,
-                source: 'listener',
-            });
-            return false;
-        }
-        logger.debug('broadcast_channel_duplicate_ack_check', {
-            channel: this.channelName,
-            connector_id: this.connectorId,
-            sender_id: normalizedSenderId ?? null,
-            dedup_key: dedupKey,
-            source: 'listener',
-            cache_entries: this.seenAckKeys.size,
-        });
-        return this._checkDuplicateAck(dedupKey, normalizedSenderId);
-    }
-    _shouldSkipDuplicateAckFromInboxItem(item) {
-        if (item instanceof Uint8Array) {
-            return this._shouldSkipDuplicateAck(undefined, item);
-        }
-        const envelope = this._extractEnvelopeFromInboxItem(item);
-        if (!envelope) {
-            return false;
-        }
-        const frame = envelope.frame;
-        if (!frame || frame.type !== 'DeliveryAck') {
-            return false;
-        }
-        const refId = typeof frame.refId === 'string' && frame.refId.length > 0
-            ? frame.refId
-            : null;
-        const dedupKey = refId ?? envelope.id ?? null;
-        if (!dedupKey) {
-            return false;
-        }
-        const senderId = this._extractSenderIdFromInboxItem(item);
-        if (senderId && senderId !== this.localNodeId) {
-            logger.debug('broadcast_channel_duplicate_ack_bypass_non_self', {
-                channel: this.channelName,
-                connector_id: this.connectorId,
-                sender_id: senderId,
-                dedup_key: dedupKey,
-                source: 'inbox_item',
-            });
-            return false;
-        }
-        logger.debug('broadcast_channel_duplicate_ack_check', {
-            channel: this.channelName,
-            connector_id: this.connectorId,
-            sender_id: senderId ?? null,
-            dedup_key: dedupKey,
-            source: 'inbox_item',
-            cache_entries: this.seenAckKeys.size,
-        });
-        return this._checkDuplicateAck(dedupKey, senderId);
-    }
-    _checkDuplicateAck(dedupKey, senderId) {
-        const now = Date.now();
-        const lastSeen = this.seenAckKeys.get(dedupKey);
-        if (lastSeen && now - lastSeen < this.ackDedupTtlMs) {
-            logger.debug('broadcast_channel_duplicate_ack_suppressed', {
-                channel: this.channelName,
-                connector_id: this.connectorId,
-                sender_id: senderId ?? null,
-                dedup_key: dedupKey,
-                age_ms: now - lastSeen,
-                ttl_ms: this.ackDedupTtlMs,
-                cache_entries: this.seenAckKeys.size,
-            });
-            return true;
-        }
-        this.seenAckKeys.set(dedupKey, now);
-        this.seenAckOrder.push(dedupKey);
-        logger.debug('broadcast_channel_duplicate_ack_recorded', {
-            channel: this.channelName,
-            connector_id: this.connectorId,
-            sender_id: senderId ?? null,
-            dedup_key: dedupKey,
-            cache_entries: this.seenAckKeys.size,
-        });
-        this._trimSeenAcks(now);
-        return false;
-    }
-    _extractEnvelopeFromInboxItem(item) {
-        if (!item || typeof item !== 'object') {
-            return null;
-        }
-        if ('envelope' in item) {
-            return item.envelope;
-        }
-        if ('frame' in item) {
-            return item;
-        }
-        return null;
-    }
-    _extractSenderIdFromInboxItem(item) {
-        if (!item || typeof item !== 'object') {
-            return undefined;
-        }
-        if ('context' in item) {
-            const context = item.context;
-            if (context && typeof context.fromSystemId === 'string') {
-                return context.fromSystemId;
-            }
-        }
-        return undefined;
-    }
     /**
      * Override start() to check initial visibility state
      */
@@ -627,46 +495,5 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             target_mode: 'wildcard',
         });
     }
-    _trimSeenAcks(now) {
-        while (this.seenAckOrder.length > 0) {
-            const candidate = this.seenAckOrder[0];
-            const timestamp = this.seenAckKeys.get(candidate);
-            if (timestamp === undefined) {
-                this.seenAckOrder.shift();
-                continue;
-            }
-            if (this.seenAckKeys.size > this.ackDedupMaxEntries ||
-                now - timestamp > this.ackDedupTtlMs) {
-                this.seenAckKeys.delete(candidate);
-                this.seenAckOrder.shift();
-                continue;
-            }
-            break;
-        }
-    }
-    _extractAckDedupKey(payload) {
-        try {
-            const decoded = this.textDecoder.decode(payload);
-            const parsed = JSON.parse(decoded);
-            const envelopeId = typeof parsed?.id === 'string' ? parsed.id : null;
-            const frameType = parsed?.frame?.type;
-            if (typeof frameType !== 'string' || frameType !== 'DeliveryAck') {
-                return null;
-            }
-            const refId = parsed.frame?.refId;
-            if (typeof refId === 'string' && refId.length > 0) {
-                return refId;
-            }
-            return envelopeId;
-        }
-        catch (error) {
-            logger.debug('broadcast_channel_ack_dedup_parse_failed', {
-                channel: this.channelName,
-                connector_id: this.connectorId,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            return null;
-        }
-    }
 }
 exports.BroadcastChannelConnector = BroadcastChannelConnector;

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

@@ -68,8 +68,16 @@ class InPageConnectorFactory extends connector_factory_js_1.ConnectorFactory {
         }
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
+        const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+        if (!localNodeId) {
+            throw new Error('InPageConnectorFactory requires a localNodeId from config or create() options');
+        }
         const channelName = normalized.channelName ?? DEFAULT_CHANNEL;
         const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY;
+        const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+        const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+        const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
         const baseConfig = {
             drainTimeout: normalized.drainTimeout,
             flowControl: normalized.flowControl,
@@ -84,6 +92,8 @@ class InPageConnectorFactory extends connector_factory_js_1.ConnectorFactory {
             type: inpage_connector_js_1.INPAGE_CONNECTOR_TYPE,
             channelName,
             inboxCapacity,
+            localNodeId,
+            initialTargetNodeId: resolvedTarget,
         };
         const connector = new inpage_connector_js_1.InPageConnector(connectorConfig, baseConfig);
         if (options.authorization) {
@@ -119,6 +129,16 @@ class InPageConnectorFactory extends connector_factory_js_1.ConnectorFactory {
             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;
+        }
+        const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
+        const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+        if (normalizedTarget) {
+            normalized.initialTargetNodeId = normalizedTarget;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -157,6 +177,22 @@ class InPageConnectorFactory extends connector_factory_js_1.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 === undefined || value === null) {
+            return undefined;
+        }
+        if (value === '*') {
+            return '*';
+        }
+        return this._normalizeNodeId(value) ?? undefined;
+    }
 }
 exports.InPageConnectorFactory = InPageConnectorFactory;
 exports.default = InPageConnectorFactory;

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

@@ -64,6 +64,26 @@ class InPageConnector extends base_async_connector_js_1.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 = {}) {
         ensureBrowserEnvironment();
         super(baseConfig);
@@ -79,41 +99,68 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
             ? Math.floor(config.inboxCapacity)
             : DEFAULT_INBOX_CAPACITY;
         this.inbox = new bounded_async_queue_js_1.BoundedAsyncQueue(preferredCapacity);
+        this.inboxCapacity = preferredCapacity;
         this.connectorId = InPageConnector.generateConnectorId();
+        const normalizedLocalNodeId = InPageConnector.normalizeNodeId(config.localNodeId);
+        if (!normalizedLocalNodeId) {
+            throw new Error('InPageConnector requires a non-empty localNodeId');
+        }
+        this.localNodeId = normalizedLocalNodeId;
+        this.targetNodeId = InPageConnector.normalizeTargetNodeId(config.initialTargetNodeId);
         logger.debug('inpage_connector_initialized', {
             channel: this.channelName,
             connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId ?? null,
+            inbox_capacity: preferredCapacity,
         });
         this.onMsg = (event) => {
+            if (!this.listenerRegistered) {
+                logger.warning('inpage_message_after_unregister', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    timestamp: new Date().toISOString(),
+                });
+                return;
+            }
             const messageEvent = event;
             const message = messageEvent.data;
             logger.debug('inpage_raw_event', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
-                message_type: message && typeof message === 'object' ? message.constructor?.name ?? typeof message : typeof message,
-                has_sender_id: Boolean(message?.senderId),
-                payload_type: message && typeof message === 'object'
-                    ? message?.payload instanceof Uint8Array
-                        ? 'Uint8Array'
-                        : message?.payload instanceof ArrayBuffer
-                            ? 'ArrayBuffer'
-                            : typeof message?.payload
+                message_type: message && typeof message === 'object'
+                    ? message.constructor?.name ?? typeof message
                     : typeof message,
-                payload_constructor: message && typeof message === 'object'
-                    ? message?.payload?.constructor?.name
-                    : undefined,
-                payload_keys: message && typeof message === 'object' && message?.payload && typeof message?.payload === 'object'
-                    ? Object.keys(message.payload).slice(0, 5)
-                    : undefined,
+                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 senderId = typeof busMessage.senderId === 'string' && busMessage.senderId.length > 0
+                ? busMessage.senderId
+                : null;
+            const senderNodeId = InPageConnector.normalizeNodeId(busMessage.senderNodeId);
+            if (!senderId || !senderNodeId) {
+                logger.debug('inpage_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'missing_sender_metadata',
+                });
                 return;
             }
-            if (busMessage.senderId === this.connectorId) {
+            if (senderId === this.connectorId || senderNodeId === this.localNodeId) {
+                logger.debug('inpage_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'self_echo',
+                    sender_node_id: senderNodeId,
+                });
+                return;
+            }
+            const incomingTargetNodeId = InPageConnector.normalizeTargetNodeId(busMessage.targetNodeId);
+            if (!this._shouldAcceptMessageFromBus(senderNodeId, incomingTargetNodeId)) {
                 return;
             }
             const payload = InPageConnector.coercePayload(busMessage.payload);
@@ -127,7 +174,9 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
             }
             logger.debug('inpage_message_received', {
                 channel: this.channelName,
-                sender_id: busMessage.senderId,
+                sender_id: senderId,
+                sender_node_id: senderNodeId,
+                target_node_id: incomingTargetNodeId ?? null,
                 connector_id: this.connectorId,
                 payload_length: payload.byteLength,
             });
@@ -135,15 +184,27 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
                 if (typeof this.inbox.tryEnqueue === 'function') {
                     const accepted = this.inbox.tryEnqueue(payload);
                     if (accepted) {
+                        this.logInboxSnapshot('inpage_inbox_enqueued', {
+                            source: 'listener',
+                            enqueue_strategy: 'try',
+                            payload_length: payload.byteLength,
+                        });
                         return;
                     }
                 }
                 this.inbox.enqueue(payload);
+                this.logInboxSnapshot('inpage_inbox_enqueued', {
+                    source: 'listener',
+                    enqueue_strategy: 'enqueue',
+                    payload_length: payload.byteLength,
+                });
             }
             catch (error) {
                 if (error instanceof bounded_async_queue_js_1.QueueFullError) {
                     logger.warning('inpage_receive_queue_full', {
                         channel: this.channelName,
+                        inbox_capacity: this.inboxCapacity,
+                        inbox_remaining_capacity: this.inbox.remainingCapacity,
                     });
                 }
                 else {
@@ -250,15 +311,25 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
             if (typeof this.inbox.tryEnqueue === 'function') {
                 const accepted = this.inbox.tryEnqueue(item);
                 if (accepted) {
+                    this.logInboxSnapshot('inpage_push_enqueued', {
+                        enqueue_strategy: 'try',
+                        item_type: this._describeInboxItem(item),
+                    });
                     return;
                 }
             }
             this.inbox.enqueue(item);
+            this.logInboxSnapshot('inpage_push_enqueued', {
+                enqueue_strategy: 'enqueue',
+                item_type: this._describeInboxItem(item),
+            });
         }
         catch (error) {
             if (error instanceof bounded_async_queue_js_1.QueueFullError) {
                 logger.warning('inpage_push_queue_full', {
                     channel: this.channelName,
+                    inbox_capacity: this.inboxCapacity,
+                    inbox_remaining_capacity: this.inbox.remainingCapacity,
                 });
                 throw error;
             }
@@ -271,25 +342,52 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
     }
     async _transportSendBytes(data) {
         ensureBrowserEnvironment();
+        const targetNodeId = this.targetNodeId ?? '*';
         logger.debug('inpage_message_sending', {
             channel: this.channelName,
             sender_id: this.connectorId,
+            sender_node_id: this.localNodeId,
+            target_node_id: targetNodeId,
         });
         const event = new MessageEvent(this.channelName, {
             data: {
                 senderId: this.connectorId,
+                senderNodeId: this.localNodeId,
+                targetNodeId,
                 payload: data,
             },
         });
         getSharedBus().dispatchEvent(event);
     }
     async _transportReceive() {
-        return await this.inbox.dequeue();
+        const item = await this.inbox.dequeue();
+        this.logInboxSnapshot('inpage_inbox_dequeued', {
+            item_type: this._describeInboxItem(item),
+        });
+        return item;
     }
     async _transportClose(code, reason) {
+        logger.debug('inpage_transport_closing', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            code,
+            reason,
+            listener_registered: this.listenerRegistered,
+            timestamp: new Date().toISOString(),
+        });
         if (this.listenerRegistered) {
+            logger.debug('inpage_removing_listener', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
             getSharedBus().removeEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = false;
+            logger.debug('inpage_listener_removed', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                timestamp: new Date().toISOString(),
+            });
         }
         if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
@@ -307,5 +405,102 @@ class InPageConnector extends base_async_connector_js_1.BaseAsyncConnector {
         }
         return rawOrEnvelope;
     }
+    _isWildcardTarget() {
+        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+    }
+    _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
+        if (this._isWildcardTarget()) {
+            if (targetNodeId &&
+                targetNodeId !== '*' &&
+                targetNodeId !== this.localNodeId) {
+                logger.debug('inpage_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('inpage_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('inpage_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';
+        }
+        if (item.envelope) {
+            return 'channel_message';
+        }
+        if (item.frame) {
+            return 'envelope';
+        }
+        return 'unknown';
+    }
+    logInboxSnapshot(event, extra = {}) {
+        logger.debug(event, {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            connector_state: this.state,
+            inbox_capacity: this.inboxCapacity,
+            inbox_remaining_capacity: this.inbox.remainingCapacity,
+            ...extra,
+        });
+    }
+    setTargetNodeId(nodeId) {
+        const normalized = InPageConnector.normalizeNodeId(nodeId);
+        if (!normalized) {
+            throw new Error('InPageConnector target node id must be a non-empty string');
+        }
+        if (normalized === '*') {
+            this.setWildcardTarget();
+            return;
+        }
+        this.targetNodeId = normalized;
+        logger.debug('inpage_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('inpage_target_updated', {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            local_node_id: this.localNodeId,
+            target_node_id: this.targetNodeId,
+            target_mode: 'wildcard',
+        });
+    }
 }
 exports.InPageConnector = InPageConnector;