web-idb-client 1.0.0

package/dist/liveQuery/index.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveQuery = void 0;
+const bridges = new WeakMap();
+function channelName(dbName) {
+    return `web-idb-client:${dbName}`;
+}
+function storageKey(dbName) {
+    return `web-idb-client:mutate:${dbName}`;
+}
+function ensureBridge(client) {
+    let bridge = bridges.get(client);
+    if (bridge) {
+        return bridge;
+    }
+    const listeners = new Set();
+    const name = client.name;
+    let channel = null;
+    try {
+        if (typeof BroadcastChannel !== 'undefined') {
+            channel = new BroadcastChannel(channelName(name));
+            channel.onmessage = (event) => {
+                var _a;
+                const stores = (_a = event.data) === null || _a === void 0 ? void 0 : _a.stores;
+                if (!Array.isArray(stores) || stores.length === 0) {
+                    return;
+                }
+                const batch = { stores, remote: true };
+                for (const listener of listeners) {
+                    listener(batch);
+                }
+            };
+        }
+    }
+    catch (_a) {
+        channel = null;
+    }
+    const key = storageKey(name);
+    let onStorage = null;
+    if (typeof window !== 'undefined' && typeof window.addEventListener === 'function') {
+        onStorage = (event) => {
+            if (event.key !== key || event.newValue == null) {
+                return;
+            }
+            let stores = ['*'];
+            try {
+                const parsed = JSON.parse(event.newValue);
+                if (Array.isArray(parsed.stores) && parsed.stores.length > 0) {
+                    stores = parsed.stores;
+                }
+            }
+            catch (_a) {
+                // ignore malformed payloads
+            }
+            const batch = { stores, remote: true };
+            for (const listener of listeners) {
+                listener(batch);
+            }
+        };
+        window.addEventListener('storage', onStorage);
+    }
+    const unsubLocal = client.subscribeMutations((batch) => {
+        for (const listener of listeners) {
+            listener(batch);
+        }
+        if (batch.remote) {
+            return;
+        }
+        try {
+            channel === null || channel === void 0 ? void 0 : channel.postMessage({ stores: batch.stores });
+        }
+        catch (_a) {
+            // ignore
+        }
+        if (typeof localStorage !== 'undefined') {
+            try {
+                localStorage.setItem(key, JSON.stringify({ stores: batch.stores, t: Date.now() }));
+            }
+            catch (_b) {
+                // private mode / quota
+            }
+        }
+    });
+    bridge = {
+        channel,
+        storageKey: key,
+        unsubLocal,
+        onStorage,
+        listeners,
+        refCount: 0,
+    };
+    bridges.set(client, bridge);
+    return bridge;
+}
+function retainBridge(client) {
+    const bridge = ensureBridge(client);
+    bridge.refCount += 1;
+    return bridge;
+}
+function releaseBridge(client) {
+    var _a;
+    const bridge = bridges.get(client);
+    if (!bridge) {
+        return;
+    }
+    bridge.refCount -= 1;
+    if (bridge.refCount > 0) {
+        return;
+    }
+    bridge.unsubLocal();
+    try {
+        (_a = bridge.channel) === null || _a === void 0 ? void 0 : _a.close();
+    }
+    catch (_b) {
+        // ignore
+    }
+    if (bridge.onStorage && typeof window !== 'undefined') {
+        window.removeEventListener('storage', bridge.onStorage);
+    }
+    bridges.delete(client);
+}
+/**
+ * Opt-in reactive query (browser tabs only — not sync / mobile).
+ *
+ * Re-runs `querier` after local mutations and when other tabs signal via
+ * BroadcastChannel (with `storage` event fallback).
+ *
+ * ```ts
+ * import { liveQuery } from 'web-idb-client/liveQuery';
+ *
+ * const sub = liveQuery(db, () => db.todos.findMany()).subscribe({
+ *   next: (rows) => render(rows),
+ *   error: console.error,
+ * });
+ * // later: sub.unsubscribe();
+ * ```
+ */
+function liveQuery(client, querier) {
+    return {
+        subscribe(subscriber) {
+            const bridge = retainBridge(client);
+            let cancelled = false;
+            let running = false;
+            let rerun = false;
+            let timer = null;
+            const emitError = (error) => {
+                var _a;
+                if (!cancelled) {
+                    (_a = subscriber.error) === null || _a === void 0 ? void 0 : _a.call(subscriber, error);
+                }
+            };
+            const run = () => {
+                if (cancelled) {
+                    return;
+                }
+                if (running) {
+                    rerun = true;
+                    return;
+                }
+                running = true;
+                Promise.resolve()
+                    .then(() => querier())
+                    .then((value) => {
+                    var _a;
+                    if (!cancelled) {
+                        (_a = subscriber.next) === null || _a === void 0 ? void 0 : _a.call(subscriber, value);
+                    }
+                })
+                    .catch(emitError)
+                    .finally(() => {
+                    running = false;
+                    if (rerun && !cancelled) {
+                        rerun = false;
+                        run();
+                    }
+                });
+            };
+            const schedule = () => {
+                if (cancelled) {
+                    return;
+                }
+                if (timer != null) {
+                    return;
+                }
+                timer = setTimeout(() => {
+                    timer = null;
+                    run();
+                }, 0);
+            };
+            const onBatch = (_batch) => {
+                schedule();
+            };
+            bridge.listeners.add(onBatch);
+            run();
+            return {
+                refresh: schedule,
+                unsubscribe() {
+                    var _a;
+                    if (cancelled) {
+                        return;
+                    }
+                    cancelled = true;
+                    if (timer != null) {
+                        clearTimeout(timer);
+                        timer = null;
+                    }
+                    bridge.listeners.delete(onBatch);
+                    releaseBridge(client);
+                    (_a = subscriber.complete) === null || _a === void 0 ? void 0 : _a.call(subscriber);
+                },
+            };
+        },
+    };
+}
+exports.liveQuery = liveQuery;
+//# sourceMappingURL=index.js.map

