@protontech/drive-sdk 0.0.10

package/dist/internal/events/eventManager.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventManager = void 0;
+const apiService_1 = require("../apiService");
+const DEFAULT_POLLING_INTERVAL_IN_SECONDS = 30;
+const FIBONACCI_LIST = [1, 1, 2, 3, 5, 8, 13];
+/**
+ * Event manager general helper that is responsible for fetching events
+ * from the server and notifying listeners about the events.
+ *
+ * The specific implementation of fetching the events from the API must
+ * be passed as dependency and can be used for any type of events that
+ * supports the same structure.
+ *
+ * The manager will not start fetching events until the `start` method is
+ * called. Once started, the manager will fetch events in a loop with
+ * a timeout between each fetch. The default timeout is 30 seconds and
+ * additional jitter is used in case of failure.
+ *
+ * Example of usage:
+ *
+ * ```typescript
+ * const manager = new EventManager(
+ *    logger,
+ *    () => apiService.getLatestEventId(),
+ *    (eventId) => apiService.getEvents(eventId),
+ * );
+ *
+ * manager.addListener((events, fullRefresh) => {
+ *   // Process the events
+ * });
+ *
+ * manager.start();
+ * ```
+ */
+class EventManager {
+    logger;
+    getLatestEventId;
+    getEvents;
+    updateLatestEventId;
+    latestEventId;
+    timeoutHandle;
+    processPromise;
+    listeners = [];
+    retryIndex = 0;
+    pollingIntervalInSeconds = DEFAULT_POLLING_INTERVAL_IN_SECONDS;
+    constructor(logger, getLatestEventId, getEvents, updateLatestEventId) {
+        this.logger = logger;
+        this.getLatestEventId = getLatestEventId;
+        this.getEvents = getEvents;
+        this.updateLatestEventId = updateLatestEventId;
+        this.logger = logger;
+        this.getLatestEventId = getLatestEventId;
+        this.getEvents = getEvents;
+        this.updateLatestEventId = updateLatestEventId;
+    }
+    addListener(callback) {
+        this.listeners.push(callback);
+    }
+    async start() {
+        this.logger.info(`Starting event manager with polling interval ${this.pollingIntervalInSeconds} seconds`);
+        await this.stop();
+        this.processPromise = this.processEvents();
+    }
+    async processEvents() {
+        try {
+            if (!this.latestEventId) {
+                this.latestEventId = await this.getLatestEventId();
+                await this.updateLatestEventId(this.latestEventId);
+            }
+            else {
+                while (true) {
+                    let result;
+                    try {
+                        result = await this.getEvents(this.latestEventId);
+                    }
+                    catch (error) {
+                        // If last event ID is not found, we need to refresh the data.
+                        // Caller is notified via standard event update with refresh flag.
+                        if (error instanceof apiService_1.NotFoundAPIError) {
+                            this.logger.warn(`Last event ID not found, refreshing data`);
+                            result = {
+                                lastEventId: await this.getLatestEventId(),
+                                more: false,
+                                refresh: true,
+                                events: [],
+                            };
+                        }
+                        else {
+                            // Any other error is considered as a failure and we will retry
+                            // with backoff policy.
+                            throw error;
+                        }
+                    }
+                    await this.notifyListeners(result);
+                    if (result.lastEventId !== this.latestEventId) {
+                        await this.updateLatestEventId(result.lastEventId);
+                        this.latestEventId = result.lastEventId;
+                    }
+                    if (!result.more) {
+                        break;
+                    }
+                }
+            }
+            this.retryIndex = 0;
+        }
+        catch (error) {
+            this.logger.error(`Failed to process events: ${error instanceof Error ? error.message : error} (retry ${this.retryIndex}, last event ID: ${this.latestEventId})`);
+            this.retryIndex++;
+        }
+        this.timeoutHandle = setTimeout(() => {
+            this.processPromise = this.processEvents();
+        }, this.nextPollTimeout);
+    }
+    ;
+    async notifyListeners(result) {
+        if (result.events.length === 0 && !result.refresh) {
+            return;
+        }
+        if (!this.listeners.length) {
+            return;
+        }
+        this.logger.debug(`Notifying listeners about ${result.events.length} events`);
+        for (const listener of this.listeners) {
+            try {
+                await listener(result.events, result.refresh);
+            }
+            catch (error) {
+                this.logger.error(`Failed to process events: ${error instanceof Error ? error.message : error} (last event ID: ${result.lastEventId}, refresh: ${result.refresh})`);
+                throw error;
+            }
+        }
+    }
+    /**
+     * Polling timeout is using exponential backoff with Fibonacci sequence.
+     *
+     * The timeout is public for testing purposes only.
+     */
+    get nextPollTimeout() {
+        const retryIndex = Math.min(this.retryIndex, FIBONACCI_LIST.length - 1);
+        return this.pollingIntervalInSeconds * 1000 * FIBONACCI_LIST[retryIndex];
+    }
+    async stop() {
+        if (this.processPromise) {
+            this.logger.info(`Stopping event manager`);
+            try {
+                await this.processPromise;
+            }
+            catch { }
+        }
+        if (!this.timeoutHandle) {
+            return;
+        }
+        clearTimeout(this.timeoutHandle);
+        this.timeoutHandle = undefined;
+    }
+}
+exports.EventManager = EventManager;
+//# sourceMappingURL=eventManager.js.map

