alepha 0.13.0 → 0.13.2

package/dist/queue-redis/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["t","QueueProvider","RedisProvider","job: QueueJob<T>","result: Record<string, string>","jobIds: string[]","jobs: QueueJob[]","stalledJobIds: string[]","alepha","QueueProvider","AlephaQueue"],"sources":["../../src/queue-redis/providers/RedisQueueProvider.ts","../../src/queue-redis/index.ts"],"sourcesContent":["import { $env, $hook, $inject, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  type QueueAcquiredJob,\n  type QueueCleanOptions,\n  type QueueGetJobsOptions,\n  type QueueJob,\n  type QueueJobCounts,\n  type QueueJobOptions,\n  type QueueJobStatus,\n  QueueProvider,\n} from \"alepha/queue\";\nimport { type RedisClient, RedisProvider } from \"alepha/redis\";\n\n// Default job options\nconst DEFAULT_MAX_ATTEMPTS = 1;\nconst DEFAULT_LOCK_DURATION = 30000; // 30 seconds\nconst DEFAULT_BACKOFF_DELAY = 1000; // 1 second\nconst DEFAULT_BACKOFF_MAX_DELAY = 30000; // 30 seconds\n\nconst envSchema = t.object({\n  REDIS_QUEUE_PREFIX: t.text({\n    default: \"queue\",\n  }),\n});\n\n// Lua script for atomic job acquisition\n// This script atomically:\n// 1. Gets the highest priority job from waiting ZSET\n// 2. Removes it from waiting\n// 3. Adds it to active SET\n// 4. Updates job state in HASH\n// Returns: job data as JSON string, or nil if no job available\nconst ACQUIRE_JOB_SCRIPT = `\nlocal waitingKey = KEYS[1]\nlocal activeKey = KEYS[2]\nlocal jobKeyPrefix = KEYS[3]\nlocal workerId = ARGV[1]\nlocal now = tonumber(ARGV[2])\nlocal lockDuration = tonumber(ARGV[3])\n\n-- Get highest priority job (lowest score)\nlocal jobs = redis.call('ZRANGE', waitingKey, 0, 0)\nif #jobs == 0 then\n  return nil\nend\n\nlocal jobId = jobs[1]\nlocal jobKey = jobKeyPrefix .. ':' .. jobId\n\n-- Remove from waiting (atomic check)\nlocal removed = redis.call('ZREM', waitingKey, jobId)\nif removed == 0 then\n  return nil\nend\n\n-- Get current job data\nlocal jobData = redis.call('HGETALL', jobKey)\nif #jobData == 0 then\n  return nil\nend\n\n-- Parse job data into table\nlocal job = {}\nfor i = 1, #jobData, 2 do\n  job[jobData[i]] = jobData[i + 1]\nend\n\n-- Parse current state\nlocal state = cjson.decode(job['state'])\nlocal options = cjson.decode(job['options'])\n\n-- Update state\nstate['status'] = 'active'\nstate['attempts'] = state['attempts'] + 1\nstate['lockedBy'] = workerId\nstate['lockedUntil'] = now + (options['lockDuration'] or lockDuration)\nstate['processedAt'] = now\n\n-- Save updated state\nredis.call('HSET', jobKey, 'state', cjson.encode(state))\n\n-- Add to active set\nredis.call('SADD', activeKey, jobId)\n\n-- Return job data\nreturn cjson.encode({\n  id = job['id'],\n  queue = job['queue'],\n  payload = cjson.decode(job['payload']),\n  options = options,\n  state = state\n})\n`;\n\n// Lua script for completing a job with removeOnComplete support\nconst COMPLETE_JOB_SCRIPT = `\nlocal jobKey = KEYS[1]\nlocal activeKey = KEYS[2]\nlocal completedKey = KEYS[3]\nlocal jobId = ARGV[1]\nlocal now = tonumber(ARGV[2])\nlocal result = ARGV[3]\n\n-- Get job data\nlocal jobData = redis.call('HGETALL', jobKey)\nif #jobData == 0 then\n  return nil\nend\n\n-- Parse job data\nlocal job = {}\nfor i = 1, #jobData, 2 do\n  job[jobData[i]] = jobData[i + 1]\nend\n\nlocal state = cjson.decode(job['state'])\nlocal options = cjson.decode(job['options'])\nlocal processedAt = state['processedAt'] or now\n\n-- Remove from active\nredis.call('SREM', activeKey, jobId)\n\n-- Update state\nstate['status'] = 'completed'\nstate['completedAt'] = now\nstate['result'] = result ~= '' and cjson.decode(result) or nil\nstate['lockedBy'] = nil\nstate['lockedUntil'] = nil\n\nlocal removeOnComplete = options['removeOnComplete']\n\nif removeOnComplete == true then\n  -- Remove job immediately\n  redis.call('DEL', jobKey)\n  return cjson.encode({ removed = true, duration = now - processedAt })\nelse\n  -- Update job state\n  redis.call('HSET', jobKey, 'state', cjson.encode(state))\n\n  -- Add to completed list (newest first)\n  redis.call('LPUSH', completedKey, jobId)\n\n  -- If removeOnComplete is a number, trim the list (0 means keep none)\n  if type(removeOnComplete) == 'number' and removeOnComplete >= 0 then\n    -- Get jobs to remove\n    local toRemove = redis.call('LRANGE', completedKey, removeOnComplete, -1)\n    for _, oldJobId in ipairs(toRemove) do\n      redis.call('DEL', jobKey:gsub(jobId, oldJobId))\n    end\n    redis.call('LTRIM', completedKey, 0, removeOnComplete - 1)\n  end\n\n  return cjson.encode({ removed = false, duration = now - processedAt })\nend\n`;\n\n// Lua script for failing a job with retry support\nconst FAIL_JOB_SCRIPT = `\nlocal jobKey = KEYS[1]\nlocal activeKey = KEYS[2]\nlocal delayedKey = KEYS[3]\nlocal failedKey = KEYS[4]\nlocal jobId = ARGV[1]\nlocal now = tonumber(ARGV[2])\nlocal errorMsg = ARGV[3]\nlocal stackTrace = ARGV[4]\nlocal backoffDelay = tonumber(ARGV[5])\n\n-- Get job data\nlocal jobData = redis.call('HGETALL', jobKey)\nif #jobData == 0 then\n  return nil\nend\n\n-- Parse job data\nlocal job = {}\nfor i = 1, #jobData, 2 do\n  job[jobData[i]] = jobData[i + 1]\nend\n\nlocal state = cjson.decode(job['state'])\nlocal options = cjson.decode(job['options'])\n\n-- Remove from active\nredis.call('SREM', activeKey, jobId)\n\nlocal maxAttempts = options['maxAttempts'] or 1\nlocal hasMoreAttempts = state['attempts'] < maxAttempts\n\nif hasMoreAttempts then\n  -- Schedule for retry\n  state['status'] = 'delayed'\n  state['availableAt'] = now + backoffDelay\n  state['error'] = errorMsg\n  state['stackTrace'] = stackTrace ~= '' and stackTrace or nil\n  state['lockedBy'] = nil\n  state['lockedUntil'] = nil\n\n  redis.call('HSET', jobKey, 'state', cjson.encode(state))\n  redis.call('ZADD', delayedKey, now + backoffDelay, jobId)\n\n  return cjson.encode({ status = 'retrying', delay = backoffDelay, attempt = state['attempts'] + 1 })\nelse\n  -- Permanently failed\n  state['status'] = 'failed'\n  state['failedAt'] = now\n  state['error'] = errorMsg\n  state['stackTrace'] = stackTrace ~= '' and stackTrace or nil\n  state['lockedBy'] = nil\n  state['lockedUntil'] = nil\n\n  local removeOnFail = options['removeOnFail']\n\n  if removeOnFail == true then\n    redis.call('DEL', jobKey)\n    return cjson.encode({ status = 'failed', removed = true, attempts = state['attempts'] })\n  else\n    redis.call('HSET', jobKey, 'state', cjson.encode(state))\n    redis.call('LPUSH', failedKey, jobId)\n\n    if type(removeOnFail) == 'number' and removeOnFail >= 0 then\n      local toRemove = redis.call('LRANGE', failedKey, removeOnFail, -1)\n      for _, oldJobId in ipairs(toRemove) do\n        redis.call('DEL', jobKey:gsub(jobId, oldJobId))\n      end\n      redis.call('LTRIM', failedKey, 0, removeOnFail - 1)\n    end\n\n    return cjson.encode({ status = 'failed', removed = false, attempts = state['attempts'] })\n  end\nend\n`;\n\n/**\n * Redis-based queue provider with full job support.\n *\n * Features:\n * - Atomic job acquisition using Lua scripts\n * - Blocking wait using Redis BZPOPMIN (no polling)\n * - Event emission for job lifecycle\n * - removeOnComplete/removeOnFail support\n *\n * Uses the following Redis data structures:\n * - HASH `{prefix}:job:{queue}:{id}` - Job data\n * - ZSET `{prefix}:waiting:{queue}` - Waiting jobs (score = priority)\n * - ZSET `{prefix}:delayed:{queue}` - Delayed jobs (score = availableAt timestamp)\n * - SET `{prefix}:active:{queue}` - Active jobs\n * - LIST `{prefix}:completed:{queue}` - Completed jobs (newest first)\n * - LIST `{prefix}:failed:{queue}` - Failed jobs (newest first)\n * - LIST `{prefix}:messages:{queue}` - Simple message queue (backward compat)\n * - LIST `{prefix}:notify:{queue}` - Notification list for blocking wait\n */\nexport class RedisQueueProvider extends QueueProvider {\n  protected readonly log = $logger();\n  protected readonly env: Static<typeof envSchema> = $env(envSchema);\n  protected readonly redisProvider: RedisProvider = $inject(RedisProvider);\n\n  // Dedicated connection for blocking operations\n  protected blockingClient: RedisClient | undefined;\n  protected shouldStop = false;\n\n  // Loaded Lua script SHAs\n  protected acquireJobSha: string | undefined;\n  protected completeJobSha: string | undefined;\n  protected failJobSha: string | undefined;\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      this.shouldStop = false;\n      this.blockingClient = this.redisProvider.duplicate();\n      await this.blockingClient.connect();\n\n      // Load Lua scripts\n      const redis = this.redisProvider.publisher;\n      const acquireSha = await redis.scriptLoad(ACQUIRE_JOB_SCRIPT);\n      const completeSha = await redis.scriptLoad(COMPLETE_JOB_SCRIPT);\n      const failSha = await redis.scriptLoad(FAIL_JOB_SCRIPT);\n      this.acquireJobSha = acquireSha.toString();\n      this.completeJobSha = completeSha.toString();\n      this.failJobSha = failSha.toString();\n    },\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: async () => {\n      this.shouldStop = true;\n      if (this.blockingClient?.isOpen) {\n        await this.blockingClient.close();\n      }\n    },\n  });\n\n  // ===========================================\n  // Key helpers\n  // ===========================================\n\n  protected key(type: string, queue: string, id?: string): string {\n    const base = `${this.env.REDIS_QUEUE_PREFIX}:${type}:${queue}`;\n    return id ? `${base}:${id}` : base;\n  }\n\n  protected messageKey(queue: string): string {\n    return `${this.env.REDIS_QUEUE_PREFIX}:${queue}`;\n  }\n\n  protected notifyKey(queue: string): string {\n    return `${this.env.REDIS_QUEUE_PREFIX}:notify:${queue}`;\n  }\n\n  // ===========================================\n  // Simple Message API (backward compatible)\n  // ===========================================\n\n  public async push(queue: string, message: string): Promise<void> {\n    await this.redisProvider.publisher.LPUSH(this.messageKey(queue), message);\n  }\n\n  public async pop(queue: string): Promise<string | undefined> {\n    const value = await this.redisProvider.publisher.RPOP(\n      this.messageKey(queue),\n    );\n    if (value == null) return undefined;\n    return String(value);\n  }\n\n  public async popBlocking(\n    queues: string[],\n    timeoutSeconds: number,\n  ): Promise<{ queue: string; message: string } | undefined> {\n    if (queues.length === 0 || !this.blockingClient) {\n      return undefined;\n    }\n\n    const prefixedQueues = queues.map((q) => this.messageKey(q));\n    const result = await this.blockingClient.BRPOP(\n      prefixedQueues,\n      timeoutSeconds,\n    );\n\n    if (result == null) return undefined;\n\n    const key = result.key.toString();\n    const prefixLength = this.env.REDIS_QUEUE_PREFIX.length + 1;\n    const queue = key.substring(prefixLength);\n\n    return { queue, message: result.element.toString() };\n  }\n\n  // ===========================================\n  // Job API Implementation\n  // ===========================================\n\n  protected async generateJobId(): Promise<string> {\n    const counter = await this.redisProvider.publisher.INCR(\n      `${this.env.REDIS_QUEUE_PREFIX}:job_counter`,\n    );\n    return `job_${counter}_${Date.now()}`;\n  }\n\n  protected serializeJob(job: QueueJob): Record<string, string> {\n    return {\n      id: job.id,\n      queue: job.queue,\n      payload: JSON.stringify(job.payload),\n      options: JSON.stringify(job.options),\n      state: JSON.stringify(job.state),\n    };\n  }\n\n  protected deserializeJob(data: Record<string, string>): QueueJob | undefined {\n    if (!data.id) return undefined;\n    return {\n      id: data.id,\n      queue: data.queue,\n      payload: JSON.parse(data.payload),\n      options: JSON.parse(data.options),\n      state: JSON.parse(data.state),\n    };\n  }\n\n  public async addJob<T>(\n    queue: string,\n    payload: T,\n    options?: QueueJobOptions,\n  ): Promise<QueueJob<T>> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n    const delay = options?.delay ?? 0;\n    const isDelayed = delay > 0;\n\n    const job: QueueJob<T> = {\n      id: await this.generateJobId(),\n      queue,\n      payload,\n      options: {\n        priority: options?.priority ?? 0,\n        delay: options?.delay ?? 0,\n        maxAttempts: options?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS,\n        backoff: options?.backoff,\n        lockDuration: options?.lockDuration ?? DEFAULT_LOCK_DURATION,\n        removeOnComplete: options?.removeOnComplete,\n        removeOnFail: options?.removeOnFail,\n      },\n      state: {\n        status: isDelayed ? \"delayed\" : \"waiting\",\n        attempts: 0,\n        createdAt: now,\n        availableAt: isDelayed ? now + delay : now,\n      },\n    };\n\n    // Store job data\n    await redis.HSET(this.key(\"job\", queue, job.id), this.serializeJob(job));\n\n    // Add to appropriate queue\n    if (isDelayed) {\n      await redis.ZADD(this.key(\"delayed\", queue), {\n        score: job.state.availableAt!,\n        value: job.id,\n      });\n    } else {\n      await redis.ZADD(this.key(\"waiting\", queue), {\n        score: job.options.priority ?? 0,\n        value: job.id,\n      });\n\n      // Notify blocking waiters by pushing to notify list\n      await redis.LPUSH(this.notifyKey(queue), job.id);\n    }\n\n    this.log.debug(`Added job ${job.id} to queue ${queue}`, {\n      status: job.state.status,\n      priority: job.options.priority,\n    });\n\n    // Emit waiting event\n    if (!isDelayed) {\n      await this.emit({\n        type: \"waiting\",\n        queue,\n        jobId: job.id,\n        timestamp: now,\n        job,\n      });\n    }\n\n    return job;\n  }\n\n  public async acquireJob(\n    queues: string[],\n    workerId: string,\n    timeoutSeconds: number,\n  ): Promise<QueueAcquiredJob | undefined> {\n    if (!this.blockingClient || this.shouldStop) {\n      return undefined;\n    }\n\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n    const endTime = now + timeoutSeconds * 1000;\n\n    while (Date.now() < endTime && !this.shouldStop) {\n      // Try to acquire a job from each queue using Lua script\n      for (const queue of queues) {\n        try {\n          const result = await redis.evalSha(this.acquireJobSha!, {\n            keys: [\n              this.key(\"waiting\", queue),\n              this.key(\"active\", queue),\n              this.key(\"job\", queue),\n            ],\n            arguments: [\n              workerId,\n              String(Date.now()),\n              String(DEFAULT_LOCK_DURATION),\n            ],\n          });\n\n          if (result) {\n            const job = JSON.parse(result as string) as QueueJob;\n\n            this.log.debug(`Worker ${workerId} acquired job ${job.id}`, {\n              queue,\n              attempt: job.state.attempts,\n            });\n\n            // Emit active event\n            await this.emit({\n              type: \"active\",\n              queue,\n              jobId: job.id,\n              timestamp: Date.now(),\n              workerId,\n              attempt: job.state.attempts,\n            });\n\n            return { queue, job };\n          }\n        } catch (error) {\n          // Script might fail if job data is corrupted, log and continue\n          this.log.warn(`Failed to acquire job from ${queue}`, error);\n        }\n      }\n\n      // No job found, wait for notification using BRPOP\n      // This blocks until a new job is added or timeout\n      const notifyKeys = queues.map((q) => this.notifyKey(q));\n      const remainingTimeout = Math.max(\n        1,\n        Math.ceil((endTime - Date.now()) / 1000),\n      );\n\n      try {\n        const notification = await this.blockingClient.BRPOP(\n          notifyKeys,\n          Math.min(remainingTimeout, 5), // Check every 5s max for shutdown\n        );\n\n        // If we got a notification, loop back to try acquiring\n        // The notification just signals that a job was added\n        if (notification) {\n        }\n      } catch {\n        // Blocking client closed during shutdown\n        if (this.shouldStop) {\n          return undefined;\n        }\n      }\n    }\n\n    return undefined;\n  }\n\n  protected bufferRecordToString(\n    record: Record<string, Buffer>,\n  ): Record<string, string> {\n    const result: Record<string, string> = {};\n    for (const [key, value] of Object.entries(record)) {\n      result[key] = value?.toString() ?? \"\";\n    }\n    return result;\n  }\n\n  public async completeJob(\n    queue: string,\n    jobId: string,\n    result?: unknown,\n  ): Promise<void> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n\n    try {\n      const luaResult = await redis.evalSha(this.completeJobSha!, {\n        keys: [\n          this.key(\"job\", queue, jobId),\n          this.key(\"active\", queue),\n          this.key(\"completed\", queue),\n        ],\n        arguments: [\n          jobId,\n          String(now),\n          result !== undefined ? JSON.stringify(result) : \"\",\n        ],\n      });\n\n      if (!luaResult) {\n        this.log.warn(`Attempted to complete unknown job ${jobId}`);\n        return;\n      }\n\n      const { removed, duration } = JSON.parse(luaResult as string);\n      this.log.debug(`Job ${jobId} completed${removed ? \" and removed\" : \"\"}`, {\n        queue,\n        result,\n      });\n\n      // Emit completed event\n      await this.emit({\n        type: \"completed\",\n        queue,\n        jobId,\n        timestamp: now,\n        result,\n        duration,\n      });\n    } catch (error) {\n      // Fallback to non-atomic completion if Lua fails\n      this.log.warn(`Lua completeJob failed, using fallback`, error);\n      await this.completeJobFallback(queue, jobId, result);\n    }\n  }\n\n  protected async completeJobFallback(\n    queue: string,\n    jobId: string,\n    result?: unknown,\n  ): Promise<void> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n\n    // Get job data\n    const jobData = await redis.HGETALL(this.key(\"job\", queue, jobId));\n    const job = this.deserializeJob(this.bufferRecordToString(jobData));\n    if (!job) {\n      this.log.warn(`Attempted to complete unknown job ${jobId}`);\n      return;\n    }\n\n    const duration = now - (job.state.processedAt ?? now);\n\n    // Remove from active\n    await redis.SREM(this.key(\"active\", queue), jobId);\n\n    // Update job state\n    job.state.status = \"completed\";\n    job.state.completedAt = now;\n    job.state.result = result;\n    job.state.lockedBy = undefined;\n    job.state.lockedUntil = undefined;\n\n    const removeOnComplete = job.options.removeOnComplete;\n    if (removeOnComplete === true) {\n      await redis.DEL(this.key(\"job\", queue, jobId));\n    } else {\n      await redis.HSET(this.key(\"job\", queue, jobId), {\n        state: JSON.stringify(job.state),\n      });\n      await redis.LPUSH(this.key(\"completed\", queue), jobId);\n\n      if (typeof removeOnComplete === \"number\" && removeOnComplete >= 0) {\n        await this.cleanJobs(queue, \"completed\", {\n          maxCount: removeOnComplete,\n        });\n      }\n    }\n\n    this.log.debug(`Job ${jobId} completed`, { queue });\n\n    // Emit completed event\n    await this.emit({\n      type: \"completed\",\n      queue,\n      jobId,\n      timestamp: now,\n      result,\n      duration,\n    });\n  }\n\n  public async failJob(\n    queue: string,\n    jobId: string,\n    error: string,\n    stackTrace?: string,\n  ): Promise<void> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n\n    // Get job to calculate backoff\n    const jobData = await redis.HGETALL(this.key(\"job\", queue, jobId));\n    const job = this.deserializeJob(this.bufferRecordToString(jobData));\n    if (!job) {\n      this.log.warn(`Attempted to fail unknown job ${jobId}`);\n      return;\n    }\n\n    const backoffDelay = this.calculateBackoff(job);\n\n    try {\n      const luaResult = await redis.evalSha(this.failJobSha!, {\n        keys: [\n          this.key(\"job\", queue, jobId),\n          this.key(\"active\", queue),\n          this.key(\"delayed\", queue),\n          this.key(\"failed\", queue),\n        ],\n        arguments: [\n          jobId,\n          String(now),\n          error,\n          stackTrace ?? \"\",\n          String(backoffDelay),\n        ],\n      });\n\n      if (!luaResult) {\n        this.log.warn(`Attempted to fail unknown job ${jobId}`);\n        return;\n      }\n\n      const result = JSON.parse(luaResult as string);\n\n      if (result.status === \"retrying\") {\n        this.log.debug(`Job ${jobId} failed, will retry in ${result.delay}ms`, {\n          queue,\n          attempt: job.state.attempts,\n          error,\n        });\n\n        // Emit retrying event\n        await this.emit({\n          type: \"retrying\",\n          queue,\n          jobId,\n          timestamp: now,\n          error,\n          attempt: result.attempt,\n          delay: result.delay,\n        });\n      } else {\n        this.log.debug(\n          `Job ${jobId} permanently failed${result.removed ? \" and removed\" : \"\"}`,\n          { queue, error },\n        );\n\n        // Emit failed event\n        await this.emit({\n          type: \"failed\",\n          queue,\n          jobId,\n          timestamp: now,\n          error,\n          stackTrace,\n          attempts: result.attempts,\n        });\n      }\n    } catch (luaError) {\n      // Fallback to non-atomic fail if Lua fails\n      this.log.warn(`Lua failJob failed, using fallback`, luaError);\n      await this.failJobFallback(queue, jobId, error, stackTrace);\n    }\n  }\n\n  protected async failJobFallback(\n    queue: string,\n    jobId: string,\n    error: string,\n    stackTrace?: string,\n  ): Promise<void> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n\n    const jobData = await redis.HGETALL(this.key(\"job\", queue, jobId));\n    const job = this.deserializeJob(this.bufferRecordToString(jobData));\n    if (!job) {\n      this.log.warn(`Attempted to fail unknown job ${jobId}`);\n      return;\n    }\n\n    // Remove from active\n    await redis.SREM(this.key(\"active\", queue), jobId);\n\n    const maxAttempts = job.options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n    const hasMoreAttempts = job.state.attempts < maxAttempts;\n\n    if (hasMoreAttempts) {\n      const backoffDelay = this.calculateBackoff(job);\n\n      job.state.status = \"delayed\";\n      job.state.availableAt = now + backoffDelay;\n      job.state.error = error;\n      job.state.stackTrace = stackTrace;\n      job.state.lockedBy = undefined;\n      job.state.lockedUntil = undefined;\n\n      await redis.HSET(this.key(\"job\", queue, jobId), {\n        state: JSON.stringify(job.state),\n      });\n      await redis.ZADD(this.key(\"delayed\", queue), {\n        score: job.state.availableAt,\n        value: jobId,\n      });\n\n      this.log.debug(`Job ${jobId} failed, will retry in ${backoffDelay}ms`, {\n        queue,\n        attempt: job.state.attempts,\n        maxAttempts,\n      });\n\n      // Emit retrying event\n      await this.emit({\n        type: \"retrying\",\n        queue,\n        jobId,\n        timestamp: now,\n        error,\n        attempt: job.state.attempts + 1,\n        delay: backoffDelay,\n      });\n    } else {\n      job.state.status = \"failed\";\n      job.state.failedAt = now;\n      job.state.error = error;\n      job.state.stackTrace = stackTrace;\n      job.state.lockedBy = undefined;\n      job.state.lockedUntil = undefined;\n\n      const removeOnFail = job.options.removeOnFail;\n      if (removeOnFail === true) {\n        await redis.DEL(this.key(\"job\", queue, jobId));\n      } else {\n        await redis.HSET(this.key(\"job\", queue, jobId), {\n          state: JSON.stringify(job.state),\n        });\n        await redis.LPUSH(this.key(\"failed\", queue), jobId);\n\n        if (typeof removeOnFail === \"number\" && removeOnFail >= 0) {\n          await this.cleanJobs(queue, \"failed\", { maxCount: removeOnFail });\n        }\n      }\n\n      this.log.debug(`Job ${jobId} permanently failed`, { queue });\n\n      // Emit failed event\n      await this.emit({\n        type: \"failed\",\n        queue,\n        jobId,\n        timestamp: now,\n        error,\n        stackTrace,\n        attempts: job.state.attempts,\n      });\n    }\n  }\n\n  protected calculateBackoff(job: QueueJob): number {\n    const backoff = job.options.backoff;\n    const attempt = job.state.attempts;\n\n    if (!backoff) return DEFAULT_BACKOFF_DELAY;\n\n    const baseDelay = backoff.delay ?? DEFAULT_BACKOFF_DELAY;\n    const maxDelay = backoff.maxDelay ?? DEFAULT_BACKOFF_MAX_DELAY;\n\n    if (backoff.type === \"fixed\") return baseDelay;\n\n    const exponentialDelay = baseDelay * 2 ** (attempt - 1);\n    return Math.min(exponentialDelay, maxDelay);\n  }\n\n  public async renewJobLock(\n    queue: string,\n    jobId: string,\n    workerId: string,\n  ): Promise<boolean> {\n    const redis = this.redisProvider.publisher;\n\n    const jobData = await redis.HGETALL(this.key(\"job\", queue, jobId));\n    const job = this.deserializeJob(this.bufferRecordToString(jobData));\n    if (!job || job.state.lockedBy !== workerId) {\n      return false;\n    }\n\n    job.state.lockedUntil =\n      Date.now() + (job.options.lockDuration ?? DEFAULT_LOCK_DURATION);\n    await redis.HSET(this.key(\"job\", queue, jobId), {\n      state: JSON.stringify(job.state),\n    });\n\n    return true;\n  }\n\n  public async getJob(\n    queue: string,\n    jobId: string,\n  ): Promise<QueueJob | undefined> {\n    const redis = this.redisProvider.publisher;\n    const jobData = await redis.HGETALL(this.key(\"job\", queue, jobId));\n    return this.deserializeJob(this.bufferRecordToString(jobData));\n  }\n\n  public async getJobs(\n    queue: string,\n    status: QueueJobStatus,\n    options?: QueueGetJobsOptions,\n  ): Promise<QueueJob[]> {\n    const redis = this.redisProvider.publisher;\n    const limit = options?.limit ?? 100;\n    const offset = options?.offset ?? 0;\n\n    let jobIds: string[];\n\n    switch (status) {\n      case \"waiting\": {\n        const results = await redis.ZRANGE(\n          this.key(\"waiting\", queue),\n          offset,\n          offset + limit - 1,\n        );\n        jobIds = results.map((r) => r.toString());\n        break;\n      }\n      case \"delayed\": {\n        const results = await redis.ZRANGE(\n          this.key(\"delayed\", queue),\n          offset,\n          offset + limit - 1,\n        );\n        jobIds = results.map((r) => r.toString());\n        break;\n      }\n      case \"active\": {\n        const results = await redis.SMEMBERS(this.key(\"active\", queue));\n        jobIds = results.map((r) => r.toString()).slice(offset, offset + limit);\n        break;\n      }\n      case \"completed\": {\n        const results = await redis.LRANGE(\n          this.key(\"completed\", queue),\n          offset,\n          offset + limit - 1,\n        );\n        jobIds = results.map((r) => r.toString());\n        break;\n      }\n      case \"failed\": {\n        const results = await redis.LRANGE(\n          this.key(\"failed\", queue),\n          offset,\n          offset + limit - 1,\n        );\n        jobIds = results.map((r) => r.toString());\n        break;\n      }\n      default:\n        jobIds = [];\n    }\n\n    const jobs: QueueJob[] = [];\n    for (const jobId of jobIds) {\n      const job = await this.getJob(queue, jobId);\n      if (job) jobs.push(job);\n    }\n\n    return jobs;\n  }\n\n  public async getJobCounts(queue: string): Promise<QueueJobCounts> {\n    const redis = this.redisProvider.publisher;\n\n    const [waiting, delayed, active, completed, failed] = await Promise.all([\n      redis.ZCARD(this.key(\"waiting\", queue)),\n      redis.ZCARD(this.key(\"delayed\", queue)),\n      redis.SCARD(this.key(\"active\", queue)),\n      redis.LLEN(this.key(\"completed\", queue)),\n      redis.LLEN(this.key(\"failed\", queue)),\n    ]);\n\n    return { waiting, delayed, active, completed, failed };\n  }\n\n  public async promoteDelayedJobs(queue: string): Promise<number> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n\n    // Get jobs whose availableAt has passed\n    const results = await redis.ZRANGEBYSCORE(\n      this.key(\"delayed\", queue),\n      \"-inf\",\n      now,\n    );\n\n    let promoted = 0;\n    for (const result of results) {\n      const jobId = result.toString();\n\n      // Remove from delayed\n      const removed = await redis.ZREM(this.key(\"delayed\", queue), jobId);\n      if (removed === 0) continue;\n\n      // Get and update job\n      const job = await this.getJob(queue, jobId);\n      if (!job) continue;\n\n      job.state.status = \"waiting\";\n      await redis.HSET(this.key(\"job\", queue, jobId), {\n        state: JSON.stringify(job.state),\n      });\n\n      // Add to waiting with priority score\n      await redis.ZADD(this.key(\"waiting\", queue), {\n        score: job.options.priority ?? 0,\n        value: jobId,\n      });\n\n      // Notify waiting workers\n      await redis.LPUSH(this.notifyKey(queue), jobId);\n\n      promoted++;\n      this.log.debug(`Promoted delayed job ${jobId}`, { queue });\n\n      // Emit waiting event\n      await this.emit({\n        type: \"waiting\",\n        queue,\n        jobId,\n        timestamp: now,\n        job,\n      });\n    }\n\n    return promoted;\n  }\n\n  public async recoverStalledJobs(\n    queue: string,\n    stalledThresholdMs: number,\n  ): Promise<string[]> {\n    const redis = this.redisProvider.publisher;\n    const now = Date.now();\n\n    const activeJobIds = await redis.SMEMBERS(this.key(\"active\", queue));\n    const stalledJobIds: string[] = [];\n\n    for (const result of activeJobIds) {\n      const jobId = result.toString();\n      const job = await this.getJob(queue, jobId);\n      if (!job) continue;\n\n      const lockExpired =\n        (job.state.lockedUntil ?? 0) + stalledThresholdMs < now;\n      if (!lockExpired) continue;\n\n      stalledJobIds.push(jobId);\n      const workerId = job.state.lockedBy;\n\n      // Remove from active\n      await redis.SREM(this.key(\"active\", queue), jobId);\n\n      const maxAttempts = job.options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n      const hasMoreAttempts = job.state.attempts < maxAttempts;\n\n      // Emit stalled event\n      await this.emit({\n        type: \"stalled\",\n        queue,\n        jobId,\n        timestamp: now,\n        workerId,\n        willRetry: hasMoreAttempts,\n      });\n\n      if (hasMoreAttempts) {\n        job.state.status = \"waiting\";\n        job.state.lockedBy = undefined;\n        job.state.lockedUntil = undefined;\n        job.state.error = \"Job stalled (worker timeout)\";\n\n        await redis.HSET(this.key(\"job\", queue, jobId), {\n          state: JSON.stringify(job.state),\n        });\n        await redis.ZADD(this.key(\"waiting\", queue), {\n          score: job.options.priority ?? 0,\n          value: jobId,\n        });\n\n        // Notify waiting workers\n        await redis.LPUSH(this.notifyKey(queue), jobId);\n\n        this.log.warn(`Recovered stalled job ${jobId}`, { queue });\n\n        // Emit waiting event\n        await this.emit({\n          type: \"waiting\",\n          queue,\n          jobId,\n          timestamp: now,\n          job,\n        });\n      } else {\n        job.state.status = \"failed\";\n        job.state.failedAt = now;\n        job.state.lockedBy = undefined;\n        job.state.lockedUntil = undefined;\n        job.state.error =\n          \"Job stalled (worker timeout) - max attempts exceeded\";\n\n        const removeOnFail = job.options.removeOnFail;\n        if (removeOnFail === true) {\n          await redis.DEL(this.key(\"job\", queue, jobId));\n        } else {\n          await redis.HSET(this.key(\"job\", queue, jobId), {\n            state: JSON.stringify(job.state),\n          });\n          await redis.LPUSH(this.key(\"failed\", queue), jobId);\n\n          if (typeof removeOnFail === \"number\" && removeOnFail >= 0) {\n            await this.cleanJobs(queue, \"failed\", { maxCount: removeOnFail });\n          }\n        }\n\n        this.log.warn(`Stalled job ${jobId} permanently failed`, { queue });\n\n        // Emit failed event\n        await this.emit({\n          type: \"failed\",\n          queue,\n          jobId,\n          timestamp: now,\n          error: job.state.error,\n          attempts: job.state.attempts,\n        });\n      }\n    }\n\n    return stalledJobIds;\n  }\n\n  public async cleanJobs(\n    queue: string,\n    status: \"completed\" | \"failed\",\n    options?: QueueCleanOptions,\n  ): Promise<number> {\n    const redis = this.redisProvider.publisher;\n    const listKey = this.key(status, queue);\n    const maxAge = options?.maxAge;\n    const maxCount = options?.maxCount;\n\n    let removed = 0;\n\n    // Remove by age\n    if (maxAge !== undefined) {\n      const now = Date.now();\n      const cutoff = now - maxAge;\n\n      const jobIds = await redis.LRANGE(listKey, 0, -1);\n      for (const result of jobIds) {\n        const jobId = result.toString();\n        const job = await this.getJob(queue, jobId);\n        if (!job) continue;\n\n        const timestamp =\n          status === \"completed\" ? job.state.completedAt : job.state.failedAt;\n\n        if (timestamp && timestamp < cutoff) {\n          await redis.LREM(listKey, 1, jobId);\n          await redis.DEL(this.key(\"job\", queue, jobId));\n          removed++;\n        }\n      }\n    }\n\n    // Remove by count\n    if (maxCount !== undefined) {\n      const currentLen = await redis.LLEN(listKey);\n      if (currentLen > maxCount) {\n        // Get jobs to remove (oldest ones)\n        const toRemove = await redis.LRANGE(listKey, maxCount, -1);\n        for (const result of toRemove) {\n          const jobId = result.toString();\n          await redis.DEL(this.key(\"job\", queue, jobId));\n          removed++;\n        }\n        // Trim the list\n        await redis.LTRIM(listKey, 0, maxCount - 1);\n      }\n    }\n\n    return removed;\n  }\n\n  public async removeJob(queue: string, jobId: string): Promise<void> {\n    const redis = this.redisProvider.publisher;\n    const job = await this.getJob(queue, jobId);\n    if (!job) return;\n\n    const previousStatus = job.state.status;\n\n    // Remove from appropriate list\n    switch (job.state.status) {\n      case \"waiting\":\n        await redis.ZREM(this.key(\"waiting\", queue), jobId);\n        break;\n      case \"delayed\":\n        await redis.ZREM(this.key(\"delayed\", queue), jobId);\n        break;\n      case \"active\":\n        await redis.SREM(this.key(\"active\", queue), jobId);\n        break;\n      case \"completed\":\n        await redis.LREM(this.key(\"completed\", queue), 1, jobId);\n        break;\n      case \"failed\":\n        await redis.LREM(this.key(\"failed\", queue), 1, jobId);\n        break;\n    }\n\n    // Delete job data\n    await redis.DEL(this.key(\"job\", queue, jobId));\n\n    // Emit removed event\n    await this.emit({\n      type: \"removed\",\n      queue,\n      jobId,\n      timestamp: Date.now(),\n      previousStatus,\n    });\n  }\n\n  public cancelWaiters(): void {\n    this.shouldStop = true;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaQueue, QueueProvider } from \"alepha/queue\";\nimport { RedisQueueProvider } from \"./providers/RedisQueueProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisQueueProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Queue that provides Redis queue capabilities.\n *\n * @see {@link RedisQueueProvider}\n * @module alepha.queue.redis\n */\nexport const AlephaQueueRedis = $module({\n  name: \"alepha.queue.redis\",\n  services: [RedisQueueProvider],\n  register: (alepha: Alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: QueueProvider,\n        use: RedisQueueProvider,\n      })\n      .with(AlephaQueue),\n});\n"],"mappings":"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"}

