@storyshelf/notify-email 0.0.0-stage → 0.5.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddhant Gupta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,50 @@
-# Temporary Holding Version
+# @storyshelf/notify-email
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Email notification transport for StoryShelf: one SMTP/HTTP transport serves notification channels and (optionally) auth mail. Owns `nodemailer`; no other package imports it directly.
+
+## Install
+
+```sh
+nub add @storyshelf/notify-email
+```
+
+## Quick start
+
+```ts
+import { createShelfApp } from "@storyshelf/app";
+import { createShelfAuth } from "@storyshelf/auth";
+import { createEmailNotifier, smtpPreset } from "@storyshelf/notify-email";
+
+const sender = smtpPreset({ host: "mail.example.com", port: 587, from: "shelf@example.com" });
+const app = createShelfApp({
+  database,
+  storage,
+  notifiers: [createEmailNotifier(sender, { from: "shelf@example.com" })],
+  // Optional: invites and password resets share the same transport.
+  // auth: createShelfAuth({ db, secret, baseURL, emailSender: sender }),
+});
+```
+
+Presets: `smtpPreset` (corporate relay, Postfix, SES-over-SMTP), `mailpitPreset` (local dev, `localhost:1025`), `logPreset` (tests/unconfigured), `httpPreset` (Resend/Postmark-style JSON endpoint). See [Notifications](/guides/notifications/).
+
+## Install notes
+
+`smtpPreset` needs the optional `nodemailer` peer:
+
+```sh
+nub add nodemailer
+```
+
+Log and HTTP presets work without it.
+
+## Subpaths
+
+Each preset is importable on its own (root aggregates all):
+
+```ts
+import { smtpPreset, smtpPresetFromEnv } from "@storyshelf/notify-email/smtp";
+import { mailpitPreset } from "@storyshelf/notify-email/mailpit";
+import { logPreset } from "@storyshelf/notify-email/log";
+import { httpPreset } from "@storyshelf/notify-email/http";
+import { createEmailNotifier } from "@storyshelf/notify-email/email";
+```

package/dist/email.d.mts

@@ -0,0 +1,23 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { EmailSender } from "@storyshelf/core/adapter/email-sender";
+import { NotifierProvider } from "@storyshelf/core/adapter/notifier";
+import { Logger } from "@storyshelf/core/logger";
+//#region src/email.d.ts
+/** Defaults applied when a channel omits sender identity. */
+interface EmailNotifierDefaults {
+  from?: string;
+  replyTo?: string;
+}
+/**
+ * Create the `email` channel provider over a shared transport.
+ * The same {@link EmailSender} can also serve auth mail (invites, resets).
+ */
+declare function createEmailNotifier(sender: EmailSender, defaults?: EmailNotifierDefaults & {
+  logger?: Logger;
+}): NotifierProvider;
+/** Describe the email provider (name, version, config schema). */
+declare function getMetadata(): NotifierProvider["metadata"];
+//#endregion
+export { EmailNotifierDefaults, createEmailNotifier, getMetadata };
+//# sourceMappingURL=email.d.mts.map

package/dist/email.mjs

