TypeScript SDK

import { VoiceMark } from "@defchat-ltd/voicemark-sdk";

const vm = new VoiceMark({
  apiKey: process.env.VOICEMARK_API_KEY,
  baseUrl: "https://api.voicemark.dev/v1", // optional override
});

const enroll: EnrollResponse = await vm.enroll(blob, userId);

interface EnrollResponse {
  voiceprint_id: string;
  enrolled_at: string;
  quality_score: number;    // 0–1
  duration_s: number;
  glyph_params: Record<string, number>;
}

const { phrase, challenge_id } = await vm.challenge();

interface ChallengeResponse {
  phrase: string;
  challenge_id: string;
  expires_in: number;
  source?: { title?: string; author?: string; year?: string; attribution?: string };
}

const verify: VerifyResponse = await vm.verify(blob, {
  voiceprintId: storedVoiceprintId,
  challengeId: challenge_id,
});

interface VerifyResponse {
  token: string;
  token_id: string;
  authorized: boolean;
  pii: null;
  expires_in: number;
  liveness_score?: number;
  transcription?: string;
  cloud_data?: {
    words: Array<{ word: string; f0: number; rms: number; bands: number[] }>;
    glyph_params: Record<string, number>;
  };
}

const { valid, expires_in } = await vm.token(tokenId, tokenJwt);

const { permitted } = await vm.policy(verify.token, "payment.authorise");

await vm.receipt(verify.token, "payment.authorise", "success", {
  amount: 250, currency: "GBP",
});

import { VoiceMarkError } from "@defchat-ltd/voicemark-sdk";

try {
  const verify = await vm.verify(blob, { voiceprintId });
} catch (err) {
  if (err instanceof VoiceMarkError) {
    console.error(err.code);    // "VOICE_MISMATCH" | "CHALLENGE_EXPIRED" | ...
    console.error(err.status);  // HTTP status code
    console.error(err.message);
  }
}