@protontech/drive-sdk 0.0.13 → 0.1.0

package/dist/cache/index.d.ts

@@ -1,2 +1,3 @@
 export type { ProtonDriveCache, EntityResult } from './interface';
 export { MemoryCache } from './memoryCache';
+export { NullCache } from './nullCache';

package/dist/cache/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryCache = void 0;
+exports.NullCache = exports.MemoryCache = void 0;
 var memoryCache_1 = require("./memoryCache");
 Object.defineProperty(exports, "MemoryCache", { enumerable: true, get: function () { return memoryCache_1.MemoryCache; } });
+var nullCache_1 = require("./nullCache");
+Object.defineProperty(exports, "NullCache", { enumerable: true, get: function () { return nullCache_1.NullCache; } });
 //# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":";;;AACA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":";;;AACA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA"}

package/dist/cache/memoryCache.d.ts

@@ -11,7 +11,7 @@ export declare class MemoryCache<T> implements ProtonDriveCache<T> {
     private entitiesByTag;
     clear(): Promise<void>;
     setEntity(key: string, value: T, tags?: string[]): Promise<void>;
-    getEntity(key: string): Promise<NonNullable<T>>;
+    getEntity(key: string): Promise<T>;
     iterateEntities(keys: string[]): AsyncGenerator<EntityResult<T>>;
     iterateEntitiesByTag(tag: string): AsyncGenerator<EntityResult<T>>;
     removeEntities(keys: string[]): Promise<void>;

package/dist/cache/nullCache.d.ts

@@ -0,0 +1,14 @@
+import type { ProtonDriveCache, EntityResult } from './interface';
+/**
+ * Null cache implementation for Proton Drive SDK.
+ *
+ * This cache is not caching anything. It can be used to disable the cache.
+ */
+export declare class NullCache<T> implements ProtonDriveCache<T> {
+    clear(): Promise<void>;
+    setEntity(key: string, value: T, tags?: string[]): Promise<void>;
+    getEntity(key: string): Promise<T>;
+    iterateEntities(keys: string[]): AsyncGenerator<EntityResult<T>>;
+    iterateEntitiesByTag(tag: string): AsyncGenerator<EntityResult<T>>;
+    removeEntities(keys: string[]): Promise<void>;
+}

package/dist/cache/nullCache.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullCache = void 0;
+/**
+ * Null cache implementation for Proton Drive SDK.
+ *
+ * This cache is not caching anything. It can be used to disable the cache.
+ */
+class NullCache {
+    async clear() {
+        // No-op.
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async setEntity(key, value, tags) {
+        // No-op.
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async getEntity(key) {
+        throw Error('Entity not found');
+    }
+    async *iterateEntities(keys) {
+        for (const key of keys) {
+            yield { key, ok: false, error: 'Entity not found' };
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async *iterateEntitiesByTag(tag) {
+        // No-op.
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async removeEntities(keys) {
+        // No-op.
+    }
+}
+exports.NullCache = NullCache;
+;
+//# sourceMappingURL=nullCache.js.map

package/dist/cache/nullCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullCache.js","sourceRoot":"","sources":["../../src/cache/nullCache.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,SAAS;IAClB,KAAK,CAAC,KAAK;QACP,SAAS;IACb,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAQ,EAAE,IAAe;QAClD,SAAS;IACb,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,SAAS,CAAC,GAAW;QACvB,MAAM,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,CAAC,eAAe,CAAC,IAAc;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QACxD,CAAC;IACL,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,CAAC,oBAAoB,CAAC,GAAW;QACnC,SAAS;IACb,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,cAAc,CAAC,IAAc;QAC/B,SAAS;IACb,CAAC;CACJ;AA9BD,8BA8BC;AAAA,CAAC"}

package/dist/config.d.ts

@@ -1,2 +1,17 @@
 import { ProtonDriveConfig } from './interface';
-export declare function getConfig(config?: ProtonDriveConfig): Required<ProtonDriveConfig>;
+/**
+ * Parsed configuration of `ProtonDriveConfig`.
+ *
+ * The object should be almost identical to the original config, but making
+ * some fields required (setting reasonable defaults for the missing fields),
+ * or changed for easier usage inside of the SDK.
+ *
+ * For more property details, see the original config declaration.
+ */
+type ParsedProtonDriveConfig = {
+    baseUrl: string;
+    language: string;
+    clientUid?: string;
+};
+export declare function getConfig(config?: ProtonDriveConfig): ParsedProtonDriveConfig;
+export {};

package/dist/config.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfig = getConfig;
 function getConfig(config) {
     return {
-        ...config,
         baseUrl: config?.baseUrl ? `https://${config.baseUrl}` : 'https://drive-api.proton.me',
         language: config?.language || 'en',
+        clientUid: config?.clientUid,
     };
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAEA,8BAMC;AAND,SAAgB,SAAS,CAAC,MAA0B;IAChD,OAAO;QACH,GAAG,MAAM;QACT,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,6BAA6B;QACtF,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI;KACrC,CAAC;AACN,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAiBA,8BAMC;AAND,SAAgB,SAAS,CAAC,MAA0B;IAChD,OAAO;QACH,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,6BAA6B;QACtF,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI;QAClC,SAAS,EAAE,MAAM,EAAE,SAAS;KAC/B,CAAC;AACN,CAAC"}

package/dist/crypto/openPGPCrypto.js

@@ -15,6 +15,8 @@ class OpenPGPCryptoWithCryptoProxy {
     }
     generatePassphrase() {
         const value = crypto.getRandomValues(new Uint8Array(32));
+        // TODO: Once all clients can use non-ascii bytes, switch to simple
+        // generating of random bytes without encoding it into base64.
         return (0, utils_1.uint8ArrayToBase64String)(value);
     }
     async generateSessionKey(encryptionKeys) {

package/dist/crypto/openPGPCrypto.js.map

@@ -1 +1 @@
-{"version":3,"file":"openPGPCrypto.js","sourceRoot":"","sources":["../../src/crypto/openPGPCrypto.ts"],"names":[],"mappings":";;;AACA,mCAAmD;AA4DnD;;;;GAIG;AACH,MAAa,4BAA4B;IACjB;IAApB,YAAoB,WAA+B;QAA/B,gBAAW,GAAX,WAAW,CAAoB;QAC/C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED,kBAAkB;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO,IAAA,gCAAwB,EAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,cAA4B;QACjD,OAAO,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,UAAsB,EAAE,cAAuC;QACnF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACvD,GAAG,UAAU;YACb,MAAM,EAAE,QAAQ;YAChB,cAAc;SACjB,CAAC,CAAC;QACH,OAAO;YACH,SAAS;SACZ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,6BAA6B,CAAC,UAAsB,EAAE,QAAgB;QACxE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACvD,GAAG,UAAU;YACb,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,CAAC,QAAQ,CAAC;SACxB,CAAC,CAAC;QACH,OAAO;YACH,SAAS;SACZ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;YAClD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAChC,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,eAAe;SACzB,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC;YACvD,UAAU;YACV,UAAU;SACb,CAAC,CAAC;QAEH,OAAO;YACH,UAAU;YACV,UAAU;SACb,CAAC;IACN,CAAC;IAED,KAAK,CAAC,cAAc,CAChB,IAAgB,EAChB,cAA4B,EAC5B,UAAuB;QAEvB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACnE,UAAU,EAAE,IAAI;YAChB,UAAU;YACV,cAAc;SACjB,CAAC,CAAC;QACH,OAAO;YACH,WAAW,EAAE,WAAqB;SACrC,CAAA;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAChB,IAAgB,EAChB,UAAsB,EACtB,cAA4B,EAC5B,UAAsB;QAEtB,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACrE,UAAU,EAAE,IAAI;YAChB,UAAU;YACV,WAAW,EAAE,UAAU;YACvB,cAAc;YACd,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,KAAK;SAClB,CAAC,CAAC;QACH,OAAO;YACH,aAAa,EAAE,aAA2B;SAC7C,CAAC;IACN,CAAC;IAED,KAAK,CAAC,qBAAqB,CACvB,IAAgB,EAChB,UAAkC,EAClC,cAA4B,EAC5B,UAAsB;QAEtB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACnE,UAAU,EAAE,IAAI;YAChB,cAAc;YACd,UAAU;YACV,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,KAAK;SAClB,CAAC,CAAC;QACH,OAAO;YACH,WAAW,EAAE,WAAqB;SACrC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,sBAAsB,CACxB,IAAgB,EAChB,UAAsB,EACtB,cAA4B,EAC5B,UAAsB;QAEtB,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YAChF,UAAU,EAAE,IAAI;YAChB,UAAU;YACV,WAAW,EAAE,UAAU;YACvB,cAAc;YACd,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,OAAO;YACH,aAAa,EAAE,aAA2B;YAC1C,SAAS,EAAE,SAAuB;SACrC,CAAA;IACL,CAAC;IAED,KAAK,CAAC,6BAA6B,CAC/B,IAAgB,EAChB,UAAsB,EACtB,cAA4B,EAC5B,UAAsB;QAEtB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YAChG,UAAU,EAAE,IAAI;YAChB,UAAU;YACV,WAAW,EAAE,UAAU;YACvB,cAAc;YACd,QAAQ,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,OAAO;YACH,WAAW,EAAE,WAAqB;YAClC,gBAAgB,EAAE,gBAA0B;SAC/C,CAAA;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CACN,IAAgB,EAChB,WAAsC,EACtC,gBAAwB;QAExB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;YACjD,UAAU,EAAE,IAAI;YAChB,WAAW;YACX,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAChE,CAAC,CAAC;QACH,OAAO;YACH,SAAS,EAAE,SAAuB;SACrC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,WAAW,CACb,IAAgB,EAChB,WAAsC;QAEtC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;YACjD,UAAU,EAAE,IAAI;YAChB,WAAW;YACX,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,OAAO;YACH,SAAS,EAAE,SAAmB;SACjC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,gBAAwB,EACxB,gBAAyC;QAEzC,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC;YAC1E,UAAU,EAAE,IAAI;YAChB,gBAAgB;YAChB,gBAAgB;SACnB,CAAC,CAAC;QACH,OAAO;YACH,6DAA6D;YAC7D,mFAAmF;YACnF,QAAQ,EAAE,QAAQ,IAAI,kBAAmB;SAC5C,CAAC;IACN,CAAC;IAED,KAAK,CAAC,iBAAiB,CACnB,IAAgB,EAChB,cAAyC;QAEzC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACxD,aAAa,EAAE,IAAI;YACnB,cAAc;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC1B,WAAmB,EACnB,cAAyC;QAEzC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACxD,cAAc,EAAE,WAAW;YAC3B,cAAc;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,UAAU,CACZ,UAAkB,EAClB,UAAkB;QAElB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC;YAChD,UAAU;YACV,UAAU;SACb,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAClB,IAAgB,EAChB,UAAsB,EACtB,gBAA6B;QAE7B,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YAChG,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,UAAU;YACvB,gBAAgB;YAChB,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QAEH,OAAO;YACH,IAAI,EAAE,aAA2B;YACjC,6DAA6D;YAC7D,mFAAmF;YACnF,QAAQ,EAAE,QAAQ,IAAI,kBAAmB;SAC5C,CAAA;IACL,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC1B,IAAgB,EAChB,SAAiC,EACjC,UAAsB,EACtB,gBAA8B;QAE9B,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YAChG,aAAa,EAAE,IAAI;YACnB,eAAe,EAAE,SAAS;YAC1B,WAAW,EAAE,UAAU;YACvB,gBAAgB;YAChB,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QAEH,OAAO;YACH,IAAI,EAAE,aAA2B;YACjC,6DAA6D;YAC7D,mFAAmF;YACnF,QAAQ,EAAE,QAAQ,IAAI,kBAAmB;SAC5C,CAAA;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAChB,WAAmB,EACnB,cAAyC;QAEzC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACnD,cAAc,EAAE,WAAW;YAC3B,cAAc;YACd,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,OAAO,IAAkB,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,uBAAuB,CACzB,WAAmB,EACnB,cAAyC,EACzC,gBAAyC;QAEzC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACjF,cAAc,EAAE,WAAW;YAC3B,cAAc;YACd,gBAAgB;YAChB,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QAEH,OAAO;YACH,IAAI,EAAE,IAAkB;YACxB,6DAA6D;YAC7D,mFAAmF;YACnF,QAAQ,EAAE,QAAQ,IAAI,kBAAmB;SAC5C,CAAA;IACL,CAAC;IAED,KAAK,CAAC,+BAA+B,CACjC,WAAmB,EACnB,gBAAwB,EACxB,UAAsB,EACtB,gBAAyC;QAEzC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACjF,cAAc,EAAE,WAAW;YAC3B,gBAAgB;YAChB,WAAW,EAAE,UAAU;YACvB,gBAAgB;YAChB,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QAEH,OAAO;YACH,IAAI,EAAE,IAAkB;YACxB,6DAA6D;YAC7D,mFAAmF;YACnF,QAAQ,EAAE,QAAQ,IAAI,kBAAmB;SAC5C,CAAA;IACL,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC5B,WAAmB,EACnB,QAAgB;QAEhB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACnD,cAAc,EAAE,WAAW;YAC3B,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,OAAO,IAAkB,CAAC;IAC9B,CAAC;CACJ;AAxVD,oEAwVC"}
+{"version":3,"file":"openPGPCrypto.js","sourceRoot":"","sources":["../../src/crypto/openPGPCrypto.ts"],"names":[],"mappings":"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"}

package/dist/diagnostic/eventsGenerator.d.ts

@@ -0,0 +1,14 @@
+import { DiagnosticResult } from './interface';
+/**
+ * A base class for class that should provide diagnostic events
+ * as a separate generator. Simply inherit from this class and use
+ * `enqueueEvent` to enqueue the observed events. The events will be
+ * available via `iterateEvents` generator.
+ */
+export declare class EventsGenerator {
+    private eventQueue;
+    private waitingResolvers;
+    protected enqueueEvent(event: DiagnosticResult): void;
+    iterateEvents(): AsyncGenerator<DiagnosticResult>;
+    private waitForEvent;
+}

package/dist/diagnostic/eventsGenerator.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsGenerator = void 0;
+/**
+ * A base class for class that should provide diagnostic events
+ * as a separate generator. Simply inherit from this class and use
+ * `enqueueEvent` to enqueue the observed events. The events will be
+ * available via `iterateEvents` generator.
+ */
+class EventsGenerator {
+    eventQueue = [];
+    waitingResolvers = [];
+    enqueueEvent(event) {
+        this.eventQueue.push(event);
+        // Notify all waiting generators
+        const resolvers = this.waitingResolvers.splice(0);
+        resolvers.forEach(resolve => resolve());
+    }
+    async *iterateEvents() {
+        try {
+            while (true) {
+                if (this.eventQueue.length === 0) {
+                    await this.waitForEvent();
+                }
+                while (this.eventQueue.length > 0) {
+                    const event = this.eventQueue.shift();
+                    if (event) {
+                        yield event;
+                    }
+                }
+            }
+        }
+        finally {
+            this.waitingResolvers.splice(0);
+        }
+    }
+    waitForEvent() {
+        return new Promise((resolve) => {
+            if (this.eventQueue.length > 0) {
+                resolve();
+            }
+            else {
+                this.waitingResolvers.push(resolve);
+            }
+        });
+    }
+}
+exports.EventsGenerator = EventsGenerator;
+//# sourceMappingURL=eventsGenerator.js.map

package/dist/diagnostic/eventsGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventsGenerator.js","sourceRoot":"","sources":["../../src/diagnostic/eventsGenerator.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,MAAa,eAAe;IAChB,UAAU,GAAuB,EAAE,CAAC;IACpC,gBAAgB,GAAsB,EAAE,CAAC;IAEvC,YAAY,CAAC,KAAuB;QAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClD,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAA,CAAE,aAAa;QAChB,IAAI,CAAC;YACD,OAAO,IAAI,EAAE,CAAC;gBACV,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC/B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC9B,CAAC;gBAED,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;oBACtC,IAAI,KAAK,EAAE,CAAC;wBACR,MAAM,KAAK,CAAC;oBAChB,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAEO,YAAY;QAChB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACjC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC;YACd,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAvCD,0CAuCC"}

package/dist/diagnostic/httpClient.d.ts

@@ -0,0 +1,16 @@
+import { ProtonDriveHTTPClient, ProtonDriveHTTPClientBlobOptions, ProtonDriveHTTPClientJsonOptions } from "../interface";
+import { EventsGenerator } from './eventsGenerator';
+/**
+ * Special HTTP client that is compatible with the SDK.
+ *
+ * It is a probe into SDK to observe whats going on and report any suspicious
+ * behavior.
+ *
+ * It should be used only for diagnostic purposes.
+ */
+export declare class DiagnosticHTTPClient extends EventsGenerator implements ProtonDriveHTTPClient {
+    private httpClient;
+    constructor(httpClient: ProtonDriveHTTPClient);
+    fetchJson(options: ProtonDriveHTTPClientJsonOptions): Promise<Response>;
+    fetchBlob(options: ProtonDriveHTTPClientBlobOptions): Promise<Response>;
+}

package/dist/diagnostic/httpClient.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagnosticHTTPClient = void 0;
+const eventsGenerator_1 = require("./eventsGenerator");
+/**
+ * Special HTTP client that is compatible with the SDK.
+ *
+ * It is a probe into SDK to observe whats going on and report any suspicious
+ * behavior.
+ *
+ * It should be used only for diagnostic purposes.
+ */
+class DiagnosticHTTPClient extends eventsGenerator_1.EventsGenerator {
+    httpClient;
+    constructor(httpClient) {
+        super();
+        this.httpClient = httpClient;
+        this.httpClient = httpClient;
+    }
+    async fetchJson(options) {
+        try {
+            const response = await this.httpClient.fetchJson(options);
+            if (response.status >= 400 && response.status !== 429) {
+                try {
+                    const json = await response.json();
+                    this.enqueueEvent({
+                        type: 'http_error',
+                        request: {
+                            url: options.url,
+                            method: options.method,
+                            json: options.json,
+                        },
+                        response: {
+                            status: response.status,
+                            statusText: response.statusText,
+                            json,
+                        },
+                    });
+                    return new Response(JSON.stringify(json), {
+                        status: response.status,
+                        statusText: response.statusText,
+                        headers: response.headers,
+                    });
+                }
+                catch (jsonError) {
+                    this.enqueueEvent({
+                        type: 'http_error',
+                        request: {
+                            url: options.url,
+                            method: options.method,
+                            json: options.json,
+                        },
+                        response: {
+                            status: response.status,
+                            statusText: response.statusText,
+                            jsonError,
+                        },
+                    });
+                }
+            }
+            return response;
+        }
+        catch (error) {
+            this.enqueueEvent({
+                type: 'http_error',
+                request: {
+                    url: options.url,
+                    method: options.method,
+                    json: options.json,
+                },
+                error,
+            });
+            throw error;
+        }
+    }
+    fetchBlob(options) {
+        return this.httpClient.fetchBlob(options);
+    }
+}
+exports.DiagnosticHTTPClient = DiagnosticHTTPClient;
+//# sourceMappingURL=httpClient.js.map

package/dist/diagnostic/httpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.js","sourceRoot":"","sources":["../../src/diagnostic/httpClient.ts"],"names":[],"mappings":";;;AACA,uDAAoD;AAEpD;;;;;;;GAOG;AACH,MAAa,oBAAqB,SAAQ,iCAAe;IACjC;IAApB,YAAoB,UAAiC;QACjD,KAAK,EAAE,CAAC;QADQ,eAAU,GAAV,UAAU,CAAuB;QAEjD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAyC;QACrD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAE1D,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACpD,IAAI,CAAC;oBACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAEnC,IAAI,CAAC,YAAY,CAAC;wBACd,IAAI,EAAE,YAAY;wBAClB,OAAO,EAAE;4BACL,GAAG,EAAE,OAAO,CAAC,GAAG;4BAChB,MAAM,EAAE,OAAO,CAAC,MAAM;4BACtB,IAAI,EAAE,OAAO,CAAC,IAAI;yBACrB;wBACD,QAAQ,EAAE;4BACN,MAAM,EAAE,QAAQ,CAAC,MAAM;4BACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;4BAC/B,IAAI;yBACP;qBACJ,CAAC,CAAC;oBAEH,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;wBACtC,MAAM,EAAE,QAAQ,CAAC,MAAM;wBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;wBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;qBAC5B,CAAC,CAAC;gBACP,CAAC;gBAAC,OAAO,SAAkB,EAAE,CAAC;oBAC1B,IAAI,CAAC,YAAY,CAAC;wBACd,IAAI,EAAE,YAAY;wBAClB,OAAO,EAAE;4BACL,GAAG,EAAE,OAAO,CAAC,GAAG;4BAChB,MAAM,EAAE,OAAO,CAAC,MAAM;4BACtB,IAAI,EAAE,OAAO,CAAC,IAAI;yBACrB;wBACD,QAAQ,EAAE;4BACN,MAAM,EAAE,QAAQ,CAAC,MAAM;4BACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;4BAC/B,SAAS;yBACZ;qBACJ,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAED,OAAO,QAAQ,CAAC;QACpB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC;gBACd,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE;oBACL,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;iBACrB;gBACD,KAAK;aACR,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAAyC;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;CACJ;AApED,oDAoEC"}

package/dist/diagnostic/index.d.ts

@@ -0,0 +1,10 @@
+import { ProtonDriveClientContructorParameters } from "../interface";
+import { Diagnostic } from "./interface";
+export type { Diagnostic, DiagnosticResult } from "./interface";
+/**
+ * Initializes the diagnostic tool. It creates the instance of
+ * ProtonDriveClient with the special probes to observe the logs,
+ * metrics and HTTP calls; and enforced null/empty cache to always
+ * start from scratch.
+ */
+export declare function initDiagnostic(options: Omit<ProtonDriveClientContructorParameters, 'entitiesCache' | 'cryptoCache' | 'telemetry'>): Diagnostic;

package/dist/diagnostic/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initDiagnostic = initDiagnostic;
+const cache_1 = require("../cache");
+const protonDriveClient_1 = require("../protonDriveClient");
+const httpClient_1 = require("./httpClient");
+const sdkDiagnostic_1 = require("./sdkDiagnostic");
+const sdkDiagnosticFull_1 = require("./sdkDiagnosticFull");
+const telemetry_1 = require("./telemetry");
+/**
+ * Initializes the diagnostic tool. It creates the instance of
+ * ProtonDriveClient with the special probes to observe the logs,
+ * metrics and HTTP calls; and enforced null/empty cache to always
+ * start from scratch.
+ */
+function initDiagnostic(options) {
+    const httpClient = new httpClient_1.DiagnosticHTTPClient(options.httpClient);
+    const telemetry = new telemetry_1.DiagnosticTelemetry();
+    const protonDriveClient = new protonDriveClient_1.ProtonDriveClient({
+        ...options,
+        httpClient,
+        // Ensure we always start with a clean state.
+        // Do not use memory cache as diagnostic should visit each node
+        // only once and we don't want to grow memory usage.
+        entitiesCache: new cache_1.NullCache(),
+        // However, we need to use memory cache for crypto cache to avoid
+        // re-fetching the same key for all the children.
+        cryptoCache: new cache_1.MemoryCache(),
+        // Special telemetry that observes the logs and metrics.
+        telemetry,
+    });
+    const diagnostic = new sdkDiagnostic_1.SDKDiagnostic(protonDriveClient);
+    return new sdkDiagnosticFull_1.FullSDKDiagnostic(diagnostic, telemetry, httpClient);
+}
+//# sourceMappingURL=index.js.map

package/dist/diagnostic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/diagnostic/index.ts"],"names":[],"mappings":";;AAiBA,wCAoBC;AArCD,oCAAkD;AAElD,4DAAyD;AACzD,6CAAoD;AAEpD,mDAAgD;AAChD,2DAAwD;AACxD,2CAAkD;AAIlD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAmG;IAC9H,MAAM,UAAU,GAAG,IAAI,iCAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,+BAAmB,EAAE,CAAC;IAE5C,MAAM,iBAAiB,GAAG,IAAI,qCAAiB,CAAC;QAC5C,GAAG,OAAO;QACV,UAAU;QACV,6CAA6C;QAC7C,+DAA+D;QAC/D,oDAAoD;QACpD,aAAa,EAAE,IAAI,iBAAS,EAAE;QAC9B,iEAAiE;QACjE,iDAAiD;QACjD,WAAW,EAAE,IAAI,mBAAW,EAAE;QAC9B,wDAAwD;QACxD,SAAS;KACZ,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,6BAAa,CAAC,iBAAiB,CAAC,CAAC;IACxD,OAAO,IAAI,qCAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC"}

package/dist/diagnostic/integrityVerificationStream.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A WritableStream that computes SHA1 hash on the fly.
+ * The computed SHA1 hash is available after the stream is closed.
+ */
+export declare class IntegrityVerificationStream extends WritableStream<Uint8Array> {
+    private sha1Hash;
+    private _computedSha1;
+    private _computedSizeInBytes;
+    private _isClosed;
+    constructor();
+    /**
+     * Get the computed SHA1 hash. Only available after the stream is closed.
+     * @returns The SHA1 hash as a hex string, or null if not yet computed or stream was aborted
+     */
+    get computedSha1(): string | undefined;
+    /**
+     * Get the computed size in bytes. Only available after the stream is closed.
+     * @returns The size in bytes, or 0 if not yet computed or stream was aborted
+     */
+    get computedSizeInBytes(): number | undefined;
+}

package/dist/diagnostic/integrityVerificationStream.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrityVerificationStream = void 0;
+const legacy_1 = require("@noble/hashes/legacy");
+const utils_1 = require("@noble/hashes/utils");
+/**
+ * A WritableStream that computes SHA1 hash on the fly.
+ * The computed SHA1 hash is available after the stream is closed.
+ */
+class IntegrityVerificationStream extends WritableStream {
+    sha1Hash = legacy_1.sha1.create();
+    _computedSha1 = undefined;
+    _computedSizeInBytes = 0;
+    _isClosed = false;
+    constructor() {
+        super({
+            start: () => { },
+            write: (chunk) => {
+                if (this._isClosed) {
+                    throw new Error('Cannot write to a closed stream');
+                }
+                this.sha1Hash.update(chunk);
+                this._computedSizeInBytes += chunk.length;
+            },
+            close: () => {
+                if (!this._isClosed) {
+                    this._computedSha1 = (0, utils_1.bytesToHex)(this.sha1Hash.digest());
+                    this._isClosed = true;
+                }
+            },
+            abort: () => {
+                this._isClosed = true;
+                this._computedSha1 = undefined;
+            }
+        });
+    }
+    /**
+     * Get the computed SHA1 hash. Only available after the stream is closed.
+     * @returns The SHA1 hash as a hex string, or null if not yet computed or stream was aborted
+     */
+    get computedSha1() {
+        return this._computedSha1;
+    }
+    /**
+     * Get the computed size in bytes. Only available after the stream is closed.
+     * @returns The size in bytes, or 0 if not yet computed or stream was aborted
+     */
+    get computedSizeInBytes() {
+        if (!this._isClosed) {
+            return undefined;
+        }
+        return this._computedSizeInBytes;
+    }
+}
+exports.IntegrityVerificationStream = IntegrityVerificationStream;
+//# sourceMappingURL=integrityVerificationStream.js.map

package/dist/diagnostic/integrityVerificationStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrityVerificationStream.js","sourceRoot":"","sources":["../../src/diagnostic/integrityVerificationStream.ts"],"names":[],"mappings":";;;AAAA,iDAA4C;AAC5C,+CAAiD;AAEjD;;;GAGG;AACH,MAAa,2BAA4B,SAAQ,cAA0B;IAC/D,QAAQ,GAAG,aAAI,CAAC,MAAM,EAAE,CAAC;IACzB,aAAa,GAAuB,SAAS,CAAC;IAC9C,oBAAoB,GAAW,CAAC,CAAC;IACjC,SAAS,GAAG,KAAK,CAAC;IAE1B;QACI,KAAK,CAAC;YACF,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,KAAK,EAAE,CAAC,KAAiB,EAAE,EAAE;gBACzB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACvD,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,CAAC,oBAAoB,IAAI,KAAK,CAAC,MAAM,CAAC;YAC9C,CAAC;YACD,KAAK,EAAE,GAAG,EAAE;gBACR,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBAClB,IAAI,CAAC,aAAa,GAAG,IAAA,kBAAU,EAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBAC1B,CAAC;YACL,CAAC;YACD,KAAK,EAAE,GAAG,EAAE;gBACR,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YACnC,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACrC,CAAC;CAEJ;AAhDD,kEAgDC"}

package/dist/diagnostic/interface.d.ts

@@ -0,0 +1,102 @@
+import { DegradedNode, MaybeNode, MetricEvent } from "../interface";
+import { LogRecord } from "../telemetry";
+export interface Diagnostic {
+    verifyMyFiles(options?: DiagnosticOptions): AsyncGenerator<DiagnosticResult>;
+    verifyNodeTree(node: MaybeNode, options?: DiagnosticOptions): AsyncGenerator<DiagnosticResult>;
+}
+export type DiagnosticOptions = {
+    verifyContent?: boolean;
+    verifyThumbnails?: boolean;
+};
+export type DiagnosticResult = FatalErrorResult | SdkErrorResult | HttpErrorResult | DegradedNodeResult | UnverifiedAuthorResult | ExtendedAttributesErrorResult | ExtendedAttributesMissingFieldResult | ContentFileMissingRevisionResult | ContentIntegrityErrorResult | ContentDownloadErrorResult | ThumbnailsErrorResult | LogErrorResult | LogWarningResult | MetricResult;
+export type FatalErrorResult = {
+    type: 'fatal_error';
+    message: string;
+    error?: unknown;
+};
+export type SdkErrorResult = {
+    type: 'sdk_error';
+    call: string;
+    error?: unknown;
+};
+export type HttpErrorResult = {
+    type: 'http_error';
+    request: {
+        url: string;
+        method: string;
+        json: unknown;
+    };
+    error?: unknown;
+    response?: {
+        status: number;
+        statusText: string;
+        json?: object;
+        jsonError?: unknown;
+    };
+};
+export type DegradedNodeResult = {
+    type: 'degraded_node';
+    nodeUid: string;
+    node: DegradedNode;
+};
+export type UnverifiedAuthorResult = {
+    type: 'unverified_author';
+    nodeUid: string;
+    revisionUid?: string;
+    authorType: string;
+    claimedAuthor?: string;
+    error: string;
+    node: MaybeNode;
+};
+export type ExtendedAttributesErrorResult = {
+    type: 'extended_attributes_error';
+    nodeUid: string;
+    revisionUid?: string;
+    field: 'sha1';
+    value: string;
+};
+export type ExtendedAttributesMissingFieldResult = {
+    type: 'extended_attributes_missing_field';
+    nodeUid: string;
+    revisionUid?: string;
+    missingField: 'sha1';
+};
+export type ContentFileMissingRevisionResult = {
+    type: 'content_file_missing_revision';
+    nodeUid: string;
+    revisionUid?: string;
+};
+export type ContentIntegrityErrorResult = {
+    type: 'content_integrity_error';
+    nodeUid: string;
+    revisionUid?: string;
+    claimedSha1?: string;
+    computedSha1?: string;
+    claimedSizeInBytes?: number;
+    computedSizeInBytes?: number;
+};
+export type ContentDownloadErrorResult = {
+    type: 'content_download_error';
+    nodeUid: string;
+    revisionUid?: string;
+    error: unknown;
+};
+export type ThumbnailsErrorResult = {
+    type: 'thumbnails_error';
+    nodeUid: string;
+    revisionUid?: string;
+    message?: string;
+    error?: unknown;
+};
+export type LogErrorResult = {
+    type: 'log_error';
+    log: LogRecord;
+};
+export type LogWarningResult = {
+    type: 'log_warning';
+    log: LogRecord;
+};
+export type MetricResult = {
+    type: 'metric';
+    event: MetricEvent;
+};

package/dist/diagnostic/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/diagnostic/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/diagnostic/interface.ts"],"names":[],"mappings":""}

package/dist/diagnostic/sdkDiagnostic.d.ts

@@ -0,0 +1,22 @@
+import { MaybeNode } from "../interface";
+import { ProtonDriveClient } from "../protonDriveClient";
+import { Diagnostic, DiagnosticOptions, DiagnosticResult } from "./interface";
+/**
+ * Diagnostic tool that uses SDK to traverse the node tree and verify
+ * the integrity of the node tree.
+ *
+ * It produces only events that can be read by direct SDK invocation.
+ * To get the full diagnostic, use {@link FullSDKDiagnostic}.
+ */
+export declare class SDKDiagnostic implements Diagnostic {
+    private protonDriveClient;
+    constructor(protonDriveClient: ProtonDriveClient);
+    verifyMyFiles(options?: DiagnosticOptions): AsyncGenerator<DiagnosticResult>;
+    verifyNodeTree(node: MaybeNode, options?: DiagnosticOptions): AsyncGenerator<DiagnosticResult>;
+    private verifyNode;
+    private verifyAuthor;
+    private verifyFileExtendedAttributes;
+    private verifyContent;
+    private verifyThumbnails;
+    private verifyNodeChildren;
+}