@wervt/nuxt 0.3.7 → 0.3.9

package/dist/brand.d.ts

@@ -18,4 +18,11 @@ export interface BrandOptions {
    * why the address bar shows wervt and that the account works in other apps too.
    */
   securedByWervt?: boolean;
-}
+  /**
+   * The sign-in options the login offers for this app, in wervt's order (`['twitch']`). All of
+   * them by default. Providers the server has no keys for stay hidden either way.
+   */
+  signIn?: SignInMethod[];
+}
+export declare const SIGN_IN_METHODS: readonly ['google', 'github', 'discord', 'twitch', 'spotify', 'passkey', 'email'];
+export type SignInMethod = (typeof SIGN_IN_METHODS)[number];

package/dist/brand.js

@@ -1,5 +1,20 @@
 import { headIcon, headMeta } from "./preview.js";
 // src/brand.ts
+const SIGN_IN_METHODS = [
+	"google",
+	"github",
+	"discord",
+	"twitch",
+	"spotify",
+	"passkey",
+	"email"
+];
+/** The known methods of a list, without duplicates; undefined when none is left. */
+function signInMethods(value) {
+	if (!Array.isArray(value)) return void 0;
+	const methods = SIGN_IN_METHODS.filter((m) => value.includes(m));
+	return methods.length ? methods : void 0;
+}
 const HEX_COLOR = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
 /** The login's branding for the app, or undefined while the app keeps wervt's. */
 function brandManifest(option, head, app, favicon) {
@@ -8,12 +23,14 @@ function brandManifest(option, head, app, favicon) {
 	const pick = (value, fallback) => value?.trim() || fallback;
 	const title = typeof head.title === "string" && head.title.trim() ? head.title.trim() : app;
 	const color = pick(custom.color, headMeta(head, "theme-color"));
+	const signIn = signInMethods(custom.signIn);
 	return {
 		name: pick(custom.name, title).slice(0, 60),
 		logo: pick(custom.logo, void 0),
 		icon: pick(custom.icon, headIcon(head) ?? favicon),
 		color: color && HEX_COLOR.test(color) ? color : void 0,
-		...custom.securedByWervt === false && { securedByWervt: false }
+		...custom.securedByWervt === false && { securedByWervt: false },
+		...signIn && { signIn }
 	};
 }
-export { HEX_COLOR, brandManifest };
+export { HEX_COLOR, SIGN_IN_METHODS, brandManifest, signInMethods };

package/dist/module.js

@@ -7,7 +7,7 @@ import { iconDefaults, iconSources, iconWarning } from "./icons.js";
 import { stripJsdocImports } from "./jsdoc-imports.js";
 import { findRouteTools } from "./route-tools.js";
 import { localFiles, previewManifest } from "./preview.js";
-import { brandManifest } from "./brand.js";
+import { SIGN_IN_METHODS, brandManifest } from "./brand.js";
 import { findShapeRoutes, shapeRoutesTypes, shapesManifest } from "./shapes.js";
 import { addImports, addPlugin, addServerHandler, addServerPlugin, addServerTemplate, addTypeTemplate, createResolver, defineNuxtModule, getNuxtVersion, hasNuxtModule, installModule, updateTemplates, useLogger } from "nuxt/kit";
 import { existsSync } from "node:fs";
@@ -398,6 +398,11 @@ var module_default = defineNuxtModule({
 				image: brand.logo
 			} : false)) if (!existsSync(join(publicDir, file))) logger.warn(`The login branding names \`${file}\`, which isn't in public/.`);
 			if (typeof options.brand === "object" && options.brand.color && !brand?.color) logger.warn("`wervt.brand.color` must be a hex color like `#ff5a1f`; it is ignored.");
+			if (typeof options.brand === "object" && options.brand.signIn) {
+				const unknown = options.brand.signIn.filter((m) => !SIGN_IN_METHODS.includes(m));
+				if (unknown.length) logger.warn(`\`wervt.brand.signIn\` ignores ${unknown.map((m) => `\`${m}\``).join(", ")}; it knows ${SIGN_IN_METHODS.join(", ")}.`);
+				if (!brand?.signIn) logger.warn("`wervt.brand.signIn` names no sign-in option; the login offers all.");
+			}
 			nuxt.hook("nitro:init", (instance) => {
 				const { serverDir } = instance.options.output;
 				instance.hooks.hook("compiled", async () => {

package/dist/runtime/email/components.d.ts

@@ -22,9 +22,14 @@ export declare const emailTheme: {
   radius: string;
   font: string;
   mono: string;
-  /** Where the logo images live. PNG, because Gmail and Outlook don't show SVG. */
+  /**
+   * Where the logo images live. PNG, because Gmail and Outlook don't show SVG. Always wervt.app's,
+   * even on a self-hosted instance: its docs, which would serve them, may not run there.
+   */
   assets: string;
+  /** @deprecated wervt.app's only; `wervtInstance().site` is the instance the app runs on. */
   site: string;
+  /** @deprecated wervt.app's only; `wervtInstance().docs` is the instance's, if it runs any. */
   docs: string;
 };
 /**

package/dist/runtime/email/components.js

@@ -1,3 +1,4 @@
+import { wervtInstance } from "../shared/instance.js";
 import { defineComponent, h, inject } from "vue";
 // src/runtime/email/components.ts
 /** The template's subject, handed to renderEmail() while rendering. */
@@ -23,9 +24,14 @@ const emailTheme = {
 	radius: "8px",
 	font: "Poppins, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif",
 	mono: "'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
-	/** Where the logo images live. PNG, because Gmail and Outlook don't show SVG. */
+	/**
+	* Where the logo images live. PNG, because Gmail and Outlook don't show SVG. Always wervt.app's,
+	* even on a self-hosted instance: its docs, which would serve them, may not run there.
+	*/
 	assets: "https://wervt.app/email",
+	/** @deprecated wervt.app's only; `wervtInstance().site` is the instance the app runs on. */
 	site: "https://wervt.app",
+	/** @deprecated wervt.app's only; `wervtInstance().docs` is the instance's, if it runs any. */
 	docs: "https://wervt.app/getting-started/introduction"
 };
 const t = emailTheme;
@@ -198,7 +204,7 @@ function header(app) {
 			verticalAlign: "middle"
 		}
 	}, h("a", {
-		href: t.site,
+		href: wervtInstance().site,
 		style: {
 			textDecoration: "none",
 			color: "#fafafa"
@@ -309,6 +315,7 @@ function footer(props) {
 		color: t.muted,
 		textDecoration: "none"
 	};
+	const instance = wervtInstance();
 	return table({ width: "100%" }, [h("tr", [tile ? h("td", {
 		width: 40,
 		style: {
@@ -357,22 +364,18 @@ function footer(props) {
 				color: t.dimmed
 			}
 		}, brand ? brand.securedByWervt === false ? [] : [h("a", {
-			href: t.site,
+			href: instance.site,
 			class: "wv-muted",
 			style: link
-		}, "Secured by wervt")] : [
-			h("a", {
-				href: t.site,
-				class: "wv-muted",
-				style: link
-			}, "wervt.app"),
-			separator(),
-			h("a", {
-				href: t.docs,
-				class: "wv-muted",
-				style: link
-			}, "Docs")
-		])
+		}, "Secured by wervt")] : [h("a", {
+			href: instance.site,
+			class: "wv-muted",
+			style: link
+		}, instance.domain), ...instance.docs ? [separator(), h("a", {
+			href: `${instance.docs}/getting-started/introduction`,
+			class: "wv-muted",
+			style: link
+		}, "Docs")] : []])
 	])])]);
 }
 function separator() {

package/dist/runtime/email/index.d.ts

@@ -1,5 +1,6 @@
 import { LogAlertEmail } from "./alert.js";
 import { EmailBrand, EmailButton, EmailCode, EmailDivider, EmailHeading, EmailLink, EmailMuted, EmailText, WervtEmail, emailTheme } from "./components.js";
 import { InviteEmail } from "./invite.js";
+import { WervtInstance, wervtInstance } from "../shared/instance.js";
 import { EmailProps, RenderedEmail, renderEmail } from "./render.js";
-export { type EmailBrand, EmailButton, EmailCode, EmailDivider, EmailHeading, EmailLink, EmailMuted, type EmailProps, EmailText, InviteEmail, LogAlertEmail, type RenderedEmail, WervtEmail, emailTheme, renderEmail };
+export { type EmailBrand, EmailButton, EmailCode, EmailDivider, EmailHeading, EmailLink, EmailMuted, type EmailProps, EmailText, InviteEmail, LogAlertEmail, type RenderedEmail, WervtEmail, type WervtInstance, emailTheme, renderEmail, wervtInstance };

package/dist/runtime/email/index.js

@@ -1,5 +1,6 @@
+import { wervtInstance } from "../shared/instance.js";
 import { EmailButton, EmailCode, EmailDivider, EmailHeading, EmailLink, EmailMuted, EmailText, WervtEmail, emailTheme } from "./components.js";
 import { LogAlertEmail } from "./alert.js";
 import { InviteEmail } from "./invite.js";
 import { renderEmail } from "./render.js";
-export { EmailButton, EmailCode, EmailDivider, EmailHeading, EmailLink, EmailMuted, EmailText, InviteEmail, LogAlertEmail, WervtEmail, emailTheme, renderEmail };
+export { EmailButton, EmailCode, EmailDivider, EmailHeading, EmailLink, EmailMuted, EmailText, InviteEmail, LogAlertEmail, WervtEmail, emailTheme, renderEmail, wervtInstance };

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

@@ -1,4 +1,5 @@
 import { WervtRole, WervtUser } from "../shared/user.js";
+import { WervtInstance, wervtInstance } from "../shared/instance.js";
 import { EmailProps, RenderedEmail, renderEmail } from "../email/render.js";
 import { WervtAccess, WervtInvite, useWervtAccess } from "./access.js";
 import { useDb } from "./db.js";
@@ -13,4 +14,4 @@ import { AccountMergedPayload, Task, TaskEvent, TaskResult, defineTask } from ".
 import { SafeResult, useSafeValidatedBody, useSafeValidatedParams, useSafeValidatedQuery, useValidatedBody, useValidatedParams, useValidatedQuery, vh } from "./validate.js";
 import { Tool, ToolRoute, defineTool, defineToolRoute } from "./tools.js";
 import { requireWervtRole, useWervtUser } from "./user.js";
-export { type AccountMergedPayload, type EmailProps, type McpTokenContext, type RenderedEmail, type SafeResult, type SendMailOptions, type ShapeOptions, type ShapeResponse, type ShapeRow, type Task, type TaskEvent, type TaskResult, type Tool, type ToolRoute, type WervtAccess, type WervtInvite, type WervtRole, type WervtUser, type WorkloadIdentity, createEvlogError, defineTask, defineTool, defineToolRoute, log, proxyShape, renderEmail, requireWervtRole, seedTable, sendMail, useDb, useLogger, useSafeValidatedBody, useSafeValidatedParams, useSafeValidatedQuery, useValidatedBody, useValidatedParams, useValidatedQuery, useWervtAccess, useWervtUser, useWorkloadIdentity, vh };
+export { type AccountMergedPayload, type EmailProps, type McpTokenContext, type RenderedEmail, type SafeResult, type SendMailOptions, type ShapeOptions, type ShapeResponse, type ShapeRow, type Task, type TaskEvent, type TaskResult, type Tool, type ToolRoute, type WervtAccess, type WervtInstance, type WervtInvite, type WervtRole, type WervtUser, type WorkloadIdentity, createEvlogError, defineTask, defineTool, defineToolRoute, log, proxyShape, renderEmail, requireWervtRole, seedTable, sendMail, useDb, useLogger, useSafeValidatedBody, useSafeValidatedParams, useSafeValidatedQuery, useValidatedBody, useValidatedParams, useValidatedQuery, useWervtAccess, useWervtUser, useWorkloadIdentity, vh, wervtInstance };

package/dist/runtime/server/index.js

@@ -1,3 +1,4 @@
+import { wervtInstance } from "../shared/instance.js";
 import { renderEmail } from "../email/render.js";
 import { useWervtAccess } from "./access.js";
 import { useWorkloadIdentity } from "./identity.js";
@@ -10,4 +11,4 @@ import { defineTask } from "./tasks.js";
 import { useSafeValidatedBody, useSafeValidatedParams, useSafeValidatedQuery, useValidatedBody, useValidatedParams, useValidatedQuery, vh } from "./validate.js";
 import { defineTool, defineToolRoute } from "./tools.js";
 import { requireWervtRole, useWervtUser } from "./user.js";
-export { createEvlogError, defineTask, defineTool, defineToolRoute, log, proxyShape, renderEmail, requireWervtRole, seedTable, sendMail, useDb, useLogger, useSafeValidatedBody, useSafeValidatedParams, useSafeValidatedQuery, useValidatedBody, useValidatedParams, useValidatedQuery, useWervtAccess, useWervtUser, useWorkloadIdentity, vh };
+export { createEvlogError, defineTask, defineTool, defineToolRoute, log, proxyShape, renderEmail, requireWervtRole, seedTable, sendMail, useDb, useLogger, useSafeValidatedBody, useSafeValidatedParams, useSafeValidatedQuery, useValidatedBody, useValidatedParams, useValidatedQuery, useWervtAccess, useWervtUser, useWorkloadIdentity, vh, wervtInstance };

package/dist/runtime/server/task-handlers.d.ts

@@ -11,8 +11,8 @@ type Registry = Record<string, {
 }>;
 /** `POST /_wervt/tasks/:name`: runs a task when the control plane asks. */
 export declare function taskRunHandler(runTask: RunTask): import("nuxt/server").EventHandler<Promise<{
-  error: string;
   result?: undefined;
+  error: string;
 } | {
   error?: undefined;
   result: {} | null;

package/dist/runtime/server/tool-handlers.d.ts

@@ -36,7 +36,7 @@ export declare const runTool: import("nuxt/server").EventHandler<Promise<{
   };
   result?: undefined;
 } | {
+  error?: undefined;
   issues?: undefined;
   result: {} | null;
-  error?: undefined;
 }>>;

package/dist/runtime/shared/instance.d.ts

@@ -0,0 +1,17 @@
+/** The wervt instance an app runs on: wervt.app, or a self-hosted one at its own domain. */
+export interface WervtInstance {
+  /** E.g. `wervt.app` or `lightdrop.cloud`. */
+  domain: string;
+  /** The domain as a link. */
+  site: string;
+  /** The instance's docs site, or `undefined` when it runs none. */
+  docs?: string;
+}
+type Env = Record<string, string | undefined>;
+/**
+ * Read at call time from what the runtime gives each isolate (`WERVT_BASE_DOMAIN`,
+ * `WERVT_DOCS_URL`, empty without docs), so an app built for wervt.app links to the right place
+ * on any other instance. Older runtimes pass neither, and were all wervt.app's.
+ */
+export declare function wervtInstance(env?: Env): WervtInstance;
+export {};

package/dist/runtime/shared/instance.js

@@ -0,0 +1,17 @@
+// src/runtime/shared/instance.ts
+const processEnv = () => typeof process === "undefined" ? {} : process.env;
+/**
+* Read at call time from what the runtime gives each isolate (`WERVT_BASE_DOMAIN`,
+* `WERVT_DOCS_URL`, empty without docs), so an app built for wervt.app links to the right place
+* on any other instance. Older runtimes pass neither, and were all wervt.app's.
+*/
+function wervtInstance(env = processEnv()) {
+	const domain = env.WERVT_BASE_DOMAIN || "wervt.app";
+	const site = `${/(^|\.)localhost(:\d+)?$/.test(domain) ? "http" : "https"}://${domain}`;
+	return {
+		domain,
+		site,
+		docs: env.WERVT_DOCS_URL === void 0 ? domain === "wervt.app" ? site : void 0 : env.WERVT_DOCS_URL.replace(/\/+$/, "") || void 0
+	};
+}
+export { wervtInstance };

package/package.json

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