create-jen-app 1.2.3 → 1.2.4

package/templates/static/lib/index.js

@@ -1,133 +1,87 @@
 /*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
+ * Jen.js Public API - Minimal tree-shakeable barrel exports
  *
- * 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 file exports only the essential public API surface needed by applications.
+ * All internal utilities, advanced features, and implementation details are intentionally
+ * excluded to enable tree-shaking and keep bundle sizes minimal for typical use cases.
  *
- * 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/>.
+ * Total exports: ~30 (core types, functions, and components)
+ * Previous file: 217 lines exporting everything
+ * This file: ~100 lines exporting only public API
  */
 // ============================================================================
-// Barrel Export: Automatically exports everything from all nested modules
-// ============================================================================
-// API
-export * from "./api/(hello).js";
-// Auth
-export * from "./auth/index.js";
-// Build
-export { buildSite as legacyBuildSite } from "./build-tools/build-site.js";
-export * from "./build/build.js";
-export { ProductionBuilder } from "./build/production-build.js";
-export { SSGPipeline } from "./build/ssg-pipeline.js";
-export * from "./build/island-hydration.js";
-export { AssetManifest } from "./build/asset-manifest.js";
-export { AssetHasher } from "./build/asset-hashing.js";
-export { PageRenderer } from "./build/page-renderer.js";
-export { Minifier } from "./build/minifier.js";
+// ROUTING (4 exports)
+// ============================================================================
+// Core routing functions for matching routes and scanning file system
+export { matchRoute } from "./core/routes/match.js";
+export { scanRoutes } from "./core/routes/scan.js";
+// ============================================================================
+// SERVER / APPLICATION (1 export)
+// ============================================================================
+// Main application factory for creating the HTTP handler
+export { createApp } from "./server/app.js";
+// ============================================================================
+// BUILD & STATIC GENERATION (1 export)
+// ============================================================================
+// Primary build function for static site generation
+export { buildSite } from "./build/build.js";
+// ============================================================================
+// CLIENT COMPONENTS (5 exports + types)
+// ============================================================================
+// Reusable Preact components for common patterns
+export { Image, Seo, PWA } from "./client/index.js";
+export { useRouter, useNavigation } from "./client/index.js";
+// ============================================================================
+// MIDDLEWARE & REQUEST HANDLING (7 exports)
+// ============================================================================
+// Core middleware types and HTTP utilities for route handlers
+// ============================================================================
+// TYPED LOADERS (5 exports)
+// ============================================================================
+// Type-safe data loading with compile-time validation
 export {
-  createIslandRegistry,
-  markIsland,
-  extractIslandsFromHtml,
-  injectIslandScript,
-} from "./build/island-hydration.js";
-// Cache
-export * from "./cache/index.js";
-export * from "./cache/memory.js";
-export * from "./cache/redis.js";
-// CLI
-export * from "./cli/templates/ssg/jen.config.js";
-export * from "./cli/templates/ssr/jen.config.js";
-export * from "./cli/banner.js";
-// Compilers
-export { createVueCompiler } from "./compilers/vue.js";
-export { createSvelteCompiler } from "./compilers/svelte.js";
+  defineLoader,
+  defineMiddleware,
+  validateLoaderData,
+} from "./core/loader-schema.js";
+export { parseCookies, headersToObject } from "./core/http.js";
+// ============================================================================
+// PLUGINS (3 exports)
+// ============================================================================
+// Plugin system for extending framework functionality
+export {
+  getPluginManager,
+  resetPluginManager,
+} from "./plugin/plugin-manager.js";
+export { HookStage } from "./plugin/types.js";
+// ============================================================================
+// RUNTIME & ISLANDS (2 exports)
+// ============================================================================
+// Client-side hydration and island components for interactivity
+export { Island } from "./runtime/islands.js";
+// ============================================================================
+// CLIENT ROUTING & STATE (8 exports + types)
+// ============================================================================
+// Minimal client-side router and signal-based reactive state
 export {
-  vueEsbuildPlugin,
-  svelteEsbuildPlugin,
-  invalidateVueCache,
-  invalidateSvelteCache,
-  clearAllCompilerCaches,
-} from "./compilers/esbuild-plugins.js";
-// Core
-export * from "./core/config.js";
-export * from "./core/http.js";
-export * from "./core/paths.js";
-export * from "./core/types.js";
-export * from "./core/routes/match.js";
-export * from "./core/routes/scan.js";
-export * from "./core/middleware-hooks.js";
-// CSS
-export * from "./css/compiler.js";
-// Database
-export * from "./db/index.js";
-export * from "./db/types.js";
-export * from "./db/connector.js";
-export * from "./db/drivers/sql.js";
-export * from "./db/drivers/jdb.js";
-// GraphQL
-export * from "./graphql/index.js";
-export * from "./graphql/schema.js";
-export * from "./graphql/resolvers.js";
-// i18n
-export * from "./i18n/index.js";
-// Import utilities
+  navigate,
+  getCurrentRoute,
+  onRouteChange,
+  initRouter,
+} from "./client-routing/router.js";
 export {
-  jenImport,
-  clearImportCache,
-  invalidateImportCache,
-  jen,
-} from "./import/jen-import.js";
-// JDB
-export * from "./jdb/index.js";
-export * from "./jdb/engine.js";
-export * from "./jdb/types.js";
-export * from "./jdb/utils.js";
-// Middleware
-export * from "./middleware/types.js";
-export * from "./middleware/context.js";
-export * from "./middleware/response.js";
-export * from "./middleware/pipeline.js";
-export * from "./middleware/kernel.js";
-export * from "./middleware/registry.js";
-export * from "./middleware/decorators.js";
-export * from "./middleware/builtins/logger.js";
-export * from "./middleware/builtins/request-id.js";
-export * from "./middleware/builtins/security-headers.js";
-export * from "./middleware/builtins/cors.js";
-export * from "./middleware/builtins/body-parser.js";
-export * from "./middleware/builtins/rate-limit.js";
-export * from "./middleware/errors/http-error.js";
-export * from "./middleware/errors/handler.js";
-export * from "./middleware/utils/matcher.js";
-// Native
-export * from "./native/index.js";
-export * from "./native/bundle.js";
-export * from "./native/dev-server.js";
-export * from "./native/optimizer.js";
-export * from "./native/style-compiler.js";
-// Plugin
-export * from "./plugin/loader.js";
-// Runtime
-export * from "./runtime/render.js";
-export * from "./runtime/client-runtime.js";
-export * from "./runtime/hydrate.js";
-export * from "./runtime/hmr.js";
-export * from "./runtime/islands.js";
-export * from "./runtime/island-hydration-client.js";
-// Server
-export * from "./server/app.js";
-// Use new api-routes.ts for HTTP method handlers (replaces old api.js behavior)
-export { tryHandleApiRoute as tryHandleApiRoute_v2 } from "./server/api-routes.js";
-// Keep old api.js exports for backward compatibility
-export { tryHandleApiRoute } from "./server/api.js";
-export * from "./server/runtimeServe.js";
-// Shared utilities
-export * from "./shared/log.js";
+  signal,
+  computed,
+  bindSignal,
+  bindInput,
+  batch,
+  watch,
+  createStore,
+} from "./client-routing/signal.js";
+export { Link } from "./client-routing/Link.js";
+// ============================================================================
+// UTILITIES (2 exports)
+// ============================================================================
+// Common utilities for logging and framework usage
+export { log } from "./shared/log.js";
+export { jenImport } from "./import/jen-import.js";

