pkg/

Package apperror defines the platform-wide application error type used to map domain and application failures to transport-level responses.

Package clock provides the Clock contract to provide time with testability.

Package config loads layered JSON configuration files with environment variable overrides into a service-defined config struct.

Package database holds database connection configuration and lifecycle.

Package echo provides the shared Echo HTTP stack: instance assembly, apperror-aware error handling, request logging, Sentry integration, the HTTP server lifecycle, and actor guard middlewares.

Package gorm_uow provides the GORM implementation of the UnitOfWork contract, plus the context plumbing repositories use to join an ambient transaction.

Package iam authenticates requests using IAM (Keycloak) service JWTs.

Package logger provides the Logger contract.

Package messaging defines the transport-agnostic inbound message contract and router shared by subscription adapters (NATS, SQS, …).

Package contract defines the migration driver contract.

Package nats provides the NATS JetStream connection, subject routing, and event/queue subscribers shared by all Tupic services.

Package objectstorage defines the transport-agnostic object-storage event contract shared by storage-event adapters (SQS, SNS, EventBridge, …).

Package outbox implements the Transactional Outbox pattern: outbound messages are stored in the caller's DB transaction and a relay ships them to NATS asynchronously.

Package pagination defines shared cursor-pagination types.

Package postgres_migrator implements the migration contract with golang-migrate.

Package random provides a crypto/rand-backed implementation of the random.Random contract.

Package redis provides a Redis client and lifecycle shared by Tupic services.

Package s3 implements the storage contract with AWS S3 (or a compatible API such as LocalStack/MinIO).

Package sentry initializes the Sentry SDK with a shutdown flush hook.

Package sqs is the SQS adapter for object-storage events: it polls an SQS queue fed by S3 bucket notifications, parses each message into an objectstorage.Event, and dispatches it through an objectstorage.Router.

Package utility provides general-purpose, dependency-free helper functions shared across Tupic services.

Package validator defines the Validator contract.