@translatehub/vite-plugin 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,55 @@
+import { Plugin } from 'vite';
+
+/**
+ * vite-plugin-translatehub
+ *
+ * Что делает плагин:
+ * 1. При сборке генерирует TypeScript-типы (translations.d.ts) из ключей проекта —
+ *    автодополнение и type-safety в IDE без изменения runtime-поведения.
+ * 2. Опционально (downloadTranslations: true): скачивает переводы в public/locales/<lang>.json
+ *    как статический fallback для оффлайн-поддержки или ускорения первого рендера.
+ *
+ * ВАЖНО: Переводы в runtime всегда загружает @translatehub/core через Public API.
+ * Изменение перевода в TranslateHub появится в production-приложении через TTL кэша Redis
+ * (по умолчанию 5 минут) — БЕЗ пересборки и деплоя.
+ *
+ * Использование в vite.config.ts:
+ *   import { translateHub } from 'vite-plugin-translatehub';
+ *
+ *   export default defineConfig({
+ *     plugins: [
+ *       react(),
+ *       translateHub({
+ *         apiKey: process.env.TRANSLATEHUB_API_KEY!,
+ *         languages: ['ru', 'en', 'de'],
+ *         // downloadTranslations: true,  // опционально — для статической предзагрузки
+ *       }),
+ *     ],
+ *   });
+ */
+
+interface TranslateHubPluginOptions {
+    /** API-ключ проекта из TranslateHub */
+    apiKey: string;
+    /** Список языков для генерации типов */
+    languages: string[];
+    /**
+     * Генерировать TypeScript-типы ключей (default: true).
+     * Типы обновляются при каждом запуске dev-сервера / сборке.
+     */
+    generateTypes?: boolean;
+    /** Путь для файла с типами (default: 'src/types/translations.d.ts') */
+    typesOutputPath?: string;
+    /**
+     * Скачивать переводы в public/locales/<lang>.json (default: false).
+     * Используйте, если хотите статическую предзагрузку переводов.
+     * Внимание: при этом обновление переводов без rebuild возможно только
+     * для языков, которые SDK получает с API (не из статических файлов).
+     */
+    downloadTranslations?: boolean;
+    /** Папка для сохранения JSON-файлов (default: 'public/locales') */
+    outputDir?: string;
+}
+declare function translateHub(options: TranslateHubPluginOptions): Plugin;
+
+export { type TranslateHubPluginOptions, translateHub };

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { Plugin } from 'vite';
+
+/**
+ * vite-plugin-translatehub
+ *
+ * Что делает плагин:
+ * 1. При сборке генерирует TypeScript-типы (translations.d.ts) из ключей проекта —
+ *    автодополнение и type-safety в IDE без изменения runtime-поведения.
+ * 2. Опционально (downloadTranslations: true): скачивает переводы в public/locales/<lang>.json
+ *    как статический fallback для оффлайн-поддержки или ускорения первого рендера.
+ *
+ * ВАЖНО: Переводы в runtime всегда загружает @translatehub/core через Public API.
+ * Изменение перевода в TranslateHub появится в production-приложении через TTL кэша Redis
+ * (по умолчанию 5 минут) — БЕЗ пересборки и деплоя.
+ *
+ * Использование в vite.config.ts:
+ *   import { translateHub } from 'vite-plugin-translatehub';
+ *
+ *   export default defineConfig({
+ *     plugins: [
+ *       react(),
+ *       translateHub({
+ *         apiKey: process.env.TRANSLATEHUB_API_KEY!,
+ *         languages: ['ru', 'en', 'de'],
+ *         // downloadTranslations: true,  // опционально — для статической предзагрузки
+ *       }),
+ *     ],
+ *   });
+ */
+
+interface TranslateHubPluginOptions {
+    /** API-ключ проекта из TranslateHub */
+    apiKey: string;
+    /** Список языков для генерации типов */
+    languages: string[];
+    /**
+     * Генерировать TypeScript-типы ключей (default: true).
+     * Типы обновляются при каждом запуске dev-сервера / сборке.
+     */
+    generateTypes?: boolean;
+    /** Путь для файла с типами (default: 'src/types/translations.d.ts') */
+    typesOutputPath?: string;
+    /**
+     * Скачивать переводы в public/locales/<lang>.json (default: false).
+     * Используйте, если хотите статическую предзагрузку переводов.
+     * Внимание: при этом обновление переводов без rebuild возможно только
+     * для языков, которые SDK получает с API (не из статических файлов).
+     */
+    downloadTranslations?: boolean;
+    /** Папка для сохранения JSON-файлов (default: 'public/locales') */
+    outputDir?: string;
+}
+declare function translateHub(options: TranslateHubPluginOptions): Plugin;
+
+export { type TranslateHubPluginOptions, translateHub };

package/dist/index.js

