fix(useTriggerChat): make AI SDK dependencies optional peer dependencies

Author: jakevollkommer

packages/react-hooks/package.json

@@ -37,11 +37,7 @@
     "check-exports": "attw --pack ."
   },
   "dependencies": {
-    "@ai-sdk/react": "^2.0.14",
-    "@electric-sql/client": "1.0.14",
     "@trigger.dev/core": "workspace:^4.0.5",
-    "ai": "^5.0.82",
-    "eventsource-parser": "^3.0.0",
     "swr": "^2.2.5"
   },
   "devDependencies": {
@@ -54,7 +50,25 @@
   },
   "peerDependencies": {
     "react": "^18.0 || ^19.0 || ^19.0.0-rc",
-    "react-dom": "^18.0 || ^19.0 || ^19.0.0-rc"
+    "react-dom": "^18.0 || ^19.0 || ^19.0.0-rc",
+    "@ai-sdk/react": "^2.0.0",
+    "@electric-sql/client": "^1.0.0",
+    "ai": "^5.0.0",
+    "eventsource-parser": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/react": {
+      "optional": true
+    },
+    "@electric-sql/client": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    },
+    "eventsource-parser": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=18.20.0"

packages/react-hooks/src/hooks/useTriggerChat.ts

@@ -2,7 +2,6 @@
 
 import { ShapeStream } from "@electric-sql/client";
 import { EventSourceParserStream } from "eventsource-parser/stream";
-
 import { useChat, type UseChatHelpers } from "@ai-sdk/react";
 import type {
   UIMessage,
@@ -488,6 +487,39 @@ async function streamDataFromTrigger(params: {
   }
 }
 
+function checkRequiredPeerDependencies() {
+  const requiredPackages = [
+    "@ai-sdk/react",
+    "ai",
+    "@electric-sql/client",
+    "eventsource-parser",
+  ];
+
+  const missing = requiredPackages.filter((pkg) => {
+    try {
+      require.resolve(pkg);
+      return false;
+    } catch {
+      return true;
+    }
+  });
+
+  if (!missing.length) return;
+
+  const packages = missing.join(" ");
+
+  throw new Error(
+    `useTriggerChat requires the following packages:\n${missing
+      .map((pkg) => `  - ${pkg}`)
+      .join("\n")}\n\n` +
+      `Install them with:\n` +
+      `  npm install ${packages}\n` +
+      `  yarn add ${packages}\n` +
+      `  pnpm add ${packages}\n` +
+      `  bun add ${packages}`,
+  );
+}
+
 type UseTriggerChatOptions = {
   transportOptions: TriggerChatTransportOptions;
 } & Omit<ChatInit<UIMessage>, "transport">;
@@ -575,6 +607,7 @@ type UseTriggerChatOptions = {
 export function useTriggerChat(
   options: UseTriggerChatOptions,
 ): UseChatHelpers<UIMessage> {
+  checkRequiredPeerDependencies();
   const { transportOptions, ...chatOptions } = options;
 
   return useChat({