@strapi-ai/translator 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 brighill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# AI Translator for Strapi
+
+Just another vibe-coded AI translator plugin for Strapi 5. Translates localized content with any OpenAI-compatible model and shows you a
+streamed diff before anything touches your entry.
+
+## Install
+
+```sh
+npm install @strapi-ai/translator
+```
+
+```ts
+// config/plugins.ts
+export default {
+  'ai-translator': { enabled: true },
+};
+```

package/dist/admin/SettingsPage-C5nm32bD.mjs

@@ -0,0 +1,466 @@
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+import { useState, useEffect, useRef } from "react";
+import { Typography, Field, TextInput, Box, Button, Combobox, ComboboxOption, Textarea, Flex, NumberInput, Main } from "@strapi/design-system";
+import { useIntl } from "react-intl";
+import { P as PLUGIN_ID, g as getTranslation } from "./index-CS0LCA35.mjs";
+import { Earth } from "@strapi/icons";
+import { useFetchClient, useNotification } from "@strapi/strapi/admin";
+const PluginIcon = (props) => /* @__PURE__ */ jsx(Earth, { ...props });
+const DEFAULT_SYSTEM_PROMPT = "You are a CMS content translator. Output only the translated text, with no explanations, no quotes, and no metadata. Preserve formatting and markup exactly: Markdown, HTML, custom tags, links, images. Leave code blocks, URLs, query parameters, variables, and placeholders unchanged. Keep brand names, product names, and currency values in their original form. Translate meaning by meaning, using natural, concise wording and the standard terminology of the target locale.";
+const DEFAULT_PROVIDER_BASE_URL = "";
+const DEFAULT_PROVIDER_MODEL = "";
+const DEFAULT_PROVIDER_TEMPERATURE = 0.3;
+const MAX_PROVIDER_TEMPERATURE = 2;
+const MIN_PROVIDER_TEMPERATURE = 0;
+const DEFAULT_MAX_TOKENS = 0;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_RETRY_BASE_DELAY_MS = 1e3;
+const DEFAULT_RETRY_MAX_DELAY_MS = 3e4;
+const toEditablePayload = (settings) => {
+  const { apiKey, apiKeyConfigured, apiKeyPreview, ...editable } = settings;
+  const trimmedApiKey = apiKey.trim();
+  return trimmedApiKey ? { ...editable, apiKey: trimmedApiKey } : editable;
+};
+const DEFAULT_CONFIG = {
+  apiKey: "",
+  baseUrl: DEFAULT_PROVIDER_BASE_URL,
+  model: DEFAULT_PROVIDER_MODEL,
+  fallbackModel: "",
+  systemPrompt: DEFAULT_SYSTEM_PROMPT,
+  temperature: DEFAULT_PROVIDER_TEMPERATURE,
+  maxTokens: DEFAULT_MAX_TOKENS,
+  maxRetries: DEFAULT_MAX_RETRIES,
+  retryBaseDelayMs: DEFAULT_RETRY_BASE_DELAY_MS,
+  retryMaxDelayMs: DEFAULT_RETRY_MAX_DELAY_MS,
+  apiKeyConfigured: false,
+  apiKeyPreview: ""
+};
+const useTranslationConfig = () => {
+  const [config, setConfig] = useState({ ...DEFAULT_CONFIG });
+  const { get, post } = useFetchClient();
+  const { toggleNotification } = useNotification();
+  const { formatMessage } = useIntl();
+  const applyPublicConfig = (settings) => {
+    setConfig({ ...DEFAULT_CONFIG, ...settings, apiKey: "" });
+  };
+  const notifySaveFailed = (error) => {
+    const serverError = error?.response?.data?.error;
+    const serverMessage = typeof serverError === "string" ? serverError : serverError?.message;
+    toggleNotification({
+      type: "danger",
+      message: serverMessage || formatMessage({
+        id: getTranslation("notification.config.save_failed"),
+        defaultMessage: "Could not save settings."
+      })
+    });
+  };
+  useEffect(() => {
+    const fetchData = async () => {
+      const response = await get(`/${PLUGIN_ID}/config`);
+      applyPublicConfig(response.data);
+    };
+    fetchData().catch(() => {
+    });
+  }, []);
+  const save = async (next) => {
+    try {
+      const response = await post(
+        `/${PLUGIN_ID}/config`,
+        toEditablePayload(next)
+      );
+      applyPublicConfig(response.data);
+      toggleNotification({
+        type: "success",
+        message: formatMessage({
+          id: getTranslation("notification.config.saved"),
+          defaultMessage: "Settings saved."
+        })
+      });
+    } catch (error) {
+      notifySaveFailed(error);
+    }
+  };
+  const clearApiKey = async () => {
+    try {
+      const response = await post(`/${PLUGIN_ID}/config`, { apiKey: null });
+      applyPublicConfig(response.data);
+      toggleNotification({
+        type: "success",
+        message: formatMessage({
+          id: getTranslation("notification.config.key_removed"),
+          defaultMessage: "Saved API key removed."
+        })
+      });
+    } catch (error) {
+      notifySaveFailed(error);
+    }
+  };
+  const restore = async () => {
+    try {
+      const response = await post(
+        `/${PLUGIN_ID}/config`,
+        toEditablePayload(DEFAULT_CONFIG)
+      );
+      applyPublicConfig(response.data);
+      toggleNotification({
+        type: "success",
+        message: formatMessage({
+          id: getTranslation("notification.config.restored"),
+          defaultMessage: "Default settings restored."
+        })
+      });
+    } catch (error) {
+      notifySaveFailed(error);
+    }
+  };
+  const updateField = (field, value) => {
+    setConfig((previous) => ({ ...previous, [field]: value }));
+  };
+  return { config, save, restore, clearApiKey, updateField };
+};
+const useProviderModels = () => {
+  const [models, setModels] = useState([]);
+  const [error, setError] = useState(null);
+  const { formatMessage } = useIntl();
+  const { post } = useFetchClient();
+  const requestSeq = useRef(0);
+  const load = async (draft = {}) => {
+    const seq = ++requestSeq.current;
+    setError(null);
+    try {
+      const response = await post(`/${PLUGIN_ID}/models`, {
+        apiKey: draft.apiKey,
+        baseUrl: draft.baseUrl
+      });
+      const next = Array.isArray(response.data?.models) ? response.data.models.filter(
+        (model) => model && typeof model.id === "string" && model.id.trim() !== ""
+      ) : [];
+      if (next.length === 0) {
+        throw new Error(
+          formatMessage({
+            id: getTranslation("settings.form.model_empty"),
+            defaultMessage: "No models were returned by the provider."
+          })
+        );
+      }
+      if (seq !== requestSeq.current) return;
+      setModels(next);
+    } catch (e) {
+      if (seq !== requestSeq.current) return;
+      setModels([]);
+      const serverError = e?.response?.data?.error;
+      setError(
+        serverError?.message || (typeof serverError === "string" ? serverError : "") || e?.message || formatMessage({
+          id: getTranslation("settings.form.model_load_failed"),
+          defaultMessage: "Failed to load provider models."
+        })
+      );
+    }
+  };
+  return { models, error, load };
+};
+const ProviderConnectionFields = ({
+  config,
+  updateField,
+  onClearApiKey,
+  providerModels,
+  providerModelsError,
+  onLoadModels
+}) => {
+  const { formatMessage } = useIntl();
+  const trimmedBaseUrl = config.baseUrl.trim().replace(/\/+$/, "");
+  const baseUrlMissingVersion = trimmedBaseUrl !== "" && !/\/v\d+$/.test(trimmedBaseUrl);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Typography, { variant: "beta", tag: "h2", marginBottom: 4, children: formatMessage({
+      id: getTranslation("settings.section.connection"),
+      defaultMessage: "Provider Connection"
+    }) }),
+    /* @__PURE__ */ jsxs(
+      Field.Root,
+      {
+        id: "api_key",
+        hint: config.apiKeyConfigured ? formatMessage(
+          {
+            id: getTranslation("settings.form.api_key_hint_configured"),
+            defaultMessage: "Currently saved: {preview}. Paste a new key to replace it, or leave blank to keep the current one."
+          },
+          { preview: config.apiKeyPreview }
+        ) : formatMessage({
+          id: getTranslation("settings.form.api_key_hint_empty"),
+          defaultMessage: "No key saved. Paste an API key to enable translation. Saved keys are never returned by the API."
+        }),
+        children: [
+          /* @__PURE__ */ jsx(Field.Label, { children: formatMessage({
+            id: getTranslation("settings.form.api_key"),
+            defaultMessage: "API Key"
+          }) }),
+          /* @__PURE__ */ jsx(
+            TextInput,
+            {
+              id: "api_key",
+              value: config.apiKey,
+              onChange: (e) => updateField("apiKey", e.target.value),
+              onBlur: onLoadModels,
+              name: "api_key",
+              type: "password",
+              autoComplete: "new-password",
+              placeholder: config.apiKeyConfigured ? formatMessage({
+                id: getTranslation("settings.form.api_key_placeholder_configured"),
+                defaultMessage: "Configured - enter a new key to replace it"
+              }) : formatMessage({
+                id: getTranslation("settings.form.api_key_placeholder_empty"),
+                defaultMessage: "Not configured"
+              })
+            }
+          ),
+          /* @__PURE__ */ jsx(Field.Error, {}),
+          /* @__PURE__ */ jsx(Field.Hint, {})
+        ]
+      }
+    ),
+    config.apiKeyConfigured ? /* @__PURE__ */ jsx(Box, { marginTop: 2, children: /* @__PURE__ */ jsx(Button, { variant: "danger-light", type: "button", size: "S", onClick: onClearApiKey, children: formatMessage({
+      id: getTranslation("settings.form.api_key_remove"),
+      defaultMessage: "Remove saved key"
+    }) }) }) : null,
+    /* @__PURE__ */ jsxs(
+      Field.Root,
+      {
+        id: "llm_base_url",
+        marginTop: 6,
+        hint: baseUrlMissingVersion ? formatMessage({
+          id: getTranslation("settings.form.base_url_hint_missing_version"),
+          defaultMessage: "Most OpenAI-compatible APIs require a version segment (e.g. ending with /v1)."
+        }) : formatMessage({
+          id: getTranslation("settings.form.base_url_hint"),
+          defaultMessage: "API endpoint for the model provider."
+        }),
+        children: [
+          /* @__PURE__ */ jsx(Field.Label, { children: formatMessage({
+            id: getTranslation("settings.form.base_url"),
+            defaultMessage: "Base URL"
+          }) }),
+          /* @__PURE__ */ jsx(
+            TextInput,
+            {
+              id: "llm_base_url",
+              value: config.baseUrl,
+              onChange: (e) => updateField("baseUrl", e.target.value),
+              onBlur: onLoadModels,
+              name: "llm_base_url",
+              placeholder: "https://api.openai.com/v1"
+            }
+          ),
+          /* @__PURE__ */ jsx(Field.Error, {}),
+          /* @__PURE__ */ jsx(Field.Hint, {})
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      Field.Root,
+      {
+        id: "llm_model",
+        marginTop: 6,
+        hint: providerModelsError || formatMessage({
+          id: getTranslation("settings.form.model_hint"),
+          defaultMessage: "Primary model for translations."
+        }),
+        children: [
+          /* @__PURE__ */ jsx(Field.Label, { children: formatMessage({
+            id: getTranslation("settings.form.model"),
+            defaultMessage: "Model"
+          }) }),
+          /* @__PURE__ */ jsx(
+            Combobox,
+            {
+              id: "llm_model",
+              value: config.model,
+              textValue: config.model,
+              onChange: (value) => updateField("model", value ?? ""),
+              onTextValueChange: (value) => updateField("model", value),
+              onClear: () => updateField("model", ""),
+              autocomplete: { type: "list", filter: "contains" },
+              allowCustomValue: true,
+              name: "llm_model",
+              children: providerModels.map((model) => /* @__PURE__ */ jsx(ComboboxOption, { value: model.id, children: model.label }, model.id))
+            }
+          ),
+          /* @__PURE__ */ jsx(Field.Error, {}),
+          /* @__PURE__ */ jsx(Field.Hint, {})
+        ]
+      }
+    )
+  ] });
+};
+const clampNumber = (value, defaultVal, min, max) => {
+  if (value === void 0) return defaultVal;
+  if (value < min) return min;
+  if (value > max) return max;
+  return value;
+};
+const TranslationSettingsFields = ({
+  config,
+  updateField
+}) => {
+  const { formatMessage } = useIntl();
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Typography, { variant: "beta", tag: "h2", marginTop: 8, marginBottom: 4, children: formatMessage({
+      id: getTranslation("settings.section.translation"),
+      defaultMessage: "Translation Settings"
+    }) }),
+    /* @__PURE__ */ jsxs(
+      Field.Root,
+      {
+        id: "system_prompt",
+        hint: formatMessage({
+          id: getTranslation("settings.form.system_prompt_hint"),
+          defaultMessage: "Instructions for the translation provider."
+        }),
+        required: true,
+        children: [
+          /* @__PURE__ */ jsx(Field.Label, { children: formatMessage({
+            id: getTranslation("settings.form.system_prompt"),
+            defaultMessage: "System prompt"
+          }) }),
+          /* @__PURE__ */ jsx(
+            Textarea,
+            {
+              id: "system_prompt",
+              value: config.systemPrompt,
+              onChange: (e) => updateField("systemPrompt", e.target.value),
+              required: true,
+              placeholder: DEFAULT_SYSTEM_PROMPT,
+              name: "system_prompt"
+            }
+          ),
+          /* @__PURE__ */ jsx(Field.Error, {}),
+          /* @__PURE__ */ jsx(Field.Hint, {})
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx(Flex, { gap: 4, marginTop: 6, children: /* @__PURE__ */ jsxs(
+      Field.Root,
+      {
+        id: "llm_temperature",
+        flex: 1,
+        hint: formatMessage({
+          id: getTranslation("settings.form.temperature_hint"),
+          defaultMessage: "Higher = more creative, lower = more deterministic."
+        }),
+        children: [
+          /* @__PURE__ */ jsx(Field.Label, { children: formatMessage({
+            id: getTranslation("settings.form.temperature"),
+            defaultMessage: "Temperature"
+          }) }),
+          /* @__PURE__ */ jsx(
+            NumberInput,
+            {
+              id: "llm_temperature",
+              value: config.temperature,
+              name: "llm_temperature",
+              step: 0.1,
+              min: MIN_PROVIDER_TEMPERATURE,
+              max: MAX_PROVIDER_TEMPERATURE,
+              onValueChange: (value) => {
+                updateField(
+                  "temperature",
+                  clampNumber(
+                    value,
+                    DEFAULT_PROVIDER_TEMPERATURE,
+                    MIN_PROVIDER_TEMPERATURE,
+                    MAX_PROVIDER_TEMPERATURE
+                  )
+                );
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx(Field.Error, {}),
+          /* @__PURE__ */ jsx(Field.Hint, {})
+        ]
+      }
+    ) })
+  ] });
+};
+const SettingsPage = () => {
+  const { formatMessage } = useIntl();
+  const { config, save, restore, clearApiKey, updateField } = useTranslationConfig();
+  const providerModels = useProviderModels();
+  const loadModels = () => {
+    if (!config.apiKeyConfigured && config.apiKey.trim() === "") return;
+    providerModels.load({ apiKey: config.apiKey, baseUrl: config.baseUrl });
+  };
+  useEffect(() => {
+    loadModels();
+  }, [config.apiKeyConfigured]);
+  return /* @__PURE__ */ jsxs(Main, { children: [
+    /* @__PURE__ */ jsxs(
+      Box,
+      {
+        paddingLeft: 10,
+        paddingRight: 10,
+        paddingBottom: 8,
+        paddingTop: 8,
+        "data-strapi-header": true,
+        background: "neutral100",
+        children: [
+          /* @__PURE__ */ jsxs(Flex, { alignItems: "center", gap: 3, marginBottom: 4, children: [
+            /* @__PURE__ */ jsx(PluginIcon, { width: 42, height: 42 }),
+            /* @__PURE__ */ jsx(Typography, { variant: "alpha", tag: "h1", fontWeight: "bold", children: formatMessage({
+              id: getTranslation("settings.page.title"),
+              defaultMessage: "AI Translator Configuration"
+            }) })
+          ] }),
+          /* @__PURE__ */ jsx(Typography, { variant: "delta", textColor: "neutral600", fontWeight: "normal", children: formatMessage({
+            id: getTranslation("settings.page.description"),
+            defaultMessage: "Configure AI translation settings for localized Strapi content."
+          }) })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx(Box, { paddingLeft: 10, paddingRight: 10, children: /* @__PURE__ */ jsx(
+      Box,
+      {
+        paddingLeft: 10,
+        paddingRight: 10,
+        paddingTop: 8,
+        paddingBottom: 8,
+        background: "neutral0",
+        children: /* @__PURE__ */ jsxs(
+          "form",
+          {
+            onSubmit: (e) => {
+              e.preventDefault();
+              save(config);
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                ProviderConnectionFields,
+                {
+                  onClearApiKey: clearApiKey,
+                  config,
+                  updateField,
+                  providerModels: providerModels.models,
+                  providerModelsError: providerModels.error,
+                  onLoadModels: loadModels
+                }
+              ),
+              /* @__PURE__ */ jsx(TranslationSettingsFields, { config, updateField }),
+              /* @__PURE__ */ jsxs(Flex, { gap: 2, marginTop: 6, justifyContent: "flex-end", children: [
+                /* @__PURE__ */ jsx(Button, { variant: "secondary", type: "button", onClick: restore, marginTop: 4, children: formatMessage({
+                  id: getTranslation("settings.form.restore"),
+                  defaultMessage: "Restore Defaults"
+                }) }),
+                /* @__PURE__ */ jsx(Button, { variant: "default", type: "submit", marginTop: 4, children: formatMessage({
+                  id: getTranslation("settings.form.save"),
+                  defaultMessage: "Save"
+                }) })
+              ] })
+            ]
+          }
+        )
+      }
+    ) })
+  ] });
+};
+export {
+  SettingsPage
+};