@beg4660/translator 0.1.0

package/README.md

@@ -0,0 +1,58 @@
+# @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` 를 사용합니다.
+

package/dist/index.cjs

@@ -0,0 +1,117 @@
+'use strict';
+
+var generativeAi = require('@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 generativeAi.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 "";
+  }
+}
+
+exports.GeminiProvider = GeminiProvider;
+exports.OllamaProvider = OllamaProvider;
+exports.TranslatorClient = TranslatorClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prompt.ts","../src/client.ts","../src/providers/gemini.ts","../src/providers/ollama.ts"],"names":["GoogleGenerativeAI"],"mappings":"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","file":"index.cjs","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"]}

package/dist/index.d.cts

@@ -0,0 +1,61 @@
+type ProviderKind = "gemini" | "ollama";
+type TranslateTone = "neutral" | "formal" | "informal" | "friendly" | "technical";
+interface TranslateOptions {
+    text: string;
+    targetLang: string;
+    sourceLang?: string;
+    tone?: TranslateTone;
+    glossary?: Record<string, string>;
+}
+interface TranslateResult {
+    text: string;
+    provider: ProviderKind;
+    model?: string;
+    raw?: unknown;
+}
+interface LLMProvider {
+    readonly kind: ProviderKind;
+    readonly model?: string;
+    generate(prompt: string): Promise<{
+        text: string;
+        raw?: unknown;
+    }>;
+}
+interface GeminiProviderOptions {
+    apiKey: string;
+    model?: string;
+}
+interface OllamaProviderOptions {
+    host?: string;
+    model: string;
+}
+
+declare class TranslatorClient {
+    private readonly provider;
+    constructor(provider: LLMProvider);
+    translate(opts: TranslateOptions): Promise<TranslateResult>;
+}
+
+declare class GeminiProvider implements LLMProvider {
+    readonly kind: "gemini";
+    readonly model: string;
+    private readonly client;
+    constructor(opts: GeminiProviderOptions);
+    generate(prompt: string): Promise<{
+        text: string;
+        raw?: unknown;
+    }>;
+}
+
+declare class OllamaProvider implements LLMProvider {
+    readonly kind: "ollama";
+    readonly model: string;
+    private readonly host;
+    constructor(opts: OllamaProviderOptions);
+    generate(prompt: string): Promise<{
+        text: string;
+        raw?: unknown;
+    }>;
+}
+
+export { GeminiProvider, type GeminiProviderOptions, type LLMProvider, OllamaProvider, type OllamaProviderOptions, type ProviderKind, type TranslateOptions, type TranslateResult, type TranslateTone, TranslatorClient };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+type ProviderKind = "gemini" | "ollama";
+type TranslateTone = "neutral" | "formal" | "informal" | "friendly" | "technical";
+interface TranslateOptions {
+    text: string;
+    targetLang: string;
+    sourceLang?: string;
+    tone?: TranslateTone;
+    glossary?: Record<string, string>;
+}
+interface TranslateResult {
+    text: string;
+    provider: ProviderKind;
+    model?: string;
+    raw?: unknown;
+}
+interface LLMProvider {
+    readonly kind: ProviderKind;
+    readonly model?: string;
+    generate(prompt: string): Promise<{
+        text: string;
+        raw?: unknown;
+    }>;
+}
+interface GeminiProviderOptions {
+    apiKey: string;
+    model?: string;
+}
+interface OllamaProviderOptions {
+    host?: string;
+    model: string;
+}
+
+declare class TranslatorClient {
+    private readonly provider;
+    constructor(provider: LLMProvider);
+    translate(opts: TranslateOptions): Promise<TranslateResult>;
+}
+
+declare class GeminiProvider implements LLMProvider {
+    readonly kind: "gemini";
+    readonly model: string;
+    private readonly client;
+    constructor(opts: GeminiProviderOptions);
+    generate(prompt: string): Promise<{
+        text: string;
+        raw?: unknown;
+    }>;
+}
+
+declare class OllamaProvider implements LLMProvider {
+    readonly kind: "ollama";
+    readonly model: string;
+    private readonly host;
+    constructor(opts: OllamaProviderOptions);
+    generate(prompt: string): Promise<{
+        text: string;
+        raw?: unknown;
+    }>;
+}
+
+export { GeminiProvider, type GeminiProviderOptions, type LLMProvider, OllamaProvider, type OllamaProviderOptions, type ProviderKind, type TranslateOptions, type TranslateResult, type TranslateTone, TranslatorClient };

package/dist/index.js

@@ -0,0 +1,113 @@
+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 "";
+  }
+}
+
+export { GeminiProvider, OllamaProvider, TranslatorClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prompt.ts","../src/client.ts","../src/providers/gemini.ts","../src/providers/ollama.ts"],"names":[],"mappings":"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","file":"index.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"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@beg4660/translator",
+  "version": "0.1.0",
+  "description": "Unified Gemini/Ollama translation client",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "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"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "chat:ollama": "npm run build && node ./scripts/chat-ollama.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.24.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
+  }
+}