@wervt/nuxt 0.3.10 → 0.3.12

package/dist/brand.d.ts

@@ -1,3 +1,4 @@
+import { Locale } from "./runtime/shared/i18n.js";
 export interface BrandOptions {
   /**
    * The product name the login shows ("Sign in to …"). Defaults to the app's `app.head.title` up
@@ -30,6 +31,11 @@ export interface BrandOptions {
    * them by default. Providers the server has no keys for stay hidden either way.
    */
   signIn?: SignInMethod[];
+  /**
+   * The language of the login, the code mail and the consent page (`'de'`). Without it they
+   * follow the visitor's browser: German for a German preference, English otherwise.
+   */
+  lang?: Locale;
 }
 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,4 +1,5 @@
 import { headIcon } from "./preview.js";
+import { isLocale } from "./runtime/shared/i18n.js";
 // src/brand.ts
 const SIGN_IN_METHODS = [
 	"google",
@@ -44,7 +45,8 @@ function brandManifest(option, head, app, favicon) {
 		icon: pick(custom.icon, mailIcon(head) ?? headIcon(head) ?? favicon),
 		color: color && HEX_COLOR.test(color) ? color : void 0,
 		...custom.securedByWervt === false && { securedByWervt: false },
-		...signIn && { signIn }
+		...signIn && { signIn },
+		...isLocale(custom.lang) && { lang: custom.lang }
 	};
 }
 export { HEX_COLOR, MAIL_IMAGE, SIGN_IN_METHODS, brandManifest, signInMethods, titleName };

package/dist/content.js

@@ -0,0 +1,34 @@
+// src/content.ts
+/**
+* Nuxt Content on wervt: SQLite is a native module (or `node:sqlite`, newer than the isolate's
+* Deno), so production builds keep content in the app's Postgres. `{{DATABASE_URL}}` is expanded
+* at runtime (Nitro's envExpansion).
+*/
+const CONTENT_DATABASE = {
+	type: "postgres",
+	url: "{{DATABASE_URL}}"
+};
+/**
+* Our options for @nuxt/content, as a module dependency: applied before Content's setup, which
+* picks its database adapter then, whatever the order of the modules. Setting them in our own
+* setup came too late when Content came first, e.g. from a layer like Docus. An override, not a
+* default: SQLite can't work in the isolate, whatever the app sets.
+*/
+function contentDependency() {
+	return {
+		optional: true,
+		overrides: { database: CONTENT_DATABASE }
+	};
+}
+/**
+* The bundle's manifest (wervt-bundle.json). An app with Nuxt Content needs a database even
+* without Drizzle migrations, which are how the control plane otherwise knows it wants one.
+*/
+function nuxtBundleManifest({ content }) {
+	return {
+		version: 2,
+		framework: "nuxt",
+		...content ? { database: true } : {}
+	};
+}
+export { CONTENT_DATABASE, contentDependency, nuxtBundleManifest };

package/dist/module.js

@@ -2,8 +2,10 @@ import { setupStudioPreview } from "./studio-preview.js";
 import { PROCESS_ENV_TYPES } from "./env-types.js";
 import { dependencyNames, ogImageDefaults, ogImageWarning } from "./og-image.js";
 import { iconDefaults, iconSources, iconWarning } from "./icons.js";
+import { CONTENT_DATABASE, contentDependency, nuxtBundleManifest } from "./content.js";
 import { findRouteTools } from "./route-tools.js";
 import { localFiles, previewManifest } from "./preview.js";
+import { LOCALES } from "./runtime/shared/i18n.js";
 import { MAIL_IMAGE, SIGN_IN_METHODS, brandManifest } from "./brand.js";
 import { findShapeRoutes, shapeRoutesTypes, shapesManifest } from "./shapes.js";
 import { BUNDLE_MANIFEST } from "@wervt/core";
