@yak-io/nextjs 0.1.6 → 0.2.0

package/README.md

@@ -263,6 +263,54 @@ export const { GET, POST } = createNextYakHandler({
 | `onRedirect` | `(path: string) => void` | Custom navigation handler |
 | `disableRestartButton` | `boolean` | Hide the restart session button in the header |
 
+## Hooks
+
+### useYak
+
+Access the widget API from any component:
+
+```tsx
+import { useYak } from "@yak-io/nextjs/client";
+
+export function ChatButton() {
+  const { open, close, openWithPrompt, isOpen } = useYak();
+  return <button onClick={() => open()}>Open Chat</button>;
+}
+```
+
+### useYakToolEvent
+
+Subscribe to tool call completion events for page-level cache invalidation:
+
+```tsx
+import { useYakToolEvent } from "@yak-io/nextjs/client";
+import { trpc } from "@/utils/trpc";
+
+function PlanPage({ planId }: { planId: string }) {
+  const utils = trpc.useUtils();
+  
+  useYakToolEvent((event) => {
+    // Invalidate cache when plan-related tools are called
+    if (event.ok && event.name.startsWith("plan.")) {
+      utils.plan.get.invalidate({ id: planId });
+      utils.planItem.list.invalidate({ planId });
+    }
+  });
+  
+  // ... component rendering
+}
+```
+
+The event object contains:
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `name` | `string` | The tool name that was called |
+| `args` | `unknown` | The arguments passed to the tool |
+| `ok` | `boolean` | Whether the call succeeded |
+| `result` | `unknown` | The result (if `ok` is true) |
+| `error` | `string` | The error message (if `ok` is false) |
+
 `YakWidget` renders the launcher + iframe shell. It accepts:
 
 | Prop | Type | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yak-io/nextjs",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Next.js SDK for embedding yak chatbot with route manifest generation",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -60,8 +60,8 @@
     "yak-nextjs": "./dist/cli/generate-manifest.js"
   },
   "dependencies": {
-    "@yak-io/javascript": "0.1.1",
-    "@yak-io/react": "0.1.1"
+    "@yak-io/javascript": "0.2.0",
+    "@yak-io/react": "0.2.0"
   },
   "peerDependencies": {
     "next": "^14.0.0 || ^15.0.0",