alepha 0.15.1 → 0.15.3

package/dist/redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["envSchema"],"sources":["../../src/redis/providers/RedisProvider.ts","../../src/redis/providers/BunRedisProvider.ts","../../src/redis/providers/RedisSubscriberProvider.ts","../../src/redis/providers/BunRedisSubscriberProvider.ts","../../src/redis/providers/NodeRedisProvider.ts","../../src/redis/providers/NodeRedisSubscriberProvider.ts","../../src/redis/index.ts"],"sourcesContent":["/**\n * Abstract Redis provider interface.\n *\n * This abstract class defines the common interface for Redis operations.\n * Implementations include:\n * - {@link NodeRedisProvider} - Uses `@redis/client` for Node.js runtime\n * - {@link BunRedisProvider} - Uses Bun's native `RedisClient` for Bun runtime\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const redis = alepha.inject(RedisProvider);\n *\n * // Use common operations\n * await redis.set(\"key\", \"value\");\n * const value = await redis.get(\"key\");\n * ```\n */\nexport abstract class RedisProvider {\n  /**\n   * Whether the Redis client is ready to accept commands.\n   */\n  public abstract readonly isReady: boolean;\n\n  /**\n   * Connect to the Redis server.\n   */\n  public abstract connect(): Promise<void>;\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Get the value of a key.\n   *\n   * @param key The key to get.\n   * @returns The value as a Buffer, or undefined if the key does not exist.\n   */\n  public abstract get(key: string): Promise<Buffer | undefined>;\n\n  /**\n   * Set the value of a key.\n   *\n   * @param key The key to set.\n   * @param value The value to set (Buffer or string).\n   * @param options Optional set options (EX, PX, NX, XX, etc.).\n   * @returns The value as a Buffer.\n   */\n  public abstract set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer>;\n\n  /**\n   * Check if a key exists.\n   *\n   * @param key The key to check.\n   * @returns True if the key exists.\n   */\n  public abstract has(key: string): Promise<boolean>;\n\n  /**\n   * Get all keys matching a pattern.\n   *\n   * @param pattern The glob-style pattern to match.\n   * @returns Array of matching key names.\n   */\n  public abstract keys(pattern: string): Promise<string[]>;\n\n  /**\n   * Delete one or more keys.\n   *\n   * @param keys The keys to delete.\n   */\n  public abstract del(keys: string[]): Promise<void>;\n\n  // ---------------------------------------------------------\n  // Queue operations (for alepha/queue-redis)\n  // ---------------------------------------------------------\n\n  /**\n   * Push a value to the left (head) of a list.\n   *\n   * @param key The list key.\n   * @param value The value to push.\n   */\n  public abstract lpush(key: string, value: string): Promise<void>;\n\n  /**\n   * Pop a value from the right (tail) of a list.\n   *\n   * @param key The list key.\n   * @returns The value, or undefined if the list is empty.\n   */\n  public abstract rpop(key: string): Promise<string | undefined>;\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations (for alepha/topic-redis)\n  // ---------------------------------------------------------\n\n  /**\n   * Publish a message to a channel.\n   *\n   * @param channel The channel name.\n   * @param message The message to publish.\n   */\n  public abstract publish(channel: string, message: string): Promise<void>;\n}\n\n/**\n * Common Redis SET command options.\n * Compatible with @redis/client SetOptions format.\n */\nexport interface RedisSetOptions {\n  /**\n   * Set the specified expire time, in seconds.\n   */\n  EX?: number;\n  /**\n   * Set the specified expire time, in milliseconds.\n   */\n  PX?: number;\n  /**\n   * Set the specified Unix time at which the key will expire, in seconds.\n   */\n  EXAT?: number;\n  /**\n   * Set the specified Unix time at which the key will expire, in milliseconds.\n   */\n  PXAT?: number;\n  /**\n   * Only set the key if it does not already exist.\n   */\n  NX?: boolean;\n  /**\n   * Only set the key if it already exists.\n   */\n  XX?: boolean;\n  /**\n   * Retain the time to live associated with the key.\n   */\n  KEEPTTL?: boolean;\n  /**\n   * Return the old string stored at key, or nil if key did not exist.\n   */\n  GET?: boolean;\n  /**\n   * Alternative expiration format (compatible with @redis/client).\n   */\n  expiration?: {\n    type: \"EX\" | \"PX\" | \"EXAT\" | \"PXAT\" | \"KEEPTTL\";\n    value: number;\n  };\n  /**\n   * Alternative condition format (compatible with @redis/client).\n   */\n  condition?: \"NX\" | \"XX\";\n}\n","import {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"./RedisProvider.ts\";\n\nconst envSchema = t.object({\n  REDIS_URL: t.text({\n    default: \"redis://localhost:6379\",\n    description: \"Redis connection URL\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Bun Redis client provider using Bun's native Redis client.\n *\n * This provider uses Bun's built-in `RedisClient` class for Redis connections,\n * which provides excellent performance (7.9x faster than ioredis) on the Bun runtime.\n *\n * @example\n * ```ts\n * // Set REDIS_URL environment variable (default: redis://localhost:6379)\n * // REDIS_URL=redis://:password@myredis.example.com:6379\n *\n * // Or configure programmatically\n * alepha.with({\n *   provide: RedisProvider,\n *   use: BunRedisProvider,\n * });\n * ```\n */\nexport class BunRedisProvider extends RedisProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected client?: Bun.RedisClient;\n\n  public get publisher(): Bun.RedisClient {\n    if (!this.client?.connected) {\n      throw new AlephaError(\"Redis client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client?.connected ?? false;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server.\n   */\n  public override async connect(): Promise<void> {\n    // Check if we're running in Bun\n    if (!this.alepha.isBun()) {\n      throw new AlephaError(\n        \"BunRedisProvider requires the Bun runtime. Use NodeRedisProvider for Node.js.\",\n      );\n    }\n\n    this.log.debug(\"Connecting...\");\n\n    this.client = new Bun.RedisClient(this.getUrl(), {\n      autoReconnect: true,\n      enableAutoPipelining: true,\n    });\n\n    this.client.onconnect = () => {\n      this.log.trace(\"Redis connected\");\n    };\n\n    this.client.onclose = (error) => {\n      if (this.alepha.isStarted() && error) {\n        this.log.error(\"Redis connection closed\", error);\n      }\n    };\n\n    await this.client.connect();\n\n    this.log.info(\"Connection OK\");\n  }\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public override async close(): Promise<void> {\n    if (this.client) {\n      this.log.debug(\"Closing connection...\");\n      this.client.close();\n      this.client = undefined;\n      this.log.info(\"Connection closed\");\n    }\n  }\n\n  /**\n   * Create a duplicate connection for pub/sub or other isolated operations.\n   */\n  public async duplicate(): Promise<Bun.RedisClient> {\n    if (typeof Bun === \"undefined\") {\n      throw new AlephaError(\"BunRedisProvider requires the Bun runtime.\");\n    }\n\n    const client = new Bun.RedisClient(this.getUrl(), {\n      autoReconnect: true,\n      enableAutoPipelining: true,\n    });\n\n    client.onclose = (error) => {\n      if (this.alepha.isStarted() && error) {\n        this.log.error(\"Redis duplicate connection closed\", error);\n      }\n    };\n\n    await client.connect();\n\n    return client;\n  }\n\n  public override async get(key: string): Promise<Buffer | undefined> {\n    this.log.trace(`Getting key ${key}`);\n    const resp = await this.publisher.getBuffer(key);\n\n    if (resp === null) {\n      return undefined;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer> {\n    const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, \"utf-8\");\n\n    // Build SET command arguments\n    const args: string[] = [key, buf.toString(\"binary\")];\n\n    // Handle expiration object format (from alepha/cache-redis, alepha/lock-redis)\n    if (options?.expiration) {\n      if (options.expiration.type === \"KEEPTTL\") {\n        args.push(\"KEEPTTL\");\n      } else {\n        args.push(options.expiration.type, String(options.expiration.value));\n      }\n    }\n\n    // Handle direct expiration properties\n    if (options?.EX !== undefined) {\n      args.push(\"EX\", String(options.EX));\n    }\n    if (options?.PX !== undefined) {\n      args.push(\"PX\", String(options.PX));\n    }\n    if (options?.EXAT !== undefined) {\n      args.push(\"EXAT\", String(options.EXAT));\n    }\n    if (options?.PXAT !== undefined) {\n      args.push(\"PXAT\", String(options.PXAT));\n    }\n    if (options?.KEEPTTL) {\n      args.push(\"KEEPTTL\");\n    }\n\n    // Handle condition object format\n    if (options?.condition === \"NX\") {\n      args.push(\"NX\");\n    } else if (options?.condition === \"XX\") {\n      args.push(\"XX\");\n    }\n\n    // Handle direct condition properties\n    if (options?.NX) {\n      args.push(\"NX\");\n    }\n    if (options?.XX) {\n      args.push(\"XX\");\n    }\n    if (options?.GET) {\n      args.push(\"GET\");\n    }\n\n    if (args.length === 2) {\n      // Simple set without options\n      await this.publisher.set(key, buf);\n    } else {\n      // Set with options via raw command\n      await this.publisher.send(\"SET\", args);\n    }\n\n    return buf;\n  }\n\n  public override async has(key: string): Promise<boolean> {\n    return this.publisher.exists(key);\n  }\n\n  public override async keys(pattern: string): Promise<string[]> {\n    const keys = await this.publisher.send(\"KEYS\", [pattern]);\n    if (!Array.isArray(keys)) {\n      return [];\n    }\n    return keys.map((key) =>\n      key instanceof Uint8Array ? Buffer.from(key).toString() : String(key),\n    );\n  }\n\n  public override async del(keys: string[]): Promise<void> {\n    if (keys.length === 0) {\n      return;\n    }\n\n    await this.publisher.send(\"DEL\", keys);\n  }\n\n  // ---------------------------------------------------------\n  // Queue operations\n  // ---------------------------------------------------------\n\n  public override async lpush(key: string, value: string): Promise<void> {\n    await this.publisher.send(\"LPUSH\", [key, value]);\n  }\n\n  public override async rpop(key: string): Promise<string | undefined> {\n    const value = await this.publisher.send(\"RPOP\", [key]);\n    if (value == null) {\n      return undefined;\n    }\n    if (value instanceof Uint8Array) {\n      return Buffer.from(value).toString();\n    }\n    return String(value);\n  }\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations\n  // ---------------------------------------------------------\n\n  public override async publish(\n    channel: string,\n    message: string,\n  ): Promise<void> {\n    await this.publisher.publish(channel, message);\n  }\n\n  /**\n   * Get the Redis connection URL.\n   */\n  protected getUrl(): string {\n    return this.env.REDIS_URL;\n  }\n}\n","/**\n * Abstract Redis subscriber provider interface.\n *\n * This abstract class defines the common interface for Redis pub/sub subscriptions.\n * Implementations include:\n * - {@link NodeRedisSubscriberProvider} - Uses `@redis/client` for Node.js runtime\n * - {@link BunRedisSubscriberProvider} - Uses Bun's native `RedisClient` for Bun runtime\n *\n * Redis requires separate connections for pub/sub operations, so this provider\n * creates a dedicated connection for subscriptions.\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n *\n * // Subscribe to a channel\n * await subscriber.subscribe(\"my-channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport abstract class RedisSubscriberProvider {\n  /**\n   * Whether the Redis subscriber client is ready to accept commands.\n   */\n  public abstract readonly isReady: boolean;\n\n  /**\n   * Connect to the Redis server for subscriptions.\n   */\n  public abstract connect(): Promise<void>;\n\n  /**\n   * Close the subscriber connection.\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Subscribe to a channel.\n   *\n   * @param channel The channel name.\n   * @param callback The callback to invoke when a message is received.\n   */\n  public abstract subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void>;\n\n  /**\n   * Unsubscribe from a channel.\n   *\n   * @param channel The channel name.\n   * @param callback Optional specific callback to remove.\n   */\n  public abstract unsubscribe(\n    channel: string,\n    callback?: SubscribeCallback,\n  ): Promise<void>;\n}\n\n/**\n * Callback for subscription messages.\n */\nexport type SubscribeCallback = (message: string, channel: string) => void;\n","import { $hook, $inject, Alepha, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { BunRedisProvider } from \"./BunRedisProvider.ts\";\nimport {\n  RedisSubscriberProvider,\n  type SubscribeCallback,\n} from \"./RedisSubscriberProvider.ts\";\n\n/**\n * Bun Redis subscriber provider for pub/sub operations.\n *\n * This provider creates a dedicated Redis connection for subscriptions,\n * as Redis requires separate connections for pub/sub operations.\n *\n * @example\n * ```ts\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n * await subscriber.subscribe(\"channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport class BunRedisSubscriberProvider extends RedisSubscriberProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(BunRedisProvider);\n  protected client?: Bun.RedisClient;\n\n  public get subscriber(): Bun.RedisClient {\n    if (!this.client?.connected) {\n      throw new AlephaError(\"Redis subscriber client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client?.connected ?? false;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server for subscriptions.\n   */\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting subscriber...\");\n    this.client = await this.redisProvider.duplicate();\n    this.log.info(\"Subscriber connection OK\");\n  }\n\n  /**\n   * Close the subscriber connection.\n   */\n  public override async close(): Promise<void> {\n    if (this.client) {\n      this.log.debug(\"Closing subscriber connection...\");\n      this.client.close();\n      this.client = undefined;\n      this.log.info(\"Subscriber connection closed\");\n    }\n  }\n\n  public override async subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.subscribe(channel, (message, ch) => {\n      // Bun's callback provides Buffer or string, normalize to string\n      const msg =\n        typeof message === \"object\" && message !== null\n          ? Buffer.from(message as Uint8Array).toString()\n          : String(message);\n      callback(msg, ch);\n    });\n  }\n\n  public override async unsubscribe(\n    channel: string,\n    _callback?: SubscribeCallback,\n  ): Promise<void> {\n    // Bun's unsubscribe doesn't support callback filtering\n    await this.subscriber.unsubscribe(channel);\n  }\n}\n","import {\n  createClient,\n  RESP_TYPES,\n  type RedisClientType,\n  type SetOptions,\n} from \"@redis/client\";\nimport {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"./RedisProvider.ts\";\n\nconst envSchema = t.object({\n  REDIS_URL: t.text({\n    default: \"redis://localhost:6379\",\n    description: \"Redis connection URL\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\nexport type NodeRedisClient = RedisClientType<\n  {},\n  {},\n  {},\n  3,\n  { 36: BufferConstructor }\n>;\nexport type NodeRedisClientOptions = Parameters<typeof createClient>[0];\n\n/**\n * Node.js Redis client provider using `@redis/client`.\n *\n * This provider uses the official Redis client for Node.js runtime.\n *\n * @example\n * ```ts\n * // Set REDIS_URL environment variable (default: redis://localhost:6379)\n * // REDIS_URL=redis://:password@myredis.example.com:6379\n *\n * // Or configure programmatically\n * alepha.with({\n *   provide: RedisProvider,\n *   use: NodeRedisProvider,\n * });\n * ```\n */\nexport class NodeRedisProvider extends RedisProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected readonly client = this.createClient();\n\n  public get publisher(): NodeRedisClient {\n    if (!this.client.isReady) {\n      throw new AlephaError(\"Redis client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client.isReady;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server.\n   */\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting...\");\n    await this.client.connect();\n    this.log.info(\"Connection OK\");\n  }\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public override async close(): Promise<void> {\n    this.log.debug(\"Closing connection...\");\n    await this.client.close();\n    this.log.info(\"Connection closed\");\n  }\n\n  public duplicate(options?: Partial<NodeRedisClientOptions>): NodeRedisClient {\n    return this.client\n      .duplicate({\n        ...options,\n        RESP: 3,\n      })\n      .withTypeMapping({\n        [RESP_TYPES.BLOB_STRING]: Buffer,\n      });\n  }\n\n  public override async get(key: string): Promise<Buffer | undefined> {\n    this.log.trace(`Getting key ${key}`);\n    const resp = await this.publisher.get(key);\n\n    if (resp === null) {\n      return undefined;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer> {\n    const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, \"utf-8\");\n\n    // Convert RedisSetOptions to @redis/client SetOptions\n    const setOptions: SetOptions = {};\n\n    // Handle expiration object format (from alepha/cache-redis, alepha/lock-redis)\n    if (options?.expiration) {\n      if (options.expiration.type === \"KEEPTTL\") {\n        setOptions.KEEPTTL = true;\n      } else {\n        setOptions[options.expiration.type] = options.expiration.value;\n      }\n    }\n\n    // Handle direct expiration properties\n    if (options?.EX !== undefined) {\n      setOptions.EX = options.EX;\n    }\n    if (options?.PX !== undefined) {\n      setOptions.PX = options.PX;\n    }\n    if (options?.EXAT !== undefined) {\n      setOptions.EXAT = options.EXAT;\n    }\n    if (options?.PXAT !== undefined) {\n      setOptions.PXAT = options.PXAT;\n    }\n    if (options?.KEEPTTL) {\n      setOptions.KEEPTTL = true;\n    }\n\n    // Handle condition object format\n    if (options?.condition === \"NX\") {\n      setOptions.NX = true;\n    } else if (options?.condition === \"XX\") {\n      setOptions.XX = true;\n    }\n\n    // Handle direct condition properties\n    if (options?.NX) {\n      setOptions.NX = true;\n    }\n    if (options?.XX) {\n      setOptions.XX = true;\n    }\n    if (options?.GET) {\n      setOptions.GET = true;\n    }\n\n    const resp = await this.publisher.set(\n      key,\n      buf,\n      Object.keys(setOptions).length > 0 ? setOptions : undefined,\n    );\n\n    if (resp === \"OK\" || !resp) {\n      return buf;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async has(key: string): Promise<boolean> {\n    const resp = await this.publisher.exists(key);\n    return resp > 0;\n  }\n\n  public override async keys(pattern: string): Promise<string[]> {\n    const keys = await this.publisher.keys(pattern);\n    return keys.map((key) => key.toString());\n  }\n\n  public override async del(keys: string[]): Promise<void> {\n    if (keys.length === 0) {\n      return;\n    }\n\n    await this.publisher.del(keys);\n  }\n\n  // ---------------------------------------------------------\n  // Queue operations\n  // ---------------------------------------------------------\n\n  public override async lpush(key: string, value: string): Promise<void> {\n    await this.publisher.LPUSH(key, value);\n  }\n\n  public override async rpop(key: string): Promise<string | undefined> {\n    const value = await this.publisher.RPOP(key);\n    if (value == null) {\n      return undefined;\n    }\n    return String(value);\n  }\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations\n  // ---------------------------------------------------------\n\n  public override async publish(\n    channel: string,\n    message: string,\n  ): Promise<void> {\n    await this.publisher.publish(channel, message);\n  }\n\n  /**\n   * Get the Redis connection URL.\n   */\n  protected getUrl(): string {\n    return this.env.REDIS_URL;\n  }\n\n  /**\n   * Redis client factory method.\n   */\n  protected createClient(): NodeRedisClient {\n    const client = createClient({\n      url: this.getUrl(),\n      RESP: 3,\n    }).withTypeMapping({\n      [RESP_TYPES.BLOB_STRING]: Buffer,\n    });\n\n    client.on(\"error\", (error) => {\n      if (this.alepha.isStarted()) {\n        this.log.error(error);\n      }\n    });\n\n    return client;\n  }\n}\n","import { $hook, $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  type NodeRedisClient,\n  NodeRedisProvider,\n} from \"./NodeRedisProvider.ts\";\nimport {\n  RedisSubscriberProvider,\n  type SubscribeCallback,\n} from \"./RedisSubscriberProvider.ts\";\n\n/**\n * Node.js Redis subscriber provider using `@redis/client`.\n *\n * This provider creates a dedicated Redis connection for subscriptions,\n * as Redis requires separate connections for pub/sub operations.\n *\n * @example\n * ```ts\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n * await subscriber.subscribe(\"channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport class NodeRedisSubscriberProvider extends RedisSubscriberProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(NodeRedisProvider);\n  protected readonly client: NodeRedisClient = this.createClient();\n\n  public get subscriber(): NodeRedisClient {\n    if (!this.client.isReady) {\n      throw new Error(\"Redis subscriber client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client.isReady;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting subscriber...\");\n    await this.client.connect();\n    this.log.info(\"Subscriber connection OK\");\n  }\n\n  public override async close(): Promise<void> {\n    this.log.debug(\"Closing subscriber connection...\");\n    await this.subscriber.close();\n    this.log.info(\"Subscriber connection closed\");\n  }\n\n  public override async subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.subscribe(channel, callback);\n  }\n\n  public override async unsubscribe(\n    channel: string,\n    callback?: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.unsubscribe(channel, callback);\n  }\n\n  /**\n   * Redis subscriber client factory method.\n   */\n  protected createClient(): NodeRedisClient {\n    const client = this.redisProvider.duplicate();\n\n    client.on(\"error\", (error) => {\n      if (this.alepha.isStarted()) {\n        this.log.error(error);\n      }\n    });\n\n    return client;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { BunRedisProvider } from \"./providers/BunRedisProvider.ts\";\nimport { BunRedisSubscriberProvider } from \"./providers/BunRedisSubscriberProvider.ts\";\nimport { NodeRedisProvider } from \"./providers/NodeRedisProvider.ts\";\nimport { NodeRedisSubscriberProvider } from \"./providers/NodeRedisSubscriberProvider.ts\";\nimport { RedisProvider } from \"./providers/RedisProvider.ts\";\nimport { RedisSubscriberProvider } from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/BunRedisProvider.ts\";\nexport * from \"./providers/BunRedisSubscriberProvider.ts\";\nexport * from \"./providers/NodeRedisProvider.ts\";\nexport * from \"./providers/NodeRedisSubscriberProvider.ts\";\nexport * from \"./providers/RedisProvider.ts\";\nexport * from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Redis client provider for Alepha applications.\n *\n * Automatically selects the appropriate provider based on runtime:\n * - Bun: Uses `BunRedisProvider` with Bun's native Redis client (7.9x faster than ioredis)\n * - Node.js: Uses `NodeRedisProvider` with `@redis/client`\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const redis = alepha.inject(RedisProvider);\n *\n * // Use common operations\n * await redis.set(\"key\", \"value\");\n * const value = await redis.get(\"key\");\n *\n * // For pub/sub\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n * await subscriber.subscribe(\"channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n *\n * @see {@link RedisProvider} - Abstract base class\n * @see {@link NodeRedisProvider} - Node.js implementation\n * @see {@link BunRedisProvider} - Bun implementation\n * @see {@link RedisSubscriberProvider} - Abstract subscriber base class\n * @see {@link NodeRedisSubscriberProvider} - Node.js subscriber implementation\n * @see {@link BunRedisSubscriberProvider} - Bun subscriber implementation\n * @module alepha.redis\n */\nexport const AlephaRedis = $module({\n  name: \"alepha.redis\",\n  services: [\n    NodeRedisProvider,\n    NodeRedisSubscriberProvider,\n    BunRedisProvider,\n    BunRedisSubscriberProvider,\n    RedisProvider,\n    RedisSubscriberProvider,\n  ],\n  register: (alepha: Alepha) => {\n    if (alepha.isBun()) {\n      alepha\n        .with({\n          provide: RedisProvider,\n          use: BunRedisProvider,\n        })\n        .with({\n          provide: RedisSubscriberProvider,\n          use: BunRedisSubscriberProvider,\n        });\n    } else {\n      alepha\n        .with({\n          provide: RedisProvider,\n          use: NodeRedisProvider,\n        })\n        .with({\n          provide: RedisSubscriberProvider,\n          use: NodeRedisSubscriberProvider,\n        });\n    }\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["envSchema"],"sources":["../../src/redis/providers/RedisProvider.ts","../../src/redis/providers/BunRedisProvider.ts","../../src/redis/providers/RedisSubscriberProvider.ts","../../src/redis/providers/BunRedisSubscriberProvider.ts","../../src/redis/providers/NodeRedisProvider.ts","../../src/redis/providers/NodeRedisSubscriberProvider.ts","../../src/redis/index.ts"],"sourcesContent":["/**\n * Abstract Redis provider interface.\n *\n * This abstract class defines the common interface for Redis operations.\n * Implementations include:\n * - {@link NodeRedisProvider} - Uses `@redis/client` for Node.js runtime\n * - {@link BunRedisProvider} - Uses Bun's native `RedisClient` for Bun runtime\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const redis = alepha.inject(RedisProvider);\n *\n * // Use common operations\n * await redis.set(\"key\", \"value\");\n * const value = await redis.get(\"key\");\n * ```\n */\nexport abstract class RedisProvider {\n  /**\n   * Whether the Redis client is ready to accept commands.\n   */\n  public abstract readonly isReady: boolean;\n\n  /**\n   * Connect to the Redis server.\n   */\n  public abstract connect(): Promise<void>;\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Get the value of a key.\n   *\n   * @param key The key to get.\n   * @returns The value as a Buffer, or undefined if the key does not exist.\n   */\n  public abstract get(key: string): Promise<Buffer | undefined>;\n\n  /**\n   * Set the value of a key.\n   *\n   * @param key The key to set.\n   * @param value The value to set (Buffer or string).\n   * @param options Optional set options (EX, PX, NX, XX, etc.).\n   * @returns The value as a Buffer.\n   */\n  public abstract set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer>;\n\n  /**\n   * Check if a key exists.\n   *\n   * @param key The key to check.\n   * @returns True if the key exists.\n   */\n  public abstract has(key: string): Promise<boolean>;\n\n  /**\n   * Get all keys matching a pattern.\n   *\n   * @param pattern The glob-style pattern to match.\n   * @returns Array of matching key names.\n   */\n  public abstract keys(pattern: string): Promise<string[]>;\n\n  /**\n   * Delete one or more keys.\n   *\n   * @param keys The keys to delete.\n   */\n  public abstract del(keys: string[]): Promise<void>;\n\n  // ---------------------------------------------------------\n  // Queue operations (for alepha/queue-redis)\n  // ---------------------------------------------------------\n\n  /**\n   * Push a value to the left (head) of a list.\n   *\n   * @param key The list key.\n   * @param value The value to push.\n   */\n  public abstract lpush(key: string, value: string): Promise<void>;\n\n  /**\n   * Pop a value from the right (tail) of a list.\n   *\n   * @param key The list key.\n   * @returns The value, or undefined if the list is empty.\n   */\n  public abstract rpop(key: string): Promise<string | undefined>;\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations (for alepha/topic-redis)\n  // ---------------------------------------------------------\n\n  /**\n   * Publish a message to a channel.\n   *\n   * @param channel The channel name.\n   * @param message The message to publish.\n   */\n  public abstract publish(channel: string, message: string): Promise<void>;\n\n  // ---------------------------------------------------------\n  // Counter operations\n  // ---------------------------------------------------------\n\n  /**\n   * Increment the integer value of a key by the given amount.\n   *\n   * If the key does not exist, it is set to 0 before performing the operation.\n   * This operation is atomic.\n   *\n   * @param key The key to increment.\n   * @param amount The amount to increment by.\n   * @returns The new value after incrementing.\n   */\n  public abstract incr(key: string, amount: number): Promise<number>;\n}\n\n/**\n * Common Redis SET command options.\n * Compatible with @redis/client SetOptions format.\n */\nexport interface RedisSetOptions {\n  /**\n   * Set the specified expire time, in seconds.\n   */\n  EX?: number;\n  /**\n   * Set the specified expire time, in milliseconds.\n   */\n  PX?: number;\n  /**\n   * Set the specified Unix time at which the key will expire, in seconds.\n   */\n  EXAT?: number;\n  /**\n   * Set the specified Unix time at which the key will expire, in milliseconds.\n   */\n  PXAT?: number;\n  /**\n   * Only set the key if it does not already exist.\n   */\n  NX?: boolean;\n  /**\n   * Only set the key if it already exists.\n   */\n  XX?: boolean;\n  /**\n   * Retain the time to live associated with the key.\n   */\n  KEEPTTL?: boolean;\n  /**\n   * Return the old string stored at key, or nil if key did not exist.\n   */\n  GET?: boolean;\n  /**\n   * Alternative expiration format (compatible with @redis/client).\n   */\n  expiration?: {\n    type: \"EX\" | \"PX\" | \"EXAT\" | \"PXAT\" | \"KEEPTTL\";\n    value: number;\n  };\n  /**\n   * Alternative condition format (compatible with @redis/client).\n   */\n  condition?: \"NX\" | \"XX\";\n}\n","import {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"./RedisProvider.ts\";\n\nconst envSchema = t.object({\n  REDIS_URL: t.text({\n    default: \"redis://localhost:6379\",\n    description: \"Redis connection URL\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Bun Redis client provider using Bun's native Redis client.\n *\n * This provider uses Bun's built-in `RedisClient` class for Redis connections,\n * which provides excellent performance (7.9x faster than ioredis) on the Bun runtime.\n *\n * @example\n * ```ts\n * // Set REDIS_URL environment variable (default: redis://localhost:6379)\n * // REDIS_URL=redis://:password@myredis.example.com:6379\n *\n * // Or configure programmatically\n * alepha.with({\n *   provide: RedisProvider,\n *   use: BunRedisProvider,\n * });\n * ```\n */\nexport class BunRedisProvider extends RedisProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected client?: Bun.RedisClient;\n\n  public get publisher(): Bun.RedisClient {\n    if (!this.client?.connected) {\n      throw new AlephaError(\"Redis client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client?.connected ?? false;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server.\n   */\n  public override async connect(): Promise<void> {\n    // Check if we're running in Bun\n    if (!this.alepha.isBun()) {\n      throw new AlephaError(\n        \"BunRedisProvider requires the Bun runtime. Use NodeRedisProvider for Node.js.\",\n      );\n    }\n\n    this.log.debug(\"Connecting...\");\n\n    this.client = new Bun.RedisClient(this.getUrl(), {\n      autoReconnect: true,\n      enableAutoPipelining: true,\n    });\n\n    this.client.onconnect = () => {\n      this.log.trace(\"Redis connected\");\n    };\n\n    this.client.onclose = (error) => {\n      if (this.alepha.isStarted() && error) {\n        this.log.error(\"Redis connection closed\", error);\n      }\n    };\n\n    await this.client.connect();\n\n    this.log.info(\"Connection OK\");\n  }\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public override async close(): Promise<void> {\n    if (this.client) {\n      this.log.debug(\"Closing connection...\");\n      this.client.close();\n      this.client = undefined;\n      this.log.info(\"Connection closed\");\n    }\n  }\n\n  /**\n   * Create a duplicate connection for pub/sub or other isolated operations.\n   */\n  public async duplicate(): Promise<Bun.RedisClient> {\n    if (typeof Bun === \"undefined\") {\n      throw new AlephaError(\"BunRedisProvider requires the Bun runtime.\");\n    }\n\n    const client = new Bun.RedisClient(this.getUrl(), {\n      autoReconnect: true,\n      enableAutoPipelining: true,\n    });\n\n    client.onclose = (error) => {\n      if (this.alepha.isStarted() && error) {\n        this.log.error(\"Redis duplicate connection closed\", error);\n      }\n    };\n\n    await client.connect();\n\n    return client;\n  }\n\n  public override async get(key: string): Promise<Buffer | undefined> {\n    this.log.trace(`Getting key ${key}`);\n    const resp = await this.publisher.getBuffer(key);\n\n    if (resp === null) {\n      return undefined;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer> {\n    const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, \"utf-8\");\n\n    // Build SET command arguments\n    const args: string[] = [key, buf.toString(\"binary\")];\n\n    // Handle expiration object format (from alepha/cache-redis, alepha/lock-redis)\n    if (options?.expiration) {\n      if (options.expiration.type === \"KEEPTTL\") {\n        args.push(\"KEEPTTL\");\n      } else {\n        args.push(options.expiration.type, String(options.expiration.value));\n      }\n    }\n\n    // Handle direct expiration properties\n    if (options?.EX !== undefined) {\n      args.push(\"EX\", String(options.EX));\n    }\n    if (options?.PX !== undefined) {\n      args.push(\"PX\", String(options.PX));\n    }\n    if (options?.EXAT !== undefined) {\n      args.push(\"EXAT\", String(options.EXAT));\n    }\n    if (options?.PXAT !== undefined) {\n      args.push(\"PXAT\", String(options.PXAT));\n    }\n    if (options?.KEEPTTL) {\n      args.push(\"KEEPTTL\");\n    }\n\n    // Handle condition object format\n    if (options?.condition === \"NX\") {\n      args.push(\"NX\");\n    } else if (options?.condition === \"XX\") {\n      args.push(\"XX\");\n    }\n\n    // Handle direct condition properties\n    if (options?.NX) {\n      args.push(\"NX\");\n    }\n    if (options?.XX) {\n      args.push(\"XX\");\n    }\n    if (options?.GET) {\n      args.push(\"GET\");\n    }\n\n    if (args.length === 2) {\n      // Simple set without options\n      await this.publisher.set(key, buf);\n    } else {\n      // Set with options via raw command\n      await this.publisher.send(\"SET\", args);\n    }\n\n    return buf;\n  }\n\n  public override async has(key: string): Promise<boolean> {\n    return this.publisher.exists(key);\n  }\n\n  public override async keys(pattern: string): Promise<string[]> {\n    const keys = await this.publisher.send(\"KEYS\", [pattern]);\n    if (!Array.isArray(keys)) {\n      return [];\n    }\n    return keys.map((key) =>\n      key instanceof Uint8Array ? Buffer.from(key).toString() : String(key),\n    );\n  }\n\n  public override async del(keys: string[]): Promise<void> {\n    if (keys.length === 0) {\n      return;\n    }\n\n    await this.publisher.send(\"DEL\", keys);\n  }\n\n  // ---------------------------------------------------------\n  // Queue operations\n  // ---------------------------------------------------------\n\n  public override async lpush(key: string, value: string): Promise<void> {\n    await this.publisher.send(\"LPUSH\", [key, value]);\n  }\n\n  public override async rpop(key: string): Promise<string | undefined> {\n    const value = await this.publisher.send(\"RPOP\", [key]);\n    if (value == null) {\n      return undefined;\n    }\n    if (value instanceof Uint8Array) {\n      return Buffer.from(value).toString();\n    }\n    return String(value);\n  }\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations\n  // ---------------------------------------------------------\n\n  public override async publish(\n    channel: string,\n    message: string,\n  ): Promise<void> {\n    await this.publisher.publish(channel, message);\n  }\n\n  // ---------------------------------------------------------\n  // Counter operations\n  // ---------------------------------------------------------\n\n  public override async incr(key: string, amount: number): Promise<number> {\n    const result = await this.publisher.send(\"INCRBY\", [key, String(amount)]);\n    return Number(result);\n  }\n\n  /**\n   * Get the Redis connection URL.\n   */\n  protected getUrl(): string {\n    return this.env.REDIS_URL;\n  }\n}\n","/**\n * Abstract Redis subscriber provider interface.\n *\n * This abstract class defines the common interface for Redis pub/sub subscriptions.\n * Implementations include:\n * - {@link NodeRedisSubscriberProvider} - Uses `@redis/client` for Node.js runtime\n * - {@link BunRedisSubscriberProvider} - Uses Bun's native `RedisClient` for Bun runtime\n *\n * Redis requires separate connections for pub/sub operations, so this provider\n * creates a dedicated connection for subscriptions.\n *\n * @example\n * ```ts\n * // Inject the abstract provider - runtime selects the implementation\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n *\n * // Subscribe to a channel\n * await subscriber.subscribe(\"my-channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport abstract class RedisSubscriberProvider {\n  /**\n   * Whether the Redis subscriber client is ready to accept commands.\n   */\n  public abstract readonly isReady: boolean;\n\n  /**\n   * Connect to the Redis server for subscriptions.\n   */\n  public abstract connect(): Promise<void>;\n\n  /**\n   * Close the subscriber connection.\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Subscribe to a channel.\n   *\n   * @param channel The channel name.\n   * @param callback The callback to invoke when a message is received.\n   */\n  public abstract subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void>;\n\n  /**\n   * Unsubscribe from a channel.\n   *\n   * @param channel The channel name.\n   * @param callback Optional specific callback to remove.\n   */\n  public abstract unsubscribe(\n    channel: string,\n    callback?: SubscribeCallback,\n  ): Promise<void>;\n}\n\n/**\n * Callback for subscription messages.\n */\nexport type SubscribeCallback = (message: string, channel: string) => void;\n","import { $hook, $inject, Alepha, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { BunRedisProvider } from \"./BunRedisProvider.ts\";\nimport {\n  RedisSubscriberProvider,\n  type SubscribeCallback,\n} from \"./RedisSubscriberProvider.ts\";\n\n/**\n * Bun Redis subscriber provider for pub/sub operations.\n *\n * This provider creates a dedicated Redis connection for subscriptions,\n * as Redis requires separate connections for pub/sub operations.\n *\n * @example\n * ```ts\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n * await subscriber.subscribe(\"channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport class BunRedisSubscriberProvider extends RedisSubscriberProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(BunRedisProvider);\n  protected client?: Bun.RedisClient;\n\n  public get subscriber(): Bun.RedisClient {\n    if (!this.client?.connected) {\n      throw new AlephaError(\"Redis subscriber client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client?.connected ?? false;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server for subscriptions.\n   */\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting subscriber...\");\n    this.client = await this.redisProvider.duplicate();\n    this.log.info(\"Subscriber connection OK\");\n  }\n\n  /**\n   * Close the subscriber connection.\n   */\n  public override async close(): Promise<void> {\n    if (this.client) {\n      this.log.debug(\"Closing subscriber connection...\");\n      this.client.close();\n      this.client = undefined;\n      this.log.info(\"Subscriber connection closed\");\n    }\n  }\n\n  public override async subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.subscribe(channel, (message, ch) => {\n      // Bun's callback provides Buffer or string, normalize to string\n      const msg =\n        typeof message === \"object\" && message !== null\n          ? Buffer.from(message as Uint8Array).toString()\n          : String(message);\n      callback(msg, ch);\n    });\n  }\n\n  public override async unsubscribe(\n    channel: string,\n    _callback?: SubscribeCallback,\n  ): Promise<void> {\n    // Bun's unsubscribe doesn't support callback filtering\n    await this.subscriber.unsubscribe(channel);\n  }\n}\n","import {\n  createClient,\n  RESP_TYPES,\n  type RedisClientType,\n  type SetOptions,\n} from \"@redis/client\";\nimport {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, type RedisSetOptions } from \"./RedisProvider.ts\";\n\nconst envSchema = t.object({\n  REDIS_URL: t.text({\n    default: \"redis://localhost:6379\",\n    description: \"Redis connection URL\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\nexport type NodeRedisClient = RedisClientType<\n  {},\n  {},\n  {},\n  3,\n  { 36: BufferConstructor }\n>;\nexport type NodeRedisClientOptions = Parameters<typeof createClient>[0];\n\n/**\n * Node.js Redis client provider using `@redis/client`.\n *\n * This provider uses the official Redis client for Node.js runtime.\n *\n * @example\n * ```ts\n * // Set REDIS_URL environment variable (default: redis://localhost:6379)\n * // REDIS_URL=redis://:password@myredis.example.com:6379\n *\n * // Or configure programmatically\n * alepha.with({\n *   provide: RedisProvider,\n *   use: NodeRedisProvider,\n * });\n * ```\n */\nexport class NodeRedisProvider extends RedisProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected readonly client = this.createClient();\n\n  public get publisher(): NodeRedisClient {\n    if (!this.client.isReady) {\n      throw new AlephaError(\"Redis client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client.isReady;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  /**\n   * Connect to the Redis server.\n   */\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting...\");\n    await this.client.connect();\n    this.log.info(\"Connection OK\");\n  }\n\n  /**\n   * Close the connection to the Redis server.\n   */\n  public override async close(): Promise<void> {\n    this.log.debug(\"Closing connection...\");\n    await this.client.close();\n    this.log.info(\"Connection closed\");\n  }\n\n  public duplicate(options?: Partial<NodeRedisClientOptions>): NodeRedisClient {\n    return this.client\n      .duplicate({\n        ...options,\n        RESP: 3,\n      })\n      .withTypeMapping({\n        [RESP_TYPES.BLOB_STRING]: Buffer,\n      });\n  }\n\n  public override async get(key: string): Promise<Buffer | undefined> {\n    this.log.trace(`Getting key ${key}`);\n    const resp = await this.publisher.get(key);\n\n    if (resp === null) {\n      return undefined;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async set(\n    key: string,\n    value: Buffer | string,\n    options?: RedisSetOptions,\n  ): Promise<Buffer> {\n    const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, \"utf-8\");\n\n    // Convert RedisSetOptions to @redis/client SetOptions\n    const setOptions: SetOptions = {};\n\n    // Handle expiration object format (from alepha/cache-redis, alepha/lock-redis)\n    if (options?.expiration) {\n      if (options.expiration.type === \"KEEPTTL\") {\n        setOptions.KEEPTTL = true;\n      } else {\n        setOptions[options.expiration.type] = options.expiration.value;\n      }\n    }\n\n    // Handle direct expiration properties\n    if (options?.EX !== undefined) {\n      setOptions.EX = options.EX;\n    }\n    if (options?.PX !== undefined) {\n      setOptions.PX = options.PX;\n    }\n    if (options?.EXAT !== undefined) {\n      setOptions.EXAT = options.EXAT;\n    }\n    if (options?.PXAT !== undefined) {\n      setOptions.PXAT = options.PXAT;\n    }\n    if (options?.KEEPTTL) {\n      setOptions.KEEPTTL = true;\n    }\n\n    // Handle condition object format\n    if (options?.condition === \"NX\") {\n      setOptions.NX = true;\n    } else if (options?.condition === \"XX\") {\n      setOptions.XX = true;\n    }\n\n    // Handle direct condition properties\n    if (options?.NX) {\n      setOptions.NX = true;\n    }\n    if (options?.XX) {\n      setOptions.XX = true;\n    }\n    if (options?.GET) {\n      setOptions.GET = true;\n    }\n\n    const resp = await this.publisher.set(\n      key,\n      buf,\n      Object.keys(setOptions).length > 0 ? setOptions : undefined,\n    );\n\n    if (resp === \"OK\" || !resp) {\n      return buf;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public override async has(key: string): Promise<boolean> {\n    const resp = await this.publisher.exists(key);\n    return resp > 0;\n  }\n\n  public override async keys(pattern: string): Promise<string[]> {\n    const keys = await this.publisher.keys(pattern);\n    return keys.map((key) => key.toString());\n  }\n\n  public override async del(keys: string[]): Promise<void> {\n    if (keys.length === 0) {\n      return;\n    }\n\n    await this.publisher.del(keys);\n  }\n\n  // ---------------------------------------------------------\n  // Queue operations\n  // ---------------------------------------------------------\n\n  public override async lpush(key: string, value: string): Promise<void> {\n    await this.publisher.LPUSH(key, value);\n  }\n\n  public override async rpop(key: string): Promise<string | undefined> {\n    const value = await this.publisher.RPOP(key);\n    if (value == null) {\n      return undefined;\n    }\n    return String(value);\n  }\n\n  // ---------------------------------------------------------\n  // Pub/Sub operations\n  // ---------------------------------------------------------\n\n  public override async publish(\n    channel: string,\n    message: string,\n  ): Promise<void> {\n    await this.publisher.publish(channel, message);\n  }\n\n  // ---------------------------------------------------------\n  // Counter operations\n  // ---------------------------------------------------------\n\n  public override async incr(key: string, amount: number): Promise<number> {\n    return this.publisher.INCRBY(key, amount);\n  }\n\n  /**\n   * Get the Redis connection URL.\n   */\n  protected getUrl(): string {\n    return this.env.REDIS_URL;\n  }\n\n  /**\n   * Redis client factory method.\n   */\n  protected createClient(): NodeRedisClient {\n    const client = createClient({\n      url: this.getUrl(),\n      RESP: 3,\n    }).withTypeMapping({\n      [RESP_TYPES.BLOB_STRING]: Buffer,\n    });\n\n    client.on(\"error\", (error) => {\n      if (this.alepha.isStarted()) {\n        this.log.error(error);\n      }\n    });\n\n    return client;\n  }\n}\n","import { $hook, $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  type NodeRedisClient,\n  NodeRedisProvider,\n} from \"./NodeRedisProvider.ts\";\nimport {\n  RedisSubscriberProvider,\n  type SubscribeCallback,\n} from \"./RedisSubscriberProvider.ts\";\n\n/**\n * Node.js Redis subscriber provider using `@redis/client`.\n *\n * This provider creates a dedicated Redis connection for subscriptions,\n * as Redis requires separate connections for pub/sub operations.\n *\n * @example\n * ```ts\n * const subscriber = alepha.inject(RedisSubscriberProvider);\n * await subscriber.subscribe(\"channel\", (message, channel) => {\n *   console.log(`Received: ${message} on ${channel}`);\n * });\n * ```\n */\nexport class NodeRedisSubscriberProvider extends RedisSubscriberProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(NodeRedisProvider);\n  protected readonly client: NodeRedisClient = this.createClient();\n\n  public get subscriber(): NodeRedisClient {\n    if (!this.client.isReady) {\n      throw new Error(\"Redis subscriber client is not ready\");\n    }\n\n    return this.client;\n  }\n\n  public override get isReady(): boolean {\n    return this.client.isReady;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => this.connect(),\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n\n  public override async connect(): Promise<void> {\n    this.log.debug(\"Connecting subscriber...\");\n    await this.client.connect();\n    this.log.info(\"Subscriber connection OK\");\n  }\n\n  public override async close(): Promise<void> {\n    this.log.debug(\"Closing subscriber connection...\");\n    await this.subscriber.close();\n    this.log.info(\"Subscriber connection closed\");\n  }\n\n  public override async subscribe(\n    channel: string,\n    callback: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.subscribe(channel, callback);\n  }\n\n  public override async unsubscribe(\n    channel: string,\n    callback?: SubscribeCallback,\n  ): Promise<void> {\n    await this.subscriber.unsubscribe(channel, callback);\n  }\n\n  /**\n   * Redis subscriber client factory method.\n   */\n  protected createClient(): NodeRedisClient {\n    const client = this.redisProvider.duplicate();\n\n    client.on(\"error\", (error) => {\n      if (this.alepha.isStarted()) {\n        this.log.error(error);\n      }\n    });\n\n    return client;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { BunRedisProvider } from \"./providers/BunRedisProvider.ts\";\nimport { BunRedisSubscriberProvider } from \"./providers/BunRedisSubscriberProvider.ts\";\nimport { NodeRedisProvider } from \"./providers/NodeRedisProvider.ts\";\nimport { NodeRedisSubscriberProvider } from \"./providers/NodeRedisSubscriberProvider.ts\";\nimport { RedisProvider } from \"./providers/RedisProvider.ts\";\nimport { RedisSubscriberProvider } from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/BunRedisProvider.ts\";\nexport * from \"./providers/BunRedisSubscriberProvider.ts\";\nexport * from \"./providers/NodeRedisProvider.ts\";\nexport * from \"./providers/NodeRedisSubscriberProvider.ts\";\nexport * from \"./providers/RedisProvider.ts\";\nexport * from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * Redis client wrapper.\n *\n * **Features:**\n * - Connection pooling\n * - Automatic reconnection\n * - Command pipelining\n * - Pub/sub support\n *\n * @module alepha.redis\n */\nexport const AlephaRedis = $module({\n  name: \"alepha.redis\",\n  services: [\n    NodeRedisProvider,\n    NodeRedisSubscriberProvider,\n    BunRedisProvider,\n    BunRedisSubscriberProvider,\n    RedisProvider,\n    RedisSubscriberProvider,\n  ],\n  register: (alepha: Alepha) => {\n    if (alepha.isBun()) {\n      alepha\n        .with({\n          provide: RedisProvider,\n          use: BunRedisProvider,\n        })\n        .with({\n          provide: RedisSubscriberProvider,\n          use: BunRedisSubscriberProvider,\n        });\n    } else {\n      alepha\n        .with({\n          provide: RedisProvider,\n          use: NodeRedisProvider,\n        })\n        .with({\n          provide: RedisSubscriberProvider,\n          use: NodeRedisSubscriberProvider,\n        });\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/retry/index.d.ts

@@ -161,9 +161,18 @@ interface RetryPrimitiveFn<T extends (...args: any[]) => any> extends RetryPrimi
 //#endregion
 //#region ../../src/retry/index.d.ts
 /**
- * Retry mechanism provider for Alepha applications.
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | backend | standard | stable |
+ *
+ * Automatic retry with backoff.
+ *
+ * **Features:**
+ * - Retry configuration
+ * - Exponential backoff
+ * - Max retry limits
+ * - Custom retry predicates
  *
- * @see {@link RetryProvider}
  * @module alepha.retry
  */
 declare const AlephaRetry: alepha0.Service<alepha0.Module>;

package/dist/retry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/retry/errors/RetryCancelError.ts","../../src/retry/errors/RetryTimeoutError.ts","../../src/retry/providers/RetryProvider.ts","../../src/retry/primitives/$retry.ts","../../src/retry/index.ts"],"mappings":";;;;;;cAEa,gBAAA,SAAyB,WAAA;EAAA,WAAA,CAAA;AAAA;;;cCAzB,iBAAA,SAA0B,WAAA;cACzB,QAAA;AAAA;;;UCGG,YAAA,eAA2B,IAAA;;;;EAI1C,OAAA,EAAS,CAAA;EFRE;;;;;EEeX,GAAA;;;ADfF;;;;ECuBE,OAAA,YAAmB,mBAAA;;;;;;EAOnB,WAAA,GAAc,YAAA;;AA1BhB;;;;EAiCE,IAAA,IAAQ,KAAA,EAAO,KAAA;EAPD;;;;EAad,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EAKrD;;;EAAT,MAAA,GAAS,WAAA;EA5CmB;;;;EAkD5B,gBAAA,GAAmB,WAAA;AAAA;AAAA,UAGJ,mBAAA;EA3Bf;;;;;EAiCA,OAAA;EApBkB;;;;;EA2BlB,MAAA;EAtBA;;;EA2BA,GAAA;EArB8B;;AAGhC;;;EAyBE,MAAA;AAAA;;;;;cAOW,aAAA;EAAA,mBACQ,GAAA,EADK,cAAA,CACF,MAAA;EAAA,mBACH,QAAA,EAAQ,gBAAA;EAFH;;;EAOlB,KAAA,eAAoB,IAAA,gBAAA,CACxB,OAAA,EAAS,YAAA,CAAa,CAAA,MACnB,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,UAAA,CAAW,CAAA;EAFX;;;EAAA,UAgHD,gBAAA,CACR,OAAA,UACA,OAAA,YAAmB,mBAAA;AAAA;;;;;AFnNvB;;cGaa,MAAA;EAAA,eAAwB,IAAA,iBAAmB,OAAA,EAC7C,qBAAA,CAAsB,CAAA,IAC9B,gBAAA,CAAiB,CAAA;EAAA;;UAQH,qBAAA,eAAoC,IAAA;;AFvBrD;;EE2BE,OAAA,EAAS,CAAA;EF3BuC;;;;;EEkChD,GAAA;;;;AD9BF;;;ECsCE,OAAA,YAAmB,mBAAA;EDnBA;;;;;EC0BnB,WAAA,GAAc,YAAA;EDDL;;;;;ECQT,IAAA,IAAQ,KAAA,EAAO,KAAA;EDhDf;;;;ECsDA,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EDhC9D;;;ECqCA,MAAA,GAAS,WAAA;AAAA;AAAA,cAKE,cAAA,eACG,IAAA,yBACN,SAAA,CAAU,qBAAA,CAAsB,CAAA;EAAA,mBACrB,aAAA,EAAa,aAAA;EAAA,UACtB,kBAAA,GAAqB,eAAA;cAEnB,IAAA,EAAM,aAAA,CAAc,qBAAA,CAAsB,CAAA;EAQhD,GAAA,CAAA,GAAO,IAAA,EAAM,UAAA,CAAW,CAAA,IAAK,OAAA,CAAQ,UAAA,CAAW,CAAA;AAAA;AAAA,UAcvC,gBAAA,eAA+B,IAAA,yBACtC,cAAA,CAAe,CAAA;EAAA,IACnB,IAAA,EAAM,UAAA,CAAW,CAAA,IAAK,OAAA,CAAQ,UAAA,CAAW,CAAA;AAAA;;;;;AHtG/C;;;;cIiBa,WAAA,EAAW,OAAA,CAAA,OAAA,CAItB,OAAA,CAJsB,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/retry/errors/RetryCancelError.ts","../../src/retry/errors/RetryTimeoutError.ts","../../src/retry/providers/RetryProvider.ts","../../src/retry/primitives/$retry.ts","../../src/retry/index.ts"],"mappings":";;;;;;cAEa,gBAAA,SAAyB,WAAA;EAAA,WAAA,CAAA;AAAA;;;cCAzB,iBAAA,SAA0B,WAAA;cACzB,QAAA;AAAA;;;UCGG,YAAA,eAA2B,IAAA;;;;EAI1C,OAAA,EAAS,CAAA;EFRE;;;;;EEeX,GAAA;;;ADfF;;;;ECuBE,OAAA,YAAmB,mBAAA;;;;;;EAOnB,WAAA,GAAc,YAAA;;AA1BhB;;;;EAiCE,IAAA,IAAQ,KAAA,EAAO,KAAA;EAPD;;;;EAad,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EAKrD;;;EAAT,MAAA,GAAS,WAAA;EA5CmB;;;;EAkD5B,gBAAA,GAAmB,WAAA;AAAA;AAAA,UAGJ,mBAAA;EA3Bf;;;;;EAiCA,OAAA;EApBkB;;;;;EA2BlB,MAAA;EAtBA;;;EA2BA,GAAA;EArB8B;;AAGhC;;;EAyBE,MAAA;AAAA;;;;;cAOW,aAAA;EAAA,mBACQ,GAAA,EADK,cAAA,CACF,MAAA;EAAA,mBACH,QAAA,EAAQ,gBAAA;EAFH;;;EAOlB,KAAA,eAAoB,IAAA,gBAAA,CACxB,OAAA,EAAS,YAAA,CAAa,CAAA,MACnB,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,UAAA,CAAW,CAAA;EAFX;;;EAAA,UAgHD,gBAAA,CACR,OAAA,UACA,OAAA,YAAmB,mBAAA;AAAA;;;;;AFnNvB;;cGaa,MAAA;EAAA,eAAwB,IAAA,iBAAmB,OAAA,EAC7C,qBAAA,CAAsB,CAAA,IAC9B,gBAAA,CAAiB,CAAA;EAAA;;UAQH,qBAAA,eAAoC,IAAA;;AFvBrD;;EE2BE,OAAA,EAAS,CAAA;EF3BuC;;;;;EEkChD,GAAA;;;;AD9BF;;;ECsCE,OAAA,YAAmB,mBAAA;EDnBA;;;;;EC0BnB,WAAA,GAAc,YAAA;EDDL;;;;;ECQT,IAAA,IAAQ,KAAA,EAAO,KAAA;EDhDf;;;;ECsDA,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EDhC9D;;;ECqCA,MAAA,GAAS,WAAA;AAAA;AAAA,cAKE,cAAA,eACG,IAAA,yBACN,SAAA,CAAU,qBAAA,CAAsB,CAAA;EAAA,mBACrB,aAAA,EAAa,aAAA;EAAA,UACtB,kBAAA,GAAqB,eAAA;cAEnB,IAAA,EAAM,aAAA,CAAc,qBAAA,CAAsB,CAAA;EAQhD,GAAA,CAAA,GAAO,IAAA,EAAM,UAAA,CAAW,CAAA,IAAK,OAAA,CAAQ,UAAA,CAAW,CAAA;AAAA;AAAA,UAcvC,gBAAA,eAA+B,IAAA,yBACtC,cAAA,CAAe,CAAA;EAAA,IACnB,IAAA,EAAM,UAAA,CAAW,CAAA,IAAK,OAAA,CAAQ,UAAA,CAAW,CAAA;AAAA;;;;;AHtG/C;;;;;;;;ACAA;;;;;cG0Ba,WAAA,EAAW,OAAA,CAAA,OAAA,CAItB,OAAA,CAJsB,MAAA"}

package/dist/retry/index.js

@@ -125,9 +125,18 @@ $retry[KIND] = RetryPrimitive;
 //#endregion
 //#region ../../src/retry/index.ts
 /**
-* Retry mechanism provider for Alepha applications.
+* | type | quality | stability |
+* |------|---------|-----------|
+* | backend | standard | stable |
+*
+* Automatic retry with backoff.
+*
+* **Features:**
+* - Retry configuration
+* - Exponential backoff
+* - Max retry limits
+* - Custom retry predicates
 *
-* @see {@link RetryProvider}
 * @module alepha.retry
 */
 const AlephaRetry = $module({

package/dist/retry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/retry/errors/RetryCancelError.ts","../../src/retry/errors/RetryTimeoutError.ts","../../src/retry/providers/RetryProvider.ts","../../src/retry/primitives/$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  createPrimitive,\n  KIND,\n  Primitive,\n  type PrimitiveArgs,\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: RetryPrimitiveOptions<T>,\n): RetryPrimitiveFn<T> => {\n  const instance = createPrimitive(RetryPrimitive, options);\n  const fn = (...args: Parameters<T>) => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as RetryPrimitiveFn<T>;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface RetryPrimitiveOptions<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 RetryPrimitive<\n  T extends (...args: any[]) => any,\n> extends Primitive<RetryPrimitiveOptions<T>> {\n  protected readonly retryProvider = $inject(RetryProvider);\n  protected appAbortController?: AbortController;\n\n  constructor(args: PrimitiveArgs<RetryPrimitiveOptions<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 RetryPrimitiveFn<T extends (...args: any[]) => any>\n  extends RetryPrimitive<T> {\n  (...args: Parameters<T>): Promise<ReturnType<T>>;\n}\n\n$retry[KIND] = RetryPrimitive;\n","import { $module } from \"alepha\";\nimport { $retry } from \"./primitives/$retry.ts\";\nimport { RetryProvider } from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/RetryCancelError.ts\";\nexport * from \"./errors/RetryTimeoutError.ts\";\nexport * from \"./primitives/$retry.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  primitives: [$retry],\n  services: [RetryProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/retry/errors/RetryCancelError.ts","../../src/retry/errors/RetryTimeoutError.ts","../../src/retry/providers/RetryProvider.ts","../../src/retry/primitives/$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  createPrimitive,\n  KIND,\n  Primitive,\n  type PrimitiveArgs,\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: RetryPrimitiveOptions<T>,\n): RetryPrimitiveFn<T> => {\n  const instance = createPrimitive(RetryPrimitive, options);\n  const fn = (...args: Parameters<T>) => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as RetryPrimitiveFn<T>;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface RetryPrimitiveOptions<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 RetryPrimitive<\n  T extends (...args: any[]) => any,\n> extends Primitive<RetryPrimitiveOptions<T>> {\n  protected readonly retryProvider = $inject(RetryProvider);\n  protected appAbortController?: AbortController;\n\n  constructor(args: PrimitiveArgs<RetryPrimitiveOptions<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 RetryPrimitiveFn<T extends (...args: any[]) => any>\n  extends RetryPrimitive<T> {\n  (...args: Parameters<T>): Promise<ReturnType<T>>;\n}\n\n$retry[KIND] = RetryPrimitive;\n","import { $module } from \"alepha\";\nimport { $retry } from \"./primitives/$retry.ts\";\nimport { RetryProvider } from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/RetryCancelError.ts\";\nexport * from \"./errors/RetryTimeoutError.ts\";\nexport * from \"./primitives/$retry.ts\";\nexport * from \"./providers/RetryProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * Automatic retry with backoff.\n *\n * **Features:**\n * - Retry configuration\n * - Exponential backoff\n * - Max retry limits\n * - Custom retry predicates\n *\n * @module alepha.retry\n */\nexport const AlephaRetry = $module({\n  name: \"alepha.retry\",\n  primitives: [$retry],\n  services: [RetryProvider],\n});\n"],"mappings":"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"}

package/dist/scheduler/index.d.ts

@@ -216,9 +216,18 @@ declare module "alepha" {
   }
 }
 /**
- * Generic interface for scheduling tasks.
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | backend | rare | stable |
+ *
+ * Cron and interval-based task execution.
+ *
+ * **Features:**
+ * - Scheduled tasks with cron expressions (e.g., `0 0 * * *`)
+ * - Interval-based scheduling
+ * - Distributed locking to prevent duplicate execution
+ * - Lifecycle hooks: `begin`, `success`, `error`, `end`
  *
- * @see {@link $scheduler}
  * @module alepha.scheduler
  */
 declare const AlephaScheduler: alepha1.Service<alepha1.Module>;

package/dist/scheduler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date"],"sources":["../../src/scheduler/constants/CRON.ts","../../../../node_modules/cron-schedule/dist/cron.d.ts","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date"],"sources":["../../src/scheduler/constants/CRON.ts","../../../../node_modules/cron-schedule/dist/cron.d.ts","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}

package/dist/scheduler/index.js

@@ -556,9 +556,18 @@ const CRON = {
 //#endregion
 //#region ../../src/scheduler/index.ts
 /**
-* Generic interface for scheduling tasks.
+* | type | quality | stability |
+* |------|---------|-----------|
+* | backend | rare | stable |
+*
+* Cron and interval-based task execution.
+*
+* **Features:**
+* - Scheduled tasks with cron expressions (e.g., `0 0 * * *`)
+* - Interval-based scheduling
+* - Distributed locking to prevent duplicate execution
+* - Lifecycle hooks: `begin`, `success`, `error`, `end`
 *
-* @see {@link $scheduler}
 * @module alepha.scheduler
 */
 const AlephaScheduler = $module({