Rene Nochebuena
7b3c331ae8
docs(storage-minio): fix fictional launcher.Register/health.Register in doc examples
...
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.
2026-08-07 22:14:03 -06:00
Rene Nochebuena
1a34b84ee9
feat(storage-minio): initial implementation — MinIO/S3 object storage with lifecycle (v1.0.0)
...
Introduces code.nochebuena.dev/einherjar/storage-minio — the object storage
starter for the Einherjar framework. Absorbs the minio package from micro-lib,
replacing fmt.Errorf wrapping with core/xerrors.
Interfaces (CT-6: one TypeSpec per file):
- Provider — PutObject, RemoveObject, GetObject, PresignedGetObject, HandleError
- Component — lifecycle.Component + observability.Checkable + Provider + Native()
Implementation:
- New(logger, cfg) Component — client not created until OnInit
- OnInit: minio.New with credentials and transport; bucket existence check
- OnStart: BucketExists PING; logs "minio: connected"
- OnStop: logs "minio: closing client" (minio-go is stateless; no explicit close)
- HealthCheck: BucketExists check; Priority LevelCritical
- Native() *miniogo.Client — escape hatch for operations not in Provider
- HandleError: maps minio-go errors to xerrors (NotFound, AlreadyExists, Internal)
Config (EINHERJAR_MINIO_* env vars):
Endpoint(required), AccessKey(required), SecretKey(required),
Bucket(required), UseSSL(false), Region(us-east-1)
- Component interface embeds observability.Identifiable; identifiable.go implements
ModulePath and ModuleVersion via runtime/debug.ReadBuildInfo() — prints in launcher banner
2026-05-29 16:03:52 +00:00
Rene Nochebuena