@ecosplay/e-translate 1.0.0

package/README.md

@@ -0,0 +1,149 @@
+# @ecosplay/e-translate
+
+[![Quality Gate Status](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=alert_status&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Coverage](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=coverage&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Duplicated Lines (%)](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=duplicated_lines_density&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Lines of Code](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=ncloc&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Security Hotspots](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=security_hotspots&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Maintainability Rating](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=software_quality_maintainability_rating&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Reliability Rating](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=software_quality_reliability_rating&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+[![Security Rating](https://sn.e-cosplay.fr/api/project_badges/measure?project=e-translate-sdk-js&metric=software_quality_security_rating&token=sqb_af5f3b3f8adae526165e73f0ed40f1fc9525e9b1)](https://sn.e-cosplay.fr/dashboard?id=e-translate-sdk-js)
+
+Client **TypeScript / JavaScript** pour l'API [e-translate](https://translation.e-cosplay.fr)
+(traduction via une API authentifiée par clé, avec mise en cache).
+
+- ✅ Fonctionne dans **Node.js ≥ 18** (fetch natif) et dans le **navigateur**
+- ✅ **TypeScript** (types fournis) — sorties **ESM + CJS**
+- ✅ Zéro dépendance runtime
+- ✅ Disponible sur **npm** (`@ecosplay/e-translate`) et installable **par git**
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @ecosplay/e-translate
+```
+
+Avec pnpm ou yarn :
+
+```bash
+pnpm add @ecosplay/e-translate
+yarn add @ecosplay/e-translate
+```
+
+**Épingler une version** (conseillé en production) :
+
+```bash
+npm install @ecosplay/e-translate@1.0.0
+```
+
+> Publié automatiquement sur npm par la CI à chaque tag `vX.Y.Z` (voir
+> `.gitea/workflows/publish.yml`).
+
+---
+
+## 🚀 Utilisation
+
+### ESM / TypeScript
+
+```ts
+import { ETranslateClient } from "@ecosplay/e-translate";
+
+const client = new ETranslateClient({
+  baseUrl: "https://translation.e-cosplay.fr",
+  apiKey: "etk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+});
+
+const res = await client.translate({ message: "Bonjour le monde", from: "fr", to: "en" });
+console.log(res.translatedText); // "Hello world"
+console.log(res.cached);         // false puis true au 2e appel identique
+```
+
+### CommonJS
+
+```js
+const { ETranslateClient } = require("@ecosplay/e-translate");
+
+const client = new ETranslateClient({
+  baseUrl: "https://translation.e-cosplay.fr",
+  apiKey: process.env.ETRANSLATE_KEY,
+});
+
+client.translate({ message: "Hello", from: "en", to: "fr" }).then((r) => console.log(r.translatedText));
+```
+
+### Détection automatique, tableaux, HTML
+
+```ts
+// from: "auto" -> la langue source est détectée
+const r1 = await client.translate({ message: "Guten Tag", from: "auto", to: "fr" });
+console.log(r1.detectedLanguage); // { confidence: 90, language: "de" }
+
+// Traduire plusieurs textes d'un coup
+const r2 = await client.translate({ message: ["Cat", "Dog"], from: "en", to: "fr" });
+console.log(r2.translatedText); // ["Chat", "Chien"]
+
+// Conserver le balisage HTML
+await client.translate({ message: "<b>Bonjour</b>", from: "fr", to: "en", format: "html" });
+```
+
+---
+
+## 📚 API
+
+### `new ETranslateClient(options)` / `createClient(options)`
+
+| Option      | Type                     | Défaut             | Description                                  |
+| ----------- | ------------------------ | ------------------ | -------------------------------------------- |
+| `baseUrl`   | `string`                 | —                  | URL du serveur (requis)                      |
+| `apiKey`    | `string`                 | —                  | Clé `etk_…` (requise sauf pour `health()`)   |
+| `timeoutMs` | `number`                 | `20000`            | Timeout par requête                          |
+| `fetch`     | `typeof fetch`           | `globalThis.fetch` | Implémentation fetch (Node < 18, tests)      |
+| `headers`   | `Record<string,string>`  | `{}`               | En-têtes additionnels                        |
+
+### Méthodes
+
+| Méthode                       | Endpoint            | Retour                      |
+| ----------------------------- | ------------------- | --------------------------- |
+| `translate(params)`           | `POST /translate`   | `Promise<TranslateResult>`  |
+| `detect(text)`                | `POST /detect`      | `Promise<DetectedLanguage[]>` |
+| `languages()`                 | `GET /languages`    | `Promise<Language[]>`       |
+| `health()`                    | `GET /health`       | `Promise<HealthResult>`     |
+
+`translate(params)` — `params` : `{ message: string | string[]; from: string; to: string; format?: "text" | "html" }`.
+(`from` accepte `"auto"`. Les alias serveur `source`/`target`/`q` sont gérés côté serveur.)
+
+### Gestion des erreurs
+
+Toute réponse non-2xx (ou un échec réseau) lève une **`ETranslateError`** :
+
+```ts
+import { ETranslateError } from "@ecosplay/e-translate";
+
+try {
+  await client.translate({ message: "x", from: "fr", to: "en" });
+} catch (e) {
+  if (e instanceof ETranslateError) {
+    console.error(e.status); // 401 (clé invalide), 429 (rate limit), 502 (upstream), 0 (réseau/timeout)
+    console.error(e.message);
+    console.error(e.body);   // corps JSON renvoyé par le serveur, si présent
+  }
+}
+```
+
+---
+
+## 🛠️ Build depuis les sources
+
+```bash
+git clone ssh://git@code.e-cosplay.fr:222/shoko/e-translate-sdk-js.git
+cd e-translate-sdk-js
+npm install        # exécute aussi le build via "prepare"
+npm run build      # -> dist/index.js (ESM), dist/index.cjs (CJS), dist/index.d.ts
+npm run typecheck  # vérification de types sans émettre
+```
+
+## Licence
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,134 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ETranslateClient: () => ETranslateClient,
+  ETranslateError: () => ETranslateError,
+  createClient: () => createClient,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var ETranslateError = class _ETranslateError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "ETranslateError";
+    this.status = status;
+    this.body = body;
+    Object.setPrototypeOf(this, _ETranslateError.prototype);
+  }
+};
+var ETranslateClient = class {
+  constructor(options) {
+    if (!options || typeof options.baseUrl !== "string" || options.baseUrl.length === 0) {
+      throw new Error("ETranslate: l'option 'baseUrl' est requise.");
+    }
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.apiKey = options.apiKey ?? "";
+    this.timeoutMs = options.timeoutMs ?? 2e4;
+    this.extraHeaders = options.headers ?? {};
+    const f = options.fetch ?? globalThis.fetch;
+    if (typeof f !== "function") {
+      throw new Error(
+        "ETranslate: aucune impl\xE9mentation `fetch` disponible. Utilisez Node >= 18 ou passez `options.fetch`."
+      );
+    }
+    this.fetchImpl = f;
+  }
+  /**
+   * Traduit un texte (ou un tableau de textes).
+   * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.
+   */
+  async translate(params) {
+    if (!params || params.message == null) {
+      throw new Error("translate: 'message' est requis.");
+    }
+    if (!params.from) throw new Error("translate: 'from' est requis (ex. 'fr' ou 'auto').");
+    if (!params.to) throw new Error("translate: 'to' est requis (ex. 'en').");
+    return this.request("POST", "/translate", {
+      lang_src: params.from,
+      lang_dest: params.to,
+      message: params.message,
+      format: params.format ?? "text"
+    });
+  }
+  /** Détecte la langue d'un texte via `POST /detect`. */
+  async detect(text) {
+    if (!text) throw new Error("detect: 'text' est requis.");
+    return this.request("POST", "/detect", { q: text });
+  }
+  /** Liste les langues supportées via `GET /languages`. */
+  async languages() {
+    return this.request("GET", "/languages");
+  }
+  /** État du service via `GET /health` (ne nécessite pas de clé API). */
+  async health() {
+    return this.request("GET", "/health", void 0, { auth: false });
+  }
+  async request(method, path, body, opts) {
+    const useAuth = opts?.auth !== false;
+    const url = `${this.baseUrl}${path}`;
+    const headers = { Accept: "application/json", ...this.extraHeaders };
+    if (useAuth) headers["X-API-Key"] = this.apiKey;
+    if (body !== void 0) headers["Content-Type"] = "application/json";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let resp;
+    try {
+      resp = await this.fetchImpl(url, {
+        method,
+        headers,
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+    } catch (err) {
+      const e = err;
+      const msg = e?.name === "AbortError" ? `Requ\xEAte expir\xE9e apr\xE8s ${this.timeoutMs} ms (${path}).` : `\xC9chec r\xE9seau vers ${url}: ${e?.message ?? String(err)}`;
+      throw new ETranslateError(msg, 0);
+    } finally {
+      clearTimeout(timer);
+    }
+    const raw = await resp.text();
+    let data = void 0;
+    if (raw) {
+      try {
+        data = JSON.parse(raw);
+      } catch {
+        data = raw;
+      }
+    }
+    if (!resp.ok) {
+      const message = data && typeof data === "object" && "error" in data ? String(data.error) : `HTTP ${resp.status} sur ${path}`;
+      throw new ETranslateError(message, resp.status, data);
+    }
+    return data;
+  }
+};
+function createClient(options) {
+  return new ETranslateClient(options);
+}
+var index_default = ETranslateClient;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ETranslateClient,
+  ETranslateError,
+  createClient
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * e-translate SDK — client TypeScript/JavaScript pour l'API e-translate.\n *\n * Fonctionne dans Node 18+ (fetch global) et dans le navigateur.\n *\n * @example\n * ```ts\n * import { ETranslateClient } from \"e-translate-sdk\";\n *\n * const client = new ETranslateClient({\n *   baseUrl: \"https://translation.e-cosplay.fr\",\n *   apiKey: \"etk_xxxxxxxx\",\n * });\n *\n * const res = await client.translate({ message: \"Bonjour\", from: \"fr\", to: \"en\" });\n * console.log(res.translatedText); // \"Hello\"\n * ```\n */\n\n/** Format du texte à traduire. */\nexport type TranslateFormat = \"text\" | \"html\";\n\n/** Méthode HTTP interne. */\ntype HttpMethod = \"GET\" | \"POST\";\n\n/** Options de construction du client. */\nexport interface ETranslateOptions {\n  /** URL de base du serveur, ex. \"https://translation.e-cosplay.fr\". */\n  baseUrl: string;\n  /** Clé d'API (`etk_...`). Requise pour /translate, /detect, /languages. */\n  apiKey: string;\n  /** Timeout par requête en millisecondes (défaut : 20000). */\n  timeoutMs?: number;\n  /** Implémentation `fetch` personnalisée (Node < 18, tests). Défaut : `globalThis.fetch`. */\n  fetch?: typeof fetch;\n  /** En-têtes HTTP supplémentaires envoyés à chaque requête. */\n  headers?: Record<string, string>;\n}\n\n/** Paramètres de traduction. */\nexport interface TranslateParams {\n  /** Texte (ou tableau de textes) à traduire. */\n  message: string | string[];\n  /** Langue source (code ISO, ex. \"fr\") ou \"auto\" pour la détection automatique. */\n  from: string;\n  /** Langue cible (code ISO, ex. \"en\"). */\n  to: string;\n  /** Format du texte (défaut : \"text\"). */\n  format?: TranslateFormat;\n}\n\n/** Langue détectée renvoyée par /detect ou en mode \"auto\". */\nexport interface DetectedLanguage {\n  /** Indice de confiance (0–100). */\n  confidence: number;\n  /** Code ISO de la langue détectée. */\n  language: string;\n}\n\n/** Résultat d'une traduction. */\nexport interface TranslateResult {\n  /** Texte traduit (string si `message` était une string, sinon string[]). */\n  translatedText: string | string[];\n  /** `true` si la réponse provient du cache Redis. */\n  cached: boolean;\n  /** Présent uniquement si `from` valait \"auto\". */\n  detectedLanguage?: DetectedLanguage;\n}\n\n/** Une langue supportée par le serveur. */\nexport interface Language {\n  code: string;\n  name: string;\n  targets?: string[];\n}\n\n/** Réponse de /health (aucune clé requise). */\nexport interface HealthResult {\n  status: string;\n  redis: boolean;\n  /** Disponibilité du moteur de traduction en amont. */\n  engine: boolean;\n  time: string;\n}\n\n/**\n * Erreur levée pour toute réponse non-2xx ou tout échec réseau.\n * `status` vaut 0 en cas d'échec réseau / timeout.\n */\nexport class ETranslateError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body?: unknown) {\n    super(message);\n    this.name = \"ETranslateError\";\n    this.status = status;\n    this.body = body;\n    // Restaure la chaîne de prototype (TS ciblant ES5/ES2015).\n    Object.setPrototypeOf(this, ETranslateError.prototype);\n  }\n}\n\n/** Client de l'API e-translate. */\nexport class ETranslateClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n  private readonly extraHeaders: Record<string, string>;\n\n  constructor(options: ETranslateOptions) {\n    if (!options || typeof options.baseUrl !== \"string\" || options.baseUrl.length === 0) {\n      throw new Error(\"ETranslate: l'option 'baseUrl' est requise.\");\n    }\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.apiKey = options.apiKey ?? \"\";\n    this.timeoutMs = options.timeoutMs ?? 20000;\n    this.extraHeaders = options.headers ?? {};\n\n    const f = options.fetch ?? (globalThis as { fetch?: typeof fetch }).fetch;\n    if (typeof f !== \"function\") {\n      throw new Error(\n        \"ETranslate: aucune implémentation `fetch` disponible. \" +\n          \"Utilisez Node >= 18 ou passez `options.fetch`.\",\n      );\n    }\n    this.fetchImpl = f;\n  }\n\n  /**\n   * Traduit un texte (ou un tableau de textes).\n   * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.\n   */\n  async translate(params: TranslateParams): Promise<TranslateResult> {\n    if (!params || params.message == null) {\n      throw new Error(\"translate: 'message' est requis.\");\n    }\n    if (!params.from) throw new Error(\"translate: 'from' est requis (ex. 'fr' ou 'auto').\");\n    if (!params.to) throw new Error(\"translate: 'to' est requis (ex. 'en').\");\n\n    return this.request<TranslateResult>(\"POST\", \"/translate\", {\n      lang_src: params.from,\n      lang_dest: params.to,\n      message: params.message,\n      format: params.format ?? \"text\",\n    });\n  }\n\n  /** Détecte la langue d'un texte via `POST /detect`. */\n  async detect(text: string): Promise<DetectedLanguage[]> {\n    if (!text) throw new Error(\"detect: 'text' est requis.\");\n    return this.request<DetectedLanguage[]>(\"POST\", \"/detect\", { q: text });\n  }\n\n  /** Liste les langues supportées via `GET /languages`. */\n  async languages(): Promise<Language[]> {\n    return this.request<Language[]>(\"GET\", \"/languages\");\n  }\n\n  /** État du service via `GET /health` (ne nécessite pas de clé API). */\n  async health(): Promise<HealthResult> {\n    return this.request<HealthResult>(\"GET\", \"/health\", undefined, { auth: false });\n  }\n\n  private async request<T>(\n    method: HttpMethod,\n    path: string,\n    body?: Record<string, unknown>,\n    opts?: { auth?: boolean },\n  ): Promise<T> {\n    const useAuth = opts?.auth !== false;\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = { Accept: \"application/json\", ...this.extraHeaders };\n    if (useAuth) headers[\"X-API-Key\"] = this.apiKey;\n    if (body !== undefined) headers[\"Content-Type\"] = \"application/json\";\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    let resp: Response;\n    try {\n      resp = await this.fetchImpl(url, {\n        method,\n        headers,\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n    } catch (err) {\n      const e = err as { name?: string; message?: string };\n      const msg =\n        e?.name === \"AbortError\"\n          ? `Requête expirée après ${this.timeoutMs} ms (${path}).`\n          : `Échec réseau vers ${url}: ${e?.message ?? String(err)}`;\n      throw new ETranslateError(msg, 0);\n    } finally {\n      clearTimeout(timer);\n    }\n\n    const raw = await resp.text();\n    let data: unknown = undefined;\n    if (raw) {\n      try {\n        data = JSON.parse(raw);\n      } catch {\n        data = raw;\n      }\n    }\n\n    if (!resp.ok) {\n      const message =\n        data && typeof data === \"object\" && \"error\" in data\n          ? String((data as { error: unknown }).error)\n          : `HTTP ${resp.status} sur ${path}`;\n      throw new ETranslateError(message, resp.status, data);\n    }\n\n    return data as T;\n  }\n}\n\n/** Fabrique pratique équivalente à `new ETranslateClient(options)`. */\nexport function createClient(options: ETranslateOptions): ETranslateClient {\n  return new ETranslateClient(options);\n}\n\nexport default ETranslateClient;\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,108 @@
+/**
+ * e-translate SDK — client TypeScript/JavaScript pour l'API e-translate.
+ *
+ * Fonctionne dans Node 18+ (fetch global) et dans le navigateur.
+ *
+ * @example
+ * ```ts
+ * import { ETranslateClient } from "e-translate-sdk";
+ *
+ * const client = new ETranslateClient({
+ *   baseUrl: "https://translation.e-cosplay.fr",
+ *   apiKey: "etk_xxxxxxxx",
+ * });
+ *
+ * const res = await client.translate({ message: "Bonjour", from: "fr", to: "en" });
+ * console.log(res.translatedText); // "Hello"
+ * ```
+ */
+/** Format du texte à traduire. */
+type TranslateFormat = "text" | "html";
+/** Options de construction du client. */
+interface ETranslateOptions {
+    /** URL de base du serveur, ex. "https://translation.e-cosplay.fr". */
+    baseUrl: string;
+    /** Clé d'API (`etk_...`). Requise pour /translate, /detect, /languages. */
+    apiKey: string;
+    /** Timeout par requête en millisecondes (défaut : 20000). */
+    timeoutMs?: number;
+    /** Implémentation `fetch` personnalisée (Node < 18, tests). Défaut : `globalThis.fetch`. */
+    fetch?: typeof fetch;
+    /** En-têtes HTTP supplémentaires envoyés à chaque requête. */
+    headers?: Record<string, string>;
+}
+/** Paramètres de traduction. */
+interface TranslateParams {
+    /** Texte (ou tableau de textes) à traduire. */
+    message: string | string[];
+    /** Langue source (code ISO, ex. "fr") ou "auto" pour la détection automatique. */
+    from: string;
+    /** Langue cible (code ISO, ex. "en"). */
+    to: string;
+    /** Format du texte (défaut : "text"). */
+    format?: TranslateFormat;
+}
+/** Langue détectée renvoyée par /detect ou en mode "auto". */
+interface DetectedLanguage {
+    /** Indice de confiance (0–100). */
+    confidence: number;
+    /** Code ISO de la langue détectée. */
+    language: string;
+}
+/** Résultat d'une traduction. */
+interface TranslateResult {
+    /** Texte traduit (string si `message` était une string, sinon string[]). */
+    translatedText: string | string[];
+    /** `true` si la réponse provient du cache Redis. */
+    cached: boolean;
+    /** Présent uniquement si `from` valait "auto". */
+    detectedLanguage?: DetectedLanguage;
+}
+/** Une langue supportée par le serveur. */
+interface Language {
+    code: string;
+    name: string;
+    targets?: string[];
+}
+/** Réponse de /health (aucune clé requise). */
+interface HealthResult {
+    status: string;
+    redis: boolean;
+    /** Disponibilité du moteur de traduction en amont. */
+    engine: boolean;
+    time: string;
+}
+/**
+ * Erreur levée pour toute réponse non-2xx ou tout échec réseau.
+ * `status` vaut 0 en cas d'échec réseau / timeout.
+ */
+declare class ETranslateError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+/** Client de l'API e-translate. */
+declare class ETranslateClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    private readonly extraHeaders;
+    constructor(options: ETranslateOptions);
+    /**
+     * Traduit un texte (ou un tableau de textes).
+     * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.
+     */
+    translate(params: TranslateParams): Promise<TranslateResult>;
+    /** Détecte la langue d'un texte via `POST /detect`. */
+    detect(text: string): Promise<DetectedLanguage[]>;
+    /** Liste les langues supportées via `GET /languages`. */
+    languages(): Promise<Language[]>;
+    /** État du service via `GET /health` (ne nécessite pas de clé API). */
+    health(): Promise<HealthResult>;
+    private request;
+}
+/** Fabrique pratique équivalente à `new ETranslateClient(options)`. */
+declare function createClient(options: ETranslateOptions): ETranslateClient;
+
+export { type DetectedLanguage, ETranslateClient, ETranslateError, type ETranslateOptions, type HealthResult, type Language, type TranslateFormat, type TranslateParams, type TranslateResult, createClient, ETranslateClient as default };

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * e-translate SDK — client TypeScript/JavaScript pour l'API e-translate.
+ *
+ * Fonctionne dans Node 18+ (fetch global) et dans le navigateur.
+ *
+ * @example
+ * ```ts
+ * import { ETranslateClient } from "e-translate-sdk";
+ *
+ * const client = new ETranslateClient({
+ *   baseUrl: "https://translation.e-cosplay.fr",
+ *   apiKey: "etk_xxxxxxxx",
+ * });
+ *
+ * const res = await client.translate({ message: "Bonjour", from: "fr", to: "en" });
+ * console.log(res.translatedText); // "Hello"
+ * ```
+ */
+/** Format du texte à traduire. */
+type TranslateFormat = "text" | "html";
+/** Options de construction du client. */
+interface ETranslateOptions {
+    /** URL de base du serveur, ex. "https://translation.e-cosplay.fr". */
+    baseUrl: string;
+    /** Clé d'API (`etk_...`). Requise pour /translate, /detect, /languages. */
+    apiKey: string;
+    /** Timeout par requête en millisecondes (défaut : 20000). */
+    timeoutMs?: number;
+    /** Implémentation `fetch` personnalisée (Node < 18, tests). Défaut : `globalThis.fetch`. */
+    fetch?: typeof fetch;
+    /** En-têtes HTTP supplémentaires envoyés à chaque requête. */
+    headers?: Record<string, string>;
+}
+/** Paramètres de traduction. */
+interface TranslateParams {
+    /** Texte (ou tableau de textes) à traduire. */
+    message: string | string[];
+    /** Langue source (code ISO, ex. "fr") ou "auto" pour la détection automatique. */
+    from: string;
+    /** Langue cible (code ISO, ex. "en"). */
+    to: string;
+    /** Format du texte (défaut : "text"). */
+    format?: TranslateFormat;
+}
+/** Langue détectée renvoyée par /detect ou en mode "auto". */
+interface DetectedLanguage {
+    /** Indice de confiance (0–100). */
+    confidence: number;
+    /** Code ISO de la langue détectée. */
+    language: string;
+}
+/** Résultat d'une traduction. */
+interface TranslateResult {
+    /** Texte traduit (string si `message` était une string, sinon string[]). */
+    translatedText: string | string[];
+    /** `true` si la réponse provient du cache Redis. */
+    cached: boolean;
+    /** Présent uniquement si `from` valait "auto". */
+    detectedLanguage?: DetectedLanguage;
+}
+/** Une langue supportée par le serveur. */
+interface Language {
+    code: string;
+    name: string;
+    targets?: string[];
+}
+/** Réponse de /health (aucune clé requise). */
+interface HealthResult {
+    status: string;
+    redis: boolean;
+    /** Disponibilité du moteur de traduction en amont. */
+    engine: boolean;
+    time: string;
+}
+/**
+ * Erreur levée pour toute réponse non-2xx ou tout échec réseau.
+ * `status` vaut 0 en cas d'échec réseau / timeout.
+ */
+declare class ETranslateError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+/** Client de l'API e-translate. */
+declare class ETranslateClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    private readonly extraHeaders;
+    constructor(options: ETranslateOptions);
+    /**
+     * Traduit un texte (ou un tableau de textes).
+     * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.
+     */
+    translate(params: TranslateParams): Promise<TranslateResult>;
+    /** Détecte la langue d'un texte via `POST /detect`. */
+    detect(text: string): Promise<DetectedLanguage[]>;
+    /** Liste les langues supportées via `GET /languages`. */
+    languages(): Promise<Language[]>;
+    /** État du service via `GET /health` (ne nécessite pas de clé API). */
+    health(): Promise<HealthResult>;
+    private request;
+}
+/** Fabrique pratique équivalente à `new ETranslateClient(options)`. */
+declare function createClient(options: ETranslateOptions): ETranslateClient;
+
+export { type DetectedLanguage, ETranslateClient, ETranslateError, type ETranslateOptions, type HealthResult, type Language, type TranslateFormat, type TranslateParams, type TranslateResult, createClient, ETranslateClient as default };

package/dist/index.js

@@ -0,0 +1,107 @@
+// src/index.ts
+var ETranslateError = class _ETranslateError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "ETranslateError";
+    this.status = status;
+    this.body = body;
+    Object.setPrototypeOf(this, _ETranslateError.prototype);
+  }
+};
+var ETranslateClient = class {
+  constructor(options) {
+    if (!options || typeof options.baseUrl !== "string" || options.baseUrl.length === 0) {
+      throw new Error("ETranslate: l'option 'baseUrl' est requise.");
+    }
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.apiKey = options.apiKey ?? "";
+    this.timeoutMs = options.timeoutMs ?? 2e4;
+    this.extraHeaders = options.headers ?? {};
+    const f = options.fetch ?? globalThis.fetch;
+    if (typeof f !== "function") {
+      throw new Error(
+        "ETranslate: aucune impl\xE9mentation `fetch` disponible. Utilisez Node >= 18 ou passez `options.fetch`."
+      );
+    }
+    this.fetchImpl = f;
+  }
+  /**
+   * Traduit un texte (ou un tableau de textes).
+   * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.
+   */
+  async translate(params) {
+    if (!params || params.message == null) {
+      throw new Error("translate: 'message' est requis.");
+    }
+    if (!params.from) throw new Error("translate: 'from' est requis (ex. 'fr' ou 'auto').");
+    if (!params.to) throw new Error("translate: 'to' est requis (ex. 'en').");
+    return this.request("POST", "/translate", {
+      lang_src: params.from,
+      lang_dest: params.to,
+      message: params.message,
+      format: params.format ?? "text"
+    });
+  }
+  /** Détecte la langue d'un texte via `POST /detect`. */
+  async detect(text) {
+    if (!text) throw new Error("detect: 'text' est requis.");
+    return this.request("POST", "/detect", { q: text });
+  }
+  /** Liste les langues supportées via `GET /languages`. */
+  async languages() {
+    return this.request("GET", "/languages");
+  }
+  /** État du service via `GET /health` (ne nécessite pas de clé API). */
+  async health() {
+    return this.request("GET", "/health", void 0, { auth: false });
+  }
+  async request(method, path, body, opts) {
+    const useAuth = opts?.auth !== false;
+    const url = `${this.baseUrl}${path}`;
+    const headers = { Accept: "application/json", ...this.extraHeaders };
+    if (useAuth) headers["X-API-Key"] = this.apiKey;
+    if (body !== void 0) headers["Content-Type"] = "application/json";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let resp;
+    try {
+      resp = await this.fetchImpl(url, {
+        method,
+        headers,
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+    } catch (err) {
+      const e = err;
+      const msg = e?.name === "AbortError" ? `Requ\xEAte expir\xE9e apr\xE8s ${this.timeoutMs} ms (${path}).` : `\xC9chec r\xE9seau vers ${url}: ${e?.message ?? String(err)}`;
+      throw new ETranslateError(msg, 0);
+    } finally {
+      clearTimeout(timer);
+    }
+    const raw = await resp.text();
+    let data = void 0;
+    if (raw) {
+      try {
+        data = JSON.parse(raw);
+      } catch {
+        data = raw;
+      }
+    }
+    if (!resp.ok) {
+      const message = data && typeof data === "object" && "error" in data ? String(data.error) : `HTTP ${resp.status} sur ${path}`;
+      throw new ETranslateError(message, resp.status, data);
+    }
+    return data;
+  }
+};
+function createClient(options) {
+  return new ETranslateClient(options);
+}
+var index_default = ETranslateClient;
+export {
+  ETranslateClient,
+  ETranslateError,
+  createClient,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * e-translate SDK — client TypeScript/JavaScript pour l'API e-translate.\n *\n * Fonctionne dans Node 18+ (fetch global) et dans le navigateur.\n *\n * @example\n * ```ts\n * import { ETranslateClient } from \"e-translate-sdk\";\n *\n * const client = new ETranslateClient({\n *   baseUrl: \"https://translation.e-cosplay.fr\",\n *   apiKey: \"etk_xxxxxxxx\",\n * });\n *\n * const res = await client.translate({ message: \"Bonjour\", from: \"fr\", to: \"en\" });\n * console.log(res.translatedText); // \"Hello\"\n * ```\n */\n\n/** Format du texte à traduire. */\nexport type TranslateFormat = \"text\" | \"html\";\n\n/** Méthode HTTP interne. */\ntype HttpMethod = \"GET\" | \"POST\";\n\n/** Options de construction du client. */\nexport interface ETranslateOptions {\n  /** URL de base du serveur, ex. \"https://translation.e-cosplay.fr\". */\n  baseUrl: string;\n  /** Clé d'API (`etk_...`). Requise pour /translate, /detect, /languages. */\n  apiKey: string;\n  /** Timeout par requête en millisecondes (défaut : 20000). */\n  timeoutMs?: number;\n  /** Implémentation `fetch` personnalisée (Node < 18, tests). Défaut : `globalThis.fetch`. */\n  fetch?: typeof fetch;\n  /** En-têtes HTTP supplémentaires envoyés à chaque requête. */\n  headers?: Record<string, string>;\n}\n\n/** Paramètres de traduction. */\nexport interface TranslateParams {\n  /** Texte (ou tableau de textes) à traduire. */\n  message: string | string[];\n  /** Langue source (code ISO, ex. \"fr\") ou \"auto\" pour la détection automatique. */\n  from: string;\n  /** Langue cible (code ISO, ex. \"en\"). */\n  to: string;\n  /** Format du texte (défaut : \"text\"). */\n  format?: TranslateFormat;\n}\n\n/** Langue détectée renvoyée par /detect ou en mode \"auto\". */\nexport interface DetectedLanguage {\n  /** Indice de confiance (0–100). */\n  confidence: number;\n  /** Code ISO de la langue détectée. */\n  language: string;\n}\n\n/** Résultat d'une traduction. */\nexport interface TranslateResult {\n  /** Texte traduit (string si `message` était une string, sinon string[]). */\n  translatedText: string | string[];\n  /** `true` si la réponse provient du cache Redis. */\n  cached: boolean;\n  /** Présent uniquement si `from` valait \"auto\". */\n  detectedLanguage?: DetectedLanguage;\n}\n\n/** Une langue supportée par le serveur. */\nexport interface Language {\n  code: string;\n  name: string;\n  targets?: string[];\n}\n\n/** Réponse de /health (aucune clé requise). */\nexport interface HealthResult {\n  status: string;\n  redis: boolean;\n  /** Disponibilité du moteur de traduction en amont. */\n  engine: boolean;\n  time: string;\n}\n\n/**\n * Erreur levée pour toute réponse non-2xx ou tout échec réseau.\n * `status` vaut 0 en cas d'échec réseau / timeout.\n */\nexport class ETranslateError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body?: unknown) {\n    super(message);\n    this.name = \"ETranslateError\";\n    this.status = status;\n    this.body = body;\n    // Restaure la chaîne de prototype (TS ciblant ES5/ES2015).\n    Object.setPrototypeOf(this, ETranslateError.prototype);\n  }\n}\n\n/** Client de l'API e-translate. */\nexport class ETranslateClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n  private readonly extraHeaders: Record<string, string>;\n\n  constructor(options: ETranslateOptions) {\n    if (!options || typeof options.baseUrl !== \"string\" || options.baseUrl.length === 0) {\n      throw new Error(\"ETranslate: l'option 'baseUrl' est requise.\");\n    }\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.apiKey = options.apiKey ?? \"\";\n    this.timeoutMs = options.timeoutMs ?? 20000;\n    this.extraHeaders = options.headers ?? {};\n\n    const f = options.fetch ?? (globalThis as { fetch?: typeof fetch }).fetch;\n    if (typeof f !== \"function\") {\n      throw new Error(\n        \"ETranslate: aucune implémentation `fetch` disponible. \" +\n          \"Utilisez Node >= 18 ou passez `options.fetch`.\",\n      );\n    }\n    this.fetchImpl = f;\n  }\n\n  /**\n   * Traduit un texte (ou un tableau de textes).\n   * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.\n   */\n  async translate(params: TranslateParams): Promise<TranslateResult> {\n    if (!params || params.message == null) {\n      throw new Error(\"translate: 'message' est requis.\");\n    }\n    if (!params.from) throw new Error(\"translate: 'from' est requis (ex. 'fr' ou 'auto').\");\n    if (!params.to) throw new Error(\"translate: 'to' est requis (ex. 'en').\");\n\n    return this.request<TranslateResult>(\"POST\", \"/translate\", {\n      lang_src: params.from,\n      lang_dest: params.to,\n      message: params.message,\n      format: params.format ?? \"text\",\n    });\n  }\n\n  /** Détecte la langue d'un texte via `POST /detect`. */\n  async detect(text: string): Promise<DetectedLanguage[]> {\n    if (!text) throw new Error(\"detect: 'text' est requis.\");\n    return this.request<DetectedLanguage[]>(\"POST\", \"/detect\", { q: text });\n  }\n\n  /** Liste les langues supportées via `GET /languages`. */\n  async languages(): Promise<Language[]> {\n    return this.request<Language[]>(\"GET\", \"/languages\");\n  }\n\n  /** État du service via `GET /health` (ne nécessite pas de clé API). */\n  async health(): Promise<HealthResult> {\n    return this.request<HealthResult>(\"GET\", \"/health\", undefined, { auth: false });\n  }\n\n  private async request<T>(\n    method: HttpMethod,\n    path: string,\n    body?: Record<string, unknown>,\n    opts?: { auth?: boolean },\n  ): Promise<T> {\n    const useAuth = opts?.auth !== false;\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = { Accept: \"application/json\", ...this.extraHeaders };\n    if (useAuth) headers[\"X-API-Key\"] = this.apiKey;\n    if (body !== undefined) headers[\"Content-Type\"] = \"application/json\";\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    let resp: Response;\n    try {\n      resp = await this.fetchImpl(url, {\n        method,\n        headers,\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n    } catch (err) {\n      const e = err as { name?: string; message?: string };\n      const msg =\n        e?.name === \"AbortError\"\n          ? `Requête expirée après ${this.timeoutMs} ms (${path}).`\n          : `Échec réseau vers ${url}: ${e?.message ?? String(err)}`;\n      throw new ETranslateError(msg, 0);\n    } finally {\n      clearTimeout(timer);\n    }\n\n    const raw = await resp.text();\n    let data: unknown = undefined;\n    if (raw) {\n      try {\n        data = JSON.parse(raw);\n      } catch {\n        data = raw;\n      }\n    }\n\n    if (!resp.ok) {\n      const message =\n        data && typeof data === \"object\" && \"error\" in data\n          ? String((data as { error: unknown }).error)\n          : `HTTP ${resp.status} sur ${path}`;\n      throw new ETranslateError(message, resp.status, data);\n    }\n\n    return data as T;\n  }\n}\n\n/** Fabrique pratique équivalente à `new ETranslateClient(options)`. */\nexport function createClient(options: ETranslateOptions): ETranslateClient {\n  return new ETranslateClient(options);\n}\n\nexport default ETranslateClient;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@ecosplay/e-translate",
+  "version": "1.0.0",
+  "description": "Client SDK (TypeScript) pour l'API e-translate (translation.e-cosplay.fr).",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepare": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "translate",
+    "translation",
+    "libretranslate",
+    "e-translate",
+    "sdk",
+    "i18n"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@code.e-cosplay.fr:222/shoko/e-translate-sdk-js.git"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,228 @@
+/**
+ * e-translate SDK — client TypeScript/JavaScript pour l'API e-translate.
+ *
+ * Fonctionne dans Node 18+ (fetch global) et dans le navigateur.
+ *
+ * @example
+ * ```ts
+ * import { ETranslateClient } from "e-translate-sdk";
+ *
+ * const client = new ETranslateClient({
+ *   baseUrl: "https://translation.e-cosplay.fr",
+ *   apiKey: "etk_xxxxxxxx",
+ * });
+ *
+ * const res = await client.translate({ message: "Bonjour", from: "fr", to: "en" });
+ * console.log(res.translatedText); // "Hello"
+ * ```
+ */
+
+/** Format du texte à traduire. */
+export type TranslateFormat = "text" | "html";
+
+/** Méthode HTTP interne. */
+type HttpMethod = "GET" | "POST";
+
+/** Options de construction du client. */
+export interface ETranslateOptions {
+  /** URL de base du serveur, ex. "https://translation.e-cosplay.fr". */
+  baseUrl: string;
+  /** Clé d'API (`etk_...`). Requise pour /translate, /detect, /languages. */
+  apiKey: string;
+  /** Timeout par requête en millisecondes (défaut : 20000). */
+  timeoutMs?: number;
+  /** Implémentation `fetch` personnalisée (Node < 18, tests). Défaut : `globalThis.fetch`. */
+  fetch?: typeof fetch;
+  /** En-têtes HTTP supplémentaires envoyés à chaque requête. */
+  headers?: Record<string, string>;
+}
+
+/** Paramètres de traduction. */
+export interface TranslateParams {
+  /** Texte (ou tableau de textes) à traduire. */
+  message: string | string[];
+  /** Langue source (code ISO, ex. "fr") ou "auto" pour la détection automatique. */
+  from: string;
+  /** Langue cible (code ISO, ex. "en"). */
+  to: string;
+  /** Format du texte (défaut : "text"). */
+  format?: TranslateFormat;
+}
+
+/** Langue détectée renvoyée par /detect ou en mode "auto". */
+export interface DetectedLanguage {
+  /** Indice de confiance (0–100). */
+  confidence: number;
+  /** Code ISO de la langue détectée. */
+  language: string;
+}
+
+/** Résultat d'une traduction. */
+export interface TranslateResult {
+  /** Texte traduit (string si `message` était une string, sinon string[]). */
+  translatedText: string | string[];
+  /** `true` si la réponse provient du cache Redis. */
+  cached: boolean;
+  /** Présent uniquement si `from` valait "auto". */
+  detectedLanguage?: DetectedLanguage;
+}
+
+/** Une langue supportée par le serveur. */
+export interface Language {
+  code: string;
+  name: string;
+  targets?: string[];
+}
+
+/** Réponse de /health (aucune clé requise). */
+export interface HealthResult {
+  status: string;
+  redis: boolean;
+  /** Disponibilité du moteur de traduction en amont. */
+  engine: boolean;
+  time: string;
+}
+
+/**
+ * Erreur levée pour toute réponse non-2xx ou tout échec réseau.
+ * `status` vaut 0 en cas d'échec réseau / timeout.
+ */
+export class ETranslateError extends Error {
+  readonly status: number;
+  readonly body: unknown;
+
+  constructor(message: string, status: number, body?: unknown) {
+    super(message);
+    this.name = "ETranslateError";
+    this.status = status;
+    this.body = body;
+    // Restaure la chaîne de prototype (TS ciblant ES5/ES2015).
+    Object.setPrototypeOf(this, ETranslateError.prototype);
+  }
+}
+
+/** Client de l'API e-translate. */
+export class ETranslateClient {
+  private readonly baseUrl: string;
+  private readonly apiKey: string;
+  private readonly timeoutMs: number;
+  private readonly fetchImpl: typeof fetch;
+  private readonly extraHeaders: Record<string, string>;
+
+  constructor(options: ETranslateOptions) {
+    if (!options || typeof options.baseUrl !== "string" || options.baseUrl.length === 0) {
+      throw new Error("ETranslate: l'option 'baseUrl' est requise.");
+    }
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.apiKey = options.apiKey ?? "";
+    this.timeoutMs = options.timeoutMs ?? 20000;
+    this.extraHeaders = options.headers ?? {};
+
+    const f = options.fetch ?? (globalThis as { fetch?: typeof fetch }).fetch;
+    if (typeof f !== "function") {
+      throw new Error(
+        "ETranslate: aucune implémentation `fetch` disponible. " +
+          "Utilisez Node >= 18 ou passez `options.fetch`.",
+      );
+    }
+    this.fetchImpl = f;
+  }
+
+  /**
+   * Traduit un texte (ou un tableau de textes).
+   * Envoie `lang_src` / `lang_dest` / `message` à `POST /translate`.
+   */
+  async translate(params: TranslateParams): Promise<TranslateResult> {
+    if (!params || params.message == null) {
+      throw new Error("translate: 'message' est requis.");
+    }
+    if (!params.from) throw new Error("translate: 'from' est requis (ex. 'fr' ou 'auto').");
+    if (!params.to) throw new Error("translate: 'to' est requis (ex. 'en').");
+
+    return this.request<TranslateResult>("POST", "/translate", {
+      lang_src: params.from,
+      lang_dest: params.to,
+      message: params.message,
+      format: params.format ?? "text",
+    });
+  }
+
+  /** Détecte la langue d'un texte via `POST /detect`. */
+  async detect(text: string): Promise<DetectedLanguage[]> {
+    if (!text) throw new Error("detect: 'text' est requis.");
+    return this.request<DetectedLanguage[]>("POST", "/detect", { q: text });
+  }
+
+  /** Liste les langues supportées via `GET /languages`. */
+  async languages(): Promise<Language[]> {
+    return this.request<Language[]>("GET", "/languages");
+  }
+
+  /** État du service via `GET /health` (ne nécessite pas de clé API). */
+  async health(): Promise<HealthResult> {
+    return this.request<HealthResult>("GET", "/health", undefined, { auth: false });
+  }
+
+  private async request<T>(
+    method: HttpMethod,
+    path: string,
+    body?: Record<string, unknown>,
+    opts?: { auth?: boolean },
+  ): Promise<T> {
+    const useAuth = opts?.auth !== false;
+    const url = `${this.baseUrl}${path}`;
+
+    const headers: Record<string, string> = { Accept: "application/json", ...this.extraHeaders };
+    if (useAuth) headers["X-API-Key"] = this.apiKey;
+    if (body !== undefined) headers["Content-Type"] = "application/json";
+
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+
+    let resp: Response;
+    try {
+      resp = await this.fetchImpl(url, {
+        method,
+        headers,
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      });
+    } catch (err) {
+      const e = err as { name?: string; message?: string };
+      const msg =
+        e?.name === "AbortError"
+          ? `Requête expirée après ${this.timeoutMs} ms (${path}).`
+          : `Échec réseau vers ${url}: ${e?.message ?? String(err)}`;
+      throw new ETranslateError(msg, 0);
+    } finally {
+      clearTimeout(timer);
+    }
+
+    const raw = await resp.text();
+    let data: unknown = undefined;
+    if (raw) {
+      try {
+        data = JSON.parse(raw);
+      } catch {
+        data = raw;
+      }
+    }
+
+    if (!resp.ok) {
+      const message =
+        data && typeof data === "object" && "error" in data
+          ? String((data as { error: unknown }).error)
+          : `HTTP ${resp.status} sur ${path}`;
+      throw new ETranslateError(message, resp.status, data);
+    }
+
+    return data as T;
+  }
+}
+
+/** Fabrique pratique équivalente à `new ETranslateClient(options)`. */
+export function createClient(options: ETranslateOptions): ETranslateClient {
+  return new ETranslateClient(options);
+}
+
+export default ETranslateClient;