Skip to main content
Official Go SDK for Westyx Nexus - the centralised secrets, feature flags, and config service.

Highlights

  • Go 1.25+ - the core module has no dependencies at all; the AWS SDK is needed only to sign an STS request for the aws_iam provider, so that provider ships as its own module
  • Thread-safe TTL cache with atomic snapshot replacement and ETag/304 support
  • Background refresh - caller goroutines are never blocked on cache expiry
  • SSE live updates - started automatically by NewClient; propagates remote changes within milliseconds; after 3 consecutive transport errors waits out a reconnect schedule and reconnects on its own
  • Public-key vs secret-key access control - public-key clients get ErrPublicKeyRestricted from GetSecret
  • Sentinel errors - errors.Is(err, nexus.ErrUnauthorized) style, idiomatic Go
  • Workload Identity Federation - Kubernetes / AWS IRSA / GCP / Azure auto-detected; bearer-JWT auth with automatic refresh; AWS IAM (aws_iam) for ECS/Fargate/Lambda/plain-EC2; a developer credential so a laptop authenticates the same way
  • Stream observer hooks - opt-in structured callbacks for ops dashboards and load-test tooling
  • Service kind awareness - GetSecret blocked with ErrServiceKindMismatch on kind=frontend
  • 402 Payment Required handling - ErrBilling returned, background refresh throttled to one attempt every five minutes, cache served
  • AB Testing batch evaluation - EvaluateAB(ctx, keys, userID, attributes) for the AB Testing add-on; ErrABAddonNotAvailable on 403
  • File-type secrets - SecretTypeFile materialised as 0600 files inside a 0700 directory private to the client (nexus-secrets-* under the system temp directory), with SHA-256-derived names so neither the key name nor the value appears in the path; GetSecretFilePath(key) exposes the path; Close() removes the directory

Module

The module is served directly via proxy.golang.org - there is no separate package registry.
Latest release: v0.19.0 (2026-11-19) - see the version history.

Quick start

Pages