@btst/stack 2.12.2 → 3.0.0-rc.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "2.12.2",
+  "version": "3.0.0-rc.2",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",
@@ -87,6 +87,36 @@
         "default": "./dist/context/index.cjs"
       }
     },
+    "./next": {
+      "import": {
+        "types": "./dist/next/index.d.ts",
+        "default": "./dist/next/index.mjs"
+      },
+      "require": {
+        "types": "./dist/next/index.d.cts",
+        "default": "./dist/next/index.cjs"
+      }
+    },
+    "./react-router": {
+      "import": {
+        "types": "./dist/react-router/index.d.ts",
+        "default": "./dist/react-router/index.mjs"
+      },
+      "require": {
+        "types": "./dist/react-router/index.d.cts",
+        "default": "./dist/react-router/index.cjs"
+      }
+    },
+    "./tanstack": {
+      "import": {
+        "types": "./dist/tanstack/index.d.ts",
+        "default": "./dist/tanstack/index.mjs"
+      },
+      "require": {
+        "types": "./dist/tanstack/index.d.cts",
+        "default": "./dist/tanstack/index.cjs"
+      }
+    },
     "./plugins/api": {
       "import": {
         "types": "./dist/plugins/api/index.d.ts",
@@ -107,6 +137,16 @@
         "default": "./dist/plugins/client/index.cjs"
       }
     },
+    "./plugins/client/hooks": {
+      "import": {
+        "types": "./dist/plugins/client/hooks/index.d.ts",
+        "default": "./dist/plugins/client/hooks/index.mjs"
+      },
+      "require": {
+        "types": "./dist/plugins/client/hooks/index.d.cts",
+        "default": "./dist/plugins/client/hooks/index.cjs"
+      }
+    },
     "./plugins/blog/api": {
       "import": {
         "types": "./dist/plugins/blog/api/index.d.ts",
@@ -197,6 +237,16 @@
         "default": "./dist/plugins/ai-chat/client/context/page-ai-context.cjs"
       }
     },
+    "./plugins/ai-chat/query-keys": {
+      "import": {
+        "types": "./dist/plugins/ai-chat/query-keys.d.ts",
+        "default": "./dist/plugins/ai-chat/query-keys.mjs"
+      },
+      "require": {
+        "types": "./dist/plugins/ai-chat/query-keys.d.cts",
+        "default": "./dist/plugins/ai-chat/query-keys.cjs"
+      }
+    },
     "./plugins/ai-chat/css": "./dist/plugins/ai-chat/style.css",
     "./plugins/blog/css": "./dist/plugins/blog/style.css",
     "./plugins/cms/api": {
@@ -321,6 +371,16 @@
         "default": "./dist/plugins/ui-builder/client/hooks/index.cjs"
       }
     },