package/dist/liveQuery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/liveQuery/index.ts"],"names":[],"mappings":";;;AA4BA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE9C,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,kBAAkB,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,UAAU,CAAC,MAAc;IAChC,OAAO,yBAAyB,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,MAAuB;IAC3C,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,MAAM,EAAE;QACV,OAAO,MAAM,CAAC;KACf;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,OAAO,GAA4B,IAAI,CAAC;IAE5C,IAAI;QACF,IAAI,OAAO,gBAAgB,KAAK,WAAW,EAAE;YAC3C,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;;gBAC1C,MAAM,MAAM,GAAG,MAAC,KAAK,CAAC,IAAqC,0CAAE,MAAM,CAAC;gBACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;oBACjD,OAAO;iBACR;gBACD,MAAM,KAAK,GAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;oBAChC,QAAQ,CAAC,KAAK,CAAC,CAAC;iBACjB;YACH,CAAC,CAAC;SACH;KACF;IAAC,WAAM;QACN,OAAO,GAAG,IAAI,CAAC;KAChB;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,SAAS,GAA2C,IAAI,CAAC;IAE7D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,gBAAgB,KAAK,UAAU,EAAE;QAClF,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;YAClC,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE;gBAC/C,OAAO;aACR;YACD,IAAI,MAAM,GAAa,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI;gBACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAA0B,CAAC;gBACnE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;oBAC5D,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;iBACxB;aACF;YAAC,WAAM;gBACN,4BAA4B;aAC7B;YACD,MAAM,KAAK,GAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;gBAChC,QAAQ,CAAC,KAAK,CAAC,CAAC;aACjB;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;KAC/C;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE;QACrD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAChC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACjB;QACD,IAAI,KAAK,CAAC,MAAM,EAAE;YAChB,OAAO;SACR;QACD,IAAI;YACF,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;SAChD;QAAC,WAAM;YACN,SAAS;SACV;QACD,IAAI,OAAO,YAAY,KAAK,WAAW,EAAE;YACvC,IAAI;gBACF,YAAY,CAAC,OAAO,CAClB,GAAG,EACH,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CACxD,CAAC;aACH;YAAC,WAAM;gBACN,uBAAuB;aACxB;SACF;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG;QACP,OAAO;QACP,UAAU,EAAE,GAAG;QACf,UAAU;QACV,SAAS;QACT,SAAS;QACT,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,MAAuB;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,MAAuB;;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE;QACX,OAAO;KACR;IACD,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IACrB,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE;QACvB,OAAO;KACR;IACD,MAAM,CAAC,UAAU,EAAE,CAAC;IACpB,IAAI;QACF,MAAA,MAAM,CAAC,OAAO,0CAAE,KAAK,EAAE,CAAC;KACzB;IAAC,WAAM;QACN,SAAS;KACV;IACD,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;QACrD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;KACzD;IACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,SAAS,CACvB,MAAuB,EACvB,OAA6B;IAE7B,OAAO;QACL,SAAS,CAAC,UAAU;YAClB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,IAAI,KAAK,GAAyC,IAAI,CAAC;YAEvD,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE;;gBACnC,IAAI,CAAC,SAAS,EAAE;oBACd,MAAA,UAAU,CAAC,KAAK,2DAAG,KAAK,CAAC,CAAC;iBAC3B;YACH,CAAC,CAAC;YAEF,MAAM,GAAG,GAAG,GAAG,EAAE;gBACf,IAAI,SAAS,EAAE;oBACb,OAAO;iBACR;gBACD,IAAI,OAAO,EAAE;oBACX,KAAK,GAAG,IAAI,CAAC;oBACb,OAAO;iBACR;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,CAAC,OAAO,EAAE;qBACd,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;qBACrB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;;oBACd,IAAI,CAAC,SAAS,EAAE;wBACd,MAAA,UAAU,CAAC,IAAI,2DAAG,KAAK,CAAC,CAAC;qBAC1B;gBACH,CAAC,CAAC;qBACD,KAAK,CAAC,SAAS,CAAC;qBAChB,OAAO,CAAC,GAAG,EAAE;oBACZ,OAAO,GAAG,KAAK,CAAC;oBAChB,IAAI,KAAK,IAAI,CAAC,SAAS,EAAE;wBACvB,KAAK,GAAG,KAAK,CAAC;wBACd,GAAG,EAAE,CAAC;qBACP;gBACH,CAAC,CAAC,CAAC;YACP,CAAC,CAAC;YAEF,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACpB,IAAI,SAAS,EAAE;oBACb,OAAO;iBACR;gBACD,IAAI,KAAK,IAAI,IAAI,EAAE;oBACjB,OAAO;iBACR;gBACD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,KAAK,GAAG,IAAI,CAAC;oBACb,GAAG,EAAE,CAAC;gBACR,CAAC,EAAE,CAAC,CAAC,CAAC;YACR,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,MAAqB,EAAE,EAAE;gBACxC,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,GAAG,EAAE,CAAC;YAEN,OAAO;gBACL,OAAO,EAAE,QAAQ;gBACjB,WAAW;;oBACT,IAAI,SAAS,EAAE;wBACb,OAAO;qBACR;oBACD,SAAS,GAAG,IAAI,CAAC;oBACjB,IAAI,KAAK,IAAI,IAAI,EAAE;wBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;wBACpB,KAAK,GAAG,IAAI,CAAC;qBACd;oBACD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACjC,aAAa,CAAC,MAAM,CAAC,CAAC;oBACtB,MAAA,UAAU,CAAC,QAAQ,0DAAI,CAAC;gBAC1B,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAlFD,8BAkFC"}

