@procedures/client 0.0.0-stage → 0.2.0

package/dist/client/errors/types.js

@@ -0,0 +1,45 @@
+/**
+ * Universal Error System - Type Definitions
+ *
+ * Protocol-agnostic error metadata system.
+ * Works across HTTP, WebSocket, gRPC, Local transports.
+ */
+/**
+ * Error severity levels.
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    /** Informational - not an actual error */
+    ErrorSeverity["INFO"] = "info";
+    /** Warning - degraded but functional */
+    ErrorSeverity["WARNING"] = "warning";
+    /** Error - operation failed */
+    ErrorSeverity["ERROR"] = "error";
+    /** Critical - system-level failure */
+    ErrorSeverity["CRITICAL"] = "critical";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Error categories for classification.
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    /** Network-level errors (connectivity, DNS, etc.) */
+    ErrorCategory["NETWORK"] = "network";
+    /** Client-side errors (validation, configuration) */
+    ErrorCategory["CLIENT"] = "client";
+    /** Server-side errors (5xx, internal errors) */
+    ErrorCategory["SERVER"] = "server";
+    /** Protocol-level errors (parsing, encoding) */
+    ErrorCategory["PROTOCOL"] = "protocol";
+    /** Authentication/authorization errors */
+    ErrorCategory["AUTH"] = "auth";
+    /** Rate limiting and throttling */
+    ErrorCategory["RATE_LIMIT"] = "rate_limit";
+    /** Timeout errors */
+    ErrorCategory["TIMEOUT"] = "timeout";
+    /** Cancellation errors */
+    ErrorCategory["CANCELLED"] = "cancelled";
+    /** Unknown/uncategorized errors */
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (ErrorCategory = {}));
+//# sourceMappingURL=types.js.map

package/dist/client/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/errors/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,0CAA0C;IAC1C,8BAAa,CAAA;IACb,wCAAwC;IACxC,oCAAmB,CAAA;IACnB,+BAA+B;IAC/B,gCAAe,CAAA;IACf,sCAAsC;IACtC,sCAAqB,CAAA;AACvB,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAmBX;AAnBD,WAAY,aAAa;IACvB,qDAAqD;IACrD,oCAAmB,CAAA;IACnB,qDAAqD;IACrD,kCAAiB,CAAA;IACjB,gDAAgD;IAChD,kCAAiB,CAAA;IACjB,gDAAgD;IAChD,sCAAqB,CAAA;IACrB,0CAA0C;IAC1C,8BAAa,CAAA;IACb,mCAAmC;IACnC,0CAAyB,CAAA;IACzB,qBAAqB;IACrB,oCAAmB,CAAA;IACnB,0BAA0B;IAC1B,wCAAuB,CAAA;IACvB,mCAAmC;IACnC,oCAAmB,CAAA;AACrB,CAAC,EAnBW,aAAa,KAAb,aAAa,QAmBxB"}

