hightjs 0.5.0 → 0.5.2

package/src/index.ts

@@ -0,0 +1,557 @@
+/*
+ * This file is part of the HightJS Project.
+ * Copyright (c) 2025 itsmuzin
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import path from 'path';
+import fs from 'fs';
+import {ExpressAdapter} from './adapters/express';
+import {build, buildWithChunks, watch, watchWithChunks} from './builder';
+import {
+    BackendHandler,
+    BackendRouteConfig,
+    HightJSOptions,
+    HightMiddleware,
+    RequestHandler,
+    RouteConfig
+} from './types';
+import {
+    findMatchingBackendRoute,
+    findMatchingRoute,
+    getLayout,
+    getNotFound,
+    loadBackendRoutes,
+    loadLayout,
+    loadNotFound,
+    loadRoutes,
+    processWebSocketRoutes,
+    setupWebSocketUpgrade
+} from './router';
+import {render} from './renderer';
+import {HightJSRequest, HightJSResponse} from './api/http';
+import {HotReloadManager} from './hotReload';
+import {FrameworkAdapterFactory} from './adapters/factory';
+import {GenericRequest, GenericResponse} from './types/framework';
+import Console, {Colors} from "./api/console"
+
+// Exporta apenas os tipos e classes para o backend
+export { HightJSRequest, HightJSResponse };
+export type { BackendRouteConfig, BackendHandler };
+
+// Exporta os adapters para uso manual se necessário
+export { ExpressAdapter } from './adapters/express';
+export { FastifyAdapter } from './adapters/fastify';
+export { FrameworkAdapterFactory } from './adapters/factory';
+export type { GenericRequest, GenericResponse, CookieOptions } from './types/framework';
+
+// Exporta os helpers para facilitar integração
+export { app } from './helpers';
+
+// Exporta o sistema de WebSocket
+export type { WebSocketContext, WebSocketHandler } from './types';
+
+// Exporta os tipos de configuração
+export type { HightConfig, HightConfigFunction } from './types';
+
+// Função para verificar se o projeto é grande o suficiente para se beneficiar de chunks
+function isLargeProject(projectDir: string): boolean {
+    try {
+        const srcDir = path.join(projectDir, 'src');
+        if (!fs.existsSync(srcDir)) return false;
+
+        let totalFiles = 0;
+        let totalSize = 0;
+
+        function scanDirectory(dir: string) {
+            const items = fs.readdirSync(dir, { withFileTypes: true });
+
+            for (const item of items) {
+                const fullPath = path.join(dir, item.name);
+
+                if (item.isDirectory() && item.name !== 'node_modules' && item.name !== '.git') {
+                    scanDirectory(fullPath);
+                } else if (item.isFile() && /\.(tsx?|jsx?|css|scss|less)$/i.test(item.name)) {
+                    totalFiles++;
+                    totalSize += fs.statSync(fullPath).size;
+                }
+            }
+        }
+
+        scanDirectory(srcDir);
+
+        // Considera projeto grande se:
+        // - Mais de 20 arquivos de frontend/style
+        // - Ou tamanho total > 500KB
+        return totalFiles > 20 || totalSize > 500 * 1024;
+    } catch (error) {
+        // Em caso de erro, assume que não é um projeto grande
+        return false;
+    }
+}
+
+// Função para gerar o arquivo de entrada para o esbuild
+function createEntryFile(projectDir: string, routes: (RouteConfig & { componentPath: string })[]): string {
+    try {
+        const tempDir = path.join(projectDir, '.hight', 'temp');
+
+        fs.mkdirSync(tempDir, { recursive: true });
+
+        const entryFilePath = path.join(tempDir, 'entry.client.js');
+        // Verifica se há layout
+        const layout = getLayout();
+
+        // Verifica se há notFound personalizado
+        const notFound = getNotFound();
+
+        // Gera imports dinâmicos para cada componente
+        const imports = routes
+            .map((route, index) => {
+                const relativePath = path.relative(tempDir, route.componentPath).replace(/\\/g, '/');
+                return `import route${index} from '${relativePath}';`;
+            })
+            .join('\n');
+
+        // Import do layout se existir
+        const layoutImport = layout
+            ? `import LayoutComponent from '${path.relative(tempDir, layout.componentPath).replace(/\\/g, '/')}';`
+            : '';
+
+        // Import do notFound se existir
+        const notFoundImport = notFound
+            ? `import NotFoundComponent from '${path.relative(tempDir, notFound.componentPath).replace(/\\/g, '/')}';`
+            : '';
+
+        // Registra os componentes no window para o cliente acessar
+        const componentRegistration = routes
+            .map((route, index) => `  '${route.componentPath}': route${index}.component || route${index}.default?.component,`)
+            .join('\n');
+
+        // Registra o layout se existir
+        const layoutRegistration = layout
+            ? `window.__HWEB_LAYOUT__ = LayoutComponent.default || LayoutComponent;`
+            : `window.__HWEB_LAYOUT__ = null;`;
+
+        // Registra o notFound se existir
+        const notFoundRegistration = notFound
+            ? `window.__HWEB_NOT_FOUND__ = NotFoundComponent.default || NotFoundComponent;`
+            : `window.__HWEB_NOT_FOUND__ = null;`;
+
+        // Caminho correto para o entry.client.tsx
+        const sdkDir = path.dirname(__dirname); // Vai para a pasta pai de src (onde está o hweb-sdk)
+        const entryClientPath = path.join(sdkDir, 'src', 'client', 'entry.client.tsx');
+        const relativeEntryPath = path.relative(tempDir, entryClientPath).replace(/\\/g, '/');
+
+        // Import do DefaultNotFound do SDK
+        const defaultNotFoundPath = path.join(sdkDir, 'src', 'client', 'DefaultNotFound.tsx');
+        const relativeDefaultNotFoundPath = path.relative(tempDir, defaultNotFoundPath).replace(/\\/g, '/');
+
+        const entryContent = `// Arquivo gerado automaticamente pelo hweb
+${imports}
+${layoutImport}
+${notFoundImport}
+import DefaultNotFound from '${relativeDefaultNotFoundPath}';
+
+// Registra os componentes para o cliente
+window.__HWEB_COMPONENTS__ = {
+${componentRegistration}
+};
+
+// Registra o layout se existir
+${layoutRegistration}
+
+// Registra o notFound se existir
+${notFoundRegistration}
+
+// Registra o DefaultNotFound do hweb
+window.__HWEB_DEFAULT_NOT_FOUND__ = DefaultNotFound;
+
+// Importa e executa o entry.client.tsx
+import '${relativeEntryPath}';
+`;
+
+        try {
+            fs.writeFileSync(entryFilePath, entryContent);
+        } catch (e) {
+            console.error("sdfijnsdfnijfsdijnfsdnijsdfnijfsdnijfsdnijfsdn", e)
+        }
+
+        return entryFilePath;
+    }catch (e){
+        Console.error("Error creating entry file:", e);
+        throw e;
+    }
+}
+
+export default function hweb(options: HightJSOptions) {
+    const { dev = true, dir = process.cwd(), port = 3000 } = options;
+    // @ts-ignore
+    process.hight = options;
+    const userWebDir = path.join(dir, 'src', 'web');
+    const userWebRoutesDir = path.join(userWebDir, 'routes');
+    const userBackendRoutesDir = path.join(dir, 'src', 'backend', 'routes');
+
+    /**
+     * Executa middlewares sequencialmente e depois o handler final
+     * @param middlewares Array de middlewares para executar
+     * @param finalHandler Handler final da rota
+     * @param request Requisição do HightJS
+     * @param params Parâmetros da rota
+     * @returns Resposta do middleware ou handler final
+     */
+    async function executeMiddlewareChain(
+        middlewares: HightMiddleware[] | undefined,
+        finalHandler: BackendHandler,
+        request: HightJSRequest,
+        params: { [key: string]: string }
+    ): Promise<HightJSResponse> {
+        if (!middlewares || middlewares.length === 0) {
+            // Não há middlewares, executa diretamente o handler final
+            return await finalHandler(request, params);
+        }
+
+        let currentIndex = 0;
+
+        // Função next que será chamada pelos middlewares
+        const next = async (): Promise<HightJSResponse> => {
+            if (currentIndex < middlewares.length) {
+                // Ainda há middlewares para executar
+                const currentMiddleware = middlewares[currentIndex];
+                currentIndex++;
+                return await currentMiddleware(request, params, next);
+            } else {
+                // Todos os middlewares foram executados, chama o handler final
+                return await finalHandler(request, params);
+            }
+        };
+
+        // Inicia a cadeia de execução
+        return await next();
+    }
+
+    let frontendRoutes: (RouteConfig & { componentPath: string })[] = [];
+    let hotReloadManager: HotReloadManager | null = null;
+    let entryPoint: string;
+    let outfile: string;
+
+    // Função para regenerar o entry file
+    const regenerateEntryFile = () => {
+        // Recarrega todas as rotas e componentes
+        frontendRoutes = loadRoutes(userWebRoutesDir);
+        loadLayout(userWebDir);
+        loadNotFound(userWebDir);
+
+        // Regenera o entry file
+        entryPoint = createEntryFile(dir, frontendRoutes);
+    };
+
+    return {
+        prepare: async () => {
+            const isProduction = !dev;
+
+            if (!isProduction) {
+                // Inicia hot reload apenas em desenvolvimento (com suporte ao main)
+                hotReloadManager = new HotReloadManager(dir);
+                await hotReloadManager.start();
+
+                // Adiciona callback para recarregar TUDO quando qualquer arquivo mudar
+                hotReloadManager.onBackendApiChange(() => {
+
+
+                    loadBackendRoutes(userBackendRoutesDir);
+                    processWebSocketRoutes(); // Processa rotas WS após recarregar backend
+                });
+
+                // Adiciona callback para regenerar entry file quando frontend mudar
+                hotReloadManager.onFrontendChange(() => {
+                    regenerateEntryFile();
+                });
+            }
+            const now = Date.now();
+            const timee = Console.dynamicLine(`  ${Colors.BgYellow} router ${Colors.Reset}   Loading routes and components`);
+            const spinnerFrames1 = ['|', '/', '-', '\\'];
+            let frameIndex1 = 0;
+
+            const spinner1 = setInterval(() => {
+                timee.update(`   ${Colors.FgYellow}${spinnerFrames1[frameIndex1]}${Colors.Reset}  Loading routes and components...`);
+                frameIndex1 = (frameIndex1 + 1) % spinnerFrames1.length;
+            }, 100); // muda a cada 100ms
+            // ORDEM IMPORTANTE: Carrega TUDO antes de criar o arquivo de entrada
+            frontendRoutes = loadRoutes(userWebRoutesDir);
+            loadBackendRoutes(userBackendRoutesDir);
+
+            // Processa rotas WebSocket após carregar backend
+            processWebSocketRoutes();
+
+            // Carrega layout.tsx ANTES de criar o entry file
+            const layout = loadLayout(userWebDir);
+
+            const notFound = loadNotFound(userWebDir);
+
+            const outDir = path.join(dir, '.hight');
+            fs.mkdirSync(outDir, {recursive: true});
+
+            entryPoint = createEntryFile(dir, frontendRoutes);
+            clearInterval(spinner1)
+            timee.end(`  ${Colors.BgGreen} router ${Colors.Reset}   Routes and components loaded in ${Date.now() - now}ms`);
+
+
+            if (isProduction) {
+                const time = Console.dynamicLine(`  ${Colors.BgYellow} build ${Colors.Reset}    Starting client build`);
+
+// Spinner
+                const spinnerFrames = ['|', '/', '-', '\\'];
+                let frameIndex = 0;
+
+                const spinner = setInterval(() => {
+                    time.update(`    ${Colors.FgYellow}${spinnerFrames[frameIndex]}${Colors.Reset}  Building...`);
+                    frameIndex = (frameIndex + 1) % spinnerFrames.length;
+                }, 100); // muda a cada 100ms
+
+                const now = Date.now();
+                await buildWithChunks(entryPoint, outDir, isProduction);
+                const elapsed = Date.now() - now;
+
+                clearInterval(spinner); // para o spinner
+                time.update(""); // limpa a linha
+                time.end(`  ${Colors.BgGreen} build ${Colors.Reset}    Client build completed in ${elapsed}ms`);
+
+                // Notifica o hot reload manager que o build foi concluído
+                if (hotReloadManager) {
+                    hotReloadManager.onBuildComplete(true);
+                }
+
+            } else {
+                const time = Console.dynamicLine(`  ${Colors.BgYellow} watcher ${Colors.Reset}  Starting client watch`);
+                watchWithChunks(entryPoint, outDir, hotReloadManager!).catch(err => {
+                    Console.error(`Error starting watch`, err);
+                });
+                time.end(`  ${Colors.BgGreen} watcher ${Colors.Reset}  Client Watch started`);
+            }
+
+        },
+
+        executeInstrumentation: () => {
+
+            // verificar se dir/src/instrumentation.(tsx/jsx/js/ts) existe com regex
+            const instrumentationFile = fs.readdirSync(path.join(dir, 'src')).find(file => /^hightweb\.(tsx|jsx|js|ts)$/.test(file));
+            if (instrumentationFile) {
+                const instrumentationPath = path.join(dir, 'src', instrumentationFile);
+                // dar require, e executar a função principal do arquivo
+                const instrumentation = require(instrumentationPath);
+
+                // Registra o listener de hot reload se existir
+                if (instrumentation.hotReloadListener && typeof instrumentation.hotReloadListener === 'function') {
+                    if (hotReloadManager) {
+                        hotReloadManager.setHotReloadListener(instrumentation.hotReloadListener);
+                    }
+                }
+
+                if (typeof instrumentation === 'function') {
+                    instrumentation();
+                } else if (typeof instrumentation.default === 'function') {
+                    instrumentation.default();
+                } else {
+                    Console.warn(`The instrumentation file ${instrumentationFile} does not export a default function.`);
+                }
+            }
+        },
+        getRequestHandler: (): RequestHandler => {
+            return async (req: any, res: any) => {
+                // Detecta automaticamente o framework e cria o adapter apropriado
+                const adapter = FrameworkAdapterFactory.detectFramework(req, res);
+                const genericReq = adapter.parseRequest(req);
+                const genericRes = adapter.createResponse(res);
+
+                // Adiciona informações do hweb na requisição genérica
+                (genericReq as any).hwebDev = dev;
+                (genericReq as any).hotReloadManager = hotReloadManager;
+
+                const {pathname} = new URL(genericReq.url, `http://${genericReq.headers.host || 'localhost'}`);
+                const method = genericReq.method.toUpperCase();
+
+                // 1. Verifica se é WebSocket upgrade para hot reload
+                if (pathname === '/hweb-hotreload/' && genericReq.headers.upgrade === 'websocket' && hotReloadManager) {
+                    // Framework vai chamar o evento 'upgrade' do servidor HTTP
+                    return;
+                }
+
+                // 2. Primeiro verifica se é um arquivo estático da pasta public
+                if (pathname !== '/' && !pathname.startsWith('/api/') && !pathname.startsWith('/.hight')) {
+                    const publicDir = path.join(dir, 'public');
+                    const filePath = path.join(publicDir, pathname);
+
+                    if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                        const ext = path.extname(filePath).toLowerCase();
+                        const contentTypes: Record<string, string> = {
+                            '.html': 'text/html',
+                            '.css': 'text/css',
+                            '.js': 'application/javascript',
+                            '.json': 'application/json',
+                            '.png': 'image/png',
+                            '.jpg': 'image/jpeg',
+                            '.jpeg': 'image/jpeg',
+                            '.gif': 'image/gif',
+                            '.svg': 'image/svg+xml',
+                            '.ico': 'image/x-icon',
+                            '.webp': 'image/webp',
+                            '.mp4': 'video/mp4',
+                            '.webm': 'video/webm',
+                            '.mp3': 'audio/mpeg',
+                            '.wav': 'audio/wav',
+                            '.pdf': 'application/pdf',
+                            '.txt': 'text/plain',
+                            '.xml': 'application/xml',
+                            '.zip': 'application/zip'
+                        };
+
+                        genericRes.header('Content-Type', contentTypes[ext] || 'application/octet-stream');
+
+                        // Para arquivos estáticos, usamos o método nativo do framework
+                        if (adapter.type === 'express') {
+                            (res as any).sendFile(filePath);
+                        } else if (adapter.type === 'fastify') {
+                            const fileContent = fs.readFileSync(filePath);
+                            genericRes.send(fileContent);
+                        } else if (adapter.type === 'native') {
+                            const fileContent = fs.readFileSync(filePath);
+                            genericRes.send(fileContent);
+                        }
+                        return;
+                    }
+                }
+
+                // 3. Verifica se é um arquivo estático do .hight
+                if (pathname.startsWith('/_hight/')) {
+
+                    const staticPath = path.join(dir, '.hight');
+                    const filePath = path.join(staticPath, pathname.replace('/_hight/', ''));
+
+                    if (fs.existsSync(filePath)) {
+
+                        const ext = path.extname(filePath).toLowerCase();
+                        const contentTypes: Record<string, string> = {
+                            '.js': 'application/javascript',
+                            '.css': 'text/css',
+                            '.map': 'application/json'
+                        };
+
+                        genericRes.header('Content-Type', contentTypes[ext] || 'text/plain');
+
+                        // Para arquivos estáticos, usamos o método nativo do framework
+                        if (adapter.type === 'express') {
+                            (res as any).sendFile(filePath);
+                        } else if (adapter.type === 'fastify') {
+                            const fileContent = fs.readFileSync(filePath);
+                            genericRes.send(fileContent);
+                        } else if (adapter.type === 'native') {
+                            const fileContent = fs.readFileSync(filePath);
+                            genericRes.send(fileContent);
+                        }
+                        return;
+                    }
+                }
+
+                // 4. REMOVIDO: Verificação de arquivos React UMD - não precisamos mais
+                // O React agora será bundlado diretamente no main.js
+
+                // 5. Verifica se é uma rota de API (backend)
+                const backendMatch = findMatchingBackendRoute(pathname, method);
+                if (backendMatch) {
+                    try {
+                        const handler = backendMatch.route[method as keyof BackendRouteConfig] as BackendHandler;
+                        if (handler) {
+                            const hwebReq = new HightJSRequest(genericReq);
+
+                            // Executa middlewares e depois o handler final
+                            const hwebRes = await executeMiddlewareChain(
+                                backendMatch.route.middleware,
+                                handler,
+                                hwebReq,
+                                backendMatch.params
+                            );
+
+                            // Aplica a resposta usando o adapter correto
+                            hwebRes._applyTo(genericRes);
+                            return;
+                        }
+                    } catch (error) {
+                        Console.error(`API route error ${pathname}:`, error);
+                        genericRes.status(500).text('Internal server error in API');
+                        return;
+                    }
+                }
+
+                // 6. Por último, tenta renderizar uma página (frontend) ou 404
+                const pageMatch = findMatchingRoute(pathname);
+
+                if (!pageMatch) {
+                    // Em vez de enviar texto simples, renderiza a página 404 React
+                    try {
+                        // Cria uma "rota falsa" para a página 404
+                        const notFoundRoute = {
+                            pattern: '/__404__',
+                            component: () => null, // Componente vazio, será tratado no cliente
+                            componentPath: '__404__'
+                        };
+
+                        const html = await render({
+                            req: genericReq,
+                            route: notFoundRoute,
+                            params: {},
+                            allRoutes: frontendRoutes
+                        });
+                        genericRes.status(404).header('Content-Type', 'text/html').send(html);
+                        return;
+                    } catch (error) {
+                        Console.error(`Error rendering page 404:`, error);
+                        genericRes.status(404).text('Page not found');
+                        return;
+                    }
+                }
+
+                try {
+                    const html = await render({
+                        req: genericReq,
+                        route: pageMatch.route,
+                        params: pageMatch.params,
+                        allRoutes: frontendRoutes
+                    });
+                    genericRes.status(200).header('Content-Type', 'text/html').send(html);
+                } catch (error) {
+                    Console.error(`Error rendering page ${pathname}:`, error);
+                    genericRes.status(500).text('Internal server error');
+                }
+            };
+        },
+
+        // Método para configurar WebSocket upgrade nos servidores Express e Fastify
+        setupWebSocket: (server: any) => {
+            // Detecta se é um servidor Express ou Fastify
+            const isExpressServer = FrameworkAdapterFactory.getCurrentAdapter() instanceof ExpressAdapter;
+            const actualServer = isExpressServer ? server : (server.server || server);
+
+            // Usa o sistema coordenado de WebSocket upgrade que integra hot-reload e rotas de usuário
+            setupWebSocketUpgrade(actualServer, hotReloadManager);
+        },
+
+
+        stop: () => {
+            if (hotReloadManager) {
+                hotReloadManager.stop();
+            }
+        }
+    };
+}
+

