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

package/dist/providers/cryptpad/sheetParser.d.ts

@@ -0,0 +1,196 @@
+import type { SheetRow } from '../../types';
+export interface CryptPadSheetGrid {
+    [cellRef: string]: string;
+}
+export interface ReconstructedSheet {
+    cells: CryptPadSheetGrid;
+    rows: SheetRow[];
+    sheetNames: string[];
+}
+/** Converts column index (0-based) to letter: 0 -> 'A', 25 -> 'Z', 26 -> 'AA'. */
+export declare function colIndexToLetter(colIndex: number): string;
+/** Converts column letter to 0-based index: 'A' -> 0, 'Z' -> 25, 'AA' -> 26. */
+export declare function letterToColIndex(letter: string): number;
+/**
+ * Parses a cell reference into components: 'A1' -> { col: 'A', row: 1 },
+ * 'Sheet1!B2' -> { sheet: 'Sheet1', col: 'B', row: 2 }.
+ */
+export declare function parseCellRef(cellRef: string): {
+    sheet?: string;
+    col: string;
+    row: number;
+} | null;
+export interface OnlyOfficeMetadata {
+    channelId: string | null;
+    title: string | null;
+    defaultTitle: string | null;
+    userDoc?: Record<string, unknown>;
+}
+/**
+ * Extracts the active OnlyOffice real-time collaboration channel ID and document
+ * metadata from decrypted pad metadata messages.
+ *
+ * CryptPad metadata channels are governed by ChainPad (SmartJSONTransformer DAG).
+ * Replaying the ChainPad log deterministically computes the true, latest document
+ * state (userDoc.content.channel).
+ */
+export declare function extractOnlyOfficeMetadata(metadataMessages: string[]): OnlyOfficeMetadata;
+/**
+ * Extracts the most recently registered OnlyOffice real-time collaboration channel ID
+ * from decrypted pad metadata messages.
+ */
+export declare function extractOnlyOfficeChannelId(metadataMessages: string[]): string | null;
+/**
+ * Parses OnlyOffice incremental binary change records into cell coordinates and text values.
+ * Supports dynamic sheet identifiers, tab additions, renames, and binary change frames.
+ *
+ * @param rtMessages - Decrypted raw change messages retrieved from the OnlyOffice RT Netflux channel.
+ * @returns A mapping of cell coordinates (`A1` or `sheet!A1`) to cell text values.
+ */
+export declare function parseOnlyOfficeChanges(rtMessages: string[]): CryptPadSheetGrid;
+/**
+ * Extracts sheet name <-> sheet ID bidirectional mappings from OnlyOffice change messages.
+ */
+export declare function extractOnlyOfficeSheetIdMap(rtMessages: string[]): {
+    nameToId: Record<string, string>;
+    idToName: Record<string, string>;
+};
+/**
+ * Converts a grid of cell references (e.g. { A1: 'key', B1: 'en', A2: 'btn.save', B2: 'Save' })
+ * into structured `SheetRow[]` objects using row 1 as the header column keys.
+ */
+export declare function convertCellsToSheetRows(cells: CryptPadSheetGrid): SheetRow[];
+/**
+ * Builds a cell reference string such as "A1" or "Sheet1!B2".
+ */
+export declare function buildCellRef(sheetName: string | undefined, col: string | number, row: number): string;
+/**
+ * Groups a flat grid of cell coordinates by sheet tab name.
+ * Cells without an explicit sheet prefix are assigned to `defaultSheet` (defaults to 'Sheet1').
+ */
+export declare function groupCellsBySheet(cells: CryptPadSheetGrid, defaultSheet?: string): Record<string, CryptPadSheetGrid>;
+/**
+ * Converts a grid of cell references into a dictionary of SheetRow arrays keyed by sheet tab name.
+ */
+export declare function convertCellsToMultiSheetRows(cells: CryptPadSheetGrid, defaultSheet?: string): Record<string, SheetRow[]>;
+export interface OnlyOfficeCellUpdate {
+    sheet?: string;
+    sheetId?: string | number;
+    col: string | number;
+    row: number;
+    /** Literal cell text. Mutually exclusive with `formula` — exactly one must be set. */
+    value?: string;
+    /** Formula text (with or without a leading "="), e.g. "i18n!B1" or "=i18n!B1".
+     *  Mutually exclusive with `value` — exactly one must be set. See
+     *  {@link encodeOnlyOfficeFormulaCellRecord}. */
+    formula?: string;
+}
+/**
+ * Encodes a single cell update record into the native OnlyOffice binary format:
+ * AscCH.historyitem_Cell_ChangeValue (magic 0x01291001) with 32-bit LE coordinates c1, r1.
+ * Supports dynamic sheet ID identifiers (string or number).
+ *
+ * The returned buffer is a standalone, self-contained record ready to be base64-encoded
+ * and placed as a single `changes` entry in an OnlyOffice `saveChanges` message.
+ * Format: 4-byte LE record length + body bytes (magic, sheetId, coordinates, value).
+ */
+export declare function encodeOnlyOfficeCellRecord(cellRef: string, value: string, sheetId?: string | number): Buffer;
+/**
+ * Encodes a single FORMULA cell update record into the native OnlyOffice binary format:
+ * the same `AscCH.historyitem_Cell_ChangeValue` (magic 0x01291001) history item used for
+ * plain-text cells — confirmed from ONLYOFFICE/sdkjs source (`cell/model/Workbook.js`
+ * `setValue`/`setFormulaTemplate`, `cell/model/UndoRedo.js` `UndoRedoData_CellValueData`)
+ * that OnlyOffice does NOT use a separate history item for formulas; only the `NewVal`
+ * object's `formula` property differs (a UTF-16LE string instead of the Null marker).
+ *
+ * Layout derived by decoding this module's own byte-verified plain-text encoder
+ * ({@link encodeOnlyOfficeCellRecord}) against the sdkjs-confirmed property-ID scheme —
+ * every offset below was cross-checked against real, already-tested reference bytes:
+ *
+ * ```
+ * UndoRedoData_CellSimpleData (Row=0, Col=1, NewVal=2)
+ *   Row: SByte(r1&0xff)
+ *   Col: SByte(c1&0xff)
+ *   NewVal -> UndoRedoData_CellValueData (class byte 3) (formula=0, value=1, formulaRef=2, ca=3)
+ *     formula: String(f)        <- the formula text, WITHOUT a leading "="
+ *     value -> CCellValue (class byte 1) (text=0, multiText=1, number=2, type=3)
+ *       text: Null, multiText: Null, number: Null, type: SByte(0) [CellValueType.Number]
+ *       (a freshly-authored formula has no cached result yet — OnlyOffice's own recalc
+ *       engine computes and syncs the cached value once the client evaluates the formula;
+ *       this matches `Cell.prototype.cleanText()`, called synchronously before the record
+ *       is built in `setFormulaTemplate`)
+ *     formulaRef: Null
+ *     ca: Undefined (matches the literal-cell reference bytes, which use Undefined here
+ *       too rather than a Boolean default)
+ * ```
+ *
+ * NOT yet independently verified against a real captured formula-cell record from a live
+ * OnlyOffice session (unlike {@link encodeOnlyOfficeCellRecord} and
+ * {@link encodeOnlyOfficeSheetAddRecord}, which both have byte-exact reference captures)
+ * — see issue #165's own risk note about attempting formula encoding without a real
+ * reference binary. Treat with appropriate caution until cross-checked against a live
+ * capture.
+ *
+ * @param cellRef - Target cell, e.g. "A1" or "Sheet1!B2".
+ * @param formula - Formula text, with or without a leading "=" (stripped either way,
+ *   matching sdkjs's own `val[0] == "="` handling in `Workbook.js`).
+ * @param sheetId - Target sheet's internal OnlyOffice sheet ID.
+ */
+export declare function encodeOnlyOfficeFormulaCellRecord(cellRef: string, formula: string, sheetId?: string | number): Buffer;
+/**
+ * Formats a list of cell updates into an OnlyOffice `saveChanges` message.
+ *
+ * ### OnlyOffice Real-Time Change Protocol
+ * OnlyOffice broadcasts changes as a JSON `saveChanges` message with a `changes` array.
+ * Each entry in `changes` is an independent document record:
+ * - The first entry is always `txOpen` (transaction open marker, 14 bytes).
+ * - Each subsequent entry is a single cell update record.
+ *
+ * Each `change` value is a JSON-encoded string of the format `"<byteLength>;<base64>"`
+ * where `byteLength` is the binary buffer length and `<base64>` is the base64-encoded buffer.
+ *
+ * This matches the exact wire format used by real OnlyOffice collaborative sessions
+ * and ensures CryptPad's OnlyOffice integration can parse each record independently.
+ */
+export declare function buildOnlyOfficeChangePayload(updates: OnlyOfficeCellUpdate[], defaultSheetId?: string | number): string;
+/**
+ * Encodes a single "add worksheet tab" record into the native OnlyOffice binary format:
+ * AscCH.historyitem_Workbook_SheetAdd (real op code 1, from ONLYOFFICE/sdkjs
+ * `cell/model/History.js` — not a guessed name), UndoRedoDataTypes.SheetAdd (25, from
+ * `cell/model/UndoRedo.js`), with a generic property list matching
+ * `UndoRedoData_SheetAdd.prototype.Properties` (`name`=0, `sheetidfrom`=1, `sheetid`=2,
+ * `tableNames`=3, `insertBefore`=4, `opt_sheet`=5, `opt_sheetidToAdd`=6).
+ *
+ * Field layout was derived and verified against two independent real "add sheet"
+ * records captured from a live OnlyOffice browser session on a CryptPad pad (see
+ * issue #161): the body length implied by summing the fixed structural bytes plus the
+ * two variable-length UTF-16LE strings matched the actual captured body length exactly
+ * in both captures, and the `insertBefore` value matched the sheet's real insert
+ * position in both.
+ *
+ * Each optional/unused property (`sheetidfrom`, `tableNames`, `opt_sheet`,
+ * `opt_sheetidToAdd`) is written as its observed constant "null" marker byte — real
+ * OnlyOffice clients only populate them for operations this encoder doesn't need to
+ * perform (e.g. duplicating an existing sheet).
+ *
+ * @param name - Display name for the new sheet tab.
+ * @param sheetId - Freeform internal sheet identifier (see {@link generateOnlyOfficeSheetId}).
+ * @param insertBeforeIndex - 0-based tab position to insert at (0-255; real captures never
+ *   exceeded a handful of tabs, and the wire format observed here only ever used one byte).
+ */
+export declare function encodeOnlyOfficeSheetAddRecord(name: string, sheetId: string, insertBeforeIndex: number): Buffer;
+/**
+ * Generates a freeform internal sheetId string in the same shape real OnlyOffice
+ * clients use (`<numeric prefix>_<counter>`, e.g. `"7204278956594729_12"`, per live
+ * capture in #161). The exact value doesn't need to match any specific algorithm —
+ * the field is a free-form string elsewhere in the protocol — only a value that's
+ * unique within the pad.
+ */
+export declare function generateOnlyOfficeSheetId(): string;
+/**
+ * Formats a single "add worksheet tab" operation into an OnlyOffice `saveChanges`
+ * message, structured the same way as {@link buildOnlyOfficeChangePayload}
+ * (txOpen marker followed by one record).
+ */
+export declare function buildOnlyOfficeSheetAddPayload(name: string, sheetId: string, insertBeforeIndex: number): string;
+//# sourceMappingURL=sheetParser.d.ts.map

