@el-j/google-sheet-translations 2.2.0-beta.6 → 2.2.0-beta.8

package/dist/action-entrypoint.d.ts

@@ -1,2 +1,12 @@
+/**
+ * Main GitHub Action entrypoint.
+ *
+ * Reads action inputs from the runner environment, configures Google Cloud
+ * credentials (WIF or classic service account key), executes either
+ * `manageDriveTranslations` (if `drive-folder-id` is present) or `getSpreadSheetData`,
+ * and sets step outputs (`translations-dir`, `locales-file`, `data-json-file`).
+ *
+ * @throws {Error} If authentication or required inputs are missing or sync fails.
+ */
 export declare function run(): Promise<void>;
 //# sourceMappingURL=action-entrypoint.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAMA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA8GzC"}
+{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA8GzC"}

package/dist/esm/index.js

@@ -571,6 +571,8 @@ function findLocalChanges(localData, spreadsheetData) {
 
 // src/utils/spreadsheetUpdater.ts
 import { setTimeout as delay2 } from "node:timers/promises";
+
+// src/utils/spreadsheetFormulas.ts
 function columnIndexToLetter(index) {
   let result = "";
   let i = index;
@@ -593,6 +595,8 @@ function langCodeFormula(cellRef, sep) {
   const full = `LOWER(${cellRef})`;
   return `IF(LOWER(LEFT(${cellRef}${sep}3))="zh-"${sep}${full}${sep}${prefix})`;
 }
+
+// src/utils/spreadsheetUpdater.ts
 async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, autoTranslate = false, localeMapping = {}, override = false) {
   console.log("Updating spreadsheet with local changes...");
   const baseDelayMs = waitSeconds * 1e3;
@@ -1541,9 +1545,12 @@ async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
       pageSize: "1000"
     });
     if (pageToken) params.set("pageToken", pageToken);
-    const response = await fetch(`${DRIVE_FILES_URL2}?${params.toString()}`, {
-      headers: { Authorization: `Bearer ${token}` }
-    });
+    const response = await withRetry(
+      () => fetch(`${DRIVE_FILES_URL2}?${params.toString()}`, {
+        headers: { Authorization: `Bearer ${token}` }
+      }),
+      `listDriveFiles(${folderId})`
+    );
     if (!response.ok) {
       const text = await response.text();
       throw new Error(`Drive API error ${response.status}: ${text}`);
@@ -1554,7 +1561,7 @@ async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
   } while (pageToken);
   return results;
 }
