@procedures/client 0.0.0-stage → 0.2.0

package/dist/adapters/websocket/server/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * WebSocket Server Transport Types
+ *
+ * Type definitions for WebSocket server adapter.
+ */
+import type { IncomingMessage } from "http";
+import type { Server as HttpServer } from "http";
+import type { WebSocket } from "ws";
+import type { BrowserGuardOptions } from "../../../server/browser-guard.js";
+/**
+ * WebSocket authentication handler.
+ * Called during WebSocket upgrade to authenticate the connection.
+ */
+export type WebSocketAuthHandler = (req: IncomingMessage) => Promise<boolean> | boolean;
+/**
+ * WebSocket connection handler.
+ * Called when a new WebSocket connection is established.
+ */
+export type WebSocketConnectionHandler = (ws: WebSocket, req: IncomingMessage) => void;
+/**
+ * WebSocket server transport options.
+ */
+export interface WebSocketServerTransportOptions extends Omit<BrowserGuardOptions, "allowGet"> {
+    /**
+     * HTTP server to attach WebSocket server to.
+     * Required - WebSocket upgrades HTTP connections.
+     */
+    server: HttpServer;
+    /**
+     * Path for WebSocket connections.
+     * @default "/ws"
+     */
+    path?: string;
+    /**
+     * Authentication handler for WebSocket upgrade.
+     * Return true to allow connection, false to reject. It runs after the browser checks of the
+     * host and the origin (`allowedHosts`, `allowedOrigins`), which are always on.
+     */
+    authenticate?: WebSocketAuthHandler;
+    /**
+     * Connection handler called when client connects.
+     */
+    onConnection?: WebSocketConnectionHandler;
+    /**
+     * Enable per-message compression.
+     * @default false
+     */
+    perMessageDeflate?: boolean;
+    /**
+     * Maximum message size in bytes.
+     * @default 1MB
+     */
+    maxPayload?: number;
+    /**
+     * Client tracking - track connected clients.
+     * @default true
+     */
+    clientTracking?: boolean;
+    /**
+     * The number of bytes that a connection can hold in its send buffer before a stream waits
+     * (deep dive TRN-3: before, a stream ran to its end whatever the reader did).
+     * @default 1 MiB
+     */
+    highWaterMark?: number;
+}
+/**
+ * WebSocket message format for RPC.
+ */
+export interface WebSocketMessage<TReq = unknown> {
+    /** Message ID for request/response matching */
+    id: string;
+    /** Message type */
+    type: "request" | "response" | "error" | "stream" | "cancel" | "credit" | "ping" | "pong" | "server-request" | "server-response" | "event";
+    /** RPC method (for requests) */
+    method?: {
+        service: string;
+        operation: string;
+        version?: string;
+    };
+    /** Procedure path (for server-request) */
+    path?: string[];
+    /** Input data (for server-request) */
+    input?: unknown;
+    /** Result data (for server-response) */
+    result?: unknown;
+    /** Message payload */
+    payload?: TReq;
+    /** Metadata (headers, auth, etc.) */
+    metadata?: Record<string, unknown>;
+    /** Status (for responses) */
+    status?: {
+        type: "success" | "error";
+        code: string | number;
+        message?: string;
+        retryable?: boolean;
+    };
+    /** Error details (for error messages) */
+    error?: {
+        code: string | number;
+        message: string;
+        retryable?: boolean;
+    };
+    /**
+     * Flow control of a stream (deep dive TRN-3). In a request: the number of stream items that
+     * the client can take before it sends more credit. In a "credit" message: the number of more
+     * items. A request without credit gets its stream with no limit (the old protocol).
+     */
+    credit?: number;
+    /** Stream indicator (for streaming responses) */
+    stream?: {
+        /** Is this the last message in the stream? */
+        done: boolean;
+    };
+    /** Topic (for event messages) */
+    topic?: string;
+    /** Data (for event messages) */
+    data?: unknown;
+    /** Subscription ID (for event messages) */
+    subscriptionId?: string;
+}
+/**
+ * Tracked connection with ID for bidirectional communication.
+ */
+export interface TrackedConnection {
+    /** Unique connection ID */
+    id: string;
+    /** WebSocket instance */
+    socket: WebSocket;
+    /** When the connection was established */
+    connectedAt: Date;
+    /** Connection metadata */
+    metadata: Record<string, unknown>;
+    /** Available procedures on this connection (discovered) */
+    procedures?: string[];
+}
+/**
+ * Connection event handler.
+ */
+export type ConnectionEventHandler = (connection: TrackedConnection) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/websocket/server/types.d.ts.map

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

