@naylence/runtime 0.3.4 → 0.3.5-test.0

package/dist/esm/src/browser.js

@@ -0,0 +1,49 @@
+/**
+ * Browser-friendly entry point for Naylence Runtime.
+ *
+ * Exposes utilities, channels, connectors, and cross-platform helpers that
+ * do not rely on Node.js-only dependencies. This file purposefully excludes
+ * modules such as the SQLite storage providers and any prompt utilities that
+ * expect access to the Node.js standard library.
+ */
+// Re-export everything from naylence-core for protocol primitives
+export * from '@naylence/core';
+// Cross-platform Fame runtime exports
+export * from './naylence/fame/errors/index.js';
+export * from './naylence/fame/util/index.js';
+export * from './naylence/fame/channel/index.js';
+// Storage providers that are safe for browsers (in-memory + IndexedDB)
+export * from './naylence/fame/storage/index.js';
+export { getNode, getCurrentNode, withNodeContextAsync, runWithNodeContext, } from './naylence/fame/node/node-context-stack.js';
+// Connector layer exports trimmed to browser-safe components
+export { BaseAsyncConnector, } from './naylence/fame/connector/base-async-connector.js';
+export { ConnectorConfigDefaults, isConnectorConfig, createConnectorConfig, } from './naylence/fame/connector/connector-config.js';
+export { ConnectorFactory, createResource, } from './naylence/fame/connector/connector-factory.js';
+export { WebSocketConnector, WebSocketState, } from './naylence/fame/connector/websocket-connector.js';
+export { _NoopFlowController } from './naylence/fame/connector/noop-flow-controller.js';
+// RPC helpers are shared
+export { RpcProxy, createRpcProxy, RpcMixin, operation, } from './naylence/fame/service/rpc.js';
+// Runtime factory registration exposes no Node.js specifics
+export { registerDefaultFactories, registerRuntimeFactories, } from './naylence/fame/util/register-runtime-factories.js';
+// Browser-facing crypto helpers
+export { hasCryptoSupport, requireCryptoSupport, } from './naylence/fame/security/crypto/crypto-dependencies.js';
+export { BrowserWrappedKeyCredentialProvider, InvalidPassphraseError, } from './naylence/fame/security/credential/browser-wrapped-key-credential-provider.js';
+const isBrowserEnvironment = typeof window !== 'undefined' && typeof document !== 'undefined';
+if (isBrowserEnvironment) {
+    const runtimePluginModulePromise = import('./plugin.js');
+    const globalScope = globalThis;
+    if (typeof globalScope.__naylenceFactoryDynamicImporter !== 'function') {
+        const loader = async (specifier) => {
+            if (specifier === '@naylence/runtime' ||
+                specifier === '@naylence/runtime/' ||
+                specifier === '@naylence/runtime/plugin' ||
+                specifier === '@naylence/runtime/plugin.js' ||
+                specifier === '@naylence/runtime/dist/esm/plugin.js') {
+                return runtimePluginModulePromise;
+            }
+            return import(/* @vite-ignore */ specifier);
+        };
+        globalScope.__naylenceFactoryDynamicImporter = loader;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/esm/src/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kEAAkE;AAClE,cAAc,gBAAgB,CAAC;AAE/B,sCAAsC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AAEjD,uEAAuE;AACvE,cAAc,kCAAkC,CAAC;AAEjD,OAAO,EACL,OAAO,EACP,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,4CAA4C,CAAC;AAEpD,6DAA6D;AAC7D,OAAO,EACL,kBAAkB,GAEnB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAEL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,gDAAgD,CAAC;AAExD,OAAO,EACL,kBAAkB,EAGlB,cAAc,GACf,MAAM,kDAAkD,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAExF,yBAAyB;AACzB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,gCAAgC,CAAC;AAExC,4DAA4D;AAC5D,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GAEzB,MAAM,oDAAoD,CAAC;AAE5D,gCAAgC;AAChC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,mCAAmC,EACnC,sBAAsB,GACvB,MAAM,gFAAgF,CAAC;AAExF,MAAM,oBAAoB,GACxB,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAC;AAEnE,IAAI,oBAAoB,EAAE,CAAC;IAKzB,MAAM,0BAA0B,GAAG,MAAM,CAAC,aAAa,CAEtD,CAAC;IAEF,MAAM,WAAW,GAAG,UAEnB,CAAC;IAEF,IAAI,OAAO,WAAW,CAAC,gCAAgC,KAAK,UAAU,EAAE,CAAC;QACvE,MAAM,MAAM,GAAuB,KAAK,EACtC,SAAiB,EACiB,EAAE;YACpC,IACE,SAAS,KAAK,mBAAmB;gBACjC,SAAS,KAAK,oBAAoB;gBAClC,SAAS,KAAK,0BAA0B;gBACxC,SAAS,KAAK,6BAA6B;gBAC3C,SAAS,KAAK,sCAAsC,EACpD,CAAC;gBACD,OAAO,0BAA0B,CAAC;YACpC,CAAC;YAED,OAAO,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAEzC,CAAC;QACJ,CAAC,CAAC;QAEF,WAAW,CAAC,gCAAgC,GAAG,MAAM,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/esm/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,2DAA2D,CAAC;AAEnE,0CAA0C;AAC1C,cAAc,gBAAgB,CAAC;AAE/B,iEAAiE;AACjE,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sDAAsD,CAAC;AACrE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,oDAAoD,CAAC;AACnE,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAElD,8EAA8E;AAC9E,OAAO;AACL,iBAAiB;AACjB,kBAAkB,EAKlB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EAErB,cAAc;AAEd,sBAAsB;AACtB,kBAAkB,EAIlB,cAAc;AAEd,2BAA2B;AAC3B,sBAAsB,EACtB,cAAc;AAGd,kBAAkB;AAClB,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,GAE5B,MAAM,iCAAiC,CAAC;AAEzC,iCAAiC;AACjC,cAAc,kCAAkC,CAAC;AAEjD,+BAA+B;AAC/B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,gCAAgC,CAAC;AAExC,sCAAsC;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EACL,wBAAwB,GAEzB,MAAM,oDAAoD,CAAC;AAE5D,kDAAkD;AAClD,OAAO,EACL,gBAAgB,GAEjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,uBAAuB,GAExB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,+BAA+B,GAEhC,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,SAAS,IAAI,qBAAqB,EAClC,IAAI,IAAI,eAAe,GACxB,MAAM,uCAAuC,CAAC"}

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

@@ -0,0 +1,229 @@
+/**
+ * flow_controller.ts - credit window management with cooperative back-pressure.
+ *
+ * This version restores the *original* test-driven semantics while still
+ * preventing notifier task spam:
+ *
+ * * **addCredits**
+ *   * accepts *any* integer `delta` (positive or negative) and clamps the
+ *     resulting balance between 0 and `initialWindow`.
+ *   * When called outside an event-loop (e.g. synchronous unit-tests), the
+ *     credit balance is updated but waiter notification is skipped instead of
+ *     raising *RuntimeError*.
+ * * **consume**
+ *   * clamps at zero rather than raising on under-flow, matching historical
+ *     behaviour.
+ * * **_wakeWaiters**
+ *   * debounces the `notifyAll()` coroutine as before *but* quietly returns
+ *     when no running loop is active.
+ *
+ * The race-safety we introduced earlier is preserved - we still use a per-flow
+ * condition/promise and ensure at most one notifier coroutine exists for a
+ * flow at any time.
+ */
+import { FlowFlags } from '@naylence/core';
+/**
+ * Simple condition variable implementation for TypeScript/Node.js
+ * Similar to Python's asyncio.Condition
+ */
+class Condition {
+    constructor() {
+        this.waiters = [];
+    }
+    /**
+     * Wait for a notification
+     */
+    async wait() {
+        return new Promise((resolve, reject) => {
+            this.waiters.push({ resolve, reject });
+        });
+    }
+    /**
+     * Notify all waiting coroutines
+     */
+    notifyAll() {
+        const waiters = this.waiters.splice(0);
+        for (const waiter of waiters) {
+            waiter.resolve();
+        }
+    }
+}
+/**
+ * Sliding-window flow/credit accounting for *one* local endpoint.
+ *
+ * A *flow* is identified by a caller-chosen string `flowId`. Each flow
+ * starts with `initialWindow` credits. Sending an envelope *consumes*
+ * one credit; the peer replenishes credits via an "ACK/CreditUpdate"
+ * envelope. When credits reach 0 local senders block in
+ * `acquire` until more arrive.
+ *
+ * The controller is **event-loop safe** - multiple coroutines can call
+ * `addCredits`, `consume`, and `acquire` without additional locks - but it is
+ * **not** thread-safe.
+ */
+export class FlowController {
+    constructor(initialWindow, lowWatermarkRatio = 0.25) {
+        // flowId → remaining credit count
+        this.credits = new Map();
+        // flowId → per-flow Condition (created lazily)
+        this.conditions = new Map();
+        // flowId → outbound window counter
+        this.windowIds = new Map();
+        // flows that must emit RESET|SYN on next envelope
+        this.resetRequested = new Set();
+        // track active notifier tasks to prevent spam
+        this.activeNotifiers = new Map();
+        if (initialWindow <= 0) {
+            throw new Error('initialWindow must be > 0');
+        }
+        this.initialWindow = initialWindow;
+        this.lowWatermark = Math.floor(initialWindow * lowWatermarkRatio);
+    }
+    // ---------------------------------------------------------------------
+    // helpers
+    // ---------------------------------------------------------------------
+    /**
+     * Lazily create bookkeeping structures for *flowId*.
+     */
+    ensureFlow(flowId) {
+        if (!this.credits.has(flowId)) {
+            this.credits.set(flowId, this.initialWindow);
+        }
+        if (!this.conditions.has(flowId)) {
+            this.conditions.set(flowId, new Condition());
+        }
+    }
+    /**
+     * Wake every coroutine blocked in `acquire` for *flowId*.
+     *
+     * We debounce - at most **one** notifier coroutine per flow can be alive.
+     * If `FlowController` is used in synchronous code with no running loop
+     * we silently skip the wake-up because nothing could be awaiting anyway.
+     */
+    wakeWaiters(flowId) {
+        const condition = this.conditions.get(flowId);
+        if (!condition) {
+            return;
+        }
+        // Check if there's already an active notifier for this flow
+        const existingNotifier = this.activeNotifiers.get(flowId);
+        if (existingNotifier) {
+            return; // Already scheduled
+        }
+        // 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));
+                condition.notifyAll();
+            }
+            finally {
+                // Always clear the reference, even on error
+                this.activeNotifiers.delete(flowId);
+            }
+        })();
+        this.activeNotifiers.set(flowId, notifierPromise);
+    }
+    // ------------------------------------------------------------------
+    // public API
+    // ------------------------------------------------------------------
+    /**
+     * Return the current credit balance for *flowId*.
+     */
+    getCredits(flowId) {
+        this.ensureFlow(flowId);
+        return this.credits.get(flowId);
+    }
+    /**
+     * Add `delta` credits (positive *or* negative) to *flowId*.
+     *
+     * The balance is bounded between 0 and `initialWindow`. Returns the new balance.
+     * If the balance transitions from `<=0` to `>0` we wake blocked
+     * acquirers.
+     */
+    addCredits(flowId, delta) {
+        this.ensureFlow(flowId);
+        const prev = this.credits.get(flowId);
+        // clamp into [0, initialWindow]
+        const newBalance = Math.max(0, Math.min(this.initialWindow, prev + delta));
+        this.credits.set(flowId, newBalance);
+        // wake waiters only if we crossed the zero boundary
+        if (prev <= 0 && newBalance > 0) {
+            this.wakeWaiters(flowId);
+        }
+        return newBalance;
+    }
+    /**
+     * Block until at least one credit is available, then consume it.
+     */
+    async acquire(flowId) {
+        this.ensureFlow(flowId);
+        const condition = this.conditions.get(flowId);
+        while (this.credits.get(flowId) <= 0) {
+            await condition.wait();
+        }
+        const current = this.credits.get(flowId);
+        this.credits.set(flowId, current - 1);
+    }
+    /**
+     * Consume *credits* immediately (non-blocking).
+     *
+     * If *credits* exceeds the current balance we clamp to **zero** (legacy
+     * behaviour retained for existing tests).
+     * Returns the remaining balance.
+     */
+    consume(flowId, credits = 1) {
+        if (credits < 0) {
+            throw new Error('credits must be positive');
+        }
+        if (credits === 0) {
+            return this.credits.get(flowId) ?? this.initialWindow;
+        }
+        this.ensureFlow(flowId);
+        const current = this.credits.get(flowId);
+        const remaining = Math.max(current - credits, 0);
+        this.credits.set(flowId, remaining);
+        return remaining;
+    }
+    /**
+     * Return `true` if balance is at or below low-watermark.
+     */
+    needsRefill(flowId) {
+        return this.getCredits(flowId) <= this.lowWatermark;
+    }
+    // ---------------------------------------------------------------
+    // flow-state (RESET / sequence) helpers
+    // ---------------------------------------------------------------
+    /**
+     * Prepare a *RESET|SYN* flag for the next outbound envelope.
+     */
+    resetFlow(flowId) {
+        this.ensureFlow(flowId);
+        this.resetRequested.add(flowId);
+        this.windowIds.delete(flowId);
+        this.credits.set(flowId, this.initialWindow);
+        this.wakeWaiters(flowId);
+    }
+    /**
+     * Return `[windowId, flags]` for the next outbound envelope.
+     */
+    nextWindow(flowId) {
+        // RESET requested - emit RESET|SYN (window 0)
+        if (this.resetRequested.has(flowId)) {
+            this.resetRequested.delete(flowId);
+            this.windowIds.set(flowId, 0);
+            return [0, FlowFlags.RESET | FlowFlags.SYN];
+        }
+        // brand-new flow - start at window 0, emit SYN
+        if (!this.windowIds.has(flowId)) {
+            this.windowIds.set(flowId, 0);
+            return [0, FlowFlags.SYN];
+        }
+        // subsequent envelope - increment window id
+        const currentId = this.windowIds.get(flowId);
+        const nextId = currentId + 1;
+        this.windowIds.set(flowId, nextId);
+        return [nextId, FlowFlags.NONE];
+    }
+}
+//# sourceMappingURL=flow-controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-controller.js","sourceRoot":"","sources":["../../../../../../src/naylence/fame/channel/flow-controller.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/naylence/fame/channel/in-memory/in-memory-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-binding.js","sourceRoot":"","sources":["../../../../../../../src/naylence/fame/channel/in-memory/in-memory-binding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,wBAAwB,GAEzB,MAAM,wBAAwB,CAAC;AAUhC;;;GAGG;AACH,MAAM,OAAO,eAAe;IAI1B,YACE,OAA6B,EAC7B,SAAgC,EAAE;QAElC,kDAAkD;QAClD,IAAI,CAAC,OAAO;YACV,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAEnE,2CAA2C;QAC3C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,OAAe,EACf,SAAgC,EAAE;QAElC,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,OAA6B,EAC7B,OAAiC;QAEjC,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,2BAA2B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,IAAI,CAAC,OAAO,GAAG,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,QAAQ;QAIN,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;YAChC,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;gBACjC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;aAChC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/esm/src/naylence/fame/channel/in-memory/in-memory-channel.js

