@fileverse-dev/ddoc 4.8.15 → 4.8.17-xchacha.0

package/dist/package/sync-local/SyncManager.d.ts

@@ -1,5 +1,5 @@
 import { Awareness } from 'y-protocols/awareness.js';
-import { SyncManagerConfig, CollabConnectionConfig, CollabServices, CollabCallbacks, CollabStatus, CollabState } from './types';
+import { SyncManagerConfig, CollabConnectionConfig, CollabServices, CollabCallbacks, CollabStatus, CollabState, WireFormat } from './types';
 
 export declare class SyncManager {
     private onCollabStateChange;
@@ -26,10 +26,17 @@ export declare class SyncManager {
     private isProcessing;
     private syncId;
     private floor;
+    private hydrationIncomplete;
+    private wireFormat;
+    private lastReportedWriteFormat;
+    getWireFormat(): WireFormat;
+    private encryptForWire;
+    private emitWireTelemetry;
+    private setWireFormat;
     private updatesSinceSnapshot;
     private isAuthoringSnapshot;
     private readonly SNAPSHOT_THRESHOLD;
-    private tailCompactTimer;
+    private deferredSnapshotTimer;
     private gapCatchUpTimer;
     private gapCatchUpInFlight;
     private gapCatchUpCooldownUntil;
@@ -100,6 +107,7 @@ export declare class SyncManager {
     private authorSnapshot;
     private hydrate;
     private maybeCompactTail;
+    private scheduleDeferredSnapshot;
     private initializeAwareness;
     private cleanupAwareness;
     private broadcastLocalContents;

package/dist/package/sync-local/crypto/index.d.ts

@@ -1,6 +1,10 @@
+import { WireFormat } from '../types';
+
+export declare const WIRE_TAG = "FVXC1";
+export declare const isXChaChaCipher: (message: unknown) => message is string;
 export declare const crypto: {
     generateKeyPair: () => import('@fileverse/crypto/ecies').EciesKeyPairBytes;
-    encryptData: (key: Uint8Array, message: Uint8Array) => string;
-    decryptData: (key: Uint8Array, message: string) => Uint8Array<ArrayBufferLike>;
+    encryptData: (key: Uint8Array, message: Uint8Array, format?: WireFormat) => string;
+    decryptData: (key: Uint8Array, message: string) => Uint8Array;
     generateRandomBytes: <E extends import('@fileverse/crypto/types').EncodingType = "bytes">(length?: number, encoding?: E) => import('@fileverse/crypto/types').EncodedReturnType<E>;
 };

package/dist/package/sync-local/crypto/room-key.d.ts

@@ -1,2 +1,4 @@
-export declare const encryptForRoomKey: (roomKey: string, bytes: Uint8Array) => string;
+import { WireFormat } from '../types';
+
+export declare const encryptForRoomKey: (roomKey: string, bytes: Uint8Array, format?: WireFormat) => string;
 export declare const decryptForRoomKey: (roomKey: string, ciphertext: string) => Uint8Array;

package/dist/package/sync-local/floor.d.ts

@@ -6,3 +6,11 @@ export declare function shouldAuthorSnapshot(p: {
     threshold: number;
 }): boolean;
 export declare function computeLocalOnlyUpdate(ydoc: Y.Doc, serverMerged: Uint8Array | null): Uint8Array | null;
+export declare function floorEligibleSeqs(rows: Array<{
+    seq: number | null;
+    isTail: boolean;
+    decrypted: boolean;
+}>, alreadyIncomplete: boolean): {
+    seqs: number[];
+    incomplete: boolean;
+};

package/dist/package/sync-local/socketClient.d.ts

@@ -1,4 +1,4 @@
-import { ISocketInitConfig, SocketStatusEnum, SendUpdateResponse, HydrationResponse, SnapshotResponse, AckResponse } from './types';
+import { ISocketInitConfig, SocketStatusEnum, SendUpdateResponse, HydrationResponse, SnapshotResponse, AckResponse, WireFormat } from './types';
 import { Awareness } from 'y-protocols/awareness.js';
 
 interface ISocketClientConfig {
@@ -42,6 +42,7 @@ interface ISocketClientConfig {
     onHandshakeData?: (response: {
         data: AckResponse;
         roomKey: string;
+        wireFormat: WireFormat;
     }) => void;
     roomInfo?: {
         documentTitle: string;
@@ -80,6 +81,8 @@ export declare class SocketClient {
     private actorHandle?;
     private joinOnly?;
     private roomKey;
+    private wireFormat;
+    getWireFormat(): WireFormat;
     private roomInfo?;
     private awareness;
     private connectionAttemptErrorCount;

package/dist/package/sync-local/types/index.d.ts

@@ -1,6 +1,25 @@
 import { Data, IDocCollabUsers } from '../../types';
 
 import * as Y from 'yjs';
+/** Collab wire cipher. `ecies` is the historical secp256k1 ECIES; `xchacha` is
+ *  XChaCha20-Poly1305 under an HKDF subkey of the roomKey (FVXC1). */
+export type WireFormat = 'ecies' | 'xchacha';
+/** Host telemetry for the wire migration; the package never imports a reporter. */
+export type WireTelemetryEvent = {
+    type: 'announced';
+    format: WireFormat;
+} | {
+    type: 'write';
+    format: WireFormat;
+} | {
+    type: 'hydrate';
+    eciesRows: number;
+    xchachaRows: number;
+    snapshotFormat: WireFormat | null;
+    incomplete: boolean;
+} | {
+    type: 'refused';
+};
 /** Connection identity — changes to these trigger reconnect */
 export interface CollabConnectionConfig {
     roomKey: string;
@@ -150,7 +169,11 @@ export interface CollabCallbacks {
     onHandshakeData?: (data: {
         data: AckResponse;
         roomKey: string;
+        wireFormat: WireFormat;
     }) => void;
+    /** The write format the server announced for this room (auth ack or live ratchet). */
+    onWireFormat?: (format: WireFormat) => void;
+    onWireTelemetry?: (event: WireTelemetryEvent) => void;
     /** Live rename from the room owner; title is roomKey-encrypted. */
     onTitleUpdate?: (encryptedTitle: string | null) => void;
     /** Decrypt-miss self-heal: resolves the CURRENT-epoch roomKey (same resolution the host
@@ -195,7 +218,8 @@ export declare enum ServerErrorCode {
     INTERNAL_ERROR = "INTERNAL_ERROR",
     JOIN_DISABLED = "JOIN_DISABLED",
     EDIT_REVOKED = "EDIT_REVOKED",
-    ROOM_NOT_ESTABLISHED = "ROOM_NOT_ESTABLISHED"
+    ROOM_NOT_ESTABLISHED = "ROOM_NOT_ESTABLISHED",
+    WIRE_FORMAT_UNSUPPORTED = "WIRE_FORMAT_UNSUPPORTED"
 }
 export interface AckResponse<T = Record<string, any>> {
     status: boolean;
@@ -260,6 +284,10 @@ export interface ISocketInitConfig {
     }) => void;
     onPresenceChange?: (collaborators: IDocCollabUsers[]) => void;
     onTitleUpdate?: (encryptedTitle: string | null) => void;
+    onWireFormat?: (data: {
+        roomId: string;
+        wireFormat: WireFormat;
+    }) => void;
     onSessionTerminated: (data: {
         roomId: string;
     }) => void;
@@ -289,4 +317,5 @@ export interface IAuthArgs {
     editUcan?: string;
     actorHandle?: string;
     joinOnly?: boolean;
+    wireFormats?: WireFormat[];
 }

package/dist/package/sync-local/utils/createAwarenessUpdateHandler.d.ts

@@ -1,7 +1,8 @@
 import { Awareness } from 'y-protocols/awareness';
 import { SocketClient } from '../socketClient';
+import { WireFormat } from '../types';
 
-export declare const createAwarenessUpdateHandler: (awareness: Awareness, socketClient: SocketClient, roomKey: string) => ({ added, updated, removed, }: {
+export declare const createAwarenessUpdateHandler: (awareness: Awareness, socketClient: SocketClient, roomKey: string, getWireFormat: () => WireFormat) => ({ added, updated, removed, }: {
     added: number[];
     updated: number[];
     removed: number[];

package/package.json

@@ -2,7 +2,7 @@
   "name": "@fileverse-dev/ddoc",
   "private": false,
   "description": "DDoc",
-  "version": "4.8.15",
+  "version": "4.8.17-xchacha.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fileverse/fileverse-ddocs.git"