@naylence/runtime 0.3.5-test.958 → 0.3.5-test.959

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.958
+// Generated from package.json version: 0.3.5-test.959
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.958';
+const VERSION = '0.3.5-test.959';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -1358,38 +1358,28 @@ class TaskSpawner {
     }
 }
 
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }
 
 /**
@@ -9686,11 +9676,31 @@ class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger$$.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger$$.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = core.createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -9702,7 +9712,25 @@ class BaseAsyncConnector extends TaskSpawner {
             },
             flags: core.FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger$$.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger$$.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management
@@ -19981,9 +20009,6 @@ 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

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.958
+// Generated from package.json version: 0.3.5-test.959
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.958';
+const VERSION = '0.3.5-test.959';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -1356,38 +1356,28 @@ class TaskSpawner {
     }
 }
 
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }
 
 /**
@@ -9684,11 +9674,31 @@ class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger$$.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger$$.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -9700,7 +9710,25 @@ class BaseAsyncConnector extends TaskSpawner {
             },
             flags: FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger$$.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger$$.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management
@@ -19979,9 +20007,6 @@ 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

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

@@ -509,11 +509,31 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof flow_controller_js_1.FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = (0, core_1.createFameEnvelope)({
             ...(traceId && { traceId }),
             flowId,
@@ -525,7 +545,25 @@ class BaseAsyncConnector extends task_spawner_js_1.TaskSpawner {
             },
             flags: core_1.FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management

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

@@ -143,9 +143,6 @@ 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/util/lock.js

@@ -1,38 +1,28 @@
 "use strict";
-// import { getLogger } from './logging.js';
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AsyncLock = void 0;
 exports.withLock = withLock;
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 exports.AsyncLock = AsyncLock;
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }

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

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

@@ -505,11 +505,31 @@ export class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -521,7 +541,25 @@ export class BaseAsyncConnector extends TaskSpawner {
             },
             flags: FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management

package/dist/esm/naylence/fame/connector/websocket-connector.js

@@ -140,9 +140,6 @@ 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/util/lock.js

@@ -1,33 +1,23 @@
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 export class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 export async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }

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

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.958
+// Generated from package.json version: 0.3.5-test.959
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.958';
+const VERSION = '0.3.5-test.959';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -1274,38 +1274,28 @@ class TaskSpawner {
     }
 }
 
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }
 
 /**
@@ -9602,11 +9592,31 @@ class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger$$.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger$$.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = core.createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -9618,7 +9628,25 @@ class BaseAsyncConnector extends TaskSpawner {
             },
             flags: core.FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger$$.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger$$.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management
@@ -19897,9 +19925,6 @@ 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

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.958
+// Generated from package.json version: 0.3.5-test.959
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.958';
+const VERSION = '0.3.5-test.959';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -1273,38 +1273,28 @@ class TaskSpawner {
     }
 }
 
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }
 
 /**
@@ -9601,11 +9591,31 @@ class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger$$.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger$$.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -9617,7 +9627,25 @@ class BaseAsyncConnector extends TaskSpawner {
             },
             flags: FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger$$.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger$$.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management
@@ -19896,9 +19924,6 @@ 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

package/dist/node/node.cjs

@@ -2522,11 +2522,31 @@ class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger$1f.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger$1f.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = core.createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -2538,7 +2558,25 @@ class BaseAsyncConnector extends TaskSpawner {
             },
             flags: core.FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger$1f.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger$1f.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management
@@ -2789,9 +2827,6 @@ 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
@@ -5120,38 +5155,28 @@ class EncryptedStorageProviderBase {
     }
 }
 
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }
 
 const logger$1b = getLogger('naylence.fame.storage.sqlite_storage_provider');
@@ -5538,12 +5563,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.958
+// Generated from package.json version: 0.3.5-test.959
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.958';
+const VERSION = '0.3.5-test.959';
 
 /**
  * Fame errors module - Fame protocol specific error classes

package/dist/node/node.mjs

@@ -2521,11 +2521,31 @@ class BaseAsyncConnector extends TaskSpawner {
      * Emit credit update if flow control needs refill
      */
     async _maybeEmitCredit(flowId, traceId) {
-        if (!this._flowCtrl.needsRefill(flowId)) {
+        const remainingCredits = this._flowCtrl.getCredits(flowId);
+        const needsRefill = this._flowCtrl.needsRefill(flowId);
+        logger$1f.debug('maybe_emit_credit_check', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            remaining_credits: remainingCredits,
+            low_watermark: this._flowCtrl instanceof FlowController
+                ? this._flowCtrl.lowWatermark
+                : null,
+            initial_window: this._initialWindow,
+            needs_refill: needsRefill,
+        });
+        if (!needsRefill) {
             return;
         }
         const delta = this._initialWindow;
         this._flowCtrl.addCredits(flowId, delta);
+        logger$1f.debug('maybe_emit_credit_emit', {
+            connector_id: this._connectorFlowId,
+            flow_id: flowId,
+            trace_id: traceId ?? null,
+            emitted_credits: delta,
+            post_emit_balance: this._flowCtrl.getCredits(flowId),
+        });
         const ackEnv = createFameEnvelope({
             ...(traceId && { traceId }),
             flowId,
@@ -2537,7 +2557,25 @@ class BaseAsyncConnector extends TaskSpawner {
             },
             flags: FlowFlags.ACK,
         });
-        await this.send(ackEnv);
+        try {
+            await this.send(ackEnv);
+            logger$1f.debug('maybe_emit_credit_sent', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_acknowledged: delta,
+            });
+        }
+        catch (error) {
+            logger$1f.error('maybe_emit_credit_send_failed', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                credits_attempted: delta,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
     }
     // ---------------------------------------------------------------------
     // Shutdown Management
@@ -2788,9 +2826,6 @@ 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
@@ -5119,38 +5154,28 @@ class EncryptedStorageProviderBase {
     }
 }
 
