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

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/esm/index.js

@@ -4,17 +4,24 @@ import path4 from "node:path";
 import { GoogleSpreadsheet as GoogleSpreadsheet2 } from "google-spreadsheet";
 
 // src/utils/auth.ts
-import { JWT } from "google-auth-library";
+import { GoogleAuth } from "google-auth-library";
 
 // src/utils/validateEnv.ts
 function validateCredentials() {
+  if (process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+    return {
+      GOOGLE_CLIENT_EMAIL: process.env.GOOGLE_CLIENT_EMAIL ?? "",
+      GOOGLE_PRIVATE_KEY: process.env.GOOGLE_PRIVATE_KEY ?? ""
+    };
+  }
   const requiredVars = ["GOOGLE_CLIENT_EMAIL", "GOOGLE_PRIVATE_KEY"];
   const missing = requiredVars.filter((v) => !process.env[v]);
   if (missing.length > 0) {
     throw new Error(
       `Missing required environment variables: ${missing.join(", ")}
 
-Make sure these are set in your .env file or environment.`
+Make sure these are set in your .env file or environment.
+Alternatively, set GOOGLE_APPLICATION_CREDENTIALS for Workload Identity Federation.`
     );
   }
   return {
@@ -23,6 +30,21 @@ Make sure these are set in your .env file or environment.`
   };
 }
 function validateEnv() {
+  const spreadsheetId = process.env.GOOGLE_SPREADSHEET_ID;
+  if (!spreadsheetId) {
+    throw new Error(
+      `Missing required environment variable: GOOGLE_SPREADSHEET_ID
+
+Make sure this is set in your .env file or environment.`
+    );
+  }
+  if (process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+    return {
+      GOOGLE_CLIENT_EMAIL: process.env.GOOGLE_CLIENT_EMAIL ?? "",
+      GOOGLE_PRIVATE_KEY: process.env.GOOGLE_PRIVATE_KEY ?? "",
+      GOOGLE_SPREADSHEET_ID: spreadsheetId
+    };
+  }
   const requiredVars = [
     "GOOGLE_CLIENT_EMAIL",
     "GOOGLE_PRIVATE_KEY",
@@ -33,24 +55,43 @@ function validateEnv() {
     throw new Error(
       `Missing required environment variables: ${missingVars.join(", ")}
 
-Make sure these are set in your .env file or environment.`
+Make sure these are set in your .env file or environment.
+Alternatively, set GOOGLE_APPLICATION_CREDENTIALS for Workload Identity Federation.`
     );
   }
   return {
     GOOGLE_CLIENT_EMAIL: process.env.GOOGLE_CLIENT_EMAIL,
     GOOGLE_PRIVATE_KEY: process.env.GOOGLE_PRIVATE_KEY,
-    GOOGLE_SPREADSHEET_ID: process.env.GOOGLE_SPREADSHEET_ID
+    GOOGLE_SPREADSHEET_ID: spreadsheetId
   };
 }
 
 // src/utils/auth.ts
+function normalizePrivateKey(key) {
+  let normalized = key;
+  const outer = key.trim();
+  if (outer.startsWith('"') && outer.endsWith('"') || outer.startsWith("'") && outer.endsWith("'")) {
+    normalized = outer.slice(1, -1);
+  }
+  normalized = normalized.replace(/\\n/g, "\n");
+  normalized = normalized.replace(/\r\n/g, "\n");
+  return normalized;
+}
+function buildGoogleAuth(scopes, credentials) {
+  if (credentials) {
+    return new GoogleAuth({ credentials, scopes });
+  }
+  return new GoogleAuth({ scopes });
+}
 function createAuthClient() {
+  if (process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+    return buildGoogleAuth(["https://www.googleapis.com/auth/spreadsheets"]);
+  }
   const { GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY } = validateCredentials();
-  const normalizedKey = GOOGLE_PRIVATE_KEY.replace(/\\n/g, "\n");
-  return new JWT({
-    email: GOOGLE_CLIENT_EMAIL,
-    key: normalizedKey,
-    scopes: ["https://www.googleapis.com/auth/spreadsheets"]
+  const normalizedKey = normalizePrivateKey(GOOGLE_PRIVATE_KEY);
+  return buildGoogleAuth(["https://www.googleapis.com/auth/spreadsheets"], {
+    client_email: GOOGLE_CLIENT_EMAIL,
+    private_key: normalizedKey
   });
 }
 
@@ -1037,7 +1078,6 @@ async function createSpreadsheet(authClient, options = {}) {
     targetLocales = DEFAULT_TARGET_LOCALES,
     seedKeys = STARTER_KEYS
   } = options;
-  await authClient.authorize();
   const createRes = await withRetry(
     () => authClient.request({
       url: "https://sheets.googleapis.com/v4/spreadsheets",
@@ -1359,23 +1399,22 @@ async function getMultipleSpreadSheetsData(docTitles, options = {}) {
 }
 
 // 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";
+var DRIVE_SCOPES = ["https://www.googleapis.com/auth/drive.readonly"];
 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) {
+  let driveCredentials;
+  if (clientEmail && privateKey) {
+    driveCredentials = { client_email: clientEmail, private_key: normalizePrivateKey(privateKey) };
+  } else if (!process.env.GOOGLE_APPLICATION_CREDENTIALS) {
     throw new Error(
-      "Google Drive credentials required: GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY"
+      "Google Drive credentials required: set GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY, or set GOOGLE_APPLICATION_CREDENTIALS for Workload Identity Federation."
     );
   }
-  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 auth = buildGoogleAuth(DRIVE_SCOPES, driveCredentials);
   const client = await auth.getClient();
   const tokenResponse = await client.getAccessToken();
   return tokenResponse.token;
@@ -1450,7 +1489,6 @@ import { createWriteStream, mkdirSync, existsSync, readdirSync, unlinkSync, stat
 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",
@@ -1466,19 +1504,27 @@ var DEFAULT_IMAGE_MIME_TYPES = [
 ];
 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}`;
+}
+var DRIVE_SCOPES2 = ["https://www.googleapis.com/auth/drive.readonly"];
 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) {
+  let driveCredentials;
+  if (clientEmail && privateKey) {
+    driveCredentials = { client_email: clientEmail, private_key: normalizePrivateKey(privateKey) };
+  } else if (!process.env.GOOGLE_APPLICATION_CREDENTIALS) {
     throw new Error(
-      "Google Drive credentials required: GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY"
+      "Google Drive credentials required: set GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY, or set GOOGLE_APPLICATION_CREDENTIALS for Workload Identity Federation."
     );
   }
-  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 auth = buildGoogleAuth(DRIVE_SCOPES2, driveCredentials);
   const client = await auth.getClient();
   const tokenResponse = await client.getAccessToken();
   return tokenResponse.token;
@@ -1491,7 +1537,7 @@ async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
     const query = `'${folderId}' in parents${mimeClause} and trashed = false`;
     const params = new URLSearchParams({
       q: query,
-      fields: "nextPageToken,files(id,name,mimeType,parents)",
+      fields: "nextPageToken,files(id,name,mimeType,modifiedTime,parents)",
       pageSize: "1000"
     });
     if (pageToken) params.set("pageToken", pageToken);
@@ -1508,7 +1554,7 @@ async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
   } while (pageToken);
   return results;
 }
-async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern) {
+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 = [];
@@ -1524,12 +1570,20 @@ async function collectFiles(folderId, folderRelPath, outputPath, token, allowedM
         token,
         allowedMimeTypes,
         recursive,
-        folderPattern
+        folderPattern,
+        normalizeExts
       );
       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 });
