module

var Client = di.Module(
	Library,
	config.Module,
	telemetry.Module,
	cache.Module,
	feature.Module,
	hooks.Module,
	sql.Module,
	limiter.Module,
)

Client provides the standard Fx module composition for a go-service client.

It builds on Library and adds client-oriented wiring commonly needed by client processes and batch jobs:

• config.Module (config decoding + validation + common sub-config projections)
• telemetry.Module (logging/tracing/metrics wiring)
• cache.Module (cache drivers/facade; optional by config)
• feature.Module (OpenFeature client + optional provider registration)
• hooks.Module (shared Standard Webhooks constructor/generator helpers)
• sql.Module (SQL database wiring; currently PostgreSQL)
• limiter.Module (rate limiter key map wiring)

Unlike Server, Client does not wire debug endpoints, transports, HTTP/gRPC health endpoints, or HTTP hook transport adapters by default. Those can be added explicitly by composing additional modules, such as transport.Module or github.com/alexfalkowski/go-service/v2/transport/http/hooks.Module, on top of Client if needed.

This is the primary entrypoint for client-style applications built from `go-client-template`.

var Library = di.Module(
	env.Module,
	compress.Module,
	encoding.Module,
	crypto.Module,
	time.Module,
	sync.Module,
	id.Module,
)

Library provides a baseline Fx module intended for reuse by both servers and clients.

It wires common, transport-agnostic dependencies that many subsystems build upon:

• env.Module (ID/UserAgent/UserID constructors; Name and Version are supplied by CLI wiring or custom callers)
• compress.Module (compression registry and default codecs)
• encoding.Module (encoding registry and default encoders)
• crypto.Module (crypto primitives and helpers)
• time.Module (time providers/utilities)
• sync.Module (shared buffer pool wiring)
• id.Module (ID generator implementations and selection)

Library does not wire config decoding, transports, servers, or request handling; it is intended to be a common foundation that both the Server and Client bundles build upon.

var Server = di.Module(
	Library,
	debug.Module,
	config.Module,
	telemetry.Module,
	cache.Module,
	feature.Module,
	sql.Module,
	limiter.Module,
	transport.Module,
	health.Module,
)

Server provides the standard Fx module composition for a go-service server.

It builds on Library and adds server-oriented wiring commonly needed by services:

• debug.Module (debug server + diagnostic endpoints)
• config.Module (config decoding + validation + common sub-config projections)
• telemetry.Module (logging/tracing/metrics wiring)
• cache.Module (cache drivers, cache facade, and package-level cache registration)
• feature.Module (OpenFeature client + optional provider registration)
• sql.Module (SQL database wiring; currently PostgreSQL)
• limiter.Module (rate limiter key map wiring; transport modules typically construct limiters)
• transport.Module (HTTP/gRPC transports, transport health endpoint registration, CloudEvents HTTP receiver hooks, and server lifecycle wiring)
• health.Module (shared go-health server/observer lifecycle used by transport health endpoints)

Many of these subsystems are optional and are enabled/disabled by configuration (often via nil pointer sub-configs). This bundle wires constructors/registrations; runtime behavior depends on the config supplied to the graph.

This is the primary entrypoint for server applications built from `go-service-template`.