vitek-plugin 0.2.1-beta → 0.2.2-beta

package/dist/mcp-docs-server/resources/introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/introspection.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,eAAO,MAAM,qBAAqB,q7BAsBjC,CAAC"}

package/dist/mcp-docs-server/resources/introspection.js

@@ -0,0 +1,24 @@
+export const INTROSPECTION_URI = 'vitek://docs/introspection';
+export const INTROSPECTION_CONTENT = `# Vitek – Introspection API
+
+Programmatic API to inspect routes, middlewares, and sockets. Manifest file generated at build.
+
+## Functions (from vitek-plugin)
+
+- \`getManifest(root, apiDir)\` – { routes, middlewares, sockets }
+- \`getRoutes(root, apiDir)\` – ParsedRoute[] ({ method, pattern, params, file })
+- \`getSockets(root, apiDir)\` – ParsedSocket[] ({ pattern, params, file })
+- \`writeManifest(root, apiDir, outDir)\` – writes vitek-manifest.json
+
+## Manifest format (vitek-manifest.json)
+
+\`\`\`json
+{
+  "routes": [{ "method": "get", "pattern": "users/:id", "params": ["id"], "file": "src/api/users/[id].get.ts" }],
+  "middlewares": [{ "basePattern": "", "path": "src/api/middleware.ts" }],
+  "sockets": [{ "pattern": "chat", "params": [], "file": "src/api/chat.socket.ts" }]
+}
+\`\`\`
+
+Paths relative to project root. Use for CLIs, IDEs, CI/CD, or custom docs.
+`;

package/dist/mcp-docs-server/resources/middlewares.d.ts

@@ -0,0 +1,3 @@
+export declare const MIDDLEWARES_URI = "vitek://docs/middlewares";
+export declare const MIDDLEWARES_CONTENT = "# Vitek \u2013 Middlewares\n\nMiddlewares run before (and optionally after) route handlers. Applied hierarchically by folder.\n\n## Global middleware\n\n`src/api/middleware.ts` \u2013 applies to all routes. Export default array of `Middleware` (async (context, next) => ...). Call `await next()` to continue.\n\n```typescript\nimport type { Middleware } from \"vitek-plugin\";\n\nexport default [\n  async (context, next) => {\n    console.log(context.method, context.path);\n    await next();\n  },\n] satisfies Middleware[];\n```\n\nOptional `config.path`: array of patterns (e.g. `[\"protected/*\", \"admin\"]`) to limit global middleware to those paths. Use `*` suffix for prefix match.\n\n## Hierarchical middleware\n\n- `src/api/posts/middleware.ts` \u2013 applies to `/api/posts`, `/api/posts/:id`, etc.\n- `src/api/posts/[id]/middleware.ts` \u2013 applies to routes under `/api/posts/:id/` (e.g. `/api/posts/1/comments`).\n\nSame signature: `(context, next) => Promise<void>`, call `await next()`.\n\n## Order\n\n1. Global (`src/api/middleware.ts`)\n2. Folder (`src/api/posts/middleware.ts`)\n3. Nested (`src/api/posts/[id]/middleware.ts`)\n4. Route handler\n";
+//# sourceMappingURL=middlewares.d.ts.map

package/dist/mcp-docs-server/resources/middlewares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewares.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/middlewares.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D,eAAO,MAAM,mBAAmB,opCAkC/B,CAAC"}

package/dist/mcp-docs-server/resources/middlewares.js

@@ -0,0 +1,36 @@
+export const MIDDLEWARES_URI = 'vitek://docs/middlewares';
+export const MIDDLEWARES_CONTENT = `# Vitek – Middlewares
+
+Middlewares run before (and optionally after) route handlers. Applied hierarchically by folder.
+
+## Global middleware
+
+\`src/api/middleware.ts\` – applies to all routes. Export default array of \`Middleware\` (async (context, next) => ...). Call \`await next()\` to continue.
+
+\`\`\`typescript
+import type { Middleware } from "vitek-plugin";
+
+export default [
+  async (context, next) => {
+    console.log(context.method, context.path);
+    await next();
+  },
+] satisfies Middleware[];
+\`\`\`
+
+Optional \`config.path\`: array of patterns (e.g. \`["protected/*", "admin"]\`) to limit global middleware to those paths. Use \`*\` suffix for prefix match.
+
+## Hierarchical middleware
+
+- \`src/api/posts/middleware.ts\` – applies to \`/api/posts\`, \`/api/posts/:id\`, etc.
+- \`src/api/posts/[id]/middleware.ts\` – applies to routes under \`/api/posts/:id/\` (e.g. \`/api/posts/1/comments\`).
+
+Same signature: \`(context, next) => Promise<void>\`, call \`await next()\`.
+
+## Order
+
+1. Global (\`src/api/middleware.ts\`)
+2. Folder (\`src/api/posts/middleware.ts\`)
+3. Nested (\`src/api/posts/[id]/middleware.ts\`)
+4. Route handler
+`;

