@procedures/client 0.8.1 → 0.9.1

package/src/server/types.ts

@@ -9,6 +9,7 @@ import type { Elicit } from "../procedures/elicit.js";
 import type { ReportProgress } from "../procedures/progress.js";
 import type { Metadata, Status, Method } from "../client/types.js";
 import type { CapabilityRequest } from "../procedures/types.js";
+import { methodName } from "./method.js";
 
 // Re-export Method from client types
 export type { Method };
@@ -120,6 +121,23 @@ export interface Principal {
   readonly claims?: Readonly<Record<string, unknown>> | undefined;
 }
 
+/** A report of the server for debug (the option `debug` of `ProcedureServer`). */
+export interface ServerDebugReport {
+  /**
+   * The subject of the report. `"narrowing"`: a part of the narrowing key of a call has no effect
+   * (CLI-30). A later version can add subjects.
+   */
+  readonly topic: string;
+  /** The id of the request. */
+  readonly requestId: string;
+  /** The method of the request. */
+  readonly method: Method;
+  /** What occurred, as a sentence. */
+  readonly message: string;
+  /** The facts of the report. For `"narrowing"`: the `field`, the `kind` and the `code` of its note (`NarrowingNote`). */
+  readonly detail?: Readonly<Record<string, unknown>> | undefined;
+}
+
 /**
  * The contract of a server transport (roadmap R18): a transport turns each protocol request
  * into a `ServerRequest` (with its signal and its credentials), gives it to `handle()`, and turns
@@ -238,7 +256,7 @@ export interface ServerTransport {
 export class HandlerNotFoundError extends Error {
   constructor(method: Method) {
     super(
-      `No handler found for ${method.service}.${method.operation}${
+      `No handler found for ${methodName(method)}${
         method.version ? ` (v${method.version})` : ""
       }`
     );