summaryrefslogtreecommitdiff
path: root/packages/taler-wallet-core/src
diff options
context:
space:
mode:
authorFlorian Dold <florian@dold.me>2021-01-13 00:50:56 +0100
committerFlorian Dold <florian@dold.me>2021-01-13 00:50:56 +0100
commit050999a910837f8a5353b1584af2b03bd8dad93d (patch)
tree8b3611476d61be56411be4104194dddda5f6d6c2 /packages/taler-wallet-core/src
parenta5681579fbddb001f5b7118fe705c6643581c722 (diff)
downloadwallet-core-050999a910837f8a5353b1584af2b03bd8dad93d.tar.gz
wallet-core-050999a910837f8a5353b1584af2b03bd8dad93d.tar.bz2
wallet-core-050999a910837f8a5353b1584af2b03bd8dad93d.zip
implement infrastructure for future DB migrations via backup
Diffstat (limited to 'packages/taler-wallet-core/src')
-rw-r--r--packages/taler-wallet-core/src/db.ts182
-rw-r--r--packages/taler-wallet-core/src/headless/helpers.ts5
-rw-r--r--packages/taler-wallet-core/src/index.ts1
-rw-r--r--packages/taler-wallet-core/src/operations/exchanges.ts1
-rw-r--r--packages/taler-wallet-core/src/operations/state.ts3
-rw-r--r--packages/taler-wallet-core/src/types/dbTypes.ts15
-rw-r--r--packages/taler-wallet-core/src/util/query.ts29
-rw-r--r--packages/taler-wallet-core/src/wallet.ts7
8 files changed, 164 insertions, 79 deletions
diff --git a/packages/taler-wallet-core/src/db.ts b/packages/taler-wallet-core/src/db.ts
index b13abac57..aed2ce5cb 100644
--- a/packages/taler-wallet-core/src/db.ts
+++ b/packages/taler-wallet-core/src/db.ts
@@ -1,5 +1,11 @@
-import { Stores } from "./types/dbTypes";
-import { openDatabase, Database, Store, Index } from "./util/query";
+import { MetaStores, Stores } from "./types/dbTypes";
+import {
+ openDatabase,
+ Database,
+ Store,
+ Index,
+ AnyStoreMap,
+} from "./util/query";
import {
IDBFactory,
IDBDatabase,
@@ -14,7 +20,11 @@ import { Logger } from "./util/logging";
* for all previous versions must be written, which should be
* avoided.
*/
-const TALER_DB_NAME = "taler-wallet-prod-v1";
+const TALER_DB_NAME = "taler-wallet-main-v2";
+
+const TALER_META_DB_NAME = "taler-wallet-meta";
+
+const CURRENT_DB_CONFIG_KEY = "currentMainDbName";
/**
* Current database minor version, should be incremented
@@ -23,78 +33,134 @@ const TALER_DB_NAME = "taler-wallet-prod-v1";
* backwards-compatible way or object stores and indices
* are added.
*/
-export const WALLET_DB_MINOR_VERSION = 3;
+export const WALLET_DB_MINOR_VERSION = 1;
const logger = new Logger("db.ts");
-/**
- * Return a promise that resolves
- * to the taler wallet db.
- */
-export function openTalerDatabase(
- idbFactory: IDBFactory,
- onVersionChange: () => void,
-): Promise<IDBDatabase> {
- const onUpgradeNeeded = (
- db: IDBDatabase,
- oldVersion: number,
- newVersion: number,
- upgradeTransaction: IDBTransaction,
- ): void => {
- if (oldVersion === 0) {
- for (const n in Stores) {
- if ((Stores as any)[n] instanceof Store) {
- const si: Store<string, any> = (Stores as any)[n];
- const s = db.createObjectStore(si.name, si.storeParams);
- for (const indexName in si as any) {
- if ((si as any)[indexName] instanceof Index) {
- const ii: Index<string, string, any, any> = (si as any)[
- indexName
- ];
- s.createIndex(ii.indexName, ii.keyPath, ii.options);
- }
+function upgradeFromStoreMap(
+ storeMap: AnyStoreMap,
+ db: IDBDatabase,
+ oldVersion: number,
+ newVersion: number,
+ upgradeTransaction: IDBTransaction,
+): void {
+ if (oldVersion === 0) {
+ for (const n in storeMap) {
+ if ((storeMap as any)[n] instanceof Store) {
+ const si: Store<string, any> = (storeMap as any)[n];
+ const s = db.createObjectStore(si.name, si.storeParams);
+ for (const indexName in si as any) {
+ if ((si as any)[indexName] instanceof Index) {
+ const ii: Index<string, string, any, any> = (si as any)[indexName];
+ s.createIndex(ii.indexName, ii.keyPath, ii.options);
}
}
}
- return;
- }
- if (oldVersion === newVersion) {
- return;
}
- logger.info(`upgrading database from ${oldVersion} to ${newVersion}`);
- for (const n in Stores) {
- if ((Stores as any)[n] instanceof Store) {
- const si: Store<string, any> = (Stores as any)[n];
- let s: IDBObjectStore;
- const storeVersionAdded = si.storeParams?.versionAdded ?? 1;
- if (storeVersionAdded > oldVersion) {
- s = db.createObjectStore(si.name, si.storeParams);
- } else {
- s = upgradeTransaction.objectStore(si.name);
- }
- for (const indexName in si as any) {
- if ((si as any)[indexName] instanceof Index) {
- const ii: Index<string, string, any, any> = (si as any)[indexName];
- const indexVersionAdded = ii.options?.versionAdded ?? 0;
- if (
- indexVersionAdded > oldVersion ||
- storeVersionAdded > oldVersion
- ) {
- s.createIndex(ii.indexName, ii.keyPath, ii.options);
- }
+ return;
+ }
+ if (oldVersion === newVersion) {
+ return;
+ }
+ logger.info(`upgrading database from ${oldVersion} to ${newVersion}`);
+ for (const n in Stores) {
+ if ((Stores as any)[n] instanceof Store) {
+ const si: Store<string, any> = (Stores as any)[n];
+ let s: IDBObjectStore;
+ const storeVersionAdded = si.storeParams?.versionAdded ?? 1;
+ if (storeVersionAdded > oldVersion) {
+ s = db.createObjectStore(si.name, si.storeParams);
+ } else {
+ s = upgradeTransaction.objectStore(si.name);
+ }
+ for (const indexName in si as any) {
+ if ((si as any)[indexName] instanceof Index) {
+ const ii: Index<string, string, any, any> = (si as any)[indexName];
+ const indexVersionAdded = ii.options?.versionAdded ?? 0;
+ if (
+ indexVersionAdded > oldVersion ||
+ storeVersionAdded > oldVersion
+ ) {
+ s.createIndex(ii.indexName, ii.keyPath, ii.options);
}
}
}
}
- };
+ }
+}
- return openDatabase(
+function onTalerDbUpgradeNeeded(
+ db: IDBDatabase,
+ oldVersion: number,
+ newVersion: number,
+ upgradeTransaction: IDBTransaction,
+) {
+ upgradeFromStoreMap(Stores, db, oldVersion, newVersion, upgradeTransaction);
+}
+
+function onMetaDbUpgradeNeeded(
+ db: IDBDatabase,
+ oldVersion: number,
+ newVersion: number,
+ upgradeTransaction: IDBTransaction,
+) {
+ upgradeFromStoreMap(
+ MetaStores,
+ db,
+ oldVersion,
+ newVersion,
+ upgradeTransaction,
+ );
+}
+
+/**
+ * Return a promise that resolves
+ * to the taler wallet db.
+ */
+export async function openTalerDatabase(
+ idbFactory: IDBFactory,
+ onVersionChange: () => void,
+): Promise<Database<typeof Stores>> {
+ const metaDbHandle = await openDatabase(
+ idbFactory,
+ TALER_META_DB_NAME,
+ 1,
+ () => {},
+ onMetaDbUpgradeNeeded,
+ );
+
+ const metaDb = new Database(metaDbHandle, MetaStores);
+ let currentMainVersion: string | undefined;
+ await metaDb.runWithWriteTransaction([MetaStores.metaConfig], async (tx) => {
+ const dbVersionRecord = await tx.get(
+ MetaStores.metaConfig,
+ CURRENT_DB_CONFIG_KEY,
+ );
+ if (!dbVersionRecord) {
+ currentMainVersion = TALER_DB_NAME;
+ await tx.put(MetaStores.metaConfig, {
+ key: CURRENT_DB_CONFIG_KEY,
+ value: TALER_DB_NAME,
+ });
+ } else {
+ currentMainVersion = dbVersionRecord.key;
+ }
+ });
+
+ if (currentMainVersion !== TALER_DB_NAME) {
+ // In the future, the migration logic will be implemented here.
+ throw Error(`migration from database ${currentMainVersion} not supported`);
+ }
+
+ const mainDbHandle = await openDatabase(
idbFactory,
TALER_DB_NAME,
WALLET_DB_MINOR_VERSION,
onVersionChange,
- onUpgradeNeeded,
+ onTalerDbUpgradeNeeded,
);
+
+ return new Database(mainDbHandle, Stores);
}
export function deleteTalerDatabase(idbFactory: IDBFactory): void {
diff --git a/packages/taler-wallet-core/src/headless/helpers.ts b/packages/taler-wallet-core/src/headless/helpers.ts
index 30b670032..3d380ad49 100644
--- a/packages/taler-wallet-core/src/headless/helpers.ts
+++ b/packages/taler-wallet-core/src/headless/helpers.ts
@@ -34,6 +34,7 @@ import { NodeHttpLib } from "./NodeHttpLib";
import { Logger } from "../util/logging";
import { SynchronousCryptoWorkerFactory } from "../crypto/workers/synchronousWorker";
import type { IDBFactory } from "idb-bridge/lib/idbtypes";
+import { Stores } from "../types/dbTypes";
const logger = new Logger("headless/helpers.ts");
@@ -149,9 +150,7 @@ export async function getDefaultNodeWallet(
workerFactory = new SynchronousCryptoWorkerFactory();
}
- const dbWrap = new Database(myDb);
-
- const w = new Wallet(dbWrap, myHttpLib, workerFactory);
+ const w = new Wallet(myDb, myHttpLib, workerFactory);
if (args.notifyHandler) {
w.addNotificationListener(args.notifyHandler);
}
diff --git a/packages/taler-wallet-core/src/index.ts b/packages/taler-wallet-core/src/index.ts
index 3d52ed762..c446a0ffa 100644
--- a/packages/taler-wallet-core/src/index.ts
+++ b/packages/taler-wallet-core/src/index.ts
@@ -34,6 +34,7 @@ export {
export * from "./operations/versions";
export * from "./db";
+export * from "./types/dbTypes";
// Internationalization
export * from "./i18n";
diff --git a/packages/taler-wallet-core/src/operations/exchanges.ts b/packages/taler-wallet-core/src/operations/exchanges.ts
index 52da6be62..7cc4fe101 100644
--- a/packages/taler-wallet-core/src/operations/exchanges.ts
+++ b/packages/taler-wallet-core/src/operations/exchanges.ts
@@ -29,6 +29,7 @@ import {
DenominationStatus,
WireFee,
ExchangeUpdateReason,
+ MetaStores,
} from "../types/dbTypes";
import { canonicalizeBaseUrl } from "../util/helpers";
import * as Amounts from "../util/amounts";
diff --git a/packages/taler-wallet-core/src/operations/state.ts b/packages/taler-wallet-core/src/operations/state.ts
index 1733f13bb..60aee4c3f 100644
--- a/packages/taler-wallet-core/src/operations/state.ts
+++ b/packages/taler-wallet-core/src/operations/state.ts
@@ -23,6 +23,7 @@ import { PendingOperationsResponse } from "../types/pendingTypes";
import { WalletNotification } from "../types/notifications";
import { Database } from "../util/query";
import { openPromise, OpenedPromise } from "../util/promiseUtils";
+import { Stores } from "../types/dbTypes";
type NotificationListener = (n: WalletNotification) => void;
@@ -59,7 +60,7 @@ export class InternalWalletState {
// the actual value nullable.
// Check if we are in a DB migration / garbage collection
// and throw an error in that case.
- public db: Database,
+ public db: Database<typeof Stores>,
public http: HttpRequestLibrary,
cryptoWorkerFactory: CryptoWorkerFactory,
) {
diff --git a/packages/taler-wallet-core/src/types/dbTypes.ts b/packages/taler-wallet-core/src/types/dbTypes.ts
index f55dcb2f6..0cfc8801b 100644
--- a/packages/taler-wallet-core/src/types/dbTypes.ts
+++ b/packages/taler-wallet-core/src/types/dbTypes.ts
@@ -1591,9 +1591,6 @@ class TipsStore extends Store<"tips", TipRecord> {
this,
"tipsByMerchantTipIdAndOriginIndex",
["merchantTipId", "merchantBaseUrl"],
- {
- versionAdded: 2,
- },
);
}
@@ -1657,7 +1654,7 @@ class BackupProvidersStore extends Store<
BackupProviderRecord
> {
constructor() {
- super("backupProviders", { keyPath: "baseUrl", versionAdded: 3 });
+ super("backupProviders", { keyPath: "baseUrl" });
}
}
@@ -1688,3 +1685,13 @@ export const Stores = {
bankWithdrawUris: new BankWithdrawUrisStore(),
backupProviders: new BackupProvidersStore(),
};
+
+export class MetaConfigStore extends Store<"metaConfig", ConfigRecord<any>> {
+ constructor() {
+ super("metaConfig", { keyPath: "key" });
+ }
+}
+
+export const MetaStores = {
+ metaConfig: new MetaConfigStore(),
+};
diff --git a/packages/taler-wallet-core/src/util/query.ts b/packages/taler-wallet-core/src/util/query.ts
index 35aab81e9..fdcab4fa1 100644
--- a/packages/taler-wallet-core/src/util/query.ts
+++ b/packages/taler-wallet-core/src/util/query.ts
@@ -269,6 +269,8 @@ class ResultStream<T> {
}
}
+export type AnyStoreMap = { [s: string]: Store<any, any> };
+
type StoreName<S> = S extends Store<infer N, any> ? N : never;
type StoreContent<S> = S extends Store<any, infer R> ? R : never;
type IndexRecord<Ind> = Ind extends Index<any, any, any, infer R> ? R : never;
@@ -462,8 +464,7 @@ export class Index<
}
/**
- * Return a promise that resolves
- * to the taler wallet db.
+ * Return a promise that resolves to the opened IndexedDB database.
*/
export function openDatabase(
idbFactory: IDBFactory,
@@ -480,7 +481,7 @@ export function openDatabase(
return new Promise<IDBDatabase>((resolve, reject) => {
const req = idbFactory.open(databaseName, databaseVersion);
req.onerror = (e) => {
- logger.error("taler database error", e);
+ logger.error("database error", e);
reject(new Error("database error"));
};
req.onsuccess = (e) => {
@@ -508,8 +509,8 @@ export function openDatabase(
});
}
-export class Database {
- constructor(private db: IDBDatabase) {}
+export class Database<StoreMap extends AnyStoreMap> {
+ constructor(private db: IDBDatabase, stores: StoreMap) {}
static deleteDatabase(idbFactory: IDBFactory, dbName: string): void {
idbFactory.deleteDatabase(dbName);
@@ -571,10 +572,10 @@ export class Database {
});
}
- async get<N extends string, T>(
- store: Store<N, T>,
+ async get<N extends keyof StoreMap, S extends StoreMap[N]>(
+ store: S,
key: IDBValidKey,
- ): Promise<T | undefined> {
+ ): Promise<StoreContent<S> | undefined> {
const tx = this.db.transaction([store.name], "readonly");
const req = tx.objectStore(store.name).get(key);
const v = await requestToPromise(req);
@@ -634,14 +635,22 @@ export class Database {
return new ResultStream<IndexRecord<Ind>>(req);
}
- async runWithReadTransaction<T, StoreTypes extends Store<string, any>>(
+ async runWithReadTransaction<
+ T,
+ N extends keyof StoreMap,
+ StoreTypes extends StoreMap[N]
+ >(
stores: StoreTypes[],
f: (t: TransactionHandle<StoreTypes>) => Promise<T>,
): Promise<T> {
return runWithTransaction<T, StoreTypes>(this.db, stores, f, "readonly");
}
- async runWithWriteTransaction<T, StoreTypes extends Store<string, any>>(
+ async runWithWriteTransaction<
+ T,
+ N extends keyof StoreMap,
+ StoreTypes extends StoreMap[N]
+ >(
stores: StoreTypes[],
f: (t: TransactionHandle<StoreTypes>) => Promise<T>,
): Promise<T> {
diff --git a/packages/taler-wallet-core/src/wallet.ts b/packages/taler-wallet-core/src/wallet.ts
index 56e3d82d1..631ac9509 100644
--- a/packages/taler-wallet-core/src/wallet.ts
+++ b/packages/taler-wallet-core/src/wallet.ts
@@ -24,7 +24,7 @@
*/
import { CryptoWorkerFactory } from "./crypto/workers/cryptoApi";
import { HttpRequestLibrary } from "./util/http";
-import { Database } from "./util/query";
+import { Database, Store } from "./util/query";
import { Amounts, AmountJson } from "./util/amounts";
@@ -52,6 +52,7 @@ import {
ReserveRecordStatus,
CoinSourceType,
RefundState,
+ MetaStores,
} from "./types/dbTypes";
import { CoinDumpJson, WithdrawUriInfoResponse } from "./types/talerTypes";
import {
@@ -200,12 +201,12 @@ export class Wallet {
private stopped = false;
private memoRunRetryLoop = new AsyncOpMemoSingle<void>();
- get db(): Database {
+ get db(): Database<typeof Stores> {
return this.ws.db;
}
constructor(
- db: Database,
+ db: Database<typeof Stores>,
http: HttpRequestLibrary,
cryptoWorkerFactory: CryptoWorkerFactory,
) {