@keepkit/core 0.1.0 → 0.3.0

package/dist/chunk-X4UVKTBK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/storage/sync.ts","../src/storage/index.ts"],"sourcesContent":["export type KeepItem<TMeta = Record<string, unknown>> = {\n  id: string;\n  savedAt: number;\n  updatedAt: number;\n  meta: TMeta;\n  targetType?: string;\n  note?: string;\n  tags?: string[];\n  schemaVersion?: number;\n  /** Optional server-provided revision used by synchronizing adapters. */\n  revision?: string;\n  /** Timestamp for the last successful refresh of source metadata. */\n  metaUpdatedAt?: number;\n};\n\nexport type KeepItemInput<TMeta = Record<string, unknown>> = Omit<KeepItem<TMeta>, \"id\" | \"savedAt\" | \"updatedAt\">;\n\nexport interface StorageAdapter<TMeta = Record<string, unknown>> {\n  getAll(): Promise<KeepItem<TMeta>[]>;\n  set(item: KeepItem<TMeta>): Promise<void>;\n  setMany?(items: KeepItem<TMeta>[]): Promise<void>;\n  remove(id: string): Promise<void>;\n  removeMany?(ids: string[]): Promise<void>;\n  clear(): Promise<void>;\n  merge?(localItems: KeepItem<TMeta>[]): Promise<KeepItem<TMeta>[]>;\n  subscribe?(listener: () => void): () => void;\n  readonly storageKey?: string;\n}\n\nexport type KeepAction =\n  | \"refresh\"\n  | \"save\"\n  | \"updateNote\"\n  | \"updateTags\"\n  | \"updateTagsBatch\"\n  | \"revalidate\"\n  | \"remove\"\n  | \"removeBatch\"\n  | \"clear\";\n\nexport type KeepChangePhase = \"local\" | \"synced\";\n\nexport type KeepChangeContext<TMeta = Record<string, unknown>> = {\n  action: KeepAction;\n  id?: string;\n  item?: KeepItem<TMeta>;\n  items?: KeepItem<TMeta>[];\n  phase: KeepChangePhase;\n};\n\nexport type KeepPluginContext<TMeta = Record<string, unknown>> = {\n  action: KeepAction;\n  id?: string;\n  item?: KeepItem<TMeta>;\n  items?: KeepItem<TMeta>[];\n};\n\nexport type KeepPlugin<TMeta = Record<string, unknown>> = {\n  name?: string;\n  before?: (context: KeepPluginContext<TMeta>) => void | Promise<void>;\n  after?: (context: KeepPluginContext<TMeta>) => void | Promise<void>;\n  onError?: (error: unknown, context: KeepErrorContext) => void;\n};\n\nexport type KeepSchemaParseResult<T> = { success: true; data: T } | { success: false; error?: unknown };\n\nexport type KeepSchema<T> =\n  | { parse: (value: unknown) => T | Promise<T> }\n  | { safeParse: (value: unknown) => KeepSchemaParseResult<T> | Promise<KeepSchemaParseResult<T>> }\n  | {\n      \"~standard\": {\n        validate: (\n          value: unknown,\n        ) => { value?: T; issues?: readonly unknown[] } | Promise<{ value?: T; issues?: readonly unknown[] }>;\n      };\n    };\n\nexport type KeepInvalidItemPolicy = \"error\" | \"drop\";\n\nexport type KeepSyncStatus = \"idle\" | \"pending\" | \"syncing\" | \"synced\" | \"conflict\" | \"error\";\n\nexport type KeepSyncState = {\n  status: KeepSyncStatus;\n  pendingCount: number;\n  conflictIds: string[];\n  lastSyncedAt?: number;\n  error?: unknown;\n};\n\nexport type SyncOperation<TMeta = Record<string, unknown>> = {\n  operationId: string;\n  type: \"upsert\" | \"remove\";\n  id: string;\n  item?: KeepItem<TMeta>;\n  createdAt: number;\n  baseRevision?: string;\n};\n\nexport type RemoteSyncResult<TMeta = Record<string, unknown>> =\n  | { type: \"synced\"; item?: KeepItem<TMeta>; revision?: string }\n  | { type: \"conflict\"; remote: KeepItem<TMeta>; revision?: string };\n\nexport type KeepConflictContext<TMeta = Record<string, unknown>> = {\n  operation: SyncOperation<TMeta>;\n  remoteRevision?: string;\n};\n\nexport type KeepConflictResolver<TMeta = Record<string, unknown>> = (\n  local: KeepItem<TMeta> | undefined,\n  remote: KeepItem<TMeta>,\n  context: KeepConflictContext<TMeta>,\n) => KeepItem<TMeta> | undefined | Promise<KeepItem<TMeta> | undefined>;\n\nexport interface RemoteSyncDriver<TMeta = Record<string, unknown>> {\n  push(operation: SyncOperation<TMeta>): Promise<RemoteSyncResult<TMeta>>;\n  pull?: () => Promise<KeepItem<TMeta>[]>;\n}\n\nexport interface SyncQueueAdapter<TMeta = Record<string, unknown>> {\n  getAll(): Promise<SyncOperation<TMeta>[]>;\n  setMany(operations: SyncOperation<TMeta>[]): Promise<void>;\n  remove(operationIds: string[]): Promise<void>;\n  clear(): Promise<void>;\n}\n\nexport interface SyncCapableStorageAdapter<TMeta = Record<string, unknown>> extends StorageAdapter<TMeta> {\n  getSyncState(): KeepSyncState;\n  subscribeSync(listener: () => void): () => void;\n  flushSync(): Promise<void>;\n  dispose?(): void;\n}\n\nexport type KeepStorageOperation = \"getAll\" | \"set\" | \"remove\" | \"clear\" | \"merge\";\n\nexport class KeepStorageError extends Error {\n  readonly operation: KeepStorageOperation;\n  readonly storageKey?: string;\n  readonly cause?: unknown;\n\n  constructor(\n    message: string,\n    options: {\n      operation: KeepStorageOperation;\n      storageKey?: string;\n      cause?: unknown;\n    },\n  ) {\n    super(message);\n    this.name = \"KeepStorageError\";\n    this.operation = options.operation;\n    this.storageKey = options.storageKey;\n    if (options.cause !== undefined) this.cause = options.cause;\n  }\n}\n\nexport class KeepStorageQuotaError extends KeepStorageError {\n  constructor(options: { operation: KeepStorageOperation; storageKey?: string; cause?: unknown }) {\n    super(\"KeepKit storage quota was exceeded.\", options);\n    this.name = \"KeepStorageQuotaError\";\n  }\n}\n\nexport class KeepStorageAccessError extends KeepStorageError {\n  constructor(options: { operation: KeepStorageOperation; storageKey?: string; cause?: unknown }) {\n    super(\"KeepKit could not access the configured storage.\", options);\n    this.name = \"KeepStorageAccessError\";\n  }\n}\n\nexport class KeepStorageParseError extends KeepStorageError {\n  constructor(options: { operation: KeepStorageOperation; storageKey?: string; cause?: unknown }) {\n    super(\"KeepKit found invalid data in the configured storage.\", options);\n    this.name = \"KeepStorageParseError\";\n  }\n}\n\nexport type KeepErrorContext = {\n  action: KeepAction;\n  id?: string;\n};\n\nexport type KeepErrorHandler = (error: unknown, context: KeepErrorContext) => void;\n\nexport type KeepEventHandlers<TMeta = Record<string, unknown>> = {\n  onSave?: (item: KeepItem<TMeta>) => void;\n  onRemove?: (item: KeepItem<TMeta>) => void;\n  onNoteUpdate?: (id: string, note?: string) => void;\n  onTagsUpdate?: (id: string, tags?: string[]) => void;\n  onChange?: (context: KeepChangeContext<TMeta>) => void | Promise<void>;\n  onError?: KeepErrorHandler;\n};\n\nexport function normalizeKeepTags(tags?: string[]): string[] | undefined {\n  if (!tags) return undefined;\n  const normalized = [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];\n  return normalized.length > 0 ? normalized : undefined;\n}\n","import type {\n  KeepConflictResolver,\n  KeepItem,\n  KeepSyncState,\n  RemoteSyncDriver,\n  StorageAdapter,\n  SyncCapableStorageAdapter,\n  SyncOperation,\n  SyncQueueAdapter,\n} from \"../types\";\n\nexport type LocalStorageSyncQueueOptions = {\n  key?: string;\n  storage?: Storage;\n};\n\nexport type IndexedDBSyncQueueOptions = {\n  databaseName?: string;\n  storeName?: string;\n  version?: number;\n  indexedDB?: IDBFactory;\n};\n\nexport type FallbackSyncQueueAdapterOptions<TMeta = Record<string, unknown>> = {\n  primary: SyncQueueAdapter<TMeta>;\n  fallback: SyncQueueAdapter<TMeta>;\n  shouldFallback?: (error: unknown) => boolean;\n};\n\nexport type SyncStorageAdapterOptions<TMeta = Record<string, unknown>> = {\n  local: StorageAdapter<TMeta>;\n  remote: RemoteSyncDriver<TMeta>;\n  queue?: SyncQueueAdapter<TMeta>;\n  queueKey?: string;\n  queueDatabaseName?: string;\n  clientId?: string;\n  now?: () => number;\n  resolveConflict?: KeepConflictResolver<TMeta>;\n};\n\nexport const DEFAULT_SYNC_QUEUE_KEY = \"keepkit:sync-queue\";\nexport const DEFAULT_SYNC_QUEUE_DATABASE = \"keepkit-sync\";\nexport const DEFAULT_SYNC_QUEUE_STORE = \"sync-queue\";\n\nexport class LocalStorageSyncQueueAdapter<TMeta = Record<string, unknown>> implements SyncQueueAdapter<TMeta> {\n  private readonly key: string;\n  private readonly storage: Storage | undefined;\n\n  constructor(options: LocalStorageSyncQueueOptions = {}) {\n    this.key = options.key ?? DEFAULT_SYNC_QUEUE_KEY;\n    this.storage = options.storage ?? getBrowserStorage();\n  }\n\n  async getAll(): Promise<SyncOperation<TMeta>[]> {\n    if (!this.storage) return [];\n    const raw = this.storage.getItem(this.key);\n    if (!raw) return [];\n    let value: unknown;\n    try {\n      value = JSON.parse(raw);\n    } catch (cause) {\n      throw Object.assign(new Error(\"KeepKit sync queue contains invalid JSON.\"), { cause });\n    }\n    if (!Array.isArray(value) || !value.every(isSyncOperation)) {\n      throw new Error(\"KeepKit sync queue contains invalid operations.\");\n    }\n    return value as SyncOperation<TMeta>[];\n  }\n\n  async setMany(operations: SyncOperation<TMeta>[]): Promise<void> {\n    if (!this.storage) return;\n    this.storage.setItem(this.key, JSON.stringify(operations));\n  }\n\n  async remove(operationIds: string[]): Promise<void> {\n    const ids = new Set(operationIds);\n    const current = await this.getAll();\n    await this.setMany(current.filter((operation) => !ids.has(operation.operationId)));\n  }\n\n  async clear(): Promise<void> {\n    this.storage?.removeItem(this.key);\n  }\n}\n\nexport class IndexedDBSyncQueueAdapter<TMeta = Record<string, unknown>> implements SyncQueueAdapter<TMeta> {\n  private readonly databaseName: string;\n  private readonly storeName: string;\n  private readonly version: number;\n  private readonly indexedDB: IDBFactory | undefined;\n  private databasePromise: Promise<IDBDatabase | undefined> | undefined;\n\n  constructor(options: IndexedDBSyncQueueOptions = {}) {\n    this.databaseName = options.databaseName ?? DEFAULT_SYNC_QUEUE_DATABASE;\n    this.storeName = options.storeName ?? DEFAULT_SYNC_QUEUE_STORE;\n    this.version = options.version ?? 1;\n    this.indexedDB = options.indexedDB ?? getBrowserIndexedDB();\n  }\n\n  async getAll(): Promise<SyncOperation<TMeta>[]> {\n    const database = await this.open();\n    if (!database) return [];\n    const transaction = database.transaction(this.storeName, \"readonly\");\n    const value: unknown = await requestToPromise(transaction.objectStore(this.storeName).getAll());\n    if (!Array.isArray(value) || !value.every(isSyncOperation)) {\n      throw new Error(\"KeepKit sync queue contains invalid operations.\");\n    }\n    return value as SyncOperation<TMeta>[];\n  }\n\n  async setMany(operations: SyncOperation<TMeta>[]): Promise<void> {\n    const database = await this.open();\n    if (!database) return;\n    const transaction = database.transaction(this.storeName, \"readwrite\");\n    const store = transaction.objectStore(this.storeName);\n    for (const operation of operations) store.put(operation);\n    await transactionToPromise(transaction);\n  }\n\n  async remove(operationIds: string[]): Promise<void> {\n    const database = await this.open();\n    if (!database) return;\n    const transaction = database.transaction(this.storeName, \"readwrite\");\n    const store = transaction.objectStore(this.storeName);\n    for (const operationId of new Set(operationIds)) store.delete(operationId);\n    await transactionToPromise(transaction);\n  }\n\n  async clear(): Promise<void> {\n    const database = await this.open();\n    if (!database) return;\n    const transaction = database.transaction(this.storeName, \"readwrite\");\n    transaction.objectStore(this.storeName).clear();\n    await transactionToPromise(transaction);\n  }\n\n  private open(): Promise<IDBDatabase | undefined> {\n    if (!this.indexedDB) return Promise.resolve(undefined);\n    if (!this.databasePromise) {\n      this.databasePromise = new Promise((resolve, reject) => {\n        let request: IDBOpenDBRequest;\n        try {\n          request = this.indexedDB?.open(this.databaseName, this.version) as IDBOpenDBRequest;\n        } catch (cause) {\n          reject(cause);\n          return;\n        }\n        request.onupgradeneeded = () => {\n          if (!request.result.objectStoreNames.contains(this.storeName)) {\n            request.result.createObjectStore(this.storeName, { keyPath: \"operationId\" });\n          }\n        };\n        request.onsuccess = () => resolve(request.result);\n        request.onerror = () => reject(request.error);\n        request.onblocked = () => reject(request.error ?? new Error(\"IndexedDB open was blocked.\"));\n      });\n    }\n    return this.databasePromise.catch((cause) => {\n      this.databasePromise = undefined;\n      throw cause;\n    });\n  }\n}\n\n/** Keeps the durable sync queue available when IndexedDB is blocked or fails. */\nexport class FallbackSyncQueueAdapter<TMeta = Record<string, unknown>> implements SyncQueueAdapter<TMeta> {\n  private readonly primary: SyncQueueAdapter<TMeta>;\n  private readonly fallback: SyncQueueAdapter<TMeta>;\n  private readonly shouldFallback: (error: unknown) => boolean;\n  private active: \"primary\" | \"fallback\" = \"primary\";\n\n  constructor(options: FallbackSyncQueueAdapterOptions<TMeta>) {\n    this.primary = options.primary;\n    this.fallback = options.fallback;\n    this.shouldFallback = options.shouldFallback ?? (() => true);\n  }\n\n  get isUsingFallback(): boolean {\n    return this.active === \"fallback\";\n  }\n\n  getAll(): Promise<SyncOperation<TMeta>[]> {\n    return this.execute((adapter) => adapter.getAll());\n  }\n\n  setMany(operations: SyncOperation<TMeta>[]): Promise<void> {\n    return this.execute((adapter) => adapter.setMany(operations));\n  }\n\n  remove(operationIds: string[]): Promise<void> {\n    return this.execute((adapter) => adapter.remove(operationIds));\n  }\n\n  clear(): Promise<void> {\n    return this.execute((adapter) => adapter.clear());\n  }\n\n  private async execute<TResult>(operation: (adapter: SyncQueueAdapter<TMeta>) => Promise<TResult>): Promise<TResult> {\n    const adapter = this.active === \"primary\" ? this.primary : this.fallback;\n    try {\n      return await operation(adapter);\n    } catch (error) {\n      if (this.active !== \"primary\" || !this.shouldFallback(error)) throw error;\n      this.active = \"fallback\";\n      return operation(this.fallback);\n    }\n  }\n}\n\n/** A local-first adapter that persists remote operations until they are acknowledged. */\nexport class SyncStorageAdapter<TMeta = Record<string, unknown>> implements SyncCapableStorageAdapter<TMeta> {\n  readonly storageKey?: string;\n  private readonly local: StorageAdapter<TMeta>;\n  private readonly remote: RemoteSyncDriver<TMeta>;\n  private readonly queue: SyncQueueAdapter<TMeta>;\n  private readonly clientId: string;\n  private readonly now: () => number;\n  private readonly resolveConflict?: KeepConflictResolver<TMeta>;\n  private readonly listeners = new Set<() => void>();\n  private readonly dataListeners = new Set<() => void>();\n  private queueItems: SyncOperation<TMeta>[] = [];\n  private queueLoaded = false;\n  private queueLoadPromise: Promise<void> | undefined;\n  private flushPromise: Promise<void> | undefined;\n  private state: KeepSyncState = { status: \"idle\", pendingCount: 0, conflictIds: [] };\n  private onlineHandler?: () => void;\n\n  constructor(options: SyncStorageAdapterOptions<TMeta>) {\n    this.local = options.local;\n    this.remote = options.remote;\n    this.queue = options.queue ?? createDefaultQueue<TMeta>(options);\n    this.clientId = options.clientId ?? createId();\n    this.now = options.now ?? Date.now;\n    this.resolveConflict = options.resolveConflict;\n    this.storageKey = this.local.storageKey;\n    if (typeof window !== \"undefined\") {\n      this.onlineHandler = () => void this.flushSync();\n      window.addEventListener(\"online\", this.onlineHandler);\n    }\n    void this.resumeQueue();\n  }\n\n  getSyncState = (): KeepSyncState => this.state;\n\n  subscribeSync = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  };\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.dataListeners.add(listener);\n    const unsubscribeLocal = this.local.subscribe?.(listener) ?? (() => undefined);\n    return () => {\n      this.dataListeners.delete(listener);\n      unsubscribeLocal();\n    };\n  };\n\n  getAll(): Promise<KeepItem<TMeta>[]> {\n    return this.local.getAll();\n  }\n\n  async set(item: KeepItem<TMeta>): Promise<void> {\n    const operation = this.createOperation(\"upsert\", item.id, item);\n    await this.enqueueBeforeLocalWrite(operation);\n    try {\n      await this.local.set(item);\n    } catch (cause) {\n      await this.removeQueued(operation.operationId);\n      throw cause;\n    }\n    this.notifyDataListeners();\n    this.setPendingState();\n  }\n\n  async setMany(items: KeepItem<TMeta>[]): Promise<void> {\n    const operations = items.map((item) => this.createOperation(\"upsert\", item.id, item));\n    await this.enqueueManyBeforeLocalWrite(operations);\n    try {\n      if (this.local.setMany) await this.local.setMany(items);\n      else for (const item of items) await this.local.set(item);\n    } catch (cause) {\n      await this.removeQueued(operations.map((operation) => operation.operationId));\n      throw cause;\n    }\n    this.notifyDataListeners();\n    this.setPendingState();\n  }\n\n  async remove(id: string): Promise<void> {\n    const operation = this.createOperation(\"remove\", id);\n    await this.enqueueBeforeLocalWrite(operation);\n    try {\n      await this.local.remove(id);\n    } catch (cause) {\n      await this.removeQueued(operation.operationId);\n      throw cause;\n    }\n    this.notifyDataListeners();\n    this.setPendingState();\n  }\n\n  async removeMany(ids: string[]): Promise<void> {\n    const operations = [...new Set(ids)].map((id) => this.createOperation(\"remove\", id));\n    await this.enqueueManyBeforeLocalWrite(operations);\n    try {\n      if (this.local.removeMany) await this.local.removeMany(ids);\n      else for (const id of ids) await this.local.remove(id);\n    } catch (cause) {\n      await this.removeQueued(operations.map((operation) => operation.operationId));\n      throw cause;\n    }\n    this.notifyDataListeners();\n    this.setPendingState();\n  }\n\n  async clear(): Promise<void> {\n    const items = await this.local.getAll();\n    await this.removeMany(items.map((item) => item.id));\n    await this.local.clear();\n  }\n\n  async merge(localItems: KeepItem<TMeta>[]): Promise<KeepItem<TMeta>[]> {\n    const merged = this.local.merge\n      ? await this.local.merge(localItems)\n      : await mergeLocalItems(localItems, this.local);\n    await this.setMany(localItems);\n    return merged;\n  }\n\n  async flushSync(): Promise<void> {\n    if (this.flushPromise) return this.flushPromise;\n    this.flushPromise = this.runFlush().finally(() => {\n      this.flushPromise = undefined;\n    });\n    return this.flushPromise;\n  }\n\n  dispose(): void {\n    if (this.onlineHandler) window.removeEventListener(\"online\", this.onlineHandler);\n    this.listeners.clear();\n    this.dataListeners.clear();\n  }\n\n  private async runFlush(): Promise<void> {\n    await this.loadQueue();\n    if (!(await this.pullRemote())) return;\n    if (this.queueItems.length === 0) {\n      this.updateState({ status: \"synced\", pendingCount: 0, error: undefined });\n      return;\n    }\n    this.updateState({ status: \"syncing\", error: undefined });\n    for (const operation of [...this.queueItems]) {\n      try {\n        const result = await this.remote.push(operation);\n        if (result.type === \"conflict\") {\n          const local = operation.item;\n          const resolved = this.resolveConflict\n            ? await this.resolveConflict(local, result.remote, {\n                operation,\n                remoteRevision: result.revision,\n              })\n            : undefined;\n          if (!resolved) {\n            this.updateState({\n              status: \"conflict\",\n              conflictIds: [...new Set([...this.state.conflictIds, operation.id])],\n            });\n            continue;\n          }\n          const retry = this.createOperation(\"upsert\", resolved.id, {\n            ...resolved,\n            revision: result.revision ?? resolved.revision,\n          });\n          await this.local.set(retry.item as KeepItem<TMeta>);\n          await this.replaceQueued(operation, retry);\n          continue;\n        }\n        if (result.item) {\n          await this.local.set({\n            ...result.item,\n            ...(result.revision ? { revision: result.revision } : {}),\n          });\n          this.notifyDataListeners();\n        }\n        await this.removeQueued(operation.operationId);\n        this.updateState({\n          status: this.queueItems.length > 0 ? \"syncing\" : \"synced\",\n          lastSyncedAt: this.now(),\n          conflictIds: this.state.conflictIds.filter((id) => id !== operation.id),\n        });\n      } catch (error) {\n        this.updateState({ status: \"error\", error });\n        return;\n      }\n    }\n    if (this.queueItems.length === 0) this.updateState({ status: \"synced\", pendingCount: 0 });\n  }\n\n  private createOperation(\n    type: SyncOperation<TMeta>[\"type\"],\n    id: string,\n    item?: KeepItem<TMeta>,\n  ): SyncOperation<TMeta> {\n    return {\n      operationId: `${this.clientId}:${this.now()}:${createId()}`,\n      type,\n      id,\n      ...(item ? { item } : {}),\n      createdAt: this.now(),\n      ...(item?.revision ? { baseRevision: item.revision } : {}),\n    };\n  }\n\n  private async enqueueBeforeLocalWrite(operation: SyncOperation<TMeta>): Promise<void> {\n    await this.enqueueManyBeforeLocalWrite([operation]);\n  }\n\n  private async enqueueManyBeforeLocalWrite(operations: SyncOperation<TMeta>[]): Promise<void> {\n    await this.loadQueue();\n    const next = [...this.queueItems];\n    for (const operation of operations) {\n      for (let index = next.length - 1; index >= 0; index -= 1) {\n        if (next[index]?.id !== operation.id) continue;\n        next.splice(index, 1);\n      }\n      next.push(operation);\n    }\n    await this.persistQueue(next);\n    this.updateState({ status: \"pending\", pendingCount: this.queueItems.length });\n  }\n\n  private async loadQueue(): Promise<void> {\n    if (this.queueLoaded) return;\n    if (!this.queueLoadPromise) {\n      this.queueLoadPromise = this.queue\n        .getAll()\n        .then((items) => {\n          this.queueItems = items;\n          this.queueLoaded = true;\n        })\n        .catch((error) => {\n          this.queueLoadPromise = undefined;\n          throw error;\n        });\n    }\n    await this.queueLoadPromise;\n  }\n\n  private async resumeQueue(): Promise<void> {\n    try {\n      await this.loadQueue();\n      if (this.queueItems.length === 0) return;\n      this.updateState({ status: \"pending\", pendingCount: this.queueItems.length });\n      if (isBrowserOnline()) await this.flushSync();\n    } catch (error) {\n      this.updateState({ status: \"error\", error });\n    }\n  }\n\n  private async persistQueue(next: SyncOperation<TMeta>[]): Promise<void> {\n    const previousIds = new Set(this.queueItems.map((operation) => operation.operationId));\n    const nextIds = new Set(next.map((operation) => operation.operationId));\n    const removed = [...previousIds].filter((id) => !nextIds.has(id));\n    if (removed.length > 0) await this.queue.remove(removed);\n    if (next.length > 0) await this.queue.setMany(next);\n    this.queueItems = next;\n  }\n\n  private async removeQueued(operationIds: string | string[]): Promise<void> {\n    await this.loadQueue();\n    const ids = new Set(typeof operationIds === \"string\" ? [operationIds] : operationIds);\n    await this.queue.remove([...ids]);\n    this.queueItems = this.queueItems.filter((operation) => !ids.has(operation.operationId));\n    this.setPendingState();\n  }\n\n  private async replaceQueued(previous: SyncOperation<TMeta>, next: SyncOperation<TMeta>): Promise<void> {\n    await this.persistQueue(\n      this.queueItems.map((operation) => (operation.operationId === previous.operationId ? next : operation)),\n    );\n    this.setPendingState();\n  }\n\n  private setPendingState(): void {\n    this.updateState({\n      status: this.queueItems.length > 0 ? \"pending\" : \"synced\",\n      pendingCount: this.queueItems.length,\n    });\n  }\n\n  private async pullRemote(): Promise<boolean> {\n    if (!this.remote.pull) return true;\n    try {\n      const remoteItems = await this.remote.pull();\n      const pendingIds = new Set(this.queueItems.map((operation) => operation.id));\n      const localItems = await this.local.getAll();\n      const localById = new Map(localItems.map((item) => [item.id, item]));\n      const incoming = remoteItems.filter((item) => {\n        const current = localById.get(item.id);\n        return !pendingIds.has(item.id) && (!current || item.updatedAt >= current.updatedAt);\n      });\n      if (incoming.length === 0) return true;\n      if (this.local.setMany) await this.local.setMany(incoming);\n      else for (const item of incoming) await this.local.set(item);\n      this.notifyDataListeners();\n      return true;\n    } catch (error) {\n      this.updateState({ status: \"error\", error });\n      return false;\n    }\n  }\n\n  private notifyDataListeners(): void {\n    for (const listener of this.dataListeners) listener();\n  }\n\n  private updateState(next: Partial<KeepSyncState>): void {\n    this.state = {\n      ...this.state,\n      ...next,\n      pendingCount: next.pendingCount ?? this.queueItems.length,\n    };\n    for (const listener of this.listeners) listener();\n  }\n}\n\nasync function mergeLocalItems<TMeta>(\n  localItems: KeepItem<TMeta>[],\n  target: StorageAdapter<TMeta>,\n): Promise<KeepItem<TMeta>[]> {\n  const remoteItems = await target.getAll();\n  const byId = new Map(remoteItems.map((item) => [item.id, item]));\n  for (const item of localItems) {\n    const current = byId.get(item.id);\n    if (!current || item.updatedAt > current.updatedAt) byId.set(item.id, item);\n  }\n  const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);\n  if (target.setMany) await target.setMany(merged);\n  else for (const item of merged) await target.set(item);\n  return merged;\n}\n\nfunction isSyncOperation(value: unknown): value is SyncOperation {\n  if (!isRecord(value)) return false;\n  return (\n    typeof value.operationId === \"string\" &&\n    (value.type === \"upsert\" || value.type === \"remove\") &&\n    typeof value.id === \"string\" &&\n    typeof value.createdAt === \"number\"\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction createId(): string {\n  if (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto) return crypto.randomUUID();\n  return Math.random().toString(36).slice(2);\n}\n\nfunction getBrowserStorage(): Storage | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  try {\n    return window.localStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction getBrowserIndexedDB(): IDBFactory | undefined {\n  if (typeof indexedDB === \"undefined\") return undefined;\n  return indexedDB;\n}\n\nfunction isBrowserOnline(): boolean {\n  return typeof navigator === \"undefined\" || navigator.onLine !== false;\n}\n\nfunction createDefaultQueue<TMeta>(options: SyncStorageAdapterOptions<TMeta>): SyncQueueAdapter<TMeta> {\n  const queueKey = options.queueKey ?? `${DEFAULT_SYNC_QUEUE_KEY}:${options.local.storageKey ?? \"default\"}`;\n  const fallback = new LocalStorageSyncQueueAdapter<TMeta>({ key: queueKey });\n  const indexedDB = getBrowserIndexedDB();\n  if (!indexedDB) return fallback;\n  return new FallbackSyncQueueAdapter<TMeta>({\n    primary: new IndexedDBSyncQueueAdapter<TMeta>({\n      databaseName: options.queueDatabaseName,\n      indexedDB,\n    }),\n    fallback,\n  });\n}\n\nfunction requestToPromise<T>(request: IDBRequest<T>): Promise<T> {\n  return new Promise((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nfunction transactionToPromise(transaction: IDBTransaction): Promise<void> {\n  return new Promise((resolve, reject) => {\n    transaction.oncomplete = () => resolve();\n    transaction.onerror = () => reject(transaction.error);\n    transaction.onabort = () => reject(transaction.error ?? new Error(\"IndexedDB transaction aborted.\"));\n  });\n}\n","import {\n  type KeepItem,\n  KeepStorageAccessError,\n  KeepStorageError,\n  type KeepStorageOperation,\n  KeepStorageParseError,\n  KeepStorageQuotaError,\n  type StorageAdapter,\n} from \"../types\";\n\nexport const DEFAULT_STORAGE_KEY = \"keepkit:items\";\n\nexport type LocalStorageAdapterOptions = {\n  key?: string;\n  storage?: Storage;\n};\n\nexport type IndexedDBAdapterOptions = {\n  databaseName?: string;\n  dbName?: string;\n  /** Alias for databaseName, useful when switching from LocalStorageAdapter. */\n  key?: string;\n  storeName?: string;\n  version?: number;\n  indexedDB?: IDBFactory;\n};\n\nexport const DEFAULT_INDEXEDDB_DATABASE = \"keepkit\";\nexport const DEFAULT_INDEXEDDB_STORE = \"items\";\n\nexport type StorageAdapterFactoryOptions<TMeta = Record<string, unknown>> = {\n  getAll: () => KeepItem<TMeta>[] | Promise<KeepItem<TMeta>[]>;\n  set: (item: KeepItem<TMeta>) => void | Promise<void>;\n  setMany?: (items: KeepItem<TMeta>[]) => void | Promise<void>;\n  remove: (id: string) => void | Promise<void>;\n  removeMany?: (ids: string[]) => void | Promise<void>;\n  clear: () => void | Promise<void>;\n  merge?: (localItems: KeepItem<TMeta>[]) => KeepItem<TMeta>[] | Promise<KeepItem<TMeta>[]>;\n  subscribe?: (listener: () => void) => undefined | (() => void);\n  storageKey?: string;\n};\n\nexport type FallbackStorageAdapterOptions<TMeta = Record<string, unknown>> = {\n  primary: StorageAdapter<TMeta>;\n  fallback: StorageAdapter<TMeta>;\n  /** Decide which primary adapter failures should activate the fallback. */\n  shouldFallback?: (error: unknown) => boolean;\n  onFallback?: (error: unknown) => void;\n  /** Copy fallback data into an empty primary on the first read. */\n  migrateFallbackOnEmpty?: boolean;\n  /** Keep the fallback current while the primary is healthy. */\n  mirrorWrites?: boolean;\n};\n\n/**\n * A storage adapter that switches to a fallback after an availability failure.\n * Parse errors remain visible so corrupt data is never silently hidden.\n */\nexport class FallbackStorageAdapter<TMeta = Record<string, unknown>> implements StorageAdapter<TMeta> {\n  public readonly storageKey: string | undefined;\n  private readonly primary: StorageAdapter<TMeta>;\n  private readonly fallback: StorageAdapter<TMeta>;\n  private readonly shouldFallback: (error: unknown) => boolean;\n  private readonly onFallback?: (error: unknown) => void;\n  private readonly migrateFallbackOnEmpty: boolean;\n  private readonly mirrorWrites: boolean;\n  private active: \"primary\" | \"fallback\" = \"primary\";\n  private readonly listeners = new Set<() => void>();\n\n  constructor(options: FallbackStorageAdapterOptions<TMeta>) {\n    this.primary = options.primary;\n    this.fallback = options.fallback;\n    this.shouldFallback = options.shouldFallback ?? isRecoverableStorageError;\n    this.onFallback = options.onFallback;\n    this.migrateFallbackOnEmpty = options.migrateFallbackOnEmpty ?? false;\n    this.mirrorWrites = options.mirrorWrites ?? false;\n    this.storageKey = options.fallback.storageKey ?? options.primary.storageKey;\n  }\n\n  get isUsingFallback(): boolean {\n    return this.active === \"fallback\";\n  }\n\n  getAll(): Promise<KeepItem<TMeta>[]> {\n    return this.readAll();\n  }\n\n  set(item: KeepItem<TMeta>): Promise<void> {\n    return this.executeWrite((adapter) => adapter.set(item));\n  }\n\n  setMany(items: KeepItem<TMeta>[]): Promise<void> {\n    return this.executeWrite((adapter) =>\n      adapter.setMany\n        ? adapter.setMany(items)\n        : Promise.all(items.map((item) => adapter.set(item))).then(() => undefined),\n    );\n  }\n\n  remove(id: string): Promise<void> {\n    return this.executeWrite((adapter) => adapter.remove(id));\n  }\n\n  removeMany(ids: string[]): Promise<void> {\n    return this.executeWrite((adapter) =>\n      adapter.removeMany\n        ? adapter.removeMany(ids)\n        : Promise.all(ids.map((id) => adapter.remove(id))).then(() => undefined),\n    );\n  }\n\n  clear(): Promise<void> {\n    return this.executeWrite((adapter) => adapter.clear());\n  }\n\n  merge(localItems: KeepItem<TMeta>[]): Promise<KeepItem<TMeta>[]> {\n    return this.execute(async (adapter) => {\n      const merged = adapter.merge ? await adapter.merge(localItems) : await mergeItems(adapter, localItems);\n      if (this.active === \"primary\" && this.mirrorWrites) {\n        try {\n          if (this.fallback.setMany) await this.fallback.setMany(merged);\n          else for (const item of merged) await this.fallback.set(item);\n        } catch {\n          // The fallback is best-effort while the primary is healthy.\n        }\n      }\n      return merged;\n    });\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    const notify = (source: \"primary\" | \"fallback\") => {\n      if (source === this.active) listener();\n    };\n    const unsubscribePrimary = this.primary.subscribe?.(() => notify(\"primary\"));\n    const unsubscribeFallback = this.fallback.subscribe?.(() => notify(\"fallback\"));\n    return () => {\n      this.listeners.delete(listener);\n      unsubscribePrimary?.();\n      unsubscribeFallback?.();\n    };\n  }\n\n  private async readAll(): Promise<KeepItem<TMeta>[]> {\n    if (this.active === \"fallback\") return this.fallback.getAll();\n    let items: KeepItem<TMeta>[];\n    try {\n      items = await this.primary.getAll();\n    } catch (error) {\n      if (!this.shouldFallback(error)) throw error;\n      this.activateFallback(error);\n      return this.fallback.getAll();\n    }\n    if (!this.migrateFallbackOnEmpty || items.length > 0) return items;\n\n    const fallbackItems = await this.fallback.getAll();\n    if (fallbackItems.length === 0) return items;\n    try {\n      if (this.primary.setMany) await this.primary.setMany(fallbackItems);\n      else for (const item of fallbackItems) await this.primary.set(item);\n      return fallbackItems;\n    } catch (error) {\n      if (!this.shouldFallback(error)) throw error;\n      this.activateFallback(error);\n      return fallbackItems;\n    }\n  }\n\n  private activateFallback(error: unknown): void {\n    this.active = \"fallback\";\n    this.onFallback?.(error);\n    for (const listener of this.listeners) listener();\n  }\n\n  private async executeWrite<TResult>(\n    operation: (adapter: StorageAdapter<TMeta>) => Promise<TResult>,\n  ): Promise<TResult> {\n    const result = await this.execute(operation);\n    if (this.active === \"primary\" && this.mirrorWrites) {\n      try {\n        await operation(this.fallback);\n      } catch {\n        // The fallback is best-effort while the primary is healthy.\n      }\n    }\n    return result;\n  }\n\n  private async execute<TResult>(operation: (adapter: StorageAdapter<TMeta>) => Promise<TResult>): Promise<TResult> {\n    const adapter = this.active === \"primary\" ? this.primary : this.fallback;\n    try {\n      return await operation(adapter);\n    } catch (error) {\n      if (this.active !== \"primary\" || !this.shouldFallback(error)) throw error;\n      this.activateFallback(error);\n      return operation(this.fallback);\n    }\n  }\n}\n\nexport type BrowserStorageAdapterOptions = {\n  key?: string;\n  databaseName?: string;\n  storeName?: string;\n  version?: number;\n  indexedDB?: IDBFactory;\n  storage?: Storage;\n};\n\n/** IndexedDB-first browser storage with localStorage fallback. */\nexport function createBrowserStorageAdapter<TMeta = Record<string, unknown>>(\n  options: BrowserStorageAdapterOptions = {},\n): StorageAdapter<TMeta> {\n  const browserIndexedDB = options.indexedDB ?? getBrowserIndexedDB();\n  const fallback = new LocalStorageAdapter<TMeta>({ key: options.key, storage: options.storage });\n  if (!browserIndexedDB) return fallback;\n  return new FallbackStorageAdapter<TMeta>({\n    primary: new IndexedDBAdapter<TMeta>({\n      databaseName: options.databaseName,\n      storeName: options.storeName,\n      version: options.version,\n      indexedDB: browserIndexedDB,\n    }),\n    fallback,\n    migrateFallbackOnEmpty: true,\n    mirrorWrites: true,\n  });\n}\n\n/** Adapt sync or async persistence functions to the StorageAdapter contract. */\nexport function createStorageAdapter<TMeta = Record<string, unknown>>(\n  options: StorageAdapterFactoryOptions<TMeta>,\n): StorageAdapter<TMeta> {\n  const merge = options.merge;\n  const subscribe = options.subscribe;\n  const setMany = options.setMany;\n  const removeMany = options.removeMany;\n  return {\n    getAll: async () => options.getAll(),\n    set: async (item) => options.set(item),\n    ...(setMany ? { setMany: async (items: KeepItem<TMeta>[]) => setMany(items) } : {}),\n    remove: async (id) => options.remove(id),\n    ...(removeMany ? { removeMany: async (ids: string[]) => removeMany(ids) } : {}),\n    clear: async () => options.clear(),\n    ...(merge ? { merge: async (items: KeepItem<TMeta>[]) => merge(items) } : {}),\n    ...(subscribe\n      ? {\n          subscribe: (listener: () => void) => subscribe(listener) ?? (() => undefined),\n        }\n      : {}),\n    ...(options.storageKey ? { storageKey: options.storageKey } : {}),\n  };\n}\n\nasync function mergeItems<TMeta>(\n  adapter: StorageAdapter<TMeta>,\n  localItems: KeepItem<TMeta>[],\n): Promise<KeepItem<TMeta>[]> {\n  const remoteItems = await adapter.getAll();\n  const byId = new Map(remoteItems.map((item) => [item.id, item]));\n  for (const item of localItems) {\n    const current = byId.get(item.id);\n    if (!current || item.updatedAt > current.updatedAt) byId.set(item.id, item);\n  }\n  const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);\n  if (adapter.setMany) await adapter.setMany(merged);\n  else for (const item of merged) await adapter.set(item);\n  return merged;\n}\n\n/** An async StorageAdapter backed by browser localStorage. */\nexport class LocalStorageAdapter<TMeta = Record<string, unknown>> implements StorageAdapter<TMeta> {\n  public readonly storageKey: string;\n  private readonly storage: Storage | undefined;\n\n  constructor(options: LocalStorageAdapterOptions = {}) {\n    this.storageKey = options.key ?? DEFAULT_STORAGE_KEY;\n    this.storage = options.storage ?? getBrowserStorage();\n  }\n\n  async getAll(): Promise<KeepItem<TMeta>[]> {\n    if (!this.storage) return [];\n\n    let raw: string | null;\n    try {\n      raw = this.storage.getItem(this.storageKey);\n    } catch (cause) {\n      throw new KeepStorageAccessError({\n        operation: \"getAll\",\n        storageKey: this.storageKey,\n        cause,\n      });\n    }\n\n    if (!raw) return [];\n\n    try {\n      const value: unknown = JSON.parse(raw);\n      if (!isKeepItemArray(value)) {\n        throw new KeepStorageParseError({\n          operation: \"getAll\",\n          storageKey: this.storageKey,\n        });\n      }\n      return value as KeepItem<TMeta>[];\n    } catch (cause) {\n      if (cause instanceof KeepStorageParseError) throw cause;\n      throw new KeepStorageParseError({\n        operation: \"getAll\",\n        storageKey: this.storageKey,\n        cause,\n      });\n    }\n  }\n\n  async set(item: KeepItem<TMeta>): Promise<void> {\n    await this.setMany([item]);\n  }\n\n  async setMany(items: KeepItem<TMeta>[]): Promise<void> {\n    const current = await this.getAll();\n    const byId = new Map(current.map((item) => [item.id, item]));\n    for (const item of items) byId.set(item.id, item);\n    this.write([...byId.values()], \"set\");\n  }\n\n  async remove(id: string): Promise<void> {\n    await this.removeMany([id]);\n  }\n\n  async removeMany(ids: string[]): Promise<void> {\n    const idSet = new Set(ids);\n    const items = await this.getAll();\n    this.write(\n      items.filter((item) => !idSet.has(item.id)),\n      \"remove\",\n    );\n  }\n\n  async clear(): Promise<void> {\n    if (!this.storage) return;\n    try {\n      this.storage.removeItem(this.storageKey);\n    } catch (cause) {\n      throw new KeepStorageAccessError({\n        operation: \"clear\",\n        storageKey: this.storageKey,\n        cause,\n      });\n    }\n  }\n\n  async merge(localItems: KeepItem<TMeta>[]): Promise<KeepItem<TMeta>[]> {\n    const remoteItems = await this.getAll();\n    const byId = new Map(remoteItems.map((item) => [item.id, item]));\n\n    for (const localItem of localItems) {\n      const remoteItem = byId.get(localItem.id);\n      if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt) {\n        byId.set(localItem.id, localItem);\n      }\n    }\n\n    const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);\n    this.write(merged, \"merge\");\n    return merged;\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (typeof window === \"undefined\") return () => undefined;\n\n    const handleStorage = (event: StorageEvent) => {\n      if (event.key !== null && event.key !== this.storageKey) return;\n      listener();\n    };\n\n    window.addEventListener(\"storage\", handleStorage);\n    return () => window.removeEventListener(\"storage\", handleStorage);\n  }\n\n  private write(items: KeepItem<TMeta>[], operation: KeepStorageOperation): void {\n    if (!this.storage) return;\n    try {\n      this.storage.setItem(this.storageKey, JSON.stringify(items));\n    } catch (cause) {\n      if (isQuotaExceededError(cause)) {\n        throw new KeepStorageQuotaError({\n          operation,\n          storageKey: this.storageKey,\n          cause,\n        });\n      }\n      throw new KeepStorageAccessError({\n        operation,\n        storageKey: this.storageKey,\n        cause,\n      });\n    }\n  }\n}\n\n/** An async StorageAdapter backed by IndexedDB, with one object store per adapter. */\nexport class IndexedDBAdapter<TMeta = Record<string, unknown>> implements StorageAdapter<TMeta> {\n  public readonly storageKey: string;\n  private readonly databaseName: string;\n  private readonly storeName: string;\n  private readonly version: number;\n  private readonly indexedDB: IDBFactory | undefined;\n  private databasePromise: Promise<IDBDatabase | undefined> | undefined;\n\n  constructor(options: IndexedDBAdapterOptions = {}) {\n    this.databaseName = options.databaseName ?? options.dbName ?? options.key ?? DEFAULT_INDEXEDDB_DATABASE;\n    this.storeName = options.storeName ?? DEFAULT_INDEXEDDB_STORE;\n    this.version = options.version ?? 1;\n    this.indexedDB = options.indexedDB ?? getBrowserIndexedDB();\n    this.storageKey = `${this.databaseName}:${this.storeName}`;\n  }\n\n  async getAll(): Promise<KeepItem<TMeta>[]> {\n    const database = await this.open(\"getAll\");\n    if (!database) return [];\n    try {\n      const transaction = database.transaction(this.storeName, \"readonly\");\n      const value: unknown = await requestToPromise(transaction.objectStore(this.storeName).getAll());\n      if (!isKeepItemArray(value)) {\n        throw new KeepStorageParseError({ operation: \"getAll\", storageKey: this.storageKey });\n      }\n      return value as KeepItem<TMeta>[];\n    } catch (cause) {\n      if (cause instanceof KeepStorageParseError) throw cause;\n      throw new KeepStorageAccessError({ operation: \"getAll\", storageKey: this.storageKey, cause });\n    }\n  }\n\n  async set(item: KeepItem<TMeta>): Promise<void> {\n    return this.setMany([item]);\n  }\n\n  async setMany(items: KeepItem<TMeta>[]): Promise<void> {\n    const database = await this.open(\"set\");\n    if (!database) return;\n    try {\n      const transaction = database.transaction(this.storeName, \"readwrite\");\n      const objectStore = transaction.objectStore(this.storeName);\n      for (const item of items) objectStore.put(item);\n      await transactionToPromise(transaction);\n      this.notifySubscribers();\n    } catch (cause) {\n      if (isQuotaExceededError(cause)) {\n        throw new KeepStorageQuotaError({ operation: \"set\", storageKey: this.storageKey, cause });\n      }\n      throw new KeepStorageAccessError({ operation: \"set\", storageKey: this.storageKey, cause });\n    }\n  }\n\n  async remove(id: string): Promise<void> {\n    return this.removeMany([id]);\n  }\n\n  async removeMany(ids: string[]): Promise<void> {\n    const database = await this.open(\"remove\");\n    if (!database) return;\n    try {\n      const transaction = database.transaction(this.storeName, \"readwrite\");\n      const objectStore = transaction.objectStore(this.storeName);\n      for (const id of new Set(ids)) objectStore.delete(id);\n      await transactionToPromise(transaction);\n      this.notifySubscribers();\n    } catch (cause) {\n      throw new KeepStorageAccessError({ operation: \"remove\", storageKey: this.storageKey, cause });\n    }\n  }\n\n  async clear(): Promise<void> {\n    const database = await this.open(\"clear\");\n    if (!database) return;\n    try {\n      const transaction = database.transaction(this.storeName, \"readwrite\");\n      transaction.objectStore(this.storeName).clear();\n      await transactionToPromise(transaction);\n      this.notifySubscribers();\n    } catch (cause) {\n      throw new KeepStorageAccessError({ operation: \"clear\", storageKey: this.storageKey, cause });\n    }\n  }\n\n  async merge(localItems: KeepItem<TMeta>[]): Promise<KeepItem<TMeta>[]> {\n    try {\n      const remoteItems = await this.getAll();\n      const byId = new Map(remoteItems.map((item) => [item.id, item]));\n      for (const localItem of localItems) {\n        const remoteItem = byId.get(localItem.id);\n        if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt) byId.set(localItem.id, localItem);\n      }\n      const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);\n      await this.setMany(merged);\n      return merged;\n    } catch (cause) {\n      if (cause instanceof KeepStorageError) throw cause;\n      throw new KeepStorageAccessError({ operation: \"merge\", storageKey: this.storageKey, cause });\n    }\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (!this.indexedDB || typeof BroadcastChannel === \"undefined\") return () => undefined;\n    const channel = new BroadcastChannel(`keepkit:${this.storageKey}`);\n    channel.onmessage = () => listener();\n    return () => channel.close();\n  }\n\n  private notifySubscribers(): void {\n    if (!this.indexedDB || typeof BroadcastChannel === \"undefined\") return;\n    const channel = new BroadcastChannel(`keepkit:${this.storageKey}`);\n    channel.postMessage({ type: \"keepkit:changed\" });\n    channel.close();\n  }\n\n  private open(operation: KeepStorageOperation): Promise<IDBDatabase | undefined> {\n    if (!this.indexedDB) return Promise.resolve(undefined);\n    if (!this.databasePromise) {\n      this.databasePromise = new Promise((resolve, reject) => {\n        let request: IDBOpenDBRequest;\n        try {\n          request = this.indexedDB?.open(this.databaseName, this.version) as IDBOpenDBRequest;\n        } catch (cause) {\n          reject(new KeepStorageAccessError({ operation, storageKey: this.storageKey, cause }));\n          return;\n        }\n        request.onupgradeneeded = () => {\n          if (!request.result.objectStoreNames.contains(this.storeName)) {\n            request.result.createObjectStore(this.storeName, { keyPath: \"id\" });\n          }\n        };\n        request.onsuccess = () => resolve(request.result);\n        request.onerror = () => reject(request.error);\n        request.onblocked = () => reject(request.error ?? new Error(\"IndexedDB open was blocked.\"));\n      });\n    }\n    return this.databasePromise.catch((cause) => {\n      this.databasePromise = undefined;\n      if (cause instanceof KeepStorageError) throw cause;\n      throw new KeepStorageAccessError({ operation, storageKey: this.storageKey, cause });\n    });\n  }\n}\n\nfunction isKeepItemArray(value: unknown): value is KeepItem[] {\n  return (\n    Array.isArray(value) &&\n    value.every(\n      (item) =>\n        isRecord(item) &&\n        typeof item.id === \"string\" &&\n        typeof item.savedAt === \"number\" &&\n        Number.isFinite(item.savedAt) &&\n        typeof item.updatedAt === \"number\" &&\n        Number.isFinite(item.updatedAt) &&\n        \"meta\" in item &&\n        (item.targetType === undefined || typeof item.targetType === \"string\") &&\n        (item.note === undefined || typeof item.note === \"string\") &&\n        (item.schemaVersion === undefined ||\n          (typeof item.schemaVersion === \"number\" && Number.isFinite(item.schemaVersion))) &&\n        (item.revision === undefined || typeof item.revision === \"string\") &&\n        (item.metaUpdatedAt === undefined ||\n          (typeof item.metaUpdatedAt === \"number\" && Number.isFinite(item.metaUpdatedAt))) &&\n        (item.tags === undefined || (Array.isArray(item.tags) && item.tags.every((tag) => typeof tag === \"string\"))),\n    )\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction getBrowserStorage(): Storage | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  try {\n    return window.localStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction getBrowserIndexedDB(): IDBFactory | undefined {\n  if (typeof indexedDB === \"undefined\") return undefined;\n  return indexedDB;\n}\n\nfunction isRecoverableStorageError(error: unknown): boolean {\n  return error instanceof KeepStorageAccessError || error instanceof KeepStorageQuotaError;\n}\n\nfunction requestToPromise<T>(request: IDBRequest<T>): Promise<T> {\n  return new Promise((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nfunction transactionToPromise(transaction: IDBTransaction): Promise<void> {\n  return new Promise((resolve, reject) => {\n    transaction.oncomplete = () => resolve();\n    transaction.onerror = () => reject(transaction.error);\n    transaction.onabort = () => reject(transaction.error ?? new Error(\"IndexedDB transaction aborted.\"));\n  });\n}\n\nfunction isQuotaExceededError(cause: unknown): boolean {\n  if (!isRecord(cause)) return false;\n  return (\n    cause.name === \"QuotaExceededError\" ||\n    cause.name === \"NS_ERROR_DOM_QUOTA_REACHED\" ||\n    cause.code === 22 ||\n    cause.code === 1014\n  );\n}\n\nexport {\n  DEFAULT_SYNC_QUEUE_DATABASE,\n  DEFAULT_SYNC_QUEUE_KEY,\n  DEFAULT_SYNC_QUEUE_STORE,\n  FallbackSyncQueueAdapter,\n  type FallbackSyncQueueAdapterOptions,\n  IndexedDBSyncQueueAdapter,\n  type IndexedDBSyncQueueOptions,\n  LocalStorageSyncQueueAdapter,\n  type LocalStorageSyncQueueOptions,\n  SyncStorageAdapter,\n  type SyncStorageAdapterOptions,\n} from \"./sync\";\n"],"mappings":"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","names":["indexedDB","getBrowserIndexedDB","getBrowserStorage","requestToPromise","transactionToPromise","isRecord"]}

