document-drive 4.0.4 → 4.1.0-dev.10

package/dist/src/server/sync-unit-map.d.ts

@@ -0,0 +1,137 @@
+import { type SynchronizationUnitId } from "./types.js";
+/**
+ * Interface for a specialized Map implementation that manages synchronization units.
+ * Each unit is identified by a SynchronizationUnitId which consists of documentId, scope, and branch.
+ */
+export interface ISyncUnitMap<Value> {
+    set(id: SynchronizationUnitId, state: Value): this;
+    get(id: SynchronizationUnitId): Value | undefined;
+    has(id: SynchronizationUnitId): boolean;
+    delete(id: SynchronizationUnitId): boolean;
+    clear(): void;
+    get size(): number;
+    keys(): IterableIterator<SynchronizationUnitId>;
+    values(): IterableIterator<Value>;
+    entries(): IterableIterator<[SynchronizationUnitId, Value]>;
+    [Symbol.iterator](): IterableIterator<[SynchronizationUnitId, Value]>;
+    forEach(callbackfn: (value: Value, key: SynchronizationUnitId, map: ISyncUnitMap<Value>) => void, thisArg?: any): void;
+    deleteByDocumentId(documentId: string): void;
+    deleteByDocumentIdAndScope(documentId: string, scope: string): void;
+    getAllByDocumentId(documentId: string): [SynchronizationUnitId, Value][];
+    getAllByDocumentIdAndScope(documentId: string, scope: string): [SynchronizationUnitId, Value][];
+}
+/** Separator character used to join synchronization unit key parts */
+type SyncUnitKeySeparator = "|";
+/**
+ * Internal key format used to store synchronization units.
+ * Composed of documentId, scope, and branch joined by the separator.
+ */
+type SyncUnitKey = `${SynchronizationUnitId["documentId"]}${SyncUnitKeySeparator}${SynchronizationUnitId["scope"]}${SyncUnitKeySeparator}${SynchronizationUnitId["branch"]}`;
+/**
+ * A specialized Map implementation for managing synchronization units that uses a "documentId - scope - branch" tuple as key.
+ * It provides methods to store, retrieve, and delete synchronization units of a certain documentId, optionally a scope and a branch.
+ * The implementation uses an internal Map with string keys created by combining documentId, scope, and branch with a separator character.
+ */
+export declare class SyncUnitMap<Value> implements ISyncUnitMap<Value> {
+    /** Internal storage using concatenated string keys */
+    private internalMap;
+    /** Character used to separate key components */
+    static keySeparator: SyncUnitKeySeparator;
+    /**
+     * Escapes the separator character in a string by prefixing it with a backslash
+     * @param str String to escape
+     */
+    private static escape;
+    /**
+     * Unescapes the separator character in a string by removing the prefix backslash
+     * @param str String to unescape
+     */
+    private static unescape;
+    /**
+     * Creates a composite key from a SynchronizationUnitId
+     * Escapes any separator characters in the components
+     * @param id The synchronization unit identifier
+     * @returns A string key combining documentId, scope, and branch
+     */
+    static buildKey(id: SynchronizationUnitId): SyncUnitKey;
+    /**
+     * Parses a composite key back into a SynchronizationUnitId
+     * Unescapes any separator characters in the components
+     * @param key The composite key string
+     * @returns The parsed synchronization unit identifier
+     */
+    static parseKey(key: SyncUnitKey): SynchronizationUnitId;
+    /**
+     * Stores a value with the given synchronization unit identifier
+     * @throws Error if any part of the id contains the separator character
+     */
+    set(id: SynchronizationUnitId, state: Value): this;
+    /** Retrieves a value by its synchronization unit identifier */
+    get(id: SynchronizationUnitId): Value | undefined;
+    /** Checks if a value exists for the given synchronization unit identifier */
+    has(id: SynchronizationUnitId): boolean;
+    /** Removes a value by its synchronization unit identifier */
+    delete(id: SynchronizationUnitId): boolean;
+    /** Removes all entries from the map */
+    clear(): void;
+    /** Returns the number of entries in the map */
+    get size(): number;
+    /**
+     * Returns an iterator of synchronization unit identifiers
+     * @param filter Optional filter by documentId and scope
+     */
+    keys(filter?: {
+        documentId: string;
+        scope?: string;
+    } | undefined): IterableIterator<SynchronizationUnitId>;
+    /**
+     * Returns an iterator of stored values
+     * @param filter Optional filter by documentId and scope
+     */
+    values(filter?: {
+        documentId: string;
+        scope?: string;
+    } | undefined): IterableIterator<Value>;
+    /**
+     * Returns an iterator of [id, value] pairs
+     * @param filter Optional filter by documentId and scope
+     */
+    entries(filter?: {
+        documentId: string;
+        scope?: string;
+    } | undefined): IterableIterator<[SynchronizationUnitId, Value]>;
+    /** Makes the map iterable */
+    [Symbol.iterator](): IterableIterator<[SynchronizationUnitId, Value]>;
+    /**
+     * Executes a callback for each entry in the map
+     * @param callbackfn Function to execute for each entry
+     * @param thisArg Value to use as 'this' in the callback
+     */
+    forEach(callbackfn: (value: Value, key: SynchronizationUnitId, map: ISyncUnitMap<Value>) => void, thisArg?: any): void;
+    /**
+     * Removes all entries associated with a specific document
+     * @param documentId The document identifier
+     */
+    deleteByDocumentId(documentId: string): void;
+    /**
+     * Removes all entries for a specific document and scope combination
+     * @param documentId The document identifier
+     * @param scope The scope identifier
+     */
+    deleteByDocumentIdAndScope(documentId: string, scope: string): void;
+    /**
+     * Retrieves all entries associated with a specific document
+     * @param documentId The document identifier
+     * @returns Array of [id, value] pairs
+     */
+    getAllByDocumentId(documentId: string): [SynchronizationUnitId, Value][];
+    /**
+     * Retrieves all entries for a specific document and scope combination
+     * @param documentId The document identifier
+     * @param scope The scope identifier
+     * @returns Array of [id, value] pairs
+     */
+    getAllByDocumentIdAndScope(documentId: string, scope: string): [SynchronizationUnitId, Value][];
+}
+export {};
+//# sourceMappingURL=sync-unit-map.d.ts.map