@@ -0,0 +1,102 @@
+"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, {
+  translateHub: () => translateHub
+});
+module.exports = __toCommonJS(index_exports);
+var import_fs = require("fs");
+var import_path = require("path");
+var BASE_URL = "https://translate-hub.ru";
+function translateHub(options) {
+  const {
+    apiKey,
+    languages,
+    generateTypes = true,
+    typesOutputPath = "src/types/translations.d.ts",
+    downloadTranslations = false,
+    outputDir = "public/locales"
+  } = options;
+  return {
+    name: "vite-plugin-translatehub",
+    async buildStart() {
+      const cwd = process.cwd();
+      if (!generateTypes && !downloadTranslations) return;
+      console.log(`[translatehub] \u0417\u0430\u0433\u0440\u0443\u0436\u0430\u044E \u043A\u043B\u044E\u0447\u0438 \u0434\u043B\u044F \u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u0438 \u0442\u0438\u043F\u043E\u0432...`);
+      const results = await Promise.allSettled(
+        languages.map((lang) => fetchTranslations(BASE_URL, apiKey, lang))
+      );
+      const allKeys = /* @__PURE__ */ new Set();
+      for (let i = 0; i < languages.length; i++) {
+        const lang = languages[i];
+        const result = results[i];
+        if (result.status === "fulfilled") {
+          const translations = result.value;
+          Object.keys(translations).forEach((k) => allKeys.add(k));
+          if (downloadTranslations) {
+            const outDir = (0, import_path.resolve)(cwd, outputDir);
+            if (!(0, import_fs.existsSync)(outDir)) (0, import_fs.mkdirSync)(outDir, { recursive: true });
+            const filePath = (0, import_path.join)(outDir, `${lang}.json`);
+            (0, import_fs.writeFileSync)(filePath, JSON.stringify(translations, null, 2), "utf-8");
+            console.log(`[translatehub] \u0421\u043A\u0430\u0447\u0430\u043D ${lang}.json (${Object.keys(translations).length} \u043A\u043B\u044E\u0447\u0435\u0439)`);
+          }
+        } else {
+          console.warn(`[translatehub] \u041E\u0448\u0438\u0431\u043A\u0430 \u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0438 \u043A\u043B\u044E\u0447\u0435\u0439 \u0434\u043B\u044F "${lang}":`, result.reason?.message);
+        }
+      }
+      if (generateTypes && allKeys.size > 0) {
+        const typesPath = (0, import_path.resolve)(cwd, typesOutputPath);
+        const typesDir = typesPath.replace(/[/\\][^/\\]+$/, "");
+        if (!(0, import_fs.existsSync)(typesDir)) (0, import_fs.mkdirSync)(typesDir, { recursive: true });
+        const keyUnion = [...allKeys].sort().map((k) => `  | '${k}'`).join("\n");
+        const content = `// \u0410\u0432\u0442\u043E\u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u044F vite-plugin-translatehub \u2014 \u043D\u0435 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0432\u0440\u0443\u0447\u043D\u0443\u044E
+// \u041E\u0431\u043D\u043E\u0432\u043B\u044F\u0435\u0442\u0441\u044F \u043F\u0440\u0438 \u043A\u0430\u0436\u0434\u043E\u0439 \u0441\u0431\u043E\u0440\u043A\u0435 / \u0437\u0430\u043F\u0443\u0441\u043A\u0435 dev-\u0441\u0435\u0440\u0432\u0435\u0440\u0430
+// \u041F\u0435\u0440\u0435\u0432\u043E\u0434\u044B \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u044E\u0442\u0441\u044F \u0432 runtime \u0447\u0435\u0440\u0435\u0437 @translatehub/core (\u0431\u0435\u0437 \u043F\u0435\u0440\u0435\u0441\u0431\u043E\u0440\u043A\u0438)
+
+export type TranslationKey =
+${keyUnion};
+
+declare module '@translatehub/react' {
+  interface UseTranslation {
+    t(key: TranslationKey, params?: Record<string, string | number>): string;
+  }
+}
+`;
+        (0, import_fs.writeFileSync)(typesPath, content, "utf-8");
+        console.log(`[translatehub] TypeScript-\u0442\u0438\u043F\u044B \u0441\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u044B: ${typesOutputPath} (${allKeys.size} \u043A\u043B\u044E\u0447\u0435\u0439)`);
+      }
+    }
+  };
+}
+async function fetchTranslations(baseUrl, apiKey, lang) {
+  const url = `${baseUrl}/api/public/translations?lang=${encodeURIComponent(lang)}`;
+  const response = await fetch(url, {
+    headers: { "X-API-Key": apiKey }
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status} \u0434\u043B\u044F \u044F\u0437\u044B\u043A\u0430 "${lang}"`);
+  }
+  return response.json();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  translateHub
+});

package/dist/index.mjs

@@ -0,0 +1,77 @@
+// src/index.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { resolve, join } from "path";
+var BASE_URL = "https://translate-hub.ru";
+function translateHub(options) {
+  const {
+    apiKey,
+    languages,
+    generateTypes = true,
+    typesOutputPath = "src/types/translations.d.ts",
+    downloadTranslations = false,
+    outputDir = "public/locales"
+  } = options;
+  return {
+    name: "vite-plugin-translatehub",
+    async buildStart() {
+      const cwd = process.cwd();
+      if (!generateTypes && !downloadTranslations) return;
+      console.log(`[translatehub] \u0417\u0430\u0433\u0440\u0443\u0436\u0430\u044E \u043A\u043B\u044E\u0447\u0438 \u0434\u043B\u044F \u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u0438 \u0442\u0438\u043F\u043E\u0432...`);
+      const results = await Promise.allSettled(
+        languages.map((lang) => fetchTranslations(BASE_URL, apiKey, lang))
+      );
+      const allKeys = /* @__PURE__ */ new Set();
+      for (let i = 0; i < languages.length; i++) {
+        const lang = languages[i];
+        const result = results[i];
+        if (result.status === "fulfilled") {
+          const translations = result.value;
+          Object.keys(translations).forEach((k) => allKeys.add(k));
+          if (downloadTranslations) {
+            const outDir = resolve(cwd, outputDir);
+            if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
+            const filePath = join(outDir, `${lang}.json`);
+            writeFileSync(filePath, JSON.stringify(translations, null, 2), "utf-8");
+            console.log(`[translatehub] \u0421\u043A\u0430\u0447\u0430\u043D ${lang}.json (${Object.keys(translations).length} \u043A\u043B\u044E\u0447\u0435\u0439)`);
+          }
+        } else {
+          console.warn(`[translatehub] \u041E\u0448\u0438\u0431\u043A\u0430 \u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0438 \u043A\u043B\u044E\u0447\u0435\u0439 \u0434\u043B\u044F "${lang}":`, result.reason?.message);
+        }
+      }
+      if (generateTypes && allKeys.size > 0) {
+        const typesPath = resolve(cwd, typesOutputPath);
+        const typesDir = typesPath.replace(/[/\\][^/\\]+$/, "");
+        if (!existsSync(typesDir)) mkdirSync(typesDir, { recursive: true });
+        const keyUnion = [...allKeys].sort().map((k) => `  | '${k}'`).join("\n");
+        const content = `// \u0410\u0432\u0442\u043E\u0433\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u044F vite-plugin-translatehub \u2014 \u043D\u0435 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0432\u0440\u0443\u0447\u043D\u0443\u044E
+// \u041E\u0431\u043D\u043E\u0432\u043B\u044F\u0435\u0442\u0441\u044F \u043F\u0440\u0438 \u043A\u0430\u0436\u0434\u043E\u0439 \u0441\u0431\u043E\u0440\u043A\u0435 / \u0437\u0430\u043F\u0443\u0441\u043A\u0435 dev-\u0441\u0435\u0440\u0432\u0435\u0440\u0430
+// \u041F\u0435\u0440\u0435\u0432\u043E\u0434\u044B \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u044E\u0442\u0441\u044F \u0432 runtime \u0447\u0435\u0440\u0435\u0437 @translatehub/core (\u0431\u0435\u0437 \u043F\u0435\u0440\u0435\u0441\u0431\u043E\u0440\u043A\u0438)
+
+export type TranslationKey =
+${keyUnion};
+
+declare module '@translatehub/react' {
+  interface UseTranslation {
+    t(key: TranslationKey, params?: Record<string, string | number>): string;
+  }
+}
+`;
+        writeFileSync(typesPath, content, "utf-8");
+        console.log(`[translatehub] TypeScript-\u0442\u0438\u043F\u044B \u0441\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u044B: ${typesOutputPath} (${allKeys.size} \u043A\u043B\u044E\u0447\u0435\u0439)`);
+      }
+    }
+  };
+}
+async function fetchTranslations(baseUrl, apiKey, lang) {
+  const url = `${baseUrl}/api/public/translations?lang=${encodeURIComponent(lang)}`;
+  const response = await fetch(url, {
+    headers: { "X-API-Key": apiKey }
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status} \u0434\u043B\u044F \u044F\u0437\u044B\u043A\u0430 "${lang}"`);
+  }
+  return response.json();
+}
+export {
+  translateHub
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@translatehub/vite-plugin",
+  "version": "1.0.0",
+  "description": "Vite plugin — downloads translations from TranslateHub at build time and generates TypeScript types",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch"
+  },
+  "peerDependencies": {
+    "vite": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.2",
+    "vite": "^5.2.0"
+  },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "i18n",
+    "translatehub"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/artemryskal/translate-hub.git",
+    "directory": "sdk/vite-plugin"
+  },
+  "homepage": "https://translate-hub.ru"
+}