@keepkit/core 0.1.0 → 0.3.0

package/README.md

@@ -7,7 +7,8 @@
 Reactアプリケーション向けの、ヘッドレスで非同期処理を前提とした保存・コレクション用プリミティブです。
 
 ```tsx
-import { KeepButton, KeepProvider, LocalStorageAdapter } from "@keepkit/core";
+import { LocalStorageAdapter } from "@keepkit/core/storage";
+import { KeepButton, KeepProvider } from "@keepkit/core/react";
 
 const storage = new LocalStorageAdapter({ key: "my-app:items" });
 
@@ -26,6 +27,8 @@ const storage = new LocalStorageAdapter({ key: "my-app:items" });
 
 `exportItems(adapter)` / `importItems(adapter, json, { mode: "replace" | "merge" })` でversion付きJSONバックアップを扱えます。結果には `imported` / `failed` 件数が含まれます。
 
+`KeepButton` の標準ARIAラベルは `savedAriaLabel` / `unsavedAriaLabel` または `getAriaLabel` で多言語化できます。`useKeepItem(id).refreshMetadata` と `isKeepItemMetadataStale` はメタデータの再取得に使えます。`useKeepList().revalidate` または `useKeepContext().revalidateItems` は削除・非公開・期限切れの対象を検出します。検出した状態を整理する場合は `removeStatuses` を明示してください。
+
 大規模アプリでは `SyncStorageAdapter` を使ってローカル保存とリモート同期を分離できます。`IndexedDBSyncQueueAdapter`（既定）または `LocalStorageSyncQueueAdapter` に操作を永続化し、オンライン復帰時に `flushSync()` で再送します。`KeepProvider` の `syncState` で `pending` / `syncing` / `conflict` / `error` を取得できます。
 
 ```tsx
