@wervt/nuxt 0.2.11 → 0.2.12

package/README.md

@@ -19,6 +19,7 @@ export default defineNuxtConfig({
 - `proxyShape()` (server) and `useShape()` (app): live rows from Postgres via Electric.
 - `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).
 - `defineTool()` (server): tools in `server/tools/` that browser agents call through WebMCP.
 - `nuxt dev` starts against the local wervt stack (Postgres, Electric) and a dev user.
 

package/dist/module.d.ts

@@ -18,6 +18,12 @@ export interface ModuleOptions {
    * Defaults to true; `false` leaves them out of the build.
    */
   webmcp?: boolean;
+  /**
+   * Reports client-side navigations and `useWervtTrack()` events to wervt's usage analytics, so
+   * page views count more than the first load. Defaults to true. Cookieless; page loads are
+   * counted by the runtime either way.
+   */
+  analytics?: boolean;
 }
 /** `server/wervt-tasks.json` in the build: the app's tasks and schedules, for the control plane. */
 export interface TasksManifest {

package/dist/module.js

@@ -221,6 +221,17 @@ var module_default = defineNuxtModule({
 				mode: "client"
 			});
 		}
+		if (options.analytics !== false && !nuxt.options.dev) {
+			const config = nuxt.options.runtimeConfig.public;
+			config.wervt = {
+				...config.wervt,
+				analytics: true
+			};
+			addPlugin({
+				src: resolver.resolve("./runtime/app/plugins/analytics.client"),
+				mode: "client"
+			});
+		}
 		nuxt.options.build.transpile.push(resolver.resolve("./runtime"));
 		addImports([
 			{
@@ -231,6 +242,10 @@ var module_default = defineNuxtModule({
 				name: "useWervtUser",
 				from: resolver.resolve("./runtime/app/useWervtUser")
 			},
+			{
+				name: "useWervtTrack",
+				from: resolver.resolve("./runtime/app/useWervtTrack")
+			},
 			{
 				name: "wervtLoginUrl",
 				from: resolver.resolve("./runtime/app/useWervtUser")

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

@@ -0,0 +1,4 @@
+//#region src/runtime/app/plugins/analytics.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/analytics.client.js

@@ -0,0 +1,16 @@
+import { defineNuxtPlugin, useRouter, useRuntimeConfig } from "#app";
+//#region src/runtime/app/plugins/analytics.client.ts
+var analytics_client_default = defineNuxtPlugin({
+	name: "wervt:analytics",
+	setup() {
+		const router = useRouter();
+		const base = useRuntimeConfig().app.baseURL.replace(/\/$/, "");
+		router.afterEach((to, from, failure) => {
+			if (failure || !from.matched.length || to.path === from.path) return;
+			const body = new Blob([JSON.stringify({ path: `${base}${to.path}` })], { type: "application/json" });
+			navigator.sendBeacon?.(`${base}/_wervt/view`, body);
+		});
+	}
+});
+//#endregion
+export { analytics_client_default as default };

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

@@ -0,0 +1,9 @@
+//#region src/runtime/app/useWervtTrack.d.ts
+/**
+ * Custom events for wervt's analytics, e.g. `track('signup')` or `track('click', url)`. They
+ * show up with their counts and visitors in the dashboard and `wervt stats`. Like page views
+ * they are cookieless: only the event, its label and the current path are sent. Does nothing
+ * in `nuxt dev`, during SSR and with `wervt.analytics: false`.
+ */
+export declare function useWervtTrack(): (name: string, label?: string) => void;
+//#endregion

package/dist/runtime/app/useWervtTrack.js

@@ -0,0 +1,24 @@
+import { useRuntimeConfig } from "#app";
+//#region src/runtime/app/useWervtTrack.ts
+/**
+* Custom events for wervt's analytics, e.g. `track('signup')` or `track('click', url)`. They
+* show up with their counts and visitors in the dashboard and `wervt stats`. Like page views
+* they are cookieless: only the event, its label and the current path are sent. Does nothing
+* in `nuxt dev`, during SSR and with `wervt.analytics: false`.
+*/
+function useWervtTrack() {
+	const config = useRuntimeConfig();
+	const enabled = config.public.wervt?.analytics;
+	const base = config.app.baseURL.replace(/\/$/, "");
+	return (name, label) => {
+		if (!enabled || import.meta.server || typeof navigator === "undefined") return;
+		const body = JSON.stringify({
+			path: location.pathname,
+			name,
+			label
+		});
+		navigator.sendBeacon?.(`${base}/_wervt/view`, new Blob([body], { type: "application/json" }));
+	};
+}
+//#endregion
+export { useWervtTrack };

package/dist/runtime/server/boot.d.ts

@@ -3,8 +3,8 @@ declare const _default: import("nuxt/server").EventHandler<{
   error: string;
   ok?: undefined;
 } | {
-  error?: undefined;
   ok: boolean;
+  error?: undefined;
 }>;
 //#endregion
 export { _default as default };

package/dist/runtime/server/task-run-nitro2.d.ts

@@ -3,8 +3,8 @@ declare const _default: import("nuxt/server").EventHandler<Promise<{
   error: string;
   result?: undefined;
 } | {
-  error?: undefined;
   result: {} | null;
+  error?: undefined;
 }>>;
 //#endregion
 export { _default as default };

package/package.json

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