@sidequest/engine/dist/routines/release-stale-jobs.js

@sidequest/engine is the core engine of SideQuest, a distributed background job processing system for Node.js and TypeScript.

import { logger, RetryTransition } from '@sidequest/core';
import { inspect } from 'util';
import '../job/constants.js';
import 'node-cron';
import 'node:util';
import 'node:fs';
import 'node:url';
import 'node:path';
import 'piscina';
import '../constants.js';
import { JobTransitioner } from '../job/job-transitioner.js';

/**
 * Finds and releases stale jobs, making them available for processing again.
 * @param backend The backend instance to operate on.
 * @param maxStaleMs Maximum age of a job to be considered stale.
 * @param maxClaimedMs Maximum age of a claimed job to be considered stale.
 * @returns A promise that resolves when the operation is complete.
 */
async function releaseStaleJobs(backend, maxStaleMs, maxClaimedMs) {
    const staleJobs = await backend.staleJobs(maxStaleMs, maxClaimedMs);
    if (staleJobs.length > 0) {
        logger("Engine").info(`Stale jobs found, making them available to process`);
        logger("Engine").debug(`Stale jobs: ${inspect(staleJobs)}`);
        for (const jobData of staleJobs) {
            if (jobData.state === "running") {
                // We need to use the JobTransitioner to properly handle retries and state transitions
                // This fixes the issue where the release of a stale job incremented the retry count and
                // did not respect the maxRetries setting.
                await JobTransitioner.apply(backend, jobData, new RetryTransition("Stale job released for retry"));
            }
            else {
                // If it's "claimed", then the attempt count was not incremented, so we can just set it back to "waiting"
                jobData.state = "waiting";
                await backend.updateJob(jobData);
            }
        }
    }
    else {
        logger("Engine").debug(`No stale jobs found`);
    }
}

export { releaseStaleJobs };
//# sourceMappingURL=release-stale-jobs.js.map