@procwire/transport 1.0.0

package/dist/channel/builder.d.ts

@@ -0,0 +1,68 @@
+import type { Transport } from "../transport/types.js";
+import type { FramingCodec } from "../framing/types.js";
+import type { SerializationCodec } from "../serialization/types.js";
+import type { Protocol } from "../protocol/types.js";
+import type { ResponseAccessor, ChannelMiddleware, Channel } from "./types.js";
+/**
+ * Fluent API builder for creating channels.
+ * Provides ergonomic configuration with validation.
+ *
+ * @example
+ * ```ts
+ * const channel = new ChannelBuilder()
+ *   .withTransport(transport)
+ *   .withFraming(new LineDelimitedFraming())
+ *   .withSerialization(new JsonCodec())
+ *   .withProtocol(new JsonRpcProtocol())
+ *   .withTimeout(5000)
+ *   .build();
+ * ```
+ */
+export declare class ChannelBuilder<TReq = unknown, TRes = unknown, TNotif = unknown> {
+    private transport?;
+    private framing?;
+    private serialization?;
+    private protocol?;
+    private timeout?;
+    private responseAccessor?;
+    private middleware;
+    private maxInboundFrames?;
+    /**
+     * Sets the transport layer.
+     */
+    withTransport(transport: Transport): this;
+    /**
+     * Sets the framing codec.
+     */
+    withFraming(framing: FramingCodec): this;
+    /**
+     * Sets the serialization codec.
+     */
+    withSerialization(serialization: SerializationCodec): this;
+    /**
+     * Sets the protocol layer.
+     */
+    withProtocol<R, S, N>(protocol: Protocol<R, S, N>): ChannelBuilder<R, S, N>;
+    /**
+     * Sets the default request timeout in milliseconds.
+     */
+    withTimeout(timeoutMs: number): this;
+    /**
+     * Sets the response accessor for interpreting response messages.
+     */
+    withResponseAccessor(accessor: ResponseAccessor): this;
+    /**
+     * Adds middleware to the channel.
+     */
+    withMiddleware(middleware: ChannelMiddleware): this;
+    /**
+     * Sets the maximum inbound frames limit.
+     */
+    withMaxInboundFrames(max: number): this;
+    /**
+     * Builds and returns the configured channel.
+     * @throws {Error} if required configuration is missing
+     */
+    build(): Channel<TReq, TRes, TNotif>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/channel/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/channel/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,EAAkB,MAAM,YAAY,CAAC;AAG/F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IAC1E,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAA+B;IAChD,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAElC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKzC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAKxC;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE,kBAAkB,GAAG,IAAI;IAK1D;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAK3E;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAKtD;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAKnD;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKvC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC;CAoCrC"}

package/dist/channel/builder.js

@@ -0,0 +1,120 @@
+import { RequestChannel } from "./request-channel.js";
+/**
+ * Fluent API builder for creating channels.
+ * Provides ergonomic configuration with validation.
+ *
+ * @example
+ * ```ts
+ * const channel = new ChannelBuilder()
+ *   .withTransport(transport)
+ *   .withFraming(new LineDelimitedFraming())
+ *   .withSerialization(new JsonCodec())
+ *   .withProtocol(new JsonRpcProtocol())
+ *   .withTimeout(5000)
+ *   .build();
+ * ```
+ */
+export class ChannelBuilder {
+    transport;
+    framing;
+    serialization;
+    protocol;
+    timeout;
+    responseAccessor;
+    middleware = [];
+    maxInboundFrames;
+    /**
+     * Sets the transport layer.
+     */
+    withTransport(transport) {
+        this.transport = transport;
+        return this;
+    }
+    /**
+     * Sets the framing codec.
+     */
+    withFraming(framing) {
+        this.framing = framing;
+        return this;
+    }
+    /**
+     * Sets the serialization codec.
+     */
+    withSerialization(serialization) {
+        this.serialization = serialization;
+        return this;
+    }
+    /**
+     * Sets the protocol layer.
+     */
+    withProtocol(protocol) {
+        this.protocol = protocol;
+        return this;
+    }
+    /**
+     * Sets the default request timeout in milliseconds.
+     */
+    withTimeout(timeoutMs) {
+        this.timeout = timeoutMs;
+        return this;
+    }
+    /**
+     * Sets the response accessor for interpreting response messages.
+     */
+    withResponseAccessor(accessor) {
+        this.responseAccessor = accessor;
+        return this;
+    }
+    /**
+     * Adds middleware to the channel.
+     */
+    withMiddleware(middleware) {
+        this.middleware.push(middleware);
+        return this;
+    }
+    /**
+     * Sets the maximum inbound frames limit.
+     */
+    withMaxInboundFrames(max) {
+        this.maxInboundFrames = max;
+        return this;
+    }
+    /**
+     * Builds and returns the configured channel.
+     * @throws {Error} if required configuration is missing
+     */
+    build() {
+        if (!this.transport) {
+            throw new Error("ChannelBuilder: transport is required");
+        }
+        if (!this.framing) {
+            throw new Error("ChannelBuilder: framing is required");
+        }
+        if (!this.serialization) {
+            throw new Error("ChannelBuilder: serialization is required");
+        }
+        if (!this.protocol) {
+            throw new Error("ChannelBuilder: protocol is required");
+        }
+        const options = {
+            transport: this.transport,
+            framing: this.framing,
+            serialization: this.serialization,
+            protocol: this.protocol,
+        };
+        if (this.timeout !== undefined) {
+            options.timeout = this.timeout;
+        }
+        if (this.responseAccessor !== undefined) {
+            options.responseAccessor = this.responseAccessor;
+        }
+        if (this.middleware.length > 0) {
+            options.middleware = this.middleware;
+        }
+        if (this.maxInboundFrames !== undefined) {
+            options.maxInboundFrames = this.maxInboundFrames;
+        }
+        return new RequestChannel(options);
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/channel/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/channel/builder.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IACjB,SAAS,CAAa;IACtB,OAAO,CAAgB;IACvB,aAAa,CAAsB;IACnC,QAAQ,CAAgC;IACxC,OAAO,CAAU;IACjB,gBAAgB,CAAoB;IACpC,UAAU,GAAwB,EAAE,CAAC;IACrC,gBAAgB,CAAU;IAElC;;OAEG;IACH,aAAa,CAAC,SAAoB;QAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,aAAiC;QACjD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CAAU,QAA2B;QAC9C,IAA2C,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjE,OAAO,IAA0C,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAiB;QAC3B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,QAA0B;QAC7C,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,UAA6B;QAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,GAAW;QAC9B,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAuC;YAClD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,cAAc,CAAqB,OAAO,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/channel/index.d.ts

@@ -0,0 +1,6 @@
+export type { Channel, ChannelEvents, ChannelOptions, ChannelServer, ChannelServerOptions, RequestHandler, NotificationHandler, ResponseAccessor, ChannelMiddleware, } from "./types.js";
+export { RequestChannel, JsonRpcResponseAccessor, SimpleResponseAccessor } from "./request-channel.js";
+export { ChannelBuilder } from "./builder.js";
+export { createStdioChannel, createPipeChannel } from "./quickstart.js";
+export type { StdioChannelOptions, PipeChannelOptions } from "./quickstart.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/channel/index.js

@@ -0,0 +1,6 @@
+// Implementations
+export { RequestChannel, JsonRpcResponseAccessor, SimpleResponseAccessor } from "./request-channel.js";
+export { ChannelBuilder } from "./builder.js";
+// Quick start helpers
+export { createStdioChannel, createPipeChannel } from "./quickstart.js";
+//# sourceMappingURL=index.js.map

package/dist/channel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAaA,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/channel/quickstart.d.ts

@@ -0,0 +1,94 @@
+import type { Channel } from "./types.js";
+import type { StdioTransportOptions } from "../transport/stdio-transport.js";
+import type { SocketTransportOptions } from "../transport/socket-transport.js";
+/**
+ * Options for stdio channel creation.
+ */
+export interface StdioChannelOptions extends Omit<StdioTransportOptions, "executablePath"> {
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+}
+/**
+ * Options for pipe channel creation.
+ */
+export interface PipeChannelOptions extends Omit<SocketTransportOptions, "path"> {
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Use line-delimited framing instead of length-prefixed.
+     * @default false (uses length-prefixed)
+     */
+    useLineDelimited?: boolean;
+}
+/**
+ * Creates a ready-to-use stdio channel with sensible defaults.
+ *
+ * - Transport: StdioTransport (spawns child process)
+ * - Framing: LineDelimitedFraming (best for JSON-RPC over stdio)
+ * - Serialization: JsonCodec
+ * - Protocol: JsonRpcProtocol
+ *
+ * The channel is automatically started and ready to send/receive messages.
+ *
+ * @param executablePath - Path to executable to spawn
+ * @param options - Optional configuration
+ * @returns Started channel instance
+ *
+ * @example
+ * ```ts
+ * const channel = await createStdioChannel('node', {
+ *   args: ['worker.js'],
+ *   cwd: process.cwd(),
+ *   timeout: 5000
+ * });
+ *
+ * const result = await channel.request('calculate', { expr: '2+2' });
+ * console.log(result); // 4
+ *
+ * await channel.close();
+ * ```
+ */
+export declare function createStdioChannel(executablePath: string, options?: StdioChannelOptions): Promise<Channel>;
+/**
+ * Creates a ready-to-use pipe/socket channel with sensible defaults.
+ *
+ * - Transport: SocketTransport (connects to named pipe/unix socket)
+ * - Framing: LengthPrefixedFraming (best for binary/large data)
+ * - Serialization: JsonCodec
+ * - Protocol: JsonRpcProtocol
+ *
+ * Platform-specific paths:
+ * - Windows: `\\\\.\\pipe\\my-pipe`
+ * - Unix: `/tmp/my-socket.sock`
+ *
+ * The channel is automatically started and ready to send/receive messages.
+ *
+ * @param path - Pipe/socket path
+ * @param options - Optional configuration
+ * @returns Started channel instance
+ *
+ * @example
+ * ```ts
+ * const path = isWindows()
+ *   ? '\\\\.\\pipe\\my-app'
+ *   : '/tmp/my-app.sock';
+ *
+ * const channel = await createPipeChannel(path, {
+ *   connectionTimeout: 5000,
+ *   timeout: 10000
+ * });
+ *
+ * const result = await channel.request('getStatus');
+ * console.log(result);
+ *
+ * await channel.close();
+ * ```
+ */
+export declare function createPipeChannel(path: string, options?: PipeChannelOptions): Promise<Channel>;
+//# sourceMappingURL=quickstart.d.ts.map

package/dist/channel/quickstart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../src/channel/quickstart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAQ/E;;GAEG;AACH,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;IACrD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAC9E;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAuBlB"}

package/dist/channel/quickstart.js

@@ -0,0 +1,104 @@
+import { TransportFactory } from "../transport/factory.js";
+import { LineDelimitedFraming } from "../framing/line-delimited.js";
+import { LengthPrefixedFraming } from "../framing/length-prefixed.js";
+import { JsonCodec } from "../serialization/json.js";
+import { JsonRpcProtocol } from "../protocol/jsonrpc.js";
+import { ChannelBuilder } from "./builder.js";
+/**
+ * Creates a ready-to-use stdio channel with sensible defaults.
+ *
+ * - Transport: StdioTransport (spawns child process)
+ * - Framing: LineDelimitedFraming (best for JSON-RPC over stdio)
+ * - Serialization: JsonCodec
+ * - Protocol: JsonRpcProtocol
+ *
+ * The channel is automatically started and ready to send/receive messages.
+ *
+ * @param executablePath - Path to executable to spawn
+ * @param options - Optional configuration
+ * @returns Started channel instance
+ *
+ * @example
+ * ```ts
+ * const channel = await createStdioChannel('node', {
+ *   args: ['worker.js'],
+ *   cwd: process.cwd(),
+ *   timeout: 5000
+ * });
+ *
+ * const result = await channel.request('calculate', { expr: '2+2' });
+ * console.log(result); // 4
+ *
+ * await channel.close();
+ * ```
+ */
+export async function createStdioChannel(executablePath, options) {
+    const transport = TransportFactory.createStdio({
+        executablePath,
+        ...options,
+    });
+    const channel = new ChannelBuilder()
+        .withTransport(transport)
+        .withFraming(new LineDelimitedFraming())
+        .withSerialization(new JsonCodec())
+        .withProtocol(new JsonRpcProtocol())
+        .withTimeout(options?.timeout ?? 30000)
+        .build();
+    await channel.start();
+    return channel;
+}
+/**
+ * Creates a ready-to-use pipe/socket channel with sensible defaults.
+ *
+ * - Transport: SocketTransport (connects to named pipe/unix socket)
+ * - Framing: LengthPrefixedFraming (best for binary/large data)
+ * - Serialization: JsonCodec
+ * - Protocol: JsonRpcProtocol
+ *
+ * Platform-specific paths:
+ * - Windows: `\\\\.\\pipe\\my-pipe`
+ * - Unix: `/tmp/my-socket.sock`
+ *
+ * The channel is automatically started and ready to send/receive messages.
+ *
+ * @param path - Pipe/socket path
+ * @param options - Optional configuration
+ * @returns Started channel instance
+ *
+ * @example
+ * ```ts
+ * const path = isWindows()
+ *   ? '\\\\.\\pipe\\my-app'
+ *   : '/tmp/my-app.sock';
+ *
+ * const channel = await createPipeChannel(path, {
+ *   connectionTimeout: 5000,
+ *   timeout: 10000
+ * });
+ *
+ * const result = await channel.request('getStatus');
+ * console.log(result);
+ *
+ * await channel.close();
+ * ```
+ */
+export async function createPipeChannel(path, options) {
+    const transportOptions = { path };
+    if (options?.connectionTimeout !== undefined) {
+        transportOptions.connectionTimeout = options.connectionTimeout;
+    }
+    const transport = TransportFactory.createPipeClient(transportOptions);
+    const framing = options?.useLineDelimited
+        ? new LineDelimitedFraming()
+        : new LengthPrefixedFraming();
+    const channel = new ChannelBuilder()
+        .withTransport(transport)
+        .withFraming(framing)
+        .withSerialization(new JsonCodec())
+        .withProtocol(new JsonRpcProtocol())
+        .withTimeout(options?.timeout ?? 30000)
+        .build();
+    await channel.start();
+    return channel;
+}
+//# sourceMappingURL=quickstart.js.map

package/dist/channel/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../src/channel/quickstart.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA+B9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,cAAsB,EACtB,OAA6B;IAE7B,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC;QAC7C,cAAc;QACd,GAAG,OAAO;KACX,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE;SACjC,aAAa,CAAC,SAAS,CAAC;SACxB,WAAW,CAAC,IAAI,oBAAoB,EAAE,CAAC;SACvC,iBAAiB,CAAC,IAAI,SAAS,EAAE,CAAC;SAClC,YAAY,CAAC,IAAI,eAAe,EAAE,CAAC;SACnC,WAAW,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;SACtC,KAAK,EAAE,CAAC;IAEX,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAEtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAA4B;IAE5B,MAAM,gBAAgB,GAA2B,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,OAAO,EAAE,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC7C,gBAAgB,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACjE,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAEtE,MAAM,OAAO,GAAG,OAAO,EAAE,gBAAgB;QACvC,CAAC,CAAC,IAAI,oBAAoB,EAAE;QAC5B,CAAC,CAAC,IAAI,qBAAqB,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE;SACjC,aAAa,CAAC,SAAS,CAAC;SACxB,WAAW,CAAC,OAAO,CAAC;SACpB,iBAAiB,CAAC,IAAI,SAAS,EAAE,CAAC;SAClC,YAAY,CAAC,IAAI,eAAe,EAAE,CAAC;SACnC,WAAW,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;SACtC,KAAK,EAAE,CAAC;IAEX,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAEtB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/channel/request-channel.d.ts

@@ -0,0 +1,119 @@
+import type { RequestId, ProtocolDataError } from "../protocol/types.js";
+import type { Channel, ChannelEvents, ChannelOptions, RequestHandler, NotificationHandler, ResponseAccessor } from "./types.js";
+import type { Unsubscribe } from "../utils/disposables.js";
+/**
+ * JSON-RPC response accessor implementation.
+ */
+export declare class JsonRpcResponseAccessor implements ResponseAccessor {
+    getResponseId(message: unknown): RequestId | undefined;
+    isErrorResponse(message: unknown): boolean;
+    getResult(message: unknown): unknown;
+    getError(message: unknown): ProtocolDataError | unknown;
+}
+/**
+ * Simple protocol response accessor implementation.
+ */
+export declare class SimpleResponseAccessor implements ResponseAccessor {
+    getResponseId(message: unknown): RequestId | undefined;
+    isErrorResponse(message: unknown): boolean;
+    getResult(message: unknown): unknown;
+    getError(message: unknown): ProtocolDataError | unknown;
+}
+/**
+ * Request channel implementation.
+ * Combines Transport + Framing + Serialization + Protocol layers
+ * to provide high-level request/response and notification patterns.
+ *
+ * @template TReq - Request message type (wire format)
+ * @template TRes - Response message type (wire format)
+ * @template TNotif - Notification message type (wire format)
+ */
+export declare class RequestChannel<TReq = unknown, TRes = unknown, TNotif = unknown> implements Channel<TReq, TRes, TNotif> {
+    private readonly transport;
+    private readonly framing;
+    private readonly serialization;
+    private readonly protocol;
+    private readonly defaultTimeout;
+    private readonly responseAccessor;
+    private readonly middleware;
+    private readonly maxInboundFrames;
+    private readonly events;
+    private readonly pendingRequests;
+    private readonly requestHandlers;
+    private readonly notificationHandlers;
+    private transportDataUnsubscribe;
+    private transportErrorUnsubscribe;
+    private _isConnected;
+    private inboundFrameCount;
+    constructor(options: ChannelOptions<TReq, TRes, TNotif>);
+    get isConnected(): boolean;
+    /**
+     * Starts the channel (connects transport and begins message processing).
+     */
+    start(): Promise<void>;
+    /**
+     * Closes the channel gracefully.
+     */
+    close(): Promise<void>;
+    /**
+     * Sends a request and waits for response.
+     */
+    request(method: string, params?: unknown, timeout?: number): Promise<unknown>;
+    /**
+     * Sends a notification (fire-and-forget).
+     */
+    notify(method: string, params?: unknown): Promise<void>;
+    /**
+     * Registers handler for incoming requests.
+     */
+    onRequest(handler: RequestHandler<TReq, TRes>): Unsubscribe;
+    /**
+     * Registers handler for incoming notifications.
+     */
+    onNotification(handler: NotificationHandler<TNotif>): Unsubscribe;
+    /**
+     * Subscribes to channel events.
+     */
+    on<K extends keyof ChannelEvents>(event: K, handler: (data: ChannelEvents[K]) => void): Unsubscribe;
+    /**
+     * Handles incoming chunk from transport.
+     */
+    private handleChunk;
+    /**
+     * Processes a single frame.
+     */
+    private processFrame;
+    /**
+     * Handles incoming response message.
+     */
+    private handleResponse;
+    /**
+     * Handles incoming request message.
+     */
+    private handleRequest;
+    /**
+     * Handles incoming notification message.
+     */
+    private handleNotification;
+    /**
+     * Sends a response message.
+     */
+    private sendResponse;
+    /**
+     * Extracts request ID from request message (protocol-specific).
+     */
+    private extractRequestId;
+    /**
+     * Creates default response accessor based on protocol name.
+     */
+    private createDefaultAccessor;
+    /**
+     * Runs middleware hook for all registered middleware.
+     */
+    private runMiddlewareHook;
+    /**
+     * Emits error event.
+     */
+    private emitError;
+}
+//# sourceMappingURL=request-channel.d.ts.map

package/dist/channel/request-channel.d.ts.map

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