@keepkit/core 0.10.0 → 0.12.0

package/dist/core.d.ts

@@ -1,8 +1,11 @@
-export { I as ImportItemsOptions, a as ImportItemsResult, K as KEEP_BACKUP_FORMAT, b as KEEP_BACKUP_VERSION, c as KeepBackup, d as KeepBackupImportError, e as KeepBackupParseError, f as KeepItemMetadataRefresher, g as KeepItemResolver, h as KeepItemRevalidationRecord, i as KeepItemRevalidationResult, j as KeepItemRevalidationSummary, k as KeepItemRevalidator, l as KeepListQuery, m as KeepStore, n as KeepStoreActions, o as KeepStoreState, Q as QueryKeepItemsResult, R as RevalidateKeepItemsOptions, p as exportItems, q as getTagCounts, r as importItems, s as isKeepItemMetadataStale, t as queryKeepItems, u as reconcileKeepItems, v as revalidateKeepItems } from './store-Cgqx7_xd.js';
-import { b as KeepPluginContext, c as KeepPlugin, a as KeepItem, S as StorageAdapter } from './types--YahIoEB.js';
-export { d as KeepAction, e as KeepChangeContext, f as KeepChangePhase, g as KeepConflictContext, h as KeepConflictResolver, i as KeepErrorContext, j as KeepErrorHandler, k as KeepEventHandlers, l as KeepInvalidItemPolicy, m as KeepItemInput, n as KeepItemStatus, K as KeepSchema, o as KeepSchemaParseResult, p as KeepStorageAccessError, q as KeepStorageError, r as KeepStorageOperation, s as KeepStorageParseError, t as KeepStorageQuotaError, u as KeepSyncState, v as KeepSyncStatus, R as RemoteSyncDriver, w as RemoteSyncResult, x as SyncCapableStorageAdapter, y as SyncOperation, z as SyncQueueAdapter, A as SyncScope, B as normalizeKeepTags } from './types--YahIoEB.js';
+export { D as DEFAULT_KEEP_URL_PARAMS, I as ImportItemsOptions, a as ImportItemsResult, K as KEEP_BACKUP_FORMAT, b as KEEP_BACKUP_VERSION, c as KeepAutoRevalidationOptions, d as KeepBackup, e as KeepBackupImportError, f as KeepBackupParseError, g as KeepItemMetadataRefresher, h as KeepItemResolver, i as KeepItemRevalidationRecord, j as KeepItemRevalidationResult, k as KeepItemRevalidationSummary, l as KeepItemRevalidator, m as KeepListQuery, n as KeepStore, o as KeepStoreActions, p as KeepStoreState, q as KeepUrlParamNames, r as KeepUrlState, s as KeepUrlSyncOptions, Q as QueryKeepItemsResult, R as RevalidateKeepItemsOptions, t as decodeKeepListQuery, u as encodeKeepListQuery, v as exportItems, w as getTagCounts, x as importItems, y as isKeepItemMetadataStale, z as mergeKeepListQueryFromUrl, A as queryKeepItems, B as reconcileKeepItems, C as revalidateKeepItems, E as serializeKeepListQuery } from './url-VhisKZCR.js';
+import { e as KeepPluginContext, f as KeepPlugin, a as KeepItem, b as StorageAdapter, R as RemoteSyncDriver, d as SyncOperation, S as SyncScope, g as SyncCapableStorageAdapter, h as RemoteSyncResult, i as KeepSyncAuthError } from './types-iMK12pmy.js';
+export { j as KeepAction, k as KeepChangeContext, l as KeepChangePhase, m as KeepConflictContext, n as KeepConflictResolver, o as KeepErrorContext, p as KeepErrorHandler, q as KeepEventHandlers, r as KeepInvalidItemPolicy, s as KeepItemInput, t as KeepItemStatus, K as KeepSchema, u as KeepSchemaParseResult, v as KeepStorageAccessError, w as KeepStorageError, x as KeepStorageOperation, y as KeepStorageParseError, z as KeepStorageQuotaError, A as KeepSyncAuthStatus, B as KeepSyncConflict, C as KeepSyncResolution, D as KeepSyncState, E as KeepSyncStatus, F as KeepUndoState, c as SyncQueueAdapter, G as isKeepSyncAuthError, H as normalizeKeepTags } from './types-iMK12pmy.js';
+import { K as KeepScope } from './scope-y_aBm363.js';
+export { S as ScopedStorageAdapter, a as ScopedSyncQueueAdapter, c as createScopedStorageAdapter, g as getKeepScopeKey, i as isSameKeepScope } from './scope-y_aBm363.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';
+import { SyncStorageAdapterOptions, BrowserStorageAdapterOptions } from './storage.js';
+export { 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, createBrowserStorageAdapter, createStorageAdapter } from './storage.js';
 
 type KeepInvalidationPluginOptions<TMeta = Record<string, unknown>> = {
     /** Query keys to invalidate after a successful local KeepKit mutation. */
@@ -19,4 +22,67 @@ declare function mergeKeepItems<TMeta>(localItems: KeepItem<TMeta>[], target: St
 /** 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 KeepInvalidationPluginOptions, KeepItem, KeepPlugin, KeepPluginContext, StorageAdapter, createKeepInvalidationPlugin, mergeKeepItems, migrateKeepItems };
+type KeepKitPresetMode = "local" | "sync" | "backup";
+type KeepKitPresetOptions<TMeta = Record<string, unknown>> = {
+    mode?: KeepKitPresetMode;
+    key?: string;
+    scope?: KeepScope;
+    remote?: RemoteSyncDriver<TMeta>;
+    storage?: StorageAdapter<TMeta>;
+};
+type KeepKitSetup<TMeta = Record<string, unknown>> = {
+    mode: KeepKitPresetMode;
+    scope?: KeepScope;
+    storage: StorageAdapter<TMeta>;
+    exportBackup: () => Promise<string>;
+};
+/**
+ * Build the recommended local/sync/backup wiring without imposing an auth or
+ * API client. Pass the current user and tenant scope whenever the account changes.
+ */
+declare function createKeepKitPreset<TMeta = Record<string, unknown>>(options?: KeepKitPresetOptions<TMeta>): KeepKitSetup<TMeta>;
+declare const createKeepKitSetup: typeof createKeepKitPreset;
+
+type AuthenticatedSyncRequestContext<TMeta = Record<string, unknown>> = {
+    token: string | null;
+    scope?: SyncScope;
+    operation?: SyncOperation<TMeta>;
+};
+/** Transport boundary for auth-aware requests; cookies and bearer tokens remain host concerns. */
+type AuthenticatedSyncTransport<TMeta = Record<string, unknown>> = {
+    push: (operation: SyncOperation<TMeta>, context: AuthenticatedSyncRequestContext<TMeta>) => Promise<RemoteSyncResult<TMeta>>;
+    pull?: (context: AuthenticatedSyncRequestContext<TMeta>) => Promise<KeepItem<TMeta>[]>;
+};
+type AuthenticatedSyncAuthContext<TMeta = Record<string, unknown>> = {
+    operation?: SyncOperation<TMeta>;
+    scope?: SyncScope;
+};
+type AuthenticatedSyncKitOptions<TMeta = Record<string, unknown>> = Omit<SyncStorageAdapterOptions<TMeta>, "local" | "remote" | "scope"> & {
+    /** Optional custom local adapter. Browser storage is used when omitted. */
+    local?: StorageAdapter<TMeta>;
+    key?: BrowserStorageAdapterOptions["key"];
+    databaseName?: BrowserStorageAdapterOptions["databaseName"];
+    scope?: SyncScope;
+    /** Resolve the active account or tenant before storage operations. */
+    getScope?: () => SyncScope | undefined | Promise<SyncScope | undefined>;
+    getAuthToken: () => Promise<string | null>;
+    transport: AuthenticatedSyncTransport<TMeta>;
+    onAuthError?: (error: KeepSyncAuthError<TMeta>, context: AuthenticatedSyncAuthContext<TMeta>) => void | Promise<void>;
+    onReauthenticate?: (error: KeepSyncAuthError<TMeta>, context: AuthenticatedSyncAuthContext<TMeta>) => void | Promise<void>;
+    onScopeChange?: (next: SyncScope | undefined, previous: SyncScope | undefined) => void | Promise<void>;
+};
+type AuthenticatedSyncKit<TMeta = Record<string, unknown>> = {
+    readonly mode: "sync";
+    readonly storage: SyncCapableStorageAdapter<TMeta>;
+    readonly scope?: SyncScope;
+    readonly scopeKey: string;
+    getScope(): SyncScope | undefined;
+    setScope(scope?: SyncScope): Promise<void>;
+    subscribeScope(listener: () => void): () => void;
+    exportBackup(): Promise<string>;
+    dispose(): void;
+};
+/** Creates auth-independent sync wiring with per-request tokens and isolated account scopes. */
+declare function createAuthenticatedSyncKit<TMeta = Record<string, unknown>>(options: AuthenticatedSyncKitOptions<TMeta>): AuthenticatedSyncKit<TMeta>;
+
+export { type AuthenticatedSyncAuthContext, type AuthenticatedSyncKit, type AuthenticatedSyncKitOptions, type AuthenticatedSyncRequestContext, type AuthenticatedSyncTransport, BrowserStorageAdapterOptions, type KeepInvalidationPluginOptions, KeepItem, type KeepKitPresetMode, type KeepKitPresetOptions, type KeepKitSetup, KeepPlugin, KeepPluginContext, KeepScope, KeepSyncAuthError, RemoteSyncDriver, RemoteSyncResult, StorageAdapter, SyncCapableStorageAdapter, SyncOperation, SyncScope, SyncStorageAdapterOptions, createAuthenticatedSyncKit, createKeepInvalidationPlugin, createKeepKitPreset, createKeepKitSetup, mergeKeepItems, migrateKeepItems };

package/dist/core.js

@@ -13,7 +13,7 @@ import {
   queryKeepItems,
   reconcileKeepItems,
   revalidateKeepItems
-} from "./chunk-XF5VI6O5.js";
+} from "./chunk-MDTL5L64.js";
 import {
   KeepSchemaValidationError,
   parseKeepMeta,
@@ -34,13 +34,20 @@ import {
   KeepStorageError,
   KeepStorageParseError,
   KeepStorageQuotaError,
+  KeepSyncAuthError,
   LocalStorageAdapter,
   LocalStorageSyncQueueAdapter,
+  ScopedStorageAdapter,
+  ScopedSyncQueueAdapter,
   SyncStorageAdapter,
   createBrowserStorageAdapter,
+  createScopedStorageAdapter,
   createStorageAdapter,
+  getKeepScopeKey,
+  isKeepSyncAuthError,
+  isSameKeepScope,
   normalizeKeepTags
-} from "./chunk-EXE4E3GA.js";
+} from "./chunk-VJDO3GFH.js";
 
 // src/integrations.ts
 function createKeepInvalidationPlugin(options) {
@@ -52,9 +59,291 @@ function createKeepInvalidationPlugin(options) {
     }
   };
 }
