@keepkit/core 0.19.0 → 0.21.0

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/features/items/presets.ts","../src/features/items/url.ts","../src/features/sync/integrations.ts","../src/features/sync/templates/auth-sync.ts"],"sourcesContent":["import { createBrowserStorageAdapter } from \"../../storage/index\";\nimport { SyncStorageAdapter } from \"../../storage/sync\";\nimport { exportItems } from \"../persistence/backup\";\nimport { createScopedStorageAdapter, type KeepScope } from \"../persistence/scope\";\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","import type { KeepPlugin, KeepPluginContext } from \"../items/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 { 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 \"../../items/types\";\nimport { KeepSyncAuthError as KeepSyncAuthErrorClass } from \"../../items/types\";\nimport { exportItems } from \"../../persistence/backup\";\nimport {\n  createScopedStorageAdapter,\n  getKeepScopeKey,\n  isSameKeepScope,\n  ScopedSyncQueueAdapter,\n} from \"../../persistence/scope\";\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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/features/items/presets.ts","../src/features/items/url.ts","../src/features/sync/integrations.ts","../src/features/sync/templates/auth-sync.ts"],"sourcesContent":["import { createBrowserStorageAdapter } from \"../../storage/index\";\nimport { SyncStorageAdapter } from \"../../storage/sync\";\nimport { exportItems } from \"../persistence/backup\";\nimport { createScopedStorageAdapter, type KeepScope } from \"../persistence/scope\";\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  archived: string;\n  collection: string;\n  pinnedFirst: 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  archived: \"archived\",\n  collection: \"collection\",\n  pinnedFirst: \"pinned\",\n};\n\nexport type KeepUrlState = Pick<\n  KeepListQuery,\n  \"search\" | \"tags\" | \"sort\" | \"pagination\" | \"archived\" | \"collectionId\" | \"pinnedFirst\"\n>;\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  if (query.archived !== undefined) result.set(params.archived, query.archived ? \"true\" : \"false\");\n  if (query.collectionId) result.set(params.collection, query.collectionId);\n  if (query.pinnedFirst) result.set(params.pinnedFirst, \"true\");\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  const archivedValue = searchParams.get(params.archived);\n  const archived = archivedValue === \"true\" ? true : archivedValue === \"false\" ? false : undefined;\n  const collectionId = searchParams.get(params.collection)?.trim() || undefined;\n  const pinnedFirst = searchParams.get(params.pinnedFirst) === \"true\" ? true : undefined;\n  return {\n    ...(search ? { search: { query: search } } : {}),\n    ...(tags.length > 0 ? { tags } : {}),\n    ...(sort ? { sort } : {}),\n    ...(page ? { pagination: { page } } : {}),\n    ...(archived === undefined ? {} : { archived }),\n    ...(collectionId ? { collectionId } : {}),\n    ...(pinnedFirst ? { pinnedFirst } : {}),\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","import type { KeepPlugin, KeepPluginContext } from \"../items/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 { 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 \"../../items/types\";\nimport { KeepSyncAuthError as KeepSyncAuthErrorClass } from \"../../items/types\";\nimport { exportItems } from \"../../persistence/backup\";\nimport {\n  createScopedStorageAdapter,\n  getKeepScopeKey,\n  isSameKeepScope,\n  ScopedSyncQueueAdapter,\n} from \"../../persistence/scope\";\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"],"mappings":"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","names":[]}

package/dist/react.d.ts