package/dist/client/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Universal Client System
+ *
+ * Protocol-agnostic RPC client with middleware composition.
+ * Works with HTTP, gRPC, WebSocket, and local transports.
+ */
+export { Client } from "./client.js";
+export type { ErrorMetadata, ErrorRegistry, ErrorContext, RichError } from "./errors/index.js";
+export { ErrorSeverity, ErrorCategory } from "./errors/index.js";
+export { ERROR_REGISTRY, getErrorMetadata, isKnownError, createError, createErrorFromHTTPStatus, createErrorFromException, formatError, } from "./errors/index.js";
+export { HttpTransport, defaultUrlPattern, restfulHttpMethodStrategy, postOnlyStrategy } from "../adapters/http/client/index.js";
+export type { HttpTransportOptions, UrlStrategy, HttpMethodStrategy } from "../adapters/http/client/index.js";
+export { LocalTransport } from "../adapters/local/client/index.js";
+export type { LocalTransportOptions, Handler } from "../adapters/local/client/index.js";
+export { WebSocketTransport } from "../adapters/websocket/client/index.js";
+export type { WebSocketTransportOptions } from "../adapters/websocket/client/index.js";
+export { WebSocketState } from "../adapters/websocket/client/index.js";
+export { MockTransport, mockBuilder } from "../adapters/mock/client/index.js";
+export type { MockTransportOptions, MockResponse, ResponseMatcher, CallHistoryEntry, } from "../adapters/mock/client//index.js";
+export { createRetryMiddleware } from "./middleware/retry.js";
+export type { RetryOptions } from "./middleware/retry.js";
+export { createCacheMiddleware } from "./middleware/cache.js";
+export type { CacheOptions, CacheStats } from "./middleware/cache.js";
+export { createTimeoutMiddleware, createOverallTimeoutMiddleware, createCombinedTimeoutMiddleware, } from "./middleware/timeout.js";
+export type { TimeoutOptions } from "./middleware/timeout.js";
+export { createPaginationMiddleware, paginateAll } from "./middleware/pagination.js";
+export type { PaginationOptions } from "./middleware/pagination.js";
+export { createCircuitBreakerMiddleware, CircuitBreakerError } from "./middleware/circuit-breaker.js";
+export type { CircuitBreakerOptions, CircuitBreakerStats, CircuitState } from "./middleware/circuit-breaker.js";
+export { createRateLimitMiddleware, createPerServiceRateLimiter, RateLimitError } from "./middleware/rate-limit.js";
+export type { RateLimitOptions, RateLimitStats } from "./middleware/rate-limit.js";
+export { createAuthMiddleware, createBearerAuthMiddleware, createApiKeyAuthMiddleware, } from "./middleware/auth.js";
+export type { AuthOptions } from "./middleware/auth.js";
+export { createTracingMiddleware, createSimpleTracingMiddleware, extractTracingInfo, } from "./middleware/tracing.js";
+export type { TracingOptions } from "./middleware/tracing.js";
+export { createZodMiddleware, ValidationError, methodToKey, keyToMethod } from "./validation/index.js";
+export type { ZodMiddlewareOptions, ValidationMode, ZodLike, ZodErrorLike, SchemaDefinition, ValidationPhase, ZodValidationContext, } from "./validation/index.js";
+export { mergeContext, normalizeCallOptions, isCallOptions } from "./context.js";
+export type { CallOptions, ClientContextInput, MiddlewareContextFields, SchemaOverride } from "./context.js";
+export type { Transport, Method, Metadata, Message, ResponseItem, Status, ClientContext, ClientRunner, ClientMiddleware, ClientOptions, } from "./types.js";
+export { ClientError } from "./types.js";
+export { createTypedCaller } from "./typed.js";
+export type { TypedCaller, BaseCaller, ProcedureDef, ProcedureNamespace, ProcedurePaths, PathInput, PathOutput, MergeProcedures, } from "./typed.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/client/index.js

