msgai-cli 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## 1.0.0 (2026-02-27)
+
+### Features
+
+- handle fuzzy translations with --include-fuzzy ([c4c8784](https://github.com/AlexMost/msgai/commit/c4c8784c361e6d00618b234a3cb5983a40e120b9))
+- handle gettext msgctxt so same msgid in different contexts are not mixed ([9f7ad7a](https://github.com/AlexMost/msgai/commit/9f7ad7a838ef81968a3e235dfd9359e42ee5557a))
+- pass plural samples from getExamples into LLM prompt for plural forms ([70dd125](https://github.com/AlexMost/msgai/commit/70dd125658539e6fbee8417ebfe601bf9ac00145))
+
+### Bug Fixes
+
+- **ci:** use github.event.workflow_run.conclusion in release-please ([0892b17](https://github.com/AlexMost/msgai/commit/0892b17aad1ec95a4e96a8208cb31d197264830f))
+- **ci:** use RELEASE_PLEASE_TOKEN so release-please can create PRs ([204c6cd](https://github.com/AlexMost/msgai/commit/204c6cdf88d480decae841f91c9fae168c4c0ce9))
+- use console.warn instead of console.error for pipeline compatibility ([8b30ebf](https://github.com/AlexMost/msgai/commit/8b30ebffba7c7447db3f51d931398938c39b6b85))
+
+## [Unreleased]
+
+## [1.0.0] - 2025-02-27
+
+### Added
+
+- CLI to translate untranslated strings in gettext (`.po`) files using AI (OpenAI LLM)
+- `msgai <file.po>`: translate empty `msgstr` entries and write back to the file
+- `--dry-run`: list untranslated `msgid` values without API calls or file changes
+- `--source-lang LANG`: specify source language (ISO 639-1); optional, model can infer
+- `--include-fuzzy`: include fuzzy entries for re-translation and clear fuzzy flag
+- `--api-key KEY` and `OPENAI_API_KEY` environment variable for API authentication

package/README.md

@@ -0,0 +1,71 @@
+# msgai
+
+`msgai` is a Node.js CLI that **automatically translates all untranslated strings in gettext (`.po`) files using AI (LLM)**. It reads your `.po` file, detects entries with empty or missing translations, sends them to an LLM (OpenAI), and writes the translations back into the file.
+
+**Install:** `npm install -g msgai-cli` (then run `msgai`).
+
+## Usage
+
+### Commands
+
+- `msgai <file.po>`: translates all untranslated `msgid` / `msgid_plural` entries in the file using AI and updates the `.po` file in place.
+- `msgai <file.po> --dry-run`: only lists untranslated `msgid` values (no API calls, no file changes).
+- `msgai --help`: prints command usage.
+
+### Fuzzy entries
+
+- By default, entries marked as **fuzzy** in the `.po` file (e.g. `#, fuzzy`) are **skipped** and not sent for translation.
+- **`--include-fuzzy`**: include fuzzy entries. They are sent to the LLM with empty `msgstr` (like untranslated strings). After the translation is applied, the fuzzy flag is removed from those entries in the `.po` file.
+
+### Source language
+
+- **`--source-lang LANG`**: source language of `msgid` strings as an ISO 639-1 code (e.g. `en`, `uk`). If omitted, the model will infer the source language. Invalid codes cause the CLI to exit with an error.
+
+### API key (for translation)
+
+When running without `--dry-run`, the CLI needs an OpenAI API key. You can pass it in either of these ways:
+
+- **Environment variable**: set `OPENAI_API_KEY` (e.g. in your shell or a `.env` file in the current directory).
+- **CLI option**: pass `--api-key KEY` (e.g. `msgai messages.po --api-key sk-...`).
+
+If neither is set, the CLI exits with code 1 and a message asking you to set the key.
+
+On API errors (e.g. rate limit, quota, server errors), the CLI shows a status-specific message and exits with code 1. For error code reference, see [OpenAI API error codes](https://developers.openai.com/api/docs/guides/error-codes#api-errors).
+
+## Development environment
+
+### Requirements
+
+- Node.js 20+ (recommended latest LTS)
+- npm 10+
+
+### Setup
+
+```bash
+npm install
+```
+
+### Commit messages
+
+This repo follows [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) for commit messages: use `feat:` for new features, `fix:` for bug fixes, optional scope (e.g. `feat(cli):`), and `BREAKING CHANGE:` or `!` for major changes. This drives version bumps and CHANGELOG updates via release-please.
+
+### Scripts
+
+- `npm run build`: compile TypeScript to `dist/`.
+- `npm test`: build project and run Jest tests.
+- `npm run test:watch`: build project and run Jest in watch mode.
+- `npm run format`: format code with Prettier.
+- `npm run lint:format`: check formatting with Prettier.
+
+## Publishing
+
+Releases are driven by [release-please](https://github.com/googleapis/release-please): it opens a **Release PR** that bumps the version and updates `CHANGELOG.md` from conventional commits. After the Release PR is merged, release-please creates the release tag on `main`.
+
+**Release-please setup:** In the repo go to **Settings → Actions → General → Workflow permissions** and set to **Read and write** and enable **Allow GitHub Actions to create and approve pull requests**. You can then use the default `GITHUB_TOKEN` (no secret). If you see "Error adding to tree" or PR creation blocked, add a Personal Access Token as secret `RELEASE_PLEASE_TOKEN` (classic: `repo` + `workflow` scope; fine-grained: Contents + Pull requests + Workflows write).
+
+**Publishing to npm (local):**
+
+1. Pull `main` with the new release tag.
+2. Run `npm publish`.
+
+Before publishing, `prepublishOnly` runs build, unit tests, integration tests, lint, and format checks. Set `OPENAI_API_KEY` so integration tests pass.

package/dist/src/cli/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs/yargs"));
+const helpers_1 = require("yargs/helpers");
+const runTranslate_1 = require("./runTranslate");
+function parseArgs(argv) {
+    try {
+        const parsedArgs = (0, yargs_1.default)(argv)
+            .scriptName('msgai')
+            .usage('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--include-fuzzy]')
+            .option('dry-run', {
+            type: 'boolean',
+            default: false,
+        })
+            .option('include-fuzzy', {
+            type: 'boolean',
+            default: false,
+            description: 'Include fuzzy entries for translation (re-translate and clear fuzzy flag)',
+        })
+            .option('api-key', {
+            type: 'string',
+            description: 'OpenAI API key (otherwise read from OPENAI_API_KEY env)',
+        })
+            .option('source-lang', {
+            type: 'string',
+            description: 'Source language of msgid strings (ISO 639-1 code, e.g. en, uk). If omitted, the model will detect it.',
+        })
+            .option('help', {
+            alias: 'h',
+            type: 'boolean',
+            default: false,
+        })
+            .strictOptions()
+            .version(false)
+            .exitProcess(false)
+            .fail((message, error) => {
+            if (error) {
+                throw error;
+            }
+            throw new Error(message);
+        })
+            .parseSync();
+        const positionalArgs = parsedArgs._.map(String);
+        const sourceLangRaw = parsedArgs['source-lang'];
+        const sourceLang = sourceLangRaw != null && String(sourceLangRaw).trim() !== ''
+            ? String(sourceLangRaw).trim().toLowerCase()
+            : undefined;
+        if (positionalArgs.length > 1) {
+            return {
+                dryRun: Boolean(parsedArgs['dry-run']),
+                help: Boolean(parsedArgs.help),
+                apiKey: parsedArgs['api-key'],
+                sourceLang,
+                includeFuzzy: Boolean(parsedArgs['include-fuzzy']),
+                error: `Unexpected argument: ${positionalArgs[1]}`,
+            };
+        }
+        return {
+            poFilePath: positionalArgs[0],
+            dryRun: Boolean(parsedArgs['dry-run']),
+            help: Boolean(parsedArgs.help),
+            apiKey: parsedArgs['api-key'],
+            sourceLang,
+            includeFuzzy: Boolean(parsedArgs['include-fuzzy']),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { dryRun: false, help: false, error: message };
+    }
+}
+const USAGE = 'Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--include-fuzzy]';
+function main(argv) {
+    const args = parseArgs(argv);
+    if (args.error) {
+        console.warn(args.error);
+        console.warn(USAGE);
+        return 1;
+    }
+    if (args.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    const result = (0, runTranslate_1.runTranslateCommand)({
+        poFilePath: args.poFilePath,
+        dryRun: args.dryRun,
+        apiKey: args.apiKey,
+        sourceLang: args.sourceLang,
+        includeFuzzy: args.includeFuzzy,
+    });
+    if (result instanceof Promise) {
+        result.then((code) => process.exit(code));
+        return undefined;
+    }
+    return result;
+}
+const exitCode = main((0, helpers_1.hideBin)(process.argv));
+if (typeof exitCode === 'number') {
+    process.exit(exitCode);
+}

package/dist/src/cli/runTranslate.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTranslate = runTranslate;
+exports.runTranslateCommand = runTranslateCommand;
+const node_fs_1 = __importDefault(require("node:fs"));
+const plural_forms_1 = require("plural-forms");
+const po_1 = require("../po");
+const translate_1 = require("../translate");
+const validate_source_lang_1 = require("../validate-source-lang");
+const TRANSLATE_BATCH_SIZE = 15;
+function isApiError(err) {
+    return (err != null &&
+        typeof err === 'object' &&
+        'status' in err &&
+        typeof err.status === 'number');
+}
+function getApiErrorMessage(err) {
+    if (!isApiError(err))
+        return null;
+    const status = err.status;
+    const code = err.code;
+    const message = (err.message ?? '');
+    switch (status) {
+        case 401:
+            return `Invalid or missing API key. Set OPENAI_API_KEY or use --api-key. Check key at https://platform.openai.com/settings/organization/api-keys`;
+        case 403:
+            return `API not available in your country/region. See https://developers.openai.com/api/docs/supported-countries`;
+        case 429:
+            if (code === 'insufficient_quota' || /quota/i.test(message)) {
+                return `Quota exceeded (out of credits or usage limit). Check plan and billing: https://platform.openai.com/settings/organization/billing`;
+            }
+            return `Rate limit reached. Request was retried; if this persists, slow down or check https://developers.openai.com/api/docs/guides/rate-limits`;
+        case 500:
+            return `OpenAI server error. Retry later; see https://status.openai.com/`;
+        case 503:
+            return `OpenAI overloaded. Retry after a short wait.`;
+        default:
+            return null;
+    }
+}
+async function runTranslate(poFilePath, apiKey, sourceLang, includeFuzzy) {
+    try {
+        const poContent = node_fs_1.default.readFileSync(poFilePath, 'utf8');
+        const parsedPo = (0, po_1.parsePoContent)(poContent);
+        const { entries, keys } = (0, po_1.getEntriesToTranslate)(parsedPo, { includeFuzzy });
+        if (entries.length === 0) {
+            console.log(`Nothing to translate in ${poFilePath}.`);
+            return 0;
+        }
+        const targetLanguage = (0, po_1.getLanguage)(parsedPo) ?? 'en';
+        const formula = (0, po_1.getPluralForms)(parsedPo) ?? '';
+        const normalizedTarget = (targetLanguage ?? '').trim().split(/\s/)[0] ?? '';
+        let pluralSamples;
+        if (normalizedTarget) {
+            try {
+                pluralSamples = (0, plural_forms_1.getExamples)(normalizedTarget);
+            }
+            catch {
+                // locale not in plural-forms; rely on formula only
+            }
+        }
+        const options = { apiKey, sourceLanguage: sourceLang, formula, pluralSamples };
+        const allResults = [];
+        for (let i = 0; i < entries.length; i += TRANSLATE_BATCH_SIZE) {
+            const batch = entries.slice(i, i + TRANSLATE_BATCH_SIZE);
+            const batchNum = Math.floor(i / TRANSLATE_BATCH_SIZE) + 1;
+            const totalBatches = Math.ceil(entries.length / TRANSLATE_BATCH_SIZE);
+            console.log(`Translating batch ${batchNum}/${totalBatches} (${batch.length} phrase${batch.length === 1 ? '' : 's'})...`);
+            const batchResults = await (0, translate_1.translateStrings)(batch, targetLanguage, options);
+            for (const r of batchResults) {
+                if (typeof r.msgstr === 'string') {
+                    console.log(`  ${r.msgid} => ${r.msgstr}`);
+                }
+                else {
+                    console.log(`  ${r.msgid_plural} (plural) => ${r.msgstr.join(' | ')}`);
+                }
+            }
+            allResults.push(...batchResults);
+        }
+        (0, po_1.applyTranslations)(parsedPo, keys, allResults);
+        if (includeFuzzy) {
+            (0, po_1.clearFuzzyFromEntries)(parsedPo, keys);
+        }
+        node_fs_1.default.writeFileSync(poFilePath, (0, po_1.compilePo)(parsedPo), undefined);
+        return 0;
+    }
+    catch (error) {
+        const apiMessage = getApiErrorMessage(error);
+        if (apiMessage != null) {
+            console.warn(apiMessage);
+            return 1;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Failed to process PO file: ${message}`);
+        return 1;
+    }
+}
+const USAGE = 'Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--include-fuzzy]';
+function runTranslateCommand(args) {
+    if (!args.poFilePath) {
+        console.warn(USAGE);
+        return 1;
+    }
+    if (args.sourceLang != null) {
+        try {
+            (0, validate_source_lang_1.validateSourceLang)(args.sourceLang);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(message);
+            return 1;
+        }
+    }
+    if (!args.dryRun) {
+        let resultApiKey;
+        try {
+            resultApiKey = (0, translate_1.resolveApiKey)(args.apiKey);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(message.replace('pass apiKey in options', 'pass --api-key'));
+            return 1;
+        }
+        return runTranslate(args.poFilePath, resultApiKey, args.sourceLang, args.includeFuzzy);
+    }
+    try {
+        const poContent = node_fs_1.default.readFileSync(args.poFilePath, 'utf8');
+        const parsedPo = (0, po_1.parsePoContent)(poContent);
+        const { entries } = (0, po_1.getEntriesToTranslate)(parsedPo, {
+            includeFuzzy: args.includeFuzzy,
+        });
+        const msgidsToShow = entries.map((e) => e.msgid);
+        for (const msgid of msgidsToShow) {
+            console.log(msgid);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Failed to process PO file: ${message}`);
+        return 1;
+    }
+}

package/dist/src/cli.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTranslate = runTranslate;
+const node_fs_1 = __importDefault(require("node:fs"));
+const yargs_1 = __importDefault(require("yargs/yargs"));
+const helpers_1 = require("yargs/helpers");
+const po_1 = require("./po");
+const translate_1 = require("./translate");
+const validate_source_lang_1 = require("./validate-source-lang");
+const TRANSLATE_BATCH_SIZE = 15;
+function parseArgs(argv) {
+    try {
+        const parsedArgs = (0, yargs_1.default)(argv)
+            .scriptName('msgai')
+            .usage('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG]')
+            .option('dry-run', {
+            type: 'boolean',
+            default: false,
+        })
+            .option('api-key', {
+            type: 'string',
+            description: 'OpenAI API key (otherwise read from OPENAI_API_KEY env)',
+        })
+            .option('source-lang', {
+            type: 'string',
+            description: 'Source language of msgid strings (ISO 639-1 code, e.g. en, uk). If omitted, the model will detect it.',
+        })
+            .option('help', {
+            alias: 'h',
+            type: 'boolean',
+            default: false,
+        })
+            .strictOptions()
+            .version(false)
+            .exitProcess(false)
+            .fail((message, error) => {
+            if (error) {
+                throw error;
+            }
+            throw new Error(message);
+        })
+            .parseSync();
+        const positionalArgs = parsedArgs._.map(String);
+        const sourceLangRaw = parsedArgs['source-lang'];
+        const sourceLang = sourceLangRaw != null && String(sourceLangRaw).trim() !== ''
+            ? String(sourceLangRaw).trim().toLowerCase()
+            : undefined;
+        if (positionalArgs.length > 1) {
+            return {
+                dryRun: Boolean(parsedArgs['dry-run']),
+                help: Boolean(parsedArgs.help),
+                apiKey: parsedArgs['api-key'],
+                sourceLang,
+                error: `Unexpected argument: ${positionalArgs[1]}`,
+            };
+        }
+        return {
+            poFilePath: positionalArgs[0],
+            dryRun: Boolean(parsedArgs['dry-run']),
+            help: Boolean(parsedArgs.help),
+            apiKey: parsedArgs['api-key'],
+            sourceLang,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { dryRun: false, help: false, error: message };
+    }
+}
+async function runTranslate(poFilePath, apiKey, sourceLang) {
+    try {
+        const poContent = node_fs_1.default.readFileSync(poFilePath, 'utf8');
+        const parsedPo = (0, po_1.parsePoContent)(poContent);
+        const { entries, keys } = (0, po_1.getEntriesToTranslate)(parsedPo);
+        if (entries.length === 0) {
+            console.log(`Nothing to translate in ${poFilePath}.`);
+            return 0;
+        }
+        const targetLanguage = (0, po_1.getLanguage)(parsedPo) ?? 'en';
+        const formula = (0, po_1.getPluralForms)(parsedPo) ?? '';
+        const options = { apiKey, sourceLanguage: sourceLang, formula };
+        const allResults = [];
+        for (let i = 0; i < entries.length; i += TRANSLATE_BATCH_SIZE) {
+            const batch = entries.slice(i, i + TRANSLATE_BATCH_SIZE);
+            const batchNum = Math.floor(i / TRANSLATE_BATCH_SIZE) + 1;
+            const totalBatches = Math.ceil(entries.length / TRANSLATE_BATCH_SIZE);
+            console.log(`Translating batch ${batchNum}/${totalBatches} (${batch.length} phrase${batch.length === 1 ? '' : 's'})...`);
+            const batchResults = await (0, translate_1.translateStrings)(batch, targetLanguage, options);
+            for (const r of batchResults) {
+                if (typeof r.msgstr === 'string') {
+                    console.log(`  ${r.msgid} => ${r.msgstr}`);
+                }
+                else {
+                    console.log(`  ${r.msgid_plural} (plural) => ${r.msgstr.join(' | ')}`);
+                }
+            }
+            allResults.push(...batchResults);
+        }
+        (0, po_1.applyTranslations)(parsedPo, keys, allResults);
+        node_fs_1.default.writeFileSync(poFilePath, (0, po_1.compilePo)(parsedPo), undefined);
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to process PO file: ${message}`);
+        return 1;
+    }
+}
+function main(argv) {
+    const args = parseArgs(argv);
+    if (args.error) {
+        console.error(args.error);
+        console.error('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG]');
+        return 1;
+    }
+    if (args.help) {
+        console.log('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG]');
+        return 0;
+    }
+    if (!args.poFilePath) {
+        console.error('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG]');
+        return 1;
+    }
+    if (args.sourceLang != null) {
+        try {
+            (0, validate_source_lang_1.validateSourceLang)(args.sourceLang);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(message);
+            return 1;
+        }
+    }
+    if (!args.dryRun) {
+        let resultApiKey;
+        try {
+            resultApiKey = (0, translate_1.resolveApiKey)(args.apiKey);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(message.replace('pass apiKey in options', 'pass --api-key'));
+            return 1;
+        }
+        runTranslate(args.poFilePath, resultApiKey, args.sourceLang).then((code) => process.exit(code));
+        return undefined;
+    }
+    try {
+        const poContent = node_fs_1.default.readFileSync(args.poFilePath, 'utf8');
+        const parsedPo = (0, po_1.parsePoContent)(poContent);
+        const untranslatedMsgids = (0, po_1.getUntranslatedMsgids)(parsedPo);
+        for (const msgid of untranslatedMsgids) {
+            console.log(msgid);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to process PO file: ${message}`);
+        return 1;
+    }
+    return 0;
+}
+const exitCode = main((0, helpers_1.hideBin)(process.argv));
+if (typeof exitCode === 'number') {
+    process.exit(exitCode);
+}

package/dist/src/loadEnv.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEnv = loadEnv;
+/**
+ * Single place for loading .env. Used by the CLI and scripts so env is loaded once.
+ */
+const dotenv_1 = __importDefault(require("dotenv"));
+const node_path_1 = __importDefault(require("node:path"));
+let loaded = false;
+function loadEnv() {
+    if (loaded)
+        return;
+    dotenv_1.default.config({ path: node_path_1.default.resolve(process.cwd(), '.env') });
+    loaded = true;
+}

package/dist/src/po/translations.en.po

@@ -0,0 +1,68 @@
+msgid ""
+msgstr ""
+"Content-Type: text/plain; charset=utf-8\n"
+"Plural-Forms: nplurals = 2; plural = (n != 1);\n"
+"Language: en\n"
+"MIME-Version: 1.0\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/templates/baseHTML.mjs:11
+msgid "Krejčovství Švadlenka – Oprava a úprava oděvů Praha 2"
+msgstr "Švadlenka Tailor Shop – Repair and Alteration of Clothing Prague 2"
+
+#: src/templates/baseHTML.mjs:12
+msgid ""
+"Švadlenka je krejčovství na Praze 2, které nabízí kvalitní opravy a úpravy "
+"oblečení – džíny, kabáty, podšívky, batohy i záclony. Najdete nás na "
+"Jaromírově 726/15."
+msgstr ""
+"Švadlenka is a tailor shop in Prague 2 offering quality repairs and "
+"alterations of clothing – jeans, coats, linings, backpacks, and curtains. "
+"You can find us at Jaromírova 726/15."
+
+#: src/templates/baseHTML.mjs:13
+msgid ""
+"krejčovství, oprava oblečení, úprava oděvů, výměna zipu, podšívka, záclony, "
+"Praha 2, Nusle"
+msgstr ""
+"tailor shop, clothes repair, clothing alteration, zipper replacement, "
+"lining, curtains, Prague 2, Nusle"
+
+#: src/templates/baseHTML.mjs:14
+msgid "Krejčovství Švadlenka – Praha 2"
+msgstr "Švadlenka Tailor Shop – Prague 2"
+
+#: src/templates/baseHTML.mjs:15
+msgid "Opravy a úpravy oblečení, záclon, batohů – najdete nás na Jaromírově 726/15."
+msgstr ""
+"Repairs and alterations of clothes, curtains, backpacks – you can find us "
+"at Jaromírova 726/15."
+
+#: src/templates/header.mjs:14
+#: src/templates/header.mjs:43
+msgid "Úvod"
+msgstr "Introduction"
+
+#: src/pages/sluzby.mjs:28
+#: src/templates/header.mjs:15
+#: src/templates/header.mjs:44
+msgid "Služby a ceník"
+msgstr "Services and Price List"
+
+#: src/templates/header.mjs:16
+#: src/templates/header.mjs:45
+#: src/templates/kontakty.mjs:5
+msgid "Kontakty"
+msgstr "Contacts"
+
+#: src/templates/kontakty.mjs:23
+msgid "Po – Čt: 10:00 – 18:00"
+msgstr "Mon – Thu: 10:00 AM – 6:00 PM"
+
+#: src/templates/kontakty.mjs:24
+msgid "Pá: 10:00 – 16:00"
+msgstr "Fri: 10:00 AM – 4:00 PM"
+
+#: src/templates/review.mjs:16
+msgid "Budeme vděční za vaši recenzi"
+msgstr "We would appreciate your review"

package/dist/src/po/translations.ru.po

@@ -0,0 +1,61 @@
+msgid ""
+msgstr ""
+"Content-Type: text/plain; charset=utf-8\n"
+"Plural-Forms: nplurals = 3; plural = (n % 10 == 1 && n % 100 != 11 ? 0 : n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 10 || n % 100 >= 20) ? 1 : 2);\n"
+"Language: ru\n"
+"MIME-Version: 1.0\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/templates/baseHTML.mjs:11
+msgid "Krejčovství Švadlenka – Oprava a úprava oděvů Praha 2"
+msgstr ""
+
+#: src/templates/baseHTML.mjs:12
+msgid ""
+"Švadlenka je krejčovství na Praze 2, které nabízí kvalitní opravy a úpravy "
+"oblečení – džíny, kabáty, podšívky, batohy i záclony. Najdete nás na "
+"Jaromírově 726/15."
+msgstr ""
+
+#: src/templates/baseHTML.mjs:13
+msgid ""
+"krejčovství, oprava oblečení, úprava oděvů, výměna zipu, podšívka, záclony, "
+"Praha 2, Nusle"
+msgstr ""
+
+#: src/templates/baseHTML.mjs:14
+msgid "Krejčovství Švadlenka – Praha 2"
+msgstr ""
+
+#: src/templates/baseHTML.mjs:15
+msgid "Opravy a úpravy oblečení, záclon, batohů – najdete nás na Jaromírově 726/15."
+msgstr ""
+
+#: src/templates/header.mjs:14
+#: src/templates/header.mjs:43
+msgid "Úvod"
+msgstr ""
+
+#: src/pages/sluzby.mjs:28
+#: src/templates/header.mjs:15
+#: src/templates/header.mjs:44
+msgid "Služby a ceník"
+msgstr ""
+
+#: src/templates/header.mjs:16
+#: src/templates/header.mjs:45
+#: src/templates/kontakty.mjs:5
+msgid "Kontakty"
+msgstr ""
+
+#: src/templates/kontakty.mjs:23
+msgid "Po – Čt: 10:00 – 18:00"
+msgstr ""
+
+#: src/templates/kontakty.mjs:24
+msgid "Pá: 10:00 – 16:00"
+msgstr ""
+
+#: src/templates/review.mjs:16
+msgid "Budeme vděční za vaši recenzi"
+msgstr ""

package/dist/src/po/translations.uk.po

@@ -0,0 +1,69 @@
+msgid ""
+msgstr ""
+"Content-Type: text/plain; charset=utf-8\n"
+"Plural-Forms: nplurals = 3; plural = (n % 10 == 1 && n % 100 != 11 ? 0 : n "
+"% 10 >= 2 && n % 10 <= 4 && (n % 100 < 10 || n % 100 >= 20) ? 1 : 2);\n"
+"Language: uk\n"
+"MIME-Version: 1.0\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/templates/baseHTML.mjs:11
+msgid "Krejčovství Švadlenka – Oprava a úprava oděvů Praha 2"
+msgstr "Ательє Швадленка – Ремонт та переробка одягу Прага 2"
+
+#: src/templates/baseHTML.mjs:12
+msgid ""
+"Švadlenka je krejčovství na Praze 2, které nabízí kvalitní opravy a úpravy "
+"oblečení – džíny, kabáty, podšívky, batohy i záclony. Najdete nás na "
+"Jaromírově 726/15."
+msgstr ""
+"Швадленка – це ательє в Празі 2, яке пропонує якісний ремонт та переробку "
+"одягу – джинси, пальта, підкладки, рюкзаки та штори. Знайдете нас на "
+"Яроміровій 726/15."
+
+#: src/templates/baseHTML.mjs:13
+msgid ""
+"krejčovství, oprava oblečení, úprava oděvů, výměna zipu, podšívka, záclony, "
+"Praha 2, Nusle"
+msgstr ""
+"ательє, ремонт одягу, переробка одягу, заміна блискавки, підкладка, штори, "
+"Прага 2, Нусле"
+
+#: src/templates/baseHTML.mjs:14
+msgid "Krejčovství Švadlenka – Praha 2"
+msgstr "Ательє Швадленка – Прага 2"
+
+#: src/templates/baseHTML.mjs:15
+msgid "Opravy a úpravy oblečení, záclon, batohů – najdete nás na Jaromírově 726/15."
+msgstr ""
+"Ремонт та переробка одягу, штор, рюкзаків – знайдете нас на Яроміровій "
+"726/15."
+
+#: src/templates/header.mjs:14
+#: src/templates/header.mjs:43
+msgid "Úvod"
+msgstr "Вступ"
+
+#: src/pages/sluzby.mjs:28
+#: src/templates/header.mjs:15
+#: src/templates/header.mjs:44
+msgid "Služby a ceník"
+msgstr "Послуги та прейскурант"
+
+#: src/templates/header.mjs:16
+#: src/templates/header.mjs:45
+#: src/templates/kontakty.mjs:5
+msgid "Kontakty"
+msgstr "Контакти"
+
+#: src/templates/kontakty.mjs:23
+msgid "Po – Čt: 10:00 – 18:00"
+msgstr "Пн – Чт: 10:00 – 18:00"
+
+#: src/templates/kontakty.mjs:24
+msgid "Pá: 10:00 – 16:00"
+msgstr "Пт: 10:00 – 16:00"
+
+#: src/templates/review.mjs:16
+msgid "Budeme vděční za vaši recenzi"
+msgstr "Будемо вдячні за ваш відгук"

package/dist/src/po.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUntranslatedMsgids = getUntranslatedMsgids;
+exports.getLanguage = getLanguage;
+exports.getPluralForms = getPluralForms;
+exports.isEntryFuzzy = isEntryFuzzy;
+exports.parsePoContent = parsePoContent;
+exports.getEntriesToTranslate = getEntriesToTranslate;
+exports.applyTranslations = applyTranslations;
+exports.clearFuzzyFromEntries = clearFuzzyFromEntries;
+exports.compilePo = compilePo;
+const gettext_parser_1 = require("gettext-parser");
+function getUntranslatedMsgids(parsedPo) {
+    const untranslatedMsgids = [];
+    const translations = parsedPo.translations;
+    for (const contextEntries of Object.values(translations)) {
+        for (const entry of Object.values(contextEntries)) {
+            if (!entry.msgid) {
+                continue;
+            }
+            const msgstr = Array.isArray(entry.msgstr) ? entry.msgstr : [];
+            const isUntranslated = msgstr.length === 0 ||
+                msgstr.every((translation) => typeof translation !== 'string' || translation.trim() === '');
+            if (isUntranslated) {
+                untranslatedMsgids.push(entry.msgid);
+            }
+        }
+    }
+    return untranslatedMsgids;
+}
+function getLanguage(parsedPo) {
+    return parsedPo.headers?.['Language'];
+}
+function getPluralForms(parsedPo) {
+    return parsedPo.headers?.['Plural-Forms'];
+}
+function isEntryUntranslated(entry) {
+    const msgstr = Array.isArray(entry.msgstr) ? entry.msgstr : [];
+    return msgstr.length === 0 || msgstr.every((s) => typeof s !== 'string' || s.trim() === '');
+}
+/** Returns true if the entry has the fuzzy flag (e.g. "#, fuzzy" in PO). */
+function isEntryFuzzy(entry) {
+    const flag = entry.comments?.flag;
+    if (flag == null || typeof flag !== 'string')
+        return false;
+    return flag.split(',').some((s) => s.trim().toLowerCase() === 'fuzzy');
+}
+/**
+ * Parses PO content and returns the gettext structure.
+ */
+function parsePoContent(poContent) {
+    return gettext_parser_1.po.parse(Buffer.from(poContent, 'utf8'));
+}
+/**
+ * Returns untranslated entries and their keys in stable order (contexts and msgids sorted).
+ * Skips the header (msgid "").
+ * By default skips fuzzy entries; set includeFuzzy to include them (with empty msgstr for the request).
+ */
+function getEntriesToTranslate(parsedPo, options) {
+    const includeFuzzy = options?.includeFuzzy === true;
+    const entries = [];
+    const keys = [];
+    const translations = parsedPo.translations;
+    const contextNames = Object.keys(translations).sort();
+    for (const context of contextNames) {
+        const contextEntries = translations[context];
+        if (contextEntries == null)
+            continue;
+        const msgids = Object.keys(contextEntries).sort();
+        for (const msgid of msgids) {
+            if (msgid === '')
+                continue;
+            const entry = contextEntries[msgid];
+            if (entry == null || !entry.msgid)
+                continue;
+            const untranslated = isEntryUntranslated(entry);
+            const fuzzy = isEntryFuzzy(entry);
+            const include = untranslated || (includeFuzzy && fuzzy);
+            if (!include)
+                continue;
+            if (entry.msgid_plural != null) {
+                entries.push({
+                    msgid: entry.msgid,
+                    msgid_plural: entry.msgid_plural,
+                    msgstr: fuzzy && !untranslated ? [] : entry.msgstr.slice(),
+                    msgctxt: context,
+                });
+            }
+            else {
+                entries.push({
+                    msgid: entry.msgid,
+                    msgctxt: context,
+                    ...(fuzzy && !untranslated ? { msgstr: [] } : {}),
+                });
+            }
+            keys.push({ context, msgid });
+        }
+    }
+    return { entries, keys };
+}
+/**
+ * Applies translation results into the parsed PO (mutates parsedPo.translations).
+ * Singular results become one-element msgstr; plural results stay as string[].
+ */
+function applyTranslations(parsedPo, keys, results) {
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const result = results[i];
+        if (result == null)
+            continue;
+        const contextEntries = parsedPo.translations[key.context];
+        if (contextEntries == null)
+            continue;
+        const entry = contextEntries[key.msgid];
+        if (entry == null)
+            continue;
+        if (typeof result.msgstr === 'string') {
+            entry.msgstr = [result.msgstr];
+        }
+        else {
+            entry.msgstr = result.msgstr.slice();
+        }
+    }
+}
+/**
+ * Removes the "fuzzy" flag from entries at the given keys (mutates parsedPo.translations).
+ * Used after applying new translations so fuzzy entries are no longer marked fuzzy.
+ */
+function clearFuzzyFromEntries(parsedPo, keys) {
+    for (const key of keys) {
+        const contextEntries = parsedPo.translations[key.context];
+        if (contextEntries == null)
+            continue;
+        const entry = contextEntries[key.msgid];
+        if (entry == null || !entry.comments?.flag)
+            continue;
+        const newFlag = entry.comments.flag
+            .split(',')
+            .map((s) => s.trim())
+            .filter((s) => s.toLowerCase() !== 'fuzzy')
+            .join(', ');
+        if (newFlag === '') {
+            delete entry.comments.flag;
+            if (Object.keys(entry.comments).length === 0) {
+                delete entry.comments;
+            }
+        }
+        else {
+            entry.comments.flag = newFlag;
+        }
+    }
+}
+/**
+ * Compiles the parsed PO to a buffer (no file I/O).
+ */
+function compilePo(parsedPo) {
+    return gettext_parser_1.po.compile(parsedPo);
+}

package/dist/src/run-translate.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTranslate = runTranslate;
+const node_fs_1 = __importDefault(require("node:fs"));
+const po_1 = require("./po");
+const translate_1 = require("./translate");
+const TRANSLATE_BATCH_SIZE = 15;
+async function runTranslate(poFilePath, apiKey, sourceLang) {
+    try {
+        const poContent = node_fs_1.default.readFileSync(poFilePath, 'utf8');
+        const parsedPo = (0, po_1.parsePoContent)(poContent);
+        const { entries, keys } = (0, po_1.getEntriesToTranslate)(parsedPo);
+        if (entries.length === 0) {
+            console.log(`Nothing to translate in ${poFilePath}.`);
+            return 0;
+        }
+        const targetLanguage = (0, po_1.getLanguage)(parsedPo) ?? 'en';
+        const formula = (0, po_1.getPluralForms)(parsedPo) ?? '';
+        const options = { apiKey, sourceLanguage: sourceLang, formula };
+        const allResults = [];
+        for (let i = 0; i < entries.length; i += TRANSLATE_BATCH_SIZE) {
+            const batch = entries.slice(i, i + TRANSLATE_BATCH_SIZE);
+            const batchNum = Math.floor(i / TRANSLATE_BATCH_SIZE) + 1;
+            const totalBatches = Math.ceil(entries.length / TRANSLATE_BATCH_SIZE);
+            console.log(`Translating batch ${batchNum}/${totalBatches} (${batch.length} phrase${batch.length === 1 ? '' : 's'})...`);
+            const batchResults = await (0, translate_1.translateStrings)(batch, targetLanguage, options);
+            for (const r of batchResults) {
+                if (typeof r.msgstr === 'string') {
+                    console.log(`  ${r.msgid} => ${r.msgstr}`);
+                }
+                else {
+                    console.log(`  ${r.msgid_plural} (plural) => ${r.msgstr.join(' | ')}`);
+                }
+            }
+            allResults.push(...batchResults);
+        }
+        (0, po_1.applyTranslations)(parsedPo, keys, allResults);
+        node_fs_1.default.writeFileSync(poFilePath, (0, po_1.compilePo)(parsedPo), undefined);
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to process PO file: ${message}`);
+        return 1;
+    }
+}

package/dist/src/translate.js

@@ -0,0 +1,223 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiKey = resolveApiKey;
+exports.translatePayload = translatePayload;
+exports.translateItems = translateItems;
+exports.translateStrings = translateStrings;
+const openai_1 = __importDefault(require("openai"));
+const loadEnv_1 = require("./loadEnv");
+function resolveApiKey(apiKey) {
+    (0, loadEnv_1.loadEnv)();
+    if (apiKey != null && apiKey.trim() !== '')
+        return apiKey;
+    const env = process.env['OPENAI_API_KEY'];
+    if (env != null && env.trim() !== '')
+        return env;
+    throw new Error('OpenAI API key not set. Set OPENAI_API_KEY in the environment or pass apiKey in options.');
+}
+const DEFAULT_MODEL = 'gpt-4o';
+/** Error codes: https://developers.openai.com/api/docs/guides/error-codes#api-errors */
+const MAX_RETRIES = 3;
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isApiError(err) {
+    return (err != null &&
+        typeof err === 'object' &&
+        'status' in err &&
+        typeof err.status === 'number');
+}
+function isRetryableStatus(status) {
+    return status === 429 || status === 500 || status === 503;
+}
+function buildSystemMessage() {
+    return `You are a deterministic translation engine for gettext PO entries.
+
+Your task:
+For each input entry, produce a translation in the corresponding "msgstr" field.
+Each output entry MUST correspond exactly to the matching input entry.
+Do not change, remove, or reorder any "msgid" or "msgid_plural" values.
+Only fill the "msgstr" field.
+If an entry has "msgctxt", leave it unchanged and return it in the output (so same msgids for different contexts are not mixed).
+
+Critical rules:
+
+- Preserve ALL placeholders exactly as in the source text.
+- NEVER translate, modify, reorder, or remove placeholders.
+
+Placeholders include (but are not limited to):
+- printf-style specifiers: %s, %d, %f, %1$s, %(name)s
+- variables in braces: {name}, {0}, {count}
+- template string interpolation: \${name}
+- template/ICU tokens
+- HTML/XML tags
+- any non-linguistic tokens
+
+Only translate natural language text surrounding them.
+
+Input:
+
+You will receive a JSON object containing:
+- "formula": plural formula of the target language
+- "target_language": language code to translate into
+- "source_language": language code of the source text
+- "translations": ordered array of entries
+- "plural_samples" (optional): array of { "plural": number, "sample": number } — one per plural form, giving the example count for that form (e.g. 1, 2, 5 for Ukrainian)
+
+Each entry is either:
+
+1) { "msgid": string }
+   → Translate the value of "msgid"
+   → Set "msgstr" to a SINGLE translated string
+   → Copy "msgid" unchanged into the output entry
+
+2) { "msgid_plural": string }
+   → Translate the plural form
+   → Set "msgstr" to an ARRAY of translated strings
+   → The number and order of elements MUST follow the plural "formula"
+   → If "plural_samples" is present: "msgstr" must have length equal to plural_samples.length; the i-th string is the translation for the count plural_samples[i].sample (e.g. form for 1 item, form for 2 items, form for 5 items)
+   → If "plural_samples" is absent: the number and order of elements MUST follow the plural "formula"
+   → Copy "msgid_plural" unchanged into the output entry
+
+Output:
+
+You MUST respond with nothing but a single JSON object. No markdown, no code fences (no \`\`\`json or \`\`\`), no explanatory text before or after. The response must be parseable by JSON.parse() directly.
+
+Return EXACTLY this structure (and nothing else):
+
+{
+  "formula": "...",
+  "target_language": "...",
+  "source_language": "...",
+  "translations": [
+    { "msgid": "...", "msgstr": "..." },
+    { "msgid_plural": "...", "msgstr": ["...", "..."] }
+  ]
+}
+
+Additional constraints:
+
+- Preserve the exact input order of entries.
+- Do not modify "formula", "target_language", or "source_language".
+- Do not add, remove, or rename fields.`;
+}
+/** Strip markdown code fences if the model wrapped JSON in ```json ... ``` */
+function stripJsonFences(raw) {
+    const trimmed = raw.trim();
+    const jsonBlock = /^```(?:json)?\s*\n?([\s\S]*?)\n?```\s*$/;
+    const match = trimmed.match(jsonBlock);
+    return match ? match[1].trim() : trimmed;
+}
+function parsePayloadResponse(content) {
+    if (content == null || content.trim() === '') {
+        throw new Error('Empty response from OpenAI');
+    }
+    const raw = content.trim();
+    const toParse = stripJsonFences(raw);
+    let parsed;
+    try {
+        parsed = JSON.parse(toParse);
+    }
+    catch {
+        console.warn('OpenAI model returned (raw):', raw);
+        throw new Error(`OpenAI response is not valid JSON: ${raw.slice(0, 200)}`);
+    }
+    if (parsed == null || typeof parsed !== 'object' || !('translations' in parsed)) {
+        console.warn('OpenAI model returned (raw):', raw);
+        throw new Error(`OpenAI response must be object with "translations" array: ${raw.slice(0, 200)}`);
+    }
+    const payload = parsed;
+    if (!Array.isArray(payload.translations)) {
+        console.warn('OpenAI model returned (raw):', raw);
+        throw new Error(`OpenAI response "translations" must be an array: ${raw.slice(0, 200)}`);
+    }
+    for (let i = 0; i < payload.translations.length; i++) {
+        const t = payload.translations[i];
+        if (t == null || typeof t !== 'object' || !('msgstr' in t)) {
+            console.warn('OpenAI model returned (raw):', raw);
+            throw new Error(`OpenAI response translations[${i}] must have msgstr`);
+        }
+        const entry = t;
+        const msgstr = entry.msgstr;
+        if (typeof msgstr === 'string')
+            continue;
+        if (Array.isArray(msgstr) && msgstr.every((s) => typeof s === 'string'))
+            continue;
+        console.warn('OpenAI model returned (raw):', raw);
+        throw new Error(`OpenAI response translations[${i}].msgstr must be a string or array of strings`);
+    }
+    return payload;
+}
+async function translatePayload(payload, options) {
+    if (payload.translations.length === 0) {
+        return { ...payload, translations: [] };
+    }
+    const client = options?.client ??
+        new openai_1.default({
+            apiKey: options.apiKey,
+        });
+    const model = options?.model ?? DEFAULT_MODEL;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            const response = await client.chat.completions.create({
+                model,
+                messages: [
+                    { role: 'system', content: buildSystemMessage() },
+                    { role: 'user', content: JSON.stringify(payload) },
+                ],
+            });
+            const content = response.choices[0]?.message?.content ?? null;
+            return parsePayloadResponse(content);
+        }
+        catch (err) {
+            const shouldRetry = attempt < MAX_RETRIES && isApiError(err) && isRetryableStatus(err.status);
+            if (shouldRetry) {
+                const delayMs = RETRY_DELAYS_MS[attempt] ?? RETRY_DELAYS_MS[RETRY_DELAYS_MS.length - 1];
+                await sleep(delayMs);
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw new Error('Unreachable');
+}
+async function translateItems(items, targetLanguage, options) {
+    if (items.length === 0)
+        return [];
+    const sourceLanguage = options?.sourceLanguage ?? 'en';
+    const formula = options?.formula ?? '';
+    const payload = {
+        formula,
+        target_language: targetLanguage,
+        source_language: sourceLanguage,
+        translations: items,
+    };
+    if (options.pluralSamples != null && options.pluralSamples.length > 0) {
+        payload.plural_samples = options.pluralSamples;
+    }
+    const result = await translatePayload(payload, options);
+    return result.translations.map((t) => t.msgstr);
+}
+/** Translate .po-style entries. Accepts entries with msgid or msgid_plural, passes them to translateItems, returns same array with msgstr filled. */
+async function translateStrings(entries, targetLanguage, options) {
+    if (entries.length === 0)
+        return [];
+    const items = entries.map((e) => {
+        const base = e.msgid_plural != null ? { msgid_plural: e.msgid_plural } : { msgid: e.msgid };
+        return e.msgctxt !== undefined ? { ...base, msgctxt: e.msgctxt } : base;
+    });
+    const results = await translateItems(items, targetLanguage, options);
+    return entries.map((entry, i) => {
+        const msgstr = results[i];
+        if (entry.msgid_plural != null) {
+            const arr = typeof msgstr === 'string' ? [msgstr] : (msgstr ?? []);
+            return { ...entry, msgstr: arr };
+        }
+        const str = typeof msgstr === 'string' ? msgstr : Array.isArray(msgstr) ? (msgstr[0] ?? '') : '';
+        return { ...entry, msgstr: str };
+    });
+}

package/dist/src/validate-source-lang.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISO_LANG_CODES_URL = void 0;
+exports.validateSourceLang = validateSourceLang;
+const plural_forms_1 = require("plural-forms");
+exports.ISO_LANG_CODES_URL = 'https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes';
+function validateSourceLang(code) {
+    const normalized = code.trim().toLowerCase();
+    if (!(0, plural_forms_1.hasLang)(normalized)) {
+        throw new Error(`Invalid --source-lang "${code}": not a known ISO language code. See ${exports.ISO_LANG_CODES_URL} for a list of valid codes.`);
+    }
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "msgai-cli",
+  "version": "1.0.0",
+  "description": "CLI that automatically translates all untranslated strings in gettext (.po) files using AI (LLM)",
+  "main": "dist/src/cli/index.js",
+  "bin": {
+    "msgai": "dist/src/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && jest",
+    "test:integration": "npm run build && jest -c jest.integration.config.cjs",
+    "test:watch": "npm run build && jest --watch",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "lint:format": "prettier --check .",
+    "script:test-openai": "ts-node scripts/test-openai.ts",
+    "prepublishOnly": "npm run build && npm test && npm run test:integration && npm run lint && npm run lint:format"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlexMost/msgai.git"
+  },
+  "keywords": [
+    "gettext",
+    "po",
+    "translate",
+    "openai",
+    "cli",
+    "i18n"
+  ],
+  "engines": {
+    "node": ">=20",
+    "npm": ">=10"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/AlexMost/msgai/issues"
+  },
+  "homepage": "https://github.com/AlexMost/msgai#readme",
+  "devDependencies": {
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.0",
+    "@eslint/js": "^10.0.1",
+    "@types/gettext-parser": "^9.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.3.0",
+    "babel-jest": "^30.2.0",
+    "eslint": "^10.0.2",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "dependencies": {
+    "dotenv": "^17.3.1",
+    "gettext-parser": "^9.0.1",
+    "openai": "^6.25.0",
+    "plural-forms": "^0.5.5",
+    "yargs": "^18.0.0"
+  }
+}