@wervt/nuxt 0.2.13 → 0.2.14

package/README.md

@@ -20,6 +20,7 @@ export default defineNuxtConfig({
 - `useWervtUser()`: the signed-in wervt user, on the server and in the app.
 - `useValidatedBody()` / `useValidatedQuery()` / `useValidatedParams()`: valibot validation.
 - `useWervtTrack()`: custom events for wervt's cookieless analytics (page views are counted automatically).
+- `wervt: { feedback: { key } }` and `useWervtFeedback()`: the kontor feedback widget, reports go into a kontor project's triage.
 - `defineTool()` (server): tools in `server/tools/` that browser agents call through WebMCP, and
   MCP clients (Claude Code, Cursor, …) at `/mcp`, signed in through wervt's OAuth login.
 - `nuxt dev` starts against the local wervt stack (Postgres, Electric) and a dev user.

package/dist/module.d.ts

@@ -30,6 +30,28 @@ export interface ModuleOptions {
    * counted by the runtime either way.
    */
   analytics?: boolean;
+  /**
+   * The kontor feedback widget: a "Feedback" button that reports issues into a kontor project's
+   * triage, as the signed-in wervt user when the app's URL is an allowed origin of the key.
+   * With `true`, the key comes from `wervt env <app> --set NUXT_PUBLIC_WERVT_FEEDBACK_KEY=pk_…`
+   * (it can override a configured key the same way).
+   */
+  feedback?: FeedbackOptions | boolean;
+}
+export interface FeedbackOptions {
+  /** Public intake key of the kontor project (Project settings → Intake keys). */
+  key?: string;
+  /** The kontor instance. Defaults to https://kontor.wervt.app. */
+  url?: string;
+  /** Widget language. Defaults to the browser's. */
+  lang?: 'de' | 'en';
+  /** `none` hides the floating button; open the form with `useWervtFeedback().open()`. */
+  position?: 'bottom-right' | 'bottom-left' | 'none';
+  label?: string;
+  /** Accent color (any CSS color). */
+  color?: string;
+  /** Also load it in `nuxt dev`. Off by default: localhost usually isn't an allowed origin. */
+  dev?: boolean;
 }
 export interface McpOptions {
   /** Server name clients show. Defaults to the app name. */

package/dist/module.js

@@ -265,6 +265,24 @@ var module_default = defineNuxtModule({
 				mode: "client"
 			});
 		}
+		const feedbackOptions = options.feedback === true ? {} : options.feedback;
+		if (feedbackOptions && (feedbackOptions.dev || !nuxt.options.dev)) {
+			const { dev: _, ...feedback } = feedbackOptions;
+			const config = nuxt.options.runtimeConfig.public;
+			config.wervt = {
+				...config.wervt,
+				feedback: {
+					key: "",
+					url: "https://kontor.wervt.app",
+					...feedback,
+					app: await resolveAppName(nuxt.options.rootDir, options.app)
+				}
+			};
+			addPlugin({
+				src: resolver.resolve("./runtime/app/plugins/feedback.client"),
+				mode: "client"
+			});
+		}
 		nuxt.options.build.transpile.push(resolver.resolve("./runtime"));
 		addImports([
 			{
@@ -290,6 +308,10 @@ var module_default = defineNuxtModule({
 			{
 				name: "useWervtUpdate",
 				from: resolver.resolve("./runtime/app/useWervtUpdate")
+			},
+			{
+				name: "useWervtFeedback",
+				from: resolver.resolve("./runtime/app/useWervtFeedback")
 			}
 		]);
 	}

package/dist/runtime/app/plugins/feedback.client.d.ts

@@ -0,0 +1,4 @@
+//#region src/runtime/app/plugins/feedback.client.d.ts
+declare const _default: import("#app").Plugin<Record<string, unknown>> & import("#app").ObjectPlugin<Record<string, unknown>>;
+//#endregion
+export { _default as default };

package/dist/runtime/app/plugins/feedback.client.js

@@ -0,0 +1,32 @@
+import { pendingFeedbackContext } from "../useWervtFeedback.js";
+import { defineNuxtPlugin, onNuxtReady, useRuntimeConfig } from "#app";
+//#region src/runtime/app/plugins/feedback.client.ts
+var feedback_client_default = defineNuxtPlugin({
+	name: "wervt:feedback",
+	setup() {
+		const config = useRuntimeConfig();
+		const feedback = config.public.wervt?.feedback;
+		if (!feedback?.key) return;
+		onNuxtReady(() => {
+			const script = document.createElement("script");
+			script.src = `${feedback.url.replace(/\/$/, "")}/widget.js`;
+			script.async = true;
+			script.dataset.key = feedback.key;
+			for (const name of [
+				"lang",
+				"position",
+				"label",
+				"color"
+			]) if (feedback[name]) script.dataset[name] = feedback[name];
+			script.dataset.context = JSON.stringify({
+				app: feedback.app,
+				release: config.app.buildId,
+				...pendingFeedbackContext
+			});
+			script.addEventListener("load", () => window.kontor?.setContext(pendingFeedbackContext));
+			document.head.appendChild(script);
+		});
+	}
+});
+//#endregion
+export { feedback_client_default as default };

package/dist/runtime/app/useWervtFeedback.d.ts

@@ -0,0 +1,24 @@
+//#region src/runtime/app/useWervtFeedback.d.ts
+interface KontorWidget {
+  open(): void;
+  close(): void;
+  setContext(values: Record<string, unknown>): void;
+}
+declare global {
+  interface Window {
+    kontor?: KontorWidget;
+  }
+}
+export declare const pendingFeedbackContext: Record<string, unknown>;
+/**
+ * Controls the feedback widget (`wervt: { feedback: { key } }`): open it from your own button,
+ * or add context to every report, e.g. what the user was looking at.
+ *
+ * @example useWervtFeedback().setContext({ room: room.id })
+ */
+export declare function useWervtFeedback(): {
+  open: () => void | undefined;
+  close: () => void | undefined;
+  setContext(values: Record<string, unknown>): void;
+};
+//#endregion

package/dist/runtime/app/useWervtFeedback.js

@@ -0,0 +1,21 @@
+//#region src/runtime/app/useWervtFeedback.ts
+const pendingFeedbackContext = {};
+/**
+* Controls the feedback widget (`wervt: { feedback: { key } }`): open it from your own button,
+* or add context to every report, e.g. what the user was looking at.
+*
+* @example useWervtFeedback().setContext({ room: room.id })
+*/
+function useWervtFeedback() {
+	const widget = () => import.meta.client ? window.kontor : void 0;
+	return {
+		open: () => widget()?.open(),
+		close: () => widget()?.close(),
+		setContext(values) {
+			Object.assign(pendingFeedbackContext, values);
+			widget()?.setContext(values);
+		}
+	};
+}
+//#endregion
+export { pendingFeedbackContext, useWervtFeedback };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wervt/nuxt",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Nuxt module for apps hosted on wervt: database, live data, MCP and runtime setup.",
   "keywords": [
     "drizzle",