@@ -0,0 +1,36 @@
+/**
+ * Universal Client System
+ *
+ * Protocol-agnostic RPC client with middleware composition.
+ * Works with HTTP, gRPC, WebSocket, and local transports.
+ */
+// Core Client
+export { Client } from "./client.js";
+export { ErrorSeverity, ErrorCategory } from "./errors/index.js";
+export { ERROR_REGISTRY, getErrorMetadata, isKnownError, createError, createErrorFromHTTPStatus, createErrorFromException, formatError, } from "./errors/index.js";
+// Transport Adapters
+export { HttpTransport, defaultUrlPattern, restfulHttpMethodStrategy, postOnlyStrategy } from "../adapters/http/client/index.js";
+export { LocalTransport } from "../adapters/local/client/index.js";
+export { WebSocketTransport } from "../adapters/websocket/client/index.js";
+// WebSocketState is a runtime enum — export as a value (not type-only) so consumers can compare
+// transport.getState() === WebSocketState.CONNECTED. See documentation/BUGS-2026-07.md (L1).
+export { WebSocketState } from "../adapters/websocket/client/index.js";
+export { MockTransport, mockBuilder } from "../adapters/mock/client/index.js";
+// Middleware
+export { createRetryMiddleware } from "./middleware/retry.js";
+``;
+export { createCacheMiddleware } from "./middleware/cache.js";
+export { createTimeoutMiddleware, createOverallTimeoutMiddleware, createCombinedTimeoutMiddleware, } from "./middleware/timeout.js";
+export { createPaginationMiddleware, paginateAll } from "./middleware/pagination.js";
+export { createCircuitBreakerMiddleware, CircuitBreakerError } from "./middleware/circuit-breaker.js";
+export { createRateLimitMiddleware, createPerServiceRateLimiter, RateLimitError } from "./middleware/rate-limit.js";
+export { createAuthMiddleware, createBearerAuthMiddleware, createApiKeyAuthMiddleware, } from "./middleware/auth.js";
+export { createTracingMiddleware, createSimpleTracingMiddleware, extractTracingInfo, } from "./middleware/tracing.js";
+// Zod Validation Middleware
+export { createZodMiddleware, ValidationError, methodToKey, keyToMethod } from "./validation/index.js";
+// Context System
+export { mergeContext, normalizeCallOptions, isCallOptions } from "./context.js";
+export { ClientError } from "./types.js";
+// Typed Caller
+export { createTypedCaller } from "./typed.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,yBAAyB,EACzB,wBAAwB,EACxB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGjI,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,gGAAgG;AAChG,6FAA6F;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAQ9E,aAAa;AACb,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAAA,EAAE,CAAA;AAGhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGtG,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGpH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,4BAA4B;AAC5B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWvG,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiBjF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/client/middleware/auth.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Authentication Middleware
+ *
+ * Adds authentication metadata to requests.
+ * Works with ALL transports (HTTP, WebSocket, Local, Mock).
+ *
+ * Each transport converts metadata.auth to its protocol format:
+ * - HTTP: Authorization header, X-API-Key header
+ * - WebSocket: Frame metadata
+ * - Local: Passed directly to handler
+ */
+import type { TypedClientMiddleware } from "../types.js";
+import type { AuthContext } from "./contexts.js";
+/**
+ * Authentication Options
+ */
+export interface AuthOptions {
+    /** Bearer token for Authorization header */
+    token?: string;
+    /** API key for X-API-Key header */
+    apiKey?: string;
+    /** User ID for context */
+    userId?: string;
+    /** Additional custom auth fields */
+    [key: string]: unknown;
+}
+/**
+ * Create authentication middleware
+ *
+ * Adds auth metadata to all requests. The transport layer
+ * converts this to protocol-specific format.
+ *
+ * **Context Override**: User-provided context (via withContext or per-call)
+ * takes precedence. Middleware options serve as defaults.
+ *
+ * @example
+ * ```typescript
+ * // Create middleware with default auth
+ * client.use(createAuthMiddleware({ token: "default-token" }));
+ *
+ * // Override per-call via context
+ * await client.call(method, payload, {
+ *   context: { auth: { token: "override-token" } }
+ * });
+ * ```
+ *
+ * @example Bearer Token
+ * ```typescript
+ * createAuthMiddleware({ token: process.env.API_TOKEN })
+ * // HTTP: Authorization: Bearer abc123
+ * // WebSocket: frame.metadata.auth.token
+ * ```
+ *
+ * @example API Key
+ * ```typescript
+ * createAuthMiddleware({ apiKey: process.env.API_KEY })
+ * // HTTP: X-API-Key: xyz789
+ * // WebSocket: frame.metadata.auth.apiKey
+ * ```
+ *
+ * @example Dynamic Auth (from function)
+ * ```typescript
+ * createAuthMiddleware(() => ({
+ *   token: getTokenFromStore(),
+ *   userId: getCurrentUserId(),
+ * }))
+ * ```
+ */
+export declare function createAuthMiddleware(authOptionsOrFn: AuthOptions | (() => AuthOptions)): TypedClientMiddleware<AuthContext, {}>;
+/**
+ * Create Bearer token auth middleware (convenience)
+ *
+ * @example
+ * ```typescript
+ * createBearerAuthMiddleware("abc123")
+ * // Equivalent to: createAuthMiddleware({ token: "abc123" })
+ * ```
+ */
+export declare function createBearerAuthMiddleware(tokenOrFn: string | (() => string)): TypedClientMiddleware<AuthContext, {}>;
+/**
+ * Create API key auth middleware (convenience)
+ *
+ * @example
+ * ```typescript
+ * createApiKeyAuthMiddleware("xyz789")
+ * // Equivalent to: createAuthMiddleware({ apiKey: "xyz789" })
+ * ```
+ */
+export declare function createApiKeyAuthMiddleware(apiKeyOrFn: string | (() => string)): TypedClientMiddleware<AuthContext, {}>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/client/middleware/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,GACjD,qBAAqB,CAAC,WAAW,EAAE,EAAE,CAAC,CAiBxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GACjC,qBAAqB,CAAC,WAAW,EAAE,EAAE,CAAC,CAMxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAClC,qBAAqB,CAAC,WAAW,EAAE,EAAE,CAAC,CAMxC"}

