@yak-io/prismic 0.1.0

package/LICENSE

@@ -0,0 +1,36 @@
+Yak Proprietary License
+
+Copyright (c) 2025 Yak. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of Yak and are protected by copyright law.
+
+GRANT OF LICENSE:
+Subject to the terms of this license and your valid subscription or agreement
+with Yak, you are granted a limited, non-exclusive, non-transferable license
+to use the Software solely for integrating the Yak chatbot widget into your
+applications as intended and documented.
+
+RESTRICTIONS:
+You may NOT:
+- Modify, adapt, alter, translate, or create derivative works of the Software
+- Reverse engineer, disassemble, decompile, or otherwise attempt to derive
+  the source code of the Software
+- Redistribute, sublicense, lease, rent, or lend the Software to third parties
+- Remove or alter any proprietary notices, labels, or marks on the Software
+- Use the Software for any purpose other than as expressly permitted herein
+
+NO WARRANTY:
+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 YAK
+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.
+
+TERMINATION:
+This license is effective until terminated. Your rights under this license
+will terminate automatically without notice if you fail to comply with any
+of its terms.
+
+For licensing inquiries, contact: support@yak.io

package/README.md

@@ -0,0 +1,96 @@
+# @yak-io/prismic
+
+Adapters that turn Prismic CMS documents into Yak routes, tools, and schema sources. This package plugs directly into `@yak-io/javascript` and works seamlessly with the Next.js and Nuxt helpers.
+
+## What you get
+
+- `createPrismicRouteAdapter` – produces a `RouteSource` from Prismic documents. Use it when your routes live in Prismic instead of (or alongside) the filesystem.
+- `createPrismicToolAdapter` – produces a `ToolSource` exposing `prismic.getByUID`, `prismic.getAllByType`, and `prismic.search` as tools the LLM can invoke.
+- `createPrismicSchemaSource` – produces a `SchemaSource` describing the Prismic content model so the LLM understands document types and fields.
+
+## Installation
+
+```bash
+pnpm add @yak-io/prismic @yak-io/javascript @prismicio/client
+```
+
+`@prismicio/client` is a peer dependency (v7+).
+
+## Usage
+
+### 1. Create a Prismic client
+
+```ts
+import * as prismic from "@prismicio/client";
+
+const client = prismic.createClient("your-repo-name", {
+  accessToken: process.env.PRISMIC_ACCESS_TOKEN,
+});
+```
+
+### 2. Use it with a Yak handler
+
+```ts
+import { createNextYakHandler } from "@yak-io/nextjs/server";
+import {
+  createPrismicRouteAdapter,
+  createPrismicToolAdapter,
+} from "@yak-io/prismic";
+
+const prismicRoutes = createPrismicRouteAdapter({
+  client,
+  documentTypes: ["page", "blog_post"],
+  resolveRoute: (doc) => ({
+    path: `/${doc.uid}`,
+    title: doc.data.meta_title ?? doc.data.title,
+    description: doc.data.meta_description,
+  }),
+});
+
+const prismicTools = createPrismicToolAdapter({
+  client,
+  allowedTypes: ["page", "blog_post"],
+});
+
+export const { GET, POST } = createNextYakHandler({
+  routes: prismicRoutes,
+  tools: prismicTools,
+});
+```
+
+The adapters return standard `RouteSource` / `ToolSource` shapes, so you can compose them with filesystem routes, tRPC tools, or any other source by passing arrays.
+
+### 3. Optionally expose the content model
+
+Inside your client-side `getConfig` provider:
+
+```ts
+import { createPrismicSchemaSource } from "@yak-io/prismic";
+
+const getConfig = async () => {
+  const res = await fetch("/api/yak");
+  const config = await res.json();
+  const schemaSource = await createPrismicSchemaSource({
+    client,
+    mode: "graphql",
+  });
+  return { ...config, schemaSources: [schemaSource] };
+};
+```
+
+## Types
+
+All route/tool/schema types are re-exported from `@yak-io/javascript/server`:
+
+```ts
+import type { RouteSource, ToolSource, SchemaSource } from "@yak-io/prismic";
+```
+
+## Security tips
+
+- Always set `allowedTypes` on the tool adapter — without it the LLM can fetch any document type in your repository.
+- `resolveRoute` returning `null` skips a document — use this to filter drafts or hidden pages out of the manifest.
+
+## License
+
+Proprietary - see LICENSE file

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createPrismicRouteAdapter } from "./route-adapter.js";
+export { createPrismicToolAdapter } from "./tool-adapter.js";
+export { createPrismicSchemaSource } from "./schema-source.js";
+export type { PrismicRouteAdapterConfig, PrismicToolAdapterConfig, PrismicSchemaSourceConfig, PrismicGraphQLSchemaSourceConfig, } from "./types.js";
+export type { RouteInfo, RouteSource, ToolDefinition, ToolExecutor, ToolManifest, ToolSource, } from "@yak-io/javascript/server";
+export type { GraphQLSchemaSource, OpenAPISchemaSource, SchemaSource } from "@yak-io/javascript";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createPrismicRouteAdapter } from "./route-adapter.js";
+export { createPrismicToolAdapter } from "./tool-adapter.js";
+export { createPrismicSchemaSource } from "./schema-source.js";

