@focus-reactive/payload-plugin-translator 0.2.1 → 0.4.0

package/dist/client/features/collection-translation-form/model/schema.d.ts

@@ -6,16 +6,16 @@ export declare const validationSchema: z.ZodObject<{
     strategy: z.ZodEnum<["overwrite", "skip_existing"]>;
     publish_on_translation: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    collection_slug: string;
     source_lng: string;
     target_lng: string;
     strategy: "overwrite" | "skip_existing";
     publish_on_translation: boolean;
-    collection_slug: string;
 }, {
+    collection_slug: string;
     source_lng: string;
     target_lng: string;
     strategy: "overwrite" | "skip_existing";
-    collection_slug: string;
     publish_on_translation?: boolean | undefined;
 }>;
 export type FormValues = z.infer<typeof validationSchema>;

package/dist/client/features/translate-document-form/model/schema.d.ts

@@ -7,17 +7,17 @@ export declare const validationSchema: z.ZodObject<{
     strategy: z.ZodDefault<z.ZodEnum<["overwrite", "skip_existing"]>>;
     publish_on_translation: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    collection_slug: string;
+    collection_id: string;
     source_lng: string;
     target_lng: string;
     strategy: "overwrite" | "skip_existing";
     publish_on_translation: boolean;
+}, {
     collection_slug: string;
     collection_id: string;
-}, {
     source_lng: string;
     target_lng: string;
-    collection_slug: string;
-    collection_id: string;
     strategy?: "overwrite" | "skip_existing" | undefined;
     publish_on_translation?: boolean | undefined;
 }>;

package/dist/server/features/cancel/handler.d.ts

@@ -1,5 +1,5 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerProvider } from "../../modules/task-runner";
 /**
  * Cancels and deletes translation tasks by IDs
  */

package/dist/server/features/cancel/handler.js

@@ -1,5 +1,5 @@
-import { ServerResponse } from '../../shared';
-import { CancelInputSchema } from './model';
+import { ServerResponse } from "../../shared";
+import { CancelInputSchema } from "./model";
 /**
  * Cancels and deletes translation tasks by IDs
  */ export class CancelHandler {
@@ -9,7 +9,7 @@ import { CancelInputSchema } from './model';
     }
     async handle(req) {
         const validationResult = CancelInputSchema.safeParse(await req.json?.());
-        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.issues);
         const { ids } = validationResult.data;
         const runner = this.taskRunnerFactory.create(req.payload);
         await runner.cancel(ids);

package/dist/server/features/cancel-by-collection/handler.d.ts

@@ -1,6 +1,6 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import { type CancelConfig } from './model';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerProvider } from "../../modules/task-runner";
+import type { CancelConfig } from './model';
 /**
  * Cancels all pending translation tasks for a collection
  */

package/dist/server/features/cancel-by-collection/handler.js

@@ -1,5 +1,5 @@
-import { ServerResponse } from '../../shared';
-import { isCollectionAvailable } from '../_lib/collection-utils';
+import { ServerResponse } from "../../shared";
+import { isCollectionAvailable } from "../_lib/collection-utils";
 import { CancelByCollectionInputSchema } from './model';
 /**
  * Cancels all pending translation tasks for a collection
@@ -12,13 +12,13 @@ import { CancelByCollectionInputSchema } from './model';
     }
     async handle(req) {
         const validationResult = CancelByCollectionInputSchema.safeParse(req.routeParams);
-        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.issues);
         const collectionSlug = isCollectionAvailable(validationResult.data.collection_slug, this.config.availableCollections);
-        if (!collectionSlug) return ServerResponse.badRequest('Collection not available for translation');
+        if (!collectionSlug) return ServerResponse.badRequest("Collection not available for translation");
         const runner = this.taskRunnerFactory.create(req.payload);
         const tasks = await runner.findByCollection(collectionSlug);
         if (tasks.length === 0) return ServerResponse.noContent();
-        const pendingTaskIds = tasks.filter((task)=>task.status === 'pending').map((task)=>task.id);
+        const pendingTaskIds = tasks.filter((task)=>task.status === "pending").map((task)=>task.id);
         if (pendingTaskIds.length === 0) return ServerResponse.noContent();
         await runner.cancel(pendingTaskIds);
         return ServerResponse.noContent();

package/dist/server/features/enqueue-translation/handler.d.ts

@@ -1,6 +1,6 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import { type EnqueueConfig } from './model';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerProvider } from "../../modules/task-runner";
+import type { EnqueueConfig } from './model';
 /**
  * Enqueues translation tasks for documents
  */

