vitek-plugin 0.1.0-beta → 0.1.2-beta

package/dist/core/server/request-handler.js

@@ -0,0 +1,143 @@
+/**
+ * Shared request handler for API routes
+ * Used by both dev server and preview/production server
+ */
+import { matchRoute } from '../routing/route-matcher.js';
+import { createContext, isVitekResponse } from '../context/create-context.js';
+import { getApplicableMiddlewares } from '../middleware/get-applicable-middlewares.js';
+import { compose } from '../middleware/compose.js';
+import { API_BASE_PATH } from '../../shared/constants.js';
+import { HttpError } from '../../shared/errors.js';
+const noop = () => { };
+/**
+ * Creates a Connect-style middleware that handles /api/* requests using the given routes and middlewares.
+ */
+export function createRequestHandler(options) {
+    const { routes, middlewares, logger } = options;
+    const logRouteMatched = logger?.routeMatched ?? noop;
+    const logRequest = logger?.request ?? noop;
+    const logWarn = logger?.warn ?? noop;
+    const logError = logger?.error ?? noop;
+    return async (req, res, next) => {
+        if (!req.url?.startsWith(API_BASE_PATH)) {
+            return next();
+        }
+        const startTime = Date.now();
+        const requestMethod = req.method?.toLowerCase() || 'get';
+        const requestPath = req.url.split('?')[0];
+        try {
+            const url = new URL(req.url, `http://${req.headers.host || 'localhost'}`);
+            const routePath = url.pathname.replace(API_BASE_PATH, '') || '/';
+            const method = requestMethod;
+            const match = matchRoute(routes, routePath, method);
+            if (!match) {
+                const duration = Date.now() - startTime;
+                res.statusCode = 404;
+                res.setHeader('Content-Type', 'application/json');
+                res.end(JSON.stringify({ error: 'Route not found' }));
+                logRequest(requestMethod, requestPath, 404, duration);
+                return;
+            }
+            logRouteMatched(match.route.pattern, method);
+            const query = {};
+            url.searchParams.forEach((value, key) => {
+                if (query[key]) {
+                    const existing = query[key];
+                    query[key] = Array.isArray(existing) ? [...existing, value] : [existing, value];
+                }
+                else {
+                    query[key] = value;
+                }
+            });
+            let body;
+            if (['post', 'put', 'patch'].includes(method)) {
+                body = await new Promise((resolve) => {
+                    const chunks = [];
+                    req.on('data', (chunk) => chunks.push(chunk));
+                    req.on('end', () => {
+                        const rawBody = Buffer.concat(chunks).toString();
+                        if (!rawBody) {
+                            resolve(undefined);
+                            return;
+                        }
+                        try {
+                            resolve(JSON.parse(rawBody));
+                        }
+                        catch {
+                            resolve(rawBody);
+                        }
+                    });
+                });
+            }
+            const context = createContext({
+                url: req.url,
+                method,
+                headers: (req.headers || {}),
+                body,
+            }, match.params, query);
+            const applicableMiddlewares = getApplicableMiddlewares(middlewares, match.route.pattern);
+            const composed = compose(applicableMiddlewares);
+            const handler = async () => {
+                const result = await match.route.handler(context);
+                if (isVitekResponse(result)) {
+                    const response = result;
+                    const statusCode = response.status || 200;
+                    if (response.headers) {
+                        for (const [key, value] of Object.entries(response.headers)) {
+                            res.setHeader(key, value);
+                        }
+                    }
+                    if (!response.headers || !response.headers['Content-Type']) {
+                        if (response.body !== undefined) {
+                            res.setHeader('Content-Type', 'application/json');
+                        }
+                    }
+                    res.statusCode = statusCode;
+                    if (response.body === undefined) {
+                        res.end();
+                    }
+                    else if (typeof response.body === 'string') {
+                        res.end(response.body);
+                    }
+                    else {
+                        res.end(JSON.stringify(response.body));
+                    }
+                    logRequest(requestMethod, requestPath, statusCode, Date.now() - startTime);
+                }
+                else {
+                    res.setHeader('Content-Type', 'application/json');
+                    res.statusCode = 200;
+                    res.end(JSON.stringify(result));
+                    logRequest(requestMethod, requestPath, 200, Date.now() - startTime);
+                }
+            };
+            await composed(context, handler);
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            if (error instanceof HttpError) {
+                const httpError = error;
+                logWarn(`HTTP Error ${httpError.statusCode}: ${httpError.message}`);
+                res.statusCode = httpError.statusCode;
+                res.setHeader('Content-Type', 'application/json');
+                res.end(JSON.stringify({
+                    error: httpError.name,
+                    message: httpError.message,
+                    code: httpError.code,
+                }));
+                logRequest(requestMethod, requestPath, httpError.statusCode, duration);
+            }
+            else {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logError(`Error handling request: ${errorMessage}`);
+                res.statusCode = 500;
+                res.setHeader('Content-Type', 'application/json');
+                res.end(JSON.stringify({
+                    error: 'Internal server error',
+                    message: errorMessage,
+                }));
+                logRequest(requestMethod, requestPath, 500, duration);
+            }
+        }
+    };
+}

