@owlmeans/mailer-smtp 0.1.18-rc.8 → 0.1.18

package/README.md

@@ -7,13 +7,13 @@ SMTP transport for the OwlMeans `MailerService` contract, built on [nodemailer](
 - `makeSmtpMailerService(alias?)` — `MailerService` implementation reading `cfg.smtp`
 - `SmtpSettings` / `SmtpConfig` — the config block; numbers and booleans also accept their string form, because config values mounted from files always arrive as text
 - `verify()` — open a session and authenticate without sending, for health checks and tests
-- `toTransportOptions()` / `toMailOptions()` — the pure translations into nodemailer's shapes
+- `makeSmtpSettingsModel(smtp).toTransportOptions()` / `.toMailOptions(message)` — the pure translations into nodemailer's shapes; `assertSmtpSettings()` validates the block
 - Works with any SMTP relay; Mailgun, SES and Postmark all expose one
 
 ## Installation
 
 ```bash
-bun add @owlmeans/mailer-smtp
+bun add @owlmeans/mailer-smtp@^0.1.18
 ```
 
 ## Usage
@@ -65,7 +65,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills
+npx @owlmeans/agent-skills@^0.1.18
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
-  "schemaVersion": 2,
+  "schemaVersion": 3,
   "package": "@owlmeans/mailer-smtp",
-  "version": "0.1.18-rc.7",
-  "generatedAt": "2026-08-24T21:14:00.095Z",
+  "version": "0.1.18",
+  "generatedAt": "2026-10-28T00:31:34.717Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/mailer-smtp/SKILL.md

@@ -8,6 +8,9 @@ metadata:
 
 # Using `@owlmeans/mailer-smtp`
 
+**Install:** `"@owlmeans/mailer-smtp": "^0.1.18"` in `dependencies` — it depends on
+`nodemailer` itself, so a consumer declares nothing extra
+
 SMTP transport implementing `@owlmeans/mailer`'s `MailerService`, built on `nodemailer` (the
 zero-dependency de-facto standard for Node SMTP). Reads `ctx.cfg.smtp`. Works against any relay —
 Mailgun, SES, Postmark all expose SMTP.
@@ -21,7 +24,7 @@ Mailgun, SES, Postmark all expose SMTP.
 | `SmtpSettings` / `SmtpConfig` | interface | `cfg.smtp` block |
 | `SMTP_MAILER` | const | `'smtp-mailer'` |
 | `SMTP_DEFAULT_PORT` | const | `465` |
-| `toTransportOptions` / `toMailOptions` | fn | Pure translations into nodemailer's shapes; test these, not the socket |
+| `makeSmtpSettingsModel(smtp).toTransportOptions()` / `.toMailOptions(message)` | model | Pure translations into nodemailer's shapes; test these, not the socket |
 
 ## Config shape
 
@@ -59,16 +62,20 @@ context.registerService(makeSmtpMailerService(MAILER_SERVICE))
 ```
 
 Register under `MAILER_SERVICE` so platform code — `OtpService` above all — resolves the mailer
-without knowing the transport. Select between transports on config, not on a build flag:
+without knowing the transport. A local-only console transport is an explicit mode; it is never a
+production fallback:
 
 ```ts