package/dist/mcp-docs-server/resources/plugin-api.d.ts

@@ -0,0 +1,3 @@
+export declare const PLUGIN_API_URI = "vitek://docs/plugin-api";
+export declare const PLUGIN_API_CONTENT = "# Vitek \u2013 Plugin API\n\nExternal plugins via `plugins` option. Type: `VitekPlugin`.\n\n## Hooks\n\n### afterTypesGenerated(ctx)\n\nCalled after types, services, and OpenAPI are generated. `ctx`: `root`, `schema` (RouteSchema[]), `sockets` (ParsedSocket[]), `apiBasePath`, `socketBasePath`. Use for codegen or integrations.\n\n### beforeApiRequest(ctx)\n\nCalled before each API request. `ctx`: `req`, `res`, `path`, `method`, `next()`. Call `next()` to continue; send response and omit `next()` to short-circuit (e.g. auth, rate limit).\n\n```typescript\nconst authPlugin: VitekPlugin = {\n  name: \"auth\",\n  async beforeApiRequest({ req, res, path, next }) {\n    if (path.startsWith(\"/admin/\") && !req.headers.authorization) {\n      res.statusCode = 401;\n      res.setHeader(\"Content-Type\", \"application/json\");\n      res.end(JSON.stringify({ error: \"Unauthorized\" }));\n      return;\n    }\n    next();\n  },\n};\n```\n\nImport types: `VitekPlugin`, `AfterTypesGeneratedContext`, `BeforeApiRequestContext` from \"vitek-plugin\".\n";
+//# sourceMappingURL=plugin-api.d.ts.map

package/dist/mcp-docs-server/resources/plugin-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-api.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/plugin-api.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD,eAAO,MAAM,kBAAkB,iiCA8B9B,CAAC"}

package/dist/mcp-docs-server/resources/plugin-api.js

@@ -0,0 +1,32 @@
+export const PLUGIN_API_URI = 'vitek://docs/plugin-api';
+export const PLUGIN_API_CONTENT = `# Vitek – Plugin API
+
+External plugins via \`plugins\` option. Type: \`VitekPlugin\`.
+
+## Hooks
+
+### afterTypesGenerated(ctx)
+
+Called after types, services, and OpenAPI are generated. \`ctx\`: \`root\`, \`schema\` (RouteSchema[]), \`sockets\` (ParsedSocket[]), \`apiBasePath\`, \`socketBasePath\`. Use for codegen or integrations.
+
+### beforeApiRequest(ctx)
+
+Called before each API request. \`ctx\`: \`req\`, \`res\`, \`path\`, \`method\`, \`next()\`. Call \`next()\` to continue; send response and omit \`next()\` to short-circuit (e.g. auth, rate limit).
+
+\`\`\`typescript
+const authPlugin: VitekPlugin = {
+  name: "auth",
+  async beforeApiRequest({ req, res, path, next }) {
+    if (path.startsWith("/admin/") && !req.headers.authorization) {
+      res.statusCode = 401;
+      res.setHeader("Content-Type", "application/json");
+      res.end(JSON.stringify({ error: "Unauthorized" }));
+      return;
+    }
+    next();
+  },
+};
+\`\`\`
+
+Import types: \`VitekPlugin\`, \`AfterTypesGeneratedContext\`, \`BeforeApiRequestContext\` from "vitek-plugin".
+`;

package/dist/mcp-docs-server/resources/response.d.ts

@@ -0,0 +1,3 @@
+export declare const RESPONSE_URI = "vitek://docs/response";
+export declare const RESPONSE_CONTENT = "# Vitek \u2013 Response handling\n\nReturn a plain object for 200 JSON, or use response helpers for status and headers.\n\n## Helpers (from vitek-plugin)\n\n- `ok(body?, headers?)` \u2013 200\n- `created(body?, headers?)` \u2013 201\n- `noContent(headers?)` \u2013 204\n- `badRequest(body?, headers?)` \u2013 400\n- `unauthorized(body?, headers?)` \u2013 401\n- `forbidden(body?, headers?)` \u2013 403\n- `notFound(body?, headers?)` \u2013 404\n- `conflict(body?, headers?)` \u2013 409\n- `unprocessableEntity(body?, headers?)` \u2013 422\n- `tooManyRequests(body?, headers?)` \u2013 429\n- `internalServerError(body?, headers?)` \u2013 500\n- `redirect(url, permanent?, preserveMethod?)` \u2013 301/302/307/308\n- `json(body, { status?, headers? })` \u2013 custom status/headers\n- `text(body: string, status?)` \u2013 plain text\n- `html(body: string, status?)` \u2013 HTML\n\n## VitekResponse\n\nReturn `{ status?, headers?, body? }` for full control (e.g. streaming, custom headers).\n\n## Example\n\n```typescript\nimport { created, notFound, json } from \"vitek-plugin\";\nimport type { VitekContext } from \"vitek-plugin\";\n\nexport default function handler(context: VitekContext) {\n  if (!context.params.id) return notFound({ error: \"Not found\" });\n  return created({ id: context.params.id });\n}\n```\n";
+//# sourceMappingURL=response.d.ts.map

