@keepkit/core 0.11.0 → 0.12.0

package/dist/core.js

@@ -34,6 +34,7 @@ import {
   KeepStorageError,
   KeepStorageParseError,
   KeepStorageQuotaError,
+  KeepSyncAuthError,
   LocalStorageAdapter,
   LocalStorageSyncQueueAdapter,
   ScopedStorageAdapter,
@@ -43,9 +44,10 @@ import {
   createScopedStorageAdapter,
   createStorageAdapter,
   getKeepScopeKey,
+  isKeepSyncAuthError,
   isSameKeepScope,
   normalizeKeepTags
-} from "./chunk-36YIELZE.js";
+} from "./chunk-VJDO3GFH.js";
 
 // src/integrations.ts
 function createKeepInvalidationPlugin(options) {
@@ -85,6 +87,200 @@ function createKeepKitPreset(options = {}) {
 }
 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",
@@ -166,11 +362,13 @@ export {
   KeepStorageParseError,
   KeepStorageQuotaError,
   KeepStore,
+  KeepSyncAuthError,
   LocalStorageAdapter,
   LocalStorageSyncQueueAdapter,
   ScopedStorageAdapter,
   ScopedSyncQueueAdapter,
   SyncStorageAdapter,
+  createAuthenticatedSyncKit,
   createBrowserStorageAdapter,
   createKeepInvalidationPlugin,
   createKeepKitPreset,
@@ -184,6 +382,7 @@ export {
   getTagCounts,
   importItems,
   isKeepItemMetadataStale,
+  isKeepSyncAuthError,
   isSameKeepScope,
   mergeKeepItems,
   mergeKeepListQueryFromUrl,

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/integrations.ts","../src/presets.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 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":"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","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":"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","names":[]}

package/dist/react.d.ts

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes, MouseEvent, HTMLAttributes, ReactElement, ErrorInfo, Component, PropsWithChildren, ComponentType } from 'react';
-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-BYFEfulm.js';
-export { j as KeepItemRevalidationResult, q as KeepUrlParamNames, r as KeepUrlState, s as KeepUrlSyncOptions, y as isKeepItemMetadataStale } from './url-BYFEfulm.js';
-import { p as KeepItemInput, a as KeepItem, n as KeepEventHandlers, b as StorageAdapter, f as KeepPlugin, K as KeepSchema, o as KeepInvalidItemPolicy, h as KeepChangeContext, x as KeepSyncState, z as KeepUndoState } from './types-D-xRiz1Y.js';
-export { q as KeepItemStatus } from './types-D-xRiz1Y.js';
-export { K as KeepScope, S as ScopedStorageAdapter } from './scope-CtLSlZhq.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;
@@ -126,7 +126,7 @@ 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>;
@@ -142,6 +142,7 @@ type KeepContextValue<TMeta = Record<string, unknown>> = {
     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>;

package/dist/react.js

@@ -10,11 +10,10 @@ import {
 import {
   parseKeepMeta
 } from "./chunk-THZ3ACR2.js";
-import "./chunk-5QSZP6MT.js";
 import {
   createBrowserStorageAdapter,
   normalizeKeepTags
-} from "./chunk-36YIELZE.js";
+} from "./chunk-VJDO3GFH.js";
 
 // src/hooks/useKeepItem.ts
 import { useCallback as useCallback3 } from "react";
@@ -272,6 +271,16 @@ function KeepProviderContent({
     if (!storage.subscribe) return;
     return storage.subscribe(() => void refresh());
   }, [refresh, storage]);
+  useEffect(() => {
+    if (!isScopeAwareStorage(storage)) return;
+    return storage.subscribeScope(() => {
+      undoRef.current?.timer && clearTimeout(undoRef.current.timer);
+      undoRef.current = void 0;
+      itemsRef.current = [];
+      store.setState({ items: [], isHydrated: false, isLoading: true, error: null, undo: EMPTY_UNDO_STATE });
+      void refresh();
+    });
+  }, [refresh, storage, store]);
   const runMutation = useCallback(
     (action, id, createPlan) => {
       pendingMutationsRef.current += 1;
@@ -656,6 +665,15 @@ function KeepProviderContent({
     [revalidateItems]
   );
   const flushSync = useCallback(() => syncStorage ? syncStorage.flushSync() : Promise.resolve(), [syncStorage]);
+  const resolveSyncConflict = useCallback(
+    (id, resolution, item) => {
+      if (!syncStorage?.resolveSyncConflict) {
+        return Promise.reject(new Error("The configured storage does not support sync conflict resolution."));
+      }
+      return syncStorage.resolveSyncConflict(id, resolution, item);
+    },
+    [syncStorage]
+  );
   const exportBackup = useCallback(() => exportItems(storage), [storage]);
   const importBackup = useCallback(
     async (data, options = {}) => {
@@ -708,6 +726,7 @@ function KeepProviderContent({
       clear,
       refresh,
       flushSync,
+      resolveSyncConflict,
       refreshItemMetadata,
       revalidateItems,
       exportBackup,
@@ -718,6 +737,7 @@ function KeepProviderContent({
       error,
       lastChange,
       flushSync,
+      resolveSyncConflict,
       isHydrated,
       isLoading,
       isMutating,
@@ -784,12 +804,16 @@ function KeepProviderContent({
 var IDLE_SYNC_STATE = Object.freeze({
   status: "idle",
   pendingCount: 0,
-  conflictIds: []
+  conflictIds: [],
+  conflicts: []
 });
 var EMPTY_UNDO_STATE = Object.freeze({ canUndo: false, ids: [] });
 function isSyncCapableStorage(storage) {
   return "getSyncState" in storage && typeof storage.getSyncState === "function" && "subscribeSync" in storage && typeof storage.subscribeSync === "function" && "flushSync" in storage && typeof storage.flushSync === "function";
 }
+function isScopeAwareStorage(storage) {
+  return "subscribeScope" in storage && typeof storage.subscribeScope === "function";
+}
 async function parseKeepMetaItem(item, schema) {
   return { ...item, meta: await parseKeepMeta(schema, item.meta) };
 }