package/src/loaders.js

@@ -0,0 +1,53 @@
+/*
+ * This file is part of the HightJS Project.
+ * Copyright (c) 2025 itsmuzin
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const fs = require('fs');
+
+/**
+ * Registra loaders customizados para Node.js
+ * Permite importar arquivos não-JS diretamente no servidor
+ */
+function registerLoaders() {
+    // Loader para arquivos Markdown (.md)
+    require.extensions['.md'] = function (module, filename) {
+        const content = fs.readFileSync(filename, 'utf8');
+        module.exports = content;
+    };
+
+    // Loader para arquivos de texto (.txt)
+    require.extensions['.txt'] = function (module, filename) {
+        const content = fs.readFileSync(filename, 'utf8');
+        module.exports = content;
+    };
+
+    // Loader para arquivos JSON (já existe nativamente, mas garantimos consistência)
+    // require.extensions['.json'] já existe
+
+    // Loader para imagens - retorna o caminho do arquivo
+    const imageExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.ico', '.bmp', '.svg'];
+
+    imageExtensions.forEach(ext => {
+        require.extensions[ext] = function (module, filename) {
+            // No servidor, retornamos o caminho do arquivo
+            // O frontend usará o plugin do esbuild para converter em base64
+            module.exports = filename;
+        };
+    });
+}
+
+module.exports = { registerLoaders };
+