@focus-reactive/payload-plugin-translator 0.3.0 → 0.5.0

package/README.md

@@ -12,6 +12,7 @@ Translation plugin for Payload CMS 3.x. Automatically translate your localized c
 - **Pluggable providers** — use OpenAI or create custom translation providers
 - **Field exclusion** — exclude specific fields from translation via `withFieldTranslation`
 - **Translation strategies** — choose between overwrite all or skip existing translations
+- **Configurable surfaces** — enable the per-document popup and/or the bulk-collection dashboard via the `levels` option _(since v0.5.0)_
 
 ## Installation
 
@@ -33,11 +34,7 @@ yarn add @focus-reactive/payload-plugin-translator
 
 ```typescript
 import { buildConfig } from "payload";
-import {
-  translatorPlugin,
-  createOpenAIProvider,
-  createPayloadJobsRunner,
-} from "@focus-reactive/payload-plugin-translator";
+import { translatorPlugin, createOpenAIProvider, createPayloadJobsRunner } from "@focus-reactive/payload-plugin-translator";
 import { Posts } from "./collections/Posts";
 import { Pages } from "./collections/Pages";
 
@@ -65,13 +62,14 @@ export default buildConfig({
 
 Configuration for `translatorPlugin()`.
 
-| Property              | Type                  | Required | Default        | Description                                                                                                         |
-| --------------------- | --------------------- | -------- | -------------- | ------------------------------------------------------------------------------------------------------------------- |
-| `collections`         | `CollectionConfig[]`  | Yes      | —              | Original collection configs to enable translation for. Must be the same objects passed to `buildConfig`, not slugs. |
-| `translationProvider` | `TranslationProvider` | Yes      | —              | Translation provider instance (e.g., `createOpenAIProvider(...)`)                                                   |
-| `runner`              | `TaskRunnerProvider`  | Yes      | —              | Task runner provider for background processing (e.g., `createPayloadJobsRunner()`)                                  |
-| `access`              | `AccessGuard`         | No       | `undefined`    | Access control function for translation endpoints                                                                   |
-| `basePath`            | `string`              | No       | `'/translate'` | Base path for all API endpoints                                                                                     |
+| Property              | Type                  | Required | Default                                | Description                                                                                                         |
+| --------------------- | --------------------- | -------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `collections`         | `CollectionConfig[]`  | Yes      | —                                      | Original collection configs to enable translation for. Must be the same objects passed to `buildConfig`, not slugs. |
+| `translationProvider` | `TranslationProvider` | Yes      | —                                      | Translation provider instance (e.g., `createOpenAIProvider(...)`)                                                   |
+| `runner`              | `TaskRunnerProvider`  | Yes      | —                                      | Task runner provider for background processing (e.g., `createPayloadJobsRunner()`)                                  |
+| `access`              | `AccessGuard`         | No       | `undefined`                            | Access guard (`{ check }`) for the translation endpoints; omit to leave them open                                   |
+| `basePath`            | `string`              | No       | `'/translate'`                         | Base path for all API endpoints                                                                                     |
+| `levels`              | `TranslationLevel[]`  | No       | `[documentLevel(), collectionLevel()]` | Which translation surfaces to enable. See [Translation Levels](#translation-levels)                                 |
 
 ```typescript
 translatorPlugin({
@@ -80,11 +78,37 @@ translatorPlugin({
     apiKey: process.env.OPENAI_API_KEY,
   }),
   runner: createPayloadJobsRunner(),
-  access: async ({ req }) => req.user?.role === "admin",
+  access: { check: ({ req }) => req.user?.role === "admin" },
   basePath: "/translate",
 });
 ```
 
+### Translation Levels
+
+_Since v0.5.0._
+
+The `levels` option controls which translation surfaces the plugin exposes. Each entry is a factory you import and list:
+
+- `documentLevel()` — a **Translate** popup on the document edit view (translate one document).
+- `collectionLevel()` — a **bulk dashboard** on the collection list view (translate many at once).
+
+Both run through the configured `runner` (async Payload Jobs by default, or synchronous via `createSyncRunner()`) and share the same translation REST API.
+
+```typescript
+import { translatorPlugin, documentLevel, collectionLevel, createOpenAIProvider, createPayloadJobsRunner } from "@focus-reactive/payload-plugin-translator";
+
+translatorPlugin({
+  collections: [Posts],
+  translationProvider: createOpenAIProvider({
+    apiKey: process.env.OPENAI_API_KEY,
+  }),
+  runner: createPayloadJobsRunner(),
+  levels: [collectionLevel()], // bulk dashboard only — no per-document popup
+});
+```
+
+Omit `levels` for the default `[documentLevel(), collectionLevel()]`, which is identical to the previous behaviour — so adopting this option is non-breaking. A synchronous `fieldLevel()` (in-place field translation) is planned for a later release.
+
 ### OpenAIProviderConfig
 
 Configuration for `createOpenAIProvider()`.
@@ -100,8 +124,7 @@ Configuration for `createOpenAIProvider()`.
 createOpenAIProvider({
   apiKey: process.env.OPENAI_API_KEY,
   model: "gpt-4o-mini",
-  systemPrompt: ({ sourceLang, targetLang, defaultPrompt }) =>
-    `${defaultPrompt}\nUse formal language. Keep brand names unchanged.`,
+  systemPrompt: ({ sourceLang, targetLang, defaultPrompt }) => `${defaultPrompt}\nUse formal language. Keep brand names unchanged.`,
   dryRun: false,
 });
 ```
