hightjs 0.1.1

package/src/router.ts

@@ -0,0 +1,400 @@
+import fs from 'fs';
+import path from 'path';
+import { RouteConfig, BackendRouteConfig, HightMiddleware } from './types';
+import Console from "./api/console"
+
+// --- Roteamento do Frontend ---
+
+// Guarda todas as rotas de PÁGINA (React) encontradas
+// A rota agora também armazena o caminho do arquivo para ser usado como um ID único no cliente
+let allRoutes: (RouteConfig & { componentPath: string })[] = [];
+
+// Guarda o layout se existir
+let layoutComponent: { componentPath: string; metadata?: any } | null = null;
+
+// Guarda o componente 404 personalizado se existir
+let notFoundComponent: { componentPath: string } | null = null;
+
+// Cache de arquivos carregados para limpeza
+let loadedRouteFiles: Set<string> = new Set();
+let loadedLayoutFiles: Set<string> = new Set();
+let loadedNotFoundFiles: Set<string> = new Set();
+
+/**
+ * Limpa o cache do require para um arquivo específico
+ * @param filePath Caminho do arquivo para limpar
+ */
+function clearRequireCache(filePath: string) {
+    try {
+        const resolvedPath = require.resolve(filePath);
+        delete require.cache[resolvedPath];
+
+        // Também limpa arquivos temporários relacionados
+        const tempFile = filePath.replace(/\.(tsx|ts)$/, '.temp.$1');
+        try {
+            const tempResolvedPath = require.resolve(tempFile);
+            delete require.cache[tempResolvedPath];
+        } catch {
+            // Arquivo temporário pode não existir
+        }
+    } catch (error) {
+        // Arquivo pode não estar no cache
+    }
+}
+
+/**
+ * Limpa todo o cache de rotas carregadas
+ */
+export function clearAllRouteCache() {
+    // Limpa cache das rotas
+    loadedRouteFiles.forEach(filePath => {
+        clearRequireCache(filePath);
+    });
+    loadedRouteFiles.clear();
+
+    // Limpa cache do layout
+    loadedLayoutFiles.forEach(filePath => {
+        clearRequireCache(filePath);
+    });
+    loadedLayoutFiles.clear();
+
+    // Limpa cache do notFound
+    loadedNotFoundFiles.forEach(filePath => {
+        clearRequireCache(filePath);
+    });
+    loadedNotFoundFiles.clear();
+}
+
+/**
+ * Limpa o cache de um arquivo específico e recarrega as rotas se necessário
+ * @param changedFilePath Caminho do arquivo que foi alterado
+ */
+export function clearFileCache(changedFilePath: string) {
+    const absolutePath = path.isAbsolute(changedFilePath) ? changedFilePath : path.resolve(changedFilePath);
+
+    // Limpa o cache do arquivo específico
+    clearRequireCache(absolutePath);
+
+    // Remove das listas de arquivos carregados
+    loadedRouteFiles.delete(absolutePath);
+    loadedLayoutFiles.delete(absolutePath);
+    loadedNotFoundFiles.delete(absolutePath);
+}
+
+/**
+ * Carrega o layout.tsx se existir no diretório web
+ * @param webDir O diretório web onde procurar o layout
+ * @returns O layout carregado ou null se não existir
+ */
+export function loadLayout(webDir: string): { componentPath: string; metadata?: any } | null {
+    const layoutPath = path.join(webDir, 'layout.tsx');
+    const layoutPathJs = path.join(webDir, 'layout.ts');
+
+    const layoutFile = fs.existsSync(layoutPath) ? layoutPath :
+        fs.existsSync(layoutPathJs) ? layoutPathJs : null;
+
+    if (layoutFile) {
+        const componentPath = path.relative(process.cwd(), layoutFile).replace(/\\/g, '/');
+        const absolutePath = path.resolve(layoutFile);
+
+        try {
+            // Limpa o cache antes de recarregar
+            clearRequireCache(absolutePath);
+
+            // HACK: Cria uma versão temporária do layout SEM imports de CSS para carregar no servidor
+            const layoutContent = fs.readFileSync(layoutFile, 'utf8');
+            const tempContent = layoutContent
+                .replace(/import\s+['"][^'"]*\.css['"];?/g, '// CSS import removido para servidor')
+                .replace(/import\s+['"][^'"]*\.scss['"];?/g, '// SCSS import removido para servidor')
+                .replace(/import\s+['"][^'"]*\.sass['"];?/g, '// SASS import removido para servidor');
+
+            const tempFile = layoutFile.replace(/\.(tsx|ts)$/, '.temp.$1');
+            fs.writeFileSync(tempFile, tempContent);
+
+            // Carrega o arquivo temporário sem CSS
+            delete require.cache[require.resolve(tempFile)];
+            const layoutModule = require(tempFile);
+
+            // Remove o arquivo temporário
+            fs.unlinkSync(tempFile);
+
+            const metadata = layoutModule.metadata || null;
+
+            // Registra o arquivo como carregado
+            loadedLayoutFiles.add(absolutePath);
+
+            layoutComponent = { componentPath, metadata };
+            return layoutComponent;
+        } catch (error) {
+            Console.error(`Erro ao carregar layout ${layoutFile}:`, error);
+            layoutComponent = { componentPath };
+            return layoutComponent;
+        }
+    }
+
+    layoutComponent = null;
+    return null;
+}
+
+/**
+ * Retorna o layout atual se carregado
+ */
+export function getLayout(): { componentPath: string; metadata?: any } | null {
+    return layoutComponent;
+}
+
+/**
+ * Carrega dinamicamente todas as rotas de frontend do diretório do usuário.
+ * @param routesDir O diretório onde as rotas de página estão localizadas.
+ * @returns A lista de rotas de página que foram carregadas.
+ */
+export function loadRoutes(routesDir: string): (RouteConfig & { componentPath: string })[] {
+    if (!fs.existsSync(routesDir)) {
+        Console.warn(`Diretório de rotas de frontend não encontrado em ${routesDir}. Nenhuma página será carregada.`);
+        allRoutes = [];
+        return allRoutes;
+    }
+
+    const files = fs.readdirSync(routesDir, { recursive: true, encoding: 'utf-8' });
+    // Corrigindo o filtro para excluir corretamente o diretório backend
+    const routeFiles = files.filter(file => {
+        const isTypeScriptFile = file.endsWith('.ts') || file.endsWith('.tsx');
+        const isNotBackend = !file.includes('backend' + path.sep) && !file.includes('backend/');
+        return isTypeScriptFile && isNotBackend;
+    });
+
+    const loaded: (RouteConfig & { componentPath: string })[] = [];
+    for (const file of routeFiles) {
+        const filePath = path.join(routesDir, file);
+        const absolutePath = path.resolve(filePath);
+        // Usamos um caminho relativo ao CWD como um ID estável para o componente.
+        const componentPath = path.relative(process.cwd(), filePath).replace(/\\/g, '/');
+
+        try {
+            // Limpa o cache antes de recarregar para pegar alterações nos metadados
+            clearRequireCache(absolutePath);
+
+            const routeModule = require(filePath);
+            if (routeModule.default && routeModule.default.pattern && routeModule.default.component) {
+                loaded.push({ ...routeModule.default, componentPath });
+
+                // Registra o arquivo como carregado
+                loadedRouteFiles.add(absolutePath);
+            }
+        } catch (error) {
+            Console.error(`Erro ao carregar a rota de página ${filePath}:`, error);
+        }
+    }
+    allRoutes = loaded;
+    return allRoutes;
+}
+
+/**
+ * Encontra a rota de página correspondente para uma URL.
+ * @param pathname O caminho da URL (ex: "/users/123").
+ * @returns Um objeto com a rota e os parâmetros, ou null se não encontrar.
+ */
+export function findMatchingRoute(pathname: string) {
+    for (const route of allRoutes) {
+        if (!route.pattern) continue;
+
+        // Converte o padrão da rota (ex: /users/[id]) em uma RegExp
+        const regexPattern = route.pattern.replace(/\[(\w+)\]/g, '(?<$1>[^/]+)');
+        const regex = new RegExp(`^${regexPattern}/?$`);
+        const match = pathname.match(regex);
+
+        if (match) {
+            return {
+                route,
+                params: match.groups || {}
+            };
+        }
+    }
+    return null;
+}
+
+// --- Roteamento do Backend ---
+
+// Guarda todas as rotas de API encontradas
+let allBackendRoutes: BackendRouteConfig[] = [];
+
+// Cache de middlewares carregados por diretório
+let loadedMiddlewares: Map<string, HightMiddleware[]> = new Map();
+
+/**
+ * Carrega middlewares de um diretório específico
+ * @param dir O diretório onde procurar por middleware.ts
+ * @returns Array de middlewares encontrados
+ */
+function loadMiddlewareFromDirectory(dir: string): HightMiddleware[] {
+    const middlewares: HightMiddleware[] = [];
+
+    // Procura por middleware.ts ou middleware.tsx
+    const middlewarePath = path.join(dir, 'middleware.ts');
+    const middlewarePathTsx = path.join(dir, 'middleware.tsx');
+
+    const middlewareFile = fs.existsSync(middlewarePath) ? middlewarePath :
+        fs.existsSync(middlewarePathTsx) ? middlewarePathTsx : null;
+
+    if (middlewareFile) {
+        try {
+            const absolutePath = path.resolve(middlewareFile);
+            clearRequireCache(absolutePath);
+
+            const middlewareModule = require(middlewareFile);
+
+            // Suporte para export default (função única) ou export { middleware1, middleware2 }
+            if (typeof middlewareModule.default === 'function') {
+                middlewares.push(middlewareModule.default);
+            } else if (middlewareModule.default && Array.isArray(middlewareModule.default)) {
+                middlewares.push(...middlewareModule.default);
+            } else {
+                // Procura por exports nomeados que sejam funções
+                Object.keys(middlewareModule).forEach(key => {
+                    if (key !== 'default' && typeof middlewareModule[key] === 'function') {
+                        middlewares.push(middlewareModule[key]);
+                    }
+                });
+            }
+
+        } catch (error) {
+            Console.error(`Erro ao carregar middleware ${middlewareFile}:`, error);
+        }
+    }
+
+    return middlewares;
+}
+
+/**
+ * Coleta middlewares do diretório específico da rota (não herda dos pais)
+ * @param routeFilePath Caminho completo do arquivo de rota
+ * @param backendRoutesDir Diretório raiz das rotas de backend
+ * @returns Array com middlewares apenas do diretório da rota
+ */
+function collectMiddlewaresForRoute(routeFilePath: string, backendRoutesDir: string): HightMiddleware[] {
+    const relativePath = path.relative(backendRoutesDir, routeFilePath);
+    const routeDir = path.dirname(path.join(backendRoutesDir, relativePath));
+
+    // Carrega middlewares APENAS do diretório específico da rota (não herda dos pais)
+    if (!loadedMiddlewares.has(routeDir)) {
+        const middlewares = loadMiddlewareFromDirectory(routeDir);
+        loadedMiddlewares.set(routeDir, middlewares);
+    }
+
+    return loadedMiddlewares.get(routeDir) || [];
+}
+
+/**
+ * Carrega dinamicamente todas as rotas de API do diretório de backend.
+ * @param backendRoutesDir O diretório onde as rotas de API estão localizadas.
+ */
+export function loadBackendRoutes(backendRoutesDir: string) {
+    if (!fs.existsSync(backendRoutesDir)) {
+        // É opcional ter uma API, então não mostramos um aviso se a pasta não existir.
+        allBackendRoutes = [];
+        return;
+    }
+
+    // Limpa cache de middlewares para recarregar
+    loadedMiddlewares.clear();
+
+    const files = fs.readdirSync(backendRoutesDir, { recursive: true, encoding: 'utf-8' });
+    const routeFiles = files.filter(file => {
+        const isTypeScript = file.endsWith('.ts') || file.endsWith('.tsx');
+        const isNotMiddleware = !path.basename(file).startsWith('middleware');
+        return isTypeScript && isNotMiddleware;
+    });
+
+    const loaded: BackendRouteConfig[] = [];
+    for (const file of routeFiles) {
+        const filePath = path.join(backendRoutesDir, file);
+        try {
+            const routeModule = require(filePath);
+            if (routeModule.default && routeModule.default.pattern) {
+                const routeConfig = { ...routeModule.default };
+
+                // Se a rota NÃO tem a propriedade middleware definida, carrega os da pasta
+                if (!routeConfig.hasOwnProperty('middleware')) {
+                    const folderMiddlewares = collectMiddlewaresForRoute(filePath, backendRoutesDir);
+                    if (folderMiddlewares.length > 0) {
+                        routeConfig.middleware = folderMiddlewares;
+                    }
+                }
+                // Se tem middleware definido (mesmo que seja []), usa só esses (não adiciona os da pasta)
+
+                loaded.push(routeConfig);
+            }
+        } catch (error) {
+            Console.error(`Erro ao carregar a rota de API ${filePath}:`, error);
+        }
+    }
+    allBackendRoutes = loaded;
+}
+
+/**
+ * Encontra a rota de API correspondente para uma URL e método HTTP.
+ * @param pathname O caminho da URL (ex: "/api/users/123").
+ * @param method O método HTTP da requisição (GET, POST, etc.).
+ * @returns Um objeto com a rota e os parâmetros, ou null se não encontrar.
+ */
+export function findMatchingBackendRoute(pathname: string, method: string) {
+    for (const route of allBackendRoutes) {
+        // Verifica se a rota tem um handler para o método HTTP atual
+        if (!route.pattern || !route[method.toUpperCase() as keyof BackendRouteConfig]) continue;
+
+        const regexPattern = route.pattern.replace(/\[(\w+)\]/g, '(?<$1>[^/]+)');
+        const regex = new RegExp(`^${regexPattern}/?$`);
+        const match = pathname.match(regex);
+
+        if (match) {
+            return {
+                route,
+                params: match.groups || {}
+            };
+        }
+    }
+    return null;
+}
+
+/**
+ * Carrega o notFound.tsx se existir no diretório web
+ * @param webDir O diretório web onde procurar o notFound
+ * @returns O notFound carregado ou null se não existir
+ */
+export function loadNotFound(webDir: string): { componentPath: string } | null {
+    const notFoundPath = path.join(webDir, 'notFound.tsx');
+    const notFoundPathJs = path.join(webDir, 'notFound.ts');
+
+    const notFoundFile = fs.existsSync(notFoundPath) ? notFoundPath :
+        fs.existsSync(notFoundPathJs) ? notFoundPathJs : null;
+
+    if (notFoundFile) {
+        const componentPath = path.relative(process.cwd(), notFoundFile).replace(/\\/g, '/');
+        const absolutePath = path.resolve(notFoundFile);
+
+        try {
+            // Limpa o cache antes de recarregar
+            clearRequireCache(absolutePath);
+
+            // Registra o arquivo como carregado
+            loadedNotFoundFiles.add(absolutePath);
+
+            notFoundComponent = { componentPath };
+            return notFoundComponent;
+        } catch (error) {
+            Console.error(`Erro ao carregar notFound ${notFoundFile}:`, error);
+            notFoundComponent = { componentPath };
+            return notFoundComponent;
+        }
+    }
+
+    notFoundComponent = null;
+    return null;
+}
+
+/**
+ * Retorna o componente 404 atual se carregado
+ */
+export function getNotFound(): { componentPath: string } | null {
+    return notFoundComponent;
+}