package/dist/internal/events/eventManager.js.map

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

package/dist/internal/events/eventManager.test.d.ts

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

package/dist/internal/events/eventManager.test.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("../../tests/logger");
+const apiService_1 = require("../apiService");
+const eventManager_1 = require("./eventManager");
+jest.useFakeTimers();
+describe("EventManager", () => {
+    let manager;
+    const getLastEventIdMock = jest.fn();
+    const getEventsMock = jest.fn();
+    const updateLatestEventIdMock = jest.fn();
+    const listenerMock = jest.fn();
+    beforeEach(() => {
+        jest.clearAllMocks();
+        getLastEventIdMock.mockImplementation(() => Promise.resolve("eventId1"));
+        getEventsMock.mockImplementation(() => Promise.resolve({
+            lastEventId: "eventId2",
+            more: false,
+            refresh: false,
+            events: ["event1", "event2"],
+        }));
+        manager = new eventManager_1.EventManager((0, logger_1.getMockLogger)(), getLastEventIdMock, getEventsMock, updateLatestEventIdMock);
+        manager.addListener(listenerMock);
+    });
+    afterEach(async () => {
+        await manager.stop();
+    });
+    it("should get latest event ID on first run only", async () => {
+        await manager.start();
+        expect(getLastEventIdMock).toHaveBeenCalledTimes(1);
+        expect(getEventsMock).toHaveBeenCalledTimes(0);
+        expect(listenerMock).toHaveBeenCalledTimes(0);
+        expect(updateLatestEventIdMock).toHaveBeenCalledTimes(1);
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId1');
+    });
+    it("should notify about events in the next run", async () => {
+        await manager.start();
+        expect(getLastEventIdMock).toHaveBeenCalledTimes(1);
+        expect(getEventsMock).toHaveBeenCalledTimes(0);
+        expect(listenerMock).toHaveBeenCalledTimes(0);
+        expect(updateLatestEventIdMock).toHaveBeenCalledTimes(1);
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId1');
+        updateLatestEventIdMock.mockClear();
+        await jest.runOnlyPendingTimersAsync();
+        expect(getEventsMock).toHaveBeenCalledTimes(1);
+        expect(listenerMock).toHaveBeenCalledTimes(1);
+        expect(updateLatestEventIdMock).toHaveBeenCalledTimes(1);
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId2');
+    });
+    it("should continue with more events", async () => {
+        getEventsMock.mockImplementation((lastEventId) => Promise.resolve({
+            lastEventId: lastEventId === "eventId1" ? "eventId2" : "eventId3",
+            more: lastEventId === "eventId1" ? true : false,
+            refresh: false,
+            events: lastEventId === "eventId1" ? ["event1", "event2"] : ["event3"],
+        }));
+        await manager.start();
+        await jest.runOnlyPendingTimersAsync();
+        expect(getEventsMock).toHaveBeenCalledTimes(2);
+        expect(listenerMock).toHaveBeenCalledTimes(2);
+        expect(listenerMock).toHaveBeenCalledWith(["event1", "event2"], false);
+        expect(listenerMock).toHaveBeenCalledWith(["event3"], false);
+        expect(updateLatestEventIdMock).toHaveBeenCalledTimes(3);
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId1');
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId2');
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId3');
+    });
+    it("should refresh if event does not exist", async () => {
+        getEventsMock.mockImplementation(() => Promise.reject(new apiService_1.NotFoundAPIError('Event not found', 2501)));
+        await manager.start();
+        await jest.runOnlyPendingTimersAsync();
+        expect(getLastEventIdMock).toHaveBeenCalledTimes(2);
+        expect(listenerMock).toHaveBeenCalledTimes(1);
+        expect(listenerMock).toHaveBeenCalledWith([], true);
+        expect(updateLatestEventIdMock).toHaveBeenCalledTimes(1);
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId1');
+    });
+    it("should retry on error", async () => {
+        let index = 0;
+        getEventsMock.mockImplementation(() => {
+            index++;
+            if (index <= 3) {
+                return Promise.reject(new Error("Error"));
+            }
+            return Promise.resolve({
+                lastEventId: "eventId2",
+                more: false,
+                refresh: false,
+                events: ["event1", "event2"],
+            });
+        });
+        await manager.start();
+        updateLatestEventIdMock.mockClear();
+        // First failure.
+        await jest.runOnlyPendingTimersAsync();
+        expect(listenerMock).toHaveBeenCalledTimes(0);
+        expect(manager.nextPollTimeout).toBe(30000);
+        // Second failure.
+        await jest.runOnlyPendingTimersAsync();
+        expect(listenerMock).toHaveBeenCalledTimes(0);
+        expect(manager.nextPollTimeout).toBe(60000);
+        // Third failure.
+        await jest.runOnlyPendingTimersAsync();
+        expect(listenerMock).toHaveBeenCalledTimes(0);
+        expect(manager.nextPollTimeout).toBe(90000);
+        // And now it passes.
+        await jest.runOnlyPendingTimersAsync();
+        expect(listenerMock).toHaveBeenCalledTimes(1);
+        expect(listenerMock).toHaveBeenCalledWith(["event1", "event2"], false);
+        expect(updateLatestEventIdMock).toHaveBeenCalledTimes(1);
+        expect(updateLatestEventIdMock).toHaveBeenCalledWith('eventId2');
+    });
+    it("should stop polling", async () => {
+        await manager.start();
+        await manager.stop();
+        await jest.runOnlyPendingTimersAsync();
+        expect(getEventsMock).toHaveBeenCalledTimes(0);
+    });
+});
+//# sourceMappingURL=eventManager.test.js.map