package/dist/core.d.ts

@@ -0,0 +1,66 @@
+import { K as KeepSchema, b as KeepInvalidItemPolicy, a as KeepItem, S as StorageAdapter, c as KeepPluginContext, d as KeepPlugin } from './types-BRfvVnCA.js';
+export { e as KeepAction, f as KeepChangeContext, g as KeepChangePhase, h as KeepConflictContext, i as KeepConflictResolver, j as KeepErrorContext, k as KeepErrorHandler, l as KeepEventHandlers, m as KeepItemInput, n as KeepSchemaParseResult, o as KeepStorageAccessError, p as KeepStorageError, q as KeepStorageOperation, r as KeepStorageParseError, s as KeepStorageQuotaError, t as KeepSyncState, u as KeepSyncStatus, R as RemoteSyncDriver, v as RemoteSyncResult, w as SyncCapableStorageAdapter, x as SyncOperation, y as SyncQueueAdapter, z as normalizeKeepTags } from './types-BRfvVnCA.js';
+export { K as KeepItemMetadataRefresher, a as KeepItemRevalidationRecord, b as KeepItemRevalidationResult, c as KeepItemRevalidationSummary, d as KeepItemRevalidator, e as KeepItemStatus, f as KeepListOptions, g as KeepStore, h as KeepStoreActions, i as KeepStoreState, Q as QueryKeepItemsResult, R as RevalidateKeepItemsOptions, j as getTagCounts, k as isKeepItemMetadataStale, q as queryKeepItems, r as reconcileKeepItems, l as revalidateKeepItems } from './store-DyjKY0s4.js';
+export { KeepSchemaValidationError, parseKeepMeta, validateKeepItem } from './schema.js';
+export { BrowserStorageAdapterOptions, DEFAULT_INDEXEDDB_DATABASE, DEFAULT_INDEXEDDB_STORE, DEFAULT_STORAGE_KEY, DEFAULT_SYNC_QUEUE_DATABASE, DEFAULT_SYNC_QUEUE_KEY, DEFAULT_SYNC_QUEUE_STORE, FallbackStorageAdapter, FallbackStorageAdapterOptions, FallbackSyncQueueAdapter, FallbackSyncQueueAdapterOptions, IndexedDBAdapter, IndexedDBAdapterOptions, IndexedDBSyncQueueAdapter, IndexedDBSyncQueueOptions, LocalStorageAdapter, LocalStorageAdapterOptions, LocalStorageSyncQueueAdapter, LocalStorageSyncQueueOptions, StorageAdapterFactoryOptions, SyncStorageAdapter, SyncStorageAdapterOptions, createBrowserStorageAdapter, createStorageAdapter } from './storage.js';
+
+declare const KEEP_BACKUP_FORMAT = "keepkit";
+declare const KEEP_BACKUP_VERSION = 1;
+type KeepBackup<TMeta = Record<string, unknown>> = {
+    format: typeof KEEP_BACKUP_FORMAT;
+    version: typeof KEEP_BACKUP_VERSION;
+    exportedAt: number;
+    items: KeepItem<TMeta>[];
+};
+type ImportItemsOptions<TMeta = unknown> = {
+    mode?: "replace" | "merge";
+    schema?: KeepSchema<TMeta>;
+    invalidItemPolicy?: KeepInvalidItemPolicy;
+    onInvalidItem?: (error: unknown, item: KeepItem<unknown>) => void;
+};
+type ImportItemsResult<TMeta = Record<string, unknown>> = {
+    mode: "replace" | "merge";
+    imported: number;
+    failed: number;
+    total: number;
+    items: KeepItem<TMeta>[];
+};
+declare class KeepBackupParseError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+declare class KeepBackupImportError extends Error {
+    readonly mode: "replace" | "merge";
+    readonly imported: number;
+    readonly failed: number;
+    readonly cause?: unknown;
+    constructor(message: string, options: {
+        mode: "replace" | "merge";
+        imported: number;
+        failed: number;
+        cause?: unknown;
+    });
+}
+/** Serialize all adapter data into a versioned JSON backup. */
+declare function exportItems<TMeta>(adapter: StorageAdapter<TMeta>): Promise<string>;
+/** Validate and restore a backup, either replacing or merging existing data. */
+declare function importItems<TMeta>(adapter: StorageAdapter<TMeta>, data: string | KeepBackup<TMeta>, options?: ImportItemsOptions<TMeta>): Promise<ImportItemsResult<TMeta>>;
+
+type KeepInvalidationPluginOptions<TMeta = Record<string, unknown>> = {
+    /** Query keys to invalidate after a successful local KeepKit mutation. */
+    queryKeys: readonly unknown[] | ((context: KeepPluginContext<TMeta>) => readonly (readonly unknown[])[]);
+    /** Connect this callback to queryClient.invalidateQueries or SWR mutate. */
+    invalidate: (queryKey: readonly unknown[], context: KeepPluginContext<TMeta>) => void | Promise<void>;
+    name?: string;
+};
+/** Framework-neutral bridge for TanStack Query, SWR, and similar caches. */
+declare function createKeepInvalidationPlugin<TMeta = Record<string, unknown>>(options: KeepInvalidationPluginOptions<TMeta>): KeepPlugin<TMeta>;
+
+/** Merge anonymous local items into a signed-in or remote adapter. */
+declare function mergeKeepItems<TMeta>(localItems: KeepItem<TMeta>[], target: StorageAdapter<TMeta>): Promise<KeepItem<TMeta>[]>;
+/** Read anonymous items, merge them into the target, then clear the source. */
+declare function migrateKeepItems<TMeta>(source: StorageAdapter<TMeta>, target: StorageAdapter<TMeta>): Promise<KeepItem<TMeta>[]>;
+
+export { type ImportItemsOptions, type ImportItemsResult, KEEP_BACKUP_FORMAT, KEEP_BACKUP_VERSION, type KeepBackup, KeepBackupImportError, KeepBackupParseError, KeepInvalidItemPolicy, type KeepInvalidationPluginOptions, KeepItem, KeepPlugin, KeepPluginContext, KeepSchema, StorageAdapter, createKeepInvalidationPlugin, exportItems, importItems, mergeKeepItems, migrateKeepItems };

