@el-j/google-sheet-translations 1.3.2 → 1.4.0

package/dist/utils/rateLimiter.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withRetry = withRetry;
-const promises_1 = require("node:timers/promises");
-const DEFAULT_RETRIES = 3;
-const DEFAULT_MAX_DELAY_MS = 30000;
-/**
- * Returns true when the error looks like a Google Sheets API rate-limit or
- * transient server error (HTTP 429 or 503).
- */
-function isRateLimitError(err) {
-    if (!err || typeof err !== 'object')
-        return false;
-    const e = err;
-    const response = e['response'];
-    const status = typeof e['status'] === 'number'
-        ? e['status']
-        : typeof response?.['status'] === 'number'
-            ? response['status']
-            : undefined;
-    return status === 429 || status === 503;
-}
-/**
- * Calls `fn` and, on a rate-limit error (HTTP 429 / 503), retries with
- * exponential back-off.  Any other error is re-thrown immediately.
- *
- * @param fn           - The async operation to execute (and potentially retry)
- * @param label        - Human-readable label used in warning logs
- * @param baseDelayMs  - Base back-off delay in milliseconds (default: 1 000)
- * @param retries      - Maximum number of retry attempts (default: 3)
- * @param maxDelayMs   - Back-off ceiling in milliseconds (default: 30 000)
- * @returns The resolved value of `fn`
- * @throws  The last error if all retries are exhausted, or any non-rate-limit error immediately
- */
-async function withRetry(fn, label, baseDelayMs = 1000, retries = DEFAULT_RETRIES, maxDelayMs = DEFAULT_MAX_DELAY_MS) {
-    for (let attempt = 0; attempt <= retries; attempt++) {
-        try {
-            return await fn();
-        }
-        catch (err) {
-            if (!isRateLimitError(err) || attempt === retries)
-                throw err;
-            const backoff = Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
-            console.warn(`[rate-limit] ${label}: retry ${attempt + 1}/${retries} in ${backoff} ms`);
-            await (0, promises_1.setTimeout)(backoff);
-        }
-    }
-    // The loop above always returns (on success) or throws (on exhausted retries or
-    // non-rate-limit errors).  This line is here solely to satisfy TypeScript's
-    // control-flow analysis — it cannot actually be reached at runtime.
-    /* c8 ignore next */
-    throw new Error('withRetry: unreachable');
-}
-exports.default = withRetry;
-//# sourceMappingURL=rateLimiter.js.map

package/dist/utils/rateLimiter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../src/utils/rateLimiter.ts"],"names":[],"mappings":";;AAkCA,8BAwBC;AA1DD,mDAA2D;AAE3D,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,oBAAoB,GAAG,KAAM,CAAC;AAEpC;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAY;IACrC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAwC,CAAC;IACtE,MAAM,MAAM,GACX,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAC9B,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACb,CAAC,CAAC,OAAO,QAAQ,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACzC,CAAC,CAAE,QAAQ,CAAC,QAAQ,CAAY;YAChC,CAAC,CAAC,SAAS,CAAC;IACf,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,SAAS,CAC9B,EAAoB,EACpB,KAAa,EACb,WAAW,GAAG,IAAK,EACnB,OAAO,GAAG,eAAe,EACzB,UAAU,GAAG,oBAAoB;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACJ,OAAO,MAAM,EAAE,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,OAAO;gBAAE,MAAM,GAAG,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,EAAE,UAAU,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CACX,gBAAgB,KAAK,WAAW,OAAO,GAAG,CAAC,IAAI,OAAO,OAAO,OAAO,KAAK,CACzE,CAAC;YACF,MAAM,IAAA,qBAAK,EAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IACD,gFAAgF;IAChF,4EAA4E;IAC5E,oEAAoE;IACpE,oBAAoB;IACpB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAC3C,CAAC;AAED,kBAAe,SAAS,CAAC"}

package/dist/utils/readDataJson.js

