npm - @beg4660/translator - Versions diffs - 0.1.0 → 0.2.0 - Mend

@beg4660/translator 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -1,58 +1,82 @@
-# @nelon/translator
-Gemini(클라우드) / Ollama(로컬) 중 원하는 Provider로 **번역 API 호출**을 할 수 있는 작은 TypeScript 라이브러리입니다.
-## Install
-```bash
-npm i @beg4660/translator
-```
-Node 18+ 필요합니다.
-## Usage
-### Gemini
-```ts
-import { GeminiProvider, TranslatorClient } from "@beg4660/translator";
-const provider = new GeminiProvider({
-  apiKey: process.env.GEMINI_API_KEY!,
-  model: "gemini-1.5-flash"
-});
-const client = new TranslatorClient(provider);
-const result = await client.translate({
-  text: "Hello, how are you?",
-  targetLang: "Korean"
-});
-console.log(result.text);
-```
-### Ollama
-```ts
-import { OllamaProvider, TranslatorClient } from "@beg4660/translator";
-const provider = new OllamaProvider({
-  host: "http://127.0.0.1:11434",
-  model: "llama3"
-});
-const client = new TranslatorClient(provider);
-const result = await client.translate({
-  text: "오늘 회의는 3시에 시작합니다.",
-  targetLang: "English",
-  tone: "formal"
-});
-console.log(result.text);
-```
-## Notes
-- Gemini API Key는 앱/확장 쪽에서는 `vscode.SecretStorage` 같은 안전한 저장소를 권장합니다.
-- Ollama는 기본적으로 `http://127.0.0.1:11434` 를 사용합니다.
+# @nelon/translator
+Gemini(클라우드) / Ollama(로컬) 중 원하는 Provider로 **번역 API 호출**을 할 수 있는 작은 TypeScript 라이브러리입니다.
+## 설치
+```bash
+npm install @beg4660/translator
+```
+Node.js 18 이상이 필요합니다.
+## 사용법
+### Gemini
+```ts
+import { GeminiProvider, TranslatorClient } from "@beg4660/translator";
+const provider = new GeminiProvider({
+  apiKey: process.env.GEMINI_API_KEY!,
+  model: "gemini-1.5-flash" // 기본값, 생략 가능
+});
+const client = new TranslatorClient(provider);
+const result = await client.translate({
+  text: "Hello, how are you?",
+  targetLang: "Korean"
+});
+console.log(result.text); // 안녕하세요, 어떻게 지내세요?
+```
+### Ollama
+Ollama가 로컬에서 실행 중이어야 합니다.
+```ts
+import { OllamaProvider, TranslatorClient } from "@beg4660/translator";
+const provider = new OllamaProvider({
+  host: "http://127.0.0.1:11434", // 기본값, 생략 가능
+  model: "llama3"
+});
+const client = new TranslatorClient(provider);
+const result = await client.translate({
+  text: "오늘 회의는 3시에 시작합니다.",
+  targetLang: "English",
+  tone: "formal"
+});
+console.log(result.text);
+```
+## 번역 옵션
+| 옵션 | 타입 | 필수 | 설명 |
+|------|------|------|------|
+| `text` | `string` | 필수 | 번역할 텍스트 |
+| `targetLang` | `string` | 필수 | 번역 대상 언어 (예: `"Korean"`, `"English"`) |
+| `sourceLang` | `string` | 선택 | 원본 언어 (기본값: 자동 감지) |
+| `tone` | `TranslateTone` | 선택 | 번역 어조 (기본값: `"neutral"`) |
+| `glossary` | `Record<string, string>` | 선택 | 고정 용어 사전 |
+**tone 값:** `"neutral"` `"formal"` `"informal"` `"friendly"` `"technical"`
+### 용어 사전 사용 예시
+```ts
+const result = await client.translate({
+  text: "The API returned an error.",
+  targetLang: "Korean",
+  tone: "technical",
+  glossary: { "API": "API", "error": "오류" }
+});
+```
+## Notes
+- Gemini API Key는 앱/확장 쪽에서는 `vscode.SecretStorage` 같은 안전한 저장소를 권장합니다.
+- Ollama는 기본적으로 `http://127.0.0.1:11434` 를 사용합니다.

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+import * as readline from 'readline/promises';
+import { stdout, stdin } from 'process';
+import { parseArgs } from 'util';
+import { GoogleGenerativeAI } from '@google/generative-ai';
+// src/prompt.ts
+function formatGlossary(glossary) {
+  if (!glossary) return "";
+  const entries = Object.entries(glossary);
+  if (entries.length === 0) return "";
+  return entries.map(([k, v]) => `- "${k}" => "${v}"`).join("\n");
+}
+function buildTranslatePrompt(opts) {
+  const source = opts.sourceLang?.trim() ? opts.sourceLang.trim() : "auto";
+  const tone = opts.tone ?? "neutral";
+  const glossary = formatGlossary(opts.glossary);
+  return [
+    "You are a professional translation engine.",
+    "Translate the user's text precisely and naturally.",
+    "",
+    "Rules:",
+    "- Output ONLY the translated text. No quotes, no markdown, no explanations.",
+    "- Preserve line breaks.",
+    "- Keep code blocks, URLs, file paths, and identifiers unchanged.",
+    "- If the input is already in the target language, return it unchanged.",
+    glossary ? `- Use this glossary strictly (source => target):
+${glossary}` : "- No glossary provided.",
+    "",
+    `Source language: ${source}`,
+    `Target language: ${opts.targetLang}`,
+    `Tone: ${tone}`,
+    "",
+    "Text to translate:",
+    opts.text
+  ].join("\n");
+}
+// src/client.ts
+var TranslatorClient = class {
+  constructor(provider) {
+    this.provider = provider;
+  }
+  provider;
+  async translate(opts) {
+    if (!opts?.text) throw new Error("translate: text is required");
+    if (!opts?.targetLang) throw new Error("translate: targetLang is required");
+    const prompt = buildTranslatePrompt(opts);
+    const out = await this.provider.generate(prompt);
+    return {
+      text: cleanupText(out.text),
+      provider: this.provider.kind,
+      model: this.provider.model,
+      raw: out.raw
+    };
+  }
+};
+function cleanupText(s) {
+  return s.replace(/\r\n/g, "\n").replace(/[ \t]+\n/g, "\n").trimEnd();
+}
+var GeminiProvider = class {
+  kind = "gemini";
+  model;
+  client;
+  constructor(opts) {
+    if (!opts?.apiKey) throw new Error("GeminiProvider: apiKey is required");
+    this.model = opts.model ?? "gemini-1.5-flash";
+    this.client = new GoogleGenerativeAI(opts.apiKey);
+  }
+  async generate(prompt) {
+    const model = this.client.getGenerativeModel({ model: this.model });
+    const res = await model.generateContent(prompt);
+    const text = res.response.text();
+    return { text, raw: res };
+  }
+};
+// src/providers/ollama.ts
+var OllamaProvider = class {
+  kind = "ollama";
+  model;
+  host;
+  constructor(opts) {
+    if (!opts?.model) throw new Error("OllamaProvider: model is required");
+    this.model = opts.model;
+    this.host = (opts.host ?? "http://127.0.0.1:11434").replace(/\/+$/, "");
+  }
+  async generate(prompt) {
+    const body = {
+      model: this.model,
+      prompt,
+      stream: false
+    };
+    const res = await fetch(`${this.host}/api/generate`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const msg = await safeReadText(res);
+      throw new Error(`OllamaProvider: HTTP ${res.status} ${res.statusText}${msg ? ` - ${msg}` : ""}`);
+    }
+    const json = await res.json();
+    return { text: (json.response ?? "").toString(), raw: json };
+  }
+};
+async function safeReadText(res) {
+  try {
+    return await res.text();
+  } catch {
+    return "";
+  }
+}
+// src/cli.ts
+var { values, positionals } = parseArgs({
+  allowPositionals: true,
+  options: {
+    to: { type: "string", short: "t" },
+    from: { type: "string", short: "f" },
+    tone: { type: "string" },
+    provider: { type: "string", short: "p", default: "gemini" },
+    model: { type: "string", short: "m" },
+    host: { type: "string" },
+    help: { type: "boolean", short: "h" }
+  }
+});
+if (values.help) {
+  console.log(`
+Usage: translator [text] [options]
+\uC778\uC218 \uC5C6\uC774 \uC2E4\uD589\uD558\uBA74 \uB300\uD654\uD615 \uBAA8\uB4DC\uB85C \uC9C4\uC785\uD569\uB2C8\uB2E4.
+Options:
+  -t, --to <lang>        \uBC88\uC5ED \uB300\uC0C1 \uC5B8\uC5B4 (\uAE30\uBCF8\uAC12: Korean)
+  -f, --from <lang>      \uC6D0\uBCF8 \uC5B8\uC5B4 (\uAE30\uBCF8\uAC12: \uC790\uB3D9 \uAC10\uC9C0)
+  --tone <tone>          \uC5B4\uC870: neutral | formal | informal | friendly | technical
+  -p, --provider <name>  \uC0AC\uC6A9\uD560 provider: gemini | ollama (\uAE30\uBCF8\uAC12: gemini)
+  -m, --model <name>     \uBAA8\uB378 \uC774\uB984
+  --host <url>           Ollama \uD638\uC2A4\uD2B8 (\uAE30\uBCF8\uAC12: http://127.0.0.1:11434)
+  -h, --help             \uB3C4\uC6C0\uB9D0
+Examples:
+  translator                            # \uB300\uD654\uD615 \uBAA8\uB4DC
+  translator "Hello, world!" --to Korean
+  translator "\uC548\uB155\uD558\uC138\uC694" --to English --tone formal
+  translator "Hello" --to Korean --provider ollama --model llama3
+  GEMINI_API_KEY=xxx translator "Hello" --to Korean
+`);
+  process.exit(0);
+}
+var targetLang = values.to ?? "Korean";
+var providerKind = values.provider ?? "gemini";
+var client;
+if (providerKind === "ollama") {
+  const model = values.model ?? "llama3";
+  client = new TranslatorClient(
+    new OllamaProvider({ model, host: values.host })
+  );
+} else {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    console.error("\uC624\uB958: GEMINI_API_KEY \uD658\uACBD\uBCC0\uC218\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");
+    process.exit(1);
+  }
+  client = new TranslatorClient(
+    new GeminiProvider({ apiKey, model: values.model })
+  );
+}
+async function translateText(text) {
+  const result = await client.translate({
+    text,
+    targetLang,
+    sourceLang: values.from,
+    tone: values.tone
+  });
+  console.log(result.text);
+}
+if (positionals.length > 0) {
+  await translateText(positionals.join(" "));
+  process.exit(0);
+}
+console.log(`\uBC88\uC5ED\uAE30 (${targetLang}) \u2014 \uC885\uB8CC\uD558\uB824\uBA74 Ctrl+C \uB610\uB294 /exit
+`);
+var rl = readline.createInterface({ input: stdin, output: stdout });
+rl.on("close", () => {
+  console.log("\n\uC885\uB8CC\uD569\uB2C8\uB2E4.");
+  process.exit(0);
+});
+while (true) {
+  const text = await rl.question("> ").catch(() => null);
+  if (text === null || text.trim() === "/exit") {
+    rl.close();
+    break;
+  }
+  if (text.trim() === "") continue;
+  await translateText(text);
+  console.log();
+}
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/prompt.ts","../src/client.ts","../src/providers/gemini.ts","../src/providers/ollama.ts","../src/cli.ts"],"names":["input","output"],"mappings":"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","file":"cli.js","sourcesContent":["import type { TranslateOptions } from \"./types.js\";\r\n\r\nfunction formatGlossary(glossary?: Record<string, string>): string {\r\n if (!glossary) return \"\";\r\n const entries = Object.entries(glossary);\r\n if (entries.length === 0) return \"\";\r\n return entries.map(([k, v]) => `- \"${k}\" => \"${v}\"`).join(\"\\n\");\r\n}\r\n\r\nexport function buildTranslatePrompt(opts: TranslateOptions): string {\r\n const source = opts.sourceLang?.trim() ? opts.sourceLang.trim() : \"auto\";\r\n const tone = opts.tone ?? \"neutral\";\r\n const glossary = formatGlossary(opts.glossary);\r\n\r\n return [\r\n \"You are a professional translation engine.\",\r\n \"Translate the user's text precisely and naturally.\",\r\n \"\",\r\n \"Rules:\",\r\n \"- Output ONLY the translated text. No quotes, no markdown, no explanations.\",\r\n \"- Preserve line breaks.\",\r\n \"- Keep code blocks, URLs, file paths, and identifiers unchanged.\",\r\n \"- If the input is already in the target language, return it unchanged.\",\r\n glossary\r\n ? `- Use this glossary strictly (source => target):\\n${glossary}`\r\n : \"- No glossary provided.\",\r\n \"\",\r\n `Source language: ${source}`,\r\n `Target language: ${opts.targetLang}`,\r\n `Tone: ${tone}`,\r\n \"\",\r\n \"Text to translate:\",\r\n opts.text\r\n ].join(\"\\n\");\r\n}\r\n\r\n","import { buildTranslatePrompt } from \"./prompt.js\";\r\nimport type { LLMProvider, TranslateOptions, TranslateResult } from \"./types.js\";\r\n\r\nexport class TranslatorClient {\r\n constructor(private readonly provider: LLMProvider) {}\r\n\r\n async translate(opts: TranslateOptions): Promise<TranslateResult> {\r\n if (!opts?.text) throw new Error(\"translate: text is required\");\r\n if (!opts?.targetLang) throw new Error(\"translate: targetLang is required\");\r\n\r\n const prompt = buildTranslatePrompt(opts);\r\n const out = await this.provider.generate(prompt);\r\n\r\n return {\r\n text: cleanupText(out.text),\r\n provider: this.provider.kind,\r\n model: this.provider.model,\r\n raw: out.raw\r\n };\r\n }\r\n}\r\n\r\nfunction cleanupText(s: string): string {\r\n // Keep it conservative: just normalize trailing whitespace/newlines.\r\n return s.replace(/\\r\\n/g, \"\\n\").replace(/[ \\t]+\\n/g, \"\\n\").trimEnd();\r\n}\r\n\r\n","import { GoogleGenerativeAI } from \"@google/generative-ai\";\r\nimport type { GeminiProviderOptions, LLMProvider } from \"../types.js\";\r\n\r\nexport class GeminiProvider implements LLMProvider {\r\n readonly kind = \"gemini\" as const;\r\n readonly model: string;\r\n private readonly client: GoogleGenerativeAI;\r\n\r\n constructor(opts: GeminiProviderOptions) {\r\n if (!opts?.apiKey) throw new Error(\"GeminiProvider: apiKey is required\");\r\n this.model = opts.model ?? \"gemini-1.5-flash\";\r\n this.client = new GoogleGenerativeAI(opts.apiKey);\r\n }\r\n\r\n async generate(prompt: string): Promise<{ text: string; raw?: unknown }> {\r\n const model = this.client.getGenerativeModel({ model: this.model });\r\n const res = await model.generateContent(prompt);\r\n const text = res.response.text();\r\n return { text, raw: res };\r\n }\r\n}\r\n\r\n","import type { LLMProvider, OllamaProviderOptions } from \"../types.js\";\r\n\r\ntype OllamaGenerateRequest = {\r\n model: string;\r\n prompt: string;\r\n stream?: boolean;\r\n options?: Record<string, unknown>;\r\n};\r\n\r\ntype OllamaGenerateResponse = {\r\n response?: string;\r\n done?: boolean;\r\n model?: string;\r\n};\r\n\r\nexport class OllamaProvider implements LLMProvider {\r\n readonly kind = \"ollama\" as const;\r\n readonly model: string;\r\n private readonly host: string;\r\n\r\n constructor(opts: OllamaProviderOptions) {\r\n if (!opts?.model) throw new Error(\"OllamaProvider: model is required\");\r\n this.model = opts.model;\r\n this.host = (opts.host ?? \"http://127.0.0.1:11434\").replace(/\\/+$/, \"\");\r\n }\r\n\r\n async generate(prompt: string): Promise<{ text: string; raw?: unknown }> {\r\n const body: OllamaGenerateRequest = {\r\n model: this.model,\r\n prompt,\r\n stream: false\r\n };\r\n\r\n const res = await fetch(`${this.host}/api/generate`, {\r\n method: \"POST\",\r\n headers: { \"content-type\": \"application/json\" },\r\n body: JSON.stringify(body)\r\n });\r\n\r\n if (!res.ok) {\r\n const msg = await safeReadText(res);\r\n throw new Error(`OllamaProvider: HTTP ${res.status} ${res.statusText}${msg ? ` - ${msg}` : \"\"}`);\r\n }\r\n\r\n const json = (await res.json()) as OllamaGenerateResponse;\r\n return { text: (json.response ?? \"\").toString(), raw: json };\r\n }\r\n}\r\n\r\nasync function safeReadText(res: Response): Promise<string> {\r\n try {\r\n return await res.text();\r\n } catch {\r\n return \"\";\r\n }\r\n}\r\n\r\n","import * as readline from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\nimport { parseArgs } from \"node:util\";\nimport { TranslatorClient } from \"./client.js\";\nimport { GeminiProvider } from \"./providers/gemini.js\";\nimport { OllamaProvider } from \"./providers/ollama.js\";\nimport type { TranslateTone } from \"./types.js\";\n\nconst { values, positionals } = parseArgs({\n allowPositionals: true,\n options: {\n to: { type: \"string\", short: \"t\" },\n from: { type: \"string\", short: \"f\" },\n tone: { type: \"string\" },\n provider: { type: \"string\", short: \"p\", default: \"gemini\" },\n model: { type: \"string\", short: \"m\" },\n host: { type: \"string\" },\n help: { type: \"boolean\", short: \"h\" },\n },\n});\n\nif (values.help) {\n console.log(`\nUsage: translator [text] [options]\n\n인수 없이 실행하면 대화형 모드로 진입합니다.\n\nOptions:\n -t, --to <lang> 번역 대상 언어 (기본값: Korean)\n -f, --from <lang> 원본 언어 (기본값: 자동 감지)\n --tone <tone> 어조: neutral | formal | informal | friendly | technical\n -p, --provider <name> 사용할 provider: gemini | ollama (기본값: gemini)\n -m, --model <name> 모델 이름\n --host <url> Ollama 호스트 (기본값: http://127.0.0.1:11434)\n -h, --help 도움말\n\nExamples:\n translator # 대화형 모드\n translator \"Hello, world!\" --to Korean\n translator \"안녕하세요\" --to English --tone formal\n translator \"Hello\" --to Korean --provider ollama --model llama3\n GEMINI_API_KEY=xxx translator \"Hello\" --to Korean\n`);\n process.exit(0);\n}\n\nconst targetLang = values.to ?? \"Korean\";\nconst providerKind = values.provider ?? \"gemini\";\n\nlet client: TranslatorClient;\n\nif (providerKind === \"ollama\") {\n const model = values.model ?? \"llama3\";\n client = new TranslatorClient(\n new OllamaProvider({ model, host: values.host })\n );\n} else {\n const apiKey = process.env.GEMINI_API_KEY;\n if (!apiKey) {\n console.error(\"오류: GEMINI_API_KEY 환경변수가 필요합니다.\");\n process.exit(1);\n }\n client = new TranslatorClient(\n new GeminiProvider({ apiKey, model: values.model })\n );\n}\n\nasync function translateText(text: string): Promise<void> {\n const result = await client.translate({\n text,\n targetLang,\n sourceLang: values.from,\n tone: values.tone as TranslateTone | undefined,\n });\n console.log(result.text);\n}\n\n// 인수가 있으면 단일 번역 후 종료\nif (positionals.length > 0) {\n await translateText(positionals.join(\" \"));\n process.exit(0);\n}\n\n// 대화형 모드\nconsole.log(`번역기 (${targetLang}) — 종료하려면 Ctrl+C 또는 /exit\\n`);\n\nconst rl = readline.createInterface({ input, output });\n\nrl.on(\"close\", () => {\n console.log(\"\\n종료합니다.\");\n process.exit(0);\n});\n\nwhile (true) {\n const text = await rl.question(\"> \").catch(() => null);\n\n if (text === null || text.trim() === \"/exit\") {\n rl.close();\n break;\n }\n\n if (text.trim() === \"\") continue;\n\n await translateText(text);\n console.log();\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@beg4660/translator",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Unified Gemini/Ollama translation client",
   "license": "MIT",
   "repository": {
@@ -18,6 +18,9 @@
       "require": "./dist/index.cjs"
     }
   },
+  "bin": {
+    "translator": "./dist/cli.js"
+  },
   "files": [
     "dist"
   ],
@@ -33,9 +36,11 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@beg4660/translator": "^0.1.0",
     "@google/generative-ai": "^0.24.1"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   }