@protontech/drive-sdk 0.0.10

package/dist/internal/shares/manager.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharesManager = void 0;
+const interface_1 = require("../../interface");
+const apiService_1 = require("../apiService");
+/**
+ * Provides high-level actions for managing shares.
+ *
+ * The manager is responsible for handling shares metadata, including
+ * API communication, encryption, decryption, and caching.
+ *
+ * This module uses other modules providing low-level operations, such
+ * as API service, cache, crypto service, etc.
+ */
+class SharesManager {
+    logger;
+    apiService;
+    cache;
+    cryptoCache;
+    cryptoService;
+    account;
+    // Cache for My files IDs.
+    // Those IDs are required very often, so it is better to keep them in memory.
+    // The IDs are not cached in the cache module, as we want to always fetch
+    // them from the API, and not from the this.cache.
+    myFilesIds;
+    rootShares = new Map();
+    constructor(logger, apiService, cache, cryptoCache, cryptoService, account) {
+        this.logger = logger;
+        this.apiService = apiService;
+        this.cache = cache;
+        this.cryptoCache = cryptoCache;
+        this.cryptoService = cryptoService;
+        this.account = account;
+        this.logger = logger;
+        this.apiService = apiService;
+        this.cache = cache;
+        this.cryptoCache = cryptoCache;
+        this.cryptoService = cryptoService;
+        this.account = account;
+    }
+    /**
+     * It returns the IDs of the My files section.
+     *
+     * If the default volume or My files section doesn't exist, it creates it.
+     */
+    async getMyFilesIDs() {
+        if (this.myFilesIds) {
+            return this.myFilesIds;
+        }
+        try {
+            const encryptedShare = await this.apiService.getMyFiles();
+            // Once any place needs IDs for My files, it will most likely
+            // need also the keys for decrypting the tree. It is better to
+            // decrypt the share here right away.
+            const { share: myFilesShare, key } = await this.cryptoService.decryptRootShare(encryptedShare);
+            await this.cryptoCache.setShareKey(myFilesShare.shareId, key);
+            await this.cache.setVolume({
+                volumeId: myFilesShare.volumeId,
+                shareId: myFilesShare.shareId,
+                rootNodeId: myFilesShare.rootNodeId,
+                creatorEmail: encryptedShare.creatorEmail,
+                addressId: encryptedShare.addressId,
+            });
+            this.myFilesIds = {
+                volumeId: myFilesShare.volumeId,
+                shareId: myFilesShare.shareId,
+                rootNodeId: myFilesShare.rootNodeId,
+            };
+            return this.myFilesIds;
+        }
+        catch (error) {
+            if (error instanceof apiService_1.NotFoundAPIError) {
+                this.logger.warn('Active volume not found, creating a new one');
+                return this.createVolume();
+            }
+            this.logger.error('Failed to get active volume', error);
+            throw error;
+        }
+    }
+    /**
+     * Creates new default volume for the user.
+     *
+     * It generates the volume bootstrap, creates the volume on the server,
+     * and caches the volume metadata.
+     *
+     * User can have only one default volume.
+     *
+     * @throws If the volume cannot be created (e.g., one already exists).
+     */
+    async createVolume() {
+        const address = await this.account.getOwnPrimaryAddress();
+        const primaryKey = address.keys[address.primaryKeyIndex];
+        const bootstrap = await this.cryptoService.generateVolumeBootstrap(primaryKey.key);
+        const myFilesIds = await this.apiService.createVolume({
+            addressId: address.addressId,
+            addressKeyId: primaryKey.id,
+            ...bootstrap.shareKey.encrypted,
+        }, {
+            ...bootstrap.rootNode.key.encrypted,
+            encryptedName: bootstrap.rootNode.encryptedName,
+            armoredHashKey: bootstrap.rootNode.armoredHashKey,
+        });
+        await this.cryptoCache.setShareKey(myFilesIds.shareId, bootstrap.shareKey.decrypted);
+        return myFilesIds;
+    }
+    /**
+     * It is a high-level action that retrieves the private key for a share.
+     * If prefers to use the cache, but if the key is not there, it fetches
+     * the share from the API, decrypts it, and caches it.
+     *
+     * @param shareId - The ID of the share.
+     * @returns The private key for the share.
+     * @throws If the share is not found or cannot be decrypted, or cached.
+     */
+    async getSharePrivateKey(shareId) {
+        try {
+            const { key } = await this.cryptoCache.getShareKey(shareId);
+            return key;
+        }
+        catch { }
+        const encryptedShare = await this.apiService.getRootShare(shareId);
+        const { key } = await this.cryptoService.decryptRootShare(encryptedShare);
+        await this.cryptoCache.setShareKey(shareId, key);
+        return key.key;
+    }
+    async getMyFilesShareMemberEmailKey() {
+        const { volumeId } = await this.getMyFilesIDs();
+        try {
+            const { addressId } = await this.cache.getVolume(volumeId);
+            const address = await this.account.getOwnAddress(addressId);
+            return {
+                email: address.email,
+                addressId,
+                addressKey: address.keys[address.primaryKeyIndex].key,
+                addressKeyId: address.keys[address.primaryKeyIndex].id,
+            };
+        }
+        catch { }
+        const { shareId } = await this.apiService.getVolume(volumeId);
+        const share = await this.apiService.getRootShare(shareId);
+        await this.cache.setVolume({
+            volumeId: share.volumeId,
+            shareId: share.shareId,
+            rootNodeId: share.rootNodeId,
+            creatorEmail: share.creatorEmail,
+            addressId: share.addressId,
+        });
+        const address = await this.account.getOwnAddress(share.addressId);
+        return {
+            email: address.email,
+            addressId: share.addressId,
+            addressKey: address.keys[address.primaryKeyIndex].key,
+            addressKeyId: address.keys[address.primaryKeyIndex].id,
+        };
+    }
+    async getContextShareMemberEmailKey(shareId) {
+        let encryptedShare = this.rootShares.get(shareId);
+        if (!encryptedShare) {
+            encryptedShare = await this.apiService.getRootShare(shareId);
+            this.rootShares.set(shareId, encryptedShare);
+        }
+        const address = await this.account.getOwnAddress(encryptedShare.addressId);
+        return {
+            email: address.email,
+            addressId: encryptedShare.addressId,
+            addressKey: address.keys[address.primaryKeyIndex].key,
+            addressKeyId: address.keys[address.primaryKeyIndex].id,
+        };
+    }
+    async getVolumeMetricContext(volumeId) {
+        const { volumeId: myVolumeId } = await this.getMyFilesIDs();
+        // SDK doesn't support public sharing yet, also public sharing
+        // doesn't use a volume but shareURL, thus we can simplify and
+        // ignore this case for now.
+        if (volumeId === myVolumeId) {
+            return interface_1.MetricContext.OwnVolume;
+        }
+        return interface_1.MetricContext.Shared;
+    }
+    async loadEncryptedShare(shareId) {
+        return this.apiService.getShare(shareId);
+    }
+}
+exports.SharesManager = SharesManager;
+//# sourceMappingURL=manager.js.map