+    "./plugins/ui-builder/query-keys": {
+      "import": {
+        "types": "./dist/plugins/ui-builder/query-keys.d.ts",
+        "default": "./dist/plugins/ui-builder/query-keys.mjs"
+      },
+      "require": {
+        "types": "./dist/plugins/ui-builder/query-keys.d.cts",
+        "default": "./dist/plugins/ui-builder/query-keys.cjs"
+      }
+    },
     "./plugins/ui-builder/css": "./dist/plugins/ui-builder/style.css",
     "./plugins/open-api/api": {
       "import": {
@@ -605,12 +665,24 @@
       "context": [
         "./dist/context/index.d.ts"
       ],
+      "next": [
+        "./dist/next/index.d.ts"
+      ],
+      "react-router": [
+        "./dist/react-router/index.d.ts"
+      ],
+      "tanstack": [
+        "./dist/tanstack/index.d.ts"
+      ],
       "plugins/api": [
         "./dist/plugins/api/index.d.ts"
       ],
       "plugins/client": [
         "./dist/plugins/client/index.d.ts"
       ],
+      "plugins/client/hooks": [
+        "./dist/plugins/client/hooks/index.d.ts"
+      ],
       "plugins/blog/api": [
         "./dist/plugins/blog/api/index.d.ts"
       ],
@@ -638,6 +710,9 @@
       "plugins/ai-chat/client/context": [
         "./dist/plugins/ai-chat/client/context/page-ai-context.d.ts"
       ],
+      "plugins/ai-chat/query-keys": [
+        "./dist/plugins/ai-chat/query-keys.d.ts"
+      ],
       "plugins/cms/api": [
         "./dist/plugins/cms/api/index.d.ts"
       ],
@@ -674,6 +749,9 @@
       "plugins/ui-builder/client/hooks": [
         "./dist/plugins/ui-builder/client/hooks/index.d.ts"
       ],
+      "plugins/ui-builder/query-keys": [
+        "./dist/plugins/ui-builder/query-keys.d.ts"
+      ],
       "plugins/open-api/api": [
         "./dist/plugins/open-api/api/index.d.ts"
       ],
@@ -755,8 +833,7 @@
     }
   },
   "dependencies": {
-    "@btst/db": "2.2.2",
-    "@lukemorales/query-key-factory": "^1.3.4",
+    "@btst/db": "2.2.3",
     "@milkdown/crepe": "^7.17.1",
     "@milkdown/kit": "^7.17.1",
     "remend": "^1.0.1",
@@ -766,7 +843,7 @@
     "@ai-sdk/react": ">=2.0.0",
     "@aws-sdk/client-s3": ">=3.0.0",
     "@aws-sdk/s3-request-presigner": ">=3.0.0",
-    "@btst/yar": ">=1.2.0",
+    "@btst/yar": ">=1.3.2",
     "@hookform/resolvers": ">=5.0.0",
     "@radix-ui/react-dialog": ">=1.1.0",
     "@radix-ui/react-label": ">=2.1.0",
@@ -774,9 +851,10 @@
     "@radix-ui/react-switch": ">=1.1.0",
     "@tailwindcss/typography": ">=0.5.0",
     "@tanstack/react-query": "^5.0.0",
+    "@tanstack/react-router": ">=1.0.0",
     "@vercel/blob": ">=0.14.0",
     "ai": ">=5.0.0",
-    "better-call": ">=1.3.5",
+    "better-call": "1.3.6",
     "class-variance-authority": ">=0.7.0",
     "clsx": ">=2.1.0",
     "cmdk": ">=1.1.0",
@@ -784,11 +862,13 @@
     "highlight.js": ">=11.9.0",
     "katex": ">=0.16.0",
     "lucide-react": ">=0.469.0",
+    "next": ">=15.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "react-error-boundary": ">=4.0.0",
     "react-hook-form": ">=7.55.0",
     "react-markdown": ">=9.1.0",
+    "react-router": ">=7.0.0",
     "rehype-highlight": ">=7.0.0",
     "rehype-katex": ">=7.0.0",
     "rehype-raw": ">=7.0.0",
@@ -808,24 +888,38 @@
     },
     "@aws-sdk/s3-request-presigner": {
       "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "react-router": {
+      "optional": true
+    },
+    "@tanstack/react-router": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@ai-sdk/react": "^2.0.94",
     "@aws-sdk/client-s3": "^3.1011.0",
     "@aws-sdk/s3-request-presigner": "^3.1011.0",
-    "@btst/adapter-memory": "2.2.2",
-    "@btst/yar": "1.2.0",
+    "@btst/adapter-memory": "2.2.3",
+    "@btst/yar": "1.3.2",
+    "@tanstack/react-router": "1.168.10",
     "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
     "@types/slug": "^5.0.9",
     "@vercel/blob": "^0.27.3",
     "@workspace/ui": "workspace:*",
     "ai": "^5.0.94",
     "better-call": "catalog:",
+    "jsdom": "^28.1.0",
     "knip": "^5.61.2",
+    "next": "16.0.10",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-error-boundary": "^4.1.2",
+    "react-router": "^7.13.1",
     "rollup-plugin-preserve-directives": "0.4.0",
     "rollup-plugin-visualizer": "^5.12.0",
     "tsx": "catalog:",

package/src/__tests__/ai-chat-query-keys.test.ts

