@usegraft/sdk-astro 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,61 @@
+import { AnyCollection, ReadOptions, Document, ListOptions, SearchOptions, SearchHit, GraftClient, ClientOptions } 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';
+
+/**
+ * Astro adapter over @usegraft/sdk-core — the same `getContent` / `listContent` /
+ * `searchContent` surface as @usegraft/sdk-next, so a schema types every read
+ * identically across frameworks.
+ *
+ * No request-level memo here (sdk-next's React.cache has no Astro
+ * equivalent): reads go straight to Postgres. In practice that's the right
+ * default — prerendered pages read at build time, and an SSR page makes a
+ * handful of reads. Server-only by nature (it holds a database handle); use
+ * it from .astro frontmatter, endpoints, and middleware — never client
+ * islands.
+ *
+ * Caching: Astro has no tag-based data cache, so the Phase 4 tag contract
+ * maps onto HTTP — stamp `tagsFor(...)` into a CDN surrogate-key header
+ * (`Cache-Tag` / `Surrogate-Key`) on SSR responses, and purge
+ * `tagsForChanges(branch, changeSet)` from your compile webhook.
+ */
+
+interface Graft<TCollections extends Record<string, AnyCollection>> {
+    /** Typed getDocument. */
+    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). */
+    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>;
+
+/**
+ * Mounting the Graft runtime in Astro — endpoints are already Web-standard,
+ * so the "adapter" is one property access: Astro hands an APIContext, the
+ * handlers want its `request`.
+ *
+ * ```ts
+ * // src/pages/api/fn/[name].ts
+ * import { createFunctionsHandler } from "@usegraft/core";
+ * import { graftRoute } from "@usegraft/sdk-astro";
+ * const handler = createFunctionsHandler({ … });
+ * export const POST = graftRoute(handler);
+ * export const GET = graftRoute(handler);   // 405s with Allow + fix
+ *
+ * // src/pages/api/mcp.ts
+ * import { createGraftMcpHandler } from "@usegraft/mcp";
+ * export const POST = graftRoute(createGraftMcpHandler({ … }));
+ * ```
+ *
+ * Typed structurally (`{ request: Request }`) so this package needs no astro
+ * dependency — every APIContext satisfies it.
+ */
+type FetchHandler = (request: Request) => Promise<Response>;
+/** An Astro APIRoute (or anything context-shaped) over a Graft handler. */
+declare function graftRoute(handler: FetchHandler): (context: {
+    request: Request;
+}) => Promise<Response>;
+
+export { type FetchHandler, type Graft, createGraft, graftRoute };

package/dist/index.js

@@ -0,0 +1,40 @@
+// src/graft.ts
+import {
+  createClient
+} from "@usegraft/sdk-core";
+function createGraft(options) {
+  const client = createClient(options);
+  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)
+  };
+}
+
+// src/routes.ts
+function graftRoute(handler) {
+  return (context) => handler(context.request);
+}
+
+// src/index.ts
+import {
+  createClient as createClient2,
+  toDocument,
+  collectionTag,
+  documentTag,
+  tagsFor,
+  tagsForChanges,
+  TAG_NAMESPACE
+} from "@usegraft/sdk-core";
+export {
+  TAG_NAMESPACE,
+  collectionTag,
+  createClient2 as createClient,
+  createGraft,
+  documentTag,
+  graftRoute,
+  tagsFor,
+  tagsForChanges,
+  toDocument
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@usegraft/sdk-astro",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AndersonDesign1/graft.git",
+    "directory": "packages/sdk-astro"
+  },
+  "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"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@usegraft/sdk-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@usegraft/core": "0.1.0"
+  },
+  "engines": {
+    "node": ">=22.16"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "oxlint ."
+  }
+}