alepha 0.12.1 → 0.13.1

package/dist/queue/index.d.ts

@@ -1,6 +1,6 @@
 import * as alepha1 from "alepha";
 import { Alepha, Descriptor, KIND, Service, Static, TSchema } from "alepha";
-import * as alepha_logger1 from "alepha/logger";
+import * as alepha_logger0 from "alepha/logger";
 import { DateTimeProvider } from "alepha/datetime";
 
 //#region src/queue/interfaces/QueueJob.d.ts
@@ -600,7 +600,7 @@ interface JobWaiter {
  * - Scenarios where job persistence across restarts is not required
  */
 declare class MemoryQueueProvider extends QueueProvider {
-  protected readonly log: alepha_logger1.Logger;
+  protected readonly log: alepha_logger0.Logger;
   protected messageQueues: Record<string, string[]>;
   protected messageWaiters: Set<MessageWaiter>;
   protected jobs: Map<string, Map<string, QueueJob>>;
@@ -947,7 +947,7 @@ interface QueueDescriptorOptions<T extends TSchema> {
   removeOnFail?: boolean | number;
 }
 declare class QueueDescriptor<T extends TSchema> extends Descriptor<QueueDescriptorOptions<T>> {
-  protected readonly log: alepha_logger1.Logger;
+  protected readonly log: alepha_logger0.Logger;
   readonly provider: QueueProvider | MemoryQueueProvider;
   /**
    * Push one or more payloads to the queue for background processing.
@@ -1180,7 +1180,7 @@ declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
 declare class WorkerProvider {
-  protected readonly log: alepha_logger1.Logger;
+  protected readonly log: alepha_logger0.Logger;
   protected readonly env: {
     QUEUE_WORKER_BLOCKING_TIMEOUT: number;
     QUEUE_WORKER_CONCURRENCY: number;

package/dist/redis/index.d.ts

@@ -1,13 +1,13 @@
-import * as alepha1 from "alepha";
+import * as alepha3 from "alepha";
 import { Alepha, Static } from "alepha";
 import { RedisClientType, SetOptions, createClient } from "@redis/client";
 import * as alepha_logger0 from "alepha/logger";
 
 //#region src/redis/providers/RedisProvider.d.ts
-declare const envSchema: alepha1.TObject<{
-  REDIS_PORT: alepha1.TInteger;
-  REDIS_HOST: alepha1.TString;
-  REDIS_PASSWORD: alepha1.TOptional<alepha1.TString>;
+declare const envSchema: alepha3.TObject<{
+  REDIS_PORT: alepha3.TInteger;
+  REDIS_HOST: alepha3.TString;
+  REDIS_PASSWORD: alepha3.TOptional<alepha3.TString>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -30,8 +30,8 @@ declare class RedisProvider {
   };
   protected readonly client: RedisClient;
   get publisher(): RedisClient;
-  protected readonly start: alepha1.HookDescriptor<"start">;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
+  protected readonly start: alepha3.HookDescriptor<"start">;
+  protected readonly stop: alepha3.HookDescriptor<"stop">;
   /**
    * Connect to the Redis server.
    */
@@ -59,8 +59,8 @@ declare class RedisSubscriberProvider {
   protected readonly redisProvider: RedisProvider;
   protected readonly client: RedisClient;
   get subscriber(): RedisClient;
-  protected readonly start: alepha1.HookDescriptor<"start">;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
+  protected readonly start: alepha3.HookDescriptor<"start">;
+  protected readonly stop: alepha3.HookDescriptor<"stop">;
   connect(): Promise<void>;
   close(): Promise<void>;
   /**
@@ -76,7 +76,7 @@ declare class RedisSubscriberProvider {
  * @see {@link RedisProvider}
  * @module alepha.redis
  */
-declare const AlephaRedis: alepha1.Service<alepha1.Module>;
+declare const AlephaRedis: alepha3.Service<alepha3.Module>;
 //#endregion
 export { AlephaRedis, RedisClient, RedisClientOptions, RedisProvider, RedisSetOptions, RedisSubscriberProvider };
 //# sourceMappingURL=index.d.ts.map

package/dist/retry/index.d.ts

@@ -141,7 +141,7 @@ interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
 }
 declare class RetryDescriptor<T extends (...args: any[]) => any> extends Descriptor<RetryDescriptorOptions<T>> {
   protected readonly retryProvider: RetryProvider;
-  protected appAbortController: AbortController;
+  protected appAbortController?: AbortController;
   constructor(args: DescriptorArgs<RetryDescriptorOptions<T>>);
   run(...args: Parameters<T>): Promise<ReturnType<T>>;
 }

package/dist/retry/index.js

@@ -108,12 +108,12 @@ var RetryDescriptor = class extends Descriptor {
 	appAbortController;
 	constructor(args) {
 		super(args);
-		this.appAbortController = new AbortController();
 		this.alepha.events.on("stop", () => {
-			this.appAbortController.abort();
+			this.appAbortController?.abort();
 		});
 	}
 	async run(...args) {
+		this.appAbortController ??= new AbortController();
 		return this.retryProvider.retry({
 			...this.options,
 			additionalSignal: this.appAbortController.signal

package/dist/retry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["lastError: Error | undefined"],"sources":["../../src/retry/errors/RetryCancelError.ts","../../src/retry/errors/RetryTimeoutError.ts","../../src/retry/providers/RetryProvider.ts","../../src/retry/descriptors/$retry.ts","../../src/retry/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class RetryCancelError extends AlephaError {\n  constructor() {\n    super(\"Retry operation was cancelled.\");\n    this.name = \"RetryCancelError\";\n  }\n}\n","import { AlephaError } from \"alepha\";\n\nexport class RetryTimeoutError extends AlephaError {\n  constructor(duration: number) {\n    super(`Retry operation timed out after ${duration}ms.`);\n    this.name = \"RetryTimeoutError\";\n  }\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { RetryCancelError } from \"../errors/RetryCancelError.ts\";\nimport { RetryTimeoutError } from \"../errors/RetryTimeoutError.ts\";\n\nexport interface RetryOptions<T extends (...args: any[]) => any> {\n  /**\n   * The function to retry.\n   */\n  handler: T;\n\n  /**\n   * The maximum number of attempts.\n   *\n   * @default 3\n   */\n  max?: number;\n\n  /**\n   * The backoff strategy for delays between retries.\n   * Can be a fixed number (in ms) or a configuration object for exponential backoff.\n   *\n   * @default { initial: 200, factor: 2, jitter: true }\n   */\n  backoff?: number | RetryBackoffOptions;\n\n  /**\n   * An overall time limit for all retry attempts combined.\n   *\n   * e.g., `[5, 'seconds']`\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * A function that determines if a retry should be attempted based on the error.\n   *\n   * @default (error) => true (retries on any error)\n   */\n  when?: (error: Error) => boolean;\n\n  /**\n   * A custom callback for when a retry attempt fails.\n   * This is called before the delay.\n   */\n  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;\n\n  /**\n   * An AbortSignal to allow for external cancellation of the retry loop.\n   */\n  signal?: AbortSignal;\n\n  /**\n   * An additional AbortSignal to combine with the provided signal.\n   * Used internally by $retry to handle app lifecycle.\n   */\n  additionalSignal?: AbortSignal;\n}\n\nexport interface RetryBackoffOptions {\n  /**\n   * Initial delay in milliseconds.\n   *\n   * @default 200\n   */\n  initial?: number;\n\n  /**\n   * Multiplier for each subsequent delay.\n   *\n   * @default 2\n   */\n  factor?: number;\n\n  /**\n   * Maximum delay in milliseconds.\n   */\n  max?: number;\n\n  /**\n   * If true, adds a random jitter to the delay to prevent thundering herd.\n   *\n   * @default true\n   */\n  jitter?: boolean;\n}\n\n/**\n * Service for executing functions with automatic retry logic.\n * Supports exponential backoff, max duration, conditional retries, and cancellation.\n */\nexport class RetryProvider {\n  protected readonly log = $logger();\n  protected readonly dateTime = $inject(DateTimeProvider);\n\n  /**\n   * Execute a function with automatic retry logic.\n   */\n  async retry<T extends (...args: any[]) => any>(\n    options: RetryOptions<T>,\n    ...args: Parameters<T>\n  ): Promise<ReturnType<T>> {\n    const maxAttempts = options.max ?? 3;\n    const when = options.when ?? (() => true);\n    const { handler, onError } = options;\n\n    let lastError: Error | undefined;\n    const startTime = Date.now();\n\n    const maxDurationMs = options.maxDuration\n      ? this.dateTime.duration(options.maxDuration).asMilliseconds()\n      : Infinity;\n\n    // Combine user-provided signal with additional signal (e.g., app lifecycle)\n    const signals = [options.signal, options.additionalSignal].filter(Boolean);\n    const onAbort = () => {\n      // Always set RetryCancelError when aborted, even if another error exists\n      // This ensures cancellation takes precedence over retry errors\n      lastError = new RetryCancelError();\n    };\n\n    // Add abort listeners to all signals\n    for (const signal of signals) {\n      signal?.addEventListener(\"abort\", onAbort);\n    }\n\n    // FIX BUG #8: Create combined signal ONCE at the start instead of on each backoff\n    // This prevents memory leak from creating multiple AbortSignal.any() instances\n    const waitSignals = [options.signal, options.additionalSignal].filter(\n      Boolean,\n    ) as AbortSignal[];\n    const combinedSignal =\n      waitSignals.length > 0 ? AbortSignal.any(waitSignals) : undefined;\n\n    try {\n      for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n        // Check for cancellation\n        if (signals.some((signal) => signal?.aborted)) {\n          throw new RetryCancelError();\n        }\n\n        // Check for timeout before attempting\n        if (Date.now() - startTime >= maxDurationMs) {\n          throw new RetryTimeoutError(maxDurationMs);\n        }\n\n        try {\n          const result = await handler(...args);\n\n          // Check for timeout after handler execution\n          if (Date.now() - startTime >= maxDurationMs) {\n            throw new RetryTimeoutError(maxDurationMs);\n          }\n\n          return result;\n        } catch (err) {\n          lastError = err as Error;\n\n          // Check for timeout after error\n          if (Date.now() - startTime >= maxDurationMs) {\n            throw new RetryTimeoutError(maxDurationMs);\n          }\n\n          // Log the error with warning level\n          this.log.warn(\"Retry attempt failed\", {\n            attempt,\n            maxAttempts,\n            remainingAttempts: maxAttempts - attempt,\n            error: lastError.message,\n            errorName: lastError.name,\n          });\n\n          if (!(err instanceof Error) || !when(err)) {\n            throw err; // don't retry if it's not an Error or `when` returns false\n          }\n\n          // FIX BUG #7: Call onError BEFORE checking if this is the final attempt\n          // This ensures onError is called for ALL failed attempts, including the last one\n          if (onError) {\n            onError(err, attempt, ...args);\n          }\n\n          if (attempt >= maxAttempts) {\n            break; // will throw lastError after the loop\n          }\n\n          // Calculate and wait for backoff delay\n          const delay = this.calculateBackoff(attempt, options.backoff);\n          if (delay > 0) {\n            await this.dateTime.wait(delay, { signal: combinedSignal });\n          }\n\n          // Check for timeout after backoff wait before next attempt\n          if (Date.now() - startTime >= maxDurationMs) {\n            throw new RetryTimeoutError(maxDurationMs);\n          }\n        }\n      }\n    } finally {\n      // Clean up listeners to prevent memory leaks\n      for (const signal of signals) {\n        signal?.removeEventListener(\"abort\", onAbort);\n      }\n    }\n\n    throw lastError;\n  }\n\n  /**\n   * Calculate the backoff delay for a given attempt.\n   */\n  protected calculateBackoff(\n    attempt: number,\n    options?: number | RetryBackoffOptions,\n  ): number {\n    if (typeof options === \"number\") {\n      return options;\n    }\n\n    const initial = options?.initial ?? 200;\n    const factor = options?.factor ?? 2;\n    const max = options?.max ?? 10000;\n    const useJitter = options?.jitter !== false;\n\n    const exponential = initial * factor ** (attempt - 1);\n    let delay = Math.min(exponential, max);\n\n    if (useJitter) {\n      // Add a random amount of jitter (e.g., up to 50% of the delay)\n      delay = delay * (1 + Math.random() * 0.5);\n    }\n\n    return Math.floor(delay);\n  }\n}\n","import {\n  $inject,\n  createDescriptor,\n  Descriptor,\n  type DescriptorArgs,\n  KIND,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport type { RetryBackoffOptions } from \"../providers/RetryProvider.ts\";\nimport { RetryProvider } from \"../providers/RetryProvider.ts\";\n\n/**\n * Creates a function that automatically retries a handler upon failure,\n * with support for exponential backoff, max duration, and cancellation.\n */\nexport const $retry = <T extends (...args: any[]) => any>(\n  options: RetryDescriptorOptions<T>,\n): RetryDescriptorFn<T> => {\n  const instance = createDescriptor(RetryDescriptor, options);\n  const fn = (...args: Parameters<T>) => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as RetryDescriptorFn<T>;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface RetryDescriptorOptions<T extends (...args: any[]) => any> {\n  /**\n   * The function to retry.\n   */\n  handler: T;\n\n  /**\n   * The maximum number of attempts.\n   *\n   * @default 3\n   */\n  max?: number;\n\n  /**\n   * The backoff strategy for delays between retries.\n   * Can be a fixed number (in ms) or a configuration object for exponential backoff.\n   *\n   * @default { initial: 200, factor: 2, jitter: true }\n   */\n  backoff?: number | RetryBackoffOptions;\n\n  /**\n   * An overall time limit for all retry attempts combined.\n   *\n   * e.g., `[5, 'seconds']`\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * A function that determines if a retry should be attempted based on the error.\n   *\n   * @default (error) => true (retries on any error)\n   */\n  when?: (error: Error) => boolean;\n\n  /**\n   * A custom callback for when a retry attempt fails.\n   * This is called before the delay.\n   */\n  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;\n\n  /**\n   * An AbortSignal to allow for external cancellation of the retry loop.\n   */\n  signal?: AbortSignal;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RetryDescriptor<\n  T extends (...args: any[]) => any,\n> extends Descriptor<RetryDescriptorOptions<T>> {\n  protected readonly retryProvider = $inject(RetryProvider);\n  protected appAbortController: AbortController;\n\n  constructor(args: DescriptorArgs<RetryDescriptorOptions<T>>) {\n    super(args);\n\n    this.appAbortController = new AbortController();\n    this.alepha.events.on(\"stop\", () => {\n      this.appAbortController.abort();\n    });\n  }\n\n  async run(...args: Parameters<T>): Promise<ReturnType<T>> {\n    return this.retryProvider.retry(\n      {\n        ...this.options,\n        additionalSignal: this.appAbortController.signal,\n      },\n      ...args,\n    );\n  }\n}\n\nexport interface RetryDescriptorFn<T extends (...args: any[]) => any>\n  extends RetryDescriptor<T> {\n  (...args: Parameters<T>): Promise<ReturnType<T>>;\n}\n\n$retry[KIND] = RetryDescriptor;\n","import { $module } from \"alepha\";\nimport { $retry } from \"./descriptors/$retry.ts\";\nimport { RetryProvider } from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./descriptors/$retry.ts\";\nexport * from \"./errors/RetryCancelError.ts\";\nexport * from \"./errors/RetryTimeoutError.ts\";\nexport * from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Retry mechanism provider for Alepha applications.\n *\n * @see {@link RetryProvider}\n * @module alepha.retry\n */\nexport const AlephaRetry = $module({\n  name: \"alepha.retry\",\n  descriptors: [$retry],\n  services: [RetryProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["lastError: Error | undefined"],"sources":["../../src/retry/errors/RetryCancelError.ts","../../src/retry/errors/RetryTimeoutError.ts","../../src/retry/providers/RetryProvider.ts","../../src/retry/descriptors/$retry.ts","../../src/retry/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class RetryCancelError extends AlephaError {\n  constructor() {\n    super(\"Retry operation was cancelled.\");\n    this.name = \"RetryCancelError\";\n  }\n}\n","import { AlephaError } from \"alepha\";\n\nexport class RetryTimeoutError extends AlephaError {\n  constructor(duration: number) {\n    super(`Retry operation timed out after ${duration}ms.`);\n    this.name = \"RetryTimeoutError\";\n  }\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { RetryCancelError } from \"../errors/RetryCancelError.ts\";\nimport { RetryTimeoutError } from \"../errors/RetryTimeoutError.ts\";\n\nexport interface RetryOptions<T extends (...args: any[]) => any> {\n  /**\n   * The function to retry.\n   */\n  handler: T;\n\n  /**\n   * The maximum number of attempts.\n   *\n   * @default 3\n   */\n  max?: number;\n\n  /**\n   * The backoff strategy for delays between retries.\n   * Can be a fixed number (in ms) or a configuration object for exponential backoff.\n   *\n   * @default { initial: 200, factor: 2, jitter: true }\n   */\n  backoff?: number | RetryBackoffOptions;\n\n  /**\n   * An overall time limit for all retry attempts combined.\n   *\n   * e.g., `[5, 'seconds']`\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * A function that determines if a retry should be attempted based on the error.\n   *\n   * @default (error) => true (retries on any error)\n   */\n  when?: (error: Error) => boolean;\n\n  /**\n   * A custom callback for when a retry attempt fails.\n   * This is called before the delay.\n   */\n  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;\n\n  /**\n   * An AbortSignal to allow for external cancellation of the retry loop.\n   */\n  signal?: AbortSignal;\n\n  /**\n   * An additional AbortSignal to combine with the provided signal.\n   * Used internally by $retry to handle app lifecycle.\n   */\n  additionalSignal?: AbortSignal;\n}\n\nexport interface RetryBackoffOptions {\n  /**\n   * Initial delay in milliseconds.\n   *\n   * @default 200\n   */\n  initial?: number;\n\n  /**\n   * Multiplier for each subsequent delay.\n   *\n   * @default 2\n   */\n  factor?: number;\n\n  /**\n   * Maximum delay in milliseconds.\n   */\n  max?: number;\n\n  /**\n   * If true, adds a random jitter to the delay to prevent thundering herd.\n   *\n   * @default true\n   */\n  jitter?: boolean;\n}\n\n/**\n * Service for executing functions with automatic retry logic.\n * Supports exponential backoff, max duration, conditional retries, and cancellation.\n */\nexport class RetryProvider {\n  protected readonly log = $logger();\n  protected readonly dateTime = $inject(DateTimeProvider);\n\n  /**\n   * Execute a function with automatic retry logic.\n   */\n  async retry<T extends (...args: any[]) => any>(\n    options: RetryOptions<T>,\n    ...args: Parameters<T>\n  ): Promise<ReturnType<T>> {\n    const maxAttempts = options.max ?? 3;\n    const when = options.when ?? (() => true);\n    const { handler, onError } = options;\n\n    let lastError: Error | undefined;\n    const startTime = Date.now();\n\n    const maxDurationMs = options.maxDuration\n      ? this.dateTime.duration(options.maxDuration).asMilliseconds()\n      : Infinity;\n\n    // Combine user-provided signal with additional signal (e.g., app lifecycle)\n    const signals = [options.signal, options.additionalSignal].filter(Boolean);\n    const onAbort = () => {\n      // Always set RetryCancelError when aborted, even if another error exists\n      // This ensures cancellation takes precedence over retry errors\n      lastError = new RetryCancelError();\n    };\n\n    // Add abort listeners to all signals\n    for (const signal of signals) {\n      signal?.addEventListener(\"abort\", onAbort);\n    }\n\n    // FIX BUG #8: Create combined signal ONCE at the start instead of on each backoff\n    // This prevents memory leak from creating multiple AbortSignal.any() instances\n    const waitSignals = [options.signal, options.additionalSignal].filter(\n      Boolean,\n    ) as AbortSignal[];\n    const combinedSignal =\n      waitSignals.length > 0 ? AbortSignal.any(waitSignals) : undefined;\n\n    try {\n      for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n        // Check for cancellation\n        if (signals.some((signal) => signal?.aborted)) {\n          throw new RetryCancelError();\n        }\n\n        // Check for timeout before attempting\n        if (Date.now() - startTime >= maxDurationMs) {\n          throw new RetryTimeoutError(maxDurationMs);\n        }\n\n        try {\n          const result = await handler(...args);\n\n          // Check for timeout after handler execution\n          if (Date.now() - startTime >= maxDurationMs) {\n            throw new RetryTimeoutError(maxDurationMs);\n          }\n\n          return result;\n        } catch (err) {\n          lastError = err as Error;\n\n          // Check for timeout after error\n          if (Date.now() - startTime >= maxDurationMs) {\n            throw new RetryTimeoutError(maxDurationMs);\n          }\n\n          // Log the error with warning level\n          this.log.warn(\"Retry attempt failed\", {\n            attempt,\n            maxAttempts,\n            remainingAttempts: maxAttempts - attempt,\n            error: lastError.message,\n            errorName: lastError.name,\n          });\n\n          if (!(err instanceof Error) || !when(err)) {\n            throw err; // don't retry if it's not an Error or `when` returns false\n          }\n\n          // FIX BUG #7: Call onError BEFORE checking if this is the final attempt\n          // This ensures onError is called for ALL failed attempts, including the last one\n          if (onError) {\n            onError(err, attempt, ...args);\n          }\n\n          if (attempt >= maxAttempts) {\n            break; // will throw lastError after the loop\n          }\n\n          // Calculate and wait for backoff delay\n          const delay = this.calculateBackoff(attempt, options.backoff);\n          if (delay > 0) {\n            await this.dateTime.wait(delay, { signal: combinedSignal });\n          }\n\n          // Check for timeout after backoff wait before next attempt\n          if (Date.now() - startTime >= maxDurationMs) {\n            throw new RetryTimeoutError(maxDurationMs);\n          }\n        }\n      }\n    } finally {\n      // Clean up listeners to prevent memory leaks\n      for (const signal of signals) {\n        signal?.removeEventListener(\"abort\", onAbort);\n      }\n    }\n\n    throw lastError;\n  }\n\n  /**\n   * Calculate the backoff delay for a given attempt.\n   */\n  protected calculateBackoff(\n    attempt: number,\n    options?: number | RetryBackoffOptions,\n  ): number {\n    if (typeof options === \"number\") {\n      return options;\n    }\n\n    const initial = options?.initial ?? 200;\n    const factor = options?.factor ?? 2;\n    const max = options?.max ?? 10000;\n    const useJitter = options?.jitter !== false;\n\n    const exponential = initial * factor ** (attempt - 1);\n    let delay = Math.min(exponential, max);\n\n    if (useJitter) {\n      // Add a random amount of jitter (e.g., up to 50% of the delay)\n      delay = delay * (1 + Math.random() * 0.5);\n    }\n\n    return Math.floor(delay);\n  }\n}\n","import {\n  $inject,\n  createDescriptor,\n  Descriptor,\n  type DescriptorArgs,\n  KIND,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport type { RetryBackoffOptions } from \"../providers/RetryProvider.ts\";\nimport { RetryProvider } from \"../providers/RetryProvider.ts\";\n\n/**\n * Creates a function that automatically retries a handler upon failure,\n * with support for exponential backoff, max duration, and cancellation.\n */\nexport const $retry = <T extends (...args: any[]) => any>(\n  options: RetryDescriptorOptions<T>,\n): RetryDescriptorFn<T> => {\n  const instance = createDescriptor(RetryDescriptor, options);\n  const fn = (...args: Parameters<T>) => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as RetryDescriptorFn<T>;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface RetryDescriptorOptions<T extends (...args: any[]) => any> {\n  /**\n   * The function to retry.\n   */\n  handler: T;\n\n  /**\n   * The maximum number of attempts.\n   *\n   * @default 3\n   */\n  max?: number;\n\n  /**\n   * The backoff strategy for delays between retries.\n   * Can be a fixed number (in ms) or a configuration object for exponential backoff.\n   *\n   * @default { initial: 200, factor: 2, jitter: true }\n   */\n  backoff?: number | RetryBackoffOptions;\n\n  /**\n   * An overall time limit for all retry attempts combined.\n   *\n   * e.g., `[5, 'seconds']`\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * A function that determines if a retry should be attempted based on the error.\n   *\n   * @default (error) => true (retries on any error)\n   */\n  when?: (error: Error) => boolean;\n\n  /**\n   * A custom callback for when a retry attempt fails.\n   * This is called before the delay.\n   */\n  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;\n\n  /**\n   * An AbortSignal to allow for external cancellation of the retry loop.\n   */\n  signal?: AbortSignal;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RetryDescriptor<\n  T extends (...args: any[]) => any,\n> extends Descriptor<RetryDescriptorOptions<T>> {\n  protected readonly retryProvider = $inject(RetryProvider);\n  protected appAbortController?: AbortController;\n\n  constructor(args: DescriptorArgs<RetryDescriptorOptions<T>>) {\n    super(args);\n\n    this.alepha.events.on(\"stop\", () => {\n      this.appAbortController?.abort();\n    });\n  }\n\n  async run(...args: Parameters<T>): Promise<ReturnType<T>> {\n    // Nov 25: Cloudflare does not like 'new AbortController' outside main handler, we can't pre-create it in the constructor.\n    this.appAbortController ??= new AbortController();\n\n    return this.retryProvider.retry(\n      {\n        ...this.options,\n        additionalSignal: this.appAbortController.signal,\n      },\n      ...args,\n    );\n  }\n}\n\nexport interface RetryDescriptorFn<T extends (...args: any[]) => any>\n  extends RetryDescriptor<T> {\n  (...args: Parameters<T>): Promise<ReturnType<T>>;\n}\n\n$retry[KIND] = RetryDescriptor;\n","import { $module } from \"alepha\";\nimport { $retry } from \"./descriptors/$retry.ts\";\nimport { RetryProvider } from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./descriptors/$retry.ts\";\nexport * from \"./errors/RetryCancelError.ts\";\nexport * from \"./errors/RetryTimeoutError.ts\";\nexport * from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Retry mechanism provider for Alepha applications.\n *\n * @see {@link RetryProvider}\n * @module alepha.retry\n */\nexport const AlephaRetry = $module({\n  name: \"alepha.retry\",\n  descriptors: [$retry],\n  services: [RetryProvider],\n});\n"],"mappings":"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"}

package/dist/scheduler/index.d.ts

@@ -1,4 +1,4 @@
-import * as alepha1 from "alepha";
+import * as alepha4 from "alepha";
 import { Alepha, Async, Descriptor, KIND, Static } from "alepha";
 import * as alepha_lock0 from "alepha/lock";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
@@ -23,8 +23,8 @@ declare class CronProvider {
   protected readonly log: alepha_logger0.Logger;
   protected readonly cronJobs: Array<CronJob>;
   getCronJobs(): Array<CronJob>;
-  protected readonly start: alepha1.HookDescriptor<"start">;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
+  protected readonly start: alepha4.HookDescriptor<"start">;
+  protected readonly stop: alepha4.HookDescriptor<"stop">;
   protected boot(name: string | CronJob): void;
   abort(name: string | CronJob): void;
   /**
@@ -87,8 +87,8 @@ type SchedulerDescriptorOptions = {
    */
   lock?: boolean;
 };
-declare const envSchema: alepha1.TObject<{
-  SCHEDULER_PREFIX: alepha1.TOptional<alepha1.TString>;
+declare const envSchema: alepha4.TObject<{
+  SCHEDULER_PREFIX: alepha4.TOptional<alepha4.TString>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -139,7 +139,7 @@ declare module "alepha" {
  * @see {@link $scheduler}
  * @module alepha.scheduler
  */
-declare const AlephaScheduler: alepha1.Service<alepha1.Module>;
+declare const AlephaScheduler: alepha4.Service<alepha4.Module>;
 //#endregion
 export { $scheduler, AlephaScheduler, CRON, CronJob, CronProvider, SchedulerDescriptor, SchedulerDescriptorOptions, SchedulerHandlerArguments };
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.js

@@ -1300,7 +1300,7 @@ var NodeHttpServerProvider = class extends ServerProvider {
 		}
 	});
 	createHttpServer(func) {
-		return createServer({ keepAlive: true }, func);
+		return createServer({ keepAlive: this.alepha.isProduction() }, func);
 	}
 	stop = $hook({
 		on: "stop",