@el-j/google-sheet-translations 3.0.0-beta.5 → 3.0.0-beta.6

package/dist/esm/index.js

@@ -3745,6 +3745,29 @@ var CryptPadClient = class {
 		return resolveCryptPadWebsocketUrl(this.parsedUrl.origin, signal);
 	}
 	/**
+	* Initializes the OnlyOffice RT channel for a brand-new CryptPad sheet that has never
+	* been opened in a browser. Generates a random 32-hex channel ID, broadcasts it as an
+	* encrypted metadata patch on the Netflux channel (the same thing the OnlyOffice browser
+	* client does on first open), and returns the new RT channel ID.
+	*
+	* This removes the requirement to open the sheet in a browser before the CLI can write to it.
+	*/
+	async initializeRtChannel(signal) {
+		const wsUrl = await this.getWebsocketUrl(signal);
+		const { channelHex, cryptKey } = this.getKeys();
+		const newRtChannel = crypto.randomBytes(16).toString("hex");
+		const innerJson = JSON.stringify({ content: { channel: newRtChannel } });
+		await broadcastChannelMessage(wsUrl, channelHex, cryptKey, JSON.stringify([1, [[
+			0,
+			0,
+			innerJson
+		]]]), {
+			timeoutMs: this.timeoutMs,
+			signal
+		});
+		return newRtChannel;
+	}
+	/**
 	* Fetches the complete sheet data, including raw cell coordinate mappings,
 	* multi-sheet tabs, and structured rows formatted for translation ingestion.
 	*/
