vitek-plugin 0.2.0-beta → 0.2.2-beta

package/dist/mcp/write/project-write-handlers.js

@@ -0,0 +1,304 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { getManifest } from '../../core/introspection/manifest.js';
+import { parseRouteFile } from '../../core/routing/route-parser.js';
+import { resolveApplyMode } from './apply-guard.js';
+import { buildRouteFileContent } from './route-snippet.js';
+import { computeRouteRisks } from './risks.js';
+import { assertUnderApiDir, resolvePathUnderRoot } from './safe-path.js';
+import { unifiedFileDiff } from './unified-diff.js';
+import { applyOpenApiSummaryToFileContent } from './openapi-jsdoc.js';
+import { injectValidationScaffold } from './validation-scaffold.js';
+import { buildRouteTestFileContent } from './test-file-content.js';
+function okResult(partial) {
+    return { ok: true, ...partial };
+}
+function errResult(message) {
+    return {
+        ok: false,
+        dryRun: true,
+        diff: '',
+        risk: [],
+        next: '',
+        error: message,
+    };
+}
+export function handleVitekRouteCreate(ctx, input) {
+    const dryRun = input.dryRun !== false;
+    const apply = input.apply === true;
+    const ext = input.extension ?? 'ts';
+    const apiDirAbs = path.resolve(ctx.root, ctx.apiDir);
+    let built;
+    try {
+        built = buildRouteFileContent(input.routePath, input.method, ext);
+    }
+    catch (e) {
+        return errResult(e instanceof Error ? e.message : String(e));
+    }
+    const rel = path.join(ctx.apiDir, built.relativeFilePath).replace(/\\/g, '/');
+    const abs = resolvePathUnderRoot(ctx.root, rel);
+    if (!abs || !assertUnderApiDir(ctx.root, ctx.apiDir, abs)) {
+        return errResult('Invalid path: must stay under project root and api directory.');
+    }
+    const manifest = getManifest(ctx.root, ctx.apiDir);
+    const parsed = parseRouteFile(abs, apiDirAbs);
+    const pattern = parsed?.pattern ?? input.routePath.replace(/\\/g, '/');
+    const risk = computeRouteRisks(manifest, pattern, input.method.toLowerCase());
+    if (fs.existsSync(abs)) {
+        risk.unshift('Target file already exists; write would overwrite.');
+    }
+    const before = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf-8') : null;
+    const diff = unifiedFileDiff(rel, before, built.content);
+    const resolution = resolveApplyMode(ctx.root, apply, dryRun);
+    if (resolution.rejectReason) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: resolution.rejectReason,
+            rejectReason: resolution.rejectReason,
+            filePath: rel,
+        });
+    }
+    if (!resolution.writeAllowed) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: 'Call again with apply: true and dryRun: false to write the file (requires vitek.platform.json mcpWriteTools).',
+            filePath: rel,
+        });
+    }
+    fs.mkdirSync(path.dirname(abs), { recursive: true });
+    fs.writeFileSync(abs, built.content, 'utf-8');
+    return okResult({
+        dryRun: false,
+        written: true,
+        diff,
+        risk,
+        next: 'File written.',
+        filePath: rel,
+    });
+}
+export function handleVitekRouteUpdate(ctx, input) {
+    const dryRun = input.dryRun !== false;
+    const apply = input.apply === true;
+    const rel = input.filePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    const abs = resolvePathUnderRoot(ctx.root, rel);
+    if (!abs || !assertUnderApiDir(ctx.root, ctx.apiDir, abs)) {
+        return errResult('Invalid path: must stay under project root and api directory.');
+    }
+    const before = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf-8') : null;
+    if (before === null) {
+        return errResult('File does not exist. Use vitek_route_create for new routes.');
+    }
+    const diff = unifiedFileDiff(rel, before, input.content);
+    const risk = ['Overwrites entire file content.'];
+    const resolution = resolveApplyMode(ctx.root, apply, dryRun);
+    if (resolution.rejectReason) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: resolution.rejectReason,
+            rejectReason: resolution.rejectReason,
+            filePath: rel,
+        });
+    }
+    if (!resolution.writeAllowed) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: 'Call again with apply: true and dryRun: false to write.',
+            filePath: rel,
+        });
+    }
+    fs.writeFileSync(abs, input.content, 'utf-8');
+    return okResult({
+        dryRun: false,
+        written: true,
+        diff,
+        risk,
+        next: 'File updated.',
+        filePath: rel,
+    });
+}
+export function handleVitekValidationSuggest(ctx, input) {
+    const dryRun = input.dryRun !== false;
+    const apply = input.apply === true;
+    const rel = input.filePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    const abs = resolvePathUnderRoot(ctx.root, rel);
+    if (!abs || !assertUnderApiDir(ctx.root, ctx.apiDir, abs)) {
+        return errResult('Invalid path: must stay under project root and api directory.');
+    }
+    if (!fs.existsSync(abs)) {
+        return errResult('File not found.');
+    }
+    const before = fs.readFileSync(abs, 'utf-8');
+    if (/validateBody\s*\(/.test(before)) {
+        return okResult({
+            dryRun: true,
+            diff: '',
+            risk: [],
+            next: 'File already calls validateBody; no change.',
+            filePath: rel,
+        });
+    }
+    const after = injectValidationScaffold(before);
+    const diff = unifiedFileDiff(rel, before, after);
+    const risk = [
+        'Adds validateBody(context.body, {}); replace {} with a real ValidationSchema.',
+        'May not suit GET routes without a body; edit after apply.',
+    ];
+    const resolution = resolveApplyMode(ctx.root, apply, dryRun);
+    if (resolution.rejectReason) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: resolution.rejectReason,
+            rejectReason: resolution.rejectReason,
+            filePath: rel,
+        });
+    }
+    if (!resolution.writeAllowed) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: 'Call again with apply: true and dryRun: false to write.',
+            filePath: rel,
+        });
+    }
+    fs.writeFileSync(abs, after, 'utf-8');
+    return okResult({
+        dryRun: false,
+        written: true,
+        diff,
+        risk,
+        next: 'Validation scaffold written; tighten schema and remove if not needed.',
+        filePath: rel,
+    });
+}
+export function handleVitekTestGenerate(ctx, input) {
+    const dryRun = input.dryRun !== false;
+    const apply = input.apply === true;
+    const relRoute = input.routeFilePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    const absRoute = resolvePathUnderRoot(ctx.root, relRoute);
+    if (!absRoute || !assertUnderApiDir(ctx.root, ctx.apiDir, absRoute)) {
+        return errResult('Invalid route file path.');
+    }
+    if (!fs.existsSync(absRoute)) {
+        return errResult('Route file not found.');
+    }
+    const apiDirAbs = path.resolve(ctx.root, ctx.apiDir);
+    const parsed = parseRouteFile(absRoute, apiDirAbs);
+    if (!parsed) {
+        return errResult('Path is not a Vitek route file.');
+    }
+    const testRel = relRoute.replace(/\.(ts|js)$/, `.test.ts`);
+    const testAbs = resolvePathUnderRoot(ctx.root, testRel);
+    if (!testAbs || !assertUnderApiDir(ctx.root, ctx.apiDir, testAbs)) {
+        return errResult('Invalid test output path.');
+    }
+    const content = buildRouteTestFileContent({
+        method: parsed.method,
+        pattern: parsed.pattern,
+        apiBasePath: ctx.apiBasePath,
+        baseUrl: ctx.baseUrl,
+    });
+    const before = fs.existsSync(testAbs) ? fs.readFileSync(testAbs, 'utf-8') : null;
+    const diff = unifiedFileDiff(testRel, before, content);
+    const risk = ['Ensure dev server is running when executing tests that call fetch.'];
+    const resolution = resolveApplyMode(ctx.root, apply, dryRun);
+    if (resolution.rejectReason) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: resolution.rejectReason,
+            rejectReason: resolution.rejectReason,
+            filePath: testRel,
+        });
+    }
+    if (!resolution.writeAllowed) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: 'Call again with apply: true and dryRun: false to write the test file.',
+            filePath: testRel,
+        });
+    }
+    fs.mkdirSync(path.dirname(testAbs), { recursive: true });
+    fs.writeFileSync(testAbs, content, 'utf-8');
+    return okResult({
+        dryRun: false,
+        written: true,
+        diff,
+        risk,
+        next: 'Test file written.',
+        filePath: testRel,
+    });
+}
+export function handleVitekOpenapiSync(ctx, input) {
+    const dryRun = input.dryRun !== false;
+    const apply = input.apply === true;
+    const rel = input.filePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    const abs = resolvePathUnderRoot(ctx.root, rel);
+    if (!abs || !assertUnderApiDir(ctx.root, ctx.apiDir, abs)) {
+        return errResult('Invalid path.');
+    }
+    if (!fs.existsSync(abs)) {
+        return errResult('File not found.');
+    }
+    const manifest = getManifest(ctx.root, ctx.apiDir);
+    const route = manifest.routes.find((r) => r.file === rel || r.file.replace(/\\/g, '/') === rel);
+    if (!route) {
+        return errResult('No manifest route matches this file; save the route and regenerate manifest if needed.');
+    }
+    const summary = `${route.method.toUpperCase()} ${route.pattern || '/'}`;
+    const before = fs.readFileSync(abs, 'utf-8');
+    const after = applyOpenApiSummaryToFileContent(before, summary);
+    const diff = unifiedFileDiff(rel, before, after);
+    if (diff === '') {
+        return okResult({
+            dryRun: true,
+            diff: '',
+            risk: [],
+            next: 'JSDoc @summary already matches suggested value.',
+            filePath: rel,
+        });
+    }
+    const risk = ['Updates JSDoc only; OpenAPI is regenerated from files on dev/build.'];
+    const resolution = resolveApplyMode(ctx.root, apply, dryRun);
+    if (resolution.rejectReason) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: resolution.rejectReason,
+            rejectReason: resolution.rejectReason,
+            filePath: rel,
+        });
+    }
+    if (!resolution.writeAllowed) {
+        return okResult({
+            dryRun: true,
+            diff,
+            risk,
+            next: 'Call again with apply: true and dryRun: false to write.',
+            filePath: rel,
+        });
+    }
+    fs.writeFileSync(abs, after, 'utf-8');
+    return okResult({
+        dryRun: false,
+        written: true,
+        diff,
+        risk,
+        next: 'JSDoc @summary updated.',
+        filePath: rel,
+    });
+}