@@ -0,0 +1,176 @@
+/**
+ * in-memory-channel.ts - In-memory ReadWriteChannel implementation.
+ *
+ * Maintains an in-memory queue for async read/write operations with optional
+ * size limits and operation timeouts.
+ */
+import { TaskTimeoutError } from '../../util/task-types.js';
+import { getLogger } from '../../util/logging.js';
+/**
+ * In-memory implementation of ReadWriteChannel using a Promise-based queue.
+ * This is the TypeScript equivalent of Python's asyncio.Queue-based implementation.
+ */
+export class InMemoryReadWriteChannel {
+    constructor(config = {}) {
+        this._queue = [];
+        this._waitingReaders = [];
+        this._closed = false;
+        this.logger = getLogger('naylence.fame.channel.in_memory.in_memory_channel');
+        const legacyMaxSize = config.maxsize;
+        const configuredMaxSize = typeof config.maxSize === 'number' ? config.maxSize : legacyMaxSize;
+        this._maxSize = configuredMaxSize || 0; // 0 = unlimited
+        this._defaultTimeoutMs = config.defaultTimeoutMs || 0; // 0 = no timeout
+    }
+    /**
+     * Receive a message from the channel.
+     * Returns a promise that resolves when a message is available.
+     * This implements the ReadChannel.receive method.
+     */
+    async receive(timeout) {
+        if (this._closed) {
+            throw new Error('Channel is closed');
+        }
+        // If there's a message in the queue, return it immediately
+        if (this._queue.length > 0) {
+            const message = this._queue.shift();
+            this.logger.debug('receive_returning_buffered_message', {
+                queue_length: this._queue.length,
+                waiting_readers: this._waitingReaders.length,
+            });
+            return message;
+        }
+        // No message available, wait for one
+        return new Promise((resolve, reject) => {
+            const waiter = { resolve, reject };
+            // Set up timeout if specified
+            const timeoutMs = timeout ?? this._defaultTimeoutMs;
+            if (timeoutMs > 0) {
+                waiter.timeoutId = setTimeout(() => {
+                    // Remove this waiter from the list
+                    const index = this._waitingReaders.indexOf(waiter);
+                    if (index !== -1) {
+                        this._waitingReaders.splice(index, 1);
+                    }
+                    reject(new TaskTimeoutError('Channel receive operation', timeoutMs));
+                }, timeoutMs);
+            }
+            this._waitingReaders.push(waiter);
+            // this.logger.debug("receive_waiting_for_message", {
+            //   queue_length: this._queue.length,
+            //   waiting_readers: this._waitingReaders.length,
+            //   timeout_ms: timeoutMs,
+            // });
+        });
+    }
+    /**
+     * Acknowledge a received message by its ID.
+     * This implements the ReadChannel.acknowledge method.
+     * For in-memory channels, this is typically a no-op.
+     */
+    async acknowledge(_messageId) {
+        // In-memory channels don't need acknowledgment tracking
+        // This is a no-op but satisfies the interface requirement
+        if (this._closed) {
+            throw new Error('Channel is closed');
+        }
+        // No-op - acknowledgment is not meaningful for in-memory channels
+    }
+    /**
+     * Send a message to the channel.
+     * If there are waiting readers, delivers directly to the first one.
+     * Otherwise, adds to the queue (if there's space).
+     * This implements the WriteChannel.send method.
+     */
+    async send(message) {
+        if (this._closed) {
+            throw new Error('Channel is closed');
+        }
+        // If there are waiting readers, deliver directly to the first one
+        if (this._waitingReaders.length > 0) {
+            const waiter = this._waitingReaders.shift();
+            if (waiter.timeoutId) {
+                clearTimeout(waiter.timeoutId);
+            }
+            this.logger.debug('send_delivering_to_waiter', {
+                queue_length: this._queue.length,
+                waiting_readers: this._waitingReaders.length,
+            });
+            waiter.resolve(message);
+            return;
+        }
+        // No waiting readers, add to queue if there's space
+        if (this._maxSize === 0 || this._queue.length < this._maxSize) {
+            this._queue.push(message);
+            this.logger.debug('send_enqueued_message', {
+                queue_length: this._queue.length,
+                waiting_readers: this._waitingReaders.length,
+                max_size: this._maxSize,
+            });
+            return;
+        }
+        // Queue is full - in Python implementation, this would block
+        // For simplicity in this TypeScript version, we'll reject immediately
+        // In a full implementation, we'd want to wait for space to become available
+        this.logger.error('send_queue_full', {
+            queue_length: this._queue.length,
+            max_size: this._maxSize,
+        });
+        throw new Error(`Channel queue is full (maxSize: ${this._maxSize})`);
+    }
+    /**
+     * Close the channel. All pending reads will be rejected.
+     * Future read/write operations will throw an error.
+     */
+    async close() {
+        if (this._closed) {
+            return;
+        }
+        this._closed = true;
+        // Reject all waiting readers
+        const error = new Error('Channel is closed');
+        for (const waiter of this._waitingReaders) {
+            if (waiter.timeoutId) {
+                clearTimeout(waiter.timeoutId);
+            }
+            waiter.reject(error);
+        }
+        this.logger.debug('channel_closed', {
+            discarded_waiters: this._waitingReaders.length,
+            discarded_messages: this._queue.length,
+        });
+        this._waitingReaders.length = 0;
+        // Clear the queue
+        this._queue.length = 0;
+    }
+    /**
+     * Check if the channel is closed
+     */
+    get isClosed() {
+        return this._closed;
+    }
+    /**
+     * Get the current queue size
+     */
+    get queueSize() {
+        return this._queue.length;
+    }
+    /**
+     * Get the number of waiting readers
+     */
+    get waitingReaders() {
+        return this._waitingReaders.length;
+    }
+    /**
+     * Check if the queue is full
+     */
+    get isFull() {
+        return this._maxSize > 0 && this._queue.length >= this._maxSize;
+    }
+    /**
+     * Check if the queue is empty
+     */
+    get isEmpty() {
+        return this._queue.length === 0;
+    }
+}
+//# sourceMappingURL=in-memory-channel.js.map

package/dist/esm/src/naylence/fame/channel/in-memory/in-memory-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-channel.js","sourceRoot":"","sources":["../../../../../../../src/naylence/fame/channel/in-memory/in-memory-channel.ts"],"names":[],"mappings":"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"}