@@ -16,10 +18,6 @@ import { dirname, extname, join, relative, resolve, sep } from "node:path";
 import evlog from "evlog/nuxt";
 import { DENO_INJECT, denoPlugins } from "@wervt/nitro/build";
 // src/module.ts
-const CONTENT_DATABASE = {
-	type: "postgres",
-	url: "{{DATABASE_URL}}"
-};
 var module_default = defineNuxtModule({
 	meta: {
 		name: "@wervt/nuxt",
@@ -35,7 +33,8 @@ var module_default = defineNuxtModule({
 			"nuxt-og-image": {
 				optional: true,
 				defaults: ogImageDefaults()
-			}
+			},
+			"@nuxt/content": contentDependency()
 		};
 	},
 	async setup(options, nuxt) {
@@ -71,16 +70,10 @@ var module_default = defineNuxtModule({
 			}
 		}
 		addServerPlugin(resolver.resolve("./runtime/server/agent-token-plugin"));
-		const useContentDatabase = !nuxt.options.dev && hasNuxtModule("@nuxt/content", nuxt);
-		if (useContentDatabase) {
-			const options = nuxt.options;
-			options.content = {
-				...options.content,
-				database: CONTENT_DATABASE
-			};
-		}
+		const usesContent = () => !nuxt.options.dev && hasNuxtModule("@nuxt/content", nuxt);
 		nuxt.hook("nitro:config", (config) => {
 			const options = config;
+			if (!nuxt.options.dev) options.serveStatic = false;
 			options.externals = {
 				...options.externals,
 				inline: [
@@ -97,7 +90,7 @@ var module_default = defineNuxtModule({
 					exclude: [exclude].flat().map((pattern) => typeof pattern === "string" ? pattern : exceptRuntime(pattern))
 				}
 			};
-			if (useContentDatabase) {
+			if (usesContent()) {
 				options.experimental = {
 					...options.experimental,
 					envExpansion: true
@@ -193,10 +186,8 @@ var module_default = defineNuxtModule({
 					};
 					await mkdir(nitroOptions.output.serverDir, { recursive: true });
 					await writeFile(join(nitroOptions.output.serverDir, "wervt-tasks.json"), `${JSON.stringify(manifest, null, 2)}\n`);
-					await writeFile(join(dirname(nitroOptions.output.serverDir), BUNDLE_MANIFEST), `${JSON.stringify({
-						version: 2,
-						framework: "nuxt"
-					}, null, 2)}\n`);
+					const bundle = nuxtBundleManifest({ content: usesContent() });
+					await writeFile(join(dirname(nitroOptions.output.serverDir), BUNDLE_MANIFEST), `${JSON.stringify(bundle, null, 2)}\n`);
 				});
 			});
 		}
@@ -402,6 +393,7 @@ var module_default = defineNuxtModule({
 			} : false)) if (!existsSync(join(publicDir, file))) logger.warn(`The login branding names \`${file}\`, which isn't in public/.`);
 			if (brand?.icon && !MAIL_IMAGE.test(brand.icon)) logger.warn(`The login branding's icon \`${brand.icon}\` won't show in the sign-in mail: Gmail and Outlook need PNG or JPEG. Set \`wervt.brand.icon\` to one.`);
 			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.lang && !brand?.lang) logger.warn(`\`wervt.brand.lang\` must be one of ${LOCALES.join(", ")}; the login follows the browser instead.`);
 			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(", ")}.`);

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

@@ -1,3 +1,4 @@
+import { Locale } from "../shared/i18n.js";
 import { InjectionKey, PropType } from "vue";
 /** The template's subject, handed to renderEmail() while rendering. */
 export declare const SUBJECT_KEY: InjectionKey<(subject: string) => void>;
@@ -84,6 +85,14 @@ export declare const WervtEmail: import("vue").DefineComponent<import("vue").Ext
     type: PropType<EmailBrand | null>;
     default: null;
   };
+  /**
+   * The language of the frame's own texts ("Sent by …") and the document. English unless set;
+   * the template's own texts are up to the template.
+   */
+  lang: {
+    type: PropType<Locale>;
+    default: string;
+  };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -117,12 +126,21 @@ export declare const WervtEmail: import("vue").DefineComponent<import("vue").Ext
     type: PropType<EmailBrand | null>;
     default: null;
   };
+  /**
+   * The language of the frame's own texts ("Sent by …") and the document. English unless set;
+   * the template's own texts are up to the template.
+   */
+  lang: {
+    type: PropType<Locale>;
+    default: string;
+  };
 }>> & Readonly<{}>, {
   app: string;
   preview: string;
   footer: string;
   reason: string;
   brand: EmailBrand | null;
+  lang: "de" | "en";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export declare const EmailHeading: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** A short label above the heading, in the landing page's mono eyebrow style. */

package/dist/runtime/email/components.js

@@ -1,3 +1,5 @@
+import { isLocale, translator } from "../shared/i18n.js";
+import { mailMessages } from "../shared/messages.js";
 import { wervtInstance } from "../shared/instance.js";
 import { defineComponent, h, inject } from "vue";
 // src/runtime/email/components.ts
@@ -102,11 +104,19 @@ const WervtEmail = defineComponent({
 		brand: {
 			type: Object,
 			default: null
+		},
+		/**
+		* The language of the frame's own texts ("Sent by …") and the document. English unless set;
+		* the template's own texts are up to the template.
+		*/
+		lang: {
+			type: String,
+			default: "en"
 		}
 	},
 	setup(props, { slots }) {
 		inject(SUBJECT_KEY, void 0)?.(props.subject);
-		return () => h("html", { lang: "en" }, [h("head", [
+		return () => h("html", { lang: isLocale(props.lang) ? props.lang : "en" }, [h("head", [
 			h("meta", { charset: "utf-8" }),
 			h("meta", {
 				name: "viewport",
@@ -304,7 +314,8 @@ function accentLine(color) {
 }
 function footer(props) {
 	const { brand } = props;
-	const sentBy = props.footer || (brand ? `Sent by ${brand.name}` : props.app === "wervt" ? "Sent by wervt" : `Sent by ${props.app} via wervt`);
+	const say = translator(mailMessages, isLocale(props.lang) ? props.lang : "en");
+	const sentBy = props.footer || (brand ? say("sentBy", { app: brand.name }) : props.app === "wervt" ? say("sentBy", { app: "wervt" }) : say("sentByVia", { app: props.app }));
 	const tile = brand ? mailIcon(brand) : `${t.assets}/mark-tile.png`;
 	const small = {
 		fontFamily: t.font,
@@ -367,7 +378,7 @@ function footer(props) {
 			href: instance.site,
 			class: "wv-muted",
 			style: link
-		}, "Secured by wervt")] : [h("a", {
+		}, say("securedBy"))] : [h("a", {
 			href: instance.site,
 			class: "wv-muted",
 			style: link
@@ -375,7 +386,7 @@ function footer(props) {
 			href: `${instance.docs}/getting-started/introduction`,
 			class: "wv-muted",
 			style: link
-		}, "Docs")] : []])
+		}, say("docs"))] : []])
 	])])]);
 }
 function separator() {

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

@@ -1,3 +1,5 @@
+import { Locale } from "../shared/i18n.js";
+import { PropType } from "vue";
 /**
  * An invitation to an app: who invited, where to go, and that signing in with this address is
  * all it takes. Send it with `sendMail({ to, template: InviteEmail, props: { by, app, url } })`.
@@ -33,6 +35,11 @@ export declare const InviteEmail: import("vue").DefineComponent<import("vue").Ex
     type: StringConstructor;
     default: string;
   };
+  /** The language of the invitation's own texts; `message`, `action` and `note` stay as given. */
+  lang: {
+    type: PropType<Locale>;
+    default: string;
+  };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -66,8 +73,14 @@ export declare const InviteEmail: import("vue").DefineComponent<import("vue").Ex
     type: StringConstructor;
     default: string;
   };
+  /** The language of the invitation's own texts; `message`, `action` and `note` stay as given. */
+  lang: {
+    type: PropType<Locale>;
+    default: string;
+  };
 }>> & Readonly<{}>, {
   message: string;
   action: string;
   note: string;
+  lang: "de" | "en";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/runtime/email/invite.js

@@ -1,3 +1,5 @@
+import { isLocale, translator } from "../shared/i18n.js";
+import { mailMessages } from "../shared/messages.js";
 import { EmailButton, EmailHeading, EmailMuted, EmailText, WervtEmail } from "./components.js";
 import { defineComponent, h } from "vue";
 // src/runtime/email/invite.ts
@@ -37,23 +39,37 @@ const InviteEmail = defineComponent({
 		note: {
 			type: String,
 			default: ""
+		},
+		/** The language of the invitation's own texts; `message`, `action` and `note` stay as given. */
+		lang: {
+			type: String,
+			default: "en"
 		}
 	},
 	setup(props) {
-		return () => h(WervtEmail, {
-			subject: `${props.by} invited you to ${props.app}`,
-			app: props.app,
-			preview: props.message || `Join ${props.app}`,
-			reason: `You received this email because ${props.by} invited this address.`
-		}, () => [
-			h(EmailHeading, { eyebrow: "Invitation" }, () => `You're invited to ${props.app}`),
-			h(EmailText, () => [`${props.by} invited you to ${props.app}.`, props.message].filter(Boolean).join(" ")),
-			h(EmailButton, {
-				href: props.url,
-				color: "neutral"
-			}, () => props.action || `Open ${props.app}`),
-			h(EmailMuted, () => props.note || "Sign in with this email address to get in.")
-		]);
+		return () => {
+			const lang = isLocale(props.lang) ? props.lang : "en";
+			const t = translator(mailMessages, lang);
+			const who = {
+				by: props.by,
+				app: props.app
+			};
+			return h(WervtEmail, {
+				subject: t("inviteSubject", who),
+				app: props.app,
+				preview: props.message || t("invitePreview", who),
+				reason: t("inviteReason", who),
+				lang
+			}, () => [
+				h(EmailHeading, { eyebrow: t("inviteEyebrow") }, () => t("inviteHeading", who)),
+				h(EmailText, () => [t("inviteText", who), props.message].filter(Boolean).join(" ")),
+				h(EmailButton, {
+					href: props.url,
+					color: "neutral"
+				}, () => props.action || t("inviteAction", who)),
+				h(EmailMuted, () => props.note || t("inviteNote"))
+			]);
+		};
 	}
 });
 export { InviteEmail };

