@gringow/gringow 0.6.1 → 0.6.2

package/dist/browser.d.mts

@@ -1,6 +1,6 @@
 export { createCacheId } from './create-cache-id.mjs';
 export { interpolateTemplate } from './interpolate-template.mjs';
 
-declare const GRINGOW_IO_URL = "https://gringow.io";
+declare const GRINGOW_IO_URL = "https://gringow.dev";
 
 export { GRINGOW_IO_URL };

package/dist/browser.mjs

@@ -4,19 +4,19 @@ var MULTIPLIERS = [668265261, 374761393, 2654435769, 2496678331];
 var AVA_MULT1 = 2146121005;
 var AVA_MULT2 = 2221713035;
 function seedState(input) {
-  const state = [...INITIAL_STATE];
+  let [h1, h2, h3, h4] = INITIAL_STATE;
   for (const char of input) {
     const codePoint = char.codePointAt(0) ?? 0;
-    for (let i = 0; i < state.length; i++) {
-      state[i] = Math.imul(state[i] ^ codePoint, MULTIPLIERS[i]);
-      state[i] = rotateLeft(state[i], (i + 1) * 3);
-    }
-    state[0] ^= state[3] >>> 11;
-    state[1] ^= state[0] << 7;
-    state[2] ^= state[1] >>> 13;
-    state[3] ^= state[2] << 5;
+    h1 = rotateLeft(Math.imul(h1 ^ codePoint, MULTIPLIERS[0]), 3);
+    h2 = rotateLeft(Math.imul(h2 ^ codePoint, MULTIPLIERS[1]), 6);
+    h3 = rotateLeft(Math.imul(h3 ^ codePoint, MULTIPLIERS[2]), 9);
+    h4 = rotateLeft(Math.imul(h4 ^ codePoint, MULTIPLIERS[3]), 12);
+    h1 ^= h4 >>> 11;
+    h2 ^= h1 << 7;
+    h3 ^= h2 >>> 13;
+    h4 ^= h3 << 5;
   }
-  return state;
+  return [h1, h2, h3, h4];
 }
 function rotateLeft(value, shift) {
   return value << shift | value >>> 32 - shift;
@@ -45,23 +45,23 @@ function md5(input) {
 }
 
 // src/interpolate-template.ts
+function formatValue(value, index) {
+  return value === null || value === void 0 ? `\${${index}}` : String(value);
+}
 function ifArray(template, givenValues) {
-  const strings = [...template.raw];
-  const hasValues = givenValues !== void 0;
-  return strings.reduce((acc, item, index) => {
-    acc += String(item ?? "");
-    if (index < strings.length - 1) {
-      acc += hasValues ? String(givenValues[index] ?? "") : `\${${index}}`;
-    }
-    return acc;
-  }, "");
+  const strings = template.raw;
+  let output = String(strings[0] ?? "");
+  for (let index = 1; index < strings.length; index++) {
+    output += formatValue(givenValues?.[index - 1], index - 1);
+    output += String(strings[index] ?? "");
+  }
+  return output;
 }
 function ifString(template, givenValues) {
   if (template?.indexOf("${") === -1) return template;
   let valueIndex = 0;
   return template.replace(/\$\{[^}]*\}/g, () => {
-    const value = givenValues?.[valueIndex];
-    const output = value === null || value === void 0 ? `\${${valueIndex}}` : String(value);
+    const output = formatValue(givenValues?.[valueIndex], valueIndex);
     valueIndex++;
     return output;
   });
@@ -81,6 +81,6 @@ function createCacheId(text) {
 }
 
 // src/browser.ts
-var GRINGOW_IO_URL = "https://gringow.io";
+var GRINGOW_IO_URL = "https://gringow.dev";
 
 export { GRINGOW_IO_URL, createCacheId, interpolateTemplate };

package/dist/config.d.mts

@@ -21,9 +21,7 @@ declare function getConfigSource(): string;
  */
 declare function loadUserConfig(): Promise<GringowConfig>;
 /**
- * Waits for the user configuration to load.
- *
- * @returns The user configuration.
+ * The user configuration promise, loaded once when this module is imported.
  */
 declare const awaitedConfig: Promise<{
     log: {
@@ -55,9 +53,38 @@ declare const awaitedConfig: Promise<{
     debug?: boolean | undefined;
     globby?: string | undefined;
 }>;
+/**
+ * Builds the default pre-prompt for the configured languages.
+ *
+ * @param config - The resolved configuration.
+ * @param extraInstructions - Optional extra instructions appended to the prompt.
+ * @returns The default pre-prompt.
+ */
 declare function defaultPrePrompt(config: GringowConfig, extraInstructions?: string): string;
+/**
+ * Builds the default post-prompt. It is empty today.
+ *
+ * @param _config - The resolved configuration.
+ * @returns The default post-prompt.
+ */
 declare function defaultPostPrompt(_config: GringowConfig): string;
+/**
+ * Builds the pre-prompt: the replacement when given, else the default with extra instructions.
+ *
+ * @param config - The resolved configuration.
+ * @param prepend - Extra instructions for the default pre-prompt.
+ * @param replace - A full replacement for the default pre-prompt.
+ * @returns The pre-prompt.
+ */
 declare function prePrompt(config: GringowConfig, prepend?: string, replace?: string): string;
+/**
+ * Builds the post-prompt: optional [SPECIFIC_INPUTS] block plus the replacement or the default.
+ *
+ * @param config - The resolved configuration.
+ * @param prepend - Text wrapped in a [SPECIFIC_INPUTS] block.
+ * @param replace - A full replacement for the default post-prompt.
+ * @returns The post-prompt.
+ */
 declare function postPrompt(config: GringowConfig, prepend?: string, replace?: string): string;
 
 export { awaitedConfig, defaultPostPrompt, defaultPrePrompt, getConfigSource, isLocalConfigFound, loadUserConfig, postPrompt, prePrompt };

package/dist/config.mjs

@@ -1,5 +1,5 @@
 import { cosmiconfig } from 'cosmiconfig';
-import merge from 'lodash.merge';
+import mergeWith from 'lodash.mergewith';
 import { z } from 'zod';
 
 // src/config.ts
@@ -20,9 +20,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
   },
@@ -44,6 +44,7 @@ var llmProviderSchema = z.enum([
   "azure",
   "meta"
 ]);
+var keylessProviders = ["ollama", "lmstudio"];
 var configSchema = z.object({
   debug: z.boolean().optional(),
   log: z.object({
@@ -75,8 +76,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;
@@ -96,21 +96,14 @@ function isLocalConfigFound() {
 function getConfigSource() {
   return result?.filepath || "default";
 }
+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;
@@ -159,10 +152,7 @@ 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();
+  return [replace ? String(replace) : defaultPrePrompt(config, prepend)].join(" ").trim();
 }
 function postPrompt(config, prepend, replace) {
   return [

package/dist/constants/default-config.mjs

@@ -14,9 +14,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
   },

package/dist/create-cache-id.d.mts

@@ -1,8 +1,8 @@
 /**
- * Creates a stable cache ID for a given text using a deterministic hash
+ * Creates a stable cache ID from the interpolated text.
  *
  * @param text - The text string to create a cache ID for
- * @returns Deterministic hash of the text as a hex string
+ * @returns The `gid_`-prefixed hex hash of the interpolated text
  *
  * @example
  * const id = createCacheId("my text")

package/dist/create-cache-id.mjs

@@ -4,19 +4,19 @@ var MULTIPLIERS = [668265261, 374761393, 2654435769, 2496678331];
 var AVA_MULT1 = 2146121005;
 var AVA_MULT2 = 2221713035;
 function seedState(input) {
-  const state = [...INITIAL_STATE];
+  let [h1, h2, h3, h4] = INITIAL_STATE;
   for (const char of input) {
     const codePoint = char.codePointAt(0) ?? 0;
-    for (let i = 0; i < state.length; i++) {
-      state[i] = Math.imul(state[i] ^ codePoint, MULTIPLIERS[i]);
-      state[i] = rotateLeft(state[i], (i + 1) * 3);
-    }
-    state[0] ^= state[3] >>> 11;
-    state[1] ^= state[0] << 7;
-    state[2] ^= state[1] >>> 13;
-    state[3] ^= state[2] << 5;
+    h1 = rotateLeft(Math.imul(h1 ^ codePoint, MULTIPLIERS[0]), 3);
+    h2 = rotateLeft(Math.imul(h2 ^ codePoint, MULTIPLIERS[1]), 6);
+    h3 = rotateLeft(Math.imul(h3 ^ codePoint, MULTIPLIERS[2]), 9);
+    h4 = rotateLeft(Math.imul(h4 ^ codePoint, MULTIPLIERS[3]), 12);
+    h1 ^= h4 >>> 11;
+    h2 ^= h1 << 7;
+    h3 ^= h2 >>> 13;
+    h4 ^= h3 << 5;
   }
-  return state;
+  return [h1, h2, h3, h4];
 }
 function rotateLeft(value, shift) {
   return value << shift | value >>> 32 - shift;
@@ -45,29 +45,30 @@ function md5(input) {
 }
 
 // src/interpolate-template.ts
+function formatValue(value, index) {
+  return value === null || value === void 0 ? `\${${index}}` : String(value);
+}
 function ifArray(template, givenValues) {
-  const strings = [...template.raw];
-  return strings.reduce((acc, item, index) => {
-    acc += String(item ?? "");
-    if (index < strings.length - 1) {
-      acc += `\${${index}}`;
-    }
-    return acc;
-  }, "");
+  const strings = template.raw;
+  let output = String(strings[0] ?? "");
+  for (let index = 1; index < strings.length; index++) {
+    output += formatValue(givenValues?.[index - 1], index - 1);
+    output += String(strings[index] ?? "");
+  }
+  return output;
 }
 function ifString(template, givenValues) {
   if (template?.indexOf("${") === -1) return template;
   let valueIndex = 0;
   return template.replace(/\$\{[^}]*\}/g, () => {
-    const value = givenValues?.[valueIndex];
-    const output = value === null || value === void 0 ? `\${${valueIndex}}` : String(value);
+    const output = formatValue(givenValues?.[valueIndex], valueIndex);
     valueIndex++;
     return output;
   });
 }
 function interpolateTemplate(template, givenValues) {
   if (typeof template === "string") return ifString(template, givenValues);
-  if (Array.isArray(template)) return ifArray(template);
+  if (Array.isArray(template)) return ifArray(template, givenValues);
   throw new Error("Template must be a string or TemplateStringsArray");
 }
 

package/dist/data/cache-file-path.d.mts

@@ -0,0 +1,13 @@
+import { GringowConfig } from '../constants/default-config.mjs';
+import 'zod';
+import '../schemas/config.shcema.mjs';
+
+/**
+ * Builds the cache file path from the configured cache directory and file name.
+ *
+ * @param config - The resolved configuration.
+ * @returns The cache file path.
+ */
+declare function cacheFilePath(config: GringowConfig): string;
+
+export { cacheFilePath };

package/dist/data/cache-file-path.mjs

@@ -0,0 +1,6 @@
+// src/data/cache-file-path.ts
+function cacheFilePath(config) {
+  return `${config.cache.dir}/${config.cache.file}`;
+}
+
+export { cacheFilePath };

package/dist/data/cache-queue.d.mts

@@ -0,0 +1,35 @@
+import { GringowCache } from '../types/index.mjs';
+import 'zod';
+import '../schemas/config.shcema.mjs';
+
+/**
+ * Runs a cache task after every task queued before it.
+ * A failed task rejects only its own caller; the queue keeps running.
+ *
+ * @param task - The task to run inside the queue.
+ * @returns The task result.
+ */
+declare function enqueueCacheTask<T>(task: () => Promise<T>): Promise<T>;
+/**
+ * Writes the whole cache to disk. Call it only inside a queued task.
+ *
+ * @param cache - The cache to write.
+ */
+declare function writeCacheFile(cache: GringowCache): Promise<void>;
+/**
+ * Parses raw cache contents. Invalid JSON logs a warning and becomes an empty cache,
+ * so the next write replaces the corrupted file with valid JSON.
+ *
+ * @param rawCache - The raw cache file contents.
+ * @returns The parsed cache, or an empty cache.
+ */
+declare function parseCacheOrEmpty(rawCache: string): Promise<GringowCache>;
+/**
+ * Reads the cache from disk, or an empty cache when the file does not exist or has invalid JSON.
+ * Call it only inside a queued task.
+ *
+ * @returns The parsed cache.
+ */
+declare function readCacheOrEmpty(): Promise<GringowCache>;
+
+export { enqueueCacheTask, parseCacheOrEmpty, readCacheOrEmpty, writeCacheFile };