@certysign/sdk 1.0.0 → 2.1.0

package/examples/nhif-batch-sign.js

@@ -1,216 +0,0 @@
-/**
- * NHIF Kenya — Batch Invoice Signing Integration
- *
- * This example shows how NHIF's automated invoicing system uses batchSign()
- * to sign hundreds of provider reimbursement invoices in a single API call
- * during the nightly batch run.
- *
- * Workflow:
- *  1. Collect pending invoices from the DB (up to 25 per API call)
- *  2. Sign all documents in one batchSign() call
- *  3. For each signed invoice: store envelopeId, certificate serial
- *  4. Retrieve audit trails for compliance archiving
- *  5. Download signed PDFs from the envelopes
- *
- * Rate limits:
- *  The SDK automatically handles 429 responses with exponential back-off.
- *  For very large batches, use the BATCH_SIZE constant to chunk requests.
- *
- * Prerequisites:
- *   npm install @certysign/sdk
- *   export CERTYSIGN_PUBLIC_KEY="cs_pk_..."
- *   export CERTYSIGN_SECRET_KEY="cs_sk_..."
- */
-
-'use strict';
-
-const fs   = require('fs');
-const path = require('path');
-const { CertySignClient, CertySignError } = require('@certysign/sdk');
-
-// ── Config ───────────────────────────────────────────────────────────────────
-
-const BATCH_SIZE = 10;          // Sign up to 10 invoices per API call (max 25)
-const SIGNER_NAME  = 'NHIF Finance System';
-const SIGNER_EMAIL = 'invoicing-batch@nhif.or.ke';
-
-const client = new CertySignClient({
-  publicKey:   process.env.CERTYSIGN_PUBLIC_KEY,
-  secretKey:   process.env.CERTYSIGN_SECRET_KEY,
-  environment: 'production'
-});
-
-// ── Simulated pending invoices ────────────────────────────────────────────────
-
-function getPendingInvoices() {
-  // In production: fetch from your DB
-  return [
-    { id: 'INV-2026-0441', provider: 'Aga Khan University Hospital', amount: 1_250_000 },
-    { id: 'INV-2026-0442', provider: 'Nairobi Hospital',             amount:   875_000 },
-    { id: 'INV-2026-0443', provider: 'Karen Hospital',               amount:   430_000 },
-    { id: 'INV-2026-0444', provider: 'MP Shah Hospital',             amount:   995_000 },
-    { id: 'INV-2026-0445', provider: 'Mater Hospital',               amount:   660_000 }
-  ];
-}
-
-function loadInvoicePdf(invoice) {
-  // In production: load from document store / generate from template
-  const filePath = path.join(__dirname, `invoice-${invoice.id}.pdf`);
-  if (fs.existsSync(filePath)) return fs.readFileSync(filePath);
-  // Placeholder for demo
-  return Buffer.from(`%PDF-1.4 NHIF Invoice ${invoice.id} — ${invoice.provider}`);
-}
-
-// ── Chunk array helper ────────────────────────────────────────────────────────
-
-function* chunks(arr, size) {
-  for (let i = 0; i < arr.length; i += size) {
-    yield arr.slice(i, i + size);
-  }
-}
-
-// ── Batch signing ─────────────────────────────────────────────────────────────
-
-async function runNightlyBatch() {
-  console.log('\n[NHIF] Starting nightly invoice signing batch');
-  console.log(`[NHIF] Timestamp: ${new Date().toISOString()}`);
-  console.log('─'.repeat(60));
-
-  const invoices = getPendingInvoices();
-  console.log(`[NHIF] ${invoices.length} invoices pending signature`);
-
-  const signedRecords = [];
-  const failedInvoices = [];
-  let batchNumber = 0;
-
-  for (const batch of chunks(invoices, BATCH_SIZE)) {
-    batchNumber++;
-    console.log(`\n[NHIF] Batch ${batchNumber} — signing ${batch.length} invoices...`);
-
-    // Build document list for this batch
-    const documents = batch.map(invoice => ({
-      data:     loadInvoicePdf(invoice),
-      filename: `nhif-invoice-${invoice.id}.pdf`
-    }));
-
-    try {
-      const result = await client.sign.batchSign({
-        documents,
-        signerName:  SIGNER_NAME,
-        signerEmail: SIGNER_EMAIL,
-        reason:      `NHIF provider reimbursement batch — ${new Date().toISOString().slice(0, 10)}`,
-        location:    'Nairobi, Kenya',
-        metadata: {
-          batchNumber:  batchNumber,
-          invoiceCount: batch.length,
-          system:       'NHIF-FINANCE-BATCH'
-        }
-      });
-
-      // Map results back to invoice records
-      const results = result.data.results;  // Array, one per document
-      for (let i = 0; i < batch.length; i++) {
-        const invoice = batch[i];
-        const res     = results[i];
-
-        if (res.success) {
-          signedRecords.push({
-            invoiceId:         invoice.id,
-            provider:          invoice.provider,
-            amount:            invoice.amount,
-            envelopeId:        res.envelopeId,
-            certificateSerial: res.certificate?.serialNumber,
-            signedAt:          new Date().toISOString(),
-            status:            'SIGNED'
-          });
-
-          console.log(`  ✓ ${invoice.id} → env: ${res.envelopeId}`);
-        } else {
-          failedInvoices.push({ invoice, reason: res.error });
-          console.warn(`  ✗ ${invoice.id} → ${res.error}`);
-        }
-      }
-
-    } catch (err) {
-      if (err instanceof CertySignError) {
-        console.error(`[NHIF] Batch ${batchNumber} API error (${err.statusCode}): ${err.message}`);
-        if (err.statusCode === 429) {
-          // Rate limited — wait and log (SDK already retried 3 times)
-          console.error('[NHIF] Rate limit exhausted — will retry this batch in next run');
-        }
-        batch.forEach(inv => failedInvoices.push({ invoice: inv, reason: err.message }));
-      } else {
-        throw err;
-      }
-    }
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────
-  // Step 2: Retrieve audit trails for compliance
-  // ─────────────────────────────────────────────────────────────────────────
-  console.log(`\n[NHIF] Retrieving audit trails for ${signedRecords.length} signed invoices...`);
-
-  for (const record of signedRecords.slice(0, 3)) {  // Demo: first 3 only
-    try {
-      const auditResult = await client.envelopes.getAuditTrail(record.envelopeId);
-      const { auditTrail, chainIntegrity } = auditResult.data;
-
-      record.auditEntries    = auditTrail.length;
-      record.auditChainValid = chainIntegrity?.valid;
-
-      console.log(`  ✓ ${record.invoiceId}: ${auditTrail.length} events, chain=${chainIntegrity?.valid}`);
-    } catch (err) {
-      console.warn(`  ✗ Audit trail for ${record.invoiceId}: ${err.message}`);
-    }
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────
-  // Step 3: Download first signed PDF as a demo
-  // ─────────────────────────────────────────────────────────────────────────
-  if (signedRecords.length > 0) {
-    const sample = signedRecords[0];
-    try {
-      console.log(`\n[NHIF] Downloading signed PDF for ${sample.invoiceId}...`);
-      // First get the envelope to find the document ID
-      const env = await client.envelopes.get(sample.envelopeId);
-      const docId = env.data?.envelope?.documents?.[0]?._id;
-
-      if (docId) {
-        const pdfBuffer = await client.envelopes.getDocument(sample.envelopeId, docId);
-        const outPath = path.join(__dirname, `signed-${sample.invoiceId}.pdf`);
-        fs.writeFileSync(outPath, pdfBuffer);
-        console.log(`[NHIF] ✓ Saved signed PDF to ${outPath} (${pdfBuffer.length} bytes)`);
-      }
-    } catch (err) {
-      console.warn(`[NHIF] Could not download signed PDF: ${err.message}`);
-    }
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────
-  // Summary
-  // ─────────────────────────────────────────────────────────────────────────
-  console.log('\n' + '─'.repeat(60));
-  console.log(`[NHIF] Batch complete`);
-  console.log(`       Signed   : ${signedRecords.length}`);
-  console.log(`       Failed   : ${failedInvoices.length}`);
-
-  if (failedInvoices.length) {
-    console.log('[NHIF] Failed invoices:');
-    failedInvoices.forEach(({ invoice, reason }) => {
-      console.log(`  - ${invoice.id}: ${reason}`);
-    });
-  }
-
-  return { signed: signedRecords, failed: failedInvoices };
-}
-
-// ── Run ───────────────────────────────────────────────────────────────────────
-
-(async () => {
-  try {
-    await runNightlyBatch();
-  } catch (err) {
-    console.error('\n[NHIF] Fatal error:', err.message);
-    process.exit(1);
-  }
-})();