@focus-reactive/payload-plugin-translator 0.1.0

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

@@ -0,0 +1,28 @@
+import { ServerResponse } from '../../shared';
+import { RunInputSchema } from './model';
+/**
+ * Runs a translation task by ID
+ */ export class RunTranslationHandler {
+    taskRunnerFactory;
+    constructor(taskRunnerFactory){
+        this.taskRunnerFactory = taskRunnerFactory;
+    }
+    async handle(req) {
+        const validationResult = RunInputSchema.safeParse(req.routeParams);
+        if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors);
+        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 === 'already_running') {
+                return ServerResponse.tooManyRequests('Translation task is already in progress');
+            }
+        }
+        return ServerResponse.noContent();
+    }
+}
+
+//# sourceMappingURL=handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/run-translation/handler.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { ServerResponse } from '../../shared'\nimport type { TaskRunnerProvider } from '../../modules/task-runner'\n\nimport { RunInputSchema } from './model'\n\n/**\n * Runs a translation task by ID\n */\nexport class RunTranslationHandler {\n  constructor(private readonly taskRunnerFactory: TaskRunnerProvider) {}\n\n  async handle(req: PayloadRequest): Promise<Response> {\n    const validationResult = RunInputSchema.safeParse(req.routeParams)\n    if (validationResult.error) return ServerResponse.validationError(validationResult.error.errors)\n\n    const { id } = validationResult.data\n    const runner = this.taskRunnerFactory.create(req.payload)\n    const result = await runner.run(id)\n\n    if (!result.success) {\n      if (result.error === 'not_found' || result.error === 'already_completed') {\n        return ServerResponse.notFound('Queued task not found')\n      }\n      if (result.error === 'already_running') {\n        return ServerResponse.tooManyRequests('Translation task is already in progress')\n      }\n    }\n\n    return ServerResponse.noContent()\n  }\n}\n"],"names":["ServerResponse","RunInputSchema","RunTranslationHandler","taskRunnerFactory","handle","req","validationResult","safeParse","routeParams","error","validationError","errors","id","data","runner","create","payload","result","run","success","notFound","tooManyRequests","noContent"],"mappings":"AAEA,SAASA,cAAc,QAAQ,eAAc;AAG7C,SAASC,cAAc,QAAQ,UAAS;AAExC;;CAEC,GACD,OAAO,MAAMC;;IACX,YAAY,AAAiBC,iBAAqC,CAAE;aAAvCA,oBAAAA;IAAwC;IAErE,MAAMC,OAAOC,GAAmB,EAAqB;QACnD,MAAMC,mBAAmBL,eAAeM,SAAS,CAACF,IAAIG,WAAW;QACjE,IAAIF,iBAAiBG,KAAK,EAAE,OAAOT,eAAeU,eAAe,CAACJ,iBAAiBG,KAAK,CAACE,MAAM;QAE/F,MAAM,EAAEC,EAAE,EAAE,GAAGN,iBAAiBO,IAAI;QACpC,MAAMC,SAAS,IAAI,CAACX,iBAAiB,CAACY,MAAM,CAACV,IAAIW,OAAO;QACxD,MAAMC,SAAS,MAAMH,OAAOI,GAAG,CAACN;QAEhC,IAAI,CAACK,OAAOE,OAAO,EAAE;YACnB,IAAIF,OAAOR,KAAK,KAAK,eAAeQ,OAAOR,KAAK,KAAK,qBAAqB;gBACxE,OAAOT,eAAeoB,QAAQ,CAAC;YACjC;YACA,IAAIH,OAAOR,KAAK,KAAK,mBAAmB;gBACtC,OAAOT,eAAeqB,eAAe,CAAC;YACxC;QACF;QAEA,OAAOrB,eAAesB,SAAS;IACjC;AACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.test.d.ts","sourceRoot":"","sources":["../../../../src/server/features/run-translation/handler.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,98 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { RunTranslationHandler } from './handler';
+describe('RunTranslationHandler', () => {
+    let handler;
+    let mockTaskRunner;
+    let mockTaskRunnerFactory;
+    const createMockRequest = (params = {}) => ({
+        payload: {},
+        routeParams: params,
+    });
+    beforeEach(() => {
+        mockTaskRunner = {
+            enqueue: vi.fn(),
+            cancel: vi.fn(),
+            run: vi.fn().mockResolvedValue({ success: true }),
+            findByCollection: vi.fn(),
+        };
+        mockTaskRunnerFactory = {
+            create: vi.fn().mockReturnValue(mockTaskRunner),
+            configure: vi.fn(),
+        };
+        handler = new RunTranslationHandler(mockTaskRunnerFactory);
+    });
+    describe('validation', () => {
+        it('returns validation error for missing id', async () => {
+            const req = createMockRequest({});
+            const response = await handler.handle(req);
+            expect(response.status).toBe(400);
+            const body = await response.json();
+            expect(body.message).toBe('Validation error');
+        });
+        it('returns validation error for empty id', async () => {
+            const req = createMockRequest({ id: '' });
+            const response = await handler.handle(req);
+            expect(response.status).toBe(400);
+        });
+    });
+    describe('success responses', () => {
+        it('returns 204 on successful run', async () => {
+            ;
+            mockTaskRunner.run.mockResolvedValue({ success: true });
+            const req = createMockRequest({ id: 'task-123' });
+            const response = await handler.handle(req);
+            expect(response.status).toBe(204);
+            expect(response.body).toBeNull();
+        });
+        it('calls runner.run with correct task id', async () => {
+            const req = createMockRequest({ id: 'task-456' });
+            await handler.handle(req);
+            expect(mockTaskRunner.run).toHaveBeenCalledWith('task-456');
+        });
+        it('creates task runner with request payload', async () => {
+            const mockPayload = { collections: {} };
+            const req = createMockRequest({ id: 'task-123' });
+            req.payload = mockPayload;
+            await handler.handle(req);
+            expect(mockTaskRunnerFactory.create).toHaveBeenCalledWith(mockPayload);
+        });
+    });
+    describe('error responses', () => {
+        it('returns 404 when task not found', async () => {
+            ;
+            mockTaskRunner.run.mockResolvedValue({
+                success: false,
+                error: 'not_found',
+            });
+            const req = createMockRequest({ id: 'non-existent' });
+            const response = await handler.handle(req);
+            expect(response.status).toBe(404);
+            const body = await response.json();
+            expect(body.message).toBe('Queued task not found');
+        });
+        it('returns 404 when task already completed', async () => {
+            ;
+            mockTaskRunner.run.mockResolvedValue({
+                success: false,
+                error: 'already_completed',
+            });
+            const req = createMockRequest({ id: 'completed-task' });
+            const response = await handler.handle(req);
+            expect(response.status).toBe(404);
+            const body = await response.json();
+            expect(body.message).toBe('Queued task not found');
+        });
+        it('returns 429 when task is already running', async () => {
+            ;
+            mockTaskRunner.run.mockResolvedValue({
+                success: false,
+                error: 'already_running',
+            });
+            const req = createMockRequest({ id: 'running-task' });
+            const response = await handler.handle(req);
+            expect(response.status).toBe(429);
+            const body = await response.json();
+            expect(body.message).toBe('Translation task is already in progress');
+        });
+    });
+});

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

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

