feat(minio): initial stable release v1.0.0 — Client interface, xerrors, GetObject, doc examples

Add Client interface with PutObject, GetObject, RemoveObject, PresignedGetObject, and
HandleError; Component now embeds Client with Native() as escape hatch for operations
not covered by the interface. Add xerrors dependency: HandleError maps minio-go error
codes to portable typed codes (NoSuchKey → ErrNotFound, AccessDenied →
ErrPermissionDenied, BucketAlreadyExists → ErrAlreadyExists, etc.). OnStop sets
c.mc = nil for lifecycle consistency. doc.go updated with launcher wiring, upload,
presigned URL, GetObject, and HandleError usage examples. API committed as stable.

What's included:
- Config with Endpoint, AccessKey, SecretKey, UseSSL, Bucket, Region (env-driven, embeddable)
- Transport field in Config for test injection (env:"-", nil uses minio-go default)
- Client interface: PutObject, GetObject, RemoveObject, PresignedGetObject, HandleError
- Component interface: launcher.Component + health.Checkable + Client + Native()
- New(logger, cfg) constructor for lifecycle registration via lc.Append
- Automatic bucket creation on OnStart if bucket does not exist
- Health check via BucketExists at LevelCritical priority
- HandleError: maps minio-go ErrorResponse codes to xerrors typed errors
- 21 unit tests using mock HTTP transport; no live server required
This commit is contained in:
2026-05-19 21:42:30 -06:00
commit 3d12d18200
14 changed files with 950 additions and 0 deletions

15
CHANGELOG.md Normal file
View File

@@ -0,0 +1,15 @@
# Changelog
All notable changes to this module will be documented in this file.
## [v0.9.0] — 2026-05-20
### Added
- `Config` — env-tagged, embeddable struct: `Endpoint`, `AccessKey`, `SecretKey`, `UseSSL`, `Bucket`, `Region`, `Transport`
- `Provider` interface — `Native() *minio.Client`
- `Component` interface — `launcher.Component + health.Checkable + Provider`
- `New(logger logz.Logger, cfg Config) Component` — constructor
- Automatic bucket creation on `OnStart` if the configured bucket does not exist
- Health check via `BucketExists` at `health.LevelCritical` priority
- `OnStop` is a no-op — minio-go client is stateless