@usegraft/sdk-next 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anderson Joseph
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+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 { MDXComponents } from 'mdx/types';
+import { ReactElement } from 'react';
+
+interface Graft<TCollections extends Record<string, AnyCollection>> {
+    /** Request-deduped getDocument. */
+    getContent<K extends keyof TCollections & string>(collection: K, slug: string, options?: ReadOptions): Promise<Document<TCollections[K]> | null>;
+    /** Request-deduped listDocuments. */
+    listContent<K extends keyof TCollections & string>(collection: K, options?: ListOptions): Promise<Document<TCollections[K]>[]>;
+    /** Request-deduped searchDocuments (full-text, best-ranked first). */
+    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>;
+}
+declare function createGraft<TCollections extends Record<string, AnyCollection>>(options: ClientOptions<TCollections>): Graft<TCollections>;
+/** How long a background-revalidated tag may keep serving stale before it hard-expires. */
+type RevalidateProfile = string | {
+    expire?: number;
+};
+/**
+ * Background-invalidate the Data Cache for everything a compile changed, on
+ * `branch`. Call it from a **route handler** (a compile webhook): the next
+ * request triggers a background refresh (stale-while-revalidate). Refreshes
+ * only the changed pages — per-doc + per-collection tags — and returns them.
+ *
+ * `profile` is Next 16's required cache-life argument to `revalidateTag`
+ * (a built-in name like `"max"`/`"hours"` or `{ expire }`); defaults to `"max"`.
+ * A no-op unless the reads were cached with `'use cache'` + `cacheTag`, but
+ * always safe to call.
+ */
+declare function revalidateContent(branch: string, changes: ChangeSet, profile?: RevalidateProfile): string[];
+/**
+ * Immediately invalidate the Data Cache for a compile's changes, with
+ * read-your-own-writes semantics. Call it from a **Server Action** (e.g. an
+ * in-app "publish" that compiles then updates): the same request sees fresh
+ * content. Returns the tags it hit. Like `revalidateContent`, a no-op unless
+ * the reads were cached with `'use cache'` + `cacheTag`.
+ */
+declare function updateContent(branch: string, changes: ChangeSet): string[];
+
+type MdxComponents = MDXComponents;
+interface MdxBodyProps {
+    /** Raw MDX body (the string stored on the document / content_index row). */
+    source: string;
+    /** Component map — typically the generated mdx-components export. */
+    components?: MdxComponents;
+}
+/**
+ * Compile + run an MDX source string and render it with the given components.
+ * Empty source renders nothing (valid for body-less docs).
+ */
+declare function MdxBody({ source, components }: MdxBodyProps): Promise<ReactElement | null>;
+
+export { type Graft, MdxBody, type MdxBodyProps, type MdxComponents, type RevalidateProfile, createGraft, revalidateContent, updateContent };

package/dist/index.js