package/dist/server/features/enqueue-translation/handler.js

@@ -1,5 +1,5 @@
-import { ServerResponse } from '../../shared';
-import { isCollectionAvailable, getAllCollectionIds } from '../_lib/collection-utils';
+import { ServerResponse } from "../../shared";
+import { isCollectionAvailable, getAllCollectionIds } from "../_lib/collection-utils";
 import { EnqueueInputSchema } from './model';
 /**
  * Enqueues translation tasks for documents
@@ -12,10 +12,10 @@ import { EnqueueInputSchema } from './model';
     }
     async handle(req) {
         const validationResult = EnqueueInputSchema.safeParse(await req.json?.());
-        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.issues);
         const { source_lng, target_lng, collection_slug, collection_id, select_all, strategy, publish_on_translation } = validationResult.data;
         const collectionSlug = isCollectionAvailable(collection_slug, this.config.availableCollections);
-        if (!collectionSlug) return ServerResponse.badRequest('Content of this collection is not available for translation');
+        if (!collectionSlug) return ServerResponse.badRequest("Content of this collection is not available for translation");
         const collectionIds = select_all ? await getAllCollectionIds(req.payload, collectionSlug) : collection_id;
         const runner = this.taskRunnerFactory.create(req.payload);
         const tasks = collectionIds.map((id)=>({

package/dist/server/features/enqueue-translation/model.d.ts

@@ -12,18 +12,18 @@ export declare const EnqueueInputSchema: z.ZodObject<{
     strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["overwrite", "skip_existing"]>>>;
     publish_on_translation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
+    collection_slug: string;
+    collection_id: [string, ...string[]];
     source_lng: string;
     target_lng: string;
     strategy: "overwrite" | "skip_existing";
     publish_on_translation: boolean;
-    collection_slug: string;
-    collection_id: [string, ...string[]];
     select_all?: boolean | undefined;
 }, {
-    source_lng: string;
-    target_lng: string;
     collection_slug: string;
     collection_id: [string, ...string[]];
+    source_lng: string;
+    target_lng: string;
     strategy?: "overwrite" | "skip_existing" | undefined;
     publish_on_translation?: boolean | undefined;
     select_all?: boolean | undefined;

package/dist/server/features/get-collection-status/handler.d.ts

@@ -1,6 +1,6 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import { type GetCollectionStatusConfig } from './model';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerProvider } from "../../modules/task-runner";
+import type { GetCollectionStatusConfig } from './model';
 /**
  * Gets translation status for all documents in a collection
  */

package/dist/server/features/get-collection-status/handler.js

@@ -1,5 +1,5 @@
-import { ServerResponse } from '../../shared';
-import { isCollectionAvailable } from '../_lib/collection-utils';
+import { ServerResponse } from "../../shared";
+import { isCollectionAvailable } from "../_lib/collection-utils";
 import { GetCollectionStatusInputSchema } from './model';
 /**
  * Gets translation status for all documents in a collection
@@ -12,9 +12,9 @@ import { GetCollectionStatusInputSchema } from './model';
     }
     async handle(req) {
         const validationResult = GetCollectionStatusInputSchema.safeParse(req.routeParams);
-        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.issues);
         const collectionSlug = isCollectionAvailable(validationResult.data.collection_slug, this.config.availableCollections);
-        if (!collectionSlug) return ServerResponse.badRequest('Collection not available for translation');
+        if (!collectionSlug) return ServerResponse.badRequest("Collection not available for translation");
         const runner = this.taskRunnerFactory.create(req.payload);
         const tasks = await runner.findByCollection(collectionSlug);
         return ServerResponse.success({

package/dist/server/features/get-document-status/handler.d.ts

@@ -1,6 +1,6 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import { type GetDocumentStatusConfig } from './model';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerProvider } from "../../modules/task-runner";
+import type { GetDocumentStatusConfig } from './model';
 /**
  * Gets the translation status for a specific document
  */