package/dist/mcp-docs-server/resources/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/response.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAEpD,eAAO,MAAM,gBAAgB,yyCAqC5B,CAAC"}

package/dist/mcp-docs-server/resources/response.js

@@ -0,0 +1,39 @@
+export const RESPONSE_URI = 'vitek://docs/response';
+export const RESPONSE_CONTENT = `# Vitek – Response handling
+
+Return a plain object for 200 JSON, or use response helpers for status and headers.
+
+## Helpers (from vitek-plugin)
+
+- \`ok(body?, headers?)\` – 200
+- \`created(body?, headers?)\` – 201
+- \`noContent(headers?)\` – 204
+- \`badRequest(body?, headers?)\` – 400
+- \`unauthorized(body?, headers?)\` – 401
+- \`forbidden(body?, headers?)\` – 403
+- \`notFound(body?, headers?)\` – 404
+- \`conflict(body?, headers?)\` – 409
+- \`unprocessableEntity(body?, headers?)\` – 422
+- \`tooManyRequests(body?, headers?)\` – 429
+- \`internalServerError(body?, headers?)\` – 500
+- \`redirect(url, permanent?, preserveMethod?)\` – 301/302/307/308
+- \`json(body, { status?, headers? })\` – custom status/headers
+- \`text(body: string, status?)\` – plain text
+- \`html(body: string, status?)\` – HTML
+
+## VitekResponse
+
+Return \`{ status?, headers?, body? }\` for full control (e.g. streaming, custom headers).
+
+## Example
+
+\`\`\`typescript
+import { created, notFound, json } from "vitek-plugin";
+import type { VitekContext } from "vitek-plugin";
+
+export default function handler(context: VitekContext) {
+  if (!context.params.id) return notFound({ error: "Not found" });
+  return created({ id: context.params.id });
+}
+\`\`\`
+`;

package/dist/mcp-docs-server/resources/routing.d.ts

@@ -0,0 +1,3 @@
+export declare const ROUTING_URI = "vitek://docs/routing";
+export declare const ROUTING_CONTENT = "# Vitek \u2013 Routing\n\nRoute handlers receive a `VitekContext` and return a plain object or a response from response helpers.\n\n## File naming\n\n- `[name].[method].ts` or `.js` under the API directory (default `src/api`).\n- Method: get, post, put, patch, delete, head, options.\n- Dynamic segment: `[id]` \u2192 one segment (`users/[id].get.ts` \u2192 pattern `users/:id`).\n- Catch-all: `[...ids]` \u2192 rest of path (`posts/[...ids].get.ts` \u2192 pattern `posts/*ids`).\n- Index route: `index.get.ts` or `folder/index.post.ts` for directory index.\n\n## Examples\n\nSimple GET: `src/api/health.get.ts`\n```typescript\nimport type { VitekContext } from \"vitek-plugin\";\nexport default function handler(context: VitekContext) {\n  return { status: \"ok\", timestamp: new Date().toISOString() };\n}\n```\n\nDynamic param: `src/api/users/[id].get.ts`\n```typescript\nimport type { VitekContext } from \"vitek-plugin\";\nexport default async function handler(context: VitekContext) {\n  const { params } = context;\n  return { id: params.id, name: `User ${params.id}` };\n}\n```\n\nPOST with body: `src/api/posts/index.post.ts`\n```typescript\nimport type { VitekContext } from \"vitek-plugin\";\nexport type Body = { title: string; content: string; authorId: number };\nexport default async function handler(context: VitekContext) {\n  const { body } = context;\n  return { message: \"Post created\", post: { id: Math.random(), ...body } };\n}\n```\n\n## Config\n\n- `apiDir`: directory for route files (default `src/api`).\n- `apiBasePath`: URL prefix (default `/api`).\n";
+//# sourceMappingURL=routing.d.ts.map

package/dist/mcp-docs-server/resources/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/routing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAElD,eAAO,MAAM,eAAe,ijDA6C3B,CAAC"}

