@procwire/transport 0.1.1

package/dist/transport/stdio-transport.js

@@ -0,0 +1,234 @@
+import * as childProcess from "node:child_process";
+import { EventEmitter } from "../utils/events.js";
+import { TransportError, TimeoutError } from "../utils/errors.js";
+/**
+ * Stdio-based transport for parent-child process communication.
+ *
+ * Spawns a child process and communicates via stdin/stdout.
+ * Stderr is exposed via separate 'stderr' event.
+ *
+ * @example
+ * ```ts
+ * const transport = new StdioTransport({
+ *   executablePath: 'node',
+ *   args: ['worker.js']
+ * });
+ *
+ * await transport.connect(); // Spawns process
+ * await transport.write(Buffer.from('hello'));
+ * transport.onData(data => console.log('received:', data));
+ * transport.on('stderr', line => console.error('stderr:', line));
+ * ```
+ */
+export class StdioTransport {
+    emitter = new EventEmitter();
+    options;
+    process = null;
+    _state = "disconnected";
+    startupTimer = null;
+    stdoutBytesReceived = 0;
+    stderrBytesReceived = 0;
+    constructor(options) {
+        this.options = {
+            executablePath: options.executablePath,
+            args: options.args ?? [],
+            cwd: options.cwd ?? process.cwd(),
+            env: options.env ?? process.env,
+            startupTimeout: options.startupTimeout ?? 10000,
+            maxStdoutBuffer: options.maxStdoutBuffer ?? 10 * 1024 * 1024, // 10MB
+            maxStderrBuffer: options.maxStderrBuffer ?? 1 * 1024 * 1024, // 1MB
+        };
+    }
+    get state() {
+        return this._state;
+    }
+    async connect() {
+        if (this._state === "connected") {
+            throw new TransportError("Already connected");
+        }
+        if (this._state === "connecting") {
+            throw new TransportError("Connection already in progress");
+        }
+        this._state = "connecting";
+        return new Promise((resolve, reject) => {
+            try {
+                const proc = childProcess.spawn(this.options.executablePath, this.options.args, {
+                    cwd: this.options.cwd,
+                    env: this.options.env,
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+                this.process = proc;
+                // Startup timeout
+                this.startupTimer = setTimeout(() => {
+                    proc.kill();
+                    this._state = "error";
+                    const error = new TransportError(`Process startup timeout after ${this.options.startupTimeout}ms`, new TimeoutError(`Startup timeout`));
+                    this.emitter.emit("error", error);
+                    reject(error);
+                }, this.options.startupTimeout);
+                // Wait for spawn event (process started successfully)
+                proc.once("spawn", () => {
+                    if (this.startupTimer) {
+                        clearTimeout(this.startupTimer);
+                        this.startupTimer = null;
+                    }
+                    this._state = "connected";
+                    this.setupProcessListeners(proc);
+                    this.emitter.emit("connect", undefined);
+                    resolve();
+                });
+                // Handle spawn errors
+                proc.once("error", (err) => {
+                    if (this.startupTimer) {
+                        clearTimeout(this.startupTimer);
+                        this.startupTimer = null;
+                    }
+                    this._state = "error";
+                    const error = new TransportError(`Failed to spawn process: ${err.message}`, err);
+                    this.emitter.emit("error", error);
+                    reject(error);
+                });
+            }
+            catch (err) {
+                this._state = "error";
+                const error = new TransportError(`Failed to create process: ${err.message}`, err);
+                reject(error);
+            }
+        });
+    }
+    async disconnect() {
+        if (this._state === "disconnected") {
+            return;
+        }
+        if (this.startupTimer) {
+            clearTimeout(this.startupTimer);
+            this.startupTimer = null;
+        }
+        if (this.process) {
+            return new Promise((resolve) => {
+                const proc = this.process;
+                // Close stdin first (graceful signal)
+                if (proc.stdin && !proc.stdin.destroyed) {
+                    proc.stdin.end();
+                }
+                // Wait for exit
+                proc.once("exit", () => {
+                    this.cleanup();
+                    resolve();
+                });
+                // Force kill after timeout
+                setTimeout(() => {
+                    if (!proc.killed) {
+                        proc.kill("SIGKILL");
+                    }
+                }, 2000);
+                // Try graceful first
+                proc.kill();
+            });
+        }
+        else {
+            this.cleanup();
+        }
+    }
+    async write(data) {
+        if (this._state !== "connected" || !this.process || !this.process.stdin) {
+            throw new TransportError("Not connected");
+        }
+        return new Promise((resolve, reject) => {
+            const stdin = this.process.stdin;
+            if (stdin.destroyed) {
+                reject(new TransportError("Stdin is closed"));
+                return;
+            }
+            const canContinue = stdin.write(data, (err) => {
+                if (err) {
+                    const error = new TransportError(`Write to stdin failed: ${err.message}`, err);
+                    this.emitter.emit("error", error);
+                    reject(error);
+                }
+                else {
+                    resolve();
+                }
+            });
+            // Handle backpressure
+            if (!canContinue) {
+                stdin.once("drain", () => {
+                    // Buffer drained, can continue writing
+                });
+            }
+        });
+    }
+    onData(handler) {
+        return this.emitter.on("data", handler);
+    }
+    on(event, handler) {
+        return this.emitter.on(event, handler);
+    }
+    setupProcessListeners(proc) {
+        // Stdout data
+        if (proc.stdout) {
+            proc.stdout.on("data", (data) => {
+                this.stdoutBytesReceived += data.length;
+                if (this.stdoutBytesReceived > this.options.maxStdoutBuffer) {
+                    const error = new TransportError(`Stdout buffer exceeded limit of ${this.options.maxStdoutBuffer} bytes`);
+                    this.emitter.emit("error", error);
+                    this.disconnect();
+                    return;
+                }
+                this.emitter.emit("data", data);
+            });
+        }
+        // Stderr data (as strings/lines)
+        if (proc.stderr) {
+            proc.stderr.setEncoding("utf8");
+            proc.stderr.on("data", (data) => {
+                this.stderrBytesReceived += Buffer.byteLength(data);
+                if (this.stderrBytesReceived > this.options.maxStderrBuffer) {
+                    const error = new TransportError(`Stderr buffer exceeded limit of ${this.options.maxStderrBuffer} bytes`);
+                    this.emitter.emit("error", error);
+                    this.disconnect();
+                    return;
+                }
+                this.emitter.emit("stderr", data);
+            });
+        }
+        // Process exit
+        proc.on("exit", (code, signal) => {
+            this.emitter.emit("exit", { code, signal });
+            this.cleanup();
+        });
+        // Process errors
+        proc.on("error", (err) => {
+            this._state = "error";
+            const error = new TransportError(`Process error: ${err.message}`, err);
+            this.emitter.emit("error", error);
+        });
+    }
+    cleanup() {
+        if (this.process) {
+            this.process.removeAllListeners();
+            // Close streams
+            if (this.process.stdin && !this.process.stdin.destroyed) {
+                this.process.stdin.destroy();
+            }
+            if (this.process.stdout && !this.process.stdout.destroyed) {
+                this.process.stdout.destroy();
+            }
+            if (this.process.stderr && !this.process.stderr.destroyed) {
+                this.process.stderr.destroy();
+            }
+            // Kill if still alive
+            if (!this.process.killed) {
+                this.process.kill();
+            }
+            this.process = null;
+        }
+        if (this._state !== "disconnected") {
+            this._state = "disconnected";
+            this.emitter.emit("disconnect", undefined);
+        }
+        this.stdoutBytesReceived = 0;
+        this.stderrBytesReceived = 0;
+    }
+}
+//# sourceMappingURL=stdio-transport.js.map

package/dist/transport/stdio-transport.js.map

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

package/dist/transport/types.d.ts

@@ -0,0 +1,131 @@
+import type { EventMap } from "../utils/events.js";
+import type { Unsubscribe } from "../utils/disposables.js";
+/**
+ * Transport connection state.
+ */
+export type TransportState = "disconnected" | "connecting" | "connected" | "error";
+/**
+ * Transport events map.
+ */
+export interface TransportEvents extends EventMap {
+    /**
+     * Fired when transport successfully connects.
+     */
+    connect: void;
+    /**
+     * Fired when transport disconnects (graceful or error).
+     */
+    disconnect: void;
+    /**
+     * Fired when an error occurs.
+     */
+    error: Error;
+    /**
+     * Fired when data is received.
+     */
+    data: Buffer;
+}
+/**
+ * Base transport interface for bidirectional byte streams.
+ * Implementations: stdio, named pipes, unix sockets, TCP, etc.
+ */
+export interface Transport {
+    /**
+     * Current connection state.
+     */
+    readonly state: TransportState;
+    /**
+     * Initiates connection.
+     * @throws {TransportError} if already connected or invalid state
+     */
+    connect(): Promise<void>;
+    /**
+     * Closes the connection gracefully.
+     * @throws {TransportError} if not connected
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Writes data to the transport.
+     * @throws {TransportError} if not connected or write fails
+     */
+    write(data: Buffer): Promise<void>;
+    /**
+     * Subscribes to data events.
+     * @returns Unsubscribe function
+     */
+    onData(handler: (data: Buffer) => void): Unsubscribe;
+    /**
+     * Subscribes to transport events.
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof TransportEvents>(event: K, handler: (data: TransportEvents[K]) => void): Unsubscribe;
+}
+/**
+ * Server address information.
+ */
+export interface ServerAddress {
+    /**
+     * Address type (pipe name, unix socket path, TCP port, etc.)
+     */
+    type: "pipe" | "unix" | "tcp";
+    /**
+     * Address value (platform-specific).
+     */
+    value: string | number;
+}
+/**
+ * Transport server events map.
+ */
+export interface TransportServerEvents extends EventMap {
+    /**
+     * Fired when server starts listening.
+     */
+    listening: ServerAddress;
+    /**
+     * Fired when new client connection is established.
+     */
+    connection: Transport;
+    /**
+     * Fired when server closes.
+     */
+    close: void;
+    /**
+     * Fired when server error occurs.
+     */
+    error: Error;
+}
+/**
+ * Transport server interface for accepting client connections.
+ * Implementations: named pipe server, unix socket server, TCP server.
+ */
+export interface TransportServer {
+    /**
+     * Returns true if server is currently listening.
+     */
+    readonly isListening: boolean;
+    /**
+     * Server address (only available when listening).
+     */
+    readonly address: ServerAddress | null;
+    /**
+     * Starts listening for connections.
+     * @param address - Platform-specific address (pipe name, socket path, port)
+     * @throws {TransportError} if already listening
+     */
+    listen(address: string | number): Promise<ServerAddress>;
+    /**
+     * Stops the server and closes all active connections.
+     */
+    close(): Promise<void>;
+    /**
+     * Subscribes to new connection events.
+     * @returns Unsubscribe function
+     */
+    onConnection(handler: (transport: Transport) => void): Unsubscribe;
+    /**
+     * Subscribes to server events.
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof TransportServerEvents>(event: K, handler: (data: TransportServerEvents[K]) => void): Unsubscribe;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C;;OAEG;IACH,OAAO,EAAE,IAAI,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,IAAI,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,CAAC;IAErD;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,EAChC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1C,WAAW,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,QAAQ;IACrD;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;IAEzB;;OAEG;IACH,UAAU,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,WAAW,CAAC;IAEnE;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAChD,WAAW,CAAC;CAChB"}

package/dist/transport/types.js

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

package/dist/transport/types.js.map

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

package/dist/utils/assert.d.ts

@@ -0,0 +1,16 @@
+import type { TransportState } from "../transport/types.js";
+/**
+ * Asserts that current state is one of the allowed states.
+ * Throws TransportError if not.
+ */
+export declare function assertState(current: TransportState, allowed: TransportState[]): void;
+/**
+ * Map of allowed state transitions.
+ */
+export declare const TRANSPORT_STATE_TRANSITIONS: Record<TransportState, TransportState[]>;
+/**
+ * Validates and returns next state if transition is allowed.
+ * Throws TransportError if transition is invalid.
+ */
+export declare function transitionState(current: TransportState, next: TransportState): TransportState;
+//# sourceMappingURL=assert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,CAMpF;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,CAKhF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,CAQ7F"}

package/dist/utils/assert.js

@@ -0,0 +1,31 @@
+import { TransportError } from "./errors.js";
+/**
+ * Asserts that current state is one of the allowed states.
+ * Throws TransportError if not.
+ */
+export function assertState(current, allowed) {
+    if (!allowed.includes(current)) {
+        throw new TransportError(`Invalid state: expected one of [${allowed.join(", ")}], got '${current}'`);
+    }
+}
+/**
+ * Map of allowed state transitions.
+ */
+export const TRANSPORT_STATE_TRANSITIONS = {
+    disconnected: ["connecting"],
+    connecting: ["connected", "error", "disconnected"],
+    connected: ["disconnected", "error"],
+    error: ["disconnected"],
+};
+/**
+ * Validates and returns next state if transition is allowed.
+ * Throws TransportError if transition is invalid.
+ */
+export function transitionState(current, next) {
+    const allowed = TRANSPORT_STATE_TRANSITIONS[current];
+    if (!allowed.includes(next)) {
+        throw new TransportError(`Invalid state transition: '${current}' -> '${next}'. Allowed: [${allowed.join(", ")}]`);
+    }
+    return next;
+}
+//# sourceMappingURL=assert.js.map

package/dist/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAuB,EAAE,OAAyB;IAC5E,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,cAAc,CACtB,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,OAAO,GAAG,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA6C;IACnF,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,UAAU,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC;IAClD,SAAS,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC;IACpC,KAAK,EAAE,CAAC,cAAc,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAuB,EAAE,IAAoB;IAC3E,MAAM,OAAO,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,8BAA8B,OAAO,SAAS,IAAI,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/disposables.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Function that performs cleanup/unsubscribe when called.
+ */
+export type Unsubscribe = () => void;
+/**
+ * Object that can be disposed (has dispose method).
+ */
+export interface DisposableLike {
+    dispose(): void;
+}
+/**
+ * Converts a function to an Unsubscribe function.
+ * Ensures idempotency (can be called multiple times safely).
+ */
+export declare function createUnsubscribe(fn: () => void): Unsubscribe;
+/**
+ * Collects multiple unsubscribe functions and disposes them all at once.
+ * Useful for cleanup in components/channels that manage multiple subscriptions.
+ */
+export declare class CompositeDisposable {
+    private readonly disposables;
+    private disposed;
+    /**
+     * Adds an unsubscribe function to the composite.
+     * If already disposed, calls it immediately.
+     */
+    add(unsubscribe: Unsubscribe): void;
+    /**
+     * Disposes all collected unsubscribe functions.
+     * Safe to call multiple times (idempotent).
+     */
+    dispose(): void;
+    /**
+     * Returns true if already disposed.
+     */
+    isDisposed(): boolean;
+}
+//# sourceMappingURL=disposables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disposables.d.ts","sourceRoot":"","sources":["../../src/utils/disposables.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW,CAQ7D;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;OAGG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAQnC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAgBf;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/utils/disposables.js

@@ -0,0 +1,59 @@
+/**
+ * Converts a function to an Unsubscribe function.
+ * Ensures idempotency (can be called multiple times safely).
+ */
+export function createUnsubscribe(fn) {
+    let disposed = false;
+    return () => {
+        if (!disposed) {
+            disposed = true;
+            fn();
+        }
+    };
+}
+/**
+ * Collects multiple unsubscribe functions and disposes them all at once.
+ * Useful for cleanup in components/channels that manage multiple subscriptions.
+ */
+export class CompositeDisposable {
+    disposables = [];
+    disposed = false;
+    /**
+     * Adds an unsubscribe function to the composite.
+     * If already disposed, calls it immediately.
+     */
+    add(unsubscribe) {
+        if (this.disposed) {
+            unsubscribe();
+            return;
+        }
+        this.disposables.push(unsubscribe);
+    }
+    /**
+     * Disposes all collected unsubscribe functions.
+     * Safe to call multiple times (idempotent).
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        for (const unsubscribe of this.disposables) {
+            try {
+                unsubscribe();
+            }
+            catch (error) {
+                // Log but don't throw - we want to dispose all
+                console.error("Error during disposal:", error);
+            }
+        }
+        this.disposables.length = 0;
+    }
+    /**
+     * Returns true if already disposed.
+     */
+    isDisposed() {
+        return this.disposed;
+    }
+}
+//# sourceMappingURL=disposables.js.map

package/dist/utils/disposables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposables.js","sourceRoot":"","sources":["../../src/utils/disposables.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAc;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,EAAE,EAAE,CAAC;QACP,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACb,WAAW,GAAkB,EAAE,CAAC;IACzC,QAAQ,GAAG,KAAK,CAAC;IAEzB;;;OAGG;IACH,GAAG,CAAC,WAAwB;QAC1B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,WAAW,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,WAAW,EAAE,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,+CAA+C;gBAC/C,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Base error class for all Aspect IPC errors.
+ */
+export declare class AspectIpcError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, cause?: unknown);
+}
+/**
+ * Transport-layer error (connection, I/O, etc.)
+ */
+export declare class TransportError extends AspectIpcError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Protocol-layer error (parsing, validation, etc.)
+ */
+export declare class ProtocolError extends AspectIpcError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Timeout error (request timeout, connection timeout, etc.)
+ */
+export declare class TimeoutError extends AspectIpcError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Serialization error (encode/decode failures)
+ */
+export declare class SerializationError extends AspectIpcError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Framing error (invalid frame format, buffer overflow, etc.)
+ */
+export declare class FramingError extends AspectIpcError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Converts unknown value to Error instance.
+ * Useful for catch blocks and error normalization.
+ */
+export declare function toError(value: unknown): Error;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAU3D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQ7C"}

package/dist/utils/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Base error class for all Aspect IPC errors.
+ */
+export class AspectIpcError extends Error {
+    code;
+    constructor(message, code, cause) {
+        super(message, { cause });
+        this.name = this.constructor.name;
+        this.code = code;
+        // Maintain proper stack trace in V8 engines
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * Transport-layer error (connection, I/O, etc.)
+ */
+export class TransportError extends AspectIpcError {
+    constructor(message, cause) {
+        super(message, "TRANSPORT_ERROR", cause);
+    }
+}
+/**
+ * Protocol-layer error (parsing, validation, etc.)
+ */
+export class ProtocolError extends AspectIpcError {
+    constructor(message, cause) {
+        super(message, "PROTOCOL_ERROR", cause);
+    }
+}
+/**
+ * Timeout error (request timeout, connection timeout, etc.)
+ */
+export class TimeoutError extends AspectIpcError {
+    constructor(message, cause) {
+        super(message, "TIMEOUT_ERROR", cause);
+    }
+}
+/**
+ * Serialization error (encode/decode failures)
+ */
+export class SerializationError extends AspectIpcError {
+    constructor(message, cause) {
+        super(message, "SERIALIZATION_ERROR", cause);
+    }
+}
+/**
+ * Framing error (invalid frame format, buffer overflow, etc.)
+ */
+export class FramingError extends AspectIpcError {
+    constructor(message, cause) {
+        super(message, "FRAMING_ERROR", cause);
+    }
+}
+/**
+ * Converts unknown value to Error instance.
+ * Useful for catch blocks and error normalization.
+ */
+export function toError(value) {
+    if (value instanceof Error) {
+        return value;
+    }
+    if (typeof value === "string") {
+        return new Error(value);
+    }
+    return new Error(String(value));
+}
+//# sourceMappingURL=errors.js.map