package/dist/server/features/get-document-status/handler.js

@@ -1,5 +1,5 @@
-import { ServerResponse } from '../../shared';
-import { isCollectionAvailable } from '../_lib/collection-utils';
+import { ServerResponse } from "../../shared";
+import { isCollectionAvailable } from "../_lib/collection-utils";
 import { GetDocumentStatusInputSchema, taskToJobStatusOutput } from './model';
 /**
  * Gets the translation status for a specific document
@@ -12,10 +12,10 @@ import { GetDocumentStatusInputSchema, taskToJobStatusOutput } from './model';
     }
     async handle(req) {
         const validationResult = GetDocumentStatusInputSchema.safeParse(req.routeParams);
-        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.issues);
         const { collection_slug, collection_id } = validationResult.data;
         const collectionSlug = isCollectionAvailable(collection_slug, this.config.availableCollections);
-        if (!collectionSlug) return ServerResponse.badRequest('Collection not available for translation');
+        if (!collectionSlug) return ServerResponse.badRequest("Collection not available for translation");
         const runner = this.taskRunnerFactory.create(req.payload);
         const tasks = await runner.findByCollection(collectionSlug, [
             collection_id

package/dist/server/features/get-document-status/model.d.ts

@@ -29,7 +29,7 @@ export type TranslationTaskStatus = TaskStatus;
 export type JobInputOutput = {
     collection: {
         relationTo: CollectionSlug;
-        value: string | number;
+        value: string;
     };
     source_lng: string;
     target_lng: string;

package/dist/server/features/run-translation/handler.d.ts

@@ -1,5 +1,5 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerProvider } from "../../modules/task-runner";
 /**
  * Runs a translation task by ID
  */

package/dist/server/features/run-translation/handler.js

