alepha 0.13.0 → 0.13.2

package/dist/server-security/index.d.cts

@@ -1,173 +0,0 @@
-import * as alepha1 from "alepha";
-import { Alepha, Descriptor, KIND } from "alepha";
-import { JwtProvider, Permission, SecurityProvider, UserAccount, UserAccountToken } from "alepha/security";
-import { FetchOptions, ServerRequest, ServerRouterProvider } from "alepha/server";
-import * as alepha_logger0 from "alepha/logger";
-
-//#region src/server-security/providers/ServerBasicAuthProvider.d.ts
-interface BasicAuthOptions {
-  username: string;
-  password: string;
-}
-interface BasicAuthDescriptorConfig extends BasicAuthOptions {
-  /** Name identifier for this basic auth (default: property key) */
-  name?: string;
-  /** Path patterns to match (supports wildcards like /devtools/*) */
-  paths?: string[];
-}
-declare class ServerBasicAuthProvider {
-  protected readonly alepha: Alepha;
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly routerProvider: ServerRouterProvider;
-  protected readonly realm = "Secure Area";
-  /**
-   * Registered basic auth descriptors with their configurations
-   */
-  readonly registeredAuths: BasicAuthDescriptorConfig[];
-  /**
-   * Register a basic auth configuration (called by descriptors)
-   */
-  registerAuth(config: BasicAuthDescriptorConfig): void;
-  readonly onStart: alepha1.HookDescriptor<"start">;
-  /**
-   * Hook into server:onRequest to check basic auth
-   */
-  readonly onRequest: alepha1.HookDescriptor<"server:onRequest">;
-  /**
-   * Hook into action:onRequest to check basic auth for actions
-   */
-  readonly onActionRequest: alepha1.HookDescriptor<"action:onRequest">;
-  /**
-   * Check basic authentication
-   */
-  checkAuth(request: ServerRequest, options: BasicAuthOptions): void;
-  /**
-   * Performs a timing-safe comparison of credentials to prevent timing attacks.
-   * Always compares both username and password to avoid leaking which one is wrong.
-   */
-  protected timingSafeCredentialCheck(inputUsername: string, inputPassword: string, expectedUsername: string, expectedPassword: string): boolean;
-  /**
-   * Compares two buffers in constant time, handling different lengths safely.
-   * Returns 1 if equal, 0 if not equal.
-   */
-  protected safeCompare(input: Buffer, expected: Buffer): number;
-  /**
-   * Send WWW-Authenticate header
-   */
-  protected sendAuthRequired(request: ServerRequest): void;
-}
-declare const isBasicAuth: (value: unknown) => value is {
-  basic: BasicAuthOptions;
-};
-//#endregion
-//#region src/server-security/providers/ServerSecurityProvider.d.ts
-declare class ServerSecurityProvider {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly securityProvider: SecurityProvider;
-  protected readonly jwtProvider: JwtProvider;
-  protected readonly alepha: Alepha;
-  protected readonly onConfigure: alepha1.HookDescriptor<"configure">;
-  protected readonly onActionRequest: alepha1.HookDescriptor<"action:onRequest">;
-  protected readonly onRequest: alepha1.HookDescriptor<"server:onRequest">;
-  protected check(user: UserAccountToken, secure: ServerRouteSecure): void;
-  /**
-   * Get the user account token for a local action call.
-   * There are three possible sources for the user:
-   * - `options.user`: the user passed in the options
-   * - `"system"`: the system user from the state (you MUST set state `server.security.system.user`)
-   * - `"context"`: the user from the request context (you MUST be in an HTTP request context)
-   *
-   * Priority order: `options.user` > `"system"` > `"context"`.
-   *
-   * In testing environment, if no user is provided, a test user is created based on the SecurityProvider's roles.
-   */
-  protected createUserFromLocalFunctionContext(options: {
-    user?: UserAccountToken | "system" | "context";
-  }, permission?: Permission): UserAccountToken;
-  protected createTestUser(): UserAccountToken;
-  protected readonly onClientRequest: alepha1.HookDescriptor<"client:onRequest">;
-}
-type ServerRouteSecure = {
-  realm?: string;
-  basic?: BasicAuthOptions;
-};
-//#endregion
-//#region src/server-security/descriptors/$basicAuth.d.ts
-/**
- * Declares HTTP Basic Authentication for server routes.
- * This descriptor provides methods to protect routes with username/password authentication.
- */
-declare const $basicAuth: {
-  (options: BasicAuthDescriptorConfig): AbstractBasicAuthDescriptor;
-  [KIND]: typeof BasicAuthDescriptor;
-};
-interface AbstractBasicAuthDescriptor {
-  readonly name: string;
-  readonly options: BasicAuthDescriptorConfig;
-  check(request: ServerRequest, options?: BasicAuthOptions): void;
-}
-declare class BasicAuthDescriptor extends Descriptor<BasicAuthDescriptorConfig> implements AbstractBasicAuthDescriptor {
-  protected readonly serverBasicAuthProvider: ServerBasicAuthProvider;
-  get name(): string;
-  protected onInit(): void;
-  /**
-   * Checks basic auth for the given request using this descriptor's configuration.
-   */
-  check(request: ServerRequest, options?: BasicAuthOptions): void;
-}
-//#endregion
-//#region src/server-security/index.d.ts
-declare module "alepha" {
-  interface State {
-    /**
-     * Real (or fake) user account, used for internal actions.
-     *
-     * If you define this, you assume that all actions are executed by this user by default.
-     * > To force a different user, you need to pass it explicitly in the options.
-     */
-    "alepha.server.security.system.user"?: UserAccountToken;
-    /**
-     * The authenticated user account attached to the server request state.
-     *
-     * @internal
-     */
-    "alepha.server.request.user"?: UserAccount;
-  }
-}
-declare module "alepha/server" {
-  interface ServerRequest<TConfig> {
-    user?: UserAccountToken;
-  }
-  interface ServerActionRequest<TConfig> {
-    user: UserAccountToken;
-  }
-  interface ServerRoute {
-    /**
-     * If true, the route will be protected by the security provider.
-     * All actions are secure by default, but you can disable it for specific actions.
-     */
-    secure?: boolean | ServerRouteSecure;
-  }
-  interface ClientRequestOptions extends FetchOptions {
-    /**
-     * Forward user from the previous request.
-     * If "system", use system user. @see {ServerSecurityProvider.localSystemUser}
-     * If "context", use the user from the current context (e.g. request).
-     *
-     * @default "system" if provided, else "context" if available.
-     */
-    user?: UserAccountToken | "system" | "context";
-  }
-}
-/**
- * Plugin for Alepha Server that provides security features. Based on the Alepha Security module.
- *
- * By default, all $action will be guarded by a permission check.
- *
- * @see {@link ServerSecurityProvider}
- * @module alepha.server.security
- */
-declare const AlephaServerSecurity: alepha1.Service<alepha1.Module>;
-//#endregion
-export { $basicAuth, AbstractBasicAuthDescriptor, AlephaServerSecurity, BasicAuthDescriptor, BasicAuthDescriptorConfig, BasicAuthOptions, ServerBasicAuthProvider, ServerRouteSecure, ServerSecurityProvider, isBasicAuth };
-//# sourceMappingURL=index.d.cts.map