package/dist/runtime/i18n.d.ts

@@ -0,0 +1,3 @@
+import { Catalog, DEFAULT_LOCALE, LOCALES, Locale, Messages, Translate, catalogProblems, defineMessages, isLocale, negotiateLocale, translator } from "./shared/i18n.js";
+import { mailMessages } from "./shared/messages.js";
+export { Catalog, DEFAULT_LOCALE, LOCALES, Locale, Messages, Translate, catalogProblems, defineMessages, isLocale, mailMessages, negotiateLocale, translator };

package/dist/runtime/i18n.js

@@ -0,0 +1,3 @@
+import { DEFAULT_LOCALE, LOCALES, catalogProblems, defineMessages, isLocale, negotiateLocale, translator } from "./shared/i18n.js";
+import { mailMessages } from "./shared/messages.js";
+export { DEFAULT_LOCALE, LOCALES, catalogProblems, defineMessages, isLocale, mailMessages, negotiateLocale, translator };

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

@@ -0,0 +1,28 @@
+export declare const LOCALES: readonly ['en', 'de'];
+export type Locale = (typeof LOCALES)[number];
+export declare const DEFAULT_LOCALE: Locale;
+export declare const isLocale: (value: unknown) => value is Locale;
+/**
+ * The best supported language for an `Accept-Language` header: the highest-ranked one there is a
+ * catalog for, English when there's none.
+ */
+export declare function negotiateLocale(header: string | null | undefined): Locale;
+/** One locale's texts, with the keys of the English catalog. */
+export type Catalog<M> = { readonly [K in keyof M]: string; };
+/** Every locale's catalog; English is the source of keys and placeholders. */
+export type Messages<M> = {
+  en: M;
+} & { [L in Exclude<Locale, 'en'>]: Catalog<M>; };
+/** Checks the catalogs against English at compile time; returns them unchanged. */
+export declare const defineMessages: <const M extends Record<string, string>>(messages: Messages<M>) => Messages<M>;
+type Placeholders<S> = S extends `${string}{${infer K}}${infer Rest}` ? K | Placeholders<Rest> : never;
+type Params<S> = [Placeholders<S>] extends [never] ? [] : [params: Record<Placeholders<S>, string | number>];
+export type Translate<M> = <K extends keyof M & string>(key: K, ...params: Params<M[K]>) => string;
+/** `t(key, params)` for one locale. */
+export declare function translator<M extends Record<string, string>>(messages: Messages<M>, locale: Locale): Translate<M>;
+/**
+ * What's wrong with the catalogs, for tests: keys English has and another locale lacks (or the
+ * other way round), empty texts and placeholders that differ from English.
+ */
+export declare function catalogProblems(messages: Messages<Record<string, string>>): string[];
+export {};

