@focus-reactive/payload-plugin-translator 0.7.2 → 0.8.0

package/dist/client/shared/ui/Loading/styles.module.scss

@@ -31,56 +31,49 @@
   }
 
   &__bars {
-    display: grid;
-    gap: 7px;
+    display: flex;
     align-items: center;
 
-    &_small {
-      grid-template-columns: 1fr 1fr;
+    // Gap tightens with size so a small control's bars don't read as scattered.
+    &_sm {
+      gap: 4px;
     }
 
-    &_medium {
-      grid-template-columns: 1fr 1fr 1fr 1fr 1fr;
+    &_md {
+      gap: 6px;
+    }
+
+    &_lg {
+      gap: 7px;
     }
   }
 
   &__bar {
     background-color: currentColor;
+    width: 2px;
 
-    &_size-small {
-      height: 10px;
-      width: 2px;
+    &_size-sm {
+      height: 9px;
     }
 
-    &_size-medium {
-      height: 15px;
-      width: 2px;
-    }
-
-    &:nth-child(1) {
-      transform: translateY(0);
-      animation: animate-bar--odd 1.25s infinite;
+    &_size-md {
+      height: 12px;
     }
 
-    &:nth-child(2) {
-      transform: translateY(-2px);
-      animation: animate-bar--even 1.25s infinite;
+    &_size-lg {
+      height: 15px;
     }
 
-    &:nth-child(3) {
+    // Neighbouring bars swing in opposition, regardless of how many there are.
+    &:nth-child(odd) {
       transform: translateY(0);
       animation: animate-bar--odd 1.25s infinite;
     }
 
-    &:nth-child(4) {
+    &:nth-child(even) {
       transform: translateY(-2px);
       animation: animate-bar--even 1.25s infinite;
     }
-
-    &:nth-child(5) {
-      transform: translateY(0);
-      animation: animate-bar--odd 1.25s infinite;
-    }
   }
 
   &__text {

package/dist/client/shared/ui/Popup/Popup.js

@@ -15,6 +15,9 @@ function Popup({ open, children, onOpenChange, $trigger, $align, $side, onOpenAu
                     sideOffset: 8,
                     side: $side,
                     align: $align,
+                    // Keep a gap from the viewport edges so the popup never sticks to the screen border —
+                    // Radix shifts it inward to preserve this padding.
+                    collisionPadding: 12,
                     className: style.popover,
                     onOpenAutoFocus: onOpenAutoFocus,
                     children: children

package/dist/client/shared/ui/Select/Select.js

@@ -5,7 +5,7 @@ import styles from "./styles.module.scss";
 const sizes = {
     sm: {
         height: "24px",
-        paddingInline: "0.25rem",
+        paddingInline: "0.5rem",
         fontSize: "0.875rem"
     },
     md: {

package/dist/client/shared/ui/form/FormSelect/FormSelect.js

@@ -78,6 +78,7 @@ export default function FormSelect({ name, required, options, label, description
     return /*#__PURE__*/ _jsxs(Label, {
         className: className,
         label: label,
+        $size: size,
         children: [
             selectElement,
             errorAndDescription

package/dist/client/widgets/bulk-translation-dashboard/ui/BulkTranslationDashboard.js

@@ -3,13 +3,14 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { toast, useLocale, useSelection } from "@payloadcms/ui";
 import { SelectAllStatus } from "@payloadcms/ui/providers/Selection";
 import { useEffect, useMemo } from "react";
-import { TranslationsApi } from "../../../entities/translation";
+import { deriveCollectionPanelStatus, TranslationsApi } from "../../../entities/translation";
 import { CollectionTranslationForm, FORM_FIELDS } from "../../../features/collection-translation-form";
 import { CollectionTranslationFormModel } from "../../../features/collection-translation-form/index.client";
 import CollectionTranslationPopup from "../../../features/collection-translation-popup";
 import { CollectionTranslationProgress } from "../../../features/collection-translation-progress";
 import { handleFormError } from "../../../shared/lib/forms/handle-form-error";
 import { useCollectionDashboardUrlParams } from "../../../shared/lib/payload/hooks/useCollectionDashboardUrlParams";
+import styles from "./styles.module.scss";
 export default function BulkTranslationDashboard({ hasDrafts }) {
     const locale = useLocale();
     const { collection } = useCollectionDashboardUrlParams();
@@ -38,7 +39,10 @@ export default function BulkTranslationDashboard({ hasDrafts }) {
     });
     const selectAll = documentsSelection.selectAll === SelectAllStatus.AllAvailable;
     const selectedCount = selectAll ? documentsSelection.totalDocs : documentsSelection.count;
-    const translationInProgress = !!(collectionTranslationApi.data?.pending.length || collectionTranslationApi.data?.running.length);
+    const status = collectionTranslationApi.data;
+    const panelStatus = deriveCollectionPanelStatus(status);
+    const hasAnyCount = !!(status && (status.completed.length || status.failed.length || status.running.length || status.pending.length));
+    const showStatus = collectionTranslationApi.isPending || hasAnyCount;
     const handleSubmit = async (formData)=>{
         try {
             await queueTranslationApi.mutateAsync({
@@ -51,25 +55,41 @@ export default function BulkTranslationDashboard({ hasDrafts }) {
         }
     };
     return /*#__PURE__*/ _jsxs(CollectionTranslationPopup, {
-        translationInProgress: translationInProgress,
+        status: panelStatus,
         selectedCount: selectedCount,
         children: [
-            /*#__PURE__*/ _jsx("h3", {
-                children: "Bulk Translation Dashboard"
+            /*#__PURE__*/ _jsx("h4", {
+                className: styles.title,
+                children: "Bulk translation"
             }),
-            /*#__PURE__*/ _jsx("p", {
-                children: "Translate multiple documents at once using AI. Select the records you want to translate on the collection dashboard, then configure your translation settings here."
+            /*#__PURE__*/ _jsxs("section", {
+                className: styles.section,
+                children: [
+                    /*#__PURE__*/ _jsx("h5", {
+                        className: styles.eyebrow,
+                        children: "Translate"
+                    }),
+                    /*#__PURE__*/ _jsx(CollectionTranslationForm, {
+                        form: form,
+                        onSubmit: handleSubmit,
+                        selectedCount: selectedCount,
+                        hasDrafts: hasDrafts
+                    })
+                ]
             }),
-            /*#__PURE__*/ _jsx(CollectionTranslationForm, {
-                form: form,
-                onSubmit: handleSubmit,
-                selectedCount: selectedCount,
-                hasDrafts: hasDrafts
-            }),
-            /*#__PURE__*/ _jsx(CollectionTranslationProgress, {
-                collection: collection,
-                data: collectionTranslationApi.data,
-                isPending: collectionTranslationApi.isPending
+            showStatus && /*#__PURE__*/ _jsxs("section", {
+                className: `${styles.section} ${styles["section--status"]}`,
+                children: [
+                    /*#__PURE__*/ _jsx("h5", {
+                        className: styles.eyebrow,
+                        children: "Status"
+                    }),
+                    /*#__PURE__*/ _jsx(CollectionTranslationProgress, {
+                        collection: collection,
+                        data: collectionTranslationApi.data,
+                        isPending: collectionTranslationApi.isPending
+                    })
+                ]
             })
         ]
     });

package/dist/client/widgets/bulk-translation-dashboard/ui/styles.module.scss

@@ -0,0 +1,27 @@
+.title {
+  margin: 0;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--theme-text, #222);
+}
+
+.section {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+// One eyebrow style shared by every section header, so the sections read as one system.
+.eyebrow {
+  margin: 0;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--theme-elevation-500, #8c8c8c);
+}
+
+.section--status {
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--theme-elevation-100, #e6e6e6);
+}

package/dist/client/widgets/translate-document/ui/TranslateDocument.js

@@ -2,20 +2,19 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { toast, useLocale } from "@payloadcms/ui";
 import { useEffect, useMemo } from "react";
-import { CompletedTranslationStatus, TranslationsApi } from "../../../entities/translation";
+import { buildTranslationStatusRows, derivePanelStatus, TranslationsApi, TranslationStatusList } from "../../../entities/translation";
 import { OpenDocumentTranslationPopup } from "../../../features/open-document-translation-popup";
 import { DocumentTranslationForm, FORM_FIELDS } from "../../../features/translate-document-form";
 import { DocumentTranslationFormModel } from "../../../features/translate-document-form/index.client";
 import { handleFormError } from "../../../shared/lib/forms/handle-form-error";
 import { useCollectionDocumentUrlParams } from "../../../shared/lib/payload/hooks/useCollectionDocumentUrlParams";
-import { DocumentTranslationProgressFailed } from "../../../features/document-translation-progress-failed";
-import { DocumentTranslationProgressRunning } from "../../../features/document-translation-progress-running";
-import { DocumentTranslationProgressPending } from "../../../features/document-translation-progress-pending";
+import styles from "./styles.module.scss";
 const TranslateDocument = ({ hasDrafts })=>{
     const locale = useLocale();
     const params = useCollectionDocumentUrlParams();
     const queueTranslationApi = TranslationsApi.useQueueDocumentTranslation();
     const { data, error, isLoading } = TranslationsApi.useDocumentTranslation(params);
+    const { data: staleness } = TranslationsApi.useDocumentStaleness(params);
     useEffect(()=>{
         if (error) {
             toast.error(error.message);
@@ -23,6 +22,24 @@ const TranslateDocument = ({ hasDrafts })=>{
     }, [
         error
     ]);
+    const staleLocales = useMemo(()=>(staleness?.locales ?? []).filter((l)=>l.is_stale).map((l)=>l.target_lng), [
+        staleness
+    ]);
+    // The panel trigger shows one aggregate marker; the popup shows the full per-locale list.
+    const panelStatus = useMemo(()=>derivePanelStatus({
+            runStatus: data?.status,
+            staleLocales
+        }), [
+        data?.status,
+        staleLocales
+    ]);
+    const statusRows = useMemo(()=>buildTranslationStatusRows({
+            staleness,
+            run: data
+        }), [
+        staleness,
+        data
+    ]);
     const initialValues = useMemo(()=>({
             [FORM_FIELDS.SOURCE_LNG]: locale.code,
             [FORM_FIELDS.HIDDEN_COLLECTION_SLUG]: params.collection,
@@ -48,38 +65,47 @@ const TranslateDocument = ({ hasDrafts })=>{
             handleFormError(e, form);
         }
     };
-    return /*#__PURE__*/ _jsxs(_Fragment, {
-        children: [
-            /*#__PURE__*/ _jsx(OpenDocumentTranslationPopup, {
-                isLoading: isLoading,
-                children: ({ close })=>/*#__PURE__*/ _jsxs(_Fragment, {
+    // Vertical stack: title → Translate (form) → Status (unified per-locale list). No columns, no
+    // corner chip — one consistent system so the popup stays calm as the plugin grows.
+    return /*#__PURE__*/ _jsx(OpenDocumentTranslationPopup, {
+        isLoading: isLoading,
+        status: panelStatus,
+        children: ({ close })=>/*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx("h4", {
+                        className: styles.title,
+                        children: "Document translation"
+                    }),
+                    /*#__PURE__*/ _jsxs("section", {
+                        className: styles.section,
                         children: [
-                            /*#__PURE__*/ _jsx("h4", {
-                                children: "Document Translation"
+                            /*#__PURE__*/ _jsx("h5", {
+                                className: styles.eyebrow,
+                                children: "Translate"
                             }),
                             /*#__PURE__*/ _jsx(DocumentTranslationForm, {
                                 form: form,
-                                onSubmit: (data)=>handleSubmit(data, close),
+                                onSubmit: (formData)=>handleSubmit(formData, close),
                                 hasDrafts: hasDrafts
                             })
                         ]
+                    }),
+                    statusRows.length > 0 && /*#__PURE__*/ _jsxs("section", {
+                        className: `${styles.section} ${styles["section--status"]}`,
+                        children: [
+                            /*#__PURE__*/ _jsx("h5", {
+                                className: styles.eyebrow,
+                                children: "Status"
+                            }),
+                            /*#__PURE__*/ _jsx(TranslationStatusList, {
+                                rows: statusRows,
+                                collection: params.collection,
+                                id: params.id
+                            })
+                        ]
                     })
-            }),
-            data?.status === "completed" && /*#__PURE__*/ _jsx(CompletedTranslationStatus, {
-                sourceLocale: data.input.source_lng,
-                targetLocale: data.input.target_lng,
-                completed_at: data.completed_at
-            }),
-            data?.status === "failed" && /*#__PURE__*/ _jsx(DocumentTranslationProgressFailed, {
-                data: data
-            }),
-            data?.status === "running" && /*#__PURE__*/ _jsx(DocumentTranslationProgressRunning, {
-                data: data
-            }),
-            data?.status === "pending" && /*#__PURE__*/ _jsx(DocumentTranslationProgressPending, {
-                data: data
+                ]
             })
-        ]
     });
 };
 export default TranslateDocument;

package/dist/client/widgets/translate-document/ui/styles.module.scss

@@ -0,0 +1,27 @@
+.title {
+  margin: 0;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--theme-text, #222);
+}
+
+.section {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+// One eyebrow style shared by every section header, so the sections read as one system.
+.eyebrow {
+  margin: 0;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--theme-elevation-500, #8c8c8c);
+}
+
+.section--status {
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--theme-elevation-100, #e6e6e6);
+}

package/dist/composition/levels/useDocTranslationApi.d.ts

@@ -1,8 +1,9 @@
 import type { LevelContext } from "../../server/modules/translation-levels";
 /**
- * Contribute the runner-agnostic document-translation API — the shared 6-route
+ * Contribute the runner-agnostic document-translation API — the shared route
  * bundle, bound to the level context's runner. Both `documentLevel` and
  * `collectionLevel` call this; the plugin deduplicates the endpoints by method +
- * path, so the bundle registers exactly once.
+ * path, so the bundle registers exactly once. The schema map and provenance
+ * store factory ride along for the staleness endpoints.
  */
 export declare function useDocTranslationApi(ctx: LevelContext): void;

package/dist/composition/levels/useDocTranslationApi.js

@@ -1,9 +1,10 @@
 import { createTranslationRoutes } from "../../server/features/createTranslationRoutes";
 /**
- * Contribute the runner-agnostic document-translation API — the shared 6-route
+ * Contribute the runner-agnostic document-translation API — the shared route
  * bundle, bound to the level context's runner. Both `documentLevel` and
  * `collectionLevel` call this; the plugin deduplicates the endpoints by method +
- * path, so the bundle registers exactly once.
+ * path, so the bundle registers exactly once. The schema map and provenance
+ * store factory ride along for the staleness endpoints.
  */ export function useDocTranslationApi(ctx) {
     ctx.addEndpoints(createTranslationRoutes({
         taskRunnerFactory: ctx.taskRunnerFactory,
@@ -11,7 +12,9 @@ import { createTranslationRoutes } from "../../server/features/createTranslation
             availableCollections: new Set(ctx.collections.map((collection)=>collection.slug))
         },
         access: ctx.access,
-        basePath: ctx.basePath
+        basePath: ctx.basePath,
+        schemaMap: ctx.schemaMap,
+        provenanceStoreFactory: ctx.provenanceStoreFactory
     }));
 }
 

package/dist/core/provenance/ProvenanceStore.interface.d.ts

@@ -88,6 +88,24 @@ export interface ProvenanceStore {
      * @returns The stored record, or `null` if none exists.
      */
     find(key: ProvenanceKey): Promise<TranslationProvenanceRecord | null>;
+    /**
+     * List every record for a document — one per translated target locale. Backs #50's per-locale
+     * staleness read for a single document panel.
+     *
+     * @param collectionSlug - Slug of the translated document's collection.
+     * @param documentId - Stringified id of the translated document.
+     * @returns All provenance receipts for the document (empty when none exist).
+     */
+    findByDocument(collectionSlug: string, documentId: string): Promise<TranslationProvenanceRecord[]>;
+    /**
+     * Acknowledge the current source drift for one locale without re-translating (#50's dismiss):
+     * persist `dismissedFingerprint` so the indicator hides until the source changes again. No-op if
+     * the key has no record.
+     *
+     * @param key - The `(collectionSlug, documentId, targetLocale)` identity to dismiss.
+     * @param dismissedFingerprint - The current source fingerprint being acknowledged.
+     */
+    dismiss(key: ProvenanceKey, dismissedFingerprint: string): Promise<void>;
     /**
      * Delete every record for a document (all target locales). Used to cascade-clean when the source
      * document is deleted.

package/dist/core/provenance/index.d.ts

@@ -1 +1,2 @@
 export type { ProvenanceKey, ProvenanceStore, TranslationProvenanceRecord, } from "./ProvenanceStore.interface";
+export { isRecordStale } from "./staleness";

package/dist/core/provenance/index.js

@@ -1,5 +1,5 @@
 // Provenance contracts (port + record types) only — payload-free. The Payload-backed store lives
 // in the plugin (src/server/modules/provenance), outside the core.
-export { };
+export { isRecordStale } from "./staleness";
 
 //# sourceMappingURL=index.js.map

package/dist/core/provenance/staleness.d.ts

@@ -0,0 +1,19 @@
+import type { TranslationProvenanceRecord } from "./ProvenanceStore.interface";
+/**
+ * Whether a translated locale is out of date relative to its source — the #50 rule, in one place.
+ *
+ * A record is stale when the current source fingerprint differs from the one the translation was
+ * derived from (`record.sourceFingerprint`) **and** the editor has not acknowledged that exact drift
+ * (`record.dismissedFingerprint`). Dismissing sets `dismissedFingerprint` to the current fingerprint,
+ * so the indicator hides until the source changes again (a new fingerprint no longer matches the
+ * dismissed one). `dismissedFingerprint` is `null` until the first dismiss, in which case the check
+ * reduces to a plain source-drift comparison.
+ *
+ * Pure and payload-free so the staleness contract is testable without a database; the server handler
+ * supplies `currentFingerprint` via {@link computeSourceFingerprint} on the live source document.
+ *
+ * @param record - The stored provenance receipt for one `(collection, document, targetLocale)`.
+ * @param currentFingerprint - `computeSourceFingerprint` of the source document right now.
+ * @returns `true` when the target locale is out of date and not dismissed.
+ */
+export declare function isRecordStale(record: TranslationProvenanceRecord, currentFingerprint: string): boolean;

package/dist/core/provenance/staleness.js

@@ -0,0 +1,21 @@
+/**
+ * Whether a translated locale is out of date relative to its source — the #50 rule, in one place.
+ *
+ * A record is stale when the current source fingerprint differs from the one the translation was
+ * derived from (`record.sourceFingerprint`) **and** the editor has not acknowledged that exact drift
+ * (`record.dismissedFingerprint`). Dismissing sets `dismissedFingerprint` to the current fingerprint,
+ * so the indicator hides until the source changes again (a new fingerprint no longer matches the
+ * dismissed one). `dismissedFingerprint` is `null` until the first dismiss, in which case the check
+ * reduces to a plain source-drift comparison.
+ *
+ * Pure and payload-free so the staleness contract is testable without a database; the server handler
+ * supplies `currentFingerprint` via {@link computeSourceFingerprint} on the live source document.
+ *
+ * @param record - The stored provenance receipt for one `(collection, document, targetLocale)`.
+ * @param currentFingerprint - `computeSourceFingerprint` of the source document right now.
+ * @returns `true` when the target locale is out of date and not dismissed.
+ */ export function isRecordStale(record, currentFingerprint) {
+    return currentFingerprint !== record.sourceFingerprint && currentFingerprint !== record.dismissedFingerprint;
+}
+
+//# sourceMappingURL=staleness.js.map

package/dist/plugin.js

@@ -87,7 +87,8 @@ import { normalizePath } from "./server/shared";
                 access,
                 taskRunnerFactory,
                 schemaMap,
-                translationProvider
+                translationProvider,
+                provenanceStoreFactory
             });
             for (const level of activeLevels)level.extend(builder);
             builder.addConfigModifier(runnerConfigModifier);

package/dist/server/features/_lib/sourceDocument.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionSlug, Payload } from "payload";
+/**
+ * Fetch a document's source-locale data with the exact shape the provenance fingerprint depends on
+ * (`depth: 0`, the given locale). Shared by the translation **write** path (which fingerprints the
+ * source it just translated) and the staleness **read** path (which re-fingerprints the live source),
+ * so the fingerprint baseline can never drift between the two — the single biggest correctness trap in
+ * staleness detection is thus enforced structurally, not by a comment.
+ */
+export declare function fetchSourceDocument(payload: Payload, collection: CollectionSlug, id: string, locale: string): Promise<import("payload").JsonObject & import("payload").TypeWithID>;

package/dist/server/features/_lib/sourceDocument.js

@@ -0,0 +1,16 @@
+/**
+ * Fetch a document's source-locale data with the exact shape the provenance fingerprint depends on
+ * (`depth: 0`, the given locale). Shared by the translation **write** path (which fingerprints the
+ * source it just translated) and the staleness **read** path (which re-fingerprints the live source),
+ * so the fingerprint baseline can never drift between the two — the single biggest correctness trap in
+ * staleness detection is thus enforced structurally, not by a comment.
+ */ export function fetchSourceDocument(payload, collection, id, locale) {
+    return payload.findByID({
+        collection,
+        id,
+        locale,
+        depth: 0
+    });
+}
+
+//# sourceMappingURL=sourceDocument.js.map

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

@@ -1,6 +1,8 @@
 import type { CollectionSlug, Endpoint } from "payload";
 import type { AccessGuard } from "../shared";
 import type { TaskRunnerFactory } from "../modules/task-runner";
+import type { CollectionSchemaMap } from "../../types/CollectionSchemaMap";
+import type { ProvenanceStoreFactory } from "../modules/provenance";
 export type TranslationRoutesDeps = {
     taskRunnerFactory: TaskRunnerFactory;
     /** Collections the plugin manages — gates which slugs the routes accept. */
@@ -9,15 +11,21 @@ export type TranslationRoutesDeps = {
     };
     access?: AccessGuard;
     basePath?: string;
+    /** Original per-collection field schema — needed to recompute source fingerprints for staleness. */
+    schemaMap: CollectionSchemaMap;
+    /** Builds a provenance store; absent when provenance is disabled (staleness then reports empty). */
+    provenanceStoreFactory?: ProvenanceStoreFactory;
 };
 /**
- * The translator's HTTP surface as one shared bundle: the 6 job-API endpoints
+ * The translator's HTTP surface as one shared bundle: the job-API endpoints
  * (enqueue / run / cancel / cancel-by-collection / document-status /
- * collection-status), all wired to the same runner factory and access guard.
+ * collection-status) plus the provenance-backed staleness endpoints
+ * (document-staleness / dismiss), all wired to the same 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.
+ * once. The staleness endpoints always register; when provenance is disabled
+ * (`provenanceStoreFactory` absent) they simply report no staleness.
  */
-export declare function createTranslationRoutes({ taskRunnerFactory, collectionConfig, access, basePath, }: TranslationRoutesDeps): Endpoint[];
+export declare function createTranslationRoutes({ taskRunnerFactory, collectionConfig, access, basePath, schemaMap, provenanceStoreFactory, }: TranslationRoutesDeps): Endpoint[];

package/dist/server/features/createTranslationRoutes.js

@@ -4,23 +4,33 @@ import { createCancelRoute } from "./cancel";
 import { createCancelByCollectionRoute } from "./cancel-by-collection";
 import { createGetDocumentStatusRoute } from "./get-document-status";
 import { createGetCollectionStatusRoute } from "./get-collection-status";
+import { createGetDocumentStalenessRoute, createDismissStalenessRoute } from "./staleness";
 /**
- * The translator's HTTP surface as one shared bundle: the 6 job-API endpoints
+ * The translator's HTTP surface as one shared bundle: the job-API endpoints
  * (enqueue / run / cancel / cancel-by-collection / document-status /
- * collection-status), all wired to the same runner factory and access guard.
+ * collection-status) plus the provenance-backed staleness endpoints
+ * (document-staleness / dismiss), all wired to the same 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 }) {
+ * once. The staleness endpoints always register; when provenance is disabled
+ * (`provenanceStoreFactory` absent) they simply report no staleness.
+ */ export function createTranslationRoutes({ taskRunnerFactory, collectionConfig, access, basePath, schemaMap, provenanceStoreFactory }) {
+    const stalenessConfig = {
+        availableCollections: collectionConfig.availableCollections,
+        schemaMap,
+        provenanceStoreFactory
+    };
     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)
+        createGetCollectionStatusRoute(collectionConfig, taskRunnerFactory, access, basePath),
+        createGetDocumentStalenessRoute(stalenessConfig, access, basePath),
+        createDismissStalenessRoute(stalenessConfig, access, basePath)
     ];
 }
 

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { JobIdSchema } from "../../shared";
+import { JobIdSchema, toClientErrorMessage } from "../../shared";
 /**
  * Input validation schema.
  *
@@ -28,7 +28,12 @@ import { JobIdSchema } from "../../shared";
             target_lng: task.input.targetLng,
             strategy: task.input.strategy
         },
-        error: task.error,
+        // Never ship the raw provider/runtime error to the browser outside development — it can leak
+        // implementation detail and secrets (e.g. a partial API key). The full error stays in the job
+        // record + server logs.
+        error: task.error ? {
+            message: toClientErrorMessage(task.error.message)
+        } : undefined,
         cancelled: task.cancelled
     };
 }

package/dist/server/features/staleness/dismissStaleness.handler.d.ts

@@ -0,0 +1,8 @@
+import type { PayloadRequest } from "payload";
+import type { StalenessConfig } from "./model";
+/** Dismisses (acknowledges) staleness of one target locale for a document. */
+export declare class DismissStalenessHandler {
+    private readonly config;
+    constructor(config: StalenessConfig);
+    handle(req: PayloadRequest): Promise<Response>;
+}