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

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
@@ -372,6 +378,23 @@ jobs:
 | `spreadsheet-title` | ❌ | `google-sheet-translations` | Title for the auto-created spreadsheet |
 | `source-locale` | ❌ | `en` | Source locale used as the base for auto-translate formulas |
 | `target-locales` | ❌ | `de,fr,es,it,pt,ja,zh` | Comma-separated target locales added to the auto-created spreadsheet |
+| `drive-folder-id` | ❌ | `''` | Drive folder ID used to auto-discover spreadsheets, docs, and images |
+| `scan-for-spreadsheets` | ❌ | `true` | When `drive-folder-id` is set, scan the folder recursively for spreadsheets |
+| `spreadsheet-ids` | ❌ | `''` | Optional extra spreadsheet IDs to merge with any IDs discovered in Drive |
+| `sync-images` | ❌ | `false` | Download Drive images alongside translation sync |
+| `image-output-path` | ❌ | `./public/remote-images` | Output directory for downloaded Drive images when `sync-images` is enabled |
+
+### Drive Folder Mode
+
+When `drive-folder-id` is set, the action switches from single-spreadsheet mode to `manageDriveTranslations()`. That enables recursive spreadsheet discovery, optional image sync, and optional explicit `spreadsheet-ids` on the same run.
+
+Operational notes:
+
+- If the Drive folder is empty and `auto-create` remains enabled, the package creates a spreadsheet and then tries to move it into the target folder.
+- `spreadsheetNameFilter` only applies to discovered sheets in the programmatic API. Explicit `spreadsheet-ids` are never filtered out.
+- `sync-images` supports incremental freshness checks and optional `cleanSync` deletion in the programmatic API. See the Drive Folder guide for those semantics before enabling destructive cleanup.
+
+See the full Drive Folder guide in `website/guide/drive-folder.md` for the complete API surface, image sync semantics, and Google Doc ingestion details.
 
 ### Outputs
 

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,CA2FzC"}
+{"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"}