mkdir isa-ts-demo && cd isa-ts-demo
npm init -y
npm install --save-dev typescript @types/node tsx

cat > tsconfig.json << 'EOF'
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "strict": true,
    "esModuleInterop": true,
    "outDir": "dist"
  },
  "include": ["*.ts"]
}
EOF

npm install isa-sdk

export ISA_TOKEN="<paste your isa_test_… key here>"

echo "Token prefix: ${ISA_TOKEN:0:9}"
# Expected: isa_test_

import { Isa, IsaConfigError } from 'isa-sdk';

// Isa.withBearer() reads ISA_TOKEN from the environment.
// If it is missing it throws IsaConfigError naming the variable.
let isa: Isa;
try {
  isa = await Isa.withBearer();
} catch (err) {
  if (err instanceof IsaConfigError) {
    console.error('Configuration error:', err.message);
    console.error('Set ISA_TOKEN in your environment.');
    process.exit(1);
  }
  throw err;
}

console.log('Client created. Ready to prequalify.');

npx tsx prequalify.ts

import {
  Isa,
  IsaConfigError,
  Sex,
  Height,
  Weight,
  NicotineDuration,
  Coverage,
  ProductSelection,
  Products,
} from 'isa-sdk';

// ── 1. Build the client (reads ISA_TOKEN from env) ───────────────────────────
let isa: Isa;
try {
  isa = await Isa.withBearer();
} catch (err) {
  if (err instanceof IsaConfigError) {
    console.error('Configuration error:', err.message);
    process.exit(1);
  }
  throw err;
}

// ── 2. Run prequalify ────────────────────────────────────────────────────────
//
// dob:         ISO date string (YYYY-MM-DD). The engine uses this to
//              compute age and apply age-band rules.
// sex:         Sex.Male or Sex.Female. Biological sex affects underwriting
//              tables for most carriers.
// height:      Use Height.fromFeetInches(feet, inches) — never pass a raw
//              number; the value object prevents passing 70 when you mean 5'10".
// weight:      Weight.fromPounds(number) — keeps the unit explicit.
// state:       Two-letter US postal code. State determines which carriers
//              are licensed to write business there.
// nicotineUse: { lastUsed: NicotineDuration.Never/... } — the single biggest
//              underwriting factor after age.
//
// Products.Fex.AetnaAccendo carries the stable prod_<uuid> used on the wire.
// Always use catalog constants — never hardcode prod_ strings or slugs.
const { data } = await isa.zyins.prequalify({
  applicant: {
    dob: '1962-04-18',
    sex: Sex.Male,
    height: Height.fromFeetInches(5, 10),
    weight: Weight.fromPounds(195),
    state: 'NC',
    nicotineUse: { lastUsed: NicotineDuration.Never },
  },
  coverage: Coverage.faceValue(25_000),
  products: ProductSelection.of([Products.Fex.AetnaAccendo]),
});

// ── 3. Print the results ─────────────────────────────────────────────────────
console.log(`Plans found: ${data.plans.length}`);
console.log('');

for (const plan of data.plans) {
  const headline = plan.pricing.find(row => row.primary);
  console.log(
    `  ${plan.carrier.name.padEnd(24)} ${plan.product.name.padEnd(40)} ` +
    `eligible=${String(plan.eligible).padEnd(6)} ` +
    `death_benefit=${(plan.deathBenefit?.amount.display ?? '—').padEnd(10)}`,
  );
  if (headline?.premium) {
    console.log(`    ✓ ${headline.eligibility.category} ${headline.premium.amount.display}`);
  }
}

npx tsx prequalify.ts

import {
  Isa,
  IsaApiError,
  IsaConfigError,
  IsaIdempotencyConflictError,
  IsaRateLimitError,
  IsaValidationError,
  Sex, Height, Weight, NicotineDuration, Coverage, ProductSelection, Products,
} from 'isa-sdk';

const isa = await Isa.withBearer();

try {
  const { data } = await isa.zyins.prequalify({
    applicant: {
      dob: '1962-04-18', sex: Sex.Male,
      height: Height.fromFeetInches(5, 10), weight: Weight.fromPounds(195),
      state: 'NC', nicotineUse: { lastUsed: NicotineDuration.Never },
    },
    coverage: Coverage.faceValue(25_000),
    products: ProductSelection.of([Products.Fex.AetnaAccendo]),
  });
  // happy path
  console.log(data.plans.length, 'plans');
} catch (err) {
  if (err instanceof IsaIdempotencyConflictError) {
    // 409 — you sent two different request bodies under the same idempotency key.
    // This is always a code bug. Log and alert; do NOT automatically retry.
    console.error(`Idempotency conflict on key: ${err.key}`);
  } else if (err instanceof IsaRateLimitError) {
    // 429 — rate limited. Honor Retry-After.
    const wait = err.retryAfterSeconds ?? 60;
    console.error(`Rate limited. Wait ${wait}s before retrying.`);
  } else if (err instanceof IsaValidationError) {
    // 400 — fix your request; do not retry.
    console.error(`Validation error [${err.code}]: ${err.message}`);
  } else if (err instanceof IsaApiError) {
    // Any other API error. Stable `code`, machine-readable.
    console.error(`API error [${err.code}]: ${err.message}`);
    if (err.requestId) console.error(`Request ID: ${err.requestId}`);
  } else if (err instanceof IsaConfigError) {
    console.error('Config error:', err.message);
  } else {
    throw err;
  }
}

import {
  type Isa,
  type PrequalifyRequest,
  type Envelope,
  type PrequalifyV3Result,
  IsaApiError,
  IsaRateLimitError,
  IsaIdempotencyConflictError,
} from 'isa-sdk';

async function prequalifyWithRetry(
  isa: Isa,
  request: PrequalifyRequest,
  maxAttempts = 3,
): Promise<Envelope<PrequalifyV3Result>> {
  // The SDK mints one Idempotency-Key per call and reuses it across its
  // own automatic 5xx/429 retries, so this outer loop is replay-safe.
  let delayMs = 1_000;

  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    try {
      return await isa.zyins.prequalify(request);
    } catch (err) {
      if (err instanceof IsaApiError && err.code === 'validation_error') throw err;
      if (err instanceof IsaIdempotencyConflictError) throw err;
      if (attempt === maxAttempts) throw err;

      if (err instanceof IsaRateLimitError && err.retryAfterSeconds !== undefined) {
        delayMs = err.retryAfterSeconds * 1_000;
      } else {
        delayMs = Math.min(delayMs * 2, 30_000);
      }
      await new Promise(resolve => setTimeout(resolve, delayMs));
    }
  }
  throw new Error('prequalifyWithRetry: exhausted all attempts');
}