Client SDKs.

import { CredoClient } from '@engineeringid/sdk';

const client = new CredoClient({ apiKey: 'credo_your_api_key' });

// Verify a sealed document
const seal = await client.verification.verify('abc123def456');
console.log(seal.document.name, seal.credential.holderName);

// Generate a stamp image (no auth required)
const png = await client.stamps.generate({
  name: 'Jane Smith, PE',
  license: 'PE-12345',
  state: 'california',
  format: 'png'
});

// API key auth (all authenticated endpoints)
const client = new CredoClient({ apiKey: 'credo_abc123...' });

// Custom base URL (self-hosted or staging)
const staging = new CredoClient({
  apiKey: 'credo_abc123...',
  baseUrl: 'https://staging-api.example.com/v1',
  timeout: 60_000  // 60 seconds
});

// Public endpoints work without an API key
const publicClient = new CredoClient({});

// Look up a seal by verification code
const seal = await client.verification.verify('abc123def456');
// seal.valid, seal.document, seal.credential, seal.seal

// Match a document hash against a seal
const match = await client.verification.matchHash(
  'abc123def456',
  'e3b0c44298fc1c149afbf4c8996fb924...'
);
// match.match (boolean), match.message

// Get verification statistics
const stats = await client.verification.stats('abc123def456');
// stats.verificationCount, stats.sealedAt

// Verify a PDF (used by browser extensions)
const result = await client.verification.verifyPdf({
  code: 'abc123def456',
  hash: 'e3b0c44298fc1c149afbf4c8996fb924...'
});
// result.status: "valid" | "tampered" | "not_found"

// Generate a stamp image (returns ArrayBuffer)
const png = await client.stamps.generate({
  name: 'Jane Smith, PE',
  license: 'PE-12345',
  state: 'california',
  profession: 'engineer',      // optional, defaults to "engineer"
  format: 'png',               // "svg" | "png" | "pdf"
  discipline: 'CIVIL',         // optional
  city: 'Los Angeles',         // optional
  date: '2026-05-08'           // optional
});

// Save to file (Node.js)
import { writeFileSync } from 'node:fs';
writeFileSync('stamp.png', Buffer.from(png));

// Display in browser
const blob = new Blob([png], { type: 'image/png' });
img.src = URL.createObjectURL(blob);

const orgId = 'org-uuid-here';

// List audit logs with filters
const logs = await client.audit.listLogs(orgId, {
  limit: 50,
  action: 'seal.created',
  startDate: '2026-01-01T00:00:00Z'
});
// logs.auditLogs, logs.meta.limit, logs.meta.offset

// Verify audit chain integrity
const chain = await client.audit.verifyChain(orgId);
// chain.status: "passed" | "failed"

// Export as CSV
const csv = await client.audit.export(orgId, { format: 'csv' });

// Create a compliance report
const report = await client.audit.createReport(orgId, {
  reportType: 'security',
  periodStart: '2026-01-01T00:00:00Z',
  periodEnd: '2026-03-31T23:59:59Z'
});

import {
  ApiError,
  AuthenticationError,
  NotFoundError,
  RateLimitError,
  ValidationError
} from '@engineeringid/sdk';

try {
  const seal = await client.verification.verify('invalid');
} catch (err) {
  if (err instanceof NotFoundError) {
    console.log('Seal not found');
  } else if (err instanceof AuthenticationError) {
    console.log('Invalid API key');
  } else if (err instanceof RateLimitError) {
    console.log(`Rate limited. Retry after ${err.retryAfter}s`);
  } else if (err instanceof ValidationError) {
    console.log('Validation errors:', err.errors);
  } else if (err instanceof ApiError) {
    console.log(`API error ${err.statusCode}: ${err.message}`);
  }
}