@el-j/google-sheet-translations 2.2.0 → 3.0.0-beta.13

package/README.md

@@ -15,7 +15,7 @@ A Node.js package for managing translations stored in Google Sheets.
 - ✅ **Smart Locale Filtering**: Only locales with actual translations in content sheets are included in output files
 - ✅ **TypeScript Support**: Full TypeScript definitions included
 - ✅ **Modular Architecture**: Well-tested, maintainable codebase with clear separation of concerns
-- ✅ **Next.js Integration**: Built-in support for Next.js static export workflows
+- ✅ **Next.js & Astro Integration**: Built-in support for Next.js static export workflows and Astro build-time hooks
 - ✅ **Flexible Configuration**: Customizable paths, wait times, and processing options
 - ✅ **GitHub Action**: One-step CI integration via `el-j/google-sheet-translations@v2` — see [GitHub Action](#github-action)
 
@@ -291,6 +291,7 @@ For more detailed examples, check out the [examples directory](examples) where y
 - Bidirectional sync
 - Auto-translation
 - Next.js integration
+- Astro integration
 
 ## GitHub Action
 
@@ -383,6 +384,8 @@ jobs:
 | `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 |
+| `provider-config` | ❌ | `''` | Inline JSON for v3 provider runtime config (mutually exclusive with `provider-config-path`) |
+| `provider-config-path` | ❌ | `''` | Path to provider runtime config JSON file in the repo (mutually exclusive with `provider-config`) |
 
 ### Drive Folder Mode
 
@@ -404,6 +407,46 @@ See the full Drive Folder guide in `website/guide/drive-folder.md` for the compl
 | `locales-file` | Absolute path of the generated `locales.ts` |
 | `data-json-file` | Absolute path of the `languageData.json` snapshot |
 
+## Provider Runtime CLI (v3)
+
+In addition to `gst-setup-wif`, the package ships `gst-run-provider` for provider-config driven execution:
+
+```bash
+gst-run-provider --config=provider.config.json --sheet-titles=home,about
+```
+
+For existing workflows, use `gst-migrate-v3` to generate provider config from legacy action inputs:
+
+```bash
+gst-migrate-v3 --dry-run
+gst-migrate-v3 --dry-run --parity-check
+gst-migrate-v3 --write-workflows --provider-config-path=.github/provider.config.json
+```
+
+If a config already exists and should be replaced:
+
+```bash
+gst-migrate-v3 --force --provider-config-path=.github/provider.config.json
+```
+
+Example `provider.config.json` for CryptPad CSV input:
+
+```json
+{
+  "input": {
+    "provider": "cryptpad-csv",
+    "options": {
+      "sources": [
+        {
+          "tableName": "home",
+          "url": "https://cryptpad.fr/.../export.csv"
+        }
+      ]
+    }
+  }
+}
+```
+
 ### Auto-Create Feature
 
 If `google-spreadsheet-id` is left empty and `auto-create` is `true` (the default), the action will automatically create a new Google Spreadsheet using your service-account credentials. The spreadsheet is pre-populated with an `i18n` starter sheet containing `GOOGLETRANSLATE` formulas for every locale listed in `target-locales`. The new spreadsheet ID is printed to the workflow log and written to your `.env` file (if one exists in the repository root), allowing you to commit it and reuse it in future runs.

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;;;;;;;;;GASG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA8GzC"}
+{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAmMzC"}

package/dist/core/rowTransformer.d.ts

@@ -0,0 +1,26 @@
+import type { SheetRow, TranslationData } from '../types';
+/**
+ * Result of processing a single sheet.
+ */
+export interface SheetProcessingResult {
+    translations: TranslationData;
+    locales: string[];
+    localeMapping: Record<string, string>;
+    originalMapping: Record<string, string>;
+    success: boolean;
+}
+export interface LocaleMappingResult {
+    normalizedLocales: string[];
+    localeMapping: Record<string, string>;
+    originalMapping: Record<string, string>;
+}
+export interface RowTransformerDependencies {
+    filterValidLocales: (headerRow: string[], keyColumn: string) => string[];
+    createLocaleMapping: (originalHeaders: string[], keyColumn: string) => LocaleMappingResult;
+    logger?: Pick<Console, 'warn' | 'error' | 'log'>;
+}
+/**
+ * Pure transformation core: converts canonical rows into TranslationData for one sheet.
+ */
+export declare function transformRowsToSheetData(rows: SheetRow[], sheetTitle: string, deps: RowTransformerDependencies): SheetProcessingResult;
+//# sourceMappingURL=rowTransformer.d.ts.map

package/dist/core/rowTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowTransformer.d.ts","sourceRoot":"","sources":["../../src/core/rowTransformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACzE,mBAAmB,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAC3F,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EAAE,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,0BAA0B,GAC/B,qBAAqB,CA8EvB"}