@procedures/client 0.0.0-stage → 0.2.0

package/dist/adapters/http/shared/strategies.js

@@ -0,0 +1,180 @@
+/**
+ * HTTP Strategy Interfaces
+ *
+ * Defines extensible, bidirectional strategies for URL mapping
+ * and HTTP method selection. These strategies ensure client
+ * and server use consistent, inverse operations.
+ */
+import { HTTPMethod } from "./constants.js";
+/**
+ * Default URL Pattern: /{version?}/{service}/{operation}
+ *
+ * Examples:
+ * - { service: "users", operation: "get" } → "/users/get"
+ * - { service: "users", operation: "get", version: "v2" } → "/v2/users/get"
+ */
+export const defaultUrlPattern = {
+    template: "/{version?}/{service}/{operation}",
+    format(method, baseUrl) {
+        const parts = [baseUrl.replace(/\/$/, "")];
+        if (method.version) {
+            parts.push(method.version);
+        }
+        parts.push(method.service, method.operation);
+        return parts.join("/");
+    },
+    parse(url, _httpMethod) {
+        // Remove base URL and query params
+        const path = url.split("?")[0];
+        const segments = path?.split("/").filter(Boolean) ?? [];
+        // Minimum: /service/operation (2 segments)
+        if (segments.length < 2) {
+            return null;
+        }
+        // Pattern: [version?]/service/operation
+        if (segments.length === 2) {
+            return {
+                service: segments[0],
+                operation: segments[1],
+            };
+        }
+        if (segments.length === 3) {
+            return {
+                version: segments[0],
+                service: segments[1],
+                operation: segments[2],
+            };
+        }
+        return null;
+    },
+};
+/**
+ * RESTful URL Pattern: /{version?}/{service}/{id?}
+ *
+ * Infers operation from HTTP method and presence of ID:
+ * - GET /users → list
+ * - GET /users/123 → get
+ * - POST /users → create
+ * - PUT /users/123 → update
+ * - PATCH /users/123 → patch
+ * - DELETE /users/123 → delete
+ */
+export const restfulUrlPattern = {
+    template: "/{version?}/{service}/{id?}",
+    format(method, baseUrl) {
+        const parts = [baseUrl.replace(/\/$/, "")];
+        if (method.version) {
+            parts.push(method.version);
+        }
+        parts.push(method.service);
+        // For RESTful, operation might encode the ID
+        // This is simplified - real implementation would need ID extraction
+        if (method.operation !== "list" && method.operation !== "create") {
+            // Assume operation is actually the ID for get/update/delete
+            parts.push(method.operation);
+        }
+        return parts.join("/");
+    },
+    parse(url, httpMethod) {
+        const path = url.split("?")[0];
+        const segments = path?.split("/").filter(Boolean) ?? [];
+        if (segments.length < 1) {
+            return null;
+        }
+        let version;
+        let service;
+        let id;
+        // Pattern: [version?]/service/[id?]
+        if (segments.length === 1) {
+            service = segments[0];
+        }
+        else if (segments.length === 2) {
+            // Could be version/service or service/id
+            // Heuristic: if starts with 'v', treat as version
+            if (segments[0].startsWith("v")) {
+                version = segments[0];
+                service = segments[1];
+            }
+            else {
+                service = segments[0];
+                id = segments[1];
+            }
+        }
+        else {
+            version = segments[0];
+            service = segments[1];
+            id = segments[2];
+        }
+        // Infer operation from HTTP method and ID presence
+        const operation = inferRESTOperation(httpMethod, !!id);
+        return {
+            ...(version && { version }),
+            service,
+            operation,
+            // Store ID in metadata or custom field if needed
+        };
+    },
+};
+/**
+ * RESTful HTTP Method Strategy
+ *
+ * Maps operation names to HTTP methods:
+ * - get/list/find/watch → GET
+ * - create → POST
+ * - update → PUT
+ * - patch → PATCH
+ * - delete/remove → DELETE
+ * - default → POST
+ */
+export const restfulHttpMethodStrategy = (method) => {
+    const op = method.operation.toLowerCase();
+    if (op === "get" || op === "list" || op === "find" || op === "watch") {
+        return HTTPMethod.GET;
+    }
+    if (op === "create") {
+        return HTTPMethod.POST;
+    }
+    if (op === "update") {
+        return HTTPMethod.PUT;
+    }
+    if (op === "patch") {
+        return HTTPMethod.PATCH;
+    }
+    if (op === "delete" || op === "remove") {
+        return HTTPMethod.DELETE;
+    }
+    // Default to POST for RPC-style operations
+    return HTTPMethod.POST;
+};
+/**
+ * POST-only HTTP Method Strategy
+ *
+ * All operations use POST (simple RPC style).
+ */
+export const postOnlyStrategy = () => HTTPMethod.POST;
+/**
+ * Infer REST operation from HTTP method and ID presence
+ */
+function inferRESTOperation(httpMethod, hasId) {
+    switch (httpMethod) {
+        case HTTPMethod.GET:
+            return hasId ? "get" : "list";
+        case HTTPMethod.POST:
+            return "create";
+        case HTTPMethod.PUT:
+            return "update";
+        case HTTPMethod.PATCH:
+            return "patch";
+        case HTTPMethod.DELETE:
+            return "delete";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Validate payload can be JSON stringified
+ */
+export function isValidJSONPayload(payload) {
+    return typeof payload === "object" && payload !== null;
+}
+//# sourceMappingURL=strategies.js.map

package/dist/adapters/http/shared/strategies.js.map

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

package/dist/adapters/local/client/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Local Client Transport Adapter
+ *
+ * Public API for Local client adapter.
+ */
+export type { LocalTransportOptions, Handler } from "./types.js";
+export { LocalTransport } from "./transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/local/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/local/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/adapters/local/client/index.js

@@ -0,0 +1,8 @@
+/**
+ * Local Client Transport Adapter
+ *
+ * Public API for Local client adapter.
+ */
+// Transport
+export { LocalTransport } from "./transport.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/local/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/local/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/adapters/local/client/transport.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Local Transport Implementation
+ *
+ * In-process RPC with handler registry - no network calls!
+ */
+import type { Transport, Message, ResponseItem, Method } from "../../../client/types.js";
+import type { Handler, LocalTransportOptions } from "./types.js";
+/**
+ * Local Transport - executes handlers in-process without network calls.
+ *
+ * Features:
+ * - No network - instant execution
+ * - Sync and async handler support
+ * - Handler registry (register/unregister)
+ * - Same Transport interface as HTTP/gRPC
+ * - Perfect for testing!
+ *
+ * @example
+ * ```typescript
+ * const transport = new LocalTransport();
+ *
+ * transport.register(
+ *   { service: "users", operation: "get" },
+ *   async ({ id }) => database.users.findById(id)
+ * );
+ *
+ * const client = new Client({ transport });
+ * const user = await client.call(
+ *   { service: "users", operation: "get" },
+ *   { id: 123 }
+ * );
+ * ```
+ */
+export declare class LocalTransport implements Transport {
+    readonly name = "local";
+    private readonly handlers;
+    private readonly throwOnMissing;
+    private readonly registry;
+    constructor(options?: LocalTransportOptions);
+    /**
+     * Register a handler for a method.
+     *
+     * @param method - Method to handle
+     * @param handler - Handler function (sync, async, or an async generator for a stream)
+     */
+    register<TReq, TRes>(method: Method, handler: Handler<TReq, TRes>): void;
+    /**
+     * Unregister a handler.
+     *
+     * @param method - Method to unregister
+     */
+    unregister(method: Method): void;
+    /**
+     * Check if handler is registered.
+     *
+     * @param method - Method to check
+     */
+    has(method: Method): boolean;
+    /** The procedure of the registry at the path of a method. */
+    private procedureFor;
+    /**
+     * Send message to local handler.
+     *
+     * A handler (or a procedure) that gives an async iterable gives a stream: one response item
+     * for each value. An error ends the stream with an error item.
+     *
+     * @param message - Message to send
+     * @returns Async iterable of response items
+     */
+    send<TReq, TRes>(message: Message<TReq>): AsyncIterable<ResponseItem<TRes>>;
+    close(): Promise<void>;
+    /**
+     * Clear all handlers.
+     */
+    clear(): void;
+    /**
+     * Get all registered method keys.
+     */
+    getMethods(): string[];
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/adapters/local/client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/adapters/local/client/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAgBjE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD,YAAY,OAAO,GAAE,qBAA0B,EAW9C;IAED;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAEvE;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/B;IAED;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3B;IAED,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAKpB;;;;;;;;OAQG;IACI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAwDjF;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE,CAErB;CACF"}

package/dist/adapters/local/client/transport.js

@@ -0,0 +1,172 @@
+/**
+ * Local Transport Implementation
+ *
+ * In-process RPC with handler registry - no network calls!
+ */
+import { methodKey } from "./types.js";
+import { InvocationError, invokeProcedure, isAsyncIterable } from "../../../procedures/invoke.js";
+import { methodToPath } from "../../../server/method.js";
+function successItem(id, payload) {
+    return { id, status: { type: "success", code: 200 }, payload: payload, metadata: {} };
+}
+function errorItem(id, code, message) {
+    // Local handlers do not benefit from retries
+    return { id, status: { type: "error", code, message, retryable: false }, payload: null, metadata: {} };
+}
+/**
+ * Local Transport - executes handlers in-process without network calls.
+ *
+ * Features:
+ * - No network - instant execution
+ * - Sync and async handler support
+ * - Handler registry (register/unregister)
+ * - Same Transport interface as HTTP/gRPC
+ * - Perfect for testing!
+ *
+ * @example
+ * ```typescript
+ * const transport = new LocalTransport();
+ *
+ * transport.register(
+ *   { service: "users", operation: "get" },
+ *   async ({ id }) => database.users.findById(id)
+ * );
+ *
+ * const client = new Client({ transport });
+ * const user = await client.call(
+ *   { service: "users", operation: "get" },
+ *   { id: 123 }
+ * );
+ * ```
+ */
+export class LocalTransport {
+    name = "local";
+    handlers = new Map();
+    throwOnMissing;
+    registry;
+    constructor(options = {}) {
+        this.throwOnMissing = options.throwOnMissing !== false;
+        this.registry = options.registry;
+        // Register pre-configured handlers. A key without a version ("users.get") gets the
+        // empty version, as methodKey() makes it: before, such a key was never found.
+        if (options.handlers) {
+            for (const [key, handler] of Object.entries(options.handlers)) {
+                this.handlers.set(key.includes(":") ? key : `:${key}`, handler);
+            }
+        }
+    }
+    /**
+     * Register a handler for a method.
+     *
+     * @param method - Method to handle
+     * @param handler - Handler function (sync, async, or an async generator for a stream)
+     */
+    register(method, handler) {
+        this.handlers.set(methodKey(method), handler);
+    }
+    /**
+     * Unregister a handler.
+     *
+     * @param method - Method to unregister
+     */
+    unregister(method) {
+        this.handlers.delete(methodKey(method));
+    }
+    /**
+     * Check if handler is registered.
+     *
+     * @param method - Method to check
+     */
+    has(method) {
+        return this.handlers.has(methodKey(method)) || this.procedureFor(method) !== undefined;
+    }
+    /** The procedure of the registry at the path of a method. */
+    procedureFor(method) {
+        if (!this.registry)
+            return undefined;
+        return this.registry.get(methodToPath(method));
+    }
+    /**
+     * Send message to local handler.
+     *
+     * A handler (or a procedure) that gives an async iterable gives a stream: one response item
+     * for each value. An error ends the stream with an error item.
+     *
+     * @param message - Message to send
+     * @returns Async iterable of response items
+     */
+    async *send(message) {
+        const key = methodKey(message.method);
+        const handler = this.handlers.get(key);
+        const procedure = handler ? undefined : this.procedureFor(message.method);
+        // Handler not found
+        if (!handler && !procedure) {
+            if (this.throwOnMissing) {
+                yield errorItem(message.id, "NOT_FOUND", `No handler registered for ${key}`);
+                return;
+            }
+            // Silently return empty response
+            return;
+        }
+        // Check if cancelled
+        if (message.signal?.aborted) {
+            yield errorItem(message.id, "ABORTED", "Request was aborted");
+            return;
+        }
+        try {
+            let values;
+            let value;
+            if (procedure) {
+                const output = await invokeProcedure(procedure, message.payload, {
+                    registry: this.registry,
+                    metadata: message.metadata,
+                    signal: message.signal,
+                });
+                if (output.kind === "stream")
+                    values = output.items;
+                else
+                    value = output.value;
+            }
+            else {
+                // Execute handler (may be sync, async or an async generator)
+                const result = await handler(message.payload, message);
+                if (isAsyncIterable(result))
+                    values = result;
+                else
+                    value = result;
+            }
+            if (values === undefined) {
+                yield successItem(message.id, value);
+                return;
+            }
+            for await (const item of values) {
+                if (message.signal?.aborted) {
+                    yield errorItem(message.id, "ABORTED", "Request was aborted");
+                    return;
+                }
+                yield successItem(message.id, item);
+            }
+        }
+        catch (error) {
+            // The handler threw, or the invocation failed (its code: VALIDATION_ERROR, ABORTED and so on)
+            const code = error instanceof InvocationError ? error.code : "HANDLER_ERROR";
+            yield errorItem(message.id, code, error instanceof Error ? error.message : "Unknown error");
+        }
+    }
+    async close() {
+        // No resources to clean up
+    }
+    /**
+     * Clear all handlers.
+     */
+    clear() {
+        this.handlers.clear();
+    }
+    /**
+     * Get all registered method keys.
+     */
+    getMethods() {
+        return Array.from(this.handlers.keys());
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/adapters/local/client/transport.js.map

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

package/dist/adapters/local/client/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Local Transport Types
+ *
+ * Type definitions and utilities for Local adapter.
+ */
+import type { Message, Method } from "../../../client/types.js";
+import type { ProcedureRegistry } from "../../../procedures/registry.js";
+/**
+ * Handler function for a method.
+ */
+export type Handler<TReq = unknown, TRes = unknown> = (payload: TReq, message: Message<TReq>) => TRes | Promise<TRes> | AsyncIterable<TRes>;
+/**
+ * Method key for handler registry.
+ */
+export declare function methodKey(method: Method): string;
+/**
+ * Local Transport configuration.
+ */
+export interface LocalTransportOptions {
+    /**
+     * Pre-registered handlers.
+     * Keys can be either:
+     * - "{service}.{operation}" (e.g., "users.get")
+     * - "{version}:{service}.{operation}" (e.g., "v2:users.get")
+     */
+    handlers?: Record<string, Handler>;
+    /**
+     * Whether to throw on missing handlers (default: true).
+     */
+    throwOnMissing?: boolean;
+    /**
+     * A procedure registry. A method without a registered handler runs the procedure at its path
+     * (the service and the operation split on dots: `{ service: "mongo", operation: "documents.find" }`
+     * and `{ service: "mongo.documents", operation: "find" }` both give `["mongo", "documents", "find"]`).
+     * The procedure runs through `invokeProcedure()`, as on a server.
+     */
+    registry?: ProcedureRegistry;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/local/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/adapters/local/client/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,IAAI,CACpD,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;AAEhD;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B"}

package/dist/adapters/local/client/types.js

@@ -0,0 +1,13 @@
+/**
+ * Local Transport Types
+ *
+ * Type definitions and utilities for Local adapter.
+ */
+/**
+ * Method key for handler registry.
+ */
+export function methodKey(method) {
+    const version = method.version || "";
+    return `${version}:${method.service}.${method.operation}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/adapters/local/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/adapters/local/client/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,OAAO,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;AAC5D,CAAC"}

package/dist/adapters/metadata.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The metadata that a transport sends.
+ *
+ * A key that starts with "__" is internal to one process (`__schema`, `__validation`,
+ * `__middlewareOverrides`): a transport never sends it, and a server drops it when a request
+ * carries it (deep dive TRN-11).
+ */
+/** This function gives a copy of the metadata without the internal keys. */
+export declare function withoutInternalKeys<T extends Record<string, unknown>>(metadata: T | undefined): Partial<T>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/adapters/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/adapters/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAO1G"}

package/dist/adapters/metadata.js

@@ -0,0 +1,19 @@
+/**
+ * The metadata that a transport sends.
+ *
+ * A key that starts with "__" is internal to one process (`__schema`, `__validation`,
+ * `__middlewareOverrides`): a transport never sends it, and a server drops it when a request
+ * carries it (deep dive TRN-11).
+ */
+/** This function gives a copy of the metadata without the internal keys. */
+export function withoutInternalKeys(metadata) {
+    const out = {};
+    if (!metadata)
+        return out;
+    for (const [key, value] of Object.entries(metadata)) {
+        if (!key.startsWith("__"))
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/adapters/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/adapters/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAoC,QAAuB;IAC5F,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,GAAiB,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,GAAiB,CAAC;AAC3B,CAAC"}

package/dist/adapters/mock/client/builder.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Mock Builder
+ *
+ * Fluent API for configuring mock responses.
+ */
+import type { ResponseItem } from "../../../client/types.js";
+import type { ResponseMatcher } from "./types.js";
+import type { MockTransport } from "./transport.js";
+export declare class MockResponseBuilder {
+    private transport;
+    private matcher;
+    constructor(transport: MockTransport, matcher: ResponseMatcher);
+    thenReturn<TRes>(payload: TRes, metadata?: Record<string, unknown>): this;
+    thenError(message: string): this;
+    thenStream<TRes>(items: ResponseItem<TRes>[]): this;
+    when(matcher: ResponseMatcher): this;
+}
+/**
+ * Create a mock response builder for fluent API.
+ *
+ * @example
+ * ```typescript
+ * const mock = new MockTransport();
+ *
+ * mockBuilder(mock)
+ *   .when((method) => method.service === "users")
+ *   .thenReturn({ id: "123", name: "John" });
+ *
+ * mockBuilder(mock)
+ *   .when((method) => method.service === "orders")
+ *   .thenError("Order service unavailable");
+ * ```
+ */
+export declare function mockBuilder(transport: MockTransport): MockResponseBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/adapters/mock/client/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/adapters/mock/client/builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAkB;IACjC,YAAY,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAG7D;IACD,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAI,IAAI,CAM3E;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAI,IAAI,CAM9B;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,GAAI,IAAI,CAMjD;IACH,IAAI,CAAC,OAAO,EAAE,eAAe,GAAI,IAAI,CAGpC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,GAAI,mBAAmB,CAE1E"}