Skip to content

Release notes

All 27 maintained modules share one version. Browse all GitHub Releases for full changelogs.

v1.3.1

2026-11-01 · GitHub Release

Upgrade recommended. We encourage all users to update their maintained Powertools modules to v1.3.1, rebuild with Go 1.27.3 or newer, and redeploy their Lambda binaries. This compatible maintenance release refreshes Go dependencies without changing public Go APIs. Updating a module requirement alone does not update an already deployed binary.

Dependencies and security

  • Refresh dependencies in 15 maintained public modules, including AWS SDK for Go v2, OpenTelemetry 1.47.0, gRPC 1.85.0, Redis 9.23.0, regexp2 2.12.0 and Avro 2.35.0. Other maintained modules receive the same version and aligned internal requirements. (#266)
  • Patch five Zod/fast-uri advisories in the repository's development reference tooling. These Node dependencies are not shipped as Go runtime libraries. Keep the historical Parser compatibility corpus and document behavior differences in the patched runner. (#266)
  • Keep the deprecated X-Ray SDK adapter frozen and excluded from publication. Use the OpenTelemetry Tracer for maintained tracing integrations.

Verification

  • Publish one stable Release with 27 matching module tags. See publication acceptance for the exact source, full PR/main checks and fresh public Go consumer results. The earlier local security audit retains its original scope; hosted full regression supplies the complete module and container acceptance.
  • Lambda runtime execution covers Linux amd64; arm64 is built and scanned. CGO remains disabled, and no AWS cloud tests are performed.

v1.3.0

2026-10-23 · GitHub Release

Features

  • Logger (Preview): Attach source stacks with WithStack, add a logging-site stack to ordinary errors by default, and record handler panics before rethrowing the original value. WithStackTrace(false) and WithPanicLogging(false) disable these defaults. The Preview is included in v1.3.0 and main; v1.2.0 does not provide these APIs. (#242)

Security and fixes

  • Require Go 1.27.3 or newer for the patched standard library. Update tracing dependencies to golang.org/x/net v0.61.0, golang.org/x/crypto v0.58.0 in the selected graph and gRPC v1.83.2; update Unicode text handling to v0.43.0. Rebuild deployed Lambda binaries with the patched toolchain. (#256)
  • Avro: Replace the archived codec with the maintained github.com/iskorotkov/avro/v2 v2.34.0, retaining cumulative collection bounds and adding explicit codec allocation limits. (#256)
  • Protobuf: Align truncated short-prefix diagnostics with patched protobufjs v7.6.6. Audit the pinned reference tooling against the official npm registry during CI. (#260)
  • Preserve native boundary behavior in Signer, Data Masking/KMS, Avro, AppSync GraphQL and Bedrock error cases. See the consolidated Release for individual fixes. (#233)

Performance and verification

  • Reduce Logger filtering, correlation and normalization allocations; reuse bounded private snapshots for ordinary JSON-shaped data in Commons/JMESPath and decode Validation snapshots directly. JSON v2 remains the fallback for custom and other unsupported fast paths. (#249, #253)
  • Publish one Release and 27 matching module tags. The deprecated X-Ray SDK adapter remains excluded. See public publication acceptance and scoped security acceptance for source identity, checks and evidence boundaries.

v1.2.0

2026-10-13 · GitHub Release

Features

Fixes

  • Logger: Preserve native TextMarshaler values and errors without invoking a failed marshaler twice. (#219)
  • Idempotency: Retain in-progress records until their execution deadline is strictly earlier than acquisition time. (#217)
  • HTTP: Reject invalid response headers before output and close retained bodies once when conversion fails. (#221)
  • Commons: Deduplicate NaN DynamoDB numeric set members and preserve numeric BOOL semantics for native Go values. (#222)
  • Metrics: Reject metadata writes to closed invocation scopes before calling user serializers. (#223)
  • JMESPath: Correct numeric conversion, JSON v2 serialization and null multi-select evaluation. (#226)
  • Validation: Preserve null oneOf branch indices and empty property names in JSON v2 diagnostics. (#215)

Changes

  • Complete first-party JSON v2 API adoption and expand finite compatibility audits across utility modules. Go 1.27 remains required.
  • Align all 27 maintained module versions and internal dependencies at v1.2.0. The frozen X-Ray SDK adapter remains excluded from new publication.
  • Improve quickstart, utility guides and documentation discovery. See publication acceptance for verified public consumers and source identity.

v1.1.0

2026-10-10 · GitHub Release

Features

  • Logger: Add opt-in WrapRawHandler to log incoming JSON before typed decoding, retaining unknown members, empty/null values and exact numeric tokens. (#149)

Changes

  • Align all maintained module versions and internal dependencies at v1.1.0.

v1.0.0

2026-10-07 · GitHub Release

Features

  • HTTP Metrics: Add opt-in request-count metrics with bounded route dimensions. (#106)
  • Logger: Support streaming JSON marshalers and JSON v2 collection/error behavior while preserving exact numeric tokens. (#111)

Fixes

  • Logger / Metrics: Reject invalid log field names without partial output, preserve decoded number precision and omit unspecified EMF storage resolution.
  • Parameters: Isolate SSM and Secrets Manager caches by effective request options; bypass caching for nonpositive lifetimes.
  • Batch / Idempotency Cache: Return every retry identifier when a full batch fails; retain unexpired in-progress records without execution deadlines to prevent duplicate execution.
  • Parser: Accept documented SES, Cognito and VPC Lattice inputs; preserve CloudFormation PhysicalResourceId and REST authorizer context.
  • HTTP: Honor compression quality values, validate structured +json bodies and preserve empty 204/205/304 responses.
  • HTTP: Preserve binary/preencoded bodies, cookies and repeated headers; bound error-handler redispatch and respect cancellation.
  • AppSync Events: Propagate per-handler authorization errors after publication workers finish.
  • Data Masking: Apply missing-field errors and warnings to erasure Rules as well as Fields.

Breaking changes

  • Require Go 1.27 and adopt JSON v2: reject duplicate members and malformed Unicode, match typed field names case-sensitively and encode nil collections as [] / {}.
  • HTTP Metrics: New accepts variadic Options. Update explicitly nonvariadic constructor function types; direct calls remain valid.

Changes

v1.0.0-rc.1

2026-10-07 · Prerelease · GitHub Release

Features

  • Preview HTTP request-count metrics and Logger streaming JSON support for the v1 API.

Fixes

  • Batch / Idempotency Cache: Preserve full-batch retry identifiers and prevent reacquisition of unexpired in-progress records without execution deadlines.
  • Parameters: Separate caches by effective request options and bypass caching for nonpositive lifetimes.

Breaking changes

  • Require Go 1.27 and strict JSON v2 decoding with case-sensitive typed field names and v2 collection defaults.
  • HTTP Metrics: Change New to accept variadic Options; explicitly nonvariadic constructor function types need updating.

v0.2.0

2026-10-05 · GitHub Release

Features

  • Release all maintained modules at one shared version with aligned dependencies.

Fixes

  • Parameters: Correct UTF-8 replacement and strip leading BOMs from byte/binary transformations.
  • Parser: Correct UTF-8 replacement and BOM handling in Base64 text and gzip JSON decoding.
  • JMESPath: Decode malformed UTF-8 consistently in Base64 and gzip functions.
  • Signer: Keep request bodies available until asynchronous transport uploads finish.

v0.1.0

2026-10-04 · GitHub Release

Features

  • Initial public release of 27 maintained modules, including Logger, OpenTelemetry Tracer, Metrics, Parameters, Parser, Batch and Idempotency.