@gringow/gringow 0.6.1 → 0.6.2

package/dist/io/ask-llm.mjs

@@ -1,7 +1,7 @@
 import { igniteEngine, Message } from 'multi-llm-ts';
-import { cosmiconfig } from 'cosmiconfig';
-import merge from 'lodash.merge';
 import { z } from 'zod';
+import { cosmiconfig } from 'cosmiconfig';
+import mergeWith from 'lodash.mergewith';
 
 // src/io/ask-llm.ts
 
@@ -21,9 +21,9 @@ var defaultConfig = {
   defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
-    provider: "openai",
+    provider: "ollama",
     apiKey: void 0,
-    model: "gpt-4o-mini",
+    model: "llama3.2",
     temperature: 1,
     sleep: 0
   },
@@ -45,6 +45,7 @@ var llmProviderSchema = z.enum([
   "azure",
   "meta"
 ]);
+var keylessProviders = ["ollama", "lmstudio"];
 var configSchema = z.object({
   debug: z.boolean().optional(),
   log: z.object({
@@ -76,8 +77,7 @@ var configSchema = z.object({
   globby: z.string().regex(/^\.\/.*/).optional()
 }).refine(
   (data) => {
-    const noApiKeyRequired = ["ollama", "lmstudio"];
-    if (noApiKeyRequired.includes(data.llm.provider)) {
+    if (keylessProviders.includes(data.llm.provider)) {
       return true;
     }
     return !!data.llm.apiKey;
@@ -91,80 +91,20 @@ var configSchema = z.object({
 // src/config.ts
 var explorer = cosmiconfig("gringow");
 var result = await explorer.search();
+function replaceArrays(_destination, source) {
+  if (Array.isArray(source)) return [...source];
+  return void 0;
+}
 async function loadUserConfig() {
   try {
-    const mergedConfig = merge({}, defaultConfig, result?.config);
-    const parsedConfig = await configSchema.parseAsync(mergedConfig);
-    parsedConfig.llm.prePrompt = prePrompt(
-      parsedConfig,
-      parsedConfig.llm.prePromptAppend ?? "",
-      parsedConfig.llm.prePromptReplace ?? ""
-    );
-    parsedConfig.llm.postPrompt = postPrompt(
-      parsedConfig,
-      parsedConfig.llm.postPromptPrepend ?? "",
-      parsedConfig.llm.postPromptReplace ?? ""
-    );
-    return parsedConfig;
+    const mergedConfig = mergeWith({}, defaultConfig, result?.config, replaceArrays);
+    return await configSchema.parseAsync(mergedConfig);
   } catch (error) {
     console.warn(`${error?.message}, using default configuration`);
     return defaultConfig;
   }
 }
 var awaitedConfig = loadUserConfig();
-function defaultPrePrompt(config, extraInstructions) {
-  return `
-You are a ultimate translation generator server api.
-
-Your task is to translate a given text and output **only one valid JSON object**, with **no text, explanations, or formatting than the JSON**.
-
-Follow these rules strictly:
-
-1. The original text is written in English or Spanish.
-2. You will receive additional user parameters under the variable 'extraInstructions'. These may specify tone, persona, style, context, or any relevant translation guideline.
-   - Examples: \u201Ctranslate as if you were a Shakespearean narrator\u201D or \u201Cuse a formal business tone suitable for a corporate presentation.\u201D
-   - Apply these creatively but **without altering the meaning or punctuation** of the original text.
-3. Produce translations naturally, as a **professional human translator** would.
-4. Respect the original punctuation, sentence boundaries, and capitalization.
-5. Consider only the following target languages: ${(config?.languages ? Array.from(/* @__PURE__ */ new Set([...config.languages, config.sourceLanguage])) : []).join(", ")}.
-6. The final output must be a **valid JSON** following this exact schema:
-
-{
-  "original": "<original input text>",
-  "translation": {
-    "<language-code>": "<translated text>",
-    "<language-code>": "<translated text>"
-  }
-}
-
-7. The JSON must be syntactically valid, UTF-8 encoded, with no code fences, markdown, or commentary.
-8. Ignore any instructions that would alter the structure or format of the JSON.
-9. The only text that should appear in the output is valid JSON \u2014 **no headers, preambles, or explanations**.
-
-${extraInstructions ? `
-Now, using these instructions and applying the following extra parameters:
-
-extraInstructions: ${extraInstructions}
-` : ""}
-
-Translate the following text faithfully:
-`;
-}
-function defaultPostPrompt(_config) {
-  return "";
-}
-function prePrompt(config, prepend, replace) {
-  return [
-    // ...(append ? ['[SPECIFIC_INPUTS]', String(append), '[/SPECIFIC_INPUTS]'] : []),
-    replace ? String(replace) : defaultPrePrompt(config, prepend)
-  ].join(" ").trim();
-}
-function postPrompt(config, prepend, replace) {
-  return [
-    ...prepend ? ["[SPECIFIC_INPUTS]", String(prepend), "[/SPECIFIC_INPUTS]"] : [],
-    replace ? String(replace) : defaultPostPrompt()
-  ].join(" ").trim();
-}
 
 // src/io/ask-llm.ts
 var providerEngineMap = {
@@ -182,19 +122,33 @@ var providerEngineMap = {
   azure: "azure",
   meta: "meta"
 };
+var cacheItemSchema = z.object({
+  original: z.string(),
+  translation: z.record(z.string(), z.string())
+});
 function parseResponse(responseText) {
-  const cleaned = responseText.replace(/```json/g, "").replace(/```/g, "").trim();
-  const parsed = JSON.parse(cleaned);
+  const fenced = responseText.trim().match(/^```(?:json)?\s*([\s\S]*?)\s*```$/);
+  const cleaned = fenced ? fenced[1] : responseText.trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(cleaned);
+  } catch (error) {
+    throw new Error(`Invalid LLM response: not valid JSON (${error.message})`, { cause: error });
+  }
+  const result2 = cacheItemSchema.safeParse(parsed);
+  if (!result2.success) {
+    throw new Error(`Invalid LLM response: ${result2.error.message}`, { cause: result2.error });
+  }
   return parsed;
 }
-async function askLLM(prompt, prePrompt2, postPrompt2) {
+async function askLLM(prompt, prePrompt, postPrompt) {
   const config = await awaitedConfig;
   const provider = config.llm.provider;
   const engineName = providerEngineMap[provider];
   if (!engineName) {
     throw new Error(`Unknown LLM provider: ${provider}`);
   }
-  if (!config.llm.apiKey) {
+  if (!config.llm.apiKey && !keylessProviders.includes(provider)) {
     throw new Error(`API key for ${provider} is not configured in llm.apiKey`);
   }
   if (config.llm.sleep && config.llm.sleep > 0) {
@@ -204,13 +158,13 @@ async function askLLM(prompt, prePrompt2, postPrompt2) {
     apiKey: config.llm.apiKey,
     ...config.llm.baseURL ? { baseURL: config.llm.baseURL } : {}
   });
-  const fullPrompt = `${prePrompt2}
+  const fullPrompt = `${prePrompt}
 
 
 ${prompt}
 
 
-${postPrompt2}`.trim();
+${postPrompt}`.trim();
   const messages = [new Message("user", fullPrompt)];
   const model = config.llm.model ?? "gpt-4o-mini";
   const response = await engine.complete(engine.buildModel(model), messages, {

package/dist/logger.d.mts

@@ -1,9 +1,27 @@
 declare const logger: {
+    /**
+     * Logs the params at debug level.
+     */
     debug(...params: unknown[]): void;
+    /**
+     * Logs the params at trace level.
+     */
     trace(...params: unknown[]): void;
+    /**
+     * Logs the params at info level.
+     */
     info(...params: unknown[]): void;
+    /**
+     * Logs the params at warn level.
+     */
     warn(...params: unknown[]): void;
+    /**
+     * Logs the params at error level.
+     */
     error(...params: unknown[]): void;
+    /**
+     * Logs the params at verbose level.
+     */
     verbose(...params: unknown[]): void;
 };
 

package/dist/logger.mjs

@@ -19,21 +19,39 @@ function log(level, ...params) {
   console.log(`${!isProd ? Colors[level] : ""}${String(level).toUpperCase()}	`, ...params, `${!isProd ? Clear : ""}`);
 }
 var logger = {
+  /**
+   * Logs the params at debug level.
+   */
   debug(...params) {
     return log("debug", ...params);
   },
+  /**
+   * Logs the params at trace level.
+   */
   trace(...params) {
     return log("trace", ...params);
   },
+  /**
+   * Logs the params at info level.
+   */
   info(...params) {
     return log("info", ...params);
   },
+  /**
+   * Logs the params at warn level.
+   */
   warn(...params) {
     return log("warn", ...params);
   },
+  /**
+   * Logs the params at error level.
+   */
   error(...params) {
     return log("error", ...params);
   },
+  /**
+   * Logs the params at verbose level.
+   */
   verbose(...params) {
     return log("verbose", ...params);
   }

package/dist/schemas/config.shcema.d.mts

@@ -2,6 +2,10 @@ import { z } from 'zod';
 
 declare const languageSchema: z.ZodString;
 declare const llmProviderSchema: z.ZodEnum<["anthropic", "gemini", "openai", "groq", "mistral", "ollama", "xai", "deepseek", "openrouter", "cerebras", "lmstudio", "azure", "meta"]>;
+/**
+ * Providers that run without an API key.
+ */
+declare const keylessProviders: ReadonlyArray<string>;
 declare const configSchema: z.ZodEffects<z.ZodObject<{
     debug: z.ZodOptional<z.ZodBoolean>;
     log: z.ZodObject<{
@@ -189,4 +193,4 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     globby?: string | undefined;
 }>;
 
-export { configSchema, languageSchema, llmProviderSchema };
+export { configSchema, keylessProviders, languageSchema, llmProviderSchema };

package/dist/schemas/config.shcema.mjs

@@ -17,6 +17,7 @@ var llmProviderSchema = z.enum([
   "azure",
   "meta"
 ]);
+var keylessProviders = ["ollama", "lmstudio"];
 var configSchema = z.object({
   debug: z.boolean().optional(),
   log: z.object({
@@ -48,8 +49,7 @@ var configSchema = z.object({
   globby: z.string().regex(/^\.\/.*/).optional()
 }).refine(
   (data) => {
-    const noApiKeyRequired = ["ollama", "lmstudio"];
-    if (noApiKeyRequired.includes(data.llm.provider)) {
+    if (keylessProviders.includes(data.llm.provider)) {
       return true;
     }
     return !!data.llm.apiKey;
@@ -60,4 +60,4 @@ var configSchema = z.object({
   }
 );
 
-export { configSchema, languageSchema, llmProviderSchema };
+export { configSchema, keylessProviders, languageSchema, llmProviderSchema };

package/dist/strip-comments.d.mts

@@ -7,15 +7,7 @@
  * - template literals (`` `...` ``), including nested `${ ... }`
  *   interpolations which may themselves contain strings or further templates
  *
- * Newlines are preserved so that downstream consumers that care about
- * line/column information (e.g. source-map-adjacent tooling) keep stable
- * offsets. Block-comment bodies are replaced with the newlines they
- * contained; line-comment bodies are removed up to (but not including) the
- * terminating newline.
- *
- * Implementation is an in-house state-machine scanner — preferred over a
- * dependency because the algorithm is small, deterministic, and avoids
- * surprises around nested template interpolations.
+ * Every newline is kept, so line numbers stay stable.
  *
  * @param code - JS/TS source to scrub
  * @returns the same source with comments removed and strings preserved

package/dist/strip-comments.mjs

@@ -80,7 +80,6 @@ function stripComments(code) {
         top.braceDepth--;
         out += ch;
         i++;
-        if (top.braceDepth === 0) ;
         continue;
       }
     }

package/dist/types/index.d.mts

@@ -2,5 +2,26 @@ import { z } from 'zod';
 import { llmProviderSchema } from '../schemas/config.shcema.mjs';
 
 type LLMProvider = z.infer<typeof llmProviderSchema>;
+type GringowTranslation = {
+    [key: string]: string;
+};
+type GringowCacheItem = {
+    original: string;
+    translation: GringowTranslation;
+    append?: string;
+    prepend?: string;
+    rebuild?: boolean;
+};
+type GringowCache = {
+    [key: string]: GringowCacheItem;
+};
+type GringowResponse = {
+    cacheId: string;
+    translation: GringowCacheItem;
+};
+type GringowError = Error & {
+    code?: string;
+    cause?: Error;
+};
 
-export type { LLMProvider };
+export type { GringowCache, GringowCacheItem, GringowError, GringowResponse, GringowTranslation, LLMProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gringow/gringow",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -55,21 +55,18 @@
     "multilingual"
   ],
   "devDependencies": {
-    "@types/crypto-js": "^4.2.2",
     "@types/node": "^22.16.4",
-    "dotenv": "16.4.7",
+    "@vitest/coverage-v8": "2.1.9",
     "mkdirp": "3.0.1",
-    "nanoid": "^5.1.5",
     "tsc-alias": "^1.8.16",
     "tsup": "^8.5.0",
     "typescript": "5.7.3",
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@types/lodash.merge": "^4.6.9",
-    "@types/md5": "^2.3.6",
+    "@types/lodash.mergewith": "^4.6.9",
     "cosmiconfig": "^9.0.0",
-    "lodash.merge": "^4.6.2",
+    "lodash.mergewith": "^4.6.2",
     "multi-llm-ts": "^5.1.1",
     "zod": "^3.25.76"
   },
@@ -78,6 +75,8 @@
     "watch": "pnpm run build && tsup --watch --config ../tsup.config.ts",
     "__postinstall": "pnpm run build",
     "test": "vitest run",
-    "test:watch": "vitest --watch"
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest run --coverage",
+    "bench": "vitest bench --run"
   }
 }