package/dist/migrate/diff.d.ts

@@ -0,0 +1,28 @@
+import type { DeclaredDbInterface, DeclaredStoreInterface, IndexInterface } from '../schema/types';
+export interface InstalledStoreInterface {
+    name: string;
+    primaryKey: {
+        keyPath: string | string[] | null;
+        autoIncrement: boolean;
+    };
+    indexes: IndexInterface[];
+}
+export declare function readStoreSchemaFromTx(tx: IDBTransaction, storeName: string): InstalledStoreInterface;
+export interface SchemaDiffInterface {
+    storesToCreate: DeclaredStoreInterface[];
+    storesToDelete: string[];
+    indexesToCreate: {
+        storeName: string;
+        index: IndexInterface;
+    }[];
+    indexesToDelete: {
+        storeName: string;
+        indexName: string;
+    }[];
+    keyPathConflicts: {
+        storeName: string;
+        installed: string | string[] | null;
+        declared: string;
+    }[];
+}
+export declare function diffSchema(tx: IDBTransaction, declared: DeclaredDbInterface): SchemaDiffInterface;

package/dist/migrate/diff.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffSchema = exports.readStoreSchemaFromTx = void 0;
+function keyPathEquals(a, b) {
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((v, i) => v === b[i]);
+    }
+    return a === b;
+}
+function readStoreSchemaFromTx(tx, storeName) {
+    const store = tx.objectStore(storeName);
+    const indexes = [];
+    for (const indexName of Array.from(store.indexNames)) {
+        const index = store.index(indexName);
+        indexes.push({
+            name: index.name,
+            keyPath: index.keyPath,
+            unique: index.unique,
+            multiEntry: index.multiEntry,
+        });
+    }
+    return {
+        name: store.name,
+        primaryKey: {
+            keyPath: store.keyPath,
+            autoIncrement: store.autoIncrement,
+        },
+        indexes,
+    };
+}
+exports.readStoreSchemaFromTx = readStoreSchemaFromTx;
+function diffSchema(tx, declared) {
+    const installedNames = new Set(Array.from(tx.objectStoreNames));
+    const declaredByName = new Map(declared.stores.map((s) => [s.name, s]));
+    const storesToCreate = [];
+    const storesToDelete = [];
+    const indexesToCreate = [];
+    const indexesToDelete = [];
+    const keyPathConflicts = [];
+    for (const store of declared.stores) {
+        if (!installedNames.has(store.name)) {
+            storesToCreate.push(store);
+            continue;
+        }
+        const installed = readStoreSchemaFromTx(tx, store.name);
+        if (!keyPathEquals(installed.primaryKey.keyPath, store.primaryKey.keyPath) ||
+            installed.primaryKey.autoIncrement !== store.primaryKey.autoIncrement) {
+            keyPathConflicts.push({
+                storeName: store.name,
+                installed: installed.primaryKey.keyPath,
+                declared: store.primaryKey.keyPath,
+            });
+        }
+        const installedIndexNames = new Set(installed.indexes.map((i) => i.name));
+        const declaredIndexNames = new Set(store.indexes.map((i) => i.name));
+        for (const index of store.indexes) {
+            const existing = installed.indexes.find((i) => i.name === index.name);
+            if (!existing) {
+                indexesToCreate.push({ storeName: store.name, index });
+                continue;
+            }
+            if (!keyPathEquals(existing.keyPath, index.keyPath) ||
+                Boolean(existing.unique) !== Boolean(index.unique) ||
+                Boolean(existing.multiEntry) !== Boolean(index.multiEntry)) {
+                indexesToDelete.push({ storeName: store.name, indexName: index.name });
+                indexesToCreate.push({ storeName: store.name, index });
+            }
+        }
+        for (const indexName of Array.from(installedIndexNames)) {
+            if (!declaredIndexNames.has(indexName)) {
+                indexesToDelete.push({ storeName: store.name, indexName });
+            }
+        }
+    }
+    for (const name of Array.from(installedNames)) {
+        if (!declaredByName.has(name)) {
+            storesToDelete.push(name);
+        }
+    }
+    return {
+        storesToCreate,
+        storesToDelete,
+        indexesToCreate,
+        indexesToDelete,
+        keyPathConflicts,
+    };
+}
+exports.diffSchema = diffSchema;
+//# sourceMappingURL=diff.js.map