package/dist/runtime/shared/i18n.js

@@ -0,0 +1,54 @@
+// src/runtime/shared/i18n.ts
+const LOCALES = ["en", "de"];
+const DEFAULT_LOCALE = "en";
+const isLocale = (value) => typeof value === "string" && LOCALES.includes(value);
+/**
+* The best supported language for an `Accept-Language` header: the highest-ranked one there is a
+* catalog for, English when there's none.
+*/
+function negotiateLocale(header) {
+	if (!header) return "en";
+	return header.split(",").map((part, index) => {
+		const [tag = "", ...params] = part.trim().split(";");
+		const q = params.map((p) => p.trim()).find((p) => p.startsWith("q="));
+		return {
+			lang: tag.trim().toLowerCase().split("-")[0],
+			q: q ? Number(q.slice(2)) : 1,
+			index
+		};
+	}).filter((entry) => entry.q > 0).sort((a, b) => b.q - a.q || a.index - b.index).map((entry) => entry.lang).find(isLocale) ?? "en";
+}
+/** Checks the catalogs against English at compile time; returns them unchanged. */
+const defineMessages = (messages) => messages;
+const fill = (text, params) => params ? text.replace(/\{(\w+)\}/g, (all, key) => String(params[key] ?? all)) : text;
+/** `t(key, params)` for one locale. */
+function translator(messages, locale) {
+	const catalog = messages[locale];
+	return (key, ...params) => fill(catalog[key] ?? messages.en[key], params[0]);
+}
+const placeholders = (text) => [...text.matchAll(/\{(\w+)\}/g)].map((m) => m[1]).sort();
+/**
+* What's wrong with the catalogs, for tests: keys English has and another locale lacks (or the
+* other way round), empty texts and placeholders that differ from English.
+*/
+function catalogProblems(messages) {
+	const problems = [];
+	const source = messages.en;
+	for (const locale of LOCALES) {
+		const catalog = messages[locale];
+		for (const key of /* @__PURE__ */ new Set([...Object.keys(source), ...Object.keys(catalog)])) {
+			const text = catalog[key];
+			if (!(key in source)) problems.push(`${locale}.${key}: not in en`);
+			else if (text === void 0) problems.push(`${locale}.${key}: missing`);
+			else if (!text.trim()) problems.push(`${locale}.${key}: empty`);
+			else {
+				const own = placeholders(text).join(",");
+				const expected = placeholders(source[key]).join(",");
+				if (own !== expected) problems.push(`${locale}.${key}: placeholders ${fmt(own)} differ from en ${fmt(expected)}`);
+			}
+		}
+	}
+	return problems;
+}
+const fmt = (list) => list.split(",").filter(Boolean).map((p) => `{${p}}`).join(" ");
+export { DEFAULT_LOCALE, LOCALES, catalogProblems, defineMessages, isLocale, negotiateLocale, translator };

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

