Skip to main content

Node SDK

The Node SDK provides high-signal helpers for:

  • createClient()
  • authorizeRequest()
  • verifyPermit()
  • createJwksCache()
  • Express and Fastify permit middleware

Install​

pnpm add @veritrellis/sdk-node

Minimal client example​

import { createClient } from "@veritrellis/sdk-node";

const client = createClient({
  apiKey: process.env.VERITRELLIS_API_KEY!,
  workspaceId: process.env.VERITRELLIS_WORKSPACE_ID!,
  environment: "sandbox",
  apiUrl: "https://api.veritrellis.ai"
});

const result = await client.authorizeRequest({
  action_type: "issue_refund",
  resource_ref: "cus_123",
  payload: {
    customer_id: "cus_123",
    amount: 50,
    currency: "USD",
    reason: "customer requested correction"
  }
});

Verify permit before execution​

import { verifyPermit } from "@veritrellis/sdk-node";

const claims = await verifyPermit({
  permitJwt: result.permit,
  workspaceId: process.env.VERITRELLIS_WORKSPACE_ID!,
  issuer: "https://api.veritrellis.ai"
});

Use the verified claims as execution input and reject any request that cannot be verified.

Middleware support​

The SDK exposes middleware for Express and Fastify to centralize permit verification on protected routes.

Generated API reference​

Detailed SDK symbols are generated from source: