TypeScript SDK

npm install dual-sdk

import { DualClient } from 'dual-sdk';

const dual = new DualClient({
  token: process.env.DUAL_API_KEY,
  authMode: 'api_key',  // 'api_key' | 'bearer' | 'both'
});

// Every method returns typed responses — no `any`
const wallet = await dual.wallets.me();
console.log(wallet.id, wallet.email);  // Wallet type

// Cursor-based pagination with generics
const page = await dual.templates.list({ limit: 20 });
console.log(page.items[0].name);  // Template type
console.log(page.next);           // string | null

// Mint an object via the Event Bus
const result = await dual.eventBus.execute({
  action: { mint: { template_id: 'tmpl_abc123', custom: { name: 'My First Object' } } }
});
console.log(result.action_id);  // Action result

const dual = new DualClient({
  token: process.env.DUAL_API_KEY,
  authMode: 'api_key',          // 'api_key' | 'bearer' | 'both'
  baseUrl: 'https://gateway-48587430648.europe-west6.run.app',  // default
  timeout: 30_000,              // 30s default
  retry: {
    maxAttempts: 3,             // retries on 429 and 5xx only
    backoffMs: 1000,            // exponential backoff base
  },
});

import {
  DualClient,
  DualError,
  DualAuthError,
  DualNotFoundError,
  DualRateLimitError,
} from 'dual-sdk';

const dual = new DualClient({ token: process.env.DUAL_API_KEY, authMode: 'api_key' });

try {
  const obj = await dual.objects.get('missing-id');
} catch (err) {
  if (err instanceof DualNotFoundError) {
    console.error('Not found:', err.code);          // 404
  } else if (err instanceof DualRateLimitError) {
    console.error('Retry after:', err.retryAfter);  // seconds from header
  } else if (err instanceof DualAuthError) {
    console.error('Auth failed — check your token'); // 401
  } else if (err instanceof DualError) {
    console.error('API Error [' + err.status + ']: ' + err.code);
  }
}