package/dist/server/features/run-translation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/features/run-translation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}

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

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

package/dist/server/features/run-translation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/run-translation/index.ts"],"sourcesContent":["export { createRunRoute } from './route'\n"],"names":["createRunRoute"],"mappings":"AAAA,SAASA,cAAc,QAAQ,UAAS"}

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

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/**
+ * Input validation schema
+ */
+export declare const RunInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+//# sourceMappingURL=model.d.ts.map

package/dist/server/features/run-translation/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/server/features/run-translation/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;EAEzB,CAAA"}

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

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+/**
+ * Input validation schema
+ */ export const RunInputSchema = z.object({
+    id: z.string().nonempty()
+});
+
+//# sourceMappingURL=model.js.map

package/dist/server/features/run-translation/model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/run-translation/model.ts"],"sourcesContent":["import { z } from 'zod'\n\n/**\n * Input validation schema\n */\nexport const RunInputSchema = z.object({\n  id: z.string().nonempty(),\n})\n"],"names":["z","RunInputSchema","object","id","string","nonempty"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAK;AAEvB;;CAEC,GACD,OAAO,MAAMC,iBAAiBD,EAAEE,MAAM,CAAC;IACrCC,IAAIH,EAAEI,MAAM,GAAGC,QAAQ;AACzB,GAAE"}

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

