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

alepha 0.15.2 → 0.15.3

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 (132) hide show

package/README.md +68 -80
package/dist/api/audits/index.d.ts +332 -332
package/dist/api/audits/index.d.ts.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/jobs/index.d.ts +151 -151
package/dist/api/keys/index.d.ts +195 -195
package/dist/api/keys/index.d.ts.map +1 -1
package/dist/api/parameters/index.d.ts +260 -260
package/dist/api/users/index.d.ts +22 -11
package/dist/api/users/index.d.ts.map +1 -1
package/dist/api/users/index.js +7 -2
package/dist/api/users/index.js.map +1 -1
package/dist/api/verifications/index.d.ts +128 -128
package/dist/api/verifications/index.d.ts.map +1 -1
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 +191 -74
package/dist/cli/index.d.ts.map +1 -1
package/dist/cli/index.js +215 -48
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 +8 -0
package/dist/email/index.d.ts.map +1 -1
package/dist/email/index.js +7 -2
package/dist/email/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/router/index.browser.js +9 -15
package/dist/react/router/index.browser.js.map +1 -1
package/dist/react/router/index.d.ts +295 -407
package/dist/react/router/index.d.ts.map +1 -1
package/dist/react/router/index.js +566 -776
package/dist/react/router/index.js.map +1 -1
package/dist/redis/index.d.ts +19 -19
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/core/index.d.ts +9 -9
package/dist/server/health/index.d.ts +17 -17
package/dist/server/links/index.d.ts +39 -39
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 +1 -1
package/dist/vite/index.js +15 -7
package/dist/vite/index.js.map +1 -1
package/package.json +4 -2
package/src/api/logs/TODO.md +13 -10
package/src/cli/apps/AlephaPackageBuilderCli.ts +9 -0
package/src/cli/atoms/buildOptions.ts +99 -9
package/src/cli/commands/build.ts +149 -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 +1 -10
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/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/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 +7 -78
package/src/react/router/providers/ReactServerTemplateProvider.spec.ts +210 -0
package/src/react/router/providers/ReactServerTemplateProvider.ts +228 -665
package/src/react/router/services/ReactRouter.ts +13 -13
package/src/security/__tests__/ServerSecurityProvider.spec.ts +77 -0
package/src/security/providers/ServerSecurityProvider.ts +30 -22
package/src/server/core/providers/NodeHttpServerProvider.spec.ts +9 -3
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 +10 -7
package/src/vite/tasks/generateDocker.ts +4 -0

package/src/react/router/providers/ReactPreloadProvider.ts ADDED Viewed

@@ -0,0 +1,85 @@
+import { $hook, $inject, Alepha } from "alepha";
+import { SSRManifestProvider } from "./SSRManifestProvider.ts";
+/**
+ * Adds HTTP Link headers for preloading entry assets.
+ *
+ * Benefits:
+ * - Early Hints (103): Servers can send preload hints before the full response
+ * - CDN optimization: Many CDNs use Link headers to optimize asset delivery
+ * - Browser prefetching: Browsers can start fetching resources earlier
+ *
+ * The Link header is computed once at first request and cached for reuse.
+ */
+export class ReactPreloadProvider {
+  protected readonly alepha = $inject(Alepha);
+  protected readonly ssrManifest = $inject(SSRManifestProvider);
+  /**
+   * Cached Link header value - computed once, reused for all requests.
+   */
+  protected cachedLinkHeader: string | null | undefined;
+  /**
+   * Build the Link header string from entry assets.
+   *
+   * Format: <url>; rel=preload; as=type, <url>; rel=modulepreload
+   *
+   * @returns Link header string or null if no assets
+   */
+  protected buildLinkHeader(): string | null {
+    const assets = this.ssrManifest.getEntryAssets();
+    if (!assets) return null;
+    const links: string[] = [];
+    // CSS - preload as style
+    for (const css of assets.css) {
+      links.push(`<${css}>; rel=preload; as=style`);
+    }
+    // JS - modulepreload for ES modules
+    if (assets.js) {
+      links.push(`<${assets.js}>; rel=modulepreload`);
+    }
+    return links.length > 0 ? links.join(", ") : null;
+  }
+  /**
+   * Get the cached Link header, computing it on first access.
+   */
+  protected getLinkHeader(): string | null {
+    if (this.cachedLinkHeader === undefined) {
+      this.cachedLinkHeader = this.buildLinkHeader();
+    }
+    return this.cachedLinkHeader;
+  }
+  /**
+   * Add Link header to HTML responses for asset preloading.
+   */
+  protected readonly onResponse = $hook({
+    on: "server:onResponse",
+    priority: "first",
+    handler: ({ response }) => {
+      // Only add to HTML responses (SSR pages)
+      const contentType = response.headers["content-type"];
+      if (!contentType || !contentType.includes("text/html")) {
+        return;
+      }
+      const linkHeader = this.getLinkHeader();
+      if (!linkHeader) {
+        return;
+      }
+      // Append to existing Link header if present
+      if (response.headers.link) {
+        response.headers.link = `${response.headers.link}, ${linkHeader}`;
+      } else {
+        response.headers.link = linkHeader;
+      }
+    },
+  });
+}

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,13 +140,6 @@ 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();
@@ -189,13 +148,9 @@ export class ReactServerProvider {
     const parts: string[] = [];
     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,11 +158,9 @@ 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", {
@@ -251,23 +204,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 +386,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 +442,6 @@ export class ReactServerProvider {
 // ---------------------------------------------------------------------------------------------------------------------
-type TemplateLoader = () => Promise<string | undefined>;
-// ---------------------------------------------------------------------------------------------------------------------
 const envSchema = t.object({
   REACT_SSR_ENABLED: t.optional(t.boolean()),
 });
@@ -520,7 +450,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();
+    });
+  });
+});