alepha 0.13.2 → 0.13.3

package/dist/server-links/index.d.ts

@@ -1,5 +1,5 @@
 import { ServerRouteSecure } from "alepha/server/security";
-import * as alepha1 from "alepha";
+import * as alepha21 from "alepha";
 import { Alepha, Async, KIND, Primitive, Static } from "alepha";
 import * as alepha_server0 from "alepha/server";
 import { ActionPrimitive, ClientRequestEntry, ClientRequestOptions, ClientRequestResponse, FetchResponse, HttpClient, RequestConfigSchema, ServerRequest, ServerRequestConfigEntry, ServerResponseBody, ServerTimingProvider } from "alepha/server";
@@ -9,23 +9,23 @@ import { ProxyPrimitiveOptions, ServerProxyProvider } from "alepha/server/proxy"
 import { ServiceAccountPrimitive, UserAccountToken } from "alepha/security";
 
 //#region src/server-links/schemas/apiLinksResponseSchema.d.ts
-declare const apiLinkSchema: alepha1.TObject<{
-  name: alepha1.TString;
-  group: alepha1.TOptional<alepha1.TString>;
-  path: alepha1.TString;
-  method: alepha1.TOptional<alepha1.TString>;
-  requestBodyType: alepha1.TOptional<alepha1.TString>;
-  service: alepha1.TOptional<alepha1.TString>;
+declare const apiLinkSchema: alepha21.TObject<{
+  name: alepha21.TString;
+  group: alepha21.TOptional<alepha21.TString>;
+  path: alepha21.TString;
+  method: alepha21.TOptional<alepha21.TString>;
+  requestBodyType: alepha21.TOptional<alepha21.TString>;
+  service: alepha21.TOptional<alepha21.TString>;
 }>;
-declare const apiLinksResponseSchema: alepha1.TObject<{
-  prefix: alepha1.TOptional<alepha1.TString>;
-  links: alepha1.TArray<alepha1.TObject<{
-    name: alepha1.TString;
-    group: alepha1.TOptional<alepha1.TString>;
-    path: alepha1.TString;
-    method: alepha1.TOptional<alepha1.TString>;
-    requestBodyType: alepha1.TOptional<alepha1.TString>;
-    service: alepha1.TOptional<alepha1.TString>;
+declare const apiLinksResponseSchema: alepha21.TObject<{
+  prefix: alepha21.TOptional<alepha21.TString>;
+  links: alepha21.TArray<alepha21.TObject<{
+    name: alepha21.TString;
+    group: alepha21.TOptional<alepha21.TString>;
+    path: alepha21.TString;
+    method: alepha21.TOptional<alepha21.TString>;
+    requestBodyType: alepha21.TOptional<alepha21.TString>;
+    service: alepha21.TOptional<alepha21.TString>;
   }>>;
 }>;
 type ApiLinksResponse = Static<typeof apiLinksResponseSchema>;
@@ -180,8 +180,8 @@ declare class RemotePrimitiveProvider {
   protected readonly remotes: Array<ServerRemote>;
   protected readonly log: alepha_logger0.Logger;
   getRemotes(): ServerRemote[];
-  readonly configure: alepha1.HookPrimitive<"configure">;
-  readonly start: alepha1.HookPrimitive<"start">;
+  readonly configure: alepha21.HookPrimitive<"configure">;
+  readonly start: alepha21.HookPrimitive<"start">;
   registerRemote(value: RemotePrimitive): Promise<void>;
   protected readonly fetchLinks: alepha_retry0.RetryPrimitiveFn<(opts: FetchLinksOptions) => Promise<ApiLinksResponse>>;
 }
@@ -249,22 +249,22 @@ declare class ServerLinksProvider {
   protected readonly remoteProvider: RemotePrimitiveProvider;
   protected readonly serverTimingProvider: ServerTimingProvider;
   get prefix(): string;
-  readonly onRoute: alepha1.HookPrimitive<"configure">;
+  readonly onRoute: alepha21.HookPrimitive<"configure">;
   /**
    * First API - Get all API links for the user.
    *
    * This is based on the user's permissions.
    */
   readonly links: alepha_server0.RoutePrimitive<{
-    response: alepha1.TObject<{
-      prefix: alepha1.TOptional<alepha1.TString>;
-      links: alepha1.TArray<alepha1.TObject<{
-        name: alepha1.TString;
-        group: alepha1.TOptional<alepha1.TString>;
-        path: alepha1.TString;
-        method: alepha1.TOptional<alepha1.TString>;
-        requestBodyType: alepha1.TOptional<alepha1.TString>;
-        service: alepha1.TOptional<alepha1.TString>;
+    response: alepha21.TObject<{
+      prefix: alepha21.TOptional<alepha21.TString>;
+      links: alepha21.TArray<alepha21.TObject<{
+        name: alepha21.TString;
+        group: alepha21.TOptional<alepha21.TString>;
+        path: alepha21.TString;
+        method: alepha21.TOptional<alepha21.TString>;
+        requestBodyType: alepha21.TOptional<alepha21.TString>;
+        service: alepha21.TOptional<alepha21.TString>;
       }>>;
     }>;
   }>;
@@ -275,10 +275,10 @@ declare class ServerLinksProvider {
    * I mean for 150+ links, you got 50ms of serialization time.
    */
   readonly schema: alepha_server0.RoutePrimitive<{
-    params: alepha1.TObject<{
-      name: alepha1.TString;
+    params: alepha21.TObject<{
+      name: alepha21.TString;
     }>;
-    response: alepha1.TRecord<string, alepha1.TAny>;
+    response: alepha21.TRecord<string, alepha21.TAny>;
   }>;
   getSchemaByName(name: string, options?: GetApiLinksOptions): Promise<RequestConfigSchema>;
   /**
@@ -315,7 +315,7 @@ declare module "alepha" {
  * @see {@link $client}
  * @module alepha.server.links
  */
-declare const AlephaServerLinks: alepha1.Service<alepha1.Module>;
+declare const AlephaServerLinks: alepha21.Service<alepha21.Module>;
 //#endregion
 export { $client, $remote, AlephaServerLinks, ApiLink, ApiLinksResponse, ClientScope, FetchLinksOptions, GetApiLinksOptions, HttpClientLink, HttpVirtualClient, LinkProvider, RemotePrimitive, RemotePrimitiveOptions, RemotePrimitiveProvider, ServerLinksProvider, ServerRemote, VirtualAction, apiLinkSchema, apiLinksResponseSchema };
 //# sourceMappingURL=index.d.ts.map

package/dist/server-static/index.js

@@ -73,7 +73,15 @@ var ServerStaticProvider = class {
 				}
 				reply.headers["content-type"] = "text/html";
 				reply.status = 200;
-				return createReadStream(join(root, "index.html"));
+				return new Promise((resolve, reject) => {
+					const stream = createReadStream(join(root, "index.html"));
+					stream.on("open", () => {
+						resolve(stream);
+					});
+					stream.on("error", (err) => {
+						reject(err);
+					});
+				});
 			}
 		});
 	}
@@ -111,7 +119,15 @@ var ServerStaticProvider = class {
 				reply.status = 304;
 				return;
 			}
-			return createReadStream(path);
+			return new Promise((resolve, reject) => {
+				const stream = createReadStream(path);
+				stream.on("open", () => {
+					resolve(stream);
+				});
+				stream.on("error", (err) => {
+					reject(err);
+				});
+			});
 		};
 	}
 	getCacheFileTypes() {

package/dist/server-static/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/server-static/primitives/$serve.ts","../../src/server-static/providers/ServerStaticProvider.ts","../../src/server-static/index.ts"],"sourcesContent":["import { createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\n\n/**\n * Create a new static file handler.\n */\nexport const $serve = (options: ServePrimitiveOptions = {}): ServePrimitive => {\n  return createPrimitive(ServePrimitive, options);\n};\n\nexport interface ServePrimitiveOptions {\n  /**\n   * Prefix for the served path.\n   *\n   * @default \"/\"\n   */\n  path?: string;\n\n  /**\n   * Path to the directory to serve.\n   *\n   * @default process.cwd()\n   */\n  root?: string;\n\n  /**\n   * If true, primitive will be ignored.\n   *\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether to keep dot files (e.g. `.gitignore`, `.env`) in the served directory.\n   *\n   * @default true\n   */\n  ignoreDotEnvFiles?: boolean;\n\n  /**\n   * Whether to use the index.html file when the path is a directory.\n   *\n   * @default true\n   */\n  indexFallback?: boolean;\n\n  /**\n   * Force all requests \"not found\" to be served with the index.html file.\n   * This is useful for single-page applications (SPAs) that use client-side only routing.\n   */\n  historyApiFallback?: boolean;\n\n  /**\n   * Optional name of the primitive.\n   * This is used for logging and debugging purposes.\n   *\n   * @default Key name.\n   */\n  name?: string;\n\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default {}\n   */\n  cacheControl?: Partial<CacheControlOptions> | false;\n}\n\nexport interface CacheControlOptions {\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default [.js, .css]\n   */\n  fileTypes: string[];\n\n  /**\n   * The maximum age of the cache in seconds.\n   *\n   * @default 60 * 60 * 24 * 2 // 2 days\n   */\n  maxAge: DurationLike;\n\n  /**\n   * Whether to use immutable cache control headers.\n   *\n   * @default true\n   */\n  immutable: boolean;\n}\n\nexport class ServePrimitive extends Primitive<ServePrimitiveOptions> {}\n\n$serve[KIND] = ServePrimitive;\n","import { createReadStream } from \"node:fs\";\nimport { access, readdir, stat } from \"node:fs/promises\";\nimport { basename, isAbsolute, join } from \"node:path\";\nimport type { Readable as NodeStream } from \"node:stream\";\nimport { $hook, $inject, Alepha } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { FileDetector } from \"alepha/file\";\nimport { $logger } from \"alepha/logger\";\nimport { type ServerHandler, ServerRouterProvider } from \"alepha/server\";\nimport { $serve, type ServePrimitiveOptions } from \"../primitives/$serve.ts\";\n\nexport class ServerStaticProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly routerProvider = $inject(ServerRouterProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly fileDetector = $inject(FileDetector);\n  protected readonly log = $logger();\n  protected readonly directories: ServeDirectory[] = [];\n\n  protected readonly configure = $hook({\n    on: \"configure\",\n    handler: async () => {\n      await Promise.all(\n        this.alepha\n          .primitives($serve)\n          .map((it) => this.createStaticServer(it.options)),\n      );\n    },\n  });\n\n  public async createStaticServer(\n    options: ServePrimitiveOptions,\n  ): Promise<void> {\n    const prefix = options.path ?? \"/\";\n\n    let root = options.root ?? process.cwd();\n    if (!isAbsolute(root)) {\n      root = join(process.cwd(), root);\n    }\n\n    this.log.debug(\"Serve static files\", { prefix, root });\n\n    await stat(root);\n\n    // 1. get all files in the root directory (recursively)\n    const files = await this.getAllFiles(root, options.ignoreDotEnvFiles);\n\n    // 2. create a $route for each file (yes, this could be a lot of routes)\n    const routes = await Promise.all(\n      files.map(async (file) => {\n        const path = file.replace(root, \"\").replace(/\\\\/g, \"/\");\n        this.log.trace(`Mount ${join(prefix, path)} -> ${join(root, path)}`);\n        return {\n          path: join(prefix, encodeURI(path)),\n          handler: await this.createFileHandler(join(root, path), options),\n        };\n      }),\n    );\n\n    for (const route of routes) {\n      this.routerProvider.createRoute(route);\n\n      // if route is for index.html, also create a route without it\n      // e.g. /my/path/index.html -> /my/path/\n      if (\n        options.indexFallback !== false &&\n        route.path.endsWith(\"index.html\")\n      ) {\n        this.routerProvider.createRoute({\n          path: route.path.replace(/index\\.html$/, \"\"),\n          handler: route.handler,\n        });\n      }\n    }\n\n    // 3. store the directory info for reference\n    this.directories.push({\n      options,\n      files: files.map((file) => file.replace(root, \"\").replace(/\\\\/g, \"/\")),\n    });\n\n    // bonus! for SPAs, handle history API fallback\n    if (options.historyApiFallback) {\n      // meaning all unmatched routes should serve index.html\n      this.routerProvider.createRoute({\n        path: join(prefix, \"*\").replace(/\\\\/g, \"/\"),\n        handler: async (request) => {\n          const { reply } = request;\n\n          if (request.url.pathname.includes(\".\")) {\n            // If the request is for a file (e.g., /style.css), do not fall back\n            reply.headers[\"content-type\"] = \"text/plain\";\n            reply.body = \"Not Found\";\n            reply.status = 404;\n            return;\n          }\n\n          reply.headers[\"content-type\"] = \"text/html\";\n          reply.status = 200;\n\n          // Serve index.html for all unmatched routes\n          return createReadStream(join(root, \"index.html\"));\n        },\n      });\n    }\n  }\n\n  public async createFileHandler(\n    filepath: string,\n    options: ServePrimitiveOptions,\n  ): Promise<ServerHandler> {\n    const filename = basename(filepath);\n\n    const hasGzip = await access(`${filepath}.gz`)\n      .then(() => true)\n      .catch(() => false);\n\n    const hasBr = await access(`${filepath}.br`)\n      .then(() => true)\n      .catch(() => false);\n\n    const fileStat = await stat(filepath);\n    const lastModified = fileStat.mtime.toUTCString();\n    const etag = `\"${fileStat.size}-${fileStat.mtime.getTime()}\"`;\n    const contentType = this.fileDetector.getContentType(filename);\n    const cacheControl = this.getCacheControl(filename, options);\n\n    return async (request): Promise<NodeStream | undefined> => {\n      const { headers, reply } = request;\n      let path = filepath;\n\n      const encoding = headers[\"accept-encoding\"];\n      if (encoding) {\n        if (hasBr && encoding.includes(\"br\")) {\n          reply.headers[\"content-encoding\"] = \"br\";\n          path += \".br\";\n        } else if (hasGzip && encoding.includes(\"gzip\")) {\n          reply.headers[\"content-encoding\"] = \"gzip\";\n          path += \".gz\";\n        }\n      }\n\n      reply.headers[\"content-type\"] = contentType;\n      reply.headers[\"accept-ranges\"] = \"bytes\";\n      reply.headers[\"last-modified\"] = lastModified;\n\n      if (cacheControl) {\n        reply.headers[\"cache-control\"] =\n          `public, max-age=${cacheControl.maxAge}`;\n        if (cacheControl.immutable) {\n          reply.headers[\"cache-control\"] += \", immutable\";\n        }\n      }\n\n      reply.headers.etag = etag;\n      if (\n        headers[\"if-none-match\"] === etag ||\n        headers[\"if-modified-since\"] === lastModified\n      ) {\n        reply.status = 304;\n        return;\n      }\n\n      return createReadStream(path);\n    };\n  }\n\n  protected getCacheFileTypes(): string[] {\n    return [\n      \".js\",\n      \".css\",\n      \".woff\",\n      \".woff2\",\n      \".ttf\",\n      \".eot\",\n      \".otf\",\n      \".jpg\",\n      \".jpeg\",\n      \".png\",\n      \".svg\",\n      \".gif\",\n    ];\n  }\n\n  protected getCacheControl(\n    filename: string,\n    options: ServePrimitiveOptions,\n  ): { maxAge: number; immutable: boolean } | undefined {\n    if (!options.cacheControl) {\n      return;\n    }\n\n    const fileTypes =\n      options.cacheControl.fileTypes ?? this.getCacheFileTypes();\n\n    for (const type of fileTypes) {\n      if (filename.endsWith(type)) {\n        return {\n          immutable: options.cacheControl.immutable ?? true,\n          maxAge: this.dateTimeProvider\n            .duration(options.cacheControl.maxAge ?? [30, \"days\"])\n            .as(\"seconds\"),\n        };\n      }\n    }\n  }\n\n  public async getAllFiles(\n    dir: string,\n    ignoreDotEnvFiles = true,\n  ): Promise<string[]> {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    const files = await Promise.all(\n      entries.map((dirent) => {\n        // skip .env & other dot files\n        if (ignoreDotEnvFiles && dirent.name.startsWith(\".\")) {\n          return [];\n        }\n\n        const fullPath = join(dir, dirent.name);\n        return dirent.isDirectory() ? this.getAllFiles(fullPath) : fullPath;\n      }),\n    );\n\n    return files.flat();\n  }\n}\n\nexport interface ServeDirectory {\n  options: ServePrimitiveOptions;\n  files: string[];\n}\n","import { $module } from \"alepha\";\nimport { AlephaServer } from \"alepha/server\";\nimport { $serve } from \"./primitives/$serve.ts\";\nimport { ServerStaticProvider } from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$serve.ts\";\nexport * from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Create static file server with `$static()`.\n *\n * @see {@link ServerStaticProvider}\n * @module alepha.server.static\n */\nexport const AlephaServerStatic = $module({\n  name: \"alepha.server.static\",\n  primitives: [$serve],\n  services: [AlephaServer, ServerStaticProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/server-static/primitives/$serve.ts","../../src/server-static/providers/ServerStaticProvider.ts","../../src/server-static/index.ts"],"sourcesContent":["import { createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\n\n/**\n * Create a new static file handler.\n */\nexport const $serve = (options: ServePrimitiveOptions = {}): ServePrimitive => {\n  return createPrimitive(ServePrimitive, options);\n};\n\nexport interface ServePrimitiveOptions {\n  /**\n   * Prefix for the served path.\n   *\n   * @default \"/\"\n   */\n  path?: string;\n\n  /**\n   * Path to the directory to serve.\n   *\n   * @default process.cwd()\n   */\n  root?: string;\n\n  /**\n   * If true, primitive will be ignored.\n   *\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether to keep dot files (e.g. `.gitignore`, `.env`) in the served directory.\n   *\n   * @default true\n   */\n  ignoreDotEnvFiles?: boolean;\n\n  /**\n   * Whether to use the index.html file when the path is a directory.\n   *\n   * @default true\n   */\n  indexFallback?: boolean;\n\n  /**\n   * Force all requests \"not found\" to be served with the index.html file.\n   * This is useful for single-page applications (SPAs) that use client-side only routing.\n   */\n  historyApiFallback?: boolean;\n\n  /**\n   * Optional name of the primitive.\n   * This is used for logging and debugging purposes.\n   *\n   * @default Key name.\n   */\n  name?: string;\n\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default {}\n   */\n  cacheControl?: Partial<CacheControlOptions> | false;\n}\n\nexport interface CacheControlOptions {\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default [.js, .css]\n   */\n  fileTypes: string[];\n\n  /**\n   * The maximum age of the cache in seconds.\n   *\n   * @default 60 * 60 * 24 * 2 // 2 days\n   */\n  maxAge: DurationLike;\n\n  /**\n   * Whether to use immutable cache control headers.\n   *\n   * @default true\n   */\n  immutable: boolean;\n}\n\nexport class ServePrimitive extends Primitive<ServePrimitiveOptions> {}\n\n$serve[KIND] = ServePrimitive;\n","import { createReadStream } from \"node:fs\";\nimport { access, readdir, stat } from \"node:fs/promises\";\nimport { basename, isAbsolute, join } from \"node:path\";\nimport type { Readable as NodeStream } from \"node:stream\";\nimport { $hook, $inject, Alepha } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { FileDetector } from \"alepha/file\";\nimport { $logger } from \"alepha/logger\";\nimport { type ServerHandler, ServerRouterProvider } from \"alepha/server\";\nimport { $serve, type ServePrimitiveOptions } from \"../primitives/$serve.ts\";\n\nexport class ServerStaticProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly routerProvider = $inject(ServerRouterProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly fileDetector = $inject(FileDetector);\n  protected readonly log = $logger();\n  protected readonly directories: ServeDirectory[] = [];\n\n  protected readonly configure = $hook({\n    on: \"configure\",\n    handler: async () => {\n      await Promise.all(\n        this.alepha\n          .primitives($serve)\n          .map((it) => this.createStaticServer(it.options)),\n      );\n    },\n  });\n\n  public async createStaticServer(\n    options: ServePrimitiveOptions,\n  ): Promise<void> {\n    const prefix = options.path ?? \"/\";\n\n    let root = options.root ?? process.cwd();\n    if (!isAbsolute(root)) {\n      root = join(process.cwd(), root);\n    }\n\n    this.log.debug(\"Serve static files\", { prefix, root });\n\n    await stat(root);\n\n    // 1. get all files in the root directory (recursively)\n    const files = await this.getAllFiles(root, options.ignoreDotEnvFiles);\n\n    // 2. create a $route for each file (yes, this could be a lot of routes)\n    const routes = await Promise.all(\n      files.map(async (file) => {\n        const path = file.replace(root, \"\").replace(/\\\\/g, \"/\");\n        this.log.trace(`Mount ${join(prefix, path)} -> ${join(root, path)}`);\n        return {\n          path: join(prefix, encodeURI(path)),\n          handler: await this.createFileHandler(join(root, path), options),\n        };\n      }),\n    );\n\n    for (const route of routes) {\n      this.routerProvider.createRoute(route);\n\n      // if route is for index.html, also create a route without it\n      // e.g. /my/path/index.html -> /my/path/\n      if (\n        options.indexFallback !== false &&\n        route.path.endsWith(\"index.html\")\n      ) {\n        this.routerProvider.createRoute({\n          path: route.path.replace(/index\\.html$/, \"\"),\n          handler: route.handler,\n        });\n      }\n    }\n\n    // 3. store the directory info for reference\n    this.directories.push({\n      options,\n      files: files.map((file) => file.replace(root, \"\").replace(/\\\\/g, \"/\")),\n    });\n\n    // bonus! for SPAs, handle history API fallback\n    if (options.historyApiFallback) {\n      // meaning all unmatched routes should serve index.html\n      this.routerProvider.createRoute({\n        path: join(prefix, \"*\").replace(/\\\\/g, \"/\"),\n        handler: async (request) => {\n          const { reply } = request;\n\n          if (request.url.pathname.includes(\".\")) {\n            // If the request is for a file (e.g., /style.css), do not fall back\n            reply.headers[\"content-type\"] = \"text/plain\";\n            reply.body = \"Not Found\";\n            reply.status = 404;\n            return;\n          }\n\n          reply.headers[\"content-type\"] = \"text/html\";\n          reply.status = 200;\n\n          return new Promise<any>((resolve, reject) => {\n            const stream = createReadStream(join(root, \"index.html\"));\n            stream.on(\"open\", () => {\n              resolve(stream);\n            });\n            stream.on(\"error\", (err) => {\n              reject(err);\n            });\n          });\n        },\n      });\n    }\n  }\n\n  public async createFileHandler(\n    filepath: string,\n    options: ServePrimitiveOptions,\n  ): Promise<ServerHandler> {\n    const filename = basename(filepath);\n\n    const hasGzip = await access(`${filepath}.gz`)\n      .then(() => true)\n      .catch(() => false);\n\n    const hasBr = await access(`${filepath}.br`)\n      .then(() => true)\n      .catch(() => false);\n\n    const fileStat = await stat(filepath);\n    const lastModified = fileStat.mtime.toUTCString();\n    const etag = `\"${fileStat.size}-${fileStat.mtime.getTime()}\"`;\n    const contentType = this.fileDetector.getContentType(filename);\n    const cacheControl = this.getCacheControl(filename, options);\n\n    return async (request): Promise<NodeStream | undefined> => {\n      const { headers, reply } = request;\n      let path = filepath;\n\n      const encoding = headers[\"accept-encoding\"];\n      if (encoding) {\n        if (hasBr && encoding.includes(\"br\")) {\n          reply.headers[\"content-encoding\"] = \"br\";\n          path += \".br\";\n        } else if (hasGzip && encoding.includes(\"gzip\")) {\n          reply.headers[\"content-encoding\"] = \"gzip\";\n          path += \".gz\";\n        }\n      }\n\n      reply.headers[\"content-type\"] = contentType;\n      reply.headers[\"accept-ranges\"] = \"bytes\";\n      reply.headers[\"last-modified\"] = lastModified;\n\n      if (cacheControl) {\n        reply.headers[\"cache-control\"] =\n          `public, max-age=${cacheControl.maxAge}`;\n        if (cacheControl.immutable) {\n          reply.headers[\"cache-control\"] += \", immutable\";\n        }\n      }\n\n      reply.headers.etag = etag;\n      if (\n        headers[\"if-none-match\"] === etag ||\n        headers[\"if-modified-since\"] === lastModified\n      ) {\n        reply.status = 304;\n        return;\n      }\n\n      return new Promise<any>((resolve, reject) => {\n        const stream = createReadStream(path);\n        stream.on(\"open\", () => {\n          resolve(stream);\n        });\n        stream.on(\"error\", (err) => {\n          reject(err);\n        });\n      });\n    };\n  }\n\n  protected getCacheFileTypes(): string[] {\n    return [\n      \".js\",\n      \".css\",\n      \".woff\",\n      \".woff2\",\n      \".ttf\",\n      \".eot\",\n      \".otf\",\n      \".jpg\",\n      \".jpeg\",\n      \".png\",\n      \".svg\",\n      \".gif\",\n    ];\n  }\n\n  protected getCacheControl(\n    filename: string,\n    options: ServePrimitiveOptions,\n  ): { maxAge: number; immutable: boolean } | undefined {\n    if (!options.cacheControl) {\n      return;\n    }\n\n    const fileTypes =\n      options.cacheControl.fileTypes ?? this.getCacheFileTypes();\n\n    for (const type of fileTypes) {\n      if (filename.endsWith(type)) {\n        return {\n          immutable: options.cacheControl.immutable ?? true,\n          maxAge: this.dateTimeProvider\n            .duration(options.cacheControl.maxAge ?? [30, \"days\"])\n            .as(\"seconds\"),\n        };\n      }\n    }\n  }\n\n  public async getAllFiles(\n    dir: string,\n    ignoreDotEnvFiles = true,\n  ): Promise<string[]> {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    const files = await Promise.all(\n      entries.map((dirent) => {\n        // skip .env & other dot files\n        if (ignoreDotEnvFiles && dirent.name.startsWith(\".\")) {\n          return [];\n        }\n\n        const fullPath = join(dir, dirent.name);\n        return dirent.isDirectory() ? this.getAllFiles(fullPath) : fullPath;\n      }),\n    );\n\n    return files.flat();\n  }\n}\n\nexport interface ServeDirectory {\n  options: ServePrimitiveOptions;\n  files: string[];\n}\n","import { $module } from \"alepha\";\nimport { AlephaServer } from \"alepha/server\";\nimport { $serve } from \"./primitives/$serve.ts\";\nimport { ServerStaticProvider } from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$serve.ts\";\nexport * from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Create static file server with `$static()`.\n *\n * @see {@link ServerStaticProvider}\n * @module alepha.server.static\n */\nexport const AlephaServerStatic = $module({\n  name: \"alepha.server.static\",\n  primitives: [$serve],\n  services: [AlephaServer, ServerStaticProvider],\n});\n"],"mappings":"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"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "alepha",
   "description": "Easy-to-use modern TypeScript framework for building many kind of applications.",
   "author": "Nicolas Foures",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -23,10 +23,10 @@
     "drizzle-kit": "^0.31.7",
     "drizzle-orm": "^0.44.7",
     "postgres": "^3.4.7",
-    "tsx": "^4.20.6",
-    "typebox": "^1.0.58",
+    "tsx": "^4.21.0",
+    "typebox": "^1.0.61",
     "typescript": "^5.9.3",
-    "vite": "^7.2.4",
+    "vite": "^7.2.6",
     "vite-bundle-analyzer": "^1.2.3",
     "ws": "^8.18.3"
   },
@@ -37,12 +37,12 @@
     "@types/nodemailer": "^7.0.4",
     "@types/ws": "^8.18.1",
     "cron-schedule": "^6.0.0",
-    "jose": "^6.1.2",
+    "jose": "^6.1.3",
     "nodemailer": "^7.0.11",
     "openid-client": "^6.8.1",
     "prom-client": "^15.1.3",
     "swagger-ui-dist": "^5.30.3",
-    "vitest": "^4.0.14"
+    "vitest": "^4.0.15"
   },
   "scarfSettings": {
     "enabled": false
@@ -70,21 +70,29 @@
   "exports": {
     "./api/files": {
       "types": "./dist/api-files/index.js",
+      "react-native": "./dist/api-files/index.browser.js",
+      "browser": "./dist/api-files/index.browser.js",
       "import": "./dist/api-files/index.js",
       "default": "./dist/api-files/index.js"
     },
     "./api/jobs": {
       "types": "./dist/api-jobs/index.js",
+      "react-native": "./dist/api-jobs/index.browser.js",
+      "browser": "./dist/api-jobs/index.browser.js",
       "import": "./dist/api-jobs/index.js",
       "default": "./dist/api-jobs/index.js"
     },
     "./api/notifications": {
       "types": "./dist/api-notifications/index.js",
+      "react-native": "./dist/api-notifications/index.browser.js",
+      "browser": "./dist/api-notifications/index.browser.js",
       "import": "./dist/api-notifications/index.js",
       "default": "./dist/api-notifications/index.js"
     },
     "./api/parameters": {
       "types": "./dist/api-parameters/index.js",
+      "react-native": "./dist/api-parameters/index.browser.js",
+      "browser": "./dist/api-parameters/index.browser.js",
       "import": "./dist/api-parameters/index.js",
       "default": "./dist/api-parameters/index.js"
     },
@@ -97,6 +105,8 @@
     },
     "./api/verifications": {
       "types": "./dist/api-verifications/index.js",
+      "react-native": "./dist/api-verifications/index.browser.js",
+      "browser": "./dist/api-verifications/index.browser.js",
       "import": "./dist/api-verifications/index.js",
       "default": "./dist/api-verifications/index.js"
     },

package/src/api-files/index.browser.ts

@@ -0,0 +1,17 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export type * from "./controllers/FileController.ts";
+export type * from "./controllers/StorageStatsController.ts";
+export * from "./entities/files.ts";
+export * from "./schemas/fileQuerySchema.ts";
+export * from "./schemas/fileResourceSchema.ts";
+export * from "./schemas/storageStatsSchema.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiFiles = $module({
+  name: "alepha.api.files",
+  services: [],
+});

