/** * Includes all the scripts needed by the queue and jobs. */ import { JobJson, JobJsonRaw, MinimalJob, MoveToWaitingChildrenOpts, ParentKeyOpts, RedisClient, MoveToDelayedOpts, RepeatableOptions, RetryJobOpts, RetryOptions, ScriptQueueContext } from '../interfaces'; import { JobsOptions, JobState, JobType, FinishedStatus, FinishedPropValAttribute, KeepJobs, RedisJobOptions, JobProgress } from '../types'; import { ChainableCommander } from 'ioredis'; export type JobData = [JobJsonRaw | number, string?]; export declare class Scripts { protected queue: ScriptQueueContext; protected version: string; moveToFinishedKeys: (string | undefined)[]; constructor(queue: ScriptQueueContext); execCommand(client: RedisClient | ChainableCommander, commandName: string, args: any[]): any; isJobInList(listKey: string, jobId: string): Promise; protected addDelayedJobArgs(job: JobJson, encodedOpts: any, args: (string | number | Record)[]): (string | Buffer)[]; protected addDelayedJob(client: RedisClient, job: JobJson, encodedOpts: any, args: (string | number | Record)[]): Promise; protected addPrioritizedJobArgs(job: JobJson, encodedOpts: any, args: (string | number | Record)[]): (string | Buffer)[]; protected addPrioritizedJob(client: RedisClient, job: JobJson, encodedOpts: any, args: (string | number | Record)[]): Promise; protected addParentJobArgs(job: JobJson, encodedOpts: any, args: (string | number | Record)[]): (string | Buffer)[]; protected addParentJob(client: RedisClient, job: JobJson, encodedOpts: any, args: (string | number | Record)[]): Promise; protected addStandardJobArgs(job: JobJson, encodedOpts: any, args: (string | number | Record)[]): (string | Buffer)[]; protected addStandardJob(client: RedisClient, job: JobJson, encodedOpts: any, args: (string | number | Record)[]): Promise; addJob(client: RedisClient, job: JobJson, opts: RedisJobOptions, jobId: string, parentKeyOpts?: ParentKeyOpts): Promise; protected pauseArgs(pause: boolean): (string | number)[]; pause(pause: boolean): Promise; protected addRepeatableJobArgs(customKey: string, nextMillis: number, opts: RepeatableOptions, legacyCustomKey: string): (string | number | Buffer)[]; addRepeatableJob(customKey: string, nextMillis: number, opts: RepeatableOptions, legacyCustomKey: string): Promise; removeDeduplicationKey(deduplicationId: string, jobId: string): Promise; addJobScheduler(jobSchedulerId: string, nextMillis: number, templateData: string, templateOpts: RedisJobOptions, opts: RepeatableOptions, delayedJobOpts: JobsOptions, producerId?: string): Promise<[string, number]>; updateRepeatableJobMillis(client: RedisClient, customKey: string, nextMillis: number, legacyCustomKey: string): Promise; updateJobSchedulerNextMillis(jobSchedulerId: string, nextMillis: number, templateData: string, delayedJobOpts: JobsOptions, producerId?: string): Promise; private removeRepeatableArgs; getRepeatConcatOptions(repeatConcatOptions: string, repeatJobKey: string): string; removeRepeatable(legacyRepeatJobId: string, repeatConcatOptions: string, repeatJobKey: string): Promise; removeJobScheduler(jobSchedulerId: string): Promise; protected removeArgs(jobId: string, removeChildren: boolean): (string | number)[]; remove(jobId: string, removeChildren: boolean): Promise; removeUnprocessedChildren(jobId: string): Promise; extendLock(jobId: string, token: string, duration: number, client?: RedisClient | ChainableCommander): Promise; extendLocks(jobIds: string[], tokens: string[], duration: number): Promise; updateData(job: MinimalJob, data: T): Promise; updateProgress(jobId: string, progress: JobProgress): Promise; addLog(jobId: string, logRow: string, keepLogs?: number): Promise; protected moveToFinishedArgs(job: MinimalJob, val: any, propVal: FinishedPropValAttribute, shouldRemove: undefined | boolean | number | KeepJobs, target: FinishedStatus, token: string, timestamp: number, fetchNext?: boolean, fieldsToUpdate?: Record): (string | number | boolean | Buffer)[]; protected getKeepJobs(shouldRemove: undefined | boolean | number | KeepJobs, workerKeepJobs: undefined | KeepJobs): KeepJobs; moveToFinished(jobId: string, args: (string | number | boolean | Buffer)[]): Promise; private drainArgs; drain(delayed: boolean): Promise; private removeChildDependencyArgs; removeChildDependency(jobId: string, parentKey: string): Promise; private getRangesArgs; getRanges(types: JobType[], start?: number, end?: number, asc?: boolean): Promise<[string][]>; private getCountsArgs; getCounts(types: JobType[]): Promise; protected getCountsPerPriorityArgs(priorities: number[]): (string | number)[]; getCountsPerPriority(priorities: number[]): Promise; protected getDependencyCountsArgs(jobId: string, types: string[]): (string | number)[]; getDependencyCounts(jobId: string, types: string[]): Promise; moveToCompletedArgs(job: MinimalJob, returnvalue: R, removeOnComplete: boolean | number | KeepJobs, token: string, fetchNext?: boolean): (string | number | boolean | Buffer)[]; moveToFailedArgs(job: MinimalJob, failedReason: string, removeOnFailed: boolean | number | KeepJobs, token: string, fetchNext?: boolean, fieldsToUpdate?: Record): (string | number | boolean | Buffer)[]; isFinished(jobId: string, returnValue?: boolean): Promise; getState(jobId: string): Promise; /** * Change delay of a delayed job. * * Reschedules a delayed job by setting a new delay from the current time. * For example, calling changeDelay(5000) will reschedule the job to execute * 5000 milliseconds (5 seconds) from now, regardless of the original delay. * * @param jobId - the ID of the job to change the delay for. * @param delay - milliseconds from now when the job should be processed. * @returns delay in milliseconds. * @throws JobNotExist * This exception is thrown if jobId is missing. * @throws JobNotInState * This exception is thrown if job is not in delayed state. */ changeDelay(jobId: string, delay: number): Promise; private changeDelayArgs; changePriority(jobId: string, priority?: number, lifo?: boolean): Promise; protected changePriorityArgs(jobId: string, priority?: number, lifo?: boolean): (string | number)[]; moveToDelayedArgs(jobId: string, timestamp: number, token: string, delay: number, opts?: MoveToDelayedOpts): (string | number | Buffer)[]; moveToWaitingChildrenArgs(jobId: string, token: string, opts?: MoveToWaitingChildrenOpts): (string | number)[]; isMaxedArgs(): string[]; isMaxed(): Promise; moveToDelayed(jobId: string, timestamp: number, delay: number, token?: string, opts?: MoveToDelayedOpts): Promise; /** * Move parent job to waiting-children state. * * @returns true if job is successfully moved, false if there are pending dependencies. * @throws JobNotExist * This exception is thrown if jobId is missing. * @throws JobLockNotExist * This exception is thrown if job lock is missing. * @throws JobNotInState * This exception is thrown if job is not in active state. */ moveToWaitingChildren(jobId: string, token: string, opts?: MoveToWaitingChildrenOpts): Promise; getRateLimitTtlArgs(maxJobs?: number): (string | number)[]; getRateLimitTtl(maxJobs?: number): Promise; /** * Remove jobs in a specific state. * * @returns Id jobs from the deleted records. */ cleanJobsInSet(set: string, timestamp: number, limit?: number): Promise; getJobSchedulerArgs(id: string): string[]; getJobScheduler(id: string): Promise<[any, string | null]>; retryJobArgs(jobId: string, lifo: boolean, token: string, opts?: MoveToDelayedOpts): (string | number | Buffer)[]; retryJob(jobId: string, lifo: boolean, token?: string, opts?: RetryJobOpts): Promise; protected moveJobsToWaitArgs(state: FinishedStatus | 'delayed', count: number, timestamp: number): (string | number)[]; retryJobs(state?: FinishedStatus, count?: number, timestamp?: number): Promise; promoteJobs(count?: number): Promise; /** * Attempts to reprocess a job * * @param job - The job to reprocess * @param state - The expected job state. If the job is not found * on the provided state, then it's not reprocessed. Supported states: 'failed', 'completed' * * @returns A promise that resolves when the job has been successfully moved to the wait queue. * @throws Will throw an error with a code property indicating the failure reason: * - code 0: Job does not exist * - code -1: Job is currently locked and can't be retried * - code -2: Job was not found in the expected set */ reprocessJob(job: MinimalJob, state: 'failed' | 'completed', opts?: RetryOptions): Promise; getMetrics(type: 'completed' | 'failed', start?: number, end?: number): Promise<[string[], string[], number]>; moveToActive(client: RedisClient, token: string, name?: string): Promise; promote(jobId: string): Promise; protected moveStalledJobsToWaitArgs(): (string | number)[]; /** * Looks for unlocked jobs in the active queue. * * The job was being worked on, but the worker process died and it failed to renew the lock. * We call these jobs 'stalled'. This is the most common case. We resolve these by moving them * back to wait to be re-processed. To prevent jobs from cycling endlessly between active and wait, * (e.g. if the job handler keeps crashing), * we limit the number stalled job recoveries to settings.maxStalledCount. */ moveStalledJobsToWait(): Promise; /** * Moves a job back from Active to Wait. * This script is used when a job has been manually rate limited and needs * to be moved back to wait from active status. * * @param client - Redis client * @param jobId - Job id * @returns */ moveJobFromActiveToWait(jobId: string, token?: string): Promise; obliterate(opts: { force: boolean; count: number; }): Promise; /** * Paginate a set or hash keys. * @param opts - options to define the pagination behaviour * */ paginate(key: string, opts: { start: number; end: number; fetchJobs?: boolean; }): Promise<{ cursor: string; items: { id: string; v?: any; err?: string; }[]; total: number; jobs?: JobJsonRaw[]; }>; finishedErrors({ code, jobId, parentKey, command, state, }: { code: number; jobId?: string; parentKey?: string; command: string; state?: string; }): Error; } export declare function raw2NextJobData(raw: any[]): any[];