create-jen-app 1.2.3 → 1.2.4

package/dist/colors.js

@@ -1,20 +1,3 @@
-/*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <https://www.gnu.org/licenses/>.
- */
 // ANSI color codes for beautiful terminal output
 export const colors = {
     // Main colors

package/dist/create.js

@@ -1,20 +1,3 @@
-/*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * 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 fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -75,6 +58,11 @@ export async function createJenApp() {
                 value: "static",
                 hint: "Fast, lightweight static sites",
             },
+            {
+                label: `${pc.green("SSR & ISR")} - Server-side rendering with incremental static regeneration`,
+                value: "ssr-isr",
+                hint: "Dynamic content with cached pages",
+            },
         ],
     });
     if (isCancel(template)) {

package/dist/generator.js

@@ -1,20 +1,3 @@
-/*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * 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 fs from "fs";
 import path from "path";
 export function copyTemplateFiles(src, dest) {
@@ -45,27 +28,27 @@ export function createProjectFiles(dir, options) {
     }
     // Merge with user project name
     const packageJson = {
-        ...templatePackageJson,
-        name: options.projectName.toLowerCase().replace(/\s+/g, "-"),
-        version: "0.1.0",
+        name: "jen-app",
+        version: "1.0.0",
         type: "module",
         scripts: {
-            ...templatePackageJson.scripts,
-            dev: "jen dev",
-            build: "jen build",
-            start: "jen start",
-            ...(options.typescript && { typecheck: "tsc --noEmit" }),
+            dev: "node server.js dev",
+            build: "node build.js",
         },
         dependencies: {
-            ...templatePackageJson.dependencies,
             "@jenjs/master": "^1.2.5",
+            "@vue/compiler-sfc": "^3.5.28",
+            esbuild: "^0.25.0",
+            glob: "^13.0.5",
+            preact: "^10.25.4",
+            "preact-render-to-string": "^6.5.13",
+            sass: "^1.97.3",
+            sirv: "^3.0.1",
+            svelte: "^5.51.3",
         },
         devDependencies: {
-            ...templatePackageJson.devDependencies,
-            ...(options.typescript && {
-                "@types/node": "^22.10.0",
-                typescript: "^5.7.2",
-            }),
+            "@types/node": "^22.10.0",
+            typescript: "^5.7.2",
         },
     };
     fs.writeFileSync(path.join(dir, "package.json"), JSON.stringify(packageJson, null, 2));

package/dist/index.js

@@ -1 +1,6 @@
-#!/usr/bin/env nodeimport { createJenApp } from "./create.js";createJenApp().catch((error) => {  console.error("\n❌ Error:", error.message);  process.exit(1);});
+#!/usr/bin/env node
+import { createJenApp } from "./create.js";
+createJenApp().catch((error) => {
+    console.error("\n❌ Error:", error.message);
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-jen-app",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Create a beautiful Jen.js application with a single command",
   "type": "module",
   "bin": {

package/templates/ssr-isr/README.md

@@ -0,0 +1,77 @@
+# Jen.js Starter Kit: SSR + ISR
+
+```sh
+npm create jen-app@latest
+```
+
+> ⚡ **Building something cool?** This is an SSR (Server-Side Rendering) + ISR (Incremental Static Regeneration) Jen.js starter template with dynamic rendering and intelligent caching.
+
+## 🚀 Project Structure
+
+Inside your Jen.js project, you'll see the following folders and files:
+
+```text
+/
+├── site/
+│   ├── assets/
+│   │   └── favicon.svg
+│   ├── components/
+│   │   └── Header.tsx
+│   ├── layouts/
+│   │   └── BaseLayout.tsx
+│   ├── pages/
+│   │   └── (index).tsx
+│   ├── styles/
+│   │   └── global.scss
+│   └── jen.config.ts
+├── dist/
+└── package.json
+```
+
+### Key Folders
+
+- **`site/pages/`** → Your routes (file-based routing)
+- **`site/components/`** → Reusable UI components
+- **`site/layouts/`** → Layout wrappers
+- **`site/assets/`** → Public static files
+- **`site/styles/`** → Global styles
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command         | Action                                    |
+| :-------------- | :---------------------------------------- |
+| `npm install`   | Installs dependencies                     |
+| `npm run dev`   | Starts the dev server at `localhost:3001` |
+| `npm run build` | Builds your SSR+ISR app into `./dist/`    |
+
+## 🎯 SSR + ISR Mode
+
+This template uses **Server-Side Rendering (SSR)** with **Incremental Static Regeneration (ISR)**:
+
+- **SSR**: Pages are rendered on-demand on the server when requested
+- **ISR**: Rendered pages are cached and revalidated every `defaultRevalidateSeconds` (default: 3600 seconds / 1 hour)
+
+Configure revalidation in `jen.config.ts`:
+
+```typescript
+rendering: {
+  defaultMode: "ssr",
+  defaultRevalidateSeconds: 3600,  // Revalidate every hour
+},
+```
+
+## 📦 Deployment
+
+SSR+ISR apps require a Node.js runtime:
+
+- **Vercel** - Excellent SSR support
+- **Netlify** - With serverless functions
+- **Railway** - Node.js hosting
+- **Heroku** - Classic Node.js deployment
+- **AWS Lambda** - Via serverless frameworks
+
+## 👀 Want to learn more?
+
+Check the Jen.js documentation (coming soon) or explore the source code to see how routing, SSR, and caching work.

package/templates/ssr-isr/build.js

@@ -0,0 +1,118 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { readdir, stat, readFile, writeFile } from "node:fs/promises";
+import esbuild from "esbuild";
+
+const __filename = fileURLToPath(import.meta.url);
+const currentDir = dirname(__filename);
+const rootDir = join(currentDir, ".");
+
+async function analyze() {
+  console.log("[ANALYZE] Loading bundle analyzer...");
+  const analyzerPath = pathToFileURL(
+    join(rootDir, "lib/build/bundle-analyzer.js"),
+  ).href;
+  const { runBundleAnalyzer } = await import(analyzerPath);
+  const configPath = join(currentDir, "jen.config.ts");
+  const outdir = join(currentDir, ".esbuild");
+  await esbuild.build({
+    entryPoints: [configPath],
+    outdir,
+    format: "esm",
+    platform: "node",
+    target: "es2022",
+    bundle: true,
+    loader: { ".ts": "ts" },
+    logLevel: "silent",
+  });
+  const configFile = join(outdir, "jen.config.js");
+  const config = (await import(pathToFileURL(configFile).href)).default;
+  await runBundleAnalyzer(config);
+  console.log("[ANALYZE] Bundle analysis complete!");
+}
+
+// Embedded Minifier Logic
+const Minifier = {
+  html(input) {
+    return input
+      .replace(/<!--[\s\S]*?-->/g, "")
+      .replace(/>\s+</g, "><")
+      .replace(/\s+/g, " ")
+      .replace(/\s*([{};:,=])\s*/g, "$1")
+      .trim();
+  },
+  css(input) {
+    return input
+      .replace(/\/\*[\s\S]*?\*\//g, "")
+      .replace(/\/\/.*/g, "")
+      .replace(/\s*([{}:;,])\s*/g, "$1")
+      .replace(/\s+/g, " ")
+      .replace(/;\s*}/g, "}")
+      .trim();
+  },
+};
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("analyze")) {
+    await analyze();
+    return;
+  }
+
+  console.log("[BUILD] Starting SSR+ISR build...");
+
+  const configPath = join(currentDir, "jen.config.ts");
+  const outdir = join(currentDir, ".esbuild");
+
+  await esbuild.build({
+    entryPoints: [configPath],
+    outdir,
+    format: "esm",
+    platform: "node",
+    target: "es2022",
+    bundle: true,
+    minify: true,
+    sourcemap: true,
+    loader: { ".ts": "ts" },
+    logLevel: "silent",
+  });
+
+  const configFile = join(outdir, "jen.config.js");
+  const config = (await import(pathToFileURL(configFile).href)).default;
+
+  const buildPath = pathToFileURL(
+    join(rootDir, "lib/build/production-build.js"),
+  ).href;
+  const { buildProduction } = await import(buildPath);
+
+  await buildProduction({ config });
+
+  console.log("[BUILD] Minifying output...");
+
+  async function minifyDir(dir) {
+    try {
+      const files = await readdir(dir);
+      for (const file of files) {
+        const path = join(dir, file);
+        const s = await stat(path);
+        if (s.isDirectory()) {
+          await minifyDir(path);
+        } else if (file.endsWith(".html")) {
+          const content = await readFile(path, "utf-8");
+          await writeFile(path, Minifier.html(content));
+        } else if (file.endsWith(".css")) {
+          const content = await readFile(path, "utf-8");
+          await writeFile(path, Minifier.css(content));
+        }
+      }
+    } catch (e) {
+      if (e.code !== "ENOENT") console.warn("Minification warning:", e.message);
+    }
+  }
+
+  await minifyDir(join(currentDir, config.distDir || "dist"));
+
+  console.log("✅ Site built successfully with SSR+ISR!");
+}
+
+main().catch(console.error);

