doc.go

// Package mysql provides a database/sql-backed MySQL client with launcher and health integration.
//
// Usage:
//
//	db := mysql.New(logger, cfg)
//	lc.Append(db)
//	r.Get("/health", health.NewHandler(logger, db))
package mysql
feat(mysql): initial stable release v0.9.0 database/sql-backed MySQL client with launcher lifecycle, health check, unit-of-work via context injection, and structured error mapping. What's included: - Executor / Tx / Client / Component interfaces using database/sql native types (sql.Result, sql.Rows, sql.Row) - Tx.Commit() / Tx.Rollback() without ctx, matching the honest database/sql contract - New(logger, cfg) constructor; sql.DB opened in OnInit - Config struct with env-tag support for all pool tuning parameters - UnitOfWork via context injection; GetExecutor(ctx) returns active sql.Tx or *sql.DB - HandleError mapping MySQLError.Number to xerrors codes (1062 → AlreadyExists, 1216/1217/1451/1452 → InvalidInput, ErrNoRows → NotFound) - Driver imported as mysqldrv alias to avoid package name collision - health.Checkable at LevelCritical; HealthCheck delegates to db.PingContext Tested-via: todo-api POC integration Reviewed-against: docs/adr/ 2026-03-19 13:21:34 +00:00			`// Package mysql provides a database/sql-backed MySQL client with launcher and health integration.`
			`//`
			`// Usage:`
			`//`
			`// db := mysql.New(logger, cfg)`
			`// lc.Append(db)`
			`// r.Get("/health", health.NewHandler(logger, db))`
			`package mysql`