alepha 0.13.0 → 0.13.1

package/dist/retry/index.d.cts

@@ -1,172 +0,0 @@
-import * as alepha0 from "alepha";
-import { AlephaError, Descriptor, DescriptorArgs, KIND } from "alepha";
-import { DateTimeProvider, DurationLike } from "alepha/datetime";
-import * as alepha_logger0 from "alepha/logger";
-
-//#region src/retry/providers/RetryProvider.d.ts
-interface RetryOptions<T extends (...args: any[]) => any> {
-  /**
-   * The function to retry.
-   */
-  handler: T;
-  /**
-   * The maximum number of attempts.
-   *
-   * @default 3
-   */
-  max?: number;
-  /**
-   * The backoff strategy for delays between retries.
-   * Can be a fixed number (in ms) or a configuration object for exponential backoff.
-   *
-   * @default { initial: 200, factor: 2, jitter: true }
-   */
-  backoff?: number | RetryBackoffOptions;
-  /**
-   * An overall time limit for all retry attempts combined.
-   *
-   * e.g., `[5, 'seconds']`
-   */
-  maxDuration?: DurationLike;
-  /**
-   * A function that determines if a retry should be attempted based on the error.
-   *
-   * @default (error) => true (retries on any error)
-   */
-  when?: (error: Error) => boolean;
-  /**
-   * A custom callback for when a retry attempt fails.
-   * This is called before the delay.
-   */
-  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;
-  /**
-   * An AbortSignal to allow for external cancellation of the retry loop.
-   */
-  signal?: AbortSignal;
-  /**
-   * An additional AbortSignal to combine with the provided signal.
-   * Used internally by $retry to handle app lifecycle.
-   */
-  additionalSignal?: AbortSignal;
-}
-interface RetryBackoffOptions {
-  /**
-   * Initial delay in milliseconds.
-   *
-   * @default 200
-   */
-  initial?: number;
-  /**
-   * Multiplier for each subsequent delay.
-   *
-   * @default 2
-   */
-  factor?: number;
-  /**
-   * Maximum delay in milliseconds.
-   */
-  max?: number;
-  /**
-   * If true, adds a random jitter to the delay to prevent thundering herd.
-   *
-   * @default true
-   */
-  jitter?: boolean;
-}
-/**
- * Service for executing functions with automatic retry logic.
- * Supports exponential backoff, max duration, conditional retries, and cancellation.
- */
-declare class RetryProvider {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly dateTime: DateTimeProvider;
-  /**
-   * Execute a function with automatic retry logic.
-   */
-  retry<T extends (...args: any[]) => any>(options: RetryOptions<T>, ...args: Parameters<T>): Promise<ReturnType<T>>;
-  /**
-   * Calculate the backoff delay for a given attempt.
-   */
-  protected calculateBackoff(attempt: number, options?: number | RetryBackoffOptions): number;
-}
-//#endregion
-//#region src/retry/descriptors/$retry.d.ts
-/**
- * Creates a function that automatically retries a handler upon failure,
- * with support for exponential backoff, max duration, and cancellation.
- */
-declare const $retry: {
-  <T extends (...args: any[]) => any>(options: RetryDescriptorOptions<T>): RetryDescriptorFn<T>;
-  [KIND]: typeof RetryDescriptor;
-};
-interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
-  /**
-   * The function to retry.
-   */
-  handler: T;
-  /**
-   * The maximum number of attempts.
-   *
-   * @default 3
-   */
-  max?: number;
-  /**
-   * The backoff strategy for delays between retries.
-   * Can be a fixed number (in ms) or a configuration object for exponential backoff.
-   *
-   * @default { initial: 200, factor: 2, jitter: true }
-   */
-  backoff?: number | RetryBackoffOptions;
-  /**
-   * An overall time limit for all retry attempts combined.
-   *
-   * e.g., `[5, 'seconds']`
-   */
-  maxDuration?: DurationLike;
-  /**
-   * A function that determines if a retry should be attempted based on the error.
-   *
-   * @default (error) => true (retries on any error)
-   */
-  when?: (error: Error) => boolean;
-  /**
-   * A custom callback for when a retry attempt fails.
-   * This is called before the delay.
-   */
-  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;
-  /**
-   * An AbortSignal to allow for external cancellation of the retry loop.
-   */
-  signal?: AbortSignal;
-}
-declare class RetryDescriptor<T extends (...args: any[]) => any> extends Descriptor<RetryDescriptorOptions<T>> {
-  protected readonly retryProvider: RetryProvider;
-  protected appAbortController: AbortController;
-  constructor(args: DescriptorArgs<RetryDescriptorOptions<T>>);
-  run(...args: Parameters<T>): Promise<ReturnType<T>>;
-}
-interface RetryDescriptorFn<T extends (...args: any[]) => any> extends RetryDescriptor<T> {
-  (...args: Parameters<T>): Promise<ReturnType<T>>;
-}
-//#endregion
-//#region src/retry/errors/RetryCancelError.d.ts
-declare class RetryCancelError extends AlephaError {
-  constructor();
-}
-//#endregion
-//#region src/retry/errors/RetryTimeoutError.d.ts
-declare class RetryTimeoutError extends AlephaError {
-  constructor(duration: number);
-}
-//#endregion
-//#region src/retry/index.d.ts
-/**
- * Retry mechanism provider for Alepha applications.
- *
- * @see {@link RetryProvider}
- * @module alepha.retry
- */
-declare const AlephaRetry: alepha0.Service<alepha0.Module>;
-//#endregion
-export { $retry, AlephaRetry, RetryBackoffOptions, RetryCancelError, RetryDescriptor, RetryDescriptorFn, RetryDescriptorOptions, RetryOptions, RetryProvider, RetryTimeoutError };
-//# sourceMappingURL=index.d.cts.map

