create-jen-app 1.2.1 → 1.2.3

package/templates/static/lib/middleware/response.js

@@ -15,46 +15,110 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
+/**
+ * Fluent builder for constructing HTTP responses.
+ * Provides a chainable API for setting status codes, headers, body, and content type.
+ * Delegates actual response sending to the underlying Node.js ServerResponse.
+ *
+ * This builder is used in the Context to provide convenient response composition
+ * without manually managing headers and response state.
+ *
+ * @example
+ * ctx.response
+ *   .status(201)
+ *   .header('X-Custom', 'value')
+ *   .json({ id: 123, name: 'Alice' })
+ *   .send();
+ */
 export class ResponseBuilder {
-    statusCode = 200;
-    headers = {};
-    body = null;
-    res;
-    constructor(res) {
-        this.res = res;
-    }
-    status(code) {
-        this.statusCode = code;
-        return this;
-    }
-    header(key, value) {
-        this.headers[key] = value;
-        return this;
-    }
-    json(data) {
-        this.header("Content-Type", "application/json");
-        this.body = JSON.stringify(data);
-        return this;
-    }
-    html(html) {
-        this.header("Content-Type", "text/html");
-        this.body = html;
-        return this;
-    }
-    text(text) {
-        this.header("Content-Type", "text/plain");
-        this.body = text;
-        return this;
-    }
-    send() {
-        if (this.res.writableEnded)
-            return;
-        this.res.writeHead(this.statusCode, this.headers);
-        if (this.body !== null && this.body !== undefined) {
-            this.res.end(this.body);
-        }
-        else {
-            this.res.end();
-        }
+  // HTTP status code to send (default 200 OK).
+  statusCode = 200;
+  // Header key-value pairs to include in the response.
+  headers = {};
+  // Response body content (string, Buffer, or null for empty body).
+  body = null;
+  // The underlying Node.js ServerResponse object.
+  res;
+  /**
+   * Initializes a ResponseBuilder with the given ServerResponse.
+   *
+   * @param res The Node.js ServerResponse object to write to.
+   */
+  constructor(res) {
+    this.res = res;
+  }
+  /**
+   * Sets the HTTP status code for the response.
+   *
+   * @param code The HTTP status code (e.g., 200, 404, 500).
+   * @returns This ResponseBuilder instance for method chaining.
+   */
+  status(code) {
+    this.statusCode = code;
+    return this;
+  }
+  /**
+   * Adds an HTTP response header.
+   * Multiple calls with the same key overwrite previous values.
+   *
+   * @param key The header name.
+   * @param value The header value.
+   * @returns This ResponseBuilder instance for method chaining.
+   */
+  header(key, value) {
+    this.headers[key] = value;
+    return this;
+  }
+  /**
+   * Sets the response body to a JSON-serialized object and sets Content-Type header.
+   * Automatically sets Content-Type to application/json.
+   *
+   * @param data The object to serialize as JSON.
+   * @returns This ResponseBuilder instance for method chaining.
+   */
+  json(data) {
+    this.header("Content-Type", "application/json");
+    this.body = JSON.stringify(data);
+    return this;
+  }
+  /**
+   * Sets the response body to HTML content and sets Content-Type header.
+   * Automatically sets Content-Type to text/html.
+   *
+   * @param html The HTML string to send.
+   * @returns This ResponseBuilder instance for method chaining.
+   */
+  html(html) {
+    this.header("Content-Type", "text/html");
+    this.body = html;
+    return this;
+  }
+  /**
+   * Sets the response body to plain text and sets Content-Type header.
+   * Automatically sets Content-Type to text/plain.
+   *
+   * @param text The plain text string to send.
+   * @returns This ResponseBuilder instance for method chaining.
+   */
+  text(text) {
+    this.header("Content-Type", "text/plain");
+    this.body = text;
+    return this;
+  }
+  /**
+   * Sends the response to the client.
+   * Writes the status code, headers, and body to the underlying ServerResponse.
+   * Does nothing if the response has already been sent (writableEnded is true).
+   *
+   * @returns Void. The underlying res.end() return value is not propagated.
+   */
+  send() {
+    if (this.res.writableEnded) return;
+    this.res.writeHead(this.statusCode, this.headers);
+    if (this.body !== null && this.body !== undefined) {
+      this.res.end(this.body);
+    } else {
+      this.res.end();
     }
+  }
 }

package/templates/static/lib/middleware/utils/matcher.js

@@ -16,16 +16,15 @@
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
 export function matchPath(pattern, path) {
-    if (pattern === "*")
-        return true;
-    if (pattern === path)
-        return true;
-    // Basic glob: * matches anything
-    const regexString = "^" +
-        pattern
-            .replace(/[.+?^${}()|[\\]/g, "\\$&") // escape regex characters
-            .replace(/\*/g, ".*") +
-        "$"; // convert * to .*
-    const regex = new RegExp(regexString);
-    return regex.test(path);
+  if (pattern === "*") return true;
+  if (pattern === path) return true;
+  // Basic glob: * matches anything
+  const regexString =
+    "^" +
+    pattern
+      .replace(/[.+?^${}()|[\\]/g, "\\$&") // escape regex characters
+      .replace(/\*/g, ".*") +
+    "$"; // convert * to .*
+  const regex = new RegExp(regexString);
+  return regex.test(path);
 }

package/templates/static/lib/native/bundle.d.ts

@@ -1,12 +1,13 @@
 import esbuild from "esbuild";
 export interface BundlerOptions {
-    entryPoint: string;
-    outdir?: string;
-    format?: "esm" | "cjs" | "iife";
-    minify?: boolean;
-    sourcemap?: boolean;
+  entryPoint: string;
+  outdir?: string;
+  format?: "esm" | "cjs" | "iife";
+  minify?: boolean;
+  sourcemap?: boolean;
 }
-export declare function bundle(opts: BundlerOptions): Promise<esbuild.BuildResult<{
+export declare function bundle(opts: BundlerOptions): Promise<
+  esbuild.BuildResult<{
     entryPoints: string[];
     outdir: string;
     format: "esm" | "iife" | "cjs";
@@ -15,5 +16,9 @@ export declare function bundle(opts: BundlerOptions): Promise<esbuild.BuildResul
     platform: "browser";
     target: string;
     logLevel: "info";
-}>>;
-export declare function bundleAssets(assetsDir: string, outdir: string): Promise<void>;
+  }>
+>;
+export declare function bundleAssets(
+  assetsDir: string,
+  outdir: string,
+): Promise<void>;

package/templates/static/lib/native/bundle.js

@@ -20,20 +20,20 @@
 // Currently: esbuild wrapper (use native C++ bundler in production)
 import esbuild from "esbuild";
 export async function bundle(opts) {
-    const result = await esbuild.build({
-        entryPoints: [opts.entryPoint],
-        outdir: opts.outdir || "dist",
-        format: opts.format || "esm",
-        minify: opts.minify ?? false,
-        sourcemap: opts.sourcemap ?? false,
-        platform: "browser",
-        target: "es2022",
-        logLevel: "info",
-    });
-    return result;
+  const result = await esbuild.build({
+    entryPoints: [opts.entryPoint],
+    outdir: opts.outdir || "dist",
+    format: opts.format || "esm",
+    minify: opts.minify ?? false,
+    sourcemap: opts.sourcemap ?? false,
+    platform: "browser",
+    target: "es2022",
+    logLevel: "info",
+  });
+  return result;
 }
 export async function bundleAssets(assetsDir, outdir) {
-    // Copy assets with optional optimization
-    console.log(`[BUNDLER] Packaging assets from ${assetsDir} to ${outdir}`);
-    // Implementation: use native bundler for CSS/image optimization
+  // Copy assets with optional optimization
+  console.log(`[BUNDLER] Packaging assets from ${assetsDir} to ${outdir}`);
+  // Implementation: use native bundler for CSS/image optimization
 }

package/templates/static/lib/native/dev-server.d.ts

@@ -1,6 +1,13 @@
 export interface DevServerOptions {
-    port?: number;
-    hostname?: string;
-    root?: string;
+  port?: number;
+  hostname?: string;
+  root?: string;
 }
-export declare function startDevServer(opts?: DevServerOptions): Promise<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>>;
+export declare function startDevServer(
+  opts?: DevServerOptions,
+): Promise<
+  import("node:http").Server<
+    typeof import("node:http").IncomingMessage,
+    typeof import("node:http").ServerResponse
+  >
+>;

package/templates/static/lib/native/dev-server.js

@@ -20,19 +20,21 @@
 // Currently: TypeScript implementation (use Bun or esbuild-serve in production)
 import { createServer } from "node:http";
 export async function startDevServer(opts = {}) {
-    const port = opts.port || 5173;
-    const hostname = opts.hostname || "0.0.0.0";
-    const root = opts.root || process.cwd();
-    const server = createServer((req, res) => {
-        res.writeHead(200, { "content-type": "text/plain" });
-        res.end("TypeScript dev server stub (replace with Rust native build in production)\n");
-    });
-    server.listen(port, hostname, () => {
-        console.log(`[DEV SERVER] Listening on http://${hostname}:${port}`);
-    });
-    return server;
+  const port = opts.port || 5173;
+  const hostname = opts.hostname || "0.0.0.0";
+  const root = opts.root || process.cwd();
+  const server = createServer((req, res) => {
+    res.writeHead(200, { "content-type": "text/plain" });
+    res.end(
+      "TypeScript dev server stub (replace with Rust native build in production)\n",
+    );
+  });
+  server.listen(port, hostname, () => {
+    console.log(`[DEV SERVER] Listening on http://${hostname}:${port}`);
+  });
+  return server;
 }
 // Export default for direct execution
 if (import.meta.url === `file://${process.argv[1]}`) {
-    startDevServer();
+  startDevServer();
 }

package/templates/static/lib/native/index.d.ts

@@ -7,24 +7,24 @@ export type { StyleCompilerOptions } from "./style-compiler.js";
 export { optimize, optimizeImages, minifyHTML } from "./optimizer.js";
 export type { OptimizerOptions } from "./optimizer.js";
 export declare const NATIVE_MODULES: {
-    devServer: {
-        name: string;
-        status: string;
-        implementation: string;
-    };
-    bundler: {
-        name: string;
-        status: string;
-        implementation: string;
-    };
-    styleCompiler: {
-        name: string;
-        status: string;
-        implementation: string;
-    };
-    optimizer: {
-        name: string;
-        status: string;
-        implementation: string;
-    };
+  devServer: {
+    name: string;
+    status: string;
+    implementation: string;
+  };
+  bundler: {
+    name: string;
+    status: string;
+    implementation: string;
+  };
+  styleCompiler: {
+    name: string;
+    status: string;
+    implementation: string;
+  };
+  optimizer: {
+    name: string;
+    status: string;
+    implementation: string;
+  };
 };

package/templates/static/lib/native/index.js

@@ -24,25 +24,27 @@ export { compileScss, compileCSS, watchStyles } from "./style-compiler.js";
 export { optimize, optimizeImages, minifyHTML } from "./optimizer.js";
 // Native module status
 export const NATIVE_MODULES = {
-    devServer: {
-        name: "dev-server",
-        status: "stub",
-        implementation: "TypeScript",
-    },
-    bundler: {
-        name: "bundler",
-        status: "stub",
-        implementation: "esbuild wrapper",
-    },
-    styleCompiler: {
-        name: "style-compiler",
-        status: "stub",
-        implementation: "TypeScript",
-    },
-    optimizer: {
-        name: "optimizer",
-        status: "stub",
-        implementation: "TypeScript",
-    },
+  devServer: {
+    name: "dev-server",
+    status: "stub",
+    implementation: "TypeScript",
+  },
+  bundler: {
+    name: "bundler",
+    status: "stub",
+    implementation: "esbuild wrapper",
+  },
+  styleCompiler: {
+    name: "style-compiler",
+    status: "stub",
+    implementation: "TypeScript",
+  },
+  optimizer: {
+    name: "optimizer",
+    status: "stub",
+    implementation: "TypeScript",
+  },
 };
-console.log("[NATIVE MODULES] Loaded (TypeScript stubs - replace with native bindings in production)");
+console.log(
+  "[NATIVE MODULES] Loaded (TypeScript stubs - replace with native bindings in production)",
+);

package/templates/static/lib/native/optimizer.d.ts

@@ -1,17 +1,21 @@
 export interface OptimizerOptions {
-    files: string[];
-    minify?: boolean;
-    compress?: boolean;
-    imageOptimization?: boolean;
+  files: string[];
+  minify?: boolean;
+  compress?: boolean;
+  imageOptimization?: boolean;
 }
 export declare function optimize(opts: OptimizerOptions): Promise<{
-    originalSize: number;
-    optimizedSize: number;
-    savings: number;
-    files: string[];
+  originalSize: number;
+  optimizedSize: number;
+  savings: number;
+  files: string[];
 }>;
-export declare function optimizeImages(inputDir: string, outputDir: string, options?: {
+export declare function optimizeImages(
+  inputDir: string,
+  outputDir: string,
+  options?: {
     format?: "webp" | "avif";
     quality?: number;
-}): Promise<void>;
+  },
+): Promise<void>;
 export declare function minifyHTML(html: string): Promise<string>;

package/templates/static/lib/native/optimizer.js

@@ -16,22 +16,22 @@
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
 export async function optimize(opts) {
-    console.log(`[OPTIMIZER] Optimizing ${opts.files.length} files`);
-    // Placeholder: simulated optimization results
-    const originalSize = 1024 * 100; // 100KB
-    const optimizedSize = 1024 * 75; // 75KB (25% reduction)
-    return {
-        originalSize,
-        optimizedSize,
-        savings: originalSize - optimizedSize,
-        files: opts.files,
-    };
+  console.log(`[OPTIMIZER] Optimizing ${opts.files.length} files`);
+  // Placeholder: simulated optimization results
+  const originalSize = 1024 * 100; // 100KB
+  const optimizedSize = 1024 * 75; // 75KB (25% reduction)
+  return {
+    originalSize,
+    optimizedSize,
+    savings: originalSize - optimizedSize,
+    files: opts.files,
+  };
 }
 export async function optimizeImages(inputDir, outputDir, options = {}) {
-    console.log(`[OPTIMIZER] Image optimization: ${inputDir} -> ${outputDir}`);
-    // Placeholder: would use native image processing
+  console.log(`[OPTIMIZER] Image optimization: ${inputDir} -> ${outputDir}`);
+  // Placeholder: would use native image processing
 }
 export async function minifyHTML(html) {
-    // Simple minification placeholder
-    return html.replace(/\s+/g, " ").replace(/>\s+</g, "><").trim();
+  // Simple minification placeholder
+  return html.replace(/\s+/g, " ").replace(/>\s+</g, "><").trim();
 }

package/templates/static/lib/native/style-compiler.d.ts

@@ -1,10 +1,19 @@
 export interface StyleCompilerOptions {
-    input: string;
-    output?: string;
-    minify?: boolean;
-    sourcemap?: boolean;
-    includePaths?: string[];
+  input: string;
+  output?: string;
+  minify?: boolean;
+  sourcemap?: boolean;
+  includePaths?: string[];
 }
-export declare function compileScss(opts: StyleCompilerOptions): Promise<string>;
-export declare function compileCSS(input: string, minify?: boolean): Promise<string>;
-export declare function watchStyles(input: string, output: string, onChange: (css: string) => void): Promise<void>;
+export declare function compileScss(
+  opts: StyleCompilerOptions,
+): Promise<string>;
+export declare function compileCSS(
+  input: string,
+  minify?: boolean,
+): Promise<string>;
+export declare function watchStyles(
+  input: string,
+  output: string,
+  onChange: (css: string) => void,
+): Promise<void>;

package/templates/static/lib/native/style-compiler.js

@@ -16,21 +16,21 @@
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
 export async function compileScss(opts) {
-    // Placeholder: returns CSS placeholder
-    console.log(`[STYLE COMPILER] Compiling SCSS: ${opts.input}`);
-    const css = `
+  // Placeholder: returns CSS placeholder
+  console.log(`[STYLE COMPILER] Compiling SCSS: ${opts.input}`);
+  const css = `
     /* SCSS compiled from: ${opts.input} */
     /* Note: Full SCSS compilation requires dart-sass or native Rust implementation */
     body { margin: 0; padding: 0; }
   `;
-    return css;
+  return css;
 }
 export async function compileCSS(input, minify = false) {
-    console.log(`[STYLE COMPILER] Processing CSS: ${input}`);
-    // Placeholder: returns input CSS
-    return input;
+  console.log(`[STYLE COMPILER] Processing CSS: ${input}`);
+  // Placeholder: returns input CSS
+  return input;
 }
 export async function watchStyles(input, output, onChange) {
-    // Placeholder watcher
-    console.log(`[STYLE COMPILER] Watching: ${input}`);
+  // Placeholder watcher
+  console.log(`[STYLE COMPILER] Watching: ${input}`);
 }

package/templates/static/lib/plugin/loader.d.ts

@@ -1,8 +1,10 @@
 export interface Plugin {
-    name: string;
-    version?: string;
-    onBuild?: () => void | Promise<void>;
-    onServe?: () => void | Promise<void>;
-    onDeploy?: () => void | Promise<void>;
+  name: string;
+  version?: string;
+  onBuild?: () => void | Promise<void>;
+  onServe?: () => void | Promise<void>;
+  onDeploy?: () => void | Promise<void>;
 }
-export declare function runPlugins(event?: "build" | "serve" | "deploy"): Promise<void>;
+export declare function runPlugins(
+  event?: "build" | "serve" | "deploy",
+): Promise<void>;

package/templates/static/lib/plugin/loader.js

@@ -23,37 +23,31 @@ import { pathToFileURL } from "node:url";
 import { log } from "../shared/log.js";
 const PLUGIN_DIR = "src/plugin/plugins";
 export async function runPlugins(event = "build") {
-    log.info(`Running plugins (${event})...`);
-    try {
-        const files = readdirSync(PLUGIN_DIR);
-        for (const file of files) {
-            if (!file.endsWith(".ts") && !file.endsWith(".js"))
-                continue;
-            const pluginPath = join(process.cwd(), PLUGIN_DIR, file);
-            const pluginUrl = pathToFileURL(pluginPath).href;
-            try {
-                const module = (await import(pluginUrl));
-                const plugin = module.default;
-                if (!plugin)
-                    continue;
-                log.info(`  Loading plugin: ${plugin.name}`);
-                if (event === "build" && plugin.onBuild) {
-                    await plugin.onBuild();
-                }
-                else if (event === "serve" && plugin.onServe) {
-                    await plugin.onServe();
-                }
-                else if (event === "deploy" && plugin.onDeploy) {
-                    await plugin.onDeploy();
-                }
-            }
-            catch (err) {
-                log.error(`  Plugin error: ${file} - ${String(err)}`);
-            }
+  log.info(`Running plugins (${event})...`);
+  try {
+    const files = readdirSync(PLUGIN_DIR);
+    for (const file of files) {
+      if (!file.endsWith(".ts") && !file.endsWith(".js")) continue;
+      const pluginPath = join(process.cwd(), PLUGIN_DIR, file);
+      const pluginUrl = pathToFileURL(pluginPath).href;
+      try {
+        const module = await import(pluginUrl);
+        const plugin = module.default;
+        if (!plugin) continue;
+        log.info(`  Loading plugin: ${plugin.name}`);
+        if (event === "build" && plugin.onBuild) {
+          await plugin.onBuild();
+        } else if (event === "serve" && plugin.onServe) {
+          await plugin.onServe();
+        } else if (event === "deploy" && plugin.onDeploy) {
+          await plugin.onDeploy();
         }
-        log.info("Plugins executed.");
-    }
-    catch (err) {
-        log.warn(`Plugin directory not found: ${PLUGIN_DIR}`);
+      } catch (err) {
+        log.error(`  Plugin error: ${file} - ${String(err)}`);
+      }
     }
+    log.info("Plugins executed.");
+  } catch (err) {
+    log.warn(`Plugin directory not found: ${PLUGIN_DIR}`);
+  }
 }

package/templates/static/lib/runtime/client-runtime.d.ts

@@ -1 +1,16 @@
+/**
+ * Retrieve framework data injected by the server into the page HTML.
+ * The server embeds loader result data, route params, and query parameters
+ * into a hidden DOM element with id "__FRAMEWORK_DATA__" as JSON.
+ *
+ * This data is passed to page components during hydration as props.
+ * Returns null if the element does not exist or JSON is malformed,
+ * allowing graceful degradation without throwing errors.
+ *
+ * Usage:
+ *   const data = getFrameworkData();
+ *   // data = { data: {...}, params: {...}, query: {...} }
+ *
+ * @returns Framework data object { data, params, query } or null if not found.
+ */
 export declare function getFrameworkData(): any;