@@ -0,0 +1,51 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { emailChannelConfigSchema } from "./types.mjs";
+//#region src/email.ts
+/**
+* Create the `email` channel provider over a shared transport.
+* The same {@link EmailSender} can also serve auth mail (invites, resets).
+*/
+function createEmailNotifier(sender, defaults = {}) {
+	return {
+		metadata: getMetadata(),
+		create(opts) {
+			const config = emailChannelConfigSchema.parse(opts.config);
+			const logger = (opts.logger ?? defaults.logger)?.child({ component: "notify-email" });
+			return {
+				metadata: getMetadata(),
+				async send(input) {
+					logger?.debug({ channelId: input.channel.id }, "sending email notification");
+					await sender.send({
+						to: config.to,
+						subject: input.formatted.subject,
+						text: input.formatted.text,
+						html: input.formatted.html,
+						from: config.from ?? defaults.from,
+						replyTo: config.replyTo ?? defaults.replyTo
+					});
+					logger?.info({
+						channelId: input.channel.id,
+						to: config.to
+					}, "email sent");
+				}
+			};
+		}
+	};
+}
+/** Describe the email provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "Email",
+		version: globalThis.__PKG_VERSION__ ?? "0.0.0",
+		description: "Email notifications over a shared SMTP/HTTP transport",
+		kind: "email",
+		category: "notifier",
+		schema: emailChannelConfigSchema
+	};
+}
+//#endregion
+export { createEmailNotifier, getMetadata };
+
+//# sourceMappingURL=email.mjs.map

package/dist/email.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.mjs","names":[],"sources":["../src/email.ts"],"sourcesContent":["import type { EmailSender } from \"@storyshelf/core/adapter/email-sender\";\nimport type { NotifierAdapter, NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { emailChannelConfigSchema } from \"./types.ts\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Defaults applied when a channel omits sender identity. */\nexport interface EmailNotifierDefaults {\n  from?: string;\n  replyTo?: string;\n}\n\n/**\n * Create the `email` channel provider over a shared transport.\n * The same {@link EmailSender} can also serve auth mail (invites, resets).\n */\nexport function createEmailNotifier(\n  sender: EmailSender,\n  defaults: EmailNotifierDefaults & { logger?: Logger } = {},\n): NotifierProvider {\n  return {\n    metadata: getMetadata(),\n    create(opts: { config: unknown; secret?: string; logger?: Logger }): NotifierAdapter {\n      const config = emailChannelConfigSchema.parse(opts.config);\n      const logger = (opts.logger ?? defaults.logger)?.child({ component: \"notify-email\" });\n      return {\n        metadata: getMetadata(),\n        async send(input): Promise<void> {\n          logger?.debug({ channelId: input.channel.id }, \"sending email notification\");\n          await sender.send({\n            to: config.to,\n            subject: input.formatted.subject,\n            text: input.formatted.text,\n            html: input.formatted.html,\n            from: config.from ?? defaults.from,\n            replyTo: config.replyTo ?? defaults.replyTo,\n          });\n          logger?.info({ channelId: input.channel.id, to: config.to }, \"email sent\");\n        },\n      };\n    },\n  };\n}\n\n/** Describe the email provider (name, version, config schema). */\nexport function getMetadata(): NotifierProvider[\"metadata\"] {\n  return {\n    name: \"Email\",\n    version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n    description: \"Email notifications over a shared SMTP/HTTP transport\",\n    kind: \"email\",\n    category: \"notifier\",\n    schema: emailChannelConfigSchema,\n  };\n}\n"],"mappings":";;;;;;;;;AAiBA,SAAgB,oBACd,QACA,WAAwD,CAAC,GACvC;CAClB,OAAO;EACL,UAAU,YAAY;EACtB,OAAO,MAA8E;GACnF,MAAM,SAAS,yBAAyB,MAAM,KAAK,MAAM;GACzD,MAAM,UAAU,KAAK,UAAU,SAAS,OAAA,EAAS,MAAM,EAAE,WAAW,eAAe,CAAC;GACpF,OAAO;IACL,UAAU,YAAY;IACtB,MAAM,KAAK,OAAsB;KAC/B,QAAQ,MAAM,EAAE,WAAW,MAAM,QAAQ,GAAG,GAAG,4BAA4B;KAC3E,MAAM,OAAO,KAAK;MAChB,IAAI,OAAO;MACX,SAAS,MAAM,UAAU;MACzB,MAAM,MAAM,UAAU;MACtB,MAAM,MAAM,UAAU;MACtB,MAAM,OAAO,QAAQ,SAAS;MAC9B,SAAS,OAAO,WAAW,SAAS;KACtC,CAAC;KACD,QAAQ,KAAK;MAAE,WAAW,MAAM,QAAQ;MAAI,IAAI,OAAO;KAAG,GAAG,YAAY;IAC3E;GACF;EACF;CACF;AACF;;AAGA,SAAgB,cAA4C;CAC1D,OAAO;EACL,MAAM;EACN,SAAU,WAAuD,mBAAmB;EACpF,aAAa;EACb,MAAM;EACN,UAAU;EACV,QAAQ;CACV;AACF"}

package/dist/http.d.mts

@@ -0,0 +1,13 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { HttpPresetOptions } from "./types.mjs";
+import { EmailSender } from "@storyshelf/core/adapter/email-sender";
+import { Logger } from "@storyshelf/core/logger";
+//#region src/http.d.ts
+/** HTTP email-API preset (Resend/Postmark-style JSON endpoint). */
+declare function httpPreset(options: HttpPresetOptions & {
+  logger?: Logger;
+}): EmailSender;
+//#endregion
+export { httpPreset };
+//# sourceMappingURL=http.d.mts.map

package/dist/http.mjs

@@ -0,0 +1,44 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { version } from "./version.mjs";
+import { httpText } from "@storyshelf/core/utils";
+//#region src/http.ts
+/** HTTP email-API preset (Resend/Postmark-style JSON endpoint). */
+function httpPreset(options) {
+	let logger = options.logger?.child({ component: "notify-email-http" });
+	return {
+		metadata: {
+			name: "HTTP",
+			version: version(),
+			kind: "email-http",
+			category: "notifier"
+		},
+		setLogger(next) {
+			logger = next.child({ component: "notify-email-http" });
+		},
+		async send(message) {
+			logger?.debug({
+				to: message.to,
+				subject: message.subject
+			}, "sending email via HTTP");
+			await httpText(options.url, {
+				method: "POST",
+				headers: options.headers,
+				json: {
+					from: message.from ?? options.from,
+					to: message.to,
+					subject: message.subject,
+					text: message.text,
+					html: message.html
+				},
+				logger
+			});
+			logger?.info({ to: message.to }, "email sent via HTTP");
+		}
+	};
+}
+//#endregion
+export { httpPreset };
+
+//# sourceMappingURL=http.mjs.map

package/dist/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import type { EmailMessage, EmailSender } from \"@storyshelf/core/adapter/email-sender\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { httpText } from \"@storyshelf/core/utils\";\nimport type { HttpPresetOptions } from \"./types.ts\";\nimport { version } from \"./version.ts\";\n\n/** HTTP email-API preset (Resend/Postmark-style JSON endpoint). */\nexport function httpPreset(options: HttpPresetOptions & { logger?: Logger }): EmailSender {\n  let logger = options.logger?.child({ component: \"notify-email-http\" });\n  return {\n    metadata: {\n      name: \"HTTP\",\n      version: version(),\n      kind: \"email-http\",\n      category: \"notifier\",\n    },\n    setLogger(next: Logger): void {\n      logger = next.child({ component: \"notify-email-http\" });\n    },\n    async send(message: EmailMessage): Promise<void> {\n      logger?.debug({ to: message.to, subject: message.subject }, \"sending email via HTTP\");\n      await httpText(options.url, {\n        method: \"POST\",\n        headers: options.headers,\n        json: {\n          from: message.from ?? options.from,\n          to: message.to,\n          subject: message.subject,\n          text: message.text,\n          html: message.html,\n        },\n        logger,\n      });\n      logger?.info({ to: message.to }, \"email sent via HTTP\");\n    },\n  };\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,WAAW,SAA+D;CACxF,IAAI,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,oBAAoB,CAAC;CACrE,OAAO;EACL,UAAU;GACR,MAAM;GACN,SAAS,QAAQ;GACjB,MAAM;GACN,UAAU;EACZ;EACA,UAAU,MAAoB;GAC5B,SAAS,KAAK,MAAM,EAAE,WAAW,oBAAoB,CAAC;EACxD;EACA,MAAM,KAAK,SAAsC;GAC/C,QAAQ,MAAM;IAAE,IAAI,QAAQ;IAAI,SAAS,QAAQ;GAAQ,GAAG,wBAAwB;GACpF,MAAM,SAAS,QAAQ,KAAK;IAC1B,QAAQ;IACR,SAAS,QAAQ;IACjB,MAAM;KACJ,MAAM,QAAQ,QAAQ,QAAQ;KAC9B,IAAI,QAAQ;KACZ,SAAS,QAAQ;KACjB,MAAM,QAAQ;KACd,MAAM,QAAQ;IAChB;IACA;GACF,CAAC;GACD,QAAQ,KAAK,EAAE,IAAI,QAAQ,GAAG,GAAG,qBAAqB;EACxD;CACF;AACF"}

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { EmailNotifierDefaults, createEmailNotifier } from "./email.mjs";
+import { EmailChannelConfig, HttpPresetOptions, SmtpPresetOptions, emailChannelConfigSchema } from "./types.mjs";
+import { httpPreset } from "./http.mjs";
+import { logPreset } from "./log.mjs";
+import { mailpitPreset } from "./mailpit.mjs";
+import { smtpPreset, smtpPresetFromEnv } from "./smtp.mjs";
+export { type EmailChannelConfig, type EmailNotifierDefaults, type HttpPresetOptions, type SmtpPresetOptions, createEmailNotifier, emailChannelConfigSchema, httpPreset, logPreset, mailpitPreset, smtpPreset, smtpPresetFromEnv };

package/dist/index.mjs

@@ -0,0 +1,19 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { emailChannelConfigSchema } from "./types.mjs";
+import { createEmailNotifier } from "./email.mjs";
+import { httpPreset } from "./http.mjs";
+import { logPreset } from "./log.mjs";
+import { smtpPreset, smtpPresetFromEnv } from "./smtp.mjs";
+import { mailpitPreset } from "./mailpit.mjs";
+//#region src/index.ts
+/**
+* Email notification transport: SMTP/Mailpit/log/HTTP presets plus the
+* `email` channel provider. One transport serves notification channels
+* and (optionally) auth mail — wire the same sender into both.
+*/
+//#endregion
+export { createEmailNotifier, emailChannelConfigSchema, httpPreset, logPreset, mailpitPreset, smtpPreset, smtpPresetFromEnv };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { createEmailNotifier } from \"./email.ts\";\n/**\n * Email notification transport: SMTP/Mailpit/log/HTTP presets plus the\n * `email` channel provider. One transport serves notification channels\n * and (optionally) auth mail — wire the same sender into both.\n */\nimport { httpPreset } from \"./http.ts\";\nimport { logPreset } from \"./log.ts\";\nimport { mailpitPreset } from \"./mailpit.ts\";\nimport { smtpPreset, smtpPresetFromEnv } from \"./smtp.ts\";\n\n/** SMTP transport preset (corporate relay, Postfix, SES-over-SMTP). */\nexport { smtpPreset };\n/** SMTP sender from `SMTP_*` environment (undefined unless configured). */\nexport { smtpPresetFromEnv };\n/** Mailpit/Mailhog preset for local development (no real delivery). */\nexport { mailpitPreset };\n/** Log-only preset for tests and unconfigured servers (no delivery). */\nexport { logPreset };\n/** HTTP email-API preset (Resend/Postmark-style JSON endpoint). */\nexport { httpPreset };\n/** `email` channel provider over a shared transport. */\nexport { createEmailNotifier };\n\nexport type { EmailNotifierDefaults } from \"./email.ts\";\nexport type { EmailChannelConfig, HttpPresetOptions, SmtpPresetOptions } from \"./types.ts\";\nexport { emailChannelConfigSchema } from \"./types.ts\";\n"],"mappings":""}

