TypeScript SDK

import Affonso from '@affonso/sdk';

const affonso = new Affonso('sk_live_...');

// List affiliates
const page = await affonso.affiliates.list({ limit: 50 });
console.log(page.data);

const affonso = new Affonso('sk_live_...', {
  baseUrl: 'https://api.affonso.io/v1', // default
  timeout: 30_000,                       // default: 30s
  maxRetries: 2,                         // default: 2 (retries on 429/5xx)
  fetch: customFetch,                    // custom fetch for testing/edge runtimes
});

// Create
const affiliate = await affonso.affiliates.create({
  name: 'Max',
  email: 'max@example.com',
  program_id: 'prog_123',
});

// Retrieve
const aff = await affonso.affiliates.retrieve(affiliate.id);

// Update
const updated = await affonso.affiliates.update(affiliate.id, {
  name: 'Max M.',
  status: 'approved',
});

// Delete
await affonso.affiliates.del(affiliate.id);

const page = await affonso.affiliates.list({ page: 1, limit: 25 });

console.log(page.data);        // Affiliate[]
console.log(page.pagination);  // { page, limit, total, total_pages, has_next_page, has_prev_page }

// Get the next page
const nextPage = await page.getNextPage(); // null if no more pages

const page = await affonso.referrals.list({ limit: 25 });
const nextPage = await page.getNextPage(); // uses starting_after cursor

const page = await affonso.affiliates.list({ limit: 50 });

for await (const affiliate of page.autoPaginate()) {
  console.log(affiliate.id);
}

// Affiliates: promoCodes, commissionOverrides, invoiceDetails, payoutMethod, onboardingResponses
const affiliate = await affonso.affiliates.retrieve('aff_123', {
  expand: 'promoCodes,commissionOverrides',
});

// Referrals: expand=affiliate, include=stats
const referral = await affonso.referrals.retrieve('ref_123', {
  expand: 'affiliate',
  include: 'stats',
});

// Commissions: affiliate, affiliate_program, referral
const commissions = await affonso.commissions.list({
  expand: 'affiliate,referral',
});

// Coupons: affiliate
const coupons = await affonso.coupons.list({ expand: 'affiliate' });

import {
  AffonsoError,
  AuthenticationError,
  NotFoundError,
  RateLimitError,
  ValidationError,
  DuplicateError,
} from '@affonso/sdk';

try {
  await affonso.affiliates.retrieve('nonexistent');
} catch (e) {
  if (e instanceof NotFoundError) {
    // 404
  }
  if (e instanceof RateLimitError) {
    console.log(e.retryAfter); // seconds until reset
  }
  if (e instanceof ValidationError) {
    console.log(e.details); // field-level errors
  }
}