@keepkit/core 0.27.3 → 0.28.1

package/dist/react.js

@@ -1,6 +1,7 @@
 "use client";
 import {
   KeepStore,
+  createRediscoveryQuery,
   exportItems,
   getKeepNavigationState,
   importItems,
@@ -10,14 +11,17 @@ import {
   queryKeepItems,
   reorderKeepItems,
   revalidateKeepItems
-} from "./chunk-O6FNZ5N2.js";
+} from "./chunk-JGGKIE3O.js";
 import {
   parseKeepMeta
 } from "./chunk-5W4QSJHV.js";
 import {
   createBrowserStorageAdapter,
-  normalizeKeepTags
-} from "./chunk-XUHRDJD6.js";
+  isRecord,
+  normalizeKeepTags,
+  persistKeepItems,
+  removeKeepItems
+} from "./chunk-HDML3IDX.js";
 
 // src/react/components/KeepButton.tsx
 import {
@@ -261,8 +265,7 @@ function KeepProviderContent({
             next = validated;
           }
           if (needsMigrationPersist) {
-            if (storage.setMany) await storage.setMany(next);
-            else for (const item of next) await storage.set(item);
+            await persistKeepItems(storage, next);
           }
           setItems(next);
           store.setState({ error: null });
@@ -328,6 +331,20 @@ function KeepProviderContent({
     },
     [enqueueOperation, reportError, runAfterPlugins, runBeforePlugins, setItems, store]
   );
+  const updateItem = useCallback(
+    (action, id, update, onSuccess) => runMutation(action, id, (previous) => {
+      const current = previous.find((item) => item.id === id);
+      if (!current) return void 0;
+      const next = update(current);
+      return {
+        next: previous.map((item) => item.id === id ? next : item),
+        persist: () => storage.set(next),
+        onSuccess: () => onSuccess?.(next),
+        pluginContext: { action, id, item: next }
+      };
+    }),
+    [runMutation, storage]
+  );
   const saveItem = useCallback(
     async (item) => {
       let normalizedItem;
@@ -377,8 +394,7 @@ function KeepProviderContent({
           next,
           persist: async () => {
             try {
-              if (storage.setMany) await storage.setMany(changedItems);
-              else for (const item of changedItems) await storage.set(item);
+              await persistKeepItems(storage, changedItems);
             } catch (cause) {
               await restoreItems(storage, previous);
               throw cause;
@@ -401,8 +417,7 @@ function KeepProviderContent({
           next,
           persist: async () => {
             try {
-              if (storage.setMany) await storage.setMany(changedItems);
-              else for (const item of changedItems) await storage.set(item);
+              await persistKeepItems(storage, changedItems);
             } catch (cause) {
               await restoreItems(storage, previous);
               throw cause;
@@ -417,51 +432,36 @@ function KeepProviderContent({
   const updateNote = useCallback(
     async (id, note) => {
       const nextNote = note?.trim() || void 0;
-      await runMutation("updateNote", id, (previous) => {
-        const current = previous.find((item) => item.id === id);
-        if (!current) return void 0;
-        const next = { ...current, note: nextNote, updatedAt: Date.now() };
-        return {
-          next: previous.map((item) => item.id === id ? next : item),
-          persist: () => storage.set(next),
-          onSuccess: () => handlersRef.current.onNoteUpdate?.(id, nextNote),
-          pluginContext: { action: "updateNote", id, item: next }
-        };
-      });
+      await updateItem(
+        "updateNote",
+        id,
+        (current) => ({ ...current, note: nextNote, updatedAt: Date.now() }),
+        () => handlersRef.current.onNoteUpdate?.(id, nextNote)
+      );
     },
-    [runMutation, storage]
+    [updateItem]
   );
   const updateTags = useCallback(
     async (id, tags) => {
       const nextTags = normalizeKeepTags(tags);
-      await runMutation("updateTags", id, (previous) => {
-        const current = previous.find((item) => item.id === id);
-        if (!current) return void 0;
-        const next = { ...current, tags: nextTags, updatedAt: Date.now() };
-        return {
-          next: previous.map((item) => item.id === id ? next : item),
-          persist: () => storage.set(next),
-          onSuccess: () => handlersRef.current.onTagsUpdate?.(id, nextTags),
-          pluginContext: { action: "updateTags", id, item: next }
-        };
-      });
+      await updateItem(
+        "updateTags",
+        id,
+        (current) => ({ ...current, tags: nextTags, updatedAt: Date.now() }),
+        () => handlersRef.current.onTagsUpdate?.(id, nextTags)
+      );
     },
-    [runMutation, storage]
+    [updateItem]
+  );
+  const recordOpen = useCallback(
+    (id, openedAt = Date.now()) => updateItem("open", id, (current) => ({ ...current, lastOpenedAt: openedAt, updatedAt: Date.now() })),
+    [updateItem]
   );
   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 }
-        };
-      });
+      await updateItem("archive", id, (current) => ({ ...current, archived, updatedAt: Date.now() }));
     },
-    [runMutation, storage]
+    [updateItem]
   );
   const toggleArchive = useCallback(
     (id) => {
@@ -474,39 +474,27 @@ function KeepProviderContent({
   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 }
-        };
-      });
+      await updateItem("pin", id, (current) => ({
+        ...current,
+        pinned: current.pinned !== true,
+        updatedAt: Date.now()
+      }));
     },
-    [runMutation, storage]
+    [updateItem]
   );
   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;
+      await updateItem("collection", id, (current) => {
         const { collectionId: _oldCollectionId, ...withoutCollection } = current;
-        const next = {
+        return {
           ...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]
+    [updateItem]
   );
   const createCollection = useCallback(
     async (id, name) => {
@@ -724,8 +712,7 @@ function KeepProviderContent({
       return {
         next,
         persist: async () => {
-          if (storage.setMany) await storage.setMany(pending.items);
-          else for (const item of pending.items) await storage.set(item);
+          await persistKeepItems(storage, pending.items);
         },
         onSuccess: () => handlersRef.current.onUndo?.(pending.items),
         pluginContext: { action: "undo", items: pending.items }
@@ -763,13 +750,11 @@ function KeepProviderContent({
           await runBeforePlugins(pluginContext);
           if (summary.updatedItems.length > 0) {
             persistenceStarted = true;
-            if (storage.setMany) await storage.setMany(summary.updatedItems);
-            else for (const item of summary.updatedItems) await storage.set(item);
+            await persistKeepItems(storage, summary.updatedItems);
           }
           if (summary.removedIds.length > 0) {
             persistenceStarted = true;
-            if (storage.removeMany) await storage.removeMany(summary.removedIds);
-            else for (const id of summary.removedIds) await storage.remove(id);
+            await removeKeepItems(storage, summary.removedIds);
           }
           setItems(summary.items);
           store.setState({ error: null });
@@ -889,6 +874,7 @@ function KeepProviderContent({
       syncState,
       undo,
       saveItem,
+      recordOpen,
       updateNote,
       updateTags,
       toggleArchive,
@@ -934,6 +920,7 @@ function KeepProviderContent({
       refresh,
       removeItem,
       saveItem,
+      recordOpen,
       removeItemWithUndo,
       removeItemsWithUndo,
       undoLastRemoval,
@@ -962,6 +949,7 @@ function KeepProviderContent({
   const actions = useMemo(
     () => ({
       saveItem,
+      recordOpen,
       updateNote,
       updateTags,
       toggleArchive,
@@ -998,6 +986,7 @@ function KeepProviderContent({
       removeTagsBatch,
       renameCollection,
       saveItem,
+      recordOpen,
       updateNote,
       updateTags,
       toggleArchive,
@@ -1036,11 +1025,7 @@ async function parseKeepMetaItem(item, schema) {
 }
 async function restoreItems(storage, items) {
   try {
-    if (storage.setMany) {
-      await storage.setMany(items);
-      return;
-    }
-    for (const item of items) await storage.set(item);
+    await persistKeepItems(storage, items);
   } catch {
   }
 }
@@ -1102,6 +1087,7 @@ function useKeepItem(input) {
     });
   }, [actions, currentOrder, input, item?.savedAt]);
   const remove = useCallback3(() => actions.removeItem(id), [actions, id]);
+  const recordOpen = useCallback3((openedAt) => actions.recordOpen(id, openedAt), [actions, id]);
   const removeWithUndo = useCallback3(() => actions.removeItemWithUndo(id), [actions, id]);
   const toggle = useCallback3(() => item ? remove() : save(), [item, remove, save]);
   const updateNote = useCallback3((note) => actions.updateNote(id, note), [actions, id]);
@@ -1125,6 +1111,7 @@ function useKeepItem(input) {
     isMutating,
     error,
     save,
+    recordOpen,
     remove,
     removeWithUndo,
     undo: actions.undoLastRemoval,
@@ -1301,9 +1288,6 @@ function getCollectionName(value, fallback) {
   if (isRecord(value) && typeof value.name === "string" && value.name.trim()) return value.name.trim();
   return fallback;
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
 
 // src/react/hooks/useKeepList.ts
 import { useCallback as useCallback4, useMemo as useMemo3 } from "react";
@@ -1311,6 +1295,7 @@ function useKeepList(query = {}) {
   const { store, actions } = useKeepStore();
   const {
     archiveScope,
+    activity,
     archived,
     collectionId,
     filter,
@@ -1325,6 +1310,7 @@ function useKeepList(query = {}) {
   const queryOptions = useMemo3(
     () => ({
       archiveScope,
+      activity,
       archived,
       collectionId,
       filter,
@@ -1338,6 +1324,7 @@ function useKeepList(query = {}) {
     }),
     [
       archiveScope,
+      activity,
       archived,
       collectionId,
       filter,
@@ -1512,6 +1499,17 @@ function useKeepNavigator(options = {}) {
   return { ...navigation, goToNext, goToPrev, goToIndex, goToItem };
 }
 
+// src/react/hooks/useKeepRediscovery.ts
+import { useMemo as useMemo5 } from "react";
+function useKeepRediscovery(options) {
+  const { strategy, inactiveForMs, limit } = options;
+  const query = useMemo5(() => {
+    const base = createRediscoveryQuery({ strategy, inactiveForMs });
+    return limit === void 0 ? base : { ...base, pagination: { page: 1, pageSize: Math.max(1, limit) } };
+  }, [inactiveForMs, limit, strategy]);
+  return { ...useKeepList(query), query };
+}
+
 // src/react/hooks/useKeepShortcut.ts
 import { useEffect as useEffect2 } from "react";
 function useKeepShortcut(options) {
@@ -1578,6 +1576,7 @@ function createKeepKit(options = {}) {
     useItem: (item) => useKeepItem(item),
     useCollections: (collectionsOptions) => useKeepCollections(collectionsOptions),
     useList: (query) => useKeepList(query),
+    useRediscovery: (rediscoveryOptions) => useKeepRediscovery(rediscoveryOptions),
     useNavigator: (navigatorOptions) => useKeepNavigator(navigatorOptions),
     useShortcut: (shortcutOptions) => useKeepShortcut(shortcutOptions)
   };
@@ -1587,12 +1586,14 @@ export {
   KeepErrorBoundary,
   KeepProvider,
   createKeepKit,
+  createRediscoveryQuery,
   isKeepItemMetadataStale,
   useKeepCollections,
   useKeepContext,
   useKeepItem,
   useKeepList,
   useKeepNavigator,
+  useKeepRediscovery,
   useKeepShortcut,
   useKeepStore
 };