@procedures/client 0.0.0-stage → 0.2.0

package/dist/server/procedure-server.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Procedure Server
+ *
+ * Server implementation with procedure auto-registration and repository pattern.
+ * Integrates with ProcedureRegistry and CollectionStorage backends.
+ */
+import { Server, type ServerOptions } from "./server.js";
+import type { Method, ServerHandler, ServerRequest, ServerResponse } from "./types.js";
+import type { AnyProcedure, ProcedurePath, RepositoryProvider, ProcedureModule } from "../procedures/types.js";
+import { ProcedureRegistry } from "../procedures/registry.js";
+import { type Interceptor, type Invocation } from "../procedures/invoke.js";
+import type { Capability, ClearanceOrder, ResourcesOf } from "../procedures/types.js";
+import type { CollectionStorage } from "../procedures/collection/storage.js";
+/**
+ * Storage configuration for a collection.
+ */
+export interface StorageConfig<T = unknown> {
+    /** Storage backend instance */
+    storage: CollectionStorage<T>;
+    /** Collection name (for mapping) */
+    name: string;
+}
+/**
+ * Options for ProcedureServer.
+ */
+export interface ProcedureServerOptions extends ServerOptions {
+    /** Procedure registry to use (defaults to global) */
+    registry?: ProcedureRegistry;
+    /** Whether to auto-register all procedures from registry */
+    autoRegister?: boolean;
+    /** Collections to configure with storage backends */
+    collections?: Record<string, CollectionStorage<unknown>>;
+    /**
+     * The procedures that the callers of this server can reach. `registerFromRegistry()` registers
+     * only these procedures. A data-driven procedure (control flow, `eval`, a procedure that
+     * `procedure.define` made) can call only these procedures too, because its caller chooses
+     * what it calls. A procedure of code calls the procedures of its `metadata.calls`
+     * (`docker.run` declares `shell.run`) and the exposed ones. Without this rule, the server
+     * exposes every procedure. See `procedures/policy.ts` (deep dive MCP-3).
+     */
+    expose?: ((path: ProcedurePath) => boolean) | undefined;
+    /**
+     * True: a procedure of code without `metadata.calls` can call only the exposed procedures.
+     * A server for an outside caller (the MCP server of the dev tools) sets it.
+     */
+    strictCalls?: boolean | undefined;
+    /**
+     * The interceptors of each request and its nested calls, the outermost first: policy,
+     * tracing, timeouts, metrics (see `procedures/interceptors.ts`).
+     */
+    interceptors?: readonly Interceptor[] | undefined;
+    /**
+     * The capability of each request (CAPABILITIES-2026-10): one value, or a function of the
+     * request. The function reads only what the transport authenticated. Without it: no limits.
+     */
+    capability?: Capability | ((request: ServerRequest<unknown>) => Capability | undefined) | undefined;
+    /** The order of the clearance values. */
+    clearanceOrder?: ClearanceOrder | undefined;
+    /** The resources of each invocation for its capability (`ctx.resources`). */
+    resources?: ((invocation: Invocation) => ResourcesOf) | undefined;
+    /** The filter of the output that leaves the server. */
+    admitItem?: ((item: unknown, invocation: Invocation) => boolean) | undefined;
+}
+/**
+ * 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 declare function errorResponse(id: string, error: unknown): ServerResponse<unknown>;
+/**
+ * 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 declare class ProcedureServer extends Server implements RepositoryProvider {
+    private readonly procedureRegistry;
+    private readonly storages;
+    /** The procedures that `registerProcedure` pinned, by key */
+    private readonly pinnedProcedures;
+    /**
+     * 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.
+     */
+    private servesRegistry;
+    private readonly expose;
+    private readonly strictCalls;
+    private readonly interceptors;
+    /** The capability options of the requests (CAPABILITIES-2026-10). */
+    private readonly capabilityOptions;
+    constructor(options?: ProcedureServerOptions);
+    /**
+     * Get storage for a collection.
+     *
+     * @param collection - Collection name
+     * @returns Storage instance
+     * @throws Error if collection not configured
+     */
+    getStorage<T>(collection: string): CollectionStorage<T>;
+    /**
+     * Check if a collection is configured.
+     *
+     * @param collection - Collection name
+     */
+    hasCollection(collection: string): boolean;
+    /**
+     * Configure storage for a collection.
+     *
+     * @param name - Collection name
+     * @param storage - Storage backend
+     * @returns this (for chaining)
+     */
+    useStorage<T>(name: string, storage: CollectionStorage<T>): this;
+    /**
+     * Configure multiple storages at once.
+     *
+     * @param storages - Map of collection names to storage backends
+     * @returns this (for chaining)
+     */
+    useStorages(storages: Record<string, CollectionStorage<unknown>>): this;
+    /**
+     * Get all configured collection names.
+     */
+    getCollectionNames(): string[];
+    /**
+     * 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: AnyProcedure): void;
+    /**
+     * Register multiple procedures.
+     *
+     * @param procedures - Array of procedures
+     */
+    registerProcedures(procedures: AnyProcedure[]): void;
+    /**
+     * Register a procedure module.
+     *
+     * @param module - Module with procedures array
+     */
+    registerModule(module: ProcedureModule): void;
+    /**
+     * 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(): void;
+    /**
+     * The procedure that answers a method, or undefined. The registry comes first (when the server
+     * serves it), then the pinned procedures.
+     */
+    private resolveProcedure;
+    /**
+     * The handlers that `register()` added come first (exact or pattern matches). Then the server
+     * looks up the procedure of the method.
+     */
+    protected findHandler(method: Method): ServerHandler | null;
+    /** Run a procedure for a request. */
+    private invoke;
+    /**
+     * Register collection procedures for a specific collection.
+     * Creates standard CRUD procedures using the configured storage.
+     *
+     * @param collectionName - Collection name
+     */
+    registerCollectionProcedures(collectionName: string): void;
+    /** The paths that the server serves now. */
+    private servedKeys;
+    /**
+     * Get count of the procedures that the server serves now.
+     */
+    get procedureCount(): number;
+    /**
+     * 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(): ProcedureRegistry;
+    hasProcedure(path: ProcedurePath): boolean;
+    /**
+     * Close all storage backends.
+     */
+    closeStorages(): Promise<void>;
+    /**
+     * Stop server and close storages.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Create a procedure server with common configuration.
+ *
+ * @param options - Server options
+ * @returns Configured ProcedureServer
+ */
+export declare function createProcedureServer(options?: ProcedureServerOptions): ProcedureServer;
+//# sourceMappingURL=procedure-server.d.ts.map

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

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