package/dist/migrate/diff.js.map

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

package/dist/migrate/helpers.d.ts

@@ -0,0 +1,29 @@
+import type { IndexInterface, PrimaryKeyInterface } from '../schema/types';
+/** Create an index inside a `versionchange` / upgrade transaction. */
+export declare function addIndex(tx: IDBTransaction, storeName: string, index: IndexInterface): void;
+/** Delete an index inside a `versionchange` / upgrade transaction. */
+export declare function dropIndex(tx: IDBTransaction, storeName: string, indexName: string): void;
+export interface CopyStoreAndDropOptions {
+    /** Existing store to read from. */
+    from: string;
+    /**
+     * Destination store name.
+     * If equal to `from`, copies via a temporary store then swaps in place
+     * (required when changing `keyPath` while keeping the same store name).
+     */
+    to: string;
+    primaryKey: PrimaryKeyInterface;
+    indexes?: IndexInterface[];
+    /**
+     * Transform each record. Return `null` to skip.
+     * Default: shallow copy of the row.
+     */
+    map?: (row: Record<string, unknown>) => Record<string, unknown> | null;
+}
+/**
+ * Copy records into a (new) store, then drop the source (or swap in place).
+ *
+ * Use inside `upgrade` hooks when changing `keyPath` — IndexedDB cannot
+ * alter keyPath in place. Same-name recreate uses a temporary store.
+ */
+export declare function copyStoreAndDrop(db: IDBDatabase, tx: IDBTransaction, options: CopyStoreAndDropOptions): void;

