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

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,6 +1317,367 @@ 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";
+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,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) {
+  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
+      );
+      entries.push(...subEntries);
+    } else if (allowedMimeTypes.includes(item.mimeType)) {
+      const localPath = folderRelPath ? join(outputPath, folderRelPath, item.name) : join(outputPath, item.name);
+      entries.push({ id: item.id, name: item.name, localPath, mimeType: item.mimeType });
+    }
+  }
+  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
+  } = options;
+  const token = await getAccessToken2(credentials);
+  mkdirSync(outputPath, { recursive: true });
+  const entries = await collectFiles(
+    folderId,
+    "",
+    outputPath,
+    token,
+    mimeTypes,
+    recursive,
+    folderPattern
+  );
+  const downloaded = [];
+  const skipped = [];
+  const errors = [];
+  const tasks = entries.map((entry) => async () => {
+    if (existsSync(entry.localPath)) {
+      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/getDriveTranslations.ts
+async function manageDriveTranslations(options) {
+  const {
+    driveFolderId,
+    scanForSpreadsheets = true,
+    spreadsheetIds: explicitIds = [],
+    spreadsheetNameFilter,
+    syncImages = false,
+    imageOutputPath,
+    imageSyncOptions,
+    translationOptions = {},
+    docTitles
+  } = options;
+  if (syncImages && !imageOutputPath) {
+    throw new Error(
+      "[manageDriveTranslations] imageOutputPath is required when syncImages is true"
+    );
+  }
+  const discoveredIds = [];
+  const discoveredNames = /* @__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);
+    }
+  }
+  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;
+  const translations = await getMultipleSpreadSheetsData(docTitles, {
+    ...translationOptions,
+    spreadsheetIds: filteredIds.length > 0 ? filteredIds : void 0
+  });
+  let imageSync;
+  if (syncImages && driveFolderId && imageOutputPath) {
+    imageSync = await syncDriveImages({
+      ...imageSyncOptions,
+      folderId: driveFolderId,
+      outputPath: imageOutputPath
+    });
+  }
+  return { translations, spreadsheetIds: filteredIds, imageSync };
+}
+
 // src/index.ts
 var index_default = getSpreadSheetData;
 export {
@@ -1332,17 +1693,22 @@ export {
   getGoogleTranslateCode,
   getLanguagePrefix,
   getLocaleDisplayName,
+  getMultipleSpreadSheetsData,
   getNormalizedLocaleForHeader,
   getOriginalHeaderForLocale,
   getSpreadSheetData,
   getTranslationSummary,
   handleBidirectionalSync,
   isValidLocale,
+  manageDriveTranslations,
+  mergeMultipleTranslationData,
   mergeSheets,
   normalizeLocaleCode,
   processRawRows,
   readPublicSheet,
   resolveLocaleWithFallback,
+  scanDriveFolderForSpreadsheets,
+  syncDriveImages,
   updateSpreadsheetWithLocalChanges,
   validateCredentials,
   validateEnv,

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,15 @@ 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 } from './utils/driveImageSync';
+export type { DriveImageSyncOptions, DriveImageSyncResult } from './utils/driveImageSync';
+export { manageDriveTranslations } from './utils/getDriveTranslations';
+export type { GoogleDriveManagerOptions, GoogleDriveManagerResult } from './utils/getDriveTranslations';
 import { getSpreadSheetData } from './getSpreadSheetData';
 export default getSpreadSheetData;
 //# sourceMappingURL=index.d.ts.map

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,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,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACtG,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGnF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,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,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACtG,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGnF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,eAAe,kBAAkB,CAAC"}

package/dist/index.js

@@ -42,17 +42,22 @@ __export(index_exports, {
   getGoogleTranslateCode: () => getGoogleTranslateCode,
   getLanguagePrefix: () => getLanguagePrefix,
   getLocaleDisplayName: () => getLocaleDisplayName,
+  getMultipleSpreadSheetsData: () => getMultipleSpreadSheetsData,
   getNormalizedLocaleForHeader: () => getNormalizedLocaleForHeader,
   getOriginalHeaderForLocale: () => getOriginalHeaderForLocale,
   getSpreadSheetData: () => getSpreadSheetData,
   getTranslationSummary: () => getTranslationSummary,
   handleBidirectionalSync: () => handleBidirectionalSync,
   isValidLocale: () => isValidLocale,
+  manageDriveTranslations: () => manageDriveTranslations,
+  mergeMultipleTranslationData: () => mergeMultipleTranslationData,
   mergeSheets: () => mergeSheets,
   normalizeLocaleCode: () => normalizeLocaleCode,
   processRawRows: () => processRawRows,
   readPublicSheet: () => readPublicSheet,
   resolveLocaleWithFallback: () => resolveLocaleWithFallback,
+  scanDriveFolderForSpreadsheets: () => scanDriveFolderForSpreadsheets,
+  syncDriveImages: () => syncDriveImages,
   updateSpreadsheetWithLocalChanges: () => updateSpreadsheetWithLocalChanges,
   validateCredentials: () => validateCredentials,
   validateEnv: () => validateEnv,
@@ -1383,6 +1388,367 @@ 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
+var import_google_auth_library2 = require("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 import_google_auth_library2.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
+var import_node_fs6 = require("node:fs");
+var import_node_path5 = require("node:path");
+var import_promises4 = require("node:stream/promises");
+var import_node_stream = require("node:stream");
+var import_google_auth_library3 = require("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";
+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 import_google_auth_library3.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 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,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) {
+  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
+      );
+      entries.push(...subEntries);
+    } else if (allowedMimeTypes.includes(item.mimeType)) {
+      const localPath = folderRelPath ? (0, import_node_path5.join)(outputPath, folderRelPath, item.name) : (0, import_node_path5.join)(outputPath, item.name);
+      entries.push({ id: item.id, name: item.name, localPath, mimeType: item.mimeType });
+    }
+  }
+  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}`);
+  }
+  (0, import_node_fs6.mkdirSync)((0, import_node_path5.dirname)(localPath), { recursive: true });
+  const dest = (0, import_node_fs6.createWriteStream)(localPath);
+  await (0, import_promises4.pipeline)(import_node_stream.Readable.fromWeb(response.body), dest);
+}
+function collectLocalFiles(dir, base) {
+  const results = [];
+  if (!(0, import_node_fs6.existsSync)(dir)) return results;
+  for (const entry of (0, import_node_fs6.readdirSync)(dir)) {
+    const fullPath = (0, import_node_path5.join)(dir, entry);
+    const stat = (0, import_node_fs6.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
+  } = options;
+  const token = await getAccessToken2(credentials);
+  (0, import_node_fs6.mkdirSync)(outputPath, { recursive: true });
+  const entries = await collectFiles(
+    folderId,
+    "",
+    outputPath,
+    token,
+    mimeTypes,
+    recursive,
+    folderPattern
+  );
+  const downloaded = [];
+  const skipped = [];
+  const errors = [];
+  const tasks = entries.map((entry) => async () => {
+    if ((0, import_node_fs6.existsSync)(entry.localPath)) {
+      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}`);
+        (0, import_node_fs6.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/getDriveTranslations.ts
+async function manageDriveTranslations(options) {
+  const {
+    driveFolderId,
+    scanForSpreadsheets = true,
+    spreadsheetIds: explicitIds = [],
+    spreadsheetNameFilter,
+    syncImages = false,
+    imageOutputPath,
+    imageSyncOptions,
+    translationOptions = {},
+    docTitles
+  } = options;
+  if (syncImages && !imageOutputPath) {
+    throw new Error(
+      "[manageDriveTranslations] imageOutputPath is required when syncImages is true"
+    );
+  }
+  const discoveredIds = [];
+  const discoveredNames = /* @__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);
+    }
+  }
+  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;
+  const translations = await getMultipleSpreadSheetsData(docTitles, {
+    ...translationOptions,
+    spreadsheetIds: filteredIds.length > 0 ? filteredIds : void 0
+  });
+  let imageSync;
+  if (syncImages && driveFolderId && imageOutputPath) {
+    imageSync = await syncDriveImages({
+      ...imageSyncOptions,
+      folderId: driveFolderId,
+      outputPath: imageOutputPath
+    });
+  }
+  return { translations, spreadsheetIds: filteredIds, imageSync };
+}
+
 // src/index.ts
 var index_default = getSpreadSheetData;
 // Annotate the CommonJS export names for ESM import in node:
@@ -1398,17 +1764,22 @@ var index_default = getSpreadSheetData;
   getGoogleTranslateCode,
   getLanguagePrefix,
   getLocaleDisplayName,
+  getMultipleSpreadSheetsData,
   getNormalizedLocaleForHeader,
   getOriginalHeaderForLocale,
   getSpreadSheetData,
   getTranslationSummary,
   handleBidirectionalSync,
   isValidLocale,
+  manageDriveTranslations,
+  mergeMultipleTranslationData,
   mergeSheets,
   normalizeLocaleCode,
   processRawRows,
   readPublicSheet,
   resolveLocaleWithFallback,
+  scanDriveFolderForSpreadsheets,
+  syncDriveImages,
   updateSpreadsheetWithLocalChanges,
   validateCredentials,
   validateEnv,

package/dist/utils/driveFolderScanner.d.ts

@@ -0,0 +1,26 @@
+import type { GoogleEnvVars } from '../types';
+export interface DriveSpreadsheetFile {
+    id: string;
+    name: string;
+    /** Relative path within the Drive folder (e.g., "subproject/translations") */
+    folderPath: string;
+    mimeType: string;
+    modifiedTime?: string;
+}
+export interface ScanDriveFolderOptions {
+    /** Google Drive folder ID to scan */
+    folderId: string;
+    /** Whether to recursively scan subfolders (default: true) */
+    recursive?: boolean;
+    /** Only return spreadsheets with names matching this pattern (optional) */
+    nameFilter?: RegExp;
+    /** Google service account credentials (falls back to env vars) */
+    credentials?: GoogleEnvVars;
+}
+/**
+ * Scans a Google Drive folder for Google Spreadsheet files.
+ * Returns all spreadsheets found (recursively by default).
+ * Uses Drive API v3 via authenticated fetch (no googleapis package needed).
+ */
+export declare function scanDriveFolderForSpreadsheets(options: ScanDriveFolderOptions): Promise<DriveSpreadsheetFile[]>;
+//# sourceMappingURL=driveFolderScanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driveFolderScanner.d.ts","sourceRoot":"","sources":["../../src/utils/driveFolderScanner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AA8HD;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAKjC"}

package/dist/utils/driveImageSync.d.ts

@@ -0,0 +1,44 @@
+import type { GoogleEnvVars } from '../types';
+export interface DriveImageSyncOptions {
+    /** Google Drive root folder ID to sync images from */
+    folderId: string;
+    /** Local directory to download images into (will be created if missing) */
+    outputPath: string;
+    /** Only download files matching these MIME types (default: all image types) */
+    mimeTypes?: string[];
+    /** Whether to recursively sync subfolders (default: true) */
+    recursive?: boolean;
+    /**
+     * Subfolder filter pattern. If provided, only subfolders whose relative path
+     * (from the root folderId) matches this pattern will be synced.
+     * The pattern is tested against the full relative path, e.g. "projects/icons".
+     * Useful for patterns like `/^projects\//` or `/icons$/`.
+     */
+    folderPattern?: RegExp;
+    /** Google service account credentials (falls back to env vars) */
+    credentials?: GoogleEnvVars;
+    /** If true, delete local files that no longer exist in Drive (default: false) */
+    cleanSync?: boolean;
+    /** Max concurrent downloads (default: 3) */
+    concurrency?: number;
+}
+export interface DriveImageSyncResult {
+    downloaded: string[];
+    skipped: string[];
+    deleted: string[];
+    errors: string[];
+}
+/**
+ * Syncs images from a Google Drive folder to a local directory.
+ * Preserves subfolder structure. Uses Drive API v3 via fetch.
+ *
+ * @example
+ * await syncDriveImages({
+ *   folderId: 'your-drive-folder-id',
+ *   outputPath: './src/assets/remote-images',
+ *   recursive: true,
+ *   credentials: { GOOGLE_CLIENT_EMAIL: '...', GOOGLE_PRIVATE_KEY: '...', GOOGLE_SPREADSHEET_ID: '' }
+ * });
+ */
+export declare function syncDriveImages(options: DriveImageSyncOptions): Promise<DriveImageSyncResult>;
+//# sourceMappingURL=driveImageSync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driveImageSync.d.ts","sourceRoot":"","sources":["../../src/utils/driveImageSync.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAoLD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoE/B"}

package/dist/utils/getDriveTranslations.d.ts

@@ -0,0 +1,80 @@
+import type { TranslationData } from '../types';
+import type { MultiSpreadsheetOptions } from '../getMultipleSpreadSheetsData';
+import type { DriveImageSyncOptions, DriveImageSyncResult } from './driveImageSync';
+export interface GoogleDriveManagerOptions {
+    /**
+     * Google Drive folder ID to scan for spreadsheets and/or images.
+     * If provided without explicit spreadsheetIds, the folder is scanned
+     * automatically for spreadsheet files.
+     */
+    driveFolderId?: string;
+    /**
+     * When true, scans driveFolderId for all Google Spreadsheet files and
+     * fetches translations from each. Requires driveFolderId. (default: true when driveFolderId set)
+     */
+    scanForSpreadsheets?: boolean;
+    /**
+     * Explicit list of spreadsheet IDs to fetch from.
+     * If provided together with driveFolderId + scanForSpreadsheets, the
+     * explicit list is merged with the discovered ones (deduped).
+     */
+    spreadsheetIds?: string[];
+    /**
+     * Optional filter: only process spreadsheets whose name matches this pattern.
+     * Useful when the Drive folder contains non-translation spreadsheets.
+     * @example /^translations-/i
+     */
+    spreadsheetNameFilter?: RegExp;
+    /**
+     * When true, also sync images from driveFolderId to imageOutputPath.
+     * Requires driveFolderId. (default: false)
+     */
+    syncImages?: boolean;
+    /**
+     * Local directory to download Drive images into.
+     * Required when syncImages: true.
+     * @example './src/assets/remote-images'
+     */
+    imageOutputPath?: string;
+    /**
+     * Image sync options passed to syncDriveImages (mimeTypes, concurrency, etc.)
+     */
+    imageSyncOptions?: Partial<DriveImageSyncOptions>;
+    /**
+     * Options forwarded to getMultipleSpreadSheetsData (rowLimit, waitSeconds,
+     * translationsOutputDir, autoTranslate, etc.)
+     */
+    translationOptions?: MultiSpreadsheetOptions;
+    /** Sheet names to fetch from each discovered spreadsheet */
+    docTitles?: string[];
+}
+export interface GoogleDriveManagerResult {
+    translations: TranslationData;
+    /** List of spreadsheet IDs that were processed */
+    spreadsheetIds: string[];
+    /** Image sync result (only present if syncImages: true) */
+    imageSync?: DriveImageSyncResult;
+}
+/**
+ * Top-level "headless CMS bridge" function.
+ *
+ * Scans a Google Drive folder for spreadsheets, fetches all translations,
+ * optionally syncs images, and returns merged results.
+ *
+ * @example
+ * const result = await manageDriveTranslations({
+ *   driveFolderId: 'your-folder-id',
+ *   scanForSpreadsheets: true,
+ *   spreadsheetNameFilter: /^i18n-/,
+ *   syncImages: true,
+ *   imageOutputPath: './src/assets/remote-images',
+ *   translationOptions: {
+ *     autoTranslate: false,
+ *     translationsOutputDir: './src/translations'
+ *   }
+ * });
+ * console.log(result.translations);
+ * console.log(result.imageSync?.downloaded.length + ' images downloaded');
+ */
+export declare function manageDriveTranslations(options: GoogleDriveManagerOptions): Promise<GoogleDriveManagerResult>;
+//# sourceMappingURL=getDriveTranslations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveTranslations.d.ts","sourceRoot":"","sources":["../../src/utils/getDriveTranslations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAI9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGpF,MAAM,WAAW,yBAAyB;IACzC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAElD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAE7C,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACxC,YAAY,EAAE,eAAe,CAAC;IAC9B,kDAAkD;IAClD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAkEnC"}

package/dist/utils/multiSpreadsheetMerger.d.ts

@@ -0,0 +1,7 @@
+import type { TranslationData } from '../types';
+/**
+ * Merges multiple TranslationData results (from different spreadsheets) into one.
+ * Sheets/keys from later spreadsheets override earlier ones if collisions occur.
+ */
+export declare function mergeMultipleTranslationData(results: TranslationData[], mergeStrategy?: 'later-wins' | 'first-wins'): TranslationData;
+//# sourceMappingURL=multiSpreadsheetMerger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multiSpreadsheetMerger.d.ts","sourceRoot":"","sources":["../../src/utils/multiSpreadsheetMerger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,eAAe,EAAE,EAC1B,aAAa,GAAE,YAAY,GAAG,YAA2B,GACvD,eAAe,CAuBjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@el-j/google-sheet-translations",
-  "version": "2.1.5-beta.1",
+  "version": "2.2.0-beta.1",
   "description": "A package to manage translations stored in Google Spreadsheets",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",