web-idb-client 1.0.0

package/dist/utils/boolean-codec.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeWhereForStorage = exports.decodeRowFromStorage = exports.encodeRowForStorage = exports.decodeBooleanFromStorage = exports.encodeBooleanForStorage = void 0;
+function isRangeFilter(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !(value instanceof Date) &&
+        !(value instanceof IDBKeyRange) &&
+        !Array.isArray(value) &&
+        ('equals' in value ||
+            'gt' in value ||
+            'gte' in value ||
+            'lt' in value ||
+            'lte' in value ||
+            'above' in value ||
+            'aboveOrEqual' in value ||
+            'below' in value ||
+            'belowOrEqual' in value ||
+            'startsWith' in value ||
+            'between' in value));
+}
+/** App boolean → IDB key (0 | 1). Passes through 0/1; leaves other values alone. */
+function encodeBooleanForStorage(value) {
+    if (typeof value === 'boolean') {
+        return value ? 1 : 0;
+    }
+    return value;
+}
+exports.encodeBooleanForStorage = encodeBooleanForStorage;
+/**
+ * IDB value → app boolean.
+ * Accepts 0/1 and legacy true/false so old rows still decode.
+ */
+function decodeBooleanFromStorage(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    return value === 1;
+}
+exports.decodeBooleanFromStorage = decodeBooleanFromStorage;
+function fieldKind(store, fieldName) {
+    var _a;
+    return (_a = store.fields[fieldName]) === null || _a === void 0 ? void 0 : _a.meta.kind;
+}
+function encodeWhereValue(kind, value) {
+    if (kind !== 'boolean') {
+        return value;
+    }
+    if (value instanceof IDBKeyRange) {
+        return value;
+    }
+    if (isRangeFilter(value)) {
+        const next = Object.assign({}, value);
+        const keys = [
+            'equals',
+            'gt',
+            'gte',
+            'lt',
+            'lte',
+            'above',
+            'aboveOrEqual',
+            'below',
+            'belowOrEqual',
+        ];
+        for (const key of keys) {
+            if (next[key] !== undefined) {
+                next[key] = encodeBooleanForStorage(next[key]);
+            }
+        }
+        if (next.between !== undefined) {
+            const [lower, upper, lowerOpen, upperOpen] = next.between;
+            next.between =
+                lowerOpen !== undefined || upperOpen !== undefined
+                    ? [
+                        encodeBooleanForStorage(lower),
+                        encodeBooleanForStorage(upper),
+                        Boolean(lowerOpen),
+                        Boolean(upperOpen),
+                    ]
+                    : [
+                        encodeBooleanForStorage(lower),
+                        encodeBooleanForStorage(upper),
+                    ];
+        }
+        return next;
+    }
+    return encodeBooleanForStorage(value);
+}
+/**
+ * Encode boolean fields in a row before writing to IndexedDB.
+ * App API stays `boolean`; storage / index keys are `0 | 1`.
+ */
+function encodeRowForStorage(store, row) {
+    const out = Object.assign({}, row);
+    for (const [name, field] of Object.entries(store.fields)) {
+        if (field.meta.kind !== 'boolean' || !(name in out)) {
+            continue;
+        }
+        const value = out[name];
+        if (value === undefined) {
+            continue;
+        }
+        out[name] = encodeBooleanForStorage(value);
+    }
+    return out;
+}
+exports.encodeRowForStorage = encodeRowForStorage;
+/**
+ * Decode boolean fields after reading from IndexedDB.
+ * Treats both `0|1` and legacy `true|false` as boolean.
+ */
+function decodeRowFromStorage(store, row) {
+    const out = Object.assign({}, row);
+    for (const [name, field] of Object.entries(store.fields)) {
+        if (field.meta.kind !== 'boolean' || !(name in out)) {
+            continue;
+        }
+        const value = out[name];
+        if (value === undefined) {
+            continue;
+        }
+        out[name] = decodeBooleanFromStorage(value);
+    }
+    return out;
+}
+exports.decodeRowFromStorage = decodeRowFromStorage;
+/** Encode boolean parts of a where clause before resolving to IDBKeyRange. */
+function encodeWhereForStorage(store, where) {
+    if (!where) {
+        return where;
+    }
+    const keys = Object.keys(where);
+    if (keys.length === 0) {
+        return where;
+    }
+    const out = {};
+    for (const key of keys) {
+        const value = where[key];
+        const namedCompound = store.indexes.find((i) => i.name === key && Array.isArray(i.keyPath));
+        if (namedCompound && Array.isArray(namedCompound.keyPath) && Array.isArray(value)) {
+            out[key] = namedCompound.keyPath.map((fieldName, i) => encodeWhereValue(fieldKind(store, fieldName), value[i]));
+            continue;
+        }
+        out[key] = encodeWhereValue(fieldKind(store, key), value);
+    }
+    return out;
+}
+exports.encodeWhereForStorage = encodeWhereForStorage;
+//# sourceMappingURL=boolean-codec.js.map

