update docs

Author: ntheile

bindings/typescript/README.md

@@ -60,6 +60,33 @@ const status = await node.lookupInvoice({ paymentHash: invoice.paymentHash });
 const txs = await node.listTransactions({ from: 0, limit: 10 });
 ```
 
+### Invoice Event Polling
+
+Poll for invoice settlement after creating an invoice. The callback fires with `'success'`, `'pending'`, or `'failure'`.
+
+```ts
+await node.onInvoiceEvents(
+  {
+    paymentHash: invoice.paymentHash,
+    pollingDelaySec: 3,
+    maxPollingSec: 60,
+  },
+  (status, tx) => {
+    if (status === 'success') {
+      // Invoice was paid and settled
+      console.log('Paid!', tx.amountMsats, 'msats');
+      console.log('Preimage:', tx.preimage);
+    } else if (status === 'pending') {
+      // Still waiting — fires each poll interval
+      console.log('Waiting for payment...');
+    } else if (status === 'failure') {
+      // maxPollingSec exceeded without settlement
+      console.log('Invoice was not paid within the timeout');
+    }
+  },
+);
+```
+
 ### Spark (browser + Expo Go oriented)
 
 ```ts
@@ -155,21 +182,6 @@ const info = await getPaymentInfo(destination, 100_000);
 const bolt11 = await resolveToBolt11(destination, 100_000);
 ```
 
-### Invoice Event Polling
-
-```ts
-await node.onInvoiceEvents(
-  {
-    paymentHash: invoice.paymentHash,
-    pollingDelaySec: 3,
-    maxPollingSec: 60,
-  },
-  (status, tx) => {
-    console.log('Invoice event:', status, tx);
-  },
-);
-```
-
 ## Implemented in this package
 
 - `PhoenixdNode`

bindings/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sunnyln/lni",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": false,
   "description": "Lightning Node Interface. Connect to CLN, LND, Phoenixd, NWC, Strike, Speed, Blink and Spark. Supports BOLT11, BOLT12, LNURL, Lightning Address  (Frontend-first TypeScript support, no wasm, no native node modules)",
   "type": "module",