package/dist/log.d.mts

@@ -0,0 +1,12 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { EmailSender } from "@storyshelf/core/adapter/email-sender";
+import { Logger } from "@storyshelf/core/logger";
+//#region src/log.d.ts
+/** Log-only preset for tests and unconfigured servers (no delivery). */
+declare function logPreset(options?: {
+  logger?: Logger;
+}): EmailSender;
+//#endregion
+export { logPreset };
+//# sourceMappingURL=log.d.mts.map

package/dist/log.mjs

@@ -0,0 +1,30 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { version } from "./version.mjs";
+//#region src/log.ts
+/** Log-only preset for tests and unconfigured servers (no delivery). */
+function logPreset(options = {}) {
+	let logger = options.logger?.child({ component: "notify-email-log" });
+	return {
+		metadata: {
+			name: "Log",
+			version: version(),
+			kind: "email-log",
+			category: "notifier"
+		},
+		setLogger(next) {
+			logger = next.child({ component: "notify-email-log" });
+		},
+		async send(message) {
+			logger?.info({
+				to: message.to,
+				subject: message.subject
+			}, "email notification (log)");
+		}
+	};
+}
+//#endregion
+export { logPreset };
+
+//# sourceMappingURL=log.mjs.map

package/dist/log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.mjs","names":[],"sources":["../src/log.ts"],"sourcesContent":["import type { EmailMessage, EmailSender } from \"@storyshelf/core/adapter/email-sender\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { version } from \"./version.ts\";\n\n/** Log-only preset for tests and unconfigured servers (no delivery). */\nexport function logPreset(options: { logger?: Logger } = {}): EmailSender {\n  let logger = options.logger?.child({ component: \"notify-email-log\" });\n  return {\n    metadata: { name: \"Log\", version: version(), kind: \"email-log\", category: \"notifier\" },\n    setLogger(next: Logger): void {\n      logger = next.child({ component: \"notify-email-log\" });\n    },\n    // oxlint-disable-next-line eslint/require-await -- send is async by contract\n    async send(message: EmailMessage): Promise<void> {\n      logger?.info({ to: message.to, subject: message.subject }, \"email notification (log)\");\n    },\n  };\n}\n"],"mappings":";;;;;;AAKA,SAAgB,UAAU,UAA+B,CAAC,GAAgB;CACxE,IAAI,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,mBAAmB,CAAC;CACpE,OAAO;EACL,UAAU;GAAE,MAAM;GAAO,SAAS,QAAQ;GAAG,MAAM;GAAa,UAAU;EAAW;EACrF,UAAU,MAAoB;GAC5B,SAAS,KAAK,MAAM,EAAE,WAAW,mBAAmB,CAAC;EACvD;EAEA,MAAM,KAAK,SAAsC;GAC/C,QAAQ,KAAK;IAAE,IAAI,QAAQ;IAAI,SAAS,QAAQ;GAAQ,GAAG,0BAA0B;EACvF;CACF;AACF"}

