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

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.955
+// Generated from package.json version: 0.3.5-test.957
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.955';
+const VERSION = '0.3.5-test.957';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -2447,8 +2447,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -2507,22 +2514,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger$1b.debug('flow_controller_waiting_for_credit', {
+            logger$1b.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(flowId),
             });
             await condition.wait();
-            logger$1b.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$1b.debug('flow_controller_credit_consumed', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger$1b.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger$1b.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -9419,10 +9428,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;
@@ -10008,8 +10019,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;
@@ -11092,8 +11105,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger$Z.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger$Z.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {
@@ -19951,6 +19971,9 @@ class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger$H.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors
@@ -30028,6 +30051,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -30088,6 +30112,7 @@ class BroadcastChannelListener extends TransportListener {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             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/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.955
+// Generated from package.json version: 0.3.5-test.957
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.955';
+const VERSION = '0.3.5-test.957';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -2445,8 +2445,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -2505,22 +2512,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger$1b.debug('flow_controller_waiting_for_credit', {
+            logger$1b.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(flowId),
             });
             await condition.wait();
-            logger$1b.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$1b.debug('flow_controller_credit_consumed', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger$1b.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger$1b.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -9417,10 +9426,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;
@@ -10006,8 +10017,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;
@@ -11090,8 +11103,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger$Z.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger$Z.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {
@@ -19949,6 +19969,9 @@ class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger$H.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors
@@ -30026,6 +30049,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -30086,6 +30110,7 @@ class BroadcastChannelListener extends TransportListener {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             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/cjs/naylence/fame/channel/flow-controller.js

@@ -118,8 +118,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -178,22 +185,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger.debug('flow_controller_waiting_for_credit', {
+            logger.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(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', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).

package/dist/cjs/naylence/fame/connector/base-async-connector.js

@@ -261,10 +261,12 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
             throw new errors_js_1.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;

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

@@ -160,8 +160,10 @@ class BroadcastChannelConnector extends base_async_connector_js_1.BaseAsyncConne
                 }
             }
         };
-        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;

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

@@ -342,6 +342,7 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
                         type: broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -402,6 +403,7 @@ class BroadcastChannelListener extends transport_listener_js_1.TransportListener
             type: broadcast_channel_connector_js_1.BROADCAST_CHANNEL_CONNECTOR_TYPE,
             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/cjs/naylence/fame/connector/websocket-connector.js

@@ -143,6 +143,9 @@ class WebSocketConnector extends base_async_connector_js_1.BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors

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

@@ -601,8 +601,15 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof errors_js_1.FameMessageTooLarge) {

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

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

@@ -115,8 +115,15 @@ export class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -175,22 +182,24 @@ export class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger.debug('flow_controller_waiting_for_credit', {
+            logger.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(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', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).

package/dist/esm/naylence/fame/connector/base-async-connector.js

@@ -257,10 +257,12 @@ export 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;

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

@@ -157,8 +157,10 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 }
             }
         };
-        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;

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

@@ -338,6 +338,7 @@ export class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -398,6 +399,7 @@ export class BroadcastChannelListener extends TransportListener {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             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/esm/naylence/fame/connector/websocket-connector.js

@@ -140,6 +140,9 @@ export class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors

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

@@ -598,8 +598,15 @@ export class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {

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

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.955
+// Generated from package.json version: 0.3.5-test.957
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.955';
+const VERSION = '0.3.5-test.957';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -2363,8 +2363,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -2423,22 +2430,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger$1b.debug('flow_controller_waiting_for_credit', {
+            logger$1b.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(flowId),
             });
             await condition.wait();
-            logger$1b.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$1b.debug('flow_controller_credit_consumed', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger$1b.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger$1b.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -9335,10 +9344,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;
@@ -9924,8 +9935,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;
@@ -11008,8 +11021,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger$Z.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger$Z.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {
@@ -19867,6 +19887,9 @@ class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger$H.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors
@@ -36256,6 +36279,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -36316,6 +36340,7 @@ class BroadcastChannelListener extends TransportListener {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             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/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.955
+// Generated from package.json version: 0.3.5-test.957
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.955';
+const VERSION = '0.3.5-test.957';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -2362,8 +2362,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -2422,22 +2429,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger$1b.debug('flow_controller_waiting_for_credit', {
+            logger$1b.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(flowId),
             });
             await condition.wait();
-            logger$1b.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$1b.debug('flow_controller_credit_consumed', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger$1b.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger$1b.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -9334,10 +9343,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;
@@ -9923,8 +9934,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;
@@ -11007,8 +11020,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger$Z.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger$Z.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {
@@ -19866,6 +19886,9 @@ class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger$H.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors
@@ -36255,6 +36278,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -36315,6 +36339,7 @@ class BroadcastChannelListener extends TransportListener {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             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/node/node.cjs

@@ -1277,8 +1277,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -1337,22 +1344,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger$1g.debug('flow_controller_waiting_for_credit', {
+            logger$1g.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(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', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger$1g.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger$1g.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -2265,10 +2274,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;
@@ -2778,6 +2789,9 @@ class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger$1e.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors
@@ -5514,12 +5528,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.955
+// Generated from package.json version: 0.3.5-test.957
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.955';
+const VERSION = '0.3.5-test.957';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11661,8 +11675,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;
@@ -12700,8 +12716,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger$$.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger$$.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {
@@ -32769,6 +32792,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE$1,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -32829,6 +32853,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/node/node.mjs

@@ -1276,8 +1276,15 @@ class FlowController {
         // Create a notifier promise
         const notifierPromise = (async () => {
             try {
-                // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                await new Promise((resolve) => setImmediate(resolve));
+                // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                await new Promise((resolve) => {
+                    if (typeof setImmediate === 'function') {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
                 condition.notifyAll();
             }
             finally {
@@ -1336,22 +1343,24 @@ class FlowController {
             current_balance: this.credits.get(flowId),
         });
         while (this.credits.get(flowId) <= 0) {
-            logger$1g.debug('flow_controller_waiting_for_credit', {
+            logger$1g.debug('flow_controller_waiting_for_credits', {
                 flow_id: flowId,
+                current_balance: this.credits.get(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', {
+        const newBalance = this.credits.get(flowId) - 1;
+        this.credits.set(flowId, newBalance);
+        logger$1g.debug('flow_controller_acquire_success', {
             flow_id: flowId,
-            prev_balance: current,
-            remaining_balance: current - 1,
+            new_balance: newBalance,
         });
+        if (newBalance <= this.lowWatermark) {
+            logger$1g.debug('flow_controller_acquire_below_low_watermark', {
+                flow_id: flowId,
+                low_watermark: this.lowWatermark,
+            });
+        }
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -2264,10 +2273,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;
@@ -2777,6 +2788,9 @@ class WebSocketConnector extends BaseAsyncConnector {
                 // Browser WebSocket or Node.js ws client
                 this._websocket.send(data);
             }
+            logger$1e.debug('websocket_sent_bytes', {
+                byte_length: data.length,
+            });
         }
         catch (error) {
             // Handle WebSocket disconnection errors
@@ -5513,12 +5527,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.955
+// Generated from package.json version: 0.3.5-test.957
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.955';
+const VERSION = '0.3.5-test.957';
 
 /**
  * Fame errors module - Fame protocol specific error classes
@@ -11660,8 +11674,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;
@@ -12699,8 +12715,15 @@ class UpstreamSessionManager extends TaskSpawner {
             if (!envelope) {
                 continue;
             }
+            logger$$.debug('upstream_pump_sending_envelope', {
+                envelopeId: envelope.id,
+                type: envelope.frame?.type,
+            });
             try {
                 await connector.send(envelope);
+                logger$$.debug('upstream_pump_sent_envelope', {
+                    envelopeId: envelope.id,
+                });
             }
             catch (error) {
                 if (error instanceof FameMessageTooLarge) {
@@ -32768,6 +32791,7 @@ class BroadcastChannelListener extends TransportListener {
                         type: BROADCAST_CHANNEL_CONNECTOR_TYPE$1,
                         channelName: this._channelName,
                         inboxCapacity: this._inboxCapacity,
+                        passive: true,
                     };
         }
         try {
@@ -32828,6 +32852,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,6 +7,7 @@ export interface BroadcastChannelConnectorConfig extends ConnectorConfig {
     channelName?: string;
     inboxCapacity?: number;
     initialWindow?: number;
+    passive?: boolean;
 }
 type BroadcastChannelInboxItem = Uint8Array | FameEnvelope | FameChannelMessage;
 export declare class BroadcastChannelConnector extends BaseAsyncConnector {

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

package/package.json

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