ci: add TypeDoc validation to check:all with treatWarningsAsErrors (#1522)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jonathanhefner

package.json

@@ -32,7 +32,7 @@
         "prepack:all": "pnpm -r prepack",
         "lint:all": "pnpm sync:snippets --check && pnpm -r lint",
         "lint:fix:all": "pnpm sync:snippets && pnpm -r lint:fix",
-        "check:all": "pnpm -r typecheck && pnpm -r lint",
+        "check:all": "pnpm -r typecheck && pnpm -r lint && pnpm run docs:check",
         "test:all": "pnpm -r test",
         "test:conformance:client": "pnpm --filter @modelcontextprotocol/test-conformance run test:conformance:client",
         "test:conformance:client:all": "pnpm --filter @modelcontextprotocol/test-conformance run test:conformance:client:all",

packages/client/package.json

@@ -55,7 +55,7 @@
         "prepack": "npm run build",
         "lint": "eslint src/ && prettier --ignore-path ../../.prettierignore --check .",
         "lint:fix": "eslint src/ --fix && prettier --ignore-path ../../.prettierignore --write .",
-        "check": "npm run typecheck && npm run lint && pnpm exec -- typedoc --emit none",
+        "check": "npm run typecheck && npm run lint",
         "test": "vitest run",
         "test:watch": "vitest",
         "start": "npm run server",

packages/client/src/client/auth.ts

@@ -193,7 +193,7 @@ export class UnauthorizedError extends Error {
     }
 }
 
-type ClientAuthMethod = 'client_secret_basic' | 'client_secret_post' | 'none';
+export type ClientAuthMethod = 'client_secret_basic' | 'client_secret_post' | 'none';
 
 function isClientAuthMethod(method: string): method is ClientAuthMethod {
     return ['client_secret_basic', 'client_secret_post', 'none'].includes(method);

packages/client/src/experimental/tasks/client.ts

@@ -82,7 +82,6 @@ export class ExperimentalClientTasks {
      * ```
      *
      * @param params - Tool call parameters (name and arguments)
-     * @param resultSchema - Zod schema for validating the result (defaults to {@linkcode CallToolResultSchema})
      * @param options - Optional request options (timeout, signal, task creation params, etc.)
      * @returns AsyncGenerator that yields {@linkcode ResponseMessage} objects
      *

packages/server/package.json

@@ -55,7 +55,7 @@
         "prepack": "npm run build",
         "lint": "eslint src/ && prettier --ignore-path ../../.prettierignore --check .",
         "lint:fix": "eslint src/ --fix && prettier --ignore-path ../../.prettierignore --write .",
-        "check": "npm run typecheck && npm run lint && pnpm exec -- typedoc --emit none",
+        "check": "npm run typecheck && npm run lint",
         "test": "vitest run",
         "test:watch": "vitest",
         "start": "npm run server",

packages/server/src/server/mcp.ts

@@ -1008,7 +1008,7 @@ export type RegisteredTool = {
     execution?: ToolExecution;
     _meta?: Record<string, unknown>;
     handler: AnyToolHandler<AnySchema | undefined>;
-    /** @internal */
+    /** @hidden */
     executor: ToolExecutor;
     enabled: boolean;
     enable(): void;
@@ -1147,7 +1147,7 @@ export type RegisteredPrompt = {
     title?: string;
     description?: string;
     argsSchema?: AnySchema;
-    /** @internal */
+    /** @hidden */
     handler: PromptHandler;
     enabled: boolean;
     enable(): void;

typedoc.config.mjs

@@ -39,5 +39,6 @@ export default {
     headings: {
         readme: false
     },
+    treatWarningsAsErrors: true,
     out: 'tmp/docs/',
 };