package/dist/mailpit.d.mts

@@ -0,0 +1,15 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { EmailSender } from "@storyshelf/core/adapter/email-sender";
+import { Logger } from "@storyshelf/core/logger";
+//#region src/mailpit.d.ts
+/** Mailpit/Mailhog preset for local development (no real delivery). */
+declare function mailpitPreset(options?: {
+  from?: string;
+  host?: string;
+  port?: number;
+  logger?: Logger;
+}): EmailSender;
+//#endregion
+export { mailpitPreset };
+//# sourceMappingURL=mailpit.d.mts.map

package/dist/mailpit.mjs

@@ -0,0 +1,18 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { smtpPreset } from "./smtp.mjs";
+//#region src/mailpit.ts
+/** Mailpit/Mailhog preset for local development (no real delivery). */
+function mailpitPreset(options = {}) {
+	return smtpPreset({
+		host: options.host ?? "localhost",
+		port: options.port ?? 1025,
+		from: options.from ?? "storyshelf@localhost",
+		logger: options.logger
+	});
+}
+//#endregion
+export { mailpitPreset };
+
+//# sourceMappingURL=mailpit.mjs.map

package/dist/mailpit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailpit.mjs","names":[],"sources":["../src/mailpit.ts"],"sourcesContent":["import type { EmailSender } from \"@storyshelf/core/adapter/email-sender\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { smtpPreset } from \"./smtp.ts\";\n\n/** Mailpit/Mailhog preset for local development (no real delivery). */\nexport function mailpitPreset(\n  options: { from?: string; host?: string; port?: number; logger?: Logger } = {},\n): EmailSender {\n  return smtpPreset({\n    host: options.host ?? \"localhost\",\n    port: options.port ?? 1025,\n    from: options.from ?? \"storyshelf@localhost\",\n    logger: options.logger,\n  });\n}\n"],"mappings":";;;;;;AAKA,SAAgB,cACd,UAA4E,CAAC,GAChE;CACb,OAAO,WAAW;EAChB,MAAM,QAAQ,QAAQ;EACtB,MAAM,QAAQ,QAAQ;EACtB,MAAM,QAAQ,QAAQ;EACtB,QAAQ,QAAQ;CAClB,CAAC;AACH"}