package/dist/queue-redis/index.d.cts

@@ -1,82 +0,0 @@
-import * as alepha1 from "alepha";
-import { Static } from "alepha";
-import * as alepha_logger0 from "alepha/logger";
-import { QueueAcquiredJob, QueueCleanOptions, QueueGetJobsOptions, QueueJob, QueueJobCounts, QueueJobOptions, QueueJobStatus, QueueProvider } from "alepha/queue";
-import { RedisClient, RedisProvider } from "alepha/redis";
-
-//#region src/queue-redis/providers/RedisQueueProvider.d.ts
-declare const envSchema: alepha1.TObject<{
-  REDIS_QUEUE_PREFIX: alepha1.TString;
-}>;
-/**
- * Redis-based queue provider with full job support.
- *
- * Features:
- * - Atomic job acquisition using Lua scripts
- * - Blocking wait using Redis BZPOPMIN (no polling)
- * - Event emission for job lifecycle
- * - removeOnComplete/removeOnFail support
- *
- * Uses the following Redis data structures:
- * - HASH `{prefix}:job:{queue}:{id}` - Job data
- * - ZSET `{prefix}:waiting:{queue}` - Waiting jobs (score = priority)
- * - ZSET `{prefix}:delayed:{queue}` - Delayed jobs (score = availableAt timestamp)
- * - SET `{prefix}:active:{queue}` - Active jobs
- * - LIST `{prefix}:completed:{queue}` - Completed jobs (newest first)
- * - LIST `{prefix}:failed:{queue}` - Failed jobs (newest first)
- * - LIST `{prefix}:messages:{queue}` - Simple message queue (backward compat)
- * - LIST `{prefix}:notify:{queue}` - Notification list for blocking wait
- */
-declare class RedisQueueProvider extends QueueProvider {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly env: Static<typeof envSchema>;
-  protected readonly redisProvider: RedisProvider;
-  protected blockingClient: RedisClient | undefined;
-  protected shouldStop: boolean;
-  protected acquireJobSha: string | undefined;
-  protected completeJobSha: string | undefined;
-  protected failJobSha: string | undefined;
-  protected readonly start: alepha1.HookDescriptor<"start">;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
-  protected key(type: string, queue: string, id?: string): string;
-  protected messageKey(queue: string): string;
-  protected notifyKey(queue: string): string;
-  push(queue: string, message: string): Promise<void>;
-  pop(queue: string): Promise<string | undefined>;
-  popBlocking(queues: string[], timeoutSeconds: number): Promise<{
-    queue: string;
-    message: string;
-  } | undefined>;
-  protected generateJobId(): Promise<string>;
-  protected serializeJob(job: QueueJob): Record<string, string>;
-  protected deserializeJob(data: Record<string, string>): QueueJob | undefined;
-  addJob<T>(queue: string, payload: T, options?: QueueJobOptions): Promise<QueueJob<T>>;
-  acquireJob(queues: string[], workerId: string, timeoutSeconds: number): Promise<QueueAcquiredJob | undefined>;
-  protected bufferRecordToString(record: Record<string, Buffer>): Record<string, string>;
-  completeJob(queue: string, jobId: string, result?: unknown): Promise<void>;
-  protected completeJobFallback(queue: string, jobId: string, result?: unknown): Promise<void>;
-  failJob(queue: string, jobId: string, error: string, stackTrace?: string): Promise<void>;
-  protected failJobFallback(queue: string, jobId: string, error: string, stackTrace?: string): Promise<void>;
-  protected calculateBackoff(job: QueueJob): number;
-  renewJobLock(queue: string, jobId: string, workerId: string): Promise<boolean>;
-  getJob(queue: string, jobId: string): Promise<QueueJob | undefined>;
-  getJobs(queue: string, status: QueueJobStatus, options?: QueueGetJobsOptions): Promise<QueueJob[]>;
-  getJobCounts(queue: string): Promise<QueueJobCounts>;
-  promoteDelayedJobs(queue: string): Promise<number>;
-  recoverStalledJobs(queue: string, stalledThresholdMs: number): Promise<string[]>;
-  cleanJobs(queue: string, status: "completed" | "failed", options?: QueueCleanOptions): Promise<number>;
-  removeJob(queue: string, jobId: string): Promise<void>;
-  cancelWaiters(): void;
-}
-//#endregion
-//#region src/queue-redis/index.d.ts
-/**
- * Plugin for Alepha Queue that provides Redis queue capabilities.
- *
- * @see {@link RedisQueueProvider}
- * @module alepha.queue.redis
- */
-declare const AlephaQueueRedis: alepha1.Service<alepha1.Module>;
-//#endregion
-export { AlephaQueueRedis, RedisQueueProvider };
-//# sourceMappingURL=index.d.cts.map

