alepha 0.21.2 → 0.23.0

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  // 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, AlephaError } 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 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.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    if (!this.client.isReady) {\n      this.log.debug(\"Subscriber client not ready, skipping close\");\n      return;\n    }\n    this.log.debug(\"Closing subscriber connection...\");\n    await this.client.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 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: [RedisProvider, RedisSubscriberProvider],\n  variants: [\n    NodeRedisProvider,\n    NodeRedisSubscriberProvider,\n    BunRedisProvider,\n    BunRedisSubscriberProvider,\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, AlephaError } 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 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.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    if (!this.client.isReady) {\n      this.log.debug(\"Subscriber client not ready, skipping close\");\n      return;\n    }\n    this.log.debug(\"Closing subscriber connection...\");\n    await this.client.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 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: [RedisProvider, RedisSubscriberProvider],\n  variants: [\n    NodeRedisProvider,\n    NodeRedisSubscriberProvider,\n    BunRedisProvider,\n    BunRedisSubscriberProvider,\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

@@ -1,7 +1,5 @@
-import * as _$alepha from "alepha";
 import { AlephaError, Middleware, Primitive, PrimitiveArgs } from "alepha";
 import { DateTimeProvider, DurationLike } from "alepha/datetime";
-import * as _$alepha_logger0 from "alepha/logger";
 
 //#region ../../src/retry/errors/RetryCancelError.d.ts
 declare class RetryCancelError extends AlephaError {
@@ -88,7 +86,7 @@ interface RetryBackoffOptions {
  * Supports exponential backoff, max duration, conditional retries, and cancellation.
  */
 declare class RetryProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly dateTime: DateTimeProvider;
   /**
    * Execute a function with automatic retry logic.
@@ -212,7 +210,7 @@ interface RetryPrimitiveFn<T extends (...args: any[]) => any> extends RetryPrimi
  *
  * @module alepha.retry
  */
-declare const AlephaRetry: _$alepha.Service<_$alepha.Module>;
+declare const AlephaRetry: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { $retry, AlephaRetry, RetryBackoffOptions, RetryCancelError, RetryMiddlewareOptions, RetryOptions, RetryPrimitive, RetryPrimitiveFn, RetryPrimitiveOptions, RetryProvider, RetryTimeoutError };
 //# sourceMappingURL=index.d.ts.map

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,gBAAA,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;;;;;;;;ACAA;;;cEuBa,MAAA,GAAU,OAAA,GAAU,sBAAA,KAAyB,UAAA;AAAA,UA8BzC,qBAAA,eAAoC,IAAA;;;;EAInD,OAAA,EAAS,CAAA;;;;ADrDX;;EC4DE,GAAA;EDxDS;;;;;;ECgET,OAAA,YAAmB,mBAAA;EDxBV;;;;;EC+BT,WAAA,GAAc,YAAA;EDvEd;;;;;EC8EA,IAAA,IAAQ,KAAA,EAAO,KAAA;EDxDD;;;;EC8Dd,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EDjD5C;;;ECsDlB,MAAA,GAAS,WAAA;AAAA;;;;UAMM,sBAAA;EDjDI;;;AAGrB;;ECoDE,GAAA;EDpDkC;;;;;EC2DlC,OAAA,YAAmB,mBAAA;EDlCb;AAOR;;ECgCE,WAAA,GAAc,YAAA;EDhCU;;;;;ECuCxB,IAAA,IAAQ,KAAA,EAAO,KAAA;ED7BO;;;ECkCtB,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA;ED8Ee;;;ECzExC,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;;;;;AH7K/C;;;;;;;;ACAA;cGqBa,WAAA,EAAW,QAAA,CAAA,OAAA,CAGtB,QAAA,CAHsB,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,WAAW;EAAX,WAAA;AAAA;;;cCAzB,iBAAA,SAA0B,WAAW;cACpC,QAAA;AAAA;;;UCGG,YAAA,eAA2B,IAAA;;;AFJ5C;EEQE,OAAA,EAAS,CAAA;;;;;;EAOT,GAAA;EDfW;;;;;;ECuBX,OAAA,YAAmB,mBAAA;EDtBS;AAAA;;;;EC6B5B,WAAA,GAAc,YAAA;EA1Ba;;;;;EAiC3B,IAAA,IAAQ,KAAA,EAAO,KAAA;EAMG;;;;EAAlB,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EAWhC;;;EAN9B,MAAA,GAAS,WAAA;EAxCT;;;;EA8CA,gBAAA,GAAmB,WAAA;AAAA;AAAA,UAGJ,mBAAA;EApBf;;;;;EA0BA,OAAA;EApByB;;;;;EA2BzB,MAAA;EAhBA;;;EAqBA,GAAA;EAlBe;;;;;EAyBf,MAAA;AAAA;;;AAAM;AAOR;cAAa,aAAA;EAAA,mBACQ,GAAA,0BAAG,MAAA;EAAA,mBACH,QAAA,EAAQ,gBAAA;EAMH;;;EADlB,KAAA,eAAoB,IAAA,iBACxB,OAAA,EAAS,YAAA,CAAa,CAAA,MACnB,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,UAAA,CAAW,CAAA;EAAA;;;EAAA,UA8GZ,gBAAA,CACR,OAAA,UACA,OAAA,YAAmB,mBAAA;AAAA;;;AFnNvB;;;;;;;;ACAA;;;;;ADAA,cGuBa,MAAA,GAAU,OAAA,GAAU,sBAAA,KAAyB,UA0BzD;AAAA,UAIgB,qBAAA,eAAoC,IAAA;EFpDvB;AAAA;;EEwD5B,OAAA,EAAS,CAAA;;ADrDX;;;;EC4DE,GAAA;EDlCc;;;;;;EC0Cd,OAAA,YAAmB,mBAAA;EDlBW;;;;;ECyB9B,WAAA,GAAc,YAAA;EDhEd;;;;;ECuEA,IAAA,IAAQ,KAAA,EAAO,KAAA;EDjDA;;;;ECuDf,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA,aAAoB,IAAA,EAAM,UAAA,CAAW,CAAA;EDjDrC;;;ECsDzB,MAAA,GAAS,WAAA;AAAA;;;;UAMM,sBAAA;EDjDe;AAGhC;;;;ECoDE,GAAA;EDvCA;;;;AAYM;ECkCN,OAAA,YAAmB,mBAAA;ED3BK;;;ECgCxB,WAAA,GAAc,YAAA;EDxBH;;;;;EC+BX,IAAA,IAAQ,KAAA,EAAO,KAAA;EDmFM;;;EC9ErB,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,OAAA;ED3CH;;;ECgDtB,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,IAAO,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;;;AH7K/C;;;;;;;;ACAA;;;ADAA,cIqBa,WAAA,mBAAW,OAAA,kBAAA,MAAA"}

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 = this.dateTime.nowMillis();\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 (this.dateTime.nowMillis() - 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 (this.dateTime.nowMillis() - 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 (this.dateTime.nowMillis() - 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 (this.dateTime.nowMillis() - 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  $context,\n  $inject,\n  createMiddleware,\n  type Middleware,\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 * Retry middleware for `use` arrays in `$action`, `$job`, `$page`, `$pipeline`.\n *\n * Retries the handler on failure with configurable backoff, max attempts, and\n * conditional retry via `when`. Aborts on application shutdown.\n *\n * ```ts\n * processOrder = $action({\n *   use: [$retry({ max: 3, backoff: { initial: 500 } })],\n *   handler: async ({ body }) => { ... },\n * });\n * ```\n */\nexport const $retry = (options?: RetryMiddlewareOptions): Middleware => {\n  const { alepha } = $context();\n  const retryProvider = alepha.inject(RetryProvider);\n  let appAbortController: AbortController | undefined;\n\n  alepha.events.on(\"stop\", () => {\n    appAbortController?.abort();\n  });\n\n  return createMiddleware({\n    name: \"$retry\",\n    options: options as unknown as Record<string, unknown>,\n    handler: ({ next }) => {\n      return async (...args) => {\n        appAbortController ??= new AbortController();\n        return retryProvider.retry(\n          {\n            ...options,\n            handler: next,\n            additionalSignal: appAbortController.signal,\n          },\n          ...args,\n        );\n      };\n    },\n  });\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 * Options for $retry in middleware mode (no handler).\n */\nexport interface RetryMiddlewareOptions {\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   *\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  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   */\n  onError?: (error: Error, attempt: number) => 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","import { $module } from \"alepha\";\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 * 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  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 = this.dateTime.nowMillis();\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 (this.dateTime.nowMillis() - 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 (this.dateTime.nowMillis() - 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 (this.dateTime.nowMillis() - 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 (this.dateTime.nowMillis() - 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  $context,\n  $inject,\n  createMiddleware,\n  type Middleware,\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 * Retry middleware for `use` arrays in `$action`, `$job`, `$page`, `$pipeline`.\n *\n * Retries the handler on failure with configurable backoff, max attempts, and\n * conditional retry via `when`. Aborts on application shutdown.\n *\n * ```ts\n * processOrder = $action({\n *   use: [$retry({ max: 3, backoff: { initial: 500 } })],\n *   handler: async ({ body }) => { ... },\n * });\n * ```\n */\nexport const $retry = (options?: RetryMiddlewareOptions): Middleware => {\n  const { alepha } = $context();\n  const retryProvider = alepha.inject(RetryProvider);\n  let appAbortController: AbortController | undefined;\n\n  alepha.events.on(\"stop\", () => {\n    appAbortController?.abort();\n  });\n\n  return createMiddleware({\n    name: \"$retry\",\n    options: options as unknown as Record<string, unknown>,\n    handler: ({ next }) => {\n      return async (...args) => {\n        appAbortController ??= new AbortController();\n        return retryProvider.retry(\n          {\n            ...options,\n            handler: next,\n            additionalSignal: appAbortController.signal,\n          },\n          ...args,\n        );\n      };\n    },\n  });\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 * Options for $retry in middleware mode (no handler).\n */\nexport interface RetryMiddlewareOptions {\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   *\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  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   */\n  onError?: (error: Error, attempt: number) => 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","import { $module } from \"alepha\";\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 * 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  services: [RetryProvider],\n});\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"mappings":";uBAEsB,cAAA,WAAyB,KAAA,GAAQ,KAAA;EAAA,UAC3C,cAAA,EAAgB,MAAA;EAAA,UAEhB,IAAA,EAAM,IAAA,CAAK,CAAA;EAAA,UACX,KAAA,EAAK,GAAA,SAAA,UAAA,CAAA,CAAA;EAAA,UACL,YAAA;EAEH,KAAA,CAAM,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UAY7B,IAAA,CAAK,IAAA;EAAA,UAML,IAAA,CAAK,KAAA,EAAO,CAAA;EAAA,UA+DZ,gBAAA,CAAiB,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UA4C3C,SAAA,CAAU,KAAA,EAAO,UAAA,CAAW,CAAA,IAAK,UAAA,CAAW,CAAA;EAAA,UAa5C,WAAA,CAAY,IAAA;AAAA;AAAA,UAYP,UAAA,WAAqB,KAAA;EACpC,KAAA,GAAQ,CAAA;EACR,MAAA,GAAS,MAAA;AAAA;AAAA,UAGM,KAAA;EACf,IAAA;EA/B2B;;;;;;;EAwC3B,SAAA,GAAY,MAAA;AAAA;AAAA,UAGG,IAAA,WAAe,KAAA;EAC9B,KAAA,GAAQ,CAAA;EACR,QAAA;IAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;EAAA;EAEtB,KAAA;IACE,KAAA,GAAQ,CAAA;IACR,IAAA;IACA,QAAA;MAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;IAAA;EAAA;EAGxB,QAAA;IACE,KAAA,EAAO,CAAA;EAAA;AAAA;;;;AA5LX;;;;;;;;;;;;;;;;;;;;;cCsBa,mBAAA;EAAA,0BACe,WAAA,EAAW,MAAA;EAAA,SAErB,QAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;EAAA,mBACG,YAAA,EAAc,MAAA;cAErB,QAAA,UAAkB,SAAA;ED5BT;;;;EC+CrB,WAAA,CAAY,MAAA,EAAQ,MAAA;ED7CV;;;;;;;EC2DV,OAAA,CAAQ,IAAA,WAAe,MAAA;EDvCD;;;;EC4DtB,WAAA,CAAY,QAAA;EDGyC;;;;ECKrD,SAAA,CAAU,IAAA;EAAA,UAaA,iBAAA,CAAA,GAAqB,MAAA;EAAA,UAerB,WAAA,CAAY,CAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"mappings":";uBAEsB,cAAA,WAAyB,KAAA,GAAQ,KAAA;EAAA,UAC3C,cAAA,EAAgB,MAAA;EAAA,UAEhB,IAAA,EAAM,IAAA,CAAK,CAAA;EAAA,UACX,KAAA,EAAK,GAAA,SAAA,UAAA,CAAA,CAAA;EAAA,UACL,YAAA;EAEH,KAAA,CAAM,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UAY7B,IAAA,CAAK,IAAA;EAAA,UAML,IAAA,CAAK,KAAA,EAAO,CAAA;EAAA,UA+DZ,gBAAA,CAAiB,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UA4C3C,SAAA,CAAU,KAAA,EAAO,UAAA,CAAW,CAAA,IAAK,UAAA,CAAW,CAAA;EAAA,UAa5C,WAAA,CAAY,IAAA;AAAA;AAAA,UAYP,UAAA,WAAqB,KAAA;EACpC,KAAA,GAAQ,CAAA;EACR,MAAA,GAAS,MAAA;AAAA;AAAA,UAGM,KAAA;EACf,IAAA;EA/B2B;;;;;;;EAwC3B,SAAA,GAAY,MAAM;AAAA;AAAA,UAGH,IAAA,WAAe,KAAA;EAC9B,KAAA,GAAQ,CAAA;EACR,QAAA;IAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;EAAA;EAEtB,KAAA;IACE,KAAA,GAAQ,CAAA;IACR,IAAA;IACA,QAAA;MAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;IAAA;EAAA;EAGxB,QAAA;IACE,KAAA,EAAO,CAAA;EAAA;AAAA;;;;AA5LX;;;;;;;;;;;;;;;;;;;;;cCsBa,mBAAA;EAAA,0BACe,WAAA,EAAW,MAAA;EAAA,SAErB,QAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;EAAA,mBACG,YAAA,EAAc,MAAA;cAErB,QAAA,UAAkB,SAAA;ED5BT;;;;EC+CrB,WAAA,CAAY,MAAA,EAAQ,MAAA;ED7CV;;;;;;;EC2DV,OAAA,CAAQ,IAAA,WAAe,MAAA;EDvCD;;;;EC4DtB,WAAA,CAAY,QAAA;EDGyC;;;;ECKrD,SAAA,CAAU,IAAA;EAAA,UAaA,iBAAA,IAAqB,MAAA;EAAA,UAerB,WAAA,CAAY,CAAA;AAAA"}

package/dist/router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n  protected maxCacheSize = 10_000;\n\n  public match(path: string): RouteMatch<T> {\n    const pathname = path.split(\"?\", 1)[0];\n    const hit = this.cache.get(pathname);\n    if (hit) {\n      return { route: hit.route, params: { ...hit.params } };\n    }\n    const result = this.mapParams(this.createRouteMatch(pathname));\n    if (this.cache.size >= this.maxCacheSize) this.cache.clear();\n    this.cache.set(pathname, result);\n    return { route: result.route, params: { ...result.params } };\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n    this.cache.clear();\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n","import { AlephaError } from \"alepha\";\n\n/**\n * Parses and manipulates templated paths with `{param}` placeholders.\n *\n * Used by both RouterProvider (HTTP routes) and TopicProvider (pub/sub topics)\n * to handle parameterized path templates in a unified way.\n *\n * @example\n * ```ts\n * const parser = new TemplatedPathParser(\"/users/{userId}/posts/{postId}\");\n * parser.interpolate({ userId: \"7\", postId: \"42\" }); // \"/users/7/posts/42\"\n * parser.extract(\"/users/7/posts/42\");               // { userId: \"7\", postId: \"42\" }\n * parser.wildcardize(\"+\");                           // \"/users/+/posts/+\"\n * ```\n *\n * @example\n * ```ts\n * // Redis-style colon-separated keys\n * const parser = new TemplatedPathParser(\"cache:{namespace}:{key}\", \":\");\n * parser.interpolate({ namespace: \"users\", key: \"42\" }); // \"cache:users:42\"\n * parser.wildcardize(\"*\");                               // \"cache:*:*\"\n * ```\n */\nexport class TemplatedPathParser {\n  protected static readonly PARAM_REGEX = /\\{([^}]+)\\}/g;\n\n  public readonly template: string;\n  public readonly separator: string;\n  public readonly paramNames: readonly string[];\n  public readonly hasParams: boolean;\n  protected readonly extractRegex: RegExp | null;\n\n  constructor(template: string, separator = \"/\") {\n    if (separator.length !== 1) {\n      throw new AlephaError(\n        `TemplatedPathParser separator must be a single character, got '${separator}'`,\n      );\n    }\n    this.template = template;\n    this.separator = separator;\n    this.paramNames = [\n      ...template.matchAll(TemplatedPathParser.PARAM_REGEX),\n    ].map((m) => m[1]);\n    this.hasParams = this.paramNames.length > 0;\n    this.extractRegex = this.hasParams ? this.buildExtractRegex() : null;\n  }\n\n  /**\n   * Replaces each `{param}` in the template with the corresponding value\n   * from the provided params record.\n   */\n  interpolate(params: Record<string, string>): string {\n    return this.template.replace(\n      TemplatedPathParser.PARAM_REGEX,\n      (_, name: string) => params[name] ?? `{${name}}`,\n    );\n  }\n\n  /**\n   * Extracts parameter values from a concrete path by matching it against\n   * the template structure.\n   *\n   * Returns `null` when the path does not match the template.\n   * Returns `{}` when the template has no parameters and the path matches.\n   */\n  extract(path: string): Record<string, string> | null {\n    if (!this.extractRegex) {\n      return path === this.template ? {} : null;\n    }\n\n    const match = this.extractRegex.exec(path);\n    if (!match) {\n      return null;\n    }\n\n    const result: Record<string, string> = {};\n    for (let i = 0; i < this.paramNames.length; i++) {\n      result[this.paramNames[i]] = match[i + 1];\n    }\n    return result;\n  }\n\n  /**\n   * Replaces each `{param}` placeholder in the template with the given\n   * wildcard string. Defaults to `\"+\"` (MQTT-style).\n   */\n  wildcardize(wildcard = \"+\"): string {\n    return this.template.replace(TemplatedPathParser.PARAM_REGEX, wildcard);\n  }\n\n  /**\n   * Normalises a path by collapsing repeated separators and stripping a\n   * trailing separator (unless the path is just the separator itself).\n   */\n  normalize(path: string): string {\n    const sep = this.separator;\n    const escapedSep = this.escapeRegex(sep);\n\n    let result = path.replace(new RegExp(`${escapedSep}{2,}`, \"g\"), sep);\n\n    if (result.endsWith(sep) && result.length > sep.length) {\n      result = result.slice(0, -sep.length);\n    }\n\n    return result;\n  }\n\n  protected buildExtractRegex(): RegExp {\n    const escapedSeparator = this.escapeRegex(this.separator);\n\n    const regexSource = this.template\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, (char) => {\n        if (char === \"{\" || char === \"}\") {\n          return char;\n        }\n        return `\\\\${char}`;\n      })\n      .replace(/\\{[^}]+\\}/g, `([^${escapedSeparator}]+)`);\n\n    return new RegExp(`^${regexSource}$`);\n  }\n\n  protected escapeRegex(s: string): string {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n}\n"],"mappings":";;AAEA,IAAsB,iBAAtB,MAA8D;CAC5D,iBAAmC;CAEnC,OAA0B,EAAE,UAAU,EAAE,EAAE;CAC1C,wBAAkB,IAAI,KAA4B;CAClD,eAAyB;CAEzB,MAAa,MAA6B;EACxC,MAAM,WAAW,KAAK,MAAM,KAAK,EAAE,CAAC;EACpC,MAAM,MAAM,KAAK,MAAM,IAAI,SAAS;EACpC,IAAI,KACF,OAAO;GAAE,OAAO,IAAI;GAAO,QAAQ,EAAE,GAAG,IAAI,QAAQ;GAAE;EAExD,MAAM,SAAS,KAAK,UAAU,KAAK,iBAAiB,SAAS,CAAC;EAC9D,IAAI,KAAK,MAAM,QAAQ,KAAK,cAAc,KAAK,MAAM,OAAO;EAC5D,KAAK,MAAM,IAAI,UAAU,OAAO;EAChC,OAAO;GAAE,OAAO,OAAO;GAAO,QAAQ,EAAE,GAAG,OAAO,QAAQ;GAAE;;CAG9D,KAAe,MAAoB;EACjC,IAAI,CAAC,KAAK,eAAe,KAAK,KAAK,EACjC,MAAM,IAAI,YAAY,UAAU,KAAK,gBAAgB;;CAIzD,KAAe,OAAgB;EAC7B,MAAM,OAAO,MAAM,KAAK,WAAW,MAAM,IAAI;EAE7C,KAAK,KAAK,KAAK;EACf,KAAK,MAAM,OAAO;EAElB,MAAM,QAAQ,KAAK,YAAY,KAAK;EAEpC,IAAI,SAAS,KAAK;EAClB,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACrC,MAAM,SAAS,MAAM,MAAM,SAAS;GACpC,IAAI,OAAO,MAAM,GAAG,aAAa;GACjC,IAAI,SAAS,OAAO,QAAQ;IAC1B,OAAO,WAAW,EAAE,OAAO;IAC3B;;GAGF,IAAI,KAAK,SAAS,IAAI,EACpB,MAAM,IAAI,YAAY,UAAU,KAAK,kCAAkC;GAGzE,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,EAC1C,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,IAAI,EAC5C,OAAO,IAAI,KAAK,MAAM,GAAG,GAAG;QAE5B,MAAM,IAAI,YAAY,UAAU,KAAK,+BAA+B;GAIxE,IAAI,KAAK,WAAW,IAAI,EAAE;IACxB,MAAM,OAAO,MAAM,GAAG,MAAM,EAAE,CAAC,WAAW,KAAK,GAAG;IAClD,IAAI,CAAC,MACH,MAAM,IAAI,YAAY,UAAU,KAAK,2BAA2B;IAElE,IAAI,CAAC,OAAO,OACV,OAAO,QAAQ;KAAE;KAAM,UAAU,EAAE;KAAE;SAChC,IAAI,OAAO,MAAM,SAAS,MAAM;KAGrC,MAAM,cAAc,EAAE;KACtB,MAAM,UAAU,OAAO,MAAM,QAAQ;;IAGvC,IAAI,QACF,OAAO,MAAM,QAAQ;IAGvB,SAAS,OAAO;IAChB;;GAGF,IAAI,CAAC,OAAO,SAAS,OACnB,OAAO,SAAS,QAAQ,EAAE,UAAU,EAAE,EAAE;GAG1C,IAAI,QACF,OAAO,SAAS,MAAM,QAAQ;GAGhC,SAAS,OAAO,SAAS;;;CAI7B,iBAA2B,MAA6B;EACtD,IAAI,KAAK,OAAO,KACd,MAAM,IAAI,YAAY,SAAS,KAAK,uBAAuB;EAG7D,MAAM,QAAQ,KAAK,YAAY,KAAK;EAEpC,IAAI,SAAS,KAAK;EAClB,IAAI;EACJ,MAAM,SAAiC,EAAE;EAEzC,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACrC,MAAM,OAAO,MAAM,GAAG,aAAa;GACnC,IAAI,OAAO,SAAS,OAAO;IACzB,IAAI,OAAO,UACT,WAAW,OAAO;IAEpB,SAAS,OAAO,SAAS;UACpB,IAAI,OAAO,OAAO;IACvB,IAAI,OAAO,UACT,WAAW,OAAO;IAEpB,OAAO,OAAO,MAAM,QAAQ,MAAM;IAClC,SAAS,OAAO;UACX,IAAI,OAAO,UAAU;IAC1B,OAAO,OAAO,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI;IACtC,OAAO;KAAE,OAAO,OAAO,SAAS;KAAO;KAAQ;UAE/C,OAAO;IAAE,OAAO,UAAU;IAAO;IAAQ;;EAI7C,IAAI,CAAC,QAAQ,OAAO;GAElB,IAAI,OAAO,UACT,OAAO;IAAE,OAAO,OAAO,SAAS;IAAO;IAAQ;GAGjD,OAAO;IAAE,OAAO,UAAU;IAAO;IAAQ;;EAG3C,OAAO;GAAE,OAAO,OAAO;GAAO;GAAQ;;CAGxC,UAAoB,OAAqC;EACvD,IAAI,MAAM,OAAO,aAAa,MAAM;QAC7B,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,MAAM,UAAU,EAC9D,IAAI,MAAM,OAAO,MAAM;IACrB,MAAM,OAAO,SAAS,MAAM,OAAO;IACnC,OAAO,MAAM,OAAO;;;EAK1B,OAAO;;CAGT,YAAsB,MAAwB;EAC5C,IAAI,WAAW,KAAK,MAAM,IAAI,CAAC,GAAG,WAAW,MAAM,IAAI;EAGvD,IAAI,SAAS,SAAS,IAAI,IAAI,SAAS,SAAS,GAC9C,WAAW,SAAS,MAAM,GAAG,GAAG;EAGlC,OAAO,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;ACnIvC,IAAa,sBAAb,MAAa,oBAAoB;CAC/B,OAA0B,cAAc;CAExC;CACA;CACA;CACA;CACA;CAEA,YAAY,UAAkB,YAAY,KAAK;EAC7C,IAAI,UAAU,WAAW,GACvB,MAAM,IAAI,YACR,kEAAkE,UAAU,GAC7E;EAEH,KAAK,WAAW;EAChB,KAAK,YAAY;EACjB,KAAK,aAAa,CAChB,GAAG,SAAS,SAAS,oBAAoB,YAAY,CACtD,CAAC,KAAK,MAAM,EAAE,GAAG;EAClB,KAAK,YAAY,KAAK,WAAW,SAAS;EAC1C,KAAK,eAAe,KAAK,YAAY,KAAK,mBAAmB,GAAG;;;;;;CAOlE,YAAY,QAAwC;EAClD,OAAO,KAAK,SAAS,QACnB,oBAAoB,cACnB,GAAG,SAAiB,OAAO,SAAS,IAAI,KAAK,GAC/C;;;;;;;;;CAUH,QAAQ,MAA6C;EACnD,IAAI,CAAC,KAAK,cACR,OAAO,SAAS,KAAK,WAAW,EAAE,GAAG;EAGvC,MAAM,QAAQ,KAAK,aAAa,KAAK,KAAK;EAC1C,IAAI,CAAC,OACH,OAAO;EAGT,MAAM,SAAiC,EAAE;EACzC,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,WAAW,QAAQ,KAC1C,OAAO,KAAK,WAAW,MAAM,MAAM,IAAI;EAEzC,OAAO;;;;;;CAOT,YAAY,WAAW,KAAa;EAClC,OAAO,KAAK,SAAS,QAAQ,oBAAoB,aAAa,SAAS;;;;;;CAOzE,UAAU,MAAsB;EAC9B,MAAM,MAAM,KAAK;EACjB,MAAM,aAAa,KAAK,YAAY,IAAI;EAExC,IAAI,SAAS,KAAK,QAAQ,IAAI,OAAO,GAAG,WAAW,OAAO,IAAI,EAAE,IAAI;EAEpE,IAAI,OAAO,SAAS,IAAI,IAAI,OAAO,SAAS,IAAI,QAC9C,SAAS,OAAO,MAAM,GAAG,CAAC,IAAI,OAAO;EAGvC,OAAO;;CAGT,oBAAsC;EACpC,MAAM,mBAAmB,KAAK,YAAY,KAAK,UAAU;EAEzD,MAAM,cAAc,KAAK,SACtB,QAAQ,wBAAwB,SAAS;GACxC,IAAI,SAAS,OAAO,SAAS,KAC3B,OAAO;GAET,OAAO,KAAK;IACZ,CACD,QAAQ,cAAc,MAAM,iBAAiB,KAAK;EAErD,OAAO,IAAI,OAAO,IAAI,YAAY,GAAG;;CAGvC,YAAsB,GAAmB;EACvC,OAAO,EAAE,QAAQ,uBAAuB,OAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n  protected maxCacheSize = 10_000;\n\n  public match(path: string): RouteMatch<T> {\n    const pathname = path.split(\"?\", 1)[0];\n    const hit = this.cache.get(pathname);\n    if (hit) {\n      return { route: hit.route, params: { ...hit.params } };\n    }\n    const result = this.mapParams(this.createRouteMatch(pathname));\n    if (this.cache.size >= this.maxCacheSize) this.cache.clear();\n    this.cache.set(pathname, result);\n    return { route: result.route, params: { ...result.params } };\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n    this.cache.clear();\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n","import { AlephaError } from \"alepha\";\n\n/**\n * Parses and manipulates templated paths with `{param}` placeholders.\n *\n * Used by both RouterProvider (HTTP routes) and TopicProvider (pub/sub topics)\n * to handle parameterized path templates in a unified way.\n *\n * @example\n * ```ts\n * const parser = new TemplatedPathParser(\"/users/{userId}/posts/{postId}\");\n * parser.interpolate({ userId: \"7\", postId: \"42\" }); // \"/users/7/posts/42\"\n * parser.extract(\"/users/7/posts/42\");               // { userId: \"7\", postId: \"42\" }\n * parser.wildcardize(\"+\");                           // \"/users/+/posts/+\"\n * ```\n *\n * @example\n * ```ts\n * // Redis-style colon-separated keys\n * const parser = new TemplatedPathParser(\"cache:{namespace}:{key}\", \":\");\n * parser.interpolate({ namespace: \"users\", key: \"42\" }); // \"cache:users:42\"\n * parser.wildcardize(\"*\");                               // \"cache:*:*\"\n * ```\n */\nexport class TemplatedPathParser {\n  protected static readonly PARAM_REGEX = /\\{([^}]+)\\}/g;\n\n  public readonly template: string;\n  public readonly separator: string;\n  public readonly paramNames: readonly string[];\n  public readonly hasParams: boolean;\n  protected readonly extractRegex: RegExp | null;\n\n  constructor(template: string, separator = \"/\") {\n    if (separator.length !== 1) {\n      throw new AlephaError(\n        `TemplatedPathParser separator must be a single character, got '${separator}'`,\n      );\n    }\n    this.template = template;\n    this.separator = separator;\n    this.paramNames = [\n      ...template.matchAll(TemplatedPathParser.PARAM_REGEX),\n    ].map((m) => m[1]);\n    this.hasParams = this.paramNames.length > 0;\n    this.extractRegex = this.hasParams ? this.buildExtractRegex() : null;\n  }\n\n  /**\n   * Replaces each `{param}` in the template with the corresponding value\n   * from the provided params record.\n   */\n  interpolate(params: Record<string, string>): string {\n    return this.template.replace(\n      TemplatedPathParser.PARAM_REGEX,\n      (_, name: string) => params[name] ?? `{${name}}`,\n    );\n  }\n\n  /**\n   * Extracts parameter values from a concrete path by matching it against\n   * the template structure.\n   *\n   * Returns `null` when the path does not match the template.\n   * Returns `{}` when the template has no parameters and the path matches.\n   */\n  extract(path: string): Record<string, string> | null {\n    if (!this.extractRegex) {\n      return path === this.template ? {} : null;\n    }\n\n    const match = this.extractRegex.exec(path);\n    if (!match) {\n      return null;\n    }\n\n    const result: Record<string, string> = {};\n    for (let i = 0; i < this.paramNames.length; i++) {\n      result[this.paramNames[i]] = match[i + 1];\n    }\n    return result;\n  }\n\n  /**\n   * Replaces each `{param}` placeholder in the template with the given\n   * wildcard string. Defaults to `\"+\"` (MQTT-style).\n   */\n  wildcardize(wildcard = \"+\"): string {\n    return this.template.replace(TemplatedPathParser.PARAM_REGEX, wildcard);\n  }\n\n  /**\n   * Normalises a path by collapsing repeated separators and stripping a\n   * trailing separator (unless the path is just the separator itself).\n   */\n  normalize(path: string): string {\n    const sep = this.separator;\n    const escapedSep = this.escapeRegex(sep);\n\n    let result = path.replace(new RegExp(`${escapedSep}{2,}`, \"g\"), sep);\n\n    if (result.endsWith(sep) && result.length > sep.length) {\n      result = result.slice(0, -sep.length);\n    }\n\n    return result;\n  }\n\n  protected buildExtractRegex(): RegExp {\n    const escapedSeparator = this.escapeRegex(this.separator);\n\n    const regexSource = this.template\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, (char) => {\n        if (char === \"{\" || char === \"}\") {\n          return char;\n        }\n        return `\\\\${char}`;\n      })\n      .replace(/\\{[^}]+\\}/g, `([^${escapedSeparator}]+)`);\n\n    return new RegExp(`^${regexSource}$`);\n  }\n\n  protected escapeRegex(s: string): string {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n}\n"],"mappings":";;AAEA,IAAsB,iBAAtB,MAA8D;CAC5D,iBAAmC;CAEnC,OAA0B,EAAE,UAAU,CAAC,EAAE;CACzC,wBAAkB,IAAI,IAA2B;CACjD,eAAyB;CAEzB,MAAa,MAA6B;EACxC,MAAM,WAAW,KAAK,MAAM,KAAK,CAAC,EAAE;EACpC,MAAM,MAAM,KAAK,MAAM,IAAI,QAAQ;EACnC,IAAI,KACF,OAAO;GAAE,OAAO,IAAI;GAAO,QAAQ,EAAE,GAAG,IAAI,OAAO;EAAE;EAEvD,MAAM,SAAS,KAAK,UAAU,KAAK,iBAAiB,QAAQ,CAAC;EAC7D,IAAI,KAAK,MAAM,QAAQ,KAAK,cAAc,KAAK,MAAM,MAAM;EAC3D,KAAK,MAAM,IAAI,UAAU,MAAM;EAC/B,OAAO;GAAE,OAAO,OAAO;GAAO,QAAQ,EAAE,GAAG,OAAO,OAAO;EAAE;CAC7D;CAEA,KAAe,MAAoB;EACjC,IAAI,CAAC,KAAK,eAAe,KAAK,IAAI,GAChC,MAAM,IAAI,YAAY,UAAU,KAAK,eAAe;CAExD;CAEA,KAAe,OAAgB;EAC7B,MAAM,OAAO,MAAM,KAAK,WAAW,MAAM,GAAG;EAE5C,KAAK,KAAK,IAAI;EACd,KAAK,MAAM,MAAM;EAEjB,MAAM,QAAQ,KAAK,YAAY,IAAI;EAEnC,IAAI,SAAS,KAAK;EAClB,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACrC,MAAM,SAAS,MAAM,MAAM,SAAS;GACpC,IAAI,OAAO,MAAM,GAAG,YAAY;GAChC,IAAI,SAAS,OAAO,QAAQ;IAC1B,OAAO,WAAW,EAAE,MAAM;IAC1B;GACF;GAEA,IAAI,KAAK,SAAS,GAAG,GACnB,MAAM,IAAI,YAAY,UAAU,KAAK,iCAAiC;GAGxE,IAAI,KAAK,SAAS,GAAG,KAAK,KAAK,SAAS,GAAG,GACzC,IAAI,KAAK,WAAW,GAAG,KAAK,KAAK,SAAS,GAAG,GAC3C,OAAO,IAAI,KAAK,MAAM,GAAG,EAAE;QAE3B,MAAM,IAAI,YAAY,UAAU,KAAK,8BAA8B;GAIvE,IAAI,KAAK,WAAW,GAAG,GAAG;IACxB,MAAM,OAAO,MAAM,GAAG,MAAM,CAAC,EAAE,WAAW,KAAK,EAAE;IACjD,IAAI,CAAC,MACH,MAAM,IAAI,YAAY,UAAU,KAAK,0BAA0B;IAEjE,IAAI,CAAC,OAAO,OACV,OAAO,QAAQ;KAAE;KAAM,UAAU,CAAC;IAAE;SAC/B,IAAI,OAAO,MAAM,SAAS,MAAM;KAGrC,MAAM,cAAc,CAAC;KACrB,MAAM,UAAU,OAAO,MAAM,QAAQ;IACvC;IAEA,IAAI,QACF,OAAO,MAAM,QAAQ;IAGvB,SAAS,OAAO;IAChB;GACF;GAEA,IAAI,CAAC,OAAO,SAAS,OACnB,OAAO,SAAS,QAAQ,EAAE,UAAU,CAAC,EAAE;GAGzC,IAAI,QACF,OAAO,SAAS,MAAM,QAAQ;GAGhC,SAAS,OAAO,SAAS;EAC3B;CACF;CAEA,iBAA2B,MAA6B;EACtD,IAAI,KAAK,OAAO,KACd,MAAM,IAAI,YAAY,SAAS,KAAK,sBAAsB;EAG5D,MAAM,QAAQ,KAAK,YAAY,IAAI;EAEnC,IAAI,SAAS,KAAK;EAClB,IAAI;EACJ,MAAM,SAAiC,CAAC;EAExC,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACrC,MAAM,OAAO,MAAM,GAAG,YAAY;GAClC,IAAI,OAAO,SAAS,OAAO;IACzB,IAAI,OAAO,UACT,WAAW,OAAO;IAEpB,SAAS,OAAO,SAAS;GAC3B,OAAO,IAAI,OAAO,OAAO;IACvB,IAAI,OAAO,UACT,WAAW,OAAO;IAEpB,OAAO,OAAO,MAAM,QAAQ,MAAM;IAClC,SAAS,OAAO;GAClB,OAAO,IAAI,OAAO,UAAU;IAC1B,OAAO,OAAO,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;IACrC,OAAO;KAAE,OAAO,OAAO,SAAS;KAAO;IAAO;GAChD,OACE,OAAO;IAAE,OAAO,UAAU;IAAO;GAAO;EAE5C;EAEA,IAAI,CAAC,QAAQ,OAAO;GAElB,IAAI,OAAO,UACT,OAAO;IAAE,OAAO,OAAO,SAAS;IAAO;GAAO;GAGhD,OAAO;IAAE,OAAO,UAAU;IAAO;GAAO;EAC1C;EAEA,OAAO;GAAE,OAAO,OAAO;GAAO;EAAO;CACvC;CAEA,UAAoB,OAAqC;EACvD,IAAI,MAAM,OAAO,aAAa,MAAM;QAC7B,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,MAAM,SAAS,GAC7D,IAAI,MAAM,OAAO,MAAM;IACrB,MAAM,OAAO,SAAS,MAAM,OAAO;IACnC,OAAO,MAAM,OAAO;GACtB;;EAIJ,OAAO;CACT;CAEA,YAAsB,MAAwB;EAC5C,IAAI,WAAW,KAAK,MAAM,GAAG,EAAE,GAAG,WAAW,MAAM,GAAG;EAGtD,IAAI,SAAS,SAAS,GAAG,KAAK,SAAS,SAAS,GAC9C,WAAW,SAAS,MAAM,GAAG,EAAE;EAGjC,OAAO,SAAS,MAAM,GAAG,EAAE,MAAM,CAAC;CACpC;AACF;;;;;;;;;;;;;;;;;;;;;;;;;ACrIA,IAAa,sBAAb,MAAa,oBAAoB;CAC/B,OAA0B,cAAc;CAExC;CACA;CACA;CACA;CACA;CAEA,YAAY,UAAkB,YAAY,KAAK;EAC7C,IAAI,UAAU,WAAW,GACvB,MAAM,IAAI,YACR,kEAAkE,UAAU,EAC9E;EAEF,KAAK,WAAW;EAChB,KAAK,YAAY;EACjB,KAAK,aAAa,CAChB,GAAG,SAAS,SAAS,oBAAoB,WAAW,CACtD,EAAE,KAAK,MAAM,EAAE,EAAE;EACjB,KAAK,YAAY,KAAK,WAAW,SAAS;EAC1C,KAAK,eAAe,KAAK,YAAY,KAAK,kBAAkB,IAAI;CAClE;;;;;CAMA,YAAY,QAAwC;EAClD,OAAO,KAAK,SAAS,QACnB,oBAAoB,cACnB,GAAG,SAAiB,OAAO,SAAS,IAAI,KAAK,EAChD;CACF;;;;;;;;CASA,QAAQ,MAA6C;EACnD,IAAI,CAAC,KAAK,cACR,OAAO,SAAS,KAAK,WAAW,CAAC,IAAI;EAGvC,MAAM,QAAQ,KAAK,aAAa,KAAK,IAAI;EACzC,IAAI,CAAC,OACH,OAAO;EAGT,MAAM,SAAiC,CAAC;EACxC,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,WAAW,QAAQ,KAC1C,OAAO,KAAK,WAAW,MAAM,MAAM,IAAI;EAEzC,OAAO;CACT;;;;;CAMA,YAAY,WAAW,KAAa;EAClC,OAAO,KAAK,SAAS,QAAQ,oBAAoB,aAAa,QAAQ;CACxE;;;;;CAMA,UAAU,MAAsB;EAC9B,MAAM,MAAM,KAAK;EACjB,MAAM,aAAa,KAAK,YAAY,GAAG;EAEvC,IAAI,SAAS,KAAK,QAAQ,IAAI,OAAO,GAAG,WAAW,OAAO,GAAG,GAAG,GAAG;EAEnE,IAAI,OAAO,SAAS,GAAG,KAAK,OAAO,SAAS,IAAI,QAC9C,SAAS,OAAO,MAAM,GAAG,CAAC,IAAI,MAAM;EAGtC,OAAO;CACT;CAEA,oBAAsC;EACpC,MAAM,mBAAmB,KAAK,YAAY,KAAK,SAAS;EAExD,MAAM,cAAc,KAAK,SACtB,QAAQ,wBAAwB,SAAS;GACxC,IAAI,SAAS,OAAO,SAAS,KAC3B,OAAO;GAET,OAAO,KAAK;EACd,CAAC,EACA,QAAQ,cAAc,MAAM,iBAAiB,IAAI;EAEpD,OAAO,IAAI,OAAO,IAAI,YAAY,EAAE;CACtC;CAEA,YAAsB,GAAmB;EACvC,OAAO,EAAE,QAAQ,uBAAuB,MAAM;CAChD;AACF"}

package/dist/scheduler/index.d.ts

@@ -1,8 +1,5 @@
-import * as _$alepha from "alepha";
 import { Alepha, Async, KIND, Primitive, Static } from "alepha";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
-import * as _$alepha_logger0 from "alepha/logger";
-import * as _$typebox from "typebox";
 
 //#region ../../src/scheduler/constants/CRON.d.ts
 declare const CRON: {
@@ -101,18 +98,18 @@ declare class Cron {
 declare class CronProvider {
   protected readonly dt: DateTimeProvider;
   protected readonly alepha: Alepha;
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly cronJobs: Array<CronJob>;
   getCronJobs(): Array<CronJob>;
-  protected readonly start: _$alepha.HookPrimitive<"start">;
-  protected readonly stop: _$alepha.HookPrimitive<"stop">;
+  protected readonly start: import("alepha").HookPrimitive<"start">;
+  protected readonly stop: import("alepha").HookPrimitive<"stop">;
   /**
    * Generic serverless cron trigger. Vercel's platform-emitted entry
    * point fires `serverless:cron` with the job name; we run the matching
    * job in-process. On long-running runtimes this listener is harmless
    * (no one fires the event).
    */
-  protected readonly onServerlessCron: _$alepha.HookPrimitive<"serverless:cron">;
+  protected readonly onServerlessCron: import("alepha").HookPrimitive<"serverless:cron">;
   protected boot(name: string | CronJob): void;
   abort(name: string | CronJob): void;
   /**
@@ -191,8 +188,8 @@ type SchedulerPrimitiveOptions = {
 /**
  * Scheduler configuration atom.
  */
-declare const schedulerOptions: _$alepha.Atom<_$typebox.TObject<{
-  prefix: _$typebox.TOptional<_$typebox.TString>;
+declare const schedulerOptions: import("alepha").Atom<import("typebox").TObject<{
+  prefix: import("typebox").TOptional<import("typebox").TString>;
 }>, "alepha.scheduler.options">;
 type SchedulerAtomOptions = Static<typeof schedulerOptions.schema>;
 declare module "alepha" {
@@ -201,7 +198,7 @@ declare module "alepha" {
   }
 }
 declare class SchedulerPrimitive extends Primitive<SchedulerPrimitiveOptions> {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly settings: Readonly<{
     prefix?: string | undefined;
   }>;
@@ -211,7 +208,7 @@ declare class SchedulerPrimitive extends Primitive<SchedulerPrimitiveOptions> {
   get name(): string;
   protected onInit(): void;
   trigger(): Promise<void>;
-  protected schedulerLock: _$alepha.PipelinePrimitiveFn<(args: SchedulerHandlerArguments) => Promise<void>>;
+  protected schedulerLock: import("alepha").PipelinePrimitiveFn<(args: SchedulerHandlerArguments) => Promise<void>>;
 }
 interface SchedulerHandlerArguments {
   now: DateTime;
@@ -262,7 +259,7 @@ declare class WorkerdCronProvider extends CronProvider {
   /**
    * Handle a scheduled event from Cloudflare Workers.
    */
-  protected readonly onScheduledEvent: _$alepha.HookPrimitive<"cloudflare:scheduled">;
+  protected readonly onScheduledEvent: import("alepha").HookPrimitive<"cloudflare:scheduled">;
 }
 //#endregion
 //#region ../../src/scheduler/index.d.ts
@@ -314,7 +311,7 @@ declare module "alepha" {
  *
  * @module alepha.scheduler
  */
-declare const AlephaScheduler: _$alepha.Service<_$alepha.Module>;
+declare const AlephaScheduler: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { $scheduler, AlephaScheduler, CRON, CronJob, CronProvider, SchedulerAtomOptions, SchedulerHandlerArguments, SchedulerPrimitive, SchedulerPrimitiveOptions, WorkerdCronProvider, schedulerOptions };
 //# sourceMappingURL=index.d.ts.map

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/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["seconds","Set","minutes","hours","days","months","weekdays","ReadonlyArray","reversed","constructor","ICronDefinition","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","Date","startDate","getNextDates","amount","getNextDatesIterator","endDate","Generator","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/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}