@@ -165,10 +188,7 @@ Configuration for `withFieldTranslation()` helper or `field.custom.translateKit`
 ```typescript
 import { withFieldTranslation } from "@focus-reactive/payload-plugin-translator";
 
-withFieldTranslation(
-  { name: "sku", type: "text", localized: true },
-  { exclude: true },
-);
+withFieldTranslation({ name: "sku", type: "text", localized: true }, { exclude: true });
 ```
 
 ## Translation Strategies
@@ -310,20 +330,12 @@ type TranslationOutput = Record<TranslationIndex, string>;
 #### Example Implementation
 
 ```typescript
-import type {
-  TranslationProvider,
-  TranslationInput,
-  TranslationOutput,
-} from "@focus-reactive/payload-plugin-translator";
+import type { TranslationProvider, TranslationInput, TranslationOutput } from "@focus-reactive/payload-plugin-translator";
 
 class DeepLProvider implements TranslationProvider {
   constructor(private apiKey: string) {}
 
-  async translate(
-    content: TranslationInput,
-    sourceLng: string,
-    targetLng: string,
-  ): Promise<TranslationOutput | null> {
+  async translate(content: TranslationInput, sourceLng: string, targetLng: string): Promise<TranslationOutput | null> {
     try {
       // content example: { "0": "Hello", "1": "World" }
       const texts = Object.values(content);
@@ -401,6 +413,9 @@ import type {
 
   // Field config
   FieldTranslationConfig,
+
+  // Translation levels
+  TranslationLevel,
 } from "@focus-reactive/payload-plugin-translator";
 ```
 

package/dist/index.d.ts

@@ -1,14 +1,16 @@
-export { translatorPlugin } from './plugin';
-export type { TranslatorPluginConfig } from './plugin';
-export type { AccessGuard, AccessGuardRequest } from './types/AccessGuard';
-export { createOpenAIProvider } from './server/modules/translation-providers';
-export type { TranslationProvider, TranslationInput, TranslationOutput, OpenAIProviderConfig, DryRunConfig, } from './server/modules/translation-providers';
-export { createPayloadJobsRunner, createSyncRunner } from './server/modules/task-runner';
-export type { TaskRunnerProvider, PayloadJobsRunnerOptions } from './server/modules/task-runner';
-export { withFieldTranslation } from './field-config';
-export type { FieldTranslationConfig } from './field-config';
-export { createTranslatePlugin, TranslateCollectionPlugin } from './plugin';
-export type { TranslateCollectionPluginConfig } from './plugin';
-export { OpenAITranslationProvider } from './server/modules/translation-providers';
-export { translateKitField } from './field-config';
-export type { TranslateKitFieldConfig } from './field-config';
+export { translatorPlugin } from "./plugin";
+export type { TranslatorPluginConfig } from "./plugin";
+export type { AccessGuard, AccessGuardRequest } from "./types/AccessGuard";
+export { createOpenAIProvider } from "./server/modules/translation-providers";
+export type { TranslationProvider, TranslationInput, TranslationOutput, OpenAIProviderConfig, DryRunConfig } from "./server/modules/translation-providers";
+export { createPayloadJobsRunner, createSyncRunner } from "./server/modules/task-runner";
+export type { TaskRunnerProvider, PayloadJobsRunnerOptions } from "./server/modules/task-runner";
+export { documentLevel, collectionLevel } from "./server/modules/translation-levels";
+export type { TranslationLevel } from "./server/modules/translation-levels";
+export { withFieldTranslation } from "./field-config";
+export type { FieldTranslationConfig } from "./field-config";
+export { createTranslatePlugin, TranslateCollectionPlugin } from "./plugin";
+export type { TranslateCollectionPluginConfig } from "./plugin";
+export { OpenAITranslationProvider } from "./server/modules/translation-providers";
+export { translateKitField } from "./field-config";
+export type { TranslateKitFieldConfig } from "./field-config";