@@ -1,29 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readDataJson = readDataJson;
-const node_fs_1 = __importDefault(require("node:fs"));
-const convertFromDataJsonFormat_1 = require("../utils/dataConverter/convertFromDataJsonFormat");
-/**
- * Reads and parses the languageData.json file
- * @param dataJsonPath - Path to languageData.json
- * @returns Parsed languageData.json contents, or null if file doesn't exist or is invalid
- */
-function readDataJson(dataJsonPath) {
-    try {
-        if (!node_fs_1.default.existsSync(dataJsonPath)) {
-            return null;
-        }
-        const dataJsonContent = node_fs_1.default.readFileSync(dataJsonPath, 'utf8');
-        const dataJson = JSON.parse(dataJsonContent);
-        // Convert from languageData.json format to TranslationData
-        return (0, convertFromDataJsonFormat_1.convertFromDataJsonFormat)(dataJson);
-    }
-    catch (error) {
-        console.warn("Error reading or parsing languageData.json:", error);
-        return null;
-    }
-}
-//# sourceMappingURL=readDataJson.js.map

package/dist/utils/readDataJson.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"readDataJson.js","sourceRoot":"","sources":["../../src/utils/readDataJson.ts"],"names":[],"mappings":";;;;;AASA,oCAeC;AAxBD,sDAAyB;AAEzB,gGAA6F;AAE7F;;;;GAIG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAChD,IAAI,CAAC;QACJ,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,eAAe,GAAG,iBAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAE7C,2DAA2D;QAC3D,OAAO,IAAA,qDAAyB,EAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/utils/sheetProcessor.js

@@ -1,121 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.processRawRows = processRawRows;
-exports.processSheet = processSheet;
-const rateLimiter_1 = require("./rateLimiter");
-const localeFilter_1 = require("./localeFilter");
-const localeNormalizer_1 = require("./localeNormalizer");
-/**
- * Core row-processing logic shared by both the authenticated and public sheet paths.
- * Accepts pre-fetched rows (as plain objects) and returns the same
- * {@link SheetProcessingResult} shape that `processSheet` produces.
- * Contains only pure computation — no API calls are made here.
- *
- * @param rows       - Array of row objects keyed by column header
- * @param sheetTitle - The sheet tab name (used as namespace key in translations)
- * @returns Processing result containing translations and locales
- */
-async function processRawRows(rows, sheetTitle) {
-    const result = {
-        translations: {},
-        locales: [],
-        localeMapping: {},
-        originalMapping: {},
-        success: false,
-    };
-    try {
-        if (!rows || rows.length === 0) {
-            console.warn(`No rows found in sheet "${sheetTitle}"`);
-            return result;
-        }
-        // Extract header information
-        const headerRow = Object.keys(rows[0]).map((key) => key.toLowerCase());
-        console.log(`Header row for sheet "${sheetTitle}":`, headerRow);
-        const keyColumn = headerRow[0];
-        const validLocales = (0, localeFilter_1.filterValidLocales)(headerRow, keyColumn);
-        if (validLocales.length === 0) {
-            console.warn(`No valid locale columns found in sheet "${sheetTitle}"`);
-            return result;
-        }
-        // Create locale mapping for normalization
-        const originalHeaders = Object.keys(rows[0]); // Keep original case
-        const { normalizedLocales, localeMapping, originalMapping } = (0, localeNormalizer_1.createLocaleMapping)(originalHeaders, keyColumn);
-        // Store the mappings in the result
-        result.localeMapping = localeMapping;
-        result.originalMapping = originalMapping;
-        // Process each normalized locale
-        for (const normalizedLocale of normalizedLocales) {
-            // Find the original header for this normalized locale
-            const originalHeader = localeMapping[normalizedLocale];
-            if (!originalHeader)
-                continue;
-            const languageCells = rows.map((row) => {
-                // Look for the key column (case-insensitive)
-                const keyField = Object.keys(row).find((k) => k.toLowerCase() === keyColumn);
-                if (!keyField || !row[keyField] || !row[originalHeader]) {
-                    return {}; // Skip rows without key or translation
-                }
-                const rowLocal = {};
-                // Convert key to lowercase
-                rowLocal[row[keyField].toString().toLowerCase()] = row[originalHeader];
-                return rowLocal;
-            });
-            // Filter out empty objects before combining
-            const nonEmptyLanguageCells = languageCells.filter((cell) => Object.keys(cell).length > 0);
-            // Combine all keys into one object
-            const prepareObj = {};
-            prepareObj[sheetTitle] = nonEmptyLanguageCells.reduce((acc, cell) => Object.assign(acc, cell), {});
-            // Use normalized locale as the key in translations
-            if (result.translations[normalizedLocale]) {
-                result.translations[normalizedLocale] = {
-                    ...result.translations[normalizedLocale],
-                    ...prepareObj,
-                };
-            }
-            else {
-                result.translations[normalizedLocale] = { ...prepareObj };
-            }
-        }
-        result.locales = normalizedLocales;
-        result.success = true;
-    }
-    catch (error) {
-        console.error(`Error processing sheet "${sheetTitle}":`, error);
-    }
-    return result;
-}
-/**
- * Fetches rows from a Google Sheet and extracts translation data.
- * The underlying `getRows` API call is automatically retried on rate-limit
- * responses (HTTP 429 / 503) using exponential back-off.
- *
- * @param sheet      The Google Spreadsheet worksheet to process
- * @param sheetTitle The title of the sheet being processed
- * @param rowLimit   Maximum number of rows to fetch
- * @param baseDelayMs Base back-off delay in ms for retrying rate-limited requests
- * @returns Processing result containing translations and locales
- */
-async function processSheet(sheet, sheetTitle, rowLimit, baseDelayMs = 1000) {
-    const emptyResult = {
-        translations: {},
-        locales: [],
-        localeMapping: {},
-        originalMapping: {},
-        success: false,
-    };
-    try {
-        const googleRows = await (0, rateLimiter_1.withRetry)(() => sheet.getRows({ limit: rowLimit }), `getRows: ${sheetTitle}`, baseDelayMs);
-        if (!googleRows || googleRows.length === 0) {
-            console.warn(`No rows found in sheet "${sheetTitle}"`);
-            return emptyResult;
-        }
-        // Convert GoogleSpreadsheetRow objects to plain SheetRow objects, then reuse shared logic
-        const rows = googleRows.map((row) => row.toObject());
-        return processRawRows(rows, sheetTitle);
-    }
-    catch (error) {
-        console.error(`Error processing sheet "${sheetTitle}":`, error);
-        return emptyResult;
-    }
-}
-//# sourceMappingURL=sheetProcessor.js.map