package/dist/mcp-docs-server/resources/routing.js

@@ -0,0 +1,47 @@
+export const ROUTING_URI = 'vitek://docs/routing';
+export const ROUTING_CONTENT = `# Vitek – Routing
+
+Route handlers receive a \`VitekContext\` and return a plain object or a response from response helpers.
+
+## File naming
+
+- \`[name].[method].ts\` or \`.js\` under the API directory (default \`src/api\`).
+- Method: get, post, put, patch, delete, head, options.
+- Dynamic segment: \`[id]\` → one segment (\`users/[id].get.ts\` → pattern \`users/:id\`).
+- Catch-all: \`[...ids]\` → rest of path (\`posts/[...ids].get.ts\` → pattern \`posts/*ids\`).
+- Index route: \`index.get.ts\` or \`folder/index.post.ts\` for directory index.
+
+## Examples
+
+Simple GET: \`src/api/health.get.ts\`
+\`\`\`typescript
+import type { VitekContext } from "vitek-plugin";
+export default function handler(context: VitekContext) {
+  return { status: "ok", timestamp: new Date().toISOString() };
+}
+\`\`\`
+
+Dynamic param: \`src/api/users/[id].get.ts\`
+\`\`\`typescript
+import type { VitekContext } from "vitek-plugin";
+export default async function handler(context: VitekContext) {
+  const { params } = context;
+  return { id: params.id, name: \`User \${params.id}\` };
+}
+\`\`\`
+
+POST with body: \`src/api/posts/index.post.ts\`
+\`\`\`typescript
+import type { VitekContext } from "vitek-plugin";
+export type Body = { title: string; content: string; authorId: number };
+export default async function handler(context: VitekContext) {
+  const { body } = context;
+  return { message: "Post created", post: { id: Math.random(), ...body } };
+}
+\`\`\`
+
+## Config
+
+- \`apiDir\`: directory for route files (default \`src/api\`).
+- \`apiBasePath\`: URL prefix (default \`/api\`).
+`;

package/dist/mcp-docs-server/resources/validation.d.ts

@@ -0,0 +1,3 @@
+export declare const VALIDATION_URI = "vitek://docs/validation";
+export declare const VALIDATION_CONTENT = "# Vitek \u2013 Request validation\n\nOptional runtime validation for body and query via helpers.\n\n## Helpers\n\n- `validateBody(body, schema)` \u2013 validates request body; throws ValidationError (422) if invalid\n- `validateQuery(query, schema)` \u2013 validates query params\n- `validate(data, schema)` \u2013 returns result without throwing\n- `validateOrThrow(data, schema)` \u2013 throws ValidationError if invalid\n\n## ValidationRule (per field)\n\n`type`: \"string\" | \"number\" | \"boolean\" | \"object\" | \"array\"\n`required?`, `min?`, `max?`, `pattern?` (string or RegExp), `custom?` (value => boolean | string)\n\n## Example\n\n```typescript\nimport { validateBody, validateQuery } from \"vitek-plugin\";\nimport type { VitekContext } from \"vitek-plugin\";\n\nexport default function handler(context: VitekContext) {\n  const body = validateBody(context.body, {\n    title: { type: \"string\", required: true, min: 1, max: 200 },\n    authorId: { type: \"number\", required: true, min: 1 },\n  });\n  const query = validateQuery(context.query, {\n    limit: { type: \"number\", min: 1, max: 100 },\n  });\n  return { body, query };\n}\n```\n\nPlugin option `enableValidation: true` enables automatic validation; manual helpers are always available.\n";
+//# sourceMappingURL=validation.d.ts.map

package/dist/mcp-docs-server/resources/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/validation.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD,eAAO,MAAM,kBAAkB,0vCAmC9B,CAAC"}

package/dist/mcp-docs-server/resources/validation.js

@@ -0,0 +1,37 @@
+export const VALIDATION_URI = 'vitek://docs/validation';
+export const VALIDATION_CONTENT = `# Vitek – Request validation
+
+Optional runtime validation for body and query via helpers.
+
+## Helpers
+
+- \`validateBody(body, schema)\` – validates request body; throws ValidationError (422) if invalid
+- \`validateQuery(query, schema)\` – validates query params
+- \`validate(data, schema)\` – returns result without throwing
+- \`validateOrThrow(data, schema)\` – throws ValidationError if invalid
+
+## ValidationRule (per field)
+
+\`type\`: "string" | "number" | "boolean" | "object" | "array"
+\`required?\`, \`min?\`, \`max?\`, \`pattern?\` (string or RegExp), \`custom?\` (value => boolean | string)
+
+## Example
+
+\`\`\`typescript
+import { validateBody, validateQuery } from "vitek-plugin";
+import type { VitekContext } from "vitek-plugin";
+
+export default function handler(context: VitekContext) {
+  const body = validateBody(context.body, {
+    title: { type: "string", required: true, min: 1, max: 200 },
+    authorId: { type: "number", required: true, min: 1 },
+  });
+  const query = validateQuery(context.query, {
+    limit: { type: "number", min: 1, max: 100 },
+  });
+  return { body, query };
+}
+\`\`\`
+
+Plugin option \`enableValidation: true\` enables automatic validation; manual helpers are always available.
+`;