@@ -0,0 +1,8 @@
+import type { Endpoint } from 'payload';
+import type { AccessGuard } from '../../shared';
+import type { TaskRunnerProvider } from '../../modules/task-runner';
+/**
+ * Creates the run translation endpoint
+ */
+export declare function createRunRoute(taskRunnerFactory: TaskRunnerProvider, access?: AccessGuard, basePath?: string): Endpoint;
+//# sourceMappingURL=route.d.ts.map

package/dist/server/features/run-translation/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../src/server/features/run-translation/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAInE;;GAEG;AACH,wBAAgB,cAAc,CAC5B,iBAAiB,EAAE,kBAAkB,EACrC,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,SAAe,GACtB,QAAQ,CAQV"}

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

@@ -0,0 +1,14 @@
+import { withErrorHandler, withAccessCheck } from '../../shared';
+import { RunTranslationHandler } from './handler';
+/**
+ * Creates the run translation endpoint
+ */ export function createRunRoute(taskRunnerFactory, access, basePath = '/translate') {
+    const handler = new RunTranslationHandler(taskRunnerFactory);
+    return {
+        path: `${basePath}/run/:id`,
+        method: 'post',
+        handler: withAccessCheck(withErrorHandler(handler.handle.bind(handler)), access)
+    };
+}
+
+//# sourceMappingURL=route.js.map

package/dist/server/features/run-translation/route.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/run-translation/route.ts"],"sourcesContent":["import type { Endpoint } from 'payload'\n\nimport { withErrorHandler, withAccessCheck } from '../../shared'\nimport type { AccessGuard } from '../../shared'\nimport type { TaskRunnerProvider } from '../../modules/task-runner'\n\nimport { RunTranslationHandler } from './handler'\n\n/**\n * Creates the run translation endpoint\n */\nexport function createRunRoute(\n  taskRunnerFactory: TaskRunnerProvider,\n  access?: AccessGuard,\n  basePath = '/translate',\n): Endpoint {\n  const handler = new RunTranslationHandler(taskRunnerFactory)\n\n  return {\n    path: `${basePath}/run/:id`,\n    method: 'post',\n    handler: withAccessCheck(withErrorHandler(handler.handle.bind(handler)), access),\n  }\n}\n"],"names":["withErrorHandler","withAccessCheck","RunTranslationHandler","createRunRoute","taskRunnerFactory","access","basePath","handler","path","method","handle","bind"],"mappings":"AAEA,SAASA,gBAAgB,EAAEC,eAAe,QAAQ,eAAc;AAIhE,SAASC,qBAAqB,QAAQ,YAAW;AAEjD;;CAEC,GACD,OAAO,SAASC,eACdC,iBAAqC,EACrCC,MAAoB,EACpBC,WAAW,YAAY;IAEvB,MAAMC,UAAU,IAAIL,sBAAsBE;IAE1C,OAAO;QACLI,MAAM,GAAGF,SAAS,QAAQ,CAAC;QAC3BG,QAAQ;QACRF,SAASN,gBAAgBD,iBAAiBO,QAAQG,MAAM,CAACC,IAAI,CAACJ,WAAWF;IAC3E;AACF"}

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

@@ -0,0 +1,19 @@
+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;
+};
+/**
+ * Translates a single document from source language to target language
+ */
+export declare class TranslateDocumentHandler implements Handler<TranslateDocumentInput, TranslateDocumentOutput> {
+    private readonly translationProvider;
+    private readonly schemaMap;
+    constructor(translationProvider: TranslationProvider, schemaMap: CollectionSchemaMap);
+    handle(payload: Payload, input: TranslateDocumentInput): Promise<TranslateDocumentOutput>;
+    private saveTranslatedDocument;
+}
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/server/features/translate-document/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,SAAS,CAAA;AAGjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAI9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEnG,MAAM,MAAM,6BAA6B,GAAG;IAC1C,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,SAAS,EAAE,mBAAmB,CAAA;CAC/B,CAAA;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,OAAO,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;IAErG,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,mBAAmB,EAAE,mBAAmB,EACxC,SAAS,EAAE,mBAAmB;IAG3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;YAuCjF,sBAAsB;CA6BrC"}

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

