This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
yarn build- Build the project using tsupyarn test- Run Jest tests from thetests/directoryyarn lint- Run ESLint on source codeyarn pretty- Format code with Prettieryarn pretty:check- Check code formattingyarn clean- Clean build artifacts and dependencies
- Tests are located in
tests/unit/with structure mirroringsrc/ - Jest configuration excludes
src/constantsandsrc/typesfrom coverage - Use
yarn testto run the full test suite
This is a TypeScript library that provides mock data for AWS services, primarily focused on AWS Cognito.
- Entry Point:
src/index.tsexports three main modules:awsServices,utils, andtypes - AWS Services: Located in
src/awsServices/, currently supports Cognito (tokens and user pools) - Utilities:
src/utils/contains shared utilities for JWT handling, key generation, and UUID generation - Types: TypeScript definitions organized by service in
src/types/ - Helpers: Service-specific helper functions in
src/helpers/
- Cognito Module: Generates mock Cognito tokens and JWKs for testing
- JWT Utilities: Handles asymmetric key generation, JWT signing, and base payload creation
- User Pool Support: Creates mock JWKS for Cognito user pool validation
- Uses
tsupfor building with multiple output formats (CJS/ESM) - TypeScript configuration extends from
tsconfig.base.json - Package manager is Yarn v4.2.2
The library is published as an npm package with:
- Main entry:
dist/index.js - TypeScript types:
dist/index.d.ts - ES module:
dist/index.mjs