package/src/api-jobs/index.browser.ts

@@ -0,0 +1,15 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export * from "./entities/jobExecutions.ts";
+export * from "./schemas/jobExecutionQuerySchema.ts";
+export * from "./schemas/jobExecutionResourceSchema.ts";
+export * from "./schemas/triggerJobSchema.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiJobs = $module({
+  name: "alepha.api.jobs",
+  services: [],
+});

package/src/api-notifications/controllers/NotificationController.ts

@@ -1 +1,26 @@
-export class NotificationController {}
+import { $inject } from "alepha";
+import { pg } from "alepha/orm";
+import { $action } from "alepha/server";
+import { notifications } from "../entities/notifications.ts";
+import { notificationQuerySchema } from "../schemas/notificationQuerySchema.ts";
+import { NotificationService } from "../services/NotificationService.ts";
+
+export class NotificationController {
+  protected readonly url = "/notifications";
+  protected readonly group = "notifications";
+  protected readonly notificationService = $inject(NotificationService);
+
+  /**
+   * Find notifications with pagination and filtering.
+   */
+  public readonly findNotifications = $action({
+    path: this.url,
+    group: this.group,
+    description: "Find notifications with pagination and filtering",
+    schema: {
+      query: notificationQuerySchema,
+      response: pg.page(notifications.schema),
+    },
+    handler: ({ query }) => this.notificationService.findNotifications(query),
+  });
+}

