create-jen-app 1.2.1 → 1.2.3

package/templates/static/lib/auth/session.d.ts

@@ -1,8 +1,8 @@
 interface SessionData {
-    userId: string;
-    createdAt: number;
-    expiresAt: number;
-    [key: string]: any;
+  userId: string;
+  createdAt: number;
+  expiresAt: number;
+  [key: string]: any;
 }
 /**
  * In-memory session manager
@@ -10,35 +10,35 @@ interface SessionData {
  * For production, use persistent storage (Redis, Database, etc.)
  */
 export declare class SessionManager {
-    private sessions;
-    constructor();
-    /**
-     * Create a new session with automatic expiration
-     */
-    createSession(userId: string, data?: Record<string, any>): string;
-    /**
-     * Get session with expiration check
-     */
-    getSession(sessionId: string): SessionData | null;
-    /**
-     * Destroy session immediately
-     */
-    destroySession(sessionId: string): void;
-    /**
-     * Verify session is valid and return user ID
-     */
-    verifySession(sessionId: string): string | null;
-    /**
-     * Update session expiration
-     */
-    refreshSession(sessionId: string): boolean;
-    /**
-     * Generate cryptographically secure session ID
-     */
-    private generateSecureSessionId;
-    /**
-     * Clean up expired sessions
-     */
-    private cleanupExpiredSessions;
+  private sessions;
+  constructor();
+  /**
+   * Create a new session with automatic expiration
+   */
+  createSession(userId: string, data?: Record<string, any>): string;
+  /**
+   * Get session with expiration check
+   */
+  getSession(sessionId: string): SessionData | null;
+  /**
+   * Destroy session immediately
+   */
+  destroySession(sessionId: string): void;
+  /**
+   * Verify session is valid and return user ID
+   */
+  verifySession(sessionId: string): string | null;
+  /**
+   * Update session expiration
+   */
+  refreshSession(sessionId: string): boolean;
+  /**
+   * Generate cryptographically secure session ID
+   */
+  private generateSecureSessionId;
+  /**
+   * Clean up expired sessions
+   */
+  private cleanupExpiredSessions;
 }
 export {};

package/templates/static/lib/auth/session.js