package/dist/route-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { RouteSource } from "@yak-io/javascript/server";
+import type { PrismicRouteAdapterConfig } from "./types.js";
+export declare function createPrismicRouteAdapter(config: PrismicRouteAdapterConfig): RouteSource;
+//# sourceMappingURL=route-adapter.d.ts.map

package/dist/route-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-adapter.d.ts","sourceRoot":"","sources":["../src/route-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,WAAW,CAqBxF"}

package/dist/route-adapter.js

@@ -0,0 +1,22 @@
+import * as prismic from "@prismicio/client";
+export function createPrismicRouteAdapter(config) {
+    return {
+        id: config.id ?? "prismic",
+        getRoutes: async () => {
+            const docs = await config.client.dangerouslyGetAll({
+                filters: [
+                    prismic.filter.any("document.type", config.documentTypes),
+                    ...(config.filters ?? []),
+                ],
+            });
+            const routes = [];
+            for (const doc of docs) {
+                const route = config.resolveRoute(doc);
+                if (route !== null) {
+                    routes.push(route);
+                }
+            }
+            return routes;
+        },
+    };
+}

package/dist/schema-source.d.ts

@@ -0,0 +1,4 @@
+import type { GraphQLSchemaSource } from "@yak-io/javascript";
+import type { PrismicSchemaSourceConfig } from "./types.js";
+export declare function createPrismicSchemaSource(config: PrismicSchemaSourceConfig): Promise<GraphQLSchemaSource>;
+//# sourceMappingURL=schema-source.d.ts.map

package/dist/schema-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-source.d.ts","sourceRoot":"","sources":["../src/schema-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AA2F5D,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAkC9B"}

package/dist/schema-source.js

@@ -0,0 +1,112 @@
+const INTROSPECTION_QUERY = `query IntrospectionQuery {
+  __schema {
+    queryType { name }
+    mutationType { name }
+    subscriptionType { name }
+    types {
+      ...FullType
+    }
+    directives {
+      name
+      description
+      locations
+      args { ...InputValue }
+    }
+  }
+}
+fragment FullType on __Type {
+  kind
+  name
+  description
+  fields(includeDeprecated: true) {
+    name
+    description
+    args { ...InputValue }
+    type { ...TypeRef }
+    isDeprecated
+    deprecationReason
+  }
+  inputFields { ...InputValue }
+  interfaces { ...TypeRef }
+  enumValues(includeDeprecated: true) {
+    name
+    description
+    isDeprecated
+    deprecationReason
+  }
+  possibleTypes { ...TypeRef }
+}
+fragment InputValue on __InputValue {
+  name
+  description
+  type { ...TypeRef }
+  defaultValue
+}
+fragment TypeRef on __Type {
+  kind
+  name
+  ofType {
+    kind
+    name
+    ofType {
+      kind
+      name
+      ofType {
+        kind
+        name
+        ofType {
+          kind
+          name
+          ofType {
+            kind
+            name
+            ofType {
+              kind
+              name
+              ofType { kind name }
+            }
+          }
+        }
+      }
+    }
+  }
+}`;
+function deriveGraphQLEndpoint(restEndpoint) {
+    const trimmed = restEndpoint.replace(/\/api\/v\d+\/?$/, "");
+    return `${trimmed}/graphql`;
+}
+async function loadGraphQLModule() {
+    try {
+        return await import("graphql");
+    }
+    catch {
+        throw new Error("createPrismicSchemaSource with mode 'graphql' requires the 'graphql' package. Install it as a peer dependency: pnpm add graphql");
+    }
+}
+export async function createPrismicSchemaSource(config) {
+    if (config.mode !== "graphql") {
+        throw new Error(`Unsupported schema source mode: ${config.mode}`);
+    }
+    const fetchFn = config.fetchFn ?? fetch;
+    const endpoint = deriveGraphQLEndpoint(config.client.endpoint);
+    const response = await fetchFn(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ query: INTROSPECTION_QUERY }),
+    });
+    if (!response.ok) {
+        throw new Error(`Prismic GraphQL introspection failed: ${response.status} ${response.statusText}`);
+    }
+    const payload = (await response.json());
+    if (payload.errors || !payload.data) {
+        throw new Error("Prismic GraphQL introspection returned no data");
+    }
+    const { buildClientSchema, printSchema } = await loadGraphQLModule();
+    const schema = buildClientSchema(payload.data);
+    const sdl = printSchema(schema);
+    return {
+        name: config.name ?? "prismic",
+        type: "graphql",
+        schema: sdl,
+    };
+}

package/dist/tool-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { ToolSource } from "@yak-io/javascript/server";
+import type { PrismicToolAdapterConfig } from "./types.js";
+export declare function createPrismicToolAdapter(config: PrismicToolAdapterConfig): ToolSource;
+//# sourceMappingURL=tool-adapter.d.ts.map

package/dist/tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.d.ts","sourceRoot":"","sources":["../src/tool-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgC,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AA2E3D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,UAAU,CA4DrF"}