package/dist/mcp/write/risks.d.ts

@@ -0,0 +1,3 @@
+import type { VitekManifest } from '../../core/introspection/manifest.js';
+export declare function computeRouteRisks(manifest: VitekManifest, routePattern: string, method: string): string[];
+//# sourceMappingURL=risks.d.ts.map

package/dist/mcp/write/risks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risks.d.ts","sourceRoot":"","sources":["../../../src/mcp/write/risks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAO1E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBzG"}

package/dist/mcp/write/risks.js

@@ -0,0 +1,20 @@
+function patternPrefix(pattern) {
+    const idx = pattern.indexOf('/');
+    return idx === -1 ? pattern : pattern.slice(0, idx);
+}
+export function computeRouteRisks(manifest, routePattern, method) {
+    const risks = [];
+    const prefix = patternPrefix(routePattern);
+    const scoped = manifest.middlewares.filter((m) => m.basePattern !== '' && (routePattern === m.basePattern || routePattern.startsWith(m.basePattern + '/')));
+    if (scoped.length === 0 && prefix !== '' && manifest.middlewares.every((m) => m.basePattern === '')) {
+        risks.push(`No route-scoped middleware under "${prefix}"; only global middleware applies.`);
+    }
+    const globalMw = manifest.middlewares.filter((m) => m.basePattern === '').length;
+    if (globalMw === 0) {
+        risks.push('No global middleware registered.');
+    }
+    if (method === 'post' || method === 'put' || method === 'patch') {
+        risks.push('Validate request body with validateBody / validation rules where appropriate.');
+    }
+    return risks;
+}