package/dist/utils/boolean-codec.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { decodeBooleanFromStorage, decodeRowFromStorage, encodeBooleanForStorage, encodeRowForStorage, encodeWhereForStorage, } from './boolean-codec';
+export type { StoredBoolean } from './boolean-codec';
+export { toKeyRange, toOptionalKeyRange } from './key-range';
+export { promisifyRequest, transactionDone } from './promisify';
+export type { Expect } from './type-utils';

package/dist/utils/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transactionDone = exports.promisifyRequest = exports.toOptionalKeyRange = exports.toKeyRange = exports.encodeWhereForStorage = exports.encodeRowForStorage = exports.encodeBooleanForStorage = exports.decodeRowFromStorage = exports.decodeBooleanFromStorage = void 0;
+var boolean_codec_1 = require("./boolean-codec");
+Object.defineProperty(exports, "decodeBooleanFromStorage", { enumerable: true, get: function () { return boolean_codec_1.decodeBooleanFromStorage; } });
+Object.defineProperty(exports, "decodeRowFromStorage", { enumerable: true, get: function () { return boolean_codec_1.decodeRowFromStorage; } });
+Object.defineProperty(exports, "encodeBooleanForStorage", { enumerable: true, get: function () { return boolean_codec_1.encodeBooleanForStorage; } });
+Object.defineProperty(exports, "encodeRowForStorage", { enumerable: true, get: function () { return boolean_codec_1.encodeRowForStorage; } });
+Object.defineProperty(exports, "encodeWhereForStorage", { enumerable: true, get: function () { return boolean_codec_1.encodeWhereForStorage; } });
+var key_range_1 = require("./key-range");
+Object.defineProperty(exports, "toKeyRange", { enumerable: true, get: function () { return key_range_1.toKeyRange; } });
+Object.defineProperty(exports, "toOptionalKeyRange", { enumerable: true, get: function () { return key_range_1.toOptionalKeyRange; } });
+var promisify_1 = require("./promisify");
+Object.defineProperty(exports, "promisifyRequest", { enumerable: true, get: function () { return promisify_1.promisifyRequest; } });
+Object.defineProperty(exports, "transactionDone", { enumerable: true, get: function () { return promisify_1.transactionDone; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,iDAMyB;AALvB,yHAAA,wBAAwB,OAAA;AACxB,qHAAA,oBAAoB,OAAA;AACpB,wHAAA,uBAAuB,OAAA;AACvB,oHAAA,mBAAmB,OAAA;AACnB,sHAAA,qBAAqB,OAAA;AAGvB,yCAA6D;AAApD,uGAAA,UAAU,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AACvC,yCAAgE;AAAvD,6GAAA,gBAAgB,OAAA;AAAE,4GAAA,eAAe,OAAA"}

package/dist/utils/key-range.d.ts

@@ -0,0 +1,14 @@
+import type { WhereValueInterface } from '../schema/infer';
+/** Build an IDBKeyRange (or exact key) from a where value. */
+export declare function toKeyRange(value: WhereValueInterface): IDBKeyRange | IDBValidKey;
+/**
+ * Normalize a resolved key / range for IDB APIs that accept
+ * `IDBKeyRange | undefined` (`getAll`, `openCursor`, `count`).
+ */
+export declare function toOptionalKeyRange(keyRange: IDBKeyRange | IDBValidKey | undefined): IDBKeyRange | undefined;
+/**
+ * Build a compound (multi-part) key or key range.
+ * Exact parts only → equality tuple.
+ * Exact prefix + range on the **last** part → IDBKeyRange over that suffix.
+ */
+export declare function toCompoundKeyRange(parts: readonly unknown[]): IDBKeyRange | IDBValidKey;

package/dist/utils/key-range.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCompoundKeyRange = exports.toOptionalKeyRange = exports.toKeyRange = void 0;
+const errors_1 = require("../errors");
+function isRangeFilter(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !(value instanceof Date) &&
+        !(value instanceof IDBKeyRange) &&
+        !Array.isArray(value) &&
+        ('equals' in value ||
+            'gt' in value ||
+            'gte' in value ||
+            'lt' in value ||
+            'lte' in value ||
+            'above' in value ||
+            'aboveOrEqual' in value ||
+            'below' in value ||
+            'belowOrEqual' in value ||
+            'startsWith' in value ||
+            'between' in value));
+}
+function startsWithRange(prefix) {
+    // Classic IndexedDB prefix range (Dexie-style).
+    return IDBKeyRange.bound(prefix, `${prefix}\uffff`, false, false);
+}
+/** Build an IDBKeyRange (or exact key) from a where value. */
+function toKeyRange(value) {
+    var _a, _b, _c, _d, _e, _f;
+    if (value instanceof IDBKeyRange) {
+        return value;
+    }
+    if (isRangeFilter(value)) {
+        if (value.equals !== undefined) {
+            return IDBKeyRange.only(value.equals);
+        }
+        if (value.startsWith !== undefined) {
+            if (typeof value.startsWith !== 'string') {
+                throw new errors_1.IndexedDbError('QUERY_INVALID', 'startsWith is only supported for string keys');
+            }
+            return startsWithRange(value.startsWith);
+        }
+        if (value.between !== undefined) {
+            const [lower, upper, lowerOpen = false, upperOpen = false] = value.between;
+            return IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen);
+        }
+        const lower = (_c = (_b = (_a = value.gte) !== null && _a !== void 0 ? _a : value.aboveOrEqual) !== null && _b !== void 0 ? _b : value.gt) !== null && _c !== void 0 ? _c : value.above;
+        const upper = (_f = (_e = (_d = value.lte) !== null && _d !== void 0 ? _d : value.belowOrEqual) !== null && _e !== void 0 ? _e : value.lt) !== null && _f !== void 0 ? _f : value.below;
+        const lowerOpen = value.gte === undefined &&
+            value.aboveOrEqual === undefined &&
+            (value.gt !== undefined || value.above !== undefined);
+        const upperOpen = value.lte === undefined &&
+            value.belowOrEqual === undefined &&
+            (value.lt !== undefined || value.below !== undefined);
+        if (lower !== undefined && upper !== undefined) {
+            return IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen);
+        }
+        if (lower !== undefined) {
+            return IDBKeyRange.lowerBound(lower, lowerOpen);
+        }
+        if (upper !== undefined) {
+            return IDBKeyRange.upperBound(upper, upperOpen);
+        }
+        throw new errors_1.IndexedDbError('QUERY_INVALID', 'Range filter must include at least one bound');
+    }
+    return value;
+}
+exports.toKeyRange = toKeyRange;
+/**
+ * Normalize a resolved key / range for IDB APIs that accept
+ * `IDBKeyRange | undefined` (`getAll`, `openCursor`, `count`).
+ */
+function toOptionalKeyRange(keyRange) {
+    if (keyRange === undefined) {
+        return undefined;
+    }
+    if (keyRange instanceof IDBKeyRange) {
+        return keyRange;
+    }
+    return IDBKeyRange.only(keyRange);
+}
+exports.toOptionalKeyRange = toOptionalKeyRange;
+/** Sentinel greater than any non-array IDB key (number/date/string/binary). */
+const COMPOUND_UPPER_SENTINEL = [];
+function isRangeFilterPart(value) {
+    return isRangeFilter(value);
+}
+/**
+ * Build a compound (multi-part) key or key range.
+ * Exact parts only → equality tuple.
+ * Exact prefix + range on the **last** part → IDBKeyRange over that suffix.
+ */
+function toCompoundKeyRange(parts) {
+    var _a, _b, _c, _d, _e, _f;
+    if (parts.length === 0) {
+        throw new errors_1.IndexedDbError('QUERY_INVALID', 'Compound key must have at least one part');
+    }
+    const rangeIndexes = parts
+        .map((part, i) => (isRangeFilterPart(part) ? i : -1))
+        .filter((i) => i >= 0);
+    if (rangeIndexes.length === 0) {
+        return parts.map((part) => {
+            const key = toKeyRange(part);
+            if (key instanceof IDBKeyRange) {
+                throw new errors_1.IndexedDbError('QUERY_INVALID', 'Compound where values must be exact keys, not ranges');
+            }
+            return key;
+        });
+    }
+    if (rangeIndexes.length > 1 || rangeIndexes[0] !== parts.length - 1) {
+        throw new errors_1.IndexedDbError('QUERY_INVALID', 'Only the last compound key part may be a range; earlier parts must be exact keys');
+    }
+    const prefix = parts.slice(0, -1).map((part) => {
+        const key = toKeyRange(part);
+        if (key instanceof IDBKeyRange) {
+            throw new errors_1.IndexedDbError('QUERY_INVALID', 'Only the last compound key part may be a range; earlier parts must be exact keys');
+        }
+        return key;
+    });
+    const last = parts[parts.length - 1];
+    if (last.equals !== undefined) {
+        return [...prefix, last.equals];
+    }
+    if (last.startsWith !== undefined) {
+        if (typeof last.startsWith !== 'string') {
+            throw new errors_1.IndexedDbError('QUERY_INVALID', 'startsWith is only supported for string keys');
+        }
+        const lo = [...prefix, last.startsWith];
+        const hi = [...prefix, `${last.startsWith}\uffff`];
+        return IDBKeyRange.bound(lo, hi, false, false);
+    }
+    if (last.between !== undefined) {
+        const [lower, upper, lowerOpen = false, upperOpen = false] = last.between;
+        return IDBKeyRange.bound([...prefix, lower], [...prefix, upper], lowerOpen, upperOpen);
+    }
+    const lowerRaw = (_c = (_b = (_a = last.gte) !== null && _a !== void 0 ? _a : last.aboveOrEqual) !== null && _b !== void 0 ? _b : last.gt) !== null && _c !== void 0 ? _c : last.above;
+    const upperRaw = (_f = (_e = (_d = last.lte) !== null && _d !== void 0 ? _d : last.belowOrEqual) !== null && _e !== void 0 ? _e : last.lt) !== null && _f !== void 0 ? _f : last.below;
+    const lowerOpen = last.gte === undefined &&
+        last.aboveOrEqual === undefined &&
+        (last.gt !== undefined || last.above !== undefined);
+    const upperOpen = last.lte === undefined &&
+        last.belowOrEqual === undefined &&
+        (last.lt !== undefined || last.below !== undefined);
+    if (lowerRaw === undefined && upperRaw === undefined) {
+        throw new errors_1.IndexedDbError('QUERY_INVALID', 'Range filter must include at least one bound');
+    }
+    const lower = lowerRaw !== undefined
+        ? [...prefix, lowerRaw]
+        : [...prefix];
+    const upper = upperRaw !== undefined
+        ? [...prefix, upperRaw]
+        : [...prefix, COMPOUND_UPPER_SENTINEL];
+    const upperOpenEffective = upperRaw !== undefined ? upperOpen : true;
+    return IDBKeyRange.bound(lower, upper, lowerOpen, upperOpenEffective);
+}
+exports.toCompoundKeyRange = toCompoundKeyRange;
+//# sourceMappingURL=key-range.js.map

