Jadpo is experimental and not ready for production. These docs follow the compiler's main branch as of 30 Oct 2026. What's built · Install 0.1.0
jadpo
Reference: External services

External services

Tests and fakes

In jadpo test, every package has a generated fake, so tests never call a provider. An operation answers with a valid default built from its output type. A test scripts a response or a failure for one call with fakes: (Fakes for integrations), and the test host puts one fake in every provider connection's place, answering each operation's scripted answers in order:

example
test "a taken slot is reported" {    fakes: {        couriers.bookings.create: [slot_taken]    }    ...}

Responses still pass through the real retries, decoding and mapping, and package actions run for real over the faked operations.

The compiler checks every scripted response against the package's types, so a fake can't return a shape the provider never would. Tests script the clean type, never the shape on the wire. Fakes keep idempotency keys as the provider does, and accept lost and in_use as scripted answers (Several changing calls in one action). Grants are declared as fixtures.

jadpo test --kind contract runs the same cases against the provider's sandbox, in CI on a schedule. Every written operation that isn't confirmed by a recording must have a case in that run.

Grants as fixtures and the contract run aren't built yet.

Markdown for agents: /docs/tests-and-fakes.md.Built from Jadpo main at a707efb.