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

package/dist/cjs/naylence/fame/channel/flow-controller.js

@@ -25,6 +25,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowController = void 0;
 const core_1 = require("@naylence/core");
+const logging_js_1 = require("../util/logging.js");
+const logger = (0, logging_js_1.getLogger)('naylence.fame.flow.flow_controller');
 /**
  * Simple condition variable implementation for TypeScript/Node.js
  * Similar to Python's asyncio.Condition
@@ -150,8 +152,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.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;
@@ -162,11 +173,27 @@ class FlowController {
     async acquire(flowId) {
         this.ensureFlow(flowId);
         const condition = this.conditions.get(flowId);
+        logger.debug('flow_controller_acquire_attempt', {
+            flow_id: flowId,
+            current_balance: this.credits.get(flowId),
+        });
         while (this.credits.get(flowId) <= 0) {
+            logger.debug('flow_controller_waiting_for_credit', {
+                flow_id: flowId,
+            });
             await condition.wait();
+            logger.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.debug('flow_controller_credit_consumed', {
+            flow_id: flowId,
+            prev_balance: current,
+            remaining_balance: current - 1,
+        });
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -186,6 +213,12 @@ class FlowController {
         const current = this.credits.get(flowId);
         const remaining = Math.max(current - credits, 0);
         this.credits.set(flowId, remaining);
+        logger.debug('flow_controller_consume', {
+            flow_id: flowId,
+            requested: credits,
+            prev_balance: current,
+            remaining_balance: remaining,
+        });
         return remaining;
     }
     /**
@@ -206,6 +239,10 @@ class FlowController {
         this.windowIds.delete(flowId);
         this.credits.set(flowId, this.initialWindow);
         this.wakeWaiters(flowId);
+        logger.debug('flow_controller_flow_reset', {
+            flow_id: flowId,
+            reset_balance: this.initialWindow,
+        });
     }
     /**
      * Return `[windowId, flags]` for the next outbound envelope.

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

@@ -69,6 +69,7 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             ? Math.floor(config.inboxCapacity)
             : DEFAULT_INBOX_CAPACITY;
         this.inbox = new bounded_async_queue_js_1.BoundedAsyncQueue(preferredCapacity);
+        this.inboxCapacity = preferredCapacity;
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
         logger.debug('broadcast_channel_connector_created', {
@@ -128,15 +129,27 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
                 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 bounded_async_queue_js_1.QueueFullError) {
                     logger.warning('broadcast_channel_receive_queue_full', {
                         channel: this.channelName,
+                        inbox_capacity: this.inboxCapacity,
+                        inbox_remaining_capacity: this.inbox.remainingCapacity,
                     });
                 }
                 else {
@@ -220,15 +233,25 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
             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 bounded_async_queue_js_1.QueueFullError) {
                 logger.warning('broadcast_channel_push_queue_full', {
                     channel: this.channelName,
+                    inbox_capacity: this.inboxCapacity,
+                    inbox_remaining_capacity: this.inbox.remainingCapacity,
                 });
                 throw error;
             }
@@ -251,7 +274,11 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         });
     }
     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.debug('broadcast_channel_transport_closing', {
@@ -305,6 +332,28 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
         }
         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.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) {

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

package/dist/esm/naylence/fame/channel/flow-controller.js

@@ -22,6 +22,8 @@
  * flow at any time.
  */
 import { FlowFlags } from '@naylence/core';
+import { getLogger } from '../util/logging.js';
+const logger = getLogger('naylence.fame.flow.flow_controller');
 /**
  * Simple condition variable implementation for TypeScript/Node.js
  * Similar to Python's asyncio.Condition
@@ -147,8 +149,17 @@ export 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.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;
@@ -159,11 +170,27 @@ export class FlowController {
     async acquire(flowId) {
         this.ensureFlow(flowId);
         const condition = this.conditions.get(flowId);
+        logger.debug('flow_controller_acquire_attempt', {
+            flow_id: flowId,
+            current_balance: this.credits.get(flowId),
+        });
         while (this.credits.get(flowId) <= 0) {
+            logger.debug('flow_controller_waiting_for_credit', {
+                flow_id: flowId,
+            });
             await condition.wait();
+            logger.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.debug('flow_controller_credit_consumed', {
+            flow_id: flowId,
+            prev_balance: current,
+            remaining_balance: current - 1,
+        });
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -183,6 +210,12 @@ export class FlowController {
         const current = this.credits.get(flowId);
         const remaining = Math.max(current - credits, 0);
         this.credits.set(flowId, remaining);
+        logger.debug('flow_controller_consume', {
+            flow_id: flowId,
+            requested: credits,
+            prev_balance: current,
+            remaining_balance: remaining,
+        });
         return remaining;
     }
     /**
@@ -203,6 +236,10 @@ export class FlowController {
         this.windowIds.delete(flowId);
         this.credits.set(flowId, this.initialWindow);
         this.wakeWaiters(flowId);
+        logger.debug('flow_controller_flow_reset', {
+            flow_id: flowId,
+            reset_balance: this.initialWindow,
+        });
     }
     /**
      * Return `[windowId, flags]` for the next outbound envelope.

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

@@ -66,6 +66,7 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             ? Math.floor(config.inboxCapacity)
             : DEFAULT_INBOX_CAPACITY;
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
+        this.inboxCapacity = preferredCapacity;
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
         logger.debug('broadcast_channel_connector_created', {
@@ -125,15 +126,27 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 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.warning('broadcast_channel_receive_queue_full', {
                         channel: this.channelName,
+                        inbox_capacity: this.inboxCapacity,
+                        inbox_remaining_capacity: this.inbox.remainingCapacity,
                     });
                 }
                 else {
@@ -217,15 +230,25 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             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.warning('broadcast_channel_push_queue_full', {
                     channel: this.channelName,
+                    inbox_capacity: this.inboxCapacity,
+                    inbox_remaining_capacity: this.inbox.remainingCapacity,
                 });
                 throw error;
             }
@@ -248,7 +271,11 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         });
     }
     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.debug('broadcast_channel_transport_closing', {
@@ -302,6 +329,28 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         }
         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.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) {

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