zudoku 0.82.5 → 0.83.0

package/dist/declarations/app/main.d.ts

@@ -15,14 +15,12 @@ export declare const getRoutesByOptions: (options: ZudokuContextOptions, enableS
     middleware?: import("react-router").MiddlewareFunction[];
     loader?: import("react-router").LoaderFunction | boolean;
     action?: import("react-router").ActionFunction | boolean;
-    hasErrorBoundary?: boolean;
     shouldRevalidate?: import("react-router").ShouldRevalidateFunction;
     handle?: any;
     lazy?: {
         middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
-        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
-        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
-        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<Readonly<import("react-router").RouterContextProvider>> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<Readonly<import("react-router").RouterContextProvider>> | null | undefined>) | undefined;
         shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
         handle?: (() => Promise<any>) | undefined;
         Component?: (() => Promise<import("react").ComponentType<{}> | null | undefined>) | undefined;
@@ -32,11 +30,11 @@ export declare const getRoutesByOptions: (options: ZudokuContextOptions, enableS
         HydrateFallback?: (() => Promise<import("react").ComponentType<{}> | null | undefined>) | undefined;
         hydrateFallbackElement?: (() => Promise<import("react").ReactNode>) | undefined;
     } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>;
-    Component?: React.ComponentType | null;
-    element?: React.ReactNode | null;
-    ErrorBoundary?: React.ComponentType | null;
-    HydrateFallback?: React.ComponentType | null;
-    hydrateFallbackElement?: React.ReactNode | null;
+    Component?: import("react").ComponentType | null;
+    element?: import("react").ReactNode | null;
+    ErrorBoundary?: import("react").ComponentType | null;
+    HydrateFallback?: import("react").ComponentType | null;
+    hydrateFallbackElement?: import("react").ReactNode | null;
     children?: undefined;
     index: true;
 } | {
@@ -47,14 +45,12 @@ export declare const getRoutesByOptions: (options: ZudokuContextOptions, enableS
     middleware?: import("react-router").MiddlewareFunction[];
     loader?: import("react-router").LoaderFunction | boolean;
     action?: import("react-router").ActionFunction | boolean;
-    hasErrorBoundary?: boolean;
     shouldRevalidate?: import("react-router").ShouldRevalidateFunction;
     handle?: any;
     lazy?: {
         middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
-        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
-        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
-        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<Readonly<import("react-router").RouterContextProvider>> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<Readonly<import("react-router").RouterContextProvider>> | null | undefined>) | undefined;
         shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
         handle?: (() => Promise<any>) | undefined;
         Component?: (() => Promise<import("react").ComponentType<{}> | null | undefined>) | undefined;
@@ -64,11 +60,11 @@ export declare const getRoutesByOptions: (options: ZudokuContextOptions, enableS
         HydrateFallback?: (() => Promise<import("react").ComponentType<{}> | null | undefined>) | undefined;
         hydrateFallbackElement?: (() => Promise<import("react").ReactNode>) | undefined;
     } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>;
-    Component?: React.ComponentType | null;
-    element?: React.ReactNode | null;
-    ErrorBoundary?: React.ComponentType | null;
-    HydrateFallback?: React.ComponentType | null;
-    hydrateFallbackElement?: React.ReactNode | null;
+    Component?: import("react").ComponentType | null;
+    element?: import("react").ReactNode | null;
+    ErrorBoundary?: import("react").ComponentType | null;
+    HydrateFallback?: import("react").ComponentType | null;
+    hydrateFallbackElement?: import("react").ReactNode | null;
     children?: RouteObject[];
     index?: false;
 })[];

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "zudoku",
-  "version": "0.82.5",
+  "version": "0.83.0",
   "type": "module",
   "engines": {
-    "node": ">=20.19.0 <21.0.0 || >=22.12.0"
+    "node": ">=22.22.0"
   },
   "sideEffects": [
     "**/*.css",
@@ -223,10 +223,9 @@
     "@tanstack/react-query": "5.101.4",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
+    "@unhead/react": "3.2.3",
     "@vitejs/plugin-react": "6.0.4",
     "@x0k/json-schema-merge": "1.0.4",
-    "@unhead/react": "3.2.3",
-    "@zuplo/mcp": "0.0.32",
     "bs58": "6.0.0",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
@@ -271,7 +270,7 @@
     "react-hook-form": "7.83.0",
     "react-is": "19.2.8",
     "react-markdown": "10.1.0",
-    "react-router": "7.18.1",
+    "react-router": "8.3.0",
     "rehype-mdx-import-media": "1.4.0",
     "rehype-raw": "7.0.0",
     "rehype-slug": "6.0.0",
@@ -308,7 +307,7 @@
     "@types/estree": "1.0.9",
     "@types/glob-parent": "5.1.3",
     "@types/har-format": "^1.2.16",
-    "@types/hast": "3.0.4",
+    "@types/hast": "3.0.5",
     "@types/json-schema": "7.0.15",
     "@types/mdast": "4.0.4",
     "@types/mdx": "2.0.14",
@@ -332,8 +331,8 @@
     "@supabase/supabase-js": "^2.49.4",
     "firebase": "^12.6.0",
     "mermaid": "^11.0.0",
-    "react": ">=19.2.0",
-    "react-dom": ">=19.2.0"
+    "react": ">=19.2.7",
+    "react-dom": ">=19.2.7"
   },
   "peerDependenciesMeta": {
     "@azure/msal-browser": {

package/src/zuplo/enrich-with-zuplo-mcp.ts

@@ -1,13 +1,5 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import type {
-  ExtensionMcpServer,
-  ExtensionMcpServerTool,
-} from "@zuplo/mcp/openapi/types";
-import {
-  DEFAULT_MCP_SERVER_NAME,
-  DEFAULT_MCP_SERVER_VERSION,
-} from "@zuplo/mcp/server";
 import type { OpenAPIV3_1 } from "openapi-types";
 import type { ProcessorArg } from "../config/validators/BuildSchema.js";
 import { traverse, traverseAsync } from "../lib/util/traverse.js";
@@ -18,6 +10,37 @@ const MCP_TAG_NAME = "MCP";
 const MCP_TAG_DESCRIPTION =
   "Model Context Protocol (MCP) server endpoints for AI tool integration";
 
+// What the Zuplo MCP runtime advertises when the handler leaves `name` and
+// `version` unset. Mirrored here so the documented server identity matches what
+// MCP clients see during initialization.
+const DEFAULT_MCP_SERVER_NAME = "MCP Server";
+const DEFAULT_MCP_SERVER_VERSION = "0.0.0";
+
+// `x-mcp-server` is an OpenAPI extension rather than an MCP protocol message,
+// so its shape is described here instead of being pulled from an MCP SDK.
+// `name` and `version` mirror the spec's `Implementation`: they are what
+// clients read back during initialization. `security` and `securitySchemes`
+// carry the auth requirements of the operations the server exposes, so install
+// snippets can show the right credentials.
+type ExtensionMcpServer = {
+  name: string;
+  version: string;
+  tools?: ExtensionMcpServerTool[];
+  security?: OpenAPIV3_1.SecurityRequirementObject[];
+  securitySchemes?: Record<string, OpenAPIV3_1.SecuritySchemeObject>;
+};
+
+// Tool metadata for an `x-mcp-server` tool list. Deviates from the spec's
+// `Tool` in two places: `description` is required because the extractor always
+// resolves one, and `inputSchema` is loose because Zudoku documents only the
+// request body rather than the full JSON Schema object the spec expects — see
+// the TODO in extractOperationSchema.
+type ExtensionMcpServerTool = {
+  name: string;
+  description: string;
+  inputSchema?: object;
+};
+
 // Reads a non-empty string from an untyped handler option, returning undefined
 // for missing, blank, or non-string values so callers can fall back to a
 // default.
@@ -243,16 +266,15 @@ export const enrichWithZuploMcpServerData = ({
         mcpExtension.tools = allTools;
       }
 
-      node["x-mcp-server"] = mcpExtension;
-
       // Add security from referenced operations to x-mcp-server
       const dedupedSecurity = deduplicateSecurity(allSecurity);
       if (dedupedSecurity.length > 0) {
-        const ext = node["x-mcp-server"] as RecordAny;
-        ext.security = dedupedSecurity;
-        ext.securitySchemes = { ...securitySchemes };
+        mcpExtension.security = dedupedSecurity;
+        mcpExtension.securitySchemes = { ...securitySchemes };
       }
 
+      node["x-mcp-server"] = mcpExtension;
+
       // Assign default MCP tag if the operation has no tags
       if (!operation.tags || operation.tags.length === 0) {
         assignedDefaultMcpTag = true;