package/dist/router/index.cjs

@@ -1,111 +0,0 @@
-let alepha = require("alepha");
-
-//#region src/router/providers/RouterProvider.ts
-var RouterProvider = class {
-	routePathRegex = /^\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;
-	tree = { children: {} };
-	cache = /* @__PURE__ */ new Map();
-	match(path) {
-		if (this.cache.has(path)) return this.cache.get(path);
-		const result = this.mapParams(this.createRouteMatch(path));
-		this.cache.set(path, result);
-		return result;
-	}
-	test(path) {
-		if (!this.routePathRegex.test(path)) throw new alepha.AlephaError(`Route '${path}' is not valid`);
-	}
-	push(route) {
-		const path = route.path.replaceAll("//", "/");
-		this.test(path);
-		const parts = this.createParts(path);
-		let cursor = this.tree;
-		for (let i = 0; i < parts.length; i++) {
-			const isLast = i === parts.length - 1;
-			let part = parts[i].toLowerCase();
-			if (part === "*" && isLast) {
-				cursor.wildcard = { route };
-				break;
-			}
-			if (part.includes("*")) throw new alepha.AlephaError(`Route '${path}' has an invalid wildcard syntax`);
-			if (part.includes("{") || part.includes("}")) if (part.startsWith("{") && part.endsWith("}")) part = `:${part.slice(1, -1)}`;
-			else throw new alepha.AlephaError(`Route '${path}' has an invalid param syntax`);
-			if (part.startsWith(":")) {
-				const name = parts[i].slice(1).replaceAll("}", "");
-				if (!name) throw new alepha.AlephaError(`Route '${path}' has an empty param name`);
-				if (!cursor.param) cursor.param = {
-					name,
-					children: {}
-				};
-				else if (cursor.param.name !== name) {
-					route.mapParams ??= {};
-					route.mapParams[cursor.param.name] = name;
-				}
-				if (isLast) cursor.param.route = route;
-				cursor = cursor.param;
-				continue;
-			}
-			if (!cursor.children[part]) cursor.children[part] = { children: {} };
-			if (isLast) cursor.children[part].route = route;
-			cursor = cursor.children[part];
-		}
-	}
-	createRouteMatch(path) {
-		if (path[0] !== "/") throw new alepha.AlephaError(`Path '${path}' must start with "/"`);
-		const parts = this.createParts(path);
-		let cursor = this.tree;
-		let wildcard;
-		const params = {};
-		for (let i = 0; i < parts.length; i++) {
-			const part = parts[i].toLowerCase();
-			if (cursor.children[part]) {
-				if (cursor.wildcard) wildcard = cursor.wildcard;
-				cursor = cursor.children[part];
-			} else if (cursor.param) {
-				if (cursor.wildcard) wildcard = cursor.wildcard;
-				params[cursor.param.name] = parts[i];
-				cursor = cursor.param;
-			} else if (cursor.wildcard) {
-				params["*"] = parts.slice(i).join("/");
-				return {
-					route: cursor.wildcard.route,
-					params
-				};
-			} else return {
-				route: wildcard?.route,
-				params
-			};
-		}
-		if (!cursor?.route) {
-			if (cursor.wildcard) return {
-				route: cursor.wildcard.route,
-				params
-			};
-			return {
-				route: wildcard?.route,
-				params
-			};
-		}
-		return {
-			route: cursor.route,
-			params
-		};
-	}
-	mapParams(match) {
-		if (match.route?.mapParams && match.params) {
-			for (const [key, value] of Object.entries(match.route.mapParams)) if (match.params[key]) {
-				match.params[value] = match.params[key];
-				delete match.params[key];
-			}
-		}
-		return match;
-	}
-	createParts(path) {
-		let pathname = path.split("?")[0].replaceAll("//", "/");
-		if (pathname.endsWith("/") && pathname.length > 1) pathname = pathname.slice(0, -1);
-		return pathname.split("/").slice(1);
-	}
-};
-
-//#endregion
-exports.RouterProvider = RouterProvider;
-//# sourceMappingURL=index.cjs.map