@@ -0,0 +1,69 @@
+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 {
+    translationProvider;
+    schemaMap;
+    constructor(translationProvider, schemaMap){
+        this.translationProvider = translationProvider;
+        this.schemaMap = schemaMap;
+    }
+    async handle(payload, input) {
+        const { collection, collectionId, sourceLng, targetLng, strategy, publishOnTranslation } = input;
+        // Get original schema (preserves localized: true on nested fields)
+        const schema = this.schemaMap.get(collection);
+        if (!schema) throw new APIError(`Collection "${collection}" not found in schemaMap`, 400);
+        const sourceData = await payload.findByID({
+            collection,
+            id: collectionId,
+            locale: sourceLng
+        });
+        const targetData = await payload.findByID({
+            collection,
+            id: collectionId,
+            locale: targetLng,
+            fallbackLocale: false
+        });
+        const translationStrategy = createTranslationStrategy(strategy);
+        const pipeline = new TranslationPipeline({
+            translationProvider: this.translationProvider,
+            translationStrategy
+        });
+        const result = await pipeline.execute({
+            schema,
+            sourceData,
+            targetData,
+            sourceLng,
+            targetLng
+        });
+        if (!result) return {
+            success: true
+        };
+        const collectionConfig = payload.collections[collection].config;
+        await this.saveTranslatedDocument(payload, collection, collectionId, result.translatedData, targetLng, sourceLng, collectionConfig, publishOnTranslation);
+        return {
+            success: true
+        };
+    }
+    async saveTranslatedDocument(payload, collection, collectionId, translatedData, targetLng, sourceLng, collectionConfig, publishOnTranslation) {
+        let isAutosaveEnabled = false;
+        const versions = collectionConfig.versions;
+        if (versions && versions.drafts) {
+            translatedData['_status'] = publishOnTranslation ? 'published' : 'draft';
+            const drafts = versions.drafts;
+            if (!publishOnTranslation && drafts.autosave) isAutosaveEnabled = true;
+        }
+        await payload.update({
+            collection: collection,
+            id: collectionId,
+            data: translatedData,
+            autosave: isAutosaveEnabled,
+            locale: targetLng,
+            fallbackLocale: sourceLng
+        });
+    }
+}
+
+//# sourceMappingURL=handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/translate-document/handler.ts"],"sourcesContent":["import type { Payload, SanitizedCollectionConfig } from 'payload'\nimport { APIError } from 'payload'\n\nimport type { Handler } from '../../shared'\nimport type { TranslationProvider } from '../../modules/translation-providers'\nimport { TranslationPipeline } from '../../modules/translation-pipeline'\nimport { createTranslationStrategy } from '../../modules/translation-pipeline/strategies'\n\nimport type { CollectionSchemaMap, TranslateDocumentInput, TranslateDocumentOutput } from './model'\n\nexport type TranslateDocumentDependencies = {\n  translationProvider: TranslationProvider\n  schemaMap: CollectionSchemaMap\n}\n\n/**\n * Translates a single document from source language to target language\n */\nexport class TranslateDocumentHandler implements Handler<TranslateDocumentInput, TranslateDocumentOutput> {\n  constructor(\n    private readonly translationProvider: TranslationProvider,\n    private readonly schemaMap: CollectionSchemaMap,\n  ) {}\n\n  async handle(payload: Payload, input: TranslateDocumentInput): Promise<TranslateDocumentOutput> {\n    const { collection, collectionId, sourceLng, targetLng, strategy, publishOnTranslation } = input\n\n    // Get original schema (preserves localized: true on nested fields)\n    const schema = this.schemaMap.get(collection)\n    if (!schema) throw new APIError(`Collection \"${collection}\" not found in schemaMap`, 400)\n\n    const sourceData = await payload.findByID({ collection, id: collectionId, locale: sourceLng })\n    const targetData = await payload.findByID({\n      collection,\n      id: collectionId,\n      locale: targetLng,\n      fallbackLocale: false,\n    })\n\n    const translationStrategy = createTranslationStrategy(strategy)\n    const pipeline = new TranslationPipeline({\n      translationProvider: this.translationProvider,\n      translationStrategy,\n    })\n\n    const result = await pipeline.execute({ schema, sourceData, targetData, sourceLng, targetLng })\n    if (!result) return { success: true }\n\n    const collectionConfig = payload.collections[collection].config\n    await this.saveTranslatedDocument(\n      payload,\n      collection,\n      collectionId,\n      result.translatedData,\n      targetLng,\n      sourceLng,\n      collectionConfig,\n      publishOnTranslation,\n    )\n\n    return { success: true }\n  }\n\n  private async saveTranslatedDocument(\n    payload: Payload,\n    collection: string,\n    collectionId: string | number,\n    translatedData: Record<string, unknown>,\n    targetLng: string,\n    sourceLng: string,\n    collectionConfig: SanitizedCollectionConfig,\n    publishOnTranslation: boolean,\n  ): Promise<void> {\n    let isAutosaveEnabled = false\n    const versions = collectionConfig.versions\n\n    if (versions && versions.drafts) {\n      translatedData['_status'] = publishOnTranslation ? 'published' : 'draft'\n\n      const drafts = versions.drafts\n      if (!publishOnTranslation && drafts.autosave) isAutosaveEnabled = true\n    }\n\n    await payload.update({\n      collection: collection,\n      id: collectionId,\n      data: translatedData,\n      autosave: isAutosaveEnabled,\n      locale: targetLng,\n      fallbackLocale: sourceLng,\n    })\n  }\n}\n"],"names":["APIError","TranslationPipeline","createTranslationStrategy","TranslateDocumentHandler","translationProvider","schemaMap","handle","payload","input","collection","collectionId","sourceLng","targetLng","strategy","publishOnTranslation","schema","get","sourceData","findByID","id","locale","targetData","fallbackLocale","translationStrategy","pipeline","result","execute","success","collectionConfig","collections","config","saveTranslatedDocument","translatedData","isAutosaveEnabled","versions","drafts","autosave","update","data"],"mappings":"AACA,SAASA,QAAQ,QAAQ,UAAS;AAIlC,SAASC,mBAAmB,QAAQ,qCAAoC;AACxE,SAASC,yBAAyB,QAAQ,gDAA+C;AASzF;;CAEC,GACD,OAAO,MAAMC;;;IACX,YACE,AAAiBC,mBAAwC,EACzD,AAAiBC,SAA8B,CAC/C;aAFiBD,sBAAAA;aACAC,YAAAA;IAChB;IAEH,MAAMC,OAAOC,OAAgB,EAAEC,KAA6B,EAAoC;QAC9F,MAAM,EAAEC,UAAU,EAAEC,YAAY,EAAEC,SAAS,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,oBAAoB,EAAE,GAAGN;QAE3F,mEAAmE;QACnE,MAAMO,SAAS,IAAI,CAACV,SAAS,CAACW,GAAG,CAACP;QAClC,IAAI,CAACM,QAAQ,MAAM,IAAIf,SAAS,CAAC,YAAY,EAAES,WAAW,wBAAwB,CAAC,EAAE;QAErF,MAAMQ,aAAa,MAAMV,QAAQW,QAAQ,CAAC;YAAET;YAAYU,IAAIT;YAAcU,QAAQT;QAAU;QAC5F,MAAMU,aAAa,MAAMd,QAAQW,QAAQ,CAAC;YACxCT;YACAU,IAAIT;YACJU,QAAQR;YACRU,gBAAgB;QAClB;QAEA,MAAMC,sBAAsBrB,0BAA0BW;QACtD,MAAMW,WAAW,IAAIvB,oBAAoB;YACvCG,qBAAqB,IAAI,CAACA,mBAAmB;YAC7CmB;QACF;QAEA,MAAME,SAAS,MAAMD,SAASE,OAAO,CAAC;YAAEX;YAAQE;YAAYI;YAAYV;YAAWC;QAAU;QAC7F,IAAI,CAACa,QAAQ,OAAO;YAAEE,SAAS;QAAK;QAEpC,MAAMC,mBAAmBrB,QAAQsB,WAAW,CAACpB,WAAW,CAACqB,MAAM;QAC/D,MAAM,IAAI,CAACC,sBAAsB,CAC/BxB,SACAE,YACAC,cACAe,OAAOO,cAAc,EACrBpB,WACAD,WACAiB,kBACAd;QAGF,OAAO;YAAEa,SAAS;QAAK;IACzB;IAEA,MAAcI,uBACZxB,OAAgB,EAChBE,UAAkB,EAClBC,YAA6B,EAC7BsB,cAAuC,EACvCpB,SAAiB,EACjBD,SAAiB,EACjBiB,gBAA2C,EAC3Cd,oBAA6B,EACd;QACf,IAAImB,oBAAoB;QACxB,MAAMC,WAAWN,iBAAiBM,QAAQ;QAE1C,IAAIA,YAAYA,SAASC,MAAM,EAAE;YAC/BH,cAAc,CAAC,UAAU,GAAGlB,uBAAuB,cAAc;YAEjE,MAAMqB,SAASD,SAASC,MAAM;YAC9B,IAAI,CAACrB,wBAAwBqB,OAAOC,QAAQ,EAAEH,oBAAoB;QACpE;QAEA,MAAM1B,QAAQ8B,MAAM,CAAC;YACnB5B,YAAYA;YACZU,IAAIT;YACJ4B,MAAMN;YACNI,UAAUH;YACVb,QAAQR;YACRU,gBAAgBX;QAClB;IACF;AACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.test.d.ts","sourceRoot":"","sources":["../../../../src/server/features/translate-document/handler.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,171 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { APIError } from 'payload';
+import { TranslateDocumentHandler } from './handler';
+// Mock TranslationPipeline
+vi.mock('../../modules/translation-pipeline', () => ({
+    TranslationPipeline: vi.fn().mockImplementation(() => ({
+        execute: vi.fn().mockResolvedValue(null),
+    })),
+}));
+// Mock createTranslationStrategy
+vi.mock('../../modules/translation-pipeline/strategies', () => ({
+    createTranslationStrategy: vi.fn().mockReturnValue({}),
+}));
+describe('TranslateDocumentHandler', () => {
+    let handler;
+    let mockTranslationProvider;
+    let mockSchemaMap;
+    let mockPayload;
+    const createInput = (overrides = {}) => ({
+        collection: 'posts',
+        collectionId: 'doc-123',
+        sourceLng: 'en',
+        targetLng: 'de',
+        strategy: 'overwrite',
+        publishOnTranslation: false,
+        ...overrides,
+    });
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockTranslationProvider = {
+            translate: vi.fn().mockResolvedValue({}),
+        };
+        mockSchemaMap = new Map([
+            ['posts', [{ name: 'title', type: 'text', localized: true }]],
+            ['pages', [{ name: 'content', type: 'richText', localized: true }]],
+        ]);
+        mockPayload = {
+            findByID: vi.fn().mockResolvedValue({ id: 'doc-123', title: 'Test' }),
+            update: vi.fn().mockResolvedValue({}),
+            collections: {
+                posts: {
+                    config: {
+                        versions: undefined,
+                    },
+                },
+                pages: {
+                    config: {
+                        versions: {
+                            drafts: true,
+                        },
+                    },
+                },
+            },
+        };
+        handler = new TranslateDocumentHandler(mockTranslationProvider, mockSchemaMap);
+    });
+    describe('schema validation', () => {
+        it('throws APIError when collection not in schemaMap', async () => {
+            const input = createInput({ collection: 'unknown' });
+            await expect(handler.handle(mockPayload, input)).rejects.toThrow(APIError);
+            await expect(handler.handle(mockPayload, input)).rejects.toThrow('Collection "unknown" not found in schemaMap');
+        });
+    });
+    describe('document fetching', () => {
+        it('fetches source document with source locale', async () => {
+            const input = createInput({ sourceLng: 'en' });
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.findByID).toHaveBeenCalledWith({
+                collection: 'posts',
+                id: 'doc-123',
+                locale: 'en',
+            });
+        });
+        it('fetches target document with target locale and no fallback', async () => {
+            const input = createInput({ targetLng: 'de' });
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.findByID).toHaveBeenCalledWith({
+                collection: 'posts',
+                id: 'doc-123',
+                locale: 'de',
+                fallbackLocale: false,
+            });
+        });
+    });
+    describe('success responses', () => {
+        it('returns success when no translation needed (pipeline returns null)', async () => {
+            const input = createInput();
+            const result = await handler.handle(mockPayload, input);
+            expect(result).toEqual({ success: true });
+            expect(mockPayload.update).not.toHaveBeenCalled();
+        });
+        it('returns success after saving translated document', async () => {
+            const { TranslationPipeline } = await import('../../modules/translation-pipeline');
+            TranslationPipeline.mockImplementation(() => ({
+                execute: vi.fn().mockResolvedValue({ translatedData: { title: 'Übersetzter Titel' } }),
+            }));
+            const input = createInput();
+            const result = await handler.handle(mockPayload, input);
+            expect(result).toEqual({ success: true });
+        });
+    });
+    describe('saving translated documents', () => {
+        beforeEach(async () => {
+            const { TranslationPipeline } = await import('../../modules/translation-pipeline');
+            TranslationPipeline.mockImplementation(() => ({
+                execute: vi.fn().mockResolvedValue({ translatedData: { title: 'Translated' } }),
+            }));
+        });
+        it('saves document with target locale and source as fallback', async () => {
+            const input = createInput({ sourceLng: 'en', targetLng: 'fr' });
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.update).toHaveBeenCalledWith(expect.objectContaining({
+                collection: 'posts',
+                id: 'doc-123',
+                locale: 'fr',
+                fallbackLocale: 'en',
+            }));
+        });
+        it('saves document without autosave when versions not enabled', async () => {
+            const input = createInput();
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.update).toHaveBeenCalledWith(expect.objectContaining({
+                autosave: false,
+            }));
+        });
+        it('sets _status to draft when versions with drafts enabled', async () => {
+            ;
+            mockPayload.collections['posts'].config.versions = { drafts: true };
+            const input = createInput();
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.update).toHaveBeenCalledWith(expect.objectContaining({
+                data: expect.objectContaining({
+                    _status: 'draft',
+                }),
+            }));
+        });
+        it('sets _status to published when publishOnTranslation is true', async () => {
+            ;
+            mockPayload.collections['posts'].config.versions = { drafts: true };
+            const input = createInput({ publishOnTranslation: true });
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.update).toHaveBeenCalledWith(expect.objectContaining({
+                data: expect.objectContaining({
+                    _status: 'published',
+                }),
+            }));
+        });
+        it('uses autosave when drafts with autosave enabled and not publishing', async () => {
+            ;
+            mockPayload.collections['posts'].config.versions = {
+                drafts: { autosave: true },
+            };
+            const input = createInput();
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.update).toHaveBeenCalledWith(expect.objectContaining({
+                autosave: true,
+            }));
+        });
+        it('does not use autosave when publishing', async () => {
+            ;
+            mockPayload.collections['posts'].config.versions = {
+                drafts: { autosave: true },
+            };
+            const input = createInput({ publishOnTranslation: true });
+            await handler.handle(mockPayload, input);
+            expect(mockPayload.update).toHaveBeenCalledWith(expect.objectContaining({
+                autosave: false,
+            }));
+        });
+    });
+});

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