package/dist/internal/events/eventManager.test.js.map

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

package/dist/internal/events/index.d.ts

@@ -0,0 +1,50 @@
+import { ProtonDriveEntitiesCache, ProtonDriveTelemetry } from "../../interface";
+import { DriveAPIService } from "../apiService";
+import { DriveListener } from "./interface";
+export type { DriveEvent, DriveListener } from "./interface";
+export { DriveEventType } from "./interface";
+/**
+ * Service for listening to drive events. The service is responsible for
+ * managing the subscriptions to the events and notifying the listeners
+ * about the new events.
+ */
+export declare class DriveEventsService {
+    private telemetry;
+    private apiService;
+    private cache;
+    private subscribedToRemoteDataUpdates;
+    private listeners;
+    private coreEvents;
+    private volumesEvents;
+    private logger;
+    constructor(telemetry: ProtonDriveTelemetry, apiService: DriveAPIService, driveEntitiesCache: ProtonDriveEntitiesCache);
+    /**
+     * Loads all the subscribed volumes (including core events) from the
+     * cache and starts listening to their events. Any additional volume
+     * that is subscribed to later will be automatically started.
+     */
+    subscribeToRemoteDataUpdates(): Promise<void>;
+    /**
+     * Subscribe to given volume. The volume will be polled for events
+     * with the polling interval depending on the type of the volume.
+     * Own volumes are polled with highest frequency, while others are
+     * polled with lower frequency depending on the total number of
+     * subscriptions.
+     *
+     * @param isOwnVolume - Owned volumes are polled with higher frequency.
+     */
+    listenToVolume(volumeId: string, isOwnVolume?: boolean): Promise<void>;
+    private loadSubscribedVolumeEventServices;
+    private sendNumberOfVolumeSubscriptionsToTelemetry;
+    private createVolumeEventManager;
+    /**
+     * Listen to the drive events. The listener will be called with the
+     * new events as they arrive.
+     *
+     * One call always provides events from withing the same volume. The
+     * second argument of the callback `fullRefreshVolumeId` is thus single
+     * ID and if multiple volumes must be fully refreshed, client will
+     * receive multiple calls.
+     */
+    addListener(callback: DriveListener): void;
+}