package/dist/src/server/sync-unit-map.d.ts.map

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

package/dist/src/server/sync-unit-map.js

@@ -0,0 +1,234 @@
+/**
+ * A specialized Map implementation for managing synchronization units that uses a "documentId - scope - branch" tuple as key.
+ * It provides methods to store, retrieve, and delete synchronization units of a certain documentId, optionally a scope and a branch.
+ * The implementation uses an internal Map with string keys created by combining documentId, scope, and branch with a separator character.
+ */
+export class SyncUnitMap {
+    /** Internal storage using concatenated string keys */
+    internalMap = new Map();
+    /** Character used to separate key components */
+    static keySeparator = "|";
+    /**
+     * Escapes the separator character in a string by prefixing it with a backslash
+     * @param str String to escape
+     */
+    static escape(str) {
+        return str.replace(/\|/g, "\\|");
+    }
+    /**
+     * Unescapes the separator character in a string by removing the prefix backslash
+     * @param str String to unescape
+     */
+    static unescape(str) {
+        return str.replace(/\\\|/g, "|");
+    }
+    /**
+     * Creates a composite key from a SynchronizationUnitId
+     * Escapes any separator characters in the components
+     * @param id The synchronization unit identifier
+     * @returns A string key combining documentId, scope, and branch
+     */
+    static buildKey(id) {
+        return `${SyncUnitMap.escape(id.documentId)}${SyncUnitMap.keySeparator}${SyncUnitMap.escape(id.scope)}${SyncUnitMap.keySeparator}${SyncUnitMap.escape(id.branch)}`;
+    }
+    /**
+     * Parses a composite key back into a SynchronizationUnitId
+     * Unescapes any separator characters in the components
+     * @param key The composite key string
+     * @returns The parsed synchronization unit identifier
+     */
+    static parseKey(key) {
+        const parts = key
+            .split(/(?<!\\)\|/)
+            .map((part) => SyncUnitMap.unescape(part));
+        const [documentId, scope, branch] = parts;
+        return { documentId, scope, branch };
+    }
+    // Map API implementation
+    /**
+     * Stores a value with the given synchronization unit identifier
+     * @throws Error if any part of the id contains the separator character
+     */
+    set(id, state) {
+        this.internalMap.set(SyncUnitMap.buildKey(id), state);
+        return this;
+    }
+    /** Retrieves a value by its synchronization unit identifier */
+    get(id) {
+        return this.internalMap.get(SyncUnitMap.buildKey(id));
+    }
+    /** Checks if a value exists for the given synchronization unit identifier */
+    has(id) {
+        return this.internalMap.has(SyncUnitMap.buildKey(id));
+    }
+    /** Removes a value by its synchronization unit identifier */
+    delete(id) {
+        return this.internalMap.delete(SyncUnitMap.buildKey(id));
+    }
+    /** Removes all entries from the map */
+    clear() {
+        this.internalMap.clear();
+    }
+    /** Returns the number of entries in the map */
+    get size() {
+        return this.internalMap.size;
+    }
+    /**
+     * Returns an iterator of synchronization unit identifiers
+     * @param filter Optional filter by documentId and scope
+     */
+    keys(filter) {
+        const iter = this.internalMap.keys();
+        return {
+            [Symbol.iterator]() {
+                return this;
+            },
+            next() {
+                while (true) {
+                    const result = iter.next();
+                    if (result.done)
+                        return { done: true, value: undefined };
+                    const key = result.value;
+                    const id = SyncUnitMap.parseKey(key);
+                    if (filter) {
+                        if (id.documentId !== filter.documentId)
+                            continue;
+                        if (filter.scope !== undefined && id.scope !== filter.scope)
+                            continue;
+                    }
+                    return { done: false, value: id };
+                }
+            },
+        };
+    }
+    /**
+     * Returns an iterator of stored values
+     * @param filter Optional filter by documentId and scope
+     */
+    values(filter) {
+        const iter = this.internalMap.entries();
+        return {
+            [Symbol.iterator]() {
+                return this;
+            },
+            next() {
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                while (true) {
+                    const result = iter.next();
+                    if (result.done)
+                        return { done: true, value: undefined };
+                    const [key, value] = result.value;
+                    const id = SyncUnitMap.parseKey(key);
+                    if (filter) {
+                        if (id.documentId !== filter.documentId)
+                            continue;
+                        if (filter.scope !== undefined && id.scope !== filter.scope)
+                            continue;
+                    }
+                    return { done: false, value };
+                }
+            },
+        };
+    }
+    /**
+     * Returns an iterator of [id, value] pairs
+     * @param filter Optional filter by documentId and scope
+     */
+    entries(filter) {
+        const iter = this.internalMap.entries();
+        return {
+            [Symbol.iterator]() {
+                return this;
+            },
+            next() {
+                while (true) {
+                    const result = iter.next();
+                    if (result.done)
+                        return { done: true, value: undefined };
+                    const [key, value] = result.value;
+                    const id = SyncUnitMap.parseKey(key);
+                    if (filter) {
+                        if (id.documentId !== filter.documentId)
+                            continue;
+                        if (filter.scope !== undefined && id.scope !== filter.scope)
+                            continue;
+                    }
+                    return {
+                        done: false,
+                        value: [id, value],
+                    };
+                }
+            },
+        };
+    }
+    /** Makes the map iterable */
+    [Symbol.iterator]() {
+        return this.entries();
+    }
+    /**
+     * Executes a callback for each entry in the map
+     * @param callbackfn Function to execute for each entry
+     * @param thisArg Value to use as 'this' in the callback
+     */
+    forEach(callbackfn, thisArg) {
+        for (const [k, v] of this.entries()) {
+            callbackfn.call(thisArg, v, k, this);
+        }
+    }
+    // Custom API methods
+    /**
+     * Removes all entries associated with a specific document
+     * @param documentId The document identifier
+     */
+    deleteByDocumentId(documentId) {
+        for (const key of this.internalMap.keys()) {
+            if (key.startsWith(documentId + SyncUnitMap.keySeparator)) {
+                this.internalMap.delete(key);
+            }
+        }
+    }
+    /**
+     * Removes all entries for a specific document and scope combination
+     * @param documentId The document identifier
+     * @param scope The scope identifier
+     */
+    deleteByDocumentIdAndScope(documentId, scope) {
+        const prefix = `${documentId}${SyncUnitMap.keySeparator}${scope}${SyncUnitMap.keySeparator}`;
+        for (const key of this.internalMap.keys()) {
+            if (key.startsWith(prefix)) {
+                this.internalMap.delete(key);
+            }
+        }
+    }
+    /**
+     * Retrieves all entries associated with a specific document
+     * @param documentId The document identifier
+     * @returns Array of [id, value] pairs
+     */
+    getAllByDocumentId(documentId) {
+        const results = [];
+        for (const [key, value] of this.internalMap.entries()) {
+            if (key.startsWith(documentId + SyncUnitMap.keySeparator)) {
+                results.push([SyncUnitMap.parseKey(key), value]);
+            }
+        }
+        return results;
+    }
+    /**
+     * Retrieves all entries for a specific document and scope combination
+     * @param documentId The document identifier
+     * @param scope The scope identifier
+     * @returns Array of [id, value] pairs
+     */
+    getAllByDocumentIdAndScope(documentId, scope) {
+        const prefix = `${documentId}${SyncUnitMap.keySeparator}${scope}${SyncUnitMap.keySeparator}`;
+        const results = [];
+        for (const [key, value] of this.internalMap.entries()) {
+            if (key.startsWith(prefix)) {
+                results.push([SyncUnitMap.parseKey(key), value]);
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=sync-unit-map.js.map

package/dist/src/server/sync-unit-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-unit-map.js","sourceRoot":"","sources":["../../../src/server/sync-unit-map.ts"],"names":[],"mappings":"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"}

package/dist/src/server/types.d.ts

@@ -1,13 +1,15 @@
-import { type DocumentDriveAction, type DocumentDriveDocument, type DocumentDriveLocalState, type ListenerCallInfo, type ListenerFilter, type Trigger } from "#drive-document-model/gen/types";
+import { type DocumentDriveAction, type DocumentDriveDocument, type DocumentDriveLocalState, type LegacyAddFileAction, type ListenerCallInfo, type ListenerFilter, type Trigger } from "#drive-document-model/gen/types";
 import { type IReadModeDriveServer } from "#read-mode/types";
 import { type IDefaultDrivesManager } from "#utils/default-drives-manager";
 import { type DriveInfo } from "#utils/graphql";
 import { type RunAsap } from "#utils/run-asap";
-import { type Action, type ActionContext, type CreateChildDocumentInput, type DocumentModelModule, type Operation, type OperationFromDocument, type OperationScope, type PHDocument, type ReducerOptions, type Signal } from "document-model";
+import { type Action, type ActionContext, type DocumentModelModule, type Operation, type PHDocument, type PHDocumentHeader, type PHDocumentMeta, type ReducerOptions } from "document-model";
 import { type Unsubscribe } from "nanoevents";
+import { type SignalResult } from "../../../document-model/src/document/signal.js";
 import { type BaseDocumentDriveServer } from "./base-server.js";
 import { type OperationError, type SynchronizationUnitNotFoundError } from "./error.js";
 import { type ITransmitter, type StrandUpdateSource } from "./listener/transmitter/types.js";
+import { type ISyncUnitMap } from "./sync-unit-map.js";
 export type Constructor<T = object> = new (...args: any[]) => T;
 export type Mixin<T extends Constructor, I> = T & Constructor<InstanceType<T> & I>;
 export type DocumentDriveServerMixin<I> = Mixin<typeof BaseDocumentDriveServer, I>;
@@ -28,25 +30,41 @@ export type RemoteDriveOptions = DocumentDriveLocalState & {
     expectedDriveInfo?: DriveInfo;
     accessLevel?: RemoteDriveAccessLevel;
 };
-export type CreateDocumentInput<TDocument extends PHDocument> = CreateChildDocumentInput<TDocument>;
-export type SignalResult = {
-    signal: Signal;
-    result: unknown;
+/**
+ * @deprecated In the future we will disallow this. Use the header field instead.
+ */
+export type LegacyCreateDocumentInput = {
+    /**
+     * @deprecated In the future we will disallow this. Use the header field instead.
+     */
+    id: string;
+    documentType: string;
+};
+export type CreateDocumentInputWithDocument<TDocument extends PHDocument> = {
+    document: TDocument;
+};
+export type CreateDocumentInputWithHeader = {
+    header: PHDocumentHeader;
+};
+export type CreateDocumentInputWithDocumentType = {
+    documentType: string;
 };
+export type CreateDocumentInput<TDocument extends PHDocument> = LegacyCreateDocumentInput | CreateDocumentInputWithDocument<TDocument> | CreateDocumentInputWithHeader | CreateDocumentInputWithDocumentType;
 export type IOperationResult<TDocument extends PHDocument = PHDocument> = {
     status: UpdateStatus;
     error?: OperationError;
-    operations: OperationFromDocument<TDocument>[];
+    operations: Operation[];
     document: TDocument | undefined;
     signals: SignalResult[];
 };
 export type DriveOperationResult = IOperationResult<DocumentDriveDocument>;
-export type SynchronizationUnit = {
-    syncId: string;
+export type SynchronizationUnitId = {
     documentId: string;
-    documentType: string;
     scope: string;
     branch: string;
+};
+export type SynchronizationUnit = SynchronizationUnitId & {
+    documentType: string;
     lastUpdated: string;
     revision: number;
 };
@@ -80,6 +98,7 @@ export declare enum TransmitterType {
 export type ListenerRevision = {
     driveId: string;
     documentId: string;
+    documentType: string;
     scope: string;
     branch: string;
     status: UpdateStatus;
@@ -108,7 +127,8 @@ export type OperationUpdate = {
 export type StrandUpdate = {
     driveId: string;
     documentId: string;
-    scope: OperationScope;
+    documentType: string;
+    scope: string;
     branch: string;
     operations: OperationUpdate[];
 };
@@ -121,21 +141,21 @@ export type SyncUnitStatusObject = {
 };
 export type AddRemoteDriveStatus = "SUCCESS" | "ERROR" | "PENDING" | "ADDING" | "ALREADY_ADDED";
 export interface DriveEvents {
-    syncStatus: (driveId: string, status: SyncStatus, error?: Error, syncUnitStatus?: SyncUnitStatusObject) => void;
+    syncStatus: (driveId: string, status: SyncStatus, error?: Error, syncUnitStatus?: SyncUnitStatusObject, scope?: string, branch?: string) => void;
     defaultRemoteDrive: (status: AddRemoteDriveStatus, defaultDrives: Map<string, DefaultRemoteDriveInfo>, driveInput: DefaultRemoteDriveInput, driveId?: string, driveName?: string, error?: Error) => void;
     strandUpdate: (update: StrandUpdate) => void;
     clientStrandsError: (driveId: string, trigger: Trigger, status: number, errorMessage: string) => void;
     documentModelModules: (documentModelModules: DocumentModelModule[]) => void;
     driveAdded: (drive: DocumentDriveDocument) => void;
     driveDeleted: (driveId: string) => void;
-    documentOperationsAdded: (driveId: string, documentId: string, operations: Operation[]) => void;
+    documentOperationsAdded: (documentId: string, operations: Operation[]) => void;
     driveOperationsAdded: (driveId: string, operations: Operation[]) => void;
-    operationsAdded: (driveId: string, documentId: string | undefined | null, operations: Operation[]) => void;
+    operationsAdded: (documentId: string, operations: Operation[]) => void;
 }
 export type PartialRecord<K extends keyof any, T> = {
     [P in K]?: T;
 };
-export type RevisionsFilter = PartialRecord<OperationScope, number>;
+export type RevisionsFilter = PartialRecord<string, number>;
 export type GetDocumentOptions = ReducerOptions & {
     revisions?: RevisionsFilter;
     checkHashes?: boolean;
@@ -234,30 +254,93 @@ export interface IBaseDocumentDriveServer {
     getDrive(driveId: string, options?: GetDocumentOptions): Promise<DocumentDriveDocument>;
     getDriveBySlug(slug: string): Promise<DocumentDriveDocument>;
     getDriveIdBySlug(slug: string): Promise<DocumentDriveDocument["header"]["id"]>;
-    getDocuments(driveId: string): Promise<string[]>;
+    addDocument<TDocument extends PHDocument>(input: TDocument, meta?: PHDocumentMeta): Promise<TDocument>;
+    addDocument<TDocument extends PHDocument>(documentType: string, meta?: PHDocumentMeta): Promise<TDocument>;
+    deleteDocument(documentId: string): Promise<void>;
+    getDocuments(parentId: string): Promise<string[]>;
+    /**
+     * @deprecated Use getDocument(documentId, options) instead. This method will be removed in the future.
+     */
     getDocument<TDocument extends PHDocument>(driveId: string, documentId: string, options?: GetDocumentOptions): Promise<TDocument>;
+    getDocument<TDocument extends PHDocument>(documentId: string, options?: GetDocumentOptions): Promise<TDocument>;
+    queueDocument<TDocument extends PHDocument>(input: CreateDocumentInput<TDocument>, options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use addOperation(documentId, operation, options) instead. This method will be removed in the future.
+     */
     addOperation(driveId: string, documentId: string, operation: Operation, options?: AddOperationOptions): Promise<IOperationResult>;
+    addOperation(documentId: string, operation: Operation, options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use addOperations(documentId, operations, options) instead. This method will be removed in the future.
+     */
     addOperations(driveId: string, documentId: string, operations: Operation[], options?: AddOperationOptions): Promise<IOperationResult>;
+    addOperations(documentId: string, operations: Operation[], options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use queueOperation(documentId, operation, options) instead. This method will be removed in the future.
+     */
     queueOperation(driveId: string, documentId: string, operation: Operation, options?: AddOperationOptions): Promise<IOperationResult>;
+    queueOperation(documentId: string, operation: Operation, options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use queueOperations(documentId, operations, options) instead. This method will be removed in the future.
+     */
     queueOperations(driveId: string, documentId: string, operations: Operation[], options?: AddOperationOptions): Promise<IOperationResult>;
+    queueOperations(documentId: string, operations: Operation[], options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use queueAction(documentId, action, options) instead. This method will be removed in the future.
+     */
     queueAction(driveId: string, documentId: string, action: Action, options?: AddOperationOptions): Promise<IOperationResult>;
+    queueAction(documentId: string, action: Action, options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use queueActions(documentId, actions, options) instead. This method will be removed in the future.
+     */
     queueActions(driveId: string, documentId: string, actions: Action[], options?: AddOperationOptions): Promise<IOperationResult>;
-    addDriveOperation(driveId: string, operation: Operation<DocumentDriveAction>, options?: AddOperationOptions): Promise<DriveOperationResult>;
-    addDriveOperations(driveId: string, operations: Operation<DocumentDriveAction>[], options?: AddOperationOptions): Promise<DriveOperationResult>;
-    queueDriveOperation(driveId: string, operation: Operation<DocumentDriveAction>, options?: AddOperationOptions): Promise<DriveOperationResult>;
-    queueDriveOperations(driveId: string, operations: Operation<DocumentDriveAction>[], options?: AddOperationOptions): Promise<DriveOperationResult>;
+    queueActions(documentId: string, actions: Action[], options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use the {@link addOperation} method instead.
+     */
+    addDriveOperation(driveId: string, operation: Operation, options?: AddOperationOptions): Promise<DriveOperationResult>;
+    /**
+     * @deprecated Use the {@link addOperations} method instead.
+     */
+    addDriveOperations(driveId: string, operations: Operation[], options?: AddOperationOptions): Promise<DriveOperationResult>;
+    /**
+     * @deprecated Use the {@link queueOperation} method instead.
+     */
+    queueDriveOperation(driveId: string, operation: Operation, options?: AddOperationOptions): Promise<DriveOperationResult>;
+    /**
+     * @deprecated Use the {@link queueOperations} method instead.
+     */
+    queueDriveOperations(driveId: string, operations: Operation[], options?: AddOperationOptions): Promise<DriveOperationResult>;
+    /**
+     * @deprecated Use the {@link queueAction} method instead.
+     */
     queueDriveAction(driveId: string, action: DocumentDriveAction, options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use the {@link queueActions} method instead.
+     */
     queueDriveActions(driveId: string, actions: DocumentDriveAction[], options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use addAction(documentId, action, options) method instead. This method will be removed in the future.
+     */
     addAction(driveId: string, documentId: string, action: Action, options?: AddOperationOptions): Promise<IOperationResult>;
+    addAction(documentId: string, action: Action, options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use addActions(documentId, actions, options) instead. This method will be removed in the future.
+     */
     addActions(driveId: string, documentId: string, actions: Action[], options?: AddOperationOptions): Promise<IOperationResult>;
+    addActions(documentId: string, actions: Action[], options?: AddOperationOptions): Promise<IOperationResult>;
+    /**
+     * @deprecated Use the {@link addAction} method with a {@link AddFileAction} and call {@link addDocument} if the document needs to be created.
+     */
+    addDriveAction(driveId: string, action: LegacyAddFileAction, options?: AddOperationOptions): Promise<DriveOperationResult>;
+    /**
+     * @deprecated Use the {@link addAction} method instead.
+     */
     addDriveAction(driveId: string, action: DocumentDriveAction, options?: AddOperationOptions): Promise<DriveOperationResult>;
+    /**
+     * @deprecated Use the {@link addActions} method instead.
+     */
     addDriveActions(driveId: string, actions: DocumentDriveAction[], options?: AddOperationOptions): Promise<DriveOperationResult>;
-    getSyncStatus(syncUnitId: string): SyncStatus | SynchronizationUnitNotFoundError;
-    /** Synchronization methods */
-    getSynchronizationUnits(driveId: string, documentId?: string[], scope?: string[], branch?: string[], documentType?: string[]): Promise<SynchronizationUnit[]>;
-    getSynchronizationUnit(driveId: string, syncId: string, loadedDrive?: DocumentDriveDocument): Promise<SynchronizationUnit | undefined>;
-    getSynchronizationUnitsIds(driveId: string, documentId?: string[], scope?: string[], branch?: string[], documentType?: string[]): Promise<SynchronizationUnitQuery[]>;
-    getOperationData(driveId: string, syncId: string, filter: GetStrandsOptions): Promise<OperationUpdate[]>;
+    getSyncStatus(documentId: string, scope?: string, branch?: string): SyncStatus | SynchronizationUnitNotFoundError;
     /** Internal methods **/
     getDocumentModelModules(): DocumentModelModule[];
     on<K extends keyof DriveEvents>(event: K, cb: DriveEvents[K]): Unsubscribe;
@@ -275,21 +358,21 @@ export interface IListenerManager {
     removeListener(driveId: string, listenerId: string): Promise<boolean>;
     getListenerState(driveId: string, listenerId: string): ListenerState;
     getStrands(driveId: string, listenerId: string, options?: GetStrandsOptions): Promise<StrandUpdate[]>;
-    updateSynchronizationRevisions(driveId: string, syncUnits: SynchronizationUnit[], source: StrandUpdateSource, willUpdate?: (listeners: Listener[]) => void, onError?: (error: Error, driveId: string, listener: ListenerState) => void, forceSync?: boolean): Promise<ListenerUpdate[]>;
-    updateListenerRevision(listenerId: string, driveId: string, syncId: string, listenerRev: number): Promise<void>;
-    getListenerSyncUnitIds(driveId: string, listenerId: string): Promise<SynchronizationUnitQuery[]>;
-    removeSyncUnits(driveId: string, syncUnits: Pick<SynchronizationUnit, "syncId">[]): Promise<void>;
+    updateSynchronizationRevisions(syncUnits: SynchronizationUnit[], source: StrandUpdateSource, willUpdate?: (listeners: Listener[]) => void, onError?: (error: Error, driveId: string, listener: ListenerState) => void, forceSync?: boolean): Promise<ListenerUpdate[]>;
+    updateListenerRevision(listenerId: string, driveId: string, syncUnitId: SynchronizationUnitId, listenerRev: number): Promise<void>;
+    removeSyncUnits(parentId: string, syncUnits: SynchronizationUnitId[]): Promise<void>;
     setGenerateJwtHandler(handler: (driveUrl: string) => Promise<string>): void;
     removeJwtHandler(): void;
     generateJwtHandler?: (driveUrl: string) => Promise<string>;
 }
 export type ListenerStatus = "CREATED" | "PENDING" | "SUCCESS" | "MISSING" | "CONFLICT" | "ERROR";
+export type SynchronizationUnitMap = ISyncUnitMap<SyncronizationUnitState>;
 export interface ListenerState {
     driveId: string;
     block: boolean;
     pendingTimeout: string;
     listener: Listener;
-    syncUnits: Map<SynchronizationUnit["syncId"], SyncronizationUnitState>;
+    syncUnits: SynchronizationUnitMap;
     listenerStatus: ListenerStatus;
 }
 export interface SyncronizationUnitState {
@@ -305,13 +388,14 @@ export interface IEventEmitter {
 }
 export interface ISynchronizationManager {
     setDocumentModelModules(arg0: DocumentModelModule[]): void;
-    getSynchronizationUnits(driveId: string, documentId?: string[], scope?: string[], branch?: string[], documentType?: string[]): Promise<SynchronizationUnit[]>;
-    getSynchronizationUnitsIds(driveId: string, documentId?: string[], scope?: string[], branch?: string[], documentType?: string[]): Promise<SynchronizationUnitQuery[]>;
-    getSynchronizationUnit(driveId: string, syncId: string): Promise<SynchronizationUnit | undefined>;
-    getOperationData(driveId: string, syncId: string, filter: GetStrandsOptions): Promise<OperationUpdate[]>;
-    getSynchronizationUnitsRevision(driveId: string, syncUnitsQuery: SynchronizationUnitQuery[]): Promise<SynchronizationUnit[]>;
-    getSyncStatus(syncUnitId: string): SyncStatus | SynchronizationUnitNotFoundError;
-    updateSyncStatus(syncUnitId: string, status: Partial<SyncUnitStatusObject> | null, error?: Error): void;
+    getSynchronizationUnits(parentId?: string, documentId?: string[], scope?: string[], branch?: string[], documentType?: string[]): Promise<SynchronizationUnit[]>;
+    getSynchronizationUnitsIds(parentId?: string, documentId?: string[], scope?: string[], branch?: string[], documentType?: string[]): Promise<SynchronizationUnitQuery[]>;
+    getSynchronizationUnit(syncId: SynchronizationUnitId): Promise<SynchronizationUnit | undefined>;
+    getOperationData(syncId: SynchronizationUnitId, filter: GetStrandsOptions): Promise<OperationUpdate[]>;
+    getSyncStatus(documentId: string, scope?: string, branch?: string): SyncStatus | SynchronizationUnitNotFoundError;
+    getSyncStatus(syncId: SynchronizationUnitId): SyncStatus | SynchronizationUnitNotFoundError;
+    updateSyncStatus(documentId: string, status: Partial<SyncUnitStatusObject> | null, error?: Error, scope?: string, branch?: string): void;
+    updateSyncStatus(syncId: SynchronizationUnitId, status: Partial<SyncUnitStatusObject> | null, error?: Error): void;
     initializeDriveSyncStatus(driveId: string, drive: DocumentDriveDocument): Promise<void>;
     getCombinedSyncUnitStatus(syncUnitStatus: SyncUnitStatusObject): SyncStatus;
 }