package/dist/adapters/websocket/server/types.js

@@ -0,0 +1,7 @@
+/**
+ * WebSocket Server Transport Types
+ *
+ * Type definitions for WebSocket server adapter.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/websocket/server/types.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Universal Client Library: the browser-safe entry point.
+ *
+ * This module exports everything of the package except the Node server transports
+ * (`HttpServerTransport` and `WebSocketServerTransport`, which use `http` and `ws`).
+ * A browser bundle imports "@procedures/client/browser". The root entry point
+ * re-exports this module and adds the server transports.
+ *
+ * Collections (maps, caches, collection storage) are in @procedures/collections.
+ * The program store, the storage backends that need a Client (ApiStorage, HybridStorage) and the
+ * synced registry are in @procedures/store (roadmap 3.2).
+ */
+export { Client, ClientError } from "./client/index.js";
+export { HttpTransport, LocalTransport, WebSocketTransport, MockTransport, mockBuilder, } from "./client/index.js";
+export { defaultUrlPattern, restfulHttpMethodStrategy, postOnlyStrategy, } from "./client/index.js";
+export type { Transport, Method, Metadata, Message, ResponseItem, Status, ClientContext, ClientRunner, ClientMiddleware, ClientOptions, HttpTransportOptions, UrlStrategy, HttpMethodStrategy, LocalTransportOptions, Handler, WebSocketTransportOptions, MockTransportOptions, MockResponse, ResponseMatcher, CallHistoryEntry, } from "./client/index.js";
+export { WebSocketState } from "./client/index.js";
+export type { ErrorMetadata, ErrorRegistry, ErrorContext, RichError } from "./client/index.js";
+export { ErrorSeverity, ErrorCategory } from "./client/index.js";
+export { ERROR_REGISTRY, getErrorMetadata, isKnownError, createError, createErrorFromHTTPStatus, createErrorFromException, formatError, } from "./client/index.js";
+export { Server } from "./server/server.js";
+export type { ServerOptions } from "./server/server.js";
+export { ProcedureServer, createProcedureServer } from "./server/procedure-server.js";
+export type { ProcedureServerOptions, StorageConfig } from "./server/procedure-server.js";
+export { HandlerNotFoundError, ServerError, } from "./server/types.js";
+export { pathToMethod, methodToPath } from "./server/method.js";
+export type { ServerRequest, ServerResponse, ServerHandler, ServerMiddleware, ServerContext, ServerRunner, ServerTransport, } from "./server/types.js";
+export { defineProcedure, defineStub, createProcedure, ProcedureBuilder, namespace, validateProcedure, ProcedureRegistry, RegistryError, PROCEDURE_REGISTRY, assertValidPath, pathToKey, keyToPath, createCollectionProcedures, registerModule, registerProcedures, createAndRegister, clientModule, defineModule, moduleClosure, registerModules, createRegistry, registerClientProcedures, PROCEDURE_SYMBOL, PROCEDURE_JSON_KEY, PROCEDURE_WHEN_KEY, PROCEDURE_NAME_KEY, WHEN_IMMEDIATE, WHEN_NEVER, WHEN_PARENT, isProcedureRef, isProcedureRefJson, isAnyProcedureRef, getRefWhen, getRefName, shouldExecuteRef, proc, ProcedureRefBuilder, fromJson, toJson, normalizeRef, hydrateInput, prepareRootCall, observeHydration, isControlFlowPath, isDataDriven, markDataDriven, RUNS_REFS_TAG, RAW_INPUT_TAG, takesRawInput, rawInputRule, MAX_DATA_DEPTH, LITERAL_KEY, isLiteral, isPlainObject, createRefScope, lookupOutputRef, resolveOutputRef, withScope, scopeOf, executeRef, extractTemplate, parseProcedureJson, stringifyProcedureJson, coreProcedures, coreModule, allCoreProcedures, allCoreModules, chainProcedure, parallelProcedure, conditionalProcedure, andProcedure, orProcedure, notProcedure, allProcedure, anyProcedure, noneProcedure, mapProcedure, reduceProcedure, identityProcedure, constantProcedure, throwProcedure, tryCatchProcedure, anySchema, typedAnySchema, zodAdapter, outputSchema, defineProcedureProcedure, getProcedureProcedure, listProceduresProcedure, deleteProcedureProcedure, metaProcedures, getRuntimeProcedure, hasRuntimeProcedure, getAllRuntimeProcedures, clearRuntimeProcedures, isRuntimeDefined, runtimeProgramOf, } from "./procedures/index.js";
+export type { Effects, PermittedEffects, Register, ClearanceOf, ResourcesOf, Capability, CapabilityRequest, ClearanceOrder, NestedCallOptions, Procedure, AnyProcedure, ProcedurePath, ProcedureMetadata, ProcedureHandler, ProcedureContext, ProcedureResult, ProcedureError, RepositoryProvider, CollectionStorage, StorageMetadata, ProcedureModule, ModuleInput, RegistrationOptions, ProcedureRegistryLike, ProcedureDefinition, ProcedureStub, InferProcedureInput, InferProcedureOutput, InferProcedureMetadata, RegistryEventType, RegistryListener, ProcedureWhen, ProcedureRef, ProcedureRefJson, AnyProcedureRef, RefExecutor, HydrateOptions, HydrationEvent, StepResultInfo, ContinueDecision, OutputRef, RefScope, ZodLikeSchema, AggregationDefinition, DefineProcedureInput, DefineProcedureOutput, } from "./procedures/index.js";
+export { invokeProcedure, invokePath, outputValue, outputItems, streamOutput, InvocationError, isAsyncIterable, } from "./procedures/invoke.js";
+export type { InvokeOptions, ProcedureOutput, InvocationErrorCode, Invocation, InvocationChanges, InvocationNext, Interceptor, } from "./procedures/invoke.js";
+export { callMatches, validateCalls, declaredCalls, nestedCallRefusal, hasCallPolicy, hiddenReach } from "./procedures/policy.js";
+export { STANDARD_RESOURCES, UNLIMITED_CAPABILITY, ladder, effectsOf, isReadOnly, isDestructive, isOpenWorld, toolHints, narrowCapability, capabilityRefusal, examinesNestedCall, explainInvocation, checkEffects, } from "./procedures/capability.js";
+export { PURE_EFFECTS, REGISTRY_READ_EFFECTS, withEffects } from "./procedures/effects.js";
+export type { ToolHints, CapabilityRefusal, CapabilityRefusalReason, InvocationExplanation, EffectsViolation } from "./procedures/capability.js";
+export type { CallPolicy, CallRefusal, HiddenCall } from "./procedures/policy.js";
+export { timeoutInterceptor, tracingInterceptor, metricsInterceptor } from "./procedures/interceptors.js";
+export type { TimeoutInterceptorOptions, TracingInterceptorOptions, InvocationSpan, ProcedureMetrics, MetricsInterceptor, } from "./procedures/interceptors.js";
+export { hostPolicy, procedureServerOptions, exposePatterns, surfaceRule } from "./server/host-policy.js";
+export type { HostPolicy, HostPolicyOptions, ToolSurface } from "./server/host-policy.js";
+export type { Route, RouteNode, RouteLeaf, CallRequest, SingleCallRequest, CallResponse, ProcedureCallResult, StreamingCallResponse, BatchConfig, BatchStrategy, StreamConfig, MiddlewareOverrides, RetryOverride, TimeoutOverride, CacheOverride, } from "./client/call-types.js";
+export { flattenRoute, buildResponse, createRoute, mergeRoutes, isBatchRoute, } from "./client/call-types.js";
+export { RouteResolver, createRouteResolver, isValidRoute, getMissingPaths, matchPath } from "./client/route-resolver.js";
+export type { ResolvedRoute, RouteResolutionResult, RouteResolutionError } from "./client/route-resolver.js";
+export { BatchExecutor, createBatchExecutor, Semaphore, executeWithConcurrency } from "./client/batch-executor.js";
+export type { ProcedureExecutor, ExecutionContext, BatchExecutionResult, BatchItem } from "./client/batch-executor.js";
+export { DefaultEventBus as EventBus, createEventBus, createTypedEventBus, getGlobalEventBus, withEventBusSignal, } from "./events/index.js";
+export type { EventBus as IEventBus, TypedEventBus, EventHandler, EventBusOptions, EventWaitOptions, ChannelMap, } from "./events/index.js";
+export { validateSchema, validateSchemaAsync, jsonSchemaOf, isStandardSchema, describeIssues, } from "./procedures/index.js";
+export type { StandardSchemaV1, StandardJSONSchemaConverter, ProcedureSchema, InferSchema, SchemaResult, JsonSchema, JsonSchemaTarget, JsonSchemaSource, } from "./procedures/index.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

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

