@procwire/transport 1.0.0

package/dist/channel/types.d.ts

@@ -0,0 +1,226 @@
+import type { EventMap } from "../utils/events.js";
+import type { Unsubscribe } from "../utils/disposables.js";
+import type { Transport, TransportServer } from "../transport/types.js";
+import type { FramingCodec } from "../framing/types.js";
+import type { SerializationCodec } from "../serialization/types.js";
+import type { Protocol, RequestId, ProtocolDataError } from "../protocol/types.js";
+/**
+ * Request handler function.
+ * @template TReq - Request data type
+ * @template TRes - Response data type
+ */
+export type RequestHandler<TReq = unknown, TRes = unknown> = (request: TReq) => TRes | Promise<TRes>;
+/**
+ * Notification handler function.
+ * @template TNotif - Notification data type
+ */
+export type NotificationHandler<TNotif = unknown> = (notification: TNotif) => void;
+/**
+ * Response accessor for interpreting protocol-specific response messages.
+ * Abstracts away protocol differences for generic channel implementation.
+ */
+export interface ResponseAccessor {
+    /**
+     * Extracts request ID from a response message.
+     * @returns Request ID or undefined if message is not a response
+     */
+    getResponseId(message: unknown): RequestId | undefined;
+    /**
+     * Checks if response message represents an error.
+     */
+    isErrorResponse(message: unknown): boolean;
+    /**
+     * Extracts result data from success response.
+     */
+    getResult(message: unknown): unknown;
+    /**
+     * Extracts error data from error response.
+     */
+    getError(message: unknown): ProtocolDataError | unknown;
+}
+/**
+ * Middleware hook for channel operations.
+ * Useful for logging, metrics, debugging, and transformation.
+ */
+export interface ChannelMiddleware {
+    /**
+     * Called before sending a request.
+     */
+    onOutgoingRequest?(request: unknown): void | Promise<void>;
+    /**
+     * Called after receiving a response.
+     */
+    onIncomingResponse?(response: unknown): void | Promise<void>;
+    /**
+     * Called when receiving an incoming request.
+     */
+    onIncomingRequest?(request: unknown): void | Promise<void>;
+    /**
+     * Called before sending a response.
+     */
+    onOutgoingResponse?(response: unknown): void | Promise<void>;
+    /**
+     * Called when an error occurs.
+     */
+    onError?(error: Error): void | Promise<void>;
+}
+/**
+ * Channel events map.
+ */
+export interface ChannelEvents extends EventMap {
+    /**
+     * Fired when channel starts (connects).
+     */
+    start: void;
+    /**
+     * Fired when channel closes.
+     */
+    close: void;
+    /**
+     * Fired when channel error occurs.
+     */
+    error: Error;
+}
+/**
+ * Channel options for configuration.
+ * @template TReq - Request data type
+ * @template TRes - Response data type
+ * @template TNotif - Notification data type
+ */
+export interface ChannelOptions<TReq = unknown, TRes = unknown, TNotif = unknown> {
+    /**
+     * Underlying transport.
+     */
+    transport: Transport;
+    /**
+     * Framing codec for message boundaries.
+     */
+    framing: FramingCodec;
+    /**
+     * Serialization codec for data encoding.
+     */
+    serialization: SerializationCodec;
+    /**
+     * Protocol layer for request/response.
+     */
+    protocol: Protocol<TReq, TRes, TNotif>;
+    /**
+     * Default request timeout in milliseconds (default: 30000).
+     */
+    timeout?: number;
+    /**
+     * Response accessor for interpreting response messages.
+     * If not provided, auto-detected based on protocol name.
+     */
+    responseAccessor?: ResponseAccessor;
+    /**
+     * Middleware hooks for logging, metrics, debugging.
+     */
+    middleware?: ChannelMiddleware[];
+    /**
+     * Maximum number of inbound frames to buffer before backpressure (optional).
+     */
+    maxInboundFrames?: number;
+}
+/**
+ * High-level communication channel combining all layers.
+ * Provides request/response and notification patterns.
+ *
+ * @template TReq - Request data type (wire format)
+ * @template TRes - Response data type (wire format)
+ * @template TNotif - Notification data type (wire format)
+ */
+export interface Channel<TReq = unknown, TRes = unknown, TNotif = unknown> {
+    /**
+     * Returns true if channel is connected and ready.
+     */
+    readonly isConnected: boolean;
+    /**
+     * Starts the channel (connects transport).
+     */
+    start(): Promise<void>;
+    /**
+     * Closes the channel gracefully.
+     */
+    close(): Promise<void>;
+    /**
+     * Sends a request and waits for response.
+     * @param method - Method name
+     * @param params - Optional parameters
+     * @param timeout - Optional timeout override (ms)
+     * @returns Promise resolving to response result
+     * @throws {TimeoutError} if request times out
+     * @throws {ProtocolError} if response is an error
+     */
+    request(method: string, params?: unknown, timeout?: number): Promise<unknown>;
+    /**
+     * Sends a notification (fire-and-forget, no response expected).
+     * @param method - Method name
+     * @param params - Optional parameters
+     */
+    notify(method: string, params?: unknown): Promise<void>;
+    /**
+     * Registers handler for incoming requests.
+     * @returns Unsubscribe function
+     */
+    onRequest(handler: RequestHandler<TReq, TRes>): Unsubscribe;
+    /**
+     * Registers handler for incoming notifications.
+     * @returns Unsubscribe function
+     */
+    onNotification(handler: NotificationHandler<TNotif>): Unsubscribe;
+    /**
+     * Subscribes to channel events.
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof ChannelEvents>(event: K, handler: (data: ChannelEvents[K]) => void): Unsubscribe;
+}
+/**
+ * Server-side channel factory options.
+ */
+export interface ChannelServerOptions<TReq = unknown, TRes = unknown, TNotif = unknown> {
+    /**
+     * Transport server for accepting connections.
+     */
+    server: TransportServer;
+    /**
+     * Framing codec factory (creates instance per connection).
+     */
+    createFraming: () => FramingCodec;
+    /**
+     * Serialization codec (can be shared across connections).
+     */
+    serialization: SerializationCodec;
+    /**
+     * Protocol factory (creates instance per connection).
+     */
+    createProtocol: () => Protocol<TReq, TRes, TNotif>;
+    /**
+     * Default request timeout in milliseconds (optional).
+     */
+    timeout?: number;
+}
+/**
+ * Server-side channel manager.
+ * Accepts connections and creates Channel instances.
+ */
+export interface ChannelServer<TReq = unknown, TRes = unknown, TNotif = unknown> {
+    /**
+     * Returns true if server is listening.
+     */
+    readonly isListening: boolean;
+    /**
+     * Starts listening for connections.
+     */
+    listen(address: string | number): Promise<void>;
+    /**
+     * Stops the server and closes all channels.
+     */
+    close(): Promise<void>;
+    /**
+     * Subscribes to new channel connections.
+     * @returns Unsubscribe function
+     */
+    onConnection(handler: (channel: Channel<TReq, TRes, TNotif>) => void): Unsubscribe;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/channel/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/channel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channel/types.ts"],"names":[],"mappings":""}

package/dist/framing/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./line-delimited.js";
+export * from "./length-prefixed.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/framing/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/framing/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./line-delimited.js";
+export * from "./length-prefixed.js";
+//# sourceMappingURL=index.js.map

package/dist/framing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/framing/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/framing/length-prefixed.d.ts

@@ -0,0 +1,55 @@
+import type { FramingCodec } from "./types.js";
+/**
+ * Options for LengthPrefixedFraming.
+ */
+export interface LengthPrefixedFramingOptions {
+    /**
+     * Maximum message size in bytes (default: 32MB).
+     * Prevents DoS from malicious large length headers.
+     */
+    maxMessageSize?: number;
+}
+/**
+ * Length-prefixed framing codec.
+ * Format: [4-byte length (uint32 BE)][payload]
+ *
+ * Each frame starts with a 4-byte big-endian unsigned integer
+ * indicating the payload length, followed by the payload itself.
+ *
+ * Handles partial headers, partial payloads, and multiple frames per chunk.
+ * Supports zero-length frames.
+ *
+ * @example
+ * const framing = new LengthPrefixedFraming();
+ * const encoded = framing.encode(Buffer.from('hello')); // [0,0,0,5,'h','e','l','l','o']
+ * const frames = framing.decode(encoded); // [Buffer<'hello'>]
+ */
+export declare class LengthPrefixedFraming implements FramingCodec {
+    private static readonly HEADER_SIZE;
+    private readonly maxMessageSize;
+    private buffer;
+    private expectedLength;
+    constructor(options?: LengthPrefixedFramingOptions);
+    /**
+     * Encodes a payload with length prefix.
+     */
+    encode(payload: Buffer): Buffer;
+    /**
+     * Decodes incoming chunk and extracts complete frames.
+     * Buffers partial headers and payloads.
+     */
+    decode(chunk: Buffer): Buffer[];
+    /**
+     * Resets internal buffer state.
+     */
+    reset(): void;
+    /**
+     * Returns true if there is buffered partial data.
+     */
+    hasBufferedData(): boolean;
+    /**
+     * Returns current buffer size in bytes.
+     */
+    getBufferSize(): number;
+}
+//# sourceMappingURL=length-prefixed.d.ts.map

package/dist/framing/length-prefixed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length-prefixed.d.ts","sourceRoot":"","sources":["../../src/framing/length-prefixed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IAExC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAgB;gBAE1B,OAAO,GAAE,4BAAiC;IAMtD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAM/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IA0D/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}

package/dist/framing/length-prefixed.js

@@ -0,0 +1,102 @@
+import { FramingError } from "../utils/errors.js";
+/**
+ * Length-prefixed framing codec.
+ * Format: [4-byte length (uint32 BE)][payload]
+ *
+ * Each frame starts with a 4-byte big-endian unsigned integer
+ * indicating the payload length, followed by the payload itself.
+ *
+ * Handles partial headers, partial payloads, and multiple frames per chunk.
+ * Supports zero-length frames.
+ *
+ * @example
+ * const framing = new LengthPrefixedFraming();
+ * const encoded = framing.encode(Buffer.from('hello')); // [0,0,0,5,'h','e','l','l','o']
+ * const frames = framing.decode(encoded); // [Buffer<'hello'>]
+ */
+export class LengthPrefixedFraming {
+    static HEADER_SIZE = 4;
+    maxMessageSize;
+    buffer;
+    expectedLength;
+    constructor(options = {}) {
+        this.maxMessageSize = options.maxMessageSize ?? 32 * 1024 * 1024; // 32MB
+        this.buffer = Buffer.allocUnsafe(0);
+        this.expectedLength = null;
+    }
+    /**
+     * Encodes a payload with length prefix.
+     */
+    encode(payload) {
+        const header = Buffer.allocUnsafe(LengthPrefixedFraming.HEADER_SIZE);
+        header.writeUInt32BE(payload.length, 0);
+        return Buffer.concat([header, payload]);
+    }
+    /**
+     * Decodes incoming chunk and extracts complete frames.
+     * Buffers partial headers and payloads.
+     */
+    decode(chunk) {
+        // Append chunk to buffer
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        const frames = [];
+        // Process all complete frames in buffer
+        while (true) {
+            // Do we need to read the header?
+            if (this.expectedLength === null) {
+                // Need at least HEADER_SIZE bytes
+                if (this.buffer.length < LengthPrefixedFraming.HEADER_SIZE) {
+                    break; // Wait for more data
+                }
+                // Read length from header
+                const length = this.buffer.readUInt32BE(0);
+                // Validate length
+                if (length > this.maxMessageSize) {
+                    const error = new FramingError(`Message length ${length} exceeds maximum ${this.maxMessageSize}`);
+                    this.reset();
+                    throw error;
+                }
+                this.expectedLength = length;
+                this.buffer = this.buffer.subarray(LengthPrefixedFraming.HEADER_SIZE);
+            }
+            // Do we have the complete payload?
+            if (this.buffer.length < this.expectedLength) {
+                break; // Wait for more data
+            }
+            // Extract frame
+            const frame = this.buffer.subarray(0, this.expectedLength);
+            frames.push(frame);
+            // Move past this frame
+            this.buffer = this.buffer.subarray(this.expectedLength);
+            this.expectedLength = null;
+        }
+        // Validate buffer doesn't grow unbounded
+        const maxBufferSize = LengthPrefixedFraming.HEADER_SIZE + this.maxMessageSize;
+        if (this.buffer.length > maxBufferSize) {
+            const error = new FramingError(`Buffer size ${this.buffer.length} exceeds maximum ${maxBufferSize}`);
+            this.reset();
+            throw error;
+        }
+        return frames;
+    }
+    /**
+     * Resets internal buffer state.
+     */
+    reset() {
+        this.buffer = Buffer.allocUnsafe(0);
+        this.expectedLength = null;
+    }
+    /**
+     * Returns true if there is buffered partial data.
+     */
+    hasBufferedData() {
+        return this.buffer.length > 0 || this.expectedLength !== null;
+    }
+    /**
+     * Returns current buffer size in bytes.
+     */
+    getBufferSize() {
+        return this.buffer.length;
+    }
+}
+//# sourceMappingURL=length-prefixed.js.map

package/dist/framing/length-prefixed.js.map

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

package/dist/framing/line-delimited.d.ts

@@ -0,0 +1,61 @@
+import type { FramingCodec } from "./types.js";
+/**
+ * Options for LineDelimitedFraming.
+ */
+export interface LineDelimitedFramingOptions {
+    /**
+     * Delimiter byte (default: 0x0A = '\n').
+     */
+    delimiter?: number;
+    /**
+     * Maximum buffer size before throwing error (default: 8MB).
+     * Prevents DoS from infinitely long lines without delimiter.
+     */
+    maxBufferSize?: number;
+    /**
+     * Whether to strip delimiter from decoded frames (default: true).
+     */
+    stripDelimiter?: boolean;
+}
+/**
+ * Line-delimited framing codec.
+ * Format: {payload}{delimiter}
+ *
+ * Each frame is terminated by a delimiter byte (default newline).
+ * Handles partial chunks and multiple frames per chunk.
+ *
+ * @example
+ * const framing = new LineDelimitedFraming();
+ * const encoded = framing.encode(Buffer.from('hello')); // Buffer<'hello\n'>
+ * const frames = framing.decode(Buffer.from('world\n')); // [Buffer<'world'>]
+ */
+export declare class LineDelimitedFraming implements FramingCodec {
+    private readonly delimiter;
+    private readonly maxBufferSize;
+    private readonly stripDelimiter;
+    private buffer;
+    constructor(options?: LineDelimitedFramingOptions);
+    /**
+     * Encodes a payload with delimiter.
+     * If payload already ends with delimiter, does not add another one.
+     */
+    encode(payload: Buffer): Buffer;
+    /**
+     * Decodes incoming chunk and extracts complete frames.
+     * Buffers partial data until delimiter is found.
+     */
+    decode(chunk: Buffer): Buffer[];
+    /**
+     * Resets internal buffer state.
+     */
+    reset(): void;
+    /**
+     * Returns true if there is buffered partial data.
+     */
+    hasBufferedData(): boolean;
+    /**
+     * Returns current buffer size in bytes.
+     */
+    getBufferSize(): number;
+}
+//# sourceMappingURL=line-delimited.d.ts.map

package/dist/framing/line-delimited.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-delimited.d.ts","sourceRoot":"","sources":["../../src/framing/line-delimited.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,2BAAgC;IAOrD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IA0C/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}

