@focus-reactive/payload-plugin-translator 0.1.0

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

@@ -0,0 +1,85 @@
+import type { CollectionSlug } from 'payload';
+/**
+ * Configuration for automatic job processing.
+ */
+export type AutoRunConfig = {
+    /**
+     * Cron schedule for auto-running jobs.
+     * @default '* * * * *' (every minute)
+     */
+    cron?: string;
+    /**
+     * Maximum number of jobs to process per run.
+     * @default 50
+     */
+    limit?: number;
+};
+/**
+ * Options for PayloadJobsRunnerProvider
+ */
+export type PayloadJobsRunnerOptions = {
+    /**
+     * Name of the Payload task.
+     * @default 'translate_document'
+     */
+    taskName?: string;
+    /**
+     * Name of the job queue.
+     * @default 'translations'
+     */
+    queueName?: string;
+    /**
+     * Name of the Payload jobs collection.
+     * @default 'payload-jobs'
+     */
+    jobsCollection?: string;
+    /**
+     * Automatic job processing configuration.
+     * Set to `false` to disable (for Vercel/serverless deployments).
+     * Set to an object to customize cron schedule and limit.
+     * @default { cron: '* * * * *', limit: 50 }
+     */
+    autoRun?: false | AutoRunConfig;
+    /**
+     * Retry configuration for failed jobs.
+     */
+    retries?: {
+        attempts?: number;
+        backoff?: {
+            delay?: number;
+            type: 'exponential' | 'fixed';
+        };
+    };
+};
+/**
+ * Internal configuration for PayloadJobsRunner
+ */
+export type PayloadJobsRunnerConfig = {
+    taskName: string;
+    queueName: string;
+    jobsCollection: string;
+    autoRun: false | Required<AutoRunConfig>;
+    retries?: PayloadJobsRunnerOptions['retries'];
+};
+/**
+ * Raw Payload job structure
+ */
+export type PayloadJob = {
+    id: string;
+    completedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    error?: unknown;
+    processing?: boolean | null;
+    input?: {
+        collection?: {
+            relationTo: CollectionSlug;
+            value: string | number;
+        };
+        source_lng?: string;
+        target_lng?: string;
+        strategy?: string;
+        publish_on_translation?: boolean;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/task-runner/payload-jobs-runner/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,aAAa,CAAA;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAA;SAAE,CAAA;KAC5D,CAAA;CACF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;IACxC,OAAO,CAAC,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;CAC9C,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE;YACX,UAAU,EAAE,cAAc,CAAA;YAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;SACvB,CAAA;QACD,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,sBAAsB,CAAC,EAAE,OAAO,CAAA;KACjC,CAAA;CACF,CAAA"}

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

@@ -0,0 +1,5 @@
+/**
+ * Raw Payload job structure
+ */ export { };
+
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/server/modules/task-runner/payload-jobs-runner/types.ts"],"sourcesContent":["import type { CollectionSlug } from 'payload'\n\n/**\n * Configuration for automatic job processing.\n */\nexport type AutoRunConfig = {\n  /**\n   * Cron schedule for auto-running jobs.\n   * @default '* * * * *' (every minute)\n   */\n  cron?: string\n  /**\n   * Maximum number of jobs to process per run.\n   * @default 50\n   */\n  limit?: number\n}\n\n/**\n * Options for PayloadJobsRunnerProvider\n */\nexport type PayloadJobsRunnerOptions = {\n  /**\n   * Name of the Payload task.\n   * @default 'translate_document'\n   */\n  taskName?: string\n  /**\n   * Name of the job queue.\n   * @default 'translations'\n   */\n  queueName?: string\n  /**\n   * Name of the Payload jobs collection.\n   * @default 'payload-jobs'\n   */\n  jobsCollection?: string\n  /**\n   * Automatic job processing configuration.\n   * Set to `false` to disable (for Vercel/serverless deployments).\n   * Set to an object to customize cron schedule and limit.\n   * @default { cron: '* * * * *', limit: 50 }\n   */\n  autoRun?: false | AutoRunConfig\n  /**\n   * Retry configuration for failed jobs.\n   */\n  retries?: {\n    attempts?: number\n    backoff?: { delay?: number; type: 'exponential' | 'fixed' }\n  }\n}\n\n/**\n * Internal configuration for PayloadJobsRunner\n */\nexport type PayloadJobsRunnerConfig = {\n  taskName: string\n  queueName: string\n  jobsCollection: string\n  autoRun: false | Required<AutoRunConfig>\n  retries?: PayloadJobsRunnerOptions['retries']\n}\n\n/**\n * Raw Payload job structure\n */\nexport type PayloadJob = {\n  id: string\n  completedAt?: string | null\n  createdAt: string\n  updatedAt: string\n  error?: unknown\n  processing?: boolean | null\n  input?: {\n    collection?: {\n      relationTo: CollectionSlug\n      value: string | number\n    }\n    source_lng?: string\n    target_lng?: string\n    strategy?: string\n    publish_on_translation?: boolean\n  }\n}\n"],"names":[],"mappings":"AAgEA;;CAEC,GACD,WAiBC"}

package/dist/server/modules/task-runner/sync-runner/SyncRunnerProvider.d.ts

@@ -0,0 +1,25 @@
+import type { Config, Payload } from 'payload';
+import type { TaskRunner } from '../TaskRunner.interface';
+import type { TaskRunnerProvider, TaskRunnerContext } from '../TaskRunnerProvider.interface';
+import type { SyncRunnerOptions } from './types';
+/**
+ * Synchronous TaskRunnerProvider implementation.
+ *
+ * Executes translations immediately without Payload Jobs.
+ * Useful for development, testing, or simple use cases.
+ */
+export declare class SyncRunnerProvider implements TaskRunnerProvider {
+    private handler?;
+    private readonly tasks;
+    constructor(options?: SyncRunnerOptions);
+    create(payload: Payload): TaskRunner;
+    configure(context: TaskRunnerContext): (config: Config) => Config;
+}
+/**
+ * Creates a synchronous TaskRunnerProvider.
+ *
+ * Executes translations immediately without queuing.
+ * Results are stored in memory and lost on server restart.
+ */
+export declare function createSyncRunner(options?: SyncRunnerOptions): TaskRunnerProvider;
+//# sourceMappingURL=SyncRunnerProvider.d.ts.map

package/dist/server/modules/task-runner/sync-runner/SyncRunnerProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncRunnerProvider.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/task-runner/sync-runner/SyncRunnerProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAe,MAAM,iCAAiC,CAAA;AAEzG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAOhD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAEjC,OAAO,CAAC,EAAE,iBAAiB;IAYvC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU;IAKpC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM;CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,kBAAkB,CAEhF"}

package/dist/server/modules/task-runner/sync-runner/SyncRunnerProvider.js

@@ -0,0 +1,42 @@
+import { SyncTaskRunner } from './SyncTaskRunner';
+import { LazyMap } from '../../../shared/utils';
+const DEFAULT_MAX_SIZE = 100;
+const DEFAULT_TTL_MS = 60 * 60 * 1000 // 1 hour
+;
+/**
+ * Synchronous TaskRunnerProvider implementation.
+ *
+ * Executes translations immediately without Payload Jobs.
+ * Useful for development, testing, or simple use cases.
+ */ export class SyncRunnerProvider {
+    handler;
+    tasks;
+    constructor(options){
+        const maxSize = options?.maxSize ?? DEFAULT_MAX_SIZE;
+        const ttlMs = options?.ttlMs ?? DEFAULT_TTL_MS;
+        this.tasks = new LazyMap({
+            maxSize,
+            ttlMs,
+            isRemovable: (task)=>task.status === 'completed' || task.status === 'failed',
+            getTimestamp: (task)=>new Date(task.updatedAt).getTime()
+        });
+    }
+    create(payload) {
+        if (!this.handler) throw new Error('SyncRunnerProvider not configured. Call configure() first.');
+        return new SyncTaskRunner(payload, this.handler, this.tasks);
+    }
+    configure(context) {
+        this.handler = context.handler;
+        return (config)=>config;
+    }
+}
+/**
+ * Creates a synchronous TaskRunnerProvider.
+ *
+ * Executes translations immediately without queuing.
+ * Results are stored in memory and lost on server restart.
+ */ export function createSyncRunner(options) {
+    return new SyncRunnerProvider(options);
+}
+
+//# sourceMappingURL=SyncRunnerProvider.js.map

package/dist/server/modules/task-runner/sync-runner/SyncRunnerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/server/modules/task-runner/sync-runner/SyncRunnerProvider.ts"],"sourcesContent":["import type { Config, Payload } from 'payload'\n\nimport type { TaskRunner } from '../TaskRunner.interface'\nimport type { TaskRunnerProvider, TaskRunnerContext, TaskHandler } from '../TaskRunnerProvider.interface'\nimport type { Task } from '../types'\nimport type { SyncRunnerOptions } from './types'\nimport { SyncTaskRunner } from './SyncTaskRunner'\nimport { LazyMap } from '../../../shared/utils'\n\nconst DEFAULT_MAX_SIZE = 100\nconst DEFAULT_TTL_MS = 60 * 60 * 1000 // 1 hour\n\n/**\n * Synchronous TaskRunnerProvider implementation.\n *\n * Executes translations immediately without Payload Jobs.\n * Useful for development, testing, or simple use cases.\n */\nexport class SyncRunnerProvider implements TaskRunnerProvider {\n  private handler?: TaskHandler\n  private readonly tasks: LazyMap<string, Task>\n\n  constructor(options?: SyncRunnerOptions) {\n    const maxSize = options?.maxSize ?? DEFAULT_MAX_SIZE\n    const ttlMs = options?.ttlMs ?? DEFAULT_TTL_MS\n\n    this.tasks = new LazyMap<string, Task>({\n      maxSize,\n      ttlMs,\n      isRemovable: (task) => task.status === 'completed' || task.status === 'failed',\n      getTimestamp: (task) => new Date(task.updatedAt).getTime(),\n    })\n  }\n\n  create(payload: Payload): TaskRunner {\n    if (!this.handler) throw new Error('SyncRunnerProvider not configured. Call configure() first.')\n    return new SyncTaskRunner(payload, this.handler, this.tasks)\n  }\n\n  configure(context: TaskRunnerContext): (config: Config) => Config {\n    this.handler = context.handler\n    return (config) => config\n  }\n}\n\n/**\n * Creates a synchronous TaskRunnerProvider.\n *\n * Executes translations immediately without queuing.\n * Results are stored in memory and lost on server restart.\n */\nexport function createSyncRunner(options?: SyncRunnerOptions): TaskRunnerProvider {\n  return new SyncRunnerProvider(options)\n}\n"],"names":["SyncTaskRunner","LazyMap","DEFAULT_MAX_SIZE","DEFAULT_TTL_MS","SyncRunnerProvider","handler","tasks","options","maxSize","ttlMs","isRemovable","task","status","getTimestamp","Date","updatedAt","getTime","create","payload","Error","configure","context","config","createSyncRunner"],"mappings":"AAMA,SAASA,cAAc,QAAQ,mBAAkB;AACjD,SAASC,OAAO,QAAQ,wBAAuB;AAE/C,MAAMC,mBAAmB;AACzB,MAAMC,iBAAiB,KAAK,KAAK,KAAK,SAAS;;AAE/C;;;;;CAKC,GACD,OAAO,MAAMC;IACHC,QAAqB;IACZC,MAA4B;IAE7C,YAAYC,OAA2B,CAAE;QACvC,MAAMC,UAAUD,SAASC,WAAWN;QACpC,MAAMO,QAAQF,SAASE,SAASN;QAEhC,IAAI,CAACG,KAAK,GAAG,IAAIL,QAAsB;YACrCO;YACAC;YACAC,aAAa,CAACC,OAASA,KAAKC,MAAM,KAAK,eAAeD,KAAKC,MAAM,KAAK;YACtEC,cAAc,CAACF,OAAS,IAAIG,KAAKH,KAAKI,SAAS,EAAEC,OAAO;QAC1D;IACF;IAEAC,OAAOC,OAAgB,EAAc;QACnC,IAAI,CAAC,IAAI,CAACb,OAAO,EAAE,MAAM,IAAIc,MAAM;QACnC,OAAO,IAAInB,eAAekB,SAAS,IAAI,CAACb,OAAO,EAAE,IAAI,CAACC,KAAK;IAC7D;IAEAc,UAAUC,OAA0B,EAA8B;QAChE,IAAI,CAAChB,OAAO,GAAGgB,QAAQhB,OAAO;QAC9B,OAAO,CAACiB,SAAWA;IACrB;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASC,iBAAiBhB,OAA2B;IAC1D,OAAO,IAAIH,mBAAmBG;AAChC"}

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.d.ts

@@ -0,0 +1,23 @@
+import type { Payload, CollectionSlug } from 'payload';
+import type { TaskRunner } from '../TaskRunner.interface';
+import type { TaskHandler } from '../TaskRunnerProvider.interface';
+import type { Task, TaskInput, RunResult } from '../types';
+import type { LazyMap } from '../../../shared/utils';
+/**
+ * Synchronous TaskRunner implementation.
+ *
+ * Executes translations immediately without queuing.
+ * Stores results in memory for status queries.
+ */
+export declare class SyncTaskRunner implements TaskRunner {
+    private readonly payload;
+    private readonly handler;
+    private readonly tasks;
+    constructor(payload: Payload, handler: TaskHandler, tasks: LazyMap<string, Task>);
+    enqueue(inputs: TaskInput[]): Promise<void>;
+    cancel(_taskIds: string[]): Promise<void>;
+    run(_taskId: string): Promise<RunResult>;
+    findByCollection(collectionSlug: CollectionSlug, documentIds?: Array<string | number>): Promise<Task[]>;
+    private getKey;
+}
+//# sourceMappingURL=SyncTaskRunner.d.ts.map

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncTaskRunner.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/task-runner/sync-runner/SyncTaskRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEpD;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;IAGzC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC3C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKxC,gBAAgB,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAY7G,OAAO,CAAC,MAAM;CAGf"}

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.js

@@ -0,0 +1,72 @@
+/**
+ * Synchronous TaskRunner implementation.
+ *
+ * Executes translations immediately without queuing.
+ * Stores results in memory for status queries.
+ */ export class SyncTaskRunner {
+    payload;
+    handler;
+    tasks;
+    constructor(payload, handler, tasks){
+        this.payload = payload;
+        this.handler = handler;
+        this.tasks = tasks;
+    }
+    async enqueue(inputs) {
+        for (const input of inputs){
+            const key = this.getKey(input.collectionSlug, input.collectionId);
+            const now = new Date().toISOString();
+            const task = {
+                id: crypto.randomUUID(),
+                status: 'running',
+                input,
+                createdAt: now,
+                updatedAt: now,
+                cancelled: false
+            };
+            this.tasks.set(key, task);
+            try {
+                await this.handler(this.payload, {
+                    collection: input.collectionSlug,
+                    collectionId: input.collectionId,
+                    sourceLng: input.sourceLng,
+                    targetLng: input.targetLng,
+                    strategy: input.strategy,
+                    publishOnTranslation: input.publishOnTranslation
+                });
+                task.status = 'completed';
+                task.completedAt = new Date().toISOString();
+            } catch (error) {
+                task.status = 'failed';
+                task.error = {
+                    message: error instanceof Error ? error.message : 'Unknown error'
+                };
+            }
+            task.updatedAt = new Date().toISOString();
+        }
+    }
+    async cancel(_taskIds) {
+    // No-op: synchronous tasks execute immediately and cannot be cancelled
+    }
+    async run(_taskId) {
+        // Sync runner executes tasks immediately, no pending tasks to run
+        return {
+            success: false,
+            error: 'not_found'
+        };
+    }
+    async findByCollection(collectionSlug, documentIds) {
+        const results = [];
+        for (const [, task] of this.tasks){
+            if (task.input.collectionSlug !== collectionSlug) continue;
+            if (documentIds && !documentIds.includes(task.input.collectionId)) continue;
+            results.push(task);
+        }
+        return results;
+    }
+    getKey(collectionSlug, collectionId) {
+        return `${collectionSlug}:${collectionId}`;
+    }
+}
+
+//# sourceMappingURL=SyncTaskRunner.js.map

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/server/modules/task-runner/sync-runner/SyncTaskRunner.ts"],"sourcesContent":["import type { Payload, CollectionSlug } from 'payload'\n\nimport type { TaskRunner } from '../TaskRunner.interface'\nimport type { TaskHandler } from '../TaskRunnerProvider.interface'\nimport type { Task, TaskInput, RunResult } from '../types'\nimport type { LazyMap } from '../../../shared/utils'\n\n/**\n * Synchronous TaskRunner implementation.\n *\n * Executes translations immediately without queuing.\n * Stores results in memory for status queries.\n */\nexport class SyncTaskRunner implements TaskRunner {\n  constructor(\n    private readonly payload: Payload,\n    private readonly handler: TaskHandler,\n    private readonly tasks: LazyMap<string, Task>,\n  ) {}\n\n  async enqueue(inputs: TaskInput[]): Promise<void> {\n    for (const input of inputs) {\n      const key = this.getKey(input.collectionSlug, input.collectionId)\n      const now = new Date().toISOString()\n\n      const task: Task = {\n        id: crypto.randomUUID(),\n        status: 'running',\n        input,\n        createdAt: now,\n        updatedAt: now,\n        cancelled: false,\n      }\n\n      this.tasks.set(key, task)\n\n      try {\n        await this.handler(this.payload, {\n          collection: input.collectionSlug,\n          collectionId: input.collectionId,\n          sourceLng: input.sourceLng,\n          targetLng: input.targetLng,\n          strategy: input.strategy,\n          publishOnTranslation: input.publishOnTranslation,\n        })\n\n        task.status = 'completed'\n        task.completedAt = new Date().toISOString()\n      } catch (error) {\n        task.status = 'failed'\n        task.error = {\n          message: error instanceof Error ? error.message : 'Unknown error',\n        }\n      }\n\n      task.updatedAt = new Date().toISOString()\n    }\n  }\n\n  async cancel(_taskIds: string[]): Promise<void> {\n    // No-op: synchronous tasks execute immediately and cannot be cancelled\n  }\n\n  async run(_taskId: string): Promise<RunResult> {\n    // Sync runner executes tasks immediately, no pending tasks to run\n    return { success: false, error: 'not_found' }\n  }\n\n  async findByCollection(collectionSlug: CollectionSlug, documentIds?: Array<string | number>): Promise<Task[]> {\n    const results: Task[] = []\n\n    for (const [, task] of this.tasks) {\n      if (task.input.collectionSlug !== collectionSlug) continue\n      if (documentIds && !documentIds.includes(task.input.collectionId)) continue\n      results.push(task)\n    }\n\n    return results\n  }\n\n  private getKey(collectionSlug: CollectionSlug, collectionId: string | number): string {\n    return `${collectionSlug}:${collectionId}`\n  }\n}\n"],"names":["SyncTaskRunner","payload","handler","tasks","enqueue","inputs","input","key","getKey","collectionSlug","collectionId","now","Date","toISOString","task","id","crypto","randomUUID","status","createdAt","updatedAt","cancelled","set","collection","sourceLng","targetLng","strategy","publishOnTranslation","completedAt","error","message","Error","cancel","_taskIds","run","_taskId","success","findByCollection","documentIds","results","includes","push"],"mappings":"AAOA;;;;;CAKC,GACD,OAAO,MAAMA;;;;IACX,YACE,AAAiBC,OAAgB,EACjC,AAAiBC,OAAoB,EACrC,AAAiBC,KAA4B,CAC7C;aAHiBF,UAAAA;aACAC,UAAAA;aACAC,QAAAA;IAChB;IAEH,MAAMC,QAAQC,MAAmB,EAAiB;QAChD,KAAK,MAAMC,SAASD,OAAQ;YAC1B,MAAME,MAAM,IAAI,CAACC,MAAM,CAACF,MAAMG,cAAc,EAAEH,MAAMI,YAAY;YAChE,MAAMC,MAAM,IAAIC,OAAOC,WAAW;YAElC,MAAMC,OAAa;gBACjBC,IAAIC,OAAOC,UAAU;gBACrBC,QAAQ;gBACRZ;gBACAa,WAAWR;gBACXS,WAAWT;gBACXU,WAAW;YACb;YAEA,IAAI,CAAClB,KAAK,CAACmB,GAAG,CAACf,KAAKO;YAEpB,IAAI;gBACF,MAAM,IAAI,CAACZ,OAAO,CAAC,IAAI,CAACD,OAAO,EAAE;oBAC/BsB,YAAYjB,MAAMG,cAAc;oBAChCC,cAAcJ,MAAMI,YAAY;oBAChCc,WAAWlB,MAAMkB,SAAS;oBAC1BC,WAAWnB,MAAMmB,SAAS;oBAC1BC,UAAUpB,MAAMoB,QAAQ;oBACxBC,sBAAsBrB,MAAMqB,oBAAoB;gBAClD;gBAEAb,KAAKI,MAAM,GAAG;gBACdJ,KAAKc,WAAW,GAAG,IAAIhB,OAAOC,WAAW;YAC3C,EAAE,OAAOgB,OAAO;gBACdf,KAAKI,MAAM,GAAG;gBACdJ,KAAKe,KAAK,GAAG;oBACXC,SAASD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAG;gBACpD;YACF;YAEAhB,KAAKM,SAAS,GAAG,IAAIR,OAAOC,WAAW;QACzC;IACF;IAEA,MAAMmB,OAAOC,QAAkB,EAAiB;IAC9C,uEAAuE;IACzE;IAEA,MAAMC,IAAIC,OAAe,EAAsB;QAC7C,kEAAkE;QAClE,OAAO;YAAEC,SAAS;YAAOP,OAAO;QAAY;IAC9C;IAEA,MAAMQ,iBAAiB5B,cAA8B,EAAE6B,WAAoC,EAAmB;QAC5G,MAAMC,UAAkB,EAAE;QAE1B,KAAK,MAAM,GAAGzB,KAAK,IAAI,IAAI,CAACX,KAAK,CAAE;YACjC,IAAIW,KAAKR,KAAK,CAACG,cAAc,KAAKA,gBAAgB;YAClD,IAAI6B,eAAe,CAACA,YAAYE,QAAQ,CAAC1B,KAAKR,KAAK,CAACI,YAAY,GAAG;YACnE6B,QAAQE,IAAI,CAAC3B;QACf;QAEA,OAAOyB;IACT;IAEQ/B,OAAOC,cAA8B,EAAEC,YAA6B,EAAU;QACpF,OAAO,GAAGD,eAAe,CAAC,EAAEC,cAAc;IAC5C;AACF"}

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SyncTaskRunner.test.d.ts.map

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncTaskRunner.test.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/task-runner/sync-runner/SyncTaskRunner.test.ts"],"names":[],"mappings":""}

package/dist/server/modules/task-runner/sync-runner/SyncTaskRunner.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { SyncTaskRunner } from './SyncTaskRunner';
+import { LazyMap } from '../../../shared/utils';
+describe('SyncTaskRunner', () => {
+    let mockPayload;
+    let mockHandler;
+    let tasks;
+    let runner;
+    beforeEach(() => {
+        mockPayload = {};
+        mockHandler = vi.fn().mockResolvedValue(undefined);
+        tasks = new LazyMap({
+            isRemovable: (task) => task.status === 'completed' || task.status === 'failed',
+            getTimestamp: (task) => new Date(task.updatedAt).getTime(),
+        });
+        runner = new SyncTaskRunner(mockPayload, mockHandler, tasks);
+    });
+    const createInput = (overrides = {}) => ({
+        collectionSlug: 'posts',
+        collectionId: 'doc-123',
+        sourceLng: 'en',
+        targetLng: 'de',
+        strategy: 'overwrite',
+        publishOnTranslation: false,
+        ...overrides,
+    });
+    describe('enqueue', () => {
+        it('executes handler immediately', async () => {
+            const input = createInput();
+            await runner.enqueue([input]);
+            expect(mockHandler).toHaveBeenCalledWith(mockPayload, {
+                collection: 'posts',
+                collectionId: 'doc-123',
+                sourceLng: 'en',
+                targetLng: 'de',
+                strategy: 'overwrite',
+                publishOnTranslation: false,
+            });
+        });
+        it('stores completed task in tasks map', async () => {
+            const input = createInput();
+            await runner.enqueue([input]);
+            const task = tasks.get('posts:doc-123');
+            expect(task).toBeDefined();
+            expect(task?.status).toBe('completed');
+            expect(task?.completedAt).toBeDefined();
+        });
+        it('stores failed task when handler throws', async () => {
+            mockHandler = vi.fn().mockRejectedValue(new Error('Translation failed'));
+            runner = new SyncTaskRunner(mockPayload, mockHandler, tasks);
+            const input = createInput();
+            await runner.enqueue([input]);
+            const task = tasks.get('posts:doc-123');
+            expect(task?.status).toBe('failed');
+            expect(task?.error?.message).toBe('Translation failed');
+        });
+        it('handles non-Error throws', async () => {
+            mockHandler = vi.fn().mockRejectedValue('string error');
+            runner = new SyncTaskRunner(mockPayload, mockHandler, tasks);
+            const input = createInput();
+            await runner.enqueue([input]);
+            const task = tasks.get('posts:doc-123');
+            expect(task?.status).toBe('failed');
+            expect(task?.error?.message).toBe('Unknown error');
+        });
+        it('processes multiple inputs sequentially', async () => {
+            const inputs = [
+                createInput({ collectionId: 'doc-1' }),
+                createInput({ collectionId: 'doc-2' }),
+                createInput({ collectionId: 'doc-3' }),
+            ];
+            await runner.enqueue(inputs);
+            expect(mockHandler).toHaveBeenCalledTimes(3);
+            expect(tasks.get('posts:doc-1')?.status).toBe('completed');
+            expect(tasks.get('posts:doc-2')?.status).toBe('completed');
+            expect(tasks.get('posts:doc-3')?.status).toBe('completed');
+        });
+        it('creates task with unique id', async () => {
+            const inputs = [createInput({ collectionId: 'doc-1' }), createInput({ collectionId: 'doc-2' })];
+            await runner.enqueue(inputs);
+            const task1 = tasks.get('posts:doc-1');
+            const task2 = tasks.get('posts:doc-2');
+            expect(task1?.id).not.toBe(task2?.id);
+        });
+        it('sets cancelled to false', async () => {
+            const input = createInput();
+            await runner.enqueue([input]);
+            const task = tasks.get('posts:doc-123');
+            expect(task?.cancelled).toBe(false);
+        });
+        it('overwrites existing task for same document', async () => {
+            const input = createInput();
+            await runner.enqueue([input]);
+            const firstTaskId = tasks.get('posts:doc-123')?.id;
+            await runner.enqueue([input]);
+            const secondTaskId = tasks.get('posts:doc-123')?.id;
+            expect(secondTaskId).not.toBe(firstTaskId);
+        });
+    });
+    describe('cancel', () => {
+        it('is a no-op (sync tasks cannot be cancelled)', async () => {
+            const input = createInput();
+            await runner.enqueue([input]);
+            const taskId = tasks.get('posts:doc-123')?.id;
+            await runner.cancel([taskId]);
+            // Task should still exist and be completed
+            expect(tasks.get('posts:doc-123')?.status).toBe('completed');
+        });
+    });
+    describe('run', () => {
+        it('returns not_found error (sync tasks run immediately)', async () => {
+            const result = await runner.run('some-task-id');
+            expect(result).toEqual({ success: false, error: 'not_found' });
+        });
+    });
+    describe('findByCollection', () => {
+        it('returns tasks for collection', async () => {
+            await runner.enqueue([
+                createInput({ collectionSlug: 'posts', collectionId: 'doc-1' }),
+                createInput({ collectionSlug: 'posts', collectionId: 'doc-2' }),
+                createInput({ collectionSlug: 'pages', collectionId: 'doc-3' }),
+            ]);
+            const postTasks = await runner.findByCollection('posts');
+            expect(postTasks).toHaveLength(2);
+            expect(postTasks.every((t) => t.input.collectionSlug === 'posts')).toBe(true);
+        });
+        it('filters by documentIds when provided', async () => {
+            await runner.enqueue([
+                createInput({ collectionId: 'doc-1' }),
+                createInput({ collectionId: 'doc-2' }),
+                createInput({ collectionId: 'doc-3' }),
+            ]);
+            const filteredTasks = await runner.findByCollection('posts', ['doc-1', 'doc-3']);
+            expect(filteredTasks).toHaveLength(2);
+            expect(filteredTasks.map((t) => t.input.collectionId).sort()).toEqual(['doc-1', 'doc-3']);
+        });
+        it('returns empty array when no tasks match', async () => {
+            await runner.enqueue([createInput()]);
+            const tasks = await runner.findByCollection('pages');
+            expect(tasks).toEqual([]);
+        });
+        it('returns empty array for empty documentIds', async () => {
+            await runner.enqueue([createInput()]);
+            const tasks = await runner.findByCollection('posts', []);
+            expect(tasks).toEqual([]);
+        });
+    });
+});

package/dist/server/modules/task-runner/sync-runner/index.d.ts

@@ -0,0 +1,2 @@
+export { createSyncRunner } from './SyncRunnerProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/modules/task-runner/sync-runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/task-runner/sync-runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/server/modules/task-runner/sync-runner/index.js

@@ -0,0 +1,3 @@
+export { createSyncRunner } from './SyncRunnerProvider';
+
+//# sourceMappingURL=index.js.map

package/dist/server/modules/task-runner/sync-runner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/server/modules/task-runner/sync-runner/index.ts"],"sourcesContent":["export { createSyncRunner } from './SyncRunnerProvider'\n"],"names":["createSyncRunner"],"mappings":"AAAA,SAASA,gBAAgB,QAAQ,uBAAsB"}

package/dist/server/modules/task-runner/sync-runner/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Options for SyncRunnerProvider
+ */
+export type SyncRunnerOptions = {
+    /**
+     * Maximum number of task results to keep in memory.
+     * When exceeded, oldest completed entries are removed.
+     * @default 100
+     */
+    maxSize?: number;
+    /**
+     * Time-to-live for completed task results in milliseconds.
+     * Expired entries are removed lazily during enqueue operations.
+     * @default 3600000 (1 hour)
+     */
+    ttlMs?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/modules/task-runner/sync-runner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/task-runner/sync-runner/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/server/modules/task-runner/sync-runner/types.js

@@ -0,0 +1,5 @@
+/**
+ * Options for SyncRunnerProvider
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/server/modules/task-runner/sync-runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/server/modules/task-runner/sync-runner/types.ts"],"sourcesContent":["/**\n * Options for SyncRunnerProvider\n */\nexport type SyncRunnerOptions = {\n  /**\n   * Maximum number of task results to keep in memory.\n   * When exceeded, oldest completed entries are removed.\n   * @default 100\n   */\n  maxSize?: number\n  /**\n   * Time-to-live for completed task results in milliseconds.\n   * Expired entries are removed lazily during enqueue operations.\n   * @default 3600000 (1 hour)\n   */\n  ttlMs?: number\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GACD,WAaC"}

package/dist/server/modules/task-runner/types.d.ts

@@ -0,0 +1,41 @@
+import type { CollectionSlug } from 'payload';
+/**
+ * Status of a translation task
+ */
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'failed';
+/**
+ * Input for creating a new translation task
+ */
+export type TaskInput = {
+    collectionSlug: CollectionSlug;
+    collectionId: string | number;
+    sourceLng: string;
+    targetLng: string;
+    strategy: 'overwrite' | 'skip_existing';
+    publishOnTranslation: boolean;
+};
+/**
+ * Normalized task representation
+ */
+export type Task = {
+    id: string;
+    status: TaskStatus;
+    input: TaskInput;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    error?: {
+        message: string;
+    };
+    cancelled: boolean;
+};
+/**
+ * Result of run operation
+ */
+export type RunResult = {
+    success: true;
+} | {
+    success: false;
+    error: 'not_found' | 'already_running' | 'already_completed';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/modules/task-runner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/task-runner/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,WAAW,GAAG,eAAe,CAAA;IACvC,oBAAoB,EAAE,OAAO,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,GAAG,mBAAmB,CAAA;CAAE,CAAA"}

package/dist/server/modules/task-runner/types.js

@@ -0,0 +1,5 @@
+/**
+ * Result of run operation
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/server/modules/task-runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/modules/task-runner/types.ts"],"sourcesContent":["import type { CollectionSlug } from 'payload'\n\n/**\n * Status of a translation task\n */\nexport type TaskStatus = 'pending' | 'running' | 'completed' | 'failed'\n\n/**\n * Input for creating a new translation task\n */\nexport type TaskInput = {\n  collectionSlug: CollectionSlug\n  collectionId: string | number\n  sourceLng: string\n  targetLng: string\n  strategy: 'overwrite' | 'skip_existing'\n  publishOnTranslation: boolean\n}\n\n/**\n * Normalized task representation\n */\nexport type Task = {\n  id: string\n  status: TaskStatus\n  input: TaskInput\n  createdAt: string\n  updatedAt: string\n  completedAt?: string\n  error?: { message: string }\n  cancelled: boolean\n}\n\n/**\n * Result of run operation\n */\nexport type RunResult =\n  | { success: true }\n  | { success: false; error: 'not_found' | 'already_running' | 'already_completed' }\n"],"names":[],"mappings":"AAiCA;;CAEC,GACD,WAEoF"}

package/dist/server/modules/translation-pipeline/TranslationPipeline.d.ts

@@ -0,0 +1,35 @@
+import type { TranslationProvider } from '../translation-providers';
+import type { PipelineConfig, PipelineResult } from './types';
+import type { TranslationStrategy } from './strategies';
+import type { TextExpander } from './stages';
+/**
+ * Options for TranslationPipeline.
+ */
+export type TranslationPipelineOptions = {
+    translationProvider: TranslationProvider;
+    translationStrategy: TranslationStrategy;
+    textExpanders?: TextExpander[];
+};
+/**
+ * Main orchestrator for the translation pipeline.
+ * Coordinates all stages in sequence via PipelineContext.
+ *
+ * Pipeline stages:
+ * 1. DataReconcilerStage - Reconcile source/target data preserving full document shape
+ * 2. FieldChunkCollectorStage - Collect FieldChunks (schema-aware)
+ * 3. TextChunkExpanderStage - Expand FieldChunks to TextChunks (schema-free)
+ * 4. TranslationStage - Call translation provider
+ * 5. TranslationMutatorStage - Apply translations via mutation
+ *
+ * Pipeline only transforms data. Saving is the caller's responsibility.
+ */
+export declare class TranslationPipeline {
+    private readonly stages;
+    constructor(options: TranslationPipelineOptions);
+    /**
+     * Executes the translation pipeline.
+     * Returns transformed data ready to be saved, or null if nothing to translate.
+     */
+    execute(config: PipelineConfig): Promise<PipelineResult | null>;
+}
+//# sourceMappingURL=TranslationPipeline.d.ts.map

package/dist/server/modules/translation-pipeline/TranslationPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationPipeline.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/translation-pipeline/TranslationPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAkC,MAAM,SAAS,CAAA;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAS5C;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,OAAO,EAAE,0BAA0B;IAU/C;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CA6BtE"}