package/dist/browser.js

@@ -0,0 +1,89 @@
+/**
+ * Universal Client Library: the browser-safe entry point.
+ *
+ * This module exports everything of the package except the Node server transports
+ * (`HttpServerTransport` and `WebSocketServerTransport`, which use `http` and `ws`).
+ * A browser bundle imports "@procedures/client/browser". The root entry point
+ * re-exports this module and adds the server transports.
+ *
+ * Collections (maps, caches, collection storage) are in @procedures/collections.
+ * The program store, the storage backends that need a Client (ApiStorage, HybridStorage) and the
+ * synced registry are in @procedures/store (roadmap 3.2).
+ */
+// ============================================================================
+// Universal Client (protocol-agnostic RPC)
+// Core client and transports
+// Import client middleware explicitly: import { createRetryMiddleware } from "@procedures/client/client"
+// ============================================================================
+export { Client, ClientError } from "./client/index.js";
+export { HttpTransport, LocalTransport, WebSocketTransport, MockTransport, mockBuilder, } from "./client/index.js";
+export { defaultUrlPattern, restfulHttpMethodStrategy, postOnlyStrategy, } from "./client/index.js";
+// WebSocketState is a runtime enum, not just a type — export as a value so consumers can compare
+// against WebSocketState.CONNECTED etc. See documentation/BUGS-2026-07.md (L1).
+export { WebSocketState } from "./client/index.js";
+export { ErrorSeverity, ErrorCategory } from "./client/index.js";
+export { ERROR_REGISTRY, getErrorMetadata, isKnownError, createError, createErrorFromHTTPStatus, createErrorFromException, formatError, } from "./client/index.js";
+// ============================================================================
+// Universal Server (protocol-agnostic RPC)
+// The server transports are Node only: the root entry point exports them.
+// ============================================================================
+export { Server } from "./server/server.js";
+export { ProcedureServer, createProcedureServer } from "./server/procedure-server.js";
+export { HandlerNotFoundError, ServerError, } from "./server/types.js";
+export { pathToMethod, methodToPath } from "./server/method.js";
+// ============================================================================
+// Procedure System - Type-safe RPC with auto-discovery
+// ============================================================================
+export { defineProcedure, defineStub, createProcedure, ProcedureBuilder, namespace, validateProcedure, ProcedureRegistry, RegistryError, PROCEDURE_REGISTRY, assertValidPath, pathToKey, keyToPath, createCollectionProcedures, 
+// Manual registration helpers
+registerModule, registerProcedures, createAndRegister, 
+// Modules and explicit registries (roadmap 3.1)
+clientModule, defineModule, moduleClosure, registerModules, createRegistry, registerClientProcedures, 
+// Procedure reference system (procedure-as-data)
+PROCEDURE_SYMBOL, PROCEDURE_JSON_KEY, PROCEDURE_WHEN_KEY, PROCEDURE_NAME_KEY, WHEN_IMMEDIATE, WHEN_NEVER, WHEN_PARENT, isProcedureRef, isProcedureRefJson, isAnyProcedureRef, getRefWhen, getRefName, shouldExecuteRef, proc, ProcedureRefBuilder, fromJson, toJson, normalizeRef, hydrateInput, prepareRootCall, observeHydration, isControlFlowPath, isDataDriven, markDataDriven, RUNS_REFS_TAG, RAW_INPUT_TAG, takesRawInput, rawInputRule, MAX_DATA_DEPTH, LITERAL_KEY, isLiteral, isPlainObject, createRefScope, lookupOutputRef, resolveOutputRef, withScope, scopeOf, executeRef, extractTemplate, parseProcedureJson, stringifyProcedureJson, 
+// Core language procedures
+coreProcedures, coreModule, 
+// Every core procedure (math, comparison, string, type, object, array, meta too). Not registered by default.
+allCoreProcedures, allCoreModules, chainProcedure, parallelProcedure, conditionalProcedure, andProcedure, orProcedure, notProcedure, allProcedure, anyProcedure, noneProcedure, mapProcedure, reduceProcedure, identityProcedure, constantProcedure, throwProcedure, tryCatchProcedure, 
+// Common schemas
+anySchema, typedAnySchema, zodAdapter, outputSchema, 
+// Meta-procedures for runtime definition
+defineProcedureProcedure, getProcedureProcedure, listProceduresProcedure, deleteProcedureProcedure, metaProcedures, getRuntimeProcedure, hasRuntimeProcedure, getAllRuntimeProcedures, clearRuntimeProcedures, isRuntimeDefined, runtimeProgramOf, } from "./procedures/index.js";
+// ============================================================================
+// Invocation: the one path, the call policy and the interceptors
+// (ARCHITECTURE-PROPOSALS P1, deep dive MCP-3, roadmap 1.2)
+// ============================================================================
+export { invokeProcedure, invokePath, outputValue, outputItems, streamOutput, InvocationError, isAsyncIterable, } from "./procedures/invoke.js";
+export { callMatches, validateCalls, declaredCalls, nestedCallRefusal, hasCallPolicy, hiddenReach } from "./procedures/policy.js";
+// Capabilities (CAPABILITIES-2026-10)
+export { STANDARD_RESOURCES, UNLIMITED_CAPABILITY, ladder, effectsOf, isReadOnly, isDestructive, isOpenWorld, toolHints, narrowCapability, capabilityRefusal, examinesNestedCall, explainInvocation, checkEffects, } from "./procedures/capability.js";
+export { PURE_EFFECTS, REGISTRY_READ_EFFECTS, withEffects } from "./procedures/effects.js";
+export { timeoutInterceptor, tracingInterceptor, metricsInterceptor } from "./procedures/interceptors.js";
+// The policy of a host (roadmap 2.3): one builder for the MCP server, the server CLI and mark
+export { hostPolicy, procedureServerOptions, exposePatterns, surfaceRule } from "./server/host-policy.js";
+export { flattenRoute, buildResponse, createRoute, mergeRoutes, isBatchRoute, } from "./client/call-types.js";
+export { RouteResolver, createRouteResolver, isValidRoute, getMissingPaths, matchPath } from "./client/route-resolver.js";
+export { BatchExecutor, createBatchExecutor, Semaphore, executeWithConcurrency } from "./client/batch-executor.js";
+// ============================================================================
+// Events System - Pub/sub messaging and streaming coordination
+// ============================================================================
+export { DefaultEventBus as EventBus, createEventBus, createTypedEventBus, getGlobalEventBus, withEventBusSignal, } from "./events/index.js";
+// ============================================================================
+// Components (serializable UI descriptors) moved to @procedures/splay, the UI package
+// of the ecosystem (roadmap 3.4).
+// ============================================================================
+// ============================================================================
+// Note: The unified middleware system (./middleware) is a foundation used by both
+// collections and universal client. Access it directly:
+// import { AsyncMiddleware, SyncMiddleware } from "client/middleware"
+//
+// Note: Universal client middleware is available for explicit import:
+// import { createRetryMiddleware } from "client/client"
+// import { createCacheMiddleware } from "client/client"
+// etc.
+// ============================================================================
+// ============================================================================
+// Schemas: Standard Schema v1, validation and JSON Schema (roadmap 2.1)
+// ============================================================================
+export { validateSchema, validateSchemaAsync, jsonSchemaOf, isStandardSchema, describeIssues, } from "./procedures/index.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/client/batch-executor.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Batch Executor
+ *
+ * Executes multiple procedure calls with configurable strategies:
+ * - all: Wait for all results
+ * - race: Return first result, and abort the other calls
+ * - stream: Yield results as they arrive
+ *
+ * Each call gets its own abort signal, linked to the signal of the batch. The executor aborts a
+ * call that can no longer change the result: a loser of a race, a call that still runs when the
+ * reader of a stream stops, or (with `continueOnError: false`) every call after the first failure.
+ */
+import type { ProcedurePath, ProcedureContext } from "../procedures/types.js";
+import type { Route, BatchConfig, BatchStrategy, ProcedureCallResult, CallResponse, StreamingCallResponse } from "./call-types.js";
+import type { ResolvedRoute } from "./route-resolver.js";
+/**
+ * Function that executes a single procedure call.
+ */
+export type ProcedureExecutor = (resolved: ResolvedRoute, context: ExecutionContext) => Promise<ProcedureCallResult>;
+/**
+ * Execution context for procedure calls.
+ */
+export interface ExecutionContext {
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Request metadata */
+    metadata: Record<string, unknown>;
+    /** Procedure context (for handlers) */
+    procedureContext?: ProcedureContext;
+}
+/** The result of one call of a batch. */
+export interface BatchItem {
+    path: ProcedurePath;
+    result: ProcedureCallResult;
+    duration: number;
+}
+/**
+ * Result of batch execution.
+ */
+export interface BatchExecutionResult<TRoute extends Route = Route> {
+    /** Mirrored response structure */
+    response: CallResponse<TRoute>;
+    /** Whether all calls succeeded */
+    success: boolean;
+    /** Total execution time in ms */
+    duration: number;
+    /** Individual call results with paths */
+    results: BatchItem[];
+}
+/**
+ * Executes batched procedure calls with configurable strategies.
+ *
+ * @example
+ * ```typescript
+ * const executor = new BatchExecutor(execute);
+ *
+ * // Execute all routes in parallel
+ * const result = await executor.executeAll(resolved, context);
+ *
+ * // Stream results as they arrive
+ * for await (const { path, result } of executor.executeStream(resolved, context)) {
+ *   console.log(`${path.join('.')}: ${result.success}`);
+ * }
+ * ```
+ */
+export declare class BatchExecutor {
+    private readonly execute;
+    constructor(execute: ProcedureExecutor);
+    /**
+     * Execute resolved routes with the specified strategy.
+     *
+     * @param resolved - Resolved routes to execute
+     * @param context - Execution context
+     * @param config - Batch configuration
+     * @returns Batch execution result
+     */
+    executeBatch<TRoute extends Route>(resolved: ResolvedRoute[], context: ExecutionContext, config?: BatchConfig): Promise<BatchExecutionResult<TRoute>>;
+    /**
+     * Execute all routes in parallel and wait for all results. The results are in route order.
+     *
+     * With `continueOnError: false`, the first failure cancels the other calls: each gets a
+     * `CANCELLED` result. By default, every call runs to its end.
+     */
+    executeAll<TRoute extends Route>(resolved: ResolvedRoute[], context: ExecutionContext, config?: BatchConfig): Promise<BatchExecutionResult<TRoute>>;
+    /**
+     * Execute routes and return when the first one completes. The executor aborts the other calls.
+     */
+    executeRace<TRoute extends Route>(resolved: ResolvedRoute[], context: ExecutionContext): Promise<BatchExecutionResult<TRoute>>;
+    /**
+     * Execute routes and stream results as they arrive.
+     *
+     * Each completed call goes into a queue, so every result reaches the reader, also when several
+     * calls complete in one tick. (Before, the executor gave only the winner of each
+     * `Promise.race`: the other calls of that tick were lost: deep dive CORE-2.)
+     *
+     * - `streamConfig.concurrency`: the maximum number of calls that run at one time.
+     * - `streamConfig.bufferSize`: when this many results wait for the reader, the executor starts
+     *   no new call. 0 or no value: no limit.
+     * - `streamConfig.emitPartial`: false holds every result, then yields them in route order.
+     * - `continueOnError: false`: the first failure cancels the calls that wait or run.
+     *
+     * When the reader stops early, the executor aborts the calls that still run.
+     */
+    executeStream(resolved: ResolvedRoute[], context: ExecutionContext, config?: BatchConfig): AsyncGenerator<BatchItem>;
+    /**
+     * Get a streaming response with both iterator and completion promise.
+     */
+    getStreamingResponse<TRoute extends Route>(resolved: ResolvedRoute[], context: ExecutionContext, config?: BatchConfig): StreamingCallResponse<TRoute>;
+    /**
+     * Collect stream results into a batch result.
+     */
+    private collectStream;
+    private collect;
+    /** Run one call. The result is never a rejection: an exception becomes an error result. */
+    private runOne;
+    /**
+     * Create an error result from an exception.
+     */
+    private createErrorResult;
+}
+/**
+ * Create a batch executor with a procedure executor function.
+ *
+ * @param execute - Function that executes a single procedure
+ * @returns Batch executor instance
+ */
+export declare function createBatchExecutor(execute: ProcedureExecutor): BatchExecutor;
+/**
+ * Determine the optimal batch strategy based on route count and config.
+ *
+ * @param routeCount - Number of routes to execute
+ * @param config - User-provided batch config
+ * @returns Effective batch strategy
+ */
+export declare function determineStrategy(routeCount: number, config?: BatchConfig): BatchStrategy;
+/**
+ * Semaphore for limiting concurrent executions.
+ */
+export declare class Semaphore {
+    private permits;
+    private waiting;
+    constructor(permits: number);
+    acquire(): Promise<void>;
+    release(): void;
+    withPermit<T>(fn: () => Promise<T>): Promise<T>;
+}
+/**
+ * Execute procedures with concurrency limit.
+ *
+ * @param resolved - Routes to execute
+ * @param execute - Executor function
+ * @param context - Execution context
+ * @param concurrency - Maximum concurrent executions
+ * @returns Array of results
+ */
+export declare function executeWithConcurrency(resolved: ResolvedRoute[], execute: ProcedureExecutor, context: ExecutionContext, concurrency: number): Promise<Array<{
+    path: ProcedurePath;
+    result: ProcedureCallResult;
+}>>;
+//# sourceMappingURL=batch-executor.d.ts.map

package/dist/client/batch-executor.d.ts.map

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