-context.registerService(
-  cfg.smtp?.host != null && cfg.smtp.host !== ''
-    ? makeSmtpMailerService(MAILER_SERVICE)
-    : makeConsoleMailerService(MAILER_SERVICE)
-)
+if (cfg.iamMailer.mode !== 'smtp') throw new SyntaxError('production requires smtp mode')
+context.registerService(makeSmtpMailerService(MAILER_SERVICE, {
+  authenticated: true,
+  verifyOnInit: true,
+}))
 ```
 
+Authenticated SMTP requires a host, from address, user and password; `verifyOnInit` makes an
+unusable relay fail context startup rather than exposing a later login code through a console log.
+
 ## Ports and TLS
 
 | Port | Mode | `secure` |
@@ -84,19 +91,30 @@ context.registerService(
 - The `From` domain must be verified with the relay; the local part is free-form.
 - Deliberately **unpooled** — a pooled transport holds its socket and keeps a short-lived process
   alive. Add pooling only with a matching lifecycle.
-- Errors are rethrown prefixed with the service alias and the server's own reply
-  (`code`/`responseCode`/`response`). The password never reaches a message or a log.
+- Relay errors are rethrown prefixed with the service alias and the server's own reply
+  (`code`/`responseCode`/`response`). The password never reaches a message or a log. A missing
+  `cfg.smtp.host` is the other failure and it is a `SyntaxError`, raised before any socket.
 - `verify()` authenticates without submitting a message — right for health checks; not proof that
   the relay accepts *a message* from your sender.
-- Never register this in unit tests — use `makeConsoleMailerService`. `toMailOptions` plus
-  nodemailer's own `jsonTransport` cover envelope assertions without a socket.
+- Production mail selection must be explicit and use `authenticated: true, verifyOnInit: true`.
+  Console mail is for local fixtures/development and must never be selected because SMTP settings
+  were absent or malformed.
+- `toMailOptions` maps `MailMessage.attachments` to nodemailer's `attachments` as
+  `{ filename, content: Buffer, contentType? }` — the bytes already decoded by
+  `mailAttachmentHelper.bytesOf`, so no `encoding` is left for nodemailer to guess; absent or empty
+  = no `attachments` key.
+- Never register this in unit tests — use `makeConsoleMailerService`.
+  `makeSmtpSettingsModel(smtp).toMailOptions` plus nodemailer's own `jsonTransport` cover envelope
+  assertions without a socket.
 - **Never authenticate with a deliberately wrong password against a live relay.** Repeated failed
   logins trip the provider's brute-force protection and lock the shared credential for every
   environment using it — Mailgun then answers `535 Authentication failed` to the correct password
   too, and the credential has to be reset in its dashboard. Provoke transport errors with an
   unreachable socket (`host: '127.0.0.1', port: '1'`) instead.
-- The live spec (`tests/send.spec.ts`) is gated on the SMTP block in `/.env.example` and **delivers
-  real mail** when the gate is open. Empty variables = skip, never a failure.
+- The live spec (`tests/send.spec.ts`) is gated by `gateHelper.smtpGate()` from
+  `@owlmeans/test-integration` on `SMTP_HOST` / `SMTP_USER` / `SMTP_PASSWORD` / `SMTP_FROM` /
+  `SMTP_TEST_TO` (with `SMTP_PORT` and `SMTP_SECURE` optional), and **delivers real mail** when the
+  gate is open. Empty variables = skip with a printed reason, never a failure.
 - Rollup-bundling for a container image works with the default `preferBuiltins: true` node-resolve
   setup; nodemailer's dynamic requires do not need to be externalized.
 
@@ -105,10 +123,14 @@ context.registerService(
 - [nodemailer](https://www.npmjs.com/package/nodemailer) — v9.x, MIT-0, **zero dependencies**, the
   de-facto standard (~10.8k dependents). Ships no types; `@types/nodemailer` (v8.x) supplies them.
   CJS — import the default (`import nodemailer from 'nodemailer'`), not named members, so both Bun
-  and Rollup's commonjs interop resolve it. Verified working under Bun and inside a Rollup CJS
-  bundle (2026-08).
+  and Rollup's commonjs interop resolve it; it works under Bun and inside a Rollup CJS bundle.
 - [Mailgun — Send via SMTP](https://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/send-smtp)
   — hosts `smtp.mailgun.org` / `smtp.eu.mailgun.org`; port 465 requires TLS, ports 25/587/2525 start
   plain and upgrade via STARTTLS. Credentials are **per sending domain**, managed under that domain's
   SMTP settings — not the account login. `X-Mailgun-Drop-Message: yes` submits in test mode (accepted,
   never delivered); other `X-Mailgun-*` headers cover tagging, DKIM, tracking and required TLS.
+
+## Related
+
+- [[mailer]] — the `MailerService` contract and the console transport
+- [[server-mailer-mailgun]] — the same contract over Mailgun's HTTP API instead of SMTP

package/build/assert.d.ts

@@ -0,0 +1,4 @@
+import type { SmtpMailerOptions, SmtpSettings } from './types.js';
+/** Validate the settings required by an authenticated production relay. */
+export declare const assertSmtpSettings: (smtp: SmtpSettings | undefined, alias: string, opts?: SmtpMailerOptions) => SmtpSettings;
+//# sourceMappingURL=assert.d.ts.map

package/build/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../src/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEjE,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,SACvB,YAAY,GAAG,SAAS,SAAS,MAAM,SAAQ,iBAAiB,KACrE,YASF,CAAA"}

package/build/assert.js

@@ -0,0 +1,10 @@
+/** Validate the settings required by an authenticated production relay. */
+export const assertSmtpSettings = (smtp, alias, opts = {}) => {
+    const required = opts.authenticated === true ? ['host', 'from', 'user', 'pass'] : ['host'];
+    const missing = required.filter(key => smtp?.[key] == null || String(smtp[key]).trim() === '');
+    if (missing.length > 0) {
+        throw new SyntaxError(`${alias}: cfg.smtp.${missing.join(', cfg.smtp.')} is not configured`);
+    }
+    return smtp;
+};
+//# sourceMappingURL=assert.js.map

package/build/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../src/assert.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAA8B,EAAE,KAAa,EAAE,IAAI,GAAsB,EAAE,EAC7D,EAAE;IAChB,MAAM,QAAQ,GACZ,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAC3E,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,WAAW,CAAC,GAAG,KAAK,cAAc,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC9F,CAAC;IAED,OAAO,IAAoB,CAAA;AAC7B,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,4 +1,7 @@
 export type * from './types.js';
+export type * from './settings/types.js';
 export * from './consts.js';
 export * from './service.js';
+export * from './settings.js';
+export * from './assert.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,qBAAqB,CAAA;AACxC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -1,3 +1,5 @@
 export * from './consts.js';
 export * from './service.js';
+export * from './settings.js';
+export * from './assert.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/build/service.d.ts

@@ -1,17 +1,4 @@
-import type { MailMessage } from '@owlmeans/mailer';
-import type SMTPTransport from 'nodemailer/lib/smtp-transport/index.js';
-import type Mail from 'nodemailer/lib/mailer/index.js';
-import type { SmtpMailerService, SmtpSettings } from './types.js';
-/**
- * Translate the settings block into nodemailer's transport options.
- *
- * Deliberately unpooled: a pooled transport holds its socket open and would keep a
- * short-lived process alive, and the traffic this serves — login codes — is far below
- * the volume that makes pooling worth that.
- */
-export declare const toTransportOptions: (smtp: SmtpSettings) => SMTPTransport.Options;
-/** Translate a provider-agnostic message into nodemailer's envelope, applying the config defaults. */
-export declare const toMailOptions: (smtp: SmtpSettings, message: MailMessage) => Mail.Options;
+import type { SmtpMailerOptions, SmtpMailerService } from './types.js';
 /**
  * SMTP transport for the `MailerService` contract. Reads `cfg.smtp` and keeps one
  * nodemailer transporter per service instance.
@@ -19,5 +6,5 @@ export declare const toMailOptions: (smtp: SmtpSettings, message: MailMessage) =
  * Register it under `MAILER_SERVICE` so callers — the email-OTP plugin above all —
  * resolve it without knowing which transport is in play.
  */
-export declare const makeSmtpMailerService: (alias?: string) => SmtpMailerService;
+export declare const makeSmtpMailerService: (alias?: string, opts?: SmtpMailerOptions) => SmtpMailerService;
 //# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAInD,OAAO,KAAK,aAAa,MAAM,wCAAwC,CAAA;AACvE,OAAO,KAAK,IAAI,MAAM,gCAAgC,CAAA;AAEtD,OAAO,KAAK,EAAc,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAgB7E;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,SAAU,YAAY,KAAG,aAAa,CAAC,OASpE,CAAA;AAEF,sGAAsG;AACtG,eAAO,MAAM,aAAa,SAAU,YAAY,WAAW,WAAW,KAAG,IAAI,CAAC,OAa7E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,sBAA0B,iBAsD3D,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAc,iBAAiB,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAA;AAEhG;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BACL,iBAAiB,KAC3C,iBAsDF,CAAA"}

package/build/service.js

@@ -1,50 +1,8 @@
 import { createService } from '@owlmeans/context';
 import nodemailer from 'nodemailer';
-import { SMTP_DEFAULT_PORT, SMTP_MAILER } from './consts.js';
-const toNumber = (value, def) => {
-    if (value == null || value === '')
-        return def;
-    const num = typeof value === 'number' ? value : Number(value);
-    return Number.isFinite(num) ? num : def;
-};
-const toBoolean = (value, def) => {
-    if (value == null || value === '')
-        return def;
-    if (typeof value === 'boolean')
-        return value;
-    return ['1', 'on', 'true', 'yes'].includes(value.trim().toLowerCase());
-};
-/**
- * Translate the settings block into nodemailer's transport options.
- *
- * Deliberately unpooled: a pooled transport holds its socket open and would keep a
- * short-lived process alive, and the traffic this serves — login codes — is far below
- * the volume that makes pooling worth that.
- */
-export const toTransportOptions = (smtp) => ({
-    host: smtp.host,
-    port: toNumber(smtp.port, SMTP_DEFAULT_PORT),
-    secure: toBoolean(smtp.secure, true),
-    tls: { rejectUnauthorized: toBoolean(smtp.rejectUnauthorized, true) },
-    ...(smtp.timeout != null ? { connectionTimeout: toNumber(smtp.timeout, 0) } : {}),
-    ...(smtp.user != null && smtp.user !== ''
-        ? { auth: { user: smtp.user, pass: smtp.pass ?? '' } }
-        : {}),
-});
-/** Translate a provider-agnostic message into nodemailer's envelope, applying the config defaults. */
-export const toMailOptions = (smtp, message) => {
-    const headers = { ...smtp.headers, ...message.headers };
-    const replyTo = message.replyTo ?? smtp.replyTo;
-    return {
-        from: message.from ?? smtp.from,
-        to: message.to,
-        subject: message.subject,
-        ...(message.text != null ? { text: message.text } : {}),
-        ...(message.html != null ? { html: message.html } : {}),
-        ...(replyTo != null ? { replyTo } : {}),
-        ...(Object.keys(headers).length > 0 ? { headers } : {}),
-    };
-};
+import { SMTP_MAILER } from './consts.js';
+import { assertSmtpSettings } from './assert.js';
+import { makeSmtpSettingsModel } from './settings.js';
 /**
  * SMTP transport for the `MailerService` contract. Reads `cfg.smtp` and keeps one
  * nodemailer transporter per service instance.
@@ -52,17 +10,13 @@ export const toMailOptions = (smtp, message) => {
  * Register it under `MAILER_SERVICE` so callers — the email-OTP plugin above all —
  * resolve it without knowing which transport is in play.
  */
-export const makeSmtpMailerService = (alias = SMTP_MAILER) => {
+export const makeSmtpMailerService = (alias = SMTP_MAILER, opts = {}) => {
     let transport = null;
     const settings = () => {
         const ctx = service.assertCtx(alias);
-        const smtp = ctx.cfg.smtp;
-        if (smtp?.host == null || smtp.host === '') {
-            throw new SyntaxError(`${alias}: cfg.smtp.host is not configured`);
-        }
-        return smtp;
+        return assertSmtpSettings(ctx.cfg.smtp, alias, opts);
     };
-    const transporter = () => transport ??= nodemailer.createTransport(toTransportOptions(settings()));
+    const transporter = () => transport ??= nodemailer.createTransport(makeSmtpSettingsModel(settings()).toTransportOptions());
     // Credentials never reach the message: nodemailer reports the server's own reply only.
     const fail = (action, error) => {
         const err = error;
@@ -72,7 +26,7 @@ export const makeSmtpMailerService = (alias = SMTP_MAILER) => {
     };
     const service = createService(alias, {
         send: async (message) => {
-            const options = toMailOptions(settings(), message);
+            const options = makeSmtpSettingsModel(settings()).toMailOptions(message);
             try {
                 await transporter().sendMail(options);
             }
@@ -93,6 +47,13 @@ export const makeSmtpMailerService = (alias = SMTP_MAILER) => {
             transport?.close();
             transport = null;
         },
+    }, current => async () => {
+        // `configure()` resolves mounted config files before services initialize, so this validates
+        // the resolved values and, when requested, verifies the relay without sending a message.
+        settings();
+        if (opts.verifyOnInit === true)
+            await current.verify();
+        current.initialized = true;
     });
     return service;
 };

package/build/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/build/settings/types.d.ts

@@ -0,0 +1,19 @@
+import type { MailMessage } from '@owlmeans/mailer';
+import type { SendMailOptions, SMTPTransportOptions } from 'nodemailer';
+/** One `cfg.smtp` block, translated into what nodemailer takes. */
+export interface SmtpSettingsModel {
+    /**
+     * Translate the settings block into nodemailer's transport options.
+     *
+     * Deliberately unpooled: a pooled transport holds its socket open and would keep a
+     * short-lived process alive, and the traffic this serves — login codes — is far below
+     * the volume that makes pooling worth that.
+     */
+    toTransportOptions: () => SMTPTransportOptions;
+    /**
+     * Translate a provider-agnostic message into nodemailer's envelope, applying the config defaults.
+     * Attachments are handed over as decoded bytes with their name and declared MIME type.
+     */
+    toMailOptions: (message: MailMessage) => SendMailOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/settings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/settings/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;IAC9C;;;OAGG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,eAAe,CAAA;CACzD"}

package/build/settings/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/settings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/settings/types.ts"],"names":[],"mappings":""}

package/build/settings.d.ts

@@ -0,0 +1,4 @@
+import type { SmtpSettings } from './types.js';
+import type { SmtpSettingsModel } from './settings/types.js';
+export declare const makeSmtpSettingsModel: (smtp: SmtpSettings) => SmtpSettingsModel;
+//# sourceMappingURL=settings.d.ts.map

package/build/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAgB5D,eAAO,MAAM,qBAAqB,SAAU,YAAY,KAAG,iBAyC1D,CAAA"}

package/build/settings.js

@@ -0,0 +1,53 @@
+import { mailAttachmentHelper } from '@owlmeans/mailer';
+import { SMTP_DEFAULT_PORT } from './consts.js';
+const toNumber = (value, def) => {
+    if (value == null || value === '')
+        return def;
+    const num = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(num) ? num : def;
+};
+const toBoolean = (value, def) => {
+    if (value == null || value === '')
+        return def;
+    if (typeof value === 'boolean')
+        return value;
+    return ['1', 'on', 'true', 'yes'].includes(value.trim().toLowerCase());
+};
+export const makeSmtpSettingsModel = (smtp) => {
+    const toTransportOptions = () => ({
+        host: smtp.host,
+        port: toNumber(smtp.port, SMTP_DEFAULT_PORT),
+        secure: toBoolean(smtp.secure, true),
+        tls: { rejectUnauthorized: toBoolean(smtp.rejectUnauthorized, true) },
+        ...(smtp.timeout != null ? { connectionTimeout: toNumber(smtp.timeout, 0) } : {}),
+        ...(smtp.user != null && smtp.user !== ''
+            ? { auth: { user: smtp.user, pass: smtp.pass ?? '' } }
+            : {}),
+    });
+    /** One attachment as nodemailer takes it: the decoded bytes, so no encoding is left to guess. */
+    const toAttachment = (attachment) => {
+        const bytes = mailAttachmentHelper.bytesOf(attachment);
+        return {
+            filename: attachment.filename,
+            content: Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength),
+            ...(attachment.contentType != null ? { contentType: attachment.contentType } : {}),
+        };
+    };
+    const toMailOptions = (message) => {
+        const headers = { ...smtp.headers, ...message.headers };
+        const replyTo = message.replyTo ?? smtp.replyTo;
+        const attachments = message.attachments ?? [];
+        return {
+            from: message.from ?? smtp.from,
+            to: message.to,
+            subject: message.subject,
+            ...(message.text != null ? { text: message.text } : {}),
+            ...(message.html != null ? { html: message.html } : {}),
+            ...(replyTo != null ? { replyTo } : {}),
+            ...(Object.keys(headers).length > 0 ? { headers } : {}),
+            ...(attachments.length > 0 ? { attachments: attachments.map(toAttachment) } : {}),
+        };
+    };
+    return { toTransportOptions, toMailOptions };
+};
+//# sourceMappingURL=settings.js.map

package/build/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -36,4 +36,10 @@ export interface SmtpMailerService extends MailerService {
     /** Release a pooled connection. A no-op for the default, non-pooled transport. */
     close: () => Promise<void>;
 }
+export interface SmtpMailerOptions {
+    /** Require a default sender and username/password authentication. */
+    authenticated?: boolean;
+    /** Authenticate with the relay while the context initializes. */
+    verifyOnInit?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACrC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,IAAI,EAAE,YAAY,CAAA;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,oGAAoG;IACpG,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,kFAAkF;IAClF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACrC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,IAAI,EAAE,YAAY,CAAA;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,oGAAoG;IACpG,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,kFAAkF;IAClF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/mailer-smtp",
-  "version": "0.1.18-rc.8",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,18 +22,17 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.6",
-    "@owlmeans/mailer": "^0.1.18-rc.6",
-    "@owlmeans/server-context": "^0.1.18-rc.8",
-    "nodemailer": "^9.0.5"
+    "@owlmeans/context": "^0.1.18",
+    "@owlmeans/mailer": "^0.1.18",
+    "@owlmeans/server-context": "^0.1.18",
+    "nodemailer": "^10.0.14"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test": "^0.1.18-rc.6",
-    "@owlmeans/test-integration": "^0.1.18-rc.6",
-    "@types/bun": "^1.4.0",
-    "@types/node": "^26.1.0",
-    "@types/nodemailer": "^8.0.1",
+    "@owlmeans/dep-config": "^0.1.18",
+    "@owlmeans/test": "^0.1.18",
+    "@owlmeans/test-integration": "^0.1.18",
+    "@types/bun": "^1.4.2",
+    "@types/node": "^26.6.4",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/assert.ts

@@ -0,0 +1,15 @@
+import type { SmtpMailerOptions, SmtpSettings } from './types.js'
+
+/** Validate the settings required by an authenticated production relay. */
+export const assertSmtpSettings = (
+  smtp: SmtpSettings | undefined, alias: string, opts: SmtpMailerOptions = {}
+): SmtpSettings => {
+  const required: Array<keyof Pick<SmtpSettings, 'host' | 'from' | 'user' | 'pass'>> =
+    opts.authenticated === true ? ['host', 'from', 'user', 'pass'] : ['host']
+  const missing = required.filter(key => smtp?.[key] == null || String(smtp[key]).trim() === '')
+  if (missing.length > 0) {
+    throw new SyntaxError(`${alias}: cfg.smtp.${missing.join(', cfg.smtp.')} is not configured`)
+  }
+
+  return smtp as SmtpSettings
+}

package/src/index.ts

@@ -1,3 +1,6 @@
 export type * from './types.js'
+export type * from './settings/types.js'
 export * from './consts.js'
 export * from './service.js'
+export * from './settings.js'
+export * from './assert.js'

package/src/service.ts

@@ -2,59 +2,11 @@ import { createService } from '@owlmeans/context'
 import type { MailMessage } from '@owlmeans/mailer'
 import type { ServerContext } from '@owlmeans/server-context'
 import nodemailer from 'nodemailer'
-import type { Transporter } from 'nodemailer'
-import type SMTPTransport from 'nodemailer/lib/smtp-transport/index.js'
-import type Mail from 'nodemailer/lib/mailer/index.js'
-import { SMTP_DEFAULT_PORT, SMTP_MAILER } from './consts.js'
-import type { SmtpConfig, SmtpMailerService, SmtpSettings } from './types.js'
-
-const toNumber = (value: number | string | undefined, def: number): number => {
-  if (value == null || value === '') return def
-  const num = typeof value === 'number' ? value : Number(value)
-
-  return Number.isFinite(num) ? num : def
-}
-
-const toBoolean = (value: boolean | string | undefined, def: boolean): boolean => {
-  if (value == null || value === '') return def
-  if (typeof value === 'boolean') return value
-
-  return ['1', 'on', 'true', 'yes'].includes(value.trim().toLowerCase())
-}
-
-/**
- * Translate the settings block into nodemailer's transport options.
- *
- * Deliberately unpooled: a pooled transport holds its socket open and would keep a
- * short-lived process alive, and the traffic this serves — login codes — is far below
- * the volume that makes pooling worth that.
- */
-export const toTransportOptions = (smtp: SmtpSettings): SMTPTransport.Options => ({
-  host: smtp.host,
-  port: toNumber(smtp.port, SMTP_DEFAULT_PORT),
-  secure: toBoolean(smtp.secure, true),
-  tls: { rejectUnauthorized: toBoolean(smtp.rejectUnauthorized, true) },
-  ...(smtp.timeout != null ? { connectionTimeout: toNumber(smtp.timeout, 0) } : {}),
-  ...(smtp.user != null && smtp.user !== ''
-    ? { auth: { user: smtp.user, pass: smtp.pass ?? '' } }
-    : {}),
-})
-
-/** Translate a provider-agnostic message into nodemailer's envelope, applying the config defaults. */
-export const toMailOptions = (smtp: SmtpSettings, message: MailMessage): Mail.Options => {
-  const headers = { ...smtp.headers, ...message.headers }
-  const replyTo = message.replyTo ?? smtp.replyTo
-
-  return {
-    from: message.from ?? smtp.from,
-    to: message.to,
-    subject: message.subject,
-    ...(message.text != null ? { text: message.text } : {}),
-    ...(message.html != null ? { html: message.html } : {}),
-    ...(replyTo != null ? { replyTo } : {}),
-    ...(Object.keys(headers).length > 0 ? { headers } : {}),
-  }
-}
+import type { SMTPSentMessageInfo, Transporter } from 'nodemailer'
+import { SMTP_MAILER } from './consts.js'
+import { assertSmtpSettings } from './assert.js'
+import { makeSmtpSettingsModel } from './settings.js'
+import type { SmtpConfig, SmtpMailerOptions, SmtpMailerService, SmtpSettings } from './types.js'
 
 /**
  * SMTP transport for the `MailerService` contract. Reads `cfg.smtp` and keeps one
@@ -63,22 +15,18 @@ export const toMailOptions = (smtp: SmtpSettings, message: MailMessage): Mail.Op
  * Register it under `MAILER_SERVICE` so callers — the email-OTP plugin above all —
  * resolve it without knowing which transport is in play.
  */
-export const makeSmtpMailerService = (alias = SMTP_MAILER): SmtpMailerService => {
-  let transport: Transporter<SMTPTransport.SentMessageInfo> | null = null
+export const makeSmtpMailerService = (
+  alias = SMTP_MAILER, opts: SmtpMailerOptions = {}
+): SmtpMailerService => {
+  let transport: Transporter<SMTPSentMessageInfo> | null = null
 
   const settings = (): SmtpSettings => {
     const ctx = service.assertCtx<SmtpConfig, ServerContext<SmtpConfig>>(alias)
-    const smtp = ctx.cfg.smtp
-
-    if (smtp?.host == null || smtp.host === '') {
-      throw new SyntaxError(`${alias}: cfg.smtp.host is not configured`)
-    }
-
-    return smtp
+    return assertSmtpSettings(ctx.cfg.smtp, alias, opts)
   }
 
-  const transporter = (): Transporter<SMTPTransport.SentMessageInfo> =>
-    transport ??= nodemailer.createTransport(toTransportOptions(settings()))
+  const transporter = (): Transporter<SMTPSentMessageInfo> =>
+    transport ??= nodemailer.createTransport(makeSmtpSettingsModel(settings()).toTransportOptions())
 
   // Credentials never reach the message: nodemailer reports the server's own reply only.
   const fail = (action: string, error: unknown): never => {
@@ -91,7 +39,7 @@ export const makeSmtpMailerService = (alias = SMTP_MAILER): SmtpMailerService =>
 
   const service = createService<SmtpMailerService>(alias, {
     send: async (message: MailMessage): Promise<void> => {
-      const options = toMailOptions(settings(), message)
+      const options = makeSmtpSettingsModel(settings()).toMailOptions(message)
 
       try {
         await transporter().sendMail(options)
@@ -114,6 +62,12 @@ export const makeSmtpMailerService = (alias = SMTP_MAILER): SmtpMailerService =>
       transport?.close()
       transport = null
     },
+  }, current => async () => {
+    // `configure()` resolves mounted config files before services initialize, so this validates
+    // the resolved values and, when requested, verifies the relay without sending a message.
+    settings()
+    if (opts.verifyOnInit === true) await current.verify()
+    current.initialized = true
   })
 
   return service

package/src/settings/types.ts

@@ -0,0 +1,19 @@
+import type { MailMessage } from '@owlmeans/mailer'
+import type { SendMailOptions, SMTPTransportOptions } from 'nodemailer'
+
+/** One `cfg.smtp` block, translated into what nodemailer takes. */
+export interface SmtpSettingsModel {
+  /**
+   * Translate the settings block into nodemailer's transport options.
+   *
+   * Deliberately unpooled: a pooled transport holds its socket open and would keep a
+   * short-lived process alive, and the traffic this serves — login codes — is far below
+   * the volume that makes pooling worth that.
+   */
+  toTransportOptions: () => SMTPTransportOptions
+  /**
+   * Translate a provider-agnostic message into nodemailer's envelope, applying the config defaults.
+   * Attachments are handed over as decoded bytes with their name and declared MIME type.
+   */
+  toMailOptions: (message: MailMessage) => SendMailOptions
+}

package/src/settings.ts

@@ -0,0 +1,63 @@
+import { mailAttachmentHelper } from '@owlmeans/mailer'
+import type { MailAttachment, MailMessage } from '@owlmeans/mailer'
+import type { SendMailOptions, SMTPTransportOptions } from 'nodemailer'
+import { SMTP_DEFAULT_PORT } from './consts.js'
+import type { SmtpSettings } from './types.js'
+import type { SmtpSettingsModel } from './settings/types.js'
+
+const toNumber = (value: number | string | undefined, def: number): number => {
+  if (value == null || value === '') return def
+  const num = typeof value === 'number' ? value : Number(value)
+
+  return Number.isFinite(num) ? num : def
+}
+
+const toBoolean = (value: boolean | string | undefined, def: boolean): boolean => {
+  if (value == null || value === '') return def
+  if (typeof value === 'boolean') return value
+
+  return ['1', 'on', 'true', 'yes'].includes(value.trim().toLowerCase())
+}
+
+export const makeSmtpSettingsModel = (smtp: SmtpSettings): SmtpSettingsModel => {
+  const toTransportOptions = (): SMTPTransportOptions => ({
+    host: smtp.host,
+    port: toNumber(smtp.port, SMTP_DEFAULT_PORT),
+    secure: toBoolean(smtp.secure, true),
+    tls: { rejectUnauthorized: toBoolean(smtp.rejectUnauthorized, true) },
+    ...(smtp.timeout != null ? { connectionTimeout: toNumber(smtp.timeout, 0) } : {}),
+    ...(smtp.user != null && smtp.user !== ''
+      ? { auth: { user: smtp.user, pass: smtp.pass ?? '' } }
+      : {}),
+  })
+
+  /** One attachment as nodemailer takes it: the decoded bytes, so no encoding is left to guess. */
+  const toAttachment = (attachment: MailAttachment): NonNullable<SendMailOptions['attachments']>[number] => {
+    const bytes = mailAttachmentHelper.bytesOf(attachment)
+
+    return {
+      filename: attachment.filename,
+      content: Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength),
+      ...(attachment.contentType != null ? { contentType: attachment.contentType } : {}),
+    }
+  }
+
+  const toMailOptions = (message: MailMessage): SendMailOptions => {
+    const headers = { ...smtp.headers, ...message.headers }
+    const replyTo = message.replyTo ?? smtp.replyTo
+    const attachments = message.attachments ?? []
+
+    return {
+      from: message.from ?? smtp.from,
+      to: message.to,
+      subject: message.subject,
+      ...(message.text != null ? { text: message.text } : {}),
+      ...(message.html != null ? { html: message.html } : {}),
+      ...(replyTo != null ? { replyTo } : {}),
+      ...(Object.keys(headers).length > 0 ? { headers } : {}),
+      ...(attachments.length > 0 ? { attachments: attachments.map(toAttachment) } : {}),
+    }
+  }
+
+  return { toTransportOptions, toMailOptions }
+}

package/src/types.ts

@@ -39,3 +39,10 @@ export interface SmtpMailerService extends MailerService {
   /** Release a pooled connection. A no-op for the default, non-pooled transport. */
   close: () => Promise<void>
 }
+
+export interface SmtpMailerOptions {
+  /** Require a default sender and username/password authentication. */
+  authenticated?: boolean
+  /** Authenticate with the relay while the context initializes. */
+  verifyOnInit?: boolean
+}

package/tests/context.ts

@@ -1,17 +1,18 @@
-import { smtpGate } from '@owlmeans/test-integration'
+
 import type { IntegrationGate, SmtpEnv } from '@owlmeans/test-integration'
 import { config, makeServerContext } from '@owlmeans/server-context'
 import type { ServerConfig, ServerContext } from '@owlmeans/server-context'
 import { MAILER_SERVICE } from '@owlmeans/mailer'
 import { makeSmtpMailerService } from '@owlmeans/mailer-smtp'
 import type { SmtpConfig, SmtpMailerService, SmtpSettings } from '@owlmeans/mailer-smtp'
+import { gateHelper } from '@owlmeans/test-integration'
 
 /**
  * Live relay gate. Every variable empty means the delivery specs self-skip with a
  * printed reason — never a failure. When it is open these specs send REAL mail, so
  * `SMTP_TEST_TO` is required rather than optional.
  */
-export const gate: IntegrationGate<SmtpEnv> = smtpGate()
+export const gate: IntegrationGate<SmtpEnv> = gateHelper.smtpGate()
 
 /** Never logged, never asserted on — only handed to the transport. */
 export const settings = (): SmtpSettings => ({

package/tests/message.spec.ts

@@ -1,6 +1,8 @@
 import { describe, expect, test } from 'bun:test'
 import nodemailer from 'nodemailer'
-import { SMTP_DEFAULT_PORT, toMailOptions, toTransportOptions } from '@owlmeans/mailer-smtp'
+import {
+  assertSmtpSettings, makeSmtpSettingsModel, SMTP_DEFAULT_PORT,
+} from '@owlmeans/mailer-smtp'
 import type { SmtpSettings } from '@owlmeans/mailer-smtp'
 
 const base: SmtpSettings = {
@@ -15,8 +17,16 @@ const base: SmtpSettings = {
  * and let nodemailer itself build the envelope through its bundled `jsonTransport`.
  */
 describe('@owlmeans/mailer-smtp — transport options', () => {
+  test('authenticated mode requires host, from, user, and password', () => {
+    expect(() => assertSmtpSettings(base, 'mailer', { authenticated: true })).not.toThrow()
+    for (const field of ['host', 'from', 'user', 'pass'] as const) {
+      expect(() => assertSmtpSettings({ ...base, [field]: '' }, 'mailer', { authenticated: true }))
+        .toThrow(`cfg.smtp.${field}`)
+    }
+  })
+
   test('defaults to implicit TLS on 465 with certificate verification', () => {
-    const options = toTransportOptions(base)
+    const options = makeSmtpSettingsModel(base).toTransportOptions()
 
     expect(options.port).toBe(SMTP_DEFAULT_PORT)
     expect(options.secure).toBe(true)
@@ -25,9 +35,9 @@ describe('@owlmeans/mailer-smtp — transport options', () => {
   })
 
   test('coerces the string forms a ConfigMap file delivers', () => {
-    const options = toTransportOptions({
+    const options = makeSmtpSettingsModel({
       ...base, port: '2525', secure: 'false', rejectUnauthorized: '0', timeout: '5000',
-    })
+    }).toTransportOptions()
 
     expect(options.port).toBe(2525)
     expect(options.secure).toBe(false)
@@ -36,12 +46,12 @@ describe('@owlmeans/mailer-smtp — transport options', () => {
   })
 
   test('falls back to the default port when the value is unusable', () => {
-    expect(toTransportOptions({ ...base, port: '' }).port).toBe(SMTP_DEFAULT_PORT)
-    expect(toTransportOptions({ ...base, port: 'nonsense' }).port).toBe(SMTP_DEFAULT_PORT)
+    expect(makeSmtpSettingsModel({ ...base, port: '' }).toTransportOptions().port).toBe(SMTP_DEFAULT_PORT)
+    expect(makeSmtpSettingsModel({ ...base, port: 'nonsense' }).toTransportOptions().port).toBe(SMTP_DEFAULT_PORT)
   })
 
   test('omits auth for an unauthenticated relay', () => {
-    expect(toTransportOptions({ ...base, user: '' }).auth).toBeUndefined()
+    expect(makeSmtpSettingsModel({ ...base, user: '' }).toTransportOptions().auth).toBeUndefined()
   })
 })
 
@@ -49,7 +59,7 @@ describe('@owlmeans/mailer-smtp — message mapping', () => {
   const message = { to: 'user@example.com', subject: 'Your login code', text: '106341' }
 
   test('applies the configured sender and reply-to', () => {
-    const options = toMailOptions({ ...base, replyTo: 'support@example.org' }, message)
+    const options = makeSmtpSettingsModel({ ...base, replyTo: 'support@example.org' }).toMailOptions(message)
 
     expect(options.from).toBe(base.from)
     expect(options.replyTo).toBe('support@example.org')
@@ -57,8 +67,7 @@ describe('@owlmeans/mailer-smtp — message mapping', () => {
   })
 
   test('lets a message override the sender and reply-to', () => {
-    const options = toMailOptions(
-      { ...base, replyTo: 'support@example.org' },
+    const options = makeSmtpSettingsModel({ ...base, replyTo: 'support@example.org' }).toMailOptions(
       { ...message, from: 'Other <other@example.org>', replyTo: 'nobody@example.org' }
     )
 
@@ -67,8 +76,7 @@ describe('@owlmeans/mailer-smtp — message mapping', () => {
   })
 
   test('merges headers with the message winning', () => {
-    const options = toMailOptions(
-      { ...base, headers: { 'X-Origin': 'config', 'X-Kept': 'yes' } },
+    const options = makeSmtpSettingsModel({ ...base, headers: { 'X-Origin': 'config', 'X-Kept': 'yes' } }).toMailOptions(
       { ...message, headers: { 'X-Origin': 'message' } }
     )
 
@@ -77,8 +85,7 @@ describe('@owlmeans/mailer-smtp — message mapping', () => {
 
   test('nodemailer builds the envelope we described', async () => {
     const transport = nodemailer.createTransport({ jsonTransport: true })
-    const info = await transport.sendMail(toMailOptions(
-      { ...base, headers: { 'X-OwlMeans-Test': 'mapping' } },
+    const info = await transport.sendMail(makeSmtpSettingsModel({ ...base, headers: { 'X-OwlMeans-Test': 'mapping' } }).toMailOptions(
       { ...message, html: '<p>106341</p>' }
     ))
 
@@ -91,4 +98,28 @@ describe('@owlmeans/mailer-smtp — message mapping', () => {
     expect(built.html).toBe('<p>106341</p>')
     expect(built.headers['X-OwlMeans-Test']).toBe('mapping')
   })
+
+  test('attachments travel as decoded bytes under their own names and types', async () => {
+    const png = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])
+    const options = makeSmtpSettingsModel(base).toMailOptions({
+      ...message,
+      attachments: [
+        { filename: 'shot.png', content: png, contentType: 'image/png' },
+        { filename: 'notes.txt', content: 'aGVsbG8=', encoding: 'base64', contentType: 'text/plain' },
+      ],
+    })
+
+    expect(options.attachments).toHaveLength(2)
+    expect(makeSmtpSettingsModel(base).toMailOptions(message).attachments).toBeUndefined()
+
+    const transport = nodemailer.createTransport({ jsonTransport: true })
+    const info = await transport.sendMail(options)
+    const built = JSON.parse(info.message as unknown as string)
+
+    expect(built.attachments.map((a: { filename: string }) => a.filename)).toEqual(['shot.png', 'notes.txt'])
+    expect(built.attachments[0].contentType).toBe('image/png')
+    expect(Buffer.from(built.attachments[0].content, 'base64')).toEqual(Buffer.from(png))
+    expect(built.attachments[1].contentType).toBe('text/plain')
+    expect(Buffer.from(built.attachments[1].content, 'base64').toString('utf8')).toBe('hello')
+  })
 })