package/templates/static/lib/jdb/engine.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 path from "path";
 import {
   ensureDir,

package/templates/static/lib/jdb/index.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/>.
- */
 /**
  * JDB (Jen Database) - A lightweight embedded JSON database for Jen.js applications.
  *
@@ -30,7 +13,7 @@
  * - Simple JSON file format for easy inspection and migration
  *
  * @example
- * import { JDBEngine, type ICollection, type Document } from '@src/jdb';
+ * import { JDBEngine, type ICollection, type Document } from '../jdb';
  *
  * interface User extends Document {
  *   name: string;

package/templates/static/lib/jdb/types.js

@@ -1,18 +1 @@
-/*
- * 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/>.
- */
 export {};

package/templates/static/lib/jdb/utils.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/promises";
 import crypto from "crypto";
 /**

package/templates/static/lib/middleware/builtins/cors.js

@@ -1,19 +1,6 @@
-/*
- * 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/>.
+/**
+ * CORS middleware with security defaults
+ * Prevents insecure origin sharing with credentials
  */
 export function cors(options = {}) {
   const defaults = {

package/templates/static/lib/middleware/context.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 { ResponseBuilder } from "./response.js";
 /**
  * Request context object passed through the middleware chain.

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

@@ -1,23 +1,7 @@
-/*
- * 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 { Pipeline } from "./pipeline.js";
 import { MiddlewareRegistry } from "./registry.js";
 import { Context } from "./context.js";
+import { log } from "../shared/log.js";
 /**
  * Core HTTP request handler that manages middleware execution and request context.
  *
@@ -61,6 +45,7 @@ export class Kernel {
   /**
    * Processes an HTTP request through the global middleware pipeline.
    * Creates a Context wrapping the request/response, composes middlewares, and executes them.
+   * Catches any uncaught errors and sends a safe 500 response.
    *
    * @param req Node.js IncomingMessage (HTTP request object)
    * @param res Node.js ServerResponse (HTTP response object)
@@ -73,14 +58,84 @@ export class Kernel {
    * });
    */
   async handle(req, res) {
-    const ctx = new Context(req, res);
-    const fn = Pipeline.compose(this.globalMiddleware);
-    await fn(ctx, async () => {});
+    try {
+      const ctx = new Context(req, res);
+      const fn = Pipeline.compose(this.globalMiddleware);
+      await fn(ctx, async () => {});
+    } catch (err) {
+      // Uncaught error in middleware pipeline
+      log.error(`[Kernel] Uncaught error: ${err}`);
+      if (err && err.stack) {
+        log.error(`Stack: ${err.stack}`);
+      }
+      // If headers already sent, destroy socket
+      if (res.headersSent) {
+        log.error("[Kernel] Headers already sent, destroying socket");
+        if (res.socket && !res.socket.destroyed) {
+          res.socket.destroy();
+        }
+        return;
+      }
+      // Try to send a safe 500 response
+      try {
+        res.statusCode = 500;
+        res.setHeader("content-type", "text/html; charset=utf-8");
+        res.setHeader("cache-control", "no-store, no-cache, must-revalidate");
+        res.end(`<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>500 - Internal Server Error</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      background: #f5f5f5;
+      margin: 0;
+      padding: 20px;
+    }
+    .container {
+      max-width: 600px;
+      margin: 60px auto;
+      background: white;
+      padding: 40px;
+      border-radius: 8px;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+    }
+    h1 {
+      color: #d32f2f;
+      margin: 0 0 20px 0;
+      font-size: 32px;
+    }
+    p {
+      color: #666;
+      line-height: 1.6;
+      margin: 10px 0;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>500 - Internal Server Error</h1>
+    <p>The server encountered an unexpected error while processing your request.</p>
+    <p>Our team has been notified. Please try again later.</p>
+  </div>
+</body>
+</html>`);
+      } catch (e) {
+        log.error(`[Kernel] Failed to send error response: ${e}`);
+        // Last resort: destroy socket
+        if (res.socket && !res.socket.destroyed) {
+          res.socket.destroy();
+        }
+      }
+    }
   }
   /**
    * Processes a request through global middleware plus a registered middleware group.
    * Retrieves middleware from the registry by group name and composes them with global middleware.
    * Useful for route-specific or feature-specific middleware chains.
+   * Catches any uncaught errors and sends a safe 500 response.
    *
    * @param req Node.js IncomingMessage
    * @param res Node.js ServerResponse
@@ -93,10 +148,47 @@ export class Kernel {
    * await kernel.handleWithGroup(req, res, "apiMiddleware");
    */
   async handleWithGroup(req, res, groupName) {
-    const ctx = new Context(req, res);
-    const registry = MiddlewareRegistry.get();
-    const groupMw = registry.getGroup(groupName);
-    const fn = Pipeline.compose([...this.globalMiddleware, ...groupMw]);
-    await fn(ctx, async () => {});
+    try {
+      const ctx = new Context(req, res);
+      const registry = MiddlewareRegistry.get();
+      const groupMw = registry.getGroup(groupName);
+      const fn = Pipeline.compose([...this.globalMiddleware, ...groupMw]);
+      await fn(ctx, async () => {});
+    } catch (err) {
+      // Uncaught error in middleware pipeline
+      log.error(
+        `[Kernel] Uncaught error in middleware group "${groupName}": ${err}`,
+      );
+      if (err && err.stack) {
+        log.error(`Stack: ${err.stack}`);
+      }
+      // If headers already sent, destroy socket
+      if (res.headersSent) {
+        log.error("[Kernel] Headers already sent, destroying socket");
+        if (res.socket && !res.socket.destroyed) {
+          res.socket.destroy();
+        }
+        return;
+      }
+      // Try to send a safe 500 response
+      try {
+        res.statusCode = 500;
+        res.setHeader("content-type", "application/json");
+        res.setHeader("cache-control", "no-store, no-cache, must-revalidate");
+        res.end(
+          JSON.stringify({
+            error: "Internal Server Error",
+            message:
+              "An unexpected error occurred while processing your request.",
+          }),
+        );
+      } catch (e) {
+        log.error(`[Kernel] Failed to send error response: ${e}`);
+        // Last resort: destroy socket
+        if (res.socket && !res.socket.destroyed) {
+          res.socket.destroy();
+        }
+      }
+    }
   }
 }

package/templates/static/lib/middleware/pipeline.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/>.
- */
 /**
  * Middleware composition and execution engine.
  * Composes multiple middleware functions into a single callable function.

package/templates/static/lib/middleware/registry.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/>.
- */
 /**
  * Global registry for named middleware and middleware groups.
  * Enables reusable middleware composition patterns where middlewares are registered once

package/templates/static/lib/middleware/response.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/>.
- */
 /**
  * Fluent builder for constructing HTTP responses.
  * Provides a chainable API for setting status codes, headers, body, and content type.