package/dist/router/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["AlephaError","wildcard: { route: T } | undefined","params: Record<string, string>"],"sources":["../../src/router/providers/RouterProvider.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n\n  public match(path: string): RouteMatch<T> {\n    if (this.cache.has(path)) {\n      return this.cache.get(path)!;\n    }\n    const result = this.mapParams(this.createRouteMatch(path));\n    this.cache.set(path, result);\n    return result;\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n"],"mappings":"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"}

package/dist/router/index.d.cts

@@ -1,46 +0,0 @@
-//#region src/router/providers/RouterProvider.d.ts
-declare abstract class RouterProvider<T extends Route = Route> {
-  protected routePathRegex: RegExp;
-  protected tree: Tree<T>;
-  protected cache: Map<string, RouteMatch<T>>;
-  match(path: string): RouteMatch<T>;
-  protected test(path: string): void;
-  protected push(route: T): void;
-  protected createRouteMatch(path: string): RouteMatch<T>;
-  protected mapParams(match: RouteMatch<T>): RouteMatch<T>;
-  protected createParts(path: string): string[];
-}
-interface RouteMatch<T extends Route> {
-  route?: T;
-  params?: Record<string, string>;
-}
-interface Route {
-  path: string;
-  /**
-   * Rename a param in the route.
-   * This is automatically filled when you have scenarios like:
-   * `/customers/:id` and `/customers/:userId/payments`
-   *
-   * In this case, `:id` will be renamed to `:userId` in the second route.
-   */
-  mapParams?: Record<string, string>;
-}
-interface Tree<T extends Route> {
-  route?: T;
-  children: {
-    [key: string]: Tree<T>;
-  };
-  param?: {
-    route?: T;
-    name: string;
-    children: {
-      [key: string]: Tree<T>;
-    };
-  };
-  wildcard?: {
-    route: T;
-  };
-}
-//#endregion
-export { Route, RouteMatch, RouterProvider, Tree };
-//# sourceMappingURL=index.d.cts.map