package/dist/redis/index.cjs

@@ -1,153 +0,0 @@
-let alepha = require("alepha");
-let __redis_client = require("@redis/client");
-let alepha_logger = require("alepha/logger");
-
-//#region src/redis/providers/RedisProvider.ts
-const envSchema = alepha.t.object({
-	REDIS_PORT: alepha.t.integer({ default: "6379" }),
-	REDIS_HOST: alepha.t.text({ default: "localhost" }),
-	REDIS_PASSWORD: alepha.t.optional(alepha.t.text())
-});
-/**
-* Redis client provider.
-*/
-var RedisProvider = class {
-	log = (0, alepha_logger.$logger)();
-	alepha = (0, alepha.$inject)(alepha.Alepha);
-	env = (0, alepha.$env)(envSchema);
-	client = this.createClient();
-	get publisher() {
-		if (!this.client.isReady) throw new Error("Redis client is not ready");
-		return this.client;
-	}
-	start = (0, alepha.$hook)({
-		on: "start",
-		handler: () => this.connect()
-	});
-	stop = (0, alepha.$hook)({
-		on: "stop",
-		handler: () => this.close()
-	});
-	/**
-	* Connect to the Redis server.
-	*/
-	async connect() {
-		this.log.debug("Connecting...");
-		await this.client.connect();
-		this.log.info("Connection OK");
-	}
-	/**
-	* Close the connection to the Redis server.
-	*/
-	async close() {
-		this.log.debug("Closing connection...");
-		await this.client.close();
-		this.log.info("Connection closed");
-	}
-	duplicate(options) {
-		return this.client.duplicate({
-			...options,
-			RESP: 3
-		}).withTypeMapping({ [__redis_client.RESP_TYPES.BLOB_STRING]: Buffer });
-	}
-	async get(key) {
-		this.log.trace(`Getting key ${key}`);
-		const resp = await this.publisher.get(key);
-		if (resp === null) return;
-		return Buffer.from(resp);
-	}
-	async set(key, value, options) {
-		const buf = Buffer.isBuffer(value) ? value : Buffer.from(value, "utf-8");
-		const resp = await this.publisher.set(key, buf, options);
-		if (resp === "OK" || !resp) return buf;
-		return Buffer.from(resp);
-	}
-	async has(key) {
-		return await this.publisher.exists(key) > 0;
-	}
-	async keys(pattern) {
-		return (await this.publisher.keys(pattern)).map((key) => key.toString());
-	}
-	async del(keys) {
-		if (keys.length === 0) return;
-		await this.publisher.del(keys);
-	}
-	/**
-	* Redis subscriber client factory method.
-	*/
-	createClient() {
-		const url = new URL("redis://127.0.0.1:6379");
-		if (this.env.REDIS_PASSWORD) url.password = this.env.REDIS_PASSWORD;
-		if (this.env.REDIS_HOST) url.hostname = this.env.REDIS_HOST;
-		if (this.env.REDIS_PORT) url.port = String(this.env.REDIS_PORT);
-		const client = (0, __redis_client.createClient)({
-			url: url.toString(),
-			RESP: 3
-		}).withTypeMapping({ [__redis_client.RESP_TYPES.BLOB_STRING]: Buffer });
-		client.on("error", (error) => {
-			if (this.alepha.isStarted()) this.log.error(error);
-		});
-		return client;
-	}
-};
-
-//#endregion
-//#region src/redis/providers/RedisSubscriberProvider.ts
-var RedisSubscriberProvider = class {
-	log = (0, alepha_logger.$logger)();
-	alepha = (0, alepha.$inject)(alepha.Alepha);
-	redisProvider = (0, alepha.$inject)(RedisProvider);
-	client = this.createClient();
-	get subscriber() {
-		if (!this.client.isReady) throw new Error("Redis client is not ready");
-		return this.client;
-	}
-	start = (0, alepha.$hook)({
-		on: "start",
-		handler: () => this.connect()
-	});
-	stop = (0, alepha.$hook)({
-		on: "stop",
-		handler: () => this.close()
-	});
-	async connect() {
-		this.log.debug("Connecting...");
-		await this.client.connect();
-		this.log.info("Connection OK");
-	}
-	async close() {
-		this.log.debug("Closing connection...");
-		this.subscriber.close();
-		this.log.info("Connection closed");
-	}
-	/**
-	* Redis subscriber client factory method.
-	*/
-	createClient() {
-		const client = this.redisProvider.duplicate();
-		client.on("error", (error) => {
-			if (this.alepha.isStarted()) this.log.error(error);
-		});
-		return client;
-	}
-};
-
-//#endregion
-//#region src/redis/index.ts
-/**
-* Redis client provider for Alepha applications.
-*
-* @see {@link RedisProvider}
-* @module alepha.redis
-*/
-const AlephaRedis = (0, alepha.$module)({
-	name: "alepha.redis",
-	services: [RedisProvider, RedisSubscriberProvider],
-	register: (alepha$1) => alepha$1.with(RedisProvider)
-});
-
-//#endregion
-exports.AlephaRedis = AlephaRedis;
-exports.RedisProvider = RedisProvider;
-exports.RedisSubscriberProvider = RedisSubscriberProvider;
-//# sourceMappingURL=index.cjs.map

