@usegraft/sdk-react 0.2.0 → 1.0.0-beta.0

package/dist/index.d.ts

@@ -3,7 +3,13 @@ export { AnyCollection, ChangeSet, ClientOptions, Document, GraftClient, ListOpt
 import { ReactNode, ReactElement } from 'react';
 export { ContentApiReaderOptions, createContentApiReader } from '@usegraft/content-api';
 
-interface GraftOptions<TCollections extends Record<string, AnyCollection>> extends Omit<ClientOptions<TCollections>, "db"> {
+interface GraftOptions<TCollections extends Record<string, AnyCollection>> extends Omit<ClientOptions<TCollections>, "index"> {
+    /**
+     * Your own reader, when `endpoint` is not enough. Optional here because
+     * `endpoint` is the ordinary way to configure this package, and exactly one
+     * of the two is required.
+     */
+    index?: ClientOptions<TCollections>["index"];
     /** Content API base URL, e.g. `https://cms.example.com/api/content/v1`. */
     endpoint?: string | URL;
     /** Static headers sent with every read, such as `Authorization`. */

package/dist/index.js

@@ -35,11 +35,30 @@ function createGraft(options) {
     collections: options.collections,
     branch: options.branch
   });
+  const endpointPinned = options.endpoint !== void 0;
+  function assertNoBranch(opts) {
+    if (!endpointPinned || opts?.branch === void 0) return;
+    throw new GraftError({
+      code: "CONFIG_INVALID",
+      message: "`branch` cannot be passed to a read on an endpoint-backed handle.",
+      fix: "Each content API endpoint serves exactly one branch, fixed by the server, and the branch query param is refused. Point a second handle at the preview's own endpoint instead of asking this one for a branch.",
+      details: { branch: opts.branch, endpoint: String(options.endpoint) }
+    });
+  }
   return {
     client,
-    getContent: (collection, slug, opts) => client.getDocument(collection, slug, opts),
-    listContent: (collection, opts) => client.listDocuments(collection, opts),
-    searchContent: (collection, query, opts) => client.searchDocuments(collection, query, opts)
+    async getContent(collection, slug, opts) {
+      assertNoBranch(opts);
+      return client.getDocument(collection, slug, opts);
+    },
+    async listContent(collection, opts) {
+      assertNoBranch(opts);
+      return client.listDocuments(collection, opts);
+    },
+    async searchContent(collection, query, opts) {
+      assertNoBranch(opts);
+      return client.searchDocuments(collection, query, opts);
+    }
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usegraft/sdk-react",
-  "version": "0.2.0",
+  "version": "1.0.0-beta.0",
   "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": "0.2.0",
-    "@usegraft/contracts": "0.2.0",
-    "@usegraft/sdk-core": "0.2.0"
+    "@usegraft/content-api": "1.0.0-beta.0",
+    "@usegraft/contracts": "1.0.0-beta.0",
+    "@usegraft/sdk-core": "1.0.0-beta.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "@usegraft/core": "0.2.0",
+    "@usegraft/core": "1.0.0-beta.0",
     "jsdom": "^25.0.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"