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

package/dist/plugin.js

@@ -1,249 +1,5 @@
 /**
  * Main Vite plugin
- * Thin layer that registers the plugin and connects with adapters
+ * Exports VitekOptions and vitek() — aggregates sub-plugins
  */
-import * as path from 'path';
-import * as fs from 'fs';
-import { pathToFileURL, fileURLToPath } from 'url';
-import { createViteDevServerMiddleware } from './adapters/vite/dev-server.js';
-import { createViteLogger } from './adapters/vite/logger.js';
-import { createRequestHandler } from './core/server/request-handler.js';
-import { buildApiBundle, getApiBundleFilename } from './build/build-api-bundle.js';
-import { buildSocketsBundle, getSocketsBundleFilename } from './build/build-sockets-bundle.js';
-import { createSocketHandler } from './core/socket/socket-handler.js';
-import { API_BASE_PATH, API_DIR_NAME, getSocketBasePath } from './shared/constants.js';
-/**
- * Vite plugin for Vitek
- */
-export function vitek(options = {}) {
-    const apiDirOption = options.apiDir || `src/${API_DIR_NAME}`;
-    const buildApi = options.buildApi !== false;
-    let root;
-    let buildOutDir;
-    let cleanupFn = null;
-    return {
-        name: 'vitek',
-        enforce: 'pre',
-        configResolved(config) {
-            root = config.root;
-            buildOutDir = path.resolve(root, config.build?.outDir ?? 'dist');
-        },
-        resolveId(id, importer) {
-            if (!id.startsWith('.') || !importer)
-                return null;
-            const fullApiDir = path.resolve(root, apiDirOption);
-            let importerPath;
-            if (importer.startsWith('file:')) {
-                importerPath = fileURLToPath(importer);
-            }
-            else if (importer.startsWith('/')) {
-                const virtualPath = path.join(root, importer.replace(/^\//, ''));
-                importerPath = fs.existsSync(virtualPath) ? virtualPath : path.resolve(importer);
-            }
-            else {
-                importerPath = path.resolve(importer);
-            }
-            const normalizedApiDir = path.resolve(fullApiDir);
-            const normalizedImporter = path.resolve(importerPath);
-            if (!normalizedImporter.startsWith(normalizedApiDir))
-                return null;
-            let resolved = path.resolve(path.dirname(normalizedImporter), id);
-            if (!fs.existsSync(resolved)) {
-                const ext = ['.ts', '.tsx', '.mts', '.js', '.jsx', '.mjs'].find((e) => fs.existsSync(resolved + e));
-                if (ext)
-                    resolved += ext;
-            }
-            return fs.existsSync(resolved) ? pathToFileURL(resolved).href : null;
-        },
-        transform(code, id) {
-            const idPath = id.startsWith('file:') ? fileURLToPath(id) : id;
-            const srcDir = path.resolve(root, 'src');
-            const virtualCandidate = idPath.startsWith('/') ? path.join(root, idPath.replace(/^\//, '')) : null;
-            const normalizedId = virtualCandidate != null && fs.existsSync(virtualCandidate)
-                ? virtualCandidate
-                : path.resolve(idPath);
-            if (!normalizedId.startsWith(srcDir))
-                return null;
-            const dir = path.dirname(normalizedId);
-            const rootSlash = path.resolve(root) + path.sep;
-            const rewritten = code.replace(/from\s+['"](\.\.?[^'"]+)['"]/g, (match, specifier) => {
-                const resolved = path.resolve(dir, specifier);
-                if (!resolved.startsWith(rootSlash))
-                    return match;
-                let target = resolved;
-                if (!fs.existsSync(target)) {
-                    const ext = ['.ts', '.tsx', '.mts', '.js', '.jsx', '.mjs'].find((e) => fs.existsSync(target + e));
-                    if (ext)
-                        target += ext;
-                }
-                if (!fs.existsSync(target))
-                    return match;
-                const rootRelative = path.relative(root, target).replace(/\\/g, '/');
-                const newSpecifier = `/${rootRelative}`;
-                const quote = match.includes('"') ? '"' : "'";
-                return `from ${quote}${newSpecifier}${quote}`;
-            });
-            return rewritten !== code ? { code: rewritten, map: null } : null;
-        },
-        async configureServer(server) {
-            const fullApiDir = path.resolve(root, apiDirOption);
-            if (!fs.existsSync(fullApiDir)) {
-                server.config.logger.warn(`[vitek] API directory not found: ${fullApiDir}`);
-                return;
-            }
-            const logger = createViteLogger(server.config.logger, options.logging);
-            const socketsEnabled = options.sockets !== false;
-            const socketBasePath = getSocketBasePath(options.apiBasePath, typeof options.sockets === 'object' ? options.sockets?.path : undefined);
-            const { ready, middleware, cleanup, setupSockets } = createViteDevServerMiddleware({
-                root,
-                apiDir: fullApiDir,
-                logger,
-                viteServer: server,
-                enableValidation: options.enableValidation || false,
-                openApi: options.openApi,
-                sockets: socketsEnabled,
-                socketBasePath,
-            });
-            cleanupFn = cleanup;
-            server.middlewares.use(middleware);
-            await ready;
-            if (socketsEnabled && server.httpServer) {
-                setupSockets(server.httpServer);
-            }
-            logger.info('Vitek plugin initialized');
-            const port = server.config.server?.port ?? 5173;
-            const apiPath = options.apiBasePath ?? API_BASE_PATH;
-            const originalPrintUrls = server.printUrls?.bind(server);
-            if (typeof originalPrintUrls === 'function') {
-                server.printUrls = () => {
-                    originalPrintUrls();
-                    const host = 'localhost';
-                    const apiUrl = `http://${host}:${port}${apiPath}`;
-                    server.config.logger.info(`  ➜  API:     ${apiUrl}`);
-                    if (socketsEnabled) {
-                        const wsUrl = `ws://${host}:${port}${socketBasePath}`;
-                        server.config.logger.info(`  ➜  WS:      ${wsUrl}`);
-                    }
-                };
-            }
-        },
-        async configurePreviewServer(server) {
-            if (!buildApi) {
-                return;
-            }
-            const bundlePath = path.join(buildOutDir, getApiBundleFilename());
-            if (!fs.existsSync(bundlePath)) {
-                server.config.logger.warn('[vitek] API bundle not found; preview serving static assets only. Run `vite build` first.');
-                return;
-            }
-            const previewPort = server.config.preview?.port ?? 4173;
-            const apiBaseUrl = `http://127.0.0.1:${previewPort}${API_BASE_PATH}`;
-            const api = {
-                async fetch(path, fetchOptions) {
-                    const url = `${apiBaseUrl}/${path.replace(/^\//, '')}`;
-                    const res = await fetch(url, {
-                        method: fetchOptions?.method ?? 'GET',
-                        headers: fetchOptions?.body !== undefined
-                            ? { 'Content-Type': 'application/json' }
-                            : undefined,
-                        body: fetchOptions?.body !== undefined
-                            ? JSON.stringify(fetchOptions.body)
-                            : undefined,
-                    });
-                    const text = await res.text();
-                    if (!text)
-                        return undefined;
-                    try {
-                        return JSON.parse(text);
-                    }
-                    catch {
-                        return text;
-                    }
-                },
-            };
-            const noopSockets = { emit() { } };
-            const shared = { sockets: noopSockets, api };
-            const bundleUrl = pathToFileURL(bundlePath).href;
-            const bundleLoadPromise = import(bundleUrl);
-            let apiHandler = null;
-            const apiMiddleware = (req, res, next) => {
-                const pathname = req.url?.split('?')[0] ?? '';
-                if (pathname !== API_BASE_PATH && !pathname.startsWith(API_BASE_PATH + '/')) {
-                    return next();
-                }
-                bundleLoadPromise
-                    .then((mod) => {
-                    if (!apiHandler) {
-                        apiHandler = createRequestHandler({
-                            routes: mod.routes,
-                            middlewares: mod.middlewares,
-                            shared,
-                        });
-                        server.config.logger.info('[vitek] API middleware registered for preview');
-                    }
-                    apiHandler(req, res, next);
-                })
-                    .catch((err) => {
-                    server.config.logger.error(`[vitek] Failed to load API bundle: ${err instanceof Error ? err.message : String(err)}`);
-                    res.statusCode = 500;
-                    res.setHeader('Content-Type', 'application/json');
-                    res.end(JSON.stringify({ error: 'Internal server error', message: 'Failed to load API bundle' }));
-                });
-            };
-            server.middlewares.use(apiMiddleware);
-            const socketsEnabled = options.sockets !== false;
-            const socketBasePath = getSocketBasePath(options.apiBasePath, typeof options.sockets === 'object' ? options.sockets?.path : undefined);
-            const socketsBundlePath = path.join(buildOutDir, getSocketsBundleFilename());
-            if (socketsEnabled && fs.existsSync(socketsBundlePath)) {
-                try {
-                    const socketsUrl = pathToFileURL(socketsBundlePath).href;
-                    const mod = await import(socketsUrl);
-                    const handler = createSocketHandler({
-                        sockets: mod.sockets,
-                        socketBasePath,
-                        shared,
-                    });
-                    server.httpServer?.on('upgrade', handler);
-                    server.config.logger.info('[vitek] WebSocket sockets registered for preview');
-                }
-                catch (err) {
-                    server.config.logger.warn(`[vitek] Failed to load sockets bundle: ${err instanceof Error ? err.message : String(err)}`);
-                }
-            }
-        },
-        async closeBundle() {
-            if (buildApi) {
-                const fullApiDir = path.resolve(root, apiDirOption);
-                try {
-                    await buildApiBundle({
-                        root,
-                        apiDir: fullApiDir,
-                        outDir: buildOutDir,
-                    });
-                }
-                catch (err) {
-                    console.error('[vitek] Failed to build API bundle:', err instanceof Error ? err.message : err);
-                }
-                const socketsEnabled = options.sockets !== false;
-                if (socketsEnabled && fs.existsSync(fullApiDir)) {
-                    try {
-                        await buildSocketsBundle({
-                            root,
-                            apiDir: fullApiDir,
-                            outDir: buildOutDir,
-                        });
-                    }
-                    catch (err) {
-                        console.error('[vitek] Failed to build sockets bundle:', err instanceof Error ? err.message : err);
-                    }
-                }
-            }
-        },
-        buildEnd() {
-            if (cleanupFn) {
-                cleanupFn();
-                cleanupFn = null;
-            }
-        },
-    };
-}
+export { vitek } from './plugin/vitek.js';

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,44 +140,114 @@ 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 on respective plugins', () => {
+            expect(resolvePlugin.resolveId).toBeDefined();
+            expect(transformPlugin.transform).toBeDefined();
         });
-        it('exposes resolveId and transform', () => {
-            expect(plugin.resolveId).toBeDefined();
-            expect(plugin.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 = buildPlugin.buildStart;
+            if (!buildStart) {
+                expect.fail('Plugin does not have buildStart hook');
+            }
+            await buildStart.call(null);
+            const servicesPath = path.join(rootDir, 'src', 'api.services.ts');
+            const typesPath = path.join(rootDir, 'src', 'api.types.ts');
+            expect(fs.existsSync(servicesPath)).toBe(true);
+            expect(fs.existsSync(typesPath)).toBe(true);
+            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' };
+}