@procwire/transport 1.0.0

package/dist/serialization/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../src/serialization/raw.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,QAAQ;IACH,IAAI,GAAG,KAAK,CAAC;IACb,WAAW,GAAG,0BAA0B,CAAC;IAEzD;;;;;OAKG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,MAAc;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/serialization/registry.d.ts

@@ -0,0 +1,91 @@
+import type { SerializationCodec } from "./types.js";
+/**
+ * Global codec registry for serialization codecs.
+ *
+ * Provides a static registry to register and lookup codecs by name or content type.
+ * Thread-safe in Node.js (single-threaded event loop).
+ *
+ * @example
+ * ```ts
+ * import { CodecRegistry, JsonCodec } from '@procwire/transport';
+ *
+ * CodecRegistry.register(new JsonCodec());
+ * const codec = CodecRegistry.get('json');
+ * ```
+ */
+export declare class CodecRegistry {
+    private static readonly byName;
+    private static readonly byContentType;
+    /**
+     * Registers a serialization codec in the global registry.
+     *
+     * @param codec - Codec to register
+     * @throws {SerializationError} if a codec with the same name or content type already exists
+     *
+     * @example
+     * ```ts
+     * CodecRegistry.register(new JsonCodec());
+     * CodecRegistry.register(new RawCodec());
+     * ```
+     */
+    static register(codec: SerializationCodec): void;
+    /**
+     * Unregisters a codec by name.
+     *
+     * @param name - Name of the codec to unregister
+     * @returns true if codec was found and removed, false otherwise
+     *
+     * @example
+     * ```ts
+     * CodecRegistry.unregister('json');
+     * ```
+     */
+    static unregister(name: string): boolean;
+    /**
+     * Retrieves a codec by name.
+     *
+     * @param name - Codec name (e.g., 'json', 'raw')
+     * @returns Codec instance or undefined if not found
+     *
+     * @example
+     * ```ts
+     * const codec = CodecRegistry.get('json');
+     * if (codec) {
+     *   const buffer = codec.serialize({ foo: 'bar' });
+     * }
+     * ```
+     */
+    static get(name: string): SerializationCodec | undefined;
+    /**
+     * Retrieves a codec by content type.
+     *
+     * @param contentType - Content type (e.g., 'application/json')
+     * @returns Codec instance or undefined if not found
+     *
+     * @example
+     * ```ts
+     * const codec = CodecRegistry.getByContentType('application/json');
+     * ```
+     */
+    static getByContentType(contentType: string): SerializationCodec | undefined;
+    /**
+     * Lists all registered codec names.
+     *
+     * @returns Array of codec names
+     *
+     * @example
+     * ```ts
+     * const names = CodecRegistry.list();
+     * console.log(names); // ['json', 'raw']
+     * ```
+     */
+    static list(): string[];
+    /**
+     * Clears all registered codecs.
+     * Intended for testing purposes only.
+     *
+     * @internal
+     */
+    static resetForTests(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/serialization/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/serialization/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAyC;IACvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAyC;IAE9E;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAmBhD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWxC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIxD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI5E;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE;IAIvB;;;;;OAKG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAI7B"}

package/dist/serialization/registry.js

@@ -0,0 +1,119 @@
+import { SerializationError } from "../utils/errors.js";
+/**
+ * Global codec registry for serialization codecs.
+ *
+ * Provides a static registry to register and lookup codecs by name or content type.
+ * Thread-safe in Node.js (single-threaded event loop).
+ *
+ * @example
+ * ```ts
+ * import { CodecRegistry, JsonCodec } from '@procwire/transport';
+ *
+ * CodecRegistry.register(new JsonCodec());
+ * const codec = CodecRegistry.get('json');
+ * ```
+ */
+export class CodecRegistry {
+    static byName = new Map();
+    static byContentType = new Map();
+    /**
+     * Registers a serialization codec in the global registry.
+     *
+     * @param codec - Codec to register
+     * @throws {SerializationError} if a codec with the same name or content type already exists
+     *
+     * @example
+     * ```ts
+     * CodecRegistry.register(new JsonCodec());
+     * CodecRegistry.register(new RawCodec());
+     * ```
+     */
+    static register(codec) {
+        const existingByName = this.byName.get(codec.name);
+        if (existingByName) {
+            throw new SerializationError(`Codec with name '${codec.name}' is already registered (content type: '${existingByName.contentType}')`);
+        }
+        const existingByContentType = this.byContentType.get(codec.contentType);
+        if (existingByContentType) {
+            throw new SerializationError(`Codec with content type '${codec.contentType}' is already registered (name: '${existingByContentType.name}')`);
+        }
+        this.byName.set(codec.name, codec);
+        this.byContentType.set(codec.contentType, codec);
+    }
+    /**
+     * Unregisters a codec by name.
+     *
+     * @param name - Name of the codec to unregister
+     * @returns true if codec was found and removed, false otherwise
+     *
+     * @example
+     * ```ts
+     * CodecRegistry.unregister('json');
+     * ```
+     */
+    static unregister(name) {
+        const codec = this.byName.get(name);
+        if (!codec) {
+            return false;
+        }
+        this.byName.delete(name);
+        this.byContentType.delete(codec.contentType);
+        return true;
+    }
+    /**
+     * Retrieves a codec by name.
+     *
+     * @param name - Codec name (e.g., 'json', 'raw')
+     * @returns Codec instance or undefined if not found
+     *
+     * @example
+     * ```ts
+     * const codec = CodecRegistry.get('json');
+     * if (codec) {
+     *   const buffer = codec.serialize({ foo: 'bar' });
+     * }
+     * ```
+     */
+    static get(name) {
+        return this.byName.get(name);
+    }
+    /**
+     * Retrieves a codec by content type.
+     *
+     * @param contentType - Content type (e.g., 'application/json')
+     * @returns Codec instance or undefined if not found
+     *
+     * @example
+     * ```ts
+     * const codec = CodecRegistry.getByContentType('application/json');
+     * ```
+     */
+    static getByContentType(contentType) {
+        return this.byContentType.get(contentType);
+    }
+    /**
+     * Lists all registered codec names.
+     *
+     * @returns Array of codec names
+     *
+     * @example
+     * ```ts
+     * const names = CodecRegistry.list();
+     * console.log(names); // ['json', 'raw']
+     * ```
+     */
+    static list() {
+        return Array.from(this.byName.keys());
+    }
+    /**
+     * Clears all registered codecs.
+     * Intended for testing purposes only.
+     *
+     * @internal
+     */
+    static resetForTests() {
+        this.byName.clear();
+        this.byContentType.clear();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/serialization/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/serialization/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAU,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/D,MAAM,CAAU,aAAa,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE9E;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAyB;QACvC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,KAAK,CAAC,IAAI,2CAA2C,cAAc,CAAC,WAAW,IAAI,CACxG,CAAC;QACJ,CAAC;QAED,MAAM,qBAAqB,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACxE,IAAI,qBAAqB,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,KAAK,CAAC,WAAW,mCAAmC,qBAAqB,CAAC,IAAI,IAAI,CAC/G,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CAAC,WAAmB;QACzC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa;QAClB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC"}

package/dist/serialization/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Serialization codec interface for converting between objects and binary data.
+ * Implementations: JSON, MessagePack, Protocol Buffers, Apache Arrow.
+ *
+ * @template T - Type of objects being serialized/deserialized
+ */
+export interface SerializationCodec<T = unknown> {
+    /**
+     * Codec name (e.g., 'json', 'msgpack', 'protobuf').
+     */
+    readonly name: string;
+    /**
+     * Content type identifier (e.g., 'application/json', 'application/msgpack').
+     */
+    readonly contentType: string;
+    /**
+     * Serializes object to binary buffer.
+     * @throws {SerializationError} if serialization fails
+     */
+    serialize(data: T): Buffer;
+    /**
+     * Deserializes binary buffer to object.
+     * @throws {SerializationError} if deserialization fails
+     */
+    deserialize(buffer: Buffer): T;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/serialization/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IAE3B;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC;CAChC"}

package/dist/serialization/types.js

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

package/dist/serialization/types.js.map

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

package/dist/transport/factory.d.ts

@@ -0,0 +1,139 @@
+import { StdioTransport, type StdioTransportOptions } from "./stdio-transport.js";
+import { type SocketTransportOptions } from "./socket-transport.js";
+import { type SocketServerOptions } from "./socket-server.js";
+import type { Transport, TransportServer } from "./types.js";
+/**
+ * Factory for creating transport instances.
+ *
+ * Provides convenient methods for creating different types of transports
+ * with platform-specific optimizations.
+ *
+ * @example
+ * ```ts
+ * // Create stdio transport for child process
+ * const transport = TransportFactory.createStdio({
+ *   executablePath: 'node',
+ *   args: ['worker.js']
+ * });
+ *
+ * // Create pipe/socket client
+ * const client = TransportFactory.createPipeClient({
+ *   path: '/tmp/my-socket.sock'
+ * });
+ *
+ * // Create pipe/socket server
+ * const server = TransportFactory.createPipeServer();
+ * await server.listen('/tmp/my-socket.sock');
+ * ```
+ */
+export declare class TransportFactory {
+    /**
+     * Creates a stdio transport for child process communication.
+     *
+     * @param options - Stdio transport options
+     * @returns StdioTransport instance
+     *
+     * @example
+     * ```ts
+     * const transport = TransportFactory.createStdio({
+     *   executablePath: 'node',
+     *   args: ['worker.js'],
+     *   cwd: '/path/to/project'
+     * });
+     * await transport.connect();
+     * ```
+     */
+    static createStdio(options: StdioTransportOptions): StdioTransport;
+    /**
+     * Creates a pipe/socket client transport.
+     *
+     * Automatically uses the appropriate implementation for the current platform:
+     * - Windows: Named Pipes
+     * - Unix: Unix Domain Sockets
+     *
+     * @param options - Socket transport options
+     * @returns SocketTransport instance
+     *
+     * @example
+     * ```ts
+     * const transport = TransportFactory.createPipeClient({
+     *   path: isWindows() ? '\\\\.\\pipe\\my-pipe' : '/tmp/my-socket.sock',
+     *   connectionTimeout: 5000
+     * });
+     * await transport.connect();
+     * ```
+     */
+    static createPipeClient(options: SocketTransportOptions): Transport;
+    /**
+     * Creates a pipe/socket server.
+     *
+     * Automatically uses the appropriate implementation for the current platform:
+     * - Windows: Named Pipe Server
+     * - Unix: Unix Domain Socket Server
+     *
+     * @param options - Socket server options
+     * @returns SocketServer instance
+     *
+     * @example
+     * ```ts
+     * const server = TransportFactory.createPipeServer();
+     * await server.listen('/tmp/my-socket.sock');
+     *
+     * server.onConnection(transport => {
+     *   console.log('Client connected');
+     *   transport.onData(data => {
+     *     transport.write(data); // Echo back
+     *   });
+     * });
+     * ```
+     */
+    static createPipeServer(options?: SocketServerOptions): TransportServer;
+    /**
+     * Creates an optimal transport based on options and platform.
+     *
+     * Automatically selects:
+     * - Stdio transport if executablePath is provided
+     * - Pipe/socket transport if path is provided
+     *
+     * @param options - Mixed transport options
+     * @returns Transport instance
+     * @throws {TransportError} if options are invalid or ambiguous
+     *
+     * @example
+     * ```ts
+     * // Stdio transport
+     * const stdio = TransportFactory.createOptimal({
+     *   executablePath: 'node',
+     *   args: ['worker.js']
+     * });
+     *
+     * // Pipe transport
+     * const pipe = TransportFactory.createOptimal({
+     *   path: '/tmp/my-socket.sock'
+     * });
+     * ```
+     */
+    static createOptimal(options: (StdioTransportOptions | SocketTransportOptions) & {
+        executablePath?: string;
+        path?: string;
+    }): Transport;
+    /**
+     * Validates if a path is valid for the current platform.
+     *
+     * @param path - Path to validate
+     * @returns true if path is valid for current platform
+     *
+     * @example
+     * ```ts
+     * // Windows
+     * TransportFactory.isValidPath('\\\\.\\pipe\\my-pipe'); // true
+     * TransportFactory.isValidPath('/tmp/socket.sock'); // false (Unix path on Windows)
+     *
+     * // Unix
+     * TransportFactory.isValidPath('/tmp/socket.sock'); // true
+     * TransportFactory.isValidPath('\\\\.\\pipe\\my-pipe'); // false (Windows path on Unix)
+     * ```
+     */
+    static isValidPath(path: string): boolean;
+}
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/transport/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc;IAIlE;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS;IAInE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,eAAe;IAIvE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,aAAa,CAClB,OAAO,EAAE,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,GAAG;QAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GACA,SAAS;IAgBZ;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAS1C"}

package/dist/transport/factory.js

@@ -0,0 +1,162 @@
+import { TransportError } from "../utils/errors.js";
+import { isWindows } from "../utils/platform.js";
+import { StdioTransport } from "./stdio-transport.js";
+import { SocketTransport } from "./socket-transport.js";
+import { SocketServer } from "./socket-server.js";
+/**
+ * Factory for creating transport instances.
+ *
+ * Provides convenient methods for creating different types of transports
+ * with platform-specific optimizations.
+ *
+ * @example
+ * ```ts
+ * // Create stdio transport for child process
+ * const transport = TransportFactory.createStdio({
+ *   executablePath: 'node',
+ *   args: ['worker.js']
+ * });
+ *
+ * // Create pipe/socket client
+ * const client = TransportFactory.createPipeClient({
+ *   path: '/tmp/my-socket.sock'
+ * });
+ *
+ * // Create pipe/socket server
+ * const server = TransportFactory.createPipeServer();
+ * await server.listen('/tmp/my-socket.sock');
+ * ```
+ */
+export class TransportFactory {
+    /**
+     * Creates a stdio transport for child process communication.
+     *
+     * @param options - Stdio transport options
+     * @returns StdioTransport instance
+     *
+     * @example
+     * ```ts
+     * const transport = TransportFactory.createStdio({
+     *   executablePath: 'node',
+     *   args: ['worker.js'],
+     *   cwd: '/path/to/project'
+     * });
+     * await transport.connect();
+     * ```
+     */
+    static createStdio(options) {
+        return new StdioTransport(options);
+    }
+    /**
+     * Creates a pipe/socket client transport.
+     *
+     * Automatically uses the appropriate implementation for the current platform:
+     * - Windows: Named Pipes
+     * - Unix: Unix Domain Sockets
+     *
+     * @param options - Socket transport options
+     * @returns SocketTransport instance
+     *
+     * @example
+     * ```ts
+     * const transport = TransportFactory.createPipeClient({
+     *   path: isWindows() ? '\\\\.\\pipe\\my-pipe' : '/tmp/my-socket.sock',
+     *   connectionTimeout: 5000
+     * });
+     * await transport.connect();
+     * ```
+     */
+    static createPipeClient(options) {
+        return new SocketTransport(options);
+    }
+    /**
+     * Creates a pipe/socket server.
+     *
+     * Automatically uses the appropriate implementation for the current platform:
+     * - Windows: Named Pipe Server
+     * - Unix: Unix Domain Socket Server
+     *
+     * @param options - Socket server options
+     * @returns SocketServer instance
+     *
+     * @example
+     * ```ts
+     * const server = TransportFactory.createPipeServer();
+     * await server.listen('/tmp/my-socket.sock');
+     *
+     * server.onConnection(transport => {
+     *   console.log('Client connected');
+     *   transport.onData(data => {
+     *     transport.write(data); // Echo back
+     *   });
+     * });
+     * ```
+     */
+    static createPipeServer(options) {
+        return new SocketServer(options);
+    }
+    /**
+     * Creates an optimal transport based on options and platform.
+     *
+     * Automatically selects:
+     * - Stdio transport if executablePath is provided
+     * - Pipe/socket transport if path is provided
+     *
+     * @param options - Mixed transport options
+     * @returns Transport instance
+     * @throws {TransportError} if options are invalid or ambiguous
+     *
+     * @example
+     * ```ts
+     * // Stdio transport
+     * const stdio = TransportFactory.createOptimal({
+     *   executablePath: 'node',
+     *   args: ['worker.js']
+     * });
+     *
+     * // Pipe transport
+     * const pipe = TransportFactory.createOptimal({
+     *   path: '/tmp/my-socket.sock'
+     * });
+     * ```
+     */
+    static createOptimal(options) {
+        // Check for stdio (has executablePath)
+        if ("executablePath" in options && options.executablePath) {
+            return this.createStdio(options);
+        }
+        // Check for pipe/socket (has path)
+        if ("path" in options && options.path) {
+            return this.createPipeClient(options);
+        }
+        throw new TransportError("Invalid transport options: must provide either 'executablePath' (stdio) or 'path' (pipe/socket)");
+    }
+    /**
+     * Validates if a path is valid for the current platform.
+     *
+     * @param path - Path to validate
+     * @returns true if path is valid for current platform
+     *
+     * @example
+     * ```ts
+     * // Windows
+     * TransportFactory.isValidPath('\\\\.\\pipe\\my-pipe'); // true
+     * TransportFactory.isValidPath('/tmp/socket.sock'); // false (Unix path on Windows)
+     *
+     * // Unix
+     * TransportFactory.isValidPath('/tmp/socket.sock'); // true
+     * TransportFactory.isValidPath('\\\\.\\pipe\\my-pipe'); // false (Windows path on Unix)
+     * ```
+     */
+    static isValidPath(path) {
+        if (isWindows()) {
+            // Windows Named Pipe: must start with \\.\pipe\
+            return path.startsWith("\\\\.\\pipe\\");
+        }
+        else {
+            // Unix: should be absolute path
+            return path.startsWith("/");
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/transport/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/transport/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,eAAe,EAA+B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAG5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,OAA8B;QAC/C,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAA+B;QACrD,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAA6B;QACnD,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,aAAa,CAClB,OAGC;QAED,uCAAuC;QACvC,IAAI,gBAAgB,IAAI,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,OAAgC,CAAC,CAAC;QAC5D,CAAC;QAED,mCAAmC;QACnC,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAiC,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,cAAc,CACtB,iGAAiG,CAClG,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,gDAAgD;YAChD,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,gCAAgC;YAChC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF"}

package/dist/transport/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./stdio-transport.js";
+export * from "./socket-transport.js";
+export * from "./socket-server.js";
+export * from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAG3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,cAAc,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,9 @@
+// Core types
+export * from "./types.js";
+// Transport implementations
+export * from "./stdio-transport.js";
+export * from "./socket-transport.js";
+export * from "./socket-server.js";
+// Factory
+export * from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,YAAY,CAAC;AAE3B,4BAA4B;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AAEnC,UAAU;AACV,cAAc,cAAc,CAAC"}

package/dist/transport/socket-server.d.ts

@@ -0,0 +1,48 @@
+import type { TransportServer, TransportServerEvents, ServerAddress, Transport } from "./types.js";
+import type { Unsubscribe } from "../utils/disposables.js";
+/**
+ * Socket server options.
+ */
+export interface SocketServerOptions {
+    /**
+     * Optional: cleanup stale socket files before listening (Unix only).
+     * @default true
+     */
+    cleanupBeforeListen?: boolean;
+}
+/**
+ * Socket server implementation for Named Pipes (Windows) and Unix Domain Sockets.
+ *
+ * Accepts client connections and creates Transport instances for each connection.
+ *
+ * @example
+ * ```ts
+ * const server = new SocketServer();
+ * const address = await server.listen('/tmp/my-server.sock');
+ *
+ * server.onConnection(transport => {
+ *   console.log('Client connected');
+ *   transport.onData(data => {
+ *     console.log('received:', data);
+ *     transport.write(data); // Echo back
+ *   });
+ * });
+ * ```
+ */
+export declare class SocketServer implements TransportServer {
+    private readonly emitter;
+    private readonly options;
+    private server;
+    private _address;
+    private readonly connections;
+    constructor(options?: SocketServerOptions);
+    get isListening(): boolean;
+    get address(): ServerAddress | null;
+    listen(address: string | number): Promise<ServerAddress>;
+    close(): Promise<void>;
+    onConnection(handler: (transport: Transport) => void): Unsubscribe;
+    on<K extends keyof TransportServerEvents>(event: K, handler: (data: TransportServerEvents[K]) => void): Unsubscribe;
+    private handleConnection;
+    private cleanup;
+}
+//# sourceMappingURL=socket-server.d.ts.map

package/dist/transport/socket-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../../src/transport/socket-server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAmC,MAAM,YAAY,CAAC;AACpI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,YAAW,eAAe;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;gBAEvD,OAAO,GAAE,mBAAwB;IAM7C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,OAAO,IAAI,aAAa,GAAG,IAAI,CAElC;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA8CxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B,YAAY,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,WAAW;IAIlE,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAChD,WAAW;IAId,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,OAAO;CAOhB"}