@protontech/drive-sdk 0.0.12 → 0.1.0

package/dist/errors.js

@@ -49,9 +49,14 @@ class ValidationError extends ProtonDriveError {
      * Use only for debugging purposes.
      */
     code;
-    constructor(message, code) {
+    /**
+     * Additional details about the error provided by the server.
+     */
+    details;
+    constructor(message, code, details) {
         super(message);
         this.code = code;
+        this.details = details;
     }
 }
 exports.ValidationError = ValidationError;
@@ -65,10 +70,12 @@ exports.ValidationError = ValidationError;
  */
 class NodeAlreadyExistsValidationError extends ValidationError {
     name = 'NodeAlreadyExistsValidationError';
-    availableName;
-    constructor(message, code, availableName) {
+    existingNodeUid;
+    ongoingUploadByOtherClient;
+    constructor(message, code, existingNodeUid, ongoingUploadByOtherClient = false) {
         super(message, code);
-        this.availableName = availableName;
+        this.existingNodeUid = existingNodeUid;
+        this.ongoingUploadByOtherClient = ongoingUploadByOtherClient;
     }
 }
 exports.NodeAlreadyExistsValidationError = NodeAlreadyExistsValidationError;

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,+BAAyB;AAEzB;;;;;;;;;;;GAWG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACvC,IAAI,GAAG,kBAAkB,CAAC;CAC7B;AAFD,4CAEC;AAED;;;;;GAKG;AACH,MAAa,UAAW,SAAQ,gBAAgB;IAC5C,IAAI,GAAG,YAAY,CAAC;IAEpB,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,IAAI,IAAA,QAAC,EAAC,OAAO,CAAC,CAAC,CAAC,CAAA,mBAAmB,CAAC,CAAC;IACtD,CAAC;CACJ;AAND,gCAMC;AAED;;;;;;;;;GASG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,IAAI,GAAG,iBAAiB,CAAC;IAEzB;;;;OAIG;IACa,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,IAAa;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAdD,0CAcC;AAED;;;;;;;GAOG;AACH,MAAa,gCAAiC,SAAQ,eAAe;IACjE,IAAI,GAAG,kCAAkC,CAAC;IAE1B,aAAa,CAAS;IAEtC,YAAY,OAAe,EAAE,IAAY,EAAE,aAAqB;QAC5D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;CACJ;AATD,4EASC;AAED;;;;;;;;GAQG;AACH,MAAa,WAAY,SAAQ,gBAAgB;IAC7C,IAAI,GAAG,aAAa,CAAC;IAErB;;;;OAIG;IACa,UAAU,CAAU;IACpC;;;;OAIG;IACa,IAAI,CAAU;CACjC;AAfD,kCAeC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAa,gBAAiB,SAAQ,WAAW;IAC7C,IAAI,GAAG,kBAAkB,CAAC;IAE1B,IAAI,GAAG,GAAG,CAAC;CACd;AAJD,4CAIC;AAED;;;;;;;GAOG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,IAAI,GAAG,iBAAiB,CAAC;CAC5B;AAFD,0CAEC;AAED;;;;;;;;;GASG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,IAAI,GAAG,iBAAiB,CAAC;CAC5B;AAFD,0CAEC;AAED;;;;;;;GAOG;AACH,MAAa,cAAe,SAAQ,gBAAgB;IAChD,IAAI,GAAG,gBAAgB,CAAC;IAER,KAAK,CAAU;IAE/B,YAAY,OAAe,EAAE,KAAc;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;CACJ;AATD,wCASC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,+BAAyB;AAEzB;;;;;;;;;;;GAWG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACvC,IAAI,GAAG,kBAAkB,CAAC;CAC7B;AAFD,4CAEC;AAED;;;;;GAKG;AACH,MAAa,UAAW,SAAQ,gBAAgB;IAC5C,IAAI,GAAG,YAAY,CAAC;IAEpB,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,IAAI,IAAA,QAAC,EAAC,OAAO,CAAC,CAAC,CAAC,CAAA,mBAAmB,CAAC,CAAC;IACtD,CAAC;CACJ;AAND,gCAMC;AAED;;;;;;;;;GASG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,IAAI,GAAG,iBAAiB,CAAC;IAEzB;;;;OAIG;IACa,IAAI,CAAU;IAE9B;;OAEG;IACa,OAAO,CAAU;IAEjC,YAAY,OAAe,EAAE,IAAa,EAAE,OAAgB;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AApBD,0CAoBC;AAED;;;;;;;GAOG;AACH,MAAa,gCAAiC,SAAQ,eAAe;IACjE,IAAI,GAAG,kCAAkC,CAAC;IAE1B,eAAe,CAAU;IAEzB,0BAA0B,CAAU;IAEpD,YAAY,OAAe,EAAE,IAAY,EAAE,eAAwB,EAAE,0BAA0B,GAAG,KAAK;QACnG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,0BAA0B,GAAG,0BAA0B,CAAC;IACjE,CAAC;CACJ;AAZD,4EAYC;AAED;;;;;;;;GAQG;AACH,MAAa,WAAY,SAAQ,gBAAgB;IAC7C,IAAI,GAAG,aAAa,CAAC;IAErB;;;;OAIG;IACa,UAAU,CAAU;IACpC;;;;OAIG;IACa,IAAI,CAAU;CACjC;AAfD,kCAeC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAa,gBAAiB,SAAQ,WAAW;IAC7C,IAAI,GAAG,kBAAkB,CAAC;IAE1B,IAAI,GAAG,GAAG,CAAC;CACd;AAJD,4CAIC;AAED;;;;;;;GAOG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,IAAI,GAAG,iBAAiB,CAAC;CAC5B;AAFD,0CAEC;AAED;;;;;;;;;GASG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,IAAI,GAAG,iBAAiB,CAAC;CAC5B;AAFD,0CAEC;AAED;;;;;;;GAOG;AACH,MAAa,cAAe,SAAQ,gBAAgB;IAChD,IAAI,GAAG,gBAAgB,CAAC;IAER,KAAK,CAAU;IAE/B,YAAY,OAAe,EAAE,KAAc;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;CACJ;AATD,wCASC"}

package/dist/interface/config.d.ts

@@ -0,0 +1,26 @@
+export type ProtonDriveConfig = {
+    /**
+     * The base URL for the Proton Drive (without schema).
+     *
+     * If not provided, defaults to 'drive-api.proton.me'.
+     */
+    baseUrl?: string;
+    /**
+     * The language to use for error messages.
+     *
+     * If not provided, defaults to 'en'.
+     */
+    language?: string;
+    /**
+     * Client UID is used to identify the client for the upload.
+     *
+     * If the upload failed because of the existing draft, the SDK will
+     * automatically clean up the existing draft and start a new upload.
+     * If the client UID doesn't match, the SDK throws and then you need
+     * to explicitely ask the user to override the existing draft.
+     *
+     * You can force the upload by setting up
+     * `overrideExistingDraftByOtherClient` to true.
+     */
+    clientUid?: string;
+};

package/dist/interface/config.js

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

package/dist/interface/config.js.map

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

package/dist/interface/download.d.ts

@@ -14,13 +14,13 @@ export interface FileDownloader {
      *
      * @param onProgress - Callback that is called with the number of downloaded bytes
      */
-    writeToStream(streamFactory: WritableStream, onProgress: (downloadedBytes: number) => void): DownloadController;
+    writeToStream(streamFactory: WritableStream, onProgress?: (downloadedBytes: number) => void): DownloadController;
     /**
      * Same as `writeToStream` but without verification checks.
      *
      * Use this only for debugging purposes.
      */
-    unsafeWriteToStream(streamFactory: WritableStream, onProgress: (downloadedBytes: number) => void): DownloadController;
+    unsafeWriteToStream(streamFactory: WritableStream, onProgress?: (downloadedBytes: number) => void): DownloadController;
 }
 export interface DownloadController {
     pause(): void;

package/dist/interface/events.d.ts

@@ -1,26 +1,66 @@
-import { Device } from './devices';
-import { MaybeNode } from './nodes';
-export type DeviceEventCallback = (deviceEvent: DeviceEvent) => void;
-export type NodeEventCallback = (nodeEvent: NodeEvent) => void;
-export type NodeEvent = {
-    type: 'update';
-    uid: string;
-    node: MaybeNode;
-} | {
-    type: 'remove';
-    uid: string;
-};
-export type DeviceEvent = {
-    type: 'update';
-    uid: string;
-    device: Device;
-} | {
-    type: 'remove';
-    uid: string;
-};
 export declare enum SDKEvent {
     TransfersPaused = "transfersPaused",
     TransfersResumed = "transfersResumed",
     RequestsThrottled = "requestsThrottled",
     RequestsUnthrottled = "requestsUnthrottled"
 }
+export interface LatestEventIdProvider {
+    getLatestEventId(treeEventScopeId: string): string | null;
+}
+/**
+ * Callback that accepts list of Drive events and flag whether no
+ * event should be processed, but rather full cache refresh should be
+ * performed.
+ *
+ * Drive listeners should never throw and be wrapped in a try-catch loop.
+ *
+ * @param fullRefreshVolumeId - ID of the volume that should be fully refreshed.
+ */
+export type DriveListener = (event: DriveEvent) => Promise<void>;
+type NodeCruEventType = DriveEventType.NodeCreated | DriveEventType.NodeUpdated;
+export type NodeEvent = {
+    type: NodeCruEventType;
+    nodeUid: string;
+    parentNodeUid?: string;
+    isTrashed: boolean;
+    isShared: boolean;
+    treeEventScopeId: string;
+    eventId: string;
+} | {
+    type: DriveEventType.NodeDeleted;
+    nodeUid: string;
+    parentNodeUid?: string;
+    treeEventScopeId: string;
+    eventId: string;
+};
+export type FastForwardEvent = {
+    type: DriveEventType.FastForward;
+    treeEventScopeId: string;
+    eventId: string;
+};
+export type TreeRefreshEvent = {
+    type: DriveEventType.TreeRefresh;
+    treeEventScopeId: string;
+    eventId: string;
+};
+export type TreeRemovalEvent = {
+    type: DriveEventType.TreeRemove;
+    treeEventScopeId: string;
+    eventId: 'none';
+};
+export type SharedWithMeUpdated = {
+    type: DriveEventType.SharedWithMeUpdated;
+    eventId: string;
+    treeEventScopeId: 'core';
+};
+export type DriveEvent = NodeEvent | FastForwardEvent | TreeRefreshEvent | TreeRemovalEvent | FastForwardEvent | SharedWithMeUpdated;
+export declare enum DriveEventType {
+    NodeCreated = "node_created",
+    NodeUpdated = "node_updated",
+    NodeDeleted = "node_deleted",
+    SharedWithMeUpdated = "shared_with_me_updated",
+    TreeRefresh = "tree_refresh",
+    TreeRemove = "tree_remove",
+    FastForward = "fast_forward"
+}
+export {};

package/dist/interface/events.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDKEvent = void 0;
+exports.DriveEventType = exports.SDKEvent = void 0;
 var SDKEvent;
 (function (SDKEvent) {
     SDKEvent["TransfersPaused"] = "transfersPaused";
@@ -8,4 +8,14 @@ var SDKEvent;
     SDKEvent["RequestsThrottled"] = "requestsThrottled";
     SDKEvent["RequestsUnthrottled"] = "requestsUnthrottled";
 })(SDKEvent || (exports.SDKEvent = SDKEvent = {}));
+var DriveEventType;
+(function (DriveEventType) {
+    DriveEventType["NodeCreated"] = "node_created";
+    DriveEventType["NodeUpdated"] = "node_updated";
+    DriveEventType["NodeDeleted"] = "node_deleted";
+    DriveEventType["SharedWithMeUpdated"] = "shared_with_me_updated";
+    DriveEventType["TreeRefresh"] = "tree_refresh";
+    DriveEventType["TreeRemove"] = "tree_remove";
+    DriveEventType["FastForward"] = "fast_forward";
+})(DriveEventType || (exports.DriveEventType = DriveEventType = {}));
 //# sourceMappingURL=events.js.map

package/dist/interface/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/interface/events.ts"],"names":[],"mappings":";;;AAwBA,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,+CAAmC,CAAA;IACnC,iDAAqC,CAAA;IACrC,mDAAuC,CAAA;IACvC,uDAA2C,CAAA;AAC/C,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/interface/events.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,+CAAmC,CAAA;IACnC,iDAAqC,CAAA;IACrC,mDAAuC,CAAA;IACvC,uDAA2C,CAAA;AAC/C,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AA6DD,IAAY,cAQX;AARD,WAAY,cAAc;IACtB,8CAA4B,CAAA;IAC5B,8CAA4B,CAAA;IAC5B,8CAA4B,CAAA;IAC5B,gEAA8C,CAAA;IAC9C,8CAA4B,CAAA;IAC5B,4CAA0B,CAAA;IAC1B,8CAA4B,CAAA;AAChC,CAAC,EARW,cAAc,8BAAd,cAAc,QAQzB"}

package/dist/interface/httpClient.d.ts

@@ -21,18 +21,4 @@ type ProtonDriveHTTPClientBaseOptions = {
     timeoutMs: number;
     signal?: AbortSignal;
 };
-export type ProtonDriveConfig = {
-    /**
-     * The base URL for the Proton Drive (without schema).
-     *
-     * If not provided, defaults to 'drive-api.proton.me'.
-     */
-    baseUrl?: string;
-    /**
-     * The language to use for error messages.
-     *
-     * If not provided, defaults to 'en'.
-     */
-    language?: string;
-};
 export {};

package/dist/interface/index.d.ts

@@ -1,25 +1,28 @@
 import { ProtonDriveCache } from '../cache';
 import { OpenPGPCrypto, PrivateKey, SessionKey, SRPModule } from '../crypto';
+import { LatestEventIdProvider } from '../internal/events/interface';
 import { ProtonDriveAccount } from './account';
-import { ProtonDriveHTTPClient, ProtonDriveConfig } from './httpClient';
+import { ProtonDriveConfig } from './config';
+import { ProtonDriveHTTPClient } from './httpClient';
 import { Telemetry, MetricEvent } from './telemetry';
 export type { Result } from './result';
 export { resultOk, resultError } from './result';
 export type { ProtonDriveAccount, ProtonDriveAccountAddress } from './account';
 export type { Author, UnverifiedAuthorError, AnonymousUser } from './author';
+export type { ProtonDriveConfig } from './config';
 export type { Device, DeviceOrUid } from './devices';
 export { DeviceType } from './devices';
 export type { FileDownloader, DownloadController } from './download';
-export type { NodeEvent, DeviceEvent, DeviceEventCallback, NodeEventCallback } from './events';
-export { SDKEvent } from './events';
-export type { ProtonDriveHTTPClient, ProtonDriveHTTPClientJsonOptions, ProtonDriveHTTPClientBlobOptions, ProtonDriveConfig } from './httpClient';
+export type { DriveListener, LatestEventIdProvider, DriveEvent } from './events';
+export { DriveEventType, SDKEvent } from './events';
+export type { ProtonDriveHTTPClient, ProtonDriveHTTPClientJsonOptions, ProtonDriveHTTPClientBlobOptions } from './httpClient';
 export type { MaybeNode, NodeEntity, DegradedNode, MaybeMissingNode, MissingNode, InvalidNameError, Revision, NodeOrUid, RevisionOrUid, NodeResult } from './nodes';
 export { NodeType, MemberRole, RevisionState } from './nodes';
 export type { ProtonInvitation, ProtonInvitationWithNode, NonProtonInvitation, Member, PublicLink, MaybeBookmark, Bookmark, DegradedBookmark, ProtonInvitationOrUid, NonProtonInvitationOrUid, BookmarkOrUid, ShareNodeSettings, UnshareNodeSettings, ShareMembersSettings, SharePublicLinkSettings, SharePublicLinkSettingsObject, ShareResult } from './sharing';
 export { NonProtonInvitationState } from './sharing';
 export type { Telemetry, Logger, MetricAPIRetrySucceededEvent, MetricUploadEvent, MetricsUploadErrorType, MetricDownloadEvent, MetricsDownloadErrorType, MetricDecryptionErrorEvent, MetricsDecryptionErrorField, MetricVerificationErrorEvent, MetricVerificationErrorField, MetricBlockVerificationErrorEvent, MetricVolumeEventsSubscriptionsChangedEvent, MetricEvent } from './telemetry';
 export { MetricVolumeType } from './telemetry';
-export type { Fileuploader, UploadController, UploadMetadata } from './upload';
+export type { FileUploader, FileRevisionUploader, UploadController, UploadMetadata } from './upload';
 export type { Thumbnail, ThumbnailResult } from './thumbnail';
 export { ThumbnailType } from './thumbnail';
 export type ProtonDriveTelemetry = Telemetry<MetricEvent>;
@@ -40,4 +43,5 @@ export interface ProtonDriveClientContructorParameters {
     srpModule: SRPModule;
     config?: ProtonDriveConfig;
     telemetry?: ProtonDriveTelemetry;
+    latestEventIdProvider?: LatestEventIdProvider;
 }

package/dist/interface/index.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ThumbnailType = exports.MetricVolumeType = exports.NonProtonInvitationState = exports.RevisionState = exports.MemberRole = exports.NodeType = exports.SDKEvent = exports.DeviceType = exports.resultError = exports.resultOk = void 0;
+exports.ThumbnailType = exports.MetricVolumeType = exports.NonProtonInvitationState = exports.RevisionState = exports.MemberRole = exports.NodeType = exports.SDKEvent = exports.DriveEventType = exports.DeviceType = exports.resultError = exports.resultOk = void 0;
 var result_1 = require("./result");
 Object.defineProperty(exports, "resultOk", { enumerable: true, get: function () { return result_1.resultOk; } });
 Object.defineProperty(exports, "resultError", { enumerable: true, get: function () { return result_1.resultError; } });
 var devices_1 = require("./devices");
 Object.defineProperty(exports, "DeviceType", { enumerable: true, get: function () { return devices_1.DeviceType; } });
 var events_1 = require("./events");
+Object.defineProperty(exports, "DriveEventType", { enumerable: true, get: function () { return events_1.DriveEventType; } });
 Object.defineProperty(exports, "SDKEvent", { enumerable: true, get: function () { return events_1.SDKEvent; } });
 var nodes_1 = require("./nodes");
 Object.defineProperty(exports, "NodeType", { enumerable: true, get: function () { return nodes_1.NodeType; } });

package/dist/interface/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interface/index.ts"],"names":[],"mappings":";;;AAOA,mCAAiD;AAAxC,kGAAA,QAAQ,OAAA;AAAE,qGAAA,WAAW,OAAA;AAI9B,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAGnB,mCAAoC;AAA3B,kGAAA,QAAQ,OAAA;AAGjB,iCAA8D;AAArD,iGAAA,QAAQ,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAE5C,qCAAqD;AAA5C,mHAAA,wBAAwB,OAAA;AAEjC,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AAGzB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AAqBrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interface/index.ts"],"names":[],"mappings":";;;AASA,mCAAiD;AAAxC,kGAAA,QAAQ,OAAA;AAAE,qGAAA,WAAW,OAAA;AAK9B,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAGnB,mCAAoD;AAA3C,wGAAA,cAAc,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAGjC,iCAA8D;AAArD,iGAAA,QAAQ,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAE5C,qCAAqD;AAA5C,mHAAA,wBAAwB,OAAA;AAEjC,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AAGzB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AAsBrB,CAAC"}

package/dist/interface/nodes.d.ts

@@ -83,6 +83,15 @@ export type NodeEntity = {
     folder?: {
         claimedModificationTime?: Date;
     };
+    /**
+     * Provides an ID for the event scope.
+     *
+     * By subscribing to events in a scope, all updates to nodes
+     * withing that scope will be passed to the client. The scope can
+     * comprise one or more folder trees and will be shared by all
+     * nodes in the tree. Nodes cannot change scopes.
+     */
+    treeEventScopeId: string;
 };
 /**
  * Degraded node representing a file or folder in the system.
@@ -127,7 +136,18 @@ export type InvalidNameError = {
 };
 export declare enum NodeType {
     File = "file",
-    Folder = "folder"
+    Folder = "folder",
+    /**
+     * Album is a special type available only in Photos section.
+     *
+     * The SDK does not support any album-specific actions, but it can load
+     * the node and do general operations on it, such as sharing. However,
+     * you should not rely that anything can work. It is not guaranteed that
+     * and in the future specific Photos SDK will support albums.
+     *
+     * @deprecated This type is not part of the public API.
+     */
+    Album = "album"
 }
 export declare enum MemberRole {
     Viewer = "viewer",

package/dist/interface/nodes.js

@@ -5,6 +5,17 @@ var NodeType;
 (function (NodeType) {
     NodeType["File"] = "file";
     NodeType["Folder"] = "folder";
+    /**
+     * Album is a special type available only in Photos section.
+     *
+     * The SDK does not support any album-specific actions, but it can load
+     * the node and do general operations on it, such as sharing. However,
+     * you should not rely that anything can work. It is not guaranteed that
+     * and in the future specific Photos SDK will support albums.
+     *
+     * @deprecated This type is not part of the public API.
+     */
+    NodeType["Album"] = "album";
 })(NodeType || (exports.NodeType = NodeType = {}));
 var MemberRole;
 (function (MemberRole) {

package/dist/interface/nodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/interface/nodes.ts"],"names":[],"mappings":";;;AAsIA,IAAY,QAGX;AAHD,WAAY,QAAQ;IAChB,yBAAa,CAAA;IACb,6BAAiB,CAAA;AACrB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB;AAED,IAAY,UAKX;AALD,WAAY,UAAU;IAClB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,6BAAe,CAAA;IACf,qCAAuB,CAAA;AAC3B,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB;AAsBD,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,0CAAyB,CAAA;AAC7B,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB"}
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/interface/nodes.ts"],"names":[],"mappings":";;;AA+IA,IAAY,QAcX;AAdD,WAAY,QAAQ;IAChB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB;;;;;;;;;OASG;IACH,2BAAe,CAAA;AACnB,CAAC,EAdW,QAAQ,wBAAR,QAAQ,QAcnB;AAED,IAAY,UAKX;AALD,WAAY,UAAU;IAClB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,6BAAe,CAAA;IACf,qCAAuB,CAAA;AAC3B,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB;AAsBD,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,0CAAyB,CAAA;AAC7B,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB"}

package/dist/interface/sharing.d.ts

@@ -30,6 +30,7 @@ export type PublicLink = {
     url: string;
     customPassword?: string;
     expirationTime?: Date;
+    numberOfInitializedDownloads: number;
 };
 /**
  * Bookmark representing a saved link to publicly shared node.

package/dist/interface/upload.d.ts

@@ -1,13 +1,67 @@
 import { Thumbnail } from "./thumbnail";
 export type UploadMetadata = {
     mediaType: string;
+    /**
+     * Expected size of the file.
+     *
+     * The file size is used to verify the integrity of the file during upload.
+     * If the expected size does not match the actual size, the upload will
+     * fail.
+     */
     expectedSize: number;
+    /**
+     * Modification time of the file.
+     *
+     * The modification time will be encrypted and stored with the file.
+     */
     modificationTime?: Date;
+    /**
+     * Additional metadata to be stored with the file.
+     *
+     * These metadata must be object that can be serialized to JSON.
+     *
+     * The metadata will be encrypted and stored with the file.
+     */
     additionalMetadata?: object;
+    /**
+     * If there is an existing draft by another client, the upload will be
+     * rejected. If user decides to override the existing draft and continue
+     * with the upload, set this to true.
+     */
+    overrideExistingDraftByOtherClient?: boolean;
 };
-export interface Fileuploader {
-    writeStream(stream: ReadableStream, thumnbails: Thumbnail[], onProgress?: (uploadedBytes: number) => void): UploadController;
-    writeFile(fileObject: File, thumnbails: Thumbnail[], onProgress?: (uploadedBytes: number) => void): UploadController;
+export interface FileRevisionUploader {
+    /**
+     * Uploads a file from a stream.
+     *
+     * The function will resolve to a controller that can be used to pause,
+     * resume and complete the upload.
+     *
+     * The function will reject if the node with the given name already exists.
+     */
+    writeStream(stream: ReadableStream, thumnbails: Thumbnail[], onProgress?: (uploadedBytes: number) => void): Promise<UploadController>;
+    /**
+     * Uploads a file from a file object. It is convenient to use this method
+     * when the file is already in memory. The file object is used to get the
+     * metadata, such as the media type, size or modification time.
+     *
+     * The function will resolve to a controller that can be used to pause,
+     * resume and complete the upload.
+     *
+     * The function will reject if the node with the given name already exists.
+     */
+    writeFile(fileObject: File, thumnbails: Thumbnail[], onProgress?: (uploadedBytes: number) => void): 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;