i18n-ai-translate/build/constants.js

AI-powered localization CLI, Node library, and GitHub Action. Translate i18next JSON, Gettext PO, Java .properties, and iOS .strings with ChatGPT, Claude, Gemini, or local Ollama models.

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.CLI_HELP = exports.DEFAULT_CONCURRENCY = exports.RETRY_ATTEMPTS = exports.DEFAULT_MODEL = exports.FLATTEN_DELIMITER = exports.DEFAULT_TEMPLATED_STRING_SUFFIX = exports.DEFAULT_TEMPLATED_STRING_PREFIX = exports.VERSION = exports.DEFAULT_REQUEST_TOKENS = exports.DEFAULT_BATCH_SIZE = void 0;
const override_prompt_1 = require("./interfaces/override_prompt");
const package_json_1 = require("../package.json");
const engine_1 = __importDefault(require("./enums/engine"));
exports.DEFAULT_BATCH_SIZE = 32;
exports.DEFAULT_REQUEST_TOKENS = 4096;
exports.VERSION = package_json_1.version;
exports.DEFAULT_TEMPLATED_STRING_PREFIX = "{{";
exports.DEFAULT_TEMPLATED_STRING_SUFFIX = "}}";
exports.FLATTEN_DELIMITER = "*";
exports.DEFAULT_MODEL = {
    [engine_1.default.ChatGPT]: "gpt-5.2",
    [engine_1.default.Gemini]: "gemini-2.5-flash",
    [engine_1.default.Ollama]: "llama3.3",
    [engine_1.default.Claude]: "claude-sonnet-4-6",
};
// 5 attempts with exponential backoff (1s, 2s, 4s, 8s, 16s base +
// jitter) gives ~30s of wall-clock retrying before a batch gives up,
// which is enough to ride out transient 429s without burning an hour
// on a genuinely bad key.
exports.RETRY_ATTEMPTS = 5;
exports.DEFAULT_CONCURRENCY = 2;
exports.CLI_HELP = {
    BatchSize: "How many keys to process at a time, 32 by default for chatgpt, 16 otherwise",
    Cache: "Reuse a translation memory across runs to skip re-translating unchanged strings. Optionally takes a path (default: .i18n-ai-translate-cache.json). Keyed by source text + languages + context, independent of engine/model",
    Concurrency: "How many batches to run in parallel (default: 2). Each worker holds its own chat history, sharing one rate limiter. Tune upward together with --rate-limit-ms to use more of your API tier",
    Context: "Product or domain context to steer translations (e.g. 'a music trivia game for Discord'). Injected into both the generation and verification prompts",
    DryRun: "Show the translations without writing to files, and store them in a temporary directory",
    Engine: "Engine to use (chatgpt, gemini, ollama, or claude)",
    EnsureChangedTranslation: "Each generated translation key must differ from the input (for keys longer than 4)",
    ExcludeLanguages: "Language codes to skip (e.g. 'fr de'). Useful when some locales are maintained manually and shouldn't be machine-translated over",
    FileFormat: "Input/output file format (default: inferred from extension). Supported: json, po, properties, strings.",
    Glossary: "Path to a glossary JSON file steering terminology: { \"doNotTranslate\": [\"Acme\"], \"terms\": { \"fr\": { \"Account\": \"Compte\" } } }. Injected into the generation and verification prompts",
    LanguageConcurrency: "How many target languages to translate in parallel (default 1). Each language shares the same pool and rate limiter, so raising this does not multiply provider traffic — pair with --concurrency and --tokens-per-minute to tune overall throughput.",
    MaxTokens: "The maximum token size of a request",
    Model: `Model to use (e.g. ${Object.values(exports.DEFAULT_MODEL).join(", ")})`,
    NoContinueOnError: "Abort the run when a key or batch exhausts retries (default: continue and report skipped keys to stderr)",
    OllamaHost: "The host and port number serving Ollama. 11434 is the default port number.",
    OverridePromptFile: `Use the prompts from the given JSON file, containing keys for at least one of ${override_prompt_1.OVERRIDE_PROMPT_KEYS.join(", ")}`,
    PromptMode: "Chose the prompting mode, between 'csv' mode (better performance but will only work with advanced models like GPT-4o) or 'json' mode (compatible with less advanced models, like llama3.1:8b, but translations take 50% longer on average)",
    RateLimit: "How many milliseconds between requests (defaults to 1s for Gemini, 120ms (at 500RPM) for ChatGPT, 1200ms for Claude)",
    SkipStylingVerification: "Skip validating the resulting translation's formatting through another query, only for 'csv' mode",
    SkipTranslationVerification: "Skip validating the resulting translation through another query",
    TokensPerMinute: "Cap on tokens-per-minute across all concurrent workers. Disabled by default — opt in with your provider's TPM limit to avoid burst-failing when your TPM tier is stricter than your RPM tier. Reference values: OpenAI Tier-1 ~200000, Anthropic Tier-1 40000 (free 20000), Gemini 2.5 Flash paid ~250000.",
    Verbose: "Print logs about progress",
};
//# sourceMappingURL=constants.js.map