/* Copyright 2020 Bruno Windels Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ import {QueryTarget, IDBQuery} from "./QueryTarget"; import {IDBRequestError, IDBRequestAttemptError} from "./error"; import {reqAsPromise} from "./utils"; import {Transaction, IDBKey} from "./Transaction"; import {LogItem} from "../../../logging/LogItem.js"; const LOG_REQUESTS = false; function logRequest(method: string, params: any[], source: any): void { const storeName = source?.name; const databaseName = source?.transaction?.db?.name; console.info(`${databaseName}.${storeName}.${method}(${params.map(p => JSON.stringify(p)).join(", ")})`); } class QueryTargetWrapper { private _qt: IDBIndex | IDBObjectStore; constructor(qt: IDBIndex | IDBObjectStore) { this._qt = qt; } get keyPath(): string | string[] { return this._qtStore.keyPath; } get _qtStore(): IDBObjectStore { if ("objectStore" in this._qt) { return this._qt.objectStore; } return this._qt; } supports(methodName: string): boolean { return !!this._qt[methodName]; } openKeyCursor(range?: IDBQuery, direction?: IDBCursorDirection | undefined): IDBRequest { try { // not supported on Edge 15 if (!this._qt.openKeyCursor) { LOG_REQUESTS && logRequest("openCursor", [range, direction], this._qt); return this.openCursor(range, direction); } LOG_REQUESTS && logRequest("openKeyCursor", [range, direction], this._qt); return this._qt.openKeyCursor(range, direction) } catch(err) { throw new IDBRequestAttemptError("openKeyCursor", this._qt, err, [range, direction]); } } openCursor(range?: IDBQuery, direction?: IDBCursorDirection | undefined): IDBRequest { try { LOG_REQUESTS && logRequest("openCursor", [], this._qt); return this._qt.openCursor(range, direction) } catch(err) { throw new IDBRequestAttemptError("openCursor", this._qt, err, [range, direction]); } } put(item: T, key?: IDBValidKey | undefined): IDBRequest { try { LOG_REQUESTS && logRequest("put", [item, key], this._qt); return this._qtStore.put(item, key); } catch(err) { throw new IDBRequestAttemptError("put", this._qt, err, [item, key]); } } add(item: T, key?: IDBValidKey | undefined): IDBRequest { try { LOG_REQUESTS && logRequest("add", [item, key], this._qt); return this._qtStore.add(item, key); } catch(err) { throw new IDBRequestAttemptError("add", this._qt, err, [item, key]); } } get(key: IDBValidKey | IDBKeyRange): IDBRequest { try { LOG_REQUESTS && logRequest("get", [key], this._qt); return this._qt.get(key); } catch(err) { throw new IDBRequestAttemptError("get", this._qt, err, [key]); } } getKey(key: IDBValidKey | IDBKeyRange): IDBRequest { try { LOG_REQUESTS && logRequest("getKey", [key], this._qt); return this._qt.getKey(key) } catch(err) { throw new IDBRequestAttemptError("getKey", this._qt, err, [key]); } } delete(key: IDBValidKey | IDBKeyRange): IDBRequest { try { LOG_REQUESTS && logRequest("delete", [key], this._qt); return this._qtStore.delete(key); } catch(err) { throw new IDBRequestAttemptError("delete", this._qt, err, [key]); } } index(name: string): IDBIndex { try { return this._qtStore.index(name); } catch(err) { // TODO: map to different error? this is not a request throw new IDBRequestAttemptError("index", this._qt, err, [name]); } } get indexNames(): string[] { return Array.from(this._qtStore.indexNames); } } export class Store extends QueryTarget { constructor(idbStore: IDBObjectStore, transaction: Transaction) { super(new QueryTargetWrapper(idbStore), transaction); } get _idbStore(): QueryTargetWrapper { return (this._target as QueryTargetWrapper); } index(indexName: string): QueryTarget { return new QueryTarget(new QueryTargetWrapper(this._idbStore.index(indexName)), this._transaction); } put(value: T, log?: LogItem): void { // If this request fails, the error will bubble up to the transaction and abort it, // which is the behaviour we want. Therefore, it is ok to not create a promise for this // request and await it. // // Perhaps at some later point, we will want to handle an error (like ConstraintError) for // individual write requests. In that case, we should add a method that returns a promise (e.g. putAndObserve) // and call preventDefault on the event to prevent it from aborting the transaction // // Note that this can still throw synchronously, like it does for TransactionInactiveError, // see https://www.w3.org/TR/IndexedDB-2/#transaction-lifetime-concept const request = this._idbStore.put(value); this._prepareErrorLog(request, log, "put", undefined, value); } add(value: T, log?: LogItem): void { // ok to not monitor result of request, see comment in `put`. const request = this._idbStore.add(value); this._prepareErrorLog(request, log, "add", undefined, value); } async tryAdd(value: T, log: LogItem): Promise { try { await reqAsPromise(this._idbStore.add(value)); return true; } catch (err) { if (err instanceof IDBRequestError) { log.log({l: "could not write", id: this._getKeys(value), e: err}, log.level.Warn); err.preventTransactionAbort(); return false; } else { throw err; } } } delete(keyOrKeyRange: IDBValidKey | IDBKeyRange, log?: LogItem): void { // ok to not monitor result of request, see comment in `put`. const request = this._idbStore.delete(keyOrKeyRange); this._prepareErrorLog(request, log, "delete", keyOrKeyRange, undefined); } private _prepareErrorLog(request: IDBRequest, log: LogItem | undefined, operationName: string, key: IDBKey | undefined, value: T | undefined) { if (log) { log.ensureRefId(); } reqAsPromise(request).catch(err => { let keys : IDBKey[] | undefined = undefined; if (value) { keys = this._getKeys(value); } else if (key) { keys = [key]; } this._transaction.addWriteError(err, log, operationName, keys); }); } private _getKeys(value: T): IDBValidKey[] { const keys: IDBValidKey[] = []; const {keyPath} = this._idbStore; try { keys.push(this._readKeyPath(value, keyPath)); } catch (err) { console.warn("could not read keyPath", keyPath); } for (const indexName of this._idbStore.indexNames) { try { const index = this._idbStore.index(indexName); keys.push(this._readKeyPath(value, index.keyPath)); } catch (err) { console.warn("could not read index", indexName); } } return keys; } private _readKeyPath(value: T, keyPath: string[] | string): IDBValidKey { if (Array.isArray(keyPath)) { let field: any = value; for (const part of keyPath) { if (typeof field === "object") { field = field[part]; } else { break; } } return field as IDBValidKey; } else { return value[keyPath] as IDBValidKey; } } }