package/src/api-notifications/index.browser.ts

@@ -0,0 +1,17 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export * from "./controllers/NotificationController.ts";
+export * from "./entities/notifications.ts";
+export * from "./schemas/notificationContactPreferencesSchema.ts";
+export * from "./schemas/notificationContactSchema.ts";
+export * from "./schemas/notificationCreateSchema.ts";
+export * from "./schemas/notificationQuerySchema.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiNotifications = $module({
+  name: "alepha.api.notifications",
+  services: [],
+});

package/src/api-notifications/index.ts

@@ -18,6 +18,7 @@ export * from "./primitives/$notification.ts";
 export * from "./queues/NotificationQueues.ts";
 export * from "./schemas/notificationContactPreferencesSchema.ts";
 export * from "./schemas/notificationCreateSchema.ts";
+export * from "./schemas/notificationQuerySchema.ts";
 export * from "./services/NotificationSenderService.ts";
 export * from "./services/NotificationService.ts";
 

package/src/api-notifications/schemas/notificationQuerySchema.ts

@@ -0,0 +1,13 @@
+import type { Static } from "alepha";
+import { t } from "alepha";
+import { pageQuerySchema } from "alepha/orm";
+
+export const notificationQuerySchema = t.extend(pageQuerySchema, {
+  type: t.optional(t.enum(["email", "sms"])),
+  template: t.optional(t.string()),
+  contact: t.optional(t.string()),
+  category: t.optional(t.string()),
+  status: t.optional(t.enum(["pending", "sent", "failed"])),
+});
+
+export type NotificationQuery = Static<typeof notificationQuerySchema>;

