@nitronjs/framework 0.2.26 → 0.3.0

package/lib/index.d.ts

@@ -259,10 +259,12 @@ export class Validator {
 }
 
 export class Lang {
-    static get(key: string, replacements?: Record<string, any>): string;
+    static setup(server: any): void;
+    static get(key: string, params?: Record<string, any>): string;
     static has(key: string): boolean;
     static locale(): string;
     static setLocale(locale: string): void;
+    static getFilteredTranslations(locale: string, keys: string[] | null): Record<string, string>;
 }
 
 export class DateTime {
@@ -542,6 +544,24 @@ declare global {
      * const tab = request().query.tab || 'general';
      * const id = request().params.id;
      */
+    /**
+     * Translates a key using the current locale.
+     * Works on both SSR and client-side.
+     *
+     * @param key - Translation key (dot notation supported)
+     * @param params - Optional parameters for replacement (:name) and pluralization (count)
+     * @example
+     * __("welcome") // "Hoş geldiniz"
+     * __("messages.greeting", { name: "Burak" }) // "Merhaba Burak"
+     * __("messages.items", { count: 5 }) // "5 öğe"
+     */
+    function __(key: string, params?: Record<string, any>): string;
+
+    /**
+     * Alias for __() — translates a key using the current locale.
+     */
+    function lang(key: string, params?: Record<string, any>): string;
+
     function request(): {
         path: string;
         method: string;
@@ -551,6 +571,7 @@ declare global {
         cookies: Record<string, string>;
         ip: string;
         isAjax: boolean;
+        locale: string;
         session: {
             get<T = any>(key: string, defaultValue?: T): T;
             set(key: string, value: any): void;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nitronjs/framework",
-	"version": "0.2.26",
+	"version": "0.3.0",
 	"description": "NitronJS is a modern and extensible Node.js MVC framework built on Fastify. It focuses on clean architecture, modular structure, and developer productivity, offering built-in routing, middleware, configuration management, CLI tooling, and native React integration for scalable full-stack applications.",
 	"bin": {
 		"njs": "./cli/njs.js"
@@ -35,7 +35,8 @@
 		"postcss": "^8.5.6",
 		"react": "^19.2.3",
 		"react-dom": "^19.2.3",
-		"react-refresh": "^0.18.0",
+		"react-server-dom-webpack": "^19.2.4",
+		"redis": "^5.6.0",
 		"socket.io": "^4.8.1",
 		"tailwindcss": "^4.1.18",
 		"typescript": "^5.9.3"

package/skeleton/config/app.js

@@ -1,5 +1,6 @@
 export default {
     locale: 'en',
+    fallback_locale: 'en',
     timezone: 'UTC',
 
     /**

package/skeleton/config/server.js

@@ -11,6 +11,19 @@ export default {
             maxFiles: 10,
             maxParts: 60,
             attachFieldsToBody: true,
+            security: {
+                verifyMagicBytes: true,
+                dangerousExtensions: [
+                    ".exe", ".bat", ".cmd", ".com", ".scr", ".pif", ".msi", ".dll",
+                    ".sh", ".cgi", ".csh", ".ksh",
+                    ".php", ".phtml", ".php5", ".php7",
+                    ".jsp", ".asp", ".aspx",
+                    ".vbs", ".vbe", ".wsf", ".wsh", ".ps1", ".psm1",
+                    ".hta", ".cpl", ".inf", ".reg", ".sct"
+                ],
+                compoundExtensions: [".tar.gz", ".tar.bz2", ".tar.xz", ".tar.zst"],
+                allowDoubleExtension: false // WARNING: true enables file.exe.jpg to pass — security risk
+            },
         },
     },
 

package/skeleton/config/session.js

@@ -1,6 +1,10 @@
 const SESSION_LIFETIME = 1000 * 60 * 60 * 2;
 
 export default {
+    // Driver: none | file | memory | redis
+    // WARNING: "memory" driver stores sessions in process memory.
+    // Sessions are lost on restart and memory usage grows with active users.
+    // Use "file" or "redis" in production.
     driver: "file",
     lifetime: SESSION_LIFETIME,
     cookieName: "session",

package/lib/Build/HydrationBuilder.js

@@ -1,190 +0,0 @@
-import fs from "fs";
-import path from "path";
-import crypto from "crypto";
-import Paths from "../Core/Paths.js";
-import Layout from "../View/Layout.js";
-
-/**
- * Sanitizes a name to be a valid JavaScript identifier.
- * @param {string} name - The name to sanitize.
- * @returns {string} A valid JS identifier.
- */
-function sanitizeName(name) {
-    return name.replace(/[^a-zA-Z0-9_$]/g, "_");
-}
-
-/**
- * Generates hydration scripts for client-side component rendering.
- * Creates island bundles for React components that need client interactivity.
- */
-class HydrationBuilder {
-    #cache;
-    #isDev;
-    #templatesPath;
-    #analyzer;
-
-    constructor(cache, isDev, templatesPath, analyzer) {
-        this.#cache = cache;
-        this.#isDev = isDev;
-        this.#templatesPath = templatesPath;
-        this.#analyzer = analyzer;
-    }
-
-    /**
-     * Builds hydration bundles for client components.
-     * @param {object} userBundle - User view bundle.
-     * @param {object} frameworkBundle - Framework view bundle.
-     * @param {object} manifest - Build manifest.
-     * @param {Set<string>|null} changedViews - Changed view files or null for full build.
-     * @returns {Promise<Array<{input: string, output: string}>>}
-     */
-    async build(userBundle, frameworkBundle, manifest, changedViews = null) {
-        const hydrationFiles = [];
-        const allChangedFiles = new Set();
-
-        if (changedViews) {
-            for (const v of changedViews) allChangedFiles.add(v);
-        }
-
-        for (const bundle of [userBundle, frameworkBundle]) {
-            if (!bundle?.meta) continue;
-            for (const [filePath, fileMeta] of bundle.meta.entries()) {
-                if (fileMeta.isClient || fileMeta.needsClient) {
-                    const content = fs.readFileSync(filePath, "utf8");
-                    const hash = crypto.createHash("md5").update(content).digest("hex");
-                    const cacheKey = `hydration:${filePath}`;
-                    const cachedHash = this.#cache.fileHashes.get(cacheKey);
-
-                    if (cachedHash !== hash) {
-                        this.#cache.fileHashes.set(cacheKey, hash);
-                        allChangedFiles.add(filePath);
-                    }
-                }
-            }
-        }
-
-        for (const bundle of [userBundle, frameworkBundle]) {
-            if (!bundle?.entries.length) continue;
-
-            for (const viewPath of bundle.entries) {
-                const viewRelative = path.relative(bundle.srcDir, viewPath)
-                    .replace(/\.tsx$/, "")
-                    .replace(/\\/g, "/")
-                    .toLowerCase();
-                const manifestKey = `${bundle.namespace}:${viewRelative}`;
-                const hydrationScriptPath = `/js/${viewRelative}.js`;
-                const hydrationOutputPath = path.join(Paths.publicJs, viewRelative + ".js");
-
-                const viewMeta = bundle.meta.get(viewPath);
-                const clientComponents = new Set();
-
-                if (!viewMeta?.layoutDisabled) {
-                    const viewRelativeForLayout = path.relative(bundle.srcDir, viewPath).replace(/\\/g, "/");
-                    const layoutChain = Layout.resolve(viewRelativeForLayout, bundle.srcDir);
-
-                    for (const layout of layoutChain) {
-                        const layoutClients = this.#analyzer.findClientComponents(layout.path, bundle.meta, new Set());
-                        for (const c of layoutClients) {
-                            clientComponents.add(c);
-                        }
-                    }
-                }
-
-                const viewClients = this.#analyzer.findClientComponents(viewPath, bundle.meta, new Set());
-                for (const c of viewClients) {
-                    clientComponents.add(c);
-                }
-
-                const needsRebuild = !changedViews ||
-                    allChangedFiles.has(viewPath) ||
-                    [...clientComponents].some(c => allChangedFiles.has(c));
-
-                if (clientComponents.size) {
-                    if (needsRebuild || !fs.existsSync(hydrationOutputPath)) {
-                        const hydrationFile = this.#generateHydrationFile(
-                            viewPath,
-                            bundle.srcDir,
-                            clientComponents,
-                            bundle.meta
-                        );
-                        hydrationFiles.push(hydrationFile);
-                    }
-                    manifest[manifestKey].hydrationScript = hydrationScriptPath;
-                }
-            }
-        }
-
-        return hydrationFiles;
-    }
-
-    #generateHydrationFile(viewPath, srcDir, clientComponents, meta) {
-        const templateName = this.#isDev ? "page-hydration-dev.tsx" : "page-hydration.tsx";
-        const cacheKey = this.#isDev ? "hydrationTemplateDev" : "hydrationTemplate";
-
-        if (!this.#cache[cacheKey]) {
-            const templatePath = path.join(this.#templatesPath, templateName);
-            this.#cache[cacheKey] = fs.readFileSync(templatePath, "utf8");
-        }
-
-        const viewRelative = path.relative(srcDir, viewPath).replace(/\.tsx$/, "").toLowerCase();
-        const outputDir = path.join(Paths.project, ".nitron/hydration", path.dirname(viewRelative));
-        const outputFile = path.join(outputDir, path.basename(viewRelative) + ".tsx");
-        const moduleId = viewRelative.replace(/[\/\\]/g, "_");
-
-        fs.mkdirSync(outputDir, { recursive: true });
-
-        const imports = [];
-        const manifestEntries = [];
-        const registrations = [];
-        let index = 0;
-
-        for (const componentPath of clientComponents) {
-            const componentMeta = meta.get(componentPath);
-            if (!componentMeta) continue;
-
-            const baseName = path.basename(componentPath, ".tsx");
-            const relativePath = path.relative(outputDir, componentPath)
-                .replace(/\\/g, "/")
-                .replace(/\.tsx$/, "");
-
-            if (componentMeta.hasDefault) {
-                const importName = sanitizeName(baseName) + "_" + index++;
-                imports.push(`import ${importName} from "${relativePath}";`);
-                manifestEntries.push(`  "${baseName}": ${importName}`);
-                manifestEntries.push(`  [${importName}.displayName || ${importName}.name || "${baseName}"]: ${importName}`);
-                if (this.#isDev) {
-                    registrations.push(`if (window.__NITRON_REFRESH__) window.__NITRON_REFRESH__.register(${importName}, "${moduleId}_${importName}");`);
-                }
-            }
-
-            for (const namedExport of componentMeta.named || []) {
-                const importName = sanitizeName(namedExport) + "_" + index++;
-                imports.push(`import { ${namedExport} as ${importName} } from "${relativePath}";`);
-                manifestEntries.push(`  "${namedExport}": ${importName}`);
-                manifestEntries.push(`  [${importName}.displayName || ${importName}.name || "${namedExport}"]: ${importName}`);
-                if (this.#isDev) {
-                    registrations.push(`if (window.__NITRON_REFRESH__) window.__NITRON_REFRESH__.register(${importName}, "${moduleId}_${importName}");`);
-                }
-            }
-        }
-
-        let code = this.#cache[cacheKey]
-            .replace("// __COMPONENT_IMPORTS__", imports.join("\n"))
-            .replace(
-                "// __COMPONENT_MANIFEST__",
-                `Object.assign(componentManifest, {\n${manifestEntries.join(",\n")}\n});`
-            );
-
-        if (this.#isDev) {
-            code = code
-                .replace("__NITRON_MODULE_ID__", moduleId)
-                .replace("// __COMPONENT_REGISTRATIONS__", registrations.join("\n"));
-        }
-
-        fs.writeFileSync(outputFile, code);
-
-        return outputFile;
-    }
-}
-
-export default HydrationBuilder;

package/lib/Console/Stubs/page-hydration-dev.tsx

@@ -1,72 +0,0 @@
-import React from "react";
-import { createRoot } from "react-dom/client";
-
-// __COMPONENT_IMPORTS__
-
-const componentManifest: Record<string, React.ComponentType<any>> = {};
-
-// __COMPONENT_MANIFEST__
-
-const w = window as any;
-const prevRefreshReg = w.$RefreshReg$;
-const prevRefreshSig = w.$RefreshSig$;
-
-if (typeof w.$RefreshReg$ === "function") {
-    const moduleId = "__NITRON_MODULE_ID__";
-    w.$RefreshReg$ = (type: any, id: string) => {
-        const fullId = moduleId + "_" + id;
-        if (prevRefreshReg) prevRefreshReg(type, fullId);
-    };
-}
-
-if (typeof w.$RefreshSig$ === "function") {
-    w.$RefreshSig$ = prevRefreshSig;
-}
-
-// __COMPONENT_REGISTRATIONS__
-
-function mount() {
-    const props = (window as any).__NITRON_PROPS__ || {};
-    if (!(window as any).__NITRON_ROOTS__) (window as any).__NITRON_ROOTS__ = new Map();
-
-    const islands = document.querySelectorAll<HTMLElement>("[data-cid]");
-
-    islands.forEach(element => {
-        const componentName = element.dataset.island;
-        const componentId = element.dataset.cid;
-
-        if (!componentName || !componentId) return;
-
-        const Component = componentManifest[componentName];
-        if (!Component) return;
-
-        const componentProps = props[componentId] || {};
-
-        try {
-            const roots = (window as any).__NITRON_ROOTS__ as Map<HTMLElement, any>;
-            let root = roots.get(element);
-            if (!root) {
-                root = createRoot(element);
-                roots.set(element, root);
-            }
-            root.render(React.createElement(Component, componentProps));
-        } catch {
-        }
-    });
-
-    delete (window as any).__NITRON_PROPS__;
-
-    if ((window as any).__NITRON_REFRESH__) {
-        (window as any).__NITRON_REFRESH__.performReactRefresh();
-    }
-}
-
-const isHmrUpdate = (window as any).__NITRON_HMR_UPDATE__;
-
-if (!isHmrUpdate) {
-    if (document.readyState === "loading") {
-        document.addEventListener("DOMContentLoaded", mount);
-    } else {
-        mount();
-    }
-}

package/lib/Console/Stubs/page-hydration.tsx

@@ -1,53 +0,0 @@
-import React from "react";
-import { createRoot } from "react-dom/client";
-
-// __COMPONENT_IMPORTS__
-
-declare global {
-    interface Window {
-        __NITRON_PROPS__?: Record<string, any>;
-        __NITRON_ROOTS__?: Map<HTMLElement, any>;
-    }
-}
-
-const componentManifest: Record<string, React.ComponentType<any>> = {};
-
-// __COMPONENT_MANIFEST__
-
-function mount() {
-    const props = window.__NITRON_PROPS__ || {};
-    if (!window.__NITRON_ROOTS__) window.__NITRON_ROOTS__ = new Map();
-
-    const islands = document.querySelectorAll<HTMLElement>("[data-cid]");
-
-    islands.forEach(element => {
-        const componentName = element.dataset.island;
-        const componentId = element.dataset.cid;
-
-        if (!componentName || !componentId) return;
-
-        const Component = componentManifest[componentName];
-        if (!Component) return;
-
-        const componentProps = props[componentId] || {};
-
-        try {
-            let root = window.__NITRON_ROOTS__.get(element);
-            if (!root) {
-                root = createRoot(element);
-                window.__NITRON_ROOTS__.set(element, root);
-            }
-            root.render(React.createElement(Component, componentProps));
-        } catch {
-        }
-    });
-
-    delete window.__NITRON_PROPS__;
-}
-
-if (document.readyState === "loading") {
-    document.addEventListener("DOMContentLoaded", mount);
-} else {
-    mount();
-}
-