Use-Tusk/drift-node-sdk: Node.js SDK for capturing and replaying API calls made to/from your service

The Node.js Tusk Drift SDK enables fast and deterministic API testing by capturing and replaying API calls made to/from your service. Automatically record real-world API calls, then replay them as tests using the Tusk CLI to find regressions. During replay, all outbound requests are intercepted with recorded data to ensure consistent behavior without side-effects.

For comprehensive guides and API reference, visit our full documentation.

Tusk Drift currently supports the following packages and versions:

• HTTP/HTTPS: All versions (Node.js built-in)
• GRPC: @grpc/grpc-js@1.x (Outbound requests only)
• PG: pg@8.x, pg-pool@2.x-3.x
• Firestore: @google-cloud/firestore@7.x
• Postgres: postgres@3.x
• MySQL: mysql2@3.x
• IORedis: ioredis@4.x-5.x
• Upstash Redis: @upstash/redis@1.x
• GraphQL: graphql@15.x-16.x
• Prisma: prisma@5.x-6.x
• JSON Web Tokens: jsonwebtoken@5.x-9.x
• JWKS RSA: jwks-rsa@1.x-3.x

If you’re using packages or versions not listed above, please create an issue with the package + version you’d like an instrumentation for.

First, install and configure the Tusk Drift CLI by following our CLI installation guide. The CLI helps set up your Tusk configuration file and replays tests.

The wizard will eventually direct you back here when it’s time to set up the SDK.

After completing the CLI wizard, install the SDK:

npm install @use-tusk/drift-node-sdk

Refer to our initialization guide to set up the SDK for your service.

Follow along our quick start guide to record and replay your first test!

Having issues?

Join our open source community on Slack.

We appreciate feedback and contributions. See CONTRIBUTING.md.

This project is licensed under the Apache License 2.0 – see the LICENSE file for details.