saltcorn-samba 0.4.15 → 0.4.16

package/CHANGELOG.md

@@ -4,6 +4,102 @@ All notable changes to `saltcorn-samba` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.4.16] – 2026-07-08
+
+### Added – Internationalisierung (Deutsch + Englisch)
+
+Alle sichtbaren Texte im File-Manager, im Tree, im PDF-Fieldview und in den
+Dialogen (Upload, Delete, Rename, Mkdir) sind jetzt übersetzbar.
+
+- Neue Kataloge unter `i18n/de.json` und `i18n/en.json` (~90 Schlüssel,
+  Punkt-Notation nach Bereich `ui.*`, `fm.*`, `tree.*`, `pdf.*`).
+- Neues Server-Modul `i18n.js` – keine externe Dependency, JSON-Kataloge
+  werden gelesen und im Prozess gecacht. Placeholder-Interpolation `{name}`.
+  API: `t(key, {locale, ...params})`, `tFor(locale)`, `catalogFor(locale)`,
+  `resolveLocaleFromReq(req, explicit)`.
+- Locale-Auflösung: expliziter Wert → `req.getLocale()` → Query `?locale=xx`
+  → `Accept-Language`-Header → Fallback `en`. Unbekannte Locales fallen
+  automatisch auf die Sprachbasis oder `en` zurück.
+- Neue Diagnose-Route `GET /samba-i18n.json?locale=xx` liefert den Katalog
+  als JSON (kein Auth, enthält keine Konfiguration).
+- Client bekommt den Katalog **inline** in die View-Shell injiziert – kein
+  zusätzlicher HTTP-Roundtrip beim ersten Rendern, keine englischen Keys, die
+  kurz aufblitzen. `SambaCommon.setCatalog(…)` wird aufgerufen, bevor die
+  view-spezifische JS-Datei geladen wird.
+- Fehlt ein Key: automatischer Fallback auf Englisch, dann auf den Key
+  selbst – nichts bricht.
+
+### Changed – Client-JS: Gemeinsame Utilities in `public/samba-common.js`
+
+- Neues Modul `public/samba-common.js` bündelt: `iconFor()`, `extOf()`,
+  `mediaTypeFor()`, `isViewable()`, `fmtSize()`, `fmtDate()`, `joinPath()`,
+  `parentOf()`, plus die i18n-Funktionen `t()`, `setCatalog()`, `loadCatalog()`.
+- **`iconFor()` war bisher in `samba-filemanager.js` und `samba-tree.js`
+  identisch dupliziert** – jetzt einzige Quelle in `samba-common.js`.
+  Änderungen am Icon-Mapping (neue Extensions etc.) müssen nur noch an einer
+  Stelle gemacht werden.
+- `samba-filemanager.js` und `samba-tree.js` konsumieren die Utilities über
+  `window.SambaCommon`. Die lokalen Kopien von `iconFor`, `extOf`,
+  `mediaTypeFor`, `isViewable`, `fmtSize`, `fmtDate`, `joinPath`, `parentOf`
+  sind entfernt.
+- Alle sichtbaren Strings in beiden Client-JS gehen über `SambaCommon.t(...)`.
+
+### Changed – Bootstrap der View-Shells: zweistufig
+
+`filemanager-view.js` und `tree-view.js` laden jetzt zuerst `samba-common.js`
+(setzt `window.SambaCommon`, wendet den inline gelieferten i18n-Katalog an)
+und erst danach die view-spezifische JS-Datei. Sind beide bereits geladen,
+wird nur re-mounted – kein doppeltes `<script>`-Injecten. `pdf-view.js`
+nutzt serverseitig `tFor(resolveLocaleFromReq(req))`.
+
+### Changed – Namens-Cleanup und Kommentare in beiden Client-JS
+
+Goal: die Client-Dateien sollen sich wie ordentliche Node-ähnliche Module
+lesen, nicht wie ein Minifier-Output.
+
+- `samba-tree.js`: `h`→`element`, `fetchDir`→`fetchDirectory`,
+  `renderList`→`renderLevel`, `openDir`→`toggleDirectory`, `li`→`lineItem`
+  u.ä. Jede exportierte / interne Funktion hat einen JSDoc-Kommentar.
+- `samba-filemanager.js`: `h`→`element`, `modal`→`openModal`, `m`→`dialog`,
+  `r`→`response`, `fd`→`formData`, `overwriteCb`→`overwriteCheckbox`,
+  `picked`→`pickedList`, `uploadBtn`→`uploadButton`. Kommentare ergänzt.
+
+### Added – README: Sicherheits-Abschnitt „Client-/Server-Trennung“
+
+Neuer Unterabschnitt in `## Sicherheit` erklärt explizit:
+
+- Welche Dateien serverseitig laufen (SMB-Credentials, `base_path`,
+  `view_base_path`, Sanitizer, Routen) und welche clientseitig (reine UI).
+- Wo genau Sicherheit durchgesetzt wird: CSRF (Saltcorn-csurf), Auth/Rolle
+  (Saltcorn + `min_role_read`/`min_role_write`), `sanitizeRelativePath`,
+  Base-Path-Enforcement, SMB-Session mit serverseitig konfiguriertem User.
+- Wichtiger Hinweis: `view_base_path` ist **keine** Sicherheitsgrenze
+  zwischen Usern; für Mandantentrennung entweder Rollen-gated Views oder
+  eigene Plugin-Instanzen mit separaten SMB-Usern.
+- Kurzfassung: JavaScript in `public/` ist reine Kosmetik; jeder Client (auch
+  ein manipulierter) bekommt dieselben 403/400-Antworten wie ein regulärer.
+
+Zusätzlich neuer Abschnitt `## Internationalisierung (i18n)` mit
+Entwickler-Doku (Kataloge ergänzen, API, Locale-Auflösung, Diagnose-Route).
+
+### Packaging
+
+- `package.json`: Version 0.4.15 → 0.4.16. `files` ergänzt um `i18n.js` und
+  `i18n/`. `lint`-Script prüft jetzt auch `i18n.js` und `public/samba-common.js`.
+- Keine neuen Runtime-Dependencies. Fortlaufend: nur `smb3-client ^0.2.0`.
+
+### Compatibility
+
+Rückwärtskompatibel:
+
+- Alle bestehenden Routen (`/sambadir`, `/sambafile`, `/sambalink`,
+  `/sambaupload`, `/sambadelete`, `/sambarename`, `/sambamkdir`, `/sambatest`)
+  unverändert in Signatur und Verhalten.
+- View-Konfigurationsschema unverändert; existierende Views laufen weiter.
+- Wer die Client-JS direkt einbindet, muss zusätzlich `samba-common.js` vor
+  `samba-filemanager.js` / `samba-tree.js` laden (das übernimmt die
+  View-Shell automatisch).
+
 ## [0.4.15] – 2026-07-07
 
 ### Fixed – CSRF-Fehlermeldung bei Upload / Ordner anlegen / Rename / Delete