@@ -0,0 +1,126 @@
+import { describe, expect, it, vi } from "vitest";
+import { runResourceMutation } from "../plugins/client";
+import {
+	aiChatResources,
+	createAiChatQueryKeys,
+} from "../plugins/ai-chat/query-keys";
+import { updateConversationSchema } from "../plugins/ai-chat/schemas";
+
+describe("AI Chat resource declaration", () => {
+	it("preserves the v3 conversation query keys", () => {
+		const client = vi.fn() as any;
+		const queries = createAiChatQueryKeys(client);
+
+		expect([...queries.conversations._def]).toEqual(["conversations"]);
+		expect([...queries.conversations.list().queryKey]).toEqual([
+			"conversations",
+			"list",
+			"all",
+		]);
+		expect([...queries.conversations.detail("conv-1").queryKey]).toEqual([
+			"conversations",
+			"detail",
+			"conv-1",
+		]);
+	});
+
+	it("forwards headers through list and detail requests", async () => {
+		const client = vi
+			.fn()
+			.mockResolvedValueOnce({ data: [] })
+			.mockResolvedValueOnce({ data: null }) as any;
+		const headers = { authorization: "Bearer test" };
+		const queries = createAiChatQueryKeys(client, headers);
+
+		await queries.conversations.list().queryFn();
+		expect(client).toHaveBeenLastCalledWith("/chat/conversations", {
+			method: "GET",
+			headers,
+		});
+
+		await queries.conversations.detail("conv-1").queryFn();
+		expect(client).toHaveBeenLastCalledWith("/chat/conversations/:id", {
+			method: "GET",
+			params: { id: "conv-1" },
+			headers,
+		});
+	});
+
+	it("maps create, rename, and delete mutations and forwards headers", async () => {
+		const client = vi
+			.fn()
+			.mockResolvedValueOnce({ data: { id: "conv-1", title: "New" } })
+			.mockResolvedValueOnce({ data: { id: "conv-1", title: "Renamed" } })
+			.mockResolvedValueOnce({ data: { success: true } }) as any;
+		const headers = { authorization: "Bearer test" };
+
+		await runResourceMutation(
+			client,
+			aiChatResources.conversations.mutations.create,
+			{ id: "conv-1", title: "New" },
+			headers,
+		);
+		expect(client).toHaveBeenLastCalledWith("@post/chat/conversations", {
+			method: "POST",
+			body: { id: "conv-1", title: "New" },
+			headers,
+		});
+
+		await runResourceMutation(
+			client,
+			aiChatResources.conversations.mutations.rename,
+			{ id: "conv-1", title: "Renamed" },
+			headers,
+		);
+		expect(client).toHaveBeenLastCalledWith("@put/chat/conversations/:id", {
+			method: "PUT",
+			params: { id: "conv-1" },
+			body: { title: "Renamed" },
+			headers,
+		});
+
+		await runResourceMutation(
+			client,
+			aiChatResources.conversations.mutations.delete,
+			{ id: "conv-1" },
+			headers,
+		);
+		expect(client).toHaveBeenLastCalledWith("@delete/chat/conversations/:id", {
+			method: "DELETE",
+			params: { id: "conv-1" },
+			headers,
+		});
+	});
+
+	it("trims rename titles and rejects empty values", () => {
+		expect(updateConversationSchema.parse({ title: "  Renamed  " })).toEqual({
+			title: "Renamed",
+		});
+		expect(updateConversationSchema.safeParse({ title: "   " }).success).toBe(
+			false,
+		);
+	});
+
+	it("only merges rename results into an existing detail cache entry", () => {
+		const updater =
+			aiChatResources.conversations.mutations.rename.setData.updater;
+		const renamed = {
+			id: "conv-1",
+			title: "Renamed",
+			createdAt: new Date("2024-01-01").toISOString(),
+			updatedAt: new Date("2024-01-03").toISOString(),
+		};
+
+		expect(updater(undefined, renamed)).toBeUndefined();
+		expect(
+			updater(
+				{
+					...renamed,
+					title: "Original",
+					messages: [{ id: "message-1" }],
+				},
+				renamed,
+			),
+		).toEqual({ ...renamed, messages: [{ id: "message-1" }] });
+	});
+});