Skip to content

AWS Secrets Manager SDK

Grow Codes CI License

One API for AWS Secrets Manager in five languages: TypeScript, Rust, Go, Python and Java. Every package has the same functions, options, defaults, error codes and behaviour, tested against the AWS API emulator motoserver/moto:5.2.4 in Docker.

Language Package Coverage
TypeScript @grow-codes/aws-secrets-manager TypeScript coverage
Rust grow-aws-secrets-manager Rust coverage
Go github.com/grow-codes-packages/aws-secrets-manager/go Go coverage
Python grow-aws-secrets-manager Python coverage
Java codes.grow.packages:aws-secrets-manager Java coverage

What you get

  • Built on the official AWS SDKs (@aws-sdk/client-secrets-manager, aws-sdk-secretsmanager, AWS SDK for Go v2, boto3 / aioboto3, AWS SDK for Java v2): SigV4, the standard credential chain, SSO, IAM roles and an assume-role helper, with the Grow configuration mapped onto them (Client setup).
  • The whole AWS Secrets Manager API: read, batch read, describe and list with auto-pagination, create, new versions, stage labels, delete/restore, tags, resource policies, rotation, random passwords and JSON fields (Functions).
  • AWS caching-client semantics: a version-stage aware cache (TTL 1 h, 1 024 entries) that checks DescribeSecret before re-reading a value (AWS secret cache).
  • Secrets: the portable provider API shared by every Grow Codes secrets SDK — typed getters, bulk reads, loadEnv, watch and a TTL cache (Secrets over AWS).
  • Configuration from code or GROW_AWS_SECRETS_MANAGER_* / standard AWS_* environment variables, immutable and validated (Configuration).
  • Typed errors mapped by AWS error code to one set of codes across languages (Error handling); timeouts, retries and cancellation in every language.
  • Redaction everywhere: credentials and secret values never appear in errors, logs, hooks or toString (Redaction).

Start with Install and the Quickstart.

Independent project

This SDK is made by Grow Codes. AWS Secrets Manager is a trademark of its owner (Amazon.com, Inc. or its affiliates); this project is not affiliated with or endorsed by it. See License & disclaimer.