package/dist/providers/cryptpad/sheetParser.d.ts.map

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

package/dist/providers/cryptpad/sheetProvider.d.ts

@@ -0,0 +1,38 @@
+import type { TranslationInputProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+/** Definition of a single CryptPad sheet source to read as a translation table. */
+export interface CryptPadSheetSource {
+    /** Target table name (e.g. "i18n", "translations"). */
+    tableName: string;
+    /** Full CryptPad URL (e.g. https://cryptpad.fr/sheet/#/2/sheet/edit/seed/p/). */
+    url?: string;
+    /** Optional password if the pad is password-protected. */
+    password?: string;
+    /** Optional unique identifier for this source. */
+    tableId?: string;
+}
+/** Options for configuring the CryptPad Sheet input provider. */
+export interface CryptPadSheetInputProviderOptions {
+    /** Array of CryptPad sheet sources. */
+    sources?: CryptPadSheetSource[];
+    /** Convenience single-source URL. */
+    url?: string;
+    /** Convenience single-source password. */
+    password?: string;
+    /** Convenience single-source table name (defaults to 'translations'). */
+    tableName?: string;
+    /** Optional custom provider identifier. Defaults to 'cryptpad-sheet'. */
+    providerId?: string;
+    /** Optional custom provider display name. */
+    displayName?: string;
+    /** Optional timeout in milliseconds for WebSocket retrieval. */
+    timeoutMs?: number;
+}
+export declare const CRYPTPAD_SHEET_INPUT_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates a read-only {@link TranslationInputProvider} that retrieves translation tables
+ * directly from password-protected or public CryptPad spreadsheets (OnlyOffice sheets)
+ * using end-to-end encrypted Netflux WebSockets without requiring a browser or bot.
+ */
+export declare function createCryptPadSheetInputProvider(options: CryptPadSheetInputProviderOptions): TranslationInputProvider;
+//# sourceMappingURL=sheetProvider.d.ts.map

package/dist/providers/cryptpad/sheetProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheetProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/sheetProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EAGzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,iCAAiC;IAChD,uCAAuC;IACvC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,iCAAiC,EAAE,qBAG9C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,wBAAwB,CAyG1B"}

package/dist/providers/cryptpad/sheetSyncProvider.d.ts

@@ -0,0 +1,46 @@
+import type { TranslationSyncProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+import { type SyncConflictPolicy } from '../syncEngine';
+export interface CryptPadSheetSyncProviderOptions {
+    /** Full CryptPad URL (e.g. https://cryptpad.fr/sheet/#/2/sheet/edit/seed/p/). */
+    url?: string;
+    /** Optional password if the pad is password-protected. */
+    password?: string;
+    /** Conflict resolution strategy used during sync. Defaults to 'manual'. Only takes
+     *  effect when a real `baseTranslations` snapshot is supplied — see below. */
+    conflictPolicy?: SyncConflictPolicy;
+    /** When true, overwrites existing remote values even on conflict. Defaults to false. */
+    override?: boolean;
+    /** Column header mappings for locale normalization. */
+    localeMapping?: Record<string, string>;
+    /** Optional custom provider identifier. Defaults to 'cryptpad-sheet'. */
+    providerId?: string;
+    /** Optional custom provider display name. */
+    displayName?: string;
+    /** Optional timeout in milliseconds for WebSocket operations. */
+    timeoutMs?: number;
+}
+export declare const CRYPTPAD_SHEET_SYNC_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates a {@link TranslationSyncProvider} that reconciles local translation changes
+ * against a live CryptPad spreadsheet (multi-tab OnlyOffice workbook), pushing only
+ * the resolved diffs back over Netflux.
+ *
+ * ### Two modes, chosen automatically per call
+ *
+ * - **Default (no `payload.metadata.baseTranslations` supplied)** — the common case,
+ *   used by `gst-cryptpad sync` and anything else that doesn't track a real common-
+ *   ancestor snapshot. Uses the exact same one-way "push new keys only" diff
+ *   ({@link findLocalChanges}) as `createGoogleSheetsSyncProvider`, so `sync` behaves
+ *   identically across providers by default: an existing key that differs between
+ *   local and remote is left untouched either way, matching Google Sheets exactly.
+ *   (See issue #164 — without a genuine base snapshot, three-way conflict detection
+ *   degenerates to "no conflict ever detected," which is a materially different and
+ *   more aggressive behavior than Google's, not an intentional feature.)
+ * - **Advanced (a real `payload.metadata.baseTranslations` is supplied)** — a genuine
+ *   three-way merge via {@link resolveSyncPlan}, with `conflictPolicy` controlling how
+ *   keys that changed on both sides are resolved. This is an explicit opt-in for
+ *   callers that track a base snapshot themselves (see the Full Sync guide).
+ */
+export declare function createCryptPadSheetSyncProvider(options?: CryptPadSheetSyncProviderOptions): TranslationSyncProvider;
+//# sourceMappingURL=sheetSyncProvider.d.ts.map

package/dist/providers/cryptpad/sheetSyncProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheetSyncProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/sheetSyncProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,OAAO,EAAmB,KAAK,kBAAkB,EAA2B,MAAM,eAAe,CAAC;AAQlG,MAAM,WAAW,gCAAgC;IAC/C,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;kFAC8E;IAC9E,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gCAAgC,EAAE,qBAG7C,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,uBAAuB,CAqFzB"}

package/dist/providers/google/index.d.ts

@@ -0,0 +1,4 @@
+/** Barrel for the Google Sheets provider family (input/output/sync). */
+export { createGoogleSheetsInputProvider, createGoogleSheetsOutputProvider, createGoogleSheetsSyncProvider, GOOGLE_SHEETS_PROVIDER_CAPABILITIES, } from './providers';
+export type { GoogleSheetsInputProviderOptions, GoogleSheetsOutputProviderOptions, GoogleSheetsSyncProviderOptions, } from './providers';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/google/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/google/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,mCAAmC,GACpC,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,gCAAgC,EAChC,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,aAAa,CAAC"}

package/dist/providers/google/providers.d.ts

@@ -0,0 +1,106 @@
+import type { GoogleAuth } from 'google-auth-library';
+import { GoogleSpreadsheet } from 'google-spreadsheet';
+import type { TranslationInputProvider, TranslationOutputProvider, TranslationSyncProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+import { withRetry } from '../../utils/rateLimiter';
+import { updateSpreadsheetWithLocalChanges } from '../../utils/spreadsheetUpdater';
+import { findLocalChanges } from '../../utils/dataConverter/findLocalChanges';
+import type { SheetRow } from '../../types';
+/**
+ * Options for creating a Google Sheets input provider.
+ */
+export interface GoogleSheetsInputProviderOptions {
+    /** Target spreadsheet ID. If omitted, falls back to GOOGLE_SPREADSHEET_ID env var. */
+    spreadsheetId?: string;
+    /** Maximum number of rows to retrieve per sheet tab. Defaults to 100. */
+    rowLimit?: number;
+    /** Throttling delay in seconds between API requests. */
+    waitSeconds?: number;
+    /** When true, fetches public spreadsheet without requiring authentication. */
+    publicSheet?: boolean;
+    /** Custom provider identifier. Defaults to 'google-sheets'. */
+    providerId?: string;
+    /** Custom provider display name. */
+    displayName?: string;
+}
+/**
+ * Options for creating a Google Sheets output provider.
+ */
+export interface GoogleSheetsOutputProviderOptions {
+    /** Target spreadsheet ID. If omitted, falls back to GOOGLE_SPREADSHEET_ID env var. */
+    spreadsheetId?: string;
+    /** Throttling delay in seconds between API requests. */
+    waitSeconds?: number;
+    /** When true, automatically inserts GOOGLETRANSLATE formulas for missing translations. */
+    autoTranslate?: boolean;
+    /** When true with autoTranslate, overwrites existing manual translations with formulas. */
+    override?: boolean;
+    /** Column header mappings for locale normalization. */
+    localeMapping?: Record<string, string>;
+    /** Custom provider identifier. Defaults to 'google-sheets'. */
+    providerId?: string;
+    /** Custom provider display name. */
+    displayName?: string;
+}
+/**
+ * Options for creating a Google Sheets sync provider.
+ */
+export interface GoogleSheetsSyncProviderOptions {
+    /** Target spreadsheet ID. If omitted, falls back to GOOGLE_SPREADSHEET_ID env var. */
+    spreadsheetId?: string;
+    /** Throttling delay in seconds between API requests. */
+    waitSeconds?: number;
+    /** When true, automatically inserts GOOGLETRANSLATE formulas for missing translations. */
+    autoTranslate?: boolean;
+    /** When true with autoTranslate, overwrites existing manual translations with formulas. */
+    override?: boolean;
+    /** Column header mappings for locale normalization. */
+    localeMapping?: Record<string, string>;
+    /** Custom provider identifier. Defaults to 'google-sheets'. */
+    providerId?: string;
+    /** Custom provider display name. */
+    displayName?: string;
+}
+interface GoogleSheetsProviderDeps {
+    createAuthClient: () => GoogleAuth;
+    createSpreadsheetClient: (spreadsheetId: string, authClient: GoogleAuth) => GoogleSpreadsheet;
+    readPublicSheet: (spreadsheetId: string, sheetName: string) => Promise<SheetRow[]>;
+    withRetry: typeof withRetry;
+    updateSpreadsheetWithLocalChanges: typeof updateSpreadsheetWithLocalChanges;
+    findLocalChanges: typeof findLocalChanges;
+    logger: Pick<Console, 'warn' | 'log'>;
+}
+export declare function createDefaultDeps(): GoogleSheetsProviderDeps;
+/**
+ * Creates a {@link TranslationInputProvider} backed by Google Sheets. When
+ * `options.publicSheet` is true, reads via the no-auth public CSV export path
+ * (`publicReadNoAuth` capability); otherwise authenticates via
+ * {@link createAuthClient} and reads through the Google Sheets API, skipping
+ * (and warning about) any requested table name that has no matching sheet.
+ */
+export declare function createGoogleSheetsInputProvider(options?: GoogleSheetsInputProviderOptions, depsOverrides?: Partial<GoogleSheetsProviderDeps>): TranslationInputProvider;
+/**
+ * Creates a {@link TranslationOutputProvider} that authenticates and writes the full
+ * translation set to a Google Sheets spreadsheet via {@link updateSpreadsheetWithLocalChanges},
+ * optionally auto-translating missing cells with a formula (`autoTranslate`) and
+ * optionally overwriting existing non-empty cells (`override`).
+ */
+export declare function createGoogleSheetsOutputProvider(options?: GoogleSheetsOutputProviderOptions, depsOverrides?: Partial<GoogleSheetsProviderDeps>): TranslationOutputProvider;
+/**
+ * Creates a {@link TranslationSyncProvider} that computes local-only changes via
+ * {@link findLocalChanges} (comparing `localTranslations` against `remoteTranslations`)
+ * and, if any exist, writes just those changed keys back to the spreadsheet. Returns
+ * early with `changedKeys: 0` when there is no local diff, avoiding an unnecessary
+ * authenticated round-trip.
+ */
+export declare function createGoogleSheetsSyncProvider(options?: GoogleSheetsSyncProviderOptions, depsOverrides?: Partial<GoogleSheetsProviderDeps>): TranslationSyncProvider;
+/**
+ * Static capability sets declared for Google Sheets input, output, and sync providers.
+ */
+export declare const GOOGLE_SHEETS_PROVIDER_CAPABILITIES: {
+    readonly input: ProviderCapabilitySet;
+    readonly output: ProviderCapabilitySet;
+    readonly sync: ProviderCapabilitySet;
+};
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers/google/providers.d.ts.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Public barrel for the v3 provider platform: capability model, provider contracts
+ * (translation + asset), the built-in Google and CryptPad provider factories, the
+ * catalog/discovery API, the sync engine, the orchestrator, and the runtime config
+ * layer that wires a {@link ProviderRuntimeConfig} into concrete provider instances.
+ */
+export { PROVIDER_CAPABILITIES, EMPTY_PROVIDER_CAPABILITIES, OPERATION_CAPABILITY_REQUIREMENTS, createCapabilitySet, missingCapabilities, hasRequiredCapabilities, assertRequiredCapabilities, assertOperationCapabilities, } from './capabilities';
+export type { ProviderCapability, ProviderCapabilitySet, ProviderOperation } from './capabilities';
+export type { ProviderKind, ProviderMetadata, CanonicalTableInput, TranslationInputRequest, TranslationInputResult, TranslationOutputPayload, TranslationOutputResult, TranslationSyncPayload, TranslationSyncResult, TranslationInputProvider, TranslationOutputProvider, TranslationSyncProvider, AnyTranslationProvider, ProviderRegistry, SegmentedProviderRegistry, } from './contracts';
+export type { AssetProviderKind, CanonicalAssetEntry, AssetManifestResult, AssetSyncRequest, AssetSyncResult, AssetInputProvider, AssetOutputProvider, AssetSyncProvider, } from './assetContracts';
+export type { ProviderSourceKind, ProviderSourceDescriptor, ProviderDiscoveryRequest, ProviderDiscoveryResult, ProviderCatalogProvider, InMemoryProviderCatalogOptions, } from './catalog';
+export { createGoogleSheetsInputProvider, createGoogleSheetsOutputProvider, createGoogleSheetsSyncProvider, GOOGLE_SHEETS_PROVIDER_CAPABILITIES, } from './google';
+export type { GoogleSheetsInputProviderOptions, GoogleSheetsOutputProviderOptions, GoogleSheetsSyncProviderOptions, } from './google';
+export { createCryptPadCsvInputProvider, createCryptPadSheetInputProvider, createCryptPadSheetOutputProvider, createCryptPadSheetSyncProvider, createCryptPadDriveCatalogProvider, createCryptPadWorkspaceOutputProvider, createCryptPadWorkspaceSyncProvider, createCryptPadAssetSyncProvider, CryptPadClient, CryptPadDriveClient, parsePadUrl, deriveCryptPadKeys, decryptCryptPadPayload, encryptCryptPadPayload, resolveCryptPadWebsocketUrl, fetchChannelHistory, broadcastChannelMessage, extractOnlyOfficeChannelId, extractOnlyOfficeMetadata, extractOnlyOfficeSheetIdMap, parseOnlyOfficeChanges, convertCellsToSheetRows, convertCellsToMultiSheetRows, groupCellsBySheet, buildCellRef, buildOnlyOfficeChangePayload, encodeOnlyOfficeCellRecord, CRYPTPAD_CSV_INPUT_CAPABILITIES, CRYPTPAD_SHEET_INPUT_CAPABILITIES, CRYPTPAD_SHEET_OUTPUT_CAPABILITIES, CRYPTPAD_SHEET_SYNC_CAPABILITIES, CRYPTPAD_DRIVE_CATALOG_CAPABILITIES, CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES, CRYPTPAD_ASSET_SYNC_CAPABILITIES, } from './cryptpad';
+export type { CryptPadCsvSource, CryptPadCsvInputProviderOptions, CryptPadSheetSource, CryptPadSheetInputProviderOptions, CryptPadSheetOutputProviderOptions, CryptPadSheetSyncProviderOptions, CryptPadDriveCatalogOptions, CryptPadDriveItem, CryptPadDriveClientOptions, CryptPadClientOptions, CryptPadSheetResult, ParsedCryptPadUrl, DerivedCryptPadKeys, CryptPadSheetGrid, ReconstructedSheet, OnlyOfficeCellUpdate, CryptPadWorkspaceProviderOptions, CryptPadAssetSyncProviderOptions, } from './cryptpad';
+export { createInMemoryProviderCatalogProvider, createDefaultProviderCatalog } from './catalog';
+export { buildSyncPlan, resolveSyncPlan } from './syncEngine';
+export type { SyncConflictPolicy, SyncChangeType, SyncEntryChange, SyncConflict, SyncPlan, ResolveSyncPlanResult, BuildSyncPlanInput, } from './syncEngine';
+export { runProviderPipeline } from './orchestrator';
+export type { ProviderPipelineOptions, ProviderPipelineResult } from './orchestrator';
+export { validateProviderRuntimeConfig, assertValidProviderRuntimeConfig, mapLegacyGoogleOptionsToProviderConfig, } from './config';
+export type { ProviderReferenceConfig, ProviderRuntimeConfig, ProviderConfigValidationResult, LegacyConfigMappingResult, } from './config';
+export { createProvidersFromRuntimeConfig, requiresGoogleAuthForRuntimeConfig } from './runtime';
+export type { ProviderRuntimeSelection } from './runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

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

package/dist/providers/orchestrator.d.ts

@@ -0,0 +1,74 @@
+import { type SheetProcessingResult } from '../core/rowTransformer';
+import type { TranslationData } from '../types';
+import type { TranslationInputProvider, TranslationOutputProvider, TranslationSyncProvider, TranslationOutputResult, TranslationSyncResult } from './contracts';
+import type { AssetSyncProvider, AssetSyncResult } from './assetContracts';
+/**
+ * Configuration options for executing asset sync within the provider pipeline.
+ */
+export interface ProviderAssetSyncRequestOptions {
+    /** Local directory where synchronized assets will be written. */
+    targetDirectory: string;
+    /** When true, local files in targetDirectory not found in the manifest are removed. */
+    deleteMissing?: boolean;
+}
+/**
+ * Input options supplied to {@link runProviderPipeline} to configure input, output,
+ * sync, asset sync providers, and execution parameters.
+ */
+export interface ProviderPipelineOptions {
+    /** Provider responsible for reading canonical source tables. */
+    inputProvider: TranslationInputProvider;
+    /** Optional provider responsible for writing canonical tables to a destination. */
+    outputProvider?: TranslationOutputProvider;
+    /** Optional provider responsible for reconciling local changes back to the remote source. */
+    syncProvider?: TranslationSyncProvider;
+    /** Optional asset-sync provider (e.g. CryptPad asset manifest sync). Runs only when `assetSync` is also set. */
+    assetSyncProvider?: AssetSyncProvider;
+    /** Target directory (and delete-missing behavior) for the asset sync run. Ignored if `assetSyncProvider` is absent. */
+    assetSync?: ProviderAssetSyncRequestOptions;
+    /** Explicit list of table names to process. Defaults to input provider default if omitted. */
+    tableNames?: string[];
+    /** Snapshot of local translations used for three-way sync back. */
+    localTranslationsForSync?: TranslationData;
+    /** Optional abort signal for cancelling in-flight operations. */
+    signal?: AbortSignal;
+}
+/**
+ * Result returned by {@link runProviderPipeline} containing processed translations,
+ * discovered locales, mapping tables, and optional step results.
+ */
+export interface ProviderPipelineResult {
+    /** Merged translation data structured by locale -> table -> key -> value. */
+    translations: TranslationData;
+    /** Normalized list of locale identifiers present in the translations. */
+    locales: string[];
+    /** Mapping of original header columns to normalized locale codes. */
+    localeMapping: Record<string, string>;
+    /** Original locale mapping preserved for reverse lookup. */
+    originalLocaleMapping: Record<string, string>;
+    /** Total number of tables read from the input provider. */
+    inputTableCount: number;
+    /** Result from the output provider stage, if outputProvider was configured. */
+    outputResult?: TranslationOutputResult;
+    /** Result from the sync provider stage, if syncProvider was configured. */
+    syncResult?: TranslationSyncResult;
+    /** Result from the asset sync provider stage, if assetSyncProvider was configured and executed. */
+    assetSyncResult?: AssetSyncResult;
+    /** Additional provider-specific metadata returned from the pipeline execution. */
+    metadata?: Record<string, unknown>;
+}
+interface OrchestratorDeps {
+    transformRows: (rows: Record<string, string>[], sheetTitle: string) => SheetProcessingResult;
+    logger: Pick<Console, 'warn'>;
+}
+/**
+ * Runs the full provider-driven translation pipeline: read tables from the input
+ * provider, transform rows into canonical {@link TranslationData}, optionally write
+ * to an output provider, optionally sync local changes back, and optionally sync
+ * assets via an asset-sync provider. Each optional stage is gated by a capability
+ * check on the corresponding provider so unsupported operations fail fast instead
+ * of silently doing partial work.
+ */
+export declare function runProviderPipeline(options: ProviderPipelineOptions, depsOverrides?: Partial<OrchestratorDeps>): Promise<ProviderPipelineResult>;
+export {};
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/providers/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/providers/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,aAAa,EAAE,wBAAwB,CAAC;IACxC,mFAAmF;IACnF,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,6FAA6F;IAC7F,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,gHAAgH;IAChH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,uHAAuH;IACvH,SAAS,CAAC,EAAE,+BAA+B,CAAC;IAC5C,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mEAAmE;IACnE,wBAAwB,CAAC,EAAE,eAAe,CAAC;IAC3C,iEAAiE;IACjE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,YAAY,EAAE,eAAe,CAAC;IAC9B,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,mGAAmG;IACnG,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,gBAAgB;IACxB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,qBAAqB,CAAC;IAC7F,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAC/B;AAgCD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,aAAa,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAC5C,OAAO,CAAC,sBAAsB,CAAC,CA0GjC"}

package/dist/providers/runtime.d.ts

@@ -0,0 +1,30 @@
+import type { TranslationInputProvider, TranslationOutputProvider, TranslationSyncProvider } from './contracts';
+import type { AssetSyncProvider } from './assetContracts';
+import type { ProviderRuntimeConfig } from './config';
+/**
+ * Set of instantiated providers resolved from a {@link ProviderRuntimeConfig}.
+ */
+export interface ProviderRuntimeSelection {
+    /** Required input provider for reading source tables. */
+    inputProvider: TranslationInputProvider;
+    /** Optional output provider for writing destination tables. */
+    outputProvider?: TranslationOutputProvider;
+    /** Optional sync provider for two-way / three-way changes sync. */
+    syncProvider?: TranslationSyncProvider;
+    /** Optional asset sync provider for fetching and mirroring media assets. */
+    assetSyncProvider?: AssetSyncProvider;
+}
+/**
+ * Builds a {@link ProviderRuntimeSelection} by resolving each configured provider slot
+ * (`input`, `output`, `sync`, `assetSync`) to a concrete provider instance via its factory.
+ * Throws if a slot names a provider ID with no matching factory, or if a provider's
+ * required options are missing.
+ */
+export declare function createProvidersFromRuntimeConfig(config: ProviderRuntimeConfig): ProviderRuntimeSelection;
+/**
+ * Determines whether a runtime config needs authenticated Google credentials, i.e.
+ * whether Google Sheets is used for output/sync, or for input without `publicSheet: true`.
+ * Used to skip Google auth bootstrapping entirely for CryptPad-only pipelines.
+ */
+export declare function requiresGoogleAuthForRuntimeConfig(config: ProviderRuntimeConfig): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/providers/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/providers/runtime.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,aAAa,EAAE,wBAAwB,CAAC;IACxC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,mEAAmE;IACnE,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAwLD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,qBAAqB,GAC5B,wBAAwB,CAqB1B;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAezF"}