package/dist/server/procedure-server.js

@@ -0,0 +1,348 @@
+/**
+ * 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";
+import { TIMEOUT_METADATA_KEY, narrowCapability } from "../procedures/capability.js";
+/** The capability of a request with the remaining time of its caller, when it sends one. */
+function withRequestTimeout(capability, request, order) {
+    const timeoutMs = request.metadata[TIMEOUT_METADATA_KEY];
+    if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs < 0)
+        return capability;
+    return narrowCapability(capability, { timeoutMs }, order);
+}
+/**
+ * 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;
+    // A refusal of the capability says why (CAPABILITIES-2026-10)
+    const reason = error instanceof InvocationError ? error.reason : undefined;
+    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: reason ? { reason } : {},
+    };
+}
+// =============================================================================
+// 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;
+    /** The capability options of the requests (CAPABILITIES-2026-10). */
+    capabilityOptions;
+    constructor(options = {}) {
+        super(options);
+        this.procedureRegistry = options.registry ?? PROCEDURE_REGISTRY;
+        this.expose = options.expose;
+        this.strictCalls = options.strictCalls ?? false;
+        this.interceptors = options.interceptors ?? [];
+        this.capabilityOptions = {
+            capability: options.capability,
+            clearanceOrder: options.clearanceOrder,
+            resources: options.resources,
+            admitItem: options.admitItem,
+        };
+        // 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 { capability, clearanceOrder, resources, admitItem } = this.capabilityOptions;
+            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,
+                // The capability comes from the server, never from the request. The remaining time of
+                // the caller can only make the deadline earlier (CAPABILITIES-2026-10, decision 9).
+                capability: withRequestTimeout(typeof capability === "function" ? capability(request) : capability, request, clearanceOrder),
+                clearanceOrder,
+                resources,
+                admitItem,
+            });
+            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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"}