package/dist/mcp/write/route-snippet.d.ts

@@ -0,0 +1,5 @@
+export declare function buildRouteFileContent(pathInput: string, method: string, ext: 'ts' | 'js'): {
+    relativeFilePath: string;
+    content: string;
+};
+//# sourceMappingURL=route-snippet.d.ts.map

package/dist/mcp/write/route-snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-snippet.d.ts","sourceRoot":"","sources":["../../../src/mcp/write/route-snippet.ts"],"names":[],"mappings":"AAUA,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,IAAI,GAAG,IAAI,GACf;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAwC/C"}

package/dist/mcp/write/route-snippet.js

@@ -0,0 +1,46 @@
+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 buildRouteFileContent(pathInput, method, ext) {
+    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}.${ext}`;
+    const relativeFilePath = 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 typeImport = ext === 'ts' ? 'import type { VitekContext } from "vitek-plugin";\n\n' : '';
+    const paramsSnippet = paramNames.length > 0
+        ? `  const { params } = context;\n  return { ${paramNames.map((p) => `${p}: params.${p}`).join(', ')} };`
+        : '  return { message: "ok" };';
+    const content = typeImport +
+        `export default async function handler(context${ext === 'ts' ? ': VitekContext' : ''}) {\n` +
+        `${paramsSnippet}\n` +
+        `}\n`;
+    return { relativeFilePath, content };
+}

package/dist/mcp/write/safe-path.d.ts

@@ -0,0 +1,3 @@
+export declare function resolvePathUnderRoot(root: string, relativePath: string): string | null;
+export declare function assertUnderApiDir(root: string, apiDir: string, absolutePath: string): boolean;
+//# sourceMappingURL=safe-path.d.ts.map

package/dist/mcp/write/safe-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-path.d.ts","sourceRoot":"","sources":["../../../src/mcp/write/safe-path.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAStF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAI7F"}

package/dist/mcp/write/safe-path.js

@@ -0,0 +1,16 @@
+import * as path from 'path';
+export function resolvePathUnderRoot(root, relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    const resolved = path.resolve(root, normalized);
+    const rootResolved = path.resolve(root);
+    const prefix = rootResolved.endsWith(path.sep) ? rootResolved : rootResolved + path.sep;
+    if (resolved !== rootResolved && !resolved.startsWith(prefix)) {
+        return null;
+    }
+    return resolved;
+}
+export function assertUnderApiDir(root, apiDir, absolutePath) {
+    const apiRoot = path.resolve(root, apiDir);
+    const prefix = apiRoot.endsWith(path.sep) ? apiRoot : apiRoot + path.sep;
+    return absolutePath === apiRoot || absolutePath.startsWith(prefix);
+}

package/dist/mcp/write/test-file-content.d.ts

@@ -0,0 +1,8 @@
+import type { HttpMethod } from '../../shared/constants.js';
+export declare function buildRouteTestFileContent(opts: {
+    method: HttpMethod;
+    pattern: string;
+    apiBasePath: string;
+    baseUrl: string;
+}): string;
+//# sourceMappingURL=test-file-content.d.ts.map

package/dist/mcp/write/test-file-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-file-content.d.ts","sourceRoot":"","sources":["../../../src/mcp/write/test-file-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAe5D,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAmBT"}

package/dist/mcp/write/test-file-content.js

@@ -0,0 +1,31 @@
+function patternToPathSuffix(pattern) {
+    if (pattern === '')
+        return '';
+    return pattern
+        .split('/')
+        .filter(Boolean)
+        .map((seg) => {
+        if (seg.startsWith(':'))
+            return '1';
+        if (seg.startsWith('*'))
+            return 'x';
+        return seg;
+    })
+        .join('/');
+}
+export function buildRouteTestFileContent(opts) {
+    const suffix = patternToPathSuffix(opts.pattern);
+    const pathPart = suffix ? `${suffix}` : '';
+    const urlLine = opts.pattern === ''
+        ? `const url = \`${opts.baseUrl.replace(/\/$/, '')}${opts.apiBasePath}\`;`
+        : `const url = \`${opts.baseUrl.replace(/\/$/, '')}${opts.apiBasePath}/${pathPart}\`;`;
+    return (`import { describe, it, expect } from "vitest";\n` +
+        `${urlLine}\n\n` +
+        `describe("${opts.method.toUpperCase()} ${opts.apiBasePath}/${opts.pattern || '(index)'}", () => {\n` +
+        `  it("responds", async () => {\n` +
+        `    const res = await fetch(url, { method: "${opts.method.toUpperCase()}" });\n` +
+        `    expect(res.status).toBeGreaterThanOrEqual(200);\n` +
+        `    expect(res.status).toBeLessThan(600);\n` +
+        `  });\n` +
+        `});\n`);
+}