package/templates/ssr-isr/jen.config.ts

@@ -0,0 +1,109 @@
+const config: FrameworkConfig = {
+  siteDir: "site",
+  distDir: "dist",
+  routes: {
+    fileExtensions: [".tsx", ".jsx", ".ts", ".js"],
+    routeFilePattern: /^\(([^)]+)\)\.(tsx|jsx|ts|js)$/,
+    enableIndexFallback: true,
+  },
+  rendering: {
+    defaultMode: "ssr",
+    defaultRevalidateSeconds: 3600,
+  },
+  inject: {
+    head: [],
+    bodyEnd: [],
+  },
+  css: {
+    globalScss: "site/styles/global.scss",
+  },
+  assets: {
+    publicDir: "site/assets",
+    cacheControl: "public, max-age=3600",
+  },
+  server: {
+    port: 3001,
+    hostname: "localhost",
+  },
+  dev: {
+    liveReload: true,
+  },
+};
+
+export default config;
+
+export type RenderMode = "ssg" | "ssr" | "isr";
+
+export interface FrameworkConfig {
+  /** Root directory where pages/components live */
+  siteDir: string;
+
+  /** Output directory for build artifacts */
+  distDir: string;
+
+  routes: {
+    /** Allowed extensions for route files */
+    fileExtensions: string[];
+
+    /**
+     * Pattern for matching route files.
+     * Example: (hello).tsx -> "hello"
+     */
+    routeFilePattern: RegExp;
+
+    /** If true, /about maps to /about/index */
+    enableIndexFallback: boolean;
+  };
+
+  rendering: {
+    /** Default rendering strategy: ssg, ssr, or isr */
+    defaultMode: RenderMode;
+
+    /**
+     * Default revalidation time in seconds (ISR-like behavior).
+     * 0 = never revalidate (pure SSR).
+     * >0 = revalidate cache after N seconds.
+     */
+    defaultRevalidateSeconds: number;
+  };
+
+  inject: {
+    /**
+     * HTML strings to inject into <head>.
+     * Example: `<meta charset="utf-8">`
+     */
+    head: string[];
+
+    /**
+     * HTML strings injected before </body>.
+     * Example: `<script src="/app.js"></script>`
+     */
+    bodyEnd: string[];
+  };
+
+  css: {
+    /** Path to global SCSS file loaded into every page */
+    globalScss?: string;
+  };
+
+  assets: {
+    /** Directory for static public assets */
+    publicDir: string;
+
+    /** Cache-Control header applied to assets */
+    cacheControl?: string;
+  };
+
+  server: {
+    /** Dev/SSR server port */
+    port: number;
+
+    /** Dev/SSR server hostname */
+    hostname: string;
+  };
+
+  dev: {
+    /** Enables live reload / HMR behavior */
+    liveReload: boolean;
+  };
+}