package/dist/utils/sheetProcessor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sheetProcessor.js","sourceRoot":"","sources":["../../src/utils/sheetProcessor.ts"],"names":[],"mappings":"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"}

package/dist/utils/spreadsheetCreator.js

@@ -1,121 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSpreadsheet = createSpreadsheet;
-const google_spreadsheet_1 = require("google-spreadsheet");
-const rateLimiter_1 = require("./rateLimiter");
-/** Column index (0-based) → spreadsheet letter (A, B…Z, AA, AB…). */
-function colLetter(index) {
-    let result = '';
-    let i = index;
-    do {
-        // Each digit in base-26 maps to a letter A–Z
-        result = String.fromCharCode(65 + (i % 26)) + result;
-        // Move to the next more-significant "digit", adjusting for 1-based indexing
-        i = Math.floor(i / 26) - 1;
-    } while (i >= 0);
-    return result;
-}
-const DEFAULT_TARGET_LOCALES = ['de', 'fr', 'es', 'it', 'pt', 'ja', 'zh'];
-const STARTER_KEYS = {
-    'app.name': 'My App',
-    'app.description': 'A great application',
-    'nav.home': 'Home',
-    'nav.about': 'About',
-    'nav.contact': 'Contact',
-    'common.save': 'Save',
-    'common.cancel': 'Cancel',
-    'common.loading': 'Loading…',
-    'common.error': 'An error occurred',
-    'common.success': 'Success!',
-};
-/**
- * Creates a new Google Spreadsheet seeded with translation starter content and
- * GOOGLETRANSLATE formulas for every non-source locale.
- *
- * Returns the spreadsheet ID and URL.
- */
-async function createSpreadsheet(authClient, options = {}) {
-    const { title = 'google-sheet-translations', sourceLocale = 'en', targetLocales = DEFAULT_TARGET_LOCALES, seedKeys = STARTER_KEYS, } = options;
-    // ── Step 1: Create the spreadsheet via the Sheets REST API ─────────────
-    // google-spreadsheet v4 does not expose a static create method, so we use
-    // the underlying JWT client to make a direct API call.
-    await authClient.authorize();
-    const createRes = await (0, rateLimiter_1.withRetry)(() => authClient.request({
-        url: 'https://sheets.googleapis.com/v4/spreadsheets',
-        method: 'POST',
-        data: {
-            properties: { title },
-            sheets: [
-                { properties: { title: '__welcome__', index: 0 } },
-                { properties: { title: 'i18n', index: 1 } },
-            ],
-        },
-    }), 'createSpreadsheet');
-    const spreadsheetId = createRes.data.spreadsheetId;
-    const url = `https://docs.google.com/spreadsheets/d/${spreadsheetId}/edit`;
-    // ── Step 2: Open the spreadsheet with google-spreadsheet ───────────────
-    const doc = new google_spreadsheet_1.GoogleSpreadsheet(spreadsheetId, authClient);
-    await (0, rateLimiter_1.withRetry)(() => doc.loadInfo(), 'loadInfo after create');
-    // ── Step 3: Populate __welcome__ sheet ─────────────────────────────────
-    const welcomeSheet = doc.sheetsByTitle['__welcome__'];
-    if (welcomeSheet) {
-        await (0, rateLimiter_1.withRetry)(() => welcomeSheet.loadCells('A1:B20'), 'loadCells welcome');
-        const lines = [
-            ['📊 Google Sheet Translations', ''],
-            ['', ''],
-            ['Package:', '@el-j/google-sheet-translations'],
-            ['Docs:', 'https://el-j.github.io/google-sheet-translations/'],
-            ['', ''],
-            ['Your Spreadsheet ID:', spreadsheetId],
-            ['URL:', url],
-            ['', ''],
-            ['Add to your .env file:', ''],
-            ['GOOGLE_SPREADSHEET_ID=' + spreadsheetId, ''],
-            ['', ''],
-            ['How this works:', ''],
-            ['1. The "i18n" sheet (and any other sheet you add) holds your translation keys.', ''],
-            ['2. Column A = key, Column B = source language, other columns = auto-translated.', ''],
-            ['3. Run getSpreadSheetData([\'i18n\']) in your project to sync to local files.', ''],
-            ['4. Add more sheets for different pages/features of your app.', ''],
-            ['5. Use syncLocalChanges: true (default) to push new keys back to this spreadsheet.', ''],
-        ];
-        for (let r = 0; r < lines.length; r++) {
-            for (let c = 0; c < lines[r].length; c++) {
-                const cell = welcomeSheet.getCell(r, c);
-                cell.value = lines[r][c];
-            }
-        }
-        await (0, rateLimiter_1.withRetry)(() => welcomeSheet.saveUpdatedCells(), 'saveWelcome');
-    }
-    // ── Step 4: Populate i18n sheet with headers + GOOGLETRANSLATE rows ────
-    const i18nSheet = doc.sheetsByTitle['i18n'];
-    if (i18nSheet) {
-        const allLocales = [sourceLocale, ...targetLocales];
-        // Row 1 = headers
-        await (0, rateLimiter_1.withRetry)(() => i18nSheet.setHeaderRow(['key', ...allLocales]), 'setHeaderRow');
-        // Build rows: source column has real text; other columns get GOOGLETRANSLATE formula.
-        // Source is always column B (index 1 after 'key')
-        const sourceColLetter = colLetter(1); // B
-        const rows = Object.entries(seedKeys).map(([key, sourceValue]) => {
-            const row = { key, [sourceLocale]: sourceValue };
-            targetLocales.forEach((locale, idx) => {
-                const targetColLetter = colLetter(2 + idx); // C, D, E, …
-                row[locale] =
-                    `=GOOGLETRANSLATE(INDIRECT("${sourceColLetter}"&ROW());$${sourceColLetter}$1;${targetColLetter}$1)`;
-            });
-            return row;
-        });
-        await (0, rateLimiter_1.withRetry)(() => i18nSheet.addRows(rows), 'addRows i18n');
-    }
-    console.log('');
-    console.log('✅ New spreadsheet created!');
-    console.log(`   Title  : ${title}`);
-    console.log(`   URL    : ${url}`);
-    console.log(`   ID     : ${spreadsheetId}`);
-    console.log('');
-    console.log('   Add this to your .env file (or environment):');
-    console.log(`   GOOGLE_SPREADSHEET_ID=${spreadsheetId}`);
-    console.log('');
-    return { spreadsheetId, url };
-}
-//# sourceMappingURL=spreadsheetCreator.js.map

package/dist/utils/spreadsheetCreator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spreadsheetCreator.js","sourceRoot":"","sources":["../../src/utils/spreadsheetCreator.ts"],"names":[],"mappings":"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"}

package/dist/utils/spreadsheetUpdater.js

@@ -1,194 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateSpreadsheetWithLocalChanges = updateSpreadsheetWithLocalChanges;
-const rateLimiter_1 = require("./rateLimiter");
-const localeNormalizer_1 = require("./localeNormalizer");
-/** Converts a 0-based column index to a spreadsheet column letter (A, B, ..., Z, AA, AB, ...) */
-function columnIndexToLetter(index) {
-    let result = '';
-    let i = index;
-    do {
-        result = String.fromCharCode(65 + (i % 26)) + result;
-        i = Math.floor(i / 26) - 1;
-    } while (i >= 0);
-    return result;
-}
-/**
- * Updates the Google Spreadsheet with new keys from local data
- *
- * When autoTranslate is enabled:
- * - For each new key added to the spreadsheet, the system checks which languages have translations
- * - For languages missing translations, it automatically adds Google Translate formulas
- * - The formula format is: =GOOGLETRANSLATE(INDIRECT(sourceColumn&ROW());$sourceColumn$1;targetColumn$1)
- * - This dynamic formula uses cell references for language codes and automatically adapts to the correct row
- *
- * Example:
- * If a new key "welcome" has an English translation in column B but no German translation in column C,
- * and autoTranslate is enabled, the system will add:
- * =GOOGLETRANSLATE(INDIRECT("B"&ROW());$B$1;C$1) to the German column
- *
- * @param doc - The Google Spreadsheet instance
- * @param changes - Object containing new keys to add to the spreadsheet
- * @param waitSeconds - Base back-off delay in seconds for retrying rate-limited API calls
- * @param autoTranslate - Whether to add Google Translate formulas for missing translations (default: false)
- * @param localeMapping - Mapping from normalized locale codes to original spreadsheet headers
- * @returns Promise that resolves when the update is complete
- */
-async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, autoTranslate = false, localeMapping = {}) {
-    console.log("Updating spreadsheet with local changes...");
-    const baseDelayMs = waitSeconds * 1000;
-    // Process each sheet in the changes object
-    for (const sheetTitle of new Set(Object.values(changes).flatMap(locale => Object.keys(locale)))) {
-        console.log(`Processing sheet: ${sheetTitle}`);
-        const sheet = doc.sheetsByTitle[sheetTitle];
-        if (!sheet) {
-            console.warn(`Sheet "${sheetTitle}" not found in the document, cannot update`);
-            continue;
-        }
-        // Get all rows from the sheet (retries automatically on rate-limit)
-        const rows = await (0, rateLimiter_1.withRetry)(() => sheet.getRows(), `getRows: ${sheetTitle}`, baseDelayMs);
-        if (!rows || rows.length === 0) {
-            console.warn(`No rows found in sheet "${sheetTitle}", cannot update`);
-            continue;
-        }
-        // Extract header information
-        const rowObject = rows[0].toObject();
-        const headerRow = Object.keys(rowObject).map(key => key.toLowerCase());
-        const keyColumn = headerRow[0]; // First column is the key
-        // Get all locales from the headerRow except the key column
-        const locales = headerRow.filter(key => key !== keyColumn);
-        // Map of existing keys to their row indices
-        const existingKeys = new Map();
-        rows.forEach((row, index) => {
-            const rowData = row.toObject();
-            const keyField = Object.keys(rowData).find(k => k.toLowerCase() === keyColumn);
-            if (keyField && rowData[keyField]) {
-                // Store the key in lowercase for case-insensitive comparison
-                existingKeys.set(rowData[keyField].toString().toLowerCase(), index);
-            }
-        });
-        // New keys to add to the sheet
-        const newKeys = new Map();
-        // Track which locales have values for each new key (for auto-translation)
-        const keyLocalesMap = new Map();
-        // Collect all new keys and their translations
-        for (const locale of Object.keys(changes)) {
-            if (!changes[locale]?.[sheetTitle])
-                continue;
-            const localeData = changes[locale][sheetTitle];
-            for (const key of Object.keys(localeData)) {
-                const keyLower = key.toLowerCase();
-                if (!existingKeys.has(keyLower)) {
-                    if (!newKeys.has(keyLower)) {
-                        newKeys.set(keyLower, { [keyColumn]: key });
-                        // Initialize map for this key's locale values
-                        keyLocalesMap.set(keyLower, new Map());
-                    }
-                    // Find the exact header for this locale using the mapping
-                    let localeHeader = (0, localeNormalizer_1.getOriginalHeaderForLocale)(locale, localeMapping);
-                    // Fallback to case-insensitive search in headerRow if mapping lookup fails
-                    if (!localeHeader) {
-                        localeHeader = headerRow.find(h => h.toLowerCase() === locale.toLowerCase());
-                    }
-                    if (localeHeader) {
-                        const theKey = newKeys.get(keyLower);
-                        if (!theKey) {
-                            console.warn(`Key "${key}" not found in newKeys map, skipping...`);
-                            continue;
-                        }
-                        const value = String(localeData[key]);
-                        // Use the correct header name for the locale value
-                        theKey[localeHeader] = value;
-                        // Store this locale value for potential auto-translation
-                        const localesForKey = keyLocalesMap.get(keyLower);
-                        if (localesForKey) {
-                            localesForKey.set(locale.toLowerCase(), localeHeader);
-                        }
-                    }
-                }
-                else {
-                    // Update existing key with new translation
-                    const rowIndex = existingKeys.get(keyLower);
-                    const row = rows[rowIndex];
-                    // Find the exact header for this locale using the mapping
-                    let localeHeader = (0, localeNormalizer_1.getOriginalHeaderForLocale)(locale, localeMapping);
-                    // Fallback to case-insensitive search if mapping lookup fails
-                    if (!localeHeader) {
-                        localeHeader = Object.keys(row.toObject()).find(h => h.toLowerCase() === locale.toLowerCase());
-                    }
-                    if (localeHeader) {
-                        // Use set() method instead of direct property assignment to avoid TS errors
-                        row.set(localeHeader, String(localeData[key]));
-                        try {
-                            await (0, rateLimiter_1.withRetry)(() => row.save(), `save row ${rowIndex} in ${sheetTitle}`, baseDelayMs);
-                        }
-                        catch (err) {
-                            console.error(`Failed to save row for key "${keyLower}" in sheet "${sheetTitle}":`, err);
-                        }
-                    }
-                }
-            }
-        }
-        // Add new keys to the sheet
-        if (newKeys.size > 0) {
-            console.log(`Adding ${newKeys.size} new keys to sheet ${sheetTitle}...`);
-            // Apply auto-translation for new keys if enabled
-            if (autoTranslate) {
-                // Process each new key
-                for (const [keyLower, rowData] of newKeys.entries()) {
-                    const localesWithValues = keyLocalesMap.get(keyLower);
-                    if (localesWithValues && localesWithValues.size > 0) {
-                        // Pick the first locale with a value as the source for translation
-                        const [, sourceHeader] = [...localesWithValues.entries()][0];
-                        // Find the cell reference for the source value
-                        // In Google Sheets formulas, we need to use column letters (A, B, C...) and row numbers
-                        // For each locale that doesn't have a value, add a GOOGLETRANSLATE formula
-                        for (const localeHeader of locales) {
-                            const localeLower = localeHeader.toLowerCase();
-                            // Skip if this locale already has a value.
-                            // rowData keys may be mixed-case (e.g. "en-GB"), so use a
-                            // case-insensitive lookup instead of a direct key access.
-                            const rowDataKey = Object.keys(rowData).find(k => k.toLowerCase() === localeLower);
-                            if (localesWithValues.has(localeLower) || (rowDataKey && rowData[rowDataKey])) {
-                                continue;
-                            }
-                            // Find the exact case-preserved header name
-                            const exactHeaderName = headerRow.find(h => h.toLowerCase() === localeLower);
-                            if (exactHeaderName) {
-                                // Create Google Translate formula referring to the source column
-                                // Since we don't know the exact row number yet, we'll use a special placeholder
-                                // that will be replaced with the actual cell reference after the rows are added
-                                // headerRow is fully lowercased; normalise sourceHeader to match so
-                                // that mixed-case originals (e.g. "en-GB") are found correctly.
-                                const sourceHeaderIndex = headerRow.indexOf(sourceHeader.toLowerCase());
-                                // Get the column index for the target locale
-                                const targetHeaderIndex = headerRow.indexOf(exactHeaderName);
-                                // Guard against unexpected out-of-range indices
-                                if (sourceHeaderIndex < 0 || targetHeaderIndex < 0) {
-                                    continue;
-                                }
-                                const sourceColumnLetter = columnIndexToLetter(sourceHeaderIndex);
-                                const targetColumnLetter = columnIndexToLetter(targetHeaderIndex);
-                                // Create improved Google Translate formula using INDIRECT and cell references
-                                // This formula dynamically references:
-                                // - INDIRECT(sourceColumn&ROW()) for the source text
-                                // - $sourceColumn$1 for the source language code from header
-                                // - targetColumn$1 for the target language code from header
-                                rowData[exactHeaderName] = `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW());$${sourceColumnLetter}$1;${targetColumnLetter}$1)`;
-                            }
-                        }
-                    }
-                }
-            }
-            const newRows = Array.from(newKeys.values());
-            // Add new rows in chunks to keep individual requests manageable
-            const CHUNK_SIZE = 5;
-            for (let i = 0; i < newRows.length; i += CHUNK_SIZE) {
-                const chunk = newRows.slice(i, i + CHUNK_SIZE);
-                await (0, rateLimiter_1.withRetry)(() => sheet.addRows(chunk), `addRows chunk ${Math.floor(i / CHUNK_SIZE) + 1} in ${sheetTitle}`, baseDelayMs);
-            }
-        }
-    }
-    console.log("Finished updating spreadsheet with local changes.");
-}
-//# sourceMappingURL=spreadsheetUpdater.js.map