package/src/api-notifications/services/NotificationService.ts

@@ -2,13 +2,17 @@ import { $env, $inject, Alepha, type Static, t } from "alepha";
 import { $batch } from "alepha/batch";
 import { DateTimeProvider } from "alepha/datetime";
 import { $logger } from "alepha/logger";
-import { $repository } from "alepha/orm";
-import { notifications } from "../entities/notifications.ts";
+import { $repository, type Page } from "alepha/orm";
+import {
+  type NotificationEntity,
+  notifications,
+} from "../entities/notifications.ts";
 import { NotificationQueues } from "../queues/NotificationQueues.ts";
 import {
   type NotificationCreate,
   notificationCreateSchema,
 } from "../schemas/notificationCreateSchema.ts";
+import type { NotificationQuery } from "../schemas/notificationQuerySchema.ts";
 import { NotificationSenderService } from "./NotificationSenderService.ts";
 
 export const notificationServiceEnvSchema = t.object({
@@ -65,6 +69,45 @@ export class NotificationService {
     return this.notificationRepository.findOne({ where: { id } });
   }
 
+  public async findNotifications(
+    q: NotificationQuery = {},
+  ): Promise<Page<NotificationEntity>> {
+    this.log.trace("Finding notifications", { query: q });
+    q.sort ??= "-createdAt";
+
+    const where = this.notificationRepository.createQueryWhere();
+
+    if (q.type) {
+      where.type = { eq: q.type };
+    }
+
+    if (q.template) {
+      where.template = { like: `%${q.template}%` };
+    }
+
+    if (q.contact) {
+      where.contact = { like: `%${q.contact}%` };
+    }
+
+    if (q.category) {
+      where.category = { eq: q.category };
+    }
+
+    if (q.status) {
+      if (q.status === "sent") {
+        where.sentAt = { isNotNull: true };
+        where.error = { isNull: true };
+      } else if (q.status === "failed") {
+        where.error = { isNotNull: true };
+      } else if (q.status === "pending") {
+        where.sentAt = { isNull: true };
+        where.error = { isNull: true };
+      }
+    }
+
+    return this.notificationRepository.paginate(q, { where }, { count: true });
+  }
+
   /**
    * Create a new notification.
    */

package/src/api-parameters/index.browser.ts

@@ -0,0 +1,12 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export * from "./entities/parameters.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiParameters = $module({
+  name: "alepha.api.parameters",
+  services: [],
+});