-async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern, normalizeExts = true) {
+async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern, normalizeExts = true, nameFilter) {
   console.log(`[driveImageSync] Scanning folder: ${folderId} (path: "${folderRelPath}")`);
   const allItems = await listFilesInFolder2(folderId, token);
   const entries = [];
@@ -1571,10 +1578,12 @@ async function collectFiles(folderId, folderRelPath, outputPath, token, allowedM
         allowedMimeTypes,
         recursive,
         folderPattern,
-        normalizeExts
+        normalizeExts,
+        nameFilter
       );
       entries.push(...subEntries);
     } else if (allowedMimeTypes.includes(item.mimeType)) {
+      if (nameFilter && !nameFilter.test(item.name)) continue;
       const localName = normalizeExts ? normalizeExtension(item.name) : item.name;
       const localPath = folderRelPath ? join(outputPath, folderRelPath, localName) : join(outputPath, localName);
       entries.push({
@@ -1590,7 +1599,10 @@ async function collectFiles(folderId, folderRelPath, outputPath, token, allowedM
 }
 async function downloadFile(fileId, localPath, token) {
   const url = `${DRIVE_FILES_URL2}/${fileId}?alt=media`;
-  const response = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+  const response = await withRetry(
+    () => fetch(url, { headers: { Authorization: `Bearer ${token}` } }),
+    `downloadDriveFile(${fileId})`
+  );
   if (!response.ok) {
     throw new Error(`Failed to download ${fileId}: ${response.status}`);
   }
@@ -1627,6 +1639,7 @@ async function syncDriveImages(options) {
     mimeTypes = DEFAULT_IMAGE_MIME_TYPES,
     recursive = true,
     folderPattern,
+    nameFilter,
     credentials,
     cleanSync = false,
     concurrency = 3,
@@ -1643,7 +1656,8 @@ async function syncDriveImages(options) {
     mimeTypes,
     recursive,
     folderPattern,
-    normalizeExtensions
+    normalizeExtensions,
+    nameFilter
   );
   const downloaded = [];
   const skipped = [];
@@ -2175,7 +2189,7 @@ async function ingestDoc(docFile, options = {}) {
   return { action: "refreshed", entry };
 }
 
-// src/utils/getDriveTranslations.ts
+// src/utils/driveSpreadsheetBootstrap.ts
 function sanitizeFolderName(name) {
   return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "") || "sheet";
 }
@@ -2205,6 +2219,8 @@ async function moveSpreadsheetToFolder(spreadsheetId, folderId) {
     }
   });
 }
+
+// src/utils/getDriveTranslations.ts
 async function manageDriveTranslations(options) {
   const {
     driveFolderId,
@@ -2401,7 +2417,7 @@ async function manageDriveTranslations(options) {
   return { translations, spreadsheetIds: filteredIds, imageSync, manifest, docIngestResults };
 }
 
-// src/setup/wifSetup.ts
+// src/setup/gcpTransport.ts
 import { GoogleAuth as GoogleAuth4 } from "google-auth-library";
 var GcpApiError = class extends Error {
   constructor(message, status) {
@@ -2410,7 +2426,7 @@ var GcpApiError = class extends Error {
     this.name = "GcpApiError";
   }
 };
-async function getAccessToken4(keyFilePath) {
+async function getGcpAccessToken(keyFilePath) {
   const auth = new GoogleAuth4({
     ...keyFilePath ? { keyFilename: keyFilePath } : {},
     scopes: ["https://www.googleapis.com/auth/cloud-platform"]
@@ -2441,7 +2457,7 @@ async function gcpFetch(url, token, method = "GET", body) {
   }
   return data;
 }
-async function pollOperation(operationName, token, maxWaitMs = 6e4) {
+async function waitForOperation(operationName, token, maxWaitMs = 6e4) {
   let opUrl;
   if (operationName.startsWith("http")) {
     let isGoogleHost;
@@ -2479,6 +2495,8 @@ async function pollOperation(operationName, token, maxWaitMs = 6e4) {
     );
   }
 }
+
+// src/setup/wifSetup.ts
 async function getProjectNumber(projectId, token) {
   const data = await gcpFetch(
     `https://cloudresourcemanager.googleapis.com/v1/projects/${encodeURIComponent(projectId)}`,
@@ -2499,7 +2517,7 @@ async function createOrGetWifPool(projectId, poolId, token) {
       }
     );
     if (!op.done) {
-      await pollOperation(op.name, token);
+      await waitForOperation(op.name, token);
     } else if (op.error) {
       throw new Error(`Operation failed: ${op.error.message}`);
     }
@@ -2532,7 +2550,7 @@ async function createOrGetWifProvider(projectId, poolId, providerId, githubRepo,
       }
     );
     if (!op.done) {
-      await pollOperation(op.name, token);
+      await waitForOperation(op.name, token);
     } else if (op.error) {
       throw new Error(`Operation failed: ${op.error.message}`);
     }
@@ -2580,7 +2598,7 @@ async function setupWIF(options) {
     );
   }
   log("Authenticating with Google Cloud...");
-  const token = await getAccessToken4(options.keyFilePath);
+  const token = await getGcpAccessToken(options.keyFilePath);
   log("Fetching project number...");
   const projectNumber = await getProjectNumber(options.projectId, token);
   log(`Creating Workload Identity Pool "${poolId}"...`);
@@ -2606,7 +2624,7 @@ async function setupWIF(options) {
   return { wifProvider, projectNumber, poolId, providerId };
 }
 async function grantDrivePermissions(options) {
-  const token = await getAccessToken4(options.keyFilePath);
+  const token = await getGcpAccessToken(options.keyFilePath);
   const policy = await gcpFetch(
     `https://cloudresourcemanager.googleapis.com/v1/projects/${encodeURIComponent(options.projectId)}:getIamPolicy`,
     token,
@@ -2641,6 +2659,7 @@ export {
   GcpApiError,
   buildGoogleAuth,
   buildManifest,
+  columnIndexToLetter,
   convertFromDataJsonFormat,
   convertToDataJsonFormat,
   createAuthClient,
@@ -2668,6 +2687,7 @@ export {
   manageDriveTranslations,
   mergeMultipleTranslationData,
   mergeSheets,
+  moveSpreadsheetToFolder,
   normalizeExtension,
   normalizeLocaleCode,
   normalizePrivateKey,
@@ -2676,6 +2696,7 @@ export {
   readManifest,
   readPublicSheet,
   resolveLocaleWithFallback,
+  sanitizeFolderName,
   scanDriveFolderForDocs,
   scanDriveFolderForSpreadsheets,
   setupWIF,

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { createAuthClient, buildGoogleAuth, normalizePrivateKey } from './utils/
 export { convertToDataJsonFormat } from './utils/dataConverter/convertToDataJsonFormat';
 export { convertFromDataJsonFormat } from './utils/dataConverter/convertFromDataJsonFormat';
 export { findLocalChanges } from './utils/dataConverter/findLocalChanges';
-export { updateSpreadsheetWithLocalChanges } from './utils/spreadsheetUpdater';
+export { updateSpreadsheetWithLocalChanges, columnIndexToLetter } from './utils/spreadsheetUpdater';
 export { readPublicSheet } from './utils/publicSheetReader';
 export { createSpreadsheet } from './utils/spreadsheetCreator';
 export { validateCredentials } from './utils/validateEnv';
@@ -34,7 +34,7 @@ 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 { manageDriveTranslations, sanitizeFolderName, moveSpreadsheetToFolder } from './utils/getDriveTranslations';
 export type { GoogleDriveManagerOptions, GoogleDriveManagerResult } from './utils/getDriveTranslations';
 export { buildManifest, writeManifest, readManifest } from './utils/driveProjectIndex';
 export type { DriveProjectManifest, SpreadsheetManifestEntry, BuildManifestOptions, DocManifestEntry } from './utils/driveProjectIndex';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -35,6 +35,7 @@ __export(index_exports, {
   GcpApiError: () => GcpApiError,
   buildGoogleAuth: () => buildGoogleAuth,
   buildManifest: () => buildManifest,
+  columnIndexToLetter: () => columnIndexToLetter,
   convertFromDataJsonFormat: () => convertFromDataJsonFormat,
   convertToDataJsonFormat: () => convertToDataJsonFormat,
   createAuthClient: () => createAuthClient,
@@ -62,6 +63,7 @@ __export(index_exports, {
   manageDriveTranslations: () => manageDriveTranslations,
   mergeMultipleTranslationData: () => mergeMultipleTranslationData,
   mergeSheets: () => mergeSheets,
+  moveSpreadsheetToFolder: () => moveSpreadsheetToFolder,
   normalizeExtension: () => normalizeExtension,
   normalizeLocaleCode: () => normalizeLocaleCode,
   normalizePrivateKey: () => normalizePrivateKey,
@@ -70,6 +72,7 @@ __export(index_exports, {
   readManifest: () => readManifest,
   readPublicSheet: () => readPublicSheet,
   resolveLocaleWithFallback: () => resolveLocaleWithFallback,
+  sanitizeFolderName: () => sanitizeFolderName,
   scanDriveFolderForDocs: () => scanDriveFolderForDocs,
   scanDriveFolderForSpreadsheets: () => scanDriveFolderForSpreadsheets,
   setupWIF: () => setupWIF,
@@ -662,6 +665,8 @@ function findLocalChanges(localData, spreadsheetData) {
 
 // src/utils/spreadsheetUpdater.ts
 var import_promises2 = require("node:timers/promises");
+
+// src/utils/spreadsheetFormulas.ts
 function columnIndexToLetter(index) {
   let result = "";
   let i = index;
@@ -684,6 +689,8 @@ function langCodeFormula(cellRef, sep) {
   const full = `LOWER(${cellRef})`;
   return `IF(LOWER(LEFT(${cellRef}${sep}3))="zh-"${sep}${full}${sep}${prefix})`;
 }
+
+// src/utils/spreadsheetUpdater.ts
 async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, autoTranslate = false, localeMapping = {}, override = false) {
   console.log("Updating spreadsheet with local changes...");
   const baseDelayMs = waitSeconds * 1e3;
@@ -1632,9 +1639,12 @@ async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
       pageSize: "1000"
     });
     if (pageToken) params.set("pageToken", pageToken);
-    const response = await fetch(`${DRIVE_FILES_URL2}?${params.toString()}`, {
-      headers: { Authorization: `Bearer ${token}` }
-    });
+    const response = await withRetry(
+      () => fetch(`${DRIVE_FILES_URL2}?${params.toString()}`, {
+        headers: { Authorization: `Bearer ${token}` }
+      }),
+      `listDriveFiles(${folderId})`
+    );
     if (!response.ok) {
       const text = await response.text();
       throw new Error(`Drive API error ${response.status}: ${text}`);
@@ -1645,7 +1655,7 @@ async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
   } while (pageToken);
   return results;
 }
-async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern, normalizeExts = true) {
+async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern, normalizeExts = true, nameFilter) {
   console.log(`[driveImageSync] Scanning folder: ${folderId} (path: "${folderRelPath}")`);
   const allItems = await listFilesInFolder2(folderId, token);
   const entries = [];
@@ -1662,10 +1672,12 @@ async function collectFiles(folderId, folderRelPath, outputPath, token, allowedM
         allowedMimeTypes,
         recursive,
         folderPattern,
-        normalizeExts
+        normalizeExts,
+        nameFilter
       );
       entries.push(...subEntries);
     } else if (allowedMimeTypes.includes(item.mimeType)) {
+      if (nameFilter && !nameFilter.test(item.name)) continue;
       const localName = normalizeExts ? normalizeExtension(item.name) : item.name;
       const localPath = folderRelPath ? (0, import_node_path5.join)(outputPath, folderRelPath, localName) : (0, import_node_path5.join)(outputPath, localName);
       entries.push({
@@ -1681,7 +1693,10 @@ async function collectFiles(folderId, folderRelPath, outputPath, token, allowedM
 }
 async function downloadFile(fileId, localPath, token) {
   const url = `${DRIVE_FILES_URL2}/${fileId}?alt=media`;
-  const response = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+  const response = await withRetry(
+    () => fetch(url, { headers: { Authorization: `Bearer ${token}` } }),
+    `downloadDriveFile(${fileId})`
+  );
   if (!response.ok) {
     throw new Error(`Failed to download ${fileId}: ${response.status}`);
   }
@@ -1718,6 +1733,7 @@ async function syncDriveImages(options) {
     mimeTypes = DEFAULT_IMAGE_MIME_TYPES,
     recursive = true,
     folderPattern,
+    nameFilter,
     credentials,
     cleanSync = false,
     concurrency = 3,
@@ -1734,7 +1750,8 @@ async function syncDriveImages(options) {
     mimeTypes,
     recursive,
     folderPattern,
-    normalizeExtensions
+    normalizeExtensions,
+    nameFilter
   );
   const downloaded = [];
   const skipped = [];
@@ -2266,7 +2283,7 @@ async function ingestDoc(docFile, options = {}) {
   return { action: "refreshed", entry };
 }
 
-// src/utils/getDriveTranslations.ts
+// src/utils/driveSpreadsheetBootstrap.ts
 function sanitizeFolderName(name) {
   return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "") || "sheet";
 }
@@ -2296,6 +2313,8 @@ async function moveSpreadsheetToFolder(spreadsheetId, folderId) {
     }
   });
 }
+
+// src/utils/getDriveTranslations.ts
 async function manageDriveTranslations(options) {
   const {
     driveFolderId,
@@ -2492,7 +2511,7 @@ async function manageDriveTranslations(options) {
   return { translations, spreadsheetIds: filteredIds, imageSync, manifest, docIngestResults };
 }
 
-// src/setup/wifSetup.ts
+// src/setup/gcpTransport.ts
 var import_google_auth_library4 = require("google-auth-library");
 var GcpApiError = class extends Error {
   constructor(message, status) {
@@ -2501,7 +2520,7 @@ var GcpApiError = class extends Error {
     this.name = "GcpApiError";
   }
 };
-async function getAccessToken4(keyFilePath) {
+async function getGcpAccessToken(keyFilePath) {
   const auth = new import_google_auth_library4.GoogleAuth({
     ...keyFilePath ? { keyFilename: keyFilePath } : {},
     scopes: ["https://www.googleapis.com/auth/cloud-platform"]
@@ -2532,7 +2551,7 @@ async function gcpFetch(url, token, method = "GET", body) {
   }
   return data;
 }
-async function pollOperation(operationName, token, maxWaitMs = 6e4) {
+async function waitForOperation(operationName, token, maxWaitMs = 6e4) {
   let opUrl;
   if (operationName.startsWith("http")) {
     let isGoogleHost;
@@ -2570,6 +2589,8 @@ async function pollOperation(operationName, token, maxWaitMs = 6e4) {
     );
   }
 }
+
+// src/setup/wifSetup.ts
 async function getProjectNumber(projectId, token) {
   const data = await gcpFetch(
     `https://cloudresourcemanager.googleapis.com/v1/projects/${encodeURIComponent(projectId)}`,
@@ -2590,7 +2611,7 @@ async function createOrGetWifPool(projectId, poolId, token) {
       }
     );
     if (!op.done) {
-      await pollOperation(op.name, token);
+      await waitForOperation(op.name, token);
     } else if (op.error) {
       throw new Error(`Operation failed: ${op.error.message}`);
     }
@@ -2623,7 +2644,7 @@ async function createOrGetWifProvider(projectId, poolId, providerId, githubRepo,
       }
     );
     if (!op.done) {
-      await pollOperation(op.name, token);
+      await waitForOperation(op.name, token);
     } else if (op.error) {
       throw new Error(`Operation failed: ${op.error.message}`);
     }
@@ -2671,7 +2692,7 @@ async function setupWIF(options) {
     );
   }
   log("Authenticating with Google Cloud...");
-  const token = await getAccessToken4(options.keyFilePath);
+  const token = await getGcpAccessToken(options.keyFilePath);
   log("Fetching project number...");
   const projectNumber = await getProjectNumber(options.projectId, token);
   log(`Creating Workload Identity Pool "${poolId}"...`);
@@ -2697,7 +2718,7 @@ async function setupWIF(options) {
   return { wifProvider, projectNumber, poolId, providerId };
 }
 async function grantDrivePermissions(options) {
-  const token = await getAccessToken4(options.keyFilePath);
+  const token = await getGcpAccessToken(options.keyFilePath);
   const policy = await gcpFetch(
     `https://cloudresourcemanager.googleapis.com/v1/projects/${encodeURIComponent(options.projectId)}:getIamPolicy`,
     token,
@@ -2733,6 +2754,7 @@ var index_default = getSpreadSheetData;
   GcpApiError,
   buildGoogleAuth,
   buildManifest,
+  columnIndexToLetter,
   convertFromDataJsonFormat,
   convertToDataJsonFormat,
   createAuthClient,
@@ -2759,6 +2781,7 @@ var index_default = getSpreadSheetData;
   manageDriveTranslations,
   mergeMultipleTranslationData,
   mergeSheets,
+  moveSpreadsheetToFolder,
   normalizeExtension,
   normalizeLocaleCode,
   normalizePrivateKey,
@@ -2767,6 +2790,7 @@ var index_default = getSpreadSheetData;
   readManifest,
   readPublicSheet,
   resolveLocaleWithFallback,
+  sanitizeFolderName,
   scanDriveFolderForDocs,
   scanDriveFolderForSpreadsheets,
   setupWIF,

package/dist/setup/gcpTransport.d.ts

@@ -0,0 +1,24 @@
+export interface GcpOperation {
+    name: string;
+    done?: boolean;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface IamPolicy {
+    bindings?: Array<{
+        role: string;
+        members: string[];
+    }>;
+    etag?: string;
+    version?: number;
+}
+export declare class GcpApiError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare function getGcpAccessToken(keyFilePath?: string): Promise<string>;
+export declare function gcpFetch(url: string, token: string, method?: string, body?: unknown): Promise<unknown>;
+export declare function waitForOperation(operationName: string, token: string, maxWaitMs?: number): Promise<void>;
+//# sourceMappingURL=gcpTransport.d.ts.map

package/dist/setup/gcpTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcpTransport.d.ts","sourceRoot":"","sources":["../../src/setup/gcpTransport.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAY,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;gBAD9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM;CAK/B;AAED,wBAAsB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB7E;AAED,wBAAsB,QAAQ,CAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,SAAQ,EACd,IAAI,CAAC,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,wBAAsB,gBAAgB,CACrC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/setup/wifSetup.d.ts

@@ -33,10 +33,8 @@ export interface GrantDrivePermissionsOptions {
     /** Path to a service account JSON key file used for bootstrapping. */
     keyFilePath?: string;
 }
-export declare class GcpApiError extends Error {
-    readonly status: number;
-    constructor(message: string, status: number);
-}
+import { GcpApiError } from "./gcpTransport";
+export { GcpApiError };
 /**
  * Configures Workload Identity Federation (WIF) on Google Cloud so that
  * GitHub Actions can authenticate without a long-lived service account key.

package/dist/setup/wifSetup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wifSetup.d.ts","sourceRoot":"","sources":["../../src/setup/wifSetup.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC/B,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;sEACkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC9B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC5C,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAkBD,qBAAa,WAAY,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;gBAD9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM;CAK/B;AAyND;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyChF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CA8Bf"}
+{"version":3,"file":"wifSetup.d.ts","sourceRoot":"","sources":["../../src/setup/wifSetup.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;sEACkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC9B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC5C,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,OAAO,EACN,WAAW,EAMX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,CAAC;AA0HvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyChF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/utils/driveImageSync.d.ts

@@ -15,6 +15,12 @@ export interface DriveImageSyncOptions {
      * Useful for patterns like `/^projects\//` or `/icons$/`.
      */
     folderPattern?: RegExp;
+    /**
+     * Optional regular expression to filter file names. Only files whose name
+     * matches this pattern will be downloaded.
+     * Example: `/^icon-/` or `/\.(png|svg)$/i`.
+     */
+    nameFilter?: 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) */

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

@@ -1 +1 @@
-{"version":3,"file":"driveImageSync.d.ts","sourceRoot":"","sources":["../../src/utils/driveImageSync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,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;IACrB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;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;AAwCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AA2JD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA4F/B"}
+{"version":3,"file":"driveImageSync.d.ts","sourceRoot":"","sources":["../../src/utils/driveImageSync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,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;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;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;AAwCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AAuKD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA8F/B"}

package/dist/utils/driveSpreadsheetBootstrap.d.ts

@@ -0,0 +1,12 @@
+/** Turns a spreadsheet name / ID into a safe directory segment */
+export declare function sanitizeFolderName(name: string): string;
+/**
+ * Moves a Google Spreadsheet (identified by `spreadsheetId`) into the given
+ * Drive folder by calling the Drive Files API with the `drive.file` scope.
+ *
+ * The service-account must have been granted edit access to the target folder.
+ * Uses the same credential detection order as `createAuthClient` (WIF first,
+ * then `GOOGLE_CLIENT_EMAIL` + `GOOGLE_PRIVATE_KEY`).
+ */
+export declare function moveSpreadsheetToFolder(spreadsheetId: string, folderId: string): Promise<void>;
+//# sourceMappingURL=driveSpreadsheetBootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driveSpreadsheetBootstrap.d.ts","sourceRoot":"","sources":["../../src/utils/driveSpreadsheetBootstrap.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/utils/getDriveTranslations.d.ts

@@ -132,6 +132,8 @@ export interface GoogleDriveManagerResult {
         action: 'created' | 'refreshed' | 'skipped';
     }>;
 }
+import { sanitizeFolderName, moveSpreadsheetToFolder } from './driveSpreadsheetBootstrap';
+export { sanitizeFolderName, moveSpreadsheetToFolder };
 /**
  * Top-level "headless CMS bridge" function.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"getDriveTranslations.d.ts","sourceRoot":"","sources":["../../src/utils/getDriveTranslations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAM9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,KAAK,EAAoB,oBAAoB,EAA4B,MAAM,qBAAqB,CAAC;AAI5G,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,yBAAyB;IACxC;;;;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;IAErB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,eAAe,CAAC;IAC9B,kDAAkD;IAClD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC5F;AA2DD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAuPnC"}
+{"version":3,"file":"getDriveTranslations.d.ts","sourceRoot":"","sources":["../../src/utils/getDriveTranslations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAM9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,KAAK,EAAoB,oBAAoB,EAA4B,MAAM,qBAAqB,CAAC;AAI5G,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,yBAAyB;IACxC;;;;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;IAErB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,eAAe,CAAC;IAC9B,kDAAkD;IAClD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC5F;AAED,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAuPnC"}

package/dist/utils/spreadsheetFormulas.d.ts

@@ -0,0 +1,51 @@
+import type { GoogleSpreadsheet } from "google-spreadsheet";
+/**
+ * Converts a 0-based column index to a spreadsheet column letter (A, B, ..., Z, AA, AB, ...)
+ *
+ * @param index - 0-based index of the column
+ * @returns Spreadsheet column letter (e.g. 0 -> 'A', 26 -> 'AA')
+ */
+export declare function columnIndexToLetter(index: number): string;
+/**
+ * Determines the formula argument separator based on the spreadsheet's locale.
+ *
+ * Google Sheets uses `,` for English, CJK and a few other locales, but `;` for
+ * the majority of European locales (German, French, Spanish, Italian, …).
+ * The Google Sheets API (`valueInputOption: USER_ENTERED`) parses formulas
+ * according to the spreadsheet's locale, so we must match the separator.
+ *
+ * @param doc - GoogleSpreadsheet document instance
+ * @returns `","` or `";"` – the argument separator to use in generated formulas.
+ */
+export declare function getFormulaSeparator(doc: GoogleSpreadsheet): string;
+/**
+ * Wraps a spreadsheet cell reference in a formula that extracts the
+ * GOOGLETRANSLATE-compatible language code from a locale header cell.
+ *
+ * For most locales the ISO 639-1 prefix before the first `"-"` is extracted
+ * (e.g. header `"tr-TR"` → `"tr"`, `"en-US"` → `"en"`).
+ *
+ * For Chinese variants (`zh-TW`, `zh-CN`) the full lowercased code is
+ * preserved because GOOGLETRANSLATE distinguishes Simplified from Traditional
+ * Chinese.
+ *
+ * Bare codes without a `"-"` are returned as-is (e.g. `"en"` → `"en"`).
+ *
+ * All inner function calls use the supplied `sep` so the generated fragment
+ * is consistent with the spreadsheet's locale.
+ *
+ * @param cellRef - A spreadsheet cell reference string, e.g. `$B$1` or `C$1`
+ * @param sep     - Formula argument separator (`","` or `";"`)
+ * @returns Formula fragment string for language code extraction
+ */
+export declare function langCodeFormula(cellRef: string, sep: string): string;
+/**
+ * Constructs a full `=GOOGLETRANSLATE(...)` formula for dynamic cell translation.
+ *
+ * @param sourceColLetter - Source column letter (e.g. 'B')
+ * @param targetColLetter - Target column letter (e.g. 'C')
+ * @param sep             - Argument separator (',' or ';')
+ * @returns `=GOOGLETRANSLATE(INDIRECT("B"&ROW()); langCodeFormula($B$1); langCodeFormula(C$1))`
+ */
+export declare function buildGoogleTranslateFormula(sourceColLetter: string, targetColLetter: string, sep: string): string;
+//# sourceMappingURL=spreadsheetFormulas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheetFormulas.d.ts","sourceRoot":"","sources":["../../src/utils/spreadsheetFormulas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAalE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACvC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,GACZ,MAAM,CAER"}

package/dist/utils/spreadsheetUpdater.d.ts

@@ -1,5 +1,7 @@
 import type { GoogleSpreadsheet } from "google-spreadsheet";
 import type { TranslationData } from "../types";
+import { columnIndexToLetter, getFormulaSeparator, langCodeFormula, buildGoogleTranslateFormula } from "./spreadsheetFormulas";
+export { columnIndexToLetter, getFormulaSeparator, langCodeFormula, buildGoogleTranslateFormula };
 /**
  * Updates the Google Spreadsheet with new keys from local data.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"spreadsheetUpdater.d.ts","sourceRoot":"","sources":["../../src/utils/spreadsheetUpdater.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAA8B,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAqEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,iCAAiC,CACnD,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,aAAa,UAAQ,EACrB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC1C,QAAQ,UAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAgVf"}
+{"version":3,"file":"spreadsheetUpdater.d.ts","sourceRoot":"","sources":["../../src/utils/spreadsheetUpdater.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAA8B,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD,OAAO,EACH,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,2BAA2B,EAAE,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,iCAAiC,CACnD,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,aAAa,UAAQ,EACrB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC1C,QAAQ,UAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAgVf"}

package/dist-cli/setup-wif.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import{createRequire}from'module';const require=createRequire(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -18565,7 +18566,7 @@ var require_src5 = __commonJS({
 // src/setup/cli.ts
 import * as readline from "readline";
 
-// src/setup/wifSetup.ts
+// src/setup/gcpTransport.ts
 var import_google_auth_library = __toESM(require_src5());
 var GcpApiError = class extends Error {
   constructor(message, status) {
@@ -18574,7 +18575,7 @@ var GcpApiError = class extends Error {
     this.name = "GcpApiError";
   }
 };
-async function getAccessToken(keyFilePath) {
+async function getGcpAccessToken(keyFilePath) {
   const auth = new import_google_auth_library.GoogleAuth({
     ...keyFilePath ? { keyFilename: keyFilePath } : {},
     scopes: ["https://www.googleapis.com/auth/cloud-platform"]
@@ -18605,7 +18606,7 @@ async function gcpFetch(url, token, method = "GET", body) {
   }
   return data;
 }
-async function pollOperation(operationName, token, maxWaitMs = 6e4) {
+async function waitForOperation(operationName, token, maxWaitMs = 6e4) {
   let opUrl;
   if (operationName.startsWith("http")) {
     let isGoogleHost;
@@ -18643,6 +18644,8 @@ async function pollOperation(operationName, token, maxWaitMs = 6e4) {
     );
   }
 }
+
+// src/setup/wifSetup.ts
 async function getProjectNumber(projectId, token) {
   const data = await gcpFetch(
     `https://cloudresourcemanager.googleapis.com/v1/projects/${encodeURIComponent(projectId)}`,
@@ -18663,7 +18666,7 @@ async function createOrGetWifPool(projectId, poolId, token) {
       }
     );
     if (!op.done) {
-      await pollOperation(op.name, token);
+      await waitForOperation(op.name, token);
     } else if (op.error) {
       throw new Error(`Operation failed: ${op.error.message}`);
     }
@@ -18696,7 +18699,7 @@ async function createOrGetWifProvider(projectId, poolId, providerId, githubRepo,
       }
     );
     if (!op.done) {
-      await pollOperation(op.name, token);
+      await waitForOperation(op.name, token);
     } else if (op.error) {
       throw new Error(`Operation failed: ${op.error.message}`);
     }
@@ -18744,7 +18747,7 @@ async function setupWIF(options) {
     );
   }
   log("Authenticating with Google Cloud...");
-  const token = await getAccessToken(options.keyFilePath);
+  const token = await getGcpAccessToken(options.keyFilePath);
   log("Fetching project number...");
   const projectNumber = await getProjectNumber(options.projectId, token);
   log(`Creating Workload Identity Pool "${poolId}"...`);
@@ -18770,7 +18773,7 @@ async function setupWIF(options) {
   return { wifProvider, projectNumber, poolId, providerId };
 }
 async function grantDrivePermissions(options) {
-  const token = await getAccessToken(options.keyFilePath);
+  const token = await getGcpAccessToken(options.keyFilePath);
   const policy = await gcpFetch(
     `https://cloudresourcemanager.googleapis.com/v1/projects/${encodeURIComponent(options.projectId)}:getIamPolicy`,
     token,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@el-j/google-sheet-translations",
-  "version": "2.2.0-beta.6",
+  "version": "2.2.0-beta.8",
   "description": "A package to manage translations stored in Google Spreadsheets",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -27,7 +27,7 @@
   ],
   "scripts": {
     "build:action": "rimraf dist-action && esbuild src/action-entrypoint.ts --bundle --platform=node --format=esm --outfile=dist-action/index.mjs --banner:js=\"import{createRequire}from'module';const require=createRequire(import.meta.url);\" --log-level=info && node -e \"const fs=require('fs');const path='dist-action/index.mjs';const search='const url = (opts.url || \\\"\\\").toString();\\n          if (!url.includes(\\\"googleapis.com\\\") && !url.includes(\\\"google.com\\\")) {';const replacement='const url = (opts.url || \\\"\\\").toString();\\n          let isGoogleHost = false;\\n          try {\\n            const parsedUrl = new URL(url);\\n            const hostname = (parsedUrl.hostname || \\\"\\\").toLowerCase();\\n            isGoogleHost = hostname === \\\"googleapis.com\\\" || hostname.endsWith(\\\".googleapis.com\\\") || hostname === \\\"google.com\\\" || hostname.endsWith(\\\".google.com\\\");\\n          } catch {\\n            isGoogleHost = false;\\n          }\\n          if (!isGoogleHost) {';const data=fs.readFileSync(path,'utf8');if(!data.includes(search)){throw new Error('Expected host-check snippet not found in dist-action bundle');}fs.writeFileSync(path,data.replace(search,replacement));\"",
-    "build:cli": "rimraf dist-cli && esbuild src/setup/cli.ts --bundle --platform=node --format=esm --outfile=dist-cli/setup-wif.mjs --banner:js=\"#!/usr/bin/env node\" --log-level=info",
+    "build:cli": "rimraf dist-cli && esbuild src/setup/cli.ts --bundle --platform=node --format=esm --outfile=dist-cli/setup-wif.mjs --banner:js=\"#!/usr/bin/env node\nimport{createRequire}from'module';const require=createRequire(import.meta.url);\" --log-level=info",
     "build:types": "tsc --emitDeclarationOnly",
     "build:cjs": "esbuild src/index.ts --bundle --format=cjs --outfile=dist/index.js --platform=node --packages=external",
     "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/esm/index.js --platform=node --packages=external && node -e \"require('fs').writeFileSync('dist/esm/package.json', JSON.stringify({type:'module'}))\"",
@@ -109,6 +109,7 @@
     }
   },
   "allowScripts": {
-    "esbuild@0.28.2": true
+    "esbuild@0.28.2": true,
+    "fsevents@2.3.3": true
   }
 }