package/dist/core.js

@@ -0,0 +1,220 @@
+import {
+  KeepStore,
+  getTagCounts,
+  isKeepItemMetadataStale,
+  queryKeepItems,
+  reconcileKeepItems,
+  revalidateKeepItems
+} from "./chunk-J7NKIOXV.js";
+import {
+  KeepSchemaValidationError,
+  parseKeepMeta,
+  validateKeepItem
+} from "./chunk-THZ3ACR2.js";
+import {
+  DEFAULT_INDEXEDDB_DATABASE,
+  DEFAULT_INDEXEDDB_STORE,
+  DEFAULT_STORAGE_KEY,
+  DEFAULT_SYNC_QUEUE_DATABASE,
+  DEFAULT_SYNC_QUEUE_KEY,
+  DEFAULT_SYNC_QUEUE_STORE,
+  FallbackStorageAdapter,
+  FallbackSyncQueueAdapter,
+  IndexedDBAdapter,
+  IndexedDBSyncQueueAdapter,
+  KeepStorageAccessError,
+  KeepStorageError,
+  KeepStorageParseError,
+  KeepStorageQuotaError,
+  LocalStorageAdapter,
+  LocalStorageSyncQueueAdapter,
+  SyncStorageAdapter,
+  createBrowserStorageAdapter,
+  createStorageAdapter,
+  normalizeKeepTags
+} from "./chunk-X4UVKTBK.js";
+
+// src/migration.ts
+async function mergeKeepItems(localItems, target) {
+  if (target.merge) return target.merge(localItems);
+  const remoteItems = await target.getAll();
+  const byId = new Map(remoteItems.map((item) => [item.id, item]));
+  for (const localItem of localItems) {
+    const remoteItem = byId.get(localItem.id);
+    if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt) {
+      byId.set(localItem.id, localItem);
+    }
+  }
+  const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);
+  await Promise.all(merged.map((item) => target.set(item)));
+  return merged;
+}
+async function migrateKeepItems(source, target) {
+  const localItems = await source.getAll();
+  const merged = await mergeKeepItems(localItems, target);
+  await source.clear();
+  return merged;
+}
+
+// src/backup.ts
+var KEEP_BACKUP_FORMAT = "keepkit";
+var KEEP_BACKUP_VERSION = 1;
+var KeepBackupParseError = class extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "KeepBackupParseError";
+    if (options?.cause !== void 0) this.cause = options.cause;
+  }
+};
+var KeepBackupImportError = class extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "KeepBackupImportError";
+    this.mode = options.mode;
+    this.imported = options.imported;
+    this.failed = options.failed;
+    if (options.cause !== void 0) this.cause = options.cause;
+  }
+};
+async function exportItems(adapter) {
+  const backup = {
+    format: KEEP_BACKUP_FORMAT,
+    version: KEEP_BACKUP_VERSION,
+    exportedAt: Date.now(),
+    items: await adapter.getAll()
+  };
+  return JSON.stringify(backup, null, 2);
+}
+async function importItems(adapter, data, options = {}) {
+  const backup = parseBackup(data);
+  const mode = options.mode ?? "merge";
+  const validItems = [];
+  let failed = 0;
+  for (const item of backup.items) {
+    if (!options.schema) {
+      validItems.push(item);
+      continue;
+    }
+    try {
+      validItems.push(await validateKeepItem(item, options.schema));
+    } catch (cause) {
+      options.onInvalidItem?.(cause, item);
+      if ((options.invalidItemPolicy ?? "error") === "drop") {
+        failed += 1;
+        continue;
+      }
+      throw cause;
+    }
+  }
+  let items;
+  if (mode === "merge") {
+    try {
+      items = await mergeKeepItems(validItems, adapter);
+    } catch (cause) {
+      throw new KeepBackupImportError("KeepKit could not merge the backup.", {
+        mode,
+        imported: 0,
+        failed: validItems.length + failed,
+        cause
+      });
+    }
+  } else {
+    let imported = 0;
+    try {
+      await adapter.clear();
+      for (const item of validItems) {
+        await adapter.set(item);
+        imported += 1;
+      }
+      items = await adapter.getAll();
+    } catch (cause) {
+      throw new KeepBackupImportError("KeepKit could not replace the stored items.", {
+        mode,
+        imported,
+        failed: validItems.length + failed - imported,
+        cause
+      });
+    }
+  }
+  return { mode, imported: validItems.length, failed, total: items.length, items };
+}
+function parseBackup(data) {
+  let value = data;
+  if (typeof data === "string") {
+    try {
+      value = JSON.parse(data);
+    } catch (cause) {
+      throw new KeepBackupParseError("KeepKit backup is not valid JSON.", { cause });
+    }
+  }
+  if (!isRecord(value)) throw new KeepBackupParseError("KeepKit backup must be an object.");
+  if (value.format !== KEEP_BACKUP_FORMAT || value.version !== KEEP_BACKUP_VERSION) {
+    throw new KeepBackupParseError("KeepKit backup format or version is unsupported.");
+  }
+  if (typeof value.exportedAt !== "number" || !Number.isFinite(value.exportedAt)) {
+    throw new KeepBackupParseError("KeepKit backup has an invalid export timestamp.");
+  }
+  if (!Array.isArray(value.items) || !value.items.every(isKeepItem)) {
+    throw new KeepBackupParseError("KeepKit backup contains invalid items.");
+  }
+  return value;
+}
+function isKeepItem(value) {
+  if (!isRecord(value)) return false;
+  return typeof value.id === "string" && typeof value.savedAt === "number" && Number.isFinite(value.savedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) && "meta" in value && (value.targetType === void 0 || typeof value.targetType === "string") && (value.note === void 0 || typeof value.note === "string") && (value.schemaVersion === void 0 || typeof value.schemaVersion === "number" && Number.isFinite(value.schemaVersion)) && (value.revision === void 0 || typeof value.revision === "string") && (value.metaUpdatedAt === void 0 || typeof value.metaUpdatedAt === "number" && Number.isFinite(value.metaUpdatedAt)) && (value.tags === void 0 || Array.isArray(value.tags) && value.tags.every((tag) => typeof tag === "string"));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+
+// src/integrations.ts
+function createKeepInvalidationPlugin(options) {
+  return {
+    name: options.name ?? "keepkit-cache-invalidation",
+    after: async (context) => {
+      const keys = typeof options.queryKeys === "function" ? options.queryKeys(context) : [options.queryKeys];
+      await Promise.all(keys.map((queryKey) => options.invalidate(queryKey, context)));
+    }
+  };
+}
+export {
+  DEFAULT_INDEXEDDB_DATABASE,
+  DEFAULT_INDEXEDDB_STORE,
+  DEFAULT_STORAGE_KEY,
+  DEFAULT_SYNC_QUEUE_DATABASE,
+  DEFAULT_SYNC_QUEUE_KEY,
+  DEFAULT_SYNC_QUEUE_STORE,
+  FallbackStorageAdapter,
+  FallbackSyncQueueAdapter,
+  IndexedDBAdapter,
+  IndexedDBSyncQueueAdapter,
+  KEEP_BACKUP_FORMAT,
+  KEEP_BACKUP_VERSION,
+  KeepBackupImportError,
+  KeepBackupParseError,
+  KeepSchemaValidationError,
+  KeepStorageAccessError,
+  KeepStorageError,
+  KeepStorageParseError,
+  KeepStorageQuotaError,
+  KeepStore,
+  LocalStorageAdapter,
+  LocalStorageSyncQueueAdapter,
+  SyncStorageAdapter,
+  createBrowserStorageAdapter,
+  createKeepInvalidationPlugin,
+  createStorageAdapter,
+  exportItems,
+  getTagCounts,
+  importItems,
+  isKeepItemMetadataStale,
+  mergeKeepItems,
+  migrateKeepItems,
+  normalizeKeepTags,
+  parseKeepMeta,
+  queryKeepItems,
+  reconcileKeepItems,
+  revalidateKeepItems,
+  validateKeepItem
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/migration.ts","../src/backup.ts","../src/integrations.ts"],"sourcesContent":["import type { KeepItem, StorageAdapter } from \"./types\";\n\n/** Merge anonymous local items into a signed-in or remote adapter. */\nexport async function mergeKeepItems<TMeta>(\n  localItems: KeepItem<TMeta>[],\n  target: StorageAdapter<TMeta>,\n): Promise<KeepItem<TMeta>[]> {\n  if (target.merge) return target.merge(localItems);\n\n  const remoteItems = await target.getAll();\n  const byId = new Map(remoteItems.map((item) => [item.id, item]));\n  for (const localItem of localItems) {\n    const remoteItem = byId.get(localItem.id);\n    if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt) {\n      byId.set(localItem.id, localItem);\n    }\n  }\n\n  const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);\n  await Promise.all(merged.map((item) => target.set(item)));\n  return merged;\n}\n\n/** Read anonymous items, merge them into the target, then clear the source. */\nexport async function migrateKeepItems<TMeta>(\n  source: StorageAdapter<TMeta>,\n  target: StorageAdapter<TMeta>,\n): Promise<KeepItem<TMeta>[]> {\n  const localItems = await source.getAll();\n  const merged = await mergeKeepItems(localItems, target);\n  await source.clear();\n  return merged;\n}\n","import { mergeKeepItems } from \"./migration\";\nimport { validateKeepItem } from \"./schema\";\nimport type { KeepInvalidItemPolicy, KeepItem, KeepSchema, StorageAdapter } from \"./types\";\n\nexport const KEEP_BACKUP_FORMAT = \"keepkit\";\nexport const KEEP_BACKUP_VERSION = 1;\n\nexport type KeepBackup<TMeta = Record<string, unknown>> = {\n  format: typeof KEEP_BACKUP_FORMAT;\n  version: typeof KEEP_BACKUP_VERSION;\n  exportedAt: number;\n  items: KeepItem<TMeta>[];\n};\n\nexport type ImportItemsOptions<TMeta = unknown> = {\n  mode?: \"replace\" | \"merge\";\n  schema?: KeepSchema<TMeta>;\n  invalidItemPolicy?: KeepInvalidItemPolicy;\n  onInvalidItem?: (error: unknown, item: KeepItem<unknown>) => void;\n};\n\nexport type ImportItemsResult<TMeta = Record<string, unknown>> = {\n  mode: \"replace\" | \"merge\";\n  imported: number;\n  failed: number;\n  total: number;\n  items: KeepItem<TMeta>[];\n};\n\nexport class KeepBackupParseError extends Error {\n  readonly cause?: unknown;\n\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message);\n    this.name = \"KeepBackupParseError\";\n    if (options?.cause !== undefined) this.cause = options.cause;\n  }\n}\n\nexport class KeepBackupImportError extends Error {\n  readonly mode: \"replace\" | \"merge\";\n  readonly imported: number;\n  readonly failed: number;\n  readonly cause?: unknown;\n\n  constructor(\n    message: string,\n    options: {\n      mode: \"replace\" | \"merge\";\n      imported: number;\n      failed: number;\n      cause?: unknown;\n    },\n  ) {\n    super(message);\n    this.name = \"KeepBackupImportError\";\n    this.mode = options.mode;\n    this.imported = options.imported;\n    this.failed = options.failed;\n    if (options.cause !== undefined) this.cause = options.cause;\n  }\n}\n\n/** Serialize all adapter data into a versioned JSON backup. */\nexport async function exportItems<TMeta>(adapter: StorageAdapter<TMeta>): Promise<string> {\n  const backup: KeepBackup<TMeta> = {\n    format: KEEP_BACKUP_FORMAT,\n    version: KEEP_BACKUP_VERSION,\n    exportedAt: Date.now(),\n    items: await adapter.getAll(),\n  };\n  return JSON.stringify(backup, null, 2);\n}\n\n/** Validate and restore a backup, either replacing or merging existing data. */\nexport async function importItems<TMeta>(\n  adapter: StorageAdapter<TMeta>,\n  data: string | KeepBackup<TMeta>,\n  options: ImportItemsOptions<TMeta> = {},\n): Promise<ImportItemsResult<TMeta>> {\n  const backup = parseBackup<TMeta>(data);\n  const mode = options.mode ?? \"merge\";\n  const validItems: KeepItem<TMeta>[] = [];\n  let failed = 0;\n  for (const item of backup.items) {\n    if (!options.schema) {\n      validItems.push(item);\n      continue;\n    }\n    try {\n      validItems.push(await validateKeepItem(item, options.schema));\n    } catch (cause) {\n      options.onInvalidItem?.(cause, item);\n      if ((options.invalidItemPolicy ?? \"error\") === \"drop\") {\n        failed += 1;\n        continue;\n      }\n      throw cause;\n    }\n  }\n  let items: KeepItem<TMeta>[];\n\n  if (mode === \"merge\") {\n    try {\n      items = await mergeKeepItems(validItems, adapter);\n    } catch (cause) {\n      throw new KeepBackupImportError(\"KeepKit could not merge the backup.\", {\n        mode,\n        imported: 0,\n        failed: validItems.length + failed,\n        cause,\n      });\n    }\n  } else {\n    let imported = 0;\n    try {\n      await adapter.clear();\n      for (const item of validItems) {\n        await adapter.set(item);\n        imported += 1;\n      }\n      items = await adapter.getAll();\n    } catch (cause) {\n      throw new KeepBackupImportError(\"KeepKit could not replace the stored items.\", {\n        mode,\n        imported,\n        failed: validItems.length + failed - imported,\n        cause,\n      });\n    }\n  }\n\n  return { mode, imported: validItems.length, failed, total: items.length, items };\n}\n\nfunction parseBackup<TMeta>(data: string | KeepBackup<TMeta>): KeepBackup<TMeta> {\n  let value: unknown = data;\n  if (typeof data === \"string\") {\n    try {\n      value = JSON.parse(data);\n    } catch (cause) {\n      throw new KeepBackupParseError(\"KeepKit backup is not valid JSON.\", { cause });\n    }\n  }\n\n  if (!isRecord(value)) throw new KeepBackupParseError(\"KeepKit backup must be an object.\");\n  if (value.format !== KEEP_BACKUP_FORMAT || value.version !== KEEP_BACKUP_VERSION) {\n    throw new KeepBackupParseError(\"KeepKit backup format or version is unsupported.\");\n  }\n  if (typeof value.exportedAt !== \"number\" || !Number.isFinite(value.exportedAt)) {\n    throw new KeepBackupParseError(\"KeepKit backup has an invalid export timestamp.\");\n  }\n  if (!Array.isArray(value.items) || !value.items.every(isKeepItem)) {\n    throw new KeepBackupParseError(\"KeepKit backup contains invalid items.\");\n  }\n  return value as KeepBackup<TMeta>;\n}\n\nfunction isKeepItem(value: unknown): value is KeepItem {\n  if (!isRecord(value)) return false;\n  return (\n    typeof value.id === \"string\" &&\n    typeof value.savedAt === \"number\" &&\n    Number.isFinite(value.savedAt) &&\n    typeof value.updatedAt === \"number\" &&\n    Number.isFinite(value.updatedAt) &&\n    \"meta\" in value &&\n    (value.targetType === undefined || typeof value.targetType === \"string\") &&\n    (value.note === undefined || typeof value.note === \"string\") &&\n    (value.schemaVersion === undefined ||\n      (typeof value.schemaVersion === \"number\" && Number.isFinite(value.schemaVersion))) &&\n    (value.revision === undefined || typeof value.revision === \"string\") &&\n    (value.metaUpdatedAt === undefined ||\n      (typeof value.metaUpdatedAt === \"number\" && Number.isFinite(value.metaUpdatedAt))) &&\n    (value.tags === undefined || (Array.isArray(value.tags) && value.tags.every((tag) => typeof tag === \"string\")))\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n","import type { KeepPlugin, KeepPluginContext } from \"./types\";\n\nexport type KeepInvalidationPluginOptions<TMeta = Record<string, unknown>> = {\n  /** Query keys to invalidate after a successful local KeepKit mutation. */\n  queryKeys: readonly unknown[] | ((context: KeepPluginContext<TMeta>) => readonly (readonly unknown[])[]);\n  /** Connect this callback to queryClient.invalidateQueries or SWR mutate. */\n  invalidate: (queryKey: readonly unknown[], context: KeepPluginContext<TMeta>) => void | Promise<void>;\n  name?: string;\n};\n\n/** Framework-neutral bridge for TanStack Query, SWR, and similar caches. */\nexport function createKeepInvalidationPlugin<TMeta = Record<string, unknown>>(\n  options: KeepInvalidationPluginOptions<TMeta>,\n): KeepPlugin<TMeta> {\n  return {\n    name: options.name ?? \"keepkit-cache-invalidation\",\n    after: async (context) => {\n      const keys = typeof options.queryKeys === \"function\" ? options.queryKeys(context) : [options.queryKeys];\n      await Promise.all(keys.map((queryKey) => options.invalidate(queryKey, context)));\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,eAAsB,eACpB,YACA,QAC4B;AAC5B,MAAI,OAAO,MAAO,QAAO,OAAO,MAAM,UAAU;AAEhD,QAAM,cAAc,MAAM,OAAO,OAAO;AACxC,QAAM,OAAO,IAAI,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AAC/D,aAAW,aAAa,YAAY;AAClC,UAAM,aAAa,KAAK,IAAI,UAAU,EAAE;AACxC,QAAI,CAAC,cAAc,UAAU,YAAY,WAAW,WAAW;AAC7D,WAAK,IAAI,UAAU,IAAI,SAAS;AAAA,IAClC;AAAA,EACF;AAEA,QAAM,SAAS,CAAC,GAAG,KAAK,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS;AAC1E,QAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,SAAS,OAAO,IAAI,IAAI,CAAC,CAAC;AACxD,SAAO;AACT;AAGA,eAAsB,iBACpB,QACA,QAC4B;AAC5B,QAAM,aAAa,MAAM,OAAO,OAAO;AACvC,QAAM,SAAS,MAAM,eAAe,YAAY,MAAM;AACtD,QAAM,OAAO,MAAM;AACnB,SAAO;AACT;;;AC5BO,IAAM,qBAAqB;AAC3B,IAAM,sBAAsB;AAwB5B,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAG9C,YAAY,SAAiB,SAA+B;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,QAAI,SAAS,UAAU,OAAW,MAAK,QAAQ,QAAQ;AAAA,EACzD;AACF;AAEO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAM/C,YACE,SACA,SAMA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,WAAW,QAAQ;AACxB,SAAK,SAAS,QAAQ;AACtB,QAAI,QAAQ,UAAU,OAAW,MAAK,QAAQ,QAAQ;AAAA,EACxD;AACF;AAGA,eAAsB,YAAmB,SAAiD;AACxF,QAAM,SAA4B;AAAA,IAChC,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,YAAY,KAAK,IAAI;AAAA,IACrB,OAAO,MAAM,QAAQ,OAAO;AAAA,EAC9B;AACA,SAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AACvC;AAGA,eAAsB,YACpB,SACA,MACA,UAAqC,CAAC,GACH;AACnC,QAAM,SAAS,YAAmB,IAAI;AACtC,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,aAAgC,CAAC;AACvC,MAAI,SAAS;AACb,aAAW,QAAQ,OAAO,OAAO;AAC/B,QAAI,CAAC,QAAQ,QAAQ;AACnB,iBAAW,KAAK,IAAI;AACpB;AAAA,IACF;AACA,QAAI;AACF,iBAAW,KAAK,MAAM,iBAAiB,MAAM,QAAQ,MAAM,CAAC;AAAA,IAC9D,SAAS,OAAO;AACd,cAAQ,gBAAgB,OAAO,IAAI;AACnC,WAAK,QAAQ,qBAAqB,aAAa,QAAQ;AACrD,kBAAU;AACV;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACA,MAAI;AAEJ,MAAI,SAAS,SAAS;AACpB,QAAI;AACF,cAAQ,MAAM,eAAe,YAAY,OAAO;AAAA,IAClD,SAAS,OAAO;AACd,YAAM,IAAI,sBAAsB,uCAAuC;AAAA,QACrE;AAAA,QACA,UAAU;AAAA,QACV,QAAQ,WAAW,SAAS;AAAA,QAC5B;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,OAAO;AACL,QAAI,WAAW;AACf,QAAI;AACF,YAAM,QAAQ,MAAM;AACpB,iBAAW,QAAQ,YAAY;AAC7B,cAAM,QAAQ,IAAI,IAAI;AACtB,oBAAY;AAAA,MACd;AACA,cAAQ,MAAM,QAAQ,OAAO;AAAA,IAC/B,SAAS,OAAO;AACd,YAAM,IAAI,sBAAsB,+CAA+C;AAAA,QAC7E;AAAA,QACA;AAAA,QACA,QAAQ,WAAW,SAAS,SAAS;AAAA,QACrC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,UAAU,WAAW,QAAQ,QAAQ,OAAO,MAAM,QAAQ,MAAM;AACjF;AAEA,SAAS,YAAmB,MAAqD;AAC/E,MAAI,QAAiB;AACrB,MAAI,OAAO,SAAS,UAAU;AAC5B,QAAI;AACF,cAAQ,KAAK,MAAM,IAAI;AAAA,IACzB,SAAS,OAAO;AACd,YAAM,IAAI,qBAAqB,qCAAqC,EAAE,MAAM,CAAC;AAAA,IAC/E;AAAA,EACF;AAEA,MAAI,CAAC,SAAS,KAAK,EAAG,OAAM,IAAI,qBAAqB,mCAAmC;AACxF,MAAI,MAAM,WAAW,sBAAsB,MAAM,YAAY,qBAAqB;AAChF,UAAM,IAAI,qBAAqB,kDAAkD;AAAA,EACnF;AACA,MAAI,OAAO,MAAM,eAAe,YAAY,CAAC,OAAO,SAAS,MAAM,UAAU,GAAG;AAC9E,UAAM,IAAI,qBAAqB,iDAAiD;AAAA,EAClF;AACA,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,KAAK,CAAC,MAAM,MAAM,MAAM,UAAU,GAAG;AACjE,UAAM,IAAI,qBAAqB,wCAAwC;AAAA,EACzE;AACA,SAAO;AACT;AAEA,SAAS,WAAW,OAAmC;AACrD,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,SACE,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,YAAY,YACzB,OAAO,SAAS,MAAM,OAAO,KAC7B,OAAO,MAAM,cAAc,YAC3B,OAAO,SAAS,MAAM,SAAS,KAC/B,UAAU,UACT,MAAM,eAAe,UAAa,OAAO,MAAM,eAAe,cAC9D,MAAM,SAAS,UAAa,OAAO,MAAM,SAAS,cAClD,MAAM,kBAAkB,UACtB,OAAO,MAAM,kBAAkB,YAAY,OAAO,SAAS,MAAM,aAAa,OAChF,MAAM,aAAa,UAAa,OAAO,MAAM,aAAa,cAC1D,MAAM,kBAAkB,UACtB,OAAO,MAAM,kBAAkB,YAAY,OAAO,SAAS,MAAM,aAAa,OAChF,MAAM,SAAS,UAAc,MAAM,QAAQ,MAAM,IAAI,KAAK,MAAM,KAAK,MAAM,CAAC,QAAQ,OAAO,QAAQ,QAAQ;AAEhH;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;;;ACzKO,SAAS,6BACd,SACmB;AACnB,SAAO;AAAA,IACL,MAAM,QAAQ,QAAQ;AAAA,IACtB,OAAO,OAAO,YAAY;AACxB,YAAM,OAAO,OAAO,QAAQ,cAAc,aAAa,QAAQ,UAAU,OAAO,IAAI,CAAC,QAAQ,SAAS;AACtG,YAAM,QAAQ,IAAI,KAAK,IAAI,CAAC,aAAa,QAAQ,WAAW,UAAU,OAAO,CAAC,CAAC;AAAA,IACjF;AAAA,EACF;AACF;","names":[]}