package/dist/framing/line-delimited.js

@@ -0,0 +1,94 @@
+import { FramingError } from "../utils/errors.js";
+/**
+ * Line-delimited framing codec.
+ * Format: {payload}{delimiter}
+ *
+ * Each frame is terminated by a delimiter byte (default newline).
+ * Handles partial chunks and multiple frames per chunk.
+ *
+ * @example
+ * const framing = new LineDelimitedFraming();
+ * const encoded = framing.encode(Buffer.from('hello')); // Buffer<'hello\n'>
+ * const frames = framing.decode(Buffer.from('world\n')); // [Buffer<'world'>]
+ */
+export class LineDelimitedFraming {
+    delimiter;
+    maxBufferSize;
+    stripDelimiter;
+    buffer;
+    constructor(options = {}) {
+        this.delimiter = options.delimiter ?? 0x0a; // '\n'
+        this.maxBufferSize = options.maxBufferSize ?? 8 * 1024 * 1024; // 8MB
+        this.stripDelimiter = options.stripDelimiter ?? true;
+        this.buffer = Buffer.allocUnsafe(0);
+    }
+    /**
+     * Encodes a payload with delimiter.
+     * If payload already ends with delimiter, does not add another one.
+     */
+    encode(payload) {
+        // Check if payload already ends with delimiter
+        if (payload.length > 0 && payload[payload.length - 1] === this.delimiter) {
+            return payload;
+        }
+        // Add delimiter
+        const result = Buffer.allocUnsafe(payload.length + 1);
+        payload.copy(result, 0);
+        result[payload.length] = this.delimiter;
+        return result;
+    }
+    /**
+     * Decodes incoming chunk and extracts complete frames.
+     * Buffers partial data until delimiter is found.
+     */
+    decode(chunk) {
+        // Append chunk to buffer
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        // Check buffer size limit
+        if (this.buffer.length > this.maxBufferSize) {
+            const error = new FramingError(`Buffer size ${this.buffer.length} exceeds maximum ${this.maxBufferSize}`);
+            this.reset();
+            throw error;
+        }
+        const frames = [];
+        let searchStart = 0;
+        // Find all complete frames (terminated by delimiter)
+        while (searchStart < this.buffer.length) {
+            const delimiterIndex = this.buffer.indexOf(this.delimiter, searchStart);
+            if (delimiterIndex === -1) {
+                // No more delimiters found
+                break;
+            }
+            // Extract frame
+            const frameEnd = this.stripDelimiter ? delimiterIndex : delimiterIndex + 1;
+            const frame = this.buffer.subarray(searchStart, frameEnd);
+            frames.push(frame);
+            // Move past delimiter
+            searchStart = delimiterIndex + 1;
+        }
+        // Keep remaining data in buffer
+        if (searchStart > 0) {
+            this.buffer = this.buffer.subarray(searchStart);
+        }
+        return frames;
+    }
+    /**
+     * Resets internal buffer state.
+     */
+    reset() {
+        this.buffer = Buffer.allocUnsafe(0);
+    }
+    /**
+     * Returns true if there is buffered partial data.
+     */
+    hasBufferedData() {
+        return this.buffer.length > 0;
+    }
+    /**
+     * Returns current buffer size in bytes.
+     */
+    getBufferSize() {
+        return this.buffer.length;
+    }
+}
+//# sourceMappingURL=line-delimited.js.map

