PPIL client — TypeScript
@aithne/ppil-client — the typed PPIL client for TypeScript stacks, with the full issue / verify / rotate API surface.
SDK overview
Install
# install the typed ecosystem client
npm install @aithne/ppil-client
# types flow through your whole stack
import PPIL from "@aithne/ppil-client";
npm install @aithne/ppil-client
# types flow through your whole stack
import PPIL from "@aithne/ppil-client";
Example only — no real keys here. Configure secrets from environment, never commit or log them.
Typed surface
// compile-time checked against the AVP contract
ppil.issue({ attestationRef, correlationId })
ppil.verify({ pptToken, otpAlias, requiredCategories, correlationId })
ppil.revoke({ pptId, correlationId })
ppil.issue({ attestationRef, correlationId })
ppil.verify({ pptToken, otpAlias, requiredCategories, correlationId })
ppil.revoke({ pptId, correlationId })
What it does
- Full TypeScript type declarations for requests, responses, and hooks.
- Age-verification middleware with session short-circuit for verified users.
- Strongly-typed merchant hooks enforce the signing boundary at compile time.
- Masked logging — sensitive tokens never appear raw in diagnostics.