package/dist/utils/spreadsheetUpdater.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spreadsheetUpdater.js","sourceRoot":"","sources":["../../src/utils/spreadsheetUpdater.ts"],"names":[],"mappings":"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"}

package/dist/utils/syncManager.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleBidirectionalSync = handleBidirectionalSync;
-const findLocalChanges_1 = require("./dataConverter/findLocalChanges");
-const spreadsheetUpdater_1 = require("./spreadsheetUpdater");
-const isDataJsonNewer_1 = require("./isDataJsonNewer");
-const readDataJson_1 = require("./readDataJson");
-/**
- * Checks if local changes need to be synced to the spreadsheet and performs the sync if needed
- * @param doc Google Spreadsheet document
- * @param dataJsonPath Path to the languageData.json file
- * @param translationsOutputDir Directory containing translation output files
- * @param syncLocalChanges Whether sync is enabled
- * @param autoTranslate Whether to auto-generate Google Translate formulas
- * @param spreadsheetData Current data from the spreadsheet
- * @param waitSeconds Time to wait between API calls
- * @param localeMapping Mapping from normalized locale codes to original spreadsheet headers
- * @returns Sync operation result
- */
-async function handleBidirectionalSync(doc, dataJsonPath, translationsOutputDir, syncLocalChanges, autoTranslate, spreadsheetData, waitSeconds, localeMapping = {}) {
-    const result = {
-        shouldRefresh: false,
-        hasChanges: false
-    };
-    // Check if languageData.json exists and read it
-    const localData = (0, readDataJson_1.readDataJson)(dataJsonPath);
-    const dataJsonExists = localData !== null;
-    // Check if we need to sync local changes to the spreadsheet
-    const shouldSyncToSheet = syncLocalChanges &&
-        dataJsonExists &&
-        (0, isDataJsonNewer_1.isDataJsonNewer)(dataJsonPath, translationsOutputDir);
-    if (!shouldSyncToSheet || !localData) {
-        return result;
-    }
-    console.log("Local languageData.json is newer than translation files. Checking for changes...");
-    // Find differences between local data and spreadsheet data
-    const changes = (0, findLocalChanges_1.findLocalChanges)(localData, spreadsheetData);
-    // Check if there are any actual changes
-    const hasChanges = Object.keys(changes).length > 0 &&
-        Object.keys(changes).some(locale => Object.keys(changes[locale]).length > 0);
-    if (!hasChanges) {
-        console.log("No local changes found that need to be synced to the spreadsheet.");
-        return result;
-    }
-    const localesCount = Object.keys(changes).length;
-    const keysCount = Object.values(changes)
-        .flatMap(l => Object.values(l))
-        .flatMap(s => Object.keys(s)).length;
-    console.log(`Found local changes: ${localesCount} locale(s), ~${keysCount} key(s) to sync to the spreadsheet.`);
-    // Update the spreadsheet with the changes, passing the autoTranslate option and locale mapping
-    try {
-        await (0, spreadsheetUpdater_1.updateSpreadsheetWithLocalChanges)(doc, changes, waitSeconds, autoTranslate, localeMapping);
-        result.shouldRefresh = true;
-        result.hasChanges = true;
-    }
-    catch (err) {
-        console.error("Failed to sync local changes to spreadsheet:", err);
-        // Do not set shouldRefresh; return unchanged result to avoid stale refresh loop
-    }
-    return result;
-}
-//# sourceMappingURL=syncManager.js.map

