@protontech/drive-sdk 0.9.8 → 0.10.0

package/dist/transformers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@protontech/drive-sdk",
-    "version": "0.9.8",
+    "version": "0.10.0",
     "description": "Proton Drive SDK",
     "license": "GPL-3.0",
     "main": "dist/index.js",
@@ -34,7 +34,7 @@
         "@swc/jest": "^0.2.38",
         "@types/jest": "^29.5.14",
         "@types/mocha": "^10.0.10",
-        "@typescript-eslint/eslint-plugin": "^8.19.1",
+        "@typescript-eslint/eslint-plugin": "^8.53.1",
         "@web/dev-server-esbuild": "^1.0.3",
         "eslint": "^8.57.1",
         "eslint-plugin-tsdoc": "^0.3.0",
@@ -43,7 +43,7 @@
         "openapi-typescript": "^7.4.1",
         "prettier": "^3.6.2",
         "ttag-cli": "^1.10.18",
-        "typedoc": "^0.26.11",
-        "typescript": "^5.6.3"
+        "typedoc": "^0.28.16",
+        "typescript": "^5.9.3"
     }
 }

package/src/crypto/driveCrypto.ts

@@ -343,7 +343,7 @@ export class DriveCrypto {
      * It encrypts and armors signature with provided session and encryption keys.
      */
     async encryptSignature(
-        signature: Uint8Array,
+        signature: Uint8Array<ArrayBuffer>,
         encryptionKey: PrivateKey,
         sessionKey: SessionKey,
     ): Promise<{
@@ -365,7 +365,7 @@ export class DriveCrypto {
      */
     async generateHashKey(encryptionAndSigningKey: PrivateKey): Promise<{
         armoredHashKey: string;
-        hashKey: Uint8Array;
+        hashKey: Uint8Array<ArrayBuffer>;
     }> {
         // Once all clients can use non-ascii bytes, switch to simple
         // generating of random bytes without encoding it into base64:
@@ -385,7 +385,7 @@ export class DriveCrypto {
         };
     }
 
-    async generateLookupHash(newName: string, parentHashKey: Uint8Array): Promise<string> {
+    async generateLookupHash(newName: string, parentHashKey: Uint8Array<ArrayBuffer>): Promise<string> {
         const key = await importHmacKey(parentHashKey);
 
         const signature = await computeHmacSignature(key, new TextEncoder().encode(newName));
@@ -461,7 +461,7 @@ export class DriveCrypto {
         decryptionAndVerificationKey: PrivateKey,
         extraVerificationKeys: PublicKey[],
     ): Promise<{
-        hashKey: Uint8Array;
+        hashKey: Uint8Array<ArrayBuffer>;
         verified: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }> {
@@ -611,11 +611,11 @@ export class DriveCrypto {
     }
 
     async encryptThumbnailBlock(
-        thumbnailData: Uint8Array,
+        thumbnailData: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         signingKey: PrivateKey,
     ): Promise<{
-        encryptedData: Uint8Array;
+        encryptedData: Uint8Array<ArrayBuffer>;
     }> {
         const { encryptedData } = await this.openPGPCrypto.encryptAndSign(
             thumbnailData,
@@ -630,11 +630,11 @@ export class DriveCrypto {
     }
 
     async decryptThumbnailBlock(
-        encryptedThumbnail: Uint8Array,
+        encryptedThumbnail: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         verificationKeys: PublicKey[],
     ): Promise<{
-        decryptedThumbnail: Uint8Array;
+        decryptedThumbnail: Uint8Array<ArrayBuffer>;
         verified: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }> {
@@ -651,12 +651,12 @@ export class DriveCrypto {
     }
 
     async encryptBlock(
-        blockData: Uint8Array,
+        blockData: Uint8Array<ArrayBuffer>,
         encryptionKey: PrivateKey,
         sessionKey: SessionKey,
         signingKey: PrivateKey,
     ): Promise<{
-        encryptedData: Uint8Array;
+        encryptedData: Uint8Array<ArrayBuffer>;
         armoredSignature: string;
     }> {
         const { encryptedData, signature } = await this.openPGPCrypto.encryptAndSignDetached(
@@ -674,14 +674,14 @@ export class DriveCrypto {
         };
     }
 
-    async decryptBlock(encryptedBlock: Uint8Array, sessionKey: SessionKey): Promise<Uint8Array> {
+    async decryptBlock(encryptedBlock: Uint8Array<ArrayBuffer>, sessionKey: SessionKey): Promise<Uint8Array<ArrayBuffer>> {
         const { data: decryptedBlock } = await this.openPGPCrypto.decryptAndVerify(encryptedBlock, sessionKey, []);
 
         return decryptedBlock;
     }
 
     async signManifest(
-        manifest: Uint8Array,
+        manifest: Uint8Array<ArrayBuffer>,
         signingKey: PrivateKey,
     ): Promise<{
         armoredManifestSignature: string;
@@ -693,7 +693,7 @@ export class DriveCrypto {
     }
 
     async verifyManifest(
-        manifest: Uint8Array,
+        manifest: Uint8Array<ArrayBuffer>,
         armoredSignature: string,
         verificationKeys: PublicKey | PublicKey[],
     ): Promise<{
@@ -727,7 +727,7 @@ export class DriveCrypto {
     }
 }
 
-export function uint8ArrayToUtf8(input: Uint8Array): string {
+export function uint8ArrayToUtf8(input: Uint8Array<ArrayBuffer>): string {
     return new TextDecoder('utf-8', { fatal: true }).decode(input);
 }
 
@@ -736,7 +736,7 @@ export function uint8ArrayToUtf8(input: Uint8Array): string {
  * @param bytes - Array of 8-bit integers to convert
  * @returns Hexadecimal representation of the array
  */
-export const arrayToHexString = (bytes: Uint8Array) => {
+export const arrayToHexString = (bytes: Uint8Array<ArrayBuffer>) => {
     const hexAlphabet = '0123456789abcdef';
     let s = '';
     bytes.forEach((v) => {

package/src/crypto/hmac.ts

@@ -8,7 +8,7 @@ type HmacKeyUsage = 'sign' | 'verify';
  * Import an HMAC-SHA256 key in order to use it with `signData` and `verifyData`.
  */
 export const importHmacKey = async (
-    key: Uint8Array,
+    key: Uint8Array<ArrayBuffer>,
     keyUsage: HmacKeyUsage[] = ['sign', 'verify'],
 ): Promise<HmacCryptoKey> => {
     // From https://datatracker.ietf.org/doc/html/rfc2104:
@@ -29,9 +29,9 @@ export const importHmacKey = async (
  * @param data - data to sign
  * @param additionalData - additional data to authenticate
  */
-export const computeHmacSignature = async (key: HmacCryptoKey, data: Uint8Array) => {
+export const computeHmacSignature = async (key: HmacCryptoKey, data: Uint8Array<ArrayBuffer>) => {
     const signatureBuffer = await crypto.subtle.sign({ name: 'HMAC', hash: HASH_ALGORITHM }, key, data);
-    return new Uint8Array(signatureBuffer);
+    return new Uint8Array<ArrayBuffer>(signatureBuffer);
 };
 
 /**
@@ -41,6 +41,6 @@ export const computeHmacSignature = async (key: HmacCryptoKey, data: Uint8Array)
  * @param data - data to verify
  * @param additionalData - additional data to authenticate
  */
-export const verifyData = async (key: HmacCryptoKey, signature: Uint8Array, data: Uint8Array) => {
+export const verifyData = async (key: HmacCryptoKey, signature: Uint8Array<ArrayBuffer>, data: Uint8Array<ArrayBuffer>) => {
     return crypto.subtle.verify({ name: 'HMAC', hash: HASH_ALGORITHM }, key, signature, data);
 };

package/src/crypto/interface.ts

@@ -2,6 +2,35 @@
 export interface PublicKey {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     readonly _idx: any;
+        readonly _keyContentHash: [string, string];
+
+    getVersion(): number;
+    getFingerprint(): string;
+    getSHA256Fingerprints(): string[];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getKeyID(): any;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getKeyIDs(): any[];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getAlgorithmInfo(): any;
+    getCreationTime(): Date;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isPrivate: any;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isPrivateKeyV4: any;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isPrivateKeyV6: any;
+    getExpirationTime(): Date | number | null;
+    getUserIDs(): string[];
+    isWeak(): boolean;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    equals(otherKey: any, ignoreOtherCerts?: boolean): boolean;
+    subkeys: {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        getAlgorithmInfo(): any;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        getKeyID(): any;
+    }[];
 }
 
 export interface PrivateKey extends PublicKey {
@@ -9,7 +38,9 @@ export interface PrivateKey extends PublicKey {
 }
 
 export interface SessionKey {
-    data: Uint8Array;
+    data: Uint8Array<ArrayBuffer>;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    algorithm: any;
 }
 
 export enum VERIFICATION_STATUS {
@@ -66,14 +97,14 @@ export interface OpenPGPCrypto {
         sessionKey: SessionKey,
         encryptionKeys: PublicKey | PublicKey[],
     ) => Promise<{
-        keyPacket: Uint8Array;
+        keyPacket: Uint8Array<ArrayBuffer>;
     }>;
 
     encryptSessionKeyWithPassword: (
         sessionKey: SessionKey,
         password: string,
     ) => Promise<{
-        keyPacket: Uint8Array;
+        keyPacket: Uint8Array<ArrayBuffer>;
     }>;
 
     /**
@@ -87,7 +118,7 @@ export interface OpenPGPCrypto {
     }>;
 
     encryptArmored: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         encryptionKeys: PublicKey[],
         sessionKey?: SessionKey,
     ) => Promise<{
@@ -95,16 +126,16 @@ export interface OpenPGPCrypto {
     }>;
 
     encryptAndSign: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
     ) => Promise<{
-        encryptedData: Uint8Array;
+        encryptedData: Uint8Array<ArrayBuffer>;
     }>;
 
     encryptAndSignArmored: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey | undefined,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
@@ -114,17 +145,17 @@ export interface OpenPGPCrypto {
     }>;
 
     encryptAndSignDetached: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
     ) => Promise<{
-        encryptedData: Uint8Array;
-        signature: Uint8Array;
+        encryptedData: Uint8Array<ArrayBuffer>;
+        signature: Uint8Array<ArrayBuffer>;
     }>;
 
     encryptAndSignDetachedArmored: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
@@ -134,23 +165,23 @@ export interface OpenPGPCrypto {
     }>;
 
     sign: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         signingKey: PrivateKey,
         signatureContext: string,
     ) => Promise<{
-        signature: Uint8Array;
+        signature: Uint8Array<ArrayBuffer>;
     }>;
 
     signArmored: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         signingKey: PrivateKey | PrivateKey[],
     ) => Promise<{
         signature: string;
     }>;
 
     verify: (
-        data: Uint8Array,
-        signature: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
+        signature: Uint8Array<ArrayBuffer>,
         verificationKeys: PublicKey | PublicKey[],
     ) => Promise<{
         verified: VERIFICATION_STATUS;
@@ -158,7 +189,7 @@ export interface OpenPGPCrypto {
     }>;
 
     verifyArmored: (
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         armoredSignature: string,
         verificationKeys: PublicKey | PublicKey[],
         signatureContext?: string,
@@ -167,41 +198,41 @@ export interface OpenPGPCrypto {
         verificationErrors?: Error[];
     }>;
 
-    decryptSessionKey: (data: Uint8Array, decryptionKeys: PrivateKey | PrivateKey[]) => Promise<SessionKey>;
+    decryptSessionKey: (data: Uint8Array<ArrayBuffer>, decryptionKeys: PrivateKey | PrivateKey[]) => Promise<SessionKey>;
 
     decryptArmoredSessionKey: (armoredData: string, decryptionKeys: PrivateKey | PrivateKey[]) => Promise<SessionKey>;
 
     decryptKey: (armoredKey: string, passphrase: string) => Promise<PrivateKey>;
 
     decryptAndVerify(
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         verificationKeys: PublicKey | PublicKey[],
     ): Promise<{
-        data: Uint8Array;
+        data: Uint8Array<ArrayBuffer>;
         verified: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }>;
 
     decryptAndVerifyDetached(
-        data: Uint8Array,
-        signature: Uint8Array | undefined,
+        data: Uint8Array<ArrayBuffer>,
+        signature: Uint8Array<ArrayBuffer> | undefined,
         sessionKey: SessionKey,
         verificationKeys?: PublicKey | PublicKey[],
     ): Promise<{
-        data: Uint8Array;
+        data: Uint8Array<ArrayBuffer>;
         verified: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }>;
 
-    decryptArmored(armoredData: string, decryptionKeys: PrivateKey | PrivateKey[]): Promise<Uint8Array>;
+    decryptArmored(armoredData: string, decryptionKeys: PrivateKey | PrivateKey[]): Promise<Uint8Array<ArrayBuffer>>;
 
     decryptArmoredAndVerify: (
         armoredData: string,
         decryptionKeys: PrivateKey | PrivateKey[],
         verificationKeys: PublicKey | PublicKey[],
     ) => Promise<{
-        data: Uint8Array;
+        data: Uint8Array<ArrayBuffer>;
         verified: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }>;
@@ -212,10 +243,10 @@ export interface OpenPGPCrypto {
         sessionKey: SessionKey,
         verificationKeys: PublicKey | PublicKey[],
     ) => Promise<{
-        data: Uint8Array;
+        data: Uint8Array<ArrayBuffer>;
         verified: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }>;
 
-    decryptArmoredWithPassword(armoredData: string, password: string): Promise<Uint8Array>;
+    decryptArmoredWithPassword(armoredData: string, password: string): Promise<Uint8Array<ArrayBuffer>>;
 }

package/src/crypto/openPGPCrypto.ts

@@ -18,15 +18,15 @@ export interface OpenPGPCryptoProxy {
             encryptionKeys?: PublicKey | PublicKey[];
             passwords?: string[];
         },
-    ) => Promise<Uint8Array>;
+    ) => Promise<Uint8Array<ArrayBuffer>>;
     decryptSessionKey: (options: {
         armoredMessage?: string;
-        binaryMessage?: Uint8Array;
+        binaryMessage?: Uint8Array<ArrayBuffer>;
         decryptionKeys: PrivateKey | PrivateKey[];
     }) => Promise<SessionKey | undefined>;
     encryptMessage: <Format extends 'armored' | 'binary' = 'armored', Detached extends boolean = false>(options: {
         format?: Format;
-        binaryData: Uint8Array;
+        binaryData: Uint8Array<ArrayBuffer>;
         sessionKey?: SessionKey;
         encryptionKeys: PublicKey[];
         signingKeys?: PrivateKey;
@@ -35,39 +35,39 @@ export interface OpenPGPCryptoProxy {
     }) => Promise<
         Detached extends true
             ? {
-                  message: Format extends 'binary' ? Uint8Array : string;
-                  signature: Format extends 'binary' ? Uint8Array : string;
+                  message: Format extends 'binary' ? Uint8Array<ArrayBuffer> : string;
+                  signature: Format extends 'binary' ? Uint8Array<ArrayBuffer> : string;
               }
             : {
-                  message: Format extends 'binary' ? Uint8Array : string;
+                  message: Format extends 'binary' ? Uint8Array<ArrayBuffer> : string;
               }
     >;
     decryptMessage: <Format extends 'utf8' | 'binary' = 'utf8'>(options: {
         format: Format;
         armoredMessage?: string;
-        binaryMessage?: Uint8Array;
+        binaryMessage?: Uint8Array<ArrayBuffer>;
         armoredSignature?: string;
-        binarySignature?: Uint8Array;
+        binarySignature?: Uint8Array<ArrayBuffer>;
         sessionKeys?: SessionKey;
         passwords?: string[];
         decryptionKeys?: PrivateKey | PrivateKey[];
         verificationKeys?: PublicKey | PublicKey[];
     }) => Promise<{
-        data: Format extends 'binary' ? Uint8Array : string;
+        data: Format extends 'binary' ? Uint8Array<ArrayBuffer> : string;
         verificationStatus: VERIFICATION_STATUS;
         verificationErrors?: Error[];
     }>;
     signMessage: <Format extends 'binary' | 'armored' = 'armored'>(options: {
         format: Format;
-        binaryData: Uint8Array;
+        binaryData: Uint8Array<ArrayBuffer>;
         signingKeys: PrivateKey | PrivateKey[];
         detached: boolean;
         signatureContext?: { critical: boolean; value: string };
-    }) => Promise<Format extends 'binary' ? Uint8Array : string>;
+    }) => Promise<Format extends 'binary' ? Uint8Array<ArrayBuffer> : string>;
     verifyMessage: (options: {
-        binaryData: Uint8Array;
+        binaryData: Uint8Array<ArrayBuffer>;
         armoredSignature?: string;
-        binarySignature?: Uint8Array;
+        binarySignature?: Uint8Array<ArrayBuffer>;
         verificationKeys: PublicKey | PublicKey[];
         signatureContext?: { critical: boolean; value: string };
     }) => Promise<{
@@ -137,7 +137,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
         };
     }
 
-    async encryptArmored(data: Uint8Array, encryptionKeys: PublicKey[], sessionKey?: SessionKey) {
+    async encryptArmored(data: Uint8Array<ArrayBuffer>, encryptionKeys: PublicKey[], sessionKey?: SessionKey) {
         const { message: armoredData } = await this.cryptoProxy.encryptMessage({
             binaryData: data,
             sessionKey,
@@ -149,7 +149,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
     }
 
     async encryptAndSign(
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
@@ -168,7 +168,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
     }
 
     async encryptAndSignArmored(
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey | undefined,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
@@ -188,7 +188,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
     }
 
     async encryptAndSignDetached(
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
@@ -208,7 +208,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
     }
 
     async encryptAndSignDetachedArmored(
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         sessionKey: SessionKey,
         encryptionKeys: PublicKey[],
         signingKey: PrivateKey,
@@ -226,7 +226,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
         };
     }
 
-    async sign(data: Uint8Array, signingKeys: PrivateKey | PrivateKey[], signatureContext: string) {
+    async sign(data: Uint8Array<ArrayBuffer>, signingKeys: PrivateKey | PrivateKey[], signatureContext: string) {
         const signature = await this.cryptoProxy.signMessage({
             binaryData: data,
             signingKeys,
@@ -239,7 +239,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
         };
     }
 
-    async signArmored(data: Uint8Array, signingKeys: PrivateKey | PrivateKey[]) {
+    async signArmored(data: Uint8Array<ArrayBuffer>, signingKeys: PrivateKey | PrivateKey[]) {
         const signature = await this.cryptoProxy.signMessage({
             binaryData: data,
             signingKeys,
@@ -251,7 +251,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
         };
     }
 
-    async verify(data: Uint8Array, signature: Uint8Array, verificationKeys: PublicKey | PublicKey[]) {
+    async verify(data: Uint8Array<ArrayBuffer>, signature: Uint8Array<ArrayBuffer>, verificationKeys: PublicKey | PublicKey[]) {
         const { verificationStatus, errors } = await this.cryptoProxy.verifyMessage({
             binaryData: data,
             binarySignature: signature,
@@ -264,7 +264,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
     }
 
     async verifyArmored(
-        data: Uint8Array,
+        data: Uint8Array<ArrayBuffer>,
         armoredSignature: string,
         verificationKeys: PublicKey | PublicKey[],
         signatureContext?: string,
@@ -282,7 +282,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
         };
     }
 
-    async decryptSessionKey(data: Uint8Array, decryptionKeys: PrivateKey | PrivateKey[]) {
+    async decryptSessionKey(data: Uint8Array<ArrayBuffer>, decryptionKeys: PrivateKey | PrivateKey[]) {
         const sessionKey = await this.cryptoProxy.decryptSessionKey({
             binaryMessage: data,
             decryptionKeys,
@@ -316,7 +316,7 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
         return key;
     }
 
-    async decryptAndVerify(data: Uint8Array, sessionKey: SessionKey, verificationKeys: PublicKey[]) {
+    async decryptAndVerify(data: Uint8Array<ArrayBuffer>, sessionKey: SessionKey, verificationKeys: PublicKey[]) {
         const {
             data: decryptedData,
             verificationStatus,
@@ -336,8 +336,8 @@ export class OpenPGPCryptoWithCryptoProxy implements OpenPGPCrypto {
     }
 
     async decryptAndVerifyDetached(
-        data: Uint8Array,
-        signature: Uint8Array | undefined,
+        data: Uint8Array<ArrayBuffer>,
+        signature: Uint8Array<ArrayBuffer> | undefined,
         sessionKey: SessionKey,
         verificationKeys?: PublicKey[],
     ) {

package/src/interface/index.ts

@@ -43,11 +43,19 @@ export type {
     NodeOrUid,
     RevisionOrUid,
     NodeResult,
+    NodeResultWithError,
     NodeResultWithNewUid,
     Membership,
 } from './nodes';
 export { NodeType, MemberRole, RevisionState } from './nodes';
-export type { MaybePhotoNode, MaybeMissingPhotoNode, PhotoNode, DegradedPhotoNode, PhotoAttributes } from './photos';
+export type {
+    MaybePhotoNode,
+    MaybeMissingPhotoNode,
+    PhotoNode,
+    DegradedPhotoNode,
+    PhotoAttributes,
+    AlbumAttributes,
+} from './photos';
 export type {
     ProtonInvitation,
     ProtonInvitationWithNode,
@@ -100,7 +108,7 @@ export type CachedCryptoMaterial = {
         key: PrivateKey;
         passphraseSessionKey: SessionKey;
         contentKeyPacketSessionKey?: SessionKey;
-        hashKey?: Uint8Array;
+        hashKey?: Uint8Array<ArrayBuffer>;
     };
     shareKey?: {
         key: PrivateKey;

package/src/interface/nodes.ts

@@ -229,4 +229,5 @@ export type RevisionOrUid = Revision | string;
 
 // TODO: Remove string from the result and use Error instead to be compatible with the NodeResultWithNewUid.
 export type NodeResult = { uid: string; ok: true } | { uid: string; ok: false; error: string };
+export type NodeResultWithError = { uid: string; ok: true } | { uid: string; ok: false; error: Error };
 export type NodeResultWithNewUid = { uid: string; newUid: string; ok: true } | { uid: string; ok: false; error: Error };

package/src/interface/photos.ts

@@ -21,8 +21,9 @@ export type MaybeMissingPhotoNode = Result<PhotoNode, DegradedPhotoNode | Missin
  * See `NodeEntity` for more information.
  */
 export type PhotoNode = NodeEntity & {
-    type: NodeType.Photo;
+    type: NodeType.Photo | NodeType.Album;
     photo?: PhotoAttributes;
+    album?: AlbumAttributes;
 };
 
 /**
@@ -32,6 +33,7 @@ export type PhotoNode = NodeEntity & {
  */
 export type DegradedPhotoNode = DegradedNode & {
     photo?: PhotoAttributes;
+    album?: AlbumAttributes;
 };
 
 /**
@@ -65,3 +67,19 @@ export type PhotoAttributes = {
      */
     tags: number[]; // TODO: enum
 }
+
+/**
+ * Attributes of an album.
+ *
+ * Only nodes of type `NodeType.Album` have property of this type.
+ */
+export type AlbumAttributes = {
+    /**
+     * Number of photos in the album.
+     */
+    photoCount: number;
+    /**
+     * UID of the cover photo node of the album.
+     */
+    coverPhotoNodeUid?: string;
+}

package/src/interface/sharing.ts

@@ -85,6 +85,7 @@ export type ShareNodeSettings = {
         message?: string;
         includeNodeName?: boolean;
     };
+    editorsCanShare?: boolean;
 };
 
 export type ShareMembersSettings =
@@ -107,6 +108,7 @@ export type ShareResult = {
     nonProtonInvitations: NonProtonInvitation[];
     members: Member[];
     publicLink?: PublicLink;
+    editorsCanShare: boolean;
 };
 
 export type UnshareNodeSettings = {