package/dist/smtp.d.mts

@@ -0,0 +1,25 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { SmtpPresetOptions } from "./types.mjs";
+import { EmailSender } from "@storyshelf/core/adapter/email-sender";
+import { Logger } from "@storyshelf/core/logger";
+//#region src/smtp.d.ts
+/**
+ * SMTP transport preset (corporate relay, Postfix, SES-over-SMTP).
+ *
+ * Requires the optional `nodemailer` peer (`nub add nodemailer`).
+ */
+declare function smtpPreset(options: SmtpPresetOptions & {
+  logger?: Logger;
+}): EmailSender;
+/**
+ * SMTP sender from the environment (`SMTP_HOST`, `SMTP_PORT`, `SMTP_SECURE`,
+ * `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM`). Returns undefined unless
+ * `SMTP_HOST` is set, so unconfigured servers keep current behavior.
+ *
+ * Requires the optional `nodemailer` peer when a sender is built.
+ */
+declare function smtpPresetFromEnv(env?: Record<string, string | undefined>, logger?: Logger): EmailSender | undefined;
+//#endregion
+export { smtpPreset, smtpPresetFromEnv };
+//# sourceMappingURL=smtp.d.mts.map

package/dist/smtp.mjs

@@ -0,0 +1,76 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { version } from "./version.mjs";
+import nodemailer from "nodemailer";
+//#region src/smtp.ts
+/**
+* SMTP transport preset (corporate relay, Postfix, SES-over-SMTP).
+*
+* Requires the optional `nodemailer` peer (`nub add nodemailer`).
+*/
+function smtpPreset(options) {
+	const transporter = nodemailer.createTransport({
+		host: options.host,
+		port: options.port,
+		secure: options.secure ?? options.port === 465,
+		auth: options.user ? {
+			user: options.user,
+			pass: options.pass
+		} : void 0
+	});
+	const from = options.from;
+	let logger = options.logger?.child({ component: "notify-email-smtp" });
+	return {
+		metadata: {
+			name: "SMTP",
+			version: version(),
+			kind: "email-smtp",
+			category: "notifier"
+		},
+		setLogger(next) {
+			logger = next.child({ component: "notify-email-smtp" });
+		},
+		async send(message) {
+			logger?.debug({
+				to: message.to,
+				subject: message.subject
+			}, "sending email");
+			await transporter.sendMail({
+				from: message.from ?? from,
+				to: message.to,
+				subject: message.subject,
+				text: message.text,
+				html: message.html,
+				replyTo: message.replyTo
+			});
+			logger?.info({ to: message.to }, "email sent");
+		}
+	};
+}
+/**
+* SMTP sender from the environment (`SMTP_HOST`, `SMTP_PORT`, `SMTP_SECURE`,
+* `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM`). Returns undefined unless
+* `SMTP_HOST` is set, so unconfigured servers keep current behavior.
+*
+* Requires the optional `nodemailer` peer when a sender is built.
+*/
+function smtpPresetFromEnv(env = process.env, logger) {
+	const host = env["SMTP_HOST"];
+	const from = env["SMTP_FROM"];
+	if (!host || !from) return;
+	const port = Number(env["SMTP_PORT"] ?? 587);
+	return smtpPreset({
+		host,
+		port: Number.isSafeInteger(port) && port > 0 ? port : 587,
+		secure: env["SMTP_SECURE"] === "1" || env["SMTP_SECURE"] === "true",
+		user: env["SMTP_USER"],
+		pass: env["SMTP_PASS"],
+		from,
+		logger
+	});
+}
+//#endregion
+export { smtpPreset, smtpPresetFromEnv };
+
+//# sourceMappingURL=smtp.mjs.map

