@keepkit/core 0.17.0 → 0.19.0

package/README.md

@@ -38,7 +38,7 @@ const list = useKeepList({
 
 保存対象の公開状態は`KeepItem.status`（`expired`、`removed`、`private`など）と`statusReason`で保持できます。`KeepProvider`の`validateItem` / `resolveItem`を指定すると、引数なしの`revalidateItems()`で検証できます。`revalidateItems`に`removeStatuses`を渡すと検出したアイテムを保存一覧から削除します。`SyncStorageAdapter`は`userId`、`tenantId`、`maxRetries`、`retryDelayMs`、`retryBackoff`に対応し、`retrySync()`で失敗後の同期を再開できます。
 
-v0.17.0では、保存順プレイリストと`useKeepNavigator`による連続閲覧、`reorderKeepItems` / `moveKeepItem`による順序管理を追加しました。`encodeKeepListQuery` / `decodeKeepListQuery`によるURL状態codec、`createScopedStorageAdapter`によるユーザー／テナント分離、`createKeepKitPreset({ mode: "local" | "sync" | "backup" })`も利用できます。`createAuthenticatedSyncKit`で認証付き同期とscope切り替えを構成できます。
+v0.19.0では、保存順プレイリストと`useKeepNavigator`による連続閲覧、`reorderKeepItems` / `moveKeepItem`による順序管理を追加しました。`encodeKeepListQuery` / `decodeKeepListQuery`によるURL状態codec、`createScopedStorageAdapter`によるユーザー／テナント分離、`createKeepKitPreset({ mode: "local" | "sync" | "backup" })`も利用できます。`createAuthenticatedSyncKit`で認証付き同期とscope切り替えを構成できます。
 
 `createAuthenticatedSyncKit`は、リクエストごとの`getAuthToken`、注入可能なpush/pull transport、401/403時の再認証callback、永続オフラインキュー、`setScope`による安全なユーザー／テナント切替を提供します。詳細は[`examples/authenticated-sync`](../../examples/authenticated-sync/README.md)を参照してください。
 
@@ -83,7 +83,7 @@ Use `@keepkit/core/core` for framework-neutral code, `@keepkit/core/react` for R
 
 `KeepItem.status` and `statusReason` preserve source availability such as `expired`, `removed`, and `private`. Configure `KeepProvider` with `validateItem` / `resolveItem` to make `revalidateItems()` use those hooks by default. Pass `removeStatuses` to remove detected items from storage. `SyncStorageAdapter` supports scoped queues with `userId` and `tenantId`, configurable retries/backoff, and explicit `retrySync()` recovery.
 
-In v0.17.0, use persisted playlist ordering with `useKeepNavigator`, `reorderKeepItems`, and `moveKeepItem` for continuous saved-item tours. `encodeKeepListQuery` / `decodeKeepListQuery` provide URL state, `createScopedStorageAdapter` provides user/tenant isolation, and `createKeepKitPreset({ mode: "local" | "sync" | "backup" })` provides the standard setup. `createAuthenticatedSyncKit` composes token-aware sync and scope switching.
+In v0.19.0, use persisted playlist ordering with `useKeepNavigator`, `reorderKeepItems`, and `moveKeepItem` for continuous saved-item tours. `encodeKeepListQuery` / `decodeKeepListQuery` provide URL state, `createScopedStorageAdapter` provides user/tenant isolation, and `createKeepKitPreset({ mode: "local" | "sync" | "backup" })` provides the standard setup. `createAuthenticatedSyncKit` composes token-aware sync and scope switching.
 
 `createAuthenticatedSyncKit` provides a per-request `getAuthToken`, injectable push/pull transport, 401/403 reauthentication callbacks, persistent offline queues, and `setScope` for safe user or tenant changes. See [`examples/authenticated-sync`](../../examples/authenticated-sync/README.md) for a recipe.
 

package/dist/{chunk-THZ3ACR2.js → chunk-5W4QSJHV.js}

@@ -1,4 +1,4 @@
-// src/schema.ts
+// src/features/persistence/schema.ts
 var KeepSchemaValidationError = class extends Error {
   constructor(message, options = {}) {
     super(message);
@@ -38,4 +38,4 @@ export {
   parseKeepMeta,
   validateKeepItem
 };
-//# sourceMappingURL=chunk-THZ3ACR2.js.map
+//# sourceMappingURL=chunk-5W4QSJHV.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/features/persistence/schema.ts"],"sourcesContent":["import type { KeepItem, KeepSchema } from \"../items/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-XWZ6GRD4.js → chunk-62I2YZYI.js}

@@ -1,8 +1,67 @@
 import {
   validateKeepItem
-} from "./chunk-THZ3ACR2.js";
+} from "./chunk-5W4QSJHV.js";
 
-// src/migration.ts
+// src/features/items/navigation.ts
+function orderKeepItems(items) {
+  if (!items.some((item) => item.order !== void 0)) return [...items];
+  return items.map((item, index) => ({ item, index })).sort((left, right) => {
+    const leftOrder = left.item.order;
+    const rightOrder = right.item.order;
+    if (leftOrder === void 0 && rightOrder !== void 0) return 1;
+    if (leftOrder !== void 0 && rightOrder === void 0) return -1;
+    if (leftOrder !== void 0 && rightOrder !== void 0 && leftOrder !== rightOrder) {
+      return leftOrder - rightOrder;
+    }
+    return left.index - right.index;
+  }).map(({ item }) => item);
+}
+function getKeepNavigationState(source, current) {
+  const items = orderKeepItems(source);
+  const currentIndex = typeof current === "number" ? Number.isInteger(current) && current >= 0 && current < items.length ? current : -1 : current === void 0 ? -1 : items.findIndex((item) => item.id === current);
+  const currentItem = currentIndex >= 0 ? items[currentIndex] ?? null : null;
+  return {
+    items,
+    currentIndex,
+    currentPosition: currentIndex >= 0 ? currentIndex + 1 : null,
+    currentItem,
+    hasNext: currentIndex >= 0 && currentIndex < items.length - 1,
+    hasPrev: currentIndex > 0,
+    nextItem: currentIndex >= 0 ? items[currentIndex + 1] ?? null : null,
+    prevItem: currentIndex > 0 ? items[currentIndex - 1] ?? null : null
+  };
+}
+function reorderKeepItems(source, orderedIds) {
+  const byId = new Map(source.map((item) => [item.id, item]));
+  const seen = /* @__PURE__ */ new Set();
+  for (const id of orderedIds) {
+    if (!byId.has(id)) throw new Error(`Cannot reorder unknown Keep item "${id}".`);
+    if (seen.has(id)) throw new Error(`Cannot reorder Keep items with duplicate id "${id}".`);
+    seen.add(id);
+  }
+  const current = orderKeepItems(source);
+  const sequence = [...orderedIds, ...current.map((item) => item.id).filter((id) => !seen.has(id))];
+  return sequence.map((id, order) => {
+    const item = byId.get(id);
+    if (!item) throw new Error(`Cannot reorder unknown Keep item "${id}".`);
+    return { ...item, order };
+  });
+}
+function moveKeepItem(source, id, targetIndex) {
+  const items = orderKeepItems(source);
+  const currentIndex = items.findIndex((item2) => item2.id === id);
+  if (currentIndex < 0) throw new Error(`Cannot move unknown Keep item "${id}".`);
+  if (!Number.isInteger(targetIndex)) throw new Error("Keep item targetIndex must be an integer.");
+  const nextIndex = Math.min(Math.max(0, targetIndex), items.length - 1);
+  const [item] = items.splice(currentIndex, 1);
+  items.splice(nextIndex, 0, item);
+  return reorderKeepItems(
+    items,
+    items.map((entry) => entry.id)
+  );
+}
+
+// src/features/persistence/migration.ts
 async function mergeKeepItems(localItems, target) {
   if (target.merge) return target.merge(localItems);
   const remoteItems = await target.getAll();
@@ -24,7 +83,7 @@ async function migrateKeepItems(source, target) {
   return merged;
 }
 
-// src/backup.ts
+// src/features/persistence/backup.ts
 var KEEP_BACKUP_FORMAT = "keepkit";
 var KEEP_BACKUP_VERSION = 1;
 var KeepBackupParseError = class extends Error {
@@ -138,66 +197,7 @@ function isSyncScope(value) {
   return isRecord(value) && (value.userId === void 0 || typeof value.userId === "string") && (value.tenantId === void 0 || typeof value.tenantId === "string");
 }
 
-// src/navigation.ts
-function orderKeepItems(items) {
-  if (!items.some((item) => item.order !== void 0)) return [...items];
-  return items.map((item, index) => ({ item, index })).sort((left, right) => {
-    const leftOrder = left.item.order;
-    const rightOrder = right.item.order;
-    if (leftOrder === void 0 && rightOrder !== void 0) return 1;
-    if (leftOrder !== void 0 && rightOrder === void 0) return -1;
-    if (leftOrder !== void 0 && rightOrder !== void 0 && leftOrder !== rightOrder) {
-      return leftOrder - rightOrder;
-    }
-    return left.index - right.index;
-  }).map(({ item }) => item);
-}
-function getKeepNavigationState(source, current) {
-  const items = orderKeepItems(source);
-  const currentIndex = typeof current === "number" ? Number.isInteger(current) && current >= 0 && current < items.length ? current : -1 : current === void 0 ? -1 : items.findIndex((item) => item.id === current);
-  const currentItem = currentIndex >= 0 ? items[currentIndex] ?? null : null;
-  return {
-    items,
-    currentIndex,
-    currentPosition: currentIndex >= 0 ? currentIndex + 1 : null,
-    currentItem,
-    hasNext: currentIndex >= 0 && currentIndex < items.length - 1,
-    hasPrev: currentIndex > 0,
-    nextItem: currentIndex >= 0 ? items[currentIndex + 1] ?? null : null,
-    prevItem: currentIndex > 0 ? items[currentIndex - 1] ?? null : null
-  };
-}
-function reorderKeepItems(source, orderedIds) {
-  const byId = new Map(source.map((item) => [item.id, item]));
-  const seen = /* @__PURE__ */ new Set();
-  for (const id of orderedIds) {
-    if (!byId.has(id)) throw new Error(`Cannot reorder unknown Keep item "${id}".`);
-    if (seen.has(id)) throw new Error(`Cannot reorder Keep items with duplicate id "${id}".`);
-    seen.add(id);
-  }
-  const current = orderKeepItems(source);
-  const sequence = [...orderedIds, ...current.map((item) => item.id).filter((id) => !seen.has(id))];
-  return sequence.map((id, order) => {
-    const item = byId.get(id);
-    if (!item) throw new Error(`Cannot reorder unknown Keep item "${id}".`);
-    return { ...item, order };
-  });
-}
-function moveKeepItem(source, id, targetIndex) {
-  const items = orderKeepItems(source);
-  const currentIndex = items.findIndex((item2) => item2.id === id);
-  if (currentIndex < 0) throw new Error(`Cannot move unknown Keep item "${id}".`);
-  if (!Number.isInteger(targetIndex)) throw new Error("Keep item targetIndex must be an integer.");
-  const nextIndex = Math.min(Math.max(0, targetIndex), items.length - 1);
-  const [item] = items.splice(currentIndex, 1);
-  items.splice(nextIndex, 0, item);
-  return reorderKeepItems(
-    items,
-    items.map((entry) => entry.id)
-  );
-}
-
-// src/query.ts
+// src/features/items/query.ts
 function queryKeepItems(source, query = {}) {
   const filtered = source.filter((item) => {
     const [from, to] = query.savedBetween ?? [];
@@ -254,7 +254,7 @@ function toTimestamp(value) {
   return value instanceof Date ? value.getTime() : value;
 }
 
-// src/revalidation.ts
+// src/features/items/revalidation.ts
 function isKeepItemMetadataStale(item, maxAgeMs, now = Date.now) {
   return item.metaUpdatedAt === void 0 || now() - item.metaUpdatedAt >= maxAgeMs;
 }
@@ -335,7 +335,7 @@ function clearItemStatus(item) {
   return next;
 }
 
-// src/store.ts
+// src/features/store/store.ts
 var KeepStore = class {
   constructor(initialState) {
     this.listeners = /* @__PURE__ */ new Set();
@@ -361,6 +361,10 @@ var KeepStore = class {
 };
 
 export {
+  orderKeepItems,
+  getKeepNavigationState,
+  reorderKeepItems,
+  moveKeepItem,
   mergeKeepItems,
   migrateKeepItems,
   KEEP_BACKUP_FORMAT,
@@ -369,10 +373,6 @@ export {
   KeepBackupImportError,
   exportItems,
   importItems,
-  orderKeepItems,
-  getKeepNavigationState,
-  reorderKeepItems,
-  moveKeepItem,
   queryKeepItems,
   getTagCounts,
   isKeepItemMetadataStale,
@@ -380,4 +380,4 @@ export {
   reconcileKeepItems,
   KeepStore
 };
-//# sourceMappingURL=chunk-XWZ6GRD4.js.map
+//# sourceMappingURL=chunk-62I2YZYI.js.map

package/dist/chunk-62I2YZYI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/features/items/navigation.ts","../src/features/persistence/migration.ts","../src/features/persistence/backup.ts","../src/features/items/query.ts","../src/features/items/revalidation.ts","../src/features/store/store.ts"],"sourcesContent":["import type { KeepItem } from \"./types\";\n\nexport type KeepNavigationState<TMeta = Record<string, unknown>> = {\n  items: KeepItem<TMeta>[];\n  currentIndex: number;\n  currentPosition: number | null;\n  currentItem: KeepItem<TMeta> | null;\n  hasNext: boolean;\n  hasPrev: boolean;\n  nextItem: KeepItem<TMeta> | null;\n  prevItem: KeepItem<TMeta> | null;\n};\n\n/** Return items in their persisted custom order, leaving legacy items stable. */\nexport function orderKeepItems<TMeta>(items: readonly KeepItem<TMeta>[]): KeepItem<TMeta>[] {\n  if (!items.some((item) => item.order !== undefined)) return [...items];\n  return items\n    .map((item, index) => ({ item, index }))\n    .sort((left, right) => {\n      const leftOrder = left.item.order;\n      const rightOrder = right.item.order;\n      if (leftOrder === undefined && rightOrder !== undefined) return 1;\n      if (leftOrder !== undefined && rightOrder === undefined) return -1;\n      if (leftOrder !== undefined && rightOrder !== undefined && leftOrder !== rightOrder) {\n        return leftOrder - rightOrder;\n      }\n      return left.index - right.index;\n    })\n    .map(({ item }) => item);\n}\n\n/** Derive the previous/current/next view for a list and an item id or index. */\nexport function getKeepNavigationState<TMeta = Record<string, unknown>>(\n  source: readonly KeepItem<TMeta>[],\n  current?: string | number,\n): KeepNavigationState<TMeta> {\n  const items = orderKeepItems(source);\n  const currentIndex =\n    typeof current === \"number\"\n      ? Number.isInteger(current) && current >= 0 && current < items.length\n        ? current\n        : -1\n      : current === undefined\n        ? -1\n        : items.findIndex((item) => item.id === current);\n  const currentItem = currentIndex >= 0 ? (items[currentIndex] ?? null) : null;\n  return {\n    items,\n    currentIndex,\n    currentPosition: currentIndex >= 0 ? currentIndex + 1 : null,\n    currentItem,\n    hasNext: currentIndex >= 0 && currentIndex < items.length - 1,\n    hasPrev: currentIndex > 0,\n    nextItem: currentIndex >= 0 ? (items[currentIndex + 1] ?? null) : null,\n    prevItem: currentIndex > 0 ? (items[currentIndex - 1] ?? null) : null,\n  };\n}\n\n/** Apply a partial or complete id order and assign stable zero-based positions. */\nexport function reorderKeepItems<TMeta = Record<string, unknown>>(\n  source: readonly KeepItem<TMeta>[],\n  orderedIds: readonly string[],\n): KeepItem<TMeta>[] {\n  const byId = new Map(source.map((item) => [item.id, item]));\n  const seen = new Set<string>();\n  for (const id of orderedIds) {\n    if (!byId.has(id)) throw new Error(`Cannot reorder unknown Keep item \"${id}\".`);\n    if (seen.has(id)) throw new Error(`Cannot reorder Keep items with duplicate id \"${id}\".`);\n    seen.add(id);\n  }\n  const current = orderKeepItems(source);\n  const sequence = [...orderedIds, ...current.map((item) => item.id).filter((id) => !seen.has(id))];\n  return sequence.map((id, order) => {\n    const item = byId.get(id);\n    if (!item) throw new Error(`Cannot reorder unknown Keep item \"${id}\".`);\n    return { ...item, order };\n  });\n}\n\n/** Move one item within the current custom/legacy order. */\nexport function moveKeepItem<TMeta = Record<string, unknown>>(\n  source: readonly KeepItem<TMeta>[],\n  id: string,\n  targetIndex: number,\n): KeepItem<TMeta>[] {\n  const items = orderKeepItems(source);\n  const currentIndex = items.findIndex((item) => item.id === id);\n  if (currentIndex < 0) throw new Error(`Cannot move unknown Keep item \"${id}\".`);\n  if (!Number.isInteger(targetIndex)) throw new Error(\"Keep item targetIndex must be an integer.\");\n  const nextIndex = Math.min(Math.max(0, targetIndex), items.length - 1);\n  const [item] = items.splice(currentIndex, 1);\n  items.splice(nextIndex, 0, item);\n  return reorderKeepItems(\n    items,\n    items.map((entry) => entry.id),\n  );\n}\n","import type { KeepItem, StorageAdapter } from \"../items/types\";\n\n/** Merge anonymous local items into a signed-in or remote adapter. */\nexport async function mergeKeepItems<TMeta>(\n  localItems: KeepItem<TMeta>[],\n  target: StorageAdapter<TMeta>,\n): Promise<KeepItem<TMeta>[]> {\n  if (target.merge) return target.merge(localItems);\n\n  const remoteItems = await target.getAll();\n  const byId = new Map(remoteItems.map((item) => [item.id, item]));\n  for (const localItem of localItems) {\n    const remoteItem = byId.get(localItem.id);\n    if (!remoteItem || localItem.updatedAt > remoteItem.updatedAt) {\n      byId.set(localItem.id, localItem);\n    }\n  }\n\n  const merged = [...byId.values()].sort((a, b) => b.updatedAt - a.updatedAt);\n  await Promise.all(merged.map((item) => target.set(item)));\n  return merged;\n}\n\n/** Read anonymous items, merge them into the target, then clear the source. */\nexport async function migrateKeepItems<TMeta>(\n  source: StorageAdapter<TMeta>,\n  target: StorageAdapter<TMeta>,\n): Promise<KeepItem<TMeta>[]> {\n  const localItems = await source.getAll();\n  const merged = await mergeKeepItems(localItems, target);\n  await source.clear();\n  return merged;\n}\n","import type { KeepInvalidItemPolicy, KeepItem, KeepSchema, StorageAdapter } from \"../items/types\";\nimport { mergeKeepItems } from \"./migration\";\nimport { validateKeepItem } from \"./schema\";\n\nexport const KEEP_BACKUP_FORMAT = \"keepkit\";\nexport const KEEP_BACKUP_VERSION = 1;\n\nexport type KeepBackup<TMeta = Record<string, unknown>> = {\n  format: typeof KEEP_BACKUP_FORMAT;\n  version: typeof KEEP_BACKUP_VERSION;\n  exportedAt: number;\n  items: KeepItem<TMeta>[];\n};\n\nexport type ImportItemsOptions<TMeta = unknown> = {\n  mode?: \"replace\" | \"merge\";\n  schema?: KeepSchema<TMeta>;\n  invalidItemPolicy?: KeepInvalidItemPolicy;\n  onInvalidItem?: (error: unknown, item: KeepItem<unknown>) => void;\n};\n\nexport type ImportItemsResult<TMeta = Record<string, unknown>> = {\n  mode: \"replace\" | \"merge\";\n  imported: number;\n  failed: number;\n  total: number;\n  items: KeepItem<TMeta>[];\n};\n\nexport class KeepBackupParseError extends Error {\n  readonly cause?: unknown;\n\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message);\n    this.name = \"KeepBackupParseError\";\n    if (options?.cause !== undefined) this.cause = options.cause;\n  }\n}\n\nexport class KeepBackupImportError extends Error {\n  readonly mode: \"replace\" | \"merge\";\n  readonly imported: number;\n  readonly failed: number;\n  readonly cause?: unknown;\n\n  constructor(\n    message: string,\n    options: {\n      mode: \"replace\" | \"merge\";\n      imported: number;\n      failed: number;\n      cause?: unknown;\n    },\n  ) {\n    super(message);\n    this.name = \"KeepBackupImportError\";\n    this.mode = options.mode;\n    this.imported = options.imported;\n    this.failed = options.failed;\n    if (options.cause !== undefined) this.cause = options.cause;\n  }\n}\n\n/** Serialize all adapter data into a versioned JSON backup. */\nexport async function exportItems<TMeta>(adapter: StorageAdapter<TMeta>): Promise<string> {\n  const backup: KeepBackup<TMeta> = {\n    format: KEEP_BACKUP_FORMAT,\n    version: KEEP_BACKUP_VERSION,\n    exportedAt: Date.now(),\n    items: await adapter.getAll(),\n  };\n  return JSON.stringify(backup, null, 2);\n}\n\n/** Validate and restore a backup, either replacing or merging existing data. */\nexport async function importItems<TMeta>(\n  adapter: StorageAdapter<TMeta>,\n  data: string | KeepBackup<TMeta>,\n  options: ImportItemsOptions<TMeta> = {},\n): Promise<ImportItemsResult<TMeta>> {\n  const backup = parseBackup<TMeta>(data);\n  const mode = options.mode ?? \"merge\";\n  const validItems: KeepItem<TMeta>[] = [];\n  let failed = 0;\n  for (const item of backup.items) {\n    if (!options.schema) {\n      validItems.push(item);\n      continue;\n    }\n    try {\n      validItems.push(await validateKeepItem(item, options.schema));\n    } catch (cause) {\n      options.onInvalidItem?.(cause, item);\n      if ((options.invalidItemPolicy ?? \"error\") === \"drop\") {\n        failed += 1;\n        continue;\n      }\n      throw cause;\n    }\n  }\n  let items: KeepItem<TMeta>[];\n\n  if (mode === \"merge\") {\n    try {\n      items = await mergeKeepItems(validItems, adapter);\n    } catch (cause) {\n      throw new KeepBackupImportError(\"KeepKit could not merge the backup.\", {\n        mode,\n        imported: 0,\n        failed: validItems.length + failed,\n        cause,\n      });\n    }\n  } else {\n    let imported = 0;\n    try {\n      await adapter.clear();\n      for (const item of validItems) {\n        await adapter.set(item);\n        imported += 1;\n      }\n      items = await adapter.getAll();\n    } catch (cause) {\n      throw new KeepBackupImportError(\"KeepKit could not replace the stored items.\", {\n        mode,\n        imported,\n        failed: validItems.length + failed - imported,\n        cause,\n      });\n    }\n  }\n\n  return { mode, imported: validItems.length, failed, total: items.length, items };\n}\n\nfunction parseBackup<TMeta>(data: string | KeepBackup<TMeta>): KeepBackup<TMeta> {\n  let value: unknown = data;\n  if (typeof data === \"string\") {\n    try {\n      value = JSON.parse(data);\n    } catch (cause) {\n      throw new KeepBackupParseError(\"KeepKit backup is not valid JSON.\", { cause });\n    }\n  }\n\n  if (!isRecord(value)) throw new KeepBackupParseError(\"KeepKit backup must be an object.\");\n  if (value.format !== KEEP_BACKUP_FORMAT || value.version !== KEEP_BACKUP_VERSION) {\n    throw new KeepBackupParseError(\"KeepKit backup format or version is unsupported.\");\n  }\n  if (typeof value.exportedAt !== \"number\" || !Number.isFinite(value.exportedAt)) {\n    throw new KeepBackupParseError(\"KeepKit backup has an invalid export timestamp.\");\n  }\n  if (!Array.isArray(value.items) || !value.items.every(isKeepItem)) {\n    throw new KeepBackupParseError(\"KeepKit backup contains invalid items.\");\n  }\n  return value as KeepBackup<TMeta>;\n}\n\nfunction isKeepItem(value: unknown): value is KeepItem {\n  if (!isRecord(value)) return false;\n  return (\n    typeof value.id === \"string\" &&\n    typeof value.savedAt === \"number\" &&\n    Number.isFinite(value.savedAt) &&\n    typeof value.updatedAt === \"number\" &&\n    Number.isFinite(value.updatedAt) &&\n    \"meta\" in value &&\n    (value.order === undefined || (typeof value.order === \"number\" && Number.isFinite(value.order))) &&\n    (value.targetType === undefined || typeof value.targetType === \"string\") &&\n    (value.note === undefined || typeof value.note === \"string\") &&\n    (value.schemaVersion === undefined ||\n      (typeof value.schemaVersion === \"number\" && Number.isFinite(value.schemaVersion))) &&\n    (value.revision === undefined || typeof value.revision === \"string\") &&\n    (value.metaUpdatedAt === undefined ||\n      (typeof value.metaUpdatedAt === \"number\" && Number.isFinite(value.metaUpdatedAt))) &&\n    (value.status === undefined ||\n      value.status === \"available\" ||\n      value.status === \"expired\" ||\n      value.status === \"removed\" ||\n      value.status === \"deleted\" ||\n      value.status === \"private\" ||\n      value.status === \"unknown\") &&\n    (value.statusReason === undefined || typeof value.statusReason === \"string\") &&\n    (value.scope === undefined || isSyncScope(value.scope)) &&\n    (value.tags === undefined || (Array.isArray(value.tags) && value.tags.every((tag) => typeof tag === \"string\")))\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isSyncScope(value: unknown): boolean {\n  return (\n    isRecord(value) &&\n    (value.userId === undefined || typeof value.userId === \"string\") &&\n    (value.tenantId === undefined || typeof value.tenantId === \"string\")\n  );\n}\n","import { orderKeepItems } from \"./navigation\";\nimport type { KeepItem } from \"./types\";\n\nexport type KeepListQuery<TMeta = Record<string, unknown>> = {\n  targetType?: string;\n  tags?: string[];\n  sort?: {\n    by: \"savedAt\" | \"updatedAt\";\n    direction?: \"asc\" | \"desc\";\n  };\n  search?: {\n    query?: string;\n    mode?: \"and\" | \"or\";\n    tokenize?: boolean;\n    fields?: Array<\"note\" | \"meta\" | \"tags\">;\n  };\n  pagination?: {\n    page?: number;\n    pageSize?: number;\n  };\n  filter?: (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  page: number;\n  pageCount: number;\n  hasNextPage: boolean;\n  hasPreviousPage: boolean;\n};\n\n/** Apply the collection query and one-based pagination without React. */\nexport function queryKeepItems<TMeta = Record<string, unknown>>(\n  source: KeepItem<TMeta>[],\n  query: KeepListQuery<TMeta> = {},\n): QueryKeepItemsResult<TMeta> {\n  const filtered = source.filter((item) => {\n    const [from, to] = query.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      (query.targetType === undefined || item.targetType === query.targetType) &&\n      (query.tags === undefined || query.tags.every((tag) => item.tags?.includes(tag))) &&\n      (lowerBound === undefined || savedAt >= lowerBound) &&\n      (upperBound === undefined || savedAt <= upperBound) &&\n      matchesSearch(item, query.search) &&\n      (query.filter?.(item) ?? true)\n    );\n  });\n  const tagCounts = getTagCounts(filtered);\n  const sortBy = query.sort?.by;\n  const direction = query.sort?.direction === \"asc\" ? 1 : -1;\n  const sorted = sortBy ? [...filtered].sort((a, b) => (a[sortBy] - b[sortBy]) * direction) : orderKeepItems(filtered);\n  const pageSize = Math.max(1, query.pagination?.pageSize ?? (sorted.length || 1));\n  const pageCount = Math.max(1, Math.ceil(sorted.length / pageSize));\n  const page = Math.min(Math.max(1, query.pagination?.page ?? 1), pageCount);\n  const offset = (page - 1) * pageSize;\n\n  return {\n    items: sorted.slice(offset, offset + pageSize),\n    totalCount: sorted.length,\n    tagCounts,\n    page,\n    pageCount,\n    hasNextPage: page < pageCount,\n    hasPreviousPage: page > 1,\n  };\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>(item: KeepItem<TMeta>, search?: KeepListQuery<TMeta>[\"search\"]): boolean {\n  const query = search?.query;\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  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, KeepItemStatus, StorageAdapter } from \"./types\";\n\nexport type { KeepItemStatus } from \"./types\";\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 KeepItemResolver<TMeta = Record<string, unknown>> = (\n  item: KeepItem<TMeta>,\n  result: KeepItemRevalidationResult<TMeta>,\n) => KeepItem<TMeta> | undefined | Promise<KeepItem<TMeta> | undefined>;\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<TMeta = Record<string, unknown>> = {\n  /** Statuses that should be removed after they are detected. Detection is the default. */\n  removeStatuses?: Array<Exclude<KeepItemStatus, \"available\">>;\n  now?: () => number;\n  resolveItem?: KeepItemResolver<TMeta>;\n};\n\nexport type KeepAutoRevalidationOptions<TMeta = Record<string, unknown>> = {\n  /** Revalidate after the provider hydrates. Defaults to true when validateItem is supplied. */\n  onMount?: boolean;\n  /** Revalidate when the browser returns online. Defaults to true. */\n  onReconnect?: boolean;\n  /** Revalidate repeatedly while mounted. Disabled by default. */\n  intervalMs?: number;\n  removeStatuses?: Array<Exclude<KeepItemStatus, \"available\">>;\n  revalidator?: KeepItemRevalidator<TMeta>;\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<TMeta> = {},\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    const reason = result.status === \"available\" ? undefined : result.reason;\n    const defaultResolved = {\n      ...item,\n      status: result.status,\n      ...(result.status === \"available\" ? { statusReason: undefined } : { statusReason: reason }),\n    };\n    const resolved = options.resolveItem\n      ? await (options.resolveItem as KeepItemResolver<TMeta>)(item, result)\n      : defaultResolved;\n    if (resolved === undefined) {\n      removedIds.push(item.id);\n      results.push({ item, status: result.status, reason, updated: false });\n      continue;\n    }\n    if (result.status === \"available\") {\n      const timestamp = now();\n      const availableItem = clearItemStatus(resolved);\n      const updated =\n        result.meta === undefined\n          ? availableItem\n          : { ...availableItem, 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 withStatus = { ...resolved, status: result.status, ...(reason ? { statusReason: reason } : {}) };\n    const shouldRemove = removeStatuses.has(result.status);\n    if (shouldRemove) removedIds.push(item.id);\n    else items.push(withStatus);\n    if (!shouldRemove && withStatus !== item) updatedItems.push(withStatus);\n    results.push({ item: withStatus, status: result.status, reason, updated: !shouldRemove && withStatus !== item });\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<TMeta> = {},\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\nfunction clearItemStatus<TMeta>(item: KeepItem<TMeta>): KeepItem<TMeta> {\n  const next = { ...item };\n  delete next.status;\n  delete next.statusReason;\n  return next;\n}\n","import type {\n  KeepItemMetadataRefresher,\n  KeepItemRevalidationSummary,\n  KeepItemRevalidator,\n  RevalidateKeepItemsOptions,\n} from \"../items/revalidation\";\nimport type { KeepChangeContext, KeepItem, KeepUndoState } from \"../items/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  lastChange?: KeepChangeContext<TMeta>;\n  undo?: KeepUndoState;\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  removeItemWithUndo: (id: string) => Promise<void>;\n  removeItemsWithUndo: (ids: string[]) => Promise<void>;\n  undoLastRemoval: () => 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<TMeta>,\n  ) => Promise<KeepItemRevalidationSummary<TMeta>>;\n  reorderItems: (orderedIds: string[]) => Promise<void>;\n  moveItem: (id: string, targetIndex: number) => Promise<void>;\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":["item"]}

package/dist/{chunk-XIBTMJ4R.js → chunk-PNP7OALR.js}

@@ -1,4 +1,51 @@
-// src/scope.ts
+// src/features/items/types.ts
+var KeepSyncAuthError = class extends Error {
+  constructor(status, options) {
+    super(`KeepKit sync authorization failed with status ${status}.`);
+    this.name = "KeepSyncAuthError";
+    this.status = status;
+    this.operation = options.operation;
+    this.scope = options.scope;
+    if (options.cause !== void 0) this.cause = options.cause;
+  }
+};
+function isKeepSyncAuthError(error) {
+  return error instanceof KeepSyncAuthError;
+}
+var KeepStorageError = class extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "KeepStorageError";
+    this.operation = options.operation;
+    this.storageKey = options.storageKey;
+    if (options.cause !== void 0) this.cause = options.cause;
+  }
+};
+var KeepStorageQuotaError = class extends KeepStorageError {
+  constructor(options) {
+    super("KeepKit storage quota was exceeded.", options);
+    this.name = "KeepStorageQuotaError";
+  }
+};
+var KeepStorageAccessError = class extends KeepStorageError {
+  constructor(options) {
+    super("KeepKit could not access the configured storage.", options);
+    this.name = "KeepStorageAccessError";
+  }
+};
+var KeepStorageParseError = class extends KeepStorageError {
+  constructor(options) {
+    super("KeepKit found invalid data in the configured storage.", options);
+    this.name = "KeepStorageParseError";
+  }
+};
+function normalizeKeepTags(tags) {
+  if (!tags) return void 0;
+  const normalized = [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];
+  return normalized.length > 0 ? normalized : void 0;
+}
+
+// src/features/persistence/scope.ts
 function getKeepScopeKey(scope) {
   if (!scope?.userId && !scope?.tenantId) return "";
   return `:${encodeURIComponent(scope.tenantId ?? "_")}:${encodeURIComponent(scope.userId ?? "_")}`;
@@ -102,53 +149,6 @@ async function writeAll(base, items) {
   for (const item of items) await base.set(item);
 }
 
-// src/types.ts
-var KeepSyncAuthError = class extends Error {
-  constructor(status, options) {
-    super(`KeepKit sync authorization failed with status ${status}.`);
-    this.name = "KeepSyncAuthError";
-    this.status = status;
-    this.operation = options.operation;
-    this.scope = options.scope;
-    if (options.cause !== void 0) this.cause = options.cause;
-  }
-};
-function isKeepSyncAuthError(error) {
-  return error instanceof KeepSyncAuthError;
-}
-var KeepStorageError = class extends Error {
-  constructor(message, options) {
-    super(message);
-    this.name = "KeepStorageError";
-    this.operation = options.operation;
-    this.storageKey = options.storageKey;
-    if (options.cause !== void 0) this.cause = options.cause;
-  }
-};
-var KeepStorageQuotaError = class extends KeepStorageError {
-  constructor(options) {
-    super("KeepKit storage quota was exceeded.", options);
-    this.name = "KeepStorageQuotaError";
-  }
-};
-var KeepStorageAccessError = class extends KeepStorageError {
-  constructor(options) {
-    super("KeepKit could not access the configured storage.", options);
-    this.name = "KeepStorageAccessError";
-  }
-};
-var KeepStorageParseError = class extends KeepStorageError {
-  constructor(options) {
-    super("KeepKit found invalid data in the configured storage.", options);
-    this.name = "KeepStorageParseError";
-  }
-};
-function normalizeKeepTags(tags) {
-  if (!tags) return void 0;
-  const normalized = [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];
-  return normalized.length > 0 ? normalized : void 0;
-}
-
 // src/storage/sync.ts
 var DEFAULT_SYNC_QUEUE_KEY = "keepkit:sync-queue";
 var DEFAULT_SYNC_QUEUE_DATABASE = "keepkit-sync";
@@ -1167,11 +1167,6 @@ function isQuotaExceededError(cause) {
 }
 
 export {
-  getKeepScopeKey,
-  isSameKeepScope,
-  ScopedStorageAdapter,
-  createScopedStorageAdapter,
-  ScopedSyncQueueAdapter,
   KeepSyncAuthError,
   isKeepSyncAuthError,
   KeepStorageError,
@@ -1179,6 +1174,11 @@ export {
   KeepStorageAccessError,
   KeepStorageParseError,
   normalizeKeepTags,
+  getKeepScopeKey,
+  isSameKeepScope,
+  ScopedStorageAdapter,
+  createScopedStorageAdapter,
+  ScopedSyncQueueAdapter,
   DEFAULT_SYNC_QUEUE_KEY,
   DEFAULT_SYNC_QUEUE_DATABASE,
   DEFAULT_SYNC_QUEUE_STORE,
@@ -1195,4 +1195,4 @@ export {
   LocalStorageAdapter,
   IndexedDBAdapter
 };
-//# sourceMappingURL=chunk-XIBTMJ4R.js.map
+//# sourceMappingURL=chunk-PNP7OALR.js.map