@procwire/transport 0.1.1

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,4CAA4C;QAC5C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC9C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC9C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/events.d.ts

@@ -0,0 +1,58 @@
+import type { Unsubscribe } from "./disposables.js";
+/**
+ * Event handler function.
+ */
+export type EventHandler<T = unknown> = (data: T) => void;
+/**
+ * Map of event names to their payload types.
+ * Usage: interface MyEvents extends EventMap { 'data': Buffer; 'error': Error; }
+ */
+export interface EventMap {
+    [event: string]: unknown;
+}
+/**
+ * Type-safe event emitter with Unsubscribe pattern.
+ * Zero dependencies, designed for transport and channel layers.
+ *
+ * @example
+ * interface MyEvents extends EventMap {
+ *   'connect': void;
+ *   'data': Buffer;
+ *   'error': Error;
+ * }
+ *
+ * const emitter = new EventEmitter<MyEvents>();
+ * const unsub = emitter.on('data', (buf) => console.log(buf));
+ * emitter.emit('data', Buffer.from('hello'));
+ * unsub(); // cleanup
+ */
+export declare class EventEmitter<TEventMap extends EventMap = EventMap> {
+    private readonly listeners;
+    /**
+     * Subscribes to an event.
+     * @returns Unsubscribe function to remove the listener
+     */
+    on<K extends keyof TEventMap>(event: K, handler: EventHandler<TEventMap[K]>): Unsubscribe;
+    /**
+     * Subscribes to an event that fires only once.
+     * @returns Unsubscribe function (in case you want to cancel before it fires)
+     */
+    once<K extends keyof TEventMap>(event: K, handler: EventHandler<TEventMap[K]>): Unsubscribe;
+    /**
+     * Removes a specific event listener.
+     */
+    off<K extends keyof TEventMap>(event: K, handler: EventHandler<TEventMap[K]>): void;
+    /**
+     * Emits an event to all registered listeners.
+     */
+    emit<K extends keyof TEventMap>(event: K, data: TEventMap[K]): void;
+    /**
+     * Removes all listeners for a specific event, or all events if no event specified.
+     */
+    removeAllListeners<K extends keyof TEventMap>(event?: K): void;
+    /**
+     * Returns the number of listeners for a specific event.
+     */
+    listenerCount<K extends keyof TEventMap>(event: K): number;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY,CAAC,SAAS,SAAS,QAAQ,GAAG,QAAQ;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiD;IAE3E;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW;IAczF;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW;IAQ3F;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAUnF;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAenE;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAQ9D;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAI3D"}

package/dist/utils/events.js

@@ -0,0 +1,95 @@
+/**
+ * Type-safe event emitter with Unsubscribe pattern.
+ * Zero dependencies, designed for transport and channel layers.
+ *
+ * @example
+ * interface MyEvents extends EventMap {
+ *   'connect': void;
+ *   'data': Buffer;
+ *   'error': Error;
+ * }
+ *
+ * const emitter = new EventEmitter<MyEvents>();
+ * const unsub = emitter.on('data', (buf) => console.log(buf));
+ * emitter.emit('data', Buffer.from('hello'));
+ * unsub(); // cleanup
+ */
+export class EventEmitter {
+    listeners = new Map();
+    /**
+     * Subscribes to an event.
+     * @returns Unsubscribe function to remove the listener
+     */
+    on(event, handler) {
+        let handlers = this.listeners.get(event);
+        if (!handlers) {
+            handlers = new Set();
+            this.listeners.set(event, handlers);
+        }
+        handlers.add(handler);
+        // Return unsubscribe function
+        return () => {
+            this.off(event, handler);
+        };
+    }
+    /**
+     * Subscribes to an event that fires only once.
+     * @returns Unsubscribe function (in case you want to cancel before it fires)
+     */
+    once(event, handler) {
+        const wrapper = (data) => {
+            this.off(event, wrapper);
+            handler(data);
+        };
+        return this.on(event, wrapper);
+    }
+    /**
+     * Removes a specific event listener.
+     */
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+            if (handlers.size === 0) {
+                this.listeners.delete(event);
+            }
+        }
+    }
+    /**
+     * Emits an event to all registered listeners.
+     */
+    emit(event, data) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            // Clone set to avoid issues if handler unsubscribes during emit
+            for (const handler of Array.from(handlers)) {
+                try {
+                    handler(data);
+                }
+                catch (error) {
+                    // Emit error event if available, otherwise log
+                    console.error(`Error in event handler for '${String(event)}':`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Removes all listeners for a specific event, or all events if no event specified.
+     */
+    removeAllListeners(event) {
+        if (event !== undefined) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /**
+     * Returns the number of listeners for a specific event.
+     */
+    listenerCount(event) {
+        const handlers = this.listeners.get(event);
+        return handlers ? handlers.size : 0;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/utils/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAY;IACN,SAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE3E;;;OAGG;IACH,EAAE,CAA4B,KAAQ,EAAE,OAAmC;QACzE,IAAI,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAC;QAEtC,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI,CAA4B,KAAQ,EAAE,OAAmC;QAC3E,MAAM,OAAO,GAAG,CAAC,IAAkB,EAAE,EAAE;YACrC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAqC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAqC,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,GAAG,CAA4B,KAAQ,EAAE,OAAmC;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,CAAC,OAAuB,CAAC,CAAC;YACzC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAA4B,KAAQ,EAAE,IAAkB;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,gEAAgE;YAChE,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,+CAA+C;oBAC/C,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB,CAA4B,KAAS;QACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAA4B,KAAQ;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./errors.js";
+export * from "./disposables.js";
+export * from "./time.js";
+export * from "./events.js";
+export * from "./assert.js";
+export * from "./platform.js";
+export * from "./pipe-path.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export * from "./errors.js";
+export * from "./disposables.js";
+export * from "./time.js";
+export * from "./events.js";
+export * from "./assert.js";
+export * from "./platform.js";
+export * from "./pipe-path.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/utils/pipe-path.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cross-platform pipe path utilities for Named Pipes (Windows) and Unix Domain Sockets.
+ *
+ * Provides consistent path generation and cleanup across platforms.
+ */
+export declare class PipePath {
+    /**
+     * Generates a platform-specific pipe/socket path for a module.
+     *
+     * Windows: `\\.\pipe\<namespace>-<moduleId>`
+     * Unix: `/tmp/<namespace>-<moduleId>.sock`
+     *
+     * @param namespace - Application namespace (e.g., 'procwire')
+     * @param moduleId - Module identifier (e.g., 'worker-1')
+     * @returns Platform-specific pipe/socket path
+     *
+     * @example
+     * ```ts
+     * // Windows: \\.\pipe\procwire-worker-1
+     * // Unix: /tmp/procwire-worker-1.sock
+     * const path = PipePath.forModule('procwire', 'worker-1');
+     * ```
+     */
+    static forModule(namespace: string, moduleId: string): string;
+    /**
+     * Cleans up a pipe/socket path (Unix only).
+     *
+     * On Unix, removes the socket file if it exists.
+     * On Windows, this is a no-op (Named Pipes are virtual).
+     *
+     * @param pipePath - Path to clean up
+     *
+     * @example
+     * ```ts
+     * await PipePath.cleanup('/tmp/my-socket.sock');
+     * ```
+     */
+    static cleanup(pipePath: string): Promise<void>;
+    /**
+     * Sanitizes a string to be safe for use in pipe/socket names.
+     * Removes or replaces characters that could cause issues.
+     *
+     * @param input - String to sanitize
+     * @returns Sanitized string
+     */
+    private static sanitize;
+}
+//# sourceMappingURL=pipe-path.d.ts.map

package/dist/utils/pipe-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe-path.d.ts","sourceRoot":"","sources":["../../src/utils/pipe-path.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAe7D;;;;;;;;;;;;OAYG;WACU,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CAMxB"}

package/dist/utils/pipe-path.js

@@ -0,0 +1,89 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { isWindows } from "./platform.js";
+/**
+ * Cross-platform pipe path utilities for Named Pipes (Windows) and Unix Domain Sockets.
+ *
+ * Provides consistent path generation and cleanup across platforms.
+ */
+export class PipePath {
+    /**
+     * Generates a platform-specific pipe/socket path for a module.
+     *
+     * Windows: `\\.\pipe\<namespace>-<moduleId>`
+     * Unix: `/tmp/<namespace>-<moduleId>.sock`
+     *
+     * @param namespace - Application namespace (e.g., 'procwire')
+     * @param moduleId - Module identifier (e.g., 'worker-1')
+     * @returns Platform-specific pipe/socket path
+     *
+     * @example
+     * ```ts
+     * // Windows: \\.\pipe\procwire-worker-1
+     * // Unix: /tmp/procwire-worker-1.sock
+     * const path = PipePath.forModule('procwire', 'worker-1');
+     * ```
+     */
+    static forModule(namespace, moduleId) {
+        // Sanitize inputs to remove problematic characters
+        const sanitizedNamespace = this.sanitize(namespace);
+        const sanitizedModuleId = this.sanitize(moduleId);
+        const name = `${sanitizedNamespace}-${sanitizedModuleId}`;
+        if (isWindows()) {
+            // Windows Named Pipe: \\.\pipe\<name>
+            return `\\\\.\\pipe\\${name}`;
+        }
+        else {
+            // Unix Domain Socket: /tmp/<name>.sock
+            return path.join("/tmp", `${name}.sock`);
+        }
+    }
+    /**
+     * Cleans up a pipe/socket path (Unix only).
+     *
+     * On Unix, removes the socket file if it exists.
+     * On Windows, this is a no-op (Named Pipes are virtual).
+     *
+     * @param pipePath - Path to clean up
+     *
+     * @example
+     * ```ts
+     * await PipePath.cleanup('/tmp/my-socket.sock');
+     * ```
+     */
+    static async cleanup(pipePath) {
+        if (isWindows()) {
+            // Windows Named Pipes are virtual, no cleanup needed
+            return;
+        }
+        try {
+            // Check if file exists and is a socket
+            const stats = await fs.stat(pipePath);
+            if (stats.isSocket()) {
+                await fs.unlink(pipePath);
+            }
+        }
+        catch (error) {
+            // Ignore errors (file doesn't exist, permission issues, etc.)
+            // This is expected and safe
+            if (error.code !== "ENOENT") {
+                // Log unexpected errors but don't throw
+                // (we don't have a logger yet, so silently ignore)
+            }
+        }
+    }
+    /**
+     * Sanitizes a string to be safe for use in pipe/socket names.
+     * Removes or replaces characters that could cause issues.
+     *
+     * @param input - String to sanitize
+     * @returns Sanitized string
+     */
+    static sanitize(input) {
+        return input
+            .replace(/[^a-zA-Z0-9_-]/g, "_") // Replace non-alphanumeric (except _ and -) with _
+            .replace(/_{2,}/g, "_") // Replace multiple underscores with single
+            .replace(/^_+|_+$/g, ""); // Trim underscores from start/end
+    }
+}
+//# sourceMappingURL=pipe-path.js.map

package/dist/utils/pipe-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe-path.js","sourceRoot":"","sources":["../../src/utils/pipe-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAiB,EAAE,QAAgB;QAClD,mDAAmD;QACnD,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,GAAG,kBAAkB,IAAI,iBAAiB,EAAE,CAAC;QAE1D,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,sCAAsC;YACtC,OAAO,gBAAgB,IAAI,EAAE,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAgB;QACnC,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,qDAAqD;YACrD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,uCAAuC;YACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8DAA8D;YAC9D,4BAA4B;YAC5B,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,wCAAwC;gBACxC,mDAAmD;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,QAAQ,CAAC,KAAa;QACnC,OAAO,KAAK;aACT,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,mDAAmD;aACnF,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,2CAA2C;aAClE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC;IAChE,CAAC;CACF"}

package/dist/utils/platform.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Platform detection utilities for cross-platform transport implementation.
+ */
+/**
+ * Returns true if running on Windows platform.
+ */
+export declare function isWindows(): boolean;
+/**
+ * Returns true if running on Unix-like platform (Linux, macOS, BSD).
+ */
+export declare function isUnix(): boolean;
+/**
+ * Returns current platform identifier.
+ */
+export declare function getPlatform(): NodeJS.Platform;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,QAAQ,CAE7C"}

package/dist/utils/platform.js

@@ -0,0 +1,22 @@
+/**
+ * Platform detection utilities for cross-platform transport implementation.
+ */
+/**
+ * Returns true if running on Windows platform.
+ */
+export function isWindows() {
+    return process.platform === "win32";
+}
+/**
+ * Returns true if running on Unix-like platform (Linux, macOS, BSD).
+ */
+export function isUnix() {
+    return process.platform === "darwin" || process.platform === "linux" || process.platform === "freebsd";
+}
+/**
+ * Returns current platform identifier.
+ */
+export function getPlatform() {
+    return process.platform;
+}
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;AACzG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Sleeps for specified milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Options for withTimeout.
+ */
+export interface TimeoutOptions {
+    /**
+     * Custom error message for timeout.
+     */
+    message?: string;
+    /**
+     * Cause to attach to timeout error.
+     */
+    cause?: unknown;
+}
+/**
+ * Wraps a promise with a timeout.
+ * Throws TimeoutError if promise doesn't settle within ms.
+ *
+ * @param promise - Promise to wrap
+ * @param ms - Timeout in milliseconds
+ * @param options - Optional message and cause for timeout error
+ * @returns Promise that rejects with TimeoutError on timeout
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, options?: TimeoutOptions): Promise<T>;
+/**
+ * Creates a timeout signal that resolves after ms.
+ * Useful for race conditions with manual cancellation.
+ *
+ * @returns Object with promise and cancel function
+ */
+export declare function createTimeoutSignal(ms: number): {
+    promise: Promise<never>;
+    cancel: () => void;
+};
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG;IAC/C,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAiBA"}

package/dist/utils/time.js

@@ -0,0 +1,55 @@
+import { TimeoutError } from "./errors.js";
+/**
+ * Sleeps for specified milliseconds.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Wraps a promise with a timeout.
+ * Throws TimeoutError if promise doesn't settle within ms.
+ *
+ * @param promise - Promise to wrap
+ * @param ms - Timeout in milliseconds
+ * @param options - Optional message and cause for timeout error
+ * @returns Promise that rejects with TimeoutError on timeout
+ */
+export function withTimeout(promise, ms, options) {
+    return new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            const message = options?.message ?? `Operation timed out after ${ms}ms`;
+            reject(new TimeoutError(message, options?.cause));
+        }, ms);
+        promise
+            .then((value) => {
+            clearTimeout(timeoutId);
+            resolve(value);
+        })
+            .catch((error) => {
+            clearTimeout(timeoutId);
+            reject(error);
+        });
+    });
+}
+/**
+ * Creates a timeout signal that resolves after ms.
+ * Useful for race conditions with manual cancellation.
+ *
+ * @returns Object with promise and cancel function
+ */
+export function createTimeoutSignal(ms) {
+    let timeoutId;
+    const promise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new TimeoutError(`Timeout after ${ms}ms`));
+        }, ms);
+    });
+    const cancel = () => {
+        if (timeoutId !== undefined) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+        }
+    };
+    return { promise, cancel };
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAiBD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,OAAmB,EACnB,EAAU,EACV,OAAwB;IAExB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,IAAI,CAAC;YACxE,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACpD,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO;aACJ,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAI5C,IAAI,SAAqC,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,YAAY,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@procwire/transport",
+  "version": "0.1.1",
+  "description": "Standalone IPC transport building blocks for Node.js (core; zero runtime dependencies).",
+  "keywords": [
+    "ipc",
+    "inter-process-communication",
+    "stdio",
+    "pipes",
+    "sockets",
+    "json-rpc",
+    "transport",
+    "node",
+    "typescript"
+  ],
+  "author": "Sebastian Webdev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SebastianWebdev/procwire.git",
+    "directory": "transport"
+  },
+  "bugs": {
+    "url": "https://github.com/SebastianWebdev/procwire/issues"
+  },
+  "homepage": "https://github.com/SebastianWebdev/procwire/tree/main/transport#readme",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./transport": {
+      "types": "./dist/transport/index.d.ts",
+      "default": "./dist/transport/index.js"
+    },
+    "./framing": {
+      "types": "./dist/framing/index.d.ts",
+      "default": "./dist/framing/index.js"
+    },
+    "./serialization": {
+      "types": "./dist/serialization/index.d.ts",
+      "default": "./dist/serialization/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "default": "./dist/protocol/index.js"
+    },
+    "./channel": {
+      "types": "./dist/channel/index.d.ts",
+      "default": "./dist/channel/index.js"
+    },
+    "./process": {
+      "types": "./dist/process/index.d.ts",
+      "default": "./dist/process/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "clean": "rimraf dist \"*.tsbuildinfo\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run"
+  }
+}