+
+// src/presets.ts
+function createKeepKitPreset(options = {}) {
+  const mode = options.mode ?? "local";
+  const local = options.storage ? options.scope ? createScopedStorageAdapter(options.storage, options.scope) : options.storage : createBrowserStorageAdapter({ key: options.key, scope: options.scope });
+  if (mode === "sync" && !options.remote) {
+    throw new Error('createKeepKitPreset({ mode: "sync" }) requires a remote driver.');
+  }
+  let storage = local;
+  if (mode === "sync") {
+    const remote = options.remote;
+    if (!remote) throw new Error('createKeepKitPreset({ mode: "sync" }) requires a remote driver.');
+    storage = new SyncStorageAdapter({
+      local,
+      remote,
+      userId: options.scope?.userId,
+      tenantId: options.scope?.tenantId
+    });
+  }
+  return {
+    mode,
+    scope: options.scope,
+    storage,
+    exportBackup: () => exportItems(storage)
+  };
+}
+var createKeepKitSetup = createKeepKitPreset;
+
+// src/templates/auth-sync.ts
+function createAuthenticatedSyncKit(options) {
+  const controller = new AuthenticatedSyncStorageController(options);
+  return {
+    mode: "sync",
+    storage: controller,
+    get scope() {
+      return controller.scope;
+    },
+    get scopeKey() {
+      return controller.scopeKey;
+    },
+    getScope: () => controller.scope,
+    setScope: (scope) => controller.setScope(scope),
+    subscribeScope: (listener) => controller.subscribeScope(listener),
+    exportBackup: () => controller.exportBackup(),
+    dispose: () => controller.dispose()
+  };
+}
+var AuthenticatedSyncStorageController = class {
+  constructor(options) {
+    this.scopeListeners = /* @__PURE__ */ new Set();
+    this.dataListeners = /* @__PURE__ */ new Set();
+    this.syncListeners = /* @__PURE__ */ new Set();
+    this.unsubscribeData = () => void 0;
+    this.unsubscribeSync = () => void 0;
+    this.transition = Promise.resolve();
+    this.disposed = false;
+    this.options = options;
+    this.currentScope = options.scope;
+    this.current = this.createAdapter(this.currentScope);
+    this.attach(this.current);
+  }
+  get storageKey() {
+    return this.current.storageKey;
+  }
+  get scope() {
+    return this.currentScope;
+  }
+  get scopeKey() {
+    return getKeepScopeKey(this.currentScope);
+  }
+  async getAll() {
+    await this.ensureScope();
+    return this.current.getAll();
+  }
+  async set(item) {
+    await this.ensureScope();
+    return this.current.set(item);
+  }
+  async setMany(items) {
+    await this.ensureScope();
+    return this.current.setMany(items);
+  }
+  async remove(id) {
+    await this.ensureScope();
+    return this.current.remove(id);
+  }
+  async removeMany(ids) {
+    await this.ensureScope();
+    return this.current.removeMany(ids);
+  }
+  async clear() {
+    await this.ensureScope();
+    return this.current.clear();
+  }
+  async merge(items) {
+    await this.ensureScope();
+    return this.current.merge(items);
+  }
+  subscribe(listener) {
+    this.dataListeners.add(listener);
+    return () => this.dataListeners.delete(listener);
+  }
+  getSyncState() {
+    return this.current.getSyncState();
+  }
+  subscribeSync(listener) {
+    this.syncListeners.add(listener);
+    return () => this.syncListeners.delete(listener);
+  }
+  async flushSync() {
+    await this.ensureScope();
+    return this.current.flushSync();
+  }
+  async retrySync() {
+    await this.ensureScope();
+    return this.current.retrySync?.() ?? this.current.flushSync();
+  }
+  async resolveSyncConflict(id, resolution, item) {
+    await this.ensureScope();
+    if (!this.current.resolveSyncConflict) {
+      throw new Error("The authenticated sync adapter does not support conflict resolution.");
+    }
+    return this.current.resolveSyncConflict(id, resolution, item);
+  }
+  async setScope(nextScope) {
+    const run = this.transition.then(async () => {
+      if (isSameKeepScope(this.currentScope, nextScope)) return;
+      if (this.disposed) throw new Error("AuthenticatedSyncKit has been disposed.");
+      const previousScope = this.currentScope;
+      this.unsubscribeData();
+      this.unsubscribeSync();
+      this.current.dispose?.();
+      this.currentScope = nextScope;
+      this.current = this.createAdapter(nextScope);
+      this.attach(this.current);
+      await this.options.onScopeChange?.(nextScope, previousScope);
+      this.notify(this.scopeListeners);
+      this.notify(this.dataListeners);
+      this.notify(this.syncListeners);
+    });
+    this.transition = run.catch(() => void 0);
+    return run;
+  }
+  subscribeScope(listener) {
+    this.scopeListeners.add(listener);
+    return () => this.scopeListeners.delete(listener);
+  }
+  async exportBackup() {
+    await this.ensureScope();
+    return exportItems(this.current);
+  }
+  dispose() {
+    this.disposed = true;
+    this.unsubscribeData();
+    this.unsubscribeSync();
+    this.current.dispose?.();
+    this.scopeListeners.clear();
+    this.dataListeners.clear();
+    this.syncListeners.clear();
+  }
+  createAdapter(scope) {
+    const local = this.options.local ? scope ? createScopedStorageAdapter(this.options.local, scope) : this.options.local : createBrowserStorageAdapter({ key: this.options.key, databaseName: this.options.databaseName, scope });
+    const queue = this.options.queue && scope ? new ScopedSyncQueueAdapter(this.options.queue, scope) : this.options.queue;
+    const remote = createAuthenticatedRemote(this.options, scope);
+    return new SyncStorageAdapter({
+      ...this.options,
+      local,
+      remote,
+      queue,
+      scope
+    });
+  }
+  attach(adapter) {
+    this.unsubscribeData = adapter.subscribe?.(() => this.notify(this.dataListeners)) ?? (() => void 0);
+    this.unsubscribeSync = adapter.subscribeSync(() => this.notify(this.syncListeners));
+  }
+  async ensureScope() {
+    if (!this.options.getScope) return;
+    await this.setScope(await this.options.getScope());
+  }
+  notify(listeners) {
+    for (const listener of listeners) listener();
+  }
+};
+function createAuthenticatedRemote(options, scope) {
+  const pull = options.transport.pull;
+  return {
+    push: async (operation) => {
+      try {
+        const token = await options.getAuthToken();
+        return await options.transport.push(operation, { token, scope, operation });
+      } catch (cause) {
+        return handleAuthFailure(cause, options, { operation, scope });
+      }
+    },
+    pull: pull ? async () => {
+      try {
+        const token = await options.getAuthToken();
+        return await pull({ token, scope });
+      } catch (cause) {
+        return handleAuthFailure(cause, options, { scope });
+      }
+    } : void 0
+  };
+}
+async function handleAuthFailure(cause, options, context) {
+  const status = getAuthStatus(cause);
+  if (!status) throw cause;
+  const error = cause instanceof KeepSyncAuthError ? cause : new KeepSyncAuthError(status, { operation: context.operation, scope: context.scope, cause });
+  await options.onAuthError?.(error, context);
+  await options.onReauthenticate?.(error, context);
+  throw error;
+}
+function getAuthStatus(error) {
+  if (error instanceof KeepSyncAuthError) return error.status;
+  if (!error || typeof error !== "object") return void 0;
+  const candidate = error;
+  if (candidate.status === 401 || candidate.status === 403) return candidate.status;
+  if (candidate.response?.status === 401 || candidate.response?.status === 403) return candidate.response.status;
+  return candidate.cause ? getAuthStatus(candidate.cause) : void 0;
+}
+
+// src/url.ts
+var DEFAULT_KEEP_URL_PARAMS = {
+  search: "q",
+  tags: "tag",
+  sort: "sort",
+  page: "page"
+};
+function encodeKeepListQuery(query = {}, options = {}) {
+  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };
+  const result = new URLSearchParams();
+  const search = query.search?.query?.trim();
+  if (search) result.set(params.search, search);
+  for (const tag of query.tags ?? []) {
+    const normalized = tag.trim();
+    if (normalized) result.append(params.tags, normalized);
+  }
+  if (query.sort?.by) result.set(params.sort, `${query.sort.by}:${query.sort.direction ?? "desc"}`);
+  const page = query.pagination?.page;
+  if (page !== void 0 && Number.isFinite(page) && page > 1) result.set(params.page, String(Math.floor(page)));
+  return result;
+}
+function decodeKeepListQuery(input, options = {}) {
+  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };
+  const searchParams = input instanceof URLSearchParams ? input : new URL(input, "http://keepkit.invalid").searchParams;
+  const search = searchParams.get(params.search)?.trim();
+  const tags = [
+    ...new Set(
+      searchParams.getAll(params.tags).map((tag) => tag.trim()).filter(Boolean)
+    )
+  ];
+  const sortValue = searchParams.get(params.sort)?.split(":");
+  const sort = sortValue?.[0] === "savedAt" || sortValue?.[0] === "updatedAt" ? {
+    by: sortValue[0],
+    direction: sortValue[1] === "asc" ? "asc" : "desc"
+  } : void 0;
+  const rawPage = Number(searchParams.get(params.page));
+  const page = Number.isInteger(rawPage) && rawPage > 0 ? rawPage : void 0;
+  return {
+    ...search ? { search: { query: search } } : {},
+    ...tags.length > 0 ? { tags } : {},
+    ...sort ? { sort } : {},
+    ...page ? { pagination: { page } } : {}
+  };
+}
+function serializeKeepListQuery(query = {}, options = {}) {
+  const value = encodeKeepListQuery(query, options).toString();
+  return value ? `?${value}` : "";
+}
+function mergeKeepListQueryFromUrl(query, input, options = {}) {
+  const decoded = decodeKeepListQuery(input, options);
+  return {
+    ...query,
+    ...decoded,
+    search: decoded.search ?? query.search,
+    tags: decoded.tags ?? query.tags,
+    sort: decoded.sort ?? query.sort,
+    pagination: decoded.pagination ? { ...query.pagination, ...decoded.pagination } : query.pagination
+  };
+}
 export {
   DEFAULT_INDEXEDDB_DATABASE,
   DEFAULT_INDEXEDDB_STORE,
+  DEFAULT_KEEP_URL_PARAMS,
   DEFAULT_STORAGE_KEY,
   DEFAULT_SYNC_QUEUE_DATABASE,
   DEFAULT_SYNC_QUEUE_KEY,
@@ -73,23 +362,37 @@ export {
   KeepStorageParseError,
   KeepStorageQuotaError,
   KeepStore,
+  KeepSyncAuthError,
   LocalStorageAdapter,
   LocalStorageSyncQueueAdapter,
+  ScopedStorageAdapter,
+  ScopedSyncQueueAdapter,
   SyncStorageAdapter,
+  createAuthenticatedSyncKit,
   createBrowserStorageAdapter,
   createKeepInvalidationPlugin,
+  createKeepKitPreset,
+  createKeepKitSetup,
+  createScopedStorageAdapter,
   createStorageAdapter,
+  decodeKeepListQuery,
+  encodeKeepListQuery,
   exportItems,
+  getKeepScopeKey,
   getTagCounts,
   importItems,
   isKeepItemMetadataStale,
+  isKeepSyncAuthError,
+  isSameKeepScope,
   mergeKeepItems,
+  mergeKeepListQueryFromUrl,
   migrateKeepItems,
   normalizeKeepTags,
   parseKeepMeta,
   queryKeepItems,
   reconcileKeepItems,
   revalidateKeepItems,
+  serializeKeepListQuery,
   validateKeepItem
 };
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/integrations.ts"],"sourcesContent":["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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,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":[]}
+{"version":3,"sources":["../src/integrations.ts","../src/presets.ts","../src/templates/auth-sync.ts","../src/url.ts"],"sourcesContent":["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","import { exportItems } from \"./backup\";\nimport { createScopedStorageAdapter, type KeepScope } from \"./scope\";\nimport { createBrowserStorageAdapter } from \"./storage/index\";\nimport { SyncStorageAdapter } from \"./storage/sync\";\nimport type { RemoteSyncDriver, StorageAdapter } from \"./types\";\n\nexport type KeepKitPresetMode = \"local\" | \"sync\" | \"backup\";\n\nexport type KeepKitPresetOptions<TMeta = Record<string, unknown>> = {\n  mode?: KeepKitPresetMode;\n  key?: string;\n  scope?: KeepScope;\n  remote?: RemoteSyncDriver<TMeta>;\n  storage?: StorageAdapter<TMeta>;\n};\n\nexport type KeepKitSetup<TMeta = Record<string, unknown>> = {\n  mode: KeepKitPresetMode;\n  scope?: KeepScope;\n  storage: StorageAdapter<TMeta>;\n  exportBackup: () => Promise<string>;\n};\n\n/**\n * Build the recommended local/sync/backup wiring without imposing an auth or\n * API client. Pass the current user and tenant scope whenever the account changes.\n */\nexport function createKeepKitPreset<TMeta = Record<string, unknown>>(\n  options: KeepKitPresetOptions<TMeta> = {},\n): KeepKitSetup<TMeta> {\n  const mode = options.mode ?? \"local\";\n  const local = options.storage\n    ? options.scope\n      ? createScopedStorageAdapter(options.storage, options.scope)\n      : options.storage\n    : createBrowserStorageAdapter<TMeta>({ key: options.key, scope: options.scope });\n  if (mode === \"sync\" && !options.remote) {\n    throw new Error('createKeepKitPreset({ mode: \"sync\" }) requires a remote driver.');\n  }\n  let storage: StorageAdapter<TMeta> = local;\n  if (mode === \"sync\") {\n    const remote = options.remote;\n    if (!remote) throw new Error('createKeepKitPreset({ mode: \"sync\" }) requires a remote driver.');\n    storage = new SyncStorageAdapter<TMeta>({\n      local,\n      remote,\n      userId: options.scope?.userId,\n      tenantId: options.scope?.tenantId,\n    });\n  }\n  return {\n    mode,\n    scope: options.scope,\n    storage,\n    exportBackup: () => exportItems(storage),\n  };\n}\n\nexport const createKeepKitSetup = createKeepKitPreset;\n","import { exportItems } from \"../backup\";\nimport { createScopedStorageAdapter, getKeepScopeKey, isSameKeepScope, ScopedSyncQueueAdapter } from \"../scope\";\nimport { type BrowserStorageAdapterOptions, createBrowserStorageAdapter } from \"../storage\";\nimport { SyncStorageAdapter, type SyncStorageAdapterOptions } from \"../storage/sync\";\nimport type {\n  KeepItem,\n  KeepSyncAuthError,\n  KeepSyncAuthStatus,\n  KeepSyncState,\n  RemoteSyncDriver,\n  RemoteSyncResult,\n  StorageAdapter,\n  SyncCapableStorageAdapter,\n  SyncOperation,\n  SyncScope,\n} from \"../types\";\nimport { KeepSyncAuthError as KeepSyncAuthErrorClass } from \"../types\";\n\nexport type AuthenticatedSyncRequestContext<TMeta = Record<string, unknown>> = {\n  token: string | null;\n  scope?: SyncScope;\n  operation?: SyncOperation<TMeta>;\n};\n\n/** Transport boundary for auth-aware requests; cookies and bearer tokens remain host concerns. */\nexport type AuthenticatedSyncTransport<TMeta = Record<string, unknown>> = {\n  push: (\n    operation: SyncOperation<TMeta>,\n    context: AuthenticatedSyncRequestContext<TMeta>,\n  ) => Promise<RemoteSyncResult<TMeta>>;\n  pull?: (context: AuthenticatedSyncRequestContext<TMeta>) => Promise<KeepItem<TMeta>[]>;\n};\n\nexport type AuthenticatedSyncAuthContext<TMeta = Record<string, unknown>> = {\n  operation?: SyncOperation<TMeta>;\n  scope?: SyncScope;\n};\n\nexport type AuthenticatedSyncKitOptions<TMeta = Record<string, unknown>> = Omit<\n  SyncStorageAdapterOptions<TMeta>,\n  \"local\" | \"remote\" | \"scope\"\n> & {\n  /** Optional custom local adapter. Browser storage is used when omitted. */\n  local?: StorageAdapter<TMeta>;\n  key?: BrowserStorageAdapterOptions[\"key\"];\n  databaseName?: BrowserStorageAdapterOptions[\"databaseName\"];\n  scope?: SyncScope;\n  /** Resolve the active account or tenant before storage operations. */\n  getScope?: () => SyncScope | undefined | Promise<SyncScope | undefined>;\n  getAuthToken: () => Promise<string | null>;\n  transport: AuthenticatedSyncTransport<TMeta>;\n  onAuthError?: (error: KeepSyncAuthError<TMeta>, context: AuthenticatedSyncAuthContext<TMeta>) => void | Promise<void>;\n  onReauthenticate?: (\n    error: KeepSyncAuthError<TMeta>,\n    context: AuthenticatedSyncAuthContext<TMeta>,\n  ) => void | Promise<void>;\n  onScopeChange?: (next: SyncScope | undefined, previous: SyncScope | undefined) => void | Promise<void>;\n};\n\nexport type AuthenticatedSyncKit<TMeta = Record<string, unknown>> = {\n  readonly mode: \"sync\";\n  readonly storage: SyncCapableStorageAdapter<TMeta>;\n  readonly scope?: SyncScope;\n  readonly scopeKey: string;\n  getScope(): SyncScope | undefined;\n  setScope(scope?: SyncScope): Promise<void>;\n  subscribeScope(listener: () => void): () => void;\n  exportBackup(): Promise<string>;\n  dispose(): void;\n};\n\n/** Creates auth-independent sync wiring with per-request tokens and isolated account scopes. */\nexport function createAuthenticatedSyncKit<TMeta = Record<string, unknown>>(\n  options: AuthenticatedSyncKitOptions<TMeta>,\n): AuthenticatedSyncKit<TMeta> {\n  const controller = new AuthenticatedSyncStorageController(options);\n  return {\n    mode: \"sync\",\n    storage: controller,\n    get scope() {\n      return controller.scope;\n    },\n    get scopeKey() {\n      return controller.scopeKey;\n    },\n    getScope: () => controller.scope,\n    setScope: (scope) => controller.setScope(scope),\n    subscribeScope: (listener) => controller.subscribeScope(listener),\n    exportBackup: () => controller.exportBackup(),\n    dispose: () => controller.dispose(),\n  };\n}\n\nclass AuthenticatedSyncStorageController<TMeta = Record<string, unknown>> implements SyncCapableStorageAdapter<TMeta> {\n  private readonly options: AuthenticatedSyncKitOptions<TMeta>;\n  private currentScope: SyncScope | undefined;\n  private current: SyncStorageAdapter<TMeta>;\n  private readonly scopeListeners = new Set<() => void>();\n  private readonly dataListeners = new Set<() => void>();\n  private readonly syncListeners = new Set<() => void>();\n  private unsubscribeData: () => void = () => undefined;\n  private unsubscribeSync: () => void = () => undefined;\n  private transition = Promise.resolve();\n  private disposed = false;\n\n  constructor(options: AuthenticatedSyncKitOptions<TMeta>) {\n    this.options = options;\n    this.currentScope = options.scope;\n    this.current = this.createAdapter(this.currentScope);\n    this.attach(this.current);\n  }\n\n  get storageKey(): string | undefined {\n    return this.current.storageKey;\n  }\n\n  get scope(): SyncScope | undefined {\n    return this.currentScope;\n  }\n\n  get scopeKey(): string {\n    return getKeepScopeKey(this.currentScope);\n  }\n\n  async getAll(): Promise<KeepItem<TMeta>[]> {\n    await this.ensureScope();\n    return this.current.getAll();\n  }\n\n  async set(item: KeepItem<TMeta>): Promise<void> {\n    await this.ensureScope();\n    return this.current.set(item);\n  }\n\n  async setMany(items: KeepItem<TMeta>[]): Promise<void> {\n    await this.ensureScope();\n    return this.current.setMany(items);\n  }\n\n  async remove(id: string): Promise<void> {\n    await this.ensureScope();\n    return this.current.remove(id);\n  }\n\n  async removeMany(ids: string[]): Promise<void> {\n    await this.ensureScope();\n    return this.current.removeMany(ids);\n  }\n\n  async clear(): Promise<void> {\n    await this.ensureScope();\n    return this.current.clear();\n  }\n\n  async merge(items: KeepItem<TMeta>[]): Promise<KeepItem<TMeta>[]> {\n    await this.ensureScope();\n    return this.current.merge(items);\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.dataListeners.add(listener);\n    return () => this.dataListeners.delete(listener);\n  }\n\n  getSyncState(): KeepSyncState<TMeta> {\n    return this.current.getSyncState();\n  }\n\n  subscribeSync(listener: () => void): () => void {\n    this.syncListeners.add(listener);\n    return () => this.syncListeners.delete(listener);\n  }\n\n  async flushSync(): Promise<void> {\n    await this.ensureScope();\n    return this.current.flushSync();\n  }\n\n  async retrySync(): Promise<void> {\n    await this.ensureScope();\n    return this.current.retrySync?.() ?? this.current.flushSync();\n  }\n\n  async resolveSyncConflict(\n    id: string,\n    resolution: \"local\" | \"remote\" | \"manual\",\n    item?: KeepItem<TMeta>,\n  ): Promise<void> {\n    await this.ensureScope();\n    if (!this.current.resolveSyncConflict) {\n      throw new Error(\"The authenticated sync adapter does not support conflict resolution.\");\n    }\n    return this.current.resolveSyncConflict(id, resolution, item);\n  }\n\n  async setScope(nextScope?: SyncScope): Promise<void> {\n    const run = this.transition.then(async () => {\n      if (isSameKeepScope(this.currentScope, nextScope)) return;\n      if (this.disposed) throw new Error(\"AuthenticatedSyncKit has been disposed.\");\n      const previousScope = this.currentScope;\n      this.unsubscribeData();\n      this.unsubscribeSync();\n      this.current.dispose?.();\n      this.currentScope = nextScope;\n      this.current = this.createAdapter(nextScope);\n      this.attach(this.current);\n      await this.options.onScopeChange?.(nextScope, previousScope);\n      this.notify(this.scopeListeners);\n      this.notify(this.dataListeners);\n      this.notify(this.syncListeners);\n    });\n    this.transition = run.catch(() => undefined);\n    return run;\n  }\n\n  subscribeScope(listener: () => void): () => void {\n    this.scopeListeners.add(listener);\n    return () => this.scopeListeners.delete(listener);\n  }\n\n  async exportBackup(): Promise<string> {\n    await this.ensureScope();\n    return exportItems(this.current);\n  }\n\n  dispose(): void {\n    this.disposed = true;\n    this.unsubscribeData();\n    this.unsubscribeSync();\n    this.current.dispose?.();\n    this.scopeListeners.clear();\n    this.dataListeners.clear();\n    this.syncListeners.clear();\n  }\n\n  private createAdapter(scope: SyncScope | undefined): SyncStorageAdapter<TMeta> {\n    const local = this.options.local\n      ? scope\n        ? createScopedStorageAdapter(this.options.local, scope)\n        : this.options.local\n      : createBrowserStorageAdapter<TMeta>({ key: this.options.key, databaseName: this.options.databaseName, scope });\n    const queue =\n      this.options.queue && scope ? new ScopedSyncQueueAdapter(this.options.queue, scope) : this.options.queue;\n    const remote = createAuthenticatedRemote(this.options, scope);\n    return new SyncStorageAdapter<TMeta>({\n      ...this.options,\n      local,\n      remote,\n      queue,\n      scope,\n    });\n  }\n\n  private attach(adapter: SyncStorageAdapter<TMeta>): void {\n    this.unsubscribeData = adapter.subscribe?.(() => this.notify(this.dataListeners)) ?? (() => undefined);\n    this.unsubscribeSync = adapter.subscribeSync(() => this.notify(this.syncListeners));\n  }\n\n  private async ensureScope(): Promise<void> {\n    if (!this.options.getScope) return;\n    await this.setScope(await this.options.getScope());\n  }\n\n  private notify(listeners: Set<() => void>): void {\n    for (const listener of listeners) listener();\n  }\n}\n\nfunction createAuthenticatedRemote<TMeta>(\n  options: AuthenticatedSyncKitOptions<TMeta>,\n  scope: SyncScope | undefined,\n): RemoteSyncDriver<TMeta> {\n  const pull = options.transport.pull;\n  return {\n    push: async (operation) => {\n      try {\n        const token = await options.getAuthToken();\n        return await options.transport.push(operation, { token, scope, operation });\n      } catch (cause) {\n        return handleAuthFailure(cause, options, { operation, scope });\n      }\n    },\n    pull: pull\n      ? async () => {\n          try {\n            const token = await options.getAuthToken();\n            return await pull({ token, scope });\n          } catch (cause) {\n            return handleAuthFailure(cause, options, { scope });\n          }\n        }\n      : undefined,\n  };\n}\n\nasync function handleAuthFailure<TMeta>(\n  cause: unknown,\n  options: AuthenticatedSyncKitOptions<TMeta>,\n  context: AuthenticatedSyncAuthContext<TMeta>,\n): Promise<never> {\n  const status = getAuthStatus(cause);\n  if (!status) throw cause;\n  const error =\n    cause instanceof KeepSyncAuthErrorClass\n      ? cause\n      : new KeepSyncAuthErrorClass(status, { operation: context.operation, scope: context.scope, cause });\n  await options.onAuthError?.(error, context);\n  await options.onReauthenticate?.(error, context);\n  throw error;\n}\n\nfunction getAuthStatus(error: unknown): KeepSyncAuthStatus | undefined {\n  if (error instanceof KeepSyncAuthErrorClass) return error.status;\n  if (!error || typeof error !== \"object\") return undefined;\n  const candidate = error as { status?: unknown; response?: { status?: unknown }; cause?: unknown };\n  if (candidate.status === 401 || candidate.status === 403) return candidate.status;\n  if (candidate.response?.status === 401 || candidate.response?.status === 403) return candidate.response.status;\n  return candidate.cause ? getAuthStatus(candidate.cause) : undefined;\n}\n","import type { KeepListQuery } from \"./query\";\n\nexport type KeepUrlParamNames = {\n  search: string;\n  tags: string;\n  sort: string;\n  page: string;\n};\n\nexport type KeepUrlSyncOptions = {\n  /** Parameters are intentionally short so shared collection URLs stay readable. */\n  params?: Partial<KeepUrlParamNames>;\n  /** Push is the default so browser back/forward restores collection states. */\n  history?: \"replace\" | \"push\";\n  /** URL to read/write. Defaults to the current browser URL. */\n  url?: string;\n};\n\nexport const DEFAULT_KEEP_URL_PARAMS: KeepUrlParamNames = {\n  search: \"q\",\n  tags: \"tag\",\n  sort: \"sort\",\n  page: \"page\",\n};\n\nexport type KeepUrlState = Pick<KeepListQuery, \"search\" | \"tags\" | \"sort\" | \"pagination\">;\n\n/** Convert a list query to stable URLSearchParams without serializing functions or unsupported filters. */\nexport function encodeKeepListQuery<TMeta = Record<string, unknown>>(\n  query: KeepListQuery<TMeta> = {},\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): URLSearchParams {\n  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };\n  const result = new URLSearchParams();\n  const search = query.search?.query?.trim();\n  if (search) result.set(params.search, search);\n  for (const tag of query.tags ?? []) {\n    const normalized = tag.trim();\n    if (normalized) result.append(params.tags, normalized);\n  }\n  if (query.sort?.by) result.set(params.sort, `${query.sort.by}:${query.sort.direction ?? \"desc\"}`);\n  const page = query.pagination?.page;\n  if (page !== undefined && Number.isFinite(page) && page > 1) result.set(params.page, String(Math.floor(page)));\n  return result;\n}\n\n/** Parse a URL into the query fields supported by KeepCollection. Invalid values are ignored. */\nexport function decodeKeepListQuery(\n  input: string | URL | URLSearchParams,\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): KeepUrlState {\n  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };\n  const searchParams = input instanceof URLSearchParams ? input : new URL(input, \"http://keepkit.invalid\").searchParams;\n  const search = searchParams.get(params.search)?.trim();\n  const tags = [\n    ...new Set(\n      searchParams\n        .getAll(params.tags)\n        .map((tag) => tag.trim())\n        .filter(Boolean),\n    ),\n  ];\n  const sortValue = searchParams.get(params.sort)?.split(\":\");\n  const sort: KeepListQuery[\"sort\"] =\n    sortValue?.[0] === \"savedAt\" || sortValue?.[0] === \"updatedAt\"\n      ? {\n          by: sortValue[0],\n          direction: sortValue[1] === \"asc\" ? (\"asc\" as const) : (\"desc\" as const),\n        }\n      : undefined;\n  const rawPage = Number(searchParams.get(params.page));\n  const page = Number.isInteger(rawPage) && rawPage > 0 ? rawPage : undefined;\n  return {\n    ...(search ? { search: { query: search } } : {}),\n    ...(tags.length > 0 ? { tags } : {}),\n    ...(sort ? { sort } : {}),\n    ...(page ? { pagination: { page } } : {}),\n  };\n}\n\nexport function serializeKeepListQuery<TMeta = Record<string, unknown>>(\n  query: KeepListQuery<TMeta> = {},\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): string {\n  const value = encodeKeepListQuery(query, options).toString();\n  return value ? `?${value}` : \"\";\n}\n\nexport function mergeKeepListQueryFromUrl<TMeta = Record<string, unknown>>(\n  query: KeepListQuery<TMeta>,\n  input: string | URL | URLSearchParams,\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): KeepListQuery<TMeta> {\n  const decoded = decodeKeepListQuery(input, options);\n  return {\n    ...query,\n    ...decoded,\n    search: decoded.search ?? query.search,\n    tags: decoded.tags ?? query.tags,\n    sort: decoded.sort ?? query.sort,\n    pagination: decoded.pagination ? { ...query.pagination, ...decoded.pagination } : query.pagination,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,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;;;ACMO,SAAS,oBACd,UAAuC,CAAC,GACnB;AACrB,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,QAAQ,QAAQ,UAClB,QAAQ,QACN,2BAA2B,QAAQ,SAAS,QAAQ,KAAK,IACzD,QAAQ,UACV,4BAAmC,EAAE,KAAK,QAAQ,KAAK,OAAO,QAAQ,MAAM,CAAC;AACjF,MAAI,SAAS,UAAU,CAAC,QAAQ,QAAQ;AACtC,UAAM,IAAI,MAAM,iEAAiE;AAAA,EACnF;AACA,MAAI,UAAiC;AACrC,MAAI,SAAS,QAAQ;AACnB,UAAM,SAAS,QAAQ;AACvB,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,iEAAiE;AAC9F,cAAU,IAAI,mBAA0B;AAAA,MACtC;AAAA,MACA;AAAA,MACA,QAAQ,QAAQ,OAAO;AAAA,MACvB,UAAU,QAAQ,OAAO;AAAA,IAC3B,CAAC;AAAA,EACH;AACA,SAAO;AAAA,IACL;AAAA,IACA,OAAO,QAAQ;AAAA,IACf;AAAA,IACA,cAAc,MAAM,YAAY,OAAO;AAAA,EACzC;AACF;AAEO,IAAM,qBAAqB;;;ACc3B,SAAS,2BACd,SAC6B;AAC7B,QAAM,aAAa,IAAI,mCAAmC,OAAO;AACjE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,IAAI,QAAQ;AACV,aAAO,WAAW;AAAA,IACpB;AAAA,IACA,IAAI,WAAW;AACb,aAAO,WAAW;AAAA,IACpB;AAAA,IACA,UAAU,MAAM,WAAW;AAAA,IAC3B,UAAU,CAAC,UAAU,WAAW,SAAS,KAAK;AAAA,IAC9C,gBAAgB,CAAC,aAAa,WAAW,eAAe,QAAQ;AAAA,IAChE,cAAc,MAAM,WAAW,aAAa;AAAA,IAC5C,SAAS,MAAM,WAAW,QAAQ;AAAA,EACpC;AACF;AAEA,IAAM,qCAAN,MAAsH;AAAA,EAYpH,YAAY,SAA6C;AARzD,SAAiB,iBAAiB,oBAAI,IAAgB;AACtD,SAAiB,gBAAgB,oBAAI,IAAgB;AACrD,SAAiB,gBAAgB,oBAAI,IAAgB;AACrD,SAAQ,kBAA8B,MAAM;AAC5C,SAAQ,kBAA8B,MAAM;AAC5C,SAAQ,aAAa,QAAQ,QAAQ;AACrC,SAAQ,WAAW;AAGjB,SAAK,UAAU;AACf,SAAK,eAAe,QAAQ;AAC5B,SAAK,UAAU,KAAK,cAAc,KAAK,YAAY;AACnD,SAAK,OAAO,KAAK,OAAO;AAAA,EAC1B;AAAA,EAEA,IAAI,aAAiC;AACnC,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA,EAEA,IAAI,QAA+B;AACjC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,WAAmB;AACrB,WAAO,gBAAgB,KAAK,YAAY;AAAA,EAC1C;AAAA,EAEA,MAAM,SAAqC;AACzC,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,OAAO;AAAA,EAC7B;AAAA,EAEA,MAAM,IAAI,MAAsC;AAC9C,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,IAAI,IAAI;AAAA,EAC9B;AAAA,EAEA,MAAM,QAAQ,OAAyC;AACrD,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,QAAQ,KAAK;AAAA,EACnC;AAAA,EAEA,MAAM,OAAO,IAA2B;AACtC,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,OAAO,EAAE;AAAA,EAC/B;AAAA,EAEA,MAAM,WAAW,KAA8B;AAC7C,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,WAAW,GAAG;AAAA,EACpC;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC5B;AAAA,EAEA,MAAM,MAAM,OAAsD;AAChE,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,MAAM,KAAK;AAAA,EACjC;AAAA,EAEA,UAAU,UAAkC;AAC1C,SAAK,cAAc,IAAI,QAAQ;AAC/B,WAAO,MAAM,KAAK,cAAc,OAAO,QAAQ;AAAA,EACjD;AAAA,EAEA,eAAqC;AACnC,WAAO,KAAK,QAAQ,aAAa;AAAA,EACnC;AAAA,EAEA,cAAc,UAAkC;AAC9C,SAAK,cAAc,IAAI,QAAQ;AAC/B,WAAO,MAAM,KAAK,cAAc,OAAO,QAAQ;AAAA,EACjD;AAAA,EAEA,MAAM,YAA2B;AAC/B,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,UAAU;AAAA,EAChC;AAAA,EAEA,MAAM,YAA2B;AAC/B,UAAM,KAAK,YAAY;AACvB,WAAO,KAAK,QAAQ,YAAY,KAAK,KAAK,QAAQ,UAAU;AAAA,EAC9D;AAAA,EAEA,MAAM,oBACJ,IACA,YACA,MACe;AACf,UAAM,KAAK,YAAY;AACvB,QAAI,CAAC,KAAK,QAAQ,qBAAqB;AACrC,YAAM,IAAI,MAAM,sEAAsE;AAAA,IACxF;AACA,WAAO,KAAK,QAAQ,oBAAoB,IAAI,YAAY,IAAI;AAAA,EAC9D;AAAA,EAEA,MAAM,SAAS,WAAsC;AACnD,UAAM,MAAM,KAAK,WAAW,KAAK,YAAY;AAC3C,UAAI,gBAAgB,KAAK,cAAc,SAAS,EAAG;AACnD,UAAI,KAAK,SAAU,OAAM,IAAI,MAAM,yCAAyC;AAC5E,YAAM,gBAAgB,KAAK;AAC3B,WAAK,gBAAgB;AACrB,WAAK,gBAAgB;AACrB,WAAK,QAAQ,UAAU;AACvB,WAAK,eAAe;AACpB,WAAK,UAAU,KAAK,cAAc,SAAS;AAC3C,WAAK,OAAO,KAAK,OAAO;AACxB,YAAM,KAAK,QAAQ,gBAAgB,WAAW,aAAa;AAC3D,WAAK,OAAO,KAAK,cAAc;AAC/B,WAAK,OAAO,KAAK,aAAa;AAC9B,WAAK,OAAO,KAAK,aAAa;AAAA,IAChC,CAAC;AACD,SAAK,aAAa,IAAI,MAAM,MAAM,MAAS;AAC3C,WAAO;AAAA,EACT;AAAA,EAEA,eAAe,UAAkC;AAC/C,SAAK,eAAe,IAAI,QAAQ;AAChC,WAAO,MAAM,KAAK,eAAe,OAAO,QAAQ;AAAA,EAClD;AAAA,EAEA,MAAM,eAAgC;AACpC,UAAM,KAAK,YAAY;AACvB,WAAO,YAAY,KAAK,OAAO;AAAA,EACjC;AAAA,EAEA,UAAgB;AACd,SAAK,WAAW;AAChB,SAAK,gBAAgB;AACrB,SAAK,gBAAgB;AACrB,SAAK,QAAQ,UAAU;AACvB,SAAK,eAAe,MAAM;AAC1B,SAAK,cAAc,MAAM;AACzB,SAAK,cAAc,MAAM;AAAA,EAC3B;AAAA,EAEQ,cAAc,OAAyD;AAC7E,UAAM,QAAQ,KAAK,QAAQ,QACvB,QACE,2BAA2B,KAAK,QAAQ,OAAO,KAAK,IACpD,KAAK,QAAQ,QACf,4BAAmC,EAAE,KAAK,KAAK,QAAQ,KAAK,cAAc,KAAK,QAAQ,cAAc,MAAM,CAAC;AAChH,UAAM,QACJ,KAAK,QAAQ,SAAS,QAAQ,IAAI,uBAAuB,KAAK,QAAQ,OAAO,KAAK,IAAI,KAAK,QAAQ;AACrG,UAAM,SAAS,0BAA0B,KAAK,SAAS,KAAK;AAC5D,WAAO,IAAI,mBAA0B;AAAA,MACnC,GAAG,KAAK;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,OAAO,SAA0C;AACvD,SAAK,kBAAkB,QAAQ,YAAY,MAAM,KAAK,OAAO,KAAK,aAAa,CAAC,MAAM,MAAM;AAC5F,SAAK,kBAAkB,QAAQ,cAAc,MAAM,KAAK,OAAO,KAAK,aAAa,CAAC;AAAA,EACpF;AAAA,EAEA,MAAc,cAA6B;AACzC,QAAI,CAAC,KAAK,QAAQ,SAAU;AAC5B,UAAM,KAAK,SAAS,MAAM,KAAK,QAAQ,SAAS,CAAC;AAAA,EACnD;AAAA,EAEQ,OAAO,WAAkC;AAC/C,eAAW,YAAY,UAAW,UAAS;AAAA,EAC7C;AACF;AAEA,SAAS,0BACP,SACA,OACyB;AACzB,QAAM,OAAO,QAAQ,UAAU;AAC/B,SAAO;AAAA,IACL,MAAM,OAAO,cAAc;AACzB,UAAI;AACF,cAAM,QAAQ,MAAM,QAAQ,aAAa;AACzC,eAAO,MAAM,QAAQ,UAAU,KAAK,WAAW,EAAE,OAAO,OAAO,UAAU,CAAC;AAAA,MAC5E,SAAS,OAAO;AACd,eAAO,kBAAkB,OAAO,SAAS,EAAE,WAAW,MAAM,CAAC;AAAA,MAC/D;AAAA,IACF;AAAA,IACA,MAAM,OACF,YAAY;AACV,UAAI;AACF,cAAM,QAAQ,MAAM,QAAQ,aAAa;AACzC,eAAO,MAAM,KAAK,EAAE,OAAO,MAAM,CAAC;AAAA,MACpC,SAAS,OAAO;AACd,eAAO,kBAAkB,OAAO,SAAS,EAAE,MAAM,CAAC;AAAA,MACpD;AAAA,IACF,IACA;AAAA,EACN;AACF;AAEA,eAAe,kBACb,OACA,SACA,SACgB;AAChB,QAAM,SAAS,cAAc,KAAK;AAClC,MAAI,CAAC,OAAQ,OAAM;AACnB,QAAM,QACJ,iBAAiB,oBACb,QACA,IAAI,kBAAuB,QAAQ,EAAE,WAAW,QAAQ,WAAW,OAAO,QAAQ,OAAO,MAAM,CAAC;AACtG,QAAM,QAAQ,cAAc,OAAO,OAAO;AAC1C,QAAM,QAAQ,mBAAmB,OAAO,OAAO;AAC/C,QAAM;AACR;AAEA,SAAS,cAAc,OAAgD;AACrE,MAAI,iBAAiB,kBAAwB,QAAO,MAAM;AAC1D,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,MAAI,UAAU,WAAW,OAAO,UAAU,WAAW,IAAK,QAAO,UAAU;AAC3E,MAAI,UAAU,UAAU,WAAW,OAAO,UAAU,UAAU,WAAW,IAAK,QAAO,UAAU,SAAS;AACxG,SAAO,UAAU,QAAQ,cAAc,UAAU,KAAK,IAAI;AAC5D;;;AC5SO,IAAM,0BAA6C;AAAA,EACxD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;AAKO,SAAS,oBACd,QAA8B,CAAC,GAC/B,UAA8C,CAAC,GAC9B;AACjB,QAAM,SAAS,EAAE,GAAG,yBAAyB,GAAG,QAAQ,OAAO;AAC/D,QAAM,SAAS,IAAI,gBAAgB;AACnC,QAAM,SAAS,MAAM,QAAQ,OAAO,KAAK;AACzC,MAAI,OAAQ,QAAO,IAAI,OAAO,QAAQ,MAAM;AAC5C,aAAW,OAAO,MAAM,QAAQ,CAAC,GAAG;AAClC,UAAM,aAAa,IAAI,KAAK;AAC5B,QAAI,WAAY,QAAO,OAAO,OAAO,MAAM,UAAU;AAAA,EACvD;AACA,MAAI,MAAM,MAAM,GAAI,QAAO,IAAI,OAAO,MAAM,GAAG,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,aAAa,MAAM,EAAE;AAChG,QAAM,OAAO,MAAM,YAAY;AAC/B,MAAI,SAAS,UAAa,OAAO,SAAS,IAAI,KAAK,OAAO,EAAG,QAAO,IAAI,OAAO,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC;AAC7G,SAAO;AACT;AAGO,SAAS,oBACd,OACA,UAA8C,CAAC,GACjC;AACd,QAAM,SAAS,EAAE,GAAG,yBAAyB,GAAG,QAAQ,OAAO;AAC/D,QAAM,eAAe,iBAAiB,kBAAkB,QAAQ,IAAI,IAAI,OAAO,wBAAwB,EAAE;AACzG,QAAM,SAAS,aAAa,IAAI,OAAO,MAAM,GAAG,KAAK;AACrD,QAAM,OAAO;AAAA,IACX,GAAG,IAAI;AAAA,MACL,aACG,OAAO,OAAO,IAAI,EAClB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,EACvB,OAAO,OAAO;AAAA,IACnB;AAAA,EACF;AACA,QAAM,YAAY,aAAa,IAAI,OAAO,IAAI,GAAG,MAAM,GAAG;AAC1D,QAAM,OACJ,YAAY,CAAC,MAAM,aAAa,YAAY,CAAC,MAAM,cAC/C;AAAA,IACE,IAAI,UAAU,CAAC;AAAA,IACf,WAAW,UAAU,CAAC,MAAM,QAAS,QAAmB;AAAA,EAC1D,IACA;AACN,QAAM,UAAU,OAAO,aAAa,IAAI,OAAO,IAAI,CAAC;AACpD,QAAM,OAAO,OAAO,UAAU,OAAO,KAAK,UAAU,IAAI,UAAU;AAClE,SAAO;AAAA,IACL,GAAI,SAAS,EAAE,QAAQ,EAAE,OAAO,OAAO,EAAE,IAAI,CAAC;AAAA,IAC9C,GAAI,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA,IAClC,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACvB,GAAI,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC;AAAA,EACzC;AACF;AAEO,SAAS,uBACd,QAA8B,CAAC,GAC/B,UAA8C,CAAC,GACvC;AACR,QAAM,QAAQ,oBAAoB,OAAO,OAAO,EAAE,SAAS;AAC3D,SAAO,QAAQ,IAAI,KAAK,KAAK;AAC/B;AAEO,SAAS,0BACd,OACA,OACA,UAA8C,CAAC,GACzB;AACtB,QAAM,UAAU,oBAAoB,OAAO,OAAO;AAClD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH,QAAQ,QAAQ,UAAU,MAAM;AAAA,IAChC,MAAM,QAAQ,QAAQ,MAAM;AAAA,IAC5B,MAAM,QAAQ,QAAQ,MAAM;AAAA,IAC5B,YAAY,QAAQ,aAAa,EAAE,GAAG,MAAM,YAAY,GAAG,QAAQ,WAAW,IAAI,MAAM;AAAA,EAC1F;AACF;","names":[]}

package/dist/react.d.ts

@@ -1,9 +1,10 @@
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes, MouseEvent, HTMLAttributes, ReactElement, ErrorInfo, Component, PropsWithChildren, ComponentType } from 'react';
-import { f as KeepItemMetadataRefresher, k as KeepItemRevalidator, R as RevalidateKeepItemsOptions, j as KeepItemRevalidationSummary, l as KeepListQuery, g as KeepItemResolver, I as ImportItemsOptions, a as ImportItemsResult, m as KeepStore, n as KeepStoreActions } from './store-Cgqx7_xd.js';
-export { i as KeepItemRevalidationResult, s as isKeepItemMetadataStale } from './store-Cgqx7_xd.js';
-import { m as KeepItemInput, a as KeepItem, k as KeepEventHandlers, S as StorageAdapter, c as KeepPlugin, K as KeepSchema, l as KeepInvalidItemPolicy, e as KeepChangeContext, u as KeepSyncState } from './types--YahIoEB.js';
-export { n as KeepItemStatus } from './types--YahIoEB.js';
+import { g as KeepItemMetadataRefresher, l as KeepItemRevalidator, R as RevalidateKeepItemsOptions, k as KeepItemRevalidationSummary, m as KeepListQuery, h as KeepItemResolver, c as KeepAutoRevalidationOptions, I as ImportItemsOptions, a as ImportItemsResult, n as KeepStore, o as KeepStoreActions } from './url-VhisKZCR.js';
+export { j as KeepItemRevalidationResult, q as KeepUrlParamNames, r as KeepUrlState, s as KeepUrlSyncOptions, y as isKeepItemMetadataStale } from './url-VhisKZCR.js';
+import { s as KeepItemInput, a as KeepItem, q as KeepEventHandlers, b as StorageAdapter, f as KeepPlugin, K as KeepSchema, r as KeepInvalidItemPolicy, k as KeepChangeContext, D as KeepSyncState, F as KeepUndoState } from './types-iMK12pmy.js';
+export { t as KeepItemStatus } from './types-iMK12pmy.js';
+export { K as KeepScope, S as ScopedStorageAdapter } from './scope-y_aBm363.js';
 
 type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     item: KeepItem<TMeta> | undefined;
@@ -13,6 +14,8 @@ type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     error: unknown | null;
     save: () => Promise<void>;
     remove: () => Promise<void>;
+    removeWithUndo: () => Promise<void>;
+    undo: () => Promise<void>;
     toggle: () => Promise<void>;
     updateNote: (note?: string) => Promise<void>;
     updateTags: (tags?: string[]) => Promise<void>;
@@ -36,6 +39,8 @@ type UseKeepListResult<TMeta = Record<string, unknown>> = {
     error: unknown | null;
     remove: (id: string) => Promise<void>;
     removeBatch: (ids: string[]) => Promise<void>;
+    removeWithUndo: (id: string) => Promise<void>;
+    removeBatchWithUndo: (ids: string[]) => Promise<void>;
     updateTagsBatch: (ids: string[], tags?: string[]) => Promise<void>;
     addTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
@@ -121,7 +126,8 @@ type KeepContextValue<TMeta = Record<string, unknown>> = {
     isMutating: boolean;
     error: unknown | null;
     lastChange?: KeepChangeContext<TMeta>;
-    syncState: KeepSyncState;
+    syncState: KeepSyncState<TMeta>;
+    undo: KeepUndoState;
     saveItem: (item: KeepItem<TMeta>) => Promise<void>;
     updateNote: (id: string, note?: string) => Promise<void>;
     updateTags: (id: string, tags?: string[]) => Promise<void>;
@@ -130,9 +136,13 @@ type KeepContextValue<TMeta = Record<string, unknown>> = {
     removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     removeItem: (id: string) => Promise<void>;
     removeItems: (ids: string[]) => Promise<void>;
+    removeItemWithUndo: (id: string) => Promise<void>;
+    removeItemsWithUndo: (ids: string[]) => Promise<void>;
+    undoLastRemoval: () => Promise<void>;
     clear: () => Promise<void>;
     refresh: () => Promise<void>;
     flushSync: () => Promise<void>;
+    resolveSyncConflict: (id: string, resolution: "local" | "remote" | "manual", item?: KeepItem<TMeta>) => Promise<void>;
     refreshItemMetadata: (id: string, refresh: KeepItemMetadataRefresher<TMeta>) => Promise<void>;
     revalidateItems: (revalidator?: KeepItemRevalidator<TMeta>, options?: RevalidateKeepItemsOptions<TMeta>) => Promise<KeepItemRevalidationSummary<TMeta>>;
     exportBackup: () => Promise<string>;
@@ -158,12 +168,14 @@ type KeepProviderProps<TMeta = Record<string, unknown>> = PropsWithChildren<Keep
     boundaryResetKey?: unknown;
     validateItem?: KeepItemRevalidator<TMeta>;
     resolveItem?: KeepItemResolver<TMeta>;
+    autoRevalidation?: KeepAutoRevalidationOptions<TMeta>;
+    undoTimeoutMs?: number;
 }>;
 type KeepStoreAccess<TMeta> = {
     store: KeepStore<TMeta>;
     actions: KeepStoreActions<TMeta>;
 };
-declare function KeepProvider<TMeta = Record<string, unknown>>({ storage, initialItems, onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onError, plugins, schemaVersion, schema, invalidItemPolicy, onInvalidItem, migrateMeta, fallback, onBoundaryError, boundaryResetKey, validateItem, resolveItem, children, }: KeepProviderProps<TMeta>): react.JSX.Element;
+declare function KeepProvider<TMeta = Record<string, unknown>>({ storage, initialItems, onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onUndo, onError, plugins, schemaVersion, schema, invalidItemPolicy, onInvalidItem, migrateMeta, fallback, onBoundaryError, boundaryResetKey, validateItem, resolveItem, autoRevalidation, undoTimeoutMs, children, }: KeepProviderProps<TMeta>): react.JSX.Element;
 declare function useKeepContext<TMeta = Record<string, unknown>>(): KeepContextValue<TMeta>;
 declare function useKeepStore<TMeta = Record<string, unknown>>(): KeepStoreAccess<TMeta>;
 
@@ -179,4 +191,4 @@ type KeepKit<TMeta> = {
 /** Create an app-specific, fully typed set of KeepKit components and hooks. */
 declare function createKeepKit<TMeta = Record<string, unknown>>(options?: CreateKeepKitOptions<TMeta>): KeepKit<TMeta>;
 
-export { type CreateKeepKitOptions, KeepButton, type KeepButtonItem, type KeepButtonProps, type KeepButtonState, type KeepContextValue, KeepErrorBoundary, type KeepErrorBoundaryProps, KeepItemMetadataRefresher, KeepItemResolver, KeepItemRevalidationSummary, KeepItemRevalidator, type KeepKit, KeepListQuery, KeepProvider, type KeepProviderProps, type KeepShortcutModifier, type KeepShortcutOptions, RevalidateKeepItemsOptions, type UseKeepItemResult, type UseKeepListResult, createKeepKit, useKeepContext, useKeepItem, useKeepList, useKeepShortcut, useKeepStore };
+export { type CreateKeepKitOptions, KeepAutoRevalidationOptions, KeepButton, type KeepButtonItem, type KeepButtonProps, type KeepButtonState, type KeepContextValue, KeepErrorBoundary, type KeepErrorBoundaryProps, KeepItemMetadataRefresher, KeepItemResolver, KeepItemRevalidationSummary, KeepItemRevalidator, type KeepKit, KeepListQuery, KeepProvider, type KeepProviderProps, type KeepShortcutModifier, type KeepShortcutOptions, KeepUndoState, RevalidateKeepItemsOptions, type UseKeepItemResult, type UseKeepListResult, createKeepKit, useKeepContext, useKeepItem, useKeepList, useKeepShortcut, useKeepStore };