@lantos1618/better-ui 0.9.0 → 0.9.1

package/dist/openapi/index.d.mts

@@ -1,30 +1,8 @@
-import { T as Tool } from '../tool-yZTixiN2.mjs';
+import { T as Tool, g as ToolContext } from '../tool-yZTixiN2.mjs';
 import { J as JsonSchema } from '../schema-DdZf6066.mjs';
 import 'zod';
 import 'react';
 
-/**
- * OpenAPI 3.1 spec generator for Better UI tools.
- *
- * Converts a tool registry into a valid OpenAPI document.
- * Each tool becomes a POST endpoint at `/api/tools/{toolName}`.
- *
- * @example
- * ```typescript
- * import { generateOpenAPISpec } from '@lantos1618/better-ui/openapi';
- * import { tools } from './tools';
- *
- * const spec = generateOpenAPISpec({
- *   title: 'My AI Tools API',
- *   version: '1.0.0',
- *   tools,
- * });
- *
- * // Serve as JSON
- * app.get('/openapi.json', (req, res) => res.json(spec));
- * ```
- */
-
 interface OpenAPISpecConfig {
     /** API title */
     title: string;
@@ -109,5 +87,36 @@ declare function generateOpenAPISpec(config: OpenAPISpecConfig): OpenAPISpec;
  * ```
  */
 declare function openAPIHandler(config: OpenAPISpecConfig): (req: Request) => Response;
+interface ToolRouterConfig {
+    /** Tool registry */
+    tools: Record<string, Tool>;
+    /** Base path prefix (default: '/api/tools') */
+    basePath?: string;
+    /** Optional context passed to every tool execution */
+    context?: Partial<ToolContext>;
+    /** Called before tool execution — throw to reject */
+    onBeforeExecute?: (toolName: string, input: unknown, req: Request) => Promise<void> | void;
+}
+/**
+ * Create a request handler that routes to individual tool endpoints.
+ * Each tool is callable at `POST {basePath}/{toolName}`.
+ *
+ * Also serves the OpenAPI spec at `GET {basePath}` and a Swagger UI at `GET {basePath}/docs`.
+ *
+ * @example
+ * ```typescript
+ * // Next.js catch-all: app/api/tools/[...path]/route.ts
+ * import { toolRouter } from '@lantos1618/better-ui/openapi';
+ * const router = toolRouter({ tools });
+ * export const GET = router;
+ * export const POST = router;
+ *
+ * // Now callable:
+ * // POST /api/tools/weather  { "city": "Tokyo" }  -> { "result": { "temp": 22, ... } }
+ * // GET  /api/tools           -> OpenAPI JSON spec
+ * // GET  /api/tools/docs      -> Swagger UI
+ * ```
+ */
+declare function toolRouter(config: ToolRouterConfig): (req: Request) => Promise<Response>;
 
-export { type OpenAPISpec, type OpenAPISpecConfig, generateOpenAPISpec, openAPIHandler };
+export { type OpenAPISpec, type OpenAPISpecConfig, type ToolRouterConfig, generateOpenAPISpec, openAPIHandler, toolRouter };

package/dist/openapi/index.d.ts

@@ -1,30 +1,8 @@
-import { T as Tool } from '../tool-yZTixiN2.js';
+import { T as Tool, g as ToolContext } from '../tool-yZTixiN2.js';
 import { J as JsonSchema } from '../schema-DdZf6066.js';
 import 'zod';
 import 'react';
 
-/**
- * OpenAPI 3.1 spec generator for Better UI tools.
- *
- * Converts a tool registry into a valid OpenAPI document.
- * Each tool becomes a POST endpoint at `/api/tools/{toolName}`.
- *
- * @example
- * ```typescript
- * import { generateOpenAPISpec } from '@lantos1618/better-ui/openapi';
- * import { tools } from './tools';
- *
- * const spec = generateOpenAPISpec({
- *   title: 'My AI Tools API',
- *   version: '1.0.0',
- *   tools,
- * });
- *
- * // Serve as JSON
- * app.get('/openapi.json', (req, res) => res.json(spec));
- * ```
- */
-
 interface OpenAPISpecConfig {
     /** API title */
     title: string;
@@ -109,5 +87,36 @@ declare function generateOpenAPISpec(config: OpenAPISpecConfig): OpenAPISpec;
  * ```
  */
 declare function openAPIHandler(config: OpenAPISpecConfig): (req: Request) => Response;
+interface ToolRouterConfig {
+    /** Tool registry */
+    tools: Record<string, Tool>;
+    /** Base path prefix (default: '/api/tools') */
+    basePath?: string;
+    /** Optional context passed to every tool execution */
+    context?: Partial<ToolContext>;
+    /** Called before tool execution — throw to reject */
+    onBeforeExecute?: (toolName: string, input: unknown, req: Request) => Promise<void> | void;
+}
+/**
+ * Create a request handler that routes to individual tool endpoints.
+ * Each tool is callable at `POST {basePath}/{toolName}`.
+ *
+ * Also serves the OpenAPI spec at `GET {basePath}` and a Swagger UI at `GET {basePath}/docs`.
+ *
+ * @example
+ * ```typescript
+ * // Next.js catch-all: app/api/tools/[...path]/route.ts
+ * import { toolRouter } from '@lantos1618/better-ui/openapi';
+ * const router = toolRouter({ tools });
+ * export const GET = router;
+ * export const POST = router;
+ *
+ * // Now callable:
+ * // POST /api/tools/weather  { "city": "Tokyo" }  -> { "result": { "temp": 22, ... } }
+ * // GET  /api/tools           -> OpenAPI JSON spec
+ * // GET  /api/tools/docs      -> Swagger UI
+ * ```
+ */
+declare function toolRouter(config: ToolRouterConfig): (req: Request) => Promise<Response>;
 
-export { type OpenAPISpec, type OpenAPISpecConfig, generateOpenAPISpec, openAPIHandler };
+export { type OpenAPISpec, type OpenAPISpecConfig, type ToolRouterConfig, generateOpenAPISpec, openAPIHandler, toolRouter };

package/dist/openapi/index.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var openapi_exports = {};
 __export(openapi_exports, {
   generateOpenAPISpec: () => generateOpenAPISpec,
-  openAPIHandler: () => openAPIHandler
+  openAPIHandler: () => openAPIHandler,
+  toolRouter: () => toolRouter
 });
 module.exports = __toCommonJS(openapi_exports);
 
@@ -253,8 +254,86 @@ function openAPIHandler(config) {
     }
   });
 }
