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

package/dist/index.js

@@ -39,19 +39,25 @@ __export(index_exports, {
   default: () => index_default,
   filterValidLocales: () => filterValidLocales,
   findLocalChanges: () => findLocalChanges,
+  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,
@@ -234,6 +240,14 @@ function filterValidLocales(headerRow, keyColumn) {
 function getLanguagePrefix(locale) {
   return locale.toLowerCase().split(/[-_]/)[0];
 }
+var GOOGLE_TRANSLATE_CODES_REQUIRING_REGION = /* @__PURE__ */ new Set(["zh-tw", "zh-cn"]);
+function getGoogleTranslateCode(locale) {
+  const normalized = locale.toLowerCase().trim().replace("_", "-");
+  if (GOOGLE_TRANSLATE_CODES_REQUIRING_REGION.has(normalized)) {
+    return normalized;
+  }
+  return normalized.split(/[-_]/)[0];
+}
 var LANGUAGE_TO_COUNTRY_MAP = {
   "en": "en-GB",
   "de": "de-DE",
@@ -596,12 +610,23 @@ function columnIndexToLetter(index) {
   } while (i >= 0);
   return result;
 }
-function langCodeFormula(cellRef) {
-  return `LOWER(IFERROR(LEFT(${cellRef},FIND("-",${cellRef})-1),${cellRef}))`;
+function getFormulaSeparator(doc) {
+  try {
+    const locale = doc._rawProperties?.locale || "";
+    if (/^(en|ja|ko|zh|th|id|ms)/i.test(locale)) return ",";
+  } catch {
+  }
+  return ";";
+}
+function langCodeFormula(cellRef, sep) {
+  const prefix = `LOWER(IFERROR(LEFT(${cellRef}${sep}FIND("-"${sep}${cellRef})-1)${sep}${cellRef}))`;
+  const full = `LOWER(${cellRef})`;
+  return `IF(LOWER(LEFT(${cellRef}${sep}3))="zh-"${sep}${full}${sep}${prefix})`;
 }
 async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, autoTranslate = false, localeMapping = {}, override = false) {
   console.log("Updating spreadsheet with local changes...");
   const baseDelayMs = waitSeconds * 1e3;
+  const sep = getFormulaSeparator(doc);
   for (const sheetTitle of new Set(
     Object.values(changes).flatMap((locale) => Object.keys(locale))
   )) {
@@ -745,7 +770,7 @@ async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, auto
                     const targetColumnLetter = columnIndexToLetter(targetHeaderIndex);
                     row.set(
                       exactTargetHeader,
-                      `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW());${langCodeFormula(`$${sourceColumnLetter}$1`)};${langCodeFormula(`${targetColumnLetter}$1`)})`
+                      `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW())${sep}${langCodeFormula(`$${sourceColumnLetter}$1`, sep)}${sep}${langCodeFormula(`${targetColumnLetter}$1`, sep)})`
                     );
                   }
                 }
@@ -794,7 +819,7 @@ async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, auto
                 }
                 const sourceColumnLetter = columnIndexToLetter(sourceHeaderIndex);
                 const targetColumnLetter = columnIndexToLetter(targetHeaderIndex);
-                rowData[exactHeaderName] = `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW());${langCodeFormula(`$${sourceColumnLetter}$1`)};${langCodeFormula(`${targetColumnLetter}$1`)})`;
+                rowData[exactHeaderName] = `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW())${sep}${langCodeFormula(`$${sourceColumnLetter}$1`, sep)}${sep}${langCodeFormula(`${targetColumnLetter}$1`, sep)})`;
               }
             }
           }
@@ -1050,8 +1075,18 @@ function colLetter(index) {
   } while (i >= 0);
   return result;
 }
-function langCodeFormula2(cellRef) {
-  return `LOWER(IFERROR(LEFT(${cellRef},FIND("-",${cellRef})-1),${cellRef}))`;
+function getFormulaSeparator2(doc) {
+  try {
+    const locale = doc._rawProperties?.locale || "";
+    if (/^(en|ja|ko|zh|th|id|ms)/i.test(locale)) return ",";
+  } catch {
+  }
+  return ";";
+}
+function langCodeFormula2(cellRef, sep) {
+  const prefix = `LOWER(IFERROR(LEFT(${cellRef}${sep}FIND("-"${sep}${cellRef})-1)${sep}${cellRef}))`;
+  const full = `LOWER(${cellRef})`;
+  return `IF(LOWER(LEFT(${cellRef}${sep}3))="zh-"${sep}${full}${sep}${prefix})`;
 }
 var DEFAULT_TARGET_LOCALES = ["de", "fr", "es", "it", "pt", "ja", "zh"];
 var STARTER_KEYS = {
@@ -1133,11 +1168,12 @@ async function createSpreadsheet(authClient, options = {}) {
       "setHeaderRow"
     );
     const sourceColLetter = colLetter(1);
+    const sep = getFormulaSeparator2(doc);
     const rows = Object.entries(seedKeys).map(([key, sourceValue]) => {
       const row = { key, [sourceLocale]: sourceValue };
       targetLocales.forEach((locale, idx) => {
         const targetColLetter = colLetter(2 + idx);
-        row[locale] = `=GOOGLETRANSLATE(INDIRECT("${sourceColLetter}"&ROW());${langCodeFormula2(`$${sourceColLetter}$1`)};${langCodeFormula2(`${targetColLetter}$1`)})`;
+        row[locale] = `=GOOGLETRANSLATE(INDIRECT("${sourceColLetter}"&ROW())${sep}${langCodeFormula2(`$${sourceColLetter}$1`, sep)}${sep}${langCodeFormula2(`${targetColLetter}$1`, sep)})`;
       });
       return row;
     });
@@ -1352,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:
@@ -1364,19 +1761,25 @@ var index_default = getSpreadSheetData;
   createSpreadsheet,
   filterValidLocales,
   findLocalChanges,
+  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"}