package/templates/ssr-isr/jenjs.d.ts

@@ -0,0 +1,22 @@
+// Type declarations for local lib/ folder (bundled Jen.js framework)
+declare module "lib" {
+  export * from "./lib/index.js";
+}
+
+declare module "lib/core" {
+  export * from "./lib/core/config.js";
+  export * from "./lib/core/routes/scan.js";
+  export * from "./lib/core/routes/match.js";
+  export * from "./lib/core/middleware-hooks.js";
+  export * from "./lib/core/http.js";
+}
+
+declare module "lib/runtime" {
+  export * from "./lib/runtime/render.js";
+  export * from "./lib/runtime/islands.js";
+}
+
+declare module "lib/server" {
+  export * from "./lib/server/app.js";
+  export * from "./lib/server/ssr.js";
+}

package/templates/ssr-isr/lib/api/(hello).js

@@ -0,0 +1,9 @@
+export default async function handler(ctx) {
+  return {
+    ok: true,
+    message: "Hello from API route",
+    method: ctx.method,
+    query: ctx.query,
+    body: ctx.body,
+  };
+}

package/templates/ssr-isr/lib/auth/cookie-utils.js

@@ -0,0 +1,79 @@
+/**
+ * Generate secure cookie header value
+ */
+export function createSecureCookie(name, value, options = {}) {
+  const defaults = {
+    httpOnly: true, // Prevent XSS token theft
+    secure: process.env.NODE_ENV === "production", // HTTPS only in production
+    sameSite: "Strict", // CSRF protection
+    maxAge: 24 * 60 * 60, // 24 hours
+    path: "/",
+  };
+  const opts = { ...defaults, ...options };
+  let cookieStr = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+  if (opts.maxAge !== undefined) {
+    cookieStr += `; Max-Age=${opts.maxAge}`;
+  }
+  if (opts.path) {
+    cookieStr += `; Path=${opts.path}`;
+  }
+  if (opts.domain) {
+    cookieStr += `; Domain=${opts.domain}`;
+  }
+  if (opts.secure) {
+    cookieStr += "; Secure";
+  }
+  if (opts.httpOnly) {
+    cookieStr += "; HttpOnly";
+  }
+  if (opts.sameSite) {
+    cookieStr += `; SameSite=${opts.sameSite}`;
+  }
+  return cookieStr;
+}
+/**
+ * Parse cookies from request header
+ */
+export function parseCookies(cookieHeader) {
+  const cookies = {};
+  if (!cookieHeader || !cookieHeader.trim()) return cookies;
+  cookieHeader.split(";").forEach((cookie) => {
+    const trimmed = cookie.trim();
+    if (!trimmed) return;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) return;
+    const name = trimmed.substring(0, eqIndex).trim();
+    const value = trimmed.substring(eqIndex + 1).trim();
+    if (name && value) {
+      try {
+        cookies[decodeURIComponent(name)] = decodeURIComponent(value);
+      } catch (err) {
+        // Skip cookies with invalid URI encoding
+        console.warn(
+          `Failed to decode cookie ${name}:`,
+          err instanceof Error ? err.message : String(err),
+        );
+      }
+    }
+  });
+  return cookies;
+}
+/**
+ * Validate session cookie - check all security properties
+ */
+export function validateSessionCookie(header, expectedName = "sessionId") {
+  if (!header) return false;
+  const parts = header.split(";").map((p) => p.trim());
+  const [cookiePair, ...flags] = parts;
+  if (!cookiePair || !cookiePair.includes("=")) return false;
+  const [name] = cookiePair.split("=");
+  if (decodeURIComponent(name) !== expectedName) return false;
+  // Check required security flags
+  const hasHttpOnly = flags.some((f) => f.toLowerCase() === "httponly");
+  const hasSameSite = flags.some((f) => f.toLowerCase().startsWith("samesite"));
+  const isSecure =
+    process.env.NODE_ENV === "production"
+      ? flags.some((f) => f.toLowerCase() === "secure")
+      : true;
+  return hasHttpOnly && hasSameSite && isSecure;
+}