package/dist/server-static/index.cjs

@@ -1,170 +0,0 @@
-let alepha = require("alepha");
-let alepha_server = require("alepha/server");
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
-let alepha_datetime = require("alepha/datetime");
-let alepha_file = require("alepha/file");
-let alepha_logger = require("alepha/logger");
-
-//#region src/server-static/descriptors/$serve.ts
-/**
-* Create a new static file handler.
-*/
-const $serve = (options = {}) => {
-	return (0, alepha.createDescriptor)(ServeDescriptor, options);
-};
-var ServeDescriptor = class extends alepha.Descriptor {};
-$serve[alepha.KIND] = ServeDescriptor;
-
-//#endregion
-//#region src/server-static/providers/ServerStaticProvider.ts
-var ServerStaticProvider = class {
-	alepha = (0, alepha.$inject)(alepha.Alepha);
-	routerProvider = (0, alepha.$inject)(alepha_server.ServerRouterProvider);
-	dateTimeProvider = (0, alepha.$inject)(alepha_datetime.DateTimeProvider);
-	fileDetector = (0, alepha.$inject)(alepha_file.FileDetector);
-	log = (0, alepha_logger.$logger)();
-	directories = [];
-	configure = (0, alepha.$hook)({
-		on: "configure",
-		handler: async () => {
-			await Promise.all(this.alepha.descriptors($serve).map((it) => this.createStaticServer(it.options)));
-		}
-	});
-	async createStaticServer(options) {
-		const prefix = options.path ?? "/";
-		let root = options.root ?? process.cwd();
-		if (!(0, node_path.isAbsolute)(root)) root = (0, node_path.join)(process.cwd(), root);
-		this.log.debug("Serve static files", {
-			prefix,
-			root
-		});
-		await (0, node_fs_promises.stat)(root);
-		const files = await this.getAllFiles(root, options.ignoreDotEnvFiles);
-		const routes = await Promise.all(files.map(async (file) => {
-			const path = file.replace(root, "").replace(/\\/g, "/");
-			this.log.trace(`Mount ${(0, node_path.join)(prefix, path)} -> ${(0, node_path.join)(root, path)}`);
-			return {
-				path: (0, node_path.join)(prefix, encodeURI(path)),
-				handler: await this.createFileHandler((0, node_path.join)(root, path), options)
-			};
-		}));
-		for (const route of routes) {
-			this.routerProvider.createRoute(route);
-			if (options.indexFallback !== false && route.path.endsWith("index.html")) this.routerProvider.createRoute({
-				path: route.path.replace(/index\.html$/, ""),
-				handler: route.handler
-			});
-		}
-		this.directories.push({
-			options,
-			files: files.map((file) => file.replace(root, "").replace(/\\/g, "/"))
-		});
-		if (options.historyApiFallback) this.routerProvider.createRoute({
-			path: (0, node_path.join)(prefix, "*").replace(/\\/g, "/"),
-			handler: async (request) => {
-				const { reply } = request;
-				if (request.url.pathname.includes(".")) {
-					reply.headers["content-type"] = "text/plain";
-					reply.body = "Not Found";
-					reply.status = 404;
-					return;
-				}
-				reply.headers["content-type"] = "text/html";
-				reply.status = 200;
-				return (0, node_fs.createReadStream)((0, node_path.join)(root, "index.html"));
-			}
-		});
-	}
-	async createFileHandler(filepath, options) {
-		const filename = (0, node_path.basename)(filepath);
-		const hasGzip = await (0, node_fs_promises.access)(`${filepath}.gz`).then(() => true).catch(() => false);
-		const hasBr = await (0, node_fs_promises.access)(`${filepath}.br`).then(() => true).catch(() => false);
-		const fileStat = await (0, node_fs_promises.stat)(filepath);
-		const lastModified = fileStat.mtime.toUTCString();
-		const etag = `"${fileStat.size}-${fileStat.mtime.getTime()}"`;
-		const contentType = this.fileDetector.getContentType(filename);
-		const cacheControl = this.getCacheControl(filename, options);
-		return async (request) => {
-			const { headers, reply } = request;
-			let path = filepath;
-			const encoding = headers["accept-encoding"];
-			if (encoding) {
-				if (hasBr && encoding.includes("br")) {
-					reply.headers["content-encoding"] = "br";
-					path += ".br";
-				} else if (hasGzip && encoding.includes("gzip")) {
-					reply.headers["content-encoding"] = "gzip";
-					path += ".gz";
-				}
-			}
-			reply.headers["content-type"] = contentType;
-			reply.headers["accept-ranges"] = "bytes";
-			reply.headers["last-modified"] = lastModified;
-			if (cacheControl) {
-				reply.headers["cache-control"] = `public, max-age=${cacheControl.maxAge}`;
-				if (cacheControl.immutable) reply.headers["cache-control"] += ", immutable";
-			}
-			reply.headers.etag = etag;
-			if (headers["if-none-match"] === etag || headers["if-modified-since"] === lastModified) {
-				reply.status = 304;
-				return;
-			}
-			return (0, node_fs.createReadStream)(path);
-		};
-	}
-	getCacheFileTypes() {
-		return [
-			".js",
-			".css",
-			".woff",
-			".woff2",
-			".ttf",
-			".eot",
-			".otf",
-			".jpg",
-			".jpeg",
-			".png",
-			".svg",
-			".gif"
-		];
-	}
-	getCacheControl(filename, options) {
-		if (!options.cacheControl) return;
-		const fileTypes = options.cacheControl.fileTypes ?? this.getCacheFileTypes();
-		for (const type of fileTypes) if (filename.endsWith(type)) return {
-			immutable: options.cacheControl.immutable ?? true,
-			maxAge: this.dateTimeProvider.duration(options.cacheControl.maxAge ?? [30, "days"]).as("seconds")
-		};
-	}
-	async getAllFiles(dir, ignoreDotEnvFiles = true) {
-		const entries = await (0, node_fs_promises.readdir)(dir, { withFileTypes: true });
-		return (await Promise.all(entries.map((dirent) => {
-			if (ignoreDotEnvFiles && dirent.name.startsWith(".")) return [];
-			const fullPath = (0, node_path.join)(dir, dirent.name);
-			return dirent.isDirectory() ? this.getAllFiles(fullPath) : fullPath;
-		}))).flat();
-	}
-};
-
-//#endregion
-//#region src/server-static/index.ts
-/**
-* Create static file server with `$static()`.
-*
-* @see {@link ServerStaticProvider}
-* @module alepha.server.static
-*/
-const AlephaServerStatic = (0, alepha.$module)({
-	name: "alepha.server.static",
-	descriptors: [$serve],
-	services: [alepha_server.AlephaServer, ServerStaticProvider]
-});
-
-//#endregion
-exports.$serve = $serve;
-exports.AlephaServerStatic = AlephaServerStatic;
-exports.ServeDescriptor = ServeDescriptor;
-exports.ServerStaticProvider = ServerStaticProvider;
-//# sourceMappingURL=index.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["Descriptor","KIND","Alepha","ServerRouterProvider","DateTimeProvider","FileDetector","AlephaServer"],"sources":["../../src/server-static/descriptors/$serve.ts","../../src/server-static/providers/ServerStaticProvider.ts","../../src/server-static/index.ts"],"sourcesContent":["import { createDescriptor, Descriptor, KIND } from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\n\n/**\n * Create a new static file handler.\n */\nexport const $serve = (\n  options: ServeDescriptorOptions = {},\n): ServeDescriptor => {\n  return createDescriptor(ServeDescriptor, options);\n};\n\nexport interface ServeDescriptorOptions {\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, descriptor 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 descriptor.\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 ServeDescriptor extends Descriptor<ServeDescriptorOptions> {}\n\n$serve[KIND] = ServeDescriptor;\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 ServeDescriptorOptions } from \"../descriptors/$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          .descriptors($serve)\n          .map((it) => this.createStaticServer(it.options)),\n      );\n    },\n  });\n\n  public async createStaticServer(\n    options: ServeDescriptorOptions,\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: ServeDescriptorOptions,\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: ServeDescriptorOptions,\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: ServeDescriptorOptions;\n  files: string[];\n}\n","import { $module } from \"alepha\";\nimport { AlephaServer } from \"alepha/server\";\nimport { $serve } from \"./descriptors/$serve.ts\";\nimport { ServerStaticProvider } from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./descriptors/$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  descriptors: [$serve],\n  services: [AlephaServer, ServerStaticProvider],\n});\n"],"mappings":"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"}