package/src/api-users/atoms/realmAuthSettingsAtom.ts

@@ -60,10 +60,11 @@ export const realmAuthSettingsAtom = $atom({
     }),
   }),
   default: {
+    // for a fresh hello world setup, we accept registration and email login
     registrationAllowed: true,
     emailEnabled: true,
     emailRequired: true,
-    usernameEnabled: true,
+    usernameEnabled: false,
     usernameRequired: false,
     phoneEnabled: false,
     phoneRequired: false,
@@ -72,6 +73,7 @@ export const realmAuthSettingsAtom = $atom({
     resetPasswordAllowed: false,
     firstNameLastNameEnabled: false,
     firstNameLastNameRequired: false,
+    // TODO: not implemented yet
     passwordPolicy: {
       minLength: 8,
       requireUppercase: true,

package/src/api-users/controllers/UserController.ts

@@ -310,6 +310,8 @@ export class UserController {
   /**
    * Request email verification.
    * Generates a verification token using verification service and sends an email to the user.
+   * @param method - The verification method: "code" (default) sends a 6-digit code, "link" sends a clickable verification link.
+   * @param verifyUrl - Required when method is "link". The base URL for the verification link. Token and email will be appended as query params.
    */
   public requestEmailVerification = $action({
     path: "/users/email-verification/request",
@@ -317,6 +319,19 @@ export class UserController {
     schema: {
       query: t.object({
         userRealmName: t.optional(t.string()),
+        method: t.optional(
+          t.enum(["code", "link"], {
+            default: "code",
+            description:
+              'Verification method: "code" sends a 6-digit code, "link" sends a clickable verification link.',
+          }),
+        ),
+        verifyUrl: t.optional(
+          t.string({
+            description:
+              'Base URL for verification link. Required when method is "link". Token and email will be appended as query params.',
+          }),
+        ),
       }),
       body: t.object({
         email: t.email(),
@@ -327,15 +342,20 @@ export class UserController {
       }),
     },
     handler: async ({ body, query }) => {
+      const method = query.method ?? "code";
       await this.userService.requestEmailVerification(
         body.email,
         query.userRealmName,
+        method,
+        query.verifyUrl,
       );
 
       return {
         success: true,
         message:
-          "If an account exists with this email, a verification code has been sent.",
+          method === "link"
+            ? "If an account exists with this email, a verification link has been sent."
+            : "If an account exists with this email, a verification code has been sent.",
       };
     },
   });

package/src/api-users/primitives/$userRealm.ts

@@ -1,4 +1,5 @@
 import { $context } from "alepha";
+import { AlephaApiFiles } from "alepha/api/files";
 import type { Repository } from "alepha/orm";
 import {
   $realm,
@@ -48,7 +49,14 @@ export const $userRealm = (
   const userRealmProvider = alepha.inject(UserRealmProvider);
   const name = options.realm?.name ?? DEFAULT_USER_REALM_NAME;
 
-  userRealmProvider.register(name, options);
+  const userRealm = userRealmProvider.register(name, options);
+
+  if (options.modules?.audits) {
+  }
+
+  if (options.modules?.files) {
+    alepha.with(AlephaApiFiles);
+  }
 
   const realm: UserRealmPrimitive = $realm({
     ...options.realm,
@@ -103,18 +111,28 @@ export const $userRealm = (
       sessionService.login(name, credentials.username, credentials.password);
   };
 
-  if (options.identities) {
-    const identities: Record<string, AuthPrimitive> = {};
-    if (options.identities?.credentials) {
-      identities.credentials = $authCredentials(realm);
+  const identities = options.identities ?? {
+    credentials: true,
+  };
+
+  if (identities) {
+    const auth: Record<string, AuthPrimitive> = {};
+    if (identities.credentials) {
+      auth.credentials = $authCredentials(realm);
+    } else {
+      // if credentials auth is disabled, disable registration as well
+      userRealm.settings.registrationAllowed = false;
     }
-    if (options.identities?.google) {
-      identities.google = $authGoogle(realm);
+
+    if (identities.google) {
+      auth.google = $authGoogle(realm);
     }
-    if (options.identities?.github) {
-      identities.github = $authGithub(realm);
+
+    if (identities.github) {
+      auth.github = $authGithub(realm);
     }
-    alepha.with(() => identities);
+
+    alepha.with(() => auth);
   }
 
   return realm;
@@ -153,4 +171,9 @@ export interface UserRealmOptions {
     google?: true;
     github?: true;
   };
+
+  modules?: {
+    files?: boolean;
+    audits?: boolean;
+  };
 }

package/src/api-users/providers/UserRealmProvider.ts

@@ -70,6 +70,7 @@ export class UserRealmProvider {
         },
       },
     });
+    return this.getRealm(userRealmName);
   }
 
   /**

package/src/api-users/services/SessionService.ts

@@ -290,6 +290,8 @@ export class SessionService {
       realm: realm.name,
       username: profile.email.split("@")[0],
       email: profile.email,
+      // we trust the OAuth2 provider
+      emailVerified: true,
       roles: ["user"], // TODO: make default roles configurable via realm settings
     });