import { FolaClient } from '@folaform/forms-sdk';
import { writeFile } from 'node:fs/promises';

const client = new FolaClient({
  apiKey: process.env.FOLA_KEY!,    // fk_live_… or fk_test_…
});

const result = await client.fill('i-130', {
  petitioner_family_name: 'Doe',
  petitioner_given_name:  'John',
  beneficiary_family_name: 'Doe',
  beneficiary_given_name:  'Jane',
  // …intellisense lists every field, type-checks enums, dates, etc.
});

await writeFile('i-130.pdf', result.pdf);
console.log(`Charged ${result.costCents}¢ — wallet now ${result.balanceCents}¢`);

import {
  FolaAuthError,
  FolaForbiddenError,
  InsufficientBalanceError,
  ValidationError,
  UnknownFormError,
} from '@folaform/forms-sdk';

try {
  await client.fill('i-130', { /* … */ });
} catch (err) {
  if (err instanceof InsufficientBalanceError) {
    console.error(`Top up — only ${err.balanceCents}¢ left, need ${err.costCents}¢`);
  } else if (err instanceof ValidationError) {
    // err.fieldErrors → { petitioner_family_name: 'required', ... }
    console.error(err.fieldErrors);
  } else if (err instanceof FolaAuthError) {
    console.error('API key revoked or invalid');
  } else if (err instanceof FolaForbiddenError) {
    // V225 introduced per-key scopes + IP allowlist. Branch on the
    // body code if you want different remediation copy:
    //   - 'developer_key_scope_missing' — widen scopes in the dashboard
    //   - 'developer_key_ip_blocked'    — add the egress IP to the allowlist
    //   - 'developer_api_disabled'      — email support to re-enable
    console.error(`Forbidden (${err.code}): ${err.message}`);
  } else if (err instanceof UnknownFormError) {
    console.error(`No such form: ${err.formId}`);
  } else throw err;
}

import type { I130Inputs, N400Inputs, Eta9089Inputs } from '@folaform/forms-sdk';

const inputs: I130Inputs = {
  petitioner_family_name: 'Doe',
  petitioner_given_name:  'John',
  // intellisense lists every field, type-checks enums, dates, etc.
};

await client.fill('i-130', inputs);

import { FORM_REGISTRY } from '@folaform/forms-sdk';

const meta = FORM_REGISTRY['i-130'];
// → { title, complexityTier, inputs: { [field]: { type, required, label, help, example, enumValues? } } }

import { verifyWebhook } from '@folaform/forms-sdk';

app.post('/fola/webhook', express.raw({ type: '*/*' }), (req, res) => {
  const event = verifyWebhook({
    body: req.body,
    signatureHeader: req.header('Fola-Signature')!,
    secret: process.env.FOLA_WEBHOOK_SECRET!,
  });
  // event.type → 'form.filled' | 'wallet.low_balance' | 'case.status_changed' | …
});