@el-j/google-sheet-translations 1.0.2 → 1.2.0

package/README.md

@@ -11,6 +11,7 @@ A Node.js package for managing translations stored in Google Sheets.
 - ✅ **Modular Architecture**: Well-tested, maintainable codebase with clear separation of concerns
 - ✅ **Next.js Integration**: Built-in support for Next.js static export workflows
 - ✅ **Flexible Configuration**: Customizable paths, wait times, and processing options
+- ✅ **GitHub Action**: One-step CI integration via the bundled composite action
 
 ## Installation
 
@@ -94,7 +95,7 @@ Fetches and processes data from a Google Spreadsheet.
 - `sheetTitles`: (Optional) Array of sheet titles to process. If not provided, only the "i18n" sheet will be processed.
 - `options`: (Optional) Configuration object
   - `rowLimit`: Number - Maximum number of rows to fetch (default: 100)
-  - `waitSeconds`: Number - Time to wait between API calls (default: 1)
+  - `waitSeconds`: Number - Base back-off delay in seconds for retrying rate-limited API calls (HTTP 429/503). Actual delay per retry is `waitSeconds × 2^attempt`, capped at 30 s. (default: 1)
   - `dataJsonPath`: String - Path for languageData.json file (default: 'src/lib/languageData.json')
   - `localesOutputPath`: String - Path for locales.ts file (default: 'src/i18n/locales.ts')
   - `translationsOutputDir`: String - Directory for translations output (default: 'translations')