package/dist/mcp-docs-server/resources/websockets.d.ts

@@ -0,0 +1,3 @@
+export declare const WEBSOCKETS_URI = "vitek://docs/websockets";
+export declare const WEBSOCKETS_CONTENT = "# Vitek \u2013 WebSockets\n\nFile-based socket routes: `.socket.ts` or `.socket.js` under `src/api`. Default base path `/api/ws`.\n\n## Naming\n\n| File | Path (default base /api/ws) |\n|------|-----------------------------|\n| index.socket.js | /api/ws |\n| chat.socket.js | /api/ws/chat |\n| rooms/[id].socket.js | /api/ws/rooms/:id |\n\nSame `[param]` and `[...rest]` rules as HTTP routes.\n\n## Handler context (VitekSocketContext)\n\n- `ctx.socket` \u2013 WebSocket (send, on('message'), close)\n- `ctx.req` \u2013 HTTP upgrade request\n- `ctx.params` \u2013 route params\n- `ctx.path` \u2013 full path (e.g. /api/ws/chat)\n- `ctx.api` \u2013 (when available) internal API client: `ctx.api.fetch(path, { method?, body? })`\n\nExport default handler; can return a cleanup function (runs on disconnect).\n\n```typescript\nexport default function handler(ctx) {\n  ctx.socket.on('message', (data) => {\n    ctx.socket.send(`Echo: ${data}`);\n  });\n  return () => { /* cleanup */ };\n}\n```\n\n## API \u2192 Socket (broadcast)\n\nIn HTTP handlers, `context.sockets` (when available): `context.sockets.emit(pattern, data)`. `pattern` is the socket route ('' for root, 'chat' for /api/ws/chat).\n\n## Config\n\n`sockets: { path: '/ws' }` \u2013 custom base path. `sockets: false` \u2013 disable.\n";
+//# sourceMappingURL=websockets.d.ts.map

package/dist/mcp-docs-server/resources/websockets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websockets.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/websockets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD,eAAO,MAAM,kBAAkB,sxCAwC9B,CAAC"}

package/dist/mcp-docs-server/resources/websockets.js

@@ -0,0 +1,42 @@
+export const WEBSOCKETS_URI = 'vitek://docs/websockets';
+export const WEBSOCKETS_CONTENT = `# Vitek – WebSockets
+
+File-based socket routes: \`.socket.ts\` or \`.socket.js\` under \`src/api\`. Default base path \`/api/ws\`.
+
+## Naming
+
+| File | Path (default base /api/ws) |
+|------|-----------------------------|
+| index.socket.js | /api/ws |
+| chat.socket.js | /api/ws/chat |
+| rooms/[id].socket.js | /api/ws/rooms/:id |
+
+Same \`[param]\` and \`[...rest]\` rules as HTTP routes.
+
+## Handler context (VitekSocketContext)
+
+- \`ctx.socket\` – WebSocket (send, on('message'), close)
+- \`ctx.req\` – HTTP upgrade request
+- \`ctx.params\` – route params
+- \`ctx.path\` – full path (e.g. /api/ws/chat)
+- \`ctx.api\` – (when available) internal API client: \`ctx.api.fetch(path, { method?, body? })\`
+
+Export default handler; can return a cleanup function (runs on disconnect).
+
+\`\`\`typescript
+export default function handler(ctx) {
+  ctx.socket.on('message', (data) => {
+    ctx.socket.send(\`Echo: \${data}\`);
+  });
+  return () => { /* cleanup */ };
+}
+\`\`\`
+
+## API → Socket (broadcast)
+
+In HTTP handlers, \`context.sockets\` (when available): \`context.sockets.emit(pattern, data)\`. \`pattern\` is the socket route ('' for root, 'chat' for /api/ws/chat).
+
+## Config
+
+\`sockets: { path: '/ws' }\` – custom base path. \`sockets: false\` – disable.
+`;

package/dist/mcp-docs-server/start-mcp-docs-server.d.ts

@@ -0,0 +1,2 @@
+export declare function startMcpDocsServer(): Promise<void>;
+//# sourceMappingURL=start-mcp-docs-server.d.ts.map

