TypeScript SDK

npm install @signalstack/sdk

# yarn
yarn add @signalstack/sdk

# pnpm
pnpm add @signalstack/sdk

# bun
bun add @signalstack/sdk

import { SignalStack } from "@signalstack/sdk"

// Using environment variable
const client = new SignalStack()

{`// Explicit API key
const client = new SignalStack({
  apiKey: process.env.SIGNALSTACK_API_KEY!,
  timeout: 30_000,
  maxRetries: 3,
  baseUrl: "https://signal-stack-ten.vercel.app/v1",
})`}

const result = await client.verify.business({
  companyName: "Acme Corp",
  jurisdiction: "us_de",
  officers: true,
  filings: true,
})

console.log(result.status)        // "active"
console.log(result.trustScore)    // 0.94
console.log(result.officers)
// [{ name: "John Doe", role: "CEO", appointedOn: "2015-03-12" }]

import { DocumentSource } from "@signalstack/sdk"

const result = await client.verify.document({
  source: DocumentSource.URL,
  content: "https://example.com/report.pdf",
  checkDeepfakes: true,
})

console.log(result.aiGeneratedProbability)  // 0.87
console.log(result.manipulationFlags)
// ["ai_generated_text", "metadata_stripped"]

const result = await client.verify.media({
  url: "https://example.com/photo.jpg",
  checkDeepfakes: true,
})

console.log(result.authenticity)     // "manipulated"
console.log(result.deepfakeScore)    // 0.94
console.log(result.provenanceSource) // "https://original-source.com/photo.jpg"

const result = await client.verify.claim({
  claim: "Water boils at 100°C at sea level",
  sources: ["web", "wikipedia", "semantic_scholar"],
})

console.log(result.verdict)       // "true"
console.log(result.trustScore)    // 0.97
for (const evidence of result.evidence) {
  console.log(`[${evidence.source}] ${evidence.snippet}`)
}

import {
  SignalStack,
  RateLimitError,
  AuthenticationError,
  ValidationError,
  ServerError,
} from "@signalstack/sdk"

try {
  const result = await client.verify.claim({ claim: "..." })
} catch (err) {
  if (err instanceof RateLimitError) {
    console.log(`Retry after ${err.retryAfter}s`)
  } else if (err instanceof AuthenticationError) {
    console.log("Check API key")
  } else if (err instanceof ValidationError) {
    console.log(`Validation: ${err.details}`)
  } else if (err instanceof ServerError) {
    console.log(`Server error: ${err.status}`)
  }
}

import type {
  SignalStackConfig,
  VerifyBusinessOptions,
  VerifyBusinessResponse,
  VerifyDocumentOptions,
  VerifyDocumentResponse,
  VerifyMediaOptions,
  VerifyMediaResponse,
  VerifyClaimOptions,
  VerifyClaimResponse,
  EvidenceItem,
  TrustDimensions,
  Verdict,
  Authenticity,
  DocumentSource,
  ManipulationFlag,
} from "@signalstack/sdk"