@@ -0,0 +1,85 @@
+// src/graft.ts
+import { revalidateTag, updateTag } from "next/cache";
+import { cache } from "react";
+import {
+  createClient,
+  tagsForChanges
+} from "@usegraft/sdk-core";
+function createGraft(options) {
+  const client = createClient(options);
+  const cachedGet = cache(
+    (collection, slug, branch) => client.getDocument(
+      collection,
+      slug,
+      branch === void 0 ? void 0 : { branch }
+    )
+  );
+  const cachedList = cache(
+    (collection, branch, limit, offset) => client.listDocuments(collection, { branch, limit, offset })
+  );
+  const cachedSearch = cache(
+    (collection, query, branch, limit) => client.searchDocuments(collection, query, { branch, limit })
+  );
+  return {
+    client,
+    getContent: (collection, slug, opts) => cachedGet(collection, slug, opts?.branch),
+    listContent: (collection, opts) => cachedList(collection, opts?.branch, opts?.limit, opts?.offset),
+    searchContent: (collection, query, opts) => cachedSearch(collection, query, opts?.branch, opts?.limit)
+  };
+}
+function revalidateContent(branch, changes, profile = "max") {
+  const tags = tagsForChanges(branch, changes);
+  for (const tag of tags) revalidateTag(tag, profile);
+  return tags;
+}
+function updateContent(branch, changes) {
+  const tags = tagsForChanges(branch, changes);
+  for (const tag of tags) updateTag(tag);
+  return tags;
+}
+
+// src/mdx.tsx
+import { compile, run } from "@mdx-js/mdx";
+import * as runtime from "react/jsx-runtime";
+import remarkGfm from "remark-gfm";
+import { jsx } from "react/jsx-runtime";
+async function MdxBody({ source, components }) {
+  const trimmed = source.trim();
+  if (trimmed.length === 0) return null;
+  const compiled = String(
+    await compile(trimmed, {
+      outputFormat: "function-body",
+      remarkPlugins: [remarkGfm],
+      development: process.env.NODE_ENV !== "production"
+    })
+  );
+  const { default: Content } = await run(compiled, {
+    ...runtime,
+    baseUrl: import.meta.url
+  });
+  return /* @__PURE__ */ jsx(Content, { components: components ?? {} });
+}
+
+// src/index.ts
+import {
+  createClient as createClient2,
+  toDocument,
+  collectionTag,
+  documentTag,
+  tagsFor,
+  tagsForChanges as tagsForChanges2,
+  TAG_NAMESPACE
+} from "@usegraft/sdk-core";
+export {
+  MdxBody,
+  TAG_NAMESPACE,
+  collectionTag,
+  createClient2 as createClient,
+  createGraft,
+  documentTag,
+  revalidateContent,
+  tagsFor,
+  tagsForChanges2 as tagsForChanges,
+  toDocument,
+  updateContent
+};

package/dist/next-config.d.ts

@@ -0,0 +1,19 @@
+import { NextConfig } from 'next';
+
+/**
+ * withGraft — wrap a Next config with everything a Graft app needs from the
+ * bundler, so consuming apps can't forget it.
+ *
+ * Today that is one thing: `@usegraft/registry` reads its bundled primitives from
+ * disk at runtime (registryRoot() → the package's registry/ dir in
+ * node_modules), so it must stay server-external — bundling it breaks
+ * list_registry / describe_item at runtime with no build-time error. Future
+ * Graft-wide Next requirements land here instead of in every app's config.
+ *
+ * Shipped as its own `@usegraft/sdk-next/config` entry: next.config.ts is loaded
+ * with require semantics and must not drag the React/MDX runtime surface in.
+ */
+
+declare function withGraft(config?: NextConfig): NextConfig;
+
+export { withGraft };

package/dist/next-config.js

@@ -0,0 +1,15 @@
+// src/next-config.ts
+var GRAFT_SERVER_EXTERNALS = ["@usegraft/registry"];
+function withGraft(config = {}) {
+  const existing = config.serverExternalPackages ?? [];
+  return {
+    ...config,
+    serverExternalPackages: [
+      ...existing,
+      ...GRAFT_SERVER_EXTERNALS.filter((pkg) => !existing.includes(pkg))
+    ]
+  };
+}
+export {
+  withGraft
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@usegraft/sdk-next",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AndersonDesign1/graft.git",
+    "directory": "packages/sdk-next"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/next-config.d.ts",
+      "import": "./dist/next-config.js",
+      "default": "./dist/next-config.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mdx-js/mdx": "^3.1.1",
+    "remark-gfm": "^4.0.1",
+    "@usegraft/sdk-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/mdx": "^2.0.14",
+    "@types/react": "^19.0.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "@usegraft/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=15.0.0",
+    "react": "^19.0.0"
+  },
+  "engines": {
+    "node": ">=22.16"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/next-config.ts --format esm --dts --clean --external react --external react/jsx-runtime --external next",
+    "dev": "tsup src/index.ts src/next-config.ts --format esm --watch --external react --external react/jsx-runtime --external next",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "oxlint ."
+  }
+}