package/dist/migrate/helpers.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyStoreAndDrop = exports.dropIndex = exports.addIndex = void 0;
+const errors_1 = require("../errors");
+function createIndexOnStore(store, index) {
+    store.createIndex(index.name, index.keyPath, {
+        unique: Boolean(index.unique),
+        multiEntry: Boolean(index.multiEntry),
+    });
+}
+/** Create an index inside a `versionchange` / upgrade transaction. */
+function addIndex(tx, storeName, index) {
+    const store = tx.objectStore(storeName);
+    if (store.indexNames.contains(index.name)) {
+        return;
+    }
+    createIndexOnStore(store, index);
+}
+exports.addIndex = addIndex;
+/** Delete an index inside a `versionchange` / upgrade transaction. */
+function dropIndex(tx, storeName, indexName) {
+    const store = tx.objectStore(storeName);
+    if (!store.indexNames.contains(indexName)) {
+        return;
+    }
+    store.deleteIndex(indexName);
+}
+exports.dropIndex = dropIndex;
+function createStoreWithIndexes(db, name, primaryKey, indexes) {
+    const store = db.createObjectStore(name, {
+        keyPath: primaryKey.keyPath,
+        autoIncrement: Boolean(primaryKey.autoIncrement),
+    });
+    for (const index of indexes) {
+        createIndexOnStore(store, index);
+    }
+}
+function copyRows(rows, dest, map) {
+    for (const raw of rows) {
+        const row = raw;
+        const next = map ? map(row) : Object.assign({}, row);
+        if (next !== null) {
+            dest.put(next);
+        }
+    }
+}
+/**
+ * Copy records into a (new) store, then drop the source (or swap in place).
+ *
+ * Use inside `upgrade` hooks when changing `keyPath` — IndexedDB cannot
+ * alter keyPath in place. Same-name recreate uses a temporary store.
+ */
+function copyStoreAndDrop(db, tx, options) {
+    const { from, to, primaryKey, indexes = [], map } = options;
+    if (!db.objectStoreNames.contains(from)) {
+        throw new errors_1.IndexedDbError('SCHEMA_INVALID', `copyStoreAndDrop: source store "${from}" does not exist`, { store: from });
+    }
+    const inPlace = from === to;
+    const destName = inPlace ? `${from}__idc_migrate` : to;
+    if (db.objectStoreNames.contains(destName)) {
+        throw new errors_1.IndexedDbError('SCHEMA_INVALID', `copyStoreAndDrop: destination store "${destName}" already exists`, { store: destName });
+    }
+    createStoreWithIndexes(db, destName, primaryKey, indexes);
+    const getAll = tx.objectStore(from).getAll();
+    getAll.onerror = () => {
+        console.error('copyStoreAndDrop getAll failed', getAll.error);
+    };
+    getAll.onsuccess = () => {
+        const rows = getAll.result;
+        // Re-resolve store from the live transaction (stale refs go inactive).
+        copyRows(rows, tx.objectStore(destName), map);
+        if (!inPlace) {
+            db.deleteObjectStore(from);
+            return;
+        }
+        db.deleteObjectStore(from);
+        createStoreWithIndexes(db, from, primaryKey, indexes);
+        const getTemp = tx.objectStore(destName).getAll();
+        getTemp.onerror = () => {
+            console.error('copyStoreAndDrop temp getAll failed', getTemp.error);
+        };
+        getTemp.onsuccess = () => {
+            copyRows(getTemp.result, tx.objectStore(from), undefined);
+            db.deleteObjectStore(destName);
+        };
+    };
+}
+exports.copyStoreAndDrop = copyStoreAndDrop;
+//# sourceMappingURL=helpers.js.map

package/dist/migrate/helpers.js.map

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

package/dist/migrate/index.d.ts

