# dwyl/aws-sdk-mock

:rainbow: AWSomocks for Javascript/Node.js aws-sdk tested, documented & maintained. Contributions welcome!

Repository: https://github.com/dwyl/aws-sdk-mock
Canonical: https://ross.abutalabs.com/products/aws-sdk-mock
Language: TypeScript
License: Apache-2.0
License Family: permissive
Last push: 2026-08-31T21:08:22+00:00

## Health v2 (maintenance only)
Score: 68/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 8, longevity 100
- inputs: {"age_days": 3862, "days_push": 2, "days_rel": 721, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1128, forks 105 (observed 2026-09-01T02:14:01.042419+00:00)

## What it is
A Node.js library that mocks AWS SDK (v2) services and methods using Sinon.js, primarily for unit testing AWS Lambda functions. It lets developers replace AWS service calls (S3, DynamoDB, SNS, etc.) with stubbed responses during tests.

## Use cases
- mock aws sdk calls in unit tests
- test lambda functions without hitting real aws services
- stub s3 operations in node.js tests
- mock dynamodb responses for testing
- simulate sns messages in tests
- prevent aws api calls during ci test runs

## When to choose
- you use AWS SDK for JavaScript v2 and need reliable, maintained mocks
- you are unit testing Lambda functions that call AWS services
- you want Sinon.js-based stubbing of AWS service methods

## When to avoid
- you are using AWS SDK v3, where mocking via client injection is often simpler
- you need integration tests against real or emulated AWS services (e.g. LocalStack)
- your project is not JavaScript/Node.js

## Facets
- artifact type: library
- maturity: active
- function: mocking, testing
- domain: testing, developer-tools, cloud-computing
- platform: -
- tags: aws-sdk, aws, unit-testing, sinon, lambda, npm-package, nodejs, javascript

## Member repositories
- dwyl/aws-sdk-mock (main) score 68

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:01.042419+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:38:32.943399+00:00, confidence not recorded.
  - readme: https://github.com/dwyl/aws-sdk-mock (fetched 2026-09-01T02:14:01.042419+00:00, sha 492f7ef60ed3)
  - registry_npm: https://registry.npmjs.org/aws-sdk-mock (fetched 2026-08-29T12:43:10.498146+00:00, sha 74b8aee682fa)
- Data as of 2026-08-30T08:39:29.467469+00:00.