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

package/README.md

@@ -15,11 +15,15 @@ npm i @usegraft/sdk-next
 `createGraft` wraps the read client with `React.cache`, so repeated reads of the same document within one render are deduped. Server-only: it holds a database handle.
 
 ```ts
+// lib/graft.ts
+import { createDb } from "@usegraft/db";
 import { createGraft } from "@usegraft/sdk-next";
 import { collections } from "@/graft.config";
 
-export const graft = createGraft({ db, collections });
+export const graft = createGraft({ db: createDb(process.env.DATABASE_URL!).db, collections });
+```
 
+```ts
 // in a Server Component
 const page = await graft.getContent("pages", "home");
 const posts = await graft.listContent("posts", { limit: 10 });
@@ -27,6 +31,19 @@ const posts = await graft.listContent("posts", { limit: 10 });
 
 Return types come from your `defineCollection` schemas, so a renamed field is a build error rather than a runtime `undefined`.
 
+### With no database
+
+Pass `index` instead of `db` and the same surface reads the SQLite artifact `graft compile` writes. Nothing else has to be running.
+
+```ts
+import { openStaticIndex } from "@usegraft/db";
+
+export const graft = createGraft({
+  index: await openStaticIndex(".graft/index.db"),
+  collections,
+});
+```
+
 ## Render MDX bodies
 
 ```tsx
@@ -56,4 +73,4 @@ Both turn a compile's `ChangeSet` into the exact `revalidateTag` / `updateTag` c
 
 ---
 
-MIT. [Repository](https://github.com/AndersonDesign1/graft) · [Changelog](https://github.com/AndersonDesign1/graft/blob/feat/core/packages/sdk-next/CHANGELOG.md)
+MIT. [Repository](https://github.com/AndersonDesign1/graft) · [Changelog](https://github.com/AndersonDesign1/graft/blob/main/packages/sdk-next/CHANGELOG.md)

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { DbClientOptions } from '@usegraft/sdk-core/db';
 import { AnyCollection, ReadOptions, Document, ListOptions, SearchOptions, SearchHit, GraftClient, ClientOptions, ChangeSet } from '@usegraft/sdk-core';
 export { AnyCollection, ChangeSet, ClientOptions, Document, GraftClient, ListOptions, ReadOptions, SearchHit, SearchOptions, TAG_NAMESPACE, collectionTag, createClient, documentTag, tagsFor, tagsForChanges, toDocument } from '@usegraft/sdk-core';
 import { MdxTrust } from '@usegraft/mdx-safety';
@@ -15,7 +16,15 @@ interface Graft<TCollections extends Record<string, AnyCollection>> {
     /** The underlying sdk-core client, for anything the helpers don't cover. */
     client: GraftClient<TCollections>;
 }
-declare function createGraft<TCollections extends Record<string, AnyCollection>>(options: ClientOptions<TCollections>): Graft<TCollections>;
+/**
+ * Either an index this adapter reads through, or a Postgres handle it builds
+ * the reader for. Two shapes rather than one optional field so that neither can
+ * be omitted: `createClient` no longer accepts `db`, because taking it there
+ * meant every consumer of `@usegraft/sdk-core` — the browser client included —
+ * carried a Postgres driver in its dependency graph.
+ */
+type GraftOptions<TCollections extends Record<string, AnyCollection>> = ClientOptions<TCollections> | DbClientOptions<TCollections>;
+declare function createGraft<TCollections extends Record<string, AnyCollection>>(options: GraftOptions<TCollections>): Graft<TCollections>;
 /** How long a background-revalidated tag may keep serving stale before it hard-expires. */
 type RevalidateProfile = string | {
     expire?: number;
@@ -73,4 +82,4 @@ interface MdxBodyProps {
  */
 declare function MdxBody({ source, components, trust, }: MdxBodyProps): Promise<ReactElement | null>;
 
-export { type Graft, MdxBody, type MdxBodyProps, type MdxComponents, type RevalidateProfile, createGraft, revalidateContent, updateContent };
+export { type Graft, type GraftOptions, MdxBody, type MdxBodyProps, type MdxComponents, type RevalidateProfile, createGraft, revalidateContent, updateContent };

package/dist/index.js

@@ -1,12 +1,13 @@
 // src/graft.ts
 import { revalidateTag, updateTag } from "next/cache";
 import { cache } from "react";
+import { createDbClient } from "@usegraft/sdk-core/db";
 import {
   createClient,
   tagsForChanges
 } from "@usegraft/sdk-core";
 function createGraft(options) {
-  const client = createClient(options);
+  const client = "db" in options ? createDbClient(options) : createClient(options);
   const cachedGet = cache(
     (collection, slug, branch) => client.getDocument(
       collection,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usegraft/sdk-next",
-  "version": "0.2.0",
+  "version": "1.0.0-beta.0",
   "description": "Next.js App Router adapter: typed content reads in Server Components, cache-tag invalidation, and real MDX rendering.",
   "keywords": [
     "agent",
@@ -46,14 +46,15 @@
   },
   "dependencies": {
     "@mdx-js/mdx": "^3.1.1",
-    "@usegraft/mdx-safety": "0.2.0",
-    "@usegraft/sdk-core": "0.2.0",
+    "@usegraft/db": "1.0.0-beta.0",
+    "@usegraft/mdx-safety": "1.0.0-beta.0",
+    "@usegraft/sdk-core": "1.0.0-beta.0",
     "remark-gfm": "^4.0.1"
   },
   "devDependencies": {
     "@types/mdx": "^2.0.14",
     "@types/react": "^19.0.0",
-    "@usegraft/core": "0.2.0",
+    "@usegraft/core": "1.0.0-beta.0",
     "next": "^16.0.0",
     "react": "^19.0.0"
   },