+      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;
@@ -1575,7 +1629,9 @@ async function syncDriveImages(options) {
     folderPattern,
     credentials,
     cleanSync = false,
-    concurrency = 3
+    concurrency = 3,
+    incrementalSync = true,
+    normalizeExtensions = true
   } = options;
   const token = await getAccessToken2(credentials);
   mkdirSync(outputPath, { recursive: true });
@@ -1586,16 +1642,33 @@ async function syncDriveImages(options) {
     token,
     mimeTypes,
     recursive,
-    folderPattern
+    folderPattern,
+    normalizeExtensions
   );
   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;
+    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 {
@@ -1626,7 +1699,134 @@ async function syncDriveImages(options) {
   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,
@@ -1637,15 +1837,25 @@ async function manageDriveTranslations(options) {
     imageOutputPath,
     imageSyncOptions,
     translationOptions = {},
-    docTitles
+    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);
@@ -1655,6 +1865,8 @@ async function manageDriveTranslations(options) {
     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])];
@@ -1663,10 +1875,50 @@ async function manageDriveTranslations(options) {
     if (!name) return true;
     return spreadsheetNameFilter.test(name);
   }) : allIds;
-  const translations = await getMultipleSpreadSheetsData(docTitles, {
-    ...translationOptions,
-    spreadsheetIds: filteredIds.length > 0 ? filteredIds : void 0
-  });
+  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({
@@ -1675,13 +1927,31 @@ async function manageDriveTranslations(options) {
       outputPath: imageOutputPath
     });
   }
-  return { translations, spreadsheetIds: filteredIds, imageSync };
+  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,
+  buildGoogleAuth,
+  buildManifest,
   convertFromDataJsonFormat,
   convertToDataJsonFormat,
   createAuthClient,
@@ -1703,7 +1973,9 @@ export {
   manageDriveTranslations,
   mergeMultipleTranslationData,
   mergeSheets,
+  normalizeExtension,
   normalizeLocaleCode,
+  normalizePrivateKey,
   processRawRows,
   readPublicSheet,
   resolveLocaleWithFallback,
@@ -1712,9 +1984,12 @@ export {
   updateSpreadsheetWithLocalChanges,
   validateCredentials,
   validateEnv,
+  validateImageDirectory,
   wait,
+  walkDirectory,
   withRetry,
   writeLanguageDataFile,
   writeLocalesFile,
+  writeManifest,
   writeTranslationFiles
 };

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export type { SpreadsheetOptions } from './utils/configurationHandler';
 export { wait } from './utils/wait';
 export { withRetry } from './utils/rateLimiter';
 export { validateEnv } from './utils/validateEnv';
-export { createAuthClient } from './utils/auth';
+export { createAuthClient, buildGoogleAuth, normalizePrivateKey } from './utils/auth';
 export { convertToDataJsonFormat } from './utils/dataConverter/convertToDataJsonFormat';
 export { convertFromDataJsonFormat } from './utils/dataConverter/convertFromDataJsonFormat';
 export { findLocalChanges } from './utils/dataConverter/findLocalChanges';
@@ -30,10 +30,14 @@ 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 { 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

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,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"}
+{"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,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtF,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,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC1G,YAAY,EACV,oBAAoB,EACpB,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,eAAe,kBAAkB,CAAC"}