package/dist/client/middleware/auth.js

@@ -0,0 +1,98 @@
+/**
+ * Authentication Middleware
+ *
+ * Adds authentication metadata to requests.
+ * Works with ALL transports (HTTP, WebSocket, Local, Mock).
+ *
+ * Each transport converts metadata.auth to its protocol format:
+ * - HTTP: Authorization header, X-API-Key header
+ * - WebSocket: Frame metadata
+ * - Local: Passed directly to handler
+ */
+/**
+ * Create authentication middleware
+ *
+ * Adds auth metadata to all requests. The transport layer
+ * converts this to protocol-specific format.
+ *
+ * **Context Override**: User-provided context (via withContext or per-call)
+ * takes precedence. Middleware options serve as defaults.
+ *
+ * @example
+ * ```typescript
+ * // Create middleware with default auth
+ * client.use(createAuthMiddleware({ token: "default-token" }));
+ *
+ * // Override per-call via context
+ * await client.call(method, payload, {
+ *   context: { auth: { token: "override-token" } }
+ * });
+ * ```
+ *
+ * @example Bearer Token
+ * ```typescript
+ * createAuthMiddleware({ token: process.env.API_TOKEN })
+ * // HTTP: Authorization: Bearer abc123
+ * // WebSocket: frame.metadata.auth.token
+ * ```
+ *
+ * @example API Key
+ * ```typescript
+ * createAuthMiddleware({ apiKey: process.env.API_KEY })
+ * // HTTP: X-API-Key: xyz789
+ * // WebSocket: frame.metadata.auth.apiKey
+ * ```
+ *
+ * @example Dynamic Auth (from function)
+ * ```typescript
+ * createAuthMiddleware(() => ({
+ *   token: getTokenFromStore(),
+ *   userId: getCurrentUserId(),
+ * }))
+ * ```
+ */
+export function createAuthMiddleware(authOptionsOrFn) {
+    return (next) => async function* (context) {
+        // Get auth options (static or dynamic)
+        const authOptions = typeof authOptionsOrFn === "function"
+            ? authOptionsOrFn()
+            : authOptionsOrFn;
+        // Merge: middleware defaults first, then user-provided context takes precedence
+        // User context is already in metadata.auth from Client.stream()
+        context.message.metadata.auth = {
+            ...authOptions, // Middleware defaults
+            ...context.message.metadata.auth, // User context overrides
+        };
+        // Continue middleware chain
+        yield* next(context);
+    };
+}
+/**
+ * Create Bearer token auth middleware (convenience)
+ *
+ * @example
+ * ```typescript
+ * createBearerAuthMiddleware("abc123")
+ * // Equivalent to: createAuthMiddleware({ token: "abc123" })
+ * ```
+ */
+export function createBearerAuthMiddleware(tokenOrFn) {
+    return createAuthMiddleware(typeof tokenOrFn === "function"
+        ? () => ({ token: tokenOrFn() })
+        : { token: tokenOrFn });
+}
+/**
+ * Create API key auth middleware (convenience)
+ *
+ * @example
+ * ```typescript
+ * createApiKeyAuthMiddleware("xyz789")
+ * // Equivalent to: createAuthMiddleware({ apiKey: "xyz789" })
+ * ```
+ */
+export function createApiKeyAuthMiddleware(apiKeyOrFn) {
+    return createAuthMiddleware(typeof apiKeyOrFn === "function"
+        ? () => ({ apiKey: apiKeyOrFn() })
+        : { apiKey: apiKeyOrFn });
+}
+//# sourceMappingURL=auth.js.map