@@ -1,10 +1,10 @@
-import { g as KeepItemMetadataRefresher, l as KeepItemRevalidator, h as KeepItemResolver, c as KeepAutoRevalidationOptions, R as RevalidateKeepItemsOptions, k as KeepItemRevalidationSummary, I as ImportItemsOptions, a as ImportItemsResult, o as KeepStore, p as KeepStoreActions, m as KeepListQuery, n as KeepNavigationState } from './store-Cm35R_ho.js';
-export { j as KeepItemRevalidationResult, r as KeepUrlParamNames, s as KeepUrlState, t as KeepUrlSyncOptions, A as isKeepItemMetadataStale } from './store-Cm35R_ho.js';
-import { r as KeepItemInput, K as KeepItem, p as KeepEventHandlers, a as StorageAdapter, e as KeepPlugin, t as KeepSchema, q as KeepInvalidItemPolicy, j as KeepChangeContext, D as KeepSyncState, F as KeepUndoState } from './types-Aoc0Eyvk.js';
-export { s as KeepItemStatus } from './types-Aoc0Eyvk.js';
-export { K as KeepScope, S as ScopedStorageAdapter } from './scope-Dk5FTVz8.js';
+import { g as KeepItemMetadataRefresher, l as KeepItemRevalidator, h as KeepItemResolver, c as KeepAutoRevalidationOptions, R as RevalidateKeepItemsOptions, k as KeepItemRevalidationSummary, I as ImportItemsOptions, a as ImportItemsResult, o as KeepStore, p as KeepStoreActions, m as KeepListQuery, n as KeepNavigationState } from './store-CPc-CUd2.js';
+export { j as KeepItemRevalidationResult, r as KeepUrlParamNames, s as KeepUrlState, t as KeepUrlSyncOptions, A as isKeepItemMetadataStale } from './store-CPc-CUd2.js';
+import { r as KeepItemInput, K as KeepItem, p as KeepEventHandlers, a as StorageAdapter, e as KeepPlugin, t as KeepSchema, q as KeepInvalidItemPolicy, j as KeepChangeContext, D as KeepSyncState, F as KeepUndoState } from './types-6ex9EBjM.js';
+export { s as KeepItemStatus } from './types-6ex9EBjM.js';
+export { K as KeepScope, S as ScopedStorageAdapter } from './scope-kVcPskvM.js';
 import * as react from 'react';
-import { ReactNode, ButtonHTMLAttributes, MouseEvent, HTMLAttributes, ReactElement, ErrorInfo, Component, PropsWithChildren, ComponentType } from 'react';
+import { ReactNode, Ref, ButtonHTMLAttributes, MouseEvent, HTMLAttributes, ReactElement, ErrorInfo, Component, PropsWithChildren, ComponentType } from 'react';
 
 type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     item: KeepItem<TMeta> | undefined;
@@ -19,6 +19,13 @@ type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     toggle: () => Promise<void>;
     updateNote: (note?: string) => Promise<void>;
     updateTags: (tags?: string[]) => Promise<void>;
+    toggleArchive: () => Promise<void>;
+    archiveItem: () => Promise<void>;
+    unarchiveItem: () => Promise<void>;
+    archive: () => Promise<void>;
+    unarchive: () => Promise<void>;
+    togglePin: () => Promise<void>;
+    moveToCollection: (collectionId?: string) => Promise<void>;
     refreshMetadata: (refresh: KeepItemMetadataRefresher<TMeta>) => Promise<void>;
 };
 /** Read and mutate one saved item from its complete minimal input description. */
