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

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

@@ -0,0 +1,195 @@
+import { type ParsedCryptPadUrl, type DerivedCryptPadKeys } from './crypto';
+import { type CryptPadSheetGrid, type OnlyOfficeCellUpdate } from './sheetParser';
+import type { SheetRow } from '../../types';
+export interface CryptPadClientOptions {
+    /** Full CryptPad URL (e.g. https://cryptpad.fr/sheet/#/2/sheet/edit/seed/p/). */
+    url: string;
+    /** Password for password-protected pads. */
+    password?: string;
+    /** Optional custom WebSocket endpoint override. If omitted, automatically queried from instance config. */
+    websocketUrl?: string;
+    /** Optional timeout in milliseconds for history retrieval. Defaults to 10000ms. */
+    timeoutMs?: number;
+    /** Optional callback for progress/status messages during headless RT channel setup. */
+    onProgress?: (message: string) => void;
+}
+export interface CryptPadSheetResult {
+    url: string;
+    cells: CryptPadSheetGrid;
+    rows: SheetRow[];
+    sheets: Record<string, {
+        cells: CryptPadSheetGrid;
+        rows: SheetRow[];
+    }>;
+    sheetNames: string[];
+    sheetIds?: Record<string, string>;
+    metadata: {
+        app: string;
+        mode: string;
+        channelId: string;
+        rtChannelId?: string;
+        title?: string;
+    };
+}
+/**
+ * Headless programmatic client for interacting with CryptPad documents (spreadsheets)
+ * over end-to-end encrypted Netflux WebSockets without requiring a browser or user interaction.
+ */
+export declare class CryptPadClient {
+    readonly parsedUrl: ParsedCryptPadUrl;
+    readonly password?: string;
+    websocketUrl?: string;
+    readonly timeoutMs: number;
+    readonly onProgress?: (message: string) => void;
+    private derivedKeys?;
+    constructor(options: CryptPadClientOptions);
+    /**
+     * Gets or derives the symmetric key and primary Netflux channel ID.
+     *
+     * @returns The derived CryptPad channel hex ID and 32-byte TweetNaCl secretbox key.
+     */
+    getKeys(): DerivedCryptPadKeys;
+    /**
+     * Resolves the Netflux WebSocket endpoint to connect to. Cached on this instance after
+     * the first successful resolution — every multi-step operation (`writeSheetRows` in
+     * particular) calls this once per sub-step, and re-resolving the same endpoint via a
+     * fresh HTTP request each time needlessly multiplies outbound connections for no benefit
+     * (the endpoint doesn't change within a single client's lifetime).
+     *
+     * @param signal - Optional AbortSignal to cancel connection discovery.
+     * @returns The WebSocket endpoint URL (wss:// or ws://).
+     */
+    getWebsocketUrl(signal?: AbortSignal): Promise<string>;
+    /**
+     * Initializes the OnlyOffice RT channel for a brand-new CryptPad sheet that has never
+     * been opened in a browser.
+     *
+     * ### CryptPad Protocol Details
+     * CryptPad pads use Netflux channels for real-time collaboration. The main pad channel
+     * stores document metadata. When a spreadsheet pad is opened in OnlyOffice, the OnlyOffice
+     * web wrapper creates a secondary Netflux channel for real-time document change frames
+     * and registers it in the pad's metadata channel.
+     *
+     * The metadata update is formatted as an edit sequence:
+     * `[sequenceNumber, [[offset, length, innerJsonString]]]`
+     * where `sequenceNumber` is 1, and `innerJsonString` is:
+     * `{"content":{"channel":"<32-hex-channel-id>"}}`.
+     *
+     * Broadcasting this envelope over the main channel headlessly replicates OnlyOffice's
+     * first-open handshake without requiring a browser or headless browser session.
+     *
+     * @param signal - Optional AbortSignal to cancel the initialization.
+     * @returns The newly allocated 32-character hexadecimal RT channel ID.
+     */
+    initializeRtChannel(signal?: AbortSignal): Promise<string>;
+    /**
+     * Creates a new sheet tab on this pad by broadcasting a real OnlyOffice
+     * `Workbook_SheetAdd` history record to the RT channel — the same operation a
+     * real OnlyOffice browser client sends when a user clicks "Add sheet". The
+     * binary layout was derived and byte-verified against two independent live
+     * captures from an actual browser session (see issue #161); it is not a guess.
+     *
+     * If the pad has never been opened by a real OnlyOffice client (no RT channel
+     * yet), the RT channel is initialized headlessly first, matching {@link sendCellUpdates}.
+     *
+     * @param name - Display name for the new sheet tab.
+     * @param insertBeforeIndex - 0-based tab position to insert at. Defaults to appending
+     *   after all currently known tabs.
+     * @param signal - Optional AbortSignal.
+     * @returns The newly generated internal sheetId — use this for subsequent cell writes
+     *   into the new sheet.
+     */
+    createSheet(name: string, insertBeforeIndex?: number, signal?: AbortSignal): Promise<string>;
+    /**
+     * Broadcasts a `Workbook_SheetAdd` record to an already-known RT channel, without
+     * re-fetching sheet data first. Used internally by {@link createSheet} (after it has
+     * resolved the channel) and by the `i18n`-header-linking path in {@link writeSheetRows}
+     * to avoid opening a fresh WebSocket connection for every step of a single push — CryptPad
+     * (and this environment's outbound networking) can drop a connection attempt when several
+     * are opened back-to-back in quick succession.
+     */
+    private broadcastSheetAdd;
+    /**
+     * Writes a literal-text header row (row 1) into a sheet — the canonical, non-linked
+     * form used for the `i18n` sheet itself (there is nothing to link an `i18n` header to)
+     * and as the safe fallback whenever a new sheet's columns can't be aligned 1:1 with an
+     * already-existing `i18n` sheet's header. Takes an already-known `rtChannel` to avoid an
+     * extra connection round-trip (see {@link broadcastSheetAdd}).
+     */
+    private writeLiteralHeaderRow;
+    /**
+     * Writes a header row (row 1) whose cells are formulas referencing the corresponding
+     * column of the reserved `i18n` sheet's own header row (`=i18n!A1`, `=i18n!B1`, ...),
+     * so a sheet's header visually mirrors `i18n` instead of duplicating literal text — see
+     * issue #165. Column `idx` here must already be verified to align with the `i18n`
+     * sheet's real column `idx` by the caller ({@link ensureI18nSheetHeader}). Takes an
+     * already-known `rtChannel` to avoid an extra connection round-trip.
+     */
+    private writeLinkedHeaderRow;
+    /**
+     * Ensures the reserved `i18n` sheet exists and has a header row, so other sheets can
+     * link their own header cells to it (see issue #165). Never overwrites an `i18n` header
+     * that already has content — it is the canonical source, so once populated it's treated
+     * as authoritative and only ever appended-to-by-creation, never silently rewritten.
+     *
+     * Takes the caller's already-fetched `data` snapshot and `rtChannel` instead of
+     * re-fetching — `data` was captured before this call's own sheet creation, but `i18n`'s
+     * own state is unaffected by creating a *different* sheet, so it stays accurate. This
+     * keeps a single `writeSheetRows` call from opening a new connection per sub-step.
+     *
+     * @param desiredHeaders - Header row to write if `i18n` doesn't exist yet (or exists but
+     *   has no header row). Ignored if `i18n` already has a populated header row.
+     * @returns The `i18n` sheet's ID and its actual current header row (which may differ
+     *   from `desiredHeaders` if the sheet already existed with different columns) — callers
+     *   must compare before linking, since a mismatched column order would silently point a
+     *   new sheet's header cells at the wrong `i18n` columns.
+     */
+    private ensureI18nSheetHeader;
+    /**
+     * Fetches the complete sheet data, including raw cell coordinate mappings,
+     * multi-sheet tabs, and structured rows formatted for translation ingestion.
+     *
+     * @param signal - Optional AbortSignal to cancel the fetch.
+     * @returns The structured {@link CryptPadSheetResult} containing grids, rows, and metadata.
+     */
+    fetchSheetData(signal?: AbortSignal): Promise<CryptPadSheetResult>;
+    /**
+     * Directly fetches tabular translation rows `[ { key: '...', en: '...', de: '...' } ]`.
+     * If `sheetName` is provided, returns rows for that specific tab.
+     *
+     * @param sheetName - Optional tab/sheet name to extract rows from.
+     * @param signal - Optional AbortSignal to cancel the operation.
+     * @returns An array of {@link SheetRow} objects.
+     */
+    fetchSheetRows(sheetName?: string, signal?: AbortSignal): Promise<SheetRow[]>;
+    /**
+     * Broadcasts cell updates to the OnlyOffice real-time collaboration channel.
+     * If the sheet has never been opened in a browser (RT channel is None), it is
+     * automatically initialized headlessly — no browser required.
+     *
+     * @param updates - Array of cell updates containing coordinates and text values.
+     * @param signal - Optional AbortSignal to cancel the broadcast.
+     * @param existingRtChannel - Optional pre-fetched RT channel ID to avoid refetching sheet data.
+     */
+    sendCellUpdates(updates: OnlyOfficeCellUpdate[], signal?: AbortSignal, existingRtChannel?: string): Promise<void>;
+    /**
+     * Updates or appends rows in a target sheet tab, creating new cells as needed.
+     *
+     * @param sheetName - Target sheet tab name (e.g. 'i18n' or 'common').
+     * @param rows - Array of translation rows to write.
+     * @param options - Write options: override existing non-empty values and optional signal.
+     * @returns The total number of cell update records sent.
+     */
+    writeSheetRows(sheetName: string, rows: SheetRow[], options?: {
+        override?: boolean;
+        signal?: AbortSignal;
+        /** When true (default false — opt-in, not yet live-verified against a real
+         *  OnlyOffice session, see {@link encodeOnlyOfficeFormulaCellRecord}) and this call
+         *  creates a brand-new, non-`i18n` sheet, that sheet's header row is written as
+         *  formula cells linking to the `i18n` sheet's header row (`=i18n!A1`, ...) instead
+         *  of duplicated literal text — see issue #165. Never touches a sheet's header on
+         *  any push after its creation. */
+        linkHeadersToI18nSheet?: boolean;
+    }): Promise<number>;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

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

@@ -0,0 +1,46 @@
+export interface ParsedCryptPadUrl {
+    origin: string;
+    version: number;
+    app: string;
+    mode: 'edit' | 'view';
+    seed: string;
+    isPasswordProtected: boolean;
+    cleanUrl: string;
+}
+export interface DerivedCryptPadKeys {
+    channelHex: string;
+    cryptKey: Uint8Array;
+    signKey: Uint8Array;
+    validateKey: Uint8Array;
+}
+/** Decodes CryptPad base64 string (which may have '-' instead of '/' and no padding). */
+export declare function b64Decode(str: string): Uint8Array;
+/** Encodes bytes to standard base64 string. */
+export declare function b64Encode(bytes: Uint8Array): string;
+/** Decodes UTF-8 string to Uint8Array. */
+export declare function decodeUTF8(str: string): Uint8Array;
+/** Encodes Uint8Array to UTF-8 string. */
+export declare function encodeUTF8(bytes: Uint8Array): string;
+/**
+ * Parses a CryptPad URL and extracts the app type, mode, seed, and whether it requires a password.
+ * Format: https://{host}/{app}/#/{version}/{app}/{mode}/{seed}[/p/]
+ */
+export declare function parsePadUrl(url: string): ParsedCryptPadUrl;
+/**
+ * Derives the Netflux channel ID (hex string), symmetric encryption key (32 bytes),
+ * and Ed25519 signing keypair from a CryptPad pad seed and optional password
+ * according to CryptPad's createEditCryptor2 / createViewCryptor2 protocol.
+ */
+export declare function deriveCryptPadKeys(seedStr: string, password?: string): DerivedCryptPadKeys;
+/**
+ * Decrypts an encrypted CryptPad message payload formatted as `nonce|ciphertext`
+ * (or optionally prefixed with a 64-byte Ed25519 signature from historyKeeper).
+ */
+export declare function decryptCryptPadPayload(payload: string, cryptKey: Uint8Array): string | null;
+/**
+ * Encrypts a plaintext message payload using TweetNaCl secretbox (XSalsa20-Poly1305).
+ * If signKey is provided, signs the `nonce|ciphertext` string using TweetNaCl Ed25519
+ * matching OnlyOffice / CryptPad real-time channel requirements.
+ */
+export declare function encryptCryptPadPayload(plaintext: string, cryptKey: Uint8Array, signKey?: Uint8Array): string;
+//# sourceMappingURL=crypto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/crypto.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAKjD;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAElD;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAmC1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAkC1F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAwC3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,MAAM,CAYR"}

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

@@ -0,0 +1,23 @@
+import type { ProviderCatalogProvider } from '../catalog';
+import { type ProviderCapabilitySet } from '../capabilities';
+export interface CryptPadDriveCatalogOptions {
+    /** Full CryptPad Drive URL (e.g. https://cryptpad.fr/drive/#/2/drive/edit/seed/p/). */
+    driveUrl?: string;
+    /** Optional master password for the drive pad. */
+    password?: string;
+    /** Optional map of passwords keyed by pad URL or title. */
+    passwords?: Record<string, string>;
+    /** Optional custom provider identifier. Defaults to 'cryptpad-drive'. */
+    providerId?: string;
+    /** Optional custom provider display name. */
+    displayName?: string;
+    /** Optional timeout in milliseconds for WebSocket retrieval. */
+    timeoutMs?: number;
+}
+export declare const CRYPTPAD_DRIVE_CATALOG_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates a {@link ProviderCatalogProvider} that inspects an encrypted CryptPad Drive folder,
+ * discovering all spreadsheets, document pads, and file assets within the directory tree.
+ */
+export declare function createCryptPadDriveCatalogProvider(options?: CryptPadDriveCatalogOptions): ProviderCatalogProvider;
+//# sourceMappingURL=driveCatalogProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driveCatalogProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/driveCatalogProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAIxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,MAAM,WAAW,2BAA2B;IAC1C,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,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,mCAAmC,EAAE,qBAEhD,CAAC;AAEH;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,2BAAgC,GACxC,uBAAuB,CA+DzB"}

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

@@ -0,0 +1,42 @@
+import { type ParsedCryptPadUrl } from './crypto';
+export interface CryptPadDriveItem {
+    id: string;
+    title: string;
+    type: 'sheet' | 'file' | 'pad' | 'folder';
+    url: string;
+    password?: string;
+    channel?: string;
+    path: string;
+    ctime?: number;
+    mtime?: number;
+}
+export interface CryptPadDriveClientOptions {
+    /** Full CryptPad Drive URL (e.g. https://cryptpad.fr/drive/#/2/drive/edit/seed/p/). */
+    url: string;
+    /** Optional password if the drive pad is password-protected. */
+    password?: string;
+    /** Optional map of passwords keyed by pad URL or title. */
+    passwords?: Record<string, string>;
+    /** Optional timeout in milliseconds. */
+    timeoutMs?: number;
+}
+/**
+ * Headless client for inspecting and traversing encrypted CryptPad Drive folders.
+ */
+export declare class CryptPadDriveClient {
+    readonly parsedUrl: ParsedCryptPadUrl;
+    readonly password?: string;
+    readonly passwords: Record<string, string>;
+    readonly timeoutMs: number;
+    constructor(options: CryptPadDriveClientOptions);
+    /**
+     * Fetches the drive pad's Netflux history, decrypts all changes, and parses
+     * the hierarchical filesystem tree into a flat list of items.
+     */
+    listDriveItems(signal?: AbortSignal): Promise<CryptPadDriveItem[]>;
+    /**
+     * Filters and returns only spreadsheets found within the drive folder.
+     */
+    listSheets(signal?: AbortSignal): Promise<CryptPadDriveItem[]>;
+}
+//# sourceMappingURL=driveClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driveClient.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/driveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGnF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,OAAO,EAAE,0BAA0B,EAS9C;IAED;;;OAGG;IACG,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsHvE;IAED;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAGnE;CACF"}

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

@@ -0,0 +1,48 @@
+import type { TranslationOutputProvider, TranslationSyncProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+import { type SyncConflictPolicy } from '../syncEngine';
+import type { TranslationData } from '../../types';
+interface CryptPadWorkspaceSnapshot {
+    revision: number;
+    translations: TranslationData;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for configuring CryptPad workspace output and sync providers.
+ */
+export interface CryptPadWorkspaceProviderOptions {
+    /** Path to the local JSON snapshot file acting as the CryptPad workspace state. */
+    filePath: string;
+    /** Optimistic-concurrency guard: if set, writes fail unless the on-disk revision matches. */
+    expectedRevision?: number;
+    /** Conflict resolution strategy used by the sync provider; ignored by the output provider. */
+    conflictPolicy?: SyncConflictPolicy;
+    /** Custom provider identifier. */
+    providerId?: string;
+    /** Custom human-friendly provider name. */
+    displayName?: string;
+}
+interface CryptPadWorkspaceProviderDeps {
+    readSnapshot: (filePath: string) => Promise<CryptPadWorkspaceSnapshot>;
+    writeSnapshot: (filePath: string, snapshot: CryptPadWorkspaceSnapshot) => Promise<void>;
+}
+declare const CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES: ProviderCapabilitySet;
+declare const CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates a {@link TranslationOutputProvider} that writes translations into a local
+ * JSON snapshot file representing CryptPad workspace state. Each write reads the
+ * current snapshot, checks `expectedRevision` (if set) for optimistic-concurrency
+ * safety, deep-merges the new translations over the existing ones, and writes back
+ * with the revision incremented by one.
+ */
+export declare function createCryptPadWorkspaceOutputProvider(options: CryptPadWorkspaceProviderOptions, depsOverrides?: Partial<CryptPadWorkspaceProviderDeps>): TranslationOutputProvider;
+/**
+ * Creates a {@link TranslationSyncProvider} that reconciles local translation changes
+ * against the CryptPad workspace snapshot using {@link resolveSyncPlan} (three-way
+ * diff against `payload.metadata.baseTranslations`, falling back to the remote
+ * snapshot as base) and the configured `conflictPolicy`. Like the output provider,
+ * it checks `expectedRevision` before writing and increments the revision on write.
+ */
+export declare function createCryptPadWorkspaceSyncProvider(options: CryptPadWorkspaceProviderOptions, depsOverrides?: Partial<CryptPadWorkspaceProviderDeps>): TranslationSyncProvider;
+export { CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES };
+//# sourceMappingURL=fullProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fullProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/fullProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,yBAAyB,EAGzB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAmB,KAAK,kBAAkB,EAA2B,MAAM,eAAe,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,UAAU,yBAAyB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,6BAA6B;IACrC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACvE,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzF;AAED,QAAA,MAAM,sCAAsC,EAAE,qBAE5C,CAAC;AAEH,QAAA,MAAM,oCAAoC,EAAE,qBAG1C,CAAC;AAqEH;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,gCAAgC,EACzC,aAAa,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACzD,yBAAyB,CAgC3B;AAqBD;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,gCAAgC,EACzC,aAAa,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACzD,uBAAuB,CA4CzB;AAED,OAAO,EAAE,sCAAsC,EAAE,oCAAoC,EAAE,CAAC"}

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

@@ -0,0 +1,25 @@
+/** Barrel for the CryptPad provider family: Sheet input/output/sync (E2EE), CSV input, workspace output/sync, Drive catalog, and asset sync. */
+export { createCryptPadCsvInputProvider, CRYPTPAD_CSV_INPUT_CAPABILITIES } from './provider';
+export { createCryptPadSheetInputProvider, CRYPTPAD_SHEET_INPUT_CAPABILITIES, } from './sheetProvider';
+export { createCryptPadSheetOutputProvider, CRYPTPAD_SHEET_OUTPUT_CAPABILITIES, convertTranslationsToSheetRows, } from './sheetOutputProvider';
+export { createCryptPadSheetSyncProvider, CRYPTPAD_SHEET_SYNC_CAPABILITIES, } from './sheetSyncProvider';
+export { createCryptPadDriveCatalogProvider, CRYPTPAD_DRIVE_CATALOG_CAPABILITIES, } from './driveCatalogProvider';
+export { createCryptPadWorkspaceOutputProvider, createCryptPadWorkspaceSyncProvider, CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES, } from './fullProvider';
+export { createCryptPadAssetSyncProvider, CRYPTPAD_ASSET_SYNC_CAPABILITIES } from './assetProvider';
+export { CryptPadClient } from './client';
+export { CryptPadDriveClient } from './driveClient';
+export { parsePadUrl, deriveCryptPadKeys, decryptCryptPadPayload, encryptCryptPadPayload, } from './crypto';
+export { resolveCryptPadWebsocketUrl, fetchChannelHistory, broadcastChannelMessage, } from './netflux';
+export { extractOnlyOfficeChannelId, extractOnlyOfficeMetadata, extractOnlyOfficeSheetIdMap, parseOnlyOfficeChanges, convertCellsToSheetRows, convertCellsToMultiSheetRows, groupCellsBySheet, buildCellRef, buildOnlyOfficeChangePayload, encodeOnlyOfficeCellRecord, colIndexToLetter, letterToColIndex, parseCellRef, } from './sheetParser';
+export type { CryptPadCsvSource, CryptPadCsvInputProviderOptions } from './provider';
+export type { CryptPadSheetSource, CryptPadSheetInputProviderOptions } from './sheetProvider';
+export type { CryptPadSheetOutputProviderOptions } from './sheetOutputProvider';
+export type { CryptPadSheetSyncProviderOptions } from './sheetSyncProvider';
+export type { CryptPadDriveCatalogOptions } from './driveCatalogProvider';
+export type { CryptPadDriveItem, CryptPadDriveClientOptions } from './driveClient';
+export type { CryptPadClientOptions, CryptPadSheetResult } from './client';
+export type { ParsedCryptPadUrl, DerivedCryptPadKeys } from './crypto';
+export type { CryptPadSheetGrid, ReconstructedSheet, OnlyOfficeCellUpdate } from './sheetParser';
+export type { CryptPadWorkspaceProviderOptions } from './fullProvider';
+export type { CryptPadAssetSyncProviderOptions } from './assetProvider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/index.ts"],"names":[],"mappings":"AAAA,gJAAgJ;AAChJ,OAAO,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAE7F,OAAO,EACL,gCAAgC,EAChC,iCAAiC,GAClC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iCAAiC,EACjC,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qCAAqC,EACrC,mCAAmC,EACnC,sCAAsC,EACtC,oCAAoC,GACrC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AAEpG,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,4BAA4B,EAC5B,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,mBAAmB,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AAC9F,YAAY,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3E,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEjG,YAAY,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,27 @@
+export interface NetfluxBroadcastOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    signKey?: Uint8Array;
+}
+export interface NetfluxHistoryOptions {
+    timeoutMs?: number;
+    quietPeriodMs?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Discovers the real WebSocket URL for a CryptPad instance by querying its `/api/config` endpoint.
+ */
+export declare function resolveCryptPadWebsocketUrl(origin: string, signal?: AbortSignal): Promise<string>;
+/**
+ * Connects to the CryptPad Netflux WebSocket server, joins a channel,
+ * requests its complete history from the historyKeeper peer, decrypts all messages,
+ * and returns the decrypted message strings.
+ */
+export declare function fetchChannelHistory(wsUrl: string, channelHex: string, cryptKey: Uint8Array, options?: NetfluxHistoryOptions): Promise<string[]>;
+/**
+ * Connects to the CryptPad Netflux WebSocket server, joins a channel,
+ * encrypts the given message with TweetNaCl, and broadcasts it to all peers
+ * in the channel (including historyKeeper).
+ */
+export declare function broadcastChannelMessage(wsUrl: string, channelHex: string, cryptKey: Uint8Array, message: string, options?: NetfluxBroadcastOptions): Promise<void>;
+//# sourceMappingURL=netflux.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"netflux.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/netflux.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,UAAU,EACpB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CA8JnB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAqGf"}

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

@@ -0,0 +1,37 @@
+import type { TranslationInputProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+/** One CSV source to read as a table. Provide exactly one of `url` or `filePath`. */
+export interface CryptPadCsvSource {
+    tableName: string;
+    url?: string;
+    filePath?: string;
+    tableId?: string;
+}
+/**
+ * Options for configuring a CryptPad CSV input provider.
+ */
+export interface CryptPadCsvInputProviderOptions {
+    /** Array of CSV source definitions mapping tables to URLs or local files. */
+    sources: CryptPadCsvSource[];
+    /** Optional CSV column delimiter (defaults to comma ','). */
+    delimiter?: string;
+    /** Optional custom provider identifier. Defaults to 'cryptpad-csv'. */
+    providerId?: string;
+    /** Optional custom provider display name. */
+    displayName?: string;
+}
+interface CryptPadCsvProviderDeps {
+    fetchCsv: (url: string, signal?: AbortSignal) => Promise<string>;
+    readCsvFile: (filePath: string) => Promise<string>;
+}
+declare const CRYPTPAD_CSV_INPUT_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates a read-only {@link TranslationInputProvider} that reads one or more CSV
+ * sources (local files or public export URLs) as canonical tables. This is a CSV-only
+ * MVP: it has no output/sync capability, so it is always paired with another provider
+ * (e.g. `cryptpad-workspace`) for write-back. Public URLs require no authentication,
+ * reflected in `publicReadNoAuth: true`.
+ */
+export declare function createCryptPadCsvInputProvider(options: CryptPadCsvInputProviderOptions, depsOverrides?: Partial<CryptPadCsvProviderDeps>): TranslationInputProvider;
+export { CRYPTPAD_CSV_INPUT_CAPABILITIES };
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EAGzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAElF,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6EAA6E;IAC7E,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,QAAA,MAAM,+BAA+B,EAAE,qBAGrC,CAAC;AAwCH;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,EACxC,aAAa,GAAE,OAAO,CAAC,uBAAuB,CAAM,GACnD,wBAAwB,CAoD1B;AAED,OAAO,EAAE,+BAA+B,EAAE,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { TranslationOutputProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+import type { SheetRow, TranslationData } from '../../types';
+export interface CryptPadSheetOutputProviderOptions {
+    /** 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;
+    /** When true, overwrites existing non-empty cells. 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 key column name in row 1 (e.g. 'var' or 'key'). Defaults to 'key', matching
+     *  the header a brand-new Google Sheets sheet is created with (see spreadsheetUpdater.ts)
+     *  and the documented spreadsheet convention (website/guide/spreadsheet-setup.md). Only
+     *  used when creating a sheet from scratch — writes to an existing sheet always respect
+     *  whichever of 'var'/'key' that sheet's own header already uses. */
+    keyColumnName?: 'var' | 'key' | string;
+    /** When true (default false — opt-in, not yet live-verified against a real OnlyOffice
+     *  session, see `encodeOnlyOfficeFormulaCellRecord`), a brand-new sheet's header row is
+     *  written as formula cells linking to the reserved `i18n` sheet's header row
+     *  (`=i18n!A1`, ...) instead of duplicated literal text, so header text stays visually
+     *  in sync across sheets — see issue #165. Auto-creates the `i18n` sheet's own header
+     *  row if it doesn't exist yet. Never rewrites an existing sheet's header on a later
+     *  push. */
+    linkHeadersToI18nSheet?: boolean;
+    /** Optional timeout in milliseconds for WebSocket operations. */
+    timeoutMs?: number;
+}
+export declare const CRYPTPAD_SHEET_OUTPUT_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Converts nested TranslationData `[locale][sheet][key] = value` into
+ * tabular rows `Record<sheetName, SheetRow[]>`.
+ */
+export declare function convertTranslationsToSheetRows(translations: TranslationData, localeMapping?: Record<string, string>, keyColumnName?: string): Record<string, SheetRow[]>;
+/**
+ * Creates a {@link TranslationOutputProvider} that writes translation data directly
+ * into password-protected or public CryptPad spreadsheets (multi-tab OnlyOffice workbooks)
+ * using end-to-end encrypted Netflux WebSockets.
+ */
+export declare function createCryptPadSheetOutputProvider(options?: CryptPadSheetOutputProviderOptions): TranslationOutputProvider;
+//# sourceMappingURL=sheetOutputProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sheetOutputProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/sheetOutputProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EAE1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAElF,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,WAAW,kCAAkC;IACjD,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,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;;;;yEAIqE;IACrE,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACvC;;;;;;gBAMY;IACZ,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,kCAAkC,EAAE,qBAE/C,CAAC;AAEH;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,eAAe,EAC7B,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC1C,aAAa,GAAE,MAAc,GAC5B,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAsC5B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,GAAE,kCAAuC,GAC/C,yBAAyB,CAsD3B"}