@lssm/lib.jobs 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/dist/queue/scaleway-sqs-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleway-sqs-queue.js","names":["envelope: RawJobEnvelope<TPayload>","envelope: RawJobEnvelope","job: Job"],"sources":["../../src/queue/scaleway-sqs-queue.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport {\n  DeleteMessageCommand,\n  ReceiveMessageCommand,\n  SendMessageCommand,\n  SQSClient,\n} from '@aws-sdk/client-sqs';\nimport type { Logger } from '@lssm/lib.logger';\nimport { DEFAULT_RETRY_POLICY } from './types';\nimport type { EnqueueOptions, Job, JobHandler, JobQueue } from './types';\n\nexport interface ScalewaySqsQueueCredentials {\n  accessKeyId: string;\n  secretAccessKey: string;\n}\n\nexport interface ScalewaySqsQueueConfig {\n  queueUrl: string;\n  region?: string;\n  endpoint?: string;\n  waitTimeSeconds?: number;\n  maxNumberOfMessages?: number;\n  visibilityTimeoutSeconds?: number;\n  credentials?: ScalewaySqsQueueCredentials;\n  logger?: Logger;\n}\n\ninterface RawJobEnvelope<TPayload = unknown> {\n  id: string;\n  type: string;\n  payload: TPayload;\n}\n\nexport class ScalewaySqsJobQueue implements JobQueue {\n  private readonly sqs: SQSClient;\n  private readonly queueUrl: string;\n  private readonly waitTimeSeconds: number;\n  private readonly maxNumberOfMessages: number;\n  private readonly visibilityTimeoutSeconds: number;\n  private readonly handlers = new Map<string, JobHandler>();\n  private readonly logger?: Logger;\n  private running = false;\n\n  constructor(config: ScalewaySqsQueueConfig) {\n    this.logger = config.logger;\n\n    const accessKeyId =\n      config.credentials?.accessKeyId ?? process.env.SCALEWAY_ACCESS_KEY_QUEUE;\n    const secretAccessKey =\n      config.credentials?.secretAccessKey ??\n      process.env.SCALEWAY_SECRET_KEY_QUEUE;\n\n    if (!accessKeyId || !secretAccessKey) {\n      throw new Error(\n        'Missing SCALEWAY_ACCESS_KEY_QUEUE / SCALEWAY_SECRET_KEY_QUEUE in env'\n      );\n    }\n\n    const region = config.region ?? process.env.SCALEWAY_REGION ?? 'par';\n    const endpoint = config.endpoint ?? 'https://sqs.mnq.fr-par.scaleway.com';\n\n    this.sqs = new SQSClient({\n      region,\n      endpoint,\n      credentials: {\n        accessKeyId,\n        secretAccessKey,\n      },\n    });\n\n    this.queueUrl = config.queueUrl;\n    this.waitTimeSeconds = config.waitTimeSeconds ?? 20;\n    this.maxNumberOfMessages = config.maxNumberOfMessages ?? 5;\n    this.visibilityTimeoutSeconds = config.visibilityTimeoutSeconds ?? 60;\n  }\n\n  async enqueue<TPayload>(\n    jobType: string,\n    payload: TPayload,\n    options: EnqueueOptions = {}\n  ): Promise<Job<TPayload>> {\n    const id = randomUUID();\n    const now = new Date();\n    const scheduledAt = options.delaySeconds\n      ? new Date(now.getTime() + options.delaySeconds * 1000)\n      : now;\n\n    const envelope: RawJobEnvelope<TPayload> = {\n      id,\n      type: jobType,\n      payload,\n    };\n\n    await this.sqs.send(\n      new SendMessageCommand({\n        QueueUrl: this.queueUrl,\n        MessageBody: JSON.stringify(envelope),\n        DelaySeconds: options.delaySeconds ?? 0,\n        // If you use FIFO queues later, you'd set MessageGroupId / MessageDeduplicationId here.\n      })\n    );\n\n    return {\n      id,\n      type: jobType,\n      version: 1,\n      payload,\n      status: 'pending',\n      priority: options.priority ?? 0,\n      attempts: 0,\n      maxRetries: options.maxRetries ?? DEFAULT_RETRY_POLICY.maxRetries,\n      createdAt: now,\n      updatedAt: now,\n      scheduledAt,\n      dedupeKey: options.dedupeKey,\n      tenantId: options.tenantId,\n      userId: options.userId,\n      traceId: options.traceId,\n      metadata: options.metadata,\n    };\n  }\n\n  register<TPayload, TResult = void>(\n    jobType: string,\n    handler: JobHandler<TPayload, TResult>\n  ): void {\n    if (this.handlers.has(jobType)) {\n      throw new Error(`Handler already registered for job type \"${jobType}\"`);\n    }\n    this.handlers.set(jobType, handler as JobHandler);\n  }\n\n  start(): void {\n    if (this.running) return;\n    this.running = true;\n    void this.pollLoop().catch((error) => {\n      this.logger?.error?.('jobs.queue.scaleway_sqs.poll_loop_fatal', {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      this.running = false;\n    });\n  }\n\n  async stop(): Promise<void> {\n    this.running = false;\n    // Worst-case we wait for the current ReceiveMessage to finish (<= waitTimeSeconds)\n  }\n\n  private async pollLoop(): Promise<void> {\n    this.logger?.info?.('jobs.queue.scaleway_sqs.started', {\n      queueUrl: this.queueUrl,\n    });\n\n    while (this.running) {\n      try {\n        const res = await this.sqs.send(\n          new ReceiveMessageCommand({\n            QueueUrl: this.queueUrl,\n            MaxNumberOfMessages: this.maxNumberOfMessages,\n            WaitTimeSeconds: this.waitTimeSeconds,\n            VisibilityTimeout: this.visibilityTimeoutSeconds,\n            MessageSystemAttributeNames: ['ApproximateReceiveCount'],\n          })\n        );\n\n        const messages = res.Messages ?? [];\n\n        if (messages.length === 0) {\n          continue;\n        }\n\n        for (const msg of messages) {\n          if (!msg.Body || !msg.ReceiptHandle) {\n            this.logger?.warn?.('jobs.queue.scaleway_sqs.invalid_message', {\n              messageId: msg.MessageId,\n              reason: 'missing_body_or_receipt',\n            });\n            continue;\n          }\n\n          let envelope: RawJobEnvelope;\n\n          try {\n            envelope = JSON.parse(msg.Body) as RawJobEnvelope;\n          } catch (err) {\n            this.logger?.warn?.('jobs.queue.scaleway_sqs.parse_failed', {\n              messageId: msg.MessageId,\n              error: err instanceof Error ? err.message : String(err),\n            });\n            await this.deleteMessage(msg.ReceiptHandle);\n            continue;\n          }\n\n          const handler = this.handlers.get(envelope.type);\n          if (!handler) {\n            this.logger?.warn?.('jobs.queue.scaleway_sqs.missing_handler', {\n              jobType: envelope.type,\n              messageId: msg.MessageId,\n            });\n            await this.deleteMessage(msg.ReceiptHandle);\n            continue;\n          }\n\n          const now = new Date();\n          const attempts = parseInt(\n            (msg.Attributes?.ApproximateReceiveCount as string | undefined) ??\n              '1',\n            10\n          );\n\n          const job: Job = {\n            id: envelope.id,\n            type: envelope.type,\n            version: 1,\n            payload: envelope.payload,\n            status: 'pending',\n            priority: 0,\n            attempts,\n            maxRetries: DEFAULT_RETRY_POLICY.maxRetries,\n            createdAt: now,\n            updatedAt: now,\n          };\n\n          job.status = 'running';\n          job.updatedAt = new Date();\n\n          try {\n            await handler(job);\n            job.status = 'completed';\n            job.updatedAt = new Date();\n            await this.deleteMessage(msg.ReceiptHandle);\n          } catch (err) {\n            job.status = 'failed';\n            job.lastError =\n              err instanceof Error ? err.message : 'Unknown job error';\n            job.updatedAt = new Date();\n\n            this.logger?.error?.('jobs.queue.scaleway_sqs.job_failed', {\n              jobType: job.type,\n              jobId: job.id,\n              error: err instanceof Error ? err.message : String(err),\n            });\n            // Do NOT delete message on failure:\n            // - SQS/Scaleway will redeliver until MaxReceiveCount, then DLQ takes over.\n          }\n        }\n      } catch (err) {\n        this.logger?.error?.('jobs.queue.scaleway_sqs.poll_error', {\n          error: err instanceof Error ? err.message : String(err),\n        });\n        await this.sleep(5000);\n      }\n    }\n\n    this.logger?.info?.('jobs.queue.scaleway_sqs.stopped', {\n      queueUrl: this.queueUrl,\n    });\n  }\n\n  private async deleteMessage(receiptHandle: string): Promise<void> {\n    try {\n      await this.sqs.send(\n        new DeleteMessageCommand({\n          QueueUrl: this.queueUrl,\n          ReceiptHandle: receiptHandle,\n        })\n      );\n    } catch (err) {\n      this.logger?.warn?.('jobs.queue.scaleway_sqs.delete_failed', {\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  private async sleep(ms: number): Promise<void> {\n    await new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"],"mappings":"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"}

package/dist/queue/types.d.ts

@@ -2,6 +2,7 @@ export * from "@lssm/lib.contracts/jobs/queue";
 
 //#region src/queue/types.d.ts
 
-import * as import___lssm_lib_contracts_jobs_queue from "@lssm/lib.contracts/jobs/queue";
+import * as import__lssm_lib_contracts_jobs_queue from "@lssm/lib.contracts/jobs/queue";
 //#endregion
-export { import___lssm_lib_contracts_jobs_queue as types_d_exports };
+export { import__lssm_lib_contracts_jobs_queue as types_d_exports };
+//# sourceMappingURL=types.d.ts.map

package/dist/queue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/queue/types.ts"],"sourcesContent":[],"mappings":""}

package/dist/scheduler/index.d.ts

@@ -89,4 +89,5 @@ declare function createScheduler(queue: types_d_exports.JobQueue, options?: {
  */
 declare function defineSchedule(config: ScheduledJobConfig): ScheduledJobConfig;
 //#endregion
-export { ActiveSchedule, JobScheduler, ScheduledJobConfig, createScheduler, defineSchedule };
+export { ActiveSchedule, JobScheduler, ScheduledJobConfig, createScheduler, defineSchedule };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/scheduler/index.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAsBiB,UAtBA,kBAAA,CAsBe;EACrB;EACA,IAAA,EAAA,MAAA;EAF6B;EAAkB,cAAA,EAAA,MAAA;EA8D7C;EAMe,OAAA,EAAA,MAAA;EAST;EA8CD,OAAA,CAAA,EAAA,OAAA,GAAA,CAAA,GAAA,GAAA,OAAA,GAzIqB,OAyIrB,CAAA,OAAA,CAAA,CAAA;EAOW;EAAc,OAAA,CAAA,EA9I/B,eAAA,CAAA,cA8I+B;EAkE3B;EAUA,QAAA,CAAA,EAAA,MAAc;;;;;;;;;UA9Mb,cAAA,SAAuB;WAC7B;WACA;;;;;cA4DE,YAAA;;;;;qBAMe,eAAA,CAAA;;;;;;mBAST;;;;;;;;;;;;;;;;kBA8CD;;;;6BAOW;;;;;;;;;;;;;;;;;iBAkEb,eAAA,QACP,eAAA,CAAA;;IAEN;;;;iBAOa,cAAA,SAAuB,qBAAqB"}

package/dist/scheduler/index.js

@@ -142,4 +142,5 @@ function defineSchedule(config) {
 }
 
 //#endregion
-export { JobScheduler, createScheduler, defineSchedule };
+export { JobScheduler, createScheduler, defineSchedule };
+//# sourceMappingURL=index.js.map

package/dist/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["queue: JobQueue"],"sources":["../../src/scheduler/index.ts"],"sourcesContent":["import type { JobQueue, EnqueueOptions } from '../queue/types';\n\n/**\n * Scheduled job configuration.\n */\nexport interface ScheduledJobConfig {\n  /** Unique name for the schedule */\n  name: string;\n  /** Cron expression (e.g., '0 0 * * *' for daily at midnight) */\n  cronExpression: string;\n  /** Job type to enqueue */\n  jobType: string;\n  /** Job payload (can be a function for dynamic payloads) */\n  payload?: unknown | (() => unknown | Promise<unknown>);\n  /** Enqueue options */\n  options?: EnqueueOptions;\n  /** Timezone for cron evaluation (default: UTC) */\n  timezone?: string;\n  /** Whether the schedule is enabled */\n  enabled?: boolean;\n  /** Description */\n  description?: string;\n}\n\n/**\n * Active scheduled job with next run time.\n */\nexport interface ActiveSchedule extends ScheduledJobConfig {\n  nextRun: Date | null;\n  lastRun: Date | null;\n}\n\n/**\n * Parse a cron expression to get the next run time.\n * Simple implementation supporting: minute hour day month weekday\n */\nfunction getNextCronRun(\n  cronExpression: string,\n  after: Date = new Date()\n): Date | null {\n  try {\n    // Dynamically import cron-parser\n    // This is a simplified fallback if cron-parser isn't available\n    const parts = cronExpression.trim().split(/\\s+/);\n    if (parts.length !== 5) {\n      console.warn(`Invalid cron expression: ${cronExpression}`);\n      return null;\n    }\n\n    // Simple parsing for common patterns\n    const minute = parts[0];\n    const hour = parts[1];\n    const dayOfMonth = parts[2];\n    const month = parts[3];\n    const next = new Date(after);\n    next.setSeconds(0);\n    next.setMilliseconds(0);\n\n    // Handle simple cases\n    if (\n      minute &&\n      hour &&\n      minute !== '*' &&\n      hour !== '*' &&\n      dayOfMonth === '*' &&\n      month === '*'\n    ) {\n      // Daily at specific time\n      const targetMinute = Number.parseInt(minute, 10);\n      const targetHour = Number.parseInt(hour, 10);\n\n      next.setHours(targetHour, targetMinute, 0, 0);\n      if (next <= after) {\n        next.setDate(next.getDate() + 1);\n      }\n      return next;\n    }\n\n    // For other patterns, add 1 minute as fallback\n    next.setMinutes(next.getMinutes() + 1);\n    return next;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Job scheduler for recurring jobs.\n */\nexport class JobScheduler {\n  private readonly schedules = new Map<string, ActiveSchedule>();\n  private timer?: ReturnType<typeof setInterval>;\n  private readonly checkIntervalMs: number;\n\n  constructor(\n    private readonly queue: JobQueue,\n    options: { checkIntervalMs?: number } = {}\n  ) {\n    this.checkIntervalMs = options.checkIntervalMs ?? 60000; // 1 minute default\n  }\n\n  /**\n   * Add a scheduled job.\n   */\n  schedule(config: ScheduledJobConfig): void {\n    const nextRun =\n      config.enabled !== false ? getNextCronRun(config.cronExpression) : null;\n\n    this.schedules.set(config.name, {\n      ...config,\n      enabled: config.enabled ?? true,\n      nextRun,\n      lastRun: null,\n    });\n  }\n\n  /**\n   * Remove a scheduled job.\n   */\n  unschedule(name: string): boolean {\n    return this.schedules.delete(name);\n  }\n\n  /**\n   * Enable a scheduled job.\n   */\n  enable(name: string): boolean {\n    const schedule = this.schedules.get(name);\n    if (!schedule) return false;\n\n    schedule.enabled = true;\n    schedule.nextRun = getNextCronRun(schedule.cronExpression);\n    return true;\n  }\n\n  /**\n   * Disable a scheduled job.\n   */\n  disable(name: string): boolean {\n    const schedule = this.schedules.get(name);\n    if (!schedule) return false;\n\n    schedule.enabled = false;\n    schedule.nextRun = null;\n    return true;\n  }\n\n  /**\n   * Get all schedules.\n   */\n  getSchedules(): ActiveSchedule[] {\n    return Array.from(this.schedules.values());\n  }\n\n  /**\n   * Get a specific schedule.\n   */\n  getSchedule(name: string): ActiveSchedule | undefined {\n    return this.schedules.get(name);\n  }\n\n  /**\n   * Start the scheduler.\n   */\n  start(): void {\n    if (this.timer) return;\n\n    // Initial check\n    void this.checkSchedules();\n\n    // Periodic check\n    this.timer = setInterval(() => {\n      void this.checkSchedules();\n    }, this.checkIntervalMs);\n  }\n\n  /**\n   * Stop the scheduler.\n   */\n  stop(): void {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = undefined;\n    }\n  }\n\n  /**\n   * Check and enqueue due schedules.\n   */\n  private async checkSchedules(): Promise<void> {\n    const now = new Date();\n\n    for (const schedule of this.schedules.values()) {\n      if (!schedule.enabled || !schedule.nextRun) continue;\n\n      if (schedule.nextRun <= now) {\n        try {\n          // Resolve payload if it's a function\n          const payload =\n            typeof schedule.payload === 'function'\n              ? await schedule.payload()\n              : schedule.payload;\n\n          // Enqueue the job\n          await this.queue.enqueue(schedule.jobType, payload, schedule.options);\n\n          // Update schedule\n          schedule.lastRun = now;\n          schedule.nextRun = getNextCronRun(schedule.cronExpression, now);\n        } catch (error) {\n          console.error(\n            `Failed to enqueue scheduled job ${schedule.name}:`,\n            error\n          );\n        }\n      }\n    }\n  }\n}\n\n/**\n * Create a job scheduler instance.\n */\nexport function createScheduler(\n  queue: JobQueue,\n  options?: { checkIntervalMs?: number }\n): JobScheduler {\n  return new JobScheduler(queue, options);\n}\n\n/**\n * Helper to define a scheduled job configuration.\n */\nexport function defineSchedule(config: ScheduledJobConfig): ScheduledJobConfig {\n  return config;\n}\n"],"mappings":";;;;;AAoCA,SAAS,eACP,gBACA,wBAAc,IAAI,MAAM,EACX;AACb,KAAI;EAGF,MAAM,QAAQ,eAAe,MAAM,CAAC,MAAM,MAAM;AAChD,MAAI,MAAM,WAAW,GAAG;AACtB,WAAQ,KAAK,4BAA4B,iBAAiB;AAC1D,UAAO;;EAIT,MAAM,SAAS,MAAM;EACrB,MAAM,OAAO,MAAM;EACnB,MAAM,aAAa,MAAM;EACzB,MAAM,QAAQ,MAAM;EACpB,MAAM,OAAO,IAAI,KAAK,MAAM;AAC5B,OAAK,WAAW,EAAE;AAClB,OAAK,gBAAgB,EAAE;AAGvB,MACE,UACA,QACA,WAAW,OACX,SAAS,OACT,eAAe,OACf,UAAU,KACV;GAEA,MAAM,eAAe,OAAO,SAAS,QAAQ,GAAG;GAChD,MAAM,aAAa,OAAO,SAAS,MAAM,GAAG;AAE5C,QAAK,SAAS,YAAY,cAAc,GAAG,EAAE;AAC7C,OAAI,QAAQ,MACV,MAAK,QAAQ,KAAK,SAAS,GAAG,EAAE;AAElC,UAAO;;AAIT,OAAK,WAAW,KAAK,YAAY,GAAG,EAAE;AACtC,SAAO;SACD;AACN,SAAO;;;;;;AAOX,IAAa,eAAb,MAA0B;CACxB,AAAiB,4BAAY,IAAI,KAA6B;CAC9D,AAAQ;CACR,AAAiB;CAEjB,YACE,AAAiBA,OACjB,UAAwC,EAAE,EAC1C;EAFiB;AAGjB,OAAK,kBAAkB,QAAQ,mBAAmB;;;;;CAMpD,SAAS,QAAkC;EACzC,MAAM,UACJ,OAAO,YAAY,QAAQ,eAAe,OAAO,eAAe,GAAG;AAErE,OAAK,UAAU,IAAI,OAAO,MAAM;GAC9B,GAAG;GACH,SAAS,OAAO,WAAW;GAC3B;GACA,SAAS;GACV,CAAC;;;;;CAMJ,WAAW,MAAuB;AAChC,SAAO,KAAK,UAAU,OAAO,KAAK;;;;;CAMpC,OAAO,MAAuB;EAC5B,MAAM,WAAW,KAAK,UAAU,IAAI,KAAK;AACzC,MAAI,CAAC,SAAU,QAAO;AAEtB,WAAS,UAAU;AACnB,WAAS,UAAU,eAAe,SAAS,eAAe;AAC1D,SAAO;;;;;CAMT,QAAQ,MAAuB;EAC7B,MAAM,WAAW,KAAK,UAAU,IAAI,KAAK;AACzC,MAAI,CAAC,SAAU,QAAO;AAEtB,WAAS,UAAU;AACnB,WAAS,UAAU;AACnB,SAAO;;;;;CAMT,eAAiC;AAC/B,SAAO,MAAM,KAAK,KAAK,UAAU,QAAQ,CAAC;;;;;CAM5C,YAAY,MAA0C;AACpD,SAAO,KAAK,UAAU,IAAI,KAAK;;;;;CAMjC,QAAc;AACZ,MAAI,KAAK,MAAO;AAGhB,EAAK,KAAK,gBAAgB;AAG1B,OAAK,QAAQ,kBAAkB;AAC7B,GAAK,KAAK,gBAAgB;KACzB,KAAK,gBAAgB;;;;;CAM1B,OAAa;AACX,MAAI,KAAK,OAAO;AACd,iBAAc,KAAK,MAAM;AACzB,QAAK,QAAQ;;;;;;CAOjB,MAAc,iBAAgC;EAC5C,MAAM,sBAAM,IAAI,MAAM;AAEtB,OAAK,MAAM,YAAY,KAAK,UAAU,QAAQ,EAAE;AAC9C,OAAI,CAAC,SAAS,WAAW,CAAC,SAAS,QAAS;AAE5C,OAAI,SAAS,WAAW,IACtB,KAAI;IAEF,MAAM,UACJ,OAAO,SAAS,YAAY,aACxB,MAAM,SAAS,SAAS,GACxB,SAAS;AAGf,UAAM,KAAK,MAAM,QAAQ,SAAS,SAAS,SAAS,SAAS,QAAQ;AAGrE,aAAS,UAAU;AACnB,aAAS,UAAU,eAAe,SAAS,gBAAgB,IAAI;YACxD,OAAO;AACd,YAAQ,MACN,mCAAmC,SAAS,KAAK,IACjD,MACD;;;;;;;;AAUX,SAAgB,gBACd,OACA,SACc;AACd,QAAO,IAAI,aAAa,OAAO,QAAQ;;;;;AAMzC,SAAgB,eAAe,QAAgD;AAC7E,QAAO"}