@libertasinception/iso

ISO 20022 financial messaging — fluent envelope builder, G3 gateway integration, cascade settlement tracking

Installation

npm install @libertasinception/iso

Quick Start

import { ISOClient, ISOBuilder, G3Client } from "@libertasinception/iso";

const envelope = new ISOBuilder()
  .messageType("pacs.008").source("n0.2").target("n4")
  .payload({ amount: "1000.00", currency: "EUR",
    debtor: { name: "Alice" }, creditor: { name: "Bob" } })
  .build();

const g3 = new G3Client(httpClient);
const receipt = await g3.submit(envelope);

const iso = new ISOClient(httpClient);
const tracking = await iso.track(receipt.id);
const resolved = await g3.resolveRIB("30006-00001-12345678901-89");

Features

• Fluent ISOBuilder for pacs.008 and other message types
• G3 banking gateway integration
• Cascade settlement tracking across chains
• Envelope validation against ISO standards
• RIB resolution for French bank routing
• AML flag detection

API Reference

Classes

• ISOClient
• G3Client
• ISOBuilder

Types

• ISOEnvelope
• CascadeTracking
• Receipt
• ValidationResult
• RibResolution
• ISOProfile

Dependencies

• @libertasinception/core
• zod

Requirements

• Node.js >= 18.0.0
• TypeScript >= 5.7 (recommended)

Links

• Documentation
• Guides
• Tutorials
• GitLab

License

MIT - see LICENSE for details.