package/README.md

@@ -304,6 +304,70 @@ führende/abschließende Punkte oder Windows-Reserved-Names enthalten.
 
 Unit-Tests zum Path- und Filename-Sanitizer laufen in CI (`npm test`).
 
+### Client-/Server-Trennung
+
+Damit klar ist, wo Sicherheit tatsächlich durchgesetzt wird: das Plugin
+läuft in zwei streng getrennten Welten.
+
+- **Serverseitig (Node.js im Saltcorn-Prozess):**
+  `index.js` (HTTP-Routen), `smb-client.js` (SMB3-Verbindung, Auth, Signing,
+  Encryption), `readdir-compat.js` (Verzeichnis-Listing),
+  `filemanager-view.js` / `tree-view.js` / `pdf-view.js`
+  (configuration_workflow, run, computeStartPath, sanitizeRelativePath),
+  `i18n.js` (Übersetzungskatalog) und `tools/diag-*.js` (CLI-Diagnose).
+  **SMB-Credentials (User, Domain, Passwort), Plugin-`base_path` und pro-View
+  `view_base_path` liegen ausschließlich serverseitig in der Saltcorn-DB.**
+  Der Browser sieht davon nichts.
+
+- **Clientseitig (Browser, unter `public/`):**
+  `samba-filemanager.js`, `samba-tree.js`, `samba-common.js` (gemeinsame
+  Utilities + i18n) und `samba.css`. Reine UI. Alle Zugriffe laufen über
+  `fetch()` mit `X-CSRF-Token`-Header.
+
+- **Enforcement-Punkte serverseitig — in jeder Request-Bearbeitung:**
+  1. **CSRF** – Saltcorns globale csurf-Middleware. Ohne Token: 403.
+  2. **Auth/Rolle** – Saltcorn prüft Login und View/Table-Rechte vor `run(…)`.
+     Zusätzlich prüft jede Route `min_role_read` bzw. `min_role_write`.
+  3. **Pfad-Sanitizing** – `sanitizeRelativePath` lehnt `..`, absolute Pfade,
+     UNC-Präfixe, Laufwerksbuchstaben und NUL-Bytes ab.
+  4. **Base-Path-Enforcement** – der effektive Pfad ist immer relativ zum
+     serverseitig konfigurierten `base_path`; `view_base_path` stammt aus der
+     View-Konfig, nie aus dem Request.
+  5. **SMB-Session** läuft mit dem serverseitig konfigurierten SMB-User; der
+     Client kann keine anderen Credentials injizieren.
+
+- **Wichtige Hinweise:**
+  `view_base_path` ist **keine** Sicherheitsgrenze zwischen Usern – nur
+  Bequemlichkeit. Für Mandantentrennung entweder eigene Views pro Mandant
+  (mit Rollen-Steuerung), oder mehrere Plugin-Instanzen mit unterschiedlichen
+  SMB-Usern. Produktions-Empfehlung: dedizierter SMB-Service-Account mit
+  minimalen Rechten; die Fileserver-ACL limitiert dann zusätzlich.
+
+- **Kurzfassung:** JavaScript in `public/` ist reine Kosmetik. Alle
+  Zugriffsrechte werden serverseitig durchgesetzt — ein manipulierter Client
+  bekommt genau die gleichen 403/400-Antworten wie ein regulärer.
+
+---
+
+## Internationalisierung (i18n)
+
+Ab v0.4.16 sind alle sichtbaren Texte übersetzbar. Ausgeliefert werden **de**
+und **en**.
+
+- Kataloge liegen als JSON unter `i18n/<locale>.json`.
+- Serverseitige Nutzung: `const { t, tFor } = require("./i18n");`
+  → `t("fm.upload.button", { locale: "de" })` bzw.
+  `const _t = tFor("de"); _t("fm.upload.button")`.
+- Clientseitig: `window.SambaCommon.t("fm.upload.button")`. Der Katalog wird
+  von der View-Shell inline in die Seite injiziert (kein Extra-Request).
+- Locale-Auflösung: explizit übergebener Wert → `req.getLocale()` →
+  `?locale=xx` → `Accept-Language` → Fallback `en`.
+- Neue Sprache ergänzen: `i18n/<locale>.json` anlegen, `availableLocales` in
+  `i18n.js` erweitern, PR aufmachen. Fehlt ein Key, greift automatisch der
+  englische Fallback — nichts bricht.
+- Diagnose-Endpoint: `GET /samba-i18n.json?locale=de` liefert den kompletten
+  Katalog als JSON (ohne Auth, enthält keine Konfiguration).
+
 ---
 
 ## Entwicklung