package/dist/client/middleware/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/client/middleware/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,UAAU,oBAAoB,CAClC,eAAkD;IAElD,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,OAAO;QACvC,uCAAuC;QACvC,MAAM,WAAW,GAAG,OAAO,eAAe,KAAK,UAAU;YACvD,CAAC,CAAC,eAAe,EAAE;YACnB,CAAC,CAAC,eAAe,CAAC;QAEpB,gFAAgF;QAChF,gEAAgE;QAChE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG;YAC9B,GAAG,WAAW,EAAyB,sBAAsB;YAC7D,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAO,yBAAyB;SACjE,CAAC;QAEF,4BAA4B;QAC5B,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAkC;IAElC,OAAO,oBAAoB,CACzB,OAAO,SAAS,KAAK,UAAU;QAC7B,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;QAChC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAmC;IAEnC,OAAO,oBAAoB,CACzB,OAAO,UAAU,KAAK,UAAU;QAC9B,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QAClC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAC3B,CAAC;AACJ,CAAC"}

package/dist/client/middleware/batching.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Batching Middleware
+ *
+ * Combines multiple requests into a single batch for efficiency.
+ * Reduces network overhead and improves throughput.
+ *
+ * Works with both client and server!
+ */
+import type { ClientMiddleware, Message, TypedClientMiddleware } from "../types.js";
+import type { BatchingContext } from "./contexts.js";
+/**
+ * Batching options.
+ */
+export interface BatchingOptions {
+    /**
+     * Maximum batch size (number of requests).
+     * @default 10
+     */
+    maxBatchSize?: number;
+    /**
+     * Maximum wait time before sending batch (in milliseconds).
+     * @default 10
+     */
+    maxWaitTime?: number;
+    /**
+     * Only batch requests to the same service.
+     * @default true
+     */
+    sameServiceOnly?: boolean;
+    /**
+     * Custom batch key function.
+     * Requests with the same key will be batched together.
+     * @default Group by service name
+     */
+    getBatchKey?: (message: Message) => string;
+    /**
+     * Callback when batch is sent.
+     */
+    onBatchSent?: (batchSize: number, batchKey: string) => void;
+}
+/**
+ * Batching statistics.
+ */
+export interface BatchingStats {
+    totalRequests: number;
+    totalBatches: number;
+    averageBatchSize: number;
+    pendingRequests: number;
+}
+/**
+ * Create batching middleware.
+ *
+ * Automatically combines multiple requests into batches for efficiency.
+ *
+ * @param options - Batching configuration
+ * @returns Middleware function
+ *
+ * @example
+ * ```typescript
+ * client.use(createBatchingMiddleware({
+ *   maxBatchSize: 10,      // Combine up to 10 requests
+ *   maxWaitTime: 10,       // Wait max 10ms before sending
+ *   sameServiceOnly: true  // Only batch requests to same service
+ * }));
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom batching by operation
+ * client.use(createBatchingMiddleware({
+ *   getBatchKey: (msg) => `${msg.method.service}:${msg.method.operation}`
+ * }));
+ * ```
+ */
+export declare function createBatchingMiddleware(options?: BatchingOptions): TypedClientMiddleware<BatchingContext, {}>;
+/**
+ * Get batching statistics.
+ *
+ * Note: This is a placeholder - proper implementation would
+ * require exposing the queue through the middleware instance.
+ */
+export declare function getBatchingStats(_middleware: ClientMiddleware): BatchingStats | null;
+/**
+ * Create adaptive batching middleware.
+ *
+ * Automatically adjusts batch size based on request patterns.
+ *
+ * @example
+ * ```typescript
+ * client.use(createAdaptiveBatchingMiddleware({
+ *   minBatchSize: 2,
+ *   maxBatchSize: 50,
+ *   targetLatency: 20  // Target 20ms latency
+ * }));
+ * ```
+ */
+export declare function createAdaptiveBatchingMiddleware(options?: {
+    minBatchSize?: number;
+    maxBatchSize?: number;
+    targetLatency?: number;
+}): ClientMiddleware;
+//# sourceMappingURL=batching.d.ts.map

package/dist/client/middleware/batching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching.d.ts","sourceRoot":"","sources":["../../../src/client/middleware/batching.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAA+B,OAAO,EAAgB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC/H,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAE3C;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AA8HD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,eAAoB,GAC5B,qBAAqB,CAAC,eAAe,EAAE,EAAE,CAAC,CAgE5C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,gBAAgB,GAC5B,aAAa,GAAG,IAAI,CAEtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,GAAE;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,gBAAgB,CAoDxB"}