npm - alepha - Versions diffs - 0.15.2 → 0.15.4 - Mend

alepha 0.15.2 → 0.15.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (180) hide show

package/README.md +68 -80
package/dist/api/audits/index.d.ts.map +1 -1
package/dist/api/audits/index.js +8 -0
package/dist/api/audits/index.js.map +1 -1
package/dist/api/files/index.d.ts +170 -170
package/dist/api/files/index.d.ts.map +1 -1
package/dist/api/files/index.js +1 -0
package/dist/api/files/index.js.map +1 -1
package/dist/api/jobs/index.d.ts.map +1 -1
package/dist/api/jobs/index.js +3 -0
package/dist/api/jobs/index.js.map +1 -1
package/dist/api/notifications/index.browser.js +1 -0
package/dist/api/notifications/index.browser.js.map +1 -1
package/dist/api/notifications/index.js +1 -0
package/dist/api/notifications/index.js.map +1 -1
package/dist/api/parameters/index.d.ts +260 -260
package/dist/api/parameters/index.d.ts.map +1 -1
package/dist/api/parameters/index.js +10 -0
package/dist/api/parameters/index.js.map +1 -1
package/dist/api/users/index.d.ts +12 -1
package/dist/api/users/index.d.ts.map +1 -1
package/dist/api/users/index.js +18 -2
package/dist/api/users/index.js.map +1 -1
package/dist/batch/index.d.ts +4 -4
package/dist/bucket/index.d.ts +8 -0
package/dist/bucket/index.d.ts.map +1 -1
package/dist/bucket/index.js +7 -2
package/dist/bucket/index.js.map +1 -1
package/dist/cli/index.d.ts +196 -74
package/dist/cli/index.d.ts.map +1 -1
package/dist/cli/index.js +234 -50
package/dist/cli/index.js.map +1 -1
package/dist/command/index.d.ts +10 -0
package/dist/command/index.d.ts.map +1 -1
package/dist/command/index.js +67 -13
package/dist/command/index.js.map +1 -1
package/dist/core/index.browser.js +28 -21
package/dist/core/index.browser.js.map +1 -1
package/dist/core/index.d.ts.map +1 -1
package/dist/core/index.js +28 -21
package/dist/core/index.js.map +1 -1
package/dist/core/index.native.js +28 -21
package/dist/core/index.native.js.map +1 -1
package/dist/email/index.d.ts +21 -13
package/dist/email/index.d.ts.map +1 -1
package/dist/email/index.js +10561 -4
package/dist/email/index.js.map +1 -1
package/dist/lock/core/index.d.ts +6 -1
package/dist/lock/core/index.d.ts.map +1 -1
package/dist/lock/core/index.js +9 -1
package/dist/lock/core/index.js.map +1 -1
package/dist/mcp/index.d.ts +5 -5
package/dist/orm/index.bun.js +32 -16
package/dist/orm/index.bun.js.map +1 -1
package/dist/orm/index.d.ts +4 -1
package/dist/orm/index.d.ts.map +1 -1
package/dist/orm/index.js +34 -22
package/dist/orm/index.js.map +1 -1
package/dist/react/auth/index.browser.js +2 -1
package/dist/react/auth/index.browser.js.map +1 -1
package/dist/react/auth/index.js +2 -1
package/dist/react/auth/index.js.map +1 -1
package/dist/react/core/index.d.ts +3 -3
package/dist/react/router/index.browser.js +9 -15
package/dist/react/router/index.browser.js.map +1 -1
package/dist/react/router/index.d.ts +305 -407
package/dist/react/router/index.d.ts.map +1 -1
package/dist/react/router/index.js +581 -781
package/dist/react/router/index.js.map +1 -1
package/dist/scheduler/index.d.ts +13 -1
package/dist/scheduler/index.d.ts.map +1 -1
package/dist/scheduler/index.js +42 -4
package/dist/scheduler/index.js.map +1 -1
package/dist/security/index.d.ts +42 -42
package/dist/security/index.d.ts.map +1 -1
package/dist/security/index.js +8 -7
package/dist/security/index.js.map +1 -1
package/dist/server/auth/index.d.ts +167 -167
package/dist/server/compress/index.d.ts.map +1 -1
package/dist/server/compress/index.js +1 -0
package/dist/server/compress/index.js.map +1 -1
package/dist/server/health/index.d.ts +17 -17
package/dist/server/links/index.d.ts +39 -39
package/dist/server/links/index.js +1 -1
package/dist/server/links/index.js.map +1 -1
package/dist/server/static/index.js +7 -2
package/dist/server/static/index.js.map +1 -1
package/dist/server/swagger/index.d.ts +8 -0
package/dist/server/swagger/index.d.ts.map +1 -1
package/dist/server/swagger/index.js +7 -2
package/dist/server/swagger/index.js.map +1 -1
package/dist/sms/index.d.ts +8 -0
package/dist/sms/index.d.ts.map +1 -1
package/dist/sms/index.js +7 -2
package/dist/sms/index.js.map +1 -1
package/dist/system/index.browser.js +734 -12
package/dist/system/index.browser.js.map +1 -1
package/dist/system/index.d.ts +8 -0
package/dist/system/index.d.ts.map +1 -1
package/dist/system/index.js +7 -2
package/dist/system/index.js.map +1 -1
package/dist/vite/index.d.ts +3 -2
package/dist/vite/index.d.ts.map +1 -1
package/dist/vite/index.js +42 -8
package/dist/vite/index.js.map +1 -1
package/dist/websocket/index.d.ts +34 -34
package/dist/websocket/index.d.ts.map +1 -1
package/package.json +9 -4
package/src/api/audits/controllers/AdminAuditController.ts +8 -0
package/src/api/files/controllers/AdminFileStatsController.ts +1 -0
package/src/api/jobs/controllers/AdminJobController.ts +3 -0
package/src/api/logs/TODO.md +13 -10
package/src/api/notifications/controllers/AdminNotificationController.ts +1 -0
package/src/api/parameters/controllers/AdminConfigController.ts +10 -0
package/src/api/users/controllers/AdminIdentityController.ts +3 -0
package/src/api/users/controllers/AdminSessionController.ts +3 -0
package/src/api/users/controllers/AdminUserController.ts +5 -0
package/src/cli/apps/AlephaPackageBuilderCli.ts +9 -0
package/src/cli/atoms/buildOptions.ts +99 -9
package/src/cli/commands/build.ts +150 -32
package/src/cli/commands/db.ts +5 -7
package/src/cli/commands/init.spec.ts +50 -6
package/src/cli/commands/init.ts +28 -5
package/src/cli/providers/ViteDevServerProvider.ts +31 -9
package/src/cli/services/AlephaCliUtils.ts +16 -0
package/src/cli/services/PackageManagerUtils.ts +2 -0
package/src/cli/services/ProjectScaffolder.spec.ts +97 -0
package/src/cli/services/ProjectScaffolder.ts +28 -6
package/src/cli/templates/agentMd.ts +6 -1
package/src/cli/templates/apiAppSecurityTs.ts +11 -0
package/src/cli/templates/apiIndexTs.ts +18 -4
package/src/cli/templates/webAppRouterTs.ts +25 -1
package/src/cli/templates/webHelloComponentTsx.ts +15 -5
package/src/command/helpers/Runner.spec.ts +135 -0
package/src/command/helpers/Runner.ts +4 -1
package/src/command/providers/CliProvider.spec.ts +325 -0
package/src/command/providers/CliProvider.ts +117 -7
package/src/core/Alepha.ts +32 -25
package/src/email/index.workerd.ts +36 -0
package/src/email/providers/WorkermailerEmailProvider.ts +221 -0
package/src/lock/core/primitives/$lock.ts +13 -1
package/src/orm/index.bun.ts +1 -1
package/src/orm/index.ts +2 -6
package/src/orm/providers/drivers/BunSqliteProvider.ts +4 -1
package/src/orm/providers/drivers/CloudflareD1Provider.ts +57 -30
package/src/orm/providers/drivers/DatabaseProvider.ts +9 -1
package/src/orm/providers/drivers/NodeSqliteProvider.ts +4 -1
package/src/react/auth/services/ReactAuth.ts +3 -1
package/src/react/router/atoms/ssrManifestAtom.ts +7 -0
package/src/react/router/hooks/useActive.ts +1 -1
package/src/react/router/hooks/useRouter.ts +1 -1
package/src/react/router/index.ts +4 -0
package/src/react/router/primitives/$page.browser.spec.tsx +24 -24
package/src/react/router/primitives/$page.spec.tsx +0 -32
package/src/react/router/primitives/$page.ts +6 -14
package/src/react/router/providers/ReactBrowserProvider.ts +6 -3
package/src/react/router/providers/ReactPageProvider.ts +1 -1
package/src/react/router/providers/ReactPreloadProvider.spec.ts +142 -0
package/src/react/router/providers/ReactPreloadProvider.ts +85 -0
package/src/react/router/providers/ReactServerProvider.ts +21 -82
package/src/react/router/providers/ReactServerTemplateProvider.spec.ts +210 -0
package/src/react/router/providers/ReactServerTemplateProvider.ts +228 -665
package/src/react/router/providers/SSRManifestProvider.ts +7 -0
package/src/react/router/services/ReactRouter.ts +13 -13
package/src/scheduler/index.workerd.ts +43 -0
package/src/scheduler/providers/CronProvider.ts +53 -6
package/src/scheduler/providers/WorkerdCronProvider.ts +102 -0
package/src/security/__tests__/ServerSecurityProvider.spec.ts +77 -0
package/src/security/providers/ServerSecurityProvider.ts +30 -22
package/src/server/compress/providers/ServerCompressProvider.ts +6 -0
package/src/server/core/providers/NodeHttpServerProvider.spec.ts +9 -3
package/src/server/links/providers/ServerLinksProvider.spec.ts +332 -0
package/src/server/links/providers/ServerLinksProvider.ts +1 -1
package/src/system/index.browser.ts +25 -0
package/src/system/index.workerd.ts +1 -0
package/src/system/providers/FileSystemProvider.ts +8 -0
package/src/system/providers/NodeFileSystemProvider.ts +11 -2
package/src/vite/tasks/buildServer.ts +2 -12
package/src/vite/tasks/generateCloudflare.ts +47 -8
package/src/vite/tasks/generateDocker.ts +4 -0