package/dist/internal/events/index.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriveEventsService = exports.DriveEventType = void 0;
+const apiService_1 = require("./apiService");
+const cache_1 = require("./cache");
+const coreEventManager_1 = require("./coreEventManager");
+const volumeEventManager_1 = require("./volumeEventManager");
+var interface_1 = require("./interface");
+Object.defineProperty(exports, "DriveEventType", { enumerable: true, get: function () { return interface_1.DriveEventType; } });
+const OWN_VOLUME_POLLING_INTERVAL = 30;
+const OTHER_VOLUME_POLLING_INTERVAL = 60;
+/**
+ * Service for listening to drive events. The service is responsible for
+ * managing the subscriptions to the events and notifying the listeners
+ * about the new events.
+ */
+class DriveEventsService {
+    telemetry;
+    apiService;
+    cache;
+    subscribedToRemoteDataUpdates = false;
+    listeners = [];
+    coreEvents;
+    volumesEvents;
+    logger;
+    constructor(telemetry, apiService, driveEntitiesCache) {
+        this.telemetry = telemetry;
+        this.telemetry = telemetry;
+        this.logger = telemetry.getLogger('events');
+        this.apiService = new apiService_1.EventsAPIService(apiService);
+        this.cache = new cache_1.EventsCache(driveEntitiesCache);
+        // FIXME: Allow to pass own core events manager from the public interface.
+        this.coreEvents = new coreEventManager_1.CoreEventManager(this.logger, this.apiService, this.cache);
+        this.volumesEvents = {};
+    }
+    /**
+     * Loads all the subscribed volumes (including core events) from the
+     * cache and starts listening to their events. Any additional volume
+     * that is subscribed to later will be automatically started.
+     */
+    async subscribeToRemoteDataUpdates() {
+        if (this.subscribedToRemoteDataUpdates) {
+            return;
+        }
+        await this.loadSubscribedVolumeEventServices();
+        this.sendNumberOfVolumeSubscriptionsToTelemetry();
+        this.subscribedToRemoteDataUpdates = true;
+        await this.coreEvents.startSubscription();
+        await Promise.all(Object.values(this.volumesEvents)
+            .map((volumeEvents) => volumeEvents.startSubscription()));
+    }
+    /**
+     * Subscribe to given volume. The volume will be polled for events
+     * with the polling interval depending on the type of the volume.
+     * Own volumes are polled with highest frequency, while others are
+     * polled with lower frequency depending on the total number of
+     * subscriptions.
+     *
+     * @param isOwnVolume - Owned volumes are polled with higher frequency.
+     */
+    async listenToVolume(volumeId, isOwnVolume = false) {
+        await this.loadSubscribedVolumeEventServices();
+        if (this.volumesEvents[volumeId]) {
+            return;
+        }
+        this.logger.debug(`Creating volume event manager for volume ${volumeId}`);
+        const manager = this.createVolumeEventManager(volumeId, isOwnVolume);
+        // FIXME: Use dynamic algorithm to determine polling interval for non-own volumes.
+        manager.setPollingInterval(isOwnVolume ? OWN_VOLUME_POLLING_INTERVAL : OTHER_VOLUME_POLLING_INTERVAL);
+        if (this.subscribedToRemoteDataUpdates) {
+            await manager.startSubscription();
+            this.sendNumberOfVolumeSubscriptionsToTelemetry();
+        }
+    }
+    async loadSubscribedVolumeEventServices() {
+        for (const volumeId of await this.cache.getSubscribedVolumeIds()) {
+            if (!this.volumesEvents[volumeId]) {
+                const isOwnVolume = await this.cache.isOwnVolume(volumeId) || false;
+                this.createVolumeEventManager(volumeId, isOwnVolume);
+            }
+        }
+    }
+    sendNumberOfVolumeSubscriptionsToTelemetry() {
+        this.telemetry.logEvent({
+            eventName: 'volumeEventsSubscriptionsChanged',
+            numberOfVolumeSubscriptions: Object.keys(this.volumesEvents).length,
+        });
+    }
+    createVolumeEventManager(volumeId, isOwnVolume) {
+        const manager = new volumeEventManager_1.VolumeEventManager(this.logger, this.apiService, this.cache, volumeId, isOwnVolume);
+        for (const listener of this.listeners) {
+            manager.addListener(listener);
+        }
+        this.volumesEvents[volumeId] = manager;
+        return manager;
+    }
+    /**
+     * Listen to the drive events. The listener will be called with the
+     * new events as they arrive.
+     *
+     * One call always provides events from withing the same volume. The
+     * second argument of the callback `fullRefreshVolumeId` is thus single
+     * ID and if multiple volumes must be fully refreshed, client will
+     * receive multiple calls.
+     */
+    addListener(callback) {
+        // Add new listener to the list for any new event manager.
+        this.listeners.push(callback);
+        // Add new listener to all existings managers.
+        this.coreEvents.addListener(callback);
+        for (const volumeEvents of Object.values(this.volumesEvents)) {
+            volumeEvents.addListener(callback);
+        }
+    }
+}
+exports.DriveEventsService = DriveEventsService;
+//# sourceMappingURL=index.js.map