@@ -49,6 +52,10 @@ const storage = new SyncStorageAdapter({
 
 `useKeepList` は `savedBetween`、`search: { query, mode: "and" | "or" }`、`filterFn`、`tagCounts` をサポートします。TanStack Query や SWR のキャッシュ連携には、依存関係を core に追加しない `createKeepInvalidationPlugin` を利用できます。
 
+サーバーで取得した一覧を初期表示に使う場合は `KeepProvider initialItems={itemsFromServer}` を指定できます。クライアント adapter の初回読み込み中も同じスナップショットを描画し、refresh 完了後は adapter の値に更新されます。Reactを使わない環境やRSCのサーバー側コードでは `@keepkit/core/core`、React binding は `@keepkit/core/react`、ストレージは `@keepkit/core/storage`、スキーマ処理は `@keepkit/core/schema` からimportできます。
+
+ブラウザの制限環境では `createBrowserStorageAdapter` が IndexedDB を優先し、アクセスできない場合は `LocalStorageAdapter` に切り替えます。自前の主／代替 adapter を組み合わせる場合は `FallbackStorageAdapter` を利用できます。`useKeepShortcut({ key: "k", modifier: "meta", id, itemPayload })` は編集可能なフィールドを除外して保存操作をキーボードに割り当てます。`asChild` の `KeepButton` には `aria-pressed`、`aria-disabled`、button role、Space／Enter 操作が自動で付与されます。
+
 詳細な使い方と開発コマンドは [ルートREADME](../../README.md) を、現在の変更内容は [リリースノート](../../RELEASE_NOTES.md) を参照してください。
 
 ## English
@@ -56,7 +63,8 @@ const storage = new SyncStorageAdapter({
 Headless, async-first save-and-collect primitives for React applications.
 
 ```tsx
-import { KeepButton, KeepProvider, LocalStorageAdapter } from "@keepkit/core";
+import { LocalStorageAdapter } from "@keepkit/core/storage";
+import { KeepButton, KeepProvider } from "@keepkit/core/react";
 
 const storage = new LocalStorageAdapter({ key: "my-app:items" });
 
@@ -75,8 +83,14 @@ Use `useKeepItem(id, payload)` for saving, toggling, removing, and updating note
 
 Use `exportItems(adapter)` and `importItems(adapter, json, { mode: "replace" | "merge" })` for versioned JSON backups. Results include imported and failed counts.
 
+Localize the default `KeepButton` ARIA label with `savedAriaLabel` / `unsavedAriaLabel` or `getAriaLabel`. `useKeepItem(id).refreshMetadata` and `isKeepItemMetadataStale` fetch current metadata, while `useKeepList().revalidate` or `useKeepContext().revalidateItems` detects deleted, private, and expired targets. Pass `removeStatuses` explicitly when detected records should be cleaned up.
+
 For larger applications, wrap a local adapter with `SyncStorageAdapter` to persist a durable offline queue and flush it with `flushSync()` when connectivity returns. Use `syncState` from `KeepProvider` for `pending`, `syncing`, `conflict`, and `error` feedback. `KeepProvider` also accepts a Zod-like `parse`, `safeParse`, or Standard Schema validator through `schema`; invalid stored records can be rejected or dropped with `invalidItemPolicy`.
 
 `useKeepList` supports `savedBetween`, tokenized `search` with `and` / `or` modes, `filterFn`, and `tagCounts`. Use `createKeepInvalidationPlugin` to connect TanStack Query, SWR, or another cache without adding framework dependencies to core.
 
+Pass a server-loaded list as `KeepProvider initialItems={itemsFromServer}` when the initial client render should use the same snapshot while storage hydrates. The first refresh then updates the state from the adapter. Framework-neutral and RSC server code can import `@keepkit/core/core`; React bindings, storage, and schema helpers are also available from `@keepkit/core/react`, `@keepkit/core/storage`, and `@keepkit/core/schema` respectively.
+
+In restricted browser environments, `createBrowserStorageAdapter` prefers IndexedDB and switches to `LocalStorageAdapter` when IndexedDB cannot be accessed. Use `FallbackStorageAdapter` to compose your own primary and fallback adapters. `useKeepShortcut({ key: "k", modifier: "meta", id, itemPayload })` binds a save action while ignoring editable fields. `KeepButton asChild` automatically supplies `aria-pressed`, `aria-disabled`, a button role, and Space/Enter activation.
+
 See the [root README](../../README.md) for detailed usage and development commands, and the [release notes](../../RELEASE_NOTES.md) for the current changes.

package/dist/chunk-5QSZP6MT.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-5QSZP6MT.js.map

package/dist/chunk-5QSZP6MT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-J7NKIOXV.js

@@ -0,0 +1,142 @@
+// src/query.ts
+function queryKeepItems(source, options = {}) {
+  const filtered = source.filter((item) => {
+    const [from, to] = options.savedBetween ?? [];
+    const savedAt = item.savedAt;
+    const lowerBound = from === void 0 ? void 0 : toTimestamp(from);
+    const upperBound = to === void 0 ? void 0 : toTimestamp(to);
+    return (options.targetType === void 0 || item.targetType === options.targetType) && (options.tag === void 0 || item.tags?.includes(options.tag) === true) && (options.tags === void 0 || options.tags.every((tag) => item.tags?.includes(tag))) && (lowerBound === void 0 || savedAt >= lowerBound) && (upperBound === void 0 || savedAt <= upperBound) && matchesSearch(item, options.searchQuery, options.search) && (options.filter?.(item) ?? true) && (options.filterFn?.(item) ?? true);
+  });
+  const tagCounts = getTagCounts(filtered);
+  const sortBy = options.sortBy ?? options.sort?.by;
+  const direction = (options.order ?? options.sort?.direction) === "asc" ? 1 : -1;
+  const sorted = sortBy ? [...filtered].sort((a, b) => (a[sortBy] - b[sortBy]) * direction) : filtered;
+  const offset = Math.max(0, options.offset ?? 0);
+  const items = options.limit === void 0 ? sorted.slice(offset) : sorted.slice(offset, offset + Math.max(0, options.limit));
+  return { items, totalCount: sorted.length, tagCounts };
+}
+function getTagCounts(items) {
+  const counts = {};
+  for (const item of items) {
+    for (const tag of item.tags ?? []) counts[tag] = (counts[tag] ?? 0) + 1;
+  }
+  return Object.fromEntries(Object.entries(counts).sort(([a], [b]) => a.localeCompare(b)));
+}
+function matchesSearch(item, searchQuery, search) {
+  const query = search?.query ?? searchQuery;
+  if (!query?.trim()) return true;
+  const fields = search?.fields ?? ["note", "meta", "tags"];
+  const values = fields.map((field) => {
+    if (field === "note") return item.note ?? "";
+    if (field === "tags") return (item.tags ?? []).join(" ");
+    try {
+      return JSON.stringify(item.meta) ?? "";
+    } catch {
+      return String(item.meta);
+    }
+  });
+  const text = values.join(" ").toLocaleLowerCase();
+  if (!search) return text.includes(query.trim().toLocaleLowerCase());
+  const normalized = query.trim().toLocaleLowerCase();
+  const needles = search.tokenize === false ? [normalized] : normalized.split(/\s+/).filter(Boolean);
+  const matches = needles.map((needle) => text.includes(needle));
+  return search.mode === "or" ? matches.some(Boolean) : matches.every(Boolean);
+}
+function toTimestamp(value) {
+  return value instanceof Date ? value.getTime() : value;
+}
+
+// src/revalidation.ts
+function isKeepItemMetadataStale(item, maxAgeMs, now = Date.now) {
+  return item.metaUpdatedAt === void 0 || now() - item.metaUpdatedAt >= maxAgeMs;
+}
+async function revalidateKeepItems(source, revalidator, options = {}) {
+  const removeStatuses = new Set(options.removeStatuses ?? []);
+  const now = options.now ?? Date.now;
+  const items = [];
+  const updatedItems = [];
+  const removedIds = [];
+  const results = [];
+  for (const item of source) {
+    const rawResult = await revalidator(item);
+    const result = typeof rawResult === "string" ? { status: rawResult } : rawResult;
+    if (result.status === "available") {
+      const timestamp = now();
+      const updated = result.meta === void 0 ? item : { ...item, meta: result.meta, metaUpdatedAt: timestamp, updatedAt: timestamp };
+      const didUpdate = updated !== item;
+      items.push(updated);
+      if (didUpdate) updatedItems.push(updated);
+      results.push({ item: updated, status: "available", updated: didUpdate });
+      continue;
+    }
+    const shouldRemove = removeStatuses.has(result.status);
+    if (shouldRemove) removedIds.push(item.id);
+    else items.push(item);
+    results.push({ item, status: result.status, reason: result.reason, updated: false });
+  }
+  return {
+    items,
+    checked: source.length,
+    updated: updatedItems.length,
+    removed: removedIds.length,
+    updatedItems,
+    removedIds,
+    results
+  };
+}
+async function reconcileKeepItems(storage, revalidator, options = {}) {
+  const source = await storage.getAll();
+  const summary = await revalidateKeepItems(source, revalidator, options);
+  if (summary.updatedItems.length > 0) await persistItems(storage, summary.updatedItems);
+  if (summary.removedIds.length > 0) await removeItems(storage, summary.removedIds);
+  return summary;
+}
+async function persistItems(storage, items) {
+  if (storage.setMany) {
+    await storage.setMany(items);
+    return;
+  }
+  for (const item of items) await storage.set(item);
+}
+async function removeItems(storage, ids) {
+  if (storage.removeMany) {
+    await storage.removeMany(ids);
+    return;
+  }
+  for (const id of ids) await storage.remove(id);
+}
+
+// src/store.ts
+var KeepStore = class {
+  constructor(initialState) {
+    this.listeners = /* @__PURE__ */ new Set();
+    this.getSnapshot = () => this.state;
+    this.subscribe = (listener) => {
+      this.listeners.add(listener);
+      return () => this.listeners.delete(listener);
+    };
+    this.state = initialState;
+  }
+  setState(next) {
+    let changed = false;
+    for (const key of Object.keys(next)) {
+      if (!Object.is(this.state[key], next[key])) {
+        changed = true;
+        break;
+      }
+    }
+    if (!changed) return;
+    this.state = { ...this.state, ...next };
+    for (const listener of this.listeners) listener();
+  }
+};
+
+export {
+  queryKeepItems,
+  getTagCounts,
+  isKeepItemMetadataStale,
+  revalidateKeepItems,
+  reconcileKeepItems,
+  KeepStore
+};
+//# sourceMappingURL=chunk-J7NKIOXV.js.map

package/dist/chunk-J7NKIOXV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query.ts","../src/revalidation.ts","../src/store.ts"],"sourcesContent":["import type { KeepItem } from \"./types\";\n\nexport type KeepListOptions<TMeta = Record<string, unknown>> = {\n  targetType?: string;\n  tag?: string;\n  tags?: string[];\n  sort?: {\n    by: \"savedAt\" | \"updatedAt\";\n    direction?: \"asc\" | \"desc\";\n  };\n  searchQuery?: string;\n  search?: {\n    query: string;\n    mode?: \"and\" | \"or\";\n    tokenize?: boolean;\n    fields?: Array<\"note\" | \"meta\" | \"tags\">;\n  };\n  sortBy?: \"savedAt\" | \"updatedAt\";\n  order?: \"asc\" | \"desc\";\n  limit?: number;\n  offset?: number;\n  filter?: (item: KeepItem<TMeta>) => boolean;\n  filterFn?: (item: KeepItem<TMeta>) => boolean;\n  savedBetween?: readonly [Date | number, Date | number];\n};\n\nexport type QueryKeepItemsResult<TMeta = Record<string, unknown>> = {\n  items: KeepItem<TMeta>[];\n  totalCount: number;\n  tagCounts: Record<string, number>;\n};\n\n/** Apply the same filtering and pagination rules as useKeepList without React. */\nexport function queryKeepItems<TMeta = Record<string, unknown>>(\n  source: KeepItem<TMeta>[],\n  options: KeepListOptions<TMeta> = {},\n): QueryKeepItemsResult<TMeta> {\n  const filtered = source.filter((item) => {\n    const [from, to] = options.savedBetween ?? [];\n    const savedAt = item.savedAt;\n    const lowerBound = from === undefined ? undefined : toTimestamp(from);\n    const upperBound = to === undefined ? undefined : toTimestamp(to);\n    return (\n      (options.targetType === undefined || item.targetType === options.targetType) &&\n      (options.tag === undefined || item.tags?.includes(options.tag) === true) &&\n      (options.tags === undefined || options.tags.every((tag) => item.tags?.includes(tag))) &&\n      (lowerBound === undefined || savedAt >= lowerBound) &&\n      (upperBound === undefined || savedAt <= upperBound) &&\n      matchesSearch(item, options.searchQuery, options.search) &&\n      (options.filter?.(item) ?? true) &&\n      (options.filterFn?.(item) ?? true)\n    );\n  });\n  const tagCounts = getTagCounts(filtered);\n  const sortBy = options.sortBy ?? options.sort?.by;\n  const direction = (options.order ?? options.sort?.direction) === \"asc\" ? 1 : -1;\n  const sorted = sortBy ? [...filtered].sort((a, b) => (a[sortBy] - b[sortBy]) * direction) : filtered;\n  const offset = Math.max(0, options.offset ?? 0);\n  const items =\n    options.limit === undefined ? sorted.slice(offset) : sorted.slice(offset, offset + Math.max(0, options.limit));\n  return { items, totalCount: sorted.length, tagCounts };\n}\n\nexport function getTagCounts<TMeta = Record<string, unknown>>(items: KeepItem<TMeta>[]): Record<string, number> {\n  const counts: Record<string, number> = {};\n  for (const item of items) {\n    for (const tag of item.tags ?? []) counts[tag] = (counts[tag] ?? 0) + 1;\n  }\n  return Object.fromEntries(Object.entries(counts).sort(([a], [b]) => a.localeCompare(b)));\n}\n\nfunction matchesSearch<TMeta>(\n  item: KeepItem<TMeta>,\n  searchQuery?: string,\n  search?: KeepListOptions<TMeta>[\"search\"],\n): boolean {\n  const query = search?.query ?? searchQuery;\n  if (!query?.trim()) return true;\n  const fields = search?.fields ?? [\"note\", \"meta\", \"tags\"];\n  const values = fields.map((field) => {\n    if (field === \"note\") return item.note ?? \"\";\n    if (field === \"tags\") return (item.tags ?? []).join(\" \");\n    try {\n      return JSON.stringify(item.meta) ?? \"\";\n    } catch {\n      return String(item.meta);\n    }\n  });\n  const text = values.join(\" \").toLocaleLowerCase();\n  if (!search) return text.includes(query.trim().toLocaleLowerCase());\n  const normalized = query.trim().toLocaleLowerCase();\n  const needles = search.tokenize === false ? [normalized] : normalized.split(/\\s+/).filter(Boolean);\n  const matches = needles.map((needle) => text.includes(needle));\n  return search.mode === \"or\" ? matches.some(Boolean) : matches.every(Boolean);\n}\n\nfunction toTimestamp(value: Date | number): number {\n  return value instanceof Date ? value.getTime() : value;\n}\n","import type { KeepItem, StorageAdapter } from \"./types\";\n\nexport type KeepItemStatus = \"available\" | \"deleted\" | \"private\" | \"expired\" | \"unknown\";\n\nexport type KeepItemRevalidationResult<TMeta = Record<string, unknown>> =\n  | { status: \"available\"; meta?: TMeta }\n  | { status: Exclude<KeepItemStatus, \"available\">; reason?: string };\n\nexport type KeepItemRevalidator<TMeta = Record<string, unknown>> = (\n  item: KeepItem<TMeta>,\n) =>\n  | KeepItemRevalidationResult<TMeta>\n  | KeepItemRevalidationResult<TMeta>[\"status\"]\n  | Promise<KeepItemRevalidationResult<TMeta> | KeepItemRevalidationResult<TMeta>[\"status\"]>;\n\nexport type KeepItemMetadataRefresher<TMeta = Record<string, unknown>> = (\n  item: KeepItem<TMeta>,\n) => TMeta | Promise<TMeta>;\n\n/** Return whether source metadata should be fetched again based on its age. */\nexport function isKeepItemMetadataStale<TMeta>(\n  item: KeepItem<TMeta>,\n  maxAgeMs: number,\n  now: () => number = Date.now,\n): boolean {\n  return item.metaUpdatedAt === undefined || now() - item.metaUpdatedAt >= maxAgeMs;\n}\n\nexport type KeepItemRevalidationRecord<TMeta = Record<string, unknown>> = {\n  item: KeepItem<TMeta>;\n  status: KeepItemStatus;\n  reason?: string;\n  updated: boolean;\n};\n\nexport type RevalidateKeepItemsOptions = {\n  /** Statuses that should be removed after they are detected. Detection is the default. */\n  removeStatuses?: Array<Exclude<KeepItemStatus, \"available\">>;\n  now?: () => number;\n};\n\nexport type KeepItemRevalidationSummary<TMeta = Record<string, unknown>> = {\n  items: KeepItem<TMeta>[];\n  checked: number;\n  updated: number;\n  removed: number;\n  updatedItems: KeepItem<TMeta>[];\n  removedIds: string[];\n  results: KeepItemRevalidationRecord<TMeta>[];\n};\n\n/** Revalidate saved items without coupling the checker to a network client. */\nexport async function revalidateKeepItems<TMeta = Record<string, unknown>>(\n  source: KeepItem<TMeta>[],\n  revalidator: KeepItemRevalidator<TMeta>,\n  options: RevalidateKeepItemsOptions = {},\n): Promise<KeepItemRevalidationSummary<TMeta>> {\n  const removeStatuses = new Set(options.removeStatuses ?? []);\n  const now = options.now ?? Date.now;\n  const items: KeepItem<TMeta>[] = [];\n  const updatedItems: KeepItem<TMeta>[] = [];\n  const removedIds: string[] = [];\n  const results: KeepItemRevalidationRecord<TMeta>[] = [];\n\n  for (const item of source) {\n    const rawResult = await revalidator(item);\n    const result: KeepItemRevalidationResult<TMeta> = typeof rawResult === \"string\" ? { status: rawResult } : rawResult;\n    if (result.status === \"available\") {\n      const timestamp = now();\n      const updated =\n        result.meta === undefined\n          ? item\n          : { ...item, meta: result.meta, metaUpdatedAt: timestamp, updatedAt: timestamp };\n      const didUpdate = updated !== item;\n      items.push(updated);\n      if (didUpdate) updatedItems.push(updated);\n      results.push({ item: updated, status: \"available\", updated: didUpdate });\n      continue;\n    }\n\n    const shouldRemove = removeStatuses.has(result.status);\n    if (shouldRemove) removedIds.push(item.id);\n    else items.push(item);\n    results.push({ item, status: result.status, reason: result.reason, updated: false });\n  }\n\n  return {\n    items,\n    checked: source.length,\n    updated: updatedItems.length,\n    removed: removedIds.length,\n    updatedItems,\n    removedIds,\n    results,\n  };\n}\n\n/** Revalidate and persist saved items for framework-neutral applications. */\nexport async function reconcileKeepItems<TMeta = Record<string, unknown>>(\n  storage: StorageAdapter<TMeta>,\n  revalidator: KeepItemRevalidator<TMeta>,\n  options: RevalidateKeepItemsOptions = {},\n): Promise<KeepItemRevalidationSummary<TMeta>> {\n  const source = await storage.getAll();\n  const summary = await revalidateKeepItems(source, revalidator, options);\n  if (summary.updatedItems.length > 0) await persistItems(storage, summary.updatedItems);\n  if (summary.removedIds.length > 0) await removeItems(storage, summary.removedIds);\n  return summary;\n}\n\nasync function persistItems<TMeta>(storage: StorageAdapter<TMeta>, items: KeepItem<TMeta>[]): Promise<void> {\n  if (storage.setMany) {\n    await storage.setMany(items);\n    return;\n  }\n  for (const item of items) await storage.set(item);\n}\n\nasync function removeItems<TMeta>(storage: StorageAdapter<TMeta>, ids: string[]): Promise<void> {\n  if (storage.removeMany) {\n    await storage.removeMany(ids);\n    return;\n  }\n  for (const id of ids) await storage.remove(id);\n}\n","import type {\n  KeepItemMetadataRefresher,\n  KeepItemRevalidationSummary,\n  KeepItemRevalidator,\n  RevalidateKeepItemsOptions,\n} from \"./revalidation\";\nimport type { KeepItem } from \"./types\";\n\nexport type KeepStoreState<TMeta = Record<string, unknown>> = {\n  items: KeepItem<TMeta>[];\n  isLoading: boolean;\n  isHydrated: boolean;\n  isMutating: boolean;\n  error: unknown | null;\n};\n\nexport type KeepStoreActions<TMeta = Record<string, unknown>> = {\n  saveItem: (item: KeepItem<TMeta>) => Promise<void>;\n  updateNote: (id: string, note?: string) => Promise<void>;\n  updateTags: (id: string, tags?: string[]) => Promise<void>;\n  updateTagsBatch: (ids: string[], tags?: string[]) => Promise<void>;\n  addTagsBatch: (ids: string[], tags: string[]) => Promise<void>;\n  removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;\n  removeItem: (id: string) => Promise<void>;\n  removeItems: (ids: string[]) => Promise<void>;\n  clear: () => Promise<void>;\n  refresh: () => Promise<void>;\n  refreshItemMetadata: (id: string, refresh: KeepItemMetadataRefresher<TMeta>) => Promise<void>;\n  revalidateItems: (\n    revalidator: KeepItemRevalidator<TMeta>,\n    options?: RevalidateKeepItemsOptions,\n  ) => Promise<KeepItemRevalidationSummary<TMeta>>;\n};\n\nexport class KeepStore<TMeta = Record<string, unknown>> {\n  private state: KeepStoreState<TMeta>;\n  private readonly listeners = new Set<() => void>();\n\n  constructor(initialState: KeepStoreState<TMeta>) {\n    this.state = initialState;\n  }\n\n  getSnapshot = (): KeepStoreState<TMeta> => this.state;\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  };\n\n  setState(next: Partial<KeepStoreState<TMeta>>): void {\n    let changed = false;\n    for (const key of Object.keys(next) as Array<keyof KeepStoreState<TMeta>>) {\n      if (!Object.is(this.state[key], next[key])) {\n        changed = true;\n        break;\n      }\n    }\n    if (!changed) return;\n    this.state = { ...this.state, ...next };\n    for (const listener of this.listeners) listener();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-THZ3ACR2.js

@@ -0,0 +1,41 @@
+// src/schema.ts
+var KeepSchemaValidationError = class extends Error {
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "KeepSchemaValidationError";
+    this.cause = options.cause;
+    this.itemId = options.itemId;
+  }
+};
+async function parseKeepMeta(schema, value) {
+  try {
+    if ("parse" in schema) return await schema.parse(value);
+    if ("safeParse" in schema) {
+      const result2 = await schema.safeParse(value);
+      if (result2.success) return result2.data;
+      throw new KeepSchemaValidationError("KeepKit metadata did not match the configured schema.", {
+        cause: result2.error
+      });
+    }
+    const result = await schema["~standard"].validate(value);
+    if (!result.issues && "value" in result) return result.value;
+    throw new KeepSchemaValidationError("KeepKit metadata did not match the configured schema.", {
+      cause: result.issues
+    });
+  } catch (cause) {
+    if (cause instanceof KeepSchemaValidationError) throw cause;
+    throw new KeepSchemaValidationError("KeepKit metadata did not match the configured schema.", {
+      cause
+    });
+  }
+}
+async function validateKeepItem(item, schema) {
+  return { ...item, meta: await parseKeepMeta(schema, item.meta) };
+}
+
+export {
+  KeepSchemaValidationError,
+  parseKeepMeta,
+  validateKeepItem
+};
+//# sourceMappingURL=chunk-THZ3ACR2.js.map

package/dist/chunk-THZ3ACR2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts"],"sourcesContent":["import type { KeepItem, KeepSchema } from \"./types\";\n\nexport class KeepSchemaValidationError extends Error {\n  readonly cause?: unknown;\n  readonly itemId?: string;\n\n  constructor(message: string, options: { cause?: unknown; itemId?: string } = {}) {\n    super(message);\n    this.name = \"KeepSchemaValidationError\";\n    this.cause = options.cause;\n    this.itemId = options.itemId;\n  }\n}\n\n/** Parse metadata with a Zod-like, safeParse-like, or Standard Schema parser. */\nexport async function parseKeepMeta<T>(schema: KeepSchema<T>, value: unknown): Promise<T> {\n  try {\n    if (\"parse\" in schema) return await schema.parse(value);\n\n    if (\"safeParse\" in schema) {\n      const result = await schema.safeParse(value);\n      if (result.success) return result.data;\n      throw new KeepSchemaValidationError(\"KeepKit metadata did not match the configured schema.\", {\n        cause: result.error,\n      });\n    }\n\n    const result = await schema[\"~standard\"].validate(value);\n    if (!result.issues && \"value\" in result) return result.value as T;\n    throw new KeepSchemaValidationError(\"KeepKit metadata did not match the configured schema.\", {\n      cause: result.issues,\n    });\n  } catch (cause) {\n    if (cause instanceof KeepSchemaValidationError) throw cause;\n    throw new KeepSchemaValidationError(\"KeepKit metadata did not match the configured schema.\", {\n      cause,\n    });\n  }\n}\n\nexport async function validateKeepItem<TMeta>(\n  item: KeepItem<unknown>,\n  schema: KeepSchema<TMeta>,\n): Promise<KeepItem<TMeta>> {\n  return { ...item, meta: await parseKeepMeta(schema, item.meta) };\n}\n"],"mappings":";AAEO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAInD,YAAY,SAAiB,UAAgD,CAAC,GAAG;AAC/E,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,QAAQ,QAAQ;AACrB,SAAK,SAAS,QAAQ;AAAA,EACxB;AACF;AAGA,eAAsB,cAAiB,QAAuB,OAA4B;AACxF,MAAI;AACF,QAAI,WAAW,OAAQ,QAAO,MAAM,OAAO,MAAM,KAAK;AAEtD,QAAI,eAAe,QAAQ;AACzB,YAAMA,UAAS,MAAM,OAAO,UAAU,KAAK;AAC3C,UAAIA,QAAO,QAAS,QAAOA,QAAO;AAClC,YAAM,IAAI,0BAA0B,yDAAyD;AAAA,QAC3F,OAAOA,QAAO;AAAA,MAChB,CAAC;AAAA,IACH;AAEA,UAAM,SAAS,MAAM,OAAO,WAAW,EAAE,SAAS,KAAK;AACvD,QAAI,CAAC,OAAO,UAAU,WAAW,OAAQ,QAAO,OAAO;AACvD,UAAM,IAAI,0BAA0B,yDAAyD;AAAA,MAC3F,OAAO,OAAO;AAAA,IAChB,CAAC;AAAA,EACH,SAAS,OAAO;AACd,QAAI,iBAAiB,0BAA2B,OAAM;AACtD,UAAM,IAAI,0BAA0B,yDAAyD;AAAA,MAC3F;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,eAAsB,iBACpB,MACA,QAC0B;AAC1B,SAAO,EAAE,GAAG,MAAM,MAAM,MAAM,cAAc,QAAQ,KAAK,IAAI,EAAE;AACjE;","names":["result"]}

package/dist/{chunk-H4A322SZ.js → chunk-X4UVKTBK.js}

@@ -136,6 +136,39 @@ var IndexedDBSyncQueueAdapter = class {
     });
   }
 };
+var FallbackSyncQueueAdapter = class {
+  constructor(options) {
+    this.active = "primary";
+    this.primary = options.primary;
+    this.fallback = options.fallback;
+    this.shouldFallback = options.shouldFallback ?? (() => true);
+  }
+  get isUsingFallback() {
+    return this.active === "fallback";
+  }
+  getAll() {
+    return this.execute((adapter) => adapter.getAll());
+  }
+  setMany(operations) {
+    return this.execute((adapter) => adapter.setMany(operations));
+  }
+  remove(operationIds) {
+    return this.execute((adapter) => adapter.remove(operationIds));
+  }
+  clear() {
+    return this.execute((adapter) => adapter.clear());
+  }
+  async execute(operation) {
+    const adapter = this.active === "primary" ? this.primary : this.fallback;
+    try {
+      return await operation(adapter);
+    } catch (error) {
+      if (this.active !== "primary" || !this.shouldFallback(error)) throw error;
+      this.active = "fallback";
+      return operation(this.fallback);
+    }
+  }
+};
 var SyncStorageAdapter = class {
   constructor(options) {
     this.listeners = /* @__PURE__ */ new Set();
@@ -158,11 +191,7 @@ var SyncStorageAdapter = class {
     };
     this.local = options.local;
     this.remote = options.remote;
-    this.queue = options.queue ?? (getBrowserIndexedDB() ? new IndexedDBSyncQueueAdapter({
-      databaseName: options.queueDatabaseName
-    }) : new LocalStorageSyncQueueAdapter({
-      key: options.queueKey ?? `${DEFAULT_SYNC_QUEUE_KEY}:${options.local.storageKey ?? "default"}`
-    }));
+    this.queue = options.queue ?? createDefaultQueue(options);
     this.clientId = options.clientId ?? createId();
     this.now = options.now ?? Date.now;
     this.resolveConflict = options.resolveConflict;
@@ -171,6 +200,7 @@ var SyncStorageAdapter = class {
       this.onlineHandler = () => void this.flushSync();
       window.addEventListener("online", this.onlineHandler);
     }
+    void this.resumeQueue();
   }
   getAll() {
     return this.local.getAll();
@@ -331,10 +361,23 @@ var SyncStorageAdapter = class {
       this.queueLoadPromise = this.queue.getAll().then((items) => {
         this.queueItems = items;
         this.queueLoaded = true;
+      }).catch((error) => {
+        this.queueLoadPromise = void 0;
+        throw error;
       });
     }
     await this.queueLoadPromise;
   }
+  async resumeQueue() {
+    try {
+      await this.loadQueue();
+      if (this.queueItems.length === 0) return;
+      this.updateState({ status: "pending", pendingCount: this.queueItems.length });
+      if (isBrowserOnline()) await this.flushSync();
+    } catch (error) {
+      this.updateState({ status: "error", error });
+    }
+  }
   async persistQueue(next) {
     const previousIds = new Set(this.queueItems.map((operation) => operation.operationId));
     const nextIds = new Set(next.map((operation) => operation.operationId));
@@ -352,9 +395,7 @@ var SyncStorageAdapter = class {
   }
   async replaceQueued(previous, next) {
     await this.persistQueue(
-      this.queueItems.map(
-        (operation) => operation.operationId === previous.operationId ? next : operation
-      )
+      this.queueItems.map((operation) => operation.operationId === previous.operationId ? next : operation)
     );
     this.setPendingState();
   }
@@ -432,6 +473,22 @@ function getBrowserIndexedDB() {
   if (typeof indexedDB === "undefined") return void 0;
   return indexedDB;
 }
+function isBrowserOnline() {
+  return typeof navigator === "undefined" || navigator.onLine !== false;
+}
+function createDefaultQueue(options) {
+  const queueKey = options.queueKey ?? `${DEFAULT_SYNC_QUEUE_KEY}:${options.local.storageKey ?? "default"}`;
+  const fallback = new LocalStorageSyncQueueAdapter({ key: queueKey });
+  const indexedDB2 = getBrowserIndexedDB();
+  if (!indexedDB2) return fallback;
+  return new FallbackSyncQueueAdapter({
+    primary: new IndexedDBSyncQueueAdapter({
+      databaseName: options.queueDatabaseName,
+      indexedDB: indexedDB2
+    }),
+    fallback
+  });
+}
 function requestToPromise(request) {
   return new Promise((resolve, reject) => {
     request.onsuccess = () => resolve(request.result);
@@ -450,6 +507,134 @@ function transactionToPromise(transaction) {
 var DEFAULT_STORAGE_KEY = "keepkit:items";
 var DEFAULT_INDEXEDDB_DATABASE = "keepkit";
 var DEFAULT_INDEXEDDB_STORE = "items";
+var FallbackStorageAdapter = class {
+  constructor(options) {
+    this.active = "primary";
+    this.listeners = /* @__PURE__ */ new Set();
+    this.primary = options.primary;
+    this.fallback = options.fallback;
+    this.shouldFallback = options.shouldFallback ?? isRecoverableStorageError;
+    this.onFallback = options.onFallback;
+    this.migrateFallbackOnEmpty = options.migrateFallbackOnEmpty ?? false;
+    this.mirrorWrites = options.mirrorWrites ?? false;
+    this.storageKey = options.fallback.storageKey ?? options.primary.storageKey;
+  }
+  get isUsingFallback() {
+    return this.active === "fallback";
+  }
+  getAll() {
+    return this.readAll();
+  }
+  set(item) {
+    return this.executeWrite((adapter) => adapter.set(item));
+  }
+  setMany(items) {
+    return this.executeWrite(
+      (adapter) => adapter.setMany ? adapter.setMany(items) : Promise.all(items.map((item) => adapter.set(item))).then(() => void 0)
+    );
+  }
+  remove(id) {
+    return this.executeWrite((adapter) => adapter.remove(id));
+  }
+  removeMany(ids) {
+    return this.executeWrite(
+      (adapter) => adapter.removeMany ? adapter.removeMany(ids) : Promise.all(ids.map((id) => adapter.remove(id))).then(() => void 0)
+    );
+  }
+  clear() {
+    return this.executeWrite((adapter) => adapter.clear());
+  }
+  merge(localItems) {
+    return this.execute(async (adapter) => {
+      const merged = adapter.merge ? await adapter.merge(localItems) : await mergeItems(adapter, localItems);
+      if (this.active === "primary" && this.mirrorWrites) {
+        try {
+          if (this.fallback.setMany) await this.fallback.setMany(merged);
+          else for (const item of merged) await this.fallback.set(item);
+        } catch {
+        }
+      }
+      return merged;
+    });
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    const notify = (source) => {
+      if (source === this.active) listener();
+    };
+    const unsubscribePrimary = this.primary.subscribe?.(() => notify("primary"));
+    const unsubscribeFallback = this.fallback.subscribe?.(() => notify("fallback"));
+    return () => {
+      this.listeners.delete(listener);
+      unsubscribePrimary?.();
+      unsubscribeFallback?.();
+    };
+  }
+  async readAll() {
+    if (this.active === "fallback") return this.fallback.getAll();
+    let items;
+    try {
+      items = await this.primary.getAll();
+    } catch (error) {
+      if (!this.shouldFallback(error)) throw error;
+      this.activateFallback(error);
+      return this.fallback.getAll();
+    }
+    if (!this.migrateFallbackOnEmpty || items.length > 0) return items;
+    const fallbackItems = await this.fallback.getAll();
+    if (fallbackItems.length === 0) return items;
+    try {
+      if (this.primary.setMany) await this.primary.setMany(fallbackItems);
+      else for (const item of fallbackItems) await this.primary.set(item);
+      return fallbackItems;
+    } catch (error) {
+      if (!this.shouldFallback(error)) throw error;
+      this.activateFallback(error);
+      return fallbackItems;
+    }
+  }
+  activateFallback(error) {
+    this.active = "fallback";
+    this.onFallback?.(error);
+    for (const listener of this.listeners) listener();
+  }
+  async executeWrite(operation) {
+    const result = await this.execute(operation);
+    if (this.active === "primary" && this.mirrorWrites) {
+      try {
+        await operation(this.fallback);
+      } catch {
+      }
+    }
+    return result;
+  }
+  async execute(operation) {
+    const adapter = this.active === "primary" ? this.primary : this.fallback;
+    try {
+      return await operation(adapter);
+    } catch (error) {
+      if (this.active !== "primary" || !this.shouldFallback(error)) throw error;
+      this.activateFallback(error);
+      return operation(this.fallback);
+    }
+  }
+};
+function createBrowserStorageAdapter(options = {}) {
+  const browserIndexedDB = options.indexedDB ?? getBrowserIndexedDB2();
+  const fallback = new LocalStorageAdapter({ key: options.key, storage: options.storage });
+  if (!browserIndexedDB) return fallback;
+  return new FallbackStorageAdapter({
+    primary: new IndexedDBAdapter({
+      databaseName: options.databaseName,
+      storeName: options.storeName,
+      version: options.version,
+      indexedDB: browserIndexedDB
+    }),
+    fallback,
+    migrateFallbackOnEmpty: true,
+    mirrorWrites: true
+  });
+}
 function createStorageAdapter(options) {
   const merge = options.merge;
   const subscribe = options.subscribe;
@@ -469,6 +654,18 @@ function createStorageAdapter(options) {
     ...options.storageKey ? { storageKey: options.storageKey } : {}
   };
 }
+async function mergeItems(adapter, localItems) {
+  const remoteItems = await adapter.getAll();
+  const byId = new Map(remoteItems.map((item) => [item.id, item]));
+  for (const item of localItems) {
+    const current = byId.get(item.id);
+    if (!current || item.updatedAt > current.updatedAt) byId.set(item.id, item);
+  }
+  const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);
+  if (adapter.setMany) await adapter.setMany(merged);
+  else for (const item of merged) await adapter.set(item);
+  return merged;
+}
 var LocalStorageAdapter = class {
   constructor(options = {}) {
     this.storageKey = options.key ?? DEFAULT_STORAGE_KEY;
@@ -592,9 +789,7 @@ var IndexedDBAdapter = class {
     if (!database) return [];
     try {
       const transaction = database.transaction(this.storeName, "readonly");
-      const value = await requestToPromise2(
-        transaction.objectStore(this.storeName).getAll()
-      );
+      const value = await requestToPromise2(transaction.objectStore(this.storeName).getAll());
       if (!isKeepItemArray(value)) {
         throw new KeepStorageParseError({ operation: "getAll", storageKey: this.storageKey });
       }
@@ -657,8 +852,7 @@ var IndexedDBAdapter = class {
       const byId = new Map(remoteItems.map((item) => [item.id, item]));
       for (const localItem of localItems) {
         const remoteItem = byId.get(localItem.id);
-        if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt)
-          byId.set(localItem.id, localItem);
+        if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt) byId.set(localItem.id, localItem);
       }
       const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);
       await this.setMany(merged);
@@ -710,7 +904,7 @@ var IndexedDBAdapter = class {
 };
 function isKeepItemArray(value) {
   return Array.isArray(value) && value.every(
-    (item) => isRecord2(item) && typeof item.id === "string" && typeof item.savedAt === "number" && Number.isFinite(item.savedAt) && typeof item.updatedAt === "number" && Number.isFinite(item.updatedAt) && "meta" in item && (item.targetType === void 0 || typeof item.targetType === "string") && (item.note === void 0 || typeof item.note === "string") && (item.schemaVersion === void 0 || typeof item.schemaVersion === "number" && Number.isFinite(item.schemaVersion)) && (item.revision === void 0 || typeof item.revision === "string") && (item.tags === void 0 || Array.isArray(item.tags) && item.tags.every((tag) => typeof tag === "string"))
+    (item) => isRecord2(item) && typeof item.id === "string" && typeof item.savedAt === "number" && Number.isFinite(item.savedAt) && typeof item.updatedAt === "number" && Number.isFinite(item.updatedAt) && "meta" in item && (item.targetType === void 0 || typeof item.targetType === "string") && (item.note === void 0 || typeof item.note === "string") && (item.schemaVersion === void 0 || typeof item.schemaVersion === "number" && Number.isFinite(item.schemaVersion)) && (item.revision === void 0 || typeof item.revision === "string") && (item.metaUpdatedAt === void 0 || typeof item.metaUpdatedAt === "number" && Number.isFinite(item.metaUpdatedAt)) && (item.tags === void 0 || Array.isArray(item.tags) && item.tags.every((tag) => typeof tag === "string"))
   );
 }
 function isRecord2(value) {
@@ -728,6 +922,9 @@ function getBrowserIndexedDB2() {
   if (typeof indexedDB === "undefined") return void 0;
   return indexedDB;
 }
+function isRecoverableStorageError(error) {
+  return error instanceof KeepStorageAccessError || error instanceof KeepStorageQuotaError;
+}
 function requestToPromise2(request) {
   return new Promise((resolve, reject) => {
     request.onsuccess = () => resolve(request.result);
@@ -757,12 +954,15 @@ export {
   DEFAULT_SYNC_QUEUE_STORE,
   LocalStorageSyncQueueAdapter,
   IndexedDBSyncQueueAdapter,
+  FallbackSyncQueueAdapter,
   SyncStorageAdapter,
   DEFAULT_STORAGE_KEY,
   DEFAULT_INDEXEDDB_DATABASE,
   DEFAULT_INDEXEDDB_STORE,
+  FallbackStorageAdapter,
+  createBrowserStorageAdapter,
   createStorageAdapter,
   LocalStorageAdapter,
   IndexedDBAdapter
 };
-//# sourceMappingURL=chunk-H4A322SZ.js.map
+//# sourceMappingURL=chunk-X4UVKTBK.js.map