package/dist/redis/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["t","Alepha","RESP_TYPES","Alepha","alepha"],"sources":["../../src/redis/providers/RedisProvider.ts","../../src/redis/providers/RedisSubscriberProvider.ts","../../src/redis/index.ts"],"sourcesContent":["import {\n  createClient,\n  RESP_TYPES,\n  type RedisClientType,\n  type SetOptions,\n} from \"@redis/client\";\nimport { $env, $hook, $inject, Alepha, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\n\nconst envSchema = t.object({\n  REDIS_PORT: t.integer({\n    default: \"6379\",\n  }),\n  REDIS_HOST: t.text({\n    default: \"localhost\",\n  }),\n  REDIS_PASSWORD: t.optional(t.text()),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\nexport type RedisClient = RedisClientType<\n  {},\n  {},\n  {},\n  3,\n  { 36: BufferConstructor }\n>;\nexport type RedisClientOptions = Parameters<typeof createClient>[0];\nexport type RedisSetOptions = SetOptions;\n\n/**\n * Redis client provider.\n */\nexport class 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(): RedisClient {\n    if (!this.client.isReady) {\n      throw new Error(\"Redis client is not ready\");\n    }\n\n    return this.client;\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 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 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<RedisClientOptions>): RedisClient {\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 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 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    const resp = await this.publisher.set(key, buf, options);\n\n    if (resp === \"OK\" || !resp) {\n      return buf;\n    }\n\n    return Buffer.from(resp);\n  }\n\n  public async has(key: string): Promise<boolean> {\n    const resp = await this.publisher.exists(key);\n    return resp > 0;\n  }\n\n  public 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 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   * Redis subscriber client factory method.\n   */\n  protected createClient(): RedisClient {\n    const url = new URL(\"redis://127.0.0.1:6379\");\n\n    if (this.env.REDIS_PASSWORD) {\n      url.password = this.env.REDIS_PASSWORD;\n    }\n\n    if (this.env.REDIS_HOST) {\n      url.hostname = this.env.REDIS_HOST;\n    }\n\n    if (this.env.REDIS_PORT) {\n      url.port = String(this.env.REDIS_PORT);\n    }\n\n    const client = createClient({\n      url: url.toString(),\n      RESP: 3,\n    }).withTypeMapping({\n      [RESP_TYPES.BLOB_STRING]: Buffer,\n    });\n\n    client.on(\"error\", (error) => {\n      if (this.alepha.isStarted()) {\n        this.log.error(error);\n      }\n    });\n\n    return client;\n  }\n}\n","import { $hook, $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { RedisClient } from \"./RedisProvider.ts\";\nimport { RedisProvider } from \"./RedisProvider.ts\";\n\nexport class RedisSubscriberProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider: RedisProvider = $inject(RedisProvider);\n  protected readonly client: RedisClient = this.createClient();\n\n  public get subscriber(): RedisClient {\n    if (!this.client.isReady) {\n      throw new Error(\"Redis client is not ready\");\n    }\n\n    return this.client;\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 async connect(): Promise<void> {\n    this.log.debug(\"Connecting...\");\n    await this.client.connect();\n    this.log.info(\"Connection OK\");\n  }\n\n  public async close(): Promise<void> {\n    this.log.debug(\"Closing connection...\");\n    this.subscriber.close();\n    this.log.info(\"Connection closed\");\n  }\n\n  /**\n   * Redis subscriber client factory method.\n   */\n  protected createClient(): RedisClient {\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 { RedisProvider } from \"./providers/RedisProvider.ts\";\nimport { RedisSubscriberProvider } from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisProvider.ts\";\nexport * from \"./providers/RedisSubscriberProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Redis client provider for Alepha applications.\n *\n * @see {@link RedisProvider}\n * @module alepha.redis\n */\nexport const AlephaRedis = $module({\n  name: \"alepha.redis\",\n  services: [RedisProvider, RedisSubscriberProvider],\n  register: (alepha: Alepha) => alepha.with(RedisProvider),\n});\n"],"mappings":"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"}