@@ -22,90 +22,88 @@ const SESSION_TIMEOUT = parseInt(process.env.SESSION_TIMEOUT ?? "86400000", 10);
  * For production, use persistent storage (Redis, Database, etc.)
  */
 export class SessionManager {
-    sessions = new Map();
-    constructor() {
-        // Cleanup expired sessions every 30 minutes
-        setInterval(() => this.cleanupExpiredSessions(), 30 * 60 * 1000);
+  sessions = new Map();
+  constructor() {
+    // Cleanup expired sessions every 30 minutes
+    setInterval(() => this.cleanupExpiredSessions(), 30 * 60 * 1000);
+  }
+  /**
+   * Create a new session with automatic expiration
+   */
+  createSession(userId, data = {}) {
+    // Validate userId
+    if (!userId || typeof userId !== "string" || userId.length > 255) {
+      throw new Error("Invalid userId");
     }
-    /**
-     * Create a new session with automatic expiration
-     */
-    createSession(userId, data = {}) {
-        // Validate userId
-        if (!userId || typeof userId !== "string" || userId.length > 255) {
-            throw new Error("Invalid userId");
-        }
-        const sessionId = this.generateSecureSessionId();
-        const now = Date.now();
-        const session = {
-            userId,
-            createdAt: now,
-            expiresAt: now + SESSION_TIMEOUT,
-            ...data,
-        };
-        this.sessions.set(sessionId, session);
-        return sessionId;
+    const sessionId = this.generateSecureSessionId();
+    const now = Date.now();
+    const session = {
+      userId,
+      createdAt: now,
+      expiresAt: now + SESSION_TIMEOUT,
+      ...data,
+    };
+    this.sessions.set(sessionId, session);
+    return sessionId;
+  }
+  /**
+   * Get session with expiration check
+   */
+  getSession(sessionId) {
+    if (!sessionId) return null;
+    const session = this.sessions.get(sessionId);
+    if (!session) return null;
+    // Check if session expired
+    if (Date.now() > session.expiresAt) {
+      this.sessions.delete(sessionId);
+      return null;
     }
-    /**
-     * Get session with expiration check
-     */
-    getSession(sessionId) {
-        if (!sessionId)
-            return null;
-        const session = this.sessions.get(sessionId);
-        if (!session)
-            return null;
-        // Check if session expired
-        if (Date.now() > session.expiresAt) {
-            this.sessions.delete(sessionId);
-            return null;
-        }
-        return session;
+    return session;
+  }
+  /**
+   * Destroy session immediately
+   */
+  destroySession(sessionId) {
+    this.sessions.delete(sessionId);
+  }
+  /**
+   * Verify session is valid and return user ID
+   */
+  verifySession(sessionId) {
+    const session = this.getSession(sessionId);
+    return session?.userId ?? null;
+  }
+  /**
+   * Update session expiration
+   */
+  refreshSession(sessionId) {
+    const session = this.getSession(sessionId);
+    if (!session) return false;
+    session.expiresAt = Date.now() + SESSION_TIMEOUT;
+    return true;
+  }
+  /**
+   * Generate cryptographically secure session ID
+   */
+  generateSecureSessionId() {
+    // In production, use crypto.randomBytes
+    const chars =
+      "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < 32; i++) {
+      result += chars.charAt(Math.floor(Math.random() * chars.length));
     }
-    /**
-     * Destroy session immediately
-     */
-    destroySession(sessionId) {
+    return result;
+  }
+  /**
+   * Clean up expired sessions
+   */
+  cleanupExpiredSessions() {
+    const now = Date.now();
+    for (const [sessionId, session] of this.sessions.entries()) {
+      if (now > session.expiresAt) {
         this.sessions.delete(sessionId);
+      }
     }
-    /**
-     * Verify session is valid and return user ID
-     */
-    verifySession(sessionId) {
-        const session = this.getSession(sessionId);
-        return session?.userId ?? null;
-    }
-    /**
-     * Update session expiration
-     */
-    refreshSession(sessionId) {
-        const session = this.getSession(sessionId);
-        if (!session)
-            return false;
-        session.expiresAt = Date.now() + SESSION_TIMEOUT;
-        return true;
-    }
-    /**
-     * Generate cryptographically secure session ID
-     */
-    generateSecureSessionId() {
-        // In production, use crypto.randomBytes
-        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-        let result = "";
-        for (let i = 0; i < 32; i++) {
-            result += chars.charAt(Math.floor(Math.random() * chars.length));
-        }
-        return result;
-    }
-    /**
-     * Clean up expired sessions
-     */
-    cleanupExpiredSessions() {
-        const now = Date.now();
-        for (const [sessionId, session] of this.sessions.entries()) {
-            if (now > session.expiresAt) {
-                this.sessions.delete(sessionId);
-            }
-        }
-    }
+  }
 }

package/templates/static/lib/build/asset-hashing.js

@@ -15,15 +15,15 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { createHash } from 'node:crypto';
-import { readFileSync, renameSync } from 'node:fs';
-import { join, dirname, basename, extname } from 'node:path';
+import { createHash } from "node:crypto";
+import { readFileSync, renameSync } from "node:fs";
+import { join, dirname, basename, extname } from "node:path";
 export class AssetHasher {
     /**
      * Calculate hash of file content
      */
     static hashContent(content) {
-        return createHash('md5').update(content).digest('hex').slice(0, 10);
+        return createHash("md5").update(content).digest("hex").slice(0, 10);
     }
     /**
      * Rename file to include hash (e.g. style.css -> style.a1b2c3.css)

package/templates/static/lib/build/asset-manifest.js

@@ -15,15 +15,15 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { writeFileSync, readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { writeFileSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
 export class AssetManifest {
     manifest = {};
     manifestPath;
     constructor(distDir) {
-        this.manifestPath = join(distDir, 'manifest.json');
+        this.manifestPath = join(distDir, "manifest.json");
         if (existsSync(this.manifestPath)) {
-            this.manifest = JSON.parse(readFileSync(this.manifestPath, 'utf8'));
+            this.manifest = JSON.parse(readFileSync(this.manifestPath, "utf8"));
         }
     }
     set(original, hashed) {

package/templates/static/lib/build/build.d.ts

@@ -1,4 +1,24 @@
 import type { FrameworkConfig } from "../core/config.js";
+/**
+ * Builds a static site by pre-rendering all routes to HTML files.
+ * This is the core static site generation (SSG) function that runs at build time.
+ * It performs the following steps:
+ * 1. Clears the previous build output directory
+ * 2. Discovers all route files in the configured site directory
+ * 3. Renders each route to a static HTML file
+ * 4. Copies static assets from the source directory
+ * 5. Bundles Vue and Svelte components for client-side rehydration
+ * 6. Compiles SCSS to CSS for the global stylesheet
+ *
+ * Routes are rendered with empty req/res objects (SSG mode) to avoid middleware execution.
+ * This produces pure static HTML that can be served by any web server.
+ * Hydration scripts are still injected if the route has hydrate:true, allowing for
+ * optional client-side interactivity in otherwise static pages.
+ *
+ * @param opts Configuration object.
+ * @param opts.config The Jen.js framework configuration.
+ * @throws Logs warnings for missing assets or component bundling failures but does not stop the build.
+ */
 export declare function buildSite(opts: {
     config: FrameworkConfig;
 }): Promise<void>;

package/templates/static/lib/build/build.js

@@ -15,15 +15,23 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { mkdirSync, rmSync, writeFileSync, existsSync, copyFileSync, readdirSync, statSync } from "node:fs";
+import { mkdirSync, rmSync, writeFileSync, existsSync, copyFileSync, readdirSync, statSync, } from "node:fs";
 import { join } from "node:path";
 import esbuild from "esbuild";
 import { createScssCompiler } from "../css/compiler.js";
-import { vueEsbuildPlugin, svelteEsbuildPlugin } from "../compilers/esbuild-plugins.js";
+import { vueEsbuildPlugin, svelteEsbuildPlugin, } from "../compilers/esbuild-plugins.js";
 import { scanRoutes } from "../core/routes/scan.js";
 import { resolveDistPath } from "../core/paths.js";
 import { log } from "../shared/log.js";
 import { renderRouteToHtml } from "../runtime/render.js";
+/**
+ * Recursively copies a directory and all its contents.
+ * Used to copy static assets from the source directory to the build output.
+ * Creates the destination directory structure as needed.
+ *
+ * @param src The source directory path.
+ * @param dst The destination directory path.
+ */
 function copyDir(src, dst) {
     if (!existsSync(src))
         return;
@@ -38,15 +46,39 @@ function copyDir(src, dst) {
             copyFileSync(sp, dp);
     }
 }
+/**
+ * Builds a static site by pre-rendering all routes to HTML files.
+ * This is the core static site generation (SSG) function that runs at build time.
+ * It performs the following steps:
+ * 1. Clears the previous build output directory
+ * 2. Discovers all route files in the configured site directory
+ * 3. Renders each route to a static HTML file
+ * 4. Copies static assets from the source directory
+ * 5. Bundles Vue and Svelte components for client-side rehydration
+ * 6. Compiles SCSS to CSS for the global stylesheet
+ *
+ * Routes are rendered with empty req/res objects (SSG mode) to avoid middleware execution.
+ * This produces pure static HTML that can be served by any web server.
+ * Hydration scripts are still injected if the route has hydrate:true, allowing for
+ * optional client-side interactivity in otherwise static pages.
+ *
+ * @param opts Configuration object.
+ * @param opts.config The Jen.js framework configuration.
+ * @throws Logs warnings for missing assets or component bundling failures but does not stop the build.
+ */
 export async function buildSite(opts) {
     const { config } = opts;
+    // Clear and recreate the dist directory for a clean build.
     const dist = resolveDistPath(config);
     rmSync(dist, { recursive: true, force: true });
     mkdirSync(dist, { recursive: true });
+    // Discover all routes and pre-render each to a static HTML file.
     const routes = scanRoutes(config);
     log.info(`Building SSG: ${routes.length} routes`);
     for (const r of routes) {
+        // Create a synthetic URL for each route. Used as the request URL during rendering.
         const url = new URL("http://localhost" + r.urlPath);
+        // Render the route to HTML. Empty req/res indicates SSG mode (no middleware execution).
         const html = await renderRouteToHtml({
             config,
             route: r,
@@ -56,8 +88,9 @@ export async function buildSite(opts) {
             params: {},
             query: {},
             headers: {},
-            cookies: {}
+            cookies: {},
         });
+        // Calculate output path. Root route goes to index.html, nested routes get their own directories.
         const outPath = r.urlPath === "/"
             ? join(dist, "index.html")
             : join(dist, r.urlPath.slice(1), "index.html");
@@ -65,8 +98,10 @@ export async function buildSite(opts) {
         writeFileSync(outPath, html, "utf8");
         log.info(`SSG: ${r.urlPath} -> ${outPath}`);
     }
+    // Copy static assets from the source assets directory to the built site.
     copyDir(join(process.cwd(), config.siteDir, "assets"), join(dist, "assets"));
-    // Handle Vue/Svelte components in site folder
+    // Bundle Vue and Svelte components found in the site directory.
+    // These are transpiled to JavaScript modules for client-side use in interactive pages.
     const siteSourceDir = join(process.cwd(), config.siteDir);
     const vueFiles = readdirSync(siteSourceDir, { recursive: true }).filter((f) => String(f).endsWith(".vue") || String(f).endsWith(".svelte"));
     if (vueFiles.length > 0) {
@@ -88,13 +123,15 @@ export async function buildSite(opts) {
             log.warn(`Failed to bundle Vue/Svelte components: ${err.message}`);
         }
     }
-    // styles.css
+    // Compile the global SCSS file to CSS.
+    // This stylesheet is injected into every page and contains framework-wide styles.
+    // Minification is enabled for production builds.
     const scssPath = join(process.cwd(), config.css.globalScss);
     if (existsSync(scssPath)) {
         const compiler = createScssCompiler();
         const result = compiler.compile({
             inputPath: scssPath,
-            minified: true
+            minified: true,
         });
         if (result.error) {
             log.error(`SCSS Compilation Failed: ${result.error}`);

package/templates/static/lib/build/island-hydration.js

@@ -40,7 +40,7 @@ export function extractIslandsFromHtml(html) {
         islands.push({
             component: match[1],
             props: JSON.parse(match[2]),
-            id: match[3]
+            id: match[3],
         });
     }
     return islands;
@@ -58,5 +58,5 @@ export function injectIslandScript(html, islands) {
       islands.forEach(i => hydrate(i.component, i.id, i.props));
     </script>
   `;
-    return html.replace('</body>', `${script}</body>`);
+    return html.replace("</body>", `${script}</body>`);
 }

package/templates/static/lib/build/minifier.js

@@ -15,8 +15,8 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import * as esbuild from 'esbuild';
-import { log } from '../shared/log.js';
+import * as esbuild from "esbuild";
+import { log } from "../shared/log.js";
 export class Minifier {
     /**
      * Minify JavaScript/TypeScript using esbuild
@@ -24,15 +24,15 @@ export class Minifier {
     static async minifyJs(code, options = {}) {
         try {
             const result = await esbuild.transform(code, {
-                loader: 'js',
+                loader: "js",
                 minify: true,
-                legalComments: 'none',
-                ...options
+                legalComments: "none",
+                ...options,
             });
             return result.code;
         }
         catch (err) {
-            log.error('Minification failed (JS)');
+            log.error("Minification failed (JS)");
             throw err;
         }
     }
@@ -42,13 +42,13 @@ export class Minifier {
     static async minifyCss(code) {
         try {
             const result = await esbuild.transform(code, {
-                loader: 'css',
-                minify: true
+                loader: "css",
+                minify: true,
             });
             return result.code;
         }
         catch (err) {
-            log.error('Minification failed (CSS)');
+            log.error("Minification failed (CSS)");
             throw err;
         }
     }
@@ -57,9 +57,9 @@ export class Minifier {
      */
     static minifyHtml(html) {
         return html
-            .replace(/<!--[\s\S]*?-->/g, '') // Remove comments
-            .replace(/>\s+</g, '><') // Remove whitespace between tags
-            .replace(/\s{2,}/g, ' ') // Collapse multiple whitespaces
+            .replace(/<!--[\s\S]*?-->/g, "") // Remove comments
+            .replace(/>\s+</g, "><") // Remove whitespace between tags
+            .replace(/\s{2,}/g, " ") // Collapse multiple whitespaces
             .trim();
     }
 }

package/templates/static/lib/build/page-renderer.d.ts

@@ -1,5 +1,5 @@
-import { FrameworkConfig } from '../core/config.js';
-import { RouteEntry } from '../core/routes/scan.js';
+import { FrameworkConfig } from "../core/config.js";
+import { RouteEntry } from "../core/routes/scan.js";
 export interface PageRenderContext {
     config: FrameworkConfig;
     route: RouteEntry;

package/templates/static/lib/build/page-renderer.js

@@ -15,8 +15,8 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { renderRouteToHtml } from '../runtime/render.js';
-import { Minifier } from './minifier.js';
+import { renderRouteToHtml } from "../runtime/render.js";
+import { Minifier } from "./minifier.js";
 export class PageRenderer {
     /**
      * Render a route to a full HTML string, including minification if requested
@@ -32,7 +32,7 @@ export class PageRenderer {
             params: ctx.params,
             query: ctx.query,
             headers: ctx.headers,
-            cookies: ctx.cookies
+            cookies: ctx.cookies,
         });
         // 2. Post-processing (Layout injection, hydration script injection)
         // Note: Hydration logic is handled by island-hydration.ts usually

package/templates/static/lib/build/production-build.d.ts

@@ -1,4 +1,4 @@
-import { FrameworkConfig } from '../core/config.js';
+import { FrameworkConfig } from "../core/config.js";
 export interface ProductionBuildConfig {
     config: FrameworkConfig;
 }

package/templates/static/lib/build/production-build.js

@@ -15,16 +15,16 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { SSGPipeline } from './ssg-pipeline.js';
-import { log } from '../shared/log.js';
+import { SSGPipeline } from "./ssg-pipeline.js";
+import { log } from "../shared/log.js";
 export class ProductionBuilder {
     /**
      * Run the production build sequence
      */
     static async build(opts) {
-        log.info('--- PRODUCTION BUILD START ---');
+        log.info("--- PRODUCTION BUILD START ---");
         const pipeline = new SSGPipeline(opts.config);
         await pipeline.run();
-        log.info('--- PRODUCTION BUILD COMPLETE ---');
+        log.info("--- PRODUCTION BUILD COMPLETE ---");
     }
 }

package/templates/static/lib/build/ssg-pipeline.d.ts

@@ -1,4 +1,4 @@
-import { FrameworkConfig } from '../core/config.js';
+import { FrameworkConfig } from "../core/config.js";
 export declare class SSGPipeline {
     private config;
     private dist;

package/templates/static/lib/build/ssg-pipeline.js

@@ -15,14 +15,14 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { mkdirSync, rmSync, writeFileSync, existsSync, copyFileSync, readdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { scanRoutes } from '../core/routes/scan.js';
-import { resolveDistPath } from '../core/paths.js';
-import { log } from '../shared/log.js';
-import { PageRenderer } from './page-renderer.js';
-import { AssetHasher } from './asset-hashing.js';
-import { createScssCompiler } from '../css/compiler.js';
+import { mkdirSync, rmSync, writeFileSync, existsSync, copyFileSync, readdirSync, statSync, } from "node:fs";
+import { join } from "node:path";
+import { scanRoutes } from "../core/routes/scan.js";
+import { resolveDistPath } from "../core/paths.js";
+import { log } from "../shared/log.js";
+import { PageRenderer } from "./page-renderer.js";
+import { AssetHasher } from "./asset-hashing.js";
+import { createScssCompiler } from "../css/compiler.js";
 export class SSGPipeline {
     config;
     dist;
@@ -34,7 +34,7 @@ export class SSGPipeline {
      * Run the full SSG Pipeline
      */
     async run() {
-        log.info('Starting SSG Pipeline (Enterprise Build)');
+        log.info("Starting SSG Pipeline (Enterprise Build)");
         // 1. Prepare dist
         this.prepareDist();
         // 2. Process Assets
@@ -43,18 +43,18 @@ export class SSGPipeline {
         const cssPath = await this.compileStyles();
         // 4. Render Pages
         await this.renderPages();
-        log.info('Pipeline complete.');
+        log.info("Pipeline complete.");
     }
     prepareDist() {
         rmSync(this.dist, { recursive: true, force: true });
         mkdirSync(this.dist, { recursive: true });
     }
     async processAssets() {
-        const assetDir = join(process.cwd(), this.config.siteDir, 'assets');
-        const targetDir = join(this.dist, 'assets');
+        const assetDir = join(process.cwd(), this.config.siteDir, "assets");
+        const targetDir = join(this.dist, "assets");
         if (existsSync(assetDir)) {
             this.copyRecursive(assetDir, targetDir);
-            log.info('Assets copied to dist');
+            log.info("Assets copied to dist");
         }
     }
     async compileStyles() {
@@ -64,13 +64,13 @@ export class SSGPipeline {
         const compiler = createScssCompiler();
         const result = compiler.compile({
             inputPath: scssPath,
-            minified: true
+            minified: true,
         });
         if (result.error) {
             log.error(`SCSS Failed: ${result.error}`);
             return null;
         }
-        const cssFile = join(this.dist, 'styles.css');
+        const cssFile = join(this.dist, "styles.css");
         writeFileSync(cssFile, result.css);
         // Hash the CSS
         const hashedName = AssetHasher.hashFile(cssFile);
@@ -81,7 +81,7 @@ export class SSGPipeline {
         const routes = scanRoutes(this.config);
         for (const r of routes) {
             try {
-                const url = new URL('http://localhost' + r.urlPath);
+                const url = new URL("http://localhost" + r.urlPath);
                 const html = await PageRenderer.render({
                     config: this.config,
                     route: r,
@@ -89,11 +89,11 @@ export class SSGPipeline {
                     params: {},
                     query: {},
                     headers: {},
-                    cookies: {}
+                    cookies: {},
                 }, true);
-                const outDir = join(this.dist, r.urlPath === '/' ? '' : r.urlPath.slice(1));
+                const outDir = join(this.dist, r.urlPath === "/" ? "" : r.urlPath.slice(1));
                 mkdirSync(outDir, { recursive: true });
-                writeFileSync(join(outDir, 'index.html'), html);
+                writeFileSync(join(outDir, "index.html"), html);
                 log.info(`Rendered ${r.urlPath}`);
             }
             catch (err) {