package/dist/index.js

@@ -1,14 +1,16 @@
 // Main plugin
-export { translatorPlugin } from './plugin';
+export { translatorPlugin } from "./plugin";
 // Translation providers
-export { createOpenAIProvider } from './server/modules/translation-providers';
+export { createOpenAIProvider } from "./server/modules/translation-providers";
 // Task runners
-export { createPayloadJobsRunner, createSyncRunner } from './server/modules/task-runner';
+export { createPayloadJobsRunner, createSyncRunner } from "./server/modules/task-runner";
+// Translation levels
+export { documentLevel, collectionLevel } from "./server/modules/translation-levels";
 // Field config
-export { withFieldTranslation } from './field-config';
+export { withFieldTranslation } from "./field-config";
 // Deprecated exports (for backwards compatibility)
-export { createTranslatePlugin, TranslateCollectionPlugin } from './plugin';
-export { OpenAITranslationProvider } from './server/modules/translation-providers';
-export { translateKitField } from './field-config';
+export { createTranslatePlugin, TranslateCollectionPlugin } from "./plugin";
+export { OpenAITranslationProvider } from "./server/modules/translation-providers";
+export { translateKitField } from "./field-config";
 
 //# sourceMappingURL=index.js.map

package/dist/plugin.d.ts

@@ -1,7 +1,8 @@
-import type { CollectionConfig, Config } from 'payload';
-import type { AccessGuard } from './types/AccessGuard';
-import type { TranslationProvider } from './server/modules/translation-providers';
-import type { TaskRunnerProvider } from './server/modules/task-runner';
+import type { CollectionConfig, Config } from "payload";
+import type { AccessGuard } from "./types/AccessGuard";
+import type { TranslationProvider } from "./server/modules/translation-providers";
+import type { TaskRunnerProvider } from "./server/modules/task-runner";
+import type { TranslationLevel } from "./server/modules/translation-levels";
 export type TranslatorPluginConfig = {
     /**
      * Original collection configs (same objects passed to buildConfig).
@@ -32,6 +33,16 @@ export type TranslatorPluginConfig = {
      * @default '/translate'
      */
     basePath?: string;
+    /**
+     * Which translation surfaces to enable, as level factories — `documentLevel()`,
+     * `collectionLevel()` (and, from a later phase, `fieldLevel()`). Omit for the
+     * default `[documentLevel(), collectionLevel()]`, which is exactly today's behaviour.
+     * Each level should appear at most once: endpoints are deduplicated, but admin
+     * components are not, so a duplicated level renders a duplicated control.
+     * @default [documentLevel(), collectionLevel()]
+     * @since 0.5.0
+     */
+    levels?: TranslationLevel[];
 };
 /** @deprecated Use `TranslatorPluginConfig` instead */
 export type TranslateCollectionPluginConfig = TranslatorPluginConfig;

package/dist/plugin.js