@@ -0,0 +1,15 @@
+import { Messages } from "./i18n.js";
+export declare const mailMessages: Messages<{
+  readonly sentBy: "Sent by {app}";
+  readonly sentByVia: "Sent by {app} via wervt";
+  readonly securedBy: "Secured by wervt";
+  readonly docs: "Docs";
+  readonly inviteSubject: "{by} invited you to {app}";
+  readonly invitePreview: "Join {app}";
+  readonly inviteReason: "You received this email because {by} invited this address.";
+  readonly inviteEyebrow: "Invitation";
+  readonly inviteHeading: "You're invited to {app}";
+  readonly inviteText: "{by} invited you to {app}.";
+  readonly inviteAction: "Open {app}";
+  readonly inviteNote: "Sign in with this email address to get in.";
+}>;

package/dist/runtime/shared/messages.js

@@ -0,0 +1,33 @@
+import { defineMessages } from "./i18n.js";
+// src/runtime/shared/messages.ts
+const mailMessages = defineMessages({
+	en: {
+		sentBy: "Sent by {app}",
+		sentByVia: "Sent by {app} via wervt",
+		securedBy: "Secured by wervt",
+		docs: "Docs",
+		inviteSubject: "{by} invited you to {app}",
+		invitePreview: "Join {app}",
+		inviteReason: "You received this email because {by} invited this address.",
+		inviteEyebrow: "Invitation",
+		inviteHeading: "You're invited to {app}",
+		inviteText: "{by} invited you to {app}.",
+		inviteAction: "Open {app}",
+		inviteNote: "Sign in with this email address to get in."
+	},
+	de: {
+		sentBy: "Gesendet von {app}",
+		sentByVia: "Gesendet von {app} über wervt",
+		securedBy: "Gesichert durch wervt",
+		docs: "Doku",
+		inviteSubject: "{by} hat dich zu {app} eingeladen",
+		invitePreview: "Mach mit bei {app}",
+		inviteReason: "Du bekommst diese E-Mail, weil {by} diese Adresse eingeladen hat.",
+		inviteEyebrow: "Einladung",
+		inviteHeading: "Du bist zu {app} eingeladen",
+		inviteText: "{by} hat dich zu {app} eingeladen.",
+		inviteAction: "{app} öffnen",
+		inviteNote: "Melde dich mit dieser E-Mail-Adresse an, um reinzukommen."
+	}
+});
+export { mailMessages };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wervt/nuxt",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Nuxt module for apps hosted on wervt: database, live data, MCP and runtime setup.",
   "keywords": [
     "drizzle",
@@ -37,6 +37,10 @@
       "types": "./dist/runtime/email/index.d.ts",
       "default": "./dist/runtime/email/index.js"
     },
+    "./i18n": {
+      "types": "./dist/runtime/i18n.d.ts",
+      "default": "./dist/runtime/i18n.js"
+    },
     "./anthropic": {
       "types": "./dist/runtime/server/anthropic.d.ts",
       "default": "./dist/runtime/server/anthropic.js"
@@ -51,7 +55,7 @@
     "@valibot/to-json-schema": "^1.8.0",
     "@wervt/client": "^0.0.2",
     "@wervt/core": "^0.0.2",
-    "@wervt/nitro": "^0.0.2",
+    "@wervt/nitro": "^0.0.3",
     "@wervt/platform": "^0.0.2",
     "aws4fetch": "^1.0.20",
     "evlog": "^2.34.0",