package/dist/utils/syncManager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncManager.js","sourceRoot":"","sources":["../../src/utils/syncManager.ts"],"names":[],"mappings":";;AA2BA,0DA6DC;AAtFD,uEAAoE;AACpE,6DAAyE;AACzE,uDAAoD;AACpD,iDAA8C;AAU9C;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,uBAAuB,CAC5C,GAAsB,EACtB,YAAoB,EACpB,qBAA6B,EAC7B,gBAAyB,EACzB,aAAsB,EACtB,eAAgC,EAChC,WAAmB,EACnB,gBAAwC,EAAE;IAE1C,MAAM,MAAM,GAAe;QAC1B,aAAa,EAAE,KAAK;QACpB,UAAU,EAAE,KAAK;KACjB,CAAC;IAEF,gDAAgD;IAChD,MAAM,SAAS,GAAG,IAAA,2BAAY,EAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;IAE1C,4DAA4D;IAC5D,MAAM,iBAAiB,GAAG,gBAAgB;QACzC,cAAc;QACd,IAAA,iCAAe,EAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;IAEtD,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAEhG,2DAA2D;IAC3D,MAAM,OAAO,GAAG,IAAA,mCAAgB,EAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAE7D,wCAAwC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAClC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CACvC,CAAC;IAEH,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;SACtC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC9B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,wBAAwB,YAAY,gBAAgB,SAAS,qCAAqC,CAAC,CAAC;IAEhH,+FAA+F;IAC/F,IAAI,CAAC;QACJ,MAAM,IAAA,sDAAiC,EAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QACjG,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,GAAG,CAAC,CAAC;QACnE,gFAAgF;IACjF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}