@@ -187,6 +188,37 @@ console.log(validLocales); // ['en', 'de']
 const config = normalizeConfig({ waitSeconds: 2 });
 ```
 
+## Auto-Creating a Spreadsheet
+
+When no `GOOGLE_SPREADSHEET_ID` is set (and `autoCreate` is not `false`), the package automatically creates a new Google Spreadsheet on first run using your service-account credentials:
+
+```typescript
+// No spreadsheetId needed — the package creates one for you
+const translations = await getSpreadSheetData(['i18n'], {
+  spreadsheetTitle: 'MyProject Translations',
+  sourceLocale: 'en',
+  targetLocales: ['de', 'fr', 'es'],
+});
+```
+
+The created spreadsheet includes:
+- A **`__welcome__`** sheet with setup instructions and your spreadsheet ID.
+- An **`i18n`** starter sheet with common translation keys and `GOOGLETRANSLATE` formulas for each target locale.
+
+The new spreadsheet ID is printed prominently to the console and, if a `.env` file exists in your working directory, is written to it automatically:
+
+```
+✅ New spreadsheet created!
+   Title  : MyProject Translations
+   URL    : https://docs.google.com/spreadsheets/d/...
+   ID     : 1abc...xyz
+
+   Add this to your .env file (or environment):
+   GOOGLE_SPREADSHEET_ID=1abc...xyz
+```
+
+Set `autoCreate: false` to disable this behaviour and require an explicit ID.
+
 ## Bidirectional Sync Feature
 
 This package supports bidirectional synchronization between local translation files and the Google Spreadsheet:
@@ -253,6 +285,102 @@ For more detailed examples, check out the [examples directory](examples) where y
 - Auto-translation
 - Next.js integration
 
+## GitHub Action
+
+This repository ships a composite GitHub Action that lets you fetch translations
+in any workflow **without writing any Node.js scripts yourself**.
+
+### Quick start
+
+Add the following step to your workflow after checking out your repository:
+
+```yaml
+- name: Fetch translations
+  uses: el-j/google-sheet-translations@v1   # pin to a specific release tag for stability
+  with:
+    google-client-email:   ${{ secrets.GOOGLE_CLIENT_EMAIL }}
+    google-private-key:    ${{ secrets.GOOGLE_PRIVATE_KEY }}
+    google-spreadsheet-id: ${{ secrets.GOOGLE_SPREADSHEET_ID }}
+    sheet-titles: 'landingPage,about'       # comma-separated sheet tab names
+```
+
+### Inputs
+
+| Input | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `google-client-email` | ✅ | — | Service-account e-mail (`GOOGLE_CLIENT_EMAIL`) |
+| `google-private-key` | ✅ | — | Service-account private key (`GOOGLE_PRIVATE_KEY`) |
+| `google-spreadsheet-id` | ✅ | — | Spreadsheet ID from the sheet URL (`GOOGLE_SPREADSHEET_ID`) |
+| `sheet-titles` | ✅ | — | Comma-separated list of sheet tab names to process |
+| `row-limit` | ❌ | `100` | Maximum rows to read per sheet |
+| `wait-seconds` | ❌ | `1` | Base back-off delay in seconds for retrying rate-limited API calls (HTTP 429/503) |
+| `translations-output-dir` | ❌ | `translations` | Directory for per-locale JSON files |
+| `locales-output-path` | ❌ | `src/i18n/locales.ts` | Path for the generated `locales.ts` |
+| `data-json-path` | ❌ | `src/lib/languageData.json` | Path for the `languageData.json` snapshot |
+| `sync-local-changes` | ❌ | `true` | Push local changes back to the sheet before fetching |
+| `node-version` | ❌ | `20` | Node.js version used to run the fetch script |
+| `package-version` | ❌ | `latest` | Version of `@el-j/google-sheet-translations` to install |
+
+### Outputs
+
+| Output | Description |
+|--------|-------------|
+| `translations-dir` | Absolute path of the directory containing locale JSON files |
+| `locales-file` | Absolute path of the generated `locales.ts` |
+| `data-json-file` | Absolute path of the `languageData.json` snapshot |
+
+### Full workflow example
+
+```yaml
+name: Update Translations
+
+on:
+  schedule:
+    - cron: '0 6 * * 1'   # every Monday at 06:00 UTC
+  workflow_dispatch:
+
+jobs:
+  update-translations:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Fetch translations
+        id: translations
+        uses: el-j/google-sheet-translations@v1
+        with:
+          google-client-email:   ${{ secrets.GOOGLE_CLIENT_EMAIL }}
+          google-private-key:    ${{ secrets.GOOGLE_PRIVATE_KEY }}
+          google-spreadsheet-id: ${{ secrets.GOOGLE_SPREADSHEET_ID }}
+          sheet-titles:          'landingPage,about'
+          translations-output-dir: 'src/translations'
+          locales-output-path:     'src/i18n/locales.ts'
+          data-json-path:          'src/lib/languageData.json'
+
+      - name: Commit updated translations
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: 'chore(i18n): update translations from Google Sheets'
+          file_pattern: |
+            ${{ steps.translations.outputs.translations-dir }}/**
+            ${{ steps.translations.outputs.locales-file }}
+            ${{ steps.translations.outputs.data-json-file }}
+```
+
+### Required secrets
+
+Store these as [encrypted repository secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets):
+
+| Secret | Description |
+|--------|-------------|
+| `GOOGLE_CLIENT_EMAIL` | Service-account e-mail from your Google Cloud credentials JSON |
+| `GOOGLE_PRIVATE_KEY` | Private key from your Google Cloud credentials JSON (include the full PEM block) |
+| `GOOGLE_SPREADSHEET_ID` | The long ID found in the spreadsheet URL: `…/spreadsheets/d/<ID>/edit` |
+
 ## License
 
 MIT

package/dist/getSpreadSheetData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getSpreadSheetData.d.ts","sourceRoot":"","sources":["../src/getSpreadSheetData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAIxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAUhC,wBAAsB,kBAAkB,CACvC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,kBAAuB,EAChC,aAAa,SAAI,GACf,OAAO,CAAC,eAAe,CAAC,CAiI1B;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"getSpreadSheetData.d.ts","sourceRoot":"","sources":["../src/getSpreadSheetData.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAOxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAsChC,wBAAsB,kBAAkB,CACvC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,kBAAuB,EAChC,aAAa,SAAI,GACf,OAAO,CAAC,eAAe,CAAC,CAyJ1B;AAED,eAAe,kBAAkB,CAAC"}

package/dist/getSpreadSheetData.js

@@ -1,118 +1,167 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_WAIT_SECONDS = void 0;
 exports.getSpreadSheetData = getSpreadSheetData;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const google_spreadsheet_1 = require("google-spreadsheet");
-const wait_1 = require("./utils/wait");
 const auth_1 = require("./utils/auth");
-const validateEnv_1 = require("./utils/validateEnv");
 const configurationHandler_1 = require("./utils/configurationHandler");
 const sheetProcessor_1 = require("./utils/sheetProcessor");
 const fileWriter_1 = require("./utils/fileWriter");
 const syncManager_1 = require("./utils/syncManager");
+const rateLimiter_1 = require("./utils/rateLimiter");
+const publicSheetReader_1 = require("./utils/publicSheetReader");
+const spreadsheetCreator_1 = require("./utils/spreadsheetCreator");
 const constants_1 = require("./constants");
 Object.defineProperty(exports, "DEFAULT_WAIT_SECONDS", { enumerable: true, get: function () { return constants_1.DEFAULT_WAIT_SECONDS; } });
 /**
- * Fetches and processes data from a Google Spreadsheet
- * @param _docTitle - Array of sheet titles to process
- * @param options - Additional options for fetching data
- * @returns Processed translation data
+ * Fetches and processes data from a Google Spreadsheet.
+ *
+ * Modes:
+ * - **Authenticated** (default): uses a Google Cloud service account.
+ *   Supports bidirectional sync, auto-translate, and auto-create.
+ * - **Public** (`publicSheet: true`): reads via the Google Visualization API
+ *   with no credentials. The spreadsheet must be shared publicly.
+ *
+ * **Auto-create**: when no spreadsheet ID is available and `autoCreate` is true
+ * (the default), a new spreadsheet is created automatically on first run.
  */
 const MAX_SYNC_REFRESH_DEPTH = 1;