package/dist/core/types/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/core/types/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA8FvF;AA6LD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,MAAM,CAuKxH;AA6KD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,OAAc,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/core/types/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA8FvF;AA4LD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,MAAM,CAuKxH;AA6KD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,OAAc,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/core/types/generate.js

@@ -248,7 +248,7 @@ function generateUniqueTypeName(route, baseName, conflictingRoutes, allUsedNames
  */
 function generateParamsType(params) {
     if (params.length === 0) {
-        return '  // No dynamic params';
+        return '';
     }
     return params.map(param => `  ${param}: string;`).join('\n');
 }

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 /**
- * Export público do pacote Vitek
+ * Public exports for the Vitek package
  */
 export { vitek } from './plugin.js';
 export type { VitekOptions } from './plugin.js';
-export type { VitekContext, VitekRequest, } from './core/context/create-context.js';
+export type { VitekContext, VitekRequest, VitekResponse, } from './core/context/create-context.js';
 export type { Route, RouteHandler, Middleware, RouteMatch, } from './core/routing/route-types.js';
+export { json, ok, created, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, redirect, } from './shared/response-helpers.js';
+export { VitekError, HttpError, BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, ValidationError, TooManyRequestsError, InternalServerError, } from './shared/errors.js';
+export { validate, validateOrThrow, validateBody, validateQuery, } from './core/validation/validator.js';
+export type { ValidationSchema, ValidationRule, ValidationResult } from './core/validation/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,YAAY,EACZ,YAAY,GACb,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,IAAI,EACJ,EAAE,EACF,OAAO,EACP,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,QAAQ,GACT,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,4 +1,7 @@
 /**
- * Export público do pacote Vitek
+ * Public exports for the Vitek package
  */
 export { vitek } from './plugin.js';
+export { json, ok, created, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, redirect, } from './shared/response-helpers.js';
+export { VitekError, HttpError, BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, ValidationError, TooManyRequestsError, InternalServerError, } from './shared/errors.js';
+export { validate, validateOrThrow, validateBody, validateQuery, } from './core/validation/validator.js';

package/dist/plugin.d.ts

@@ -8,6 +8,8 @@ export interface VitekOptions {
     apiDir?: string;
     /** API base path (default: /api) */
     apiBasePath?: string;
+    /** Build API bundle for preview/production (default: true). Set to false to skip. */
+    buildApi?: boolean;
     /** Enable request validation (default: false) */
     enableValidation?: boolean;
     /** Logging configuration */

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,OAAO,CAAC,EAAE;QACR,uEAAuE;QACvE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,uDAAuD;QACvD,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,iDAAiD;QACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAoDxD"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAWnC,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,OAAO,CAAC,EAAE;QACR,uEAAuE;QACvE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,uDAAuD;QACvD,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,iDAAiD;QACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAgHxD"}

package/dist/plugin.js

@@ -4,29 +4,33 @@
  */
 import * as path from 'path';
 import * as fs from 'fs';
+import { pathToFileURL } from 'url';
 import { createViteDevServerMiddleware } from './adapters/vite/dev-server.js';
 import { createViteLogger } from './adapters/vite/logger.js';
-import { API_DIR_NAME } from './shared/constants.js';
+import { createRequestHandler } from './core/server/request-handler.js';
+import { buildApiBundle, getApiBundleFilename } from './build/build-api-bundle.js';
+import { API_BASE_PATH, API_DIR_NAME } from './shared/constants.js';
 /**
  * Vite plugin for Vitek
  */
 export function vitek(options = {}) {
-    const apiDir = options.apiDir || `src/${API_DIR_NAME}`;
+    const apiDirOption = options.apiDir || `src/${API_DIR_NAME}`;
+    const buildApi = options.buildApi !== false;
     let root;
+    let buildOutDir;
     let cleanupFn = null;
     return {
         name: 'vitek',
         configResolved(config) {
             root = config.root;
+            buildOutDir = path.resolve(root, config.build?.outDir ?? 'dist');
         },
         configureServer(server) {
-            const fullApiDir = path.resolve(root, apiDir);
-            // Check if directory exists
+            const fullApiDir = path.resolve(root, apiDirOption);
             if (!fs.existsSync(fullApiDir)) {
                 server.config.logger.warn(`[vitek] API directory not found: ${fullApiDir}`);
                 return;
             }
-            // Create logger and middleware
             const logger = createViteLogger(server.config.logger, options.logging);
             const { middleware, cleanup } = createViteDevServerMiddleware({
                 root,
@@ -36,15 +40,63 @@ export function vitek(options = {}) {
                 enableValidation: options.enableValidation || false,
             });
             cleanupFn = cleanup;
-            // Register middleware in Vite server
             server.middlewares.use(middleware);
             logger.info('Vitek plugin initialized');
-            // Show relative path to root
             const relativeApiDir = path.relative(root, fullApiDir);
             logger.info(`API directory: ./${relativeApiDir.replace(/\\/g, '/')}`);
         },
+        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 bundleUrl = pathToFileURL(bundlePath).href;
+            const bundleLoadPromise = import(bundleUrl);
+            let apiHandler = null;
+            const apiMiddleware = (req, res, next) => {
+                if (!req.url?.startsWith(API_BASE_PATH)) {
+                    return next();
+                }
+                bundleLoadPromise
+                    .then((mod) => {
+                    if (!apiHandler) {
+                        apiHandler = createRequestHandler({
+                            routes: mod.routes,
+                            middlewares: mod.middlewares,
+                        });
+                        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);
+        },
+        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);
+                }
+            }
+        },
         buildEnd() {
-            // Clean up resources when build ends
             if (cleanupFn) {
                 cleanupFn();
                 cleanupFn = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitek-plugin",
-  "version": "0.1.0-beta",
+  "version": "0.1.2-beta",
   "description": "Vite plugin for file-based HTTP API generation",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,11 +14,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "vite",
     "plugin",
@@ -39,10 +34,29 @@
   "peerDependencies": {
     "vite": "^5.0.0"
   },
+  "dependencies": {
+    "esbuild": "^0.24.0",
+    "connect": "^3.7.0",
+    "serve-static": "^1.16.0"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "concurrently": "^9.0.0",
     "typescript": "^5.0.0",
-    "vite": "^5.0.0"
+    "vite": "^5.0.0",
+    "vitepress": "^1.0.0",
+    "@types/connect": "^3.4.0",
+    "@types/serve-static": "^1.15.0"
+  },
+  "bin": {
+    "vitek-serve": "./dist/cli/serve.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "concurrently \"pnpm:dev:tsc\" \"pnpm:docs:dev\"",
+    "dev:tsc": "tsc --watch",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   }
-}
-
+}