package/src/react/router/providers/ReactServerProvider.ts CHANGED Viewed

@@ -6,7 +6,6 @@ import {
   $inject,
   $use,
   Alepha,
-  AlephaError,
   type Static,
   t,
 } from "alepha";
@@ -101,54 +100,21 @@ export class ReactServerProvider {
       }
       if (ssrEnabled) {
-        await this.registerPages(async () => this.template);
+        this.registerPages();
         this.log.info("SSR OK");
         return;
       }
-      // no SSR enabled, serve index.html for all unmatched routes
-      this.log.info("SSR is disabled, use History API fallback");
-      this.serverRouterProvider.createRoute({
-        path: "*",
-        handler: async ({ url, reply }) => {
-          if (url.pathname.includes(".")) {
-            // If the request is for a file (e.g., /style.css), do not fallback
-            reply.headers["content-type"] = "text/plain";
-            reply.body = "Not Found";
-            reply.status = 404;
-            return;
-          }
-          reply.headers["content-type"] = "text/html";
-          // serve index.html for all unmatched routes
-          return this.template;
-        },
-      });
+      // no SSR enabled, serve a minimal fallback
+      this.log.info("SSR is disabled");
     },
   });
-  /**
-   * Get the current HTML template.
-   */
-  public get template() {
-    return (
-      this.alepha.store.get("alepha.react.server.template") ??
-      "<!DOCTYPE html><html lang='en'><head></head><body><div id='root'></div></body></html>"
-    );
-  }
   /**
    * Register all pages as server routes.
    */