package/dist/framing/line-delimited.js.map

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

package/dist/framing/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Framing codec interface for message boundary detection in byte streams.
+ * Implementations: line-delimited, length-prefixed, etc.
+ */
+export interface FramingCodec {
+    /**
+     * Encodes a message payload into a framed buffer.
+     * @param payload - Raw message data
+     * @returns Framed buffer ready for transmission
+     */
+    encode(payload: Buffer): Buffer;
+    /**
+     * Decodes incoming chunk and extracts complete messages.
+     * May buffer partial data internally.
+     *
+     * @param chunk - Incoming data chunk
+     * @returns Array of complete message payloads (may be empty if buffering)
+     */
+    decode(chunk: Buffer): Buffer[];
+    /**
+     * Resets internal decoder state and clears buffers.
+     * Used for error recovery or connection restart.
+     */
+    reset(): void;
+    /**
+     * Returns true if decoder has buffered partial data.
+     */
+    hasBufferedData(): boolean;
+    /**
+     * Returns current buffer size (bytes).
+     * Useful for monitoring and debugging.
+     */
+    getBufferSize(): number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/framing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/framing/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC;IAE3B;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC;CACzB"}

package/dist/framing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/framing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/framing/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @procwire/transport
+ *
+ * Core IPC transport library with zero runtime dependencies.
+ * Provides modular, type-safe building blocks for inter-process communication.
+ *
+ * Architecture layers (bottom to top):
+ * - Transport: Raw byte transfer (stdio, pipes, sockets)
+ * - Framing: Message boundary detection
+ * - Serialization: Object <-> binary conversion
+ * - Protocol: Request/response messaging
+ * - Channel: High-level communication API
+ * - Process: Child process lifecycle management
+ *
+ * @packageDocumentation
+ */
+export * from "./transport/index.js";
+export * from "./framing/index.js";
+export * from "./serialization/index.js";
+export * from "./protocol/index.js";
+export * from "./channel/index.js";
+export * from "./process/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC"}