package/src/types/framework.ts

@@ -0,0 +1,42 @@
+// Tipos genéricos para abstrair diferentes frameworks web
+export interface GenericRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string | string[]>;
+    body?: any;
+    query?: Record<string, any>;
+    params?: Record<string, string>;
+    cookies?: Record<string, string>;
+    raw?: any; // Requisição original do framework
+}
+
+export interface GenericResponse {
+    status(code: number): GenericResponse;
+    header(name: string, value: string): GenericResponse;
+    cookie(name: string, value: string, options?: CookieOptions): GenericResponse;
+    clearCookie(name: string, options?: CookieOptions): GenericResponse;
+    json(data: any): void;
+    text(data: string): void;
+    send(data: any): void;
+    redirect(url: string): void;
+    raw?: any; // Resposta original do framework
+}
+
+export interface CookieOptions {
+    domain?: string;
+    expires?: Date;
+    httpOnly?: boolean;
+    maxAge?: number;
+    path?: string;
+    secure?: boolean;
+    signed?: boolean;
+    sameSite?: boolean | 'lax' | 'strict' | 'none';
+}
+
+export type FrameworkType = 'express' | 'fastify' | 'native';
+
+export interface FrameworkAdapter {
+    type: FrameworkType;
+    parseRequest(req: any): GenericRequest;
+    createResponse(res: any): GenericResponse;
+}