-  protected async registerPages(templateLoader: TemplateLoader) {
-    // Parse template once at startup
-    const template = await templateLoader();
-    if (template) {
-      this.templateProvider.parseTemplate(template);
-    }
-    // Set up early head content (entry assets preloads)
+  protected registerPages(): void {
+    // Set up early head content (entry assets)
     this.setupEarlyHeadContent();
     // Cache ServerLinksProvider check at startup
@@ -163,7 +129,7 @@ export class ReactServerProvider {
           schema: undefined, // schema is handled by the page primitive provider
           method: "GET",
           path: page.match,
-          handler: this.createHandler(page, templateLoader),
+          handler: this.createHandler(page),
         });
       }
     }
@@ -174,28 +140,28 @@ export class ReactServerProvider {
    *
    * This content is sent immediately when streaming starts, before page loaders run,
    * allowing the browser to start downloading entry.js and CSS files early.
-   *
-   * Uses <script type="module"> instead of <link rel="modulepreload"> for JS
-   * because the script needs to execute anyway - this way the browser starts
-   * downloading, parsing, AND will execute as soon as ready.
-   *
-   * Also injects critical meta tags (charset, viewport) if not specified in $head,
-   * and strips these assets from the original template head to avoid duplicates.
    */
   protected setupEarlyHeadContent(): void {
-    const assets = this.ssrManifestProvider.getEntryAssets();
     const globalHead = this.serverHeadProvider.resolveGlobalHead();
+    const manifest = this.ssrManifestProvider.getManifest();
-    const parts: string[] = [];
+    // Dev mode: use pre-transformed head content from Vite
+    if (manifest.devHead) {
+      this.templateProvider.setEarlyHeadContent(
+        `${manifest.devHead}\n`,
+        globalHead,
+      );
+      this.log.debug("Early head content set (dev mode)");
+      return;
+    }
+    // Production: build from SSR manifest entry assets
+    const parts: string[] = [];
+    const assets = this.ssrManifestProvider.getEntryAssets();
     if (assets) {
-      // Add CSS stylesheets (critical for rendering)
       for (const css of assets.css) {
         parts.push(`<link rel="stylesheet" href="${css}" crossorigin="">`);
       }
-      // Add entry JS as script module (not just modulepreload)
-      // This starts download, parse, AND execution immediately
       if (assets.js) {
         parts.push(
           `<script type="module" crossorigin="" src="${assets.js}"></script>`,
@@ -203,16 +169,13 @@ export class ReactServerProvider {
       }
     }
-    // Pass global head so critical meta tags can be injected if missing
     this.templateProvider.setEarlyHeadContent(
       parts.length > 0 ? `${parts.join("\n")}\n` : "",
       globalHead,
-      assets ?? undefined,
     );
     this.log.debug("Early head content set", {
-      css: assets?.css.length ?? 0,
-      js: assets?.js ? 1 : 0,
+      parts: parts.length,
     });
   }
@@ -251,23 +214,10 @@ export class ReactServerProvider {
   /**
    * Create the request handler for a page route.
    */
-  protected createHandler(
-    route: PageRoute,
-    templateLoader: TemplateLoader,
-  ): ServerHandler {
+  protected createHandler(route: PageRoute): ServerHandler {
     return async (serverRequest) => {
       const { url, reply, query, params } = serverRequest;
-      // Ensure template is parsed (handles dev mode where template may change)
-      if (!this.templateProvider.isReady()) {
-        const template = await templateLoader();
-        if (!template) {
-          throw new AlephaError("Missing template for SSR rendering");
-        }
-        this.templateProvider.parseTemplate(template);
-        this.setupEarlyHeadContent();
-      }
       this.log.trace("Rendering page", { name: route.name });
       // Initialize router state
@@ -446,12 +396,6 @@ export class ReactServerProvider {
     await this.alepha.events.emit("react:server:render:begin", { state });
-    // Ensure template is parsed with early head content (entry.js, CSS)
-    if (!this.templateProvider.isReady()) {
-      this.templateProvider.parseTemplate(this.template);
-      this.setupEarlyHeadContent();
-    }
     // Use shared rendering logic
     const result = await this.renderPage(page, state);
@@ -508,10 +452,6 @@ export class ReactServerProvider {
 // ---------------------------------------------------------------------------------------------------------------------
-type TemplateLoader = () => Promise<string | undefined>;
-// ---------------------------------------------------------------------------------------------------------------------
 const envSchema = t.object({
   REACT_SSR_ENABLED: t.optional(t.boolean()),
 });
@@ -520,7 +460,6 @@ declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
   interface State {
     "alepha.react.server.ssr"?: boolean;
-    "alepha.react.server.template"?: string;
   }
 }

package/src/react/router/providers/ReactServerTemplateProvider.spec.ts ADDED Viewed

@@ -0,0 +1,210 @@
+import { Alepha } from "alepha";
+import { $head } from "alepha/react/head";
+import { HttpClient, ServerProvider } from "alepha/server";
+import { describe, it } from "vitest";
+import { ssrManifestAtom } from "../atoms/ssrManifestAtom.ts";
+import { $page } from "../index.ts";
+describe("ReactServerTemplateProvider", () => {
+  describe("streaming", () => {
+    class App {
+      head = $head({
+        htmlAttributes: { lang: "en" },
+      });
+      home = $page({
+        path: "/",
+        head: {
+          title: "Test Page",
+          meta: [{ name: "description", content: "Test description" }],
+        },
+        component: () => "Hello World",
+      });
+      withLoader = $page({
+        path: "/with-loader",
+        head: { title: "Loader Page" },
+        loader: async () => ({ data: "loaded" }),
+        component: ({ data }) => `Data: ${data}`,
+      });
+    }
+    it("should stream complete HTML document with correct structure", async ({
+      expect,
+    }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(App);
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/`);
+      // Verify HTML structure
+      expect(response.data).toContain("<!DOCTYPE html>");
+      expect(response.data).toContain('<html lang="en">');
+      expect(response.data).toContain("<head>");
+      expect(response.data).toContain('<meta charset="UTF-8">');
+      expect(response.data).toContain('<meta name="viewport"');
+      expect(response.data).toContain("<title>Test Page</title>");
+      expect(response.data).toContain(
+        '<meta name="description" content="Test description">',
+      );
+      expect(response.data).toContain("</head>");
+      expect(response.data).toContain("<body>");
+      expect(response.data).toContain('<div id="root">');
+      expect(response.data).toContain("Hello World");
+      expect(response.data).toContain("</div>");
+      expect(response.data).toContain("</body>");
+      expect(response.data).toContain("</html>");
+      await alepha.stop();
+    });
+    it("should include hydration data when enabled", async ({ expect }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(App);
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/with-loader`);
+      // Verify hydration script is present
+      expect(response.data).toContain("<script>window.__ssr=");
+      expect(response.data).toContain("</script>");
+      // Verify hydration data structure
+      expect(response.data).toMatch(/window\.__ssr=\{.*"layers".*\}/);
+      await alepha.stop();
+    });
+    it("should include entry assets in head when manifest is available", async ({
+      expect,
+    }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(App);
+      // Set up mock SSR manifest
+      alepha.store.set(ssrManifestAtom, {
+        client: {
+          "src/entry.tsx": {
+            file: "assets/entry.abc123.js",
+            isEntry: true,
+            css: ["assets/style.def456.css"],
+          },
+        },
+      });
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/`);
+      // Verify entry assets are in the head
+      expect(response.data).toContain(
+        '<link rel="stylesheet" href="/assets/style.def456.css" crossorigin="">',
+      );
+      expect(response.data).toContain(
+        '<script type="module" crossorigin="" src="/assets/entry.abc123.js"></script>',
+      );
+      await alepha.stop();
+    });
+    it("should handle pages with loaders correctly", async ({ expect }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(App);
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/with-loader`);
+      // Verify loader data is rendered
+      expect(response.data).toContain("Data: loaded");
+      await alepha.stop();
+    });
+    it("should set correct content-type header", async ({ expect }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(App);
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/`);
+      expect(response.headers.get("content-type")).toBe("text/html");
+      await alepha.stop();
+    });
+    it("should set cache-control headers for SSR responses", async ({
+      expect,
+    }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(App);
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/`);
+      expect(response.headers.get("cache-control")).toContain("no-store");
+      await alepha.stop();
+    });
+  });
+  describe("error handling", () => {
+    class ErrorApp {
+      errorPage = $page({
+        path: "/error",
+        loader: async () => {
+          throw new Error("Loader error");
+        },
+        component: () => "Should not render",
+      });
+    }
+    it("should render error when loader throws", async ({ expect }) => {
+      const alepha = Alepha.create({
+        env: { LOG_LEVEL: "error", SERVER_PORT: 0 },
+      }).with(ErrorApp);
+      await alepha.start();
+      const server = alepha.inject(ServerProvider);
+      const http = alepha.inject(HttpClient);
+      const response = await http.fetch(`${server.hostname}/error`);
+      // Should still return a valid HTML response with error
+      expect(response.data).toContain("<!DOCTYPE html>");
+      expect(response.data).toContain("Loader error");
+      await alepha.stop();
+    });
+  });
+});