package/dist/tool-adapter.js

@@ -0,0 +1,119 @@
+import * as prismic from "@prismicio/client";
+const TOOL_DEFINITIONS = [
+    {
+        name: "prismic.getByUID",
+        description: "Fetch a single Prismic document by document type and UID. Use this when you know the exact UID of a page or post.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    description: "The Prismic custom type (for example 'page' or 'blog_post')",
+                },
+                uid: {
+                    type: "string",
+                    description: "The unique identifier of the document",
+                },
+            },
+            required: ["type", "uid"],
+        },
+    },
+    {
+        name: "prismic.getAllByType",
+        description: "Fetch all Prismic documents of a given type. Use this to list pages or posts of a particular kind.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    description: "The Prismic custom type to list",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of documents to return (default 20)",
+                },
+            },
+            required: ["type"],
+        },
+    },
+    {
+        name: "prismic.search",
+        description: "Full-text search across Prismic documents. Returns documents whose fields match the query.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The free-text search query",
+                },
+                types: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional list of document types to restrict the search to. Defaults to all allowed types.",
+                },
+            },
+            required: ["query"],
+        },
+    },
+];
+function buildGraphQuery(fields, type) {
+    const typeFields = fields?.[type];
+    if (!typeFields || typeFields.length === 0) {
+        return undefined;
+    }
+    return `{ ${type} { ${typeFields.join(" ")} } }`;
+}
+export function createPrismicToolAdapter(config) {
+    const allowed = new Set(config.allowedTypes);
+    const assertAllowed = (type) => {
+        if (typeof type !== "string" || !allowed.has(type)) {
+            throw new Error(`Prismic document type '${String(type)}' is not in allowedTypes`);
+        }
+        return type;
+    };
+    const executor = async (name, args) => {
+        const input = (args ?? {});
+        switch (name) {
+            case "prismic.getByUID": {
+                const type = assertAllowed(input.type);
+                const uid = input.uid;
+                if (typeof uid !== "string" || uid.length === 0) {
+                    throw new Error("prismic.getByUID requires a 'uid' string");
+                }
+                const graphQuery = buildGraphQuery(config.fields, type);
+                return await config.client.getByUID(type, uid, graphQuery ? { graphQuery } : undefined);
+            }
+            case "prismic.getAllByType": {
+                const type = assertAllowed(input.type);
+                const limit = typeof input.limit === "number" ? input.limit : 20;
+                const graphQuery = buildGraphQuery(config.fields, type);
+                return await config.client.getAllByType(type, {
+                    limit,
+                    ...(graphQuery ? { graphQuery } : {}),
+                });
+            }
+            case "prismic.search": {
+                const query = input.query;
+                if (typeof query !== "string" || query.length === 0) {
+                    throw new Error("prismic.search requires a 'query' string");
+                }
+                const requestedTypes = Array.isArray(input.types)
+                    ? input.types.map((t) => assertAllowed(t))
+                    : [...allowed];
+                return await config.client.get({
+                    filters: [
+                        prismic.filter.fulltext("document", query),
+                        prismic.filter.any("document.type", requestedTypes),
+                    ],
+                });
+            }
+            default:
+                throw new Error(`Unknown Prismic tool: ${name}`);
+        }
+    };
+    return {
+        id: config.id ?? "prismic",
+        getTools: async () => TOOL_DEFINITIONS,
+        executeTool: executor,
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,23 @@
+import type { Client, PrismicDocument } from "@prismicio/client";
+import type { RouteInfo } from "@yak-io/javascript/server";
+export type PrismicRouteAdapterConfig = {
+    id?: string;
+    client: Client;
+    documentTypes: string[];
+    resolveRoute: (doc: PrismicDocument) => RouteInfo | null;
+    filters?: string[];
+};
+export type PrismicToolAdapterConfig = {
+    id?: string;
+    client: Client;
+    allowedTypes: string[];
+    fields?: Record<string, string[]>;
+};
+export type PrismicGraphQLSchemaSourceConfig = {
+    client: Client;
+    mode: "graphql";
+    name?: string;
+    fetchFn?: typeof fetch;
+};
+export type PrismicSchemaSourceConfig = PrismicGraphQLSchemaSourceConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,SAAS,GAAG,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,gCAAgC,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@yak-io/prismic",
+  "version": "0.1.0",
+  "description": "Prismic CMS adapter for yak chatbot - exposes Prismic documents as routes, tools, and schema sources",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Yak <support@yak.io>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/388-labs/yak.git",
+    "directory": "packages/prismic"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "yak",
+    "chatbot",
+    "ai",
+    "prismic",
+    "cms"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@yak-io/javascript": "0.7.0"
+  },
+  "peerDependencies": {
+    "@prismicio/client": "^7.0.0",
+    "graphql": "^16.0.0"
+  },
+  "peerDependenciesMeta": {
+    "graphql": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@prismicio/client": "^7.13.1",
+    "@types/node": "^24.12.4",
+    "graphql": "^16.9.0",
+    "typescript": "^5.3.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "biome lint ./src --fix",
+    "format": "biome format ./src --write"
+  }
+}