@lingo.dev/_compiler 0.1.12 → 0.2.0

package/build/index.cjs

@@ -4,7 +4,7 @@ var _unplugin = require('unplugin');
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.1.12",
+  version: "0.2.0",
   description: "Lingo.dev Compiler",
   private: false,
   publishConfig: {
@@ -40,6 +40,7 @@ var package_default = {
     typescript: "^5.4.5"
   },
   dependencies: {
+    "@ai-sdk/google": "^1.2.19",
     "@ai-sdk/groq": "^1.2.3",
     "@babel/generator": "^7.26.5",
     "@babel/parser": "^7.26.7",
@@ -449,6 +450,9 @@ function getJsxScopes(node) {
   const result = [];
   _traverse2.default.call(void 0, node, {
     JSXElement(path6) {
+      if (getJsxElementName(path6) === "LingoProvider") {
+        return;
+      }
       const hasNonEmptyTextSiblings = path6.getAllPrevSiblings().concat(path6.getAllNextSiblings()).some(
         (sibling) => t7.isJSXText(sibling.node) && _optionalChain([sibling, 'access', _16 => _16.node, 'access', _17 => _17.value, 'optionalAccess', _18 => _18.trim, 'call', _19 => _19()]) !== ""
       );
@@ -916,6 +920,7 @@ var LCPCache = class {
 
 // src/lib/lcp/api/index.ts
 var _groq = require('@ai-sdk/groq');
+var _google = require('@ai-sdk/google');
 var _ai = require('ai');
 
 
@@ -1147,21 +1152,36 @@ function getRc() {
   return data;
 }
 
-// src/utils/groq.ts
+// src/utils/llm-api-key.ts
 
 var _dotenv = require('dotenv'); var dotenv = _interopRequireWildcard(_dotenv);
+function getKeyFromEnv(envVarName) {
+  const ephemeralEnv = {};
+  dotenv.config({ processEnv: ephemeralEnv });
+  return ephemeralEnv[envVarName];
+}
+function getKeyFromRc(rcPath) {
+  const rc = getRc();
+  const result = _lodash2.default.get(rc, rcPath);
+  return typeof result === "string" ? result : void 0;
+}
 function getGroqKey() {
   return getGroqKeyFromEnv() || getGroqKeyFromRc();
 }
 function getGroqKeyFromRc() {
-  const rc = getRc();
-  const result = _lodash2.default.get(rc, "llm.groqApiKey");
-  return result;
+  return getKeyFromRc("llm.groqApiKey");
 }
 function getGroqKeyFromEnv() {
-  const ephemeralEnv = {};
-  dotenv.config({ processEnv: ephemeralEnv });
-  return ephemeralEnv.GROQ_API_KEY;
+  return getKeyFromEnv("GROQ_API_KEY");
+}
+function getGoogleKey() {
+  return getGoogleKeyFromEnv() || getGoogleKeyFromRc();
+}
+function getGoogleKeyFromRc() {
+  return getKeyFromRc("llm.googleApiKey");
+}
+function getGoogleKeyFromEnv() {
+  return getKeyFromEnv("GOOGLE_API_KEY");
 }
 
 // src/lib/lcp/api/index.ts
@@ -1173,6 +1193,24 @@ function isRunningInCIOrDocker() {
   return Boolean(process.env.CI) || fs.default.existsSync("/.dockerenv");
 }
 
+// src/lib/lcp/api/provider-details.ts
+var providerDetails = {
+  groq: {
+    name: "Groq",
+    apiKeyEnvVar: "GROQ_API_KEY",
+    apiKeyConfigKey: "llm.groqApiKey",
+    getKeyLink: "https://groq.com",
+    docsLink: "https://console.groq.com/docs/errors"
+  },
+  google: {
+    name: "Google",
+    apiKeyEnvVar: "GOOGLE_API_KEY",
+    apiKeyConfigKey: "llm.googleApiKey",
+    getKeyLink: "https://ai.google.dev/",
+    docsLink: "https://ai.google.dev/gemini-api/docs/troubleshooting"
+  }
+};
+
 // src/lib/lcp/api/index.ts
 var LCPAPI = class {
   static async translate(models, sourceDictionary, sourceLocale, targetLocale) {
@@ -1257,114 +1295,207 @@ var LCPAPI = class {
     return dictionary;
   }
   static async _translateChunk(models, sourceDictionary, sourceLocale, targetLocale) {
-    try {
-      return await this._translateChunkGroq(
-        models,
-        sourceDictionary,
-        sourceLocale,
-        targetLocale
-      );
-    } catch (e) {
-      console.error(`\u26A0\uFE0F  Translation for ${targetLocale} failed:`, e);
-      return {
-        version: 0.1,
-        locale: targetLocale,
-        files: {}
-      };
-    }
-    if (isRunningInCIOrDocker()) {
-      const groqFromEnv = getGroqKeyFromEnv();
-      if (!groqFromEnv) {
-        this._failMissingGroqKeyCi();
-      }
-    }
-    throw new Error(
-      "\u26A0\uFE0F  No API key found. Please set GROQ_API_KEY environment variable. If you dont have one go to https://groq.com/"
-    );
-  }
-  static async _translateChunkGroq(models, sourceDictionary, sourceLocale, targetLocale) {
-    const groq = _groq.createGroq.call(void 0, { apiKey: getGroqKey() });
-    console.log(`Created Groq client for ${targetLocale}`);
     const { provider, model } = getLocaleModel(
       models,
       sourceLocale,
       targetLocale
     );
-    if (!model) {
+    if (!provider || !model) {
       throw new Error(
-        `\u26A0\uFE0F  Locale ${targetLocale} is not configured. Add model for this locale to your config.`
+        `\u26A0\uFE0F  Locale "${targetLocale}" is not configured. Add provider and model for this locale to your config, e.g., "groq:llama3-8b-8192".`
       );
     }
-    if (provider !== "groq") {
-      throw new Error(
-        `\u26A0\uFE0F  Provider ${provider} is not supported. Only "groq" provider is supported at the moment.`
+    try {
+      const aiModel = this._createAiModel(provider, model, targetLocale);
+      console.log(
+        `\u2728 Using model "${model}" from "${provider}" to translate from "${sourceLocale}" to "${targetLocale}"`
       );
-    }
-    console.log(
-      `\u2728 Using model "${model}" from "${provider}" to translate from "${sourceLocale}" to "${targetLocale}"`
-    );
-    const groqModel = groq(model);
-    console.log(`Created model ${model}`);
-    const response = await _ai.generateText.call(void 0, {
-      model: groqModel,
-      messages: [
-        {
-          role: "system",
-          content: prompt_default({ sourceLocale, targetLocale })
-        },
-        ...shots_default.flatMap((shotsTuple) => [
+      const response = await _ai.generateText.call(void 0, {
+        model: aiModel,
+        messages: [
           {
-            role: "user",
-            content: obj2xml(shotsTuple[0])
+            role: "system",
+            content: prompt_default({ sourceLocale, targetLocale })
           },
+          ...shots_default.flatMap((shotsTuple) => [
+            {
+              role: "user",
+              content: obj2xml(shotsTuple[0])
+            },
+            {
+              role: "assistant",
+              content: obj2xml(shotsTuple[1])
+            }
+          ]),
           {
-            role: "assistant",
-            content: obj2xml(shotsTuple[1])
+            role: "user",
+            content: obj2xml(sourceDictionary)
+          }
+        ]
+      });
+      console.log("Response text received for", targetLocale);
+      let responseText = response.text;
+      responseText = responseText.substring(
+        responseText.indexOf("<"),
+        responseText.lastIndexOf(">") + 1
+      );
+      return xml2obj(responseText);
+    } catch (error) {
+      this._failLLMFailureLocal(
+        provider,
+        targetLocale,
+        error instanceof Error ? error.message : "Unknown error"
+      );
+      throw error;
+    }
+  }
+  /**
+   * Instantiates an AI model based on provider and model ID.
+   * Includes CI/CD API key checks.
+   * @param providerId The ID of the AI provider (e.g., "groq", "google").
+   * @param modelId The ID of the specific model (e.g., "llama3-8b-8192", "gemini-2.0-flash").
+   * @param targetLocale The target locale being translated to (for logging/error messages).
+   * @returns An instantiated AI LanguageModel.
+   * @throws Error if the provider is not supported or API key is missing in CI/CD.
+   */
+  static _createAiModel(providerId, modelId, targetLocale) {
+    switch (providerId) {
+      case "groq":
+        if (isRunningInCIOrDocker()) {
+          const groqFromEnv = getGroqKeyFromEnv();
+          if (!groqFromEnv) {
+            this._failMissingLLMKeyCi(providerId);
           }
-        ]),
-        {
-          role: "user",
-          content: obj2xml(sourceDictionary)
         }
-      ]
-    });
-    console.log("Response", response.text);
-    let responseText = response.text;
-    responseText = responseText.substring(
-      responseText.indexOf("<"),
-      responseText.lastIndexOf(">") + 1
-    );
-    return xml2obj(responseText);
+        const groqKey = getGroqKey();
+        if (!groqKey) {
+          throw new Error(
+            "\u26A0\uFE0F  GROQ API key not found. Please set GROQ_API_KEY environment variable or configure it user-wide."
+          );
+        }
+        console.log(
+          `Creating Groq client for ${targetLocale} using model ${modelId}`
+        );
+        return _groq.createGroq.call(void 0, { apiKey: groqKey })(modelId);
+      case "google":
+        if (isRunningInCIOrDocker()) {
+          const googleFromEnv = getGoogleKeyFromEnv();
+          if (!googleFromEnv) {
+            this._failMissingLLMKeyCi(providerId);
+          }
+        }
+        const googleKey = getGoogleKey();
+        if (!googleKey) {
+          throw new Error(
+            "\u26A0\uFE0F  Google API key not found. Please set GOOGLE_API_KEY environment variable or configure it user-wide."
+          );
+        }
+        console.log(
+          `Creating Google Generative AI client for ${targetLocale} using model ${modelId}`
+        );
+        return _google.createGoogleGenerativeAI.call(void 0, { apiKey: googleKey })(modelId);
+      default:
+        throw new Error(
+          `\u26A0\uFE0F  Provider "${providerId}" for locale "${targetLocale}" is not supported. Only "groq" and "google" providers are supported at the moment.`
+        );
+    }
   }
   /**
    * Show an actionable error message and exit the process when the compiler
-   * is running in CI/CD without a GROQ API key.
+   * is running in CI/CD without a required LLM API key.
    * The message explains why this situation is unusual and how to fix it.
+   * @param providerId The ID of the LLM provider whose key is missing.
    */
-  static _failMissingGroqKeyCi() {
+  static _failMissingLLMKeyCi(providerId) {
+    let details = providerDetails[providerId];
+    if (!details) {
+      console.error(
+        `Internal Error: Missing details for provider "${providerId}" when reporting missing key in CI/CD. You might be using an unsupported provider.`
+      );
+      process.exit(1);
+    }
     console.log(
       _dedent2.default`
         \n
         💡 You're using Lingo.dev Localization Compiler, and it detected unlocalized components in your app.
 
-        The compiler needs a GROQ API key to translate missing strings, but GROQ_API_KEY is not set in the environment.
+        The compiler needs a ${details.name} API key to translate missing strings, but ${details.apiKeyEnvVar} is not set in the environment.
 
         This is unexpected: typically you run a full build locally, commit the generated translation files, and push them to CI/CD.
 
         However, If you want CI/CD to translate the new strings, provide the key with:
-        • Session-wide: export GROQ_API_KEY=<your-api-key>
-        • Project-wide / CI: add GROQ_API_KEY=<your-api-key> to your pipeline environment variables
+        • Session-wide: export ${details.apiKeyEnvVar}=<your-api-key>
+        • Project-wide / CI: add ${details.apiKeyEnvVar}=<your-api-key> to your pipeline environment variables
 
         ⭐️ Also:
-        1. If you don't yet have a GROQ API key, get one for free at https://groq.com
-        2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
-        3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
+        1. If you don't yet have a ${details.name} API key, get one for free at ${details.getKeyLink}
+        2. If you want to use a different LLM, update your configuration. Refer to documentation for help: https://docs.lingo.dev/
+        3. If the model you want to use isn't supported yet, raise an issue in our open-source repo: https://lingo.dev/go/gh
 
         ✨
       `
     );
     process.exit(1);
   }
+  /**
+   * Show an actionable error message and exit the process when an LLM API call
+   * fails during local compilation.
+   * @param providerId The ID of the LLM provider that failed.
+   * @param targetLocale The target locale being translated to.
+   * @param errorMessage The error message received from the API.
+   */
+  static _failLLMFailureLocal(providerId, targetLocale, errorMessage) {
+    const details = providerDetails[providerId];
+    if (!details) {
+      console.error(
+        `Internal Error: Missing details for provider "${providerId}" when reporting local failure.`
+      );
+      console.error(`Original Error: ${errorMessage}`);
+      process.exit(1);
+    }
+    const isInvalidApiKey = errorMessage.match("Invalid API Key");
+    if (isInvalidApiKey) {
+      console.log(_dedent2.default`
+          \n
+          ⚠️  Lingo.dev Compiler requires a valid ${details.name} API key to translate your application.
+
+          It looks like you set ${details.name} API key but it is not valid. Please check your API key and try again.
+
+          Error details from ${details.name} API: ${errorMessage}
+
+          👉 You can set the API key in one of the following ways:
+          1. User-wide: Run npx lingo.dev@latest config set ${details.apiKeyConfigKey} <your-api-key>
+          2. Project-wide: Add ${details.apiKeyEnvVar}=<your-api-key> to .env file in every project that uses Lingo.dev Localization Compiler
+          3 Session-wide: Run export ${details.apiKeyEnvVar}=<your-api-key> in your terminal before running the compiler to set the API key for the current session
+
+          ⭐️ Also:
+          1. If you don't yet have a ${details.name} API key, get one for free at ${details.getKeyLink}
+          2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
+          3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
+
+          ✨
+        `);
+    } else {
+      console.log(
+        _dedent2.default`
+        \n
+        ⚠️  Lingo.dev Compiler tried to translate your application to "${targetLocale}" locale via ${details.name} but it failed.
+
+        Error details from ${details.name} API: ${errorMessage}
+
+        This error comes from the ${details.name} API, please check their documentation for more details: ${details.docsLink}
+
+        ⭐️ Also:
+        1. Did you set ${details.apiKeyEnvVar} environment variable correctly?
+        2. Did you reach any limits of your ${details.name} account?
+        3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
+
+        ✨
+      `
+      );
+    }
+    process.exit(1);
+  }
 };
 
 // src/lib/lcp/server.ts
@@ -2339,13 +2470,23 @@ var clientDictionaryLoaderMutation = createCodeMutation((payload) => {
 });
 
 // src/index.ts
+var keyCheckers = {
+  groq: {
+    checkEnv: getGroqKeyFromEnv,
+    checkRc: getGroqKeyFromRc
+  },
+  google: {
+    checkEnv: getGoogleKeyFromEnv,
+    checkRc: getGoogleKeyFromRc
+  }
+};
 var unplugin = _unplugin.createUnplugin.call(void 0, 
   (_params, _meta) => {
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
+    const params = _lodash2.default.defaults(_params, defaultParams);
     if (!isRunningInCIOrDocker()) {
-      validateGroqKeyDetails();
+      validateLLMKeyDetails(params.models);
     }
-    const params = _lodash2.default.defaults(_params, defaultParams);
     const invalidLocales = getInvalidLocales(
       params.models,
       params.sourceLocale,
@@ -2360,7 +2501,7 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
         1. Refer to documentation for help: https://docs.lingo.dev/
         2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
         3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
-  
+
         ✨
       `);
       process.exit(1);
@@ -2459,56 +2600,81 @@ var src_default = {
     return config2;
   }
 };
-function validateGroqKeyDetails() {
-  const groq = {
-    fromEnv: getGroqKeyFromEnv(),
-    fromRc: getGroqKeyFromRc()
-  };
-  if (!groq.fromEnv && !groq.fromRc) {
+function validateLLMKeyDetails(models) {
+  const configuredProviders = _lodash2.default.chain(Object.values(models)).map((modelString) => modelString.split(":")[0]).filter(Boolean).uniq().filter(
+    (providerId) => providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
+  ).value();
+  if (configuredProviders.length === 0) {
+    return;
+  }
+  const keyStatuses = {};
+  const missingProviders = [];
+  const foundProviders = [];
+  for (const providerId of configuredProviders) {
+    const details = providerDetails[providerId];
+    const checkers = keyCheckers[providerId];
+    if (!details || !checkers) continue;
+    const foundInEnv = checkers.checkEnv() !== void 0;
+    const foundInRc = checkers.checkRc() !== void 0;
+    keyStatuses[providerId] = { foundInEnv, foundInRc, details };
+    if (!foundInEnv && !foundInRc) {
+      missingProviders.push(providerId);
+    } else {
+      foundProviders.push(providerId);
+    }
+  }
+  if (missingProviders.length > 0) {
     console.log(_dedent2.default`
       \n
-      💡 You're using Lingo.dev Localization Compiler in your project, which requires a GROQ API key to work.
+      💡 Lingo.dev Localization Compiler is configured to use the following LLM provider(s): ${configuredProviders.join(", ")}.
 
-      👉 You can set the API key in one of the following ways:
-      1. User-wide: Run npx lingo.dev@latest config set llm.groqApiKey <your-api-key>
-      2. Project-wide: Add GROQ_API_KEY=<your-api-key> to .env file in every project that uses Lingo.dev Localization Compiler
-      3. Session-wide: Run export GROQ_API_KEY=<your-api-key> in your terminal before running the compiler to set the API key for the current session
+      The compiler requires API keys for these providers to work, but the following keys are missing:
+    `);
+    for (const providerId of missingProviders) {
+      const status = keyStatuses[providerId];
+      if (!status) continue;
+      console.log(_dedent2.default`
+          ⚠️  ${status.details.name} API key is missing. Set ${status.details.apiKeyEnvVar} environment variable.
 
+          👉 You can set the API key in one of the following ways:
+          1. User-wide: Run npx lingo.dev@latest config set ${status.details.apiKeyConfigKey || "<config-key-not-available>"} <your-api-key>
+          2. Project-wide: Add ${status.details.apiKeyEnvVar}=<your-api-key> to .env file in every project that uses Lingo.dev Localization Compiler
+          3. Session-wide: Run export ${status.details.apiKeyEnvVar}=<your-api-key> in your terminal before running the compiler to set the API key for the current session
+
+          ⭐️ If you don't yet have a ${status.details.name} API key, get one for free at ${status.details.getKeyLink}
+        `);
+    }
+    console.log(_dedent2.default`
+      \n
       ⭐️ Also:
-      1. If you don't yet have a GROQ API key, get one for free at https://groq.com
-      2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
+      1. If you want to use a different LLM, update your configuration. Refer to documentation for help: https://docs.lingo.dev/
+      2. If the model/provider you want to use isn't supported yet, raise an issue in our open-source repo: https://lingo.dev/go/gh
       3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
 
       ✨
     `);
     process.exit(1);
-  } else if (groq.fromEnv && groq.fromRc) {
-    console.log(
-      _dedent2.default`
-        🔑  GROQ API key detected in both environment variables and your user-wide configuration.
-
-        👉  The compiler will use the key from the environment because it has higher priority.
-
-        • To update the user-wide key run: npx lingo.dev@latest config set llm.groqApiKey <your-api-key>
-        • To remove it run: npx lingo.dev@latest config unset llm.groqApiKey
-        • To remove the env variable from the current session run: unset GROQ_API_KEY
-      `
-    );
-  } else if (groq.fromEnv && !groq.fromRc) {
-    console.log(
-      _dedent2.default`
-        🔑  GROQ API key loaded from environment variables.
-
-        • You can also save the key user-wide with: npx lingo.dev@latest config set llm.groqApiKey <your-api-key>
-        • Or remove the env variable from the current session with: unset GROQ_API_KEY
-      `
-    );
-  } else if (!groq.fromEnv && groq.fromRc) {
-    console.log(
-      _dedent2.default`
-        🔑  GROQ API key loaded from your user-wide configuration.
-      `
-    );
+  } else if (foundProviders.length > 0) {
+    console.log(_dedent2.default`
+        \n
+        🔑  LLM API keys detected for configured providers: ${foundProviders.join(", ")}.
+      `);
+    for (const providerId of foundProviders) {
+      const status = keyStatuses[providerId];
+      if (!status) continue;
+      let sourceMessage = "";
+      if (status.foundInEnv && status.foundInRc) {
+        sourceMessage = `from both environment variables (${status.details.apiKeyEnvVar}) and your user-wide configuration. The key from the environment will be used because it has higher priority.`;
+      } else if (status.foundInEnv) {
+        sourceMessage = `from environment variables (${status.details.apiKeyEnvVar}).`;
+      } else if (status.foundInRc) {
+        sourceMessage = `from your user-wide configuration${status.details.apiKeyConfigKey ? ` (${status.details.apiKeyConfigKey})` : ""}.`;
+      }
+      console.log(_dedent2.default`
+          • ${status.details.name} API key loaded ${sourceMessage}
+        `);
+    }
+    console.log("\u2728");
   }
 }
 

package/build/index.mjs

@@ -4,7 +4,7 @@ import { createUnplugin } from "unplugin";
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.1.12",
+  version: "0.2.0",
   description: "Lingo.dev Compiler",
   private: false,
   publishConfig: {
@@ -40,6 +40,7 @@ var package_default = {
     typescript: "^5.4.5"
   },
   dependencies: {
+    "@ai-sdk/google": "^1.2.19",
     "@ai-sdk/groq": "^1.2.3",
     "@babel/generator": "^7.26.5",
     "@babel/parser": "^7.26.7",
@@ -449,6 +450,9 @@ function getJsxScopes(node) {
   const result = [];
   traverse4(node, {
     JSXElement(path6) {
+      if (getJsxElementName(path6) === "LingoProvider") {
+        return;
+      }
       const hasNonEmptyTextSiblings = path6.getAllPrevSiblings().concat(path6.getAllNextSiblings()).some(
         (sibling) => t7.isJSXText(sibling.node) && sibling.node.value?.trim() !== ""
       );
@@ -916,6 +920,7 @@ var LCPCache = class {
 
 // src/lib/lcp/api/index.ts
 import { createGroq } from "@ai-sdk/groq";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { generateText } from "ai";
 import _6 from "lodash";
 
@@ -1147,21 +1152,36 @@ function getRc() {
   return data;
 }
 
-// src/utils/groq.ts
+// src/utils/llm-api-key.ts
 import _5 from "lodash";
 import * as dotenv from "dotenv";
+function getKeyFromEnv(envVarName) {
+  const ephemeralEnv = {};
+  dotenv.config({ processEnv: ephemeralEnv });
+  return ephemeralEnv[envVarName];
+}
+function getKeyFromRc(rcPath) {
+  const rc = getRc();
+  const result = _5.get(rc, rcPath);
+  return typeof result === "string" ? result : void 0;
+}
 function getGroqKey() {
   return getGroqKeyFromEnv() || getGroqKeyFromRc();
 }
 function getGroqKeyFromRc() {
-  const rc = getRc();
-  const result = _5.get(rc, "llm.groqApiKey");
-  return result;
+  return getKeyFromRc("llm.groqApiKey");
 }
 function getGroqKeyFromEnv() {
-  const ephemeralEnv = {};
-  dotenv.config({ processEnv: ephemeralEnv });
-  return ephemeralEnv.GROQ_API_KEY;
+  return getKeyFromEnv("GROQ_API_KEY");
+}
+function getGoogleKey() {
+  return getGoogleKeyFromEnv() || getGoogleKeyFromRc();
+}
+function getGoogleKeyFromRc() {
+  return getKeyFromRc("llm.googleApiKey");
+}
+function getGoogleKeyFromEnv() {
+  return getKeyFromEnv("GOOGLE_API_KEY");
 }
 
 // src/lib/lcp/api/index.ts
@@ -1173,6 +1193,24 @@ function isRunningInCIOrDocker() {
   return Boolean(process.env.CI) || fs4.existsSync("/.dockerenv");
 }
 
+// src/lib/lcp/api/provider-details.ts
+var providerDetails = {
+  groq: {
+    name: "Groq",
+    apiKeyEnvVar: "GROQ_API_KEY",
+    apiKeyConfigKey: "llm.groqApiKey",
+    getKeyLink: "https://groq.com",
+    docsLink: "https://console.groq.com/docs/errors"
+  },
+  google: {
+    name: "Google",
+    apiKeyEnvVar: "GOOGLE_API_KEY",
+    apiKeyConfigKey: "llm.googleApiKey",
+    getKeyLink: "https://ai.google.dev/",
+    docsLink: "https://ai.google.dev/gemini-api/docs/troubleshooting"
+  }
+};
+
 // src/lib/lcp/api/index.ts
 var LCPAPI = class {
   static async translate(models, sourceDictionary, sourceLocale, targetLocale) {
@@ -1257,114 +1295,207 @@ var LCPAPI = class {
     return dictionary;
   }
   static async _translateChunk(models, sourceDictionary, sourceLocale, targetLocale) {
-    try {
-      return await this._translateChunkGroq(
-        models,
-        sourceDictionary,
-        sourceLocale,
-        targetLocale
-      );
-    } catch (e) {
-      console.error(`\u26A0\uFE0F  Translation for ${targetLocale} failed:`, e);
-      return {
-        version: 0.1,
-        locale: targetLocale,
-        files: {}
-      };
-    }
-    if (isRunningInCIOrDocker()) {
-      const groqFromEnv = getGroqKeyFromEnv();
-      if (!groqFromEnv) {
-        this._failMissingGroqKeyCi();
-      }
-    }
-    throw new Error(
-      "\u26A0\uFE0F  No API key found. Please set GROQ_API_KEY environment variable. If you dont have one go to https://groq.com/"
-    );
-  }
-  static async _translateChunkGroq(models, sourceDictionary, sourceLocale, targetLocale) {
-    const groq = createGroq({ apiKey: getGroqKey() });
-    console.log(`Created Groq client for ${targetLocale}`);
     const { provider, model } = getLocaleModel(
       models,
       sourceLocale,
       targetLocale
     );
-    if (!model) {
+    if (!provider || !model) {
       throw new Error(
-        `\u26A0\uFE0F  Locale ${targetLocale} is not configured. Add model for this locale to your config.`
+        `\u26A0\uFE0F  Locale "${targetLocale}" is not configured. Add provider and model for this locale to your config, e.g., "groq:llama3-8b-8192".`
       );
     }
-    if (provider !== "groq") {
-      throw new Error(
-        `\u26A0\uFE0F  Provider ${provider} is not supported. Only "groq" provider is supported at the moment.`
+    try {
+      const aiModel = this._createAiModel(provider, model, targetLocale);
+      console.log(
+        `\u2728 Using model "${model}" from "${provider}" to translate from "${sourceLocale}" to "${targetLocale}"`
       );
-    }
-    console.log(
-      `\u2728 Using model "${model}" from "${provider}" to translate from "${sourceLocale}" to "${targetLocale}"`
-    );
-    const groqModel = groq(model);
-    console.log(`Created model ${model}`);
-    const response = await generateText({
-      model: groqModel,
-      messages: [
-        {
-          role: "system",
-          content: prompt_default({ sourceLocale, targetLocale })
-        },
-        ...shots_default.flatMap((shotsTuple) => [
+      const response = await generateText({
+        model: aiModel,
+        messages: [
           {
-            role: "user",
-            content: obj2xml(shotsTuple[0])
+            role: "system",
+            content: prompt_default({ sourceLocale, targetLocale })
           },
+          ...shots_default.flatMap((shotsTuple) => [
+            {
+              role: "user",
+              content: obj2xml(shotsTuple[0])
+            },
+            {
+              role: "assistant",
+              content: obj2xml(shotsTuple[1])
+            }
+          ]),
           {
-            role: "assistant",
-            content: obj2xml(shotsTuple[1])
+            role: "user",
+            content: obj2xml(sourceDictionary)
+          }
+        ]
+      });
+      console.log("Response text received for", targetLocale);
+      let responseText = response.text;
+      responseText = responseText.substring(
+        responseText.indexOf("<"),
+        responseText.lastIndexOf(">") + 1
+      );
+      return xml2obj(responseText);
+    } catch (error) {
+      this._failLLMFailureLocal(
+        provider,
+        targetLocale,
+        error instanceof Error ? error.message : "Unknown error"
+      );
+      throw error;
+    }
+  }
+  /**
+   * Instantiates an AI model based on provider and model ID.
+   * Includes CI/CD API key checks.
+   * @param providerId The ID of the AI provider (e.g., "groq", "google").
+   * @param modelId The ID of the specific model (e.g., "llama3-8b-8192", "gemini-2.0-flash").
+   * @param targetLocale The target locale being translated to (for logging/error messages).
+   * @returns An instantiated AI LanguageModel.
+   * @throws Error if the provider is not supported or API key is missing in CI/CD.
+   */
+  static _createAiModel(providerId, modelId, targetLocale) {
+    switch (providerId) {
+      case "groq":
+        if (isRunningInCIOrDocker()) {
+          const groqFromEnv = getGroqKeyFromEnv();
+          if (!groqFromEnv) {
+            this._failMissingLLMKeyCi(providerId);
           }
-        ]),
-        {
-          role: "user",
-          content: obj2xml(sourceDictionary)
         }
-      ]
-    });
-    console.log("Response", response.text);
-    let responseText = response.text;
-    responseText = responseText.substring(
-      responseText.indexOf("<"),
-      responseText.lastIndexOf(">") + 1
-    );
-    return xml2obj(responseText);
+        const groqKey = getGroqKey();
+        if (!groqKey) {
+          throw new Error(
+            "\u26A0\uFE0F  GROQ API key not found. Please set GROQ_API_KEY environment variable or configure it user-wide."
+          );
+        }
+        console.log(
+          `Creating Groq client for ${targetLocale} using model ${modelId}`
+        );
+        return createGroq({ apiKey: groqKey })(modelId);
+      case "google":
+        if (isRunningInCIOrDocker()) {
+          const googleFromEnv = getGoogleKeyFromEnv();
+          if (!googleFromEnv) {
+            this._failMissingLLMKeyCi(providerId);
+          }
+        }
+        const googleKey = getGoogleKey();
+        if (!googleKey) {
+          throw new Error(
+            "\u26A0\uFE0F  Google API key not found. Please set GOOGLE_API_KEY environment variable or configure it user-wide."
+          );
+        }
+        console.log(
+          `Creating Google Generative AI client for ${targetLocale} using model ${modelId}`
+        );
+        return createGoogleGenerativeAI({ apiKey: googleKey })(modelId);
+      default:
+        throw new Error(
+          `\u26A0\uFE0F  Provider "${providerId}" for locale "${targetLocale}" is not supported. Only "groq" and "google" providers are supported at the moment.`
+        );
+    }
   }
   /**
    * Show an actionable error message and exit the process when the compiler
-   * is running in CI/CD without a GROQ API key.
+   * is running in CI/CD without a required LLM API key.
    * The message explains why this situation is unusual and how to fix it.
+   * @param providerId The ID of the LLM provider whose key is missing.
    */
-  static _failMissingGroqKeyCi() {
+  static _failMissingLLMKeyCi(providerId) {
+    let details = providerDetails[providerId];
+    if (!details) {
+      console.error(
+        `Internal Error: Missing details for provider "${providerId}" when reporting missing key in CI/CD. You might be using an unsupported provider.`
+      );
+      process.exit(1);
+    }
     console.log(
       dedent2`
         \n
         💡 You're using Lingo.dev Localization Compiler, and it detected unlocalized components in your app.
 
-        The compiler needs a GROQ API key to translate missing strings, but GROQ_API_KEY is not set in the environment.
+        The compiler needs a ${details.name} API key to translate missing strings, but ${details.apiKeyEnvVar} is not set in the environment.
 
         This is unexpected: typically you run a full build locally, commit the generated translation files, and push them to CI/CD.
 
         However, If you want CI/CD to translate the new strings, provide the key with:
-        • Session-wide: export GROQ_API_KEY=<your-api-key>
-        • Project-wide / CI: add GROQ_API_KEY=<your-api-key> to your pipeline environment variables
+        • Session-wide: export ${details.apiKeyEnvVar}=<your-api-key>
+        • Project-wide / CI: add ${details.apiKeyEnvVar}=<your-api-key> to your pipeline environment variables
 
         ⭐️ Also:
-        1. If you don't yet have a GROQ API key, get one for free at https://groq.com
-        2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
-        3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
+        1. If you don't yet have a ${details.name} API key, get one for free at ${details.getKeyLink}
+        2. If you want to use a different LLM, update your configuration. Refer to documentation for help: https://docs.lingo.dev/
+        3. If the model you want to use isn't supported yet, raise an issue in our open-source repo: https://lingo.dev/go/gh
 
         ✨
       `
     );
     process.exit(1);
   }
+  /**
+   * Show an actionable error message and exit the process when an LLM API call
+   * fails during local compilation.
+   * @param providerId The ID of the LLM provider that failed.
+   * @param targetLocale The target locale being translated to.
+   * @param errorMessage The error message received from the API.
+   */
+  static _failLLMFailureLocal(providerId, targetLocale, errorMessage) {
+    const details = providerDetails[providerId];
+    if (!details) {
+      console.error(
+        `Internal Error: Missing details for provider "${providerId}" when reporting local failure.`
+      );
+      console.error(`Original Error: ${errorMessage}`);
+      process.exit(1);
+    }
+    const isInvalidApiKey = errorMessage.match("Invalid API Key");
+    if (isInvalidApiKey) {
+      console.log(dedent2`
+          \n
+          ⚠️  Lingo.dev Compiler requires a valid ${details.name} API key to translate your application.
+
+          It looks like you set ${details.name} API key but it is not valid. Please check your API key and try again.
+
+          Error details from ${details.name} API: ${errorMessage}
+
+          👉 You can set the API key in one of the following ways:
+          1. User-wide: Run npx lingo.dev@latest config set ${details.apiKeyConfigKey} <your-api-key>
+          2. Project-wide: Add ${details.apiKeyEnvVar}=<your-api-key> to .env file in every project that uses Lingo.dev Localization Compiler
+          3 Session-wide: Run export ${details.apiKeyEnvVar}=<your-api-key> in your terminal before running the compiler to set the API key for the current session
+
+          ⭐️ Also:
+          1. If you don't yet have a ${details.name} API key, get one for free at ${details.getKeyLink}
+          2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
+          3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
+
+          ✨
+        `);
+    } else {
+      console.log(
+        dedent2`
+        \n
+        ⚠️  Lingo.dev Compiler tried to translate your application to "${targetLocale}" locale via ${details.name} but it failed.
+
+        Error details from ${details.name} API: ${errorMessage}
+
+        This error comes from the ${details.name} API, please check their documentation for more details: ${details.docsLink}
+
+        ⭐️ Also:
+        1. Did you set ${details.apiKeyEnvVar} environment variable correctly?
+        2. Did you reach any limits of your ${details.name} account?
+        3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
+
+        ✨
+      `
+      );
+    }
+    process.exit(1);
+  }
 };
 
 // src/lib/lcp/server.ts
@@ -2339,13 +2470,23 @@ var clientDictionaryLoaderMutation = createCodeMutation((payload) => {
 });
 
 // src/index.ts
+var keyCheckers = {
+  groq: {
+    checkEnv: getGroqKeyFromEnv,
+    checkRc: getGroqKeyFromRc
+  },
+  google: {
+    checkEnv: getGoogleKeyFromEnv,
+    checkRc: getGoogleKeyFromRc
+  }
+};
 var unplugin = createUnplugin(
   (_params, _meta) => {
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
+    const params = _11.defaults(_params, defaultParams);
     if (!isRunningInCIOrDocker()) {
-      validateGroqKeyDetails();
+      validateLLMKeyDetails(params.models);
     }
-    const params = _11.defaults(_params, defaultParams);
     const invalidLocales = getInvalidLocales(
       params.models,
       params.sourceLocale,
@@ -2360,7 +2501,7 @@ var unplugin = createUnplugin(
         1. Refer to documentation for help: https://docs.lingo.dev/
         2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
         3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
-  
+
         ✨
       `);
       process.exit(1);
@@ -2459,56 +2600,81 @@ var src_default = {
     return config2;
   }
 };
-function validateGroqKeyDetails() {
-  const groq = {
-    fromEnv: getGroqKeyFromEnv(),
-    fromRc: getGroqKeyFromRc()
-  };
-  if (!groq.fromEnv && !groq.fromRc) {
+function validateLLMKeyDetails(models) {
+  const configuredProviders = _11.chain(Object.values(models)).map((modelString) => modelString.split(":")[0]).filter(Boolean).uniq().filter(
+    (providerId) => providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
+  ).value();
+  if (configuredProviders.length === 0) {
+    return;
+  }
+  const keyStatuses = {};
+  const missingProviders = [];
+  const foundProviders = [];
+  for (const providerId of configuredProviders) {
+    const details = providerDetails[providerId];
+    const checkers = keyCheckers[providerId];
+    if (!details || !checkers) continue;
+    const foundInEnv = checkers.checkEnv() !== void 0;
+    const foundInRc = checkers.checkRc() !== void 0;
+    keyStatuses[providerId] = { foundInEnv, foundInRc, details };
+    if (!foundInEnv && !foundInRc) {
+      missingProviders.push(providerId);
+    } else {
+      foundProviders.push(providerId);
+    }
+  }
+  if (missingProviders.length > 0) {
     console.log(dedent3`
       \n
-      💡 You're using Lingo.dev Localization Compiler in your project, which requires a GROQ API key to work.
+      💡 Lingo.dev Localization Compiler is configured to use the following LLM provider(s): ${configuredProviders.join(", ")}.
 
-      👉 You can set the API key in one of the following ways:
-      1. User-wide: Run npx lingo.dev@latest config set llm.groqApiKey <your-api-key>
-      2. Project-wide: Add GROQ_API_KEY=<your-api-key> to .env file in every project that uses Lingo.dev Localization Compiler
-      3. Session-wide: Run export GROQ_API_KEY=<your-api-key> in your terminal before running the compiler to set the API key for the current session
+      The compiler requires API keys for these providers to work, but the following keys are missing:
+    `);
+    for (const providerId of missingProviders) {
+      const status = keyStatuses[providerId];
+      if (!status) continue;
+      console.log(dedent3`
+          ⚠️  ${status.details.name} API key is missing. Set ${status.details.apiKeyEnvVar} environment variable.
 
+          👉 You can set the API key in one of the following ways:
+          1. User-wide: Run npx lingo.dev@latest config set ${status.details.apiKeyConfigKey || "<config-key-not-available>"} <your-api-key>
+          2. Project-wide: Add ${status.details.apiKeyEnvVar}=<your-api-key> to .env file in every project that uses Lingo.dev Localization Compiler
+          3. Session-wide: Run export ${status.details.apiKeyEnvVar}=<your-api-key> in your terminal before running the compiler to set the API key for the current session
+
+          ⭐️ If you don't yet have a ${status.details.name} API key, get one for free at ${status.details.getKeyLink}
+        `);
+    }
+    console.log(dedent3`
+      \n
       ⭐️ Also:
-      1. If you don't yet have a GROQ API key, get one for free at https://groq.com
-      2. If you want to use a different LLM, raise an issue in our open-source repo: https://lingo.dev/go/gh
+      1. If you want to use a different LLM, update your configuration. Refer to documentation for help: https://docs.lingo.dev/
+      2. If the model/provider you want to use isn't supported yet, raise an issue in our open-source repo: https://lingo.dev/go/gh
       3. If you have questions, feature requests, or would like to contribute, join our Discord: https://lingo.dev/go/discord
 
       ✨
     `);
     process.exit(1);
-  } else if (groq.fromEnv && groq.fromRc) {
-    console.log(
-      dedent3`
-        🔑  GROQ API key detected in both environment variables and your user-wide configuration.
-
-        👉  The compiler will use the key from the environment because it has higher priority.
-
-        • To update the user-wide key run: npx lingo.dev@latest config set llm.groqApiKey <your-api-key>
-        • To remove it run: npx lingo.dev@latest config unset llm.groqApiKey
-        • To remove the env variable from the current session run: unset GROQ_API_KEY
-      `
-    );
-  } else if (groq.fromEnv && !groq.fromRc) {
-    console.log(
-      dedent3`
-        🔑  GROQ API key loaded from environment variables.
-
-        • You can also save the key user-wide with: npx lingo.dev@latest config set llm.groqApiKey <your-api-key>
-        • Or remove the env variable from the current session with: unset GROQ_API_KEY
-      `
-    );
-  } else if (!groq.fromEnv && groq.fromRc) {
-    console.log(
-      dedent3`
-        🔑  GROQ API key loaded from your user-wide configuration.
-      `
-    );
+  } else if (foundProviders.length > 0) {
+    console.log(dedent3`
+        \n
+        🔑  LLM API keys detected for configured providers: ${foundProviders.join(", ")}.
+      `);
+    for (const providerId of foundProviders) {
+      const status = keyStatuses[providerId];
+      if (!status) continue;
+      let sourceMessage = "";
+      if (status.foundInEnv && status.foundInRc) {
+        sourceMessage = `from both environment variables (${status.details.apiKeyEnvVar}) and your user-wide configuration. The key from the environment will be used because it has higher priority.`;
+      } else if (status.foundInEnv) {
+        sourceMessage = `from environment variables (${status.details.apiKeyEnvVar}).`;
+      } else if (status.foundInRc) {
+        sourceMessage = `from your user-wide configuration${status.details.apiKeyConfigKey ? ` (${status.details.apiKeyConfigKey})` : ""}.`;
+      }
+      console.log(dedent3`
+          • ${status.details.name} API key loaded ${sourceMessage}
+        `);
+    }
+    console.log("\u2728");
   }
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_compiler",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Lingo.dev Compiler",
   "private": false,
   "publishConfig": {
@@ -29,6 +29,7 @@
     "typescript": "^5.4.5"
   },
   "dependencies": {
+    "@ai-sdk/google": "^1.2.19",
     "@ai-sdk/groq": "^1.2.3",
     "@babel/generator": "^7.26.5",
     "@babel/parser": "^7.26.7",