@justanarthur/payload-plugin-translator 3.0.3 → 3.1.0

package/dist/shared/{chunk-97ktc51q.js → chunk-zenq7s47.js}

@@ -1,5 +1,5 @@
 // src/resolvers/copy.ts
-var copyResolver = () => {
+var copyResolver2 = () => {
   return {
     key: "copy",
     resolve: (args) => {
@@ -12,4 +12,4 @@ var copyResolver = () => {
   };
 };
 
-export { copyResolver };
+export { copyResolver2 };

package/dist/shared/{chunk-fsveh29m.js → chunk-zs19h344.js}

@@ -1,13 +1,13 @@
 import {
   chunkArray
-} from "./chunk-frnemj69.js";
+} from "./chunk-e6c0qzkt.js";
 
 // src/resolvers/google.ts
 var localeToCountryCodeMapper = {
   ua: "uk"
 };
 var mapLocale = (incoming) => (incoming in localeToCountryCodeMapper) ? localeToCountryCodeMapper[incoming] : incoming;
-var googleResolver = ({
+var googleResolver2 = ({
   apiKey,
   chunkLength = 100
 }) => {
@@ -52,4 +52,4 @@ var googleResolver = ({
   };
 };
 
-export { googleResolver };
+export { googleResolver2 };

package/dist/types.d.ts

@@ -22,6 +22,14 @@ type TranslatorConfig = {
 	globals: GlobalSlug[];
 	resolvers: TranslateResolver[];
 	autoTranslate?: boolean;
+	/**
+	* what a publish in the default locale does to the other locales.
+	* `missing` (default) fills empty fields and keeps existing translations and slugs;
+	* `all` re-translates every field.
+	*/
+	autoTranslateMode?: "all" | "missing";
+	/** adds the /admin/translations review view, its endpoints and the status collection (default true) */
+	review?: boolean;
 	_options?: {
 		additionalTraverseRichText?: (args: {
 			onText: (siblingData: Record<string, unknown>, attribute?: string) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@justanarthur/payload-plugin-translator",
   "description": "Translator plugin for Payload CMS — automatic localization via Google, OpenAI, LibreTranslate, or custom resolvers.",
-  "version": "3.0.3",
+  "version": "3.1.0",
   "type": "module",
   "private": false,
   "files": [
@@ -29,6 +29,12 @@
         "default": "./dist/types.js"
       }
     },
+    "./rsc": {
+      "import": {
+        "types": "./dist/rsc.d.ts",
+        "default": "./dist/rsc.js"
+      }
+    },
     "./client": {
       "import": {
         "types": "./dist/client.d.ts",
@@ -78,6 +84,7 @@
   "scripts": {
     "build": "NODE_ENV=production bunup",
     "clean": "rm -rf dist .tsbuildinfo",
+    "test": "bun test",
     "prepublishOnly": "bun run clean && bun run build"
   },
   "dependencies": {
@@ -85,18 +92,20 @@
     "he": "^1.2.0"
   },
   "devDependencies": {
-    "@payloadcms/translations": "3.85.0",
-    "@payloadcms/ui": "3.85.0",
+    "@payloadcms/next": "3.88.0",
+    "@payloadcms/translations": "3.88.0",
+    "@payloadcms/ui": "3.88.0",
     "@types/he": "^1.2.3",
-    "@types/react": "19.2.14",
-    "@types/react-dom": "19.2.3",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.7",
     "bunup": "^0.16.32",
-    "payload": "3.85.0",
-    "react": "19.2.6",
-    "react-dom": "19.2.6",
-    "typescript": "5.7.3"
+    "payload": "3.88.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "typescript": "^7.0.2"
   },
   "peerDependencies": {
+    "@payloadcms/next": "^3.85.0",
     "@payloadcms/translations": "^3.85.0",
     "@payloadcms/ui": "^3.85.0",
     "payload": "^3.85.0",

package/dist/shared/chunk-ecnph6hw.js

@@ -1,205 +0,0 @@
-import {
-  chunkArray
-} from "./chunk-frnemj69.js";
-
-// src/resolvers/openAI.ts
-var LOCALE_DISPLAY_NAME = {
-  en: "English",
-  sk: "Slovak",
-  cs: "Czech",
-  de: "German",
-  uk: "Ukrainian",
-  ua: "Ukrainian",
-  pl: "Polish",
-  hu: "Hungarian",
-  fr: "French",
-  es: "Spanish",
-  it: "Italian",
-  pt: "Portuguese",
-  nl: "Dutch",
-  ro: "Romanian"
-};
-var RETRY_DELAYS_MS = [500, 1000, 2000];
-var defaultPrompt = ({ localeFrom, localeTo, texts }) => {
-  const from = LOCALE_DISPLAY_NAME[localeFrom] ?? localeFrom;
-  const to = LOCALE_DISPLAY_NAME[localeTo] ?? localeTo;
-  return `You are a machine-translation engine. Translate each string in the input JSON array from ${from} (${localeFrom}) to ${to} (${localeTo}).
-
-Rules:
-1. The output must be a valid JSON array of strings, with the same length and order as the input.
-2. SLUGS: any input that looks like a URL slug (lowercase, contains only ASCII letters/digits/hyphens/underscores, no spaces, no punctuation) MUST be transliterated into the target language. Output the slug in the same format: lowercase ASCII only, using only letters a-z, digits 0-9, hyphens (-), and underscores (_). Never leave a slug unchanged. Never output accented characters, uppercase letters, spaces, or other symbols in a slug. Examples:
-   - "about-us-copy" (en) → "o-nas-kopia" (sk) → "uber-uns-kopie" (de) → "sobre-nos-copia" (pt) → "a-propos-copie" (fr)
-   - For Cyrillic source scripts, transliterate to Latin first, then translate.
-3. URLs (containing "://" or "www."), email addresses, hex strings, and other opaque identifiers: keep as-is.
-4. Apply locale-specific formatting for dates, currency, decimal separators in human-readable text.
-5. Return only the JSON array. No markdown fences, no prose, no trailing commentary.
-
-INPUT:
-${JSON.stringify(texts)}`;
-};
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-var isRetryableStatus = (status) => status === 429 || status >= 500;
-var isGpt5Family = (model) => /^gpt-5/.test(model);
-var isGpt54Plus = (model) => /^gpt-5\.[1-9]/.test(model);
-var usesMaxCompletionTokens = (model) => isGpt5Family(model) || /^o[1-9]/.test(model);
-var deriveMaxTokens = (chunkLength, model) => {
-  const base = Math.max(chunkLength * 100, 4000);
-  if (model && isGpt54Plus(model))
-    return Math.max(base * 4, 16000);
-  return base;
-};
-var parseContent = (raw) => {
-  const trimmed = raw.trim();
-  const m = trimmed.match(/^```(?:json)?\s*\n?([\s\S]*?)\n?\s*```$/);
-  const candidate = m ? m[1].trim() : trimmed;
-  const fenceStripped = m !== null;
-  let parsed;
-  try {
-    parsed = JSON.parse(candidate);
-  } catch (e) {
-    return {
-      error: e instanceof Error ? e.message : String(e),
-      fenceStripped,
-      ok: false
-    };
-  }
-  if (!Array.isArray(parsed)) {
-    return { error: "parsed value is not an array", fenceStripped, ok: false };
-  }
-  if (!parsed.every((v) => typeof v === "string")) {
-    return { error: "array contains non-string element", fenceStripped, ok: false };
-  }
-  return { fenceStripped, ok: true, translated: parsed };
-};
-var openAIResolver = ({
-  apiKey,
-  baseUrl,
-  chunkLength = 100,
-  model = "gpt-4o-mini",
-  prompt = defaultPrompt
-}) => {
-  return {
-    key: "openai",
-    resolve: async ({ localeFrom, localeTo, req, texts }) => {
-      const apiUrl = `${baseUrl || "https://api.openai.com"}/v1/chat/completions`;
-      const maxTokens = deriveMaxTokens(chunkLength, model);
-      const maxTokensKey = usesMaxCompletionTokens(model) ? "max_completion_tokens" : "max_tokens";
-      const supportsCustomTemperature = !isGpt5Family(model);
-      const reasoningEffort = isGpt54Plus(model) ? "low" : undefined;
-      const logger = req.payload.logger;
-      try {
-        const response = await Promise.all(chunkArray(texts, chunkLength).map(async (chunk) => {
-          for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
-            let shouldRetry = false;
-            let httpStatus = 0;
-            try {
-              const res = await fetch(apiUrl, {
-                body: JSON.stringify({
-                  messages: [
-                    {
-                      content: prompt({ localeFrom, localeTo, texts: chunk }),
-                      role: "user"
-                    }
-                  ],
-                  model,
-                  ...supportsCustomTemperature ? { temperature: 0 } : {},
-                  ...reasoningEffort ? { reasoning_effort: reasoningEffort } : {},
-                  [maxTokensKey]: maxTokens
-                }),
-                headers: {
-                  Authorization: `Bearer ${apiKey}`,
-                  "Content-Type": "application/json"
-                },
-                method: "post"
-              });
-              httpStatus = res.status;
-              const data = await res.json();
-              if (res.ok) {
-                const content = data?.choices?.[0]?.message?.content;
-                if (!content) {
-                  logger.error({
-                    code: "OPENAI_BAD_JSON",
-                    message: "OpenAI response missing content",
-                    openAIResponse: data
-                  });
-                  shouldRetry = true;
-                } else {
-                  const result = parseContent(content);
-                  if (result.ok) {
-                    if (result.fenceStripped) {
-                      logger.info({
-                        code: "OPENAI_FENCE_STRIPPED",
-                        message: "OpenAI returned fenced JSON despite json_object mode"
-                      });
-                    }
-                    return { success: true, translated: result.translated };
-                  }
-                  logger.error({
-                    code: "OPENAI_BAD_JSON",
-                    error: result.error,
-                    fenceStripped: result.fenceStripped,
-                    message: "Failed to parse OpenAI response"
-                  });
-                  shouldRetry = true;
-                }
-              } else {
-                logger.error({
-                  code: "OPENAI_HTTP_ERROR",
-                  message: "OpenAI returned non-2xx status",
-                  openAIResponse: data,
-                  status: httpStatus
-                });
-                if (isRetryableStatus(httpStatus))
-                  shouldRetry = true;
-              }
-            } catch (e) {
-              logger.error({
-                code: "OPENAI_NETWORK_ERROR",
-                message: "OpenAI request threw",
-                originalErr: e instanceof Error ? e.message : String(e)
-              });
-              shouldRetry = true;
-            }
-            if (attempt < RETRY_DELAYS_MS.length && shouldRetry) {
-              logger.info({
-                attempt: attempt + 1,
-                code: "OPENAI_RETRY",
-                message: "Retrying OpenAI request after backoff",
-                nextBackoffMs: RETRY_DELAYS_MS[attempt],
-                status: httpStatus
-              });
-              await sleep(RETRY_DELAYS_MS[attempt]);
-              continue;
-            }
-            logger.error({
-              code: "OPENAI_GIVE_UP",
-              message: "OpenAI chunk failed after retries",
-              status: httpStatus
-            });
-            return { success: false };
-          }
-          return { success: false };
-        }));
-        const translated = [];
-        for (const result of response) {
-          if (!result.success)
-            return { success: false };
-          translated.push(...result.translated);
-        }
-        return {
-          success: true,
-          translatedTexts: translated
-        };
-      } catch (e) {
-        logger.error({
-          code: "OPENAI_UNEXPECTED",
-          message: "OpenAI resolve threw an unexpected error",
-          originalErr: e instanceof Error ? e.message : String(e)
-        });
-        return { success: false };
-      }
-    }
-  };
-};
-
-export { openAIResolver };