package/dist/smtp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.mjs","names":[],"sources":["../src/smtp.ts"],"sourcesContent":["import type { EmailMessage, EmailSender } from \"@storyshelf/core/adapter/email-sender\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport nodemailer from \"nodemailer\";\nimport type { SmtpPresetOptions } from \"./types.ts\";\nimport { version } from \"./version.ts\";\n\n/**\n * SMTP transport preset (corporate relay, Postfix, SES-over-SMTP).\n *\n * Requires the optional `nodemailer` peer (`nub add nodemailer`).\n */\nexport function smtpPreset(options: SmtpPresetOptions & { logger?: Logger }): EmailSender {\n  const transporter = nodemailer.createTransport({\n    host: options.host,\n    port: options.port,\n    secure: options.secure ?? options.port === 465,\n    auth: options.user ? { user: options.user, pass: options.pass } : undefined,\n  });\n  const from = options.from;\n  let logger = options.logger?.child({ component: \"notify-email-smtp\" });\n  return {\n    metadata: {\n      name: \"SMTP\",\n      version: version(),\n      kind: \"email-smtp\",\n      category: \"notifier\",\n    },\n    setLogger(next: Logger): void {\n      logger = next.child({ component: \"notify-email-smtp\" });\n    },\n    async send(message: EmailMessage): Promise<void> {\n      logger?.debug({ to: message.to, subject: message.subject }, \"sending email\");\n      await transporter.sendMail({\n        from: message.from ?? from,\n        to: message.to,\n        subject: message.subject,\n        text: message.text,\n        html: message.html,\n        replyTo: message.replyTo,\n      });\n      logger?.info({ to: message.to }, \"email sent\");\n    },\n  };\n}\n\n/**\n * SMTP sender from the environment (`SMTP_HOST`, `SMTP_PORT`, `SMTP_SECURE`,\n * `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM`). Returns undefined unless\n * `SMTP_HOST` is set, so unconfigured servers keep current behavior.\n *\n * Requires the optional `nodemailer` peer when a sender is built.\n */\nexport function smtpPresetFromEnv(\n  env: Record<string, string | undefined> = process.env,\n  logger?: Logger,\n): EmailSender | undefined {\n  const host = env[\"SMTP_HOST\"];\n  const from = env[\"SMTP_FROM\"];\n  if (!host || !from) {\n    return undefined;\n  }\n  const port = Number(env[\"SMTP_PORT\"] ?? 587);\n  return smtpPreset({\n    host,\n    port: Number.isSafeInteger(port) && port > 0 ? port : 587,\n    secure: env[\"SMTP_SECURE\"] === \"1\" || env[\"SMTP_SECURE\"] === \"true\",\n    user: env[\"SMTP_USER\"],\n    pass: env[\"SMTP_PASS\"],\n    from,\n    logger,\n  });\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,WAAW,SAA+D;CACxF,MAAM,cAAc,WAAW,gBAAgB;EAC7C,MAAM,QAAQ;EACd,MAAM,QAAQ;EACd,QAAQ,QAAQ,UAAU,QAAQ,SAAS;EAC3C,MAAM,QAAQ,OAAO;GAAE,MAAM,QAAQ;GAAM,MAAM,QAAQ;EAAK,IAAI,KAAA;CACpE,CAAC;CACD,MAAM,OAAO,QAAQ;CACrB,IAAI,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,oBAAoB,CAAC;CACrE,OAAO;EACL,UAAU;GACR,MAAM;GACN,SAAS,QAAQ;GACjB,MAAM;GACN,UAAU;EACZ;EACA,UAAU,MAAoB;GAC5B,SAAS,KAAK,MAAM,EAAE,WAAW,oBAAoB,CAAC;EACxD;EACA,MAAM,KAAK,SAAsC;GAC/C,QAAQ,MAAM;IAAE,IAAI,QAAQ;IAAI,SAAS,QAAQ;GAAQ,GAAG,eAAe;GAC3E,MAAM,YAAY,SAAS;IACzB,MAAM,QAAQ,QAAQ;IACtB,IAAI,QAAQ;IACZ,SAAS,QAAQ;IACjB,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,SAAS,QAAQ;GACnB,CAAC;GACD,QAAQ,KAAK,EAAE,IAAI,QAAQ,GAAG,GAAG,YAAY;EAC/C;CACF;AACF;;;;;;;;AASA,SAAgB,kBACd,MAA0C,QAAQ,KAClD,QACyB;CACzB,MAAM,OAAO,IAAI;CACjB,MAAM,OAAO,IAAI;CACjB,IAAI,CAAC,QAAQ,CAAC,MACZ;CAEF,MAAM,OAAO,OAAO,IAAI,gBAAgB,GAAG;CAC3C,OAAO,WAAW;EAChB;EACA,MAAM,OAAO,cAAc,IAAI,KAAK,OAAO,IAAI,OAAO;EACtD,QAAQ,IAAI,mBAAmB,OAAO,IAAI,mBAAmB;EAC7D,MAAM,IAAI;EACV,MAAM,IAAI;EACV;EACA;CACF,CAAC;AACH"}

