@vielzeug/vault 2.2.0 → 2.3.0

package/dist/adapters/indexeddb.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"indexeddb.cjs","names":[],"sources":["../../src/adapters/indexeddb.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\nimport {\n  assertBatchTables,\n  type BatchImpl,\n  buildAdapterOps,\n  buildTxContext,\n  type StorageBackend,\n  withIndexedDbTransactions,\n} from '../adapter-core';\nimport { VaultDisposedError, VaultError, VaultMigrationError } from '../errors';\nimport { encodeVaultKey, getRecordKey } from '../internal';\nimport type { NativeRange } from '../query';\nimport { isExpired, parseStored, type StoredRecord } from '../ttl';\nimport type {\n  AnySchema,\n  BaseAdapterOptions,\n  IndexedDbVaultStore,\n  KeyOf,\n  MigrationFn,\n  RecordOf,\n  TransactionContext,\n  TtlMs,\n} from '../types';\n\nfunction idbReq<R>(request: IDBRequest<R>): Promise<R> {\n  return new Promise<R>((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error ?? new VaultError('IndexedDB request failed'));\n  });\n}\n\nfunction wrapTxError(scope: string, message: string, cause: unknown): VaultError {\n  const causeMessage = cause instanceof Error && cause.message ? `: ${cause.message}` : '';\n\n  return new VaultError(`${message} on \"${scope}\"${causeMessage}`, { cause });\n}\n\nfunction runIdbTx<T>(tx: IDBTransaction, scope: string, work: () => Promise<T>): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let result: T | undefined;\n    let callbackError: unknown;\n\n    Promise.resolve()\n      .then(work)\n      .then((value) => {\n        result = value;\n      })\n      .catch((error) => {\n        callbackError = error;\n\n        try {\n          tx.abort();\n        } catch {\n          /* ignore */\n        }\n      });\n\n    const rejectWithCallbackError = (fallbackCause: unknown, message = 'transaction failed'): void => {\n      if (callbackError instanceof Error) {\n        reject(callbackError);\n      } else {\n        reject(wrapTxError(scope, message, callbackError ?? fallbackCause));\n      }\n    };\n\n    tx.oncomplete = () => {\n      if (callbackError) {\n        rejectWithCallbackError(undefined);\n\n        return;\n      }\n\n      resolve(result as T);\n    };\n    tx.onerror = () => reject(wrapTxError(scope, 'transaction error', tx.error));\n    tx.onabort = () => rejectWithCallbackError(tx.error, 'transaction aborted');\n  });\n}\n\nasync function getAllFromStore<T extends object>(\n  store: IDBObjectStore,\n  decode: (raw: unknown) => T | undefined,\n): Promise<T[]> {\n  const rawRecords = await idbReq<unknown[]>(store.getAll());\n  const records: T[] = [];\n\n  for (const raw of rawRecords) {\n    const value = decode(raw);\n\n    if (value !== undefined) records.push(value);\n  }\n\n  return records;\n}\n\nasync function getAllFromStoreByIndex<T extends object>(\n  store: IDBObjectStore,\n  indexName: string,\n  range: NativeRange,\n  decode: (raw: unknown) => T | undefined,\n): Promise<T[]> {\n  const index = store.index(indexName);\n  const idbRange =\n    range.type === 'eq'\n      ? IDBKeyRange.only(range.value as IDBValidKey)\n      : range.type === 'between'\n        ? IDBKeyRange.bound(range.lower as IDBValidKey, range.upper as IDBValidKey)\n        : IDBKeyRange.bound(range.prefix, `${range.prefix}\\uffff`);\n  const rawRecords = await idbReq<unknown[]>(index.getAll(idbRange));\n  const records: T[] = [];\n\n  for (const raw of rawRecords) {\n    const value = decode(raw);\n\n    if (value !== undefined) records.push(value);\n  }\n\n  return records;\n}\n\nasync function storeGet<T extends object>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  decode: (raw: unknown) => T | undefined,\n): Promise<T | undefined> {\n  const raw = await idbReq<unknown>(store.get(key));\n\n  if (raw == null) return undefined;\n\n  return decode(raw);\n}\n\nasync function storeHas<T extends object>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  decode: (raw: unknown) => T | undefined,\n): Promise<boolean> {\n  return (await storeGet<T>(store, key, decode)) !== undefined;\n}\n\nasync function storeDelete<T extends object>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  decode: (raw: unknown) => T | undefined,\n): Promise<boolean> {\n  const live = await storeHas<T>(store, key, decode);\n\n  await idbReq(store.delete(key));\n\n  return live;\n}\n\nasync function storeDeleteMany<T extends object>(\n  store: IDBObjectStore,\n  keys: IDBValidKey[],\n  decode: (raw: unknown) => T | undefined,\n): Promise<number> {\n  if (keys.length === 0) return 0;\n\n  const results = await Promise.all(keys.map((k) => storeDelete<T>(store, k, decode)));\n\n  return results.filter(Boolean).length;\n}\n\nasync function storePutAt<T>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  value: T,\n  encode: (v: T, ttl?: TtlMs) => unknown,\n  ttl?: TtlMs,\n): Promise<void> {\n  await idbReq(store.put(encode(value, ttl), key));\n}\n\nfunction pruneExpiredInStore(store: IDBObjectStore): Promise<number> {\n  return new Promise<number>((resolve, reject) => {\n    let deleted = 0;\n    const request = store.openCursor();\n\n    request.onerror = () => reject(request.error ?? new VaultError('IndexedDB cursor failed during prune'));\n    request.onsuccess = () => {\n      const cursor = request.result;\n\n      if (!cursor) {\n        resolve(deleted);\n\n        return;\n      }\n\n      const stored = parseStored(cursor.value as unknown);\n\n      if (!stored || isExpired(stored.expiresAt)) {\n        cursor.delete();\n        deleted += 1;\n      }\n\n      cursor.continue();\n    };\n  });\n}\n\n/**\n * Cursor state machine — a single discriminated union replaces five boolean/nullable variables.\n * Transitions: idle → waiting (next() before cursor fires) | buffered (cursor fires first) | done | error\n */\ntype CursorState<T> =\n  | { type: 'idle' }\n  | { reject: (e: unknown) => void; resolve: (r: IteratorResult<T>) => void; type: 'waiting' }\n  | { result: IteratorResult<T>; type: 'buffered' }\n  | { error: unknown; type: 'error' }\n  | { type: 'done' };\n\n/**\n * F1: True cursor-based iteration for IndexedDB.\n * Yields live records one-by-one using an IDB cursor, avoiding materializing the full table.\n * This is memory-efficient for large tables — the cursor walks the store incrementally.\n *\n * Design: the cursor is opened *synchronously* in [Symbol.asyncIterator]() so that event\n * handlers are wired immediately (no queueMicrotask races). The cursor is advanced *eagerly*\n * before yielding — this keeps the IDB readonly transaction alive between consumer awaits,\n * because IDB auto-commits when there are no pending requests.\n */\nfunction iterateStoreWithCursor<T extends object>(\n  store: IDBObjectStore,\n  decode: (raw: unknown) => T | undefined,\n): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<T> {\n      const cursorRequest = store.openCursor();\n      let state: CursorState<T> = { type: 'idle' };\n\n      const deliver = (result: IteratorResult<T>): void => {\n        if (state.type === 'waiting') {\n          const { resolve } = state;\n\n          state = result.done ? { type: 'done' } : { type: 'idle' };\n          resolve(result);\n        } else {\n          state = { result, type: 'buffered' };\n        }\n      };\n\n      cursorRequest.onerror = () => {\n        const err = cursorRequest.error ?? new VaultError('IndexedDB cursor iteration failed');\n\n        if (state.type === 'waiting') {\n          const { reject } = state;\n\n          state = { type: 'done' };\n          reject(err);\n        } else {\n          state = { error: err, type: 'error' };\n        }\n      };\n\n      cursorRequest.onsuccess = () => {\n        const cursor = cursorRequest.result;\n\n        if (!cursor) {\n          deliver({ done: true, value: undefined });\n\n          return;\n        }\n\n        const value = decode(cursor.value as unknown);\n\n        // Advance eagerly BEFORE yielding to keep the IDB transaction alive.\n        cursor.continue();\n\n        if (value !== undefined) deliver({ done: false, value });\n      };\n\n      return {\n        next(): Promise<IteratorResult<T>> {\n          if (state.type === 'error') {\n            const { error } = state;\n\n            state = { type: 'done' };\n\n            return Promise.reject(error);\n          }\n\n          if (state.type === 'buffered') {\n            const { result } = state;\n\n            state = result.done ? { type: 'done' } : { type: 'idle' };\n\n            return Promise.resolve(result);\n          }\n\n          if (state.type === 'done') return Promise.resolve({ done: true, value: undefined });\n\n          return new Promise<IteratorResult<T>>((resolve, reject) => {\n            state = { reject, resolve, type: 'waiting' };\n          });\n        },\n\n        return(value?: unknown): Promise<IteratorResult<T>> {\n          if (state.type === 'waiting') state.resolve({ done: true, value: undefined });\n\n          state = { type: 'done' };\n\n          return Promise.resolve({ done: true, value });\n        },\n\n        throw(err?: unknown): Promise<IteratorResult<T>> {\n          if (state.type === 'waiting') state.reject(err);\n\n          state = { type: 'done' };\n\n          return Promise.reject(err);\n        },\n      };\n    },\n  };\n}\n\n/**\n * R3: Extracted IDB batch core — builds a StorageBackend that operates within\n * an existing IDBTransaction, shared by all tables in the batch.\n * Eliminates the duplicated `txCore` block that was previously inlined in `idbBatch`.\n */\nfunction buildIdbBatchCore<S extends AnySchema, K extends keyof S & string>(\n  schema: S,\n  idbTx: IDBTransaction,\n  decode: <T extends object>(raw: unknown) => T | undefined,\n  encode: <T>(value: T, ttl?: TtlMs) => unknown,\n): StorageBackend<S, K> {\n  const storeOf = (table: K): IDBObjectStore => idbTx.objectStore(table);\n\n  return {\n    clear: async (table) => {\n      await idbReq(storeOf(table).clear());\n    },\n    count: async (table) => {\n      // Must inspect each stored record to exclude TTL-expired entries.\n      // Individual put() calls can attach a TTL even when the schema has no defaultTtl,\n      // so schema[table].defaultTtl being absent does not guarantee a clean count.\n      // This matches the top-level core.count() behaviour in the IDB adapter.\n      const all = await idbReq<unknown[]>(storeOf(table).getAll());\n\n      return all.filter((r) => decode(r) !== undefined).length;\n    },\n    delete: (table, key) => storeDelete<RecordOf<S, K>>(storeOf(table), encodeVaultKey(key), decode),\n    deleteMany: (table, keys) => storeDeleteMany<RecordOf<S, K>>(storeOf(table), keys.map(encodeVaultKey), decode),\n    get: (table, key) => storeGet<RecordOf<S, typeof table>>(storeOf(table), encodeVaultKey(key), decode),\n    getAll: (table) => getAllFromStore<RecordOf<S, typeof table>>(storeOf(table), decode),\n    getByIndexRange: (table, field, range) =>\n      getAllFromStoreByIndex<RecordOf<S, typeof table>>(storeOf(table), field, range, decode),\n    getMany: (table, keys) =>\n      Promise.all(keys.map((key) => storeGet<RecordOf<S, typeof table>>(storeOf(table), encodeVaultKey(key), decode))),\n    has: (table, key) => storeHas<RecordOf<S, typeof table>>(storeOf(table), encodeVaultKey(key), decode),\n    pruneExpiredInTable: (table) => pruneExpiredInStore(storeOf(table)),\n    put(table, value, ttl) {\n      return storePutAt(storeOf(table), encodeVaultKey(getRecordKey(schema, table, value)), value, encode, ttl);\n    },\n    putAll(table, values, ttl) {\n      return Promise.all(\n        values.map((v) => storePutAt(storeOf(table), encodeVaultKey(getRecordKey(schema, table, v)), v, encode, ttl)),\n      ).then(() => undefined);\n    },\n  };\n}\n\ntype IndexedDbOptions<S extends AnySchema> = BaseAdapterOptions<S> & {\n  migrate?: MigrationFn;\n  name: string;\n  /** Schema version. Must be a positive integer. Increment when adding tables or changing the schema, then provide `migrate`. Defaults to 1. */\n  version?: number;\n};\n\nexport function createIndexedDB<S extends AnySchema>(options: IndexedDbOptions<S>): IndexedDbVaultStore<S> {\n  const { logger, migrate, name, onMetrics, schema, validators, version = 1 } = options;\n\n  if (!Number.isInteger(version) || version < 1) {\n    throw new VaultError(`createIndexedDB: version must be a positive integer, got ${String(version)}`);\n  }\n\n  // Fixed envelopes keep IndexedDB records and `value.<field>` indexes portable across adapters.\n  const decode = <T extends object>(raw: unknown): T | undefined => {\n    const stored = parseStored<T>(raw);\n\n    return !stored || isExpired(stored.expiresAt) ? undefined : stored.value;\n  };\n\n  const encode = <T>(value: T, ttl?: TtlMs): StoredRecord<T> => {\n    return ttl === undefined ? { value } : { expiresAt: Date.now() + ttl, value };\n  };\n\n  const channel = typeof BroadcastChannel !== 'undefined' ? new BroadcastChannel(`vault:${name}`) : undefined;\n\n  if (!channel && logger) {\n    logger.error(`[vault] BroadcastChannel unavailable — cross-tab sync disabled for \"${name}\"`);\n  }\n\n  let db: IDBDatabase | null = null;\n  let connectPromise: Promise<void> | null = null;\n  let disposed = false;\n\n  const createObjectStores = (target: IDBDatabase, tx: IDBTransaction): void => {\n    for (const [tableName, entry] of Object.entries(schema)) {\n      let store: IDBObjectStore;\n\n      if (!target.objectStoreNames.contains(tableName)) {\n        store = target.createObjectStore(tableName);\n      } else {\n        store = tx.objectStore(tableName);\n      }\n\n      // F5: Create secondary indexes for fields declared via .index() on the table() builder.\n      // Stored format is { value: T, expiresAt?: number } so IDB keyPath is `value.<field>`.\n      const indexes = (entry as { indexes?: readonly string[] }).indexes ?? [];\n\n      for (const field of indexes) {\n        if (!store.indexNames.contains(field)) {\n          store.createIndex(field, `value.${field}`);\n        }\n      }\n    }\n  };\n\n  const connect = async (): Promise<void> => {\n    if (!connectPromise) {\n      connectPromise = new Promise((resolve, reject) => {\n        const request = indexedDB.open(name, version);\n\n        request.onupgradeneeded = (event) => {\n          const target = request.result;\n          const tx = request.transaction!;\n\n          if (migrate) {\n            try {\n              migrate({\n                db: target,\n                newVersion: (event as IDBVersionChangeEvent).newVersion ?? null,\n                oldVersion: event.oldVersion,\n                tx,\n              });\n            } catch (error) {\n              try {\n                tx.abort();\n              } catch {\n                /* ignore */\n              }\n\n              reject(new VaultMigrationError(`migration failed for \"${name}\"`, { cause: error }));\n\n              return;\n            }\n          }\n\n          createObjectStores(target, tx);\n        };\n\n        request.onsuccess = () => {\n          if (disposed) {\n            request.result.close();\n            resolve();\n\n            return;\n          }\n\n          const connection = request.result;\n\n          connection.onversionchange = () => {\n            connection.close();\n            db = null;\n            connectPromise = null;\n          };\n\n          db = connection;\n          resolve();\n        };\n        request.onerror = () => {\n          connectPromise = null;\n          reject(new VaultError(`failed to open \"${name}\"`, { cause: request.error }));\n        };\n      });\n    }\n\n    return connectPromise;\n  };\n\n  const withStore = async <T>(\n    table: keyof S,\n    mode: 'readonly' | 'readwrite',\n    fn: (store: IDBObjectStore) => Promise<T>,\n  ): Promise<T> => {\n    if (disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    if (!db) await connect();\n\n    if (!db) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    const tableName = String(table);\n    const tx = db.transaction(tableName, mode);\n\n    return runIdbTx(tx, `${name}/${tableName}`, () => fn(tx.objectStore(tableName)));\n  };\n\n  const requireDb = async (): Promise<IDBDatabase> => {\n    if (disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    if (!db) await connect();\n\n    if (!db) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    return db;\n  };\n\n  const publish = <K extends keyof S>(table: K): void => {\n    channel?.postMessage({ table: String(table) });\n  };\n\n  const core: StorageBackend<S> = {\n    clear: (table) => withStore(table, 'readwrite', (s) => idbReq(s.clear()).then(() => undefined)),\n\n    count: (table) =>\n      withStore(table, 'readonly', async (s) => {\n        // Must inspect each stored record to exclude TTL-expired entries.\n        // Individual put() calls can attach a TTL even when the schema has no defaultTtl,\n        // so schema[table].defaultTtl being absent does not guarantee a clean count.\n        const all = await idbReq<unknown[]>(s.getAll());\n\n        return all.filter((r) => decode(r) !== undefined).length;\n      }),\n\n    delete: (table, key) =>\n      withStore(table, 'readwrite', (s) => storeDelete<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode)),\n\n    deleteMany: (table, keys) =>\n      keys.length === 0\n        ? Promise.resolve(0)\n        : withStore(table, 'readwrite', (s) =>\n            storeDeleteMany<RecordOf<S, typeof table>>(s, keys.map(encodeVaultKey), decode),\n          ),\n\n    async dispose(): Promise<void> {\n      disposed = true;\n      channel?.close();\n\n      // F7: Wait for any in-progress connect before closing the DB to avoid\n      // \"database connection is closing\" errors on in-flight requests.\n      if (connectPromise) await connectPromise.catch(() => {});\n\n      db?.close();\n      db = null;\n      connectPromise = null;\n    },\n\n    get: (table, key) =>\n      withStore(table, 'readonly', (s) => storeGet<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode)),\n\n    getAll: (table) => withStore(table, 'readonly', (s) => getAllFromStore<RecordOf<S, typeof table>>(s, decode)),\n\n    // Ad-hoc per-put TTLs can be attached regardless of schema-level defaultTtl (same caveat as\n    // count()), so we cannot take the O(1) store.getAllKeys() shortcut unconditionally — every\n    // record must be decoded to exclude TTL-expired entries correctly.\n    getAllKeys: (table) =>\n      withStore(table, 'readonly', async (s) => {\n        const records = await getAllFromStore<RecordOf<S, typeof table>>(s, decode);\n        const keyField = schema[table].key;\n\n        return records.map((r) => (r as Record<string, unknown>)[keyField] as KeyOf<S, typeof table>);\n      }),\n\n    getByIndexRange: (table, field, range) =>\n      withStore(table, 'readonly', (s) => getAllFromStoreByIndex<RecordOf<S, typeof table>>(s, field, range, decode)),\n\n    getMany: (table, keys) =>\n      keys.length === 0\n        ? Promise.resolve([])\n        : withStore(table, 'readonly', (s) =>\n            Promise.all(keys.map((key) => storeGet<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode))),\n          ),\n\n    getRawCount: (table) => withStore(table, 'readonly', (s) => idbReq(s.count())),\n\n    has: (table, key) =>\n      withStore(table, 'readonly', (s) => storeHas<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode)),\n\n    async pruneAllExpired() {\n      const idb = await requireDb();\n      const tableNames = Object.keys(schema);\n      const tx = idb.transaction(tableNames, 'readwrite');\n      const results = await runIdbTx(tx, `${name}/pruneAll`, () =>\n        Promise.all(tableNames.map(async (t) => [t, await pruneExpiredInStore(tx.objectStore(t))] as const)),\n      );\n\n      return Object.fromEntries(results);\n    },\n\n    pruneExpiredInTable: (table) => withStore(table, 'readwrite', (s) => pruneExpiredInStore(s)),\n\n    put(table, value, ttl) {\n      const key = encodeVaultKey(getRecordKey(schema, table, value));\n\n      return withStore(table, 'readwrite', (s) => storePutAt(s, key, value, encode, ttl));\n    },\n\n    putAll(table, values, ttl) {\n      return withStore(table, 'readwrite', (s) =>\n        Promise.all(\n          values.map((v) => storePutAt(s, encodeVaultKey(getRecordKey(schema, table, v)), v, encode, ttl)),\n        ).then(() => undefined),\n      );\n    },\n  };\n\n  const idbBatch = async <K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n    notifyMutation: (table: K) => void,\n    validateFn: <T extends K>(table: T, value: RecordOf<S, T>) => RecordOf<S, T>,\n  ): Promise<R> => {\n    assertBatchTables(tables);\n\n    const idb = await requireDb();\n    const idbTx = idb.transaction([...tables] as string[], 'readwrite');\n    const dirtyTables = new Set<K>();\n\n    const txCore = buildIdbBatchCore<S, K>(schema, idbTx, decode, encode);\n    const scope = new Set<string>(tables);\n    const tx = buildTxContext<S, K>(schema, txCore, (t) => dirtyTables.add(t), validateFn, scope);\n    const result = await runIdbTx(idbTx, name, () => fn(tx));\n\n    for (const table of dirtyTables) {\n      notifyMutation(table);\n    }\n\n    return result;\n  };\n\n  let batch: BatchImpl<S> | undefined;\n  const adapter = buildAdapterOps(schema, core, {\n    logger,\n    onCrossTabMessage(notify) {\n      if (!channel) {\n        return undefined;\n      }\n\n      channel.onmessage = (event: MessageEvent<{ table?: string }>) => {\n        const tableName = event.data?.table;\n\n        if (!tableName || !Object.hasOwn(schema, tableName)) return;\n\n        notify(tableName as keyof S & string);\n      };\n\n      return () => {\n        channel.onmessage = null;\n      };\n    },\n    onMetrics,\n    onMutation: publish,\n    onTransactions: (deps) => {\n      batch = (tables, fn) => idbBatch(tables, fn, deps.notifyMutation, deps.validate);\n    },\n    schema,\n    validators,\n  });\n\n  /**\n   * F1: Attach cursor-based `iterate()` on top of the adapter.\n   * Opens a dedicated readonly transaction per call and streams records via IDB cursor —\n   * genuinely memory-efficient for large tables unlike the getAll()-then-yield pattern.\n   */\n  const store = {\n    ...adapter,\n    iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>> {\n      if (disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n      // Each call opens a fresh transaction so iteration doesn't hold locks across awaits.\n      // We need to ensure the DB is connected before opening the transaction.\n      const getIterable = async (): Promise<AsyncIterable<RecordOf<S, K>>> => {\n        if (!db) await connect();\n\n        if (!db || disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n        const idb = db;\n        const tx = idb.transaction(String(table), 'readonly');\n        const store = tx.objectStore(String(table));\n\n        return iterateStoreWithCursor<RecordOf<S, K>>(store, decode as (raw: unknown) => RecordOf<S, K> | undefined);\n      };\n\n      let inner: AsyncIterator<RecordOf<S, K>> | undefined;\n\n      const initInner = (): Promise<AsyncIterator<RecordOf<S, K>>> =>\n        getIterable().then((iterable) => {\n          inner = iterable[Symbol.asyncIterator]();\n\n          return inner;\n        });\n\n      return {\n        [Symbol.asyncIterator](): AsyncIterator<RecordOf<S, K>> {\n          return {\n            next(): Promise<IteratorResult<RecordOf<S, K>>> {\n              // Sync check avoids an extra Promise allocation on every iteration after the first.\n              if (inner) return inner.next();\n\n              return initInner().then((it) => it.next());\n            },\n            return(value?: unknown): Promise<IteratorResult<RecordOf<S, K>>> {\n              if (inner) return inner.return?.(value) ?? Promise.resolve({ done: true, value });\n\n              return Promise.resolve({ done: true, value });\n            },\n            throw(err?: unknown): Promise<IteratorResult<RecordOf<S, K>>> {\n              if (inner) return inner.throw?.(err) ?? Promise.reject(err);\n\n              return Promise.reject(err);\n            },\n          };\n        },\n      };\n    },\n  };\n\n  if (!batch) throw new VaultError('IndexedDB transaction capability was not initialized');\n\n  return withIndexedDbTransactions(store, batch);\n}\n"],"mappings":"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"}
+{"version":3,"file":"indexeddb.cjs","names":[],"sources":["../../src/adapters/indexeddb.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\nimport {\n  assertBatchTables,\n  type BatchImpl,\n  buildAdapterOps,\n  buildTxContext,\n  type StorageBackend,\n  withIndexedDbTransactions,\n} from '../adapter-core';\nimport { VaultDisposedError, VaultError, VaultMigrationError } from '../errors';\nimport { encodeVaultKey, getRecordKey } from '../internal';\nimport type { NativeRange } from '../query';\nimport { isExpired, parseStored, type StoredRecord } from '../ttl';\nimport type { AnySchema, BaseAdapterOptions, IndexedDbVaultStore, KeyOf, RecordOf, TransactionContext } from '../types';\n\nexport type { IndexedDbVaultStore };\n\n/** IndexedDB-only migration context supplied to `MigrationFn` during `onupgradeneeded`. */\nexport type MigrationContext = {\n  db: IDBDatabase;\n  newVersion: number | null;\n  oldVersion: number;\n  tx: IDBTransaction;\n};\n\n/** Synchronous IndexedDB schema upgrade callback. */\nexport type MigrationFn = (ctx: MigrationContext) => void;\n\n/**\n * A single step in a typed migration definition.\n * Compose multiple steps to describe the full schema change between two versions.\n */\nexport type MigrationStep =\n  | { field: string; table: string; type: 'addIndex' }\n  | { field: string; table: string; type: 'removeIndex' }\n  | { name: string; type: 'addTable' }\n  | { name: string; type: 'removeTable' };\n\n/**\n * Builds a typed `MigrationFn` from a declarative list of schema change steps.\n * Each step is applied in order and is idempotent (safe to run when the target\n * already exists or has already been removed).\n *\n * ```ts\n * const migrate = defineMigration([\n *   { type: 'addTable', name: 'sessions' },\n *   { type: 'addIndex', table: 'users', field: 'email' },\n *   { type: 'removeTable', name: 'legacyTokens' },\n * ]);\n *\n * const db = createIndexedDB({ name: 'app', version: 2, schema, migrate });\n * ```\n */\nexport function defineMigration(steps: MigrationStep[]): MigrationFn {\n  return ({ db, tx }) => {\n    for (const step of steps) {\n      switch (step.type) {\n        case 'addIndex': {\n          const store = tx.objectStore(step.table);\n\n          // keyPath mirrors the vault storage envelope: { value: T, expiresAt?: number }\n          if (!store.indexNames.contains(step.field)) {\n            store.createIndex(step.field, `value.${step.field}`);\n          }\n\n          break;\n        }\n        case 'addTable':\n          if (!db.objectStoreNames.contains(step.name)) {\n            db.createObjectStore(step.name);\n          }\n\n          break;\n        case 'removeIndex': {\n          const store = tx.objectStore(step.table);\n\n          if (store.indexNames.contains(step.field)) {\n            store.deleteIndex(step.field);\n          }\n\n          break;\n        }\n        case 'removeTable':\n          if (db.objectStoreNames.contains(step.name)) {\n            db.deleteObjectStore(step.name);\n          }\n\n          break;\n      }\n    }\n  };\n}\n\nfunction idbReq<R>(request: IDBRequest<R>): Promise<R> {\n  return new Promise<R>((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error ?? new VaultError('IndexedDB request failed'));\n  });\n}\n\nfunction wrapTxError(scope: string, message: string, cause: unknown): VaultError {\n  const causeMessage = cause instanceof Error && cause.message ? `: ${cause.message}` : '';\n\n  return new VaultError(`${message} on \"${scope}\"${causeMessage}`, { cause });\n}\n\nfunction runIdbTx<T>(tx: IDBTransaction, scope: string, work: () => Promise<T>): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let result: T | undefined;\n    let callbackError: unknown;\n\n    Promise.resolve()\n      .then(work)\n      .then((value) => {\n        result = value;\n      })\n      .catch((error) => {\n        callbackError = error;\n\n        try {\n          tx.abort();\n        } catch {\n          /* ignore */\n        }\n      });\n\n    const rejectWithCallbackError = (fallbackCause: unknown, message = 'transaction failed'): void => {\n      if (callbackError instanceof Error) {\n        reject(callbackError);\n      } else {\n        reject(wrapTxError(scope, message, callbackError ?? fallbackCause));\n      }\n    };\n\n    tx.oncomplete = () => {\n      if (callbackError) {\n        rejectWithCallbackError(undefined);\n\n        return;\n      }\n\n      resolve(result as T);\n    };\n    tx.onerror = () => reject(wrapTxError(scope, 'transaction error', tx.error));\n    tx.onabort = () => rejectWithCallbackError(tx.error, 'transaction aborted');\n  });\n}\n\nasync function getAllFromStore<T extends object>(\n  store: IDBObjectStore,\n  decode: (raw: unknown) => T | undefined,\n): Promise<T[]> {\n  const rawRecords = await idbReq<unknown[]>(store.getAll());\n  const records: T[] = [];\n\n  for (const raw of rawRecords) {\n    const value = decode(raw);\n\n    if (value !== undefined) records.push(value);\n  }\n\n  return records;\n}\n\nasync function getAllFromStoreByIndex<T extends object>(\n  store: IDBObjectStore,\n  indexName: string,\n  range: NativeRange,\n  decode: (raw: unknown) => T | undefined,\n): Promise<T[]> {\n  const index = store.index(indexName);\n  const idbRange =\n    range.type === 'eq'\n      ? IDBKeyRange.only(range.value as IDBValidKey)\n      : range.type === 'between'\n        ? IDBKeyRange.bound(range.lower as IDBValidKey, range.upper as IDBValidKey)\n        : IDBKeyRange.bound(range.prefix, `${range.prefix}\\uffff`);\n  const rawRecords = await idbReq<unknown[]>(index.getAll(idbRange));\n  const records: T[] = [];\n\n  for (const raw of rawRecords) {\n    const value = decode(raw);\n\n    if (value !== undefined) records.push(value);\n  }\n\n  return records;\n}\n\nasync function storeGet<T extends object>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  decode: (raw: unknown) => T | undefined,\n): Promise<T | undefined> {\n  const raw = await idbReq<unknown>(store.get(key));\n\n  if (raw == null) return undefined;\n\n  return decode(raw);\n}\n\nasync function storeHas<T extends object>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  decode: (raw: unknown) => T | undefined,\n): Promise<boolean> {\n  return (await storeGet<T>(store, key, decode)) !== undefined;\n}\n\nasync function storeDelete<T extends object>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  decode: (raw: unknown) => T | undefined,\n): Promise<boolean> {\n  const live = await storeHas<T>(store, key, decode);\n\n  await idbReq(store.delete(key));\n\n  return live;\n}\n\nasync function storeDeleteMany<T extends object>(\n  store: IDBObjectStore,\n  keys: IDBValidKey[],\n  decode: (raw: unknown) => T | undefined,\n): Promise<number> {\n  if (keys.length === 0) return 0;\n\n  const results = await Promise.all(keys.map((k) => storeDelete<T>(store, k, decode)));\n\n  return results.filter(Boolean).length;\n}\n\nasync function storePutAt<T>(\n  store: IDBObjectStore,\n  key: IDBValidKey,\n  value: T,\n  encode: (v: T, ttl?: number) => unknown,\n  ttl?: number,\n): Promise<void> {\n  await idbReq(store.put(encode(value, ttl), key));\n}\n\nfunction pruneExpiredInStore(store: IDBObjectStore): Promise<number> {\n  return new Promise<number>((resolve, reject) => {\n    let deleted = 0;\n    const request = store.openCursor();\n\n    request.onerror = () => reject(request.error ?? new VaultError('IndexedDB cursor failed during prune'));\n    request.onsuccess = () => {\n      const cursor = request.result;\n\n      if (!cursor) {\n        resolve(deleted);\n\n        return;\n      }\n\n      const stored = parseStored(cursor.value as unknown);\n\n      if (!stored || isExpired(stored.expiresAt)) {\n        cursor.delete();\n        deleted += 1;\n      }\n\n      cursor.continue();\n    };\n  });\n}\n\n/**\n * Cursor state machine — a single discriminated union replaces five boolean/nullable variables.\n * Transitions: idle → waiting (next() before cursor fires) | buffered (cursor fires first) | done | error\n */\ntype CursorState<T> =\n  | { type: 'idle' }\n  | { reject: (e: unknown) => void; resolve: (r: IteratorResult<T>) => void; type: 'waiting' }\n  | { result: IteratorResult<T>; type: 'buffered' }\n  | { error: unknown; type: 'error' }\n  | { type: 'done' };\n\n/**\n * F1: True cursor-based iteration for IndexedDB.\n * Yields live records one-by-one using an IDB cursor, avoiding materializing the full table.\n * This is memory-efficient for large tables — the cursor walks the store incrementally.\n *\n * Design: the cursor is opened *synchronously* in [Symbol.asyncIterator]() so that event\n * handlers are wired immediately (no queueMicrotask races). The cursor is advanced *eagerly*\n * before yielding — this keeps the IDB readonly transaction alive between consumer awaits,\n * because IDB auto-commits when there are no pending requests.\n */\nfunction iterateStoreWithCursor<T extends object>(\n  store: IDBObjectStore,\n  decode: (raw: unknown) => T | undefined,\n): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<T> {\n      const cursorRequest = store.openCursor();\n      let state: CursorState<T> = { type: 'idle' };\n\n      const deliver = (result: IteratorResult<T>): void => {\n        if (state.type === 'waiting') {\n          const { resolve } = state;\n\n          state = result.done ? { type: 'done' } : { type: 'idle' };\n          resolve(result);\n        } else {\n          state = { result, type: 'buffered' };\n        }\n      };\n\n      cursorRequest.onerror = () => {\n        const err = cursorRequest.error ?? new VaultError('IndexedDB cursor iteration failed');\n\n        if (state.type === 'waiting') {\n          const { reject } = state;\n\n          state = { type: 'done' };\n          reject(err);\n        } else {\n          state = { error: err, type: 'error' };\n        }\n      };\n\n      cursorRequest.onsuccess = () => {\n        const cursor = cursorRequest.result;\n\n        if (!cursor) {\n          deliver({ done: true, value: undefined });\n\n          return;\n        }\n\n        const value = decode(cursor.value as unknown);\n\n        // Advance eagerly BEFORE yielding to keep the IDB transaction alive.\n        cursor.continue();\n\n        if (value !== undefined) deliver({ done: false, value });\n      };\n\n      return {\n        next(): Promise<IteratorResult<T>> {\n          if (state.type === 'error') {\n            const { error } = state;\n\n            state = { type: 'done' };\n\n            return Promise.reject(error);\n          }\n\n          if (state.type === 'buffered') {\n            const { result } = state;\n\n            state = result.done ? { type: 'done' } : { type: 'idle' };\n\n            return Promise.resolve(result);\n          }\n\n          if (state.type === 'done') return Promise.resolve({ done: true, value: undefined });\n\n          return new Promise<IteratorResult<T>>((resolve, reject) => {\n            state = { reject, resolve, type: 'waiting' };\n          });\n        },\n\n        return(value?: unknown): Promise<IteratorResult<T>> {\n          if (state.type === 'waiting') state.resolve({ done: true, value: undefined });\n\n          state = { type: 'done' };\n\n          return Promise.resolve({ done: true, value });\n        },\n\n        throw(err?: unknown): Promise<IteratorResult<T>> {\n          if (state.type === 'waiting') state.reject(err);\n\n          state = { type: 'done' };\n\n          return Promise.reject(err);\n        },\n      };\n    },\n  };\n}\n\n/**\n * R3: Extracted IDB batch core — builds a StorageBackend that operates within\n * an existing IDBTransaction, shared by all tables in the batch.\n * Eliminates the duplicated `txCore` block that was previously inlined in `idbBatch`.\n */\nfunction buildIdbBatchCore<S extends AnySchema, K extends keyof S & string>(\n  schema: S,\n  idbTx: IDBTransaction,\n  decode: <T extends object>(raw: unknown) => T | undefined,\n  encode: <T>(value: T, ttl?: number) => unknown,\n): StorageBackend<S, K> {\n  const storeOf = (table: K): IDBObjectStore => idbTx.objectStore(table);\n\n  return {\n    clear: async (table) => {\n      await idbReq(storeOf(table).clear());\n    },\n    count: async (table) => {\n      // Must inspect each stored record to exclude TTL-expired entries.\n      // Individual put() calls can attach a TTL even when the schema has no defaultTtl,\n      // so schema[table].defaultTtl being absent does not guarantee a clean count.\n      // This matches the top-level core.count() behaviour in the IDB adapter.\n      const all = await idbReq<unknown[]>(storeOf(table).getAll());\n\n      return all.filter((r) => decode(r) !== undefined).length;\n    },\n    delete: (table, key) => storeDelete<RecordOf<S, K>>(storeOf(table), encodeVaultKey(key), decode),\n    deleteMany: (table, keys) => storeDeleteMany<RecordOf<S, K>>(storeOf(table), keys.map(encodeVaultKey), decode),\n    get: (table, key) => storeGet<RecordOf<S, typeof table>>(storeOf(table), encodeVaultKey(key), decode),\n    getAll: (table) => getAllFromStore<RecordOf<S, typeof table>>(storeOf(table), decode),\n    getByIndexRange: (table, field, range) =>\n      getAllFromStoreByIndex<RecordOf<S, typeof table>>(storeOf(table), field, range, decode),\n    getMany: (table, keys) =>\n      Promise.all(keys.map((key) => storeGet<RecordOf<S, typeof table>>(storeOf(table), encodeVaultKey(key), decode))),\n    has: (table, key) => storeHas<RecordOf<S, typeof table>>(storeOf(table), encodeVaultKey(key), decode),\n    pruneExpiredInTable: (table) => pruneExpiredInStore(storeOf(table)),\n    put(table, value, ttl) {\n      return storePutAt(storeOf(table), encodeVaultKey(getRecordKey(schema, table, value)), value, encode, ttl);\n    },\n    putAll(table, values, ttl) {\n      return Promise.all(\n        values.map((v) => storePutAt(storeOf(table), encodeVaultKey(getRecordKey(schema, table, v)), v, encode, ttl)),\n      ).then(() => undefined);\n    },\n  };\n}\n\ntype IndexedDbOptions<S extends AnySchema> = BaseAdapterOptions<S> & {\n  migrate?: MigrationFn;\n  name: string;\n  /** Schema version. Must be a positive integer. Increment when adding tables or changing the schema, then provide `migrate`. Defaults to 1. */\n  version?: number;\n};\n\nexport function createIndexedDB<S extends AnySchema>(options: IndexedDbOptions<S>): IndexedDbVaultStore<S> {\n  const { logger, migrate, name, onMetrics, schema, validators, version = 1 } = options;\n\n  if (!Number.isInteger(version) || version < 1) {\n    throw new VaultError(`createIndexedDB: version must be a positive integer, got ${String(version)}`);\n  }\n\n  // Fixed envelopes keep IndexedDB records and `value.<field>` indexes portable across adapters.\n  const decode = <T extends object>(raw: unknown): T | undefined => {\n    const stored = parseStored<T>(raw);\n\n    return !stored || isExpired(stored.expiresAt) ? undefined : stored.value;\n  };\n\n  const encode = <T>(value: T, ttl?: number): StoredRecord<T> => {\n    return ttl === undefined ? { value } : { expiresAt: Date.now() + ttl, value };\n  };\n\n  const channel = typeof BroadcastChannel !== 'undefined' ? new BroadcastChannel(`vault:${name}`) : undefined;\n\n  if (!channel && logger) {\n    logger.error(`[vault] BroadcastChannel unavailable — cross-tab sync disabled for \"${name}\"`);\n  }\n\n  let db: IDBDatabase | null = null;\n  let connectPromise: Promise<void> | null = null;\n  let disposed = false;\n\n  const createObjectStores = (target: IDBDatabase, tx: IDBTransaction): void => {\n    for (const [tableName, entry] of Object.entries(schema)) {\n      let store: IDBObjectStore;\n\n      if (!target.objectStoreNames.contains(tableName)) {\n        store = target.createObjectStore(tableName);\n      } else {\n        store = tx.objectStore(tableName);\n      }\n\n      // F5: Create secondary indexes for fields declared via .index() on the table() builder.\n      // Stored format is { value: T, expiresAt?: number } so IDB keyPath is `value.<field>`.\n      const indexes = (entry as { indexes?: readonly string[] }).indexes ?? [];\n\n      for (const field of indexes) {\n        if (!store.indexNames.contains(field)) {\n          store.createIndex(field, `value.${field}`);\n        }\n      }\n    }\n  };\n\n  const connect = async (): Promise<void> => {\n    if (!connectPromise) {\n      connectPromise = new Promise((resolve, reject) => {\n        const request = indexedDB.open(name, version);\n\n        request.onupgradeneeded = (event) => {\n          const target = request.result;\n          const tx = request.transaction!;\n\n          if (migrate) {\n            try {\n              migrate({\n                db: target,\n                newVersion: (event as IDBVersionChangeEvent).newVersion ?? null,\n                oldVersion: event.oldVersion,\n                tx,\n              });\n            } catch (error) {\n              try {\n                tx.abort();\n              } catch {\n                /* ignore */\n              }\n\n              reject(new VaultMigrationError(`migration failed for \"${name}\"`, { cause: error }));\n\n              return;\n            }\n          }\n\n          createObjectStores(target, tx);\n        };\n\n        request.onsuccess = () => {\n          if (disposed) {\n            request.result.close();\n            resolve();\n\n            return;\n          }\n\n          const connection = request.result;\n\n          connection.onversionchange = () => {\n            connection.close();\n            db = null;\n            connectPromise = null;\n          };\n\n          db = connection;\n          resolve();\n        };\n        request.onerror = () => {\n          connectPromise = null;\n          reject(new VaultError(`failed to open \"${name}\"`, { cause: request.error }));\n        };\n      });\n    }\n\n    return connectPromise;\n  };\n\n  const withStore = async <T>(\n    table: keyof S,\n    mode: 'readonly' | 'readwrite',\n    fn: (store: IDBObjectStore) => Promise<T>,\n  ): Promise<T> => {\n    if (disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    if (!db) await connect();\n\n    if (!db) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    const tableName = String(table);\n    const tx = db.transaction(tableName, mode);\n\n    return runIdbTx(tx, `${name}/${tableName}`, () => fn(tx.objectStore(tableName)));\n  };\n\n  const requireDb = async (): Promise<IDBDatabase> => {\n    if (disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    if (!db) await connect();\n\n    if (!db) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n    return db;\n  };\n\n  const publish = <K extends keyof S>(table: K): void => {\n    channel?.postMessage({ table: String(table) });\n  };\n\n  const core: StorageBackend<S> = {\n    clear: (table) => withStore(table, 'readwrite', (s) => idbReq(s.clear()).then(() => undefined)),\n\n    count: (table) =>\n      withStore(table, 'readonly', async (s) => {\n        // Must inspect each stored record to exclude TTL-expired entries.\n        // Individual put() calls can attach a TTL even when the schema has no defaultTtl,\n        // so schema[table].defaultTtl being absent does not guarantee a clean count.\n        const all = await idbReq<unknown[]>(s.getAll());\n\n        return all.filter((r) => decode(r) !== undefined).length;\n      }),\n\n    delete: (table, key) =>\n      withStore(table, 'readwrite', (s) => storeDelete<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode)),\n\n    deleteMany: (table, keys) =>\n      keys.length === 0\n        ? Promise.resolve(0)\n        : withStore(table, 'readwrite', (s) =>\n            storeDeleteMany<RecordOf<S, typeof table>>(s, keys.map(encodeVaultKey), decode),\n          ),\n\n    async dispose(): Promise<void> {\n      disposed = true;\n      channel?.close();\n\n      // F7: Wait for any in-progress connect before closing the DB to avoid\n      // \"database connection is closing\" errors on in-flight requests.\n      if (connectPromise) await connectPromise.catch(() => {});\n\n      db?.close();\n      db = null;\n      connectPromise = null;\n    },\n\n    get: (table, key) =>\n      withStore(table, 'readonly', (s) => storeGet<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode)),\n\n    getAll: (table) => withStore(table, 'readonly', (s) => getAllFromStore<RecordOf<S, typeof table>>(s, decode)),\n\n    // Ad-hoc per-put TTLs can be attached regardless of schema-level defaultTtl (same caveat as\n    // count()), so we cannot take the O(1) store.getAllKeys() shortcut unconditionally — every\n    // record must be decoded to exclude TTL-expired entries correctly.\n    getAllKeys: (table) =>\n      withStore(table, 'readonly', async (s) => {\n        const records = await getAllFromStore<RecordOf<S, typeof table>>(s, decode);\n        const keyField = schema[table].key;\n\n        return records.map((r) => (r as Record<string, unknown>)[keyField] as KeyOf<S, typeof table>);\n      }),\n\n    getByIndexRange: (table, field, range) =>\n      withStore(table, 'readonly', (s) => getAllFromStoreByIndex<RecordOf<S, typeof table>>(s, field, range, decode)),\n\n    getMany: (table, keys) =>\n      keys.length === 0\n        ? Promise.resolve([])\n        : withStore(table, 'readonly', (s) =>\n            Promise.all(keys.map((key) => storeGet<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode))),\n          ),\n\n    getRawCount: (table) => withStore(table, 'readonly', (s) => idbReq(s.count())),\n\n    has: (table, key) =>\n      withStore(table, 'readonly', (s) => storeHas<RecordOf<S, typeof table>>(s, encodeVaultKey(key), decode)),\n\n    async pruneAllExpired() {\n      const idb = await requireDb();\n      const tableNames = Object.keys(schema);\n      const tx = idb.transaction(tableNames, 'readwrite');\n      const results = await runIdbTx(tx, `${name}/pruneAll`, () =>\n        Promise.all(tableNames.map(async (t) => [t, await pruneExpiredInStore(tx.objectStore(t))] as const)),\n      );\n\n      return Object.fromEntries(results);\n    },\n\n    pruneExpiredInTable: (table) => withStore(table, 'readwrite', (s) => pruneExpiredInStore(s)),\n\n    put(table, value, ttl) {\n      const key = encodeVaultKey(getRecordKey(schema, table, value));\n\n      return withStore(table, 'readwrite', (s) => storePutAt(s, key, value, encode, ttl));\n    },\n\n    putAll(table, values, ttl) {\n      return withStore(table, 'readwrite', (s) =>\n        Promise.all(\n          values.map((v) => storePutAt(s, encodeVaultKey(getRecordKey(schema, table, v)), v, encode, ttl)),\n        ).then(() => undefined),\n      );\n    },\n  };\n\n  const idbBatch = async <K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n    notifyMutation: (table: K) => void,\n    validateFn: <T extends K>(table: T, value: RecordOf<S, T>) => RecordOf<S, T>,\n  ): Promise<R> => {\n    assertBatchTables(tables);\n\n    const idb = await requireDb();\n    const idbTx = idb.transaction([...tables] as string[], 'readwrite');\n    const dirtyTables = new Set<K>();\n\n    const txCore = buildIdbBatchCore<S, K>(schema, idbTx, decode, encode);\n    const scope = new Set<string>(tables);\n    const tx = buildTxContext<S, K>(schema, txCore, (t) => dirtyTables.add(t), validateFn, scope);\n    const result = await runIdbTx(idbTx, name, () => fn(tx));\n\n    for (const table of dirtyTables) {\n      notifyMutation(table);\n    }\n\n    return result;\n  };\n\n  let batch: BatchImpl<S> | undefined;\n  const adapter = buildAdapterOps(schema, core, {\n    logger,\n    onCrossTabMessage(notify) {\n      if (!channel) {\n        return undefined;\n      }\n\n      channel.onmessage = (event: MessageEvent<{ table?: string }>) => {\n        const tableName = event.data?.table;\n\n        if (!tableName || !Object.hasOwn(schema, tableName)) return;\n\n        notify(tableName as keyof S & string);\n      };\n\n      return () => {\n        channel.onmessage = null;\n      };\n    },\n    onMetrics,\n    onMutation: publish,\n    onTransactions: (deps) => {\n      batch = (tables, fn) => idbBatch(tables, fn, deps.notifyMutation, deps.validate);\n    },\n    schema,\n    validators,\n  });\n\n  /**\n   * F1: Attach cursor-based `iterate()` on top of the adapter.\n   * Opens a dedicated readonly transaction per call and streams records via IDB cursor —\n   * genuinely memory-efficient for large tables unlike the getAll()-then-yield pattern.\n   */\n  const store = {\n    ...adapter,\n    iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>> {\n      if (disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n      // Each call opens a fresh transaction so iteration doesn't hold locks across awaits.\n      // We need to ensure the DB is connected before opening the transaction.\n      const getIterable = async (): Promise<AsyncIterable<RecordOf<S, K>>> => {\n        if (!db) await connect();\n\n        if (!db || disposed) throw new VaultDisposedError(`\"${name}\" is disposed`);\n\n        const idb = db;\n        const tx = idb.transaction(String(table), 'readonly');\n        const store = tx.objectStore(String(table));\n\n        return iterateStoreWithCursor<RecordOf<S, K>>(store, decode as (raw: unknown) => RecordOf<S, K> | undefined);\n      };\n\n      let inner: AsyncIterator<RecordOf<S, K>> | undefined;\n\n      const initInner = (): Promise<AsyncIterator<RecordOf<S, K>>> =>\n        getIterable().then((iterable) => {\n          inner = iterable[Symbol.asyncIterator]();\n\n          return inner;\n        });\n\n      return {\n        [Symbol.asyncIterator](): AsyncIterator<RecordOf<S, K>> {\n          return {\n            next(): Promise<IteratorResult<RecordOf<S, K>>> {\n              // Sync check avoids an extra Promise allocation on every iteration after the first.\n              if (inner) return inner.next();\n\n              return initInner().then((it) => it.next());\n            },\n            return(value?: unknown): Promise<IteratorResult<RecordOf<S, K>>> {\n              if (inner) return inner.return?.(value) ?? Promise.resolve({ done: true, value });\n\n              return Promise.resolve({ done: true, value });\n            },\n            throw(err?: unknown): Promise<IteratorResult<RecordOf<S, K>>> {\n              if (inner) return inner.throw?.(err) ?? Promise.reject(err);\n\n              return Promise.reject(err);\n            },\n          };\n        },\n      };\n    },\n  };\n\n  if (!batch) throw new VaultError('IndexedDB transaction capability was not initialized');\n\n  return withIndexedDbTransactions(store, batch);\n}\n"],"mappings":"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"}

