@protontech/drive-sdk 0.5.1 → 0.6.0

package/dist/protonDrivePhotosClient.js

@@ -36,16 +36,16 @@ class ProtonDrivePhotosClient {
         if (!telemetry) {
             telemetry = new telemetry_1.Telemetry();
         }
-        this.logger = telemetry.getLogger('interface');
+        this.logger = telemetry.getLogger('photos-interface');
         const fullConfig = (0, config_1.getConfig)(config);
         this.sdkEvents = new sdkEvents_1.SDKEvents(telemetry);
         const cryptoModule = new crypto_1.DriveCrypto(openPGPCryptoModule, srpModule);
         const apiService = new apiService_1.DriveAPIService(telemetry, this.sdkEvents, httpClient, fullConfig.baseUrl, fullConfig.language);
         const coreShares = (0, shares_1.initSharesModule)(telemetry, apiService, entitiesCache, cryptoCache, account, cryptoModule);
         this.photoShares = (0, photos_1.initPhotoSharesModule)(telemetry, apiService, entitiesCache, cryptoCache, account, cryptoModule, coreShares);
-        this.nodes = (0, nodes_1.initNodesModule)(telemetry, apiService, entitiesCache, cryptoCache, account, cryptoModule, this.photoShares);
+        this.nodes = (0, nodes_1.initNodesModule)(telemetry, apiService, entitiesCache, cryptoCache, account, cryptoModule, this.photoShares, fullConfig.clientUid);
         this.photos = (0, photos_1.initPhotosModule)(apiService, this.photoShares, this.nodes.access);
-        this.sharing = (0, sharing_1.initSharingModule)(telemetry, apiService, entitiesCache, account, cryptoModule, this.photoShares, this.nodes.access);
+        this.sharing = (0, sharing_1.initSharingModule)(telemetry, apiService, entitiesCache, account, cryptoModule, this.photoShares, this.nodes.access, photos_1.PHOTOS_SHARE_TARGET_TYPES);
         this.download = (0, download_1.initDownloadModule)(telemetry, apiService, cryptoModule, account, this.photoShares, this.nodes.access, this.nodes.revisions);
         this.upload = (0, photos_1.initPhotoUploadModule)(telemetry, apiService, cryptoModule, this.photoShares, this.nodes.access, fullConfig.clientUid);
         // These are used to keep the internal cache up to date
@@ -105,6 +105,15 @@ class ProtonDrivePhotosClient {
         // TODO: expose better type
         yield* this.photos.timeline.iterateTimeline(signal);
     }
+    /**
+     * Iterates the trashed nodes.
+     *
+     * See `ProtonDriveClient.iterateTrashedNodes` for more information.
+     */
+    async *iterateTrashedNodes(signal) {
+        this.logger.info('Iterating trashed nodes');
+        yield* (0, transformers_1.convertInternalNodeIterator)(this.nodes.access.iterateTrashedNodes(signal));
+    }
     /**
      * Iterates the nodes by their UIDs.
      *
@@ -125,14 +134,146 @@ class ProtonDrivePhotosClient {
         return (0, transformers_1.convertInternalNodePromise)(this.nodes.access.getNode((0, transformers_1.getUid)(nodeUid)));
     }
     /**
-     * Iterates the albums.
+     * Rename the node.
      *
-     * The output is not sorted and the order of the nodes is not guaranteed.
+     * See `ProtonDriveClient.renameNode` for more information.
      */
-    async *iterateAlbums(signal) {
-        this.logger.info('Iterating albums');
-        // TODO: expose album type
-        yield* (0, transformers_1.convertInternalNodeIterator)(this.photos.albums.iterateAlbums(signal));
+    async renameNode(nodeUid, newName) {
+        this.logger.info(`Renaming node ${(0, transformers_1.getUid)(nodeUid)}`);
+        return (0, transformers_1.convertInternalNodePromise)(this.nodes.management.renameNode((0, transformers_1.getUid)(nodeUid), newName));
+    }
+    /**
+     * Trash the nodes.
+     *
+     * See `ProtonDriveClient.trashNodes` for more information.
+     */
+    async *trashNodes(nodeUids, signal) {
+        this.logger.info(`Trashing ${nodeUids.length} nodes`);
+        yield* this.nodes.management.trashNodes((0, transformers_1.getUids)(nodeUids), signal);
+    }
+    /**
+     * Restore the nodes from the trash to their original place.
+     *
+     * See `ProtonDriveClient.restoreNodes` for more information.
+     */
+    async *restoreNodes(nodeUids, signal) {
+        this.logger.info(`Restoring ${nodeUids.length} nodes`);
+        yield* this.nodes.management.restoreNodes((0, transformers_1.getUids)(nodeUids), signal);
+    }
+    /**
+     * Delete the nodes permanently.
+     *
+     * See `ProtonDriveClient.deleteNodes` for more information.
+     */
+    async *deleteNodes(nodeUids, signal) {
+        this.logger.info(`Deleting ${nodeUids.length} nodes`);
+        yield* this.nodes.management.deleteNodes((0, transformers_1.getUids)(nodeUids), signal);
+    }
+    /**
+     * Empty the trash.
+     *
+     * See `ProtonDriveClient.emptyTrash` for more information.
+     */
+    async emptyTrash() {
+        this.logger.info('Emptying trash');
+        throw new Error('Method not implemented');
+    }
+    /**
+     * Iterates the nodes shared by the user.
+     *
+     * See `ProtonDriveClient.iterateSharedNodes` for more information.
+     */
+    async *iterateSharedNodes(signal) {
+        this.logger.info('Iterating shared nodes by me');
+        yield* (0, transformers_1.convertInternalNodeIterator)(this.sharing.access.iterateSharedNodes(signal));
+    }
+    /**
+     * Iterates the nodes shared with the user.
+     *
+     * See `ProtonDriveClient.iterateSharedNodesWithMe` for more information.
+     */
+    async *iterateSharedNodesWithMe(signal) {
+        this.logger.info('Iterating shared nodes with me');
+        for await (const node of this.sharing.access.iterateSharedNodesWithMe(signal)) {
+            yield (0, transformers_1.convertInternalNode)(node);
+        }
+    }
+    /**
+     * Leave shared node that was previously shared with the user.
+     *
+     * See `ProtonDriveClient.leaveSharedNode` for more information.
+     */
+    async leaveSharedNode(nodeUid) {
+        this.logger.info(`Leaving shared node with me ${(0, transformers_1.getUid)(nodeUid)}`);
+        await this.sharing.access.removeSharedNodeWithMe((0, transformers_1.getUid)(nodeUid));
+    }
+    /**
+     * Iterates the invitations to shared nodes.
+     *
+     * See `ProtonDriveClient.iterateInvitations` for more information.
+     */
+    async *iterateInvitations(signal) {
+        this.logger.info('Iterating invitations');
+        yield* this.sharing.access.iterateInvitations(signal);
+    }
+    /**
+     * Accept the invitation to the shared node.
+     *
+     * See `ProtonDriveClient.acceptInvitation` for more information.
+     */
+    async acceptInvitation(invitationUid) {
+        this.logger.info(`Accepting invitation ${(0, transformers_1.getUid)(invitationUid)}`);
+        await this.sharing.access.acceptInvitation((0, transformers_1.getUid)(invitationUid));
+    }
+    /**
+     * Reject the invitation to the shared node.
+     *
+     * See `ProtonDriveClient.rejectInvitation` for more information.
+     */
+    async rejectInvitation(invitationUid) {
+        this.logger.info(`Rejecting invitation ${(0, transformers_1.getUid)(invitationUid)}`);
+        await this.sharing.access.rejectInvitation((0, transformers_1.getUid)(invitationUid));
+    }
+    /**
+     * Get sharing info of the node.
+     *
+     * See `ProtonDriveClient.getSharingInfo` for more information.
+     */
+    async getSharingInfo(nodeUid) {
+        this.logger.info(`Getting sharing info for ${(0, transformers_1.getUid)(nodeUid)}`);
+        return this.sharing.management.getSharingInfo((0, transformers_1.getUid)(nodeUid));
+    }
+    /**
+     * Share or update sharing of the node.
+     *
+     * See `ProtonDriveClient.shareNode` for more information.
+     */
+    async shareNode(nodeUid, settings) {
+        this.logger.info(`Sharing node ${(0, transformers_1.getUid)(nodeUid)}`);
+        return this.sharing.management.shareNode((0, transformers_1.getUid)(nodeUid), settings);
+    }
+    /**
+     * Unshare the node, completely or partially.
+     *
+     * See `ProtonDriveClient.unshareNode` for more information.
+     */
+    async unshareNode(nodeUid, settings) {
+        if (!settings) {
+            this.logger.info(`Unsharing node ${(0, transformers_1.getUid)(nodeUid)}`);
+        }
+        else {
+            this.logger.info(`Partially unsharing ${(0, transformers_1.getUid)(nodeUid)}`);
+        }
+        return this.sharing.management.unshareNode((0, transformers_1.getUid)(nodeUid), settings);
+    }
+    /**
+     * Resend the invitation email to shared node.
+     *
+     * See `ProtonDriveClient.resendInvitation` for more information.
+     */
+    async resendInvitation(nodeUid, invitationUid) {
+        this.logger.info(`Resending invitation ${(0, transformers_1.getUid)(invitationUid)}`);
+        return this.sharing.management.resendInvitationEmail((0, transformers_1.getUid)(nodeUid), (0, transformers_1.getUid)(invitationUid));
     }
     /**
      * Get the file downloader to download the node content.
@@ -162,6 +303,16 @@ class ProtonDrivePhotosClient {
         const parentFolderUid = await this.nodes.access.getVolumeRootFolder();
         return this.upload.getFileUploader((0, transformers_1.getUid)(parentFolderUid), name, metadata, signal);
     }
+    /**
+     * Iterates the albums.
+     *
+     * The output is not sorted and the order of the nodes is not guaranteed.
+     */
+    async *iterateAlbums(signal) {
+        this.logger.info('Iterating albums');
+        // TODO: expose album type
+        yield* (0, transformers_1.convertInternalNodeIterator)(this.photos.albums.iterateAlbums(signal));
+    }
 }
 exports.ProtonDrivePhotosClient = ProtonDrivePhotosClient;
 //# sourceMappingURL=protonDrivePhotosClient.js.map

package/dist/protonDrivePhotosClient.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@protontech/drive-sdk",
-    "version": "0.5.1",
+    "version": "0.6.0",
     "description": "Proton Drive SDK",
     "license": "GPL-3.0",
     "main": "dist/index.js",

package/src/interface/index.ts

@@ -82,7 +82,7 @@ export type {
     MetricEvent,
 } from './telemetry';
 export { MetricVolumeType } from './telemetry';
-export type { FileUploader, FileRevisionUploader, UploadController, UploadMetadata } from './upload';
+export type { FileUploader, UploadController, UploadMetadata } from './upload';
 export type { Thumbnail, ThumbnailResult } from './thumbnail';
 export { ThumbnailType } from './thumbnail';
 

package/src/interface/upload.ts

@@ -32,7 +32,7 @@ export type UploadMetadata = {
     overrideExistingDraftByOtherClient?: boolean;
 };
 
-export interface FileRevisionUploader {
+export interface FileUploader {
     /**
      * Uploads a file from a stream.
      *
@@ -64,18 +64,6 @@ export interface FileRevisionUploader {
     ): Promise<UploadController>;
 }
 
-export interface FileUploader extends FileRevisionUploader {
-    /**
-     * Returns the available name for the file.
-     *
-     * The function will return a name that includes the original name with the
-     * available index. The name is guaranteed to be unique in the parent folder.
-     *
-     * Example new name: `file (2).txt`.
-     */
-    getAvailableName(): Promise<string>;
-}
-
 export interface UploadController {
     pause(): void;
     resume(): void;

package/src/internal/nodes/apiService.test.ts

@@ -173,7 +173,7 @@ describe('nodeAPIService', () => {
             put: jest.fn(),
         };
 
-        api = new NodeAPIService(getMockLogger(), apiMock);
+        api = new NodeAPIService(getMockLogger(), apiMock, 'clientUid');
     });
 
     describe('getNode', () => {

package/src/internal/nodes/apiService.ts

@@ -102,6 +102,14 @@ type PostRestoreRevisionResponse =
 type DeleteRevisionResponse =
     drivePaths['/drive/v2/volumes/{volumeID}/files/{linkID}/revisions/{revisionID}']['delete']['responses']['200']['content']['application/json'];
 
+
+type PostCheckAvailableHashesRequest = Extract<
+    drivePaths['/drive/v2/volumes/{volumeID}/links/{linkID}/checkAvailableHashes']['post']['requestBody'],
+    { content: object }
+>['content']['application/json'];
+type PostCheckAvailableHashesResponse =
+    drivePaths['/drive/v2/volumes/{volumeID}/links/{linkID}/checkAvailableHashes']['post']['responses']['200']['content']['application/json'];
+
 /**
  * Provides API communication for fetching and manipulating nodes metadata.
  *
@@ -112,9 +120,11 @@ export class NodeAPIService {
     constructor(
         private logger: Logger,
         private apiService: DriveAPIService,
+        private clientUid: string | undefined,
     ) {
         this.logger = logger;
         this.apiService = apiService;
+        this.clientUid = clientUid;
     }
 
     async getNode(nodeUid: string, ownVolumeId: string, signal?: AbortSignal): Promise<EncryptedNode> {
@@ -526,6 +536,38 @@ export class NodeAPIService {
             `drive/v2/volumes/${volumeId}/files/${nodeId}/revisions/${revisionId}`,
         );
     }
+
+    async checkAvailableHashes(
+        parentNodeUid: string,
+        hashes: string[],
+    ): Promise<{
+        availableHashes: string[];
+        pendingHashes: {
+            hash: string;
+            nodeUid: string;
+            revisionUid: string;
+            clientUid?: string;
+        }[];
+    }> {
+        const { volumeId, nodeId: parentNodeId } = splitNodeUid(parentNodeUid);
+        const result = await this.apiService.post<PostCheckAvailableHashesRequest, PostCheckAvailableHashesResponse>(
+            `drive/v2/volumes/${volumeId}/links/${parentNodeId}/checkAvailableHashes`,
+            {
+                Hashes: hashes,
+                ClientUID: this.clientUid ? [this.clientUid] : null,
+            },
+        );
+
+        return {
+            availableHashes: result.AvailableHashes,
+            pendingHashes: result.PendingHashes.map((hash) => ({
+                hash: hash.Hash,
+                nodeUid: makeNodeUid(volumeId, hash.LinkID),
+                revisionUid: makeNodeRevisionUid(volumeId, hash.LinkID, hash.RevisionID),
+                clientUid: hash.ClientUID || undefined,
+            })),
+        };
+    }
 }
 
 type LinkResponse = {

package/src/internal/nodes/cryptoService.ts

@@ -645,6 +645,15 @@ export class NodesCryptoService {
             nameSignatureEmail: email,
         };
     }
+
+    async generateNameHashes(parentHashKey: Uint8Array, names: string[]): Promise<{ name: string; hash: string }[]> {
+        return Promise.all(
+            names.map(async (name) => ({
+                name,
+                hash: await this.driveCrypto.generateLookupHash(name, parentHashKey),
+            })),
+        );
+    }
 }
 
 function getClaimedAuthor(

package/src/internal/nodes/index.test.ts

@@ -64,6 +64,7 @@ describe('nodesModules integration tests', () => {
             account,
             driveCrypto,
             sharesService,
+            'clientUid',
         );
 
         nodesCache = new NodesCache(getMockLogger(), driveEntitiesCache);

package/src/internal/nodes/index.ts

@@ -37,8 +37,9 @@ export function initNodesModule(
     account: ProtonDriveAccount,
     driveCrypto: DriveCrypto,
     sharesService: SharesService,
+    clientUid: string | undefined,
 ) {
-    const api = new NodeAPIService(telemetry.getLogger('nodes-api'), apiService);
+    const api = new NodeAPIService(telemetry.getLogger('nodes-api'), apiService, clientUid);
     const cache = new NodesCache(telemetry.getLogger('nodes-cache'), driveEntitiesCache);
     const cryptoCache = new NodesCryptoCache(telemetry.getLogger('nodes-cache'), driveCryptoCache);
     const cryptoReporter = new NodesCryptoReporter(telemetry, sharesService);

package/src/internal/nodes/nodeName.test.ts

@@ -0,0 +1,57 @@
+import { splitExtension, joinNameAndExtension } from './nodeName';
+
+describe('nodeName', () => {
+    describe('splitExtension', () => {
+        it('should handle empty string', () => {
+            const result = splitExtension('');
+            expect(result).toEqual(['', '']);
+        });
+
+        it('should split filename with extension correctly', () => {
+            const result = splitExtension('document.pdf');
+            expect(result).toEqual(['document', 'pdf']);
+        });
+
+        it('should handle filename without extension', () => {
+            const result = splitExtension('folder');
+            expect(result).toEqual(['folder', '']);
+        });
+
+        it('should split filename with multiple dots correctly', () => {
+            const result = splitExtension('my.file.name.txt');
+            expect(result).toEqual(['my.file.name', 'txt']);
+        });
+
+        it('should handle filename ending with dot', () => {
+            const result = splitExtension('dot.');
+            expect(result).toEqual(['dot.', '']);
+        });
+
+        it('should handle filename with only extension', () => {
+            const result = splitExtension('.gitignore');
+            expect(result).toEqual(['.gitignore', '']);
+        });
+    });
+
+    describe('joinNameAndExtension', () => {
+        it('should join name, index, and extension correctly', () => {
+            const result = joinNameAndExtension('document', 1, 'pdf');
+            expect(result).toBe('document (1).pdf');
+        });
+
+        it('should handle empty name with extension', () => {
+            const result = joinNameAndExtension('', 2, 'txt');
+            expect(result).toBe('(2).txt');
+        });
+
+        it('should handle name with empty extension', () => {
+            const result = joinNameAndExtension('document', 3, '');
+            expect(result).toBe('document (3)');
+        });
+
+        it('should handle both name and extension empty', () => {
+            const result = joinNameAndExtension('', 4, '');
+            expect(result).toBe('(4)');
+        });
+    });
+});

package/src/internal/nodes/nodeName.ts

@@ -0,0 +1,26 @@
+/**
+ * Split a filename into `[name, extension]`
+ */
+export function splitExtension(filename = ''): [string, string] {
+    const endIdx = filename.lastIndexOf('.');
+    if (endIdx === -1 || endIdx === 0 || endIdx === filename.length - 1) {
+        return [filename, ''];
+    }
+    return [filename.slice(0, endIdx), filename.slice(endIdx + 1)];
+}
+
+/**
+ * Join a filename into `name (index).extension`
+ */
+export function joinNameAndExtension(name: string, index: number, extension: string): string {
+    if (!name && !extension) {
+        return `(${index})`;
+    }
+    if (!name) {
+        return `(${index}).${extension}`;
+    }
+    if (!extension) {
+        return `${name} (${index})`;
+    }
+    return `${name} (${index}).${extension}`;
+}

package/src/internal/nodes/nodesManagement.test.ts

@@ -61,6 +61,10 @@ describe('NodesManagement', () => {
                 yield* uids.map((uid) => ({ ok: true, uid }) as NodeResult);
             }),
             createFolder: jest.fn(),
+            checkAvailableHashes: jest.fn().mockResolvedValue({
+                availableHashes: ['name1Hash'],
+                pendingHashes: [],
+            }),
         };
         // @ts-expect-error No need to implement all methods for mocking
         cryptoCache = {
@@ -75,6 +79,20 @@ describe('NodesManagement', () => {
             }),
             encryptNodeWithNewParent: jest.fn(),
             createFolder: jest.fn(),
+            generateNameHashes: jest.fn().mockResolvedValue([
+                {
+                    name: 'name1',
+                    hash: 'name1Hash',
+                },
+                {
+                    name: 'name2',
+                    hash: 'name2Hash',
+                },
+                {
+                    name: 'name3',
+                    hash: 'name3Hash',
+                },
+            ]),
         };
         // @ts-expect-error No need to implement all methods for mocking
         nodesAccess = {
@@ -340,4 +358,51 @@ describe('NodesManagement', () => {
         expect(restored).toEqual(new Set(uids));
         expect(nodesAccess.notifyNodeChanged).toHaveBeenCalledTimes(2);
     });
+
+    describe('findAvailableName', () => {
+        it('should find available name', async () => {
+            apiService.checkAvailableHashes = jest.fn().mockImplementation(() => {
+                return {
+                    availableHashes: ['name3Hash'],
+                    pendingHashes: [],
+                };
+            });
+
+            const result = await management.findAvailableName('parentUid', 'name');
+            expect(result).toBe('name3');
+            expect(apiService.checkAvailableHashes).toHaveBeenCalledTimes(1);
+            expect(apiService.checkAvailableHashes).toHaveBeenCalledWith('parentUid', [
+                'name1Hash',
+                'name2Hash',
+                'name3Hash',
+            ]);
+        });
+
+        it('should find available name with multiple pages', async () => {
+            let firstCall = false;
+            apiService.checkAvailableHashes = jest.fn().mockImplementation(() => {
+                if (!firstCall) {
+                    firstCall = true;
+                    return {
+                        // First page has no available hashes
+                        availableHashes: [],
+                        pendingHashes: [],
+                    };
+                }
+                return {
+                    availableHashes: ['name3Hash'],
+                    pendingHashes: [],
+                };
+            });
+
+            const result = await management.findAvailableName('parentUid', 'name');
+            expect(result).toBe('name3');
+            expect(apiService.checkAvailableHashes).toHaveBeenCalledTimes(2);
+            expect(apiService.checkAvailableHashes).toHaveBeenCalledWith('parentUid', [
+                'name1Hash',
+                'name2Hash',
+                'name3Hash',
+            ]);
+        });
+    });
 });

package/src/internal/nodes/nodesManagement.ts

@@ -8,10 +8,14 @@ import { NodeAPIService } from './apiService';
 import { NodesCryptoCache } from './cryptoCache';
 import { NodesCryptoService } from './cryptoService';
 import { NodeOutOfSyncError } from './errors';
+import { generateFolderExtendedAttributes } from './extendedAttributes';
 import { DecryptedNode } from './interface';
+import { splitExtension, joinNameAndExtension } from './nodeName';
 import { NodesAccess } from './nodesAccess';
 import { validateNodeName } from './validations';
-import { generateFolderExtendedAttributes } from './extendedAttributes';
+
+const AVAILABLE_NAME_BATCH_SIZE = 10;
+const AVAILABLE_NAME_LIMIT = 1000;
 
 /**
  * Provides high-level actions for managing nodes.
@@ -349,4 +353,42 @@ export class NodesManagement {
         await this.cryptoCache.setNodeKeys(nodeUid, keys);
         return node;
     }
+
+    async findAvailableName(parentFolderUid: string, name: string): Promise<string> {
+        const { hashKey: parentHashKey } = await this.nodesAccess.getNodeKeys(parentFolderUid);
+        if (!parentHashKey) {
+            throw new ValidationError(c('Error').t`Creating files in non-folders is not allowed`);
+        }
+
+        const [namePart, extension] = splitExtension(name);
+
+        let startIndex = 1;
+        while (startIndex < AVAILABLE_NAME_LIMIT) {
+            const namesToCheck = startIndex === 1 ? [name] : [];
+            for (let i = startIndex; i < startIndex + AVAILABLE_NAME_BATCH_SIZE; i++) {
+                namesToCheck.push(joinNameAndExtension(namePart, i, extension));
+            }
+
+            const hashesToCheck = await this.cryptoService.generateNameHashes(parentHashKey, namesToCheck);
+
+            const { availableHashes } = await this.apiService.checkAvailableHashes(
+                parentFolderUid,
+                hashesToCheck.map(({ hash }) => hash),
+            );
+
+            if (!availableHashes.length) {
+                startIndex += AVAILABLE_NAME_BATCH_SIZE;
+                continue;
+            }
+
+            const availableHash = hashesToCheck.find(({ hash }) => hash === availableHashes[0]);
+            if (!availableHash) {
+                throw Error('Backend returned unexpected hash');
+            }
+
+            return availableHash.name;
+        }
+
+        throw new ValidationError(c('Error').t`No available name found`);
+    }
 }

package/src/internal/photos/index.ts

@@ -24,6 +24,10 @@ import {
     PhotoUploadManager,
     PhotoUploadMetadata,
 } from './upload';
+import { ShareTargetType } from '../shares';
+
+// Only photos and albums can be shared in photos volume.
+export const PHOTOS_SHARE_TARGET_TYPES = [ShareTargetType.Photo, ShareTargetType.Album];
 
 /**
  * Provides facade for the whole photos module.

package/src/internal/shares/index.ts

@@ -12,6 +12,7 @@ import { SharesCache } from './cache';
 import { SharesCryptoService } from './cryptoService';
 import { SharesManager } from './manager';
 
+export { ShareTargetType } from './interface';
 export type { EncryptedShare } from './interface';
 
 /**

package/src/internal/shares/interface.ts

@@ -1,6 +1,15 @@
 import { PrivateKey, SessionKey } from '../../crypto';
 import { Result, UnverifiedAuthorError } from '../../interface';
 
+export enum ShareTargetType {
+    Root = 0,
+    Folder = 1,
+    File = 2,
+    Album = 3,
+    Photo = 4,
+    ProtonVendor = 5,
+}
+
 /**
  * Internal interface providing basic identification of volume and its root
  * share and node.