@@ -0,0 +1,4 @@
+export { createTranslateDocumentTask, createAutoRunConfig, TASK_NAME, QUEUE_NAME } from './task';
+export { TranslateDocumentHandler } from './handler';
+export type { CollectionSchemaMap, AutoRunConfig } from './model';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/features/translate-document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAChG,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/translate-document/index.ts"],"sourcesContent":["export { createTranslateDocumentTask, createAutoRunConfig, TASK_NAME, QUEUE_NAME } from './task'\nexport { TranslateDocumentHandler } from './handler'\nexport type { CollectionSchemaMap, AutoRunConfig } from './model'\n"],"names":["createTranslateDocumentTask","createAutoRunConfig","TASK_NAME","QUEUE_NAME","TranslateDocumentHandler"],"mappings":"AAAA,SAASA,2BAA2B,EAAEC,mBAAmB,EAAEC,SAAS,EAAEC,UAAU,QAAQ,SAAQ;AAChG,SAASC,wBAAwB,QAAQ,YAAW"}

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

@@ -0,0 +1,53 @@
+import type { CollectionSlug, Field } from 'payload';
+import type { TranslationStrategyName } from '../../modules/translation-pipeline/strategies';
+/**
+ * Input for the translate document handler
+ */
+export type TranslateDocumentInput = {
+    collection: CollectionSlug;
+    collectionId: string | number;
+    sourceLng: string;
+    targetLng: string;
+    strategy: TranslationStrategyName;
+    publishOnTranslation: boolean;
+};
+/**
+ * Output of the translate document handler
+ */
+export type TranslateDocumentOutput = {
+    success: true;
+};
+/**
+ * Map of collection slug to original field schema.
+ * 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;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/server/features/translate-document/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAA;AAE5F;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,cAAc,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,uBAAuB,CAAA;IACjC,oBAAoB,EAAE,OAAO,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,IAAI,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,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,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,EAmBlC,CAAA;AAED,eAAO,MAAM,SAAS,EAAG,oBAA6B,CAAA;AACtD,eAAO,MAAM,UAAU,EAAG,cAAuB,CAAA;AACjD,eAAO,MAAM,gBAAgB,EAAE,aAG9B,CAAA"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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
+};
+
+//# sourceMappingURL=model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/features/translate-document/model.ts"],"sourcesContent":["import type { CollectionSlug, Field } from 'payload'\nimport type { TranslationStrategyName } from '../../modules/translation-pipeline/strategies'\n\n/**\n * Input for the translate document handler\n */\nexport type TranslateDocumentInput = {\n  collection: CollectionSlug\n  collectionId: string | number\n  sourceLng: string\n  targetLng: string\n  strategy: TranslationStrategyName\n  publishOnTranslation: boolean\n}\n\n/**\n * Output of the translate document handler\n */\nexport type TranslateDocumentOutput = {\n  success: true\n}\n\n/**\n * Map of collection slug to original field schema.\n * Used to access original schemas before Payload sanitization.\n */\nexport type CollectionSchemaMap = Map<CollectionSlug, Field[]>\n\n/**\n * Payload task configuration\n */\nexport type TaskConfig = {\n  collections: CollectionSlug[]\n  retries?: {\n    attempts?: number\n    backoff?: { delay?: number; type: 'exponential' | 'fixed' }\n  }\n}\n\n/**\n * Auto-run configuration for the job queue\n */\nexport type AutoRunConfig = {\n  cron?: string\n  limit?: number\n  queue?: string\n}\n\n/**\n * Payload input schema for the task\n */\nexport const taskInputSchema: Field[] = [\n  {\n    type: 'relationship',\n    name: 'collection',\n    relationTo: [], // Will be populated with actual collections\n    required: true,\n  },\n  {\n    type: 'text',\n    maxLength: 256,\n    name: 'source_lng',\n    required: true,\n  },\n  {\n    type: 'text',\n    maxLength: 256,\n    name: 'target_lng',\n    required: true,\n  },\n]\n\nexport const TASK_NAME = 'translate_document' as const\nexport const QUEUE_NAME = 'translations' as const\nexport const DEFAULT_AUTO_RUN: AutoRunConfig = {\n  cron: '* * * * *',\n  limit: 50,\n}\n"],"names":["taskInputSchema","type","name","relationTo","required","maxLength","TASK_NAME","QUEUE_NAME","DEFAULT_AUTO_RUN","cron","limit"],"mappings":"AAgDA;;CAEC,GACD,OAAO,MAAMA,kBAA2B;IACtC;QACEC,MAAM;QACNC,MAAM;QACNC,YAAY,EAAE;QACdC,UAAU;IACZ;IACA;QACEH,MAAM;QACNI,WAAW;QACXH,MAAM;QACNE,UAAU;IACZ;IACA;QACEH,MAAM;QACNI,WAAW;QACXH,MAAM;QACNE,UAAU;IACZ;CACD,CAAA;AAED,OAAO,MAAME,YAAY,qBAA6B;AACtD,OAAO,MAAMC,aAAa,eAAuB;AACjD,OAAO,MAAMC,mBAAkC;IAC7CC,MAAM;IACNC,OAAO;AACT,EAAC"}