@el-j/google-sheet-translations 1.0.0

package/dist/utils/localeNormalizer.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Locale normalization utilities for converting simple language codes to full locale codes
+ * and maintaining mappings between normalized codes and original spreadsheet headers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeLocaleCode = normalizeLocaleCode;
+exports.createLocaleMapping = createLocaleMapping;
+exports.getOriginalHeaderForLocale = getOriginalHeaderForLocale;
+exports.getNormalizedLocaleForHeader = getNormalizedLocaleForHeader;
+/**
+ * Common language to country mappings for normalization
+ * Maps language codes to their most common country variants
+ */
+const LANGUAGE_TO_COUNTRY_MAP = {
+    'en': 'en-GB',
+    'de': 'de-DE',
+    'fr': 'fr-FR',
+    'es': 'es-ES',
+    'it': 'it-IT',
+    'pt': 'pt-PT',
+    'pl': 'pl-PL',
+    'ru': 'ru-RU',
+    'zh': 'zh-CN',
+    'ja': 'ja-JP',
+    'ko': 'ko-KR',
+    'ar': 'ar-SA',
+    'hi': 'hi-IN',
+    'th': 'th-TH',
+    'vi': 'vi-VN',
+    'tr': 'tr-TR',
+    'nl': 'nl-NL',
+    'sv': 'sv-SE',
+    'da': 'da-DK',
+    'no': 'no-NO',
+    'fi': 'fi-FI',
+    'cs': 'cs-CZ',
+    'sk': 'sk-SK',
+    'hu': 'hu-HU',
+    'ro': 'ro-RO',
+    'bg': 'bg-BG',
+    'hr': 'hr-HR',
+    'sl': 'sl-SI',
+    'et': 'et-EE',
+    'lv': 'lv-LV',
+    'lt': 'lt-LT',
+    'el': 'el-GR',
+    'he': 'he-IL',
+    'uk': 'uk-UA',
+    'be': 'be-BY',
+};
+/**
+ * Normalizes a language code to include country code if missing
+ * @param locale The original locale code from spreadsheet header
+ * @returns Normalized locale with country code
+ */
+function normalizeLocaleCode(locale) {
+    if (!locale || typeof locale !== 'string') {
+        return '';
+    }
+    const normalized = locale.toLowerCase().trim();
+    // If already has country code, return as is
+    if (normalized.includes('-') || normalized.includes('_')) {
+        return normalized;
+    }
+    // Look up the language in our mapping first
+    const withCountry = LANGUAGE_TO_COUNTRY_MAP[normalized];
+    if (withCountry) {
+        return withCountry;
+    }
+    // If not in mapping and it's a 2-letter code, append the same code in uppercase
+    // This handles cases like "pl" -> "pl-PL"
+    if (normalized.length === 2 && /^[a-z]{2}$/.test(normalized)) {
+        return `${normalized}-${normalized.toUpperCase()}`;
+    }
+    // Return original if we can't normalize it
+    return normalized;
+}
+/**
+ * Creates a mapping between normalized locale codes and their original spreadsheet headers
+ * @param originalHeaders Array of original header names from spreadsheet
+ * @param keyColumn The key column name to exclude
+ * @returns Object with normalized locales and header mapping
+ */
+function createLocaleMapping(originalHeaders, keyColumn) {
+    const localeMapping = {}; // normalized -> original
+    const originalMapping = {}; // original -> normalized
+    const normalizedLocales = [];
+    for (const header of originalHeaders) {
+        const headerLower = header.toLowerCase();
+        // Skip key column and non-locale headers
+        if (headerLower === keyColumn.toLowerCase()) {
+            continue;
+        }
+        // Check if this looks like a locale
+        const isLocale = /^[a-z]{2}([_-][a-z]{2})?([_-][a-z]+)?$/.test(headerLower);
+        if (!isLocale) {
+            continue;
+        }
+        const normalized = normalizeLocaleCode(headerLower);
+        localeMapping[normalized] = header; // Store original case
+        originalMapping[headerLower] = normalized;
+        normalizedLocales.push(normalized);
+    }
+    return {
+        normalizedLocales: [...new Set(normalizedLocales)], // Remove duplicates
+        localeMapping, // normalized -> original header
+        originalMapping // original header (lowercase) -> normalized
+    };
+}
+/**
+ * Finds the original header name for a given normalized locale
+ * @param normalizedLocale The normalized locale code (e.g., 'pl-PL')
+ * @param localeMapping Mapping from normalized locales to original headers
+ * @returns Original header name or undefined if not found
+ */
+function getOriginalHeaderForLocale(normalizedLocale, localeMapping) {
+    // Try direct lookup first
+    let result = localeMapping[normalizedLocale];
+    if (result)
+        return result;
+    // Try lowercase lookup if direct lookup fails
+    const lowercaseLocale = normalizedLocale.toLowerCase();
+    result = localeMapping[lowercaseLocale];
+    if (result)
+        return result;
+    // Try finding by case-insensitive key comparison
+    for (const [key, value] of Object.entries(localeMapping)) {
+        if (key.toLowerCase() === lowercaseLocale) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Finds the normalized locale for a given original header
+ * @public
+ * @param originalHeader The original header name (e.g., 'pl')
+ * @param originalMapping Mapping from original headers to normalized locales
+ * @returns Normalized locale code or undefined if not found
+ */
+function getNormalizedLocaleForHeader(originalHeader, originalMapping) {
+    return originalMapping[originalHeader.toLowerCase()];
+}
+//# sourceMappingURL=localeNormalizer.js.map

package/dist/utils/localeNormalizer.js.map

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

package/dist/utils/readDataJson.d.ts

@@ -0,0 +1,8 @@
+import type { TranslationData } from "../types";
+/**
+ * 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
+ */
+export declare function readDataJson(dataJsonPath: string): TranslationData | null;
+//# sourceMappingURL=readDataJson.d.ts.map

package/dist/utils/readDataJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readDataJson.d.ts","sourceRoot":"","sources":["../../src/utils/readDataJson.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAezE"}

package/dist/utils/readDataJson.js

@@ -0,0 +1,29 @@
+"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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,22 @@
+import type { GoogleSpreadsheetWorksheet } from "google-spreadsheet";
+import type { TranslationData } from "../types";
+/**
+ * Result of processing a single sheet
+ */
+export interface SheetProcessingResult {
+    translations: TranslationData;
+    locales: string[];
+    localeMapping: Record<string, string>;
+    originalMapping: Record<string, string>;
+    success: boolean;
+}
+/**
+ * Processes a single Google Sheet and extracts translation data
+ * @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 waitSeconds Time to wait after processing
+ * @returns Processing result containing translations and locales
+ */
+export declare function processSheet(sheet: GoogleSpreadsheetWorksheet, sheetTitle: string, rowLimit: number, waitSeconds: number): Promise<SheetProcessingResult>;
+//# sourceMappingURL=sheetProcessor.d.ts.map

package/dist/utils/sheetProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheetProcessor.d.ts","sourceRoot":"","sources":["../../src/utils/sheetProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,UAAU,CAAC;AAK1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,YAAY,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,0BAA0B,EACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,CA6FhC"}

package/dist/utils/sheetProcessor.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processSheet = processSheet;
+const wait_1 = require("./wait");
+const localeFilter_1 = require("./localeFilter");
+const localeNormalizer_1 = require("./localeNormalizer");
+/**
+ * Processes a single Google Sheet and extracts translation data
+ * @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 waitSeconds Time to wait after processing
+ * @returns Processing result containing translations and locales
+ */
+async function processSheet(sheet, sheetTitle, rowLimit, waitSeconds) {
+    const result = {
+        translations: {},
+        locales: [],
+        localeMapping: {},
+        originalMapping: {},
+        success: false
+    };
+    try {
+        const rows = await sheet.getRows({ limit: rowLimit });
+        if (!rows || rows.length === 0) {
+            console.warn(`No rows found in sheet "${sheetTitle}"`);
+            return result;
+        }
+        // Extract header information
+        const rowObject = rows[0].toObject();
+        const headerRow = Object.keys(rowObject).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(rowObject); // 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;
+        // Convert rows to data objects
+        const cells = rows.map(row => row.toObject());
+        // 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 = cells.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;
+        await (0, wait_1.wait)(waitSeconds, `after processing sheet: ${sheetTitle}`);
+    }
+    catch (error) {
+        console.error(`Error processing sheet "${sheetTitle}":`, error);
+    }
+    return result;
+}
+//# sourceMappingURL=sheetProcessor.js.map

package/dist/utils/sheetProcessor.js.map

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

package/dist/utils/spreadsheetUpdater.d.ts

@@ -0,0 +1,25 @@
+import type { GoogleSpreadsheet } from "google-spreadsheet";
+import type { TranslationData } from "../types";
+/**
+ * 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 - Number of seconds to wait between 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
+ */
+export declare function updateSpreadsheetWithLocalChanges(doc: GoogleSpreadsheet, changes: TranslationData, waitSeconds: number, autoTranslate?: boolean, localeMapping?: Record<string, string>): Promise<void>;
+//# sourceMappingURL=spreadsheetUpdater.d.ts.map

package/dist/utils/spreadsheetUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheetUpdater.d.ts","sourceRoot":"","sources":["../../src/utils/spreadsheetUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAehD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iCAAiC,CACnD,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,aAAa,UAAQ,EACrB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC3C,OAAO,CAAC,IAAI,CAAC,CA2Mf"}

package/dist/utils/spreadsheetUpdater.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSpreadsheetWithLocalChanges = updateSpreadsheetWithLocalChanges;
+const wait_1 = require("./wait");
+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 - Number of seconds to wait between 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...");
+    // 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
+        await (0, wait_1.wait)(waitSeconds, `before getting rows for sheet: ${sheetTitle}`);
+        const rows = await sheet.getRows();
+        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]));
+                        await (0, wait_1.wait)(waitSeconds / 2, `before updating row ${rowIndex}`);
+                        try {
+                            await row.save();
+                        }
+                        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
+                            if (localesWithValues.has(localeLower) || rowData[localeHeader]) {
+                                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
+                                // Get the column index for the source locale to build the reference
+                                const sourceHeaderIndex = headerRow.indexOf(sourceHeader);
+                                // 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());
+            await (0, wait_1.wait)(waitSeconds, `before adding ${newRows.length} new rows`);
+            // Add new rows in chunks to avoid rate limiting
+            const CHUNK_SIZE = 5;
+            for (let i = 0; i < newRows.length; i += CHUNK_SIZE) {
+                const chunk = newRows.slice(i, i + CHUNK_SIZE);
+                await sheet.addRows(chunk);
+                if (i + CHUNK_SIZE < newRows.length) {
+                    await (0, wait_1.wait)(waitSeconds, `after adding ${chunk.length} rows (chunk ${i / CHUNK_SIZE + 1})`);
+                }
+            }
+        }
+        await (0, wait_1.wait)(waitSeconds, `after updating sheet: ${sheetTitle}`);
+    }
+    console.log("Finished updating spreadsheet with local changes.");
+}
+//# sourceMappingURL=spreadsheetUpdater.js.map

package/dist/utils/spreadsheetUpdater.js.map

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

package/dist/utils/syncManager.d.ts

@@ -0,0 +1,23 @@
+import type { GoogleSpreadsheet } from "google-spreadsheet";
+import type { TranslationData } from "../types";
+/**
+ * Sync operation result
+ */
+export interface SyncResult {
+    shouldRefresh: boolean;
+    hasChanges: boolean;
+}
+/**
+ * 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
+ */
+export declare function handleBidirectionalSync(doc: GoogleSpreadsheet, dataJsonPath: string, translationsOutputDir: string, syncLocalChanges: boolean, autoTranslate: boolean, spreadsheetData: TranslationData, waitSeconds: number, localeMapping?: Record<string, string>): Promise<SyncResult>;
+//# sourceMappingURL=syncManager.d.ts.map

package/dist/utils/syncManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncManager.d.ts","sourceRoot":"","sources":["../../src/utils/syncManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,iBAAiB,EACtB,YAAY,EAAE,MAAM,EACpB,qBAAqB,EAAE,MAAM,EAC7B,gBAAgB,EAAE,OAAO,EACzB,aAAa,EAAE,OAAO,EACtB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACxC,OAAO,CAAC,UAAU,CAAC,CAoDrB"}