@protontech/drive-sdk 0.0.12 → 0.1.0

package/dist/internal/upload/streamUploader.test.js

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const interface_1 = require("../../interface");
+const errors_1 = require("../../errors");
+const apiService_1 = require("../apiService");
+const streamUploader_1 = require("./streamUploader");
+const controller_1 = require("./controller");
+const BLOCK_ENCRYPTION_OVERHEAD = 10000;
+async function mockEncryptBlock(verifyBlock, _, block, index) {
+    await verifyBlock(block);
+    return {
+        index,
+        encryptedData: block,
+        armoredSignature: 'signature',
+        verificationToken: 'verificationToken',
+        originalSize: block.length,
+        encryptedSize: block.length + BLOCK_ENCRYPTION_OVERHEAD,
+        hash: 'blockHash',
+    };
+}
+function mockUploadBlock(_, __, encryptedBlock, onProgress) {
+    onProgress(encryptedBlock.length);
+}
+describe('StreamUploader', () => {
+    let telemetry;
+    let apiService;
+    let cryptoService;
+    let uploadManager;
+    let blockVerifier;
+    let revisionDraft;
+    let metadata;
+    let controller;
+    let onFinish;
+    let abortController;
+    let uploader;
+    beforeEach(() => {
+        // @ts-expect-error No need to implement all methods for mocking
+        telemetry = {
+            getLoggerForRevision: jest.fn().mockReturnValue({
+                debug: jest.fn(),
+                info: jest.fn(),
+                warn: jest.fn(),
+                error: jest.fn(),
+            }),
+            logBlockVerificationError: jest.fn(),
+            uploadFailed: jest.fn(),
+            uploadFinished: jest.fn(),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        apiService = {
+            requestBlockUpload: jest.fn().mockImplementation((_, __, blocks) => ({
+                blockTokens: blocks.contentBlocks.map((block) => ({
+                    index: block.index,
+                    bareUrl: `bareUrl/block:${block.index}`,
+                    token: `token/block:${block.index}`,
+                })),
+                thumbnailTokens: (blocks.thumbnails || []).map((thumbnail) => ({
+                    type: thumbnail.type,
+                    bareUrl: `bareUrl/thumbnail:${thumbnail.type}`,
+                    token: `token/thumbnail:${thumbnail.type}`,
+                })),
+            })),
+            uploadBlock: jest.fn().mockImplementation(mockUploadBlock),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        cryptoService = {
+            encryptThumbnail: jest.fn().mockImplementation(async (_, thumbnail) => ({
+                type: thumbnail.type,
+                encryptedData: thumbnail.thumbnail,
+                originalSize: thumbnail.thumbnail.length,
+                encryptedSize: thumbnail.thumbnail + 1000,
+                hash: 'thumbnailHash',
+            })),
+            encryptBlock: jest.fn().mockImplementation(mockEncryptBlock),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        uploadManager = {
+            commitDraft: jest.fn().mockResolvedValue(undefined),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        blockVerifier = {
+            verifyBlock: jest.fn().mockResolvedValue(undefined),
+        };
+        revisionDraft = {
+            nodeRevisionUid: 'revisionUid',
+            nodeKeys: {
+                signatureAddress: { addressId: 'addressId' },
+            },
+        };
+        metadata = {
+            // 3 blocks: 4 + 4 + 2 MB
+            expectedSize: 10 * 1024 * 1024,
+        };
+        controller = new controller_1.UploadController();
+        onFinish = jest.fn();
+        abortController = new AbortController();
+        uploader = new streamUploader_1.StreamUploader(telemetry, apiService, cryptoService, uploadManager, blockVerifier, revisionDraft, metadata, onFinish, abortController.signal);
+    });
+    describe('start', () => {
+        let thumbnails;
+        let thumbnailSize;
+        let onProgress;
+        let stream;
+        const verifySuccess = async () => {
+            await uploader.start(stream, thumbnails, onProgress);
+            const numberOfExpectedBlocks = Math.ceil(metadata.expectedSize / streamUploader_1.FILE_CHUNK_SIZE);
+            expect(uploadManager.commitDraft).toHaveBeenCalledTimes(1);
+            expect(uploadManager.commitDraft).toHaveBeenCalledWith(revisionDraft, expect.anything(), metadata, {
+                size: metadata.expectedSize,
+                blockSizes: metadata.expectedSize ? [
+                    ...Array(numberOfExpectedBlocks - 1).fill(streamUploader_1.FILE_CHUNK_SIZE),
+                    metadata.expectedSize % streamUploader_1.FILE_CHUNK_SIZE
+                ] : [],
+                modificationTime: undefined,
+                digests: {
+                    sha1: expect.anything(),
+                }
+            });
+            expect(telemetry.uploadFinished).toHaveBeenCalledTimes(1);
+            expect(telemetry.uploadFinished).toHaveBeenCalledWith('revisionUid', metadata.expectedSize + thumbnailSize);
+            expect(telemetry.uploadFailed).not.toHaveBeenCalled();
+            expect(onFinish).toHaveBeenCalledTimes(1);
+            expect(onFinish).toHaveBeenCalledWith(false);
+        };
+        const verifyFailure = async (error, uploadedBytes, expectedSize = metadata.expectedSize) => {
+            const promise = uploader.start(stream, thumbnails, onProgress);
+            await expect(promise).rejects.toThrow(error);
+            expect(telemetry.uploadFinished).not.toHaveBeenCalled();
+            expect(telemetry.uploadFailed).toHaveBeenCalledTimes(1);
+            expect(telemetry.uploadFailed).toHaveBeenCalledWith('revisionUid', new Error(error), uploadedBytes === undefined ? expect.anything() : uploadedBytes, expectedSize);
+            expect(onFinish).toHaveBeenCalledTimes(1);
+            expect(onFinish).toHaveBeenCalledWith(true);
+        };
+        const verifyOnProgress = async (uploadedBytes) => {
+            expect(onProgress).toHaveBeenCalledTimes(uploadedBytes.length);
+            for (let i = 0; i < uploadedBytes.length; i++) {
+                expect(onProgress).toHaveBeenNthCalledWith(i + 1, uploadedBytes[i]);
+            }
+        };
+        beforeEach(() => {
+            onProgress = jest.fn();
+            thumbnails = [
+                {
+                    type: interface_1.ThumbnailType.Type1,
+                    thumbnail: new Uint8Array(1024),
+                }
+            ];
+            thumbnailSize = thumbnails.reduce((acc, thumbnail) => acc + thumbnail.thumbnail.length, 0);
+            stream = new ReadableStream({
+                start(controller) {
+                    const chunkSize = 1024;
+                    const chunkCount = metadata.expectedSize / chunkSize;
+                    for (let i = 1; i <= chunkCount; i++) {
+                        controller.enqueue(new Uint8Array(chunkSize));
+                    }
+                    controller.close();
+                },
+            });
+        });
+        it("should upload successfully", async () => {
+            await verifySuccess();
+            expect(apiService.requestBlockUpload).toHaveBeenCalledTimes(1);
+            expect(apiService.uploadBlock).toHaveBeenCalledTimes(4); // 3 blocks + 1 thumbnail
+            expect(blockVerifier.verifyBlock).toHaveBeenCalledTimes(3); // 3 blocks
+            expect(telemetry.logBlockVerificationError).not.toHaveBeenCalled();
+            await verifyOnProgress([thumbnailSize, 4 * 1024 * 1024, 4 * 1024 * 1024, 2 * 1024 * 1024]);
+        });
+        it("should upload successfully empty file without thumbnail", async () => {
+            metadata = {
+                expectedSize: 0,
+            };
+            stream = new ReadableStream({
+                start(controller) {
+                    controller.close();
+                },
+            });
+            thumbnails = [];
+            thumbnailSize = 0;
+            uploader = new streamUploader_1.StreamUploader(telemetry, apiService, cryptoService, uploadManager, blockVerifier, revisionDraft, metadata, onFinish);
+            await verifySuccess();
+            expect(apiService.requestBlockUpload).toHaveBeenCalledTimes(0);
+            expect(apiService.uploadBlock).toHaveBeenCalledTimes(0);
+            expect(blockVerifier.verifyBlock).toHaveBeenCalledTimes(0);
+            await verifyOnProgress([]);
+        });
+        it("should upload successfully empty file with thumbnail", async () => {
+            metadata = {
+                expectedSize: 0,
+            };
+            stream = new ReadableStream({
+                start(controller) {
+                    controller.close();
+                },
+            });
+            uploader = new streamUploader_1.StreamUploader(telemetry, apiService, cryptoService, uploadManager, blockVerifier, revisionDraft, metadata, onFinish);
+            await verifySuccess();
+            expect(apiService.requestBlockUpload).toHaveBeenCalledTimes(1);
+            expect(apiService.uploadBlock).toHaveBeenCalledTimes(1);
+            expect(blockVerifier.verifyBlock).toHaveBeenCalledTimes(0);
+            await verifyOnProgress([thumbnailSize]);
+        });
+        it('should handle failure when encrypting thumbnails', async () => {
+            cryptoService.encryptThumbnail = jest.fn().mockImplementation(async function () {
+                throw new Error('Failed to encrypt thumbnail');
+            });
+            await verifyFailure('Failed to encrypt thumbnail', 0);
+            expect(cryptoService.encryptThumbnail).toHaveBeenCalledTimes(1);
+        });
+        it('should handle failure when encrypting block', async () => {
+            cryptoService.encryptBlock = jest.fn().mockImplementation(async function () {
+                throw new Error('Failed to encrypt block');
+            });
+            // Encrypting thumbnails is before blocks, thus it can be uploaded before failure.
+            await verifyFailure('Failed to encrypt block', 1024);
+            // 1 block + 1 retry, others are skipped
+            expect(cryptoService.encryptBlock).toHaveBeenCalledTimes(2);
+        });
+        it('should handle one time-off failure when encrypting block', async () => {
+            let count = 0;
+            cryptoService.encryptBlock = jest.fn().mockImplementation(async function (verifyBlock, keys, block, index) {
+                if (count === 0) {
+                    count++;
+                    throw new Error('Failed to encrypt block');
+                }
+                return mockEncryptBlock(verifyBlock, keys, block, index);
+            });
+            await verifySuccess();
+            // 1 block + 1 retry + 2 other blocks without retry
+            expect(cryptoService.encryptBlock).toHaveBeenCalledTimes(4);
+            await verifyOnProgress([thumbnailSize, 4 * 1024 * 1024, 4 * 1024 * 1024, 2 * 1024 * 1024]);
+        });
+        it('should handle failure when requesting tokens', async () => {
+            apiService.requestBlockUpload = jest.fn().mockImplementation(async function () {
+                throw new Error('Failed to request tokens');
+            });
+            await verifyFailure('Failed to request tokens', 0);
+        });
+        it('should handle failure when uploading thumbnail', async () => {
+            apiService.uploadBlock = jest.fn().mockImplementation(async function (bareUrl, token, block, onProgress) {
+                if (token === 'token/thumbnail:1') {
+                    throw new Error('Failed to upload thumbnail');
+                }
+                return mockUploadBlock(bareUrl, token, block, onProgress);
+            });
+            // 10 MB uploaded as blocks still uploaded
+            await verifyFailure('Failed to upload thumbnail', 10 * 1024 * 1024);
+        });
+        it('should handle one time-off failure when uploading thubmnail', async () => {
+            let count = 0;
+            apiService.uploadBlock = jest.fn().mockImplementation(async function (bareUrl, token, block, onProgress) {
+                if (token === 'token/thumbnail:1' && count === 0) {
+                    count++;
+                    throw new Error('Failed to upload thumbnail');
+                }
+                return mockUploadBlock(bareUrl, token, block, onProgress);
+            });
+            await verifySuccess();
+            expect(apiService.requestBlockUpload).toHaveBeenCalledTimes(1);
+            // 3 blocks + 1 retry + 1 thumbnail
+            expect(apiService.uploadBlock).toHaveBeenCalledTimes(5);
+            await verifyOnProgress([4 * 1024 * 1024, 4 * 1024 * 1024, 2 * 1024 * 1024, 1024]);
+        });
+        it('should handle failure when uploading block', async () => {
+            apiService.uploadBlock = jest.fn().mockImplementation(async function (bareUrl, token, block, onProgress) {
+                if (token === 'token/block:3') {
+                    throw new Error('Failed to upload block');
+                }
+                return mockUploadBlock(bareUrl, token, block, onProgress);
+            });
+            // ~8 MB uploaded as 2 first blocks + 1 thumbnail still uploaded
+            await verifyFailure('Failed to upload block', 8 * 1024 * 1024 + 1024);
+        });
+        it('should handle one time-off failure when uploading block', async () => {
+            let count = 0;
+            apiService.uploadBlock = jest.fn().mockImplementation(async function (bareUrl, token, block, onProgress) {
+                if (token === 'token/block:2' && count === 0) {
+                    count++;
+                    throw new Error('Failed to upload block');
+                }
+                return mockUploadBlock(bareUrl, token, block, onProgress);
+            });
+            await verifySuccess();
+            expect(apiService.requestBlockUpload).toHaveBeenCalledTimes(1);
+            // 3 blocks + 1 retry + 1 thumbnail
+            expect(apiService.uploadBlock).toHaveBeenCalledTimes(5);
+            await verifyOnProgress([1024, 4 * 1024 * 1024, 2 * 1024 * 1024, 4 * 1024 * 1024]);
+        });
+        it('should handle expired token when uploading block', async () => {
+            let count = 0;
+            apiService.uploadBlock = jest.fn().mockImplementation(async function (bareUrl, token, block, onProgress) {
+                if (token === 'token/block:2' && count === 0) {
+                    count++;
+                    throw new apiService_1.APIHTTPError('Expired token', 404 /* HTTPErrorCode.NOT_FOUND */);
+                }
+                return mockUploadBlock(bareUrl, token, block, onProgress);
+            });
+            await verifySuccess();
+            // 1 for first try + 1 for retry
+            expect(apiService.requestBlockUpload).toHaveBeenCalledTimes(2);
+            expect(apiService.requestBlockUpload).toHaveBeenCalledWith(revisionDraft.nodeRevisionUid, revisionDraft.nodeKeys.signatureAddress.addressId, {
+                contentBlocks: [
+                    {
+                        index: 2,
+                        encryptedSize: 4 * 1024 * 1024 + 10000,
+                        hash: 'blockHash',
+                        armoredSignature: 'signature',
+                        verificationToken: 'verificationToken',
+                    }
+                ],
+            });
+            // 3 blocks + 1 retry + 1 thumbnail
+            expect(apiService.uploadBlock).toHaveBeenCalledTimes(5);
+            await verifyOnProgress([1024, 4 * 1024 * 1024, 2 * 1024 * 1024, 4 * 1024 * 1024]);
+        });
+        it('should handle abortion', async () => {
+            const error = new Error('Aborted');
+            const promise = uploader.start(stream, thumbnails, onProgress);
+            abortController.abort(error);
+            await promise;
+            expect(apiService.uploadBlock.mock.calls[0][4]?.aborted).toBe(true);
+        });
+        describe('verifyIntegrity', () => {
+            it('should report block verification error', async () => {
+                blockVerifier.verifyBlock = jest.fn().mockRejectedValue(new errors_1.IntegrityError('Block verification error'));
+                await verifyFailure('Block verification error', 1024);
+                expect(telemetry.logBlockVerificationError).toHaveBeenCalledWith(false);
+            });
+            it('should report block verification error when retry helped', async () => {
+                blockVerifier.verifyBlock = jest.fn().mockRejectedValueOnce(new errors_1.IntegrityError('Block verification error')).mockResolvedValue({
+                    verificationToken: new Uint8Array(),
+                });
+                await verifySuccess();
+                expect(telemetry.logBlockVerificationError).toHaveBeenCalledWith(true);
+            });
+            it('should throw an error if block count does not match', async () => {
+                uploader = new streamUploader_1.StreamUploader(telemetry, apiService, cryptoService, uploadManager, blockVerifier, revisionDraft, {
+                    // Fake expected size to break verification
+                    expectedSize: 1 * 1024 * 1024 + 1024,
+                    mediaType: '',
+                }, onFinish);
+                await verifyFailure('Some file parts failed to upload', 10 * 1024 * 1024 + 1024, 1 * 1024 * 1024 + 1024);
+            });
+            it('should throw an error if file size does not match', async () => {
+                cryptoService.encryptBlock = jest.fn().mockImplementation(async (_, __, block, index) => ({
+                    index,
+                    encryptedData: block,
+                    armoredSignature: 'signature',
+                    verificationToken: 'verificationToken',
+                    originalSize: 0, // Fake original size to break verification
+                    encryptedSize: block.length + 10000,
+                    hash: 'blockHash',
+                }));
+                await verifyFailure('Some file bytes failed to upload', 10 * 1024 * 1024 + 1024);
+            });
+        });
+    });
+});
+//# sourceMappingURL=streamUploader.test.js.map

package/dist/internal/upload/streamUploader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamUploader.test.js","sourceRoot":"","sources":["../../../src/internal/upload/streamUploader.test.ts"],"names":[],"mappings":"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"}

package/dist/protonDriveClient.d.ts

@@ -1,5 +1,7 @@
-import { ProtonDriveClientContructorParameters, NodeOrUid, MaybeNode, MaybeMissingNode, NodeResult, Revision, ShareNodeSettings, UnshareNodeSettings, ProtonInvitationOrUid, NonProtonInvitationOrUid, ProtonInvitationWithNode, MaybeBookmark, BookmarkOrUid, ShareResult, Device, DeviceType, DeviceOrUid, UploadMetadata, FileDownloader, Fileuploader, ThumbnailType, ThumbnailResult, SDKEvent, DeviceEventCallback, NodeEventCallback } from './interface';
+import { ProtonDriveClientContructorParameters, NodeOrUid, MaybeNode, MaybeMissingNode, NodeResult, Revision, ShareNodeSettings, UnshareNodeSettings, ProtonInvitationOrUid, NonProtonInvitationOrUid, ProtonInvitationWithNode, MaybeBookmark, BookmarkOrUid, ShareResult, Device, DeviceType, DeviceOrUid, UploadMetadata, FileDownloader, FileUploader, FileRevisionUploader, ThumbnailType, ThumbnailResult, SDKEvent } from './interface';
 import { SessionKey } from './crypto';
+import { DriveListener } from './internal/events';
+import { EventSubscription } from './internal/events/interface';
 /**
  * ProtonDriveClient is the main interface for the ProtonDrive SDK.
  *
@@ -33,7 +35,7 @@ export declare class ProtonDriveClient {
          */
         getDocsKey: (nodeUid: NodeOrUid) => Promise<SessionKey>;
     };
-    constructor({ httpClient, entitiesCache, cryptoCache, account, openPGPCryptoModule, srpModule, config, telemetry, }: ProtonDriveClientContructorParameters);
+    constructor({ httpClient, entitiesCache, cryptoCache, account, openPGPCryptoModule, srpModule, config, telemetry, latestEventIdProvider, }: ProtonDriveClientContructorParameters);
     /**
      * Subscribes to the general SDK events.
      *
@@ -46,161 +48,23 @@ export declare class ProtonDriveClient {
      */
     onMessage(eventName: SDKEvent, callback: () => void): () => void;
     /**
-     * Subscribes to the remote data updates.
+     * Subscribes to the remote data updates for all files and folders in a
+     * tree.
      *
-     * By default, SDK doesn't subscribe to remote data updates. If you
-     * cache the data locally, you need to call this method so the SDK
-     * keeps the local cache in sync with the remote data.
+     * In order to keep local data up to date, the client must call this method
+     * to receive events on update and to keep the SDK cache in sync.
      *
-     * Only one instance of the SDK should subscribe to remote data updates.
+     * The `treeEventScopeId` can be obtained from node properties.
      *
-     * Once subscribed, the SDK will poll for events for core user events and
-     * for own data at minimum. Updates to nodes from other users are polled
-     * with lower frequency depending on the number of subscriptions, and only
-     * after accessing them for the first time via `iterateSharedNodesWithMe`.
+     * Only one instance of the SDK should subscribe to updates.
      */
-    subscribeToRemoteDataUpdates(): Promise<void>;
+    subscribeToTreeEvents(treeEventScopeId: string, callback: DriveListener): Promise<EventSubscription>;
     /**
-     * Subscribe to updates of the devices.
+     * Subscribes to sharing updates.
      *
-     * Clients should subscribe to this before beginning to list devices
-     * to ensure that updates are reflected once a device is in the cache.
-     * Subscribing before listing is also required to ensure that devices
-     * that are created during the listing will be recognized.
-     *
-     * ```typescript
-     * const unsubscribe = sdk.subscribeToDevices((event) => {
-     *     if (event.type === 'update') {
-     *         // Update the device in the UI
-     *     } else if (event.type === 'remove') {
-     *         // Remove the device from the UI
-     *     }
-     * });
-     *
-     * const devices = await Array.fromAsync(sdk.iterateDevices());
-     * // Render the devices in the UI
-     *
-     * // Unsubscribe from the updates when the component is unmounted
-     * unsubscribe();
-     * ```
-     *
-     * @param callback - Callback to be called when the event is emitted.
-     * @returns Callback to unsubscribe from the event.
-     */
-    subscribeToDevices(callback: DeviceEventCallback): () => void;
-    /**
-     * Subscribe to updates of the children of the given parent node.
-     *
-     * Clients should subscribe to this before beginning to list children
-     * to ensure that updates are reflected once a node is in the cache.
-     * Subscribing before listing is also required to ensure that nodes
-     * that are created during the listing will be recognized.
-     *
-     * ```typescript
-     * const unsubscribe = sdk.subscribeToChildren(parentNodeUid, (event) => {
-     *     if (event.type === 'update') {
-     *         // Update the node in the UI
-     *     } else if (event.type === 'remove') {
-     *         // Remove the node from the UI
-     *     }
-     * });
-     *
-     * const nodes = await Array.fromAsync(sdk.iterateChildren(parentNodeUid));
-     * // Render the nodes in the UI
-     *
-     * // Unsubscribe from the updates when the component is unmounted
-     * unsubscribe();
-     * ```
-     *
-     * @param parentNodeUid - Node entity or its UID string.
-     * @param callback - Callback to be called when the event is emitted.
-     * @returns Callback to unsubscribe from the event.
+     * Only one instance of the SDK should subscribe to updates.
      */
-    subscribeToFolder(parentNodeUid: NodeOrUid, callback: NodeEventCallback): () => void;
-    /**
-     * Subscribe to updates of the trashed nodes.
-     *
-     * Clients should subscribe to this before beginning to list trashed
-     * nodes to ensure that updates are reflected once a node is in the cache.
-     * Subscribing before listing is also required to ensure that nodes
-     * that are trashed during the listing will be recognized.
-     *
-     * ```typescript
-     * const unsubscribe = sdk.subscribeToTrashedNodes((event) => {
-     *     if (event.type === 'update') {
-     *         // Update the node in the UI
-     *     } else if (event.type === 'remove') {
-     *         // Remove the node from the UI
-     *     }
-     * });
-     *
-     * const nodes = await Array.fromAsync(sdk.iterateTrashedNodes());
-     * // Render the nodes in the UI
-     *
-     * // Unsubscribe from the updates when the component is unmounted
-     * unsubscribe();
-     * ```
-     *
-     * @param callback - Callback to be called when the event is emitted.
-     * @returns Callback to unsubscribe from the event.
-     */
-    subscribeToTrashedNodes(callback: NodeEventCallback): () => void;
-    /**
-     * Subscribe to updates of the nodes shared by the user.
-     *
-     * Clients should subscribe to this before beginning to list shared
-     * nodes to ensure that updates are reflected once a node is in the cache.
-     * Subscribing before listing is also required to ensure that nodes
-     * that are shared during the listing will be recognized.
-     *
-     * ```typescript
-     * const unsubscribe = sdk.subscribeToSharedNodesByMe((event) => {
-     *     if (event.type === 'update') {
-     *         // Update the node in the UI
-     *     } else if (event.type === 'remove') {
-     *         // Remove the node from the UI
-     *     }
-     * });
-     *
-     * const nodes = await Array.fromAsync(sdk.iterateSharedNodes());
-     * // Render the nodes in the UI
-     *
-     * // Unsubscribe from the updates when the component is unmounted
-     * unsubscribe();
-     * ```
-     *
-     * @param callback - Callback to be called when the event is emitted.
-     * @returns Callback to unsubscribe from the event.
-     */
-    subscribeToSharedNodesByMe(callback: NodeEventCallback): () => void;
-    /**
-     * Subscribe to updates of the nodes shared with the user.
-     *
-     * Clients should subscribe to this before beginning to list shared
-     * nodes to ensure that updates are reflected once a node is in the cache.
-     * Subscribing before listing is also required to ensure that nodes
-     * that are shared during the listing will be recognized.
-     *
-     * ```typescript
-     * const unsubscribe = sdk.subscribeToSharedNodesWithMe((event) => {
-     *     if (event.type === 'update') {
-     *         // Update the node in the UI
-     *     } else if (event.type === 'remove') {
-     *         // Remove the node from the UI
-     *     }
-     * });
-     *
-     * const nodes = await Array.fromAsync(sdk.iterateSharedNodesWithMe());
-     * // Render the nodes in the UI
-     *
-     * // Unsubscribe from the updates when the component is unmounted
-     * unsubscribe();
-     * ```
-     *
-     * @param callback - Callback to be called when the event is emitted.
-     * @returns Callback to unsubscribe from the event.
-     */
-    subscribeToSharedNodesWithMe(callback: NodeEventCallback): () => void;
+    subscribeToDriveEvents(callback: DriveListener): Promise<EventSubscription>;
     /**
      * Provides the node UID for the given raw share and node IDs.
      *
@@ -224,8 +88,6 @@ export declare class ProtonDriveClient {
      *
      * The output is not sorted and the order of the children is not guaranteed.
      *
-     * You can listen to updates via `subscribeToChildren`.
-     *
      * @param parentNodeUid - Node entity or its UID string.
      * @param signal - Signal to abort the operation.
      * @returns An async generator of the children of the given parent node.
@@ -239,8 +101,6 @@ export declare class ProtonDriveClient {
      *
      * The output is not sorted and the order of the trashed nodes is not guaranteed.
      *
-     * You can listen to updates via `subscribeToTrashedNodes`.
-     *
      * @param signal - Signal to abort the operation.
      * @returns An async generator of the trashed nodes.
      */
@@ -384,8 +244,6 @@ export declare class ProtonDriveClient {
      *
      * The output is not sorted and the order of the shared nodes is not guaranteed.
      *
-     * You can listen to updates via `subscribeToSharedNodesByMe`.
-     *
      * @param signal - Signal to abort the operation.
      * @returns An async generator of the shared nodes.
      */
@@ -395,11 +253,9 @@ export declare class ProtonDriveClient {
      *
      * The output is not sorted and the order of the shared nodes is not guaranteed.
      *
-     * At the end of the iteration, if `subscribeToRemoteDataUpdates` was called,
-     * the SDK will listen to updates for the shared nodes to keep the local cache
-     * in sync with the remote data.
-     *
-     * You can listen to updates via `subscribeToSharedNodesWithMe`.
+     * Clients can subscribe to drive events in order to receive a
+     * `SharedWithMeUpdated` event when there are changes to the user's
+     * access to shared nodes.
      *
      * @param signal - Signal to abort the operation.
      * @returns An async generator of the shared nodes.
@@ -560,7 +416,7 @@ export declare class ProtonDriveClient {
      *
      * ```typescript
      * const uploader = await client.getFileUploader(parentFolderUid, name, metadata, signal);
-     * const uploadController = uploader.writeStream(stream, thumbnails, (uploadedBytes) => { ... });
+     * const uploadController = await uploader.writeStream(stream, thumbnails, (uploadedBytes) => { ... });
      *
      * signalController.abort(); // to cancel
      * uploadController.pause(); // to pause
@@ -568,17 +424,18 @@ export declare class ProtonDriveClient {
      * const nodeUid = await uploadController.completion(); // to await completion
      * ```
      */
-    getFileUploader(parentFolderUid: NodeOrUid, name: string, metadata: UploadMetadata, signal?: AbortSignal): Promise<Fileuploader>;
+    getFileUploader(parentFolderUid: NodeOrUid, name: string, metadata: UploadMetadata, signal?: AbortSignal): Promise<FileUploader>;
     /**
      * Same as `getFileUploader`, but for a uploading new revision of the file.
      */
-    getFileRevisionUploader(nodeUid: NodeOrUid, metadata: UploadMetadata, signal?: AbortSignal): Promise<Fileuploader>;
+    getFileRevisionUploader(nodeUid: NodeOrUid, metadata: UploadMetadata, signal?: AbortSignal): Promise<FileRevisionUploader>;
     /**
      * Iterates the devices of the user.
      *
      * The output is not sorted and the order of the devices is not guaranteed.
      *
-     * You can listen to updates via `subscribeToDevices`.
+     * New devices can be registered by listening to events in the
+     * event scope of "My Files" and filtering on nodes with null `ParentLinkId`.
      *
      * @returns An async generator of devices.
      */