package/dist/utils/key-range.js.map

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

package/dist/utils/promisify.d.ts

@@ -0,0 +1,2 @@
+export declare function promisifyRequest<T>(request: IDBRequest<T>): Promise<T>;
+export declare function transactionDone(tx: IDBTransaction): Promise<void>;

package/dist/utils/promisify.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transactionDone = exports.promisifyRequest = void 0;
+const errors_1 = require("../errors");
+function promisifyRequest(request) {
+    return new Promise((resolve, reject) => {
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => {
+            var _a, _b;
+            return reject(new errors_1.IndexedDbError('TRANSACTION_FAILED', (_b = (_a = request.error) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : 'IndexedDB request failed'));
+        };
+    });
+}
+exports.promisifyRequest = promisifyRequest;
+function transactionDone(tx) {
+    return new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => {
+            var _a, _b;
+            return reject(new errors_1.IndexedDbError('TRANSACTION_FAILED', (_b = (_a = tx.error) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : 'IndexedDB transaction failed'));
+        };
+        tx.onabort = () => {
+            var _a, _b;
+            return reject(new errors_1.IndexedDbError('TRANSACTION_FAILED', (_b = (_a = tx.error) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : 'IndexedDB transaction aborted'));
+        };
+    });
+}
+exports.transactionDone = transactionDone;
+//# sourceMappingURL=promisify.js.map

package/dist/utils/promisify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promisify.js","sourceRoot":"","sources":["../../src/utils/promisify.ts"],"names":[],"mappings":";;;AAAA,sCAA2C;AAE3C,SAAgB,gBAAgB,CAAI,OAAsB;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE;;YACrB,OAAA,MAAM,CACJ,IAAI,uBAAc,CAChB,oBAAoB,EACpB,MAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,OAAO,mCAAI,0BAA0B,CACrD,CACF,CAAA;SAAA,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC;AAXD,4CAWC;AAED,SAAgB,eAAe,CAAC,EAAkB;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAChC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;;YAChB,OAAA,MAAM,CACJ,IAAI,uBAAc,CAChB,oBAAoB,EACpB,MAAA,MAAA,EAAE,CAAC,KAAK,0CAAE,OAAO,mCAAI,8BAA8B,CACpD,CACF,CAAA;SAAA,CAAC;QACJ,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;;YAChB,OAAA,MAAM,CACJ,IAAI,uBAAc,CAChB,oBAAoB,EACpB,MAAA,MAAA,EAAE,CAAC,KAAK,0CAAE,OAAO,mCAAI,+BAA+B,CACrD,CACF,CAAA;SAAA,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC;AAlBD,0CAkBC"}

package/dist/utils/type-utils.d.ts

@@ -0,0 +1,2 @@
+/** Compile-time assert that A is assignable to B and B to A (approx). */
+export type Expect<A, B> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;

package/dist/utils/type-utils.js

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

package/dist/utils/type-utils.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "web-idb-client",
+  "version": "1.0.0",
+  "description": "Browser-only typed IndexedDB client with a Prisma-like store API and schema-in-TypeScript factories.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./liveQuery": {
+      "types": "./dist/liveQuery/index.d.ts",
+      "default": "./dist/liveQuery/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "format": "npx prettier \"src/**/*.{js,jsx,ts,tsx}\" --write",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "ci": "npm run typecheck && npm test && npm run demo:build && npm run relations:build",
+    "demo:dev": "npm --prefix examples/todo run dev",
+    "demo:build": "npm --prefix examples/todo run build",
+    "demo:preview": "npm --prefix examples/todo run preview",
+    "relations:dev": "npm --prefix examples/relations run dev",
+    "relations:build": "npm --prefix examples/relations run build",
+    "prepublishOnly": "npm run build",
+    "version:patch": "npm version patch && git push origin main && git push origin $(npm version --json | jq -r '.[]')",
+    "version:minor": "npm version minor && git push origin main && git push origin $(npm version --json | jq -r '.[]')",
+    "version:major": "npm version major && git push origin main && git push origin $(npm version --json | jq -r '.[]')",
+    "publish:patch": "npm run version:patch && npm publish",
+    "publish:minor": "npm run version:minor && npm publish",
+    "publish:major": "npm run version:major && npm publish"
+  },
+  "keywords": [
+    "indexeddb",
+    "orm",
+    "client",
+    "database",
+    "browser",
+    "storage",
+    "typescript"
+  ],
+  "author": "Sergey Azarov <your-email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/azarov-serge/indexed-db-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/azarov-serge/indexed-db-client/issues"
+  },
+  "homepage": "https://github.com/azarov-serge/indexed-db-client#readme",
+  "devDependencies": {
+    "@typescript-eslint/parser": "7.2.0",
+    "eslint": "8.57.0",
+    "fake-indexeddb": "^6.0.0",
+    "husky": "9.0.11",
+    "lint-staged": "15.2.2",
+    "prettier": "3.2.5",
+    "typescript": "5.1.6",
+    "vitest": "^2.1.8"
+  }
+}