+function toolRouter(config) {
+  const basePath = config.basePath ?? "/api/tools";
+  return async (req) => {
+    const url = new URL(req.url);
+    const path = url.pathname;
+    if (req.method === "OPTIONS") {
+      return new Response(null, {
+        headers: {
+          "Access-Control-Allow-Origin": "*",
+          "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+          "Access-Control-Allow-Headers": "Content-Type, Authorization"
+        }
+      });
+    }
+    if (req.method === "GET" && (path === basePath || path === basePath + "/")) {
+      const spec = generateOpenAPISpec({
+        title: "Tool API",
+        version: "1.0.0",
+        tools: config.tools,
+        basePath,
+        serverUrl: url.origin
+      });
+      return new Response(JSON.stringify(spec, null, 2), {
+        headers: { "Content-Type": "application/json", "Access-Control-Allow-Origin": "*" }
+      });
+    }
+    if (req.method === "GET" && (path === basePath + "/docs" || path === basePath + "/docs/")) {
+      const html = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>API Docs</title>
+<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
+</head><body><div id="swagger-ui"></div>
+<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
+<script>SwaggerUIBundle({url:'${basePath}',dom_id:'#swagger-ui',deepLinking:true});</script>
+</body></html>`;
+      return new Response(html, {
+        headers: { "Content-Type": "text/html", "Access-Control-Allow-Origin": "*" }
+      });
+    }
+    if (req.method === "POST" && path.startsWith(basePath + "/")) {
+      const toolName = path.slice(basePath.length + 1).replace(/\/$/, "");
+      if (!toolName) {
+        return Response.json({ error: "Missing tool name" }, { status: 400 });
+      }
+      if (!Object.prototype.hasOwnProperty.call(config.tools, toolName)) {
+        return Response.json({ error: "Tool not found" }, { status: 404 });
+      }
+      const tool = config.tools[toolName];
+      let input;
+      try {
+        input = await req.json();
+      } catch {
+        return Response.json({ error: "Invalid JSON body" }, { status: 400 });
+      }
+      try {
+        if (config.onBeforeExecute) {
+          await config.onBeforeExecute(toolName, input, req);
+        }
+        const result = await tool.run(input, {
+          isServer: true,
+          headers: req.headers,
+          ...config.context
+        });
+        return Response.json({ result }, {
+          headers: { "Access-Control-Allow-Origin": "*" }
+        });
+      } catch (error) {
+        if (error instanceof Error && error.name === "ZodError") {
+          return Response.json({ error: error.message }, { status: 400 });
+        }
+        return Response.json(
+          { error: error instanceof Error ? error.message : "Tool execution failed" },
+          { status: 500 }
+        );
+      }
+    }
+    return Response.json({ error: "Not found" }, { status: 404 });
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   generateOpenAPISpec,
-  openAPIHandler
+  openAPIHandler,
+  toolRouter
 });

package/dist/openapi/index.mjs

@@ -91,7 +91,85 @@ function openAPIHandler(config) {
     }
   });
 }
+function toolRouter(config) {
+  const basePath = config.basePath ?? "/api/tools";
+  return async (req) => {
+    const url = new URL(req.url);
+    const path = url.pathname;
+    if (req.method === "OPTIONS") {
+      return new Response(null, {
+        headers: {
+          "Access-Control-Allow-Origin": "*",
+          "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+          "Access-Control-Allow-Headers": "Content-Type, Authorization"
+        }
+      });
+    }
+    if (req.method === "GET" && (path === basePath || path === basePath + "/")) {
+      const spec = generateOpenAPISpec({
+        title: "Tool API",
+        version: "1.0.0",
+        tools: config.tools,
+        basePath,
+        serverUrl: url.origin
+      });
+      return new Response(JSON.stringify(spec, null, 2), {
+        headers: { "Content-Type": "application/json", "Access-Control-Allow-Origin": "*" }
+      });
+    }
+    if (req.method === "GET" && (path === basePath + "/docs" || path === basePath + "/docs/")) {
+      const html = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>API Docs</title>
+<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
+</head><body><div id="swagger-ui"></div>
+<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
+<script>SwaggerUIBundle({url:'${basePath}',dom_id:'#swagger-ui',deepLinking:true});</script>
+</body></html>`;
+      return new Response(html, {
+        headers: { "Content-Type": "text/html", "Access-Control-Allow-Origin": "*" }
+      });
+    }
+    if (req.method === "POST" && path.startsWith(basePath + "/")) {
+      const toolName = path.slice(basePath.length + 1).replace(/\/$/, "");
+      if (!toolName) {
+        return Response.json({ error: "Missing tool name" }, { status: 400 });
+      }
+      if (!Object.prototype.hasOwnProperty.call(config.tools, toolName)) {
+        return Response.json({ error: "Tool not found" }, { status: 404 });
+      }
+      const tool = config.tools[toolName];
+      let input;
+      try {
+        input = await req.json();
+      } catch {
+        return Response.json({ error: "Invalid JSON body" }, { status: 400 });
+      }
+      try {
+        if (config.onBeforeExecute) {
+          await config.onBeforeExecute(toolName, input, req);
+        }
+        const result = await tool.run(input, {
+          isServer: true,
+          headers: req.headers,
+          ...config.context
+        });
+        return Response.json({ result }, {
+          headers: { "Access-Control-Allow-Origin": "*" }
+        });
+      } catch (error) {
+        if (error instanceof Error && error.name === "ZodError") {
+          return Response.json({ error: error.message }, { status: 400 });
+        }
+        return Response.json(
+          { error: error instanceof Error ? error.message : "Tool execution failed" },
+          { status: 500 }
+        );
+      }
+    }
+    return Response.json({ error: "Not found" }, { status: 404 });
+  };
+}
 export {
   generateOpenAPISpec,
-  openAPIHandler
+  openAPIHandler,
+  toolRouter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lantos1618/better-ui",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "A minimal, type-safe AI-first UI framework for building tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",