package/dist/server-static/index.d.cts

@@ -1,121 +0,0 @@
-import * as alepha1 from "alepha";
-import { Alepha, Descriptor, KIND } from "alepha";
-import { DateTimeProvider, DurationLike } from "alepha/datetime";
-import * as alepha_logger0 from "alepha/logger";
-import { FileDetector } from "alepha/file";
-import { ServerHandler, ServerRouterProvider } from "alepha/server";
-
-//#region src/server-static/descriptors/$serve.d.ts
-/**
- * Create a new static file handler.
- */
-declare const $serve: {
-  (options?: ServeDescriptorOptions): ServeDescriptor;
-  [KIND]: typeof ServeDescriptor;
-};
-interface ServeDescriptorOptions {
-  /**
-   * Prefix for the served path.
-   *
-   * @default "/"
-   */
-  path?: string;
-  /**
-   * Path to the directory to serve.
-   *
-   * @default process.cwd()
-   */
-  root?: string;
-  /**
-   * If true, descriptor will be ignored.
-   *
-   * @default false
-   */
-  disabled?: boolean;
-  /**
-   * Whether to keep dot files (e.g. `.gitignore`, `.env`) in the served directory.
-   *
-   * @default true
-   */
-  ignoreDotEnvFiles?: boolean;
-  /**
-   * Whether to use the index.html file when the path is a directory.
-   *
-   * @default true
-   */
-  indexFallback?: boolean;
-  /**
-   * Force all requests "not found" to be served with the index.html file.
-   * This is useful for single-page applications (SPAs) that use client-side only routing.
-   */
-  historyApiFallback?: boolean;
-  /**
-   * Optional name of the descriptor.
-   * This is used for logging and debugging purposes.
-   *
-   * @default Key name.
-   */
-  name?: string;
-  /**
-   * Whether to use cache control headers.
-   *
-   * @default {}
-   */
-  cacheControl?: Partial<CacheControlOptions> | false;
-}
-interface CacheControlOptions {
-  /**
-   * Whether to use cache control headers.
-   *
-   * @default [.js, .css]
-   */
-  fileTypes: string[];
-  /**
-   * The maximum age of the cache in seconds.
-   *
-   * @default 60 * 60 * 24 * 2 // 2 days
-   */
-  maxAge: DurationLike;
-  /**
-   * Whether to use immutable cache control headers.
-   *
-   * @default true
-   */
-  immutable: boolean;
-}
-declare class ServeDescriptor extends Descriptor<ServeDescriptorOptions> {}
-//#endregion
-//#region src/server-static/providers/ServerStaticProvider.d.ts
-declare class ServerStaticProvider {
-  protected readonly alepha: Alepha;
-  protected readonly routerProvider: ServerRouterProvider;
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly fileDetector: FileDetector;
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly directories: ServeDirectory[];
-  protected readonly configure: alepha1.HookDescriptor<"configure">;
-  createStaticServer(options: ServeDescriptorOptions): Promise<void>;
-  createFileHandler(filepath: string, options: ServeDescriptorOptions): Promise<ServerHandler>;
-  protected getCacheFileTypes(): string[];
-  protected getCacheControl(filename: string, options: ServeDescriptorOptions): {
-    maxAge: number;
-    immutable: boolean;
-  } | undefined;
-  getAllFiles(dir: string, ignoreDotEnvFiles?: boolean): Promise<string[]>;
-}
-interface ServeDirectory {
-  options: ServeDescriptorOptions;
-  files: string[];
-}
-//#endregion
-//#region src/server-static/index.d.ts
-/**
- * Create static file server with `$static()`.
- *
- * @see {@link ServerStaticProvider}
- * @module alepha.server.static
- */
-declare const AlephaServerStatic: alepha1.Service<alepha1.Module>;
-//#endregion
-export { $serve, AlephaServerStatic, CacheControlOptions, ServeDescriptor, ServeDescriptorOptions, ServeDirectory, ServerStaticProvider };
-//# sourceMappingURL=index.d.cts.map