vitek-plugin 0.1.2-beta.6 → 0.2.0-beta

package/dist/plugin.test.js

@@ -3,7 +3,12 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { pathToFileURL } from 'url';
 import { vitek } from './plugin.js';
+function findPlugin(plugins, name) {
+    return plugins.find((p) => p.name === name);
+}
 function callResolveId(plugin, id, importer) {
+    if (!plugin)
+        return null;
     const hook = plugin.resolveId;
     if (!hook)
         return null;
@@ -12,6 +17,8 @@ function callResolveId(plugin, id, importer) {
     return fn.call(null, id, importer, { attributes: {}, isEntry: false });
 }
 function callTransform(plugin, code, id) {
+    if (!plugin)
+        return null;
     const hook = plugin.transform;
     if (!hook)
         return null;
@@ -20,9 +27,13 @@ function callTransform(plugin, code, id) {
     return fn.call(null, code, id);
 }
 describe('vitek plugin resolveId and transform', () => {
-    let plugin;
+    let plugins;
     let rootDir;
     let apiDir;
+    let configPlugin;
+    let resolvePlugin;
+    let transformPlugin;
+    let buildPlugin;
     beforeEach(() => {
         rootDir = fs.mkdtempSync(path.join(process.cwd(), 'vitek-plugin-test-'));
         apiDir = path.join(rootDir, 'src', 'api');
@@ -32,11 +43,16 @@ describe('vitek plugin resolveId and transform', () => {
         fs.writeFileSync(path.join(rootDir, 'src', 'lib', 'greeting.ts'), "export function getGreeting() { return 'hi'; }\n", 'utf-8');
         fs.mkdirSync(path.join(rootDir, 'src', 'api', 'nested'), { recursive: true });
         fs.writeFileSync(path.join(rootDir, 'src', 'api', 'nested', 'deep.get.ts'), "import { getGreeting } from '../../lib/greeting';\nexport default function handler() { return {}; }\n", 'utf-8');
-        plugin = vitek({ apiDir: path.join('src', 'api') });
-        plugin.configResolved?.({
-            root: rootDir,
-            build: { outDir: 'dist' },
-        });
+        plugins = vitek({ apiDir: path.join('src', 'api') });
+        configPlugin = findPlugin(plugins, 'vitek:build');
+        resolvePlugin = findPlugin(plugins, 'vitek:resolve');
+        transformPlugin = findPlugin(plugins, 'vitek:transform');
+        buildPlugin = findPlugin(plugins, 'vitek:build');
+        const configResolvedHook = configPlugin.configResolved;
+        if (configResolvedHook) {
+            const fn = typeof configResolvedHook === 'function' ? configResolvedHook : configResolvedHook.handler;
+            fn.call(null, { root: rootDir, build: { outDir: 'dist' } });
+        }
     });
     afterEach(() => {
         try {
@@ -49,19 +65,19 @@ describe('vitek plugin resolveId and transform', () => {
     describe('resolveId', () => {
         it('returns null when id does not start with .', () => {
             const importer = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            expect(callResolveId(plugin, 'vue', importer)).toBeNull();
-            expect(callResolveId(plugin, '/absolute', importer)).toBeNull();
+            expect(callResolveId(resolvePlugin, 'vue', importer)).toBeNull();
+            expect(callResolveId(resolvePlugin, '/absolute', importer)).toBeNull();
         });
         it('returns null when importer is undefined', () => {
-            expect(callResolveId(plugin, '../lib/greeting', undefined)).toBeNull();
+            expect(callResolveId(resolvePlugin, '../lib/greeting', undefined)).toBeNull();
         });
         it('returns null when importer is outside apiDir', () => {
             const importerOutside = pathToFileURL(path.join(rootDir, 'src', 'main.ts')).href;
-            expect(callResolveId(plugin, '../lib/greeting', importerOutside)).toBeNull();
+            expect(callResolveId(resolvePlugin, '../lib/greeting', importerOutside)).toBeNull();
         });
         it('resolves relative import from api file to existing file and returns file URL', () => {
             const importer = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callResolveId(plugin, '../lib/greeting', importer);
+            const result = callResolveId(resolvePlugin, '../lib/greeting', importer);
             expect(result).not.toBeNull();
             expect(typeof result).toBe('string');
             expect(result).toContain('greeting');
@@ -69,19 +85,19 @@ describe('vitek plugin resolveId and transform', () => {
         });
         it('resolves with extension fallback when target has no extension', () => {
             const importer = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callResolveId(plugin, '../lib/greeting', importer);
+            const result = callResolveId(resolvePlugin, '../lib/greeting', importer);
             expect(result).not.toBeNull();
             const filePath = result.replace(/^file:\/\//, '').replace(/%2F/g, '/').replace(/%3A/g, ':');
             expect(fs.existsSync(filePath) || fs.existsSync(filePath + '.ts')).toBe(true);
         });
         it('returns null when relative target does not exist', () => {
             const importer = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            expect(callResolveId(plugin, '../lib/nonexistent', importer)).toBeNull();
+            expect(callResolveId(resolvePlugin, '../lib/nonexistent', importer)).toBeNull();
         });
         it('resolves nested api file relative import', () => {
             const nestedDir = path.join(apiDir, 'nested');
             const importer = pathToFileURL(path.join(nestedDir, 'deep.get.ts')).href;
-            const result = callResolveId(plugin, '../../lib/greeting', importer);
+            const result = callResolveId(resolvePlugin, '../../lib/greeting', importer);
             expect(result).not.toBeNull();
             expect(result).toContain('greeting');
         });
@@ -91,14 +107,14 @@ describe('vitek plugin resolveId and transform', () => {
             const code = "import x from '../lib/greeting';";
             fs.mkdirSync(path.join(rootDir, 'other'), { recursive: true });
             const idOutside = pathToFileURL(path.join(rootDir, 'other', 'main.ts')).href;
-            const result = callTransform(plugin, code, idOutside);
+            const result = callTransform(transformPlugin, code, idOutside);
             expect(result).toBeNull();
         });
         it('rewrites relative import when id is under src/lib (not only api)', () => {
             fs.writeFileSync(path.join(rootDir, 'src', 'lib', 'executor.ts'), "import { getGreeting } from './greeting';\nexport function run() { return getGreeting(); }\n", 'utf-8');
             const code = "import { getGreeting } from './greeting';\nexport function run() { return getGreeting(); }\n";
             const id = pathToFileURL(path.join(rootDir, 'src', 'lib', 'executor.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).not.toBeNull();
             expect(result.code).toContain("/src/lib/greeting");
             expect(result.code).not.toContain("from './greeting'");
@@ -109,14 +125,14 @@ describe('vitek plugin resolveId and transform', () => {
             fs.writeFileSync(path.join(rootDir, 'src', 'lib', 'nested', 'index.ts'), "export { getMessage } from './helper';\n", 'utf-8');
             const code = "export { getMessage } from './helper';\n";
             const id = pathToFileURL(path.join(rootDir, 'src', 'lib', 'nested', 'index.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).not.toBeNull();
             expect(result.code).toContain("/src/lib/nested/helper");
         });
         it('rewrites relative import to root-relative path when id is under apiDir', () => {
             const code = "import { getGreeting } from '../lib/greeting';\nexport default function handler() {}";
             const id = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).not.toBeNull();
             expect(result.code).toContain("/src/lib/greeting");
             expect(result.code).not.toContain("from '../lib/greeting'");
@@ -124,50 +140,52 @@ describe('vitek plugin resolveId and transform', () => {
         it('preserves double quotes when original uses double quotes', () => {
             const code = 'import { getGreeting } from "../lib/greeting";';
             const id = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).not.toBeNull();
             expect(result.code).toContain('/src/lib/greeting');
         });
         it('returns null when code has no relative imports', () => {
             const code = "import vue from 'vue';\nexport default {}";
             const id = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).toBeNull();
         });
         it('rewrites nested relative import (../../lib)', () => {
             const code = "import { getGreeting } from '../../lib/greeting';";
             const nestedPath = path.join(apiDir, 'nested', 'deep.get.ts');
             const id = pathToFileURL(nestedPath).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).not.toBeNull();
             expect(result.code).toContain("/src/lib/greeting");
         });
         it('does not rewrite import when resolved target is outside root', () => {
             const code = "import x from '../../../etc/passwd';";
             const id = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).toBeNull();
         });
         it('returns null when relative target file does not exist', () => {
             const code = "import x from '../lib/nonexistent';";
             const id = pathToFileURL(path.join(apiDir, 'health.get.ts')).href;
-            const result = callTransform(plugin, code, id);
+            const result = callTransform(transformPlugin, code, id);
             expect(result).toBeNull();
         });
     });
     describe('plugin shape', () => {
-        it('has enforce pre', () => {
-            expect(plugin.enforce).toBe('pre');
+        it('returns array of sub-plugins with enforce pre for resolve/transform/build', () => {
+            expect(resolvePlugin.enforce).toBe('pre');
+            expect(transformPlugin.enforce).toBe('pre');
+            expect(buildPlugin.enforce).toBe('pre');
         });
-        it('exposes resolveId and transform', () => {
-            expect(plugin.resolveId).toBeDefined();
-            expect(plugin.transform).toBeDefined();
+        it('exposes resolveId and transform on respective plugins', () => {
+            expect(resolvePlugin.resolveId).toBeDefined();
+            expect(transformPlugin.transform).toBeDefined();
         });
     });
     describe('buildStart', () => {
         it('generates api.services.ts and api.types.ts when buildStart runs', async () => {
             fs.writeFileSync(path.join(rootDir, 'tsconfig.json'), '{}', 'utf-8');
-            const buildStart = plugin.buildStart;
+            const buildStart = buildPlugin.buildStart;
             if (!buildStart) {
                 expect.fail('Plugin does not have buildStart hook');
             }
@@ -179,5 +197,57 @@ describe('vitek plugin resolveId and transform', () => {
             expect(fs.readFileSync(servicesPath, 'utf-8')).toContain('getHealth');
             expect(fs.readFileSync(typesPath, 'utf-8')).toContain('VitekParams');
         });
+        it('skips type generation and API bundle when buildApi is false', async () => {
+            fs.writeFileSync(path.join(rootDir, 'tsconfig.json'), '{}', 'utf-8');
+            const noApiPlugins = vitek({ apiDir: path.join('src', 'api'), buildApi: false });
+            const noApiBuild = findPlugin(noApiPlugins, 'vitek:build');
+            const configResolved = noApiBuild.configResolved;
+            if (configResolved) {
+                const fn = typeof configResolved === 'function' ? configResolved : configResolved.handler;
+                fn.call(null, { root: rootDir, build: { outDir: 'dist' } });
+            }
+            const buildStart = noApiBuild.buildStart;
+            const closeBundle = noApiBuild.closeBundle;
+            if (buildStart)
+                await buildStart.call(null);
+            fs.mkdirSync(path.join(rootDir, 'dist'), { recursive: true });
+            if (closeBundle)
+                await closeBundle.call(null);
+            expect(fs.existsSync(path.join(rootDir, 'src', 'api.types.ts'))).toBe(false);
+            expect(fs.existsSync(path.join(rootDir, 'src', 'api.services.ts'))).toBe(false);
+            expect(fs.existsSync(path.join(rootDir, 'dist', 'vitek-api.mjs'))).toBe(false);
+        });
+    });
+    describe('srcDir option', () => {
+        it('transform respects srcDir when custom srcDir is set', () => {
+            fs.mkdirSync(path.join(rootDir, 'lib', 'shared'), { recursive: true });
+            fs.writeFileSync(path.join(rootDir, 'lib', 'shared', 'helper.ts'), "export function help() { return 'ok'; }\n", 'utf-8');
+            fs.writeFileSync(path.join(rootDir, 'lib', 'entry.ts'), "import { help } from './shared/helper';\nexport default help;\n", 'utf-8');
+            const customPlugins = vitek({ apiDir: path.join('src', 'api'), srcDir: 'lib' });
+            const customTransform = findPlugin(customPlugins, 'vitek:transform');
+            const customBuild = findPlugin(customPlugins, 'vitek:build');
+            const configResolved = customBuild.configResolved;
+            if (configResolved) {
+                const fn = typeof configResolved === 'function' ? configResolved : configResolved.handler;
+                fn.call(null, { root: rootDir, build: { outDir: 'dist' } });
+            }
+            const code = "import { help } from './shared/helper';\nexport default help;\n";
+            const id = pathToFileURL(path.join(rootDir, 'lib', 'entry.ts')).href;
+            const result = callTransform(customTransform, code, id);
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('/lib/shared/helper');
+        });
+    });
+});
+describe('vitek plugin options (cors, trustProxy, onError)', () => {
+    it('accepts cors and trustProxy and returns plugins', () => {
+        const plugins = vitek({ apiDir: 'src/api', cors: true, trustProxy: true });
+        expect(plugins.length).toBeGreaterThan(0);
+        expect(findPlugin(plugins, 'vitek:dev')).toBeDefined();
+    });
+    it('accepts onError option', () => {
+        const onError = () => { };
+        const plugins = vitek({ apiDir: 'src/api', onError });
+        expect(plugins.length).toBeGreaterThan(0);
     });
 });

package/dist/shared/response-helpers.d.ts

@@ -58,4 +58,25 @@ export declare function internalServerError(body?: any, headers?: Record<string,
  * Creates a redirect response (301, 302, 307, 308)
  */
 export declare function redirect(url: string, permanent?: boolean, preserveMethod?: boolean): VitekResponse;
+/**
+ * Creates a plain text response (Content-Type: text/plain).
+ */
+export declare function text(body: string, status?: number): VitekResponse;
+/**
+ * Creates an HTML response (Content-Type: text/html).
+ */
+export declare function html(body: string, status?: number): VitekResponse;
+/**
+ * Cache-Control header helpers. Merge returned headers into your response, e.g.:
+ * `{ ...ok(body), headers: { ...ok(body).headers, ...cacheControl(60) } }`
+ */
+export declare function cacheControl(maxAgeSeconds: number, options?: {
+    staleWhileRevalidate?: number;
+    private?: boolean;
+}): Record<string, string>;
+/**
+ * Returns headers to disable caching. Merge into response headers, e.g.:
+ * `{ ...ok(body), headers: { ...ok(body).headers, ...noStore() } }`
+ */
+export declare function noStore(): Record<string, string>;
 //# sourceMappingURL=response-helpers.d.ts.map

package/dist/shared/response-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../src/shared/response-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;GAEG;AACH,wBAAgB,IAAI,CAClB,IAAI,EAAE,GAAG,EACT,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAClE,aAAa,CASf;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAE7E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAElF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAMzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,GAA8B,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAEhH;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,GAA+B,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAEnH;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,GAA4B,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAE7G;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,GAAE,GAA4B,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAE5G;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,GAAE,GAA2B,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAE3G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,GAAmC,EACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,GAAoC,EAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,GAAwC,EAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,OAAe,EAC1B,cAAc,GAAE,OAAe,GAC9B,aAAa,CASf"}
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../src/shared/response-helpers.ts"],"names":[],"mappings":"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"}

package/dist/shared/response-helpers.js

@@ -98,3 +98,44 @@ export function redirect(url, permanent = false, preserveMethod = false) {
         body: undefined,
     };
 }
+/**
+ * Creates a plain text response (Content-Type: text/plain).
+ */
+export function text(body, status = 200) {
+    return {
+        status,
+        headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+        body,
+    };
+}
+/**
+ * Creates an HTML response (Content-Type: text/html).
+ */
+export function html(body, status = 200) {
+    return {
+        status,
+        headers: { 'Content-Type': 'text/html; charset=utf-8' },
+        body,
+    };
+}
+/**
+ * Cache-Control header helpers. Merge returned headers into your response, e.g.:
+ * `{ ...ok(body), headers: { ...ok(body).headers, ...cacheControl(60) } }`
+ */
+export function cacheControl(maxAgeSeconds, options) {
+    const parts = [`max-age=${maxAgeSeconds}`];
+    if (options?.staleWhileRevalidate != null) {
+        parts.push(`stale-while-revalidate=${options.staleWhileRevalidate}`);
+    }
+    if (options?.private === true) {
+        parts.push('private');
+    }
+    return { 'Cache-Control': parts.join(', ') };
+}
+/**
+ * Returns headers to disable caching. Merge into response headers, e.g.:
+ * `{ ...ok(body), headers: { ...ok(body).headers, ...noStore() } }`
+ */
+export function noStore() {
+    return { 'Cache-Control': 'no-store' };
+}

package/dist/shared/response-helpers.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { json, ok, created, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, redirect, } from './response-helpers.js';
+import { json, ok, created, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, redirect, text, html, cacheControl, noStore, } from './response-helpers.js';
 describe('json', () => {
     it('should create JSON response with default status 200', () => {
         const response = json({ message: 'Hello' });
@@ -165,3 +165,56 @@ describe('redirect', () => {
         expect(response.status).toBe(308);
     });
 });
+describe('text', () => {
+    it('creates 200 response with text/plain', () => {
+        const response = text('Hello world');
+        expect(response.status).toBe(200);
+        expect(response.headers).toEqual({ 'Content-Type': 'text/plain; charset=utf-8' });
+        expect(response.body).toBe('Hello world');
+    });
+    it('accepts custom status', () => {
+        const response = text('Error', 503);
+        expect(response.status).toBe(503);
+        expect(response.body).toBe('Error');
+    });
+});
+describe('html', () => {
+    it('creates 200 response with text/html', () => {
+        const response = html('<p>Hi</p>');
+        expect(response.status).toBe(200);
+        expect(response.headers).toEqual({ 'Content-Type': 'text/html; charset=utf-8' });
+        expect(response.body).toBe('<p>Hi</p>');
+    });
+    it('accepts custom status', () => {
+        const response = html('<h1>Not Found</h1>', 404);
+        expect(response.status).toBe(404);
+    });
+});
+describe('cacheControl', () => {
+    it('returns Cache-Control max-age only', () => {
+        const headers = cacheControl(60);
+        expect(headers).toEqual({ 'Cache-Control': 'max-age=60' });
+    });
+    it('includes stale-while-revalidate when provided', () => {
+        const headers = cacheControl(60, { staleWhileRevalidate: 120 });
+        expect(headers['Cache-Control']).toContain('max-age=60');
+        expect(headers['Cache-Control']).toContain('stale-while-revalidate=120');
+    });
+    it('includes private when set', () => {
+        const headers = cacheControl(300, { private: true });
+        expect(headers['Cache-Control']).toContain('max-age=300');
+        expect(headers['Cache-Control']).toContain('private');
+    });
+    it('combines all options', () => {
+        const headers = cacheControl(60, { staleWhileRevalidate: 120, private: true });
+        expect(headers['Cache-Control']).toContain('max-age=60');
+        expect(headers['Cache-Control']).toContain('stale-while-revalidate=120');
+        expect(headers['Cache-Control']).toContain('private');
+    });
+});
+describe('noStore', () => {
+    it('returns Cache-Control no-store', () => {
+        const headers = noStore();
+        expect(headers).toEqual({ 'Cache-Control': 'no-store' });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitek-plugin",
-  "version": "0.1.2-beta.6",
+  "version": "0.2.0-beta",
   "description": "Vite plugin for file-based HTTP API generation",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,27 +32,34 @@
     "url": "https://github.com/martinsbicudo/vitek-plugin/issues"
   },
   "peerDependencies": {
-    "vite": "^5.0.0"
+    "vite": "^5.0.0 || ^6.0.0"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
     "connect": "^3.7.0",
+    "zod": "^3.23.0",
     "esbuild": "^0.24.0",
+    "magic-string": "^0.30.0",
     "serve-static": "^1.16.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@commitlint/cli": "^20.4.2",
+    "@commitlint/config-conventional": "^20.4.2",
     "@types/connect": "^3.4.0",
     "@types/node": "^20.0.0",
     "@types/serve-static": "^1.15.0",
     "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.0.18",
     "concurrently": "^9.0.0",
+    "husky": "^9.1.7",
     "typescript": "^5.0.0",
-    "vite": "^5.0.0",
+    "vite": "^5.0.0 || ^6.0.0",
     "vitepress": "^1.0.0",
     "vitest": "^4.0.18"
   },
   "bin": {
+    "vitek": "./dist/cli/cli.js",
     "vitek-serve": "./dist/cli/serve.js"
   },
   "scripts": {
@@ -64,6 +71,14 @@
     "docs:preview": "vitepress preview docs",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "node scripts/e2e.mjs",
+    "test:e2e:socket": "node scripts/e2e-socket.mjs",
+    "bench": "node scripts/bench.mjs",
+    "example:bench": "node scripts/bench.mjs --with-example",
+    "examples:build": "bash examples/build-all.sh",
+    "examples:test": "bash examples/run-all-tests.sh",
+    "examples:build-and-test": "bash examples/build-and-test.sh",
+    "check": "pnpm i && pnpm run build && pnpm test && pnpm run examples:build-and-test && pnpm run test:e2e && pnpm run test:e2e:socket && pnpm run example:bench"
   }
 }