@@ -35,6 +42,9 @@ type KeepButtonSharedProps<TMeta> = {
     getAriaLabel?: (state: KeepButtonState<TMeta>) => string;
     disabled?: boolean;
     onToggleError?: (error: unknown) => void;
+    ref?: Ref<HTMLElement> | {
+        readonly current: unknown;
+    };
 };
 type KeepButtonProps<TMeta = Record<string, unknown>> = KeepButtonSharedProps<TMeta> & ((Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "onClick" | "aria-pressed"> & {
     asChild?: false;
@@ -57,7 +67,7 @@ type KeepButtonState<TMeta = Record<string, unknown>> = {
     updateTags: (tags?: string[]) => Promise<void>;
 };
 /** A style-free accessible save toggle. Consumers provide all visual styling. */
-declare function KeepButton<TMeta = Record<string, unknown>>({ item, children, savedLabel, unsavedLabel, savedAriaLabel, unsavedAriaLabel, getAriaLabel, asChild, onToggleError, onClick, disabled, ...buttonProps }: KeepButtonProps<TMeta>): react.JSX.Element;
+declare function KeepButton<TMeta = Record<string, unknown>>({ item, children, savedLabel, unsavedLabel, savedAriaLabel, unsavedAriaLabel, getAriaLabel, asChild, onToggleError, onClick, disabled, ref: providedRef, ...buttonProps }: KeepButtonProps<TMeta>): react.JSX.Element;
 
 type KeepErrorBoundaryProps = {
     children?: ReactNode;
@@ -90,6 +100,11 @@ type KeepContextValue<TMeta = Record<string, unknown>> = {
     saveItem: (item: KeepItem<TMeta>) => Promise<void>;
     updateNote: (id: string, note?: string) => Promise<void>;
     updateTags: (id: string, tags?: string[]) => Promise<void>;
+    toggleArchive: (id: string) => Promise<void>;
+    archiveItem: (id: string) => Promise<void>;
+    unarchiveItem: (id: string) => Promise<void>;
+    togglePin: (id: string) => Promise<void>;
+    moveToCollection: (id: string, collectionId?: string) => Promise<void>;
     updateTagsBatch: (ids: string[], tags?: string[]) => Promise<void>;
     addTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
@@ -158,6 +173,13 @@ type UseKeepListResult<TMeta = Record<string, unknown>> = {
     removeWithUndo: (id: string) => Promise<void>;
     removeBatchWithUndo: (ids: string[]) => Promise<void>;
     updateTagsBatch: (ids: string[], tags?: string[]) => Promise<void>;
+    toggleArchive: (id: string) => Promise<void>;
+    archiveItem: (id: string) => Promise<void>;
+    unarchiveItem: (id: string) => Promise<void>;
+    archive: (id: string) => Promise<void>;
+    unarchive: (id: string) => Promise<void>;
+    togglePin: (id: string) => Promise<void>;
+    moveToCollection: (id: string, collectionId?: string) => Promise<void>;
     addTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     reorder: (orderedIds: string[]) => Promise<void>;

package/dist/react.js

@@ -10,14 +10,14 @@ import {
   queryKeepItems,
   reorderKeepItems,
   revalidateKeepItems
-} from "./chunk-62I2YZYI.js";
+} from "./chunk-RSXYXT5D.js";
 import {
   parseKeepMeta
 } from "./chunk-5W4QSJHV.js";
 import {
   createBrowserStorageAdapter,
   normalizeKeepTags
-} from "./chunk-PNP7OALR.js";
+} from "./chunk-XUHRDJD6.js";
 
 // src/react/components/KeepButton.tsx
 import {
@@ -447,6 +447,66 @@ function KeepProviderContent({
     },
     [runMutation, storage]
   );
+  const setArchive = useCallback(
+    async (id, archived) => {
+      await runMutation("archive", id, (previous) => {
+        const current = previous.find((item) => item.id === id);
+        if (!current) return void 0;
+        const next = { ...current, archived, updatedAt: Date.now() };
+        return {
+          next: previous.map((item) => item.id === id ? next : item),
+          persist: () => storage.set(next),
+          pluginContext: { action: "archive", id, item: next }
+        };
+      });
+    },
+    [runMutation, storage]
+  );
+  const toggleArchive = useCallback(
+    (id) => {
+      const item = itemsRef.current.find((current) => current.id === id);
+      return setArchive(id, item?.archived !== true);
+    },
+    [setArchive]
+  );
+  const archiveItem = useCallback((id) => setArchive(id, true), [setArchive]);
+  const unarchiveItem = useCallback((id) => setArchive(id, false), [setArchive]);
+  const togglePin = useCallback(
+    async (id) => {
+      await runMutation("pin", id, (previous) => {
+        const current = previous.find((item) => item.id === id);
+        if (!current) return void 0;
+        const next = { ...current, pinned: current.pinned !== true, updatedAt: Date.now() };
+        return {
+          next: previous.map((item) => item.id === id ? next : item),
+          persist: () => storage.set(next),
+          pluginContext: { action: "pin", id, item: next }
+        };
+      });
+    },
+    [runMutation, storage]
+  );
+  const moveToCollection = useCallback(
+    async (id, collectionId) => {
+      const nextCollectionId = collectionId?.trim() || void 0;
+      await runMutation("collection", id, (previous) => {
+        const current = previous.find((item) => item.id === id);
+        if (!current) return void 0;
+        const { collectionId: _oldCollectionId, ...withoutCollection } = current;
+        const next = {
+          ...withoutCollection,
+          ...nextCollectionId ? { collectionId: nextCollectionId } : {},
+          updatedAt: Date.now()
+        };
+        return {
+          next: previous.map((item) => item.id === id ? next : item),
+          persist: () => storage.set(next),
+          pluginContext: { action: "collection", id, item: next }
+        };
+      });
+    },
+    [runMutation, storage]
+  );
   const updateTagsBatch = useCallback(
     async (ids, tags) => {
       const idSet = new Set(ids);
@@ -787,6 +847,11 @@ function KeepProviderContent({
       saveItem,
       updateNote,
       updateTags,
+      toggleArchive,
+      archiveItem,
+      unarchiveItem,
+      togglePin,
+      moveToCollection,
       updateTagsBatch,
       addTagsBatch,
       removeTagsBatch,
@@ -826,6 +891,11 @@ function KeepProviderContent({
       undoLastRemoval,
       updateNote,
       updateTags,
+      toggleArchive,
+      archiveItem,
+      unarchiveItem,
+      togglePin,
+      moveToCollection,
       updateTagsBatch,
       addTagsBatch,
       removeTagsBatch,
@@ -843,6 +913,11 @@ function KeepProviderContent({
       saveItem,
       updateNote,
       updateTags,
+      toggleArchive,
+      archiveItem,
+      unarchiveItem,
+      togglePin,
+      moveToCollection,
       updateTagsBatch,
       addTagsBatch,
       removeTagsBatch,
@@ -868,6 +943,11 @@ function KeepProviderContent({
       saveItem,
       updateNote,
       updateTags,
+      toggleArchive,
+      archiveItem,
+      unarchiveItem,
+      togglePin,
+      moveToCollection,
       updateTagsBatch,
       refreshItemMetadata,
       revalidateItems,
@@ -969,6 +1049,14 @@ function useKeepItem(input) {
   const toggle = useCallback3(() => item ? remove() : save(), [item, remove, save]);
   const updateNote = useCallback3((note) => actions.updateNote(id, note), [actions, id]);
   const updateTags = useCallback3((tags) => actions.updateTags(id, tags), [actions, id]);
+  const toggleArchive = useCallback3(() => actions.toggleArchive(id), [actions, id]);
+  const archive = useCallback3(() => actions.archiveItem(id), [actions, id]);
+  const unarchive = useCallback3(() => actions.unarchiveItem(id), [actions, id]);
+  const togglePin = useCallback3(() => actions.togglePin(id), [actions, id]);
+  const moveToCollection = useCallback3(
+    (collectionId) => actions.moveToCollection(id, collectionId),
+    [actions, id]
+  );
   const refreshMetadata = useCallback3(
     (refresh) => actions.refreshItemMetadata(id, refresh),
     [actions, id]
@@ -986,6 +1074,13 @@ function useKeepItem(input) {
     toggle,
     updateNote,
     updateTags,
+    toggleArchive,
+    archiveItem: archive,
+    unarchiveItem: unarchive,
+    archive,
+    unarchive,
+    togglePin,
+    moveToCollection,
     refreshMetadata
   };
 }
@@ -1004,6 +1099,7 @@ function KeepButton({
   onToggleError,
   onClick,
   disabled,
+  ref: providedRef,
   ...buttonProps
 }) {
   const state = useKeepItem(item);
@@ -1047,6 +1143,7 @@ function KeepButton({
   if (asChild && !isValidElement(child)) {
     throw new Error("KeepButton with asChild requires a single React element child.");
   }
+  const childRef = asChild && isValidElement(child) ? child.props.ref : void 0;
   const commonProps = {
     ...buttonProps,
     "aria-pressed": isSaved,
@@ -1060,12 +1157,29 @@ function KeepButton({
       tabIndex: isDisabled ? -1 : buttonProps.tabIndex ?? 0
     } : { disabled: isDisabled },
     onClick: handleElementClick,
-    onKeyDown: handleKeyDown
+    onKeyDown: handleKeyDown,
+    ...asChild ? { ref: composeRefs(childRef, providedRef) } : {}
   };
   if (asChild) {
     return cloneElement(child, commonProps);
   }
-  return /* @__PURE__ */ jsx2("button", { ...commonProps, type: "type" in buttonProps ? buttonProps.type ?? "button" : "button", children: content });
+  return /* @__PURE__ */ jsx2(
+    "button",
+    {
+      ...commonProps,
+      ref: providedRef,
+      type: "type" in buttonProps ? buttonProps.type ?? "button" : "button",
+      children: content
+    }
+  );
+}
+function composeRefs(...refs) {
+  return (value) => {
+    for (const ref of refs) {
+      if (typeof ref === "function") ref(value);
+      else if (ref) ref.current = value;
+    }
+  };
 }
 function getAccessibleLabel(isSaved, item, asChild) {
   if (!asChild) return isSaved ? "Remove saved item" : "Save item";
@@ -1083,10 +1197,10 @@ function getMetaTitle(meta) {
 import { useCallback as useCallback4, useMemo as useMemo2 } from "react";
 function useKeepList(query = {}) {
   const { store, actions } = useKeepStore();
-  const { filter, pagination, savedBetween, search, sort, tags, targetType } = query;
+  const { archived, collectionId, filter, pagination, pinnedFirst, savedBetween, search, sort, tags, targetType } = query;
   const queryOptions = useMemo2(
-    () => ({ filter, pagination, savedBetween, search, sort, tags, targetType }),
-    [filter, pagination, savedBetween, search, sort, tags, targetType]
+    () => ({ archived, collectionId, filter, pagination, pinnedFirst, savedBetween, search, sort, tags, targetType }),
+    [archived, collectionId, filter, pagination, pinnedFirst, savedBetween, search, sort, tags, targetType]
   );
   const selector = useMemo2(() => {
     let previousResult;
@@ -1140,6 +1254,14 @@ function useKeepList(query = {}) {
     (ids, nextTags) => actions.removeTagsBatch(ids, nextTags),
     [actions]
   );
+  const toggleArchive = useCallback4((id) => actions.toggleArchive(id), [actions]);
+  const archive = useCallback4((id) => actions.archiveItem(id), [actions]);
+  const unarchive = useCallback4((id) => actions.unarchiveItem(id), [actions]);
+  const togglePin = useCallback4((id) => actions.togglePin(id), [actions]);
+  const moveToCollection = useCallback4(
+    (id, collectionId2) => actions.moveToCollection(id, collectionId2),
+    [actions]
+  );
   return {
     items: result.items,
     totalCount: result.totalCount,
@@ -1160,6 +1282,13 @@ function useKeepList(query = {}) {
     updateTagsBatch,
     addTagsBatch,
     removeTagsBatch,
+    toggleArchive,
+    archiveItem: archive,
+    unarchiveItem: unarchive,
+    archive,
+    unarchive,
+    togglePin,
+    moveToCollection,
     reorder: actions.reorderItems,
     move: actions.moveItem,
     clear: actions.clear,