@@ -0,0 +1,6 @@
+export { diffSchema, readStoreSchemaFromTx } from './diff';
+export type { InstalledStoreInterface, SchemaDiffInterface, } from './diff';
+export { applySchemaUpgrade, assertKeyPathsMatchSchema } from './upgrade';
+export type { ApplyUpgradeArgsInterface } from './upgrade';
+export { addIndex, dropIndex, copyStoreAndDrop } from './helpers';
+export type { CopyStoreAndDropOptions } from './helpers';

package/dist/migrate/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyStoreAndDrop = exports.dropIndex = exports.addIndex = exports.assertKeyPathsMatchSchema = exports.applySchemaUpgrade = exports.readStoreSchemaFromTx = exports.diffSchema = void 0;
+var diff_1 = require("./diff");
+Object.defineProperty(exports, "diffSchema", { enumerable: true, get: function () { return diff_1.diffSchema; } });
+Object.defineProperty(exports, "readStoreSchemaFromTx", { enumerable: true, get: function () { return diff_1.readStoreSchemaFromTx; } });
+var upgrade_1 = require("./upgrade");
+Object.defineProperty(exports, "applySchemaUpgrade", { enumerable: true, get: function () { return upgrade_1.applySchemaUpgrade; } });
+Object.defineProperty(exports, "assertKeyPathsMatchSchema", { enumerable: true, get: function () { return upgrade_1.assertKeyPathsMatchSchema; } });
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "addIndex", { enumerable: true, get: function () { return helpers_1.addIndex; } });
+Object.defineProperty(exports, "dropIndex", { enumerable: true, get: function () { return helpers_1.dropIndex; } });
+Object.defineProperty(exports, "copyStoreAndDrop", { enumerable: true, get: function () { return helpers_1.copyStoreAndDrop; } });
+//# sourceMappingURL=index.js.map

package/dist/migrate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrate/index.ts"],"names":[],"mappings":";;;AAAA,+BAA2D;AAAlD,kGAAA,UAAU,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAK1C,qCAA0E;AAAjE,6GAAA,kBAAkB,OAAA;AAAE,oHAAA,yBAAyB,OAAA;AAEtD,qCAAkE;AAAzD,mGAAA,QAAQ,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,2GAAA,gBAAgB,OAAA"}

package/dist/migrate/upgrade.d.ts

@@ -0,0 +1,19 @@
+import type { DeclaredDbInterface, UpgradeFn } from '../schema/types';
+/** Sync check after upgrade tx completed (e.g. on open success). */
+export declare function assertKeyPathsMatchSchema(db: IDBDatabase, schema: DeclaredDbInterface): void;
+export interface ApplyUpgradeArgsInterface {
+    db: IDBDatabase;
+    tx: IDBTransaction;
+    schema: DeclaredDbInterface;
+    oldVersion: number;
+    newVersion: number;
+    upgradeHooks?: Record<number, UpgradeFn>;
+}
+/**
+ * Apply structural schema changes and versioned upgrade hooks.
+ *
+ * When declared `keyPath` differs from installed, hooks run **first** so they
+ * can `copyStoreAndDrop`. Structural ops for those stores are skipped in this
+ * turn (the helper recreates them). A final keyPath check runs on open success.
+ */
+export declare function applySchemaUpgrade(args: ApplyUpgradeArgsInterface): void;

