Package Overview

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

Load .env files into typed Config structs. Validates JWT_SECRET on load. Builds Postgres DSN automatically.

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. Values serialized with json.Marshal for consistency with mock.

MinIO object storage. Auto-creates buckets on startup. Presigned URLs with caller-controlled expiry.

golang-jwt v5, HMAC-SHA256. Sets iat+exp claims. Validates signing method to prevent alg:none attacks.

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.