@el-j/google-sheet-translations 2.1.5-beta.1 → 2.2.0-beta.2

package/README.md

@@ -1,5 +1,11 @@
 # Google Sheet Translations
 
+[![CI](https://github.com/el-j/google-sheet-translations/actions/workflows/ci.yml/badge.svg)](https://github.com/el-j/google-sheet-translations/actions/workflows/ci.yml)
+[![Release](https://github.com/el-j/google-sheet-translations/actions/workflows/release.yml/badge.svg)](https://github.com/el-j/google-sheet-translations/actions/workflows/release.yml)
+[![Docs](https://github.com/el-j/google-sheet-translations/actions/workflows/docs.yml/badge.svg)](https://github.com/el-j/google-sheet-translations/actions/workflows/docs.yml)
+[![npm version](https://img.shields.io/npm/v/@el-j/google-sheet-translations.svg)](https://www.npmjs.com/package/@el-j/google-sheet-translations)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
 A Node.js package for managing translations stored in Google Sheets.
 
 ## Features

package/dist/action-entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAKA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA+DzC"}
+{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAMA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA2FzC"}

package/dist/esm/index.js

@@ -1317,10 +1317,602 @@ function mergeSheets(translations, locale, sheetNames) {
   return merged;
 }
 
+// src/utils/multiSpreadsheetMerger.ts
+function mergeMultipleTranslationData(results, mergeStrategy = "later-wins") {
+  const merged = {};
+  for (const result of results) {
+    for (const [locale, sheets] of Object.entries(result)) {
+      if (!merged[locale]) {
+        merged[locale] = {};
+      }
+      for (const [sheet, keys] of Object.entries(sheets)) {
+        if (!merged[locale][sheet]) {
+          merged[locale][sheet] = {};
+        }
+        for (const [key, value] of Object.entries(keys)) {
+          if (mergeStrategy === "first-wins" && key in merged[locale][sheet]) {
+            continue;
+          }
+          merged[locale][sheet][key] = value;
+        }
+      }
+    }
+  }
+  return merged;
+}
+
+// src/getMultipleSpreadSheetsData.ts
+async function getMultipleSpreadSheetsData(docTitles, options = {}) {
+  const { spreadsheetIds, mergeStrategy = "later-wins", ...baseOptions } = options;
+  if (!spreadsheetIds || spreadsheetIds.length === 0) {
+    return getSpreadSheetData(docTitles, baseOptions);
+  }
+  console.log(`[getMultipleSpreadSheetsData] Fetching ${spreadsheetIds.length} spreadsheets...`);
+  const results = [];
+  for (let i = 0; i < spreadsheetIds.length; i++) {
+    const id = spreadsheetIds[i];
+    console.log(`[getMultipleSpreadSheetsData] (${i + 1}/${spreadsheetIds.length}) "${id}"...`);
+    const result = await getSpreadSheetData(docTitles, { ...baseOptions, spreadsheetId: id });
+    results.push(result);
+  }
+  return mergeMultipleTranslationData(results, mergeStrategy);
+}
+
+// src/utils/driveFolderScanner.ts
+import { GoogleAuth } from "google-auth-library";
+var SPREADSHEET_MIME = "application/vnd.google-apps.spreadsheet";
+var FOLDER_MIME = "application/vnd.google-apps.folder";
+var DRIVE_FILES_URL = "https://www.googleapis.com/drive/v3/files";
+async function getAccessToken(credentials) {
+  const clientEmail = credentials?.GOOGLE_CLIENT_EMAIL ?? process.env.GOOGLE_CLIENT_EMAIL;
+  const privateKey = credentials?.GOOGLE_PRIVATE_KEY ?? process.env.GOOGLE_PRIVATE_KEY;
+  if (!clientEmail || !privateKey) {
+    throw new Error(
+      "Google Drive credentials required: GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY"
+    );
+  }
+  const normalizedKey = privateKey.replace(/\\n/g, "\n");
+  const auth = new GoogleAuth({
+    credentials: { client_email: clientEmail, private_key: normalizedKey },
+    scopes: ["https://www.googleapis.com/auth/drive.readonly"]
+  });
+  const client = await auth.getClient();
+  const tokenResponse = await client.getAccessToken();
+  return tokenResponse.token;
+}
+async function listFilesInFolder(folderId, mimeType, token) {
+  const results = [];
+  let pageToken;
+  do {
+    const query = `'${folderId}' in parents and mimeType = '${mimeType}' and trashed = false`;
+    const params = new URLSearchParams({
+      q: query,
+      fields: "nextPageToken,files(id,name,mimeType,modifiedTime,parents)",
+      pageSize: "1000"
+    });
+    if (pageToken) params.set("pageToken", pageToken);
+    const response = await fetch(`${DRIVE_FILES_URL}?${params.toString()}`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `Drive API error ${response.status}: ${text}`
+      );
+    }
+    const data = await response.json();
+    results.push(...data.files);
+    pageToken = data.nextPageToken;
+  } while (pageToken);
+  return results;
+}
+async function scanFolder(folderId, folderPath, token, recursive, nameFilter, seen = /* @__PURE__ */ new Set()) {
+  console.log(`[driveFolderScanner] Scanning folder: ${folderId} (path: "${folderPath}")`);
+  const spreadsheets = await listFilesInFolder(folderId, SPREADSHEET_MIME, token);
+  const results = [];
+  for (const file of spreadsheets) {
+    if (seen.has(file.id)) continue;
+    seen.add(file.id);
+    if (nameFilter && !nameFilter.test(file.name)) continue;
+    results.push({
+      id: file.id,
+      name: file.name,
+      folderPath,
+      mimeType: file.mimeType,
+      modifiedTime: file.modifiedTime
+    });
+  }
+  if (recursive) {
+    const subfolders = await listFilesInFolder(folderId, FOLDER_MIME, token);
+    for (const folder of subfolders) {
+      const subPath = folderPath ? `${folderPath}/${folder.name}` : folder.name;
+      const subResults = await scanFolder(
+        folder.id,
+        subPath,
+        token,
+        recursive,
+        nameFilter,
+        seen
+      );
+      results.push(...subResults);
+    }
+  }
+  return results;
+}
+async function scanDriveFolderForSpreadsheets(options) {
+  const { folderId, recursive = true, nameFilter, credentials } = options;
+  const token = await getAccessToken(credentials);
+  return scanFolder(folderId, "", token, recursive, nameFilter);
+}
+
+// src/utils/driveImageSync.ts
+import { createWriteStream, mkdirSync, existsSync, readdirSync, unlinkSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { GoogleAuth as GoogleAuth2 } from "google-auth-library";
+var DEFAULT_IMAGE_MIME_TYPES = [
+  "image/jpeg",
+  "image/jpg",
+  "image/png",
+  "image/webp",
+  "image/avif",
+  "image/gif",
+  "image/svg+xml",
+  "image/tiff",
+  "image/bmp",
+  "image/ico",
+  "image/x-icon"
+];
+var FOLDER_MIME2 = "application/vnd.google-apps.folder";
+var DRIVE_FILES_URL2 = "https://www.googleapis.com/drive/v3/files";
+function normalizeExtension(name) {
+  const dot = name.lastIndexOf(".");
+  if (dot === -1) return name;
+  const base = name.slice(0, dot);
+  let ext = name.slice(dot + 1).toLowerCase();
+  if (ext === "jpeg") ext = "jpg";
+  return `${base}.${ext}`;
+}
+async function getAccessToken2(credentials) {
+  const clientEmail = credentials?.GOOGLE_CLIENT_EMAIL ?? process.env.GOOGLE_CLIENT_EMAIL;
+  const privateKey = credentials?.GOOGLE_PRIVATE_KEY ?? process.env.GOOGLE_PRIVATE_KEY;
+  if (!clientEmail || !privateKey) {
+    throw new Error(
+      "Google Drive credentials required: GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY"
+    );
+  }
+  const normalizedKey = privateKey.replace(/\\n/g, "\n");
+  const auth = new GoogleAuth2({
+    credentials: { client_email: clientEmail, private_key: normalizedKey },
+    scopes: ["https://www.googleapis.com/auth/drive.readonly"]
+  });
+  const client = await auth.getClient();
+  const tokenResponse = await client.getAccessToken();
+  return tokenResponse.token;
+}
+async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
+  const results = [];
+  let pageToken;
+  do {
+    const mimeClause = mimeTypeFilter ? ` and mimeType = '${mimeTypeFilter}'` : "";
+    const query = `'${folderId}' in parents${mimeClause} and trashed = false`;
+    const params = new URLSearchParams({
+      q: query,
+      fields: "nextPageToken,files(id,name,mimeType,modifiedTime,parents)",
+      pageSize: "1000"
+    });
+    if (pageToken) params.set("pageToken", pageToken);
+    const response = await fetch(`${DRIVE_FILES_URL2}?${params.toString()}`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Drive API error ${response.status}: ${text}`);
+    }
+    const data = await response.json();
+    results.push(...data.files);
+    pageToken = data.nextPageToken;
+  } while (pageToken);
+  return results;
+}
+async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern, normalizeExts = true) {
+  console.log(`[driveImageSync] Scanning folder: ${folderId} (path: "${folderRelPath}")`);
+  const allItems = await listFilesInFolder2(folderId, token);
+  const entries = [];
+  for (const item of allItems) {
+    if (item.mimeType === FOLDER_MIME2) {
+      if (!recursive) continue;
+      const subRelPath = folderRelPath ? `${folderRelPath}/${item.name}` : item.name;
+      if (folderPattern && !folderPattern.test(subRelPath)) continue;
+      const subEntries = await collectFiles(
+        item.id,
+        subRelPath,
+        outputPath,
+        token,
+        allowedMimeTypes,
+        recursive,
+        folderPattern,
+        normalizeExts
+      );
+      entries.push(...subEntries);
+    } else if (allowedMimeTypes.includes(item.mimeType)) {
+      const localName = normalizeExts ? normalizeExtension(item.name) : item.name;
+      const localPath = folderRelPath ? join(outputPath, folderRelPath, localName) : join(outputPath, localName);
+      entries.push({
+        id: item.id,
+        name: item.name,
+        localPath,
+        mimeType: item.mimeType,
+        driveModifiedTime: item.modifiedTime
+      });
+    }
+  }
+  return entries;
+}
+async function downloadFile(fileId, localPath, token) {
+  const url = `${DRIVE_FILES_URL2}/${fileId}?alt=media`;
+  const response = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+  if (!response.ok) {
+    throw new Error(`Failed to download ${fileId}: ${response.status}`);
+  }
+  mkdirSync(dirname(localPath), { recursive: true });
+  const dest = createWriteStream(localPath);
+  await pipeline(Readable.fromWeb(response.body), dest);
+}
+function collectLocalFiles(dir, base) {
+  const results = [];
+  if (!existsSync(dir)) return results;
+  for (const entry of readdirSync(dir)) {
+    const fullPath = join(dir, entry);
+    const stat = statSync(fullPath);
+    if (stat.isDirectory()) {
+      results.push(...collectLocalFiles(fullPath, base));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+async function runConcurrent(tasks, concurrency) {
+  const results = [];
+  for (let i = 0; i < tasks.length; i += concurrency) {
+    const batch = tasks.slice(i, i + concurrency).map((t) => t());
+    results.push(...await Promise.all(batch));
+  }
+  return results;
+}
+async function syncDriveImages(options) {
+  const {
+    folderId,
+    outputPath,
+    mimeTypes = DEFAULT_IMAGE_MIME_TYPES,
+    recursive = true,
+    folderPattern,
+    credentials,
+    cleanSync = false,
+    concurrency = 3,
+    incrementalSync = true,
+    normalizeExtensions = true
+  } = options;
+  const token = await getAccessToken2(credentials);
+  mkdirSync(outputPath, { recursive: true });
+  const entries = await collectFiles(
+    folderId,
+    "",
+    outputPath,
+    token,
+    mimeTypes,
+    recursive,
+    folderPattern,
+    normalizeExtensions
+  );
+  const downloaded = [];
+  const skipped = [];
+  const errors = [];
+  const tasks = entries.map((entry) => async () => {
+    const localExists = existsSync(entry.localPath);
+    if (localExists) {
+      if (incrementalSync && entry.driveModifiedTime) {
+        try {
+          const localMtimeMs = statSync(entry.localPath).mtimeMs;
+          const driveMtimeMs = new Date(entry.driveModifiedTime).getTime();
+          if (driveMtimeMs <= localMtimeMs) {
+            console.log(`[driveImageSync] Skipping (up to date): ${entry.localPath}`);
+            skipped.push(entry.localPath);
+            return;
+          }
+          console.log(`[driveImageSync] Re-downloading (changed in Drive): ${entry.localPath}`);
+        } catch {
+          console.log(`[driveImageSync] Downloading (could not stat local): ${entry.localPath}`);
+        }
+      } else {
+        console.log(`[driveImageSync] Skipping (exists): ${entry.localPath}`);
+        skipped.push(entry.localPath);
+        return;
+      }
+    }
+    console.log(`[driveImageSync] Downloading: ${entry.localPath}`);
+    try {
+      await downloadFile(entry.id, entry.localPath, token);
+      downloaded.push(entry.localPath);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`[driveImageSync] Error downloading ${entry.localPath}: ${msg}`);
+      errors.push(entry.localPath);
+    }
+  });
+  await runConcurrent(tasks, concurrency);
+  const deleted = [];
+  if (cleanSync) {
+    const driveLocalPaths = new Set(entries.map((e) => e.localPath));
+    const localFiles = collectLocalFiles(outputPath, outputPath);
+    for (const localFile of localFiles) {
+      if (!driveLocalPaths.has(localFile)) {
+        console.log(`[driveImageSync] Deleting (not in Drive): ${localFile}`);
+        unlinkSync(localFile);
+        deleted.push(localFile);
+      }
+    }
+  }
+  console.log(
+    `[driveImageSync] Synced ${downloaded.length} files, skipped ${skipped.length}, deleted ${deleted.length}, errors ${errors.length}`
+  );
+  return { downloaded, skipped, deleted, errors };
+}
+
+// src/utils/localImageUtils.ts
+import { promises as fsp } from "node:fs";
+import { join as join2, extname } from "node:path";
+async function walkDirectory(dir, options) {
+  const { extensions } = options ?? {};
+  const lowerExts = extensions?.map((e) => e.toLowerCase());
+  async function go(current) {
+    const entries = await fsp.readdir(current, { withFileTypes: true, encoding: "utf8" });
+    const results = [];
+    for (const entry of entries) {
+      const full = join2(current, entry.name);
+      if (entry.isDirectory()) {
+        results.push(...await go(full));
+      } else if (entry.isFile()) {
+        if (!lowerExts || lowerExts.includes(extname(entry.name).toLowerCase())) {
+          results.push(full);
+        }
+      }
+    }
+    return results;
+  }
+  return go(dir);
+}
+var DEFAULT_IMAGE_EXTENSIONS = [
+  ".jpg",
+  ".jpeg",
+  ".png",
+  ".webp",
+  ".avif",
+  ".gif",
+  ".svg",
+  ".tiff",
+  ".bmp",
+  ".ico"
+];
+async function validateImageDirectory(options) {
+  const {
+    rootDir,
+    imageExtensions = DEFAULT_IMAGE_EXTENSIONS,
+    allowRootFiles = false,
+    expectedSubfolders = []
+  } = options;
+  const errors = [];
+  const warnings = [];
+  const rootFiles = [];
+  const subfolders = [];
+  const lowerExts = imageExtensions.map((e) => e.toLowerCase());
+  let entries;
+  try {
+    entries = await fsp.readdir(rootDir, { withFileTypes: true, encoding: "utf8" });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+      valid: false,
+      errors: [`Could not read directory "${rootDir}": ${msg}`],
+      warnings,
+      rootFiles,
+      subfolders
+    };
+  }
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      subfolders.push(entry.name);
+    } else if (entry.isFile()) {
+      if (lowerExts.includes(extname(entry.name).toLowerCase())) {
+        rootFiles.push(entry.name);
+      }
+    }
+  }
+  if (!allowRootFiles && rootFiles.length > 0) {
+    errors.push(
+      `Image files found directly in "${rootDir}" \u2014 the folder structure may have been flattened during sync. Files: ${rootFiles.slice(0, 5).join(", ")}${rootFiles.length > 5 ? ` \u2026 (+${rootFiles.length - 5} more)` : ""}`
+    );
+  }
+  if (!allowRootFiles && subfolders.length === 0) {
+    errors.push(
+      `No sub-directories found in "${rootDir}". Expected a nested folder structure (e.g. projects/, performances/).`
+    );
+  }
+  const missing = expectedSubfolders.filter((name) => !subfolders.includes(name));
+  if (missing.length > 0) {
+    warnings.push(
+      `Some expected sub-folders are absent from "${rootDir}": ${missing.join(", ")}`
+    );
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings,
+    rootFiles,
+    subfolders
+  };
+}
+
+// src/utils/getDriveTranslations.ts
+import path6 from "node:path";
+
+// src/utils/driveProjectIndex.ts
+import fs6 from "node:fs";
+import path5 from "node:path";
+function buildManifest(options) {
+  const locales = Object.keys(options.translations).sort();
+  return {
+    version: "1",
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    projectName: options.projectName,
+    domain: options.domain,
+    locales,
+    defaultLocale: options.defaultLocale,
+    spreadsheets: options.spreadsheets,
+    outputDirectory: options.outputDirectory,
+    flatten: options.flatten,
+    projectMetadata: options.projectMetadata
+  };
+}
+function writeManifest(manifest, manifestPath) {
+  const dir = path5.dirname(manifestPath);
+  if (!fs6.existsSync(dir)) {
+    fs6.mkdirSync(dir, { recursive: true });
+  }
+  fs6.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf8");
+  console.log(`[driveProjectIndex] Wrote project manifest \u2192 ${manifestPath}`);
+}
+
+// src/utils/getDriveTranslations.ts
+function sanitizeFolderName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "") || "sheet";
+}
+async function manageDriveTranslations(options) {
+  const {
+    driveFolderId,
+    scanForSpreadsheets = true,
+    spreadsheetIds: explicitIds = [],
+    spreadsheetNameFilter,
+    syncImages = false,
+    imageOutputPath,
+    imageSyncOptions,
+    translationOptions = {},
+    docTitles,
+    flatten = true,
+    createManifest,
+    manifestPath,
+    projectName,
+    domain,
+    defaultLocale,
+    projectMetadata
+  } = options;
+  if (syncImages && !imageOutputPath) {
+    throw new Error(
+      "[manageDriveTranslations] imageOutputPath is required when syncImages is true"
+    );
+  }
+  const shouldCreateManifest = createManifest ?? driveFolderId !== void 0;
+  const discoveredIds = [];
+  const discoveredNames = /* @__PURE__ */ new Map();
+  const discoveredFolderPaths = /* @__PURE__ */ new Map();
+  const discoveredModifiedTimes = /* @__PURE__ */ new Map();
+  if (driveFolderId && scanForSpreadsheets) {
+    const scanOptions = { folderId: driveFolderId };
+    const discovered = await scanDriveFolderForSpreadsheets(scanOptions);
+    console.log(
+      `[manageDriveTranslations] Found ${discovered.length} spreadsheet(s) in Drive folder`
+    );
+    for (const file of discovered) {
+      discoveredIds.push(file.id);
+      discoveredNames.set(file.id, file.name);
+      discoveredFolderPaths.set(file.id, file.folderPath);
+      if (file.modifiedTime) discoveredModifiedTimes.set(file.id, file.modifiedTime);
+    }
+  }
+  const allIds = [.../* @__PURE__ */ new Set([...discoveredIds, ...explicitIds])];
+  const filteredIds = spreadsheetNameFilter ? allIds.filter((id) => {
+    const name = discoveredNames.get(id);
+    if (!name) return true;
+    return spreadsheetNameFilter.test(name);
+  }) : allIds;
+  let translations;
+  const spreadsheetEntries = [];
+  const baseOutputDir = translationOptions.translationsOutputDir ?? "translations";
+  if (!flatten) {
+    const { mergeStrategy = "later-wins", ...baseOptions } = translationOptions;
+    const perResults = [];
+    for (const id of filteredIds) {
+      const name = discoveredNames.get(id) ?? id;
+      const subDir = sanitizeFolderName(name);
+      const subOutputDir = path6.join(baseOutputDir, subDir);
+      console.log(
+        `[manageDriveTranslations] (flatten: false) Fetching "${name}" \u2192 ${subOutputDir}`
+      );
+      const result = await getSpreadSheetData(docTitles, {
+        ...baseOptions,
+        spreadsheetId: id,
+        translationsOutputDir: subOutputDir
+      });
+      perResults.push(result);
+      spreadsheetEntries.push({
+        id,
+        name,
+        folderPath: discoveredFolderPaths.get(id) ?? "",
+        sheets: docTitles ?? [],
+        modifiedTime: discoveredModifiedTimes.get(id),
+        outputSubDirectory: subDir
+      });
+    }
+    translations = mergeMultipleTranslationData(perResults, mergeStrategy);
+  } else {
+    translations = await getMultipleSpreadSheetsData(docTitles, {
+      ...translationOptions,
+      spreadsheetIds: filteredIds.length > 0 ? filteredIds : void 0
+    });
+    for (const id of filteredIds) {
+      spreadsheetEntries.push({
+        id,
+        name: discoveredNames.get(id) ?? id,
+        folderPath: discoveredFolderPaths.get(id) ?? "",
+        sheets: docTitles ?? [],
+        modifiedTime: discoveredModifiedTimes.get(id)
+      });
+    }
+  }
+  let imageSync;
+  if (syncImages && driveFolderId && imageOutputPath) {
+    imageSync = await syncDriveImages({
+      ...imageSyncOptions,
+      folderId: driveFolderId,
+      outputPath: imageOutputPath
+    });
+  }
+  let manifest;
+  if (shouldCreateManifest) {
+    const resolvedManifestPath = manifestPath ?? path6.join(baseOutputDir, "i18n-manifest.json");
+    manifest = buildManifest({
+      translations,
+      spreadsheets: spreadsheetEntries,
+      outputDirectory: baseOutputDir,
+      flatten,
+      projectName,
+      domain,
+      defaultLocale,
+      projectMetadata
+    });
+    writeManifest(manifest, resolvedManifestPath);
+  }
+  return { translations, spreadsheetIds: filteredIds, imageSync, manifest };
+}
+
 // src/index.ts
 var index_default = getSpreadSheetData;
 export {
+  DEFAULT_IMAGE_EXTENSIONS,
   DEFAULT_WAIT_SECONDS,
+  buildManifest,
   convertFromDataJsonFormat,
   convertToDataJsonFormat,
   createAuthClient,
@@ -1332,23 +1924,32 @@ export {
   getGoogleTranslateCode,
   getLanguagePrefix,
   getLocaleDisplayName,
+  getMultipleSpreadSheetsData,
   getNormalizedLocaleForHeader,
   getOriginalHeaderForLocale,
   getSpreadSheetData,
   getTranslationSummary,
   handleBidirectionalSync,
   isValidLocale,
+  manageDriveTranslations,
+  mergeMultipleTranslationData,
   mergeSheets,
+  normalizeExtension,
   normalizeLocaleCode,
   processRawRows,
   readPublicSheet,
   resolveLocaleWithFallback,
+  scanDriveFolderForSpreadsheets,
+  syncDriveImages,
   updateSpreadsheetWithLocalChanges,
   validateCredentials,
   validateEnv,
+  validateImageDirectory,
   wait,
+  walkDirectory,
   withRetry,
   writeLanguageDataFile,
   writeLocalesFile,
+  writeManifest,
   writeTranslationFiles
 };

package/dist/getMultipleSpreadSheetsData.d.ts

@@ -0,0 +1,19 @@
+import type { TranslationData } from './types';
+import type { SpreadsheetOptions } from './utils/configurationHandler';
+export interface MultiSpreadsheetOptions extends SpreadsheetOptions {
+    /** Array of spreadsheet IDs to fetch from. Overrides spreadsheetId if provided. */
+    spreadsheetIds?: string[];
+    /**
+     * How to merge same-locale same-sheet keys from different spreadsheets.
+     * 'later-wins': keys from later spreadsheets override earlier (default)
+     * 'first-wins': keep first occurrence of each key
+     */
+    mergeStrategy?: 'later-wins' | 'first-wins';
+}
+/**
+ * Fetches translations from multiple Google Spreadsheets and merges them.
+ * When spreadsheetIds is not provided, falls back to options.spreadsheetId
+ * or GOOGLE_SPREADSHEET_ID env var (same as getSpreadSheetData).
+ */
+export declare function getMultipleSpreadSheetsData(docTitles?: string[], options?: MultiSpreadsheetOptions): Promise<TranslationData>;
+//# sourceMappingURL=getMultipleSpreadSheetsData.d.ts.map

package/dist/getMultipleSpreadSheetsData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMultipleSpreadSheetsData.d.ts","sourceRoot":"","sources":["../src/getMultipleSpreadSheetsData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAIvE,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IAClE,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/index.d.ts

@@ -25,6 +25,19 @@ export { writeTranslationFiles, writeLocalesFile, writeLanguageDataFile } from '
 export { handleBidirectionalSync } from './utils/syncManager';
 export type { SyncResult } from './utils/syncManager';
 export type { TranslationData, TranslationValue, SheetRow, GoogleEnvVars, } from './types';
+export { getMultipleSpreadSheetsData } from './getMultipleSpreadSheetsData';
+export type { MultiSpreadsheetOptions } from './getMultipleSpreadSheetsData';
+export { mergeMultipleTranslationData } from './utils/multiSpreadsheetMerger';
+export { scanDriveFolderForSpreadsheets } from './utils/driveFolderScanner';
+export type { DriveSpreadsheetFile, ScanDriveFolderOptions } from './utils/driveFolderScanner';
+export { syncDriveImages, normalizeExtension } from './utils/driveImageSync';
+export type { DriveImageSyncOptions, DriveImageSyncResult } from './utils/driveImageSync';
+export { walkDirectory, validateImageDirectory, DEFAULT_IMAGE_EXTENSIONS } from './utils/localImageUtils';
+export type { WalkDirectoryOptions, ImageDirectoryValidationOptions, ImageDirectoryValidationResult, } from './utils/localImageUtils';
+export { manageDriveTranslations } from './utils/getDriveTranslations';
+export type { GoogleDriveManagerOptions, GoogleDriveManagerResult } from './utils/getDriveTranslations';
+export { buildManifest, writeManifest } from './utils/driveProjectIndex';
+export type { DriveProjectManifest, SpreadsheetManifestEntry, BuildManifestOptions } from './utils/driveProjectIndex';
 import { getSpreadSheetData } from './getSpreadSheetData';
 export default getSpreadSheetData;
 //# sourceMappingURL=index.d.ts.map