package/dist/mcp-docs-server/start-mcp-docs-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-mcp-docs-server.d.ts","sourceRoot":"","sources":["../../src/mcp-docs-server/start-mcp-docs-server.ts"],"names":[],"mappings":"AA4BA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwOxD"}

package/dist/mcp-docs-server/start-mcp-docs-server.js

@@ -0,0 +1,171 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { ROUTING_URI, ROUTING_CONTENT } from './resources/routing.js';
+import { CONTEXT_URI, CONTEXT_CONTENT } from './resources/context.js';
+import { RESPONSE_URI, RESPONSE_CONTENT } from './resources/response.js';
+import { MIDDLEWARES_URI, MIDDLEWARES_CONTENT } from './resources/middlewares.js';
+import { WEBSOCKETS_URI, WEBSOCKETS_CONTENT } from './resources/websockets.js';
+import { VALIDATION_URI, VALIDATION_CONTENT } from './resources/validation.js';
+import { ERRORS_URI, ERRORS_CONTENT } from './resources/errors.js';
+import { PLUGIN_API_URI, PLUGIN_API_CONTENT } from './resources/plugin-api.js';
+import { CONFIGURATION_URI, CONFIGURATION_CONTENT } from './resources/configuration.js';
+import { INTROSPECTION_URI, INTROSPECTION_CONTENT } from './resources/introspection.js';
+import { pathToRouteFilePath } from './tools/create-route.js';
+import { pathToMiddlewareFilePath } from './tools/create-middleware.js';
+import { pathToSocketFilePath } from './tools/create-socket.js';
+import { suggestViteConfig } from './tools/suggest-vite-config.js';
+import { validateConvention } from './tools/validate-convention.js';
+function readPluginVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(here, '../../package.json');
+    return JSON.parse(readFileSync(pkgPath, 'utf-8')).version;
+}
+export async function startMcpDocsServer() {
+    const server = new McpServer({
+        name: 'vitek-mcp-docs',
+        version: readPluginVersion(),
+    }, {
+        capabilities: {
+            resources: {},
+            tools: {},
+        },
+    });
+    server.registerResource('vitek-docs-routing', ROUTING_URI, {
+        title: 'Vitek routing',
+        description: 'File-based routing conventions and examples',
+        mimeType: 'text/plain',
+    }, async () => ({
+        contents: [{ uri: ROUTING_URI, text: ROUTING_CONTENT }],
+    }));
+    server.registerResource('vitek-docs-context', CONTEXT_URI, {
+        title: 'Vitek context',
+        description: 'VitekContext and VitekRequest',
+        mimeType: 'text/plain',
+    }, async () => ({
+        contents: [{ uri: CONTEXT_URI, text: CONTEXT_CONTENT }],
+    }));
+    server.registerResource('vitek-docs-response', RESPONSE_URI, {
+        title: 'Vitek response',
+        description: 'Response helpers and VitekResponse',
+        mimeType: 'text/plain',
+    }, async () => ({
+        contents: [{ uri: RESPONSE_URI, text: RESPONSE_CONTENT }],
+    }));
+    server.registerResource('vitek-docs-middlewares', MIDDLEWARES_URI, { title: 'Vitek middlewares', description: 'Global and hierarchical middlewares', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: MIDDLEWARES_URI, text: MIDDLEWARES_CONTENT }] }));
+    server.registerResource('vitek-docs-websockets', WEBSOCKETS_URI, { title: 'Vitek WebSockets', description: 'File-based socket routes and context', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: WEBSOCKETS_URI, text: WEBSOCKETS_CONTENT }] }));
+    server.registerResource('vitek-docs-validation', VALIDATION_URI, { title: 'Vitek validation', description: 'validateBody, validateQuery, ValidationRule', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: VALIDATION_URI, text: VALIDATION_CONTENT }] }));
+    server.registerResource('vitek-docs-errors', ERRORS_URI, { title: 'Vitek errors', description: 'HttpError classes and onError', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: ERRORS_URI, text: ERRORS_CONTENT }] }));
+    server.registerResource('vitek-docs-plugin-api', PLUGIN_API_URI, { title: 'Vitek plugin API', description: 'VitekPlugin, afterTypesGenerated, beforeApiRequest', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: PLUGIN_API_URI, text: PLUGIN_API_CONTENT }] }));
+    server.registerResource('vitek-docs-configuration', CONFIGURATION_URI, { title: 'Vitek configuration', description: 'VitekOptions reference', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: CONFIGURATION_URI, text: CONFIGURATION_CONTENT }] }));
+    server.registerResource('vitek-docs-introspection', INTROSPECTION_URI, { title: 'Vitek introspection', description: 'getManifest, getRoutes, getSockets, writeManifest', mimeType: 'text/plain' }, async () => ({ contents: [{ uri: INTROSPECTION_URI, text: INTROSPECTION_CONTENT }] }));
+    server.registerTool('vitek_create_route', {
+        title: 'Create Vitek route',
+        description: 'Returns a file path and code snippet for a new Vitek route. path can use [id], [...rest], or :id, *rest.',
+        inputSchema: {
+            path: z.string().describe('Route path, e.g. users/[id] or users/:id or posts/[...ids]'),
+            method: z
+                .enum(['get', 'post', 'put', 'patch', 'delete', 'head', 'options'])
+                .describe('HTTP method'),
+            apiDir: z.string().optional().default('src/api').describe('API directory'),
+        },
+    }, async ({ path, method, apiDir }) => {
+        try {
+            const { filePath, snippet } = pathToRouteFilePath(path, method, apiDir);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `File: ${filePath}\n\n${snippet}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('vitek_create_middleware', {
+        title: 'Create Vitek middleware',
+        description: 'Returns file path and snippet for a new middleware. basePattern: e.g. "users" or "posts/[id]" or empty for global.',
+        inputSchema: {
+            basePattern: z.string().describe('Path segment for middleware scope, or empty for global (src/api/middleware.ts)'),
+            apiDir: z.string().optional().default('src/api').describe('API directory'),
+        },
+    }, async ({ basePattern, apiDir }) => {
+        try {
+            const { filePath, snippet } = pathToMiddlewareFilePath(basePattern, apiDir);
+            return { content: [{ type: 'text', text: `File: ${filePath}\n\n${snippet}` }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
+        }
+    });
+    server.registerTool('vitek_create_socket', {
+        title: 'Create Vitek socket',
+        description: 'Returns file path and snippet for a new WebSocket handler. pattern: e.g. "chat" or "rooms/[id]".',
+        inputSchema: {
+            pattern: z.string().describe('Socket path pattern, e.g. chat or rooms/[id]'),
+            apiDir: z.string().optional().default('src/api').describe('API directory'),
+        },
+    }, async ({ pattern, apiDir }) => {
+        try {
+            const { filePath, snippet } = pathToSocketFilePath(pattern, apiDir);
+            return { content: [{ type: 'text', text: `File: ${filePath}\n\n${snippet}` }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
+        }
+    });
+    server.registerTool('vitek_suggest_vite_config', {
+        title: 'Suggest Vite + Vitek config',
+        description: 'Returns a vite.config.ts snippet with vitek() and optional openApi, cors, apiDir, sockets.',
+        inputSchema: {
+            openApi: z.boolean().optional().describe('Enable OpenAPI docs'),
+            cors: z.boolean().optional().describe('Enable CORS'),
+            apiDir: z.string().optional().describe('API directory'),
+            apiBasePath: z.string().optional().describe('API base path'),
+            socketsPath: z.string().optional().describe('Custom socket path, e.g. /ws'),
+        },
+    }, async (args) => {
+        const options = {
+            openApi: args.openApi,
+            cors: args.cors,
+            apiDir: args.apiDir,
+            apiBasePath: args.apiBasePath,
+            sockets: args.socketsPath != null ? { path: args.socketsPath } : undefined,
+        };
+        const snippet = suggestViteConfig(options);
+        return { content: [{ type: 'text', text: snippet }] };
+    });
+    server.registerTool('vitek_validate_convention', {
+        title: 'Validate Vitek file convention',
+        description: 'Checks if a file path follows Vitek naming (route, middleware, or socket). Returns type, method/pattern if valid.',
+        inputSchema: {
+            filePath: z.string().describe('Path to file, e.g. src/api/users/[id].get.ts'),
+            apiDir: z.string().optional().default('src/api').describe('API directory'),
+        },
+    }, async ({ filePath, apiDir }) => {
+        const result = validateConvention(filePath, apiDir);
+        if (result.valid) {
+            const detail = result.type === 'route'
+                ? `method=${result.method} pattern=${result.pattern} params=[${result.params.join(', ')}]`
+                : result.type === 'middleware'
+                    ? `basePattern=${result.basePattern || '(global)'}`
+                    : `pattern=${result.pattern} params=[${result.params.join(', ')}]`;
+            return { content: [{ type: 'text', text: `Valid ${result.type}: ${detail}` }] };
+        }
+        return { content: [{ type: 'text', text: result.message }], isError: true };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}

package/dist/mcp-docs-server/tools/create-middleware.d.ts

@@ -0,0 +1,5 @@
+export declare function pathToMiddlewareFilePath(basePattern: string, apiDir?: string): {
+    filePath: string;
+    snippet: string;
+};
+//# sourceMappingURL=create-middleware.d.ts.map

package/dist/mcp-docs-server/tools/create-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-middleware.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/tools/create-middleware.ts"],"names":[],"mappings":"AAQA,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAkB,GACzB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmBvC"}

package/dist/mcp-docs-server/tools/create-middleware.js

@@ -0,0 +1,29 @@
+function pathToFileSegment(segment) {
+    if (/^\[\.\.\.[^\]]+\]$/.test(segment))
+        return segment;
+    if (/^\[[^\]]+\]$/.test(segment))
+        return segment;
+    if (segment.startsWith('*'))
+        return `[...${segment.slice(1)}]`;
+    if (segment.startsWith(':'))
+        return `[${segment.slice(1)}]`;
+    return segment;
+}
+export function pathToMiddlewareFilePath(basePattern, apiDir = 'src/api') {
+    const normalized = basePattern.replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
+    const segments = normalized ? normalized.split('/').filter(Boolean) : [];
+    const fileSegments = segments.map((s) => pathToFileSegment(s));
+    const dirPart = fileSegments.length ? fileSegments.join('/') : '';
+    const filePath = dirPart
+        ? `${apiDir}/${dirPart}/middleware.ts`.replace(/\/+/g, '/')
+        : `${apiDir}/middleware.ts`.replace(/\/+/g, '/');
+    const snippet = `import type { Middleware } from "vitek-plugin";
+
+export default [
+  async (context, next) => {
+    await next();
+  },
+] satisfies Middleware[];
+`;
+    return { filePath, snippet };
+}

package/dist/mcp-docs-server/tools/create-route.d.ts

@@ -0,0 +1,5 @@
+export declare function pathToRouteFilePath(pathInput: string, method: string, apiDir?: string): {
+    filePath: string;
+    snippet: string;
+};
+//# sourceMappingURL=create-route.d.ts.map

package/dist/mcp-docs-server/tools/create-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-route.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/tools/create-route.ts"],"names":[],"mappings":"AAUA,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAkB,GACzB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiCvC"}

package/dist/mcp-docs-server/tools/create-route.js

@@ -0,0 +1,44 @@
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+function pathToFileSegment(segment) {
+    if (/^\[\.\.\.[^\]]+\]$/.test(segment))
+        return segment;
+    if (/^\[[^\]]+\]$/.test(segment))
+        return segment;
+    if (segment.startsWith('*'))
+        return `[...${segment.slice(1)}]`;
+    if (segment.startsWith(':'))
+        return `[${segment.slice(1)}]`;
+    return segment;
+}
+export function pathToRouteFilePath(pathInput, method, apiDir = 'src/api') {
+    const methodLower = method.toLowerCase();
+    if (!HTTP_METHODS.includes(methodLower)) {
+        throw new Error(`Invalid method: ${method}. Use one of ${HTTP_METHODS.join(', ')}`);
+    }
+    const normalized = pathInput.replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
+    const segments = normalized ? normalized.split('/').filter(Boolean) : [];
+    const fileSegments = segments.map((s) => pathToFileSegment(s));
+    const pathPart = fileSegments.length ? fileSegments.join('/') : 'index';
+    const fileName = `${pathPart}.${methodLower}.ts`;
+    const filePath = `${apiDir}/${fileName}`.replace(/\/+/g, '/');
+    const paramNames = segments
+        .filter((s) => s.startsWith(':') || s.startsWith('*') || /^\[\.\.\.[^\]]+\]$/.test(s) || /^\[[^\]]+\]$/.test(s))
+        .map((s) => {
+        if (s.startsWith('*'))
+            return s.slice(1);
+        if (s.startsWith(':'))
+            return s.slice(1);
+        const m = s.match(/^\[\.\.\.?([^\]]+)\]$/);
+        return m ? m[1] : s;
+    });
+    const paramsSnippet = paramNames.length > 0
+        ? `  const { params } = context;\n  return { ${paramNames.map((p) => `${p}: params.${p}`).join(', ')} };`
+        : '  return { message: "ok" };';
+    const snippet = `import type { VitekContext } from "vitek-plugin";
+
+export default async function handler(context: VitekContext) {
+${paramsSnippet}
+}
+`;
+    return { filePath, snippet };
+}

package/dist/mcp-docs-server/tools/create-socket.d.ts

@@ -0,0 +1,5 @@
+export declare function pathToSocketFilePath(pattern: string, apiDir?: string): {
+    filePath: string;
+    snippet: string;
+};
+//# sourceMappingURL=create-socket.d.ts.map

package/dist/mcp-docs-server/tools/create-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-socket.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/tools/create-socket.ts"],"names":[],"mappings":"AAQA,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAkB,GACzB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA8BvC"}