package/dist/adapters/indexeddb.d.ts

@@ -1,4 +1,49 @@
-import type { AnySchema, BaseAdapterOptions, IndexedDbVaultStore, MigrationFn } from '../types';
+import type { AnySchema, BaseAdapterOptions, IndexedDbVaultStore } from '../types';
+export type { IndexedDbVaultStore };
+/** IndexedDB-only migration context supplied to `MigrationFn` during `onupgradeneeded`. */
+export type MigrationContext = {
+    db: IDBDatabase;
+    newVersion: number | null;
+    oldVersion: number;
+    tx: IDBTransaction;
+};
+/** Synchronous IndexedDB schema upgrade callback. */
+export type MigrationFn = (ctx: MigrationContext) => void;
+/**
+ * A single step in a typed migration definition.
+ * Compose multiple steps to describe the full schema change between two versions.
+ */
+export type MigrationStep = {
+    field: string;
+    table: string;
+    type: 'addIndex';
+} | {
+    field: string;
+    table: string;
+    type: 'removeIndex';
+} | {
+    name: string;
+    type: 'addTable';
+} | {
+    name: string;
+    type: 'removeTable';
+};
+/**
+ * Builds a typed `MigrationFn` from a declarative list of schema change steps.
+ * Each step is applied in order and is idempotent (safe to run when the target
+ * already exists or has already been removed).
+ *
+ * ```ts
+ * const migrate = defineMigration([
+ *   { type: 'addTable', name: 'sessions' },
+ *   { type: 'addIndex', table: 'users', field: 'email' },
+ *   { type: 'removeTable', name: 'legacyTokens' },
+ * ]);
+ *
+ * const db = createIndexedDB({ name: 'app', version: 2, schema, migrate });
+ * ```
+ */
+export declare function defineMigration(steps: MigrationStep[]): MigrationFn;
 type IndexedDbOptions<S extends AnySchema> = BaseAdapterOptions<S> & {
     migrate?: MigrationFn;
     name: string;
@@ -6,5 +51,4 @@ type IndexedDbOptions<S extends AnySchema> = BaseAdapterOptions<S> & {
     version?: number;
 };
 export declare function createIndexedDB<S extends AnySchema>(options: IndexedDbOptions<S>): IndexedDbVaultStore<S>;
-export {};
 //# sourceMappingURL=indexeddb.d.ts.map

package/dist/adapters/indexeddb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../src/adapters/indexeddb.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EAEnB,WAAW,EAIZ,MAAM,UAAU,CAAC;AAsVlB,KAAK,gBAAgB,CAAC,CAAC,SAAS,SAAS,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG;IACnE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,8IAA8I;IAC9I,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAgWzG"}
+{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../src/adapters/indexeddb.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,mBAAmB,EAAuC,MAAM,UAAU,CAAC;AAExH,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,WAAW,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,cAAc,CAAC;CACpB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAClD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,WAAW,CAsCnE;AAsVD,KAAK,gBAAgB,CAAC,CAAC,SAAS,SAAS,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG;IACnE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,8IAA8I;IAC9I,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAgWzG"}

package/dist/adapters/indexeddb.js

@@ -4,15 +4,35 @@ import { encodeVaultKey as a, getRecordKey as o } from "../internal.js";
 import { assertBatchTables as s, buildAdapterOps as c, buildTxContext as l, withIndexedDbTransactions as u } from "../adapter-core.js";
 //#region src/adapters/indexeddb.ts
 function d(e) {
+	return ({ db: t, tx: n }) => {
+		for (let r of e) switch (r.type) {
+			case "addIndex": {
+				let e = n.objectStore(r.table);
+				e.indexNames.contains(r.field) || e.createIndex(r.field, `value.${r.field}`);
+				break;
+			}
+			case "addTable":
+				t.objectStoreNames.contains(r.name) || t.createObjectStore(r.name);
+				break;
+			case "removeIndex": {
+				let e = n.objectStore(r.table);
+				e.indexNames.contains(r.field) && e.deleteIndex(r.field);
+				break;
+			}
+			case "removeTable": t.objectStoreNames.contains(r.name) && t.deleteObjectStore(r.name);
+		}
+	};
+}
+function f(e) {
 	return new Promise((n, r) => {
 		e.onsuccess = () => n(e.result), e.onerror = () => r(e.error ?? new t("IndexedDB request failed"));
 	});
 }
-function f(e, n, r) {
+function p(e, n, r) {
 	let i = r instanceof Error && r.message ? `: ${r.message}` : "";
 	return new t(`${n} on "${e}"${i}`, { cause: r });
 }
-function p(e, t, n) {
+function m(e, t, n) {
 	return new Promise((r, i) => {
 		let a, o;
 		Promise.resolve().then(n).then((e) => {
@@ -24,7 +44,7 @@ function p(e, t, n) {
 			} catch {}
 		});
 		let s = (e, n = "transaction failed") => {
-			o instanceof Error ? i(o) : i(f(t, n, o ?? e));
+			o instanceof Error ? i(o) : i(p(t, n, o ?? e));
 		};
 		e.oncomplete = () => {
 			if (o) {
@@ -32,43 +52,43 @@ function p(e, t, n) {
 				return;
 			}
 			r(a);
-		}, e.onerror = () => i(f(t, "transaction error", e.error)), e.onabort = () => s(e.error, "transaction aborted");
+		}, e.onerror = () => i(p(t, "transaction error", e.error)), e.onabort = () => s(e.error, "transaction aborted");
 	});
 }
-async function m(e, t) {
-	let n = await d(e.getAll()), r = [];
+async function h(e, t) {
+	let n = await f(e.getAll()), r = [];
 	for (let e of n) {
 		let n = t(e);
 		n !== void 0 && r.push(n);
 	}
 	return r;
 }
-async function h(e, t, n, r) {
-	let i = e.index(t), a = n.type === "eq" ? IDBKeyRange.only(n.value) : n.type === "between" ? IDBKeyRange.bound(n.lower, n.upper) : IDBKeyRange.bound(n.prefix, `${n.prefix}\uffff`), o = await d(i.getAll(a)), s = [];
+async function g(e, t, n, r) {
+	let i = e.index(t), a = n.type === "eq" ? IDBKeyRange.only(n.value) : n.type === "between" ? IDBKeyRange.bound(n.lower, n.upper) : IDBKeyRange.bound(n.prefix, `${n.prefix}\uffff`), o = await f(i.getAll(a)), s = [];
 	for (let e of o) {
 		let t = r(e);
 		t !== void 0 && s.push(t);
 	}
 	return s;
 }
-async function g(e, t, n) {
-	let r = await d(e.get(t));
-	if (r != null) return n(r);
-}
 async function _(e, t, n) {
-	return await g(e, t, n) !== void 0;
+	let r = await f(e.get(t));
+	if (r != null) return n(r);
 }
 async function v(e, t, n) {
-	let r = await _(e, t, n);
-	return await d(e.delete(t)), r;
+	return await _(e, t, n) !== void 0;
 }
 async function y(e, t, n) {
-	return t.length === 0 ? 0 : (await Promise.all(t.map((t) => v(e, t, n)))).filter(Boolean).length;
+	let r = await v(e, t, n);
+	return await f(e.delete(t)), r;
+}
+async function b(e, t, n) {
+	return t.length === 0 ? 0 : (await Promise.all(t.map((t) => y(e, t, n)))).filter(Boolean).length;
 }
-async function b(e, t, n, r, i) {
-	await d(e.put(r(n, i), t));
+async function x(e, t, n, r, i) {
+	await f(e.put(r(n, i), t));
 }
-function x(e) {
+function S(e) {
 	return new Promise((n, a) => {
 		let o = 0, s = e.openCursor();
 		s.onerror = () => a(s.error ?? new t("IndexedDB cursor failed during prune")), s.onsuccess = () => {
@@ -82,7 +102,7 @@ function x(e) {
 		};
 	});
 }
-function S(e, n) {
+function C(e, n) {
 	return { [Symbol.asyncIterator]() {
 		let r = e.openCursor(), i = { type: "idle" }, a = (e) => {
 			if (i.type === "waiting") {
@@ -152,31 +172,31 @@ function S(e, n) {
 		};
 	} };
 }
-function C(e, t, n, r) {
+function w(e, t, n, r) {
 	let i = (e) => t.objectStore(e);
 	return {
 		clear: async (e) => {
-			await d(i(e).clear());
+			await f(i(e).clear());
 		},
-		count: async (e) => (await d(i(e).getAll())).filter((e) => n(e) !== void 0).length,
-		delete: (e, t) => v(i(e), a(t), n),
-		deleteMany: (e, t) => y(i(e), t.map(a), n),
-		get: (e, t) => g(i(e), a(t), n),
-		getAll: (e) => m(i(e), n),
-		getByIndexRange: (e, t, r) => h(i(e), t, r, n),
-		getMany: (e, t) => Promise.all(t.map((t) => g(i(e), a(t), n))),
-		has: (e, t) => _(i(e), a(t), n),
-		pruneExpiredInTable: (e) => x(i(e)),
+		count: async (e) => (await f(i(e).getAll())).filter((e) => n(e) !== void 0).length,
+		delete: (e, t) => y(i(e), a(t), n),
+		deleteMany: (e, t) => b(i(e), t.map(a), n),
+		get: (e, t) => _(i(e), a(t), n),
+		getAll: (e) => h(i(e), n),
+		getByIndexRange: (e, t, r) => g(i(e), t, r, n),
+		getMany: (e, t) => Promise.all(t.map((t) => _(i(e), a(t), n))),
+		has: (e, t) => v(i(e), a(t), n),
+		pruneExpiredInTable: (e) => S(i(e)),
 		put(t, n, s) {
-			return b(i(t), a(o(e, t, n)), n, r, s);
+			return x(i(t), a(o(e, t, n)), n, r, s);
 		},
 		putAll(t, n, s) {
-			return Promise.all(n.map((n) => b(i(t), a(o(e, t, n)), n, r, s))).then(() => void 0);
+			return Promise.all(n.map((n) => x(i(t), a(o(e, t, n)), n, r, s))).then(() => void 0);
 		}
 	};
 }
-function w(f) {
-	let { logger: w, migrate: T, name: E, onMetrics: D, schema: O, validators: k, version: A = 1 } = f;
+function T(d) {
+	let { logger: p, migrate: T, name: E, onMetrics: D, schema: O, validators: k, version: A = 1 } = d;
 	if (!Number.isInteger(A) || A < 1) throw new t(`createIndexedDB: version must be a positive integer, got ${String(A)}`);
 	let j = (e) => {
 		let t = i(e);
@@ -185,7 +205,7 @@ function w(f) {
 		expiresAt: Date.now() + t,
 		value: e
 	}, N = typeof BroadcastChannel < "u" ? new BroadcastChannel(`vault:${E}`) : void 0;
-	!N && w && w.error(`[vault] BroadcastChannel unavailable — cross-tab sync disabled for "${E}"`);
+	!N && p && p.error(`[vault] BroadcastChannel unavailable — cross-tab sync disabled for "${E}"`);
 	let P = null, F = null, I = !1, L = (e, t) => {
 		for (let [n, r] of Object.entries(O)) {
 			let i;
@@ -227,50 +247,50 @@ function w(f) {
 	}), F), z = async (t, n, r) => {
 		if (I || (P || await R(), !P)) throw new e(`"${E}" is disposed`);
 		let i = String(t), a = P.transaction(i, n);
-		return p(a, `${E}/${i}`, () => r(a.objectStore(i)));
+		return m(a, `${E}/${i}`, () => r(a.objectStore(i)));
 	}, B = async () => {
 		if (I || (P || await R(), !P)) throw new e(`"${E}" is disposed`);
 		return P;
 	}, V = (e) => {
 		N?.postMessage({ table: String(e) });
 	}, H = {
-		clear: (e) => z(e, "readwrite", (e) => d(e.clear()).then(() => void 0)),
-		count: (e) => z(e, "readonly", async (e) => (await d(e.getAll())).filter((e) => j(e) !== void 0).length),
-		delete: (e, t) => z(e, "readwrite", (e) => v(e, a(t), j)),
-		deleteMany: (e, t) => t.length === 0 ? Promise.resolve(0) : z(e, "readwrite", (e) => y(e, t.map(a), j)),
+		clear: (e) => z(e, "readwrite", (e) => f(e.clear()).then(() => void 0)),
+		count: (e) => z(e, "readonly", async (e) => (await f(e.getAll())).filter((e) => j(e) !== void 0).length),
+		delete: (e, t) => z(e, "readwrite", (e) => y(e, a(t), j)),
+		deleteMany: (e, t) => t.length === 0 ? Promise.resolve(0) : z(e, "readwrite", (e) => b(e, t.map(a), j)),
 		async dispose() {
 			I = !0, N?.close(), F && await F.catch(() => {}), P?.close(), P = null, F = null;
 		},
-		get: (e, t) => z(e, "readonly", (e) => g(e, a(t), j)),
-		getAll: (e) => z(e, "readonly", (e) => m(e, j)),
+		get: (e, t) => z(e, "readonly", (e) => _(e, a(t), j)),
+		getAll: (e) => z(e, "readonly", (e) => h(e, j)),
 		getAllKeys: (e) => z(e, "readonly", async (t) => {
-			let n = await m(t, j), r = O[e].key;
+			let n = await h(t, j), r = O[e].key;
 			return n.map((e) => e[r]);
 		}),
-		getByIndexRange: (e, t, n) => z(e, "readonly", (e) => h(e, t, n, j)),
-		getMany: (e, t) => t.length === 0 ? Promise.resolve([]) : z(e, "readonly", (e) => Promise.all(t.map((t) => g(e, a(t), j)))),
-		getRawCount: (e) => z(e, "readonly", (e) => d(e.count())),
-		has: (e, t) => z(e, "readonly", (e) => _(e, a(t), j)),
+		getByIndexRange: (e, t, n) => z(e, "readonly", (e) => g(e, t, n, j)),
+		getMany: (e, t) => t.length === 0 ? Promise.resolve([]) : z(e, "readonly", (e) => Promise.all(t.map((t) => _(e, a(t), j)))),
+		getRawCount: (e) => z(e, "readonly", (e) => f(e.count())),
+		has: (e, t) => z(e, "readonly", (e) => v(e, a(t), j)),
 		async pruneAllExpired() {
-			let e = await B(), t = Object.keys(O), n = e.transaction(t, "readwrite"), r = await p(n, `${E}/pruneAll`, () => Promise.all(t.map(async (e) => [e, await x(n.objectStore(e))])));
+			let e = await B(), t = Object.keys(O), n = e.transaction(t, "readwrite"), r = await m(n, `${E}/pruneAll`, () => Promise.all(t.map(async (e) => [e, await S(n.objectStore(e))])));
 			return Object.fromEntries(r);
 		},
-		pruneExpiredInTable: (e) => z(e, "readwrite", (e) => x(e)),
+		pruneExpiredInTable: (e) => z(e, "readwrite", (e) => S(e)),
 		put(e, t, n) {
 			let r = a(o(O, e, t));
-			return z(e, "readwrite", (e) => b(e, r, t, M, n));
+			return z(e, "readwrite", (e) => x(e, r, t, M, n));
 		},
 		putAll(e, t, n) {
-			return z(e, "readwrite", (r) => Promise.all(t.map((t) => b(r, a(o(O, e, t)), t, M, n))).then(() => void 0));
+			return z(e, "readwrite", (r) => Promise.all(t.map((t) => x(r, a(o(O, e, t)), t, M, n))).then(() => void 0));
 		}
 	}, U = async (e, t, n, r) => {
 		s(e);
-		let i = (await B()).transaction([...e], "readwrite"), a = /* @__PURE__ */ new Set(), o = C(O, i, j, M), c = new Set(e), u = l(O, o, (e) => a.add(e), r, c), d = await p(i, E, () => t(u));
+		let i = (await B()).transaction([...e], "readwrite"), a = /* @__PURE__ */ new Set(), o = w(O, i, j, M), c = new Set(e), u = l(O, o, (e) => a.add(e), r, c), d = await m(i, E, () => t(u));
 		for (let e of a) n(e);
 		return d;
 	}, W, G = {
 		...c(O, H, {
-			logger: w,
+			logger: p,
 			onCrossTabMessage(e) {
 				if (N) return N.onmessage = (t) => {
 					let n = t.data?.table;
@@ -291,7 +311,7 @@ function w(f) {
 			if (I) throw new e(`"${E}" is disposed`);
 			let n = async () => {
 				if (P || await R(), !P || I) throw new e(`"${E}" is disposed`);
-				return S(P.transaction(String(t), "readonly").objectStore(String(t)), j);
+				return C(P.transaction(String(t), "readonly").objectStore(String(t)), j);
 			}, r, i = () => n().then((e) => (r = e[Symbol.asyncIterator](), r));
 			return { [Symbol.asyncIterator]() {
 				return {
@@ -318,6 +338,6 @@ function w(f) {
 	return u(G, W);
 }
 //#endregion
-export { w as createIndexedDB };
+export { T as createIndexedDB, d as defineMigration };
 
 //# sourceMappingURL=indexeddb.js.map