@usegraft/sdk-react 1.0.0-beta.2 → 1.0.0-beta.3

package/dist/index.d.ts

@@ -22,7 +22,10 @@ interface Graft<TCollections extends Record<string, AnyCollection>> {
     getContent<K extends keyof TCollections & string>(collection: K, slug: string, options?: ReadOptions): Promise<Document<TCollections[K]> | null>;
     /** Typed listDocuments. */
     listContent<K extends keyof TCollections & string>(collection: K, options?: ListOptions): Promise<Document<TCollections[K]>[]>;
-    /** Typed searchDocuments (full-text, best-ranked first). */
+    /**
+     * Typed searchDocuments (full-text, best-ranked first). A blank query
+     * resolves to [] without a request.
+     */
     searchContent<K extends keyof TCollections & string>(collection: K, query: string, options?: SearchOptions): Promise<SearchHit<TCollections[K]>[]>;
     /** The underlying sdk-core client, for anything the helpers don't cover. */
     client: GraftClient<TCollections>;
@@ -46,7 +49,9 @@ declare function createGraft<TCollections extends Record<string, AnyCollection>>
  * plain async function and composes with either of them.
  *
  * Browser-side. `useEffect` does not run during server rendering, so on the
- * server these hooks render their loading state and nothing else. Data that
+ * server these hooks render their loading state and nothing else. The one
+ * exception is a blank search, which is answered without a read, so it renders
+ * its empty result on the server too. Data that
  * has to be in the HTML belongs in a loader or a server adapter
  * (@usegraft/sdk-react-router, @usegraft/sdk-tanstack-start, and the rest).
  *
@@ -85,7 +90,10 @@ interface GraftHooks<TCollections extends Record<string, AnyCollection>> {
     useContent: <K extends keyof TCollections & string>(collection: K, slug: string, options?: ReadOptions) => AsyncState<Document<TCollections[K]> | null>;
     /** A collection, in index order. */
     useContentList: <K extends keyof TCollections & string>(collection: K, options?: ListOptions) => AsyncState<Document<TCollections[K]>[]>;
-    /** Full-text search within one collection, best-ranked first. */
+    /**
+     * Full-text search within one collection, best-ranked first. A blank query
+     * reports no hits and sends no request.
+     */
     useContentSearch: <K extends keyof TCollections & string>(collection: K, query: string, options?: SearchOptions) => AsyncState<SearchHit<TCollections[K]>[]>;
 }
 /**

package/dist/index.js

@@ -57,6 +57,7 @@ function createGraft(options) {
     },
     async searchContent(collection, query, opts) {
       assertNoBranch(opts);
+      if (query.trim() === "") return [];
       return client.searchDocuments(collection, query, opts);
     }
   };
@@ -72,29 +73,41 @@ import {
 } from "react";
 import { jsx } from "react/jsx-runtime";
 var PENDING = { data: void 0, error: void 0, loading: true };
+var NO_HITS = {
+  data: Object.freeze([]),
+  error: void 0,
+  loading: false
+};
 function asError(cause) {
   return cause instanceof Error ? cause : new Error(String(cause));
 }
-function useRead(read) {
+function useRead(read, settled) {
   const [attempt, setAttempt] = useState(0);
-  const [state, setState] = useState(PENDING);
+  const [answer, setAnswer] = useState();
   useEffect(() => {
+    if (settled !== void 0) return;
     let live = true;
-    setState(PENDING);
     read().then(
       (data) => {
-        if (live) setState({ data, error: void 0, loading: false });
+        if (live) setAnswer({ read, attempt, state: { data, error: void 0, loading: false } });
       },
       (cause) => {
-        if (live) setState({ data: void 0, error: asError(cause), loading: false });
+        if (live) {
+          setAnswer({
+            read,
+            attempt,
+            state: { data: void 0, error: asError(cause), loading: false }
+          });
+        }
       }
     );
     return () => {
       live = false;
     };
-  }, [read, attempt]);
+  }, [read, attempt, settled]);
   const refresh = useCallback(() => setAttempt((previous) => previous + 1), []);
-  return { ...state, refresh };
+  const current = answer?.read === read && answer.attempt === attempt ? answer.state : PENDING;
+  return { ...settled ?? current, refresh };
 }
 function createGraftHooks(graft) {
   const GraftContext = createContext(graft);
@@ -136,7 +149,8 @@ function createGraftHooks(graft) {
         () => handle.searchContent(collection, query, { branch, limit }),
         [handle, collection, query, branch, limit]
       );
-      return useRead(read);
+      const settled = query.trim() === "" && branch === void 0 ? NO_HITS : void 0;
+      return useRead(read, settled);
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usegraft/sdk-react",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.3",
   "description": "React browser client: typed content reads and hooks over Graft's read-only content API.",
   "keywords": [
     "agent",
@@ -38,15 +38,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@usegraft/content-api": "1.0.0-beta.2",
-    "@usegraft/contracts": "1.0.0-beta.2",
-    "@usegraft/sdk-core": "1.0.0-beta.2"
+    "@usegraft/content-api": "1.0.0-beta.3",
+    "@usegraft/contracts": "1.0.0-beta.3",
+    "@usegraft/sdk-core": "1.0.0-beta.3"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.3",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.5",
-    "@usegraft/core": "1.0.0-beta.2",
+    "@usegraft/core": "1.0.0-beta.3",
     "jsdom": "^25.0.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8"