package/dist/migrate/upgrade.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySchemaUpgrade = exports.assertKeyPathsMatchSchema = void 0;
+const errors_1 = require("../errors");
+const diff_1 = require("./diff");
+function createIndex(store, index) {
+    store.createIndex(index.name, index.keyPath, {
+        unique: Boolean(index.unique),
+        multiEntry: Boolean(index.multiEntry),
+    });
+}
+function keyPathEquals(a, b) {
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((v, i) => v === b[i]);
+    }
+    return a === b;
+}
+function runUpgradeHooks(tx, oldVersion, newVersion, upgradeHooks) {
+    if (!upgradeHooks) {
+        return;
+    }
+    const versions = Object.keys(upgradeHooks)
+        .map(Number)
+        .filter((v) => v > oldVersion && v <= newVersion)
+        .sort((a, b) => a - b);
+    for (const version of versions) {
+        const hook = upgradeHooks[version];
+        void hook(tx, { oldVersion, newVersion });
+    }
+}
+/** Sync check after upgrade tx completed (e.g. on open success). */
+function assertKeyPathsMatchSchema(db, schema) {
+    const existing = schema.stores
+        .map((s) => s.name)
+        .filter((n) => db.objectStoreNames.contains(n));
+    if (existing.length === 0) {
+        return;
+    }
+    const tx = db.transaction(existing, 'readonly');
+    const conflicts = [];
+    for (const store of schema.stores) {
+        if (!db.objectStoreNames.contains(store.name)) {
+            continue;
+        }
+        const installed = (0, diff_1.readStoreSchemaFromTx)(tx, store.name);
+        if (!keyPathEquals(installed.primaryKey.keyPath, store.primaryKey.keyPath) ||
+            installed.primaryKey.autoIncrement !== store.primaryKey.autoIncrement) {
+            conflicts.push(`"${store.name}": installed keyPath ${JSON.stringify(installed.primaryKey.keyPath)} vs declared "${store.primaryKey.keyPath}"`);
+        }
+    }
+    if (conflicts.length === 0) {
+        return;
+    }
+    throw new errors_1.IndexedDbError('SCHEMA_MISMATCH', `Cannot change object store keyPath in place. Use copyStoreAndDrop() in an upgrade hook (see docs/upgrades.md). Conflicts: ${conflicts.join('; ')}`);
+}
+exports.assertKeyPathsMatchSchema = assertKeyPathsMatchSchema;
+/**
+ * Apply structural schema changes and versioned upgrade hooks.
+ *
+ * When declared `keyPath` differs from installed, hooks run **first** so they
+ * can `copyStoreAndDrop`. Structural ops for those stores are skipped in this
+ * turn (the helper recreates them). A final keyPath check runs on open success.
+ */
+function applySchemaUpgrade(args) {
+    const { db, tx, schema, oldVersion, newVersion, upgradeHooks } = args;
+    const diff = (0, diff_1.diffSchema)(tx, schema);
+    const conflicted = new Set(diff.keyPathConflicts.map((c) => c.storeName));
+    const hasKeyPathConflict = conflicted.size > 0;
+    if (hasKeyPathConflict) {
+        runUpgradeHooks(tx, oldVersion, newVersion, upgradeHooks);
+    }
+    const next = hasKeyPathConflict ? (0, diff_1.diffSchema)(tx, schema) : diff;
+    // After async copyStoreAndDrop the sync re-diff may still see old keyPaths;
+    // never delete/recreate conflicted stores here — hooks own that.
+    const skip = (storeName) => conflicted.has(storeName);
+    for (const storeName of next.storesToDelete) {
+        if (skip(storeName)) {
+            continue;
+        }
+        // Temporary stores used by copyStoreAndDrop during this upgrade.
+        if (storeName.endsWith('__idc_migrate')) {
+            continue;
+        }
+        db.deleteObjectStore(storeName);
+    }
+    for (const store of next.storesToCreate) {
+        if (skip(store.name)) {
+            continue;
+        }
+        const objectStore = db.createObjectStore(store.name, {
+            keyPath: store.primaryKey.keyPath,
+            autoIncrement: store.primaryKey.autoIncrement,
+        });
+        for (const index of store.indexes) {
+            createIndex(objectStore, index);
+        }
+    }
+    for (const { storeName, indexName } of next.indexesToDelete) {
+        if (skip(storeName)) {
+            continue;
+        }
+        if (db.objectStoreNames.contains(storeName)) {
+            const store = tx.objectStore(storeName);
+            if (store.indexNames.contains(indexName)) {
+                store.deleteIndex(indexName);
+            }
+        }
+    }
+    for (const { storeName, index } of next.indexesToCreate) {
+        if (skip(storeName)) {
+            continue;
+        }
+        const store = tx.objectStore(storeName);
+        if (!store.indexNames.contains(index.name)) {
+            createIndex(store, index);
+        }
+    }
+    if (!hasKeyPathConflict) {
+        runUpgradeHooks(tx, oldVersion, newVersion, upgradeHooks);
+    }
+}
+exports.applySchemaUpgrade = applySchemaUpgrade;
+//# sourceMappingURL=upgrade.js.map

package/dist/migrate/upgrade.js.map

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