@procedures/client 0.0.0-stage → 0.1.0

package/dist/server/procedure-server.js

@@ -0,0 +1,323 @@
+/**
+ * Procedure Server
+ *
+ * Server implementation with procedure auto-registration and repository pattern.
+ * Integrates with ProcedureRegistry and CollectionStorage backends.
+ */
+import { Server } from "./server.js";
+import { methodToPath, pathToMethod } from "./method.js";
+import { pathToKey } from "../procedures/types.js";
+import { ProcedureRegistry, PROCEDURE_REGISTRY } from "../procedures/registry.js";
+import { createCollectionProcedures } from "../procedures/collection/procedures.js";
+import { InvocationError, invokeProcedure } from "../procedures/invoke.js";
+/**
+ * The error response of a failed invocation. An invocation error keeps its code
+ * (VALIDATION_ERROR, NOT_EXPOSED, ABORTED and so on). An error of the handler is HANDLER_ERROR.
+ */
+export function errorResponse(id, error) {
+    // An error that says it is retryable stays retryable: before, every error lost the flag
+    // (deep dive TRN-7)
+    const retryable = error?.retryable;
+    return {
+        id,
+        status: {
+            type: "error",
+            code: error instanceof InvocationError ? error.code : "HANDLER_ERROR",
+            message: error instanceof Error ? error.message : String(error),
+            retryable: typeof retryable === "boolean" ? retryable : false,
+        },
+        metadata: {},
+    };
+}
+// =============================================================================
+// Procedure Server
+// =============================================================================
+/**
+ * Server with procedure auto-registration and repository pattern.
+ *
+ * Features:
+ * - Auto-registers handlers from procedure definitions
+ * - Repository pattern for storage backend injection
+ * - Collection storage configuration per-collection
+ * - Integrates with ProcedureRegistry
+ *
+ * @example
+ * ```typescript
+ * const server = new ProcedureServer({
+ *   collections: {
+ *     users: new ApiStorage(remoteClient, { service: 'users' }),
+ *     cache: new InMemoryStorage(),
+ *   }
+ * });
+ *
+ * // Register collection procedures
+ * server.registerCollectionProcedures('users');
+ *
+ * // Or auto-register all from registry
+ * server.registerFromRegistry();
+ *
+ * await server.start();
+ * ```
+ */
+export class ProcedureServer extends Server {
+    procedureRegistry;
+    storages = new Map();
+    /** The procedures that `registerProcedure` pinned, by key */
+    pinnedProcedures = new Map();
+    /**
+     * True after `registerFromRegistry()`: the server serves each procedure of the registry that
+     * has a handler and passes the expose rule, looked up when the request arrives (deep dive
+     * TRN-13). Before, the server copied the registry at startup: a later registration was not
+     * found, and an override or an unregistration was not seen.
+     */
+    servesRegistry = false;
+    expose;
+    strictCalls;
+    interceptors;
+    constructor(options = {}) {
+        super(options);
+        this.procedureRegistry = options.registry ?? PROCEDURE_REGISTRY;
+        this.expose = options.expose;
+        this.strictCalls = options.strictCalls ?? false;
+        this.interceptors = options.interceptors ?? [];
+        // Configure collections
+        if (options.collections) {
+            for (const [name, storage] of Object.entries(options.collections)) {
+                this.storages.set(name, storage);
+            }
+        }
+        // Auto-register if enabled
+        if (options.autoRegister) {
+            this.registerFromRegistry();
+        }
+    }
+    // ===========================================================================
+    // RepositoryProvider Implementation
+    // ===========================================================================
+    /**
+     * Get storage for a collection.
+     *
+     * @param collection - Collection name
+     * @returns Storage instance
+     * @throws Error if collection not configured
+     */
+    getStorage(collection) {
+        const storage = this.storages.get(collection);
+        if (!storage) {
+            throw new Error(`Collection storage not configured: ${collection}`);
+        }
+        return storage;
+    }
+    /**
+     * Check if a collection is configured.
+     *
+     * @param collection - Collection name
+     */
+    hasCollection(collection) {
+        return this.storages.has(collection);
+    }
+    // ===========================================================================
+    // Storage Configuration
+    // ===========================================================================
+    /**
+     * Configure storage for a collection.
+     *
+     * @param name - Collection name
+     * @param storage - Storage backend
+     * @returns this (for chaining)
+     */
+    useStorage(name, storage) {
+        this.storages.set(name, storage);
+        return this;
+    }
+    /**
+     * Configure multiple storages at once.
+     *
+     * @param storages - Map of collection names to storage backends
+     * @returns this (for chaining)
+     */
+    useStorages(storages) {
+        for (const [name, storage] of Object.entries(storages)) {
+            this.storages.set(name, storage);
+        }
+        return this;
+    }
+    /**
+     * Get all configured collection names.
+     */
+    getCollectionNames() {
+        return Array.from(this.storages.keys());
+    }
+    // ===========================================================================
+    // Procedure Registration
+    // ===========================================================================
+    /**
+     * Register a procedure as a server handler. The server keeps this procedure object. A
+     * procedure of the registry at the same path comes first when the server serves the registry.
+     *
+     * @param procedure - Procedure definition
+     */
+    registerProcedure(procedure) {
+        // Must have a handler
+        if (!procedure.handler) {
+            throw new Error(`Procedure at ${pathToKey(procedure.path)} has no handler`);
+        }
+        // The path must make a method: this throws for a path of one segment
+        pathToMethod(procedure.path);
+        this.pinnedProcedures.set(pathToKey(procedure.path), procedure);
+    }
+    /**
+     * Register multiple procedures.
+     *
+     * @param procedures - Array of procedures
+     */
+    registerProcedures(procedures) {
+        for (const procedure of procedures) {
+            this.registerProcedure(procedure);
+        }
+    }
+    /**
+     * Register a procedure module.
+     *
+     * @param module - Module with procedures array
+     */
+    registerModule(module) {
+        this.registerProcedures(module.procedures);
+    }
+    /**
+     * Serve the procedures of the registry. The server looks up each request in the registry when
+     * the request arrives, so a later registration, an override or an unregistration takes effect
+     * at once. A procedure without a handler (a stub synced from storage, BUGS-2026-07 H14/H28) or
+     * outside the expose rule is not served.
+     */
+    registerFromRegistry() {
+        this.servesRegistry = true;
+    }
+    /**
+     * The procedure that answers a method, or undefined. The registry comes first (when the server
+     * serves it), then the pinned procedures.
+     */
+    resolveProcedure(method) {
+        const path = methodToPath(method);
+        if (this.servesRegistry) {
+            const procedure = this.procedureRegistry.get(path);
+            if (procedure?.handler && (!this.expose || this.expose(procedure.path))) {
+                return procedure;
+            }
+        }
+        return this.pinnedProcedures.get(pathToKey(path));
+    }
+    /**
+     * The handlers that `register()` added come first (exact or pattern matches). Then the server
+     * looks up the procedure of the method.
+     */
+    findHandler(method) {
+        const handler = super.findHandler(method);
+        if (handler)
+            return handler;
+        const procedure = this.resolveProcedure(method);
+        return procedure ? (request) => this.invoke(procedure, request) : null;
+    }
+    /** Run a procedure for a request. */
+    async invoke(procedure, request) {
+        try {
+            // One invocation path for every host (ARCHITECTURE-PROPOSALS P1): input validation, the
+            // context, the expose rule for nested calls (BUGS-2026-07 H18) and output validation
+            const output = await invokeProcedure(procedure, request.payload, {
+                registry: this.procedureRegistry,
+                metadata: request.metadata,
+                signal: request.signal,
+                repository: this,
+                expose: this.expose,
+                strictCalls: this.strictCalls,
+                interceptors: this.interceptors,
+            });
+            if (output.kind === "stream") {
+                return { id: request.id, status: { type: "success", code: 200 }, stream: output.items, metadata: {} };
+            }
+            return { id: request.id, status: { type: "success", code: 200 }, payload: output.value, metadata: {} };
+        }
+        catch (error) {
+            return errorResponse(request.id, error);
+        }
+    }
+    /**
+     * Register collection procedures for a specific collection.
+     * Creates standard CRUD procedures using the configured storage.
+     *
+     * @param collectionName - Collection name
+     */
+    registerCollectionProcedures(collectionName) {
+        // Uses a top-level import; require() is not available in this ESM package and
+        // previously threw "Cannot find module" on every call. See BUGS-2026-07 H13.
+        const procedures = createCollectionProcedures(collectionName);
+        // Register with the procedure registry first
+        this.procedureRegistry.registerAll(procedures);
+        // Then register as server handlers
+        this.registerProcedures(procedures);
+    }
+    // ===========================================================================
+    // Utility Methods
+    // ===========================================================================
+    /** The paths that the server serves now. */
+    servedKeys() {
+        const keys = new Set(this.pinnedProcedures.keys());
+        if (this.servesRegistry) {
+            for (const procedure of this.procedureRegistry.getAll()) {
+                if (procedure.handler && (!this.expose || this.expose(procedure.path))) {
+                    keys.add(pathToKey(procedure.path));
+                }
+            }
+        }
+        return keys;
+    }
+    /**
+     * Get count of the procedures that the server serves now.
+     */
+    get procedureCount() {
+        return this.servedKeys().size;
+    }
+    /**
+     * Check if the server serves a procedure now.
+     *
+     * @param path - Procedure path
+     */
+    /**
+     * The registry that this server serves. A face of the server (the MCP transport) lists its
+     * tools from it: with an explicit registry (`createRegistry()`), the global registry is not the
+     * server's.
+     */
+    getRegistry() {
+        return this.procedureRegistry;
+    }
+    hasProcedure(path) {
+        return this.resolveProcedure(pathToMethod(path)) !== undefined;
+    }
+    /**
+     * Close all storage backends.
+     */
+    async closeStorages() {
+        const closePromises = Array.from(this.storages.values()).map((s) => s.close());
+        await Promise.all(closePromises);
+    }
+    /**
+     * Stop server and close storages.
+     */
+    async stop() {
+        await super.stop();
+        await this.closeStorages();
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create a procedure server with common configuration.
+ *
+ * @param options - Server options
+ * @returns Configured ProcedureServer
+ */
+export function createProcedureServer(options = {}) {
+    return new ProcedureServer(options);
+}
+//# sourceMappingURL=procedure-server.js.map

package/dist/server/procedure-server.js.map

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

package/dist/server/server.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Universal Server
+ *
+ * Protocol-agnostic RPC server.
+ * Registers handlers and processes requests in unified format.
+ */
+import type { Method, ServerRequest, ServerResponse, ServerHandler, ServerMiddleware, ServerTransport } from "./types.js";
+/**
+ * Server configuration options.
+ */
+export interface ServerOptions {
+    /**
+     * Server transports (HTTP, WebSocket, etc.)
+     * Can run multiple transports simultaneously.
+     */
+    transports?: ServerTransport[];
+    /**
+     * Global error handler.
+     * Called when a handler throws an error.
+     */
+    onError?: (error: Error, request: ServerRequest) => void;
+    /**
+     * Request logger.
+     */
+    onRequest?: (request: ServerRequest) => void;
+    /**
+     * Response logger.
+     */
+    onResponse?: (response: ServerResponse) => void;
+}
+/**
+ * Method matcher for handler registration.
+ * Can match exact methods or patterns.
+ */
+interface MethodMatcher {
+    service: string | RegExp;
+    operation: string | RegExp;
+    version?: string | RegExp;
+}
+/**
+ * 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 declare class Server {
+    private handlers;
+    private middleware;
+    private transports;
+    private options;
+    constructor(options?: ServerOptions);
+    /**
+     * 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: Method | MethodMatcher, handler: ServerHandler): void;
+    /**
+     * Add middleware to the server.
+     * Middleware is applied in the order it's registered.
+     *
+     * @param middleware - Middleware function
+     */
+    use(middleware: ServerMiddleware): void;
+    /**
+     * Add a transport to the server.
+     *
+     * @param transport - Server transport adapter
+     */
+    addTransport(transport: ServerTransport): void;
+    /**
+     * Get all registered transports.
+     *
+     * @returns Array of server transports
+     */
+    getTransports(): ServerTransport[];
+    /**
+     * Start all server transports.
+     * Begins listening for incoming requests.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop all server transports.
+     * Gracefully shuts down connections.
+     */
+    stop(): Promise<void>;
+    /**
+     * 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
+     */
+    handle<TReq, TRes>(request: ServerRequest<TReq>): Promise<ServerResponse<TRes>>;
+    /**
+     * Find handler for a method. A subclass can add handlers that it finds at request time
+     * (`ProcedureServer` looks up its registry).
+     */
+    protected findHandler(method: Method): ServerHandler | null;
+    /**
+     * Check if a method matches a matcher.
+     */
+    private matchesMethod;
+    /**
+     * Normalize method matcher.
+     */
+    private normalizeMethodMatcher;
+    /**
+     * Convert error to response.
+     */
+    private errorToResponse;
+}
+export {};
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,EAGhB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAE7C;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACjD;AAED;;;GAGG;AACH,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,OAAO,CAAgB;IAE/B,YAAY,OAAO,GAAE,aAAkB,EAGtC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,GAAG,aAAa,EAC/B,OAAO,EAAE,aAAa,GACrB,IAAI,CAKN;IAED;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAEtC;IAED;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAE7C;IAED;;;;OAIG;IACH,aAAa,IAAI,eAAe,EAAE,CAEjC;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAED;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,EACrB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,GAC3B,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CA4C/B;IAED;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAO1D;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,eAAe;CAyCxB"}