package/dist/redis/index.d.cts

@@ -1,82 +0,0 @@
-import * as alepha3 from "alepha";
-import { Alepha, Static } from "alepha";
-import * as alepha_logger0 from "alepha/logger";
-import { RedisClientType, SetOptions, createClient } from "@redis/client";
-
-//#region src/redis/providers/RedisProvider.d.ts
-declare const envSchema: alepha3.TObject<{
-  REDIS_PORT: alepha3.TInteger;
-  REDIS_HOST: alepha3.TString;
-  REDIS_PASSWORD: alepha3.TOptional<alepha3.TString>;
-}>;
-declare module "alepha" {
-  interface Env extends Partial<Static<typeof envSchema>> {}
-}
-type RedisClient = RedisClientType<{}, {}, {}, 3, {
-  36: BufferConstructor;
-}>;
-type RedisClientOptions = Parameters<typeof createClient>[0];
-type RedisSetOptions = SetOptions;
-/**
- * Redis client provider.
- */
-declare class RedisProvider {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly alepha: Alepha;
-  protected readonly env: {
-    REDIS_PASSWORD?: string | undefined;
-    REDIS_PORT: number;
-    REDIS_HOST: string;
-  };
-  protected readonly client: RedisClient;
-  get publisher(): RedisClient;
-  protected readonly start: alepha3.HookDescriptor<"start">;
-  protected readonly stop: alepha3.HookDescriptor<"stop">;
-  /**
-   * Connect to the Redis server.
-   */
-  connect(): Promise<void>;
-  /**
-   * Close the connection to the Redis server.
-   */
-  close(): Promise<void>;
-  duplicate(options?: Partial<RedisClientOptions>): RedisClient;
-  get(key: string): Promise<Buffer | undefined>;
-  set(key: string, value: Buffer | string, options?: RedisSetOptions): Promise<Buffer>;
-  has(key: string): Promise<boolean>;
-  keys(pattern: string): Promise<string[]>;
-  del(keys: string[]): Promise<void>;
-  /**
-   * Redis subscriber client factory method.
-   */
-  protected createClient(): RedisClient;
-}
-//#endregion
-//#region src/redis/providers/RedisSubscriberProvider.d.ts
-declare class RedisSubscriberProvider {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly alepha: Alepha;
-  protected readonly redisProvider: RedisProvider;
-  protected readonly client: RedisClient;
-  get subscriber(): RedisClient;
-  protected readonly start: alepha3.HookDescriptor<"start">;
-  protected readonly stop: alepha3.HookDescriptor<"stop">;
-  connect(): Promise<void>;
-  close(): Promise<void>;
-  /**
-   * Redis subscriber client factory method.
-   */
-  protected createClient(): RedisClient;
-}
-//#endregion
-//#region src/redis/index.d.ts
-/**
- * Redis client provider for Alepha applications.
- *
- * @see {@link RedisProvider}
- * @module alepha.redis
- */
-declare const AlephaRedis: alepha3.Service<alepha3.Module>;
-//#endregion
-export { AlephaRedis, RedisClient, RedisClientOptions, RedisProvider, RedisSetOptions, RedisSubscriberProvider };
-//# sourceMappingURL=index.d.cts.map