package/dist/mcp/write/unified-diff.d.ts

@@ -0,0 +1,2 @@
+export declare function unifiedFileDiff(relativePath: string, before: string | null, after: string): string;
+//# sourceMappingURL=unified-diff.d.ts.map

package/dist/mcp/write/unified-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-diff.d.ts","sourceRoot":"","sources":["../../../src/mcp/write/unified-diff.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBlG"}

package/dist/mcp/write/unified-diff.js

@@ -0,0 +1,19 @@
+export function unifiedFileDiff(relativePath, before, after) {
+    const a = before ?? '';
+    const b = after;
+    if (a === b) {
+        return '';
+    }
+    const header = `--- a/${relativePath}\n+++ b/${relativePath}\n`;
+    const al = a.split('\n');
+    const bl = b.split('\n');
+    if (before == null) {
+        return header + bl.map((l) => `+${l}`).join('\n') + (bl.length ? '\n' : '');
+    }
+    return (header +
+        `@@ -1,${al.length} +1,${bl.length} @@\n` +
+        al.map((l) => `-${l}`).join('\n') +
+        '\n' +
+        bl.map((l) => `+${l}`).join('\n') +
+        '\n');
+}

package/dist/mcp/write/validation-scaffold.d.ts

@@ -0,0 +1,2 @@
+export declare function injectValidationScaffold(content: string): string;
+//# sourceMappingURL=validation-scaffold.d.ts.map

