Documentation · Integrate

JavaScript SDK

Integrate QEV capture in Node/TypeScript: point at your gateway, send workflow events, seal evidence.

Requires a gateway. The SDK talks to a capture gateway you control (or the pilot surface). For a one-off secret with no code, use the browser vault.

Install / source

SDK source lives in the monorepo: packages/sdk-js. CLI published today: @bryan237l/qev-cli. Brand package names may track as they publish.

Minimal shape

import { QEV } from "@imagineqira/qev-sdk"; // monorepo package name may vary

const qev = new QEV({
  endpoint: process.env.QEV_GATEWAY_URL, // YOUR gateway base URL
  token: process.env.QEV_INGEST_TOKEN,
});

await qev.capture({
  flow: "field-service",
  caseId: "JOB-1",
  type: "work.completed",
  actor: { id: "tech@example.com" },
});

Steps

  1. Deploy or open a gateway — see Gateway docs.
  2. Create an ingest token on that instance.
  3. Point endpoint at that base URL (not a public plaintext dump).
  4. Emit events from your app; complete flows to seal packages.
  5. Verify packages via gateway or offline tools.

SDK overview · Connectors · Evidence bundles