-async function getSpreadSheetData(_docTitle, options = {}, _refreshDepth = 0) {
-    // Normalize configuration with defaults
-    const config = (0, configurationHandler_1.normalizeConfig)(options);
-    // Get spreadsheet ID from environment variables
-    const { GOOGLE_SPREADSHEET_ID } = (0, validateEnv_1.validateEnv)();
-    // Initialize Google Spreadsheet connection
-    const serviceAuthClient = (0, auth_1.createAuthClient)();
-    const doc = new google_spreadsheet_1.GoogleSpreadsheet(GOOGLE_SPREADSHEET_ID, serviceAuthClient);
+/** Appends (or updates) GOOGLE_SPREADSHEET_ID in .env when the file exists. */
+async function persistSpreadsheetId(id) {
+    const envPath = node_path_1.default.join(process.cwd(), '.env');
     try {
-        await doc.loadInfo(true);
+        let content = '';
+        if (node_fs_1.default.existsSync(envPath)) {
+            content = node_fs_1.default.readFileSync(envPath, 'utf8');
+            if (/^GOOGLE_SPREADSHEET_ID=/m.test(content)) {
+                content = content.replace(/^GOOGLE_SPREADSHEET_ID=.*/m, `GOOGLE_SPREADSHEET_ID=${id}`);
+            }
+            else {
+                content = content.trimEnd() + `\nGOOGLE_SPREADSHEET_ID=${id}\n`;
+            }
+        }
+        else {
+            content = `GOOGLE_SPREADSHEET_ID=${id}\n`;
+        }
+        node_fs_1.default.writeFileSync(envPath, content, 'utf8');
+        console.log(`   Saved GOOGLE_SPREADSHEET_ID to ${envPath}`);
     }
     catch (err) {
-        throw new Error(`Failed to load spreadsheet "${GOOGLE_SPREADSHEET_ID}"`, { cause: err });
+        console.warn(`   Could not write .env: ${err.message}`);
     }
-    // Prepare sheet titles to process
+}
+async function getSpreadSheetData(_docTitle, options = {}, _refreshDepth = 0) {
+    const config = (0, configurationHandler_1.normalizeConfig)(options);
+    const baseDelayMs = config.waitSeconds * 1000;
     const docTitle = _docTitle ?? [];
     if (docTitle.length === 0) {
         console.warn("No sheet titles provided, cannot process spreadsheet data");
         return {};
     }
-    // Always include i18n sheet if not already present
     if (!docTitle.includes("i18n")) {
         docTitle.push("i18n");
     }
-    console.log(`Processing ${docTitle.length} sheets: ${docTitle.join(", ")}`);
-    // Initialize result containers
     const finalTranslations = {};
     const allLocales = new Set();
-    const localesWithContent = new Set(); // Track locales with actual translations in non-i18n sheets
-    const globalLocaleMapping = {}; // normalized -> original header
-    const globalOriginalMapping = {}; // original header -> normalized
-    // Process each sheet in parallel
-    await Promise.all(docTitle.map(async (title) => {
-        await (0, wait_1.wait)(config.waitSeconds, `before get cells for sheet: ${title}`);
-        const sheet = doc.sheetsByTitle[title];
-        if (!sheet) {
-            console.warn(`Sheet "${title}" not found in the document`);
+    const localesWithContent = new Set();
+    const globalLocaleMapping = {};
+    const globalOriginalMapping = {};
+    function mergeResult(result, title) {
+        if (!result.success)
             return;
+        for (const [normalized, original] of Object.entries(result.localeMapping)) {
+            if (!globalLocaleMapping[normalized])
+                globalLocaleMapping[normalized] = original;
+        }
+        for (const [original, normalized] of Object.entries(result.originalMapping)) {
+            if (!globalOriginalMapping[original])
+                globalOriginalMapping[original] = normalized;
+        }
+        for (const locale of result.locales) {
+            if (finalTranslations[locale]) {
+                finalTranslations[locale] = { ...finalTranslations[locale], ...result.translations[locale] };
+            }
+            else {
+                finalTranslations[locale] = result.translations[locale];
+            }
+            allLocales.add(locale);
+            if (title !== "i18n" && result.translations[locale]) {
+                const hasActualTranslations = Object.values(result.translations[locale]).some((sheetTranslations) => Object.keys(sheetTranslations).length > 0);
+                if (hasActualTranslations)
+                    localesWithContent.add(locale);
+            }
+        }
+    }
+    if (config.publicSheet) {
+        // ── Public (unauthenticated) path ──────────────────────────────────────
+        const spreadsheetId = config.spreadsheetId ?? process.env.GOOGLE_SPREADSHEET_ID;
+        if (!spreadsheetId) {
+            throw new Error("No spreadsheet ID provided. Set GOOGLE_SPREADSHEET_ID or pass spreadsheetId in options.");
         }
-        const result = await (0, sheetProcessor_1.processSheet)(sheet, title, config.rowLimit, config.waitSeconds);
-        if (result.success) {
-            // Merge locale mappings - prioritize first occurrence for consistency
-            for (const [normalized, original] of Object.entries(result.localeMapping)) {
-                if (!globalLocaleMapping[normalized]) {
-                    globalLocaleMapping[normalized] = original;
-                }
+        console.log(`Processing ${docTitle.length} sheets: ${docTitle.join(", ")}`);
+        await Promise.all(docTitle.map(async (title) => {
+            let rows;
+            try {
+                rows = await (0, rateLimiter_1.withRetry)(() => (0, publicSheetReader_1.readPublicSheet)(spreadsheetId, title), `readPublicSheet: ${title}`, baseDelayMs);
+            }
+            catch (err) {
+                console.warn(`Sheet "${title}" could not be fetched: ${err.message}`);
+                return;
+            }
+            mergeResult(await (0, sheetProcessor_1.processRawRows)(rows, title), title);
+        }));
+    }
+    else {
+        // ── Authenticated path ─────────────────────────────────────────────────
+        const serviceAuthClient = (0, auth_1.createAuthClient)();
+        // Resolve spreadsheet ID: option > env var > auto-create
+        let spreadsheetId = config.spreadsheetId ?? process.env.GOOGLE_SPREADSHEET_ID;
+        if (!spreadsheetId) {
+            if (config.autoCreate) {
+                const created = await (0, spreadsheetCreator_1.createSpreadsheet)(serviceAuthClient, {
+                    title: config.spreadsheetTitle,
+                    sourceLocale: config.sourceLocale,
+                    targetLocales: config.targetLocales,
+                });
+                spreadsheetId = created.spreadsheetId;
+                await persistSpreadsheetId(spreadsheetId);
             }
-            for (const [original, normalized] of Object.entries(result.originalMapping)) {
-                if (!globalOriginalMapping[original]) {
-                    globalOriginalMapping[original] = normalized;
-                }
+            else {
+                throw new Error("No spreadsheet ID provided. Set GOOGLE_SPREADSHEET_ID or pass spreadsheetId in options.");
             }
-            // Merge translations from this sheet into final result
-            for (const locale of result.locales) {
-                if (finalTranslations[locale]) {
-                    finalTranslations[locale] = {
-                        ...finalTranslations[locale],
-                        ...result.translations[locale]
-                    };
-                }
-                else {
-                    finalTranslations[locale] = result.translations[locale];
-                }
-                allLocales.add(locale);
-                // Only track locales with content from non-i18n sheets
-                if (title !== "i18n" && result.translations[locale] && Object.keys(result.translations[locale]).length > 0) {
-                    // Check if this locale actually has translation content (not just empty objects)
-                    const hasActualTranslations = Object.values(result.translations[locale]).some(sheetTranslations => Object.keys(sheetTranslations).length > 0);
-                    if (hasActualTranslations) {
-                        localesWithContent.add(locale);
-                    }
-                }
+        }
+        console.log(`Processing ${docTitle.length} sheets: ${docTitle.join(", ")}`);
+        const doc = new google_spreadsheet_1.GoogleSpreadsheet(spreadsheetId, serviceAuthClient);
+        try {
+            await (0, rateLimiter_1.withRetry)(() => doc.loadInfo(true), "loadInfo", baseDelayMs);
+        }
+        catch (err) {
+            throw new Error(`Failed to load spreadsheet "${spreadsheetId}"`, { cause: err });
+        }
+        await Promise.all(docTitle.map(async (title) => {
+            const sheet = doc.sheetsByTitle[title];
+            if (!sheet) {
+                console.warn(`Sheet "${title}" not found in the document`);
+                return;
             }
+            mergeResult(await (0, sheetProcessor_1.processSheet)(sheet, title, config.rowLimit, baseDelayMs), title);
+        }));
+        const syncResult = await (0, syncManager_1.handleBidirectionalSync)(doc, config.dataJsonPath, config.translationsOutputDir, config.syncLocalChanges, config.autoTranslate, finalTranslations, config.waitSeconds, globalLocaleMapping);
+        if (syncResult.shouldRefresh && _refreshDepth < MAX_SYNC_REFRESH_DEPTH) {
+            return getSpreadSheetData(_docTitle, { ...options, syncLocalChanges: false }, _refreshDepth + 1);
         }
-    }));
-    // Use locales with actual content for the locales file, fall back to all locales if none found
+    }
     const localesForOutput = localesWithContent.size > 0 ? Array.from(localesWithContent) : Array.from(allLocales);
     const allLocalesArray = Array.from(allLocales);
-    // Handle bidirectional sync if needed
-    const syncResult = await (0, syncManager_1.handleBidirectionalSync)(doc, config.dataJsonPath, config.translationsOutputDir, config.syncLocalChanges, config.autoTranslate, finalTranslations, config.waitSeconds, globalLocaleMapping);
-    // If sync requested a refresh, recursively call with updated data (depth-limited)
-    if (syncResult.shouldRefresh && _refreshDepth < MAX_SYNC_REFRESH_DEPTH) {
-        return getSpreadSheetData(_docTitle, {
-            ...options,
-            syncLocalChanges: false,
-        }, _refreshDepth + 1);
-    }
-    // Write output files - use all locales for translation files but filtered locales for locales.ts
     (0, fileWriter_1.writeTranslationFiles)(finalTranslations, allLocalesArray, config.translationsOutputDir);
     (0, fileWriter_1.writeLocalesFile)(localesForOutput, globalLocaleMapping, config.localesOutputPath);
     console.log(`Writing locales file with ${localesForOutput.length} locales that have actual translations:`, localesForOutput);
-    // Write languageData.json if we have fresh data or it doesn't exist
-    const hasData = Object.keys(finalTranslations).length > 0;
-    if (hasData) {
+    if (Object.keys(finalTranslations).length > 0) {
         (0, fileWriter_1.writeLanguageDataFile)(finalTranslations, allLocalesArray, config.dataJsonPath);
     }
     return finalTranslations;

package/dist/getSpreadSheetData.js.map

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

package/dist/index.d.ts

@@ -5,12 +5,16 @@
 export { getSpreadSheetData, DEFAULT_WAIT_SECONDS } from './getSpreadSheetData';
 export type { SpreadsheetOptions } from './utils/configurationHandler';
 export { wait } from './utils/wait';
+export { withRetry } from './utils/rateLimiter';
 export { validateEnv } from './utils/validateEnv';
 export { createAuthClient } from './utils/auth';
 export { convertToDataJsonFormat } from './utils/dataConverter/convertToDataJsonFormat';
 export { convertFromDataJsonFormat } from './utils/dataConverter/convertFromDataJsonFormat';
 export { findLocalChanges } from './utils/dataConverter/findLocalChanges';
 export { updateSpreadsheetWithLocalChanges } from './utils/spreadsheetUpdater';
+export { readPublicSheet } from './utils/publicSheetReader';
+export { createSpreadsheet } from './utils/spreadsheetCreator';
+export { validateCredentials } from './utils/validateEnv';
 export { isValidLocale, filterValidLocales } from './utils/localeFilter';
 export type { TranslationData, TranslationValue, SheetRow, GoogleEnvVars, } from './types';
 import { getSpreadSheetData } from './getSpreadSheetData';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGzE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGzE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,eAAe,kBAAkB,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@
  * v2.0.0 – public API surface
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterValidLocales = exports.isValidLocale = exports.updateSpreadsheetWithLocalChanges = exports.findLocalChanges = exports.convertFromDataJsonFormat = exports.convertToDataJsonFormat = exports.createAuthClient = exports.validateEnv = exports.wait = exports.DEFAULT_WAIT_SECONDS = exports.getSpreadSheetData = void 0;
+exports.filterValidLocales = exports.isValidLocale = exports.validateCredentials = exports.createSpreadsheet = exports.readPublicSheet = exports.updateSpreadsheetWithLocalChanges = exports.findLocalChanges = exports.convertFromDataJsonFormat = exports.convertToDataJsonFormat = exports.createAuthClient = exports.validateEnv = exports.withRetry = exports.wait = exports.DEFAULT_WAIT_SECONDS = exports.getSpreadSheetData = void 0;
 // Main entry point
 var getSpreadSheetData_1 = require("./getSpreadSheetData");
 Object.defineProperty(exports, "getSpreadSheetData", { enumerable: true, get: function () { return getSpreadSheetData_1.getSpreadSheetData; } });
@@ -12,6 +12,8 @@ Object.defineProperty(exports, "DEFAULT_WAIT_SECONDS", { enumerable: true, get:
 // Utility functions required by dependents
 var wait_1 = require("./utils/wait");
 Object.defineProperty(exports, "wait", { enumerable: true, get: function () { return wait_1.wait; } });
+var rateLimiter_1 = require("./utils/rateLimiter");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return rateLimiter_1.withRetry; } });
 var validateEnv_1 = require("./utils/validateEnv");
 Object.defineProperty(exports, "validateEnv", { enumerable: true, get: function () { return validateEnv_1.validateEnv; } });
 var auth_1 = require("./utils/auth");
@@ -24,6 +26,14 @@ var findLocalChanges_1 = require("./utils/dataConverter/findLocalChanges");
 Object.defineProperty(exports, "findLocalChanges", { enumerable: true, get: function () { return findLocalChanges_1.findLocalChanges; } });
 var spreadsheetUpdater_1 = require("./utils/spreadsheetUpdater");
 Object.defineProperty(exports, "updateSpreadsheetWithLocalChanges", { enumerable: true, get: function () { return spreadsheetUpdater_1.updateSpreadsheetWithLocalChanges; } });
+// Public (unauthenticated) sheet reader
+var publicSheetReader_1 = require("./utils/publicSheetReader");
+Object.defineProperty(exports, "readPublicSheet", { enumerable: true, get: function () { return publicSheetReader_1.readPublicSheet; } });
+// Auto-create spreadsheet utility
+var spreadsheetCreator_1 = require("./utils/spreadsheetCreator");
+Object.defineProperty(exports, "createSpreadsheet", { enumerable: true, get: function () { return spreadsheetCreator_1.createSpreadsheet; } });
+var validateEnv_2 = require("./utils/validateEnv");
+Object.defineProperty(exports, "validateCredentials", { enumerable: true, get: function () { return validateEnv_2.validateCredentials; } });
 // Locale validation utilities (useful standalone)
 var localeFilter_1 = require("./utils/localeFilter");
 Object.defineProperty(exports, "isValidLocale", { enumerable: true, get: function () { return localeFilter_1.isValidLocale; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mBAAmB;AACnB,2DAAgF;AAAvE,wHAAA,kBAAkB,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAKjD,2CAA2C;AAC3C,qCAAoC;AAA3B,4FAAA,IAAI,OAAA;AACb,mDAAkD;AAAzC,0GAAA,WAAW,OAAA;AACpB,qCAAgD;AAAvC,wGAAA,gBAAgB,OAAA;AACzB,yFAAwF;AAA/E,kIAAA,uBAAuB,OAAA;AAChC,6FAA4F;AAAnF,sIAAA,yBAAyB,OAAA;AAClC,2EAA0E;AAAjE,oHAAA,gBAAgB,OAAA;AACzB,iEAA+E;AAAtE,uIAAA,iCAAiC,OAAA;AAE1C,kDAAkD;AAClD,qDAAyE;AAAhE,6GAAA,aAAa,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAU1C,iBAAiB;AACjB,6DAA0D;AAC1D,kBAAe,uCAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mBAAmB;AACnB,2DAAgF;AAAvE,wHAAA,kBAAkB,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAKjD,2CAA2C;AAC3C,qCAAoC;AAA3B,4FAAA,IAAI,OAAA;AACb,mDAAgD;AAAvC,wGAAA,SAAS,OAAA;AAClB,mDAAkD;AAAzC,0GAAA,WAAW,OAAA;AACpB,qCAAgD;AAAvC,wGAAA,gBAAgB,OAAA;AACzB,yFAAwF;AAA/E,kIAAA,uBAAuB,OAAA;AAChC,6FAA4F;AAAnF,sIAAA,yBAAyB,OAAA;AAClC,2EAA0E;AAAjE,oHAAA,gBAAgB,OAAA;AACzB,iEAA+E;AAAtE,uIAAA,iCAAiC,OAAA;AAE1C,wCAAwC;AACxC,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AAExB,kCAAkC;AAClC,iEAA+D;AAAtD,uHAAA,iBAAiB,OAAA;AAC1B,mDAA0D;AAAjD,kHAAA,mBAAmB,OAAA;AAE5B,kDAAkD;AAClD,qDAAyE;AAAhE,6GAAA,aAAa,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAU1C,iBAAiB;AACjB,6DAA0D;AAC1D,kBAAe,uCAAkB,CAAC"}

package/dist/utils/auth.js

@@ -8,7 +8,7 @@ const validateEnv_1 = require("./validateEnv");
  * @returns JWT authentication client
  */
 function createAuthClient() {
-    const { GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY } = (0, validateEnv_1.validateEnv)();
+    const { GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY } = (0, validateEnv_1.validateCredentials)();
     // GitHub Actions (and many CI systems) store secrets with literal `\n`
     // instead of real newlines. The PEM key must have actual newlines for
     // OpenSSL to parse it; replace any escaped sequences before use.

package/dist/utils/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":";;AAOA,4CAaC;AApBD,6DAA0C;AAC1C,+CAA4C;AAE5C;;;GAGG;AACH,SAAgB,gBAAgB;IAC/B,MAAM,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,GAAG,IAAA,yBAAW,GAAE,CAAC;IAElE,uEAAuE;IACvE,sEAAsE;IACtE,iEAAiE;IACjE,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE/D,OAAO,IAAI,yBAAG,CAAC;QACd,KAAK,EAAE,mBAAmB;QAC1B,GAAG,EAAE,aAAa;QAClB,MAAM,EAAE,CAAC,8CAA8C,CAAC;KACxD,CAAC,CAAC;AACJ,CAAC;AAED,kBAAe,gBAAgB,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":";;AAOA,4CAaC;AApBD,6DAA0C;AAC1C,+CAAoD;AAEpD;;;GAGG;AACH,SAAgB,gBAAgB;IAC/B,MAAM,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,GAAG,IAAA,iCAAmB,GAAE,CAAC;IAE1E,uEAAuE;IACvE,sEAAsE;IACtE,iEAAiE;IACjE,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE/D,OAAO,IAAI,yBAAG,CAAC;QACd,KAAK,EAAE,mBAAmB;QAC1B,GAAG,EAAE,aAAa;QAClB,MAAM,EAAE,CAAC,8CAA8C,CAAC;KACxD,CAAC,CAAC;AACJ,CAAC;AAED,kBAAe,gBAAgB,CAAC"}

package/dist/utils/configurationHandler.d.ts

@@ -3,12 +3,50 @@
  */
 export interface SpreadsheetOptions {
     rowLimit?: number;
+    /**
+     * Base back-off delay in seconds used when retrying Google Sheets API
+     * calls that fail with a rate-limit response (HTTP 429 / 503).
+     * The actual delay for each retry attempt is `waitSeconds * 2^attempt`,
+     * capped at 30 seconds.  Defaults to 1.
+     */
     waitSeconds?: number;
     dataJsonPath?: string;
     localesOutputPath?: string;
     translationsOutputDir?: string;
     syncLocalChanges?: boolean;
     autoTranslate?: boolean;
+    /**
+     * Google Spreadsheet ID.
+     * Overrides the `GOOGLE_SPREADSHEET_ID` environment variable when provided.
+     */
+    spreadsheetId?: string;
+    /**
+     * When `true`, the spreadsheet is read through the Google Visualization
+     * API without any service-account credentials.
+     *
+     * The spreadsheet must be shared as **"Anyone with link can view"** (or
+     * broader). Bidirectional sync and auto-translate are unavailable in
+     * this mode because they require write access.
+     */
+    publicSheet?: boolean;
+    /**
+     * Automatically create a new Google Spreadsheet when no spreadsheetId is
+     * available and the caller is in authenticated mode.
+     * Default: `true` (creation happens on the first run when no ID is set).
+     */
+    autoCreate?: boolean;
+    /** Title for the auto-created spreadsheet (default: "google-sheet-translations"). */
+    spreadsheetTitle?: string;
+    /**
+     * Source locale used when seeding the auto-created spreadsheet with
+     * GOOGLETRANSLATE formulas (default: "en").
+     */
+    sourceLocale?: string;
+    /**
+     * Target locales for GOOGLETRANSLATE formulas in the auto-created spreadsheet.
+     * Default: ['de', 'fr', 'es', 'it', 'pt', 'ja', 'zh'].
+     */
+    targetLocales?: string[];
 }
 /**
  * Normalized configuration with all defaults applied
@@ -21,6 +59,12 @@ export interface NormalizedConfig {
     translationsOutputDir: string;
     syncLocalChanges: boolean;
     autoTranslate: boolean;
+    spreadsheetId: string | undefined;
+    publicSheet: boolean;
+    autoCreate: boolean;
+    spreadsheetTitle: string;
+    sourceLocale: string;
+    targetLocales: string[];
 }
 /**
  * Normalizes configuration options by applying defaults

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

@@ -1 +1 @@
-{"version":3,"file":"configurationHandler.d.ts","sourceRoot":"","sources":["../../src/utils/configurationHandler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,CAUlF"}
+{"version":3,"file":"configurationHandler.d.ts","sourceRoot":"","sources":["../../src/utils/configurationHandler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,CAgBlF"}

package/dist/utils/configurationHandler.js

@@ -14,10 +14,16 @@ function normalizeConfig(options = {}) {
         rowLimit: options.rowLimit ?? 100,
         waitSeconds: options.waitSeconds ?? constants_1.DEFAULT_WAIT_SECONDS,
         dataJsonPath: options.dataJsonPath ?? node_path_1.default.join(process.cwd(), "src/lib/languageData.json"),
-        localesOutputPath: options.localesOutputPath ?? "src/i18n/locales.ts",
-        translationsOutputDir: options.translationsOutputDir ?? "translations",
+        localesOutputPath: options.localesOutputPath ?? node_path_1.default.join(process.cwd(), "src/i18n/locales.ts"),
+        translationsOutputDir: options.translationsOutputDir ?? node_path_1.default.join(process.cwd(), "translations"),
         syncLocalChanges: options.syncLocalChanges !== false, // Default to true
         autoTranslate: options.autoTranslate === true, // Default to false
+        spreadsheetId: options.spreadsheetId,
+        publicSheet: options.publicSheet === true, // Default to false
+        autoCreate: options.autoCreate !== false, // Default to true
+        spreadsheetTitle: options.spreadsheetTitle ?? 'google-sheet-translations',
+        sourceLocale: options.sourceLocale ?? 'en',
+        targetLocales: options.targetLocales ?? ['de', 'fr', 'es', 'it', 'pt', 'ja', 'zh'],
     };
 }
 //# sourceMappingURL=configurationHandler.js.map

package/dist/utils/configurationHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"configurationHandler.js","sourceRoot":"","sources":["../../src/utils/configurationHandler.ts"],"names":[],"mappings":";;;;;AAgCA,0CAUC;AA1CD,0DAA6B;AAC7B,4CAAoD;AA4BpD;;GAEG;AACH,SAAgB,eAAe,CAAC,UAA8B,EAAE;IAC/D,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG;QACjC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,gCAAoB;QACxD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,2BAA2B,CAAC;QAC3F,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,qBAAqB;QACrE,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,cAAc;QACtE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,KAAK,KAAK,EAAE,kBAAkB;QACxE,aAAa,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,mBAAmB;KAClE,CAAC;AACH,CAAC"}
+{"version":3,"file":"configurationHandler.js","sourceRoot":"","sources":["../../src/utils/configurationHandler.ts"],"names":[],"mappings":";;;;;AA4EA,0CAgBC;AA5FD,0DAA6B;AAC7B,4CAAoD;AAwEpD;;GAEG;AACH,SAAgB,eAAe,CAAC,UAA8B,EAAE;IAC/D,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG;QACjC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,gCAAoB;QACxD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,2BAA2B,CAAC;QAC3F,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qBAAqB,CAAC;QAC/F,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC;QAChG,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,KAAK,KAAK,EAAE,kBAAkB;QACxE,aAAa,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,mBAAmB;QAClE,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,mBAAmB;QAC9D,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,kBAAkB;QAC5D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,2BAA2B;QACzE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;KAClF,CAAC;AACH,CAAC"}