package/dist/mcp/write/validation-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-scaffold.d.ts","sourceRoot":"","sources":["../../../src/mcp/write/validation-scaffold.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA4BhE"}

package/dist/mcp/write/validation-scaffold.js

@@ -0,0 +1,31 @@
+export function injectValidationScaffold(content) {
+    if (/validateBody\s*\(/.test(content)) {
+        return content;
+    }
+    let next = content;
+    const importStmt = 'import { validateBody } from "vitek-plugin/validation";\n';
+    if (!/from\s+["']vitek-plugin\/validation["']/.test(next)) {
+        const lines = next.split('\n');
+        let lastImport = -1;
+        for (let i = 0; i < lines.length; i++) {
+            if (/^\s*import\s/.test(lines[i]))
+                lastImport = i;
+        }
+        if (lastImport >= 0) {
+            lines.splice(lastImport + 1, 0, importStmt.trimEnd());
+            next = lines.join('\n');
+        }
+        else {
+            next = importStmt + next;
+        }
+    }
+    const asyncFn = /(export default async function handler\([^)]*\)\s*\{)/;
+    const syncFn = /(export default function handler\([^)]*\)\s*\{)/;
+    if (asyncFn.test(next)) {
+        return next.replace(asyncFn, `$1\n  validateBody(context.body, {});`);
+    }
+    if (syncFn.test(next)) {
+        return next.replace(syncFn, `$1\n  validateBody(context.body, {});`);
+    }
+    return next;
+}

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

@@ -0,0 +1,3 @@
+export declare const CONFIGURATION_URI = "vitek://docs/configuration";
+export declare const CONFIGURATION_CONTENT = "# Vitek \u2013 Configuration\n\nPass options to `vitek()` in Vite config.\n\n## Main options\n\n- `apiDir` (default 'src/api') \u2013 directory for route files\n- `srcDir` (default 'src') \u2013 for import rewriting\n- `apiBasePath` (default '/api') \u2013 URL prefix\n- `buildApi` (default true) \u2013 build API bundle for production; false = dev-only\n- `enableValidation` (default false) \u2013 automatic validation\n- `openApi` \u2013 true or object for OpenAPI/AsyncAPI docs\n- `sockets` \u2013 true (default), false, or { path: '/ws' }\n- `logging` \u2013 { level?, enableRequestLogging?, enableRouteLogging? }\n- `onGenerationError` \u2013 callback when type/OpenAPI generation fails\n- `plugins` \u2013 VitekPlugin[]\n- `alias` \u2013 resolve aliases (e.g. { '@lib': 'src/lib' })\n- `cors` \u2013 true or CorsOptions (origin, methods, allowedHeaders)\n- `trustProxy` \u2013 trust X-Forwarded-* (sets context.clientIp)\n- `onError` \u2013 (err, req, res) for non-HttpError\n- `maxBodySize` \u2013 max body bytes (413 when exceeded)\n\nProduction: export `onError`, `maxBodySize`, etc. from `dist/vitek.config.mjs` when using vitek-serve.\n";
+//# sourceMappingURL=configuration.d.ts.map

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

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

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

@@ -0,0 +1,25 @@
+export const CONFIGURATION_URI = 'vitek://docs/configuration';
+export const CONFIGURATION_CONTENT = `# Vitek – Configuration
+
+Pass options to \`vitek()\` in Vite config.
+
+## Main options
+
+- \`apiDir\` (default 'src/api') – directory for route files
+- \`srcDir\` (default 'src') – for import rewriting
+- \`apiBasePath\` (default '/api') – URL prefix
+- \`buildApi\` (default true) – build API bundle for production; false = dev-only
+- \`enableValidation\` (default false) – automatic validation
+- \`openApi\` – true or object for OpenAPI/AsyncAPI docs
+- \`sockets\` – true (default), false, or { path: '/ws' }
+- \`logging\` – { level?, enableRequestLogging?, enableRouteLogging? }
+- \`onGenerationError\` – callback when type/OpenAPI generation fails
+- \`plugins\` – VitekPlugin[]
+- \`alias\` – resolve aliases (e.g. { '@lib': 'src/lib' })
+- \`cors\` – true or CorsOptions (origin, methods, allowedHeaders)
+- \`trustProxy\` – trust X-Forwarded-* (sets context.clientIp)
+- \`onError\` – (err, req, res) for non-HttpError
+- \`maxBodySize\` – max body bytes (413 when exceeded)
+
+Production: export \`onError\`, \`maxBodySize\`, etc. from \`dist/vitek.config.mjs\` when using vitek-serve.
+`;

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

@@ -0,0 +1,3 @@
+export declare const CONTEXT_URI = "vitek://docs/context";
+export declare const CONTEXT_CONTENT = "# Vitek \u2013 Context and request\n\n## VitekContext\n\nHandlers receive a `VitekContext` with:\n\n- `url`: full request URL\n- `method`: HTTP method (lowercase)\n- `path`: path relative to API base (e.g. `/users/1`)\n- `query`: parsed query string (`Record<string, string | string[]>`)\n- `params`: route params (e.g. `{ id: \"1\" }` for `/users/[id]`)\n- `headers`: request headers (`Record<string, string>`)\n- `body`: parsed body (when applicable)\n- `clientIp`: client IP (when `trustProxy: true`)\n- `sockets`: `SocketEmitter` for broadcasting to WebSocket clients (when available)\n\n## VitekRequest\n\nMinimal request shape used internally: `url`, `method`, `headers`, `body?`.\n\n## Usage in handlers\n\n```typescript\nimport type { VitekContext } from \"vitek-plugin\";\n\nexport default async function handler(context: VitekContext) {\n  const { params, query, body, headers } = context;\n  const id = params.id;\n  const limit = query.limit ? Number(query.limit) : 10;\n  return { id, limit, body };\n}\n```\n";
+//# sourceMappingURL=context.d.ts.map

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

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

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

@@ -0,0 +1,34 @@
+export const CONTEXT_URI = 'vitek://docs/context';
+export const CONTEXT_CONTENT = `# Vitek – Context and request
+
+## VitekContext
+
+Handlers receive a \`VitekContext\` with:
+
+- \`url\`: full request URL
+- \`method\`: HTTP method (lowercase)
+- \`path\`: path relative to API base (e.g. \`/users/1\`)
+- \`query\`: parsed query string (\`Record<string, string | string[]>\`)
+- \`params\`: route params (e.g. \`{ id: "1" }\` for \`/users/[id]\`)
+- \`headers\`: request headers (\`Record<string, string>\`)
+- \`body\`: parsed body (when applicable)
+- \`clientIp\`: client IP (when \`trustProxy: true\`)
+- \`sockets\`: \`SocketEmitter\` for broadcasting to WebSocket clients (when available)
+
+## VitekRequest
+
+Minimal request shape used internally: \`url\`, \`method\`, \`headers\`, \`body?\`.
+
+## Usage in handlers
+
+\`\`\`typescript
+import type { VitekContext } from "vitek-plugin";
+
+export default async function handler(context: VitekContext) {
+  const { params, query, body, headers } = context;
+  const id = params.id;
+  const limit = query.limit ? Number(query.limit) : 10;
+  return { id, limit, body };
+}
+\`\`\`
+`;

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

@@ -0,0 +1,3 @@
+export declare const ERRORS_URI = "vitek://docs/errors";
+export declare const ERRORS_CONTENT = "# Vitek \u2013 Error handling\n\nHTTP error classes map to status codes and JSON error response.\n\n## Error classes (from vitek-plugin)\n\n- BadRequestError \u2192 400\n- UnauthorizedError \u2192 401\n- ForbiddenError \u2192 403\n- NotFoundError \u2192 404\n- ConflictError \u2192 409\n- ValidationError \u2192 422 (supports field errors object: { email: [\"Invalid\"], age: [\"Must be 18+\"] })\n- TooManyRequestsError \u2192 429\n- InternalServerError \u2192 500\n\n```typescript\nimport { NotFoundError, ValidationError } from \"vitek-plugin\";\n\nif (!resource) throw new NotFoundError(\"Resource not found\");\nthrow new ValidationError(\"Invalid\", { email: [\"Invalid format\"] });\n```\n\n## onError (non-HttpError)\n\nFor uncaught exceptions or non-HttpError, set `onError(err, req, res)` in plugin options. Send response and call `res.end()`; otherwise default 500 JSON is sent. In production with vitek-serve, export `onError` from `dist/vitek.config.mjs`.\n";
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mcp-docs-server/resources/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAEhD,eAAO,MAAM,cAAc,+8BAyB1B,CAAC"}

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

@@ -0,0 +1,27 @@
+export const ERRORS_URI = 'vitek://docs/errors';
+export const ERRORS_CONTENT = `# Vitek – Error handling
+
+HTTP error classes map to status codes and JSON error response.
+
+## Error classes (from vitek-plugin)
+
+- BadRequestError → 400
+- UnauthorizedError → 401
+- ForbiddenError → 403
+- NotFoundError → 404
+- ConflictError → 409
+- ValidationError → 422 (supports field errors object: { email: ["Invalid"], age: ["Must be 18+"] })
+- TooManyRequestsError → 429
+- InternalServerError → 500
+
+\`\`\`typescript
+import { NotFoundError, ValidationError } from "vitek-plugin";
+
+if (!resource) throw new NotFoundError("Resource not found");
+throw new ValidationError("Invalid", { email: ["Invalid format"] });
+\`\`\`
+
+## onError (non-HttpError)
+
+For uncaught exceptions or non-HttpError, set \`onError(err, req, res)\` in plugin options. Send response and call \`res.end()\`; otherwise default 500 JSON is sent. In production with vitek-serve, export \`onError\` from \`dist/vitek.config.mjs\`.
+`;

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

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