@owlmeans/mailer 0.1.18-rc.35 → 0.1.18-rc.36

package/README.md

@@ -13,7 +13,7 @@ Provider-agnostic email dispatch interface for the OwlMeans framework — `Maile
 ## Installation
 
 ```bash
-bun add @owlmeans/mailer@^0.1.18-rc.35
+bun add @owlmeans/mailer@^0.1.18-rc.36
 ```
 
 ## Usage
@@ -37,7 +37,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@^0.1.18-rc.48
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 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,
   "package": "@owlmeans/mailer",
-  "version": "0.1.18-rc.35",
-  "generatedAt": "2026-10-05T08:32:19.129Z",
+  "version": "0.1.18-rc.36",
+  "generatedAt": "2026-10-05T21:03:06.407Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,7 +8,7 @@ metadata:
 
 # Using `@owlmeans/mailer`
 
-**Install:** `"@owlmeans/mailer": "^0.1.18-rc.35"` in `dependencies`
+**Install:** `"@owlmeans/mailer": "^0.1.18-rc.36"` in `dependencies`
 
 Provider-agnostic email dispatch service. It defines the `MailerService` interface and ships one
 transport of its own — the console/dev one. Real delivery is a separate package:

package/build/service.d.ts

@@ -1,11 +1,8 @@
-import type { MailerService, MailMessage } from './types.js';
+import type { ConsoleMailerService } from './types.js';
 /** Dev/test transport: logs the message to console and stores it for inspection. */
-export declare const makeConsoleMailerService: (alias?: string) => MailerService & {
-    /** Messages captured since the service was created (use in tests). */
-    captured: MailMessage[];
-};
+export declare const makeConsoleMailerService: (alias?: string) => ConsoleMailerService;
 /** Alias of makeConsoleMailerService registered under the default MAILER_SERVICE alias.
  *  Useful as a drop-in replacement during development and integration tests.
  */
-export declare const makeDefaultConsoleMailerService: () => ReturnType<typeof makeConsoleMailerService>;
+export declare const makeDefaultConsoleMailerService: () => ConsoleMailerService;
 //# 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,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAM5D,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,sBAA6B,aAAa,GAAG;IAChF,sEAAsE;IACtE,QAAQ,EAAE,WAAW,EAAE,CAAA;CAmBxB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,QAAO,UAAU,CAAC,OAAO,wBAAwB,CACnD,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAA8B,MAAM,YAAY,CAAA;AAMlF,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,sBAA6B,oBAkBjE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,QAAO,oBACT,CAAA"}

package/build/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAE5B,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,GAAG,cAAc,EAG7D,EAAE;IACF,MAAM,QAAQ,GAAkB,EAAE,CAAA;IAElC,MAAM,OAAO,GAAG,aAAa,CAAgB,KAAK,EAAE;QAClD,IAAI,EAAE,KAAK,EAAE,OAAoB,EAAiB,EAAE;YAClD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACtB,4FAA4F;YAC5F,6FAA6F;YAC7F,uDAAuD;YACvD,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACtC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,EAAE;aACnF,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAA;QAC/B,CAAC;KACF,CAAgD,CAAA;IAEjD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC3B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAgD,EAAE,CAC/F,wBAAwB,CAAC,cAAc,CAAC,CAAA"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAE5B,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,GAAG,cAAc,EAAwB,EAAE;IACvF,MAAM,QAAQ,GAAkB,EAAE,CAAA;IAElC,MAAM,OAAO,GAAG,aAAa,CAAgB,KAAK,EAAE;QAClD,IAAI,EAAE,KAAK,EAAE,OAAoB,EAAiB,EAAE;YAClD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACtB,4FAA4F;YAC5F,6FAA6F;YAC7F,uDAAuD;YACvD,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACtC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,EAAE;aACnF,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAA;QAC/B,CAAC;KACF,CAAyB,CAAA;IAE1B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC3B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAyB,EAAE,CACxE,wBAAwB,CAAC,cAAc,CAAC,CAAA"}

package/build/types.d.ts

@@ -14,4 +14,9 @@ export interface MailMessage {
 export interface MailerService extends InitializedService {
     send: (message: MailMessage) => Promise<void>;
 }
+/** The dev/test transport: delivers by logging, and keeps what it sent for inspection. */
+export interface ConsoleMailerService extends MailerService {
+    /** Messages captured since the service was created (use in tests). */
+    captured: MailMessage[];
+}
 //# 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,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,sEAAsE;IACtE,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/mailer",
-  "version": "0.1.18-rc.35",
+  "version": "0.1.18-rc.36",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,9 +22,9 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.33",
-    "@owlmeans/error": "^0.1.18-rc.37",
-    "@owlmeans/log": "^0.1.18-rc.1"
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/error": "^0.1.18-rc.38",
+    "@owlmeans/log": "^0.1.18-rc.2"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/service.ts

@@ -1,15 +1,12 @@
 import { createService } from '@owlmeans/context'
-import type { MailerService, MailMessage } from './types.js'
+import type { ConsoleMailerService, MailerService, MailMessage } from './types.js'
 import { MAILER_SERVICE, CONSOLE_MAILER } from './consts.js'
 import { logger } from '@owlmeans/log'
 
 const log = logger('mailer')
 
 /** Dev/test transport: logs the message to console and stores it for inspection. */
-export const makeConsoleMailerService = (alias = CONSOLE_MAILER): MailerService & {
-  /** Messages captured since the service was created (use in tests). */
-  captured: MailMessage[]
-} => {
+export const makeConsoleMailerService = (alias = CONSOLE_MAILER): ConsoleMailerService => {
   const captured: MailMessage[] = []
 
   const service = createService<MailerService>(alias, {
@@ -23,7 +20,7 @@ export const makeConsoleMailerService = (alias = CONSOLE_MAILER): MailerService
         to: message.to, subject: message.subject, body: message.text ?? message.html ?? '',
       }, { event: 'mail.console' })
     },
-  }) as MailerService & { captured: MailMessage[] }
+  }) as ConsoleMailerService
 
   service.captured = captured
   return service
@@ -32,5 +29,5 @@ export const makeConsoleMailerService = (alias = CONSOLE_MAILER): MailerService
 /** Alias of makeConsoleMailerService registered under the default MAILER_SERVICE alias.
  *  Useful as a drop-in replacement during development and integration tests.
  */
-export const makeDefaultConsoleMailerService = (): ReturnType<typeof makeConsoleMailerService> =>
+export const makeDefaultConsoleMailerService = (): ConsoleMailerService =>
   makeConsoleMailerService(MAILER_SERVICE)

package/src/types.ts

@@ -16,3 +16,9 @@ export interface MailMessage {
 export interface MailerService extends InitializedService {
   send: (message: MailMessage) => Promise<void>
 }
+
+/** The dev/test transport: delivers by logging, and keeps what it sent for inspection. */
+export interface ConsoleMailerService extends MailerService {
+  /** Messages captured since the service was created (use in tests). */
+  captured: MailMessage[]
+}

package/tests/console.spec.ts

@@ -0,0 +1,53 @@
+import { describe, expect, test } from 'bun:test'
+import { AppType, makeBasicContext } from '@owlmeans/context'
+import type { BasicConfig } from '@owlmeans/context'
+import { CONSOLE_MAILER, MAILER_SERVICE, makeConsoleMailerService, makeDefaultConsoleMailerService } from '../src/index.js'
+import type { MailerService } from '../src/index.js'
+
+/** Registered and initialized the way an application does it, then looked up by alias. */
+const booted = async (service: MailerService) => {
+  const ctx = makeBasicContext<BasicConfig>({ ready: false, service: 'mailer-tests', type: AppType.Backend })
+  ctx.registerService(service)
+  ctx.configure()
+  await ctx.init()
+
+  return ctx
+}
+
+describe('@owlmeans/mailer — console transport', () => {
+  test('is registered under its own alias unless told otherwise', () => {
+    expect(makeConsoleMailerService().alias).toBe(CONSOLE_MAILER)
+    expect(makeConsoleMailerService('outbox').alias).toBe('outbox')
+  })
+
+  test('the default variant answers the alias every consumer looks the mailer up by', async () => {
+    const mailer = makeDefaultConsoleMailerService()
+    const ctx = await booted(mailer)
+
+    expect(ctx.service<MailerService>(MAILER_SERVICE)).toBe(mailer)
+  })
+
+  test('captures every message as sent, in order, without touching it', async () => {
+    const mailer = makeConsoleMailerService()
+    await booted(mailer)
+    const first = { to: 'a@example.com', subject: 'Code', text: '123456' }
+    const second = {
+      to: 'b@example.com', subject: 'Report', html: '<b>done</b>', from: 'Ops <ops@example.com>',
+      replyTo: 'help@example.com', headers: { 'X-Run': '7' },
+    }
+
+    await mailer.send(first)
+    await mailer.send(second)
+
+    expect(mailer.captured).toEqual([first, second])
+  })
+
+  test('each instance keeps its own outbox', async () => {
+    const one = makeConsoleMailerService('one')
+    const two = makeConsoleMailerService('two')
+    await one.send({ to: 'a@example.com', subject: 'only one' })
+
+    expect(one.captured).toHaveLength(1)
+    expect(two.captured).toHaveLength(0)
+  })
+})