-// import { getLogger } from './logging.js';
-// const logger = getLogger('naylence.fame.util.lock');
 class AsyncLock {
     constructor() {
-        this.queue = Promise.resolve();
+        this.tail = Promise.resolve();
     }
-    async acquire(task) {
-        const currentQueue = this.queue;
+    async runExclusive(operation) {
         let release;
-        const nextPromise = new Promise((resolve) => {
+        const next = new Promise((resolve) => {
             release = resolve;
         });
-        // Chain the new promise to the queue
-        this.queue = this.queue.then(() => nextPromise, () => nextPromise);
-        // Wait for the previous task to complete
-        // logger.debug('waiting_for_lock');
-        await currentQueue;
-        // logger.debug('lock_acquired');
+        const previous = this.tail;
+        this.tail = previous.then(() => next, () => next);
+        await previous;
         try {
-            return await task();
+            return await operation();
         }
         finally {
             release();
-            // logger.debug('lock_released');
         }
     }
-    async runExclusive(task) {
-        return this.acquire(task);
-    }
 }
 async function withLock(lock, operation) {
-    return await lock.acquire(operation);
+    return await lock.runExclusive(operation);
 }
 
 const logger$1b = getLogger('naylence.fame.storage.sqlite_storage_provider');
@@ -5537,12 +5562,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.958
+// Generated from package.json version: 0.3.5-test.959
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.5-test.958';
+const VERSION = '0.3.5-test.959';
 
 /**
  * Fame errors module - Fame protocol specific error classes

package/dist/types/naylence/fame/util/lock.d.ts

@@ -1,6 +1,5 @@
 export declare class AsyncLock {
-    private queue;
-    acquire<T>(task: () => Promise<T> | T): Promise<T>;
-    runExclusive<T>(task: () => Promise<T> | T): Promise<T>;
+    private tail;
+    runExclusive<T>(operation: () => Promise<T> | T): Promise<T>;
 }
 export declare function withLock<T>(lock: AsyncLock, operation: () => Promise<T> | T): Promise<T>;

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

package/package.json

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