@@ -1,5 +1,5 @@
-import { ServerResponse } from '../../shared';
-import { RunInputSchema } from './model';
+import { ServerResponse } from "../../shared";
+import { RunInputSchema } from "./model";
 /**
  * Runs a translation task by ID
  */ export class RunTranslationHandler {
@@ -9,16 +9,16 @@ import { RunInputSchema } from './model';
     }
     async handle(req) {
         const validationResult = RunInputSchema.safeParse(req.routeParams);
-        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.issues);
         const { id } = validationResult.data;
         const runner = this.taskRunnerFactory.create(req.payload);
         const result = await runner.run(id);
         if (!result.success) {
-            if (result.error === 'not_found' || result.error === 'already_completed') {
-                return ServerResponse.notFound('Queued task not found');
+            if (result.error === "not_found" || result.error === "already_completed") {
+                return ServerResponse.notFound("Queued task not found");
             }
-            if (result.error === 'already_running') {
-                return ServerResponse.tooManyRequests('Translation task is already in progress');
+            if (result.error === "already_running") {
+                return ServerResponse.tooManyRequests("Translation task is already in progress");
             }
         }
         return ServerResponse.noContent();

package/dist/server/features/translate-document/handler.d.ts

@@ -1,7 +1,7 @@
-import type { Payload } from 'payload';
-import type { Handler } from '../../shared';
-import type { TranslationProvider } from '../../modules/translation-providers';
-import type { CollectionSchemaMap, TranslateDocumentInput, TranslateDocumentOutput } from './model';
+import type { Payload } from "payload";
+import type { Handler } from "../../shared";
+import type { TranslationProvider } from "../../modules/translation-providers";
+import type { CollectionSchemaMap, TranslateDocumentInput, TranslateDocumentOutput } from "./model";
 export type TranslateDocumentDependencies = {
     translationProvider: TranslationProvider;
     schemaMap: CollectionSchemaMap;

package/dist/server/features/translate-document/handler.js

@@ -1,6 +1,6 @@
-import { APIError } from 'payload';
-import { TranslationPipeline } from '../../modules/translation-pipeline';
-import { createTranslationStrategy } from '../../modules/translation-pipeline/strategies';
+import { APIError } from "payload";
+import { TranslationPipeline } from "../../modules/translation-pipeline";
+import { createTranslationStrategy } from "../../modules/translation-pipeline/strategies";
 /**
  * Translates a single document from source language to target language
  */ export class TranslateDocumentHandler {
@@ -53,7 +53,7 @@ import { createTranslationStrategy } from '../../modules/translation-pipeline/st
         let isAutosaveEnabled = false;
         const versions = collectionConfig.versions;
         if (versions && versions.drafts) {
-            translatedData['_status'] = publishOnTranslation ? 'published' : 'draft';
+            translatedData["_status"] = publishOnTranslation ? "published" : "draft";
             const drafts = versions.drafts;
             if (!publishOnTranslation && drafts.autosave) isAutosaveEnabled = true;
         }

package/dist/server/features/translate-document/index.d.ts

@@ -1,3 +1,2 @@
-export { createTranslateDocumentTask, createAutoRunConfig, TASK_NAME, QUEUE_NAME } from './task';
-export { TranslateDocumentHandler } from './handler';
-export type { CollectionSchemaMap, AutoRunConfig } from './model';
+export { TranslateDocumentHandler } from "./handler";
+export type { CollectionSchemaMap } from "./model";

package/dist/server/features/translate-document/index.js

@@ -1,4 +1,3 @@
-export { createTranslateDocumentTask, createAutoRunConfig, TASK_NAME, QUEUE_NAME } from './task';
-export { TranslateDocumentHandler } from './handler';
+export { TranslateDocumentHandler } from "./handler";
 
 //# sourceMappingURL=index.js.map

package/dist/server/features/translate-document/model.d.ts

@@ -1,11 +1,12 @@
-import type { CollectionSlug, Field } from 'payload';
-import type { TranslationStrategyName } from '../../modules/translation-pipeline/strategies';
+import type { CollectionSlug, Field } from "payload";
+import type { ID } from "../../modules/task-runner/types";
+import type { TranslationStrategyName } from "../../modules/translation-pipeline/strategies";
 /**
  * Input for the translate document handler
  */
 export type TranslateDocumentInput = {
     collection: CollectionSlug;
-    collectionId: string | number;
+    collectionId: ID;
     sourceLng: string;
     targetLng: string;
     strategy: TranslationStrategyName;
@@ -22,31 +23,3 @@ export type TranslateDocumentOutput = {
  * Used to access original schemas before Payload sanitization.
  */
 export type CollectionSchemaMap = Map<CollectionSlug, Field[]>;
-/**
- * Payload task configuration
- */
-export type TaskConfig = {
-    collections: CollectionSlug[];
-    retries?: {
-        attempts?: number;
-        backoff?: {
-            delay?: number;
-            type: 'exponential' | 'fixed';
-        };
-    };
-};
-/**
- * Auto-run configuration for the job queue
- */
-export type AutoRunConfig = {
-    cron?: string;
-    limit?: number;
-    queue?: string;
-};
-/**
- * Payload input schema for the task
- */
-export declare const taskInputSchema: Field[];
-export declare const TASK_NAME: "translate_document";
-export declare const QUEUE_NAME: "translations";
-export declare const DEFAULT_AUTO_RUN: AutoRunConfig;

package/dist/server/features/translate-document/model.js

@@ -1,30 +1,6 @@
 /**
- * Payload input schema for the task
- */ export const taskInputSchema = [
-    {
-        type: 'relationship',
-        name: 'collection',
-        relationTo: [],
-        required: true
-    },
-    {
-        type: 'text',
-        maxLength: 256,
-        name: 'source_lng',
-        required: true
-    },
-    {
-        type: 'text',
-        maxLength: 256,
-        name: 'target_lng',
-        required: true
-    }
-];
-export const TASK_NAME = 'translate_document';
-export const QUEUE_NAME = 'translations';
-export const DEFAULT_AUTO_RUN = {
-    cron: '* * * * *',
-    limit: 50
-};
+ * Map of collection slug to original field schema.
+ * Used to access original schemas before Payload sanitization.
+ */ export { };
 
 //# sourceMappingURL=model.js.map

package/dist/server/modules/task-runner/TaskRunnerProvider.interface.d.ts

@@ -1,12 +1,13 @@
-import type { CollectionSlug, Config, Payload } from 'payload';
-import type { TaskRunner } from './TaskRunner.interface';
-import type { TranslationStrategyName } from '../translation-pipeline/strategies';
+import type { CollectionSlug, Config, Payload } from "payload";
+import type { TaskRunner } from "./TaskRunner.interface";
+import type { ID } from "./types";
+import type { TranslationStrategyName } from "../translation-pipeline/strategies";
 /**
  * Input for task handler callback
  */
 export type TaskHandlerInput = {
     collection: CollectionSlug;
-    collectionId: string | number;
+    collectionId: ID;
     sourceLng: string;
     targetLng: string;
     strategy: TranslationStrategyName;
@@ -40,6 +41,7 @@ export interface TaskRunnerProvider {
     /**
      * Configures the runner and returns a Payload config modifier.
      * The modifier adds necessary tasks, jobs, queues to Payload config.
+     * Implementations may also install a `config.onInit` hook for boot-time initialization (e.g. stale-lock recovery).
      */
     configure(context: TaskRunnerContext): (config: Config) => Config;
 }

package/dist/server/modules/task-runner/payload-jobs-runner/PayloadJobsRunnerProvider.d.ts

@@ -1,7 +1,7 @@
-import type { Config, Payload } from 'payload';
-import type { TaskRunner } from '../TaskRunner.interface';
-import type { PayloadJobsRunnerOptions } from './types';
-import type { TaskRunnerContext, TaskRunnerProvider } from '../TaskRunnerProvider.interface';
+import type { Config, Payload } from "payload";
+import type { TaskRunner } from "../TaskRunner.interface";
+import type { PayloadJobsRunnerOptions } from "./types";
+import type { TaskRunnerContext, TaskRunnerProvider } from "../TaskRunnerProvider.interface";
 /**
  * TaskRunnerProvider implementation using Payload Jobs.
  *

package/dist/server/modules/task-runner/payload-jobs-runner/PayloadJobsRunnerProvider.js

@@ -1,17 +1,20 @@
-import { PayloadJobsTaskRunner } from './PayloadJobsTaskRunner';
+import { PayloadJobsTaskRunner } from "./PayloadJobsTaskRunner";
+import { readCollectionRef } from "./readCollectionRef";
 const defaultAutoRun = {
-    cron: '* * * * *',
+    cron: "* * * * *",
     limit: 50
 };
+const DEFAULT_STALE_JOB_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
 const defaultValues = {
-    taskName: 'translate_document',
-    queueName: 'translations',
-    jobsCollection: 'payload-jobs',
+    taskName: "translate_document",
+    queueName: "translations",
+    jobsCollection: "payload-jobs",
     autoRun: defaultAutoRun,
+    staleJobTimeoutMs: DEFAULT_STALE_JOB_TIMEOUT_MS,
     retries: {
         attempts: 3,
         backoff: {
-            type: 'exponential',
+            type: "exponential",
             delay: 5000
         }
     }
@@ -27,11 +30,16 @@ const defaultValues = {
             ...defaultAutoRun,
             ...options.autoRun
         } : defaultAutoRun;
+        const staleJobTimeoutMs = options?.staleJobTimeoutMs ?? defaultValues.staleJobTimeoutMs;
+        if (!Number.isFinite(staleJobTimeoutMs) || staleJobTimeoutMs <= 0) {
+            throw new Error(`[payload-plugin-translator] staleJobTimeoutMs must be a positive finite number (got ${staleJobTimeoutMs})`);
+        }
         this.config = {
             taskName: options?.taskName ?? defaultValues.taskName,
             queueName: options?.queueName ?? defaultValues.queueName,
             jobsCollection: options?.jobsCollection ?? defaultValues.jobsCollection,
             autoRun,
+            staleJobTimeoutMs,
             retries: options?.retries ?? defaultValues.retries
         };
     }
@@ -43,33 +51,57 @@ const defaultValues = {
         const { handler, collections } = context;
         return (config)=>{
             const inputSchema = [
+                // Flat text reference (ID-agnostic). Current shape that jobs are
+                // written with — no relationship type validation against the target
+                // collection's ID type, so string IDs work for number-id collections.
                 {
-                    type: 'relationship',
-                    name: 'collection',
-                    relationTo: collections,
+                    type: "text",
+                    name: "collection_slug",
+                    required: true
+                },
+                {
+                    type: "text",
+                    name: "collection_id",
                     required: true
                 },
+                /**
+         * Legacy relationship reference, kept as a read-only fallback so jobs
+         * queued before the ID-agnostic migration stay readable. No longer
+         * written; demoted to `required: false` so new jobs (which omit it)
+         * pass validation. Removed in the next major.
+         * See docs/DEPRECATIONS.md#jobs-input-collection-field
+         * @deprecated
+         */ {
+                    type: "relationship",
+                    name: "collection",
+                    relationTo: collections,
+                    required: false,
+                    admin: {
+                        readOnly: true,
+                        description: "Deprecated. See docs/DEPRECATIONS.md#jobs-input-collection-field"
+                    }
+                },
                 {
-                    type: 'text',
+                    type: "text",
                     maxLength: 256,
-                    name: 'source_lng',
+                    name: "source_lng",
                     required: true
                 },
                 {
-                    type: 'text',
+                    type: "text",
                     maxLength: 256,
-                    name: 'target_lng',
+                    name: "target_lng",
                     required: true
                 },
                 {
-                    type: 'text',
+                    type: "text",
                     maxLength: 256,
-                    name: 'strategy',
+                    name: "strategy",
                     required: true
                 },
                 {
-                    type: 'checkbox',
-                    name: 'publish_on_translation',
+                    type: "checkbox",
+                    name: "publish_on_translation",
                     defaultValue: false
                 }
             ];
@@ -78,9 +110,10 @@ const defaultValues = {
                 inputSchema,
                 retries,
                 handler: async (args)=>{
+                    const { collectionSlug, collectionId } = readCollectionRef(args.input);
                     await handler(args.req.payload, {
-                        collection: args.input.collection.relationTo,
-                        collectionId: args.input.collection.value,
+                        collection: collectionSlug,
+                        collectionId,
                         sourceLng: args.input.source_lng,
                         targetLng: args.input.target_lng,
                         strategy: args.input.strategy,
@@ -104,7 +137,7 @@ const defaultValues = {
                 const existingAutoRun = config.jobs.autoRun;
                 if (Array.isArray(existingAutoRun)) {
                     existingAutoRun.push(autoRunConfig);
-                } else if (typeof existingAutoRun === 'function') {
+                } else if (typeof existingAutoRun === "function") {
                     config.jobs.autoRun = async (payload)=>[
                             ...await existingAutoRun(payload),
                             autoRunConfig
@@ -115,6 +148,25 @@ const defaultValues = {
                     ];
                 }
             }
+            // Reset stale locks on boot so jobs abandoned by a killed process
+            // (deploy/crash/timeout) become eligible for the autorun picker again.
+            // The picker requires processing:false, no error, and no pending waitUntil;
+            // a mid-run casualty (no error, no waitUntil) satisfies the rest, so
+            // clearing processing is sufficient for that case. Threshold-based, so a
+            // job genuinely in flight on another live instance (fresh updatedAt) is
+            // left alone. Wrapped so a reclaim failure never blocks startup.
+            const existingOnInit = config.onInit;
+            config.onInit = async (payload)=>{
+                if (existingOnInit) await existingOnInit(payload);
+                try {
+                    await new PayloadJobsTaskRunner(payload, this.config).reclaimStaleJobs();
+                } catch (err) {
+                    payload.logger?.error?.({
+                        err,
+                        msg: "[translator] failed to reclaim stale translation jobs"
+                    });
+                }
+            };
             return config;
         };
     }