@el-j/google-sheet-translations 1.0.0

package/dist/utils/syncManager.js

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

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

package/dist/utils/validateEnv.d.ts

@@ -0,0 +1,9 @@
+import type { GoogleEnvVars } from "../types";
+/**
+ * Validates required environment variables for Google Sheets API
+ * @returns Object with validated environment variables
+ * @throws Error if any required environment variable is missing
+ */
+export declare function validateEnv(): GoogleEnvVars;
+export default validateEnv;
+//# sourceMappingURL=validateEnv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateEnv.d.ts","sourceRoot":"","sources":["../../src/utils/validateEnv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAuB3C;AAED,eAAe,WAAW,CAAC"}

package/dist/utils/validateEnv.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEnv = validateEnv;
+/**
+ * Validates required environment variables for Google Sheets API
+ * @returns Object with validated environment variables
+ * @throws Error if any required environment variable is missing
+ */
+function validateEnv() {
+    // Check for required environment variables
+    const requiredVars = [
+        "GOOGLE_CLIENT_EMAIL",
+        "GOOGLE_PRIVATE_KEY",
+        "GOOGLE_SPREADSHEET_ID",
+    ];
+    const missingVars = requiredVars.filter((varName) => !process.env[varName]);
+    if (missingVars.length > 0) {
+        throw new Error(`Missing required environment variables: ${missingVars.join(", ")}\n
+\nMake sure these are set in your .env file or environment.`);
+    }
+    // Return validated environment variables
+    return {
+        GOOGLE_CLIENT_EMAIL: process.env.GOOGLE_CLIENT_EMAIL,
+        GOOGLE_PRIVATE_KEY: process.env.GOOGLE_PRIVATE_KEY,
+        GOOGLE_SPREADSHEET_ID: process.env.GOOGLE_SPREADSHEET_ID,
+    };
+}
+exports.default = validateEnv;
+//# sourceMappingURL=validateEnv.js.map

package/dist/utils/validateEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEnv.js","sourceRoot":"","sources":["../../src/utils/validateEnv.ts"],"names":[],"mappings":";;AAOA,kCAuBC;AA5BD;;;;GAIG;AACH,SAAgB,WAAW;IAC1B,2CAA2C;IAC3C,MAAM,YAAY,GAA+B;QAChD,qBAAqB;QACrB,oBAAoB;QACpB,uBAAuB;KACvB,CAAC;IAEF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5E,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACd,2CAA2C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;4DACR,CACzD,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,OAAO;QACN,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAA6B;QAC9D,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAA4B;QAC5D,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,qBAA+B;KAClE,CAAC;AACH,CAAC;AAED,kBAAe,WAAW,CAAC"}

package/dist/utils/wait.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Creates a promise that resolves after a specified number of seconds
+ * @param seconds - The number of seconds to wait
+ * @param reason - A description of why we're waiting
+ * @returns A promise that resolves after the specified delay
+ */
+export declare function wait(seconds: number, reason: string): Promise<void>;
+export default wait;
+//# sourceMappingURL=wait.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnE;AAED,eAAe,IAAI,CAAC"}

package/dist/utils/wait.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wait = wait;
+/**
+ * Creates a promise that resolves after a specified number of seconds
+ * @param seconds - The number of seconds to wait
+ * @param reason - A description of why we're waiting
+ * @returns A promise that resolves after the specified delay
+ */
+function wait(seconds, reason) {
+    console.log("wait", seconds, reason);
+    return new Promise((resolve) => {
+        const timeoutId = setTimeout(() => {
+            resolve();
+        }, seconds * 1000);
+        // This ensures the timeout is properly cleared if the promise is garbage collected
+        timeoutId.unref?.();
+    });
+}
+exports.default = wait;
+//# sourceMappingURL=wait.js.map

package/dist/utils/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":";;AAMA,oBAUC;AAhBD;;;;;GAKG;AACH,SAAgB,IAAI,CAAC,OAAe,EAAE,MAAc;IACnD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACpC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,OAAO,EAAE,CAAC;QACX,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;QAEnB,mFAAmF;QACnF,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,kBAAe,IAAI,CAAC"}

package/package.json

@@ -0,0 +1,91 @@
+{
+	"name": "@el-j/google-sheet-translations",
+	"version": "1.0.0",
+	"description": "A package to manage translations stored in Google Spreadsheets",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"require": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist",
+		"LICENSE",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc",
+		"clean": "rimraf dist",
+		"prebuild": "npm run clean",
+		"prepare": "npm run build",
+		"test": "jest",
+		"lint": "eslint src/ --ext .ts --max-warnings 0",
+		"dev": "tsc --watch",
+		"release": "semantic-release",
+		"release:dry-run": "semantic-release --dry-run",
+		"docs:dev": "vitepress dev website",
+		"docs:build": "vitepress build website",
+		"docs:preview": "vitepress preview website"
+	},
+	"keywords": [
+		"google-sheets",
+		"translations",
+		"i18n",
+		"nextjs",
+		"typescript",
+		"auto-translation",
+		"machine-translation",
+		"google-translate",
+		"localization",
+		"internationalization",
+		"spreadsheet",
+		"google-api",
+		"google-spreadsheet"
+	],
+	"author": "el-j",
+	"license": "MIT",
+	"dependencies": {
+		"google-auth-library": "^10.1.0",
+		"google-spreadsheet": "^4.1.5"
+	},
+	"peerDependencies": {
+		"typescript": ">=4.0.0"
+	},
+	"devDependencies": {
+		"@eslint/js": "^10.0.1",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/commit-analyzer": "^13.0.1",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/github": "^12.0.6",
+		"@semantic-release/npm": "^13.1.5",
+		"@semantic-release/release-notes-generator": "^14.1.0",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^24.0.15",
+		"@typescript-eslint/eslint-plugin": "^8.56.1",
+		"@typescript-eslint/parser": "^8.56.1",
+		"conventional-changelog-conventionalcommits": "^9.3.0",
+		"dotenv": "17.2.0",
+		"eslint": "^10.0.3",
+		"jest": "^30.0.4",
+		"jest-mock-extended": "^4.0.0",
+		"rimraf": "^6.0.1",
+		"semantic-release": "^25.0.3",
+		"ts-jest": "^29.4.0",
+		"ts-node": "^10.9.2",
+		"typescript": "^5.8.3",
+		"vitepress": "^1.6.4"
+	},
+	"engines": {
+		"node": ">=14.18.0"
+	},
+	"overrides": {
+		"google-spreadsheet": {
+			"google-auth-library": "^10.1.0"
+		}
+	}
+}