@aster-rpc/aster 0.1.2

package/dist/status.js

@@ -0,0 +1,206 @@
+/**
+ * Aster RPC status codes and error hierarchy.
+ *
+ * Spec reference: S6.5 (status codes).
+ *
+ * Codes 0-16 mirror gRPC's google.rpc.Code semantically. Codes 100+
+ * are Aster-native and have no gRPC equivalent. The 17-99 range is
+ * reserved as a buffer in case gRPC ever extends its enum.
+ *
+ * A common gripe with gRPC's status codes is that there are too few
+ * to express the variety of failures real services actually hit.
+ * The 100+ space gives Aster room to mint more precise codes over
+ * time, signalling clearly that they are intentionally separate
+ * from the gRPC vocabulary.
+ */
+export const StatusCode = {
+    // gRPC-mirrored codes (0-16)
+    OK: 0,
+    CANCELLED: 1,
+    UNKNOWN: 2,
+    INVALID_ARGUMENT: 3,
+    DEADLINE_EXCEEDED: 4,
+    NOT_FOUND: 5,
+    ALREADY_EXISTS: 6,
+    PERMISSION_DENIED: 7,
+    RESOURCE_EXHAUSTED: 8,
+    FAILED_PRECONDITION: 9,
+    ABORTED: 10,
+    OUT_OF_RANGE: 11,
+    UNIMPLEMENTED: 12,
+    INTERNAL: 13,
+    UNAVAILABLE: 14,
+    DATA_LOSS: 15,
+    UNAUTHENTICATED: 16,
+    // 17-99 reserved (gRPC extension buffer)
+    // Aster-native codes (100+)
+    /**
+     * The wire payload doesn't match the published contract: e.g. the
+     * JSON dict has fields the receiver's @WireType class doesn't
+     * declare, or vice versa. Distinct from INVALID_ARGUMENT because
+     * the violation is about data SHAPE, not value, and shape
+     * violations can occur at any nesting depth (a top-level
+     * INVALID_ARGUMENT label doesn't apply when the bad field is two
+     * objects deep). The producer owns the contract; consumers must
+     * use the field names defined by the producer's manifest.
+     */
+    CONTRACT_VIOLATION: 101,
+};
+/** Human-readable name for a status code. */
+const STATUS_NAMES = {
+    0: 'OK', 1: 'CANCELLED', 2: 'UNKNOWN', 3: 'INVALID_ARGUMENT',
+    4: 'DEADLINE_EXCEEDED', 5: 'NOT_FOUND', 6: 'ALREADY_EXISTS',
+    7: 'PERMISSION_DENIED', 8: 'RESOURCE_EXHAUSTED', 9: 'FAILED_PRECONDITION',
+    10: 'ABORTED', 11: 'OUT_OF_RANGE', 12: 'UNIMPLEMENTED', 13: 'INTERNAL',
+    14: 'UNAVAILABLE', 15: 'DATA_LOSS', 16: 'UNAUTHENTICATED',
+    101: 'CONTRACT_VIOLATION',
+};
+export function statusName(code) {
+    return STATUS_NAMES[code] ?? `UNKNOWN(${code})`;
+}
+/** Base error class for Aster RPC errors. */
+export class RpcError extends Error {
+    code;
+    details;
+    constructor(code, message = '', details) {
+        super(`[${statusName(code)}] ${message}`);
+        this.name = 'RpcError';
+        this.code = code;
+        this.details = details ?? {};
+    }
+    /** Create the most specific RpcError subclass for a status code. */
+    static fromStatus(code, message = '', details) {
+        const ErrorClass = RPC_ERROR_TYPES.get(code);
+        if (ErrorClass)
+            return new ErrorClass(message, details);
+        return new RpcError(code, message, details);
+    }
+}
+export class CancelledError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.CANCELLED, message, details);
+        this.name = 'CancelledError';
+    }
+}
+export class UnknownRpcError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.UNKNOWN, message, details);
+        this.name = 'UnknownRpcError';
+    }
+}
+export class InvalidArgumentError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.INVALID_ARGUMENT, message, details);
+        this.name = 'InvalidArgumentError';
+    }
+}
+export class DeadlineExceededError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.DEADLINE_EXCEEDED, message, details);
+        this.name = 'DeadlineExceededError';
+    }
+}
+export class NotFoundError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.NOT_FOUND, message, details);
+        this.name = 'NotFoundError';
+    }
+}
+export class AlreadyExistsError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.ALREADY_EXISTS, message, details);
+        this.name = 'AlreadyExistsError';
+    }
+}
+export class PermissionDeniedError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.PERMISSION_DENIED, message, details);
+        this.name = 'PermissionDeniedError';
+    }
+}
+export class ResourceExhaustedError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.RESOURCE_EXHAUSTED, message, details);
+        this.name = 'ResourceExhaustedError';
+    }
+}
+export class FailedPreconditionError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.FAILED_PRECONDITION, message, details);
+        this.name = 'FailedPreconditionError';
+    }
+}
+export class AbortedError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.ABORTED, message, details);
+        this.name = 'AbortedError';
+    }
+}
+export class OutOfRangeError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.OUT_OF_RANGE, message, details);
+        this.name = 'OutOfRangeError';
+    }
+}
+export class UnimplementedError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.UNIMPLEMENTED, message, details);
+        this.name = 'UnimplementedError';
+    }
+}
+export class InternalError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.INTERNAL, message, details);
+        this.name = 'InternalError';
+    }
+}
+export class UnavailableError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.UNAVAILABLE, message, details);
+        this.name = 'UnavailableError';
+    }
+}
+export class DataLossError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.DATA_LOSS, message, details);
+        this.name = 'DataLossError';
+    }
+}
+export class UnauthenticatedError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.UNAUTHENTICATED, message, details);
+        this.name = 'UnauthenticatedError';
+    }
+}
+/**
+ * Raised when the wire payload doesn't match the published contract.
+ *
+ * Carries the offending field names in `details.unexpected_fields`
+ * (comma-separated, repr-sanitized).
+ */
+export class ContractViolationError extends RpcError {
+    constructor(message = '', details) {
+        super(StatusCode.CONTRACT_VIOLATION, message, details);
+        this.name = 'ContractViolationError';
+    }
+}
+const RPC_ERROR_TYPES = new Map([
+    [StatusCode.CANCELLED, CancelledError],
+    [StatusCode.UNKNOWN, UnknownRpcError],
+    [StatusCode.INVALID_ARGUMENT, InvalidArgumentError],
+    [StatusCode.DEADLINE_EXCEEDED, DeadlineExceededError],
+    [StatusCode.NOT_FOUND, NotFoundError],
+    [StatusCode.ALREADY_EXISTS, AlreadyExistsError],
+    [StatusCode.PERMISSION_DENIED, PermissionDeniedError],
+    [StatusCode.RESOURCE_EXHAUSTED, ResourceExhaustedError],
+    [StatusCode.FAILED_PRECONDITION, FailedPreconditionError],
+    [StatusCode.ABORTED, AbortedError],
+    [StatusCode.OUT_OF_RANGE, OutOfRangeError],
+    [StatusCode.UNIMPLEMENTED, UnimplementedError],
+    [StatusCode.INTERNAL, InternalError],
+    [StatusCode.UNAVAILABLE, UnavailableError],
+    [StatusCode.DATA_LOSS, DataLossError],
+    [StatusCode.UNAUTHENTICATED, UnauthenticatedError],
+    [StatusCode.CONTRACT_VIOLATION, ContractViolationError],
+]);
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/transport/base.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Transport interface and BidiChannel.
+ *
+ * The Transport interface is the abstraction point for different backends:
+ * - IrohTransport: NAPI-RS, direct QUIC (Phase 4)
+ * - LocalTransport: in-process, for testing (Phase 3)
+ * - IrohWasmTransport: wasm-bindgen, relay-only (future Phase 8)
+ */
+import type { StatusCode } from '../status.js';
+/** Options for a single RPC call. */
+export interface CallOptions {
+    metadata?: Record<string, string>;
+    deadlineEpochMs?: number;
+    serializationMode?: number;
+    callId?: string;
+}
+/**
+ * Aster RPC transport — the wire-level interface that all transports implement.
+ *
+ * The server and client layers use this interface to send/receive RPC calls.
+ * The transport handles framing, stream management, and serialization.
+ */
+export interface AsterTransport {
+    /** Perform a unary RPC call. */
+    unary(service: string, method: string, request: unknown, opts?: CallOptions): Promise<unknown>;
+    /** Initiate a server-streaming call. Returns an async iterable of responses. */
+    serverStream(service: string, method: string, request: unknown, opts?: CallOptions): AsyncIterable<unknown>;
+    /** Perform a client-streaming call. Sends items, returns single response. */
+    clientStream(service: string, method: string, requests: AsyncIterable<unknown>, opts?: CallOptions): Promise<unknown>;
+    /** Initiate a bidirectional-streaming call. */
+    bidiStream(service: string, method: string, opts?: CallOptions): BidiChannel;
+    /** Close the transport. */
+    close(): Promise<void>;
+}
+/** Bidirectional streaming channel. */
+export interface BidiChannel {
+    /** Send a message on the channel. */
+    send(msg: unknown): Promise<void>;
+    /** Receive messages as an async iterable. */
+    [Symbol.asyncIterator](): AsyncIterator<unknown>;
+    /** Close the sending side. */
+    close(): Promise<void>;
+    /** Wait for the trailing status frame. */
+    waitForTrailer(): Promise<[code: StatusCode, message: string]>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/transport/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/transport/base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,KAAK,CACH,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,gFAAgF;IAChF,YAAY,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,aAAa,CAAC,OAAO,CAAC,CAAC;IAE1B,6EAA6E;IAC7E,YAAY,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,+CAA+C;IAC/C,UAAU,CACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,WAAW,GACjB,WAAW,CAAC;IAEf,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,6CAA6C;IAC7C,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAEjD,8BAA8B;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,0CAA0C;IAC1C,cAAc,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE"}

package/dist/transport/base.js

@@ -0,0 +1,10 @@
+/**
+ * Transport interface and BidiChannel.
+ *
+ * The Transport interface is the abstraction point for different backends:
+ * - IrohTransport: NAPI-RS, direct QUIC (Phase 4)
+ * - LocalTransport: in-process, for testing (Phase 3)
+ * - IrohWasmTransport: wasm-bindgen, relay-only (future Phase 8)
+ */
+export {};
+//# sourceMappingURL=base.js.map

package/dist/transport/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/transport/base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/transport/iroh.d.ts

@@ -0,0 +1,45 @@
+/**
+ * IrohTransport — Transport implementation over real QUIC streams.
+ *
+ * Each RPC call opens a bidirectional QUIC stream, sends the StreamHeader
+ * frame, then performs the appropriate read/write sequence for the pattern.
+ *
+ * Requires NAPI-RS native bindings (@aster-rpc/transport).
+ */
+import type { Codec } from '../codec.js';
+import type { AsterTransport, CallOptions } from './base.js';
+import type { BidiChannel } from './base.js';
+/** QUIC connection interface (matches NAPI IrohConnection). */
+interface QuicConnection {
+    openBi(): Promise<{
+        takeSend(): QuicSendStream;
+        takeRecv(): QuicRecvStream;
+    }>;
+    close(code: number, reason: string): void;
+}
+/** QUIC send stream interface (matches NAPI IrohSendStream). */
+interface QuicSendStream {
+    writeAll(data: Uint8Array): Promise<void>;
+    finish(): Promise<void>;
+}
+/** QUIC recv stream interface (matches NAPI IrohRecvStream). */
+interface QuicRecvStream {
+    readExact(n: number): Promise<Uint8Array>;
+}
+/**
+ * Transport implementation using Iroh QUIC streams.
+ */
+export declare class IrohTransport implements AsterTransport {
+    private conn;
+    private codec;
+    constructor(connection: QuicConnection, codec?: Codec);
+    unary(service: string, method: string, request: unknown, opts?: CallOptions): Promise<unknown>;
+    serverStream(service: string, method: string, request: unknown, opts?: CallOptions): AsyncIterable<unknown>;
+    clientStream(service: string, method: string, requests: AsyncIterable<unknown>, opts?: CallOptions): Promise<unknown>;
+    bidiStream(service: string, method: string, opts?: CallOptions): BidiChannel;
+    close(): Promise<void>;
+    private writeHeader;
+    private checkTrailer;
+}
+export {};
+//# sourceMappingURL=iroh.d.ts.map

package/dist/transport/iroh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iroh.d.ts","sourceRoot":"","sources":["../../src/transport/iroh.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAWzC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,+DAA+D;AAC/D,UAAU,cAAc;IACtB,MAAM,IAAI,OAAO,CAAC;QAAE,QAAQ,IAAI,cAAc,CAAC;QAAC,QAAQ,IAAI,cAAc,CAAA;KAAE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,gEAAgE;AAChE,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,gEAAgE;AAChE,UAAU,cAAc;IACtB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3C;AAQD;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,KAAK,CAAQ;gBAET,UAAU,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK;IAK/C,KAAK,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC;IAmCZ,YAAY,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,aAAa,CAAC,OAAO,CAAC;IA6BnB,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC;IAmCnB,UAAU,CACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,WAAW,GACjB,WAAW;IAuER,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,WAAW;IAqBzB,OAAO,CAAC,YAAY;CAWrB"}

package/dist/transport/iroh.js

@@ -0,0 +1,225 @@
+/**
+ * IrohTransport — Transport implementation over real QUIC streams.
+ *
+ * Each RPC call opens a bidirectional QUIC stream, sends the StreamHeader
+ * frame, then performs the appropriate read/write sequence for the pattern.
+ *
+ * Requires NAPI-RS native bindings (@aster-rpc/transport).
+ */
+import { JsonCodec } from '../codec.js';
+import { writeFrame, readFrame, HEADER, TRAILER, COMPRESSED, } from '../framing.js';
+import { StreamHeader } from '../protocol.js';
+import { StatusCode, RpcError } from '../status.js';
+function buildMetadata(metadata) {
+    if (!metadata || Object.keys(metadata).length === 0)
+        return [[], []];
+    const keys = Object.keys(metadata);
+    return [keys, keys.map(k => metadata[k])];
+}
+/**
+ * Transport implementation using Iroh QUIC streams.
+ */
+export class IrohTransport {
+    conn;
+    codec;
+    constructor(connection, codec) {
+        this.conn = connection;
+        this.codec = codec ?? new JsonCodec();
+    }
+    async unary(service, method, request, opts) {
+        const bi = await this.conn.openBi();
+        const send = bi.takeSend();
+        const recv = bi.takeRecv();
+        try {
+            // Write StreamHeader
+            await this.writeHeader(send, service, method, opts);
+            // Write request
+            const [payload, compressed] = this.codec.encodeCompressed(request);
+            await writeFrame(send, payload, compressed ? COMPRESSED : 0);
+            await send.finish();
+            // Read response frames
+            let response = undefined;
+            while (true) {
+                const frame = await readFrame(recv, 0);
+                if (!frame)
+                    throw new RpcError(StatusCode.UNAVAILABLE, 'stream ended before response');
+                const [data, flags] = frame;
+                if (flags & TRAILER) {
+                    this.checkTrailer(data);
+                    break;
+                }
+                response = this.codec.decode(data);
+            }
+            return response;
+        }
+        catch (e) {
+            throw mapTransportError(e);
+        }
+    }
+    async *serverStream(service, method, request, opts) {
+        const bi = await this.conn.openBi();
+        const send = bi.takeSend();
+        const recv = bi.takeRecv();
+        try {
+            await this.writeHeader(send, service, method, opts);
+            const [payload, compressed] = this.codec.encodeCompressed(request);
+            await writeFrame(send, payload, compressed ? COMPRESSED : 0);
+            await send.finish();
+            while (true) {
+                const frame = await readFrame(recv, 0);
+                if (!frame)
+                    throw new RpcError(StatusCode.UNAVAILABLE, 'stream ended before trailer');
+                const [data, flags] = frame;
+                if (flags & TRAILER) {
+                    this.checkTrailer(data);
+                    break;
+                }
+                yield this.codec.decode(data);
+            }
+        }
+        catch (e) {
+            throw mapTransportError(e);
+        }
+    }
+    async clientStream(service, method, requests, opts) {
+        const bi = await this.conn.openBi();
+        const send = bi.takeSend();
+        const recv = bi.takeRecv();
+        try {
+            await this.writeHeader(send, service, method, opts);
+            for await (const req of requests) {
+                const [payload, compressed] = this.codec.encodeCompressed(req);
+                await writeFrame(send, payload, compressed ? COMPRESSED : 0);
+            }
+            await send.finish();
+            // Read single response + trailer
+            let response = undefined;
+            while (true) {
+                const frame = await readFrame(recv, 0);
+                if (!frame)
+                    throw new RpcError(StatusCode.UNAVAILABLE, 'stream ended before response');
+                const [data, flags] = frame;
+                if (flags & TRAILER) {
+                    this.checkTrailer(data);
+                    break;
+                }
+                response = this.codec.decode(data);
+            }
+            return response;
+        }
+        catch (e) {
+            throw mapTransportError(e);
+        }
+    }
+    bidiStream(service, method, opts) {
+        const codec = this.codec;
+        const conn = this.conn;
+        const writeHeader = this.writeHeader.bind(this);
+        const checkTrailer = this.checkTrailer.bind(this);
+        // Open the stream eagerly but return a channel object
+        let sendStream;
+        let recvStream;
+        let streamReady;
+        let receiveDone = false;
+        streamReady = (async () => {
+            const bi = await conn.openBi();
+            sendStream = bi.takeSend();
+            recvStream = bi.takeRecv();
+            await writeHeader(sendStream, service, method, opts);
+        })();
+        const channel = {
+            async send(msg) {
+                await streamReady;
+                const [payload, compressed] = codec.encodeCompressed(msg);
+                await writeFrame(sendStream, payload, compressed ? COMPRESSED : 0);
+            },
+            async *[Symbol.asyncIterator]() {
+                await streamReady;
+                while (!receiveDone) {
+                    try {
+                        const frame = await readFrame(recvStream, 0);
+                        if (!frame) {
+                            receiveDone = true;
+                            return;
+                        }
+                        const [data, flags] = frame;
+                        if (flags & TRAILER) {
+                            checkTrailer(data);
+                            receiveDone = true;
+                            return;
+                        }
+                        yield codec.decode(data);
+                    }
+                    catch (e) {
+                        receiveDone = true;
+                        throw mapTransportError(e);
+                    }
+                }
+            },
+            async close() {
+                await streamReady;
+                await sendStream.finish();
+            },
+            async waitForTrailer() {
+                await streamReady;
+                // Drain remaining frames until trailer
+                while (!receiveDone) {
+                    const frame = await readFrame(recvStream, 0);
+                    if (!frame)
+                        return [StatusCode.OK, ''];
+                    const [data, flags] = frame;
+                    if (flags & TRAILER) {
+                        if (data.length === 0)
+                            return [StatusCode.OK, ''];
+                        const status = codec.decode(data);
+                        return [status.code, status.message];
+                    }
+                }
+                return [StatusCode.OK, ''];
+            },
+        };
+        return channel;
+    }
+    async close() {
+        this.conn.close(0, 'normal close');
+    }
+    // -- Helpers ----------------------------------------------------------------
+    async writeHeader(send, service, method, opts) {
+        const [keys, values] = buildMetadata(opts?.metadata);
+        const header = new StreamHeader({
+            service,
+            method,
+            version: 1,
+            callId: opts?.callId ?? crypto.randomUUID(),
+            deadlineEpochMs: opts?.deadlineEpochMs ?? 0,
+            serializationMode: opts?.serializationMode ?? (this.codec instanceof JsonCodec ? 3 : 0),
+            metadataKeys: keys,
+            metadataValues: values,
+        });
+        const headerBytes = this.codec.encode(header);
+        await writeFrame(send, headerBytes, HEADER);
+    }
+    checkTrailer(data) {
+        if (data.length === 0)
+            return; // empty trailer = OK
+        const status = this.codec.decode(data);
+        if (status.code !== StatusCode.OK) {
+            throw RpcError.fromStatus(status.code, status.message, status.details);
+        }
+    }
+}
+const RESET_KEYWORDS = ['reset', 'connection closed', 'connection lost'];
+function mapTransportError(e) {
+    if (e instanceof RpcError)
+        return e;
+    if (e instanceof Error) {
+        const msg = e.message.toLowerCase();
+        if (RESET_KEYWORDS.some(kw => msg.includes(kw))) {
+            return new RpcError(StatusCode.UNAVAILABLE, `stream reset: ${e.message}`);
+        }
+    }
+    if (e instanceof Error)
+        return new RpcError(StatusCode.UNKNOWN, e.message);
+    return new RpcError(StatusCode.UNKNOWN, String(e));
+}
+//# sourceMappingURL=iroh.js.map

package/dist/transport/iroh.js.map

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

package/dist/transport/local.d.ts

@@ -0,0 +1,48 @@
+/**
+ * LocalTransport — in-process transport for testing.
+ *
+ * Executes RPC calls directly against a ServiceRegistry without
+ * network I/O or serialization. Useful for unit testing service logic.
+ */
+import type { ServiceRegistry } from '../service.js';
+import type { AsterTransport, CallOptions, BidiChannel } from './base.js';
+/**
+ * In-memory receive stream for testing.
+ * Wraps a pre-filled buffer and exposes a read() interface.
+ */
+export declare class MemRecvStream {
+    private data;
+    private pos;
+    constructor(data: Uint8Array);
+    /**
+     * Read up to n bytes. Returns null at EOF.
+     */
+    read(n: number): Uint8Array | null;
+    readExact(n: number): Promise<Uint8Array>;
+}
+/**
+ * In-process transport that dispatches directly to registered services.
+ *
+ * @example
+ * ```ts
+ * const registry = new ServiceRegistry();
+ * registry.register(new EchoService());
+ * const transport = new LocalTransport(registry);
+ *
+ * const result = await transport.unary("Echo", "echo", { message: "hi" });
+ * ```
+ */
+export declare class LocalTransport implements AsterTransport {
+    private registry;
+    constructor(registry: ServiceRegistry);
+    unary(service: string, method: string, request: unknown, _opts?: CallOptions): Promise<unknown>;
+    serverStream(service: string, method: string, request: unknown, _opts?: CallOptions): AsyncIterable<unknown>;
+    clientStream(service: string, method: string, requests: AsyncIterable<unknown>, _opts?: CallOptions): Promise<unknown>;
+    bidiStream(service: string, method: string, _opts?: CallOptions): BidiChannel;
+    close(): Promise<void>;
+    /** The remote endpoint ID (always 'local' for in-process transport). */
+    get remoteId(): string;
+    private resolve;
+    private assertPattern;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/transport/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/transport/local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1E;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,GAAG,CAAK;gBAEJ,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAO5B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAMhD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,QAAQ,EAAE,eAAe;IAI/B,KAAK,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC;IAOZ,YAAY,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,WAAW,GAClB,aAAa,CAAC,OAAO,CAAC;IAQnB,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC;IAOnB,UAAU,CACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,WAAW,GAClB,WAAW;IAwDR,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,wEAAwE;IACxE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,aAAa;CAQtB"}