/*
Package minio provides a MinIO (S3-compatible) client with launcher lifecycle
and health check integration.

Register the component with the launcher and use the Client interface in repositories:

	cfg := minio.Config{
		Endpoint:  "minio:9000",
		AccessKey: "minioadmin",
		SecretKey: "minioadmin",
		Bucket:    "my-app-assets",
	}
	mc := minio.New(logger, cfg)
	lc.Append(mc)                 // OnInit + OnStart + OnStop managed automatically
	health.NewHandler(logger, mc) // mc satisfies health.Checkable

Uploading an object via the Client interface:

	info, err := mc.PutObject(ctx, "my-app-assets", "products/abc/photo.jpg",
		reader, size, miniogo.PutObjectOptions{ContentType: "image/jpeg"})

Generating a pre-signed download URL:

	u, err := mc.PresignedGetObject(ctx, "my-app-assets", "products/abc/photo.jpg", time.Hour, nil)

Use Native() for operations not covered by Client (e.g. PresignedPutObject, ListObjects):

	url, err := mc.Native().PresignedPutObject(ctx, "my-app-assets", "products/abc/photo.jpg", time.Hour)

Errors returned by Client methods are already mapped to typed xerrors values. Use errors.As
to inspect them:

	var xe *xerrors.Err
	if errors.As(err, &xe) && xe.Code() == xerrors.ErrNotFound {
		// object or bucket does not exist
	}

When using Native() directly, map errors explicitly with HandleError before returning them:

	obj, err := mc.Native().GetObject(ctx, bucket, key, miniogo.GetObjectOptions{})
	if err != nil {
		return HandleError(err) // maps NoSuchKey → ErrNotFound, AccessDenied → ErrPermissionDenied, etc.
	}
	defer obj.Close()
*/
package minio