Package Overview

Core interfaces (ports): ORM, Database, Rows, Row, Tx, Transactional, Cache, Storage, Token, Claims.

Load .env into typed Config. *_ENABLED flags for Postgres/Redis/MinIO/JWT. Validates only enabled adapters. Builds Postgres DSN.

Generic helpers: Coalesce and Unique. Domain-independent — scaffold also drops a copy into your project's pkg/utils.

GORM v2 PostgreSQL adapter. Implements contract.ORM. Default database adapter for all generated modules.

Raw SQL adapter. pgx v5 connection pool. Implements contract.Database and contract.Transactional.

go-redis v9 client. Implements contract.Cache. Wire when REDIS_ENABLED=true.

MinIO object storage. Auto-creates buckets on startup. Wire when MINIO_ENABLED=true.

golang-jwt v5, HMAC-SHA256. Sign/Verify reject empty secrets. Wire when JWT_ENABLED=true.

Fiber middleware: JWT auth, RBAC role checking, configurable CORS with preflight support.

AppError type with HTTP status + error code. Sentinels: NotFound, BadRequest, Unauthorized, Conflict, etc.

Standard JSON response envelope: Success, SuccessMessage, Paginated, Error. Consistent API responses.

Thread-safe locale registry. Parse Accept-Language header. Built-in EN, LO (Lao), TH, ZH. Custom locales.

Struct validation via go-playground/validator. Human-readable field error messages. Custom rule registration.

bcrypt password hashing and verification via golang.org/x/crypto.

Offset pagination params. Normalize() clamps Page/Limit. Offset() computes DB offset without mutation.

slog-based logger factory. Development() for text output, Production() for JSON. Zero external deps.

Function-override test doubles for Database, Cache, Storage, Token, Tx, TransactionalDB. No mock frameworks.