/* Copyright 2024 New Vector Ltd. Copyright 2024 The Matrix.org Foundation C.I.C. SPDX-License-Identifier: AGPL-3.0-only OR GPL-3.0-only OR LicenseRef-Element-Commercial Please see LICENSE files in the repository root for full details. */ import "fake-indexeddb/auto"; import { IDBFactory } from "fake-indexeddb"; import { IndexedDBCryptoStore } from "matrix-js-sdk/src/matrix"; import { logger } from "matrix-js-sdk/src/logger"; import * as StorageManager from "../../../src/utils/StorageManager"; const LEGACY_CRYPTO_STORE_NAME = "matrix-js-sdk:crypto"; const RUST_CRYPTO_STORE_NAME = "matrix-js-sdk::matrix-sdk-crypto"; describe("StorageManager", () => { async function createDB(name: string, withStores: string[] | undefined = undefined): Promise { const request = indexedDB.open(name); return new Promise((resolve, reject) => { request.onupgradeneeded = function (event) { const db = request.result; if (withStores) { withStores.forEach((storeName) => { db.createObjectStore(storeName); }); } }; request.onsuccess = function (event) { const db = request.result; resolve(db); }; request.onerror = function (event) { reject(event); }; }); } async function populateLegacyStore(migrationState: number | undefined) { const db = await createDB(LEGACY_CRYPTO_STORE_NAME, [IndexedDBCryptoStore.STORE_ACCOUNT]); if (migrationState) { const transaction = db.transaction([IndexedDBCryptoStore.STORE_ACCOUNT], "readwrite"); const store = transaction.objectStore(IndexedDBCryptoStore.STORE_ACCOUNT); store.put(migrationState, "migrationState"); await new Promise((resolve, reject) => { transaction.oncomplete = resolve; transaction.onerror = reject; }); } } beforeEach(() => { global.structuredClone = (v) => JSON.parse(JSON.stringify(v)); }); describe("Crypto store checks", () => { async function populateHealthySession() { // Storage manager only check for the existence of the `riot-web-sync` store, so just create one. await createDB("riot-web-sync"); } beforeEach(async () => { await populateHealthySession(); indexedDB = new IDBFactory(); }); it("should not be ok if sync store but no crypto store", async () => { const result = await StorageManager.checkConsistency(); expect(result.healthy).toBe(true); expect(result.dataInCryptoStore).toBe(false); }); it("should be ok if sync store and a rust crypto store", async () => { await createDB(RUST_CRYPTO_STORE_NAME); const result = await StorageManager.checkConsistency(); expect(result.healthy).toBe(true); expect(result.dataInCryptoStore).toBe(true); }); describe("without rust store", () => { it("should be ok if there is non migrated legacy crypto store", async () => { await populateLegacyStore(undefined); const result = await StorageManager.checkConsistency(); expect(result.healthy).toBe(true); expect(result.dataInCryptoStore).toBe(true); }); it("should be ok if legacy store in MigrationState `NOT_STARTED`", async () => { await populateLegacyStore(0 /* MigrationState.NOT_STARTED*/); const result = await StorageManager.checkConsistency(); expect(result.healthy).toBe(true); expect(result.dataInCryptoStore).toBe(true); }); it("should not be ok if MigrationState greater than `NOT_STARTED`", async () => { await populateLegacyStore(1 /*INITIAL_DATA_MIGRATED*/); const result = await StorageManager.checkConsistency(); expect(result.healthy).toBe(true); expect(result.dataInCryptoStore).toBe(false); }); it("should not be healthy if no indexeddb", async () => { indexedDB = {} as IDBFactory; const result = await StorageManager.checkConsistency(); expect(result.healthy).toBe(false); indexedDB = new IDBFactory(); }); }); }); describe("tryPersistStorage", () => { // jsdom does not implement navigator.storage, so stub it per-test; jest.replaceProperty // cannot be used as it refuses to replace a property that does not exist. function setStorage(value: unknown): void { Object.defineProperty(navigator, "storage", { value, configurable: true }); } beforeEach(() => { jest.spyOn(logger, "log").mockImplementation(() => {}); jest.spyOn(logger, "warn").mockImplementation(() => {}); jest.spyOn(logger, "error").mockImplementation(() => {}); }); afterEach(() => { delete (navigator as unknown as { storage?: unknown }).storage; jest.restoreAllMocks(); }); it("returns true and does not re-request when storage is already persisted", async () => { const persist = jest.fn().mockResolvedValue(true); const persisted = jest.fn().mockResolvedValue(true); setStorage({ persist, persisted }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(true); expect(persisted).toHaveBeenCalled(); expect(persist).not.toHaveBeenCalled(); expect(logger.warn).not.toHaveBeenCalled(); }); it("requests persistence and returns true when granted", async () => { const persist = jest.fn().mockResolvedValue(true); const persisted = jest.fn().mockResolvedValue(false); setStorage({ persist, persisted }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(true); expect(persist).toHaveBeenCalled(); expect(logger.warn).not.toHaveBeenCalled(); }); it("requests persistence directly when persisted() is unavailable", async () => { const persist = jest.fn().mockResolvedValue(true); setStorage({ persist }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(true); expect(persist).toHaveBeenCalledTimes(1); }); it("still requests persistence and logs the failure when querying the persisted state fails", async () => { const queryError = new Error("query failed"); const persisted = jest.fn().mockRejectedValue(queryError); const persist = jest.fn().mockResolvedValue(true); setStorage({ persist, persisted }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(true); expect(persist).toHaveBeenCalled(); expect(logger.warn).toHaveBeenCalledWith(expect.stringContaining("Could not query"), queryError); }); it("returns false and warns when persistence is denied", async () => { const persist = jest.fn().mockResolvedValue(false); const persisted = jest.fn().mockResolvedValue(false); setStorage({ persist, persisted }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(false); expect(logger.warn).toHaveBeenCalledWith(expect.stringContaining("Persistent storage")); }); it("returns false when navigator.storage lacks persist()", async () => { setStorage({ persisted: jest.fn().mockResolvedValue(false) }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(false); expect(logger.log).toHaveBeenCalledWith(expect.stringContaining("unsupported")); }); it("returns false without throwing when persistence is unsupported", async () => { await expect(StorageManager.tryPersistStorage()).resolves.toBe(false); }); it("does not reject but logs an error if requesting persistence throws", async () => { const persist = jest.fn().mockRejectedValue(new Error("boom")); const persisted = jest.fn().mockResolvedValue(false); setStorage({ persist, persisted }); await expect(StorageManager.tryPersistStorage()).resolves.toBe(false); expect(logger.error).toHaveBeenCalled(); }); }); });