NonLoggable wraps a string that must never appear in logs or JSON output.

AuthorizationMock bypasses JWT validation for local development. NEVER enable in production.

BadRequestError represents a 400 Bad Request transport error.

Claims holds the JWT payload. Standard claims (exp, iss, sub) are embedded and validated automatically.

ClaimsParser handles JWT generation and validation.

ClaimsParserOption is a functional option for ClaimsParser.

Config holds the MongoDB connection settings.

Config is the full application configuration.

ConflictError represents a 409 Conflict transport error.

Consumer implements worker.MessageConsumer by routing decoded messages through go-kit endpoints. Replace the Start/Close stubs with your broker client

Consumer holds configuration for message broker consumers (Kafka, RabbitMQ, etc.).

ConsumerProcess wires up and starts the message consumer.

ConsumerWorker runs a MessageConsumer with graceful shutdown on SIGINT/SIGTERM.

CreateExampleCommandPayload is the transport-level wire format for the "example.create" message, matching the AsyncAPI CreateExampleCommandPayload sch

---- Create ----

CreateHandler handles the create-example use case.

CreateParams holds the data required to insert a new example record.

go:generate go tool mockgen -source=${GOFILE} -destination=mock/${GOFILE} -package=mock

go:generate go tool mockgen -source=${GOFILE} -destination=mock/${GOFILE} -package=mock

DBConfig holds the connection parameters for a PostgreSQL database.

DeadlineError is returned when a context deadline is exceeded inside an endpoint.

Decoder decodes an HTTP request into a domain request type.

---- Delete ----

DeleteHandler handles the delete-example use case.

Dependencies holds external client connections shared across the HTTP process.

Dependencies holds external client connections shared across the gRPC process.

Dependencies holds external client connections shared across the consumer process.

go:generate mockgen -destination=mock/mock.go -package=mock github.com/nawafswe/go-service-starter-kit/internal/httpx Doer

EncodeDecoder combines Encoder and Decoder.

Encoder encodes a domain response type into an HTTP response.

EndpointCfg holds per-endpoint rate limiter and deadline settings.

Endpoints holds per-endpoint rate limiter and timeout configuration.

ErrorEncoder encodes an error into an HTTP response.

Example is a placeholder domain entity. Replace this with your own domain models.

ExampleServiceClient is the client API for ExampleService service. For semantics around ctx use and closing/ending streaming RPCs, please refer to ht

ExampleServiceHandler implements grpcv1.ExampleServiceServer by delegating each RPC method to a go-kit gRPC transport handler. This gives every method

ExampleServiceServer is the server API for ExampleService service. All implementations must embed UnimplementedExampleServiceServer for forward compat

ForbiddenError represents a 403 Forbidden transport error.

GRPCServerProcess wires up and starts the gRPC server.

GRPCWorker runs a grpc.Server with graceful shutdown on SIGINT/SIGTERM.

---- Get ----

GetHandler handles the get-example use case.

HTTPServerProcess wires up and starts the HTTP server.

HTTPWorker runs an http.Server with graceful shutdown on SIGINT/SIGTERM.

go:generate mockgen -destination=mock/mock.go -package=mock github.com/nawafswe/go-service-starter-kit/internal/grpcx Invoker

JSONErrorEncoder encodes domain and transport errors as JSON:API error responses.

Level enumerates available log levels.

---- List ----

ListHandler handles the list-examples use case.

LogErrorHandler logs errors produced inside go-kit HTTP servers.

LogErrorHandler logs errors produced inside go-kit gRPC handlers.

go:generate go tool mockgen -source=${GOFILE} -destination=mock/${GOFILE} -package=mock Logger is the primary logging interface. All application code

MessageConsumer is the interface that any message consumer must implement. Implementations are responsible for connecting to the broker, subscribing t

MessageHandler pairs a decode function with a go-kit endpoint. Decode converts the raw payload into the request type the endpoint expects.

MessageRouter maps message type names to their handler. Used by the consumer to route incoming messages.

NotFoundError represents a 404 Not Found transport error.

Option configures the test suite before the test runs.

Option customises the behaviour of CreateTestDB.

Option configures the resilient HTTP client.

Option configures the resilient gRPC client.

Option configures the PostgreSQL connection.

Option configures the MySQL connection.

OrderBy describes a single SQL ORDER BY clause.

Page holds caller-supplied pagination input (1-indexed page number + page size).

PageResult is the computed pagination metadata returned in list responses.

PasswordGenerator hashes and verifies passwords using bcrypt.