@yak-io/nuxt 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/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createYakProvider } from "./plugin.js";
+export type { YakProviderOptions, YakApi, ToolCallEventHandler } from "./plugin.js";
+export { enableYakLogging, disableYakLogging, isYakLoggingEnabled } from "@yak-io/javascript";
+export type { GraphQLSchemaHandler, RESTSchemaHandler, GraphQLRequest, RESTRequest, ToolCallHandler, ToolCallEvent, SchemaSource, GraphQLSchemaSource, OpenAPISchemaSource, Theme, ThemeColors, TriggerButtonConfig, WidgetPosition, ChatConfigProvider, } 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":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9F,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// Public API
+export { createYakProvider } from "./plugin.js";
+// Re-export logging utilities
+export { enableYakLogging, disableYakLogging, isYakLoggingEnabled } from "@yak-io/javascript";

package/dist/internal/logger.d.ts

@@ -0,0 +1,2 @@
+export { logger } from "@yak-io/javascript";
+//# sourceMappingURL=logger.d.ts.map

package/dist/internal/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/internal/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/internal/logger.js

@@ -0,0 +1 @@
+export { logger } from "@yak-io/javascript";

package/dist/plugin.d.ts

@@ -0,0 +1,59 @@
+import { type Ref, type DeepReadonly } from "vue";
+import { type TriggerButtonConfig, type ChatConfigProvider, type ToolCallHandler, type ToolCallEvent, type GraphQLSchemaHandler, type RESTSchemaHandler, type Theme } from "@yak-io/javascript";
+export type ToolCallEventHandler = (event: ToolCallEvent) => void;
+export type YakProviderOptions = {
+    appId: string;
+    getConfig?: ChatConfigProvider;
+    onToolCall?: ToolCallHandler;
+    onGraphQLSchemaCall?: GraphQLSchemaHandler;
+    onRESTSchemaCall?: RESTSchemaHandler;
+    theme?: Theme;
+    onRedirect?: (path: string) => void;
+    disableRestartButton?: boolean;
+    trigger?: boolean | TriggerButtonConfig;
+};
+export type YakApi = {
+    /** Readonly ref — whether the chat widget is open */
+    isOpen: DeepReadonly<Ref<boolean>>;
+    /** Readonly ref — whether the iframe is ready */
+    isReady: DeepReadonly<Ref<boolean>>;
+    /** Open the chat widget */
+    open: () => void;
+    /** Close the chat widget */
+    close: () => void;
+    /** Open the chat widget and send a prompt */
+    openWithPrompt: (prompt: string) => void;
+    /** Subscribe to tool call completion events. Returns an unsubscribe function. */
+    subscribeToToolEvents: (handler: ToolCallEventHandler) => () => void;
+    /** Mount the widget DOM — call only on client side */
+    mount: () => void;
+    /** Destroy the widget DOM */
+    destroy: () => void;
+};
+/**
+ * Creates a yak chat widget instance for Nuxt.
+ * SSR-safe: call `mount()` only on the client side (e.g. in a plugin with `nuxtApp.hook("app:mounted")`
+ * or inside `onMounted`).
+ *
+ * @example
+ * ```ts
+ * // plugins/yak.client.ts
+ * import { createYakProvider } from "@yak-io/nuxt";
+ *
+ * export default defineNuxtPlugin((nuxtApp) => {
+ *   const yak = createYakProvider({ appId: "my-app" });
+ *
+ *   nuxtApp.hook("app:mounted", () => yak.mount());
+ *   nuxtApp.hook("app:beforeMount", () => {});
+ *
+ *   nuxtApp.provide("yak", yak);
+ *
+ *   // Cleanup on HMR
+ *   if (import.meta.hot) {
+ *     import.meta.hot.dispose(() => yak.destroy());
+ *   }
+ * });
+ * ```
+ */
+export declare function createYakProvider(options: YakProviderOptions): YakApi;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,KAAK,CAAC;AACjE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACX,MAAM,oBAAoB,CAAC;AAK5B,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,qDAAqD;IACrD,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,iDAAiD;IACjD,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6CAA6C;IAC7C,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iFAAiF;IACjF,qBAAqB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,IAAI,CAAC;IACrE,sDAAsD;IACtD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAkFrE"}

package/dist/plugin.js

