@yak-io/react 0.1.0 → 0.2.0

package/dist/YakProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"YakProvider.d.ts","sourceRoot":"","sources":["../src/YakProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,EAEL,KAAK,KAAK,EAGV,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,oBAAoB,EACpB,QAAQ,GACT,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAgMtC"}
+{"version":3,"file":"YakProvider.d.ts","sourceRoot":"","sources":["../src/YakProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,EAEL,KAAK,KAAK,EAGV,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,oBAAoB,EACpB,QAAQ,GACT,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmOtC"}

package/dist/YakProvider.js

@@ -13,6 +13,24 @@ export function YakProvider({ appId, getConfig, onToolCall, onGraphQLSchemaCall,
     const [isWidgetOpen, setIsWidgetOpen] = useState(false);
     const [pendingPrompt, setPendingPrompt] = useState(null);
     const [isIframeReady, setIsIframeReady] = useState(false);
+    // Store event subscribers for tool call events
+    const toolEventSubscribersRef = useRef(new Set());
+    // Handler that notifies all subscribers when a tool call completes
+    const handleToolCallComplete = useCallback((event) => {
+        logger.debug("Tool call completed, notifying subscribers:", {
+            name: event.name,
+            ok: event.ok,
+            subscriberCount: toolEventSubscribersRef.current.size,
+        });
+        for (const handler of toolEventSubscribersRef.current) {
+            try {
+                handler(event);
+            }
+            catch (err) {
+                logger.warn("Error in tool event subscriber:", err);
+            }
+        }
+    }, []);
     // Initialize YakClient
     const clientRef = useRef(null);
     if (!clientRef.current) {
@@ -26,6 +44,7 @@ export function YakProvider({ appId, getConfig, onToolCall, onGraphQLSchemaCall,
             options: { disableRestartButton },
             onClose: () => setIsWidgetOpen(false),
             onReady: () => setIsIframeReady(true),
+            onToolCallComplete: handleToolCallComplete,
         });
     }
     const client = clientRef.current;
@@ -42,8 +61,9 @@ export function YakProvider({ appId, getConfig, onToolCall, onGraphQLSchemaCall,
             onRedirect,
             options: { disableRestartButton },
             chatConfig: chatConfig ?? undefined,
+            onToolCallComplete: handleToolCallComplete,
         });
-    }, [appId, onToolCall, onGraphQLSchemaCall, onRESTSchemaCall, theme, onRedirect, disableRestartButton, chatConfig, client]);
+    }, [appId, onToolCall, onGraphQLSchemaCall, onRESTSchemaCall, theme, onRedirect, disableRestartButton, chatConfig, client, handleToolCallComplete]);
     // Update client iframe window
     useEffect(() => {
         client.setIframeWindow(iframeWindow);
@@ -141,6 +161,16 @@ export function YakProvider({ appId, getConfig, onToolCall, onGraphQLSchemaCall,
             iframeWindow.postMessage(focusMessage, iframeOrigin);
         }
     }, [isWidgetOpen, iframeWindow, isIframeReady, iframeOrigin]);
+    // Subscribe to tool call completion events
+    const subscribeToToolEvents = useCallback((handler) => {
+        toolEventSubscribersRef.current.add(handler);
+        logger.debug("Tool event subscriber added, total:", toolEventSubscribersRef.current.size);
+        // Return unsubscribe function
+        return () => {
+            toolEventSubscribersRef.current.delete(handler);
+            logger.debug("Tool event subscriber removed, total:", toolEventSubscribersRef.current.size);
+        };
+    }, []);
     const contextValue = useMemo(() => ({
         config,
         getIframeOrigin,
@@ -154,6 +184,7 @@ export function YakProvider({ appId, getConfig, onToolCall, onGraphQLSchemaCall,
         close,
         openWithPrompt,
         setIsIframeReady,
+        subscribeToToolEvents,
     }), [
         config,
         getIframeOrigin,
@@ -166,6 +197,7 @@ export function YakProvider({ appId, getConfig, onToolCall, onGraphQLSchemaCall,
         open,
         close,
         openWithPrompt,
+        subscribeToToolEvents,
     ]);
     return _jsx(YakContext.Provider, { value: contextValue, children: children });
 }

package/dist/context.d.ts

@@ -1,4 +1,4 @@
-import type { Theme, IframeMessageFromHost, ChatConfig } from "@yak-io/javascript";
+import type { Theme, IframeMessageFromHost, ChatConfig, ToolCallEvent } from "@yak-io/javascript";
 /**
  * Configuration for the yak provider
  */
@@ -8,6 +8,10 @@ export type YakConfig = {
     chatConfig?: ChatConfig | null;
     onRedirect?: (path: string) => void;
 };
+/**
+ * Listener function for tool call events
+ */
+export type ToolCallEventHandler = (event: ToolCallEvent) => void;
 /**
  * Context value with config and iframe management
  */
@@ -31,6 +35,8 @@ export type YakContextValue = {
     /** Open the chat widget and trigger a specific prompt */
     openWithPrompt: (prompt: string) => void;
     setIsIframeReady: (ready: boolean) => void;
+    /** Subscribe to tool call completion events */
+    subscribeToToolEvents: (handler: ToolCallEventHandler) => () => void;
 };
 export declare const YakContext: import("react").Context<YakContextValue | null>;
 /**
@@ -54,4 +60,36 @@ export declare const YakContext: import("react").Context<YakContextValue | null>
  * @throws {Error} if used outside YakProvider
  */
 export declare function useYak(): YakContextValue;
+/**
+ * Hook to subscribe to tool call completion events.
+ * Useful for page-level cache invalidation when chatbot tools modify data.
+ *
+ * The handler receives an event with:
+ * - `name`: The tool name that was called (e.g., "order.cancel")
+ * - `args`: The arguments passed to the tool
+ * - `ok`: Whether the call succeeded
+ * - `result`: The result (if ok is true)
+ * - `error`: The error message (if ok is false)
+ *
+ * @example
+ * ```tsx
+ * function PlanPage({ planId }: { planId: string }) {
+ *   const utils = trpc.useUtils();
+ *
+ *   useYakToolEvent((event) => {
+ *     // Only invalidate if this tool touched plans
+ *     if (event.ok && event.name.startsWith("plan.")) {
+ *       utils.plan.get.invalidate({ id: planId });
+ *       utils.planItem.list.invalidate({ planId });
+ *     }
+ *   });
+ *
+ *   // ... rest of component
+ * }
+ * ```
+ *
+ * @param handler - Function called after each tool call completes
+ * @throws {Error} if used outside YakProvider
+ */
+export declare function useYakToolEvent(handler: ToolCallEventHandler): void;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,oCAAoC;IACpC,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,WAAW,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,aAAa,EAAE,OAAO,CAAC;IACvB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yDAAyD;IACzD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF,eAAO,MAAM,UAAU,iDAA8C,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,IAAI,eAAe,CAMxC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,oCAAoC;IACpC,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,WAAW,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,aAAa,EAAE,OAAO,CAAC;IACvB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yDAAyD;IACzD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,+CAA+C;IAC/C,qBAAqB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,IAAI,CAAC;CACtE,CAAC;AAEF,eAAO,MAAM,UAAU,iDAA8C,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,IAAI,eAAe,CAMxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAkBnE"}

package/dist/context.js

@@ -1,5 +1,5 @@
 "use client";
-import { createContext, useContext } from "react";
+import { createContext, useContext, useEffect, useRef } from "react";
 export const YakContext = createContext(null);
 /**
  * Hook to access the Yak chat widget API.
@@ -28,3 +28,50 @@ export function useYak() {
     }
     return context;
 }
+/**
+ * Hook to subscribe to tool call completion events.
+ * Useful for page-level cache invalidation when chatbot tools modify data.
+ *
+ * The handler receives an event with:
+ * - `name`: The tool name that was called (e.g., "order.cancel")
+ * - `args`: The arguments passed to the tool
+ * - `ok`: Whether the call succeeded
+ * - `result`: The result (if ok is true)
+ * - `error`: The error message (if ok is false)
+ *
+ * @example
+ * ```tsx
+ * function PlanPage({ planId }: { planId: string }) {
+ *   const utils = trpc.useUtils();
+ *
+ *   useYakToolEvent((event) => {
+ *     // Only invalidate if this tool touched plans
+ *     if (event.ok && event.name.startsWith("plan.")) {
+ *       utils.plan.get.invalidate({ id: planId });
+ *       utils.planItem.list.invalidate({ planId });
+ *     }
+ *   });
+ *
+ *   // ... rest of component
+ * }
+ * ```
+ *
+ * @param handler - Function called after each tool call completes
+ * @throws {Error} if used outside YakProvider
+ */
+export function useYakToolEvent(handler) {
+    const context = useContext(YakContext);
+    if (!context) {
+        throw new Error("useYakToolEvent must be used within YakProvider");
+    }
+    // Use ref to always have latest handler without re-subscribing
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        // Wrap handler to use ref (stable reference)
+        const stableHandler = (event) => {
+            handlerRef.current(event);
+        };
+        return context.subscribeToToolEvents(stableHandler);
+    }, [context]);
+}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { useYak } from "./context.js";
-export type { YakConfig, YakContextValue } from "./context.js";
+export { useYak, useYakToolEvent } from "./context.js";
+export type { YakConfig, YakContextValue, ToolCallEventHandler } from "./context.js";
 export { YakProvider } from "./YakProvider.js";
 export type { YakProviderProps } from "./YakProvider.js";
 export { YakWidget } from "./YakWidget.js";
 export type { YakWidgetProps } from "./YakWidget.js";
-export { type GraphQLSchemaHandler, type RESTSchemaHandler, type GraphQLRequest, type RESTRequest, type ToolCallHandler, type SchemaSource, type GraphQLSchemaSource, type OpenAPISchemaSource, type Theme, type ThemeColors, type ButtonColors, } from "@yak-io/javascript";
+export { type GraphQLSchemaHandler, type RESTSchemaHandler, type GraphQLRequest, type RESTRequest, type ToolCallHandler, type ToolCallEvent, type SchemaSource, type GraphQLSchemaSource, type OpenAPISchemaSource, type Theme, type ThemeColors, type ButtonColors, } from "@yak-io/javascript";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 "use client";
 // Public API - only export what consumers need
-export { useYak } from "./context.js";
+export { useYak, useYakToolEvent } from "./context.js";
 export { YakProvider } from "./YakProvider.js";
 export { YakWidget } from "./YakWidget.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yak-io/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "React SDK for embedding yak chatbot",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -11,8 +11,7 @@
     "directory": "packages/react"
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": false
+    "access": "public"
   },
   "keywords": [
     "yak",
@@ -30,15 +29,19 @@
     "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"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@yak-io/javascript": "0.1.0"
+    "@yak-io/javascript": "0.2.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",