package/dist/retry/index.cjs

@@ -1,146 +0,0 @@
-let alepha = require("alepha");
-let alepha_datetime = require("alepha/datetime");
-let alepha_logger = require("alepha/logger");
-
-//#region src/retry/errors/RetryCancelError.ts
-var RetryCancelError = class extends alepha.AlephaError {
-	constructor() {
-		super("Retry operation was cancelled.");
-		this.name = "RetryCancelError";
-	}
-};
-
-//#endregion
-//#region src/retry/errors/RetryTimeoutError.ts
-var RetryTimeoutError = class extends alepha.AlephaError {
-	constructor(duration) {
-		super(`Retry operation timed out after ${duration}ms.`);
-		this.name = "RetryTimeoutError";
-	}
-};
-
-//#endregion
-//#region src/retry/providers/RetryProvider.ts
-/**
-* Service for executing functions with automatic retry logic.
-* Supports exponential backoff, max duration, conditional retries, and cancellation.
-*/
-var RetryProvider = class {
-	log = (0, alepha_logger.$logger)();
-	dateTime = (0, alepha.$inject)(alepha_datetime.DateTimeProvider);
-	/**
-	* Execute a function with automatic retry logic.
-	*/
-	async retry(options, ...args) {
-		const maxAttempts = options.max ?? 3;
-		const when = options.when ?? (() => true);
-		const { handler, onError } = options;
-		let lastError;
-		const startTime = Date.now();
-		const maxDurationMs = options.maxDuration ? this.dateTime.duration(options.maxDuration).asMilliseconds() : Infinity;
-		const signals = [options.signal, options.additionalSignal].filter(Boolean);
-		const onAbort = () => {
-			lastError = new RetryCancelError();
-		};
-		for (const signal of signals) signal?.addEventListener("abort", onAbort);
-		const waitSignals = [options.signal, options.additionalSignal].filter(Boolean);
-		const combinedSignal = waitSignals.length > 0 ? AbortSignal.any(waitSignals) : void 0;
-		try {
-			for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-				if (signals.some((signal) => signal?.aborted)) throw new RetryCancelError();
-				if (Date.now() - startTime >= maxDurationMs) throw new RetryTimeoutError(maxDurationMs);
-				try {
-					const result = await handler(...args);
-					if (Date.now() - startTime >= maxDurationMs) throw new RetryTimeoutError(maxDurationMs);
-					return result;
-				} catch (err) {
-					lastError = err;
-					if (Date.now() - startTime >= maxDurationMs) throw new RetryTimeoutError(maxDurationMs);
-					this.log.warn("Retry attempt failed", {
-						attempt,
-						maxAttempts,
-						remainingAttempts: maxAttempts - attempt,
-						error: lastError.message,
-						errorName: lastError.name
-					});
-					if (!(err instanceof Error) || !when(err)) throw err;
-					if (onError) onError(err, attempt, ...args);
-					if (attempt >= maxAttempts) break;
-					const delay = this.calculateBackoff(attempt, options.backoff);
-					if (delay > 0) await this.dateTime.wait(delay, { signal: combinedSignal });
-					if (Date.now() - startTime >= maxDurationMs) throw new RetryTimeoutError(maxDurationMs);
-				}
-			}
-		} finally {
-			for (const signal of signals) signal?.removeEventListener("abort", onAbort);
-		}
-		throw lastError;
-	}
-	/**
-	* Calculate the backoff delay for a given attempt.
-	*/
-	calculateBackoff(attempt, options) {
-		if (typeof options === "number") return options;
-		const initial = options?.initial ?? 200;
-		const factor = options?.factor ?? 2;
-		const max = options?.max ?? 1e4;
-		const useJitter = options?.jitter !== false;
-		const exponential = initial * factor ** (attempt - 1);
-		let delay = Math.min(exponential, max);
-		if (useJitter) delay = delay * (1 + Math.random() * .5);
-		return Math.floor(delay);
-	}
-};
-
-//#endregion
-//#region src/retry/descriptors/$retry.ts
-/**
-* Creates a function that automatically retries a handler upon failure,
-* with support for exponential backoff, max duration, and cancellation.
-*/
-const $retry = (options) => {
-	const instance = (0, alepha.createDescriptor)(RetryDescriptor, options);
-	const fn = (...args) => instance.run(...args);
-	return Object.setPrototypeOf(fn, instance);
-};
-var RetryDescriptor = class extends alepha.Descriptor {
-	retryProvider = (0, alepha.$inject)(RetryProvider);
-	appAbortController;
-	constructor(args) {
-		super(args);
-		this.appAbortController = new AbortController();
-		this.alepha.events.on("stop", () => {
-			this.appAbortController.abort();
-		});
-	}
-	async run(...args) {
-		return this.retryProvider.retry({
-			...this.options,
-			additionalSignal: this.appAbortController.signal
-		}, ...args);
-	}
-};
-$retry[alepha.KIND] = RetryDescriptor;
-
-//#endregion
-//#region src/retry/index.ts
-/**
-* Retry mechanism provider for Alepha applications.
-*
-* @see {@link RetryProvider}
-* @module alepha.retry
-*/
-const AlephaRetry = (0, alepha.$module)({
-	name: "alepha.retry",
-	descriptors: [$retry],
-	services: [RetryProvider]
-});
-
-//#endregion
-exports.$retry = $retry;
-exports.AlephaRetry = AlephaRetry;
-exports.RetryCancelError = RetryCancelError;
-exports.RetryDescriptor = RetryDescriptor;
-exports.RetryProvider = RetryProvider;
-exports.RetryTimeoutError = RetryTimeoutError;
-//# sourceMappingURL=index.cjs.map

package/dist/retry/index.cjs.map

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