package/dist/internal/events/index.js.map

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

package/dist/internal/events/interface.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Callback that accepts list of Drive events and flag whether no
+ * event should be processed, but rather full cache refresh should be
+ * performed.
+ *
+ * @param fullRefreshVolumeId - ID of the volume that should be fully refreshed.
+ */
+export type DriveListener = (events: DriveEvent[], fullRefreshVolumeId?: string) => Promise<void>;
+/**
+ * Generic internal event interface representing a list of events
+ * with metadata about the last event ID, whether there are more
+ * events to fetch, or whether the listener should refresh its state.
+ */
+export type Events<T> = {
+    lastEventId: string;
+    more: boolean;
+    refresh: boolean;
+    events: T[];
+};
+/**
+ * Internal event interface representing a list of specific Drive events.
+ */
+export type DriveEvents = Events<DriveEvent>;
+export type DriveEvent = {
+    type: DriveEventType.NodeCreated | DriveEventType.NodeUpdated | DriveEventType.NodeUpdatedMetadata;
+    nodeUid: string;
+    parentNodeUid?: string;
+    isTrashed: boolean;
+    isShared: boolean;
+    isOwnVolume: boolean;
+} | {
+    type: DriveEventType.NodeDeleted;
+    nodeUid: string;
+    parentNodeUid?: string;
+    isTrashed?: boolean;
+    isShared?: boolean;
+    isOwnVolume: boolean;
+} | {
+    type: DriveEventType.ShareWithMeUpdated;
+};
+export declare enum DriveEventType {
+    NodeCreated = "node_created",
+    NodeUpdated = "node_updated",
+    NodeUpdatedMetadata = "node_updated_metadata",
+    NodeDeleted = "node_deleted",
+    ShareWithMeUpdated = "share_with_me_updated"
+}

package/dist/internal/events/interface.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriveEventType = void 0;
+var DriveEventType;
+(function (DriveEventType) {
+    DriveEventType["NodeCreated"] = "node_created";
+    DriveEventType["NodeUpdated"] = "node_updated";
+    DriveEventType["NodeUpdatedMetadata"] = "node_updated_metadata";
+    DriveEventType["NodeDeleted"] = "node_deleted";
+    DriveEventType["ShareWithMeUpdated"] = "share_with_me_updated";
+})(DriveEventType || (exports.DriveEventType = DriveEventType = {}));
+//# sourceMappingURL=interface.js.map

package/dist/internal/events/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/internal/events/interface.ts"],"names":[],"mappings":";;;AA4CA,IAAY,cAMX;AAND,WAAY,cAAc;IACtB,8CAA4B,CAAA;IAC5B,8CAA4B,CAAA;IAC5B,+DAA6C,CAAA;IAC7C,8CAA4B,CAAA;IAC5B,8DAA4C,CAAA;AAChD,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB"}

package/dist/internal/events/volumeEventManager.d.ts

@@ -0,0 +1,27 @@
+import { Logger } from "../../interface";
+import { EventsAPIService } from "./apiService";
+import { EventsCache } from "./cache";
+import { DriveListener } from "./interface";
+/**
+ * Combines API and event manager to provide a service for listening to
+ * volume events. Volume events are all about nodes updates. Whenever
+ * there is update to the node metadata or content, the event is emitted.
+ */
+export declare class VolumeEventManager {
+    private apiService;
+    private cache;
+    private volumeId;
+    private manager;
+    constructor(logger: Logger, apiService: EventsAPIService, cache: EventsCache, volumeId: string, isOwnVolume: boolean);
+    private getLastEventId;
+    /**
+     * There is a limit how many volume subscribtions can be active at
+     * the same time. The manager of all volume managers should set the
+     * intervals for each volume accordingly depending on the volume
+     * type or the total number of subscriptions.
+     */
+    setPollingInterval(pollingIntervalInSeconds: number): void;
+    startSubscription(): Promise<void>;
+    stopSubscription(): Promise<void>;
+    addListener(callback: DriveListener): void;
+}

