@naylence/runtime 0.3.5-test.954 → 0.3.5-test.956

package/dist/node/node.mjs

@@ -724,7 +724,7 @@ class TaskCancelledError extends Error {
  * Provides functionality similar to Python's asyncio TaskSpawner with proper
  * error handling, cancellation, and graceful shutdown capabilities.
  */
-const logger$1g = getLogger('naylence.fame.util.task_spawner');
+const logger$1h = getLogger('naylence.fame.util.task_spawner');
 function firstDefined(source, keys) {
     for (const key of keys) {
         if (Object.prototype.hasOwnProperty.call(source, key)) {
@@ -885,7 +885,7 @@ class TaskSpawner {
         const taskId = `task-${++this._taskCounter}`;
         const taskName = normalizedOptions.name || `unnamed-${taskId}`;
         const timeout = normalizedOptions.timeout ?? this._config.defaultTimeout;
-        logger$1g.debug('starting_background_task', {
+        logger$1h.debug('starting_background_task', {
             task_name: taskName,
             task_id: taskId,
         });
@@ -902,7 +902,7 @@ class TaskSpawner {
         task.promise
             .then(() => {
             if (!this._suppressCompletionLogging) {
-                logger$1g.debug('task_completed_successfully', {
+                logger$1h.debug('task_completed_successfully', {
                     task_name: taskName,
                     task_id: taskId,
                     duration_ms: Date.now() - task.startTime,
@@ -956,7 +956,7 @@ class TaskSpawner {
             error.name === 'AbortError' ||
             error.message === 'Task cancelled' ||
             error.message === 'Aborted') {
-            logger$1g.debug('task_cancelled', {
+            logger$1h.debug('task_cancelled', {
                 task_name: taskName,
                 note: 'Task cancelled as requested',
             });
@@ -964,7 +964,7 @@ class TaskSpawner {
         }
         // Handle timeout
         if (error instanceof TaskTimeoutError) {
-            logger$1g.warning('task_timed_out', {
+            logger$1h.warning('task_timed_out', {
                 task_name: taskName,
                 error: error.message,
             });
@@ -976,7 +976,7 @@ class TaskSpawner {
         // Handle known WebSocket shutdown race condition (similar to Python version)
         if (error.message.includes("await wasn't used with future") ||
             error.message.includes('WebSocket closed during receive')) {
-            logger$1g.debug('task_shutdown_race_condition_handled', {
+            logger$1h.debug('task_shutdown_race_condition_handled', {
                 task_name: taskName,
                 note: 'Normal WebSocket close timing during shutdown - not an error',
             });
@@ -986,7 +986,7 @@ class TaskSpawner {
         if (error.name === 'FameTransportClose' ||
             error.message.includes('normal closure') ||
             error.message.includes('Connection closed')) {
-            logger$1g.debug('task_shutdown_completed_normally', {
+            logger$1h.debug('task_shutdown_completed_normally', {
                 task_name: taskName,
                 note: 'Task closed normally during shutdown',
             });
@@ -999,14 +999,14 @@ class TaskSpawner {
         // Log retriable errors as warnings (they'll be retried by upstream logic)
         // Log non-retriable errors as errors (fatal failures)
         if (isRetriableError) {
-            logger$1g.warning('background_task_failed', {
+            logger$1h.warning('background_task_failed', {
                 task_name: taskName,
                 error: error.message,
                 retriable: true,
             });
         }
         else {
-            logger$1g.error('background_task_failed', {
+            logger$1h.error('background_task_failed', {
                 task_name: taskName,
                 error: error.message,
                 stack: error.stack,
@@ -1025,11 +1025,11 @@ class TaskSpawner {
     async shutdownTasks(options = {}) {
         const { gracePeriod, cancelHanging, joinTimeout } = normalizeShutdownOptions(options);
         if (this._tasks.size === 0) {
-            logger$1g.debug('shutdown_tasks_no_tasks_to_shutdown');
+            logger$1h.debug('shutdown_tasks_no_tasks_to_shutdown');
             return;
         }
         this._suppressCompletionLogging = true;
-        logger$1g.debug('shutting_down_tasks', {
+        logger$1h.debug('shutting_down_tasks', {
             task_count: this._tasks.size,
             task_names: Array.from(this._tasks.values()).map((t) => t.name),
             grace_period_ms: gracePeriod,
@@ -1044,7 +1044,7 @@ class TaskSpawner {
         if (cancelHanging) {
             const stillRunning = tasks.filter((task) => task.getState() === TaskState.RUNNING && !completed.has(task));
             if (stillRunning.length > 0) {
-                logger$1g.debug('tasks_did_not_complete_within_grace_period', {
+                logger$1h.debug('tasks_did_not_complete_within_grace_period', {
                     hanging_count: stillRunning.length,
                 });
                 // Wait for them to finish with individual timeouts
@@ -1054,7 +1054,7 @@ class TaskSpawner {
                     }
                     catch (error) {
                         if (error instanceof TaskTimeoutError) {
-                            logger$1g.warning('task_did_not_shutdown', {
+                            logger$1h.warning('task_did_not_shutdown', {
                                 task_name: task.name || task.id,
                                 join_timeout_ms: joinTimeout,
                             });
@@ -1065,7 +1065,7 @@ class TaskSpawner {
                         }
                         else if (!(error instanceof TaskCancelledError)) {
                             /* istanbul ignore next - unreachable defensive branch */
-                            logger$1g.error('task_raised_during_cancellation', {
+                            logger$1h.error('task_raised_during_cancellation', {
                                 task_name: task.name || task.id,
                                 error: error instanceof Error ? error.message : String(error),
                             });
@@ -1184,6 +1184,7 @@ class TaskSpawner {
  * condition/promise and ensure at most one notifier coroutine exists for a
  * flow at any time.
  */
+const logger$1g = getLogger('naylence.fame.flow.flow_controller');
 /**
  * Simple condition variable implementation for TypeScript/Node.js
  * Similar to Python's asyncio.Condition
@@ -1309,8 +1310,17 @@ class FlowController {
         // clamp into [0, initialWindow]
         const newBalance = Math.max(0, Math.min(this.initialWindow, prev + delta));
         this.credits.set(flowId, newBalance);
+        const crossedZero = prev <= 0 && newBalance > 0;
+        logger$1g.debug('flow_controller_add_credits', {
+            flow_id: flowId,
+            delta,
+            prev_balance: prev,
+            new_balance: newBalance,
+            initial_window: this.initialWindow,
+            crossed_zero: crossedZero,
+        });
         // wake waiters only if we crossed the zero boundary
-        if (prev <= 0 && newBalance > 0) {
+        if (crossedZero) {
             this.wakeWaiters(flowId);
         }
         return newBalance;
@@ -1321,11 +1331,27 @@ class FlowController {
     async acquire(flowId) {
         this.ensureFlow(flowId);
         const condition = this.conditions.get(flowId);
+        logger$1g.debug('flow_controller_acquire_attempt', {
+            flow_id: flowId,
+            current_balance: this.credits.get(flowId),
+        });
         while (this.credits.get(flowId) <= 0) {
+            logger$1g.debug('flow_controller_waiting_for_credit', {
+                flow_id: flowId,
+            });
             await condition.wait();
+            logger$1g.debug('flow_controller_woke_with_credit', {
+                flow_id: flowId,
+                balance_after_wake: this.credits.get(flowId),
+            });
         }
         const current = this.credits.get(flowId);
         this.credits.set(flowId, current - 1);
+        logger$1g.debug('flow_controller_credit_consumed', {
+            flow_id: flowId,
+            prev_balance: current,
+            remaining_balance: current - 1,
+        });
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -1345,6 +1371,12 @@ class FlowController {
         const current = this.credits.get(flowId);
         const remaining = Math.max(current - credits, 0);
         this.credits.set(flowId, remaining);
+        logger$1g.debug('flow_controller_consume', {
+            flow_id: flowId,
+            requested: credits,
+            prev_balance: current,
+            remaining_balance: remaining,
+        });
         return remaining;
     }
     /**
@@ -1365,6 +1397,10 @@ class FlowController {
         this.windowIds.delete(flowId);
         this.credits.set(flowId, this.initialWindow);
         this.wakeWaiters(flowId);
+        logger$1g.debug('flow_controller_flow_reset', {
+            flow_id: flowId,
+            reset_balance: this.initialWindow,
+        });
     }
     /**
      * Return `[windowId, flags]` for the next outbound envelope.
@@ -2228,10 +2264,12 @@ class BaseAsyncConnector extends TaskSpawner {
             throw new FameTransportClose('Connection closed', 1006);
         }
         // Apply flow control if enabled and not a credit update
-        if (this._fcEnabled &&
-            !(envelope.frame &&
-                'flow_id' in envelope.frame &&
-                'credits' in envelope.frame)) {
+        const isCreditUpdateFrame = Boolean(envelope.frame &&
+            (envelope.frame.type === 'CreditUpdate' ||
+                envelope.frame.type === 'credit_update' ||
+                ('flowId' in envelope.frame && 'credits' in envelope.frame) ||
+                ('flow_id' in envelope.frame && 'credits' in envelope.frame)));
+        if (this._fcEnabled && !isCreditUpdateFrame) {
             const flowId = envelope.flowId || this._connectorFlowId;
             envelope.flowId = flowId;
             const t0 = this._metrics ? performance.now() : 0;
@@ -5477,12 +5515,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.954
+// Generated from package.json version: 0.3.5-test.956
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.954';
+const VERSION = '0.3.5-test.956';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11533,6 +11571,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             ? Math.floor(config.inboxCapacity)
             : DEFAULT_INBOX_CAPACITY$7;
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
+        this.inboxCapacity = preferredCapacity;
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
         logger$10.debug('broadcast_channel_connector_created', {
@@ -11592,15 +11631,27 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 if (typeof this.inbox.tryEnqueue === 'function') {
                     const accepted = this.inbox.tryEnqueue(payload);
                     if (accepted) {
+                        this.logInboxSnapshot('broadcast_channel_inbox_enqueued', {
+                            source: 'listener',
+                            enqueue_strategy: 'try',
+                            payload_length: payload.byteLength,
+                        });
                         return;
                     }
                 }
                 this.inbox.enqueue(payload);
+                this.logInboxSnapshot('broadcast_channel_inbox_enqueued', {
+                    source: 'listener',
+                    enqueue_strategy: 'enqueue',
+                    payload_length: payload.byteLength,
+                });
             }
             catch (error) {
                 if (error instanceof QueueFullError) {
                     logger$10.warning('broadcast_channel_receive_queue_full', {
                         channel: this.channelName,
+                        inbox_capacity: this.inboxCapacity,
+                        inbox_remaining_capacity: this.inbox.remainingCapacity,
                     });
                 }
                 else {
@@ -11611,8 +11662,10 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 }
             }
         };
-        this.channel.addEventListener('message', this.onMsg);
-        this.listenerRegistered = true;
+        if (!config.passive) {
+            this.channel.addEventListener('message', this.onMsg);
+            this.listenerRegistered = true;
+        }
         // Setup visibility change monitoring
         this.visibilityChangeHandler = () => {
             const isHidden = document.hidden;
@@ -11684,15 +11737,25 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             if (typeof this.inbox.tryEnqueue === 'function') {
                 const accepted = this.inbox.tryEnqueue(item);
                 if (accepted) {
+                    this.logInboxSnapshot('broadcast_channel_push_enqueued', {
+                        enqueue_strategy: 'try',
+                        item_type: this._describeInboxItem(item),
+                    });
                     return;
                 }
             }
             this.inbox.enqueue(item);
+            this.logInboxSnapshot('broadcast_channel_push_enqueued', {
+                enqueue_strategy: 'enqueue',
+                item_type: this._describeInboxItem(item),
+            });
         }
         catch (error) {
             if (error instanceof QueueFullError) {
                 logger$10.warning('broadcast_channel_push_queue_full', {
                     channel: this.channelName,
+                    inbox_capacity: this.inboxCapacity,
+                    inbox_remaining_capacity: this.inbox.remainingCapacity,
                 });
                 throw error;
             }
@@ -11715,7 +11778,11 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         });
     }
     async _transportReceive() {
-        return await this.inbox.dequeue();
+        const item = await this.inbox.dequeue();
+        this.logInboxSnapshot('broadcast_channel_inbox_dequeued', {
+            item_type: this._describeInboxItem(item),
+        });
+        return item;
     }
     async _transportClose(code, reason) {
         logger$10.debug('broadcast_channel_transport_closing', {
@@ -11769,6 +11836,28 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         }
         return rawOrEnvelope;
     }
+    _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$10.debug(event, {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            connector_state: this.state,
+            inbox_capacity: this.inboxCapacity,
+            inbox_remaining_capacity: this.inbox.remainingCapacity,
+            ...extra,
+        });
+    }
     _shouldSkipDuplicateAck(senderId, payload) {
         const dedupKey = this._extractAckDedupKey(payload);
         if (!dedupKey) {
@@ -32683,6 +32772,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE$1,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -32743,6 +32833,7 @@ class BroadcastChannelListener extends TransportListener {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE$1,
             channelName: this._channelName,
             inboxCapacity: this._inboxCapacity,
+            passive: true,
         };
         const channelCandidate = candidate.channelName ?? candidate['channel_name'];
         if (typeof channelCandidate === 'string' && channelCandidate.trim().length > 0) {

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

@@ -7,11 +7,13 @@ export interface BroadcastChannelConnectorConfig extends ConnectorConfig {
     channelName?: string;
     inboxCapacity?: number;
     initialWindow?: number;
+    passive?: boolean;
 }
 type BroadcastChannelInboxItem = Uint8Array | FameEnvelope | FameChannelMessage;
 export declare class BroadcastChannelConnector extends BaseAsyncConnector {
     private readonly channelName;
     private readonly inbox;
+    private readonly inboxCapacity;
     private listenerRegistered;
     private readonly connectorId;
     private readonly onMsg;
@@ -31,6 +33,8 @@ export declare class BroadcastChannelConnector extends BaseAsyncConnector {
     protected _transportReceive(): Promise<BroadcastChannelInboxItem>;
     protected _transportClose(code: number, reason: string): Promise<void>;
     private _normalizeInboxItem;
+    private _describeInboxItem;
+    private logInboxSnapshot;
     private _shouldSkipDuplicateAck;
     private _shouldSkipDuplicateAckFromInboxItem;
     private _checkDuplicateAck;

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

package/package.json

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