package/dist/internal/shares/manager.js.map

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

package/dist/internal/shares/manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal/shares/manager.test.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("../../tests/logger");
+const apiService_1 = require("../apiService");
+const manager_1 = require("./manager");
+describe("SharesManager", () => {
+    let apiService;
+    let cache;
+    let cryptoCache;
+    let cryptoService;
+    let account;
+    let manager;
+    beforeEach(() => {
+        // @ts-expect-error No need to implement all methods for mocking
+        apiService = {
+            getMyFiles: jest.fn(),
+            getRootShare: jest.fn(),
+            getShare: jest.fn(),
+            getVolume: jest.fn(),
+            createVolume: jest.fn(),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        cache = {
+            setVolume: jest.fn(),
+            getVolume: jest.fn(),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        cryptoCache = {
+            setShareKey: jest.fn(),
+            getShareKey: jest.fn(),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        cryptoService = {
+            generateVolumeBootstrap: jest.fn(),
+            decryptRootShare: jest.fn(),
+        };
+        // @ts-expect-error No need to implement all methods for mocking
+        account = {
+            getOwnPrimaryAddress: jest.fn(),
+            getOwnAddress: jest.fn(),
+        };
+        manager = new manager_1.SharesManager((0, logger_1.getMockLogger)(), apiService, cache, cryptoCache, cryptoService, account);
+    });
+    describe("getMyFilesIDs", () => {
+        const myFilesShare = {
+            shareId: "myFilesShareId",
+            volumeId: "myFilesVolumeId",
+            rootNodeId: "myFilesRootNodeId",
+        };
+        it("should load My files IDs once", async () => {
+            const encryptedShare = {
+                share: myFilesShare,
+                creatorEmail: "email",
+            };
+            const key = {
+                key: "privateKey",
+                sessionKey: "sessionKey",
+            };
+            apiService.getMyFiles = jest.fn().mockResolvedValue(encryptedShare);
+            cryptoService.decryptRootShare = jest.fn().mockResolvedValue({ share: myFilesShare, key });
+            // Calling twice to check if it loads only once.
+            await manager.getMyFilesIDs();
+            const result = await manager.getMyFilesIDs();
+            expect(result).toStrictEqual(myFilesShare);
+            expect(apiService.getMyFiles).toHaveBeenCalledTimes(1);
+            expect(cryptoService.decryptRootShare).toHaveBeenCalledTimes(1);
+            expect(cryptoCache.setShareKey).toHaveBeenCalledWith(myFilesShare.shareId, key);
+            expect(cache.setVolume).toHaveBeenCalledWith({
+                ...myFilesShare,
+                creatorEmail: encryptedShare.creatorEmail,
+            });
+            expect(apiService.createVolume).not.toHaveBeenCalled();
+        });
+        it("should create volume when My files section doesn't exist", async () => {
+            apiService.getMyFiles = jest.fn().mockRejectedValue(new apiService_1.NotFoundAPIError("no active volume", 0));
+            account.getOwnPrimaryAddress = jest.fn().mockResolvedValue({ primaryKeyIndex: 0, keys: [{ key: "addressKey" }] });
+            cryptoService.generateVolumeBootstrap = jest.fn().mockResolvedValue({
+                shareKey: {
+                    encrypted: "encrypted share key",
+                    decrypted: "decrypted share key",
+                },
+                rootNode: {
+                    key: {
+                        encrypted: "encrypted root key",
+                    },
+                }
+            });
+            apiService.createVolume = jest.fn().mockResolvedValue(myFilesShare);
+            const result = await manager.getMyFilesIDs();
+            expect(result).toStrictEqual(myFilesShare);
+            expect(cryptoService.decryptRootShare).not.toHaveBeenCalled();
+            expect(cryptoCache.setShareKey).toHaveBeenCalledWith("myFilesShareId", "decrypted share key");
+        });
+        it("should throw on unknown error", async () => {
+            apiService.getMyFiles = jest.fn().mockRejectedValue(new Error("Some error"));
+            await expect(manager.getMyFilesIDs()).rejects.toThrow("Some error");
+            expect(cryptoService.decryptRootShare).not.toHaveBeenCalled();
+            expect(apiService.createVolume).not.toHaveBeenCalled();
+        });
+    });
+    describe("getSharePrivateKey", () => {
+        it("should return cached private key", async () => {
+            cryptoCache.getShareKey = jest.fn().mockResolvedValue({ key: "cachedPrivateKey" });
+            const result = await manager.getSharePrivateKey("shareId");
+            expect(result).toBe("cachedPrivateKey");
+        });
+        it("should load private key if not in cache", async () => {
+            cryptoCache.getShareKey = jest.fn().mockRejectedValue(new Error('not found'));
+            apiService.getRootShare = jest.fn().mockResolvedValue({ shareId: "shareId" });
+            cryptoService.decryptRootShare = jest.fn().mockResolvedValue({ key: { key: "privateKey" } });
+            const result = await manager.getSharePrivateKey("shareId");
+            expect(result).toBe("privateKey");
+            expect(cryptoCache.setShareKey).toHaveBeenCalledWith("shareId", { key: "privateKey" });
+        });
+    });
+    describe("getMyFilesShareMemberEmailKey", () => {
+        it("should return cached volume email key", async () => {
+            jest.spyOn(manager, 'getMyFilesIDs').mockResolvedValue({ volumeId: "volumeId" });
+            cache.getVolume = jest.fn().mockResolvedValue({ addressId: "addressId" });
+            account.getOwnAddress = jest.fn().mockResolvedValue({ email: "email", primaryKeyIndex: 0, keys: [{ key: "addressKey" }] });
+            const result = await manager.getMyFilesShareMemberEmailKey();
+            expect(result).toEqual({
+                addressId: "addressId",
+                email: "email",
+                addressKey: "addressKey",
+            });
+        });
+        it("should load volume email key if not in cache", async () => {
+            jest.spyOn(manager, 'getMyFilesIDs').mockResolvedValue({ volumeId: "volumeId" });
+            const share = {
+                volumeId: "volumeId",
+                shareId: "shareId",
+                rootNodeId: "rootNodeId",
+                creatorEmail: "email",
+                addressId: "addressId",
+            };
+            cache.getVolume = jest.fn().mockRejectedValue(new Error('not found'));
+            apiService.getVolume = jest.fn().mockResolvedValue({ shareId: "shareId" });
+            apiService.getRootShare = jest.fn().mockResolvedValue(share);
+            account.getOwnAddress = jest.fn().mockResolvedValue({ email: "email", primaryKeyIndex: 0, keys: [{ key: "addressKey" }] });
+            const result = await manager.getMyFilesShareMemberEmailKey();
+            expect(result).toEqual({
+                addressId: "addressId",
+                email: "email",
+                addressKey: "addressKey",
+            });
+            expect(cache.setVolume).toHaveBeenCalledWith(share);
+        });
+    });
+    describe("getContextShareMemberEmailKey", () => {
+        it("should load share email key only once", async () => {
+            const share = {
+                volumeId: "volumeId",
+                shareId: "shareId",
+                rootNodeId: "rootNodeId",
+                creatorEmail: "creatorEmail",
+                addressId: "addressId",
+            };
+            apiService.getRootShare = jest.fn().mockResolvedValue(share);
+            account.getOwnAddress = jest.fn().mockResolvedValue({ email: "email", primaryKeyIndex: 0, keys: [{ key: "addressKey" }] });
+            const result = await manager.getContextShareMemberEmailKey("shareId");
+            expect(result).toEqual({
+                addressId: "addressId",
+                email: "email",
+                addressKey: "addressKey",
+            });
+            expect(apiService.getRootShare).toHaveBeenCalledTimes(1);
+            expect(account.getOwnAddress).toHaveBeenCalledTimes(1);
+            const result2 = await manager.getContextShareMemberEmailKey("shareId");
+            expect(result2).toEqual(result);
+            expect(apiService.getRootShare).toHaveBeenCalledTimes(1);
+            expect(account.getOwnAddress).toHaveBeenCalledTimes(2);
+        });
+    });
+});
+//# sourceMappingURL=manager.test.js.map

package/dist/internal/shares/manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.test.js","sourceRoot":"","sources":["../../../src/internal/shares/manager.test.ts"],"names":[],"mappings":";;AACA,+CAAmD;AACnD,8CAAiD;AAMjD,uCAA0C;AAE1C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,IAAI,UAA4B,CAAC;IACjC,IAAI,KAAkB,CAAC;IACvB,IAAI,WAA8B,CAAC;IACnC,IAAI,aAAkC,CAAC;IACvC,IAAI,OAA2B,CAAC;IAEhC,IAAI,OAAsB,CAAC;IAE3B,UAAU,CAAC,GAAG,EAAE;QACZ,gEAAgE;QAChE,UAAU,GAAG;YACT,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;YACnB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;YACpB,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE;SAC1B,CAAA;QACD,gEAAgE;QAChE,KAAK,GAAG;YACJ,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;YACpB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;SACvB,CAAA;QACD,gEAAgE;QAChE,WAAW,GAAG;YACV,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;YACtB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;SACzB,CAAA;QACD,gEAAgE;QAChE,aAAa,GAAG;YACZ,uBAAuB,EAAE,IAAI,CAAC,EAAE,EAAE;YAClC,gBAAgB,EAAE,IAAI,CAAC,EAAE,EAAE;SAC9B,CAAA;QACD,gEAAgE;QAChE,OAAO,GAAG;YACN,oBAAoB,EAAE,IAAI,CAAC,EAAE,EAAE;YAC/B,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;SAC3B,CAAA;QAED,OAAO,GAAG,IAAI,uBAAa,CAAC,IAAA,sBAAa,GAAE,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC3B,MAAM,YAAY,GAAG;YACjB,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,iBAAiB;YAC3B,UAAU,EAAE,mBAAmB;SAClC,CAAC;QAEF,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,cAAc,GAAG;gBACnB,KAAK,EAAE,YAAY;gBACnB,YAAY,EAAE,OAAO;aACxB,CAAC;YACF,MAAM,GAAG,GAAG;gBACR,GAAG,EAAE,YAAY;gBACjB,UAAU,EAAE,YAAY;aAC3B,CAAC;YAEF,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YACpE,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;YAE3F,gDAAgD;YAChD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAE7C,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAChE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAChF,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC;gBACzC,GAAG,YAAY;gBACf,YAAY,EAAE,cAAc,CAAC,YAAY;aAC5C,CAAC,CAAC;YACH,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACtE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,6BAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC;YACjG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;YAClH,aAAa,CAAC,uBAAuB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBAChE,QAAQ,EAAE;oBACN,SAAS,EAAE,qBAAqB;oBAChC,SAAS,EAAE,qBAAqB;iBACnC;gBACD,QAAQ,EAAE;oBACN,GAAG,EAAE;wBACD,SAAS,EAAE,oBAAoB;qBAClC;iBACJ;aACJ,CAAC,CAAC;YACH,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAEpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAE7C,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC9D,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC3C,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YAE7E,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACpE,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC9D,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC3D,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAC9C,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAEnF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACrD,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YAC9E,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9E,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YAE7F,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAClC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACnD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAwB,CAAC,CAAC;YACvG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1E,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;YAE3H,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,6BAA6B,EAAE,CAAC;YAE7D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACnB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,YAAY;aAC3B,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAwB,CAAC,CAAC;YACvG,MAAM,KAAK,GAAG;gBACV,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,YAAY;gBACxB,YAAY,EAAE,OAAO;gBACrB,SAAS,EAAE,WAAW;aACzB,CAAA;YACD,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YACtE,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3E,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC7D,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;YAE3H,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,6BAA6B,EAAE,CAAC;YAE7D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACnB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,YAAY;aAC3B,CAAC,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,KAAK,GAAG;gBACV,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,YAAY;gBACxB,YAAY,EAAE,cAAc;gBAC5B,SAAS,EAAE,WAAW;aACzB,CAAA;YACD,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC7D,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;YAE3H,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC;YAEtE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACnB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,YAAY;aAC3B,CAAC,CAAC;YACH,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAEvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC;YAEvE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/internal/sharing/apiService.d.ts

@@ -0,0 +1,80 @@
+import { SRPVerifier } from "../../crypto";
+import { MemberRole, Logger } from "../../interface";
+import { DriveAPIService } from "../apiService";
+import { EncryptedInvitationRequest, EncryptedInvitation, EncryptedInvitationWithNode, EncryptedExternalInvitation, EncryptedMember, EncryptedBookmark, EncryptedExternalInvitationRequest, EncryptedPublicLink, EncryptedPublicLinkCrypto } from "./interface";
+/**
+ * Provides API communication for fetching and managing sharing.
+ *
+ * The service is responsible for transforming local objects to API payloads
+ * and vice versa. It should not contain any business logic.
+ */
+export declare class SharingAPIService {
+    private logger;
+    private apiService;
+    constructor(logger: Logger, apiService: DriveAPIService);
+    iterateSharedNodeUids(volumeId: string, signal?: AbortSignal): AsyncGenerator<string>;
+    iterateSharedWithMeNodeUids(signal?: AbortSignal): AsyncGenerator<string>;
+    iterateInvitationUids(signal?: AbortSignal): AsyncGenerator<string>;
+    getInvitation(invitationUid: string): Promise<EncryptedInvitationWithNode>;
+    acceptInvitation(invitationUid: string, base64SessionKeySignature: string): Promise<void>;
+    rejectInvitation(invitationUid: string): Promise<void>;
+    iterateBookmarks(signal?: AbortSignal): AsyncGenerator<EncryptedBookmark>;
+    deleteBookmark(tokenId: string): Promise<void>;
+    getShareInvitations(shareId: string): Promise<EncryptedInvitation[]>;
+    getShareExternalInvitations(shareId: string): Promise<EncryptedExternalInvitation[]>;
+    getShareMembers(shareId: string): Promise<EncryptedMember[]>;
+    createStandardShare(nodeUid: string, addressId: string, shareKey: {
+        armoredKey: string;
+        armoredPassphrase: string;
+        armoredPassphraseSignature: string;
+    }, node: {
+        base64PassphraseKeyPacket: string;
+        base64NameKeyPacket: string;
+    }): Promise<string>;
+    deleteShare(shareId: string): Promise<void>;
+    inviteProtonUser(shareId: string, invitation: EncryptedInvitationRequest, emailDetails?: {
+        message?: string;
+        nodeName?: string;
+    }): Promise<EncryptedInvitation>;
+    updateInvitation(invitationUid: string, invitation: {
+        role: MemberRole;
+    }): Promise<void>;
+    resendInvitationEmail(invitationUid: string): Promise<void>;
+    deleteInvitation(invitationUid: string): Promise<void>;
+    inviteExternalUser(shareId: string, invitation: EncryptedExternalInvitationRequest, emailDetails?: {
+        message?: string;
+        nodeName?: string;
+    }): Promise<EncryptedExternalInvitation>;
+    updateExternalInvitation(invitationUid: string, invitation: {
+        role: MemberRole;
+    }): Promise<void>;
+    resendExternalInvitationEmail(invitationUid: string): Promise<void>;
+    deleteExternalInvitation(invitationUid: string): Promise<void>;
+    updateMember(memberUid: string, member: {
+        role: MemberRole;
+    }): Promise<void>;
+    removeMember(memberUid: string): Promise<void>;
+    getPublicLink(shareId: string): Promise<EncryptedPublicLink | undefined>;
+    createPublicLink(shareId: string, publicLink: {
+        creatorEmail: string;
+        role: MemberRole;
+        includesCustomPassword: boolean;
+        expirationDuration?: number;
+        crypto: EncryptedPublicLinkCrypto;
+        srp: SRPVerifier;
+    }): Promise<{
+        uid: string;
+        publicUrl: string;
+    }>;
+    updatePublicLink(publicLinkUid: string, publicLink: {
+        role: MemberRole;
+        includesCustomPassword: boolean;
+        expirationDuration?: number;
+        crypto: EncryptedPublicLinkCrypto;
+        srp: SRPVerifier;
+    }): Promise<void>;
+    private generatePublicLinkRequestPayload;
+    removePublicLink(publicLinkUid: string): Promise<void>;
+    private convertInternalInvitation;
+    private convertExternalInvitaiton;
+}