package/dist/types.d.mts

@@ -0,0 +1,38 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { z } from "zod";
+//#region src/types.d.ts
+/** Display toggles plus addressing for email channels. */
+declare const emailChannelConfigSchema: z.ZodObject<{
+  to: z.ZodString;
+  from: z.ZodOptional<z.ZodString>;
+  replyTo: z.ZodOptional<z.ZodString>;
+  style: z.ZodOptional<z.ZodEnum<{
+    compact: "compact";
+    verbose: "verbose";
+  }>>;
+  subjectPrefix: z.ZodOptional<z.ZodString>;
+  includeAuthor: z.ZodOptional<z.ZodBoolean>;
+  includeMessage: z.ZodOptional<z.ZodBoolean>;
+  includeCounts: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Email channel config (addressing + display toggles). */
+type EmailChannelConfig = z.infer<typeof emailChannelConfigSchema>;
+/** SMTP transport options for {@link smtpPreset}. */
+interface SmtpPresetOptions {
+  host: string;
+  port: number;
+  secure?: boolean;
+  user?: string;
+  pass?: string;
+  from: string;
+}
+/** HTTP email-API options for {@link httpPreset} (Resend-style). */
+interface HttpPresetOptions {
+  url: string;
+  headers?: Record<string, string>;
+  from: string;
+}
+//#endregion
+export { EmailChannelConfig, HttpPresetOptions, SmtpPresetOptions, emailChannelConfigSchema };
+//# sourceMappingURL=types.d.mts.map

package/dist/types.mjs

@@ -0,0 +1,20 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { z } from "zod";
+//#region src/types.ts
+/** Display toggles plus addressing for email channels. */
+const emailChannelConfigSchema = z.object({
+	to: z.string().min(1),
+	from: z.string().min(1).optional(),
+	replyTo: z.string().min(1).optional(),
+	style: z.enum(["compact", "verbose"]).optional(),
+	subjectPrefix: z.string().min(1).optional(),
+	includeAuthor: z.boolean().optional(),
+	includeMessage: z.boolean().optional(),
+	includeCounts: z.boolean().optional()
+});
+//#endregion
+export { emailChannelConfigSchema };
+
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Display toggles plus addressing for email channels. */\nexport const emailChannelConfigSchema = z.object({\n  to: z.string().min(1),\n  from: z.string().min(1).optional(),\n  replyTo: z.string().min(1).optional(),\n  style: z.enum([\"compact\", \"verbose\"]).optional(),\n  subjectPrefix: z.string().min(1).optional(),\n  includeAuthor: z.boolean().optional(),\n  includeMessage: z.boolean().optional(),\n  includeCounts: z.boolean().optional(),\n});\n\n/** Email channel config (addressing + display toggles). */\nexport type EmailChannelConfig = z.infer<typeof emailChannelConfigSchema>;\n\n/** SMTP transport options for {@link smtpPreset}. */\nexport interface SmtpPresetOptions {\n  host: string;\n  port: number;\n  secure?: boolean;\n  user?: string;\n  pass?: string;\n  from: string;\n}\n\n/** HTTP email-API options for {@link httpPreset} (Resend-style). */\nexport interface HttpPresetOptions {\n  url: string;\n  headers?: Record<string, string>;\n  from: string;\n}\n"],"mappings":";;;;;;AAGA,MAAa,2BAA2B,EAAE,OAAO;CAC/C,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACpB,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACjC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACpC,OAAO,EAAE,KAAK,CAAC,WAAW,SAAS,CAAC,CAAC,CAAC,SAAS;CAC/C,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CAC1C,eAAe,EAAE,QAAQ,CAAC,CAAC,SAAS;CACpC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,SAAS;CACrC,eAAe,EAAE,QAAQ,CAAC,CAAC,SAAS;AACtC,CAAC"}

package/dist/version.mjs

@@ -0,0 +1,12 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/version.ts
+/** Package version injected at build via __PKG_VERSION__. */
+function version() {
+	return globalThis.__PKG_VERSION__ ?? "0.0.0";
+}
+//#endregion
+export { version };
+
+//# sourceMappingURL=version.mjs.map

package/dist/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["declare const __PKG_VERSION__: string | undefined;\n\n/** Package version injected at build via __PKG_VERSION__. */\nexport function version(): string {\n  return (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\";\n}\n"],"mappings":";;;;;AAGA,SAAgB,UAAkB;CAChC,OAAQ,WAAuD,mBAAmB;AACpF"}

package/package.json

@@ -1,6 +1,112 @@
 {
   "name": "@storyshelf/notify-email",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.3",
+  "description": "Email notification transport for StoryShelf (SMTP, Mailpit, log, HTTP APIs).",
+  "keywords": [
+    "email",
+    "notifications",
+    "self-hosted",
+    "smtp",
+    "storybook"
+  ],
+  "homepage": "https://github.com/GuptaSiddhant/StoryShelf#readme",
+  "bugs": {
+    "url": "https://github.com/GuptaSiddhant/StoryShelf/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Siddhant Gupta",
+    "url": "https://guptasiddhant.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuptaSiddhant/StoryShelf.git",
+    "directory": "packages/notify-email"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./email": {
+      "source": "./src/email.ts",
+      "default": "./dist/email.mjs"
+    },
+    "./http": {
+      "source": "./src/http.ts",
+      "default": "./dist/http.mjs"
+    },
+    "./log": {
+      "source": "./src/log.ts",
+      "default": "./dist/log.mjs"
+    },
+    "./mailpit": {
+      "source": "./src/mailpit.ts",
+      "default": "./dist/mailpit.mjs"
+    },
+    "./smtp": {
+      "source": "./src/smtp.ts",
+      "default": "./dist/smtp.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.mjs",
+      "./email": "./dist/email.mjs",
+      "./http": "./dist/http.mjs",
+      "./log": "./dist/log.mjs",
+      "./mailpit": "./dist/mailpit.mjs",
+      "./smtp": "./dist/smtp.mjs",
+      "./package.json": "./package.json"
+    },
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown -w",
+    "fmt": "oxfmt ./src",
+    "lint": "oxlint --type-aware --type-check ./src",
+    "test": "vitest run",
+    "prepublishOnly": "nub run build"
+  },
+  "dependencies": {
+    "@storyshelf/core": "0.5.3",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@types/nodemailer": "^8.0.2",
+    "@vitest/coverage-v8": "^4.0.0",
+    "nodemailer": "^10.0.12",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "peerDependencies": {
+    "nodemailer": "^10.0.12"
+  },
+  "peerDependenciesMeta": {
+    "nodemailer": {
+      "optional": true
+    }
+  },
+  "jsr": {
+    "runtimeCompat": {
+      "node": true,
+      "deno": false,
+      "browser": false,
+      "workerd": false,
+      "bun": true
+    }
+  }
+}