@procedures/client 0.0.0-stage → 0.1.0

package/dist/server/server.js

@@ -0,0 +1,279 @@
+/**
+ * Universal Server
+ *
+ * Protocol-agnostic RPC server.
+ * Registers handlers and processes requests in unified format.
+ */
+import { HandlerNotFoundError, ServerError } from "./types.js";
+import { compose } from "../middleware/index.js";
+/**
+ * Universal RPC server.
+ *
+ * Features:
+ * - Protocol-agnostic (HTTP, WebSocket, gRPC via adapters)
+ * - Middleware support (logging, auth, validation, etc.)
+ * - Handler registry with pattern matching
+ * - Graceful shutdown
+ * - Error handling
+ *
+ * @example
+ * ```typescript
+ * const server = new Server({
+ *   transports: [
+ *     new HttpServerTransport({ port: 3000 }),
+ *     new WebSocketServerTransport({ port: 3001 })
+ *   ]
+ * });
+ *
+ * // Register handlers
+ * server.register(
+ *   { service: "users", operation: "get" },
+ *   async (req) => ({
+ *     id: req.id,
+ *     status: { type: "success", code: 200 },
+ *     payload: { id: "123", name: "John" },
+ *     metadata: {}
+ *   })
+ * );
+ *
+ * // Add middleware
+ * server.use(createLoggingMiddleware());
+ * server.use(createAuthMiddleware());
+ *
+ * await server.start();
+ * ```
+ */
+export class Server {
+    handlers = [];
+    middleware = [];
+    transports = [];
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        this.transports = options.transports ?? [];
+    }
+    /**
+     * Register a handler for a method.
+     *
+     * @param matcher - Method to match (exact or pattern)
+     * @param handler - Handler function
+     *
+     * @example
+     * ```typescript
+     * // Exact match
+     * server.register(
+     *   { service: "users", operation: "get" },
+     *   async (req) => ({ ... })
+     * );
+     *
+     * // Pattern match (all operations for a service)
+     * server.register(
+     *   { service: "users", operation: /.* / },
+     *   async (req) => ({ ... })
+     * );
+     * ```
+     */
+    register(matcher, handler) {
+        this.handlers.push({
+            matcher: this.normalizeMethodMatcher(matcher),
+            handler,
+        });
+    }
+    /**
+     * Add middleware to the server.
+     * Middleware is applied in the order it's registered.
+     *
+     * @param middleware - Middleware function
+     */
+    use(middleware) {
+        this.middleware.push(middleware);
+    }
+    /**
+     * Add a transport to the server.
+     *
+     * @param transport - Server transport adapter
+     */
+    addTransport(transport) {
+        this.transports.push(transport);
+    }
+    /**
+     * Get all registered transports.
+     *
+     * @returns Array of server transports
+     */
+    getTransports() {
+        return [...this.transports];
+    }
+    /**
+     * Start all server transports.
+     * Begins listening for incoming requests.
+     */
+    async start() {
+        // Start all transports
+        await Promise.all(this.transports.map((t) => t.start()));
+    }
+    /**
+     * Stop all server transports.
+     * Gracefully shuts down connections.
+     */
+    async stop() {
+        await Promise.all(this.transports.map((t) => t.stop()));
+    }
+    /**
+     * Handle a request (called by transport adapters).
+     * Processes request through middleware and handlers.
+     *
+     * @param request - Incoming request in unified format
+     * @returns Response in unified format
+     */
+    async handle(request) {
+        // Log request
+        if (this.options.onRequest) {
+            this.options.onRequest(request);
+        }
+        try {
+            // Find handler
+            const handler = this.findHandler(request.method);
+            if (!handler) {
+                throw new HandlerNotFoundError(request.method);
+            }
+            // Create base runner
+            const baseRunner = async (context) => {
+                return (await handler(context.request));
+            };
+            // Compose middleware
+            const runner = compose(...this.middleware, baseRunner);
+            // Execute
+            const context = {
+                request,
+                state: {},
+            };
+            const response = await runner(context);
+            // Log response
+            if (this.options.onResponse) {
+                this.options.onResponse(response);
+            }
+            return response;
+        }
+        catch (error) {
+            // Log error
+            if (this.options.onError) {
+                this.options.onError(error, request);
+            }
+            // Convert error to response
+            return this.errorToResponse(request.id, error);
+        }
+    }
+    /**
+     * Find handler for a method. A subclass can add handlers that it finds at request time
+     * (`ProcedureServer` looks up its registry).
+     */
+    findHandler(method) {
+        for (const entry of this.handlers) {
+            if (this.matchesMethod(entry.matcher, method)) {
+                return entry.handler;
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if a method matches a matcher.
+     */
+    matchesMethod(matcher, method) {
+        // Match service
+        if (matcher.service instanceof RegExp) {
+            if (!matcher.service.test(method.service)) {
+                return false;
+            }
+        }
+        else {
+            if (matcher.service !== method.service) {
+                return false;
+            }
+        }
+        // Match operation
+        if (matcher.operation instanceof RegExp) {
+            if (!matcher.operation.test(method.operation)) {
+                return false;
+            }
+        }
+        else {
+            if (matcher.operation !== method.operation) {
+                return false;
+            }
+        }
+        // Match version (optional)
+        if (matcher.version !== undefined) {
+            if (matcher.version instanceof RegExp) {
+                if (!matcher.version.test(method.version ?? "")) {
+                    return false;
+                }
+            }
+            else {
+                if (matcher.version !== method.version) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Normalize method matcher.
+     */
+    normalizeMethodMatcher(matcher) {
+        // If already a MethodMatcher, return as-is
+        if ("service" in matcher && typeof matcher.service === "object") {
+            return matcher;
+        }
+        // Convert Method to exact MethodMatcher
+        const method = matcher;
+        return {
+            service: method.service,
+            operation: method.operation,
+            ...(method.version !== undefined && { version: method.version }),
+        };
+    }
+    /**
+     * Convert error to response.
+     */
+    errorToResponse(id, error) {
+        if (error instanceof HandlerNotFoundError) {
+            return {
+                id,
+                status: {
+                    type: "error",
+                    // The symbolic code, as the other errors: the HTTP transport maps it to 404. Before,
+                    // the code was the string "404", which the HTTP transport sent as a 500 (deep dive TRN-7).
+                    code: "NOT_FOUND",
+                    message: error.message,
+                    retryable: false,
+                },
+                metadata: {},
+            };
+        }
+        if (error instanceof ServerError) {
+            return {
+                id,
+                status: {
+                    type: "error",
+                    code: error.code,
+                    message: error.message,
+                    retryable: error.retryable,
+                },
+                metadata: {},
+            };
+        }
+        // Generic error
+        return {
+            id,
+            status: {
+                type: "error",
+                code: "500",
+                message: error.message || "Internal server error",
+                retryable: false,
+            },
+            metadata: {},
+        };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Universal Server Types
+ *
+ * Protocol-agnostic server types mirroring the client architecture.
+ * Enables handling HTTP, WebSocket, gRPC, etc. with unified RPC format.
+ */
+import type { Metadata, Status, Method } from "../client/types.js";
+export type { Method };
+/**
+ * Server request in unified RPC format.
+ * Created by transport adapters from protocol-specific requests.
+ */
+export interface ServerRequest<TReq = unknown> {
+    /** Unique request ID (for correlation, logging) */
+    id: string;
+    /** RPC method (service, operation, version) */
+    method: Method;
+    /** Request payload */
+    payload: TReq;
+    /** Request metadata (headers, query params, etc.) */
+    metadata: Metadata;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Server response in unified RPC format.
+ * Converted by transport adapters to protocol-specific responses.
+ */
+export interface ServerResponse<TRes = unknown> {
+    /** Request ID (for correlation) */
+    id: string;
+    /** Response status */
+    status: Status;
+    /** Response payload (only present on success) */
+    payload?: TRes;
+    /**
+     * The items of a stream response. When this field is set, the response is a stream: the
+     * transport sends each item, then the end of the stream. An error from the iterator ends
+     * the stream with an error. A transport that cannot stream sends the last item.
+     */
+    stream?: AsyncIterable<TRes>;
+    /** Response metadata */
+    metadata: Metadata;
+}
+/**
+ * Server handler function.
+ * Processes requests in unified RPC format.
+ */
+export type ServerHandler<TReq = unknown, TRes = unknown> = (request: ServerRequest<TReq>) => Promise<ServerResponse<TRes>> | ServerResponse<TRes>;
+/**
+ * Server middleware context.
+ * Passed through middleware chain.
+ */
+export interface ServerContext<TReq = unknown> {
+    /** The incoming request */
+    request: ServerRequest<TReq>;
+    /** Additional context data (can be set by middleware) */
+    state: Record<string, unknown>;
+}
+/**
+ * Server middleware runner.
+ * Processes a request and returns a response.
+ */
+export type ServerRunner<TReq = unknown, TRes = unknown> = (context: ServerContext<TReq>) => Promise<ServerResponse<TRes>>;
+/**
+ * Server middleware function.
+ * Can intercept, modify, or handle requests.
+ */
+export type ServerMiddleware<TReq = unknown, TRes = unknown> = (next: ServerRunner<TReq, TRes>) => ServerRunner<TReq, TRes>;
+/**
+ * Server transport adapter interface.
+ * Adapts protocol-specific servers to unified RPC format.
+ */
+export interface ServerTransport {
+    /** Transport name (for logging, debugging) */
+    readonly name: string;
+    /**
+     * Start the server transport.
+     * Begins listening for incoming requests.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server transport.
+     * Gracefully shuts down and closes connections.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if transport is running.
+     */
+    isRunning(): boolean;
+}
+/**
+ * Handler not found error.
+ */
+export declare class HandlerNotFoundError extends Error {
+    constructor(method: Method);
+}
+/**
+ * Server error with status code.
+ */
+export declare class ServerError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(message: string, code?: string, retryable?: boolean);
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGnE,YAAY,EAAE,MAAM,EAAE,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,OAAO;IAC3C,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IAEX,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,OAAO,EAAE,IAAI,CAAC;IAEd,qDAAqD;IACrD,QAAQ,EAAE,QAAQ,CAAC;IAEnB,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,IAAI,GAAG,OAAO;IAC5C,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,OAAO,CAAC,EAAE,IAAI,CAAC;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IAE7B,wBAAwB;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,IAAI,CAC1D,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,KACzB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,OAAO;IAC3C,2BAA2B;IAC3B,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IAE7B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,IAAI,CACzD,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,KACzB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,IAAI,CAC7D,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,KAC3B,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,MAAM,EAAE,MAAM,EAOzB;CACF;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,OAAO;IAHpC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,MAAc,EACpB,SAAS,GAAE,OAAe,EAI3C;CACF"}

package/dist/server/types.js

@@ -0,0 +1,29 @@
+/**
+ * Universal Server Types
+ *
+ * Protocol-agnostic server types mirroring the client architecture.
+ * Enables handling HTTP, WebSocket, gRPC, etc. with unified RPC format.
+ */
+/**
+ * Handler not found error.
+ */
+export class HandlerNotFoundError extends Error {
+    constructor(method) {
+        super(`No handler found for ${method.service}.${method.operation}${method.version ? ` (v${method.version})` : ""}`);
+        this.name = "HandlerNotFoundError";
+    }
+}
+/**
+ * Server error with status code.
+ */
+export class ServerError extends Error {
+    code;
+    retryable;
+    constructor(message, code = "500", retryable = false) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "ServerError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmHH;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,MAAc;QACxB,KAAK,CACH,wBAAwB,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,GACxD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAC7C,EAAE,CACH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB,IAAI;IACJ,SAAS;IAH3B,YACE,OAAe,EACC,IAAI,GAAW,KAAK,EACpB,SAAS,GAAY,KAAK;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHC,IAAI;yBACJ,SAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,118 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Procedures as data for TypeScript: define typed procedures once and call them in process, over HTTP, WebSocket, the CLI or MCP. Streaming, middleware, retries, caching and a JSON program format.",
+  "keywords": [
+    "rpc",
+    "procedures",
+    "typescript",
+    "type-safe",
+    "http",
+    "websocket",
+    "streaming",
+    "middleware",
+    "mcp",
+    "json-rpc",
+    "workflow",
+    "dsl",
+    "zod",
+    "client",
+    "server"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.js"
+    },
+    "./procedures": {
+      "types": "./dist/procedures/index.d.ts",
+      "import": "./dist/procedures/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    }
+  },
+  "bin": {
+    "client-registry": "./dist/procedures/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/browser.js",
+    "./dist/procedures/index.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "ws": "^8.18.3",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@mark1russell7/cue": "^1.0.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "watch": "tsc -b --watch"
+  }
 }

package/src/adapters/http/client/index.ts

@@ -0,0 +1,51 @@
+/**
+ * HTTP Client Transport Adapter
+ *
+ * Public API for HTTP client adapter.
+ * Exports transport and re-exports shared utilities for convenience.
+ */
+
+// Client Transport
+export { HttpTransport } from "./transport.js";
+export type { HttpTransportOptions } from "./types.js";
+
+// Re-export shared utilities for convenience
+export {
+  // Constants
+  HTTP,
+  HTTPMethod,
+  HTTPStatus,
+  HTTPHeaders,
+
+  // Status Code Utilities
+  HTTPStatusToCode,
+  HTTPCodeMap, // Legacy alias
+  isSuccessStatus,
+  isClientErrorStatus,
+  isServerErrorStatus,
+  isRetryableStatus,
+  getStatusCode,
+  formatHTTPError,
+
+  // Header Utilities
+  type HeaderConverter,
+  type HTTPHeadersMap,
+  createDefaultHeaderConverter,
+
+  // Strategies
+  type UrlStrategy,
+  type HttpMethodStrategy,
+  type UrlPattern,
+  defaultUrlPattern,
+  restfulUrlPattern,
+  restfulHttpMethodStrategy,
+  postOnlyStrategy,
+
+  // Error Utilities
+  HTTPErrorCode,
+  type HTTPErrorDetails,
+  createHTTPStatusError,
+  createNetworkError,
+  createTimeoutError,
+  createAbortError,
+} from "../shared/index.js";