@@ -3795,14 +3818,22 @@ var CryptPadClient = class {
 	}
 	/**
 	* 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.
 	*/
 	async sendCellUpdates(updates, signal) {
 		if (updates.length === 0) return;
-		const rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
-		if (!rtChannel) throw new Error(`CryptPad sheet "${this.parsedUrl.cleanUrl}" does not have an active OnlyOffice RT channel.`);
+		let rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
+		if (!rtChannel) {
+			console.log("No OnlyOffice RT channel found. Initializing headlessly (no browser required)...");
+			rtChannel = await this.initializeRtChannel(signal);
+			console.log(`RT channel initialized: ${rtChannel}`);
+			await new Promise((r) => setTimeout(r, 800));
+		}
 		const wsUrl = await this.getWebsocketUrl(signal);
 		const { cryptKey } = this.getKeys();
-		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, buildOnlyOfficeChangePayload(updates), {
+		const payload = buildOnlyOfficeChangePayload(updates);
+		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, payload, {
 			timeoutMs: this.timeoutMs,
 			signal
 		});

package/dist/index.js

@@ -3778,6 +3778,29 @@ var CryptPadClient = class {
 		return resolveCryptPadWebsocketUrl(this.parsedUrl.origin, signal);
 	}
 	/**
+	* Initializes the OnlyOffice RT channel for a brand-new CryptPad sheet that has never
+	* been opened in a browser. Generates a random 32-hex channel ID, broadcasts it as an
+	* encrypted metadata patch on the Netflux channel (the same thing the OnlyOffice browser
+	* client does on first open), and returns the new RT channel ID.
+	*
+	* This removes the requirement to open the sheet in a browser before the CLI can write to it.
+	*/
+	async initializeRtChannel(signal) {
+		const wsUrl = await this.getWebsocketUrl(signal);
+		const { channelHex, cryptKey } = this.getKeys();
+		const newRtChannel = node_crypto.default.randomBytes(16).toString("hex");
+		const innerJson = JSON.stringify({ content: { channel: newRtChannel } });
+		await broadcastChannelMessage(wsUrl, channelHex, cryptKey, JSON.stringify([1, [[
+			0,
+			0,
+			innerJson
+		]]]), {
+			timeoutMs: this.timeoutMs,
+			signal
+		});
+		return newRtChannel;
+	}
+	/**
 	* Fetches the complete sheet data, including raw cell coordinate mappings,
 	* multi-sheet tabs, and structured rows formatted for translation ingestion.
 	*/
@@ -3828,14 +3851,22 @@ var CryptPadClient = class {
 	}
 	/**
 	* 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.
 	*/
 	async sendCellUpdates(updates, signal) {
 		if (updates.length === 0) return;
-		const rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
-		if (!rtChannel) throw new Error(`CryptPad sheet "${this.parsedUrl.cleanUrl}" does not have an active OnlyOffice RT channel.`);
+		let rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
+		if (!rtChannel) {
+			console.log("No OnlyOffice RT channel found. Initializing headlessly (no browser required)...");
+			rtChannel = await this.initializeRtChannel(signal);
+			console.log(`RT channel initialized: ${rtChannel}`);
+			await new Promise((r) => setTimeout(r, 800));
+		}
 		const wsUrl = await this.getWebsocketUrl(signal);
 		const { cryptKey } = this.getKeys();
-		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, buildOnlyOfficeChangePayload(updates), {
+		const payload = buildOnlyOfficeChangePayload(updates);
+		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, payload, {
 			timeoutMs: this.timeoutMs,
 			signal
 		});

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

@@ -42,6 +42,15 @@ export declare class CryptPadClient {
     getKeys(): DerivedCryptPadKeys;
     /** Resolves the Netflux WebSocket endpoint to connect to. */
     getWebsocketUrl(signal?: AbortSignal): Promise<string>;
+    /**
+     * Initializes the OnlyOffice RT channel for a brand-new CryptPad sheet that has never
+     * been opened in a browser. Generates a random 32-hex channel ID, broadcasts it as an
+     * encrypted metadata patch on the Netflux channel (the same thing the OnlyOffice browser
+     * client does on first open), and returns the new RT channel ID.
+     *
+     * This removes the requirement to open the sheet in a browser before the CLI can write to it.
+     */
+    initializeRtChannel(signal?: AbortSignal): Promise<string>;
     /**
      * Fetches the complete sheet data, including raw cell coordinate mappings,
      * multi-sheet tabs, and structured rows formatted for translation ingestion.
@@ -54,6 +63,8 @@ export declare class CryptPadClient {
     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.
      */
     sendCellUpdates(updates: OnlyOfficeCellUpdate[], signal?: AbortSignal): Promise<void>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,UAAU,CAAC;AAMlB,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2GAA2G;IAC3G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;QACE,KAAK,EAAE,iBAAiB,CAAC;QACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;KAClB,CACF,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAsB;IAE1C,YAAY,OAAO,EAAE,qBAAqB,EAezC;IAED,wEAAwE;IACxE,OAAO,IAAI,mBAAmB,CAK7B;IAED,6DAA6D;IACvD,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3D;IAED;;;OAGG;IACG,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoDvE;IAED;;;OAGG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMlF;IAED;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB1F;IAED;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EAAE,EAChB,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACzD,OAAO,CAAC,MAAM,CAAC,CA+EjB;CACF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/client.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,UAAU,CAAC;AAMlB,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2GAA2G;IAC3G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;QACE,KAAK,EAAE,iBAAiB,CAAC;QACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;KAClB,CACF,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAsB;IAE1C,YAAY,OAAO,EAAE,qBAAqB,EAezC;IAED,wEAAwE;IACxE,OAAO,IAAI,mBAAmB,CAK7B;IAED,6DAA6D;IACvD,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3D;IAED;;;;;;;OAOG;IACG,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB/D;IAED;;;OAGG;IACG,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoDvE;IAED;;;OAGG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMlF;IAED;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B1F;IAED;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EAAE,EAChB,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACzD,OAAO,CAAC,MAAM,CAAC,CA+EjB;CACF"}

package/dist-cli/cryptpad.mjs

@@ -649,6 +649,29 @@ var CryptPadClient = class {
 		return resolveCryptPadWebsocketUrl(this.parsedUrl.origin, signal);
 	}
 	/**
+	* Initializes the OnlyOffice RT channel for a brand-new CryptPad sheet that has never
+	* been opened in a browser. Generates a random 32-hex channel ID, broadcasts it as an
+	* encrypted metadata patch on the Netflux channel (the same thing the OnlyOffice browser
+	* client does on first open), and returns the new RT channel ID.
+	*
+	* This removes the requirement to open the sheet in a browser before the CLI can write to it.
+	*/
+	async initializeRtChannel(signal) {
+		const wsUrl = await this.getWebsocketUrl(signal);
+		const { channelHex, cryptKey } = this.getKeys();
+		const newRtChannel = crypto.randomBytes(16).toString("hex");
+		const innerJson = JSON.stringify({ content: { channel: newRtChannel } });
+		await broadcastChannelMessage(wsUrl, channelHex, cryptKey, JSON.stringify([1, [[
+			0,
+			0,
+			innerJson
+		]]]), {
+			timeoutMs: this.timeoutMs,
+			signal
+		});
+		return newRtChannel;
+	}
+	/**
 	* Fetches the complete sheet data, including raw cell coordinate mappings,
 	* multi-sheet tabs, and structured rows formatted for translation ingestion.
 	*/
@@ -699,14 +722,22 @@ var CryptPadClient = class {
 	}
 	/**
 	* 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.
 	*/
 	async sendCellUpdates(updates, signal) {
 		if (updates.length === 0) return;
-		const rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
-		if (!rtChannel) throw new Error(`CryptPad sheet "${this.parsedUrl.cleanUrl}" does not have an active OnlyOffice RT channel.`);
+		let rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
+		if (!rtChannel) {
+			console.log("No OnlyOffice RT channel found. Initializing headlessly (no browser required)...");
+			rtChannel = await this.initializeRtChannel(signal);
+			console.log(`RT channel initialized: ${rtChannel}`);
+			await new Promise((r) => setTimeout(r, 800));
+		}
 		const wsUrl = await this.getWebsocketUrl(signal);
 		const { cryptKey } = this.getKeys();
-		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, buildOnlyOfficeChangePayload(updates), {
+		const payload = buildOnlyOfficeChangePayload(updates);
+		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, payload, {
 			timeoutMs: this.timeoutMs,
 			signal
 		});
@@ -1660,7 +1691,7 @@ async function main() {
 			console.log(`  App:          ${data.metadata.app}`);
 			console.log(`  Mode:         ${data.metadata.mode}`);
 			console.log(`  Channel ID:   ${data.metadata.channelId}`);
-			console.log(`  RT Channel:   ${data.metadata.rtChannelId ?? "None"}`);
+			console.log(`  RT Channel:   ${data.metadata.rtChannelId ?? "None (will auto-initialize on first push)"}`);
 			console.log(`  Total Cells:  ${Object.keys(data.cells).length}`);
 			console.log(`  Sheet Tabs (${data.sheetNames.length}):`);
 			for (const name of data.sheetNames) {

package/dist-cli/run-provider.mjs

@@ -1481,6 +1481,29 @@ var CryptPadClient = class {
 		return resolveCryptPadWebsocketUrl(this.parsedUrl.origin, signal);
 	}
 	/**
+	* Initializes the OnlyOffice RT channel for a brand-new CryptPad sheet that has never
+	* been opened in a browser. Generates a random 32-hex channel ID, broadcasts it as an
+	* encrypted metadata patch on the Netflux channel (the same thing the OnlyOffice browser
+	* client does on first open), and returns the new RT channel ID.
+	*
+	* This removes the requirement to open the sheet in a browser before the CLI can write to it.
+	*/
+	async initializeRtChannel(signal) {
+		const wsUrl = await this.getWebsocketUrl(signal);
+		const { channelHex, cryptKey } = this.getKeys();
+		const newRtChannel = crypto.randomBytes(16).toString("hex");
+		const innerJson = JSON.stringify({ content: { channel: newRtChannel } });
+		await broadcastChannelMessage(wsUrl, channelHex, cryptKey, JSON.stringify([1, [[
+			0,
+			0,
+			innerJson
+		]]]), {
+			timeoutMs: this.timeoutMs,
+			signal
+		});
+		return newRtChannel;
+	}
+	/**
 	* Fetches the complete sheet data, including raw cell coordinate mappings,
 	* multi-sheet tabs, and structured rows formatted for translation ingestion.
 	*/
@@ -1531,14 +1554,22 @@ var CryptPadClient = class {
 	}
 	/**
 	* 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.
 	*/
 	async sendCellUpdates(updates, signal) {
 		if (updates.length === 0) return;
-		const rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
-		if (!rtChannel) throw new Error(`CryptPad sheet "${this.parsedUrl.cleanUrl}" does not have an active OnlyOffice RT channel.`);
+		let rtChannel = (await this.fetchSheetData(signal)).metadata.rtChannelId;
+		if (!rtChannel) {
+			console.log("No OnlyOffice RT channel found. Initializing headlessly (no browser required)...");
+			rtChannel = await this.initializeRtChannel(signal);
+			console.log(`RT channel initialized: ${rtChannel}`);
+			await new Promise((r) => setTimeout(r, 800));
+		}
 		const wsUrl = await this.getWebsocketUrl(signal);
 		const { cryptKey } = this.getKeys();
-		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, buildOnlyOfficeChangePayload(updates), {
+		const payload = buildOnlyOfficeChangePayload(updates);
+		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, payload, {
 			timeoutMs: this.timeoutMs,
 			signal
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@el-j/google-sheet-translations",
-  "version": "3.0.0-beta.5",
+  "version": "3.0.0-beta.6",
   "description": "A package to manage translations stored in Google Spreadsheets",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",