package/src/types.ts

@@ -0,0 +1,54 @@
+import type { ComponentType } from 'react';
+import type { GenericRequest } from './types/framework';
+import {HightJSRequest, HightJSResponse} from "./api/http";
+
+// --- Tipos do Frontend (sem alteração) ---
+export interface HightJSOptions {
+    dev?: boolean;
+    hostname?: string;
+    port?: number;
+    dir?: string;
+    framework?: 'express' | 'fastify' | 'native';
+}
+export interface Metadata {
+    title?: string;
+    description?: string;
+    favicon?: string;
+}
+export interface RouteConfig {
+    pattern: string;
+    component: ComponentType<any>;
+    generateMetadata?: (params: any, req: GenericRequest) => Promise<Metadata> | Metadata;
+}
+export type RequestHandler = (req: any, res: any) => Promise<void>;
+
+// --- NOVO: Tipos do Backend ---
+
+/**
+ * Define o formato de uma função que manipula uma rota da API.
+ */
+export type BackendHandler = (
+    request: HightJSRequest, // HWebRequest será importado onde necessário
+    params: { [key: string]: string }
+) => Promise<HightJSResponse> | HightJSResponse; // HWebResponse será importado onde necessário
+
+
+
+export type HightMiddleware = (
+    request: HightJSRequest, // HWebRequest será importado onde necessário
+    params: { [key: string]: string },
+    next: () => Promise<HightJSResponse>
+) => Promise<HightJSResponse> | HightJSResponse; // HWebResponse será importado onde necessário
+
+
+/**
+ * Define a estrutura de cada rota da API, com suporte para métodos HTTP.
+ */
+export interface BackendRouteConfig {
+    pattern: string;
+    GET?: BackendHandler;
+    POST?: BackendHandler;
+    PUT?: BackendHandler;
+    DELETE?: BackendHandler;
+    middleware?: HightMiddleware[]; // Permite adicionar middlewares específicos à rota
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "moduleResolution": "node",
+    "allowJs": true,
+  },
+  "include": ["src"],
+  "exclude": ["node_modules"]
+}