package/dist/internal/events/volumeEventManager.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeEventManager = void 0;
+const telemetry_1 = require("../../telemetry");
+const eventManager_1 = require("./eventManager");
+/**
+ * Combines API and event manager to provide a service for listening to
+ * volume events. Volume events are all about nodes updates. Whenever
+ * there is update to the node metadata or content, the event is emitted.
+ */
+class VolumeEventManager {
+    apiService;
+    cache;
+    volumeId;
+    manager;
+    constructor(logger, apiService, cache, volumeId, isOwnVolume) {
+        this.apiService = apiService;
+        this.cache = cache;
+        this.volumeId = volumeId;
+        this.apiService = apiService;
+        this.volumeId = volumeId;
+        this.manager = new eventManager_1.EventManager(new telemetry_1.LoggerWithPrefix(logger, `volume ${volumeId}`), () => this.getLastEventId(), (eventId) => this.apiService.getVolumeEvents(volumeId, eventId, isOwnVolume), (lastEventId) => this.cache.setLastEventId(volumeId, {
+            lastEventId,
+            pollingIntervalInSeconds: this.manager.pollingIntervalInSeconds,
+            isOwnVolume
+        }));
+        this.cache.getPollingIntervalInSeconds(volumeId)
+            .then((pollingIntervalInSeconds) => {
+            if (pollingIntervalInSeconds) {
+                this.manager.pollingIntervalInSeconds = pollingIntervalInSeconds;
+            }
+        })
+            .catch(() => { });
+    }
+    async getLastEventId() {
+        const lastEventId = await this.cache.getLastEventId(this.volumeId);
+        if (lastEventId) {
+            return lastEventId;
+        }
+        return this.apiService.getVolumeLatestEventId(this.volumeId);
+    }
+    /**
+     * There is a limit how many volume subscribtions can be active at
+     * the same time. The manager of all volume managers should set the
+     * intervals for each volume accordingly depending on the volume
+     * type or the total number of subscriptions.
+     */
+    setPollingInterval(pollingIntervalInSeconds) {
+        this.manager.pollingIntervalInSeconds = pollingIntervalInSeconds;
+    }
+    async startSubscription() {
+        await this.manager.start();
+    }
+    async stopSubscription() {
+        await this.manager.stop();
+    }
+    addListener(callback) {
+        this.manager.addListener(async (events, fullRefresh) => {
+            if (fullRefresh) {
+                await callback([], this.volumeId);
+            }
+            else {
+                await callback(events);
+            }
+        });
+    }
+}
+exports.VolumeEventManager = VolumeEventManager;
+//# sourceMappingURL=volumeEventManager.js.map

package/dist/internal/events/volumeEventManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumeEventManager.js","sourceRoot":"","sources":["../../../src/internal/events/volumeEventManager.ts"],"names":[],"mappings":";;;AACA,+CAAmD;AAInD,iDAA8C;AAE9C;;;;GAIG;AACH,MAAa,kBAAkB;IAGS;IAAsC;IAA4B;IAF9F,OAAO,CAA2B;IAE1C,YAAY,MAAc,EAAU,UAA4B,EAAU,KAAkB,EAAU,QAAgB,EAAE,WAAoB;QAAxG,eAAU,GAAV,UAAU,CAAkB;QAAU,UAAK,GAAL,KAAK,CAAa;QAAU,aAAQ,GAAR,QAAQ,CAAQ;QAClH,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,IAAI,CAAC,OAAO,GAAG,IAAI,2BAAY,CAC3B,IAAI,4BAAgB,CAAC,MAAM,EAAE,UAAU,QAAQ,EAAE,CAAC,EAClD,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAC3B,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAC5E,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE;YACjD,WAAW;YACX,wBAAwB,EAAE,IAAI,CAAC,OAAO,CAAC,wBAAwB;YAC/D,WAAW;SACd,CAAC,CACL,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,QAAQ,CAAC;aAC3C,IAAI,CAAC,CAAC,wBAAwB,EAAE,EAAE;YAC/B,IAAI,wBAAwB,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,wBAAwB,GAAG,wBAAwB,CAAC;YACrE,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,cAAc;QACxB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,IAAI,WAAW,EAAE,CAAC;YACd,OAAO,WAAW,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,wBAAgC;QAC/C,IAAI,CAAC,OAAO,CAAC,wBAAwB,GAAG,wBAAwB,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,iBAAiB;QACnB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,WAAW,CAAC,QAAuB;QAC/B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;YACnD,IAAI,WAAW,EAAE,CAAC;gBACd,MAAM,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACJ,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA7DD,gDA6DC"}