nuxt-generation-emails 1.0.2 → 1.0.4

package/README.md

@@ -46,7 +46,7 @@ export default defineNuxtConfig({
 Scaffold the emails directory with example templates and reusable components:
 
 ```bash
-npx nuxt-gen-emails setup
+npx nuxt-generation-emails setup
 ```
 
 This creates:
@@ -82,9 +82,9 @@ Then add this to your `.vscode/settings.json` so `.mjml` files get Handlebars hi
 ### 3. Add More Templates
 
 ```bash
-npx nuxt-gen-emails add welcome
-npx nuxt-gen-emails add v1/order-confirmation
-npx nuxt-gen-emails add marketing/campaigns/summer-sale
+npx nuxt-generation-emails add welcome
+npx nuxt-generation-emails add v1/order-confirmation
+npx nuxt-generation-emails add marketing/campaigns/summer-sale
 ```
 
 Each command creates a `.vue` + `.mjml` pair with a ready-to-customize starter template.
@@ -289,14 +289,14 @@ The `components/` directory is reserved — it is skipped during route generatio
 
 ## Sending Emails
 
-The generated `POST` endpoints render email HTML via MJML. To send, register a Nitro plugin that listens for the `nuxt-gen-emails:send` hook.
+The generated `POST` endpoints render email HTML via MJML. To send, register a Nitro plugin that listens for the `nuxt-generation-emails:send` hook.
 
 ### Server plugin
 
 ```ts
 // server/plugins/gen-emails.ts
 export default defineNitroPlugin((nitro) => {
-  nitro.hooks.hook('nuxt-gen-emails:send', async ({ html, data }) => {
+  nitro.hooks.hook('nuxt-generation-emails:send', async ({ html, data }) => {…})
     // data contains: { to?, from?, subject?, ...anything from sendData }
     console.log('Sending email to:', data.to)
     // Your provider logic here (SendGrid, SES, Postmark, etc.)
@@ -317,7 +317,7 @@ import sgMail from '@sendgrid/mail'
 export default defineNitroPlugin((nitro) => {
   sgMail.setApiKey(process.env.SENDGRID_API_KEY!)
 
-  nitro.hooks.hook('nuxt-gen-emails:send', async ({ html, data }) => {
+  nitro.hooks.hook('nuxt-generation-emails:send', async ({ html, data }) => {
     await sgMail.send({
       to: data.to as string,
       from: (data.from as string) || 'noreply@yourdomain.com',
@@ -352,7 +352,7 @@ curl -X POST http://localhost:3000/api/emails/welcome \
 
 1. `templateData` from the request body is passed directly to the Handlebars template (no transformations)
 2. MJML compiles the result into email-safe HTML
-3. The `nuxt-gen-emails:send` hook is called with `{ html, data }` where `data` is `sendData`
+3. The `nuxt-generation-emails:send` hook is called with `{ html, data }` where `data` is `sendData`
 4. The response always returns `{ success: true, html: "..." }`
 
 If no Nitro plugin is configured, the endpoint still renders and returns the HTML — useful for testing.
@@ -426,8 +426,8 @@ export default defineEventHandler((event) => {
 
 | Command | Description |
 |---------|-------------|
-| `npx nuxt-gen-emails setup` | Scaffold the emails directory with components and an example template |
-| `npx nuxt-gen-emails add <name>` | Create a new email template (`.vue` + `.mjml` pair) |
+| `npx nuxt-generation-emails setup` | Scaffold the emails directory with components and an example template |
+| `npx nuxt-generation-emails add <name>` | Create a new email template (`.vue` + `.mjml` pair) |
 
 ---
 

package/dist/cli/index.mjs

@@ -423,8 +423,8 @@ const setupCommand = defineCommand({
 
 const main = defineCommand({
   meta: {
-    name: "nuxt-gen-emails",
-    description: "CLI for nuxt-gen-emails module",
+    name: "nuxt-generation-emails",
+    description: "CLI for nuxt-generation-emails module",
     version: "1.0.0"
   },
   subCommands: {

package/dist/module.d.mts

@@ -1,6 +1,6 @@
 import * as _nuxt_schema from '@nuxt/schema';
 
-/** Payload passed to the `nuxt-gen-emails:send` Nitro runtime hook. */
+/** Payload passed to the `nuxt-generation-emails:send` Nitro runtime hook. */
 type NuxtGenEmailsSendData<TAdditional extends Record<string, unknown> = Record<string, unknown>> = {
     /** Recipient email address. */
     to?: string;
@@ -9,7 +9,7 @@ type NuxtGenEmailsSendData<TAdditional extends Record<string, unknown> = Record<
     /** Email subject line. */
     subject?: string;
 } & TAdditional;
-/** Payload passed to the `nuxt-gen-emails:send` Nitro runtime hook. */
+/** Payload passed to the `nuxt-generation-emails:send` Nitro runtime hook. */
 interface NuxtGenEmailsSendPayload<TSendData extends Record<string, unknown> = NuxtGenEmailsSendData> {
     /** The rendered HTML string of the email template. */
     html: string;

package/dist/module.d.ts

@@ -1,6 +1,6 @@
 import * as _nuxt_schema from '@nuxt/schema';
 
-/** Payload passed to the `nuxt-gen-emails:send` Nitro runtime hook. */
+/** Payload passed to the `nuxt-generation-emails:send` Nitro runtime hook. */
 type NuxtGenEmailsSendData<TAdditional extends Record<string, unknown> = Record<string, unknown>> = {
     /** Recipient email address. */
     to?: string;
@@ -9,7 +9,7 @@ type NuxtGenEmailsSendData<TAdditional extends Record<string, unknown> = Record<
     /** Email subject line. */
     subject?: string;
 } & TAdditional;
-/** Payload passed to the `nuxt-gen-emails:send` Nitro runtime hook. */
+/** Payload passed to the `nuxt-generation-emails:send` Nitro runtime hook. */
 interface NuxtGenEmailsSendPayload<TSendData extends Record<string, unknown> = NuxtGenEmailsSendData> {
     /** The rendered HTML string of the email template. */
     html: string;

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=4.0.0"
   },
-  "version": "1.0.2",
+  "version": "1.0.4",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -304,7 +304,7 @@ export default defineEventHandler(async (event) => {
 
     const nitro = useNitroApp()
     // @ts-ignore - custom hook
-    await nitro.hooks.callHook('nuxt-gen-emails:send', { html, data: sendData })
+    await nitro.hooks.callHook('nuxt-generation-emails:send', { html, data: sendData })
 
     return { success: true, message: 'Email rendered successfully', html }
   }
@@ -506,7 +506,7 @@ function generateServerRoutes(emailsDir, buildDir) {
         const emailPath = `${routePrefix}/${emailName}`.replace(/^\//, "");
         const mjmlPath = join(dirPath, `${emailName}.mjml`);
         if (!fs.existsSync(mjmlPath)) {
-          console.warn(`[nuxt-gen-emails] Missing co-located MJML file for ${emailName}.vue \u2014 skipping API route. Expected: ${mjmlPath}`);
+          console.warn(`[nuxt-generation-emails] Missing co-located MJML file for ${emailName}.vue \u2014 skipping API route. Expected: ${mjmlPath}`);
           continue;
         }
         const handlerDir = routePrefix ? join(handlersDir, routePrefix.replace(/^\//, "")) : handlersDir;
@@ -519,7 +519,7 @@ function generateServerRoutes(emailsDir, buildDir) {
         const handlerFilePath = join(handlerDir, handlerFileName);
         const handlerContent = generateApiRoute(emailName, emailPath, examplePayload);
         fs.writeFileSync(handlerFilePath, handlerContent, "utf-8");
-        console.log(`[nuxt-gen-emails] Generated API handler: ${handlerFilePath}`);
+        console.log(`[nuxt-generation-emails] Generated API handler: ${handlerFilePath}`);
         handlers.push({
           route: `/api/emails/${emailPath}`,
           method: "post",
@@ -548,7 +548,7 @@ const module$1 = defineNuxtModule({
   async setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
     addTypeTemplate({
-      filename: "types/nuxt-gen-emails-nitro.d.ts",
+      filename: "types/nuxt-generation-emails-nitro.d.ts",
       getContents: () => `
 export interface NuxtGenEmailsSendPayload {
   html: string
@@ -571,12 +571,12 @@ export interface NuxtGenEmailsApiBody<
 
 declare module 'nitropack' {
   interface NitroRuntimeHooks {
-    'nuxt-gen-emails:send': (payload: NuxtGenEmailsSendPayload) => void | Promise<void>
+    'nuxt-generation-emails:send': (payload: NuxtGenEmailsSendPayload) => void | Promise<void>
   }
 }
 declare module 'nitropack/types' {
   interface NitroRuntimeHooks {
-    'nuxt-gen-emails:send': (payload: NuxtGenEmailsSendPayload) => void | Promise<void>
+    'nuxt-generation-emails:send': (payload: NuxtGenEmailsSendPayload) => void | Promise<void>
   }
 }
 `
@@ -605,10 +605,15 @@ export function registerMjmlComponents(): void {
       write: true,
       getContents: () => `import { computed, h, getCurrentInstance } from 'vue'
 import type { ComputedRef } from 'vue'
-import mjml2html from 'mjml-browser'
 import Handlebars from 'handlebars'
 import { registerMjmlComponents } from './register-components'
 
+// Lazy-load mjml-browser only on the client to avoid "window is not defined" during SSR
+let mjml2html: ((mjml: string) => { html: string; errors: unknown[] }) | null = null
+if (import.meta.client) {
+  mjml2html = (await import('mjml-browser')).default
+}
+
 const mjmlTemplates: Record<string, string> = import.meta.glob(
   ['${templateGlobPath}/**/*.mjml', '!${templateGlobPath}/components/**'],
   { query: '?raw', import: 'default', eager: true }
@@ -644,7 +649,7 @@ export function useNgeTemplate(name: string, props: Record<string, unknown>): Co
   const source = templateMap[name]
   if (!source) {
     const available = Object.keys(templateMap).join(', ')
-    console.error(\`[nuxt-gen-emails] Template "\${name}" not found. Available: \${available}\`)
+    console.error(\`[nuxt-generation-emails] Template "\${name}" not found. Available: \${available}\`)
     const fallback = computed(() => \`<pre style="color:red;">Template "\${name}" not found</pre>\`)
     const instance = getCurrentInstance()
     if (instance) instance.render = () => h('div', { innerHTML: fallback.value })
@@ -654,6 +659,8 @@ export function useNgeTemplate(name: string, props: Record<string, unknown>): Co
   const compiled = Handlebars.compile(source)
 
   const renderedHtml = computed(() => {
+    // mjml-browser requires window \u2014 skip rendering during SSR
+    if (!mjml2html) return ''
     try {
       const mjmlString = compiled({ ...props })
       const result = mjml2html(mjmlString)
@@ -724,19 +731,19 @@ export function useNgeTemplate(name: string, props: Record<string, unknown>): Co
     }
     if (nuxt.options.dev && fs.existsSync(emailsDir)) {
       const relDir = relative(nuxt.options.rootDir, emailsDir);
-      consola.info(`[nuxt-gen-emails] Watching for new templates in ${relDir}/`);
+      consola.info(`[nuxt-generation-emails] Watching for new templates in ${relDir}/`);
       nuxt.options.watch.push(emailsDir + "/**/*.vue");
       nuxt.options.watch.push(emailsDir + "/**/*.mjml");
       nuxt.hook("builder:watch", (event, relativePath) => {
         const absolutePath = join(nuxt.options.rootDir, relativePath);
         const rel = relative(emailsDir, absolutePath);
         if (event === "add" && (relativePath.endsWith(".vue") || relativePath.endsWith(".mjml"))) {
-          consola.success(`[nuxt-gen-emails] New template detected: ${rel}`);
-          consola.info("[nuxt-gen-emails] Restarting to register new routes...");
+          consola.success(`[nuxt-generation-emails] New template detected: ${rel}`);
+          consola.info("[nuxt-generation-emails] Restarting to register new routes...");
           nuxt.callHook("restart");
         } else if (event === "unlink" && (relativePath.endsWith(".vue") || relativePath.endsWith(".mjml"))) {
-          consola.warn(`[nuxt-gen-emails] Template removed: ${rel}`);
-          consola.info("[nuxt-gen-emails] Restarting to update routes...");
+          consola.warn(`[nuxt-generation-emails] Template removed: ${rel}`);
+          consola.info("[nuxt-generation-emails] Restarting to update routes...");
           nuxt.callHook("restart");
         }
       });

package/dist/runtime/components/ApiTester.vue

@@ -11,7 +11,7 @@ const responseData = ref(null);
 const error = ref("");
 const copySuccess = ref(false);
 const copyHtmlSuccess = ref(false);
-const lastUsedEmail = useCookie("nuxt-gen-emails-last-email", {
+const lastUsedEmail = useCookie("nuxt-generation-emails-last-email", {
   default: () => "",
   sameSite: "lax"
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-generation-emails",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "A Nuxt module for authoring, previewing, and sending transactional email templates with MJML and Handlebars.",
   "author": "nullcarry@icloud.com",
   "repository": {
@@ -31,7 +31,7 @@
     }
   },
   "bin": {
-    "nuxt-gen-emails": "./dist/cli/index.mjs"
+    "nuxt-generation-emails": "./dist/cli/index.mjs"
   },
   "main": "./dist/module.mjs",
   "types": "./dist/types.d.mts",