package/filemanager-view.js

@@ -18,6 +18,7 @@ const Field = require("@saltcorn/data/models/field");
 const Table = require("@saltcorn/data/models/table");
 
 const { sanitizeRelativePath } = require("./smb-client");
+const { catalogFor, resolveLocaleFromReq } = require("./i18n");
 
 // ---------------------------------------------------------------------------
 // Configuration workflow
@@ -170,8 +171,21 @@ function computeStartPath(configuration, row) {
 // Shell renderer
 // ---------------------------------------------------------------------------
 
-function renderShell(startPath, configuration, pluginVersion, csrfToken) {
+/**
+ * Serialisiert den i18n-Katalog inline in die Seite. Alternative w\u00e4re ein
+ * zus\u00e4tzlicher HTTP-Roundtrip auf /samba-i18n.json — inline spart einen
+ * Request und rendert die Oberfl\u00e4che ohne Aufblitzen englischer Keys.
+ * `</script>` wird escaped, damit das JSON-Blob den HTML-Parser nicht t\u00f6tet.
+ */
+function serialiseCatalog(catalog) {
+  return JSON.stringify(catalog || {}).replace(/</g, "\\u003c");
+}
+
+function renderShell(startPath, configuration, pluginVersion, csrfToken, locale, catalog) {
   const id = "samba-fm-" + Math.random().toString(36).slice(2, 10);
+  // Panel-Titel: wenn der User keinen eigenen Titel gesetzt hat, greift die
+  // \u00fcbersetzte Default-Bezeichnung aus dem i18n-Katalog.
+  const defaultTitle = (catalog && catalog["fm.title_default"]) || "Samba files";
   const opts = {
     startPath,
     showHidden: !!configuration.show_hidden,
@@ -179,10 +193,16 @@ function renderShell(startPath, configuration, pluginVersion, csrfToken) {
     pdfInline: configuration.pdf_inline !== false,
     exposeSmbLink: configuration.expose_smb_link !== false,
     pageSize: Number(configuration.page_size) || 0,
-    title: configuration.title || "Samba files",
+    title: configuration.title || defaultTitle,
     csrfToken: csrfToken || "",
+    locale: locale || "en",
   };
 
+  // Zwei-Stufen-Bootstrap:
+  //   1. samba-common.js laden (SambaCommon global) und Katalog setzen
+  //   2. samba-filemanager.js laden und mounten
+  // Wenn beide Skripte bereits geladen sind, wird nur remounted.
+  const catalogJson = serialiseCatalog(catalog);
   return (
     div(
       { class: "samba-fm card" },
@@ -201,14 +221,23 @@ function renderShell(startPath, configuration, pluginVersion, csrfToken) {
     ) +
     script(
       `(function(){
-         function boot(){window.saltcornSambaMountFM && window.saltcornSambaMountFM(${JSON.stringify(
+         var CATALOG=${catalogJson};
+         function applyCatalog(){ if(window.SambaCommon && window.SambaCommon.setCatalog) window.SambaCommon.setCatalog(CATALOG); }
+         function mount(){window.saltcornSambaMountFM && window.saltcornSambaMountFM(${JSON.stringify(
            id
          )}, ${JSON.stringify(opts)});}
-         if(window.saltcornSambaMountFM){boot();return;}
-         var s=document.createElement('script');
-         s.src='/plugins/public/saltcorn-samba@${pluginVersion}/samba-filemanager.js';
-         s.onload=boot;
-         document.head.appendChild(s);
+         function loadFM(){
+           if(window.saltcornSambaMountFM){ mount(); return; }
+           var s=document.createElement('script');
+           s.src='/plugins/public/saltcorn-samba@${pluginVersion}/samba-filemanager.js';
+           s.onload=mount;
+           document.head.appendChild(s);
+         }
+         if(window.SambaCommon){ applyCatalog(); loadFM(); return; }
+         var c=document.createElement('script');
+         c.src='/plugins/public/saltcorn-samba@${pluginVersion}/samba-common.js';
+         c.onload=function(){ applyCatalog(); loadFM(); };
+         document.head.appendChild(c);
        })();`
     )
   );
@@ -230,9 +259,21 @@ function extractCsrf(extra) {
   return "";
 }
 
+/**
+ * Liest die vom Nutzer bevorzugte Sprache aus dem Request (Saltcorn setzt
+ * das aus Login-Cookie / Accept-Language) und liefert Locale + Katalog. Bei
+ * Ausfall greift `en` als Notnagel – hardgecodete Strings werden nie leer.
+ */
+function resolveLocaleAndCatalog(extra) {
+  const req = extra && extra.req;
+  const locale = resolveLocaleFromReq(req);
+  return { locale, catalog: catalogFor(locale) };
+}
+
 async function run(table_id, viewname, configuration, state, extra) {
   const pluginVersion = configuration.__pluginVersion || "0.3.0";
   const csrf = extractCsrf(extra);
+  const { locale, catalog } = resolveLocaleAndCatalog(extra);
   let row = extra && extra.row;
   if (!row && configuration.mode === "from_field" && table_id) {
     const table = await Table.findOne({ id: table_id });
@@ -250,12 +291,13 @@ async function run(table_id, viewname, configuration, state, extra) {
   } catch (e) {
     return div({ class: "alert alert-danger" }, "Samba file manager: " + e.message);
   }
-  return renderShell(startPath, configuration, pluginVersion, csrf);
+  return renderShell(startPath, configuration, pluginVersion, csrf, locale, catalog);
 }
 
 async function runMany(table_id, viewname, configuration, state, extra) {
   const pluginVersion = configuration.__pluginVersion || "0.3.0";
   const csrf = extractCsrf(extra);
+  const { locale, catalog } = resolveLocaleAndCatalog(extra);
   const rows = (extra && extra.rows) || [];
   return rows.map((row) => {
     let startPath = "";
@@ -265,7 +307,7 @@ async function runMany(table_id, viewname, configuration, state, extra) {
       startPath = "";
     }
     return {
-      html: renderShell(startPath, configuration, pluginVersion, csrf),
+      html: renderShell(startPath, configuration, pluginVersion, csrf, locale, catalog),
       row,
     };
   });

package/i18n/de.json

@@ -0,0 +1,93 @@
+{
+  "$meta": {
+    "language": "Deutsch",
+    "locale": "de",
+    "note": "Übersetzungskatalog für saltcorn-samba. Punkt-Notation gruppiert nach Bereich."
+  },
+
+  "ui.loading": "Lädt …",
+  "ui.close": "Schließen",
+  "ui.cancel": "Abbrechen",
+  "ui.confirm": "OK",
+  "ui.error": "Fehler",
+  "ui.empty": "(leeres Verzeichnis)",
+  "ui.empty_short": "(leer)",
+  "ui.path": "Pfad:",
+  "ui.show_hidden": "Versteckte Dateien anzeigen",
+  "ui.up": "⬆ Übergeordnet",
+  "ui.up_title": "Ein Verzeichnis nach oben",
+  "ui.home_title": "Zur Wurzel springen",
+  "ui.refresh_title": "Aktualisieren",
+  "ui.page_of": "Seite {page} / {total}",
+  "ui.prev_page": "‹",
+  "ui.next_page": "›",
+
+  "fm.title_default": "Samba-Dateien",
+  "fm.col.filename": "Dateiname",
+  "fm.col.media_type": "MIME-Typ",
+  "fm.col.size": "Größe",
+  "fm.col.modified": "Geändert",
+  "fm.col.actions": "Aktionen",
+  "fm.counter": "{dirs} Ordner · {files} Dateien",
+  "fm.open": "Öffnen",
+  "fm.open_new_tab": "In neuem Tab öffnen",
+  "fm.view": "Anzeigen",
+  "fm.download": "Herunterladen",
+  "fm.rename": "Umbenennen",
+  "fm.rename_title": "Umbenennen",
+  "fm.delete": "Löschen",
+  "fm.delete_title": "Löschen",
+  "fm.smb_link_title": "Im Datei-Manager öffnen (Nemo/Nautilus/Explorer)",
+  "fm.upload": "⬆ Hochladen",
+  "fm.upload_title": "Dateien in dieses Verzeichnis hochladen",
+  "fm.new_folder": "+ Ordner",
+  "fm.new_folder_title": "Neuen Ordner anlegen",
+
+  "fm.confirm_delete.title": "Löschen bestätigen",
+  "fm.confirm_delete.prompt_prefix": "„",
+  "fm.confirm_delete.prompt_suffix": "\" wirklich löschen?",
+  "fm.confirm_delete.dir_hint": "Klappt nur, wenn das Verzeichnis leer ist.",
+  "fm.confirm_delete.file_hint": "Dieser Vorgang kann nicht rückgängig gemacht werden.",
+  "fm.deleted_ok": "„{name}\" gelöscht",
+  "fm.deleted_fail": "Löschen fehlgeschlagen: {msg}",
+
+  "fm.rename.title": "„{name}\" umbenennen",
+  "fm.rename.label": "Neuer Name",
+  "fm.rename.hint": "Slashes sind nicht erlaubt. Zum Verschieben stattdessen die ↗-Funktion nutzen.",
+  "fm.renamed_ok": "Umbenannt in „{name}\"",
+  "fm.rename_fail": "Umbenennen fehlgeschlagen: {msg}",
+
+  "fm.mkdir.title": "Ordner anlegen in {path}",
+  "fm.mkdir.label": "Ordnername",
+  "fm.mkdir.placeholder": "Neuer Ordnername",
+  "fm.mkdir.create": "Anlegen",
+  "fm.mkdir_ok": "Ordner „{name}\" angelegt",
+  "fm.mkdir_fail": "Ordner anlegen fehlgeschlagen: {msg}",
+
+  "fm.upload.title": "Dateien hochladen",
+  "fm.upload.dropzone": "Dateien hierher ziehen oder klicken zum Auswählen",
+  "fm.upload.into_prefix": "Ziel: ",
+  "fm.upload.limit": ". Max. {mb} MiB pro Datei.",
+  "fm.upload.or_pick": "…oder Dateien auswählen",
+  "fm.upload.overwrite": "Vorhandene Dateien überschreiben",
+  "fm.upload.button": "Hochladen",
+  "fm.upload.uploading": "Wird hochgeladen …",
+  "fm.upload.no_files": "Keine Dateien ausgewählt",
+  "fm.upload.ok": "{n} Datei(en) hochgeladen",
+  "fm.upload.partial_summary": "{ok} von {total} Dateien hochgeladen. Fehler:",
+  "fm.upload.some_failed": "Einige Uploads fehlgeschlagen",
+  "fm.upload.failed": "Upload fehlgeschlagen: {msg}",
+  "fm.upload.failed_short": "Upload fehlgeschlagen",
+
+  "tree.open_in_fm": "Im Datei-Manager öffnen",
+  "tree.open_in_fm_title": "Im Datei-Manager öffnen",
+  "tree.error_prefix": "Fehler: ",
+  "tree.samba_prefix": "Samba: ",
+  "tree.open_new_tab": "In neuem Tab öffnen",
+
+  "pdf.download": "Herunterladen",
+  "pdf.open_in_fm": "Im Datei-Manager öffnen",
+  "pdf.open_in_fm_title": "In Nemo/Nautilus/Explorer öffnen",
+  "pdf.open_new_tab": "In neuem Tab öffnen",
+  "pdf.empty": "—"
+}

package/i18n/en.json

@@ -0,0 +1,93 @@
+{
+  "$meta": {
+    "language": "English",
+    "locale": "en",
+    "note": "Translation catalogue for saltcorn-samba. Dot notation groups keys by area."
+  },
+
+  "ui.loading": "Loading…",
+  "ui.close": "Close",
+  "ui.cancel": "Cancel",
+  "ui.confirm": "OK",
+  "ui.error": "Error",
+  "ui.empty": "(empty directory)",
+  "ui.empty_short": "(empty)",
+  "ui.path": "Path:",
+  "ui.show_hidden": "Show hidden",
+  "ui.up": "⬆ Up",
+  "ui.up_title": "Up one directory",
+  "ui.home_title": "Go to root",
+  "ui.refresh_title": "Refresh",
+  "ui.page_of": "Page {page} / {total}",
+  "ui.prev_page": "‹",
+  "ui.next_page": "›",
+
+  "fm.title_default": "Samba files",
+  "fm.col.filename": "Filename",
+  "fm.col.media_type": "Media type",
+  "fm.col.size": "Size",
+  "fm.col.modified": "Modified",
+  "fm.col.actions": "Actions",
+  "fm.counter": "{dirs} folders · {files} files",
+  "fm.open": "Open",
+  "fm.open_new_tab": "Open in new tab",
+  "fm.view": "View",
+  "fm.download": "Download",
+  "fm.rename": "Rename",
+  "fm.rename_title": "Rename",
+  "fm.delete": "Delete",
+  "fm.delete_title": "Delete",
+  "fm.smb_link_title": "Open in file manager (Nemo/Nautilus/Explorer)",
+  "fm.upload": "⬆ Upload",
+  "fm.upload_title": "Upload files to this directory",
+  "fm.new_folder": "+ Folder",
+  "fm.new_folder_title": "Create new folder",
+
+  "fm.confirm_delete.title": "Confirm delete",
+  "fm.confirm_delete.prompt_prefix": "Delete \"",
+  "fm.confirm_delete.prompt_suffix": "\"?",
+  "fm.confirm_delete.dir_hint": "This will only succeed if the directory is empty.",
+  "fm.confirm_delete.file_hint": "This action cannot be undone.",
+  "fm.deleted_ok": "Deleted {name}",
+  "fm.deleted_fail": "Delete failed: {msg}",
+
+  "fm.rename.title": "Rename \"{name}\"",
+  "fm.rename.label": "New name",
+  "fm.rename.hint": "Slashes are not allowed. To move, use the ↗ file-manager link instead.",
+  "fm.renamed_ok": "Renamed to {name}",
+  "fm.rename_fail": "Rename failed: {msg}",
+
+  "fm.mkdir.title": "Create folder in {path}",
+  "fm.mkdir.label": "Folder name",
+  "fm.mkdir.placeholder": "New folder name",
+  "fm.mkdir.create": "Create",
+  "fm.mkdir_ok": "Created folder {name}",
+  "fm.mkdir_fail": "Create folder failed: {msg}",
+
+  "fm.upload.title": "Upload files",
+  "fm.upload.dropzone": "Drop files here or click to select",
+  "fm.upload.into_prefix": "Uploading to ",
+  "fm.upload.limit": ". Max {mb} MiB per file.",
+  "fm.upload.or_pick": "…or pick files",
+  "fm.upload.overwrite": "Overwrite existing files",
+  "fm.upload.button": "Upload",
+  "fm.upload.uploading": "Uploading…",
+  "fm.upload.no_files": "No files selected",
+  "fm.upload.ok": "Uploaded {n} file(s)",
+  "fm.upload.partial_summary": "Uploaded {ok} / {total} files. Failures:",
+  "fm.upload.some_failed": "Some uploads failed",
+  "fm.upload.failed": "Upload failed: {msg}",
+  "fm.upload.failed_short": "Upload failed",
+
+  "tree.open_in_fm": "Open in file manager",
+  "tree.open_in_fm_title": "Open in file manager",
+  "tree.error_prefix": "Error: ",
+  "tree.samba_prefix": "Samba: ",
+  "tree.open_new_tab": "Open in new tab",
+
+  "pdf.download": "Download",
+  "pdf.open_in_fm": "Open in file manager",
+  "pdf.open_in_fm_title": "Open in Nemo/Nautilus/Explorer",
+  "pdf.open_new_tab": "Open in new tab",
+  "pdf.empty": "—"
+}

package/i18n.js

@@ -0,0 +1,155 @@
+/**
+ * saltcorn-samba – Minimales i18n-Modul (Server-Seite).
+ *
+ * Design-Ziele:
+ *   - Keine externe Dependency (kein i18next, keine intl-messageformat).
+ *   - JSON-Kataloge unter ./i18n/<locale>.json.
+ *   - Lazy load + Cache; unbekannte Locales fallen automatisch auf `en`.
+ *   - Placeholder-Syntax {name} wird durch die übergebenen Werte ersetzt.
+ *
+ * Locale-Auflösung (in dieser Reihenfolge):
+ *   1. Explizit übergebener Wert (Request-Query ?locale=de).
+ *   2. `req.getLocale()` (Saltcorn setzt das aus Cookie / Accept-Language).
+ *   3. `req.headers["accept-language"]`  – erste passende Locale.
+ *   4. Fallback = `en`.
+ *
+ * Die Client-Seite bekommt den passenden Katalog via Route
+ *   GET /samba-i18n.json?locale=xx
+ * (siehe index.js). Dort ruft samba-common.js `SambaCommon.setCatalog(...)` auf.
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const CATALOG_DIR = path.join(__dirname, "i18n");
+const DEFAULT_LOCALE = "en";
+const catalogs = Object.create(null);       // locale -> { key: str }
+const availableLocales = new Set(["de", "en"]);
+
+/**
+ * Load a catalogue from disk. Cached forever (plugin restart to reload).
+ * Missing files silently return {} — the caller falls back to the key itself.
+ */
+function loadCatalog(locale) {
+  if (catalogs[locale]) return catalogs[locale];
+  const file = path.join(CATALOG_DIR, locale + ".json");
+  try {
+    const raw = fs.readFileSync(file, "utf8");
+    const parsed = JSON.parse(raw);
+    delete parsed.$meta;   // metadata is not a translation
+    catalogs[locale] = parsed;
+  } catch (_) {
+    catalogs[locale] = {};
+  }
+  return catalogs[locale];
+}
+
+/**
+ * Resolve a locale string to one we actually ship a catalogue for.
+ * Accepts full IETF tags ("de-DE", "en-US") and language-only ("de", "en").
+ */
+function normaliseLocale(raw) {
+  if (!raw) return DEFAULT_LOCALE;
+  const lc = String(raw).toLowerCase().trim();
+  if (availableLocales.has(lc)) return lc;
+  const short = lc.split(/[-_]/)[0];
+  if (availableLocales.has(short)) return short;
+  return DEFAULT_LOCALE;
+}
+
+/**
+ * Extract the caller's preferred locale from an Express-like request object.
+ * Never throws; falls back to DEFAULT_LOCALE.
+ */
+function resolveLocaleFromReq(req, explicit) {
+  if (explicit) return normaliseLocale(explicit);
+  try {
+    if (req) {
+      // Saltcorn / i18next-express-middleware
+      if (typeof req.getLocale === "function") {
+        const l = req.getLocale();
+        if (l) return normaliseLocale(l);
+      }
+      // Explicit query ?locale=de
+      if (req.query && req.query.locale) {
+        return normaliseLocale(req.query.locale);
+      }
+      // Accept-Language header – take the first tag we understand.
+      const hdr = req.headers && req.headers["accept-language"];
+      if (hdr) {
+        const first = String(hdr).split(",")[0].split(";")[0];
+        return normaliseLocale(first);
+      }
+    }
+  } catch (_) {
+    // fall through
+  }
+  return DEFAULT_LOCALE;
+}
+
+/**
+ * Substitute {placeholder} tokens in the message. Missing values render as "".
+ */
+function interpolate(msg, params) {
+  if (!params) return msg;
+  return String(msg).replace(/\{(\w+)\}/g, (_, key) =>
+    Object.prototype.hasOwnProperty.call(params, key) ? String(params[key]) : ""
+  );
+}
+
+/**
+ * Translate a single key. Falls back to English, then to the key itself so
+ * a missing translation never breaks the UI.
+ *
+ *   t("fm.upload.button", { locale: "de" })                → "Hochladen"
+ *   t("fm.deleted_ok", { locale: "de", name: "foo.txt" }) → "„foo.txt\" gelöscht"
+ */
+function t(key, params) {
+  const opts = params || {};
+  const locale = normaliseLocale(opts.locale);
+  const primary = loadCatalog(locale);
+  if (Object.prototype.hasOwnProperty.call(primary, key)) {
+    return interpolate(primary[key], opts);
+  }
+  if (locale !== DEFAULT_LOCALE) {
+    const fallback = loadCatalog(DEFAULT_LOCALE);
+    if (Object.prototype.hasOwnProperty.call(fallback, key)) {
+      return interpolate(fallback[key], opts);
+    }
+  }
+  return key;
+}
+
+/**
+ * Bind a locale so callers can write `const _ = tFor("de"); _("ui.close")`.
+ */
+function tFor(locale) {
+  const loc = normaliseLocale(locale);
+  return function boundTranslate(key, params) {
+    return t(key, Object.assign({}, params || {}, { locale: loc }));
+  };
+}
+
+/**
+ * Return the raw catalogue for a locale, merged over the English defaults.
+ * Used to ship a single JSON blob to the browser.
+ */
+function catalogFor(locale) {
+  const loc = normaliseLocale(locale);
+  const en = loadCatalog(DEFAULT_LOCALE);
+  if (loc === DEFAULT_LOCALE) return Object.assign({}, en);
+  const merged = Object.assign({}, en, loadCatalog(loc));
+  return merged;
+}
+
+module.exports = {
+  DEFAULT_LOCALE,
+  availableLocales: Array.from(availableLocales),
+  t,
+  tFor,
+  catalogFor,
+  resolveLocaleFromReq,
+  normaliseLocale,
+};