@procwire/bun-client 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Client class - Child-side API for Procwire IPC.
+ *
+ * This is the Bun.js optimized version using Bun.listen() for named pipe server.
+ *
+ * RESPONSIBILITIES:
+ * - Register method handlers
+ * - Register events
+ * - Create named pipe server
+ * - Send $init to parent
+ * - Handle incoming requests
+ * - Emit events to parent
+ *
+ * @module
+ */
+import { EventEmitter } from "node:events";
+import type { MethodDefinition, EventDefinition, MethodHandler, ClientOptions } from "./types.js";
+import { BunDrainWaiter } from "./drain-waiter.js";
+type BunSocket = Awaited<ReturnType<typeof Bun.connect>>;
+/**
+ * Client - Child-side API for Procwire IPC.
+ *
+ * This is the Bun.js optimized version.
+ *
+ * @example
+ * ```typescript
+ * const client = new Client()
+ *   .handle('query', async (data, ctx) => {
+ *     const results = await search(data);
+ *     ctx.respond(results);
+ *   })
+ *   .handle('insert', async (data, ctx) => {
+ *     ctx.ack({ accepted: true });
+ *     await processInBackground(data);
+ *   })
+ *   .event('progress');
+ *
+ * await client.start();
+ *
+ * // Emit events to parent
+ * client.emitEvent('progress', { percent: 50 });
+ * ```
+ */
+export declare class Client extends EventEmitter {
+    private _defaultCodec;
+    private _methods;
+    private _events;
+    private _server;
+    private _socket;
+    private _frameBuffer;
+    private _methodNameToId;
+    private _methodIdToName;
+    private _eventNameToId;
+    private _abortCallbacks;
+    private _activeContexts;
+    private _started;
+    private readonly _headerPool;
+    private _headerPoolIndex;
+    private _drainWaiter;
+    constructor(options?: ClientOptions);
+    /**
+     * Register a method handler.
+     *
+     * @param method - Method name
+     * @param handler - Handler function
+     * @param options - Method configuration
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * client.handle('query', async (data, ctx) => {
+     *   ctx.respond({ results: [] });
+     * });
+     * ```
+     */
+    handle<TData = unknown>(method: string, handler: MethodHandler<TData>, options?: Partial<MethodDefinition>): this;
+    /**
+     * Register an event that can be emitted to parent.
+     *
+     * @param name - Event name
+     * @param options - Event configuration
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * client.event('progress');
+     * client.event('status', { codec: arrowCodec });
+     * ```
+     */
+    event(name: string, options?: Partial<EventDefinition>): this;
+    /**
+     * Start the client.
+     *
+     * Creates named pipe server using Bun.listen(), waits for server to be ready,
+     * then sends $init to parent.
+     *
+     * @example
+     * ```typescript
+     * await client.start();
+     * // Client is now ready to receive requests
+     * ```
+     */
+    start(): Promise<void>;
+    /**
+     * Emit an event to parent.
+     *
+     * @param eventName - Event name (must be registered with .event())
+     * @param data - Event data
+     * @returns Promise that resolves when the event has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     *
+     * @example
+     * ```typescript
+     * await client.emitEvent('progress', { percent: 50 });
+     * ```
+     */
+    emitEvent(eventName: string, data: unknown): Promise<void>;
+    /**
+     * Graceful shutdown.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Whether client is connected to parent.
+     */
+    get connected(): boolean;
+    /**
+     * @internal Acquire a header buffer from the ring pool.
+     */
+    _acquireHeaderBuffer(): Buffer;
+    /**
+     * @internal Get the drain waiter instance.
+     */
+    _getDrainWaiter(): BunDrainWaiter | null;
+    /**
+     * @internal Get the socket instance.
+     */
+    _getSocket(): BunSocket | null;
+    private _generatePipePath;
+    private _createPipeServer;
+    private _sendInit;
+    private _handleFrame;
+    private _handleAbort;
+    private _sendErrorResponse;
+    /**
+     * Send a frame with proper backpressure handling.
+     * Used for emitting events to parent.
+     *
+     * Bun sockets don't have cork/uncork, so we concatenate buffers.
+     */
+    private _sendFrame;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGlG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,KAAK,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,MAAO,SAAQ,YAAY;IACtC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAwE;IACxF,OAAO,CAAC,OAAO,CAAsC;IAErD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAA4B;IAEhD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAA6B;IAEnD,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IACF,OAAO,CAAC,gBAAgB,CAAK;IAG7B,OAAO,CAAC,YAAY,CAA+B;gBAEvC,OAAO,CAAC,EAAE,aAAa;IASnC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,KAAK,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAC7B,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,IAAI;IAiBP;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAY7D;;;;;;;;;;;OAWG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAMD;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAM9B;;OAEG;IACH,eAAe,IAAI,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,UAAU,IAAI,SAAS,GAAG,IAAI;IAQ9B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,iBAAiB;IA2CzB,OAAO,CAAC,SAAS;IAqCjB,OAAO,CAAC,YAAY;IAyEpB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,kBAAkB;IAsB1B;;;;;OAKG;YACW,UAAU;CA6BzB"}

package/dist/client.js

@@ -0,0 +1,423 @@
+/**
+ * Client class - Child-side API for Procwire IPC.
+ *
+ * This is the Bun.js optimized version using Bun.listen() for named pipe server.
+ *
+ * RESPONSIBILITIES:
+ * - Register method handlers
+ * - Register events
+ * - Create named pipe server
+ * - Send $init to parent
+ * - Handle incoming requests
+ * - Emit events to parent
+ *
+ * @module
+ */
+import { EventEmitter } from "node:events";
+import { FrameBuffer, Flags, encodeHeaderInto, HEADER_SIZE, HEADER_POOL_SIZE, ABORT_METHOD_ID, } from "@procwire/protocol";
+import { msgpackCodec, codecDeserialize } from "@procwire/codecs";
+import { RequestContextImpl } from "./request-context.js";
+import { ClientErrors } from "./errors.js";
+import { BunDrainWaiter } from "./drain-waiter.js";
+/**
+ * Client - Child-side API for Procwire IPC.
+ *
+ * This is the Bun.js optimized version.
+ *
+ * @example
+ * ```typescript
+ * const client = new Client()
+ *   .handle('query', async (data, ctx) => {
+ *     const results = await search(data);
+ *     ctx.respond(results);
+ *   })
+ *   .handle('insert', async (data, ctx) => {
+ *     ctx.ack({ accepted: true });
+ *     await processInBackground(data);
+ *   })
+ *   .event('progress');
+ *
+ * await client.start();
+ *
+ * // Emit events to parent
+ * client.emitEvent('progress', { percent: 50 });
+ * ```
+ */
+export class Client extends EventEmitter {
+    _defaultCodec;
+    _methods = new Map();
+    _events = new Map();
+    _server = null;
+    _socket = null;
+    _frameBuffer = null;
+    _methodNameToId = new Map();
+    _methodIdToName = new Map();
+    _eventNameToId = new Map();
+    _abortCallbacks = new Map();
+    _activeContexts = new Map();
+    _started = false;
+    // Ring buffer for headers (OPT-02: allocation-free sends)
+    _headerPool = Array.from({ length: HEADER_POOL_SIZE }, () => Buffer.allocUnsafe(HEADER_SIZE));
+    _headerPoolIndex = 0;
+    // OPT-04: Backpressure tracking via BunDrainWaiter
+    _drainWaiter = null;
+    constructor(options) {
+        super();
+        this._defaultCodec = options?.defaultCodec ?? msgpackCodec;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // BUILDER API
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Register a method handler.
+     *
+     * @param method - Method name
+     * @param handler - Handler function
+     * @param options - Method configuration
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * client.handle('query', async (data, ctx) => {
+     *   ctx.respond({ results: [] });
+     * });
+     * ```
+     */
+    handle(method, handler, options) {
+        if (this._started) {
+            throw ClientErrors.cannotAddHandlerAfterStart();
+        }
+        this._methods.set(method, {
+            def: {
+                response: options?.response ?? "result",
+                codec: options?.codec ?? this._defaultCodec,
+                cancellable: options?.cancellable ?? false,
+            },
+            handler: handler,
+        });
+        return this;
+    }
+    /**
+     * Register an event that can be emitted to parent.
+     *
+     * @param name - Event name
+     * @param options - Event configuration
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * client.event('progress');
+     * client.event('status', { codec: arrowCodec });
+     * ```
+     */
+    event(name, options) {
+        if (this._started) {
+            throw ClientErrors.cannotAddEventAfterStart();
+        }
+        this._events.set(name, {
+            codec: options?.codec ?? this._defaultCodec,
+        });
+        return this;
+    }
+    /**
+     * Start the client.
+     *
+     * Creates named pipe server using Bun.listen(), waits for server to be ready,
+     * then sends $init to parent.
+     *
+     * @example
+     * ```typescript
+     * await client.start();
+     * // Client is now ready to receive requests
+     * ```
+     */
+    async start() {
+        if (this._started) {
+            throw ClientErrors.alreadyStarted();
+        }
+        this._started = true;
+        // Assign IDs to methods and events
+        let methodId = 1;
+        for (const name of this._methods.keys()) {
+            this._methodNameToId.set(name, methodId);
+            this._methodIdToName.set(methodId, name);
+            methodId++;
+        }
+        let eventId = 1;
+        for (const name of this._events.keys()) {
+            this._eventNameToId.set(name, eventId);
+            eventId++;
+        }
+        // Create pipe path
+        const pipePath = this._generatePipePath();
+        // Create server and wait for listen
+        await this._createPipeServer(pipePath);
+        // Send $init to parent (via stdout, JSON-RPC control plane)
+        this._sendInit(pipePath);
+    }
+    /**
+     * Emit an event to parent.
+     *
+     * @param eventName - Event name (must be registered with .event())
+     * @param data - Event data
+     * @returns Promise that resolves when the event has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     *
+     * @example
+     * ```typescript
+     * await client.emitEvent('progress', { percent: 50 });
+     * ```
+     */
+    async emitEvent(eventName, data) {
+        if (!this._socket) {
+            throw ClientErrors.notConnected();
+        }
+        const eventId = this._eventNameToId.get(eventName);
+        if (eventId === undefined) {
+            throw ClientErrors.unknownEvent(eventName);
+        }
+        const eventDef = this._events.get(eventName);
+        const codec = eventDef.codec ?? this._defaultCodec;
+        await this._sendFrame(eventId, 0, data, codec, Flags.DIRECTION_TO_PARENT);
+    }
+    /**
+     * Graceful shutdown.
+     */
+    async shutdown() {
+        this._socket?.end();
+        this._server?.stop(true);
+        this._drainWaiter?.clear();
+        this._socket = null;
+        this._server = null;
+    }
+    /**
+     * Whether client is connected to parent.
+     */
+    get connected() {
+        return this._socket !== null;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // INTERNAL API (for RequestContextImpl)
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * @internal Acquire a header buffer from the ring pool.
+     */
+    _acquireHeaderBuffer() {
+        const buffer = this._headerPool[this._headerPoolIndex];
+        this._headerPoolIndex = (this._headerPoolIndex + 1) % HEADER_POOL_SIZE;
+        return buffer;
+    }
+    /**
+     * @internal Get the drain waiter instance.
+     */
+    _getDrainWaiter() {
+        return this._drainWaiter;
+    }
+    /**
+     * @internal Get the socket instance.
+     */
+    _getSocket() {
+        return this._socket;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRIVATE: Initialization
+    // ═══════════════════════════════════════════════════════════════════════════
+    _generatePipePath() {
+        const id = Math.random().toString(36).slice(2, 10);
+        return process.platform === "win32"
+            ? `\\\\.\\pipe\\procwire-${process.pid}-${id}`
+            : `/tmp/procwire-${process.pid}-${id}.sock`;
+    }
+    _createPipeServer(pipePath) {
+        return new Promise((resolve, reject) => {
+            try {
+                // Create server using Bun.listen with unix socket
+                this._server = Bun.listen({
+                    unix: pipePath,
+                    socket: {
+                        open: (socket) => {
+                            // Parent connected
+                            this._socket = socket;
+                            this._drainWaiter = new BunDrainWaiter();
+                            this._frameBuffer = new FrameBuffer();
+                        },
+                        data: (_socket, data) => {
+                            // Handle incoming data
+                            if (!this._frameBuffer)
+                                return;
+                            const frames = this._frameBuffer.push(data);
+                            for (const frame of frames) {
+                                this._handleFrame(frame);
+                            }
+                        },
+                        error: (_socket, err) => {
+                            this.emit("error", err);
+                        },
+                        close: (_socket) => {
+                            this._drainWaiter?.clear();
+                            this.emit("disconnected");
+                        },
+                        drain: (_socket) => {
+                            // Backpressure released
+                            this._drainWaiter?.onDrain();
+                        },
+                    },
+                });
+                // Server is listening
+                resolve();
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    _sendInit(pipePath) {
+        const schema = {
+            methods: Object.fromEntries(Array.from(this._methods.entries()).map(([name, { def }]) => [
+                name,
+                {
+                    id: this._methodNameToId.get(name),
+                    response: def.response,
+                },
+            ])),
+            events: Object.fromEntries(Array.from(this._events.keys()).map((name) => [
+                name,
+                { id: this._eventNameToId.get(name) },
+            ])),
+        };
+        const initMessage = {
+            jsonrpc: "2.0",
+            method: "$init",
+            params: {
+                pipe: pipePath,
+                schema,
+                version: "2.0.0",
+            },
+        };
+        // Write to stdout (JSON-RPC control plane)
+        console.log(JSON.stringify(initMessage));
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRIVATE: Frame Handling
+    // ═══════════════════════════════════════════════════════════════════════════
+    _handleFrame(frame) {
+        const { header } = frame;
+        // Abort signal (reserved methodId)
+        if (header.methodId === ABORT_METHOD_ID) {
+            this._handleAbort(header.requestId);
+            return;
+        }
+        // Request from parent
+        const methodName = this._methodIdToName.get(header.methodId);
+        if (!methodName) {
+            // Unknown method - send error response
+            this._sendErrorResponse(header.requestId, header.methodId, `Unknown method ID: ${header.methodId}`);
+            return;
+        }
+        const methodEntry = this._methods.get(methodName);
+        if (!methodEntry)
+            return;
+        const { def, handler } = methodEntry;
+        const codec = def.codec ?? this._defaultCodec;
+        const data = codecDeserialize(codec, frame);
+        // Create request context
+        const ctx = new RequestContextImpl(header.requestId, methodName, header.methodId, codec, this._socket, this._abortCallbacks, () => this._acquireHeaderBuffer(), this._drainWaiter);
+        // Track active context for abort handling
+        this._activeContexts.set(header.requestId, ctx);
+        // Call handler
+        try {
+            const result = handler(data, ctx);
+            if (result instanceof Promise) {
+                result
+                    .catch((err) => {
+                    if (!ctx.responded) {
+                        // ctx.error() is async - fire and forget with error handling
+                        ctx.error(err).catch(() => {
+                            /* ignore - socket may be closed */
+                        });
+                    }
+                })
+                    .finally(() => {
+                    this._activeContexts.delete(header.requestId);
+                });
+            }
+            else {
+                this._activeContexts.delete(header.requestId);
+            }
+        }
+        catch (err) {
+            if (!ctx.responded) {
+                // ctx.error() is async - fire and forget with error handling
+                ctx.error(err).catch(() => {
+                    /* ignore - socket may be closed */
+                });
+            }
+            this._activeContexts.delete(header.requestId);
+        }
+    }
+    _handleAbort(requestId) {
+        // Mark context as aborted
+        const ctx = this._activeContexts.get(requestId);
+        if (ctx) {
+            ctx._markAborted();
+        }
+        // Call abort callbacks
+        const callbacks = this._abortCallbacks.get(requestId);
+        if (callbacks) {
+            for (const cb of callbacks) {
+                try {
+                    cb();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            this._abortCallbacks.delete(requestId);
+        }
+    }
+    _sendErrorResponse(requestId, methodId, message) {
+        if (!this._socket)
+            return;
+        const payload = this._defaultCodec.serialize(message);
+        const headerBuf = this._acquireHeaderBuffer();
+        encodeHeaderInto(headerBuf, {
+            methodId,
+            flags: Flags.IS_RESPONSE | Flags.IS_ERROR | Flags.DIRECTION_TO_PARENT,
+            requestId,
+            payloadLength: payload.length,
+        });
+        // Bun doesn't have cork/uncork, concatenate for atomic write
+        const combined = Buffer.concat([headerBuf, payload]);
+        this._socket.write(combined);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRIVATE: Frame Sending
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Send a frame with proper backpressure handling.
+     * Used for emitting events to parent.
+     *
+     * Bun sockets don't have cork/uncork, so we concatenate buffers.
+     */
+    async _sendFrame(methodId, requestId, data, codec, flags) {
+        if (!this._socket || !this._drainWaiter)
+            return;
+        const payload = codec.serialize(data);
+        const headerBuf = this._acquireHeaderBuffer();
+        encodeHeaderInto(headerBuf, {
+            methodId,
+            flags,
+            requestId,
+            payloadLength: payload.length,
+        });
+        // Bun doesn't have cork/uncork, concatenate for atomic write
+        const combined = Buffer.concat([headerBuf, payload]);
+        const canContinue = this._socket.write(combined);
+        // OPT-04: Wait AFTER write if backpressure
+        if (!canContinue) {
+            this._drainWaiter.markNeedsDrain();
+            await this._drainWaiter.waitForDrain();
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/drain-waiter.d.ts

@@ -0,0 +1,74 @@
+/**
+ * BunDrainWaiter - Singleton pattern for Bun socket drain waiting.
+ *
+ * PROBLEM: In Bun, socket.write() returns a boolean indicating if more data
+ * can be written. When it returns false, you need to wait for the drain
+ * callback before writing more data.
+ *
+ * SOLUTION: This class maintains pending drain waiters and resolves them
+ * when the drain callback is called.
+ *
+ * @example
+ * ```typescript
+ * const drainWaiter = new BunDrainWaiter();
+ *
+ * // In socket handlers:
+ * socket: {
+ *   drain(socket) {
+ *     drainWaiter.onDrain();
+ *   }
+ * }
+ *
+ * // When writing:
+ * const canContinue = socket.write(data);
+ * if (!canContinue) {
+ *   drainWaiter.markNeedsDrain();
+ *   await drainWaiter.waitForDrain();
+ * }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Singleton drain waiter for Bun sockets.
+ *
+ * Allows multiple concurrent requests to wait for drain
+ * with a simple callback-based pattern.
+ */
+export declare class BunDrainWaiter {
+    private _waiters;
+    private _needsDrain;
+    private _closed;
+    /**
+     * Call this from the socket's drain handler.
+     * Resolves all pending waiters.
+     */
+    onDrain(): void;
+    /**
+     * Mark that drain is needed (socket.write returned false).
+     */
+    markNeedsDrain(): void;
+    /**
+     * Check if drain is needed.
+     */
+    get needsDrain(): boolean;
+    /**
+     * Wait for socket drain.
+     *
+     * Call markNeedsDrain() before calling this if socket.write returned false.
+     *
+     * @throws {Error} If socket is closed while waiting
+     */
+    waitForDrain(): Promise<void>;
+    /**
+     * Clear all pending waiters.
+     * Call this on socket close/disconnect.
+     */
+    clear(): void;
+    /**
+     * Mark socket as closed but don't clear waiters yet.
+     * They will be cleared when they complete.
+     */
+    markClosed(): void;
+}
+//# sourceMappingURL=drain-waiter.d.ts.map

package/dist/drain-waiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain-waiter.d.ts","sourceRoot":"","sources":["../src/drain-waiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;;;;OAMG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAUb;;;OAGG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/drain-waiter.js

@@ -0,0 +1,108 @@
+/**
+ * BunDrainWaiter - Singleton pattern for Bun socket drain waiting.
+ *
+ * PROBLEM: In Bun, socket.write() returns a boolean indicating if more data
+ * can be written. When it returns false, you need to wait for the drain
+ * callback before writing more data.
+ *
+ * SOLUTION: This class maintains pending drain waiters and resolves them
+ * when the drain callback is called.
+ *
+ * @example
+ * ```typescript
+ * const drainWaiter = new BunDrainWaiter();
+ *
+ * // In socket handlers:
+ * socket: {
+ *   drain(socket) {
+ *     drainWaiter.onDrain();
+ *   }
+ * }
+ *
+ * // When writing:
+ * const canContinue = socket.write(data);
+ * if (!canContinue) {
+ *   drainWaiter.markNeedsDrain();
+ *   await drainWaiter.waitForDrain();
+ * }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Singleton drain waiter for Bun sockets.
+ *
+ * Allows multiple concurrent requests to wait for drain
+ * with a simple callback-based pattern.
+ */
+export class BunDrainWaiter {
+    _waiters = new Set();
+    _needsDrain = false;
+    _closed = false;
+    /**
+     * Call this from the socket's drain handler.
+     * Resolves all pending waiters.
+     */
+    onDrain() {
+        this._needsDrain = false;
+        // Resolve all waiters
+        for (const resolve of this._waiters) {
+            resolve();
+        }
+        this._waiters.clear();
+    }
+    /**
+     * Mark that drain is needed (socket.write returned false).
+     */
+    markNeedsDrain() {
+        this._needsDrain = true;
+    }
+    /**
+     * Check if drain is needed.
+     */
+    get needsDrain() {
+        return this._needsDrain;
+    }
+    /**
+     * Wait for socket drain.
+     *
+     * Call markNeedsDrain() before calling this if socket.write returned false.
+     *
+     * @throws {Error} If socket is closed while waiting
+     */
+    async waitForDrain() {
+        // Fast path: no backpressure
+        if (!this._needsDrain) {
+            return;
+        }
+        // Socket closed check
+        if (this._closed) {
+            throw new Error("Socket closed during backpressure wait");
+        }
+        // Add this request to waiters
+        return new Promise((resolve) => {
+            this._waiters.add(resolve);
+        });
+    }
+    /**
+     * Clear all pending waiters.
+     * Call this on socket close/disconnect.
+     */
+    clear() {
+        this._needsDrain = false;
+        this._closed = true;
+        // Resolve all waiters so they don't hang
+        for (const resolve of this._waiters) {
+            resolve();
+        }
+        this._waiters.clear();
+    }
+    /**
+     * Mark socket as closed but don't clear waiters yet.
+     * They will be cleared when they complete.
+     */
+    markClosed() {
+        this._closed = true;
+    }
+}
+//# sourceMappingURL=drain-waiter.js.map

package/dist/drain-waiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain-waiter.js","sourceRoot":"","sources":["../src/drain-waiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAoB,IAAI,GAAG,EAAE,CAAC;IACtC,WAAW,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,KAAK,CAAC;IAExB;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,sBAAsB;QACtB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY;QAChB,6BAA6B;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,8BAA8B;QAC9B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,yCAAyC;QACzC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Error types and factory functions for @procwire-bun/client.
+ *
+ * @module
+ */
+/**
+ * Base error class for all Procwire client errors.
+ */
+export declare class ProcwireClientError extends Error {
+    constructor(message: string);
+}
+/**
+ * Factory functions for Client-related errors.
+ */
+export declare const ClientErrors: {
+    /** Cannot add handlers after start */
+    readonly cannotAddHandlerAfterStart: () => ProcwireClientError;
+    /** Cannot add events after start */
+    readonly cannotAddEventAfterStart: () => ProcwireClientError;
+    /** Client already started */
+    readonly alreadyStarted: () => ProcwireClientError;
+    /** Client not connected */
+    readonly notConnected: () => ProcwireClientError;
+    /** Unknown event name */
+    readonly unknownEvent: (eventName: string) => ProcwireClientError;
+    /** Response already sent */
+    readonly responseAlreadySent: () => ProcwireClientError;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,sCAAsC;;IAGtC,oCAAoC;;IAGpC,6BAA6B;;IAG7B,2BAA2B;;IAG3B,yBAAyB;uCACC,MAAM;IAEhC,4BAA4B;;CAEpB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,32 @@
+/**
+ * Error types and factory functions for @procwire-bun/client.
+ *
+ * @module
+ */
+/**
+ * Base error class for all Procwire client errors.
+ */
+export class ProcwireClientError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProcwireClientError";
+    }
+}
+/**
+ * Factory functions for Client-related errors.
+ */
+export const ClientErrors = {
+    /** Cannot add handlers after start */
+    cannotAddHandlerAfterStart: () => new ProcwireClientError("Cannot add handlers after start()"),
+    /** Cannot add events after start */
+    cannotAddEventAfterStart: () => new ProcwireClientError("Cannot add events after start()"),
+    /** Client already started */
+    alreadyStarted: () => new ProcwireClientError("Client already started"),
+    /** Client not connected */
+    notConnected: () => new ProcwireClientError("Client not connected"),
+    /** Unknown event name */
+    unknownEvent: (eventName) => new ProcwireClientError(`Unknown event: ${eventName}`),
+    /** Response already sent */
+    responseAlreadySent: () => new ProcwireClientError("Response already sent"),
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,sCAAsC;IACtC,0BAA0B,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,mCAAmC,CAAC;IAE9F,oCAAoC;IACpC,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,iCAAiC,CAAC;IAE1F,6BAA6B;IAC7B,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,wBAAwB,CAAC;IAEvE,2BAA2B;IAC3B,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,sBAAsB,CAAC;IAEnE,yBAAyB;IACzB,YAAY,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,kBAAkB,SAAS,EAAE,CAAC;IAE3F,4BAA4B;IAC5B,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,uBAAuB,CAAC;CACnE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @procwire-bun/client - Child-side API for Procwire IPC (Bun.js optimized).
+ *
+ * This package provides the client-side implementation for child processes
+ * to communicate with the parent process using Procwire's binary protocol.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@procwire-bun/client';
+ *
+ * const client = new Client()
+ *   .handle('query', async (data, ctx) => {
+ *     const results = await search(data);
+ *     ctx.respond(results);
+ *   })
+ *   .handle('insert', async (data, ctx) => {
+ *     ctx.ack({ accepted: true });
+ *     await processInBackground(data);
+ *   })
+ *   .event('progress');
+ *
+ * await client.start();
+ *
+ * // Emit events to parent
+ * client.emitEvent('progress', { percent: 50 });
+ * ```
+ *
+ * @module
+ */
+export { Client } from "./client.js";
+export { RequestContextImpl } from "./request-context.js";
+export { BunDrainWaiter } from "./drain-waiter.js";
+export { ProcwireClientError, ClientErrors } from "./errors.js";
+export type { ResponseType, MethodDefinition, EventDefinition, ClientOptions, MethodHandler, RequestContext, } from "./types.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @procwire-bun/client - Child-side API for Procwire IPC (Bun.js optimized).
+ *
+ * This package provides the client-side implementation for child processes
+ * to communicate with the parent process using Procwire's binary protocol.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@procwire-bun/client';
+ *
+ * const client = new Client()
+ *   .handle('query', async (data, ctx) => {
+ *     const results = await search(data);
+ *     ctx.respond(results);
+ *   })
+ *   .handle('insert', async (data, ctx) => {
+ *     ctx.ack({ accepted: true });
+ *     await processInBackground(data);
+ *   })
+ *   .event('progress');
+ *
+ * await client.start();
+ *
+ * // Emit events to parent
+ * client.emitEvent('progress', { percent: 50 });
+ * ```
+ *
+ * @module
+ */
+export { Client } from "./client.js";
+export { RequestContextImpl } from "./request-context.js";
+export { BunDrainWaiter } from "./drain-waiter.js";
+export { ProcwireClientError, ClientErrors } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/request-context.d.ts

@@ -0,0 +1,57 @@
+/**
+ * RequestContext implementation for method handlers.
+ *
+ * This is the Bun.js optimized version using Bun socket API.
+ *
+ * @module
+ */
+import type { Codec } from "@procwire/codecs";
+import type { RequestContext } from "./types.js";
+import type { BunDrainWaiter } from "./drain-waiter.js";
+type BunSocket = Awaited<ReturnType<typeof Bun.connect>>;
+/**
+ * Internal implementation of RequestContext.
+ *
+ * Passed to method handlers to allow sending responses.
+ * All response methods are async to properly handle socket backpressure.
+ */
+export declare class RequestContextImpl implements RequestContext {
+    readonly requestId: number;
+    readonly method: string;
+    private readonly _methodId;
+    private readonly _codec;
+    private readonly _socket;
+    private readonly _abortCallbacks;
+    private readonly _acquireHeader;
+    private readonly _drainWaiter;
+    private _aborted;
+    private _responded;
+    constructor(requestId: number, method: string, _methodId: number, _codec: Codec, _socket: BunSocket, _abortCallbacks: Map<number, Set<() => void>>, _acquireHeader: () => Buffer, _drainWaiter: BunDrainWaiter);
+    get aborted(): boolean;
+    /**
+     * Whether a response has been sent.
+     * @internal
+     */
+    get responded(): boolean;
+    onAbort(callback: () => void): void;
+    respond(data: unknown): Promise<void>;
+    ack(data?: unknown): Promise<void>;
+    chunk(data: unknown): Promise<void>;
+    end(): Promise<void>;
+    error(err: Error | string): Promise<void>;
+    /**
+     * Mark context as aborted.
+     * @internal Called by Client when abort frame received.
+     */
+    _markAborted(): void;
+    private _ensureNotResponded;
+    /**
+     * Send response data with proper backpressure handling.
+     *
+     * Bun sockets don't have cork/uncork, so we concatenate buffers for atomic write.
+     */
+    private _sendResponse;
+    private _cleanup;
+}
+export {};
+//# sourceMappingURL=request-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,KAAK,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;aAKrC,SAAS,EAAE,MAAM;aACjB,MAAM,EAAE,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAX/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;gBAGT,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,KAAK,EACb,OAAO,EAAE,SAAS,EAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,EAC7C,cAAc,EAAE,MAAM,MAAM,EAC5B,YAAY,EAAE,cAAc;IAG/C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAS7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlC,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpB,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C;;;OAGG;IACH,YAAY,IAAI,IAAI;IAIpB,OAAO,CAAC,mBAAmB;IAM3B;;;;OAIG;YACW,aAAa;IA4B3B,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/request-context.js

@@ -0,0 +1,128 @@
+/**
+ * RequestContext implementation for method handlers.
+ *
+ * This is the Bun.js optimized version using Bun socket API.
+ *
+ * @module
+ */
+import { Flags, encodeHeaderInto } from "@procwire/protocol";
+import { ClientErrors } from "./errors.js";
+/**
+ * Internal implementation of RequestContext.
+ *
+ * Passed to method handlers to allow sending responses.
+ * All response methods are async to properly handle socket backpressure.
+ */
+export class RequestContextImpl {
+    requestId;
+    method;
+    _methodId;
+    _codec;
+    _socket;
+    _abortCallbacks;
+    _acquireHeader;
+    _drainWaiter;
+    _aborted = false;
+    _responded = false;
+    constructor(requestId, method, _methodId, _codec, _socket, _abortCallbacks, _acquireHeader, _drainWaiter) {
+        this.requestId = requestId;
+        this.method = method;
+        this._methodId = _methodId;
+        this._codec = _codec;
+        this._socket = _socket;
+        this._abortCallbacks = _abortCallbacks;
+        this._acquireHeader = _acquireHeader;
+        this._drainWaiter = _drainWaiter;
+    }
+    get aborted() {
+        return this._aborted;
+    }
+    /**
+     * Whether a response has been sent.
+     * @internal
+     */
+    get responded() {
+        return this._responded;
+    }
+    onAbort(callback) {
+        let callbacks = this._abortCallbacks.get(this.requestId);
+        if (!callbacks) {
+            callbacks = new Set();
+            this._abortCallbacks.set(this.requestId, callbacks);
+        }
+        callbacks.add(callback);
+    }
+    async respond(data) {
+        this._ensureNotResponded();
+        this._responded = true;
+        await this._sendResponse(data, Flags.IS_RESPONSE | Flags.DIRECTION_TO_PARENT);
+        this._cleanup();
+    }
+    async ack(data) {
+        this._ensureNotResponded();
+        this._responded = true;
+        await this._sendResponse(data ?? null, Flags.IS_RESPONSE | Flags.IS_ACK | Flags.DIRECTION_TO_PARENT);
+        this._cleanup();
+    }
+    async chunk(data) {
+        await this._sendResponse(data, Flags.IS_RESPONSE | Flags.IS_STREAM | Flags.DIRECTION_TO_PARENT);
+    }
+    async end() {
+        this._ensureNotResponded();
+        this._responded = true;
+        await this._sendResponse(null, Flags.IS_RESPONSE | Flags.IS_STREAM | Flags.STREAM_END | Flags.DIRECTION_TO_PARENT);
+        this._cleanup();
+    }
+    async error(err) {
+        this._ensureNotResponded();
+        this._responded = true;
+        const message = err instanceof Error ? err.message : err;
+        await this._sendResponse(message, Flags.IS_RESPONSE | Flags.IS_ERROR | Flags.DIRECTION_TO_PARENT);
+        this._cleanup();
+    }
+    /**
+     * Mark context as aborted.
+     * @internal Called by Client when abort frame received.
+     */
+    _markAborted() {
+        this._aborted = true;
+    }
+    _ensureNotResponded() {
+        if (this._responded) {
+            throw ClientErrors.responseAlreadySent();
+        }
+    }
+    /**
+     * Send response data with proper backpressure handling.
+     *
+     * Bun sockets don't have cork/uncork, so we concatenate buffers for atomic write.
+     */
+    async _sendResponse(data, flags) {
+        // Empty payload cases:
+        // 1. STREAM_END frames (null data)
+        // 2. ACK without data (null/undefined data with IS_ACK flag)
+        // Don't serialize null - just use empty buffer (required for rawCodec compatibility)
+        const isStreamEnd = (flags & Flags.STREAM_END) !== 0;
+        const isEmptyAck = (flags & Flags.IS_ACK) !== 0 && data == null;
+        const payload = isStreamEnd || isEmptyAck ? Buffer.alloc(0) : this._codec.serialize(data);
+        const headerBuf = this._acquireHeader();
+        encodeHeaderInto(headerBuf, {
+            methodId: this._methodId,
+            flags,
+            requestId: this.requestId,
+            payloadLength: payload.length,
+        });
+        // Bun doesn't have cork/uncork, concatenate for atomic write
+        const combined = Buffer.concat([headerBuf, payload]);
+        const canContinue = this._socket.write(combined);
+        // OPT-04: Wait AFTER write if backpressure
+        if (!canContinue) {
+            this._drainWaiter.markNeedsDrain();
+            await this._drainWaiter.waitForDrain();
+        }
+    }
+    _cleanup() {
+        this._abortCallbacks.delete(this.requestId);
+    }
+}
+//# sourceMappingURL=request-context.js.map

package/dist/request-context.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Type definitions for @procwire-bun/client.
+ *
+ * @module
+ */
+import type { Codec } from "@procwire/codecs";
+/**
+ * Response type for methods.
+ */
+export type ResponseType = "result" | "stream" | "ack" | "none";
+/**
+ * Method definition for registration.
+ */
+export interface MethodDefinition {
+    /** Expected response type */
+    response: ResponseType;
+    /** Codec for serialization (defaults to msgpack) */
+    codec?: Codec;
+    /** Can be cancelled via AbortSignal? */
+    cancellable?: boolean;
+}
+/**
+ * Event definition for registration.
+ */
+export interface EventDefinition {
+    /** Codec for serialization (defaults to msgpack) */
+    codec?: Codec;
+}
+/**
+ * Client configuration options.
+ */
+export interface ClientOptions {
+    /** Default codec for methods and events */
+    defaultCodec?: Codec;
+}
+/**
+ * Method handler function type.
+ */
+export type MethodHandler<TData = unknown> = (data: TData, ctx: RequestContext) => void | Promise<void>;
+/**
+ * Request context passed to method handlers.
+ *
+ * Provides methods to send responses back to parent.
+ *
+ * All response methods are async to properly handle backpressure.
+ * Always await these methods to prevent deadlocks with large payloads.
+ */
+export interface RequestContext {
+    /** Request ID for correlation */
+    readonly requestId: number;
+    /** Method name being handled */
+    readonly method: string;
+    /** Was request aborted by parent? */
+    readonly aborted: boolean;
+    /**
+     * Register callback to be called when request is aborted.
+     */
+    onAbort(callback: () => void): void;
+    /**
+     * Send full response to parent.
+     * Sets IS_RESPONSE flag.
+     *
+     * @returns Promise that resolves when the response has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     */
+    respond(data: unknown): Promise<void>;
+    /**
+     * Send acknowledgment to parent.
+     * Sets IS_RESPONSE | IS_ACK flags.
+     *
+     * @returns Promise that resolves when the response has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     */
+    ack(data?: unknown): Promise<void>;
+    /**
+     * Send stream chunk to parent.
+     * Sets IS_RESPONSE | IS_STREAM flags.
+     *
+     * @returns Promise that resolves when the chunk has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     */
+    chunk(data: unknown): Promise<void>;
+    /**
+     * End stream.
+     * Sets IS_RESPONSE | IS_STREAM | STREAM_END flags.
+     *
+     * @returns Promise that resolves when the end marker has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     */
+    end(): Promise<void>;
+    /**
+     * Send error response to parent.
+     * Sets IS_RESPONSE | IS_ERROR flags.
+     *
+     * @returns Promise that resolves when the error has been written
+     *          and socket buffer has drained (if backpressure occurred).
+     */
+    error(err: Error | string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,oDAAoD;IACpD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,GAAG,OAAO,IAAI,CAC3C,IAAI,EAAE,KAAK,EACX,GAAG,EAAE,cAAc,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEpC;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErB;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for @procwire-bun/client.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@procwire/bun-client",
+  "version": "1.0.0",
+  "description": "Child-side client for Procwire IPC (Bun.js optimized)",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "engines": {
+    "bun": ">=1.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "bun test",
+    "clean": "rimraf dist \"*.tsbuildinfo\""
+  },
+  "dependencies": {
+    "@procwire/protocol": "workspace:*",
+    "@procwire/codecs": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "ipc",
+    "procwire",
+    "client",
+    "child-process",
+    "bun"
+  ]
+}