@@ -1,14 +1,8 @@
-import { CacheProviderExport } from './client/app/cache/CacheProvider.export';
-import { BulkDocumentTranslationDashboard } from './client/widgets/bulk-translation-dashboard/ui/BulkTranslationDashboard.export';
-import { TranslateDocumentExport } from './client/widgets/translate-document';
-import { TranslateDocumentHandler } from './server/features/translate-document';
-import { createEnqueueRoute } from './server/features/enqueue-translation';
-import { createRunRoute } from './server/features/run-translation';
-import { createCancelRoute } from './server/features/cancel';
-import { createCancelByCollectionRoute } from './server/features/cancel-by-collection';
-import { createGetDocumentStatusRoute } from './server/features/get-document-status';
-import { createGetCollectionStatusRoute } from './server/features/get-collection-status';
-import { normalizePath, pipe } from './server/shared';
+import { CacheProviderExport } from "./client/app/cache/CacheProvider.export";
+import { TranslateDocumentHandler } from "./server/features/translate-document";
+import { documentLevel, collectionLevel } from "./server/modules/translation-levels";
+import { PluginConfigBuilder } from "./server/modules/translation-levels/PluginConfigBuilder";
+import { normalizePath } from "./server/shared";
 /** @deprecated Use `translatorPlugin` function instead */ export class TranslateCollectionPlugin {
     pluginConfig;
     constructor(pluginConfig){
@@ -16,7 +10,7 @@ import { normalizePath, pipe } from './server/shared';
     }
     init() {
         return async (config)=>{
-            const { access, translationProvider, basePath: rawBasePath = '/translate' } = this.pluginConfig;
+            const { access, translationProvider, runner, collections, levels, basePath: rawBasePath = "/translate" } = this.pluginConfig;
             // Build schema map from deep-cloned collections
             // Deep clone is required because Payload mutates the original collection objects,
             // removing `localized: true` from nested fields during sanitization.
@@ -25,14 +19,14 @@ import { normalizePath, pipe } from './server/shared';
             // TODO: Consider introducing a FieldLike interface with only the properties
             // used by the pipeline (name, type, localized, fields, blocks, tabs, custom)
             // to make the contract explicit and avoid reliance on JSON round-trip.
-            const schemaMap = new Map(this.pluginConfig.collections.map((col)=>[
+            const schemaMap = new Map(collections.map((col)=>[
                     col.slug,
                     JSON.parse(JSON.stringify(col.fields))
                 ]));
             const collectionSlugs = new Set(schemaMap.keys());
             const basePath = normalizePath(rawBasePath);
             const translateHandler = new TranslateDocumentHandler(translationProvider, schemaMap);
-            const runnerConfigModifier = this.pluginConfig.runner.configure({
+            const runnerContext = {
                 handler: async (payload, input)=>{
                     await translateHandler.handle(payload, {
                         collection: input.collection,
@@ -44,50 +38,33 @@ import { normalizePath, pipe } from './server/shared';
                     });
                 },
                 collections: Array.from(collectionSlugs)
+            };
+            const runnerConfigModifier = runner.configure(runnerContext);
+            // Bind the context once so routes receive a self-sufficient factory: the
+            // runner needs no mutable per-instance handler state and create() has no
+            // "configure() must run first" ordering coupling (translator plan, 0c).
+            const taskRunnerFactory = {
+                create: (payload)=>runner.create(payload, runnerContext.handler)
+            };
+            const activeLevels = levels ?? [
+                documentLevel(),
+                collectionLevel()
+            ];
+            const builder = new PluginConfigBuilder({
+                collections,
+                basePath,
+                access,
+                taskRunnerFactory
             });
-            return pipe(// 1. Set up UI component provider import
-            (cfg)=>{
-                if (!cfg.admin) cfg.admin = {};
-                if (!cfg.admin.components) cfg.admin.components = {};
-                if (!cfg.admin.components.providers) cfg.admin.components.providers = [];
-                cfg.admin.components.providers.push(new CacheProviderExport(basePath));
-                return cfg;
-            }, // 2. Set up UI component import
-            (cfg)=>{
-                cfg.collections?.forEach((collection)=>{
-                    if (!collectionSlugs.has(collection.slug)) {
-                        return;
-                    }
-                    if (!collection.admin) collection.admin = {};
-                    if (!collection.admin.components) collection.admin.components = {};
-                    if (!collection.admin.components.edit) collection.admin.components.edit = {};
-                    if (!collection.admin.components.edit.beforeDocumentControls) {
-                        collection.admin.components.edit.beforeDocumentControls = [];
-                    }
-                    if (!collection.admin.components.beforeListTable) {
-                        collection.admin.components.beforeListTable = [];
-                    }
-                    collection.admin.components.edit.beforeDocumentControls.push(new TranslateDocumentExport(collection, access));
-                    collection.admin.components.beforeListTable.push(new BulkDocumentTranslationDashboard(access));
-                });
-                return cfg;
-            }, // 3. Runner configures jobs/tasks/autorun
-            runnerConfigModifier, // 4. Add global endpoints
-            (cfg)=>{
-                if (!cfg.endpoints) cfg.endpoints = [];
-                const collectionConfig = {
-                    availableCollections: collectionSlugs
-                };
-                cfg.endpoints.push(...[
-                    createEnqueueRoute(this.pluginConfig.runner, collectionConfig, access, basePath),
-                    createRunRoute(this.pluginConfig.runner, access, basePath),
-                    createCancelRoute(this.pluginConfig.runner, access, basePath),
-                    createCancelByCollectionRoute(collectionConfig, this.pluginConfig.runner, access, basePath),
-                    createGetDocumentStatusRoute(collectionConfig, this.pluginConfig.runner, access, basePath),
-                    createGetCollectionStatusRoute(collectionConfig, this.pluginConfig.runner, access, basePath)
-                ]);
-                return cfg;
-            })(config);
+            for (const level of activeLevels)level.extend(builder);
+            // Plugin-level contributions, routed through the same single config-writer:
+            //  - the runner's jobs/autorun/onInit modifier (the builder applies it first,
+            //    so a modifier returning a fresh config object doesn't drop later writes),
+            //  - the always-on client cache provider.
+            builder.addConfigModifier(runnerConfigModifier);
+            builder.addAdminProvider(new CacheProviderExport(basePath));
+            // The single place the Payload config is mutated.
+            return builder.applyTo(config);
         };
     }
 }

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

@@ -1,10 +1,10 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerFactory } from "../../modules/task-runner";
 /**
  * Cancels and deletes translation tasks by IDs
  */
 export declare class CancelHandler {
     private readonly taskRunnerFactory;
-    constructor(taskRunnerFactory: TaskRunnerProvider);
+    constructor(taskRunnerFactory: TaskRunnerFactory);
     handle(req: PayloadRequest): Promise<Response>;
 }

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,9 @@ 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/route.d.ts

@@ -1,7 +1,7 @@
-import type { Endpoint } from 'payload';
-import type { AccessGuard } from '../../shared';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
+import type { Endpoint } from "payload";
+import type { AccessGuard } from "../../shared";
+import type { TaskRunnerFactory } from "../../modules/task-runner";
 /**
  * Creates the batch cancel endpoint
  */
-export declare function createCancelRoute(taskRunnerFactory: TaskRunnerProvider, access?: AccessGuard, basePath?: string): Endpoint;
+export declare function createCancelRoute(taskRunnerFactory: TaskRunnerFactory, access?: AccessGuard, basePath?: string): Endpoint;

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

@@ -1,12 +1,12 @@
-import { withErrorHandler, withAccessCheck } from '../../shared';
-import { CancelHandler } from './handler';
+import { withErrorHandler, withAccessCheck } from "../../shared";
+import { CancelHandler } from "./handler";
 /**
  * Creates the batch cancel endpoint
- */ export function createCancelRoute(taskRunnerFactory, access, basePath = '/translate') {
+ */ export function createCancelRoute(taskRunnerFactory, access, basePath = "/translate") {
     const handler = new CancelHandler(taskRunnerFactory);
     return {
         path: `${basePath}/cancel`,
-        method: 'delete',
+        method: "delete",
         handler: withAccessCheck(withErrorHandler(handler.handle.bind(handler)), access)
     };
 }

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

@@ -1,12 +1,12 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import { type CancelConfig } from './model';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerFactory } from "../../modules/task-runner";
+import type { CancelConfig } from "./model";
 /**
  * Cancels all pending translation tasks for a collection
  */
 export declare class CancelByCollectionHandler {
     private readonly config;
     private readonly taskRunnerFactory;
-    constructor(config: CancelConfig, taskRunnerFactory: TaskRunnerProvider);
+    constructor(config: CancelConfig, taskRunnerFactory: TaskRunnerFactory);
     handle(req: PayloadRequest): Promise<Response>;
 }

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

@@ -1,6 +1,6 @@
-import { ServerResponse } from '../../shared';
-import { isCollectionAvailable } from '../_lib/collection-utils';
-import { CancelByCollectionInputSchema } from './model';
+import { ServerResponse } from "../../shared";
+import { isCollectionAvailable } from "../_lib/collection-utils";
+import { CancelByCollectionInputSchema } from "./model";
 /**
  * Cancels all pending translation tasks for a collection
  */ export class CancelByCollectionHandler {
@@ -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/cancel-by-collection/route.d.ts

@@ -1,8 +1,8 @@
-import type { Endpoint } from 'payload';
-import type { AccessGuard } from '../../shared';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import type { CancelConfig } from './model';
+import type { Endpoint } from "payload";
+import type { AccessGuard } from "../../shared";
+import type { TaskRunnerFactory } from "../../modules/task-runner";
+import type { CancelConfig } from "./model";
 /**
  * Creates the cancel by collection endpoint
  */
-export declare function createCancelByCollectionRoute(config: CancelConfig, taskRunnerFactory: TaskRunnerProvider, access?: AccessGuard, basePath?: string): Endpoint;
+export declare function createCancelByCollectionRoute(config: CancelConfig, taskRunnerFactory: TaskRunnerFactory, access?: AccessGuard, basePath?: string): Endpoint;

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

@@ -1,12 +1,12 @@
-import { withErrorHandler, withAccessCheck } from '../../shared';
-import { CancelByCollectionHandler } from './handler';
+import { withErrorHandler, withAccessCheck } from "../../shared";
+import { CancelByCollectionHandler } from "./handler";
 /**
  * Creates the cancel by collection endpoint
- */ export function createCancelByCollectionRoute(config, taskRunnerFactory, access, basePath = '/translate') {
+ */ export function createCancelByCollectionRoute(config, taskRunnerFactory, access, basePath = "/translate") {
     const handler = new CancelByCollectionHandler(config, taskRunnerFactory);
     return {
         path: `${basePath}/cancel-by-collection/:collection_slug`,
-        method: 'delete',
+        method: "delete",
         handler: withAccessCheck(withErrorHandler(handler.handle.bind(handler)), access)
     };
 }

package/dist/server/features/createTranslationRoutes.d.ts

@@ -0,0 +1,23 @@
+import type { CollectionSlug, Endpoint } from "payload";
+import type { AccessGuard } from "../shared";
+import type { TaskRunnerFactory } from "../modules/task-runner";
+export type TranslationRoutesDeps = {
+    taskRunnerFactory: TaskRunnerFactory;
+    /** Collections the plugin manages — gates which slugs the routes accept. */
+    collectionConfig: {
+        availableCollections: Set<CollectionSlug>;
+    };
+    access?: AccessGuard;
+    basePath?: string;
+};
+/**
+ * The translator's HTTP surface as one shared bundle: the 6 job-API endpoints
+ * (enqueue / run / cancel / cancel-by-collection / document-status /
+ * collection-status), all wired to the same runner factory and access guard.
+ *
+ * Extracted from the plugin's `init()` so registration is a single unit. The
+ * document and collection levels each contribute this bundle via the level
+ * context; the plugin deduplicates by method + path, so it registers exactly
+ * once. Behaviour-preserving: same endpoints, same order, same wiring.
+ */
+export declare function createTranslationRoutes({ taskRunnerFactory, collectionConfig, access, basePath }: TranslationRoutesDeps): Endpoint[];

package/dist/server/features/createTranslationRoutes.js

@@ -0,0 +1,27 @@
+import { createEnqueueRoute } from "./enqueue-translation";
+import { createRunRoute } from "./run-translation";
+import { createCancelRoute } from "./cancel";
+import { createCancelByCollectionRoute } from "./cancel-by-collection";
+import { createGetDocumentStatusRoute } from "./get-document-status";
+import { createGetCollectionStatusRoute } from "./get-collection-status";
+/**
+ * The translator's HTTP surface as one shared bundle: the 6 job-API endpoints
+ * (enqueue / run / cancel / cancel-by-collection / document-status /
+ * collection-status), all wired to the same runner factory and access guard.
+ *
+ * Extracted from the plugin's `init()` so registration is a single unit. The
+ * document and collection levels each contribute this bundle via the level
+ * context; the plugin deduplicates by method + path, so it registers exactly
+ * once. Behaviour-preserving: same endpoints, same order, same wiring.
+ */ export function createTranslationRoutes({ taskRunnerFactory, collectionConfig, access, basePath }) {
+    return [
+        createEnqueueRoute(taskRunnerFactory, collectionConfig, access, basePath),
+        createRunRoute(taskRunnerFactory, access, basePath),
+        createCancelRoute(taskRunnerFactory, access, basePath),
+        createCancelByCollectionRoute(collectionConfig, taskRunnerFactory, access, basePath),
+        createGetDocumentStatusRoute(collectionConfig, taskRunnerFactory, access, basePath),
+        createGetCollectionStatusRoute(collectionConfig, taskRunnerFactory, access, basePath)
+    ];
+}
+
+//# sourceMappingURL=createTranslationRoutes.js.map

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

@@ -1,12 +1,12 @@
-import type { PayloadRequest } from 'payload';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import { type EnqueueConfig } from './model';
+import type { PayloadRequest } from "payload";
+import type { TaskRunnerFactory } from "../../modules/task-runner";
+import type { EnqueueConfig } from "./model";
 /**
  * Enqueues translation tasks for documents
  */
 export declare class EnqueueTranslationHandler {
     private readonly config;
     private readonly taskRunnerFactory;
-    constructor(config: EnqueueConfig, taskRunnerFactory: TaskRunnerProvider);
+    constructor(config: EnqueueConfig, taskRunnerFactory: TaskRunnerFactory);
     handle(req: PayloadRequest): Promise<Response>;
 }

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

@@ -1,6 +1,6 @@
-import { ServerResponse } from '../../shared';
-import { isCollectionAvailable, getAllCollectionIds } from '../_lib/collection-utils';
-import { EnqueueInputSchema } from './model';
+import { ServerResponse } from "../../shared";
+import { isCollectionAvailable, getAllCollectionIds } from "../_lib/collection-utils";
+import { EnqueueInputSchema } from "./model";
 /**
  * Enqueues translation tasks for documents
  */ export class EnqueueTranslationHandler {
@@ -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/route.d.ts

@@ -1,8 +1,8 @@
-import type { Endpoint } from 'payload';
-import type { AccessGuard } from '../../shared';
-import type { TaskRunnerProvider } from '../../modules/task-runner';
-import type { EnqueueConfig } from './model';
+import type { Endpoint } from "payload";
+import type { AccessGuard } from "../../shared";
+import type { TaskRunnerFactory } from "../../modules/task-runner";
+import type { EnqueueConfig } from "./model";
 /**
  * Creates the enqueue translation endpoint
  */
-export declare function createEnqueueRoute(taskRunnerFactory: TaskRunnerProvider, config: EnqueueConfig, access?: AccessGuard, basePath?: string): Endpoint;
+export declare function createEnqueueRoute(taskRunnerFactory: TaskRunnerFactory, config: EnqueueConfig, access?: AccessGuard, basePath?: string): Endpoint;

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

@@ -1,12 +1,12 @@
-import { withErrorHandler, withAccessCheck } from '../../shared';
-import { EnqueueTranslationHandler } from './handler';
+import { withErrorHandler, withAccessCheck } from "../../shared";
+import { EnqueueTranslationHandler } from "./handler";
 /**
  * Creates the enqueue translation endpoint
- */ export function createEnqueueRoute(taskRunnerFactory, config, access, basePath = '/translate') {
+ */ export function createEnqueueRoute(taskRunnerFactory, config, access, basePath = "/translate") {
     const handler = new EnqueueTranslationHandler(config, taskRunnerFactory);
     return {
         path: `${basePath}/enqueue`,
-        method: 'post',
+        method: "post",
         handler: withAccessCheck(withErrorHandler(handler.handle.bind(handler)), access)
     };
 }