chore(smtp): framework version alignment to v1.1.2

docs(smtp): fix wiring doc examples; align to v1.1.1
docs(smtp): fix fictional launcher.Register/health.Register in doc examples (#2 )
2026-08-08 00:43:59 -06:00 · 2026-08-07 23:32:57 -06:00 · 2026-08-07 22:19:52 -06:00 · 2026-08-07 19:14:04 -06:00
5 changed files with 56 additions and 11 deletions
@@ -0,0 +1,40 @@
+# Changelog — einherjar/smtp
+
+All notable changes to this module are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+This module adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.1.2] — 2026-08-08
+
+Patch — coordinated framework version alignment.
+
+### Changed
+
+- Bumped einherjar dependencies (`contracts`, `core`) to v1.1.2. No code or API changes.
+
+## [1.1.1] — 2026-08-07
+
+Patch — corrected package-doc wiring examples plus framework version alignment.
+
+### Fixed
+
+- Doc examples used a fictional `launcher.Register` / `health.Register` API; corrected to
+  `lc.Append` + `web/health.NewHandler(...).ServeHTTP`.
+
+### Changed
+
+- Bumped einherjar dependencies (`contracts`, `core`) to v1.1.1.
+
+## [1.1.0] — 2026-08-07
+
+Patch — coordinated framework version alignment.
+
+### Changed
+
+- Bumped einherjar dependencies (`contracts`, `core`) to v1.1.0.
+
+## [1.0.0] — 2026-05-28
+
+Initial release. See the README for the full API and the `v1.0.0` git tag for the source.
@@ -1,6 +1,6 @@
 # einherjar/smtp

-[![version](https://img.shields.io/badge/version-v1.0.0-5C4EE5?style=flat-square)](https://code.nochebuena.dev/einherjar/smtp)
+[![version](https://img.shields.io/badge/version-v1.1.2-5C4EE5?style=flat-square)](https://code.nochebuena.dev/einherjar/smtp)
 [![license](https://img.shields.io/badge/license-AGPL--3.0-22863A?style=flat-square)](LICENSE)
 [![go](https://img.shields.io/badge/Go-1.26+-00ADD8?style=flat-square&logo=go&logoColor=white)](https://go.dev)
 [![health](https://img.shields.io/badge/health-degraded-E36209?style=flat-square)]()
@@ -19,8 +19,9 @@
 import "code.nochebuena.dev/einherjar/smtp"

 mailer := smtp.New(logger, smtp.DefaultConfig())
-launcher.Append(mailer)   // OnInit verifies credentials; OnStop is a no-op
-health.Register(mailer)   // dial check; LevelDegraded
+lc.Append(mailer)   // OnInit verifies credentials; OnStop is a no-op
+// mailer is observability.Checkable (dial check, LevelDegraded):
+srv.Get("/health", health.NewHandler(logger, mailer).ServeHTTP)
 ```

 When `cfg.Host` is empty, `New` returns a no-op that logs every `Send` call at debug level and always returns nil. No code changes are needed between environments.
@@ -12,8 +12,12 @@
 // # Lifecycle Registration
 //
 //	client := smtp.New(logger, cfg)
-//	launcher.Register(client)
-//	health.Register(client)
+//	lc.Append(client) // lifecycle: OnInit → OnStop
+//
+// client satisfies [observability.Checkable], so it can back a health endpoint via
+// web/health.NewHandler:
+//
+//	srv.Get("/health", health.NewHandler(logger, client).ServeHTTP)
 //
 // # Sending
 //
@@ -3,6 +3,6 @@ module code.nochebuena.dev/einherjar/smtp
 go 1.26

 require (
-	code.nochebuena.dev/einherjar/contracts v1.0.0
-	code.nochebuena.dev/einherjar/core v1.0.0
+	code.nochebuena.dev/einherjar/contracts v1.1.2
+	code.nochebuena.dev/einherjar/core v1.1.2
 )
@@ -1,4 +1,4 @@
-code.nochebuena.dev/einherjar/contracts v1.0.0 h1:hRudEtOIqU7vwedYLsCh8+9q5dCnKb61qX+zibqImRU=
-code.nochebuena.dev/einherjar/contracts v1.0.0/go.mod h1:ccltUtrFb5+MEJdkx2VVEUL+xC5pupVlVVsMM8AlCWI=
-code.nochebuena.dev/einherjar/core v1.0.0 h1:AueZgfjp3+rQmDKOxmJQ945TTh+sqC1l/xJdTOdbr9w=
-code.nochebuena.dev/einherjar/core v1.0.0/go.mod h1:0IywfRnJXX9xXQO6iPVaq2QDlXbbpXrB8A4T7gO8nE4=
+code.nochebuena.dev/einherjar/contracts v1.1.2 h1:LNAFCKQjpNjkCyMid2AgkhDPPzOx8dvpRqqZ7F3zpo0=
+code.nochebuena.dev/einherjar/contracts v1.1.2/go.mod h1:ccltUtrFb5+MEJdkx2VVEUL+xC5pupVlVVsMM8AlCWI=
+code.nochebuena.dev/einherjar/core v1.1.2 h1:iYU2fIWtnyOYFbTMD92NaLJMye4XgZHXWhEjB3iS7lo=
+code.nochebuena.dev/einherjar/core v1.1.2/go.mod h1:Y7qZ9nri9Ydey3+40yz75KErOvOUjRSoffdykXbncsw=
Author	SHA1	Message	Date
Rene Nochebuena	0c5177a415	chore(smtp): framework version alignment to v1.1.2	2026-08-08 00:43:59 -06:00
Rene Nochebuena	ce72260b0b	docs(smtp): fix wiring doc examples; align to v1.1.1	2026-08-07 23:32:57 -06:00
Rene Nochebuena	af6f5ab9e6	docs(smtp): fix fictional launcher.Register/health.Register in doc examples (#2 ) The package-doc examples showed a fictional launcher.Register / health.Register API (and launcher.Append as a package func). Corrected to the real wiring: lc.Append + web/health.NewHandler(...).ServeHTTP. Documentation-only. No code, API, or dependency changes; version stays v1.1.0 (the v1.1.0 tag is moved to include this fix). Verified by compiling the corrected pattern against the real API. Reviewed-on: #2 Co-authored-by: Rene Nochebuena Guerrero <rene@nochebuena.dev> Co-committed-by: Rene Nochebuena Guerrero <rene@nochebuena.dev>	2026-08-07 22:19:52 -06:00
Rene Nochebuena	e1cd1d2674	chore(smtp): bump einherjar deps to v1.1.0 (framework version alignment) (#1 ) Patch of the coordinated framework release: einherjar modules move to v1.1.0 in lockstep, so smtp is bumped alongside the rest. - go.mod: contracts, core -> v1.1.0 (via go get + go mod tidy) No code or API changes. ModuleVersion() reports v1.1.0 automatically from build info once tagged. Badge bumped to v1.1.0. Reviewed-on: #1 Co-authored-by: Rene Nochebuena Guerrero <rene@nochebuena.dev> Co-committed-by: Rene Nochebuena Guerrero <rene@nochebuena.dev>	2026-08-07 19:14:04 -06:00