package/templates/ssr-isr/lib/auth/index.js

@@ -0,0 +1,2 @@
+export * from "./jwt";
+export * from "./session";

package/templates/ssr-isr/lib/auth/jwt.js

@@ -0,0 +1,57 @@
+/**
+ * JWT token utilities for creating and validating JSON Web Tokens.
+ * This module provides stub implementations that require an external JWT library.
+ * Users must install a JWT library (e.g., jsonwebtoken) and implement these functions
+ * using that library's APIs to enable authentication features.
+ *
+ * The module validates that JWT_SECRET is configured in the environment,
+ * ensuring token signing and verification can proceed securely.
+ */
+// JWT signing and verification require an external library not included by default.
+// Users should install jsonwebtoken: npm install jsonwebtoken
+const SECRET = process.env.JWT_SECRET;
+// Validate that JWT_SECRET is set. This environment variable is required for all token operations.
+// Without a secret, tokens cannot be securely signed or verified.
+if (!SECRET) {
+  throw new Error(
+    "CRITICAL: JWT_SECRET environment variable is required. Set JWT_SECRET in your .env file or environment.",
+  );
+}
+/**
+ * Creates a signed JWT token containing the provided payload.
+ * This function is a stub that requires implementing with an external JWT library.
+ *
+ * @param payload The data to encode in the token.
+ * @param expiresIn Token expiration time (default "1h"). Format: "1h", "7d", "30s", etc.
+ * @returns The signed JWT token as a string.
+ * @throws Error indicating that a JWT library must be installed.
+ *
+ * @example
+ * const token = signToken({ userId: 123, role: 'admin' }, '24h');
+ * // Implementation using jsonwebtoken:
+ * // jwt.sign(payload, SECRET, { expiresIn });
+ */
+export function signToken(payload, expiresIn = "1h") {
+  throw new Error(
+    "JWT implementation requires external library. Install: npm install jsonwebtoken",
+  );
+}
+/**
+ * Verifies and decodes a JWT token, returning the payload if valid.
+ * This function is a stub that requires implementing with an external JWT library.
+ *
+ * @param token The JWT token string to verify.
+ * @returns The decoded payload from the token.
+ * @throws Error indicating that a JWT library must be installed.
+ * @throws Error if the token is invalid, expired, or fails verification.
+ *
+ * @example
+ * const payload = verifyToken(token);
+ * // Implementation using jsonwebtoken:
+ * // jwt.verify(token, SECRET);
+ */
+export function verifyToken(token) {
+  throw new Error(
+    "JWT implementation requires external library. Install: npm install jsonwebtoken",
+  );
+}