@@ -0,0 +1,102 @@
+import { ref, readonly } from "vue";
+import { YakEmbed, } from "@yak-io/javascript";
+import { logger } from "./internal/logger.js";
+// ── Provider factory ────────────────────────────────────────────────────────
+/**
+ * Creates a yak chat widget instance for Nuxt.
+ * SSR-safe: call `mount()` only on the client side (e.g. in a plugin with `nuxtApp.hook("app:mounted")`
+ * or inside `onMounted`).
+ *
+ * @example
+ * ```ts
+ * // plugins/yak.client.ts
+ * import { createYakProvider } from "@yak-io/nuxt";
+ *
+ * export default defineNuxtPlugin((nuxtApp) => {
+ *   const yak = createYakProvider({ appId: "my-app" });
+ *
+ *   nuxtApp.hook("app:mounted", () => yak.mount());
+ *   nuxtApp.hook("app:beforeMount", () => {});
+ *
+ *   nuxtApp.provide("yak", yak);
+ *
+ *   // Cleanup on HMR
+ *   if (import.meta.hot) {
+ *     import.meta.hot.dispose(() => yak.destroy());
+ *   }
+ * });
+ * ```
+ */
+export function createYakProvider(options) {
+    const isOpen = ref(false);
+    const isReady = ref(false);
+    const toolEventSubscribers = new Set();
+    const handleToolCallComplete = (event) => {
+        logger.debug("Tool call completed, notifying subscribers:", {
+            name: event.name,
+            ok: event.ok,
+            subscriberCount: toolEventSubscribers.size,
+        });
+        for (const handler of toolEventSubscribers) {
+            try {
+                handler(event);
+            }
+            catch (err) {
+                logger.warn("Error in tool event subscriber:", err);
+            }
+        }
+    };
+    const resolvedRedirect = options.onRedirect ??
+        (typeof window !== "undefined" ? (path) => window.location.assign(path) : undefined);
+    const embed = new YakEmbed({
+        appId: options.appId,
+        theme: options.theme,
+        trigger: options.trigger ?? false,
+        onToolCall: options.onToolCall,
+        onGraphQLSchemaCall: options.onGraphQLSchemaCall,
+        onRESTSchemaCall: options.onRESTSchemaCall,
+        onRedirect: resolvedRedirect,
+        options: { disableRestartButton: options.disableRestartButton },
+        onToolCallComplete: handleToolCallComplete,
+    });
+    // Sync embed state → refs
+    embed.onStateChange((state) => {
+        isOpen.value = state.isOpen;
+        isReady.value = state.isReady;
+    });
+    // Fetch chat config on first open
+    if (options.getConfig) {
+        const getConfig = options.getConfig;
+        let configFetched = false;
+        embed.onStateChange((state) => {
+            if (state.isOpen && !configFetched) {
+                configFetched = true;
+                logger.debug("Getting chat config");
+                Promise.resolve(getConfig())
+                    .then((config) => {
+                    logger.debug(`Chat config loaded with ${config.tools?.tools.length ?? 0} tools and ${config.routes?.routes.length ?? 0} routes`);
+                    embed.getClient().updateConfig({ chatConfig: config });
+                })
+                    .catch((err) => {
+                    logger.warn("Error getting chat config:", err);
+                    configFetched = false;
+                });
+            }
+        });
+    }
+    return {
+        isOpen: readonly(isOpen),
+        isReady: readonly(isReady),
+        open: () => embed.open(),
+        close: () => embed.close(),
+        openWithPrompt: (prompt) => embed.openWithPrompt(prompt),
+        subscribeToToolEvents: (handler) => {
+            toolEventSubscribers.add(handler);
+            return () => {
+                toolEventSubscribers.delete(handler);
+            };
+        },
+        mount: () => embed.mount(),
+        destroy: () => embed.destroy(),
+    };
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@yak-io/nuxt",
+  "version": "0.1.0",
+  "description": "Nuxt 3 module for embedding yak chatbot",
+  "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/nuxt"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "yak",
+    "chatbot",
+    "ai",
+    "widget",
+    "chat",
+    "nuxt"
+  ],
+  "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"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "biome lint ./src --fix",
+    "format": "biome format ./src --write",
+    "prepare": "pnpm build"
+  },
+  "dependencies": {
+    "@yak-io/javascript": "workspace:*"
+  },
+  "peerDependencies": {
+    "vue": "^3.3.0",
+    "nuxt": "^3.0.0"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "workspace:*",
+    "@types/node": "^24.10.4",
+    "typescript": "^5.3.0",
+    "vue": "^3.5.16"
+  }
+}