@sunnyln/lni 0.1.0

package/README.md

@@ -0,0 +1,118 @@
+# LNI TypeScript (Frontend-first)
+
+Pure TypeScript port of `crates/lni` HTTP adapters for frontend runtimes.
+
+## Scope
+
+Implemented in this package:
+
+- `PhoenixdNode`
+- `ClnNode`
+- `LndNode`
+- `NwcNode`
+- `StrikeNode`
+- `SpeedNode`
+- `BlinkNode`
+- LNURL helpers (`detectPaymentType`, `needsResolution`, `resolveToBolt11`, `getPaymentInfo`)
+
+Not included yet:
+
+- `SparkNode` (intentionally deferred)
+
+## Install
+
+```bash
+npm install @sunnyln/lni
+```
+
+From source:
+
+```bash
+cd bindings/typescript
+npm install
+npm run typecheck
+npm run build
+```
+
+## Install from this GitHub repo (without publishing)
+
+Because this package lives in a monorepo subfolder, install it from a local path after cloning:
+
+```bash
+git clone https://github.com/lightning-node-interface/lni.git
+npm install ./lni/bindings/typescript
+```
+
+One-liner:
+
+```bash
+TMP_DIR=$(mktemp -d) && git clone --depth 1 https://github.com/lightning-node-interface/lni.git "$TMP_DIR/lni" && npm install "$TMP_DIR/lni/bindings/typescript"
+```
+
+From another project:
+
+```bash
+npm install /absolute/path/to/lni/bindings/typescript
+```
+
+## Packaging and publish
+
+```bash
+cd bindings/typescript
+npm install
+npm run prepack
+npm run pack:dry-run
+```
+
+To publish:
+
+```bash
+npm login
+npm run publish:public
+```
+
+Per-node real integration test scripts are available before publishing:
+
+- `npm run test:integration:phoenixd`
+- `npm run test:integration:cln`
+- `npm run test:integration:lnd`
+- `npm run test:integration:strike`
+- `npm run test:integration:speed`
+- `npm run test:integration:blink`
+- `npm run test:integration:nwc`
+
+## Basic usage
+
+```ts
+import { LndNode } from '@sunnyln/lni';
+
+const node = new LndNode({
+  url: 'https://127.0.0.1:8080',
+  macaroon: '...'
+});
+
+const info = await node.getInfo();
+console.log(info.sendBalanceMsat);
+```
+
+## Frontend runtime notes
+
+- This package uses `fetch` and does not depend on Node native modules.
+- You can inject a custom fetch implementation via constructor options:
+  - `new LndNode(config, { fetch: customFetch })`
+- `socks5Proxy` and `acceptInvalidCerts` are config-compatible with Rust structs, but not applied in browser fetch runtimes.
+- Most backends require secrets (API keys, macaroons, runes, passwords). For production web apps, use a backend proxy/BFF to protect secrets.
+
+## API parity
+
+The exported TypeScript interfaces mirror `bindings/lni_nodejs/index.d.ts` shapes:
+
+- `NodeInfo`
+- `Transaction`
+- `CreateInvoiceParams`
+- `PayInvoiceParams`
+- `ListTransactionsParams`
+- `LookupInvoiceParams`
+- `OnInvoiceEventParams`
+
+Methods are class-based (`getInfo`, `createInvoice`, `payInvoice`, `lookupInvoice`, etc.), with polling callback support via `onInvoiceEvents`.

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export type LniErrorCode = 'Http' | 'Api' | 'Json' | 'NetworkError' | 'InvalidInput' | 'LnurlError';
+export declare class LniError extends Error {
+    readonly code: LniErrorCode;
+    readonly status?: number;
+    readonly body?: string;
+    constructor(code: LniErrorCode, message: string, options?: {
+        status?: number;
+        body?: string;
+        cause?: unknown;
+    });
+}
+export declare function asLniError(error: unknown, fallbackCode?: LniErrorCode): LniError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,KAAK,GACL,MAAM,GACN,cAAc,GACd,cAAc,GACd,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAW/G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,GAAE,YAAoB,GAAG,QAAQ,CAUvF"}

package/dist/errors.js

@@ -0,0 +1,25 @@
+export class LniError extends Error {
+    code;
+    status;
+    body;
+    constructor(code, message, options) {
+        super(message);
+        this.name = 'LniError';
+        this.code = code;
+        this.status = options?.status;
+        this.body = options?.body;
+        if (options?.cause !== undefined) {
+            this.cause = options.cause;
+        }
+    }
+}
+export function asLniError(error, fallbackCode = 'Api') {
+    if (error instanceof LniError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new LniError(fallbackCode, error.message, { cause: error });
+    }
+    return new LniError(fallbackCode, 'Unknown error', { cause: error });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,IAAI,CAAe;IACnB,MAAM,CAAU;IAChB,IAAI,CAAU;IAE9B,YAAY,IAAkB,EAAE,OAAe,EAAE,OAA6D;QAC5G,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAE1B,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,eAA6B,KAAK;IAC3E,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './lnurl.js';
+export { PhoenixdNode } from './nodes/phoenixd.js';
+export { ClnNode } from './nodes/cln.js';
+export { LndNode } from './nodes/lnd.js';
+export { NwcNode } from './nodes/nwc.js';
+export { StrikeNode } from './nodes/strike.js';
+export { SpeedNode } from './nodes/speed.js';
+export { BlinkNode } from './nodes/blink.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './lnurl.js';
+export { PhoenixdNode } from './nodes/phoenixd.js';
+export { ClnNode } from './nodes/cln.js';
+export { LndNode } from './nodes/lnd.js';
+export { NwcNode } from './nodes/nwc.js';
+export { StrikeNode } from './nodes/strike.js';
+export { SpeedNode } from './nodes/speed.js';
+export { BlinkNode } from './nodes/blink.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/internal/encoding.d.ts

@@ -0,0 +1,5 @@
+export declare function encodeBase64(input: string): string;
+export declare function decodeBase64(input: string): Uint8Array;
+export declare function bytesToHex(bytes: Uint8Array): string;
+export declare function hexToBytes(hex: string): Uint8Array;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/internal/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/internal/encoding.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2BlD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA2CtD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAelD"}

package/dist/internal/encoding.js

@@ -0,0 +1,79 @@
+const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+export function encodeBase64(input) {
+    if (typeof globalThis.btoa === 'function') {
+        return globalThis.btoa(input);
+    }
+    const maybeBuffer = globalThis.Buffer;
+    if (maybeBuffer) {
+        return maybeBuffer.from(input, 'utf8').toString('base64');
+    }
+    const bytes = new TextEncoder().encode(input);
+    let output = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i] ?? 0;
+        const b = bytes[i + 1] ?? 0;
+        const c = bytes[i + 2] ?? 0;
+        const triple = (a << 16) | (b << 8) | c;
+        output += BASE64_CHARS[(triple >> 18) & 63];
+        output += BASE64_CHARS[(triple >> 12) & 63];
+        output += i + 1 < bytes.length ? BASE64_CHARS[(triple >> 6) & 63] : '=';
+        output += i + 2 < bytes.length ? BASE64_CHARS[triple & 63] : '=';
+    }
+    return output;
+}
+export function decodeBase64(input) {
+    const normalized = input.replace(/\s+/g, '');
+    if (typeof globalThis.atob === 'function') {
+        const raw = globalThis.atob(normalized);
+        const out = new Uint8Array(raw.length);
+        for (let i = 0; i < raw.length; i += 1) {
+            out[i] = raw.charCodeAt(i);
+        }
+        return out;
+    }
+    const maybeBuffer = globalThis.Buffer;
+    if (maybeBuffer) {
+        return Uint8Array.from(maybeBuffer.from(normalized, 'base64').values());
+    }
+    const padding = (4 - (normalized.length % 4 || 4)) % 4;
+    const base64 = normalized + '='.repeat(padding);
+    let bits = 0;
+    let bitCount = 0;
+    const output = [];
+    for (const char of base64) {
+        if (char === '=') {
+            break;
+        }
+        const value = BASE64_CHARS.indexOf(char);
+        if (value === -1) {
+            throw new Error(`Invalid base64 character: ${char}`);
+        }
+        bits = (bits << 6) | value;
+        bitCount += 6;
+        if (bitCount >= 8) {
+            bitCount -= 8;
+            output.push((bits >> bitCount) & 0xff);
+        }
+    }
+    return Uint8Array.from(output);
+}
+export function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map((value) => value.toString(16).padStart(2, '0'))
+        .join('');
+}
+export function hexToBytes(hex) {
+    const normalized = hex.trim().toLowerCase();
+    if (normalized.length % 2 !== 0) {
+        throw new Error('Invalid hex length');
+    }
+    if (!/^[0-9a-f]*$/.test(normalized)) {
+        throw new Error('Invalid hex characters');
+    }
+    const out = new Uint8Array(normalized.length / 2);
+    for (let i = 0; i < normalized.length; i += 2) {
+        out[i / 2] = Number.parseInt(normalized.slice(i, i + 2), 16);
+    }
+    return out;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/internal/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/internal/encoding.ts"],"names":[],"mappings":"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"}

package/dist/internal/http.d.ts

@@ -0,0 +1,19 @@
+import type { FetchLike } from '../types.js';
+export type QueryValue = string | number | boolean | null | undefined;
+export interface RequestArgs {
+    method?: string;
+    headers?: HeadersInit;
+    query?: Record<string, QueryValue>;
+    json?: unknown;
+    form?: Record<string, QueryValue>;
+    body?: BodyInit | null;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare function resolveFetch(customFetch?: FetchLike): FetchLike;
+export declare function buildUrl(baseUrl: string, path: string, query?: Record<string, QueryValue>): string;
+export declare function requestText(fetchFn: FetchLike, url: string, args?: RequestArgs): Promise<string>;
+export declare function requestJson<T>(fetchFn: FetchLike, url: string, args?: RequestArgs): Promise<T>;
+export declare function requestMaybeJson<T>(fetchFn: FetchLike, url: string, args?: RequestArgs): Promise<T | string>;
+export declare function toTimeoutMs(timeoutSeconds?: number): number | undefined;
+//# sourceMappingURL=http.d.ts.map

package/dist/internal/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/internal/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAU/D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAelG;AAgDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C1G;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAexG;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAYtH;AAED,wBAAgB,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE"}

package/dist/internal/http.js

@@ -0,0 +1,130 @@
+import { LniError } from '../errors.js';
+export function resolveFetch(customFetch) {
+    if (customFetch) {
+        return customFetch;
+    }
+    if (typeof globalThis.fetch === 'function') {
+        return globalThis.fetch.bind(globalThis);
+    }
+    throw new LniError('InvalidInput', 'No fetch implementation found. Pass fetch via NodeRequestOptions.');
+}
+export function buildUrl(baseUrl, path, query) {
+    const normalizedBase = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
+    const url = new URL(normalizedPath, normalizedBase);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined || value === null || value === '') {
+                continue;
+            }
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url.toString();
+}
+function encodeForm(form) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(form)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        params.set(key, String(value));
+    }
+    return params;
+}
+function withTimeout(signal, timeoutMs) {
+    if (!timeoutMs || timeoutMs <= 0) {
+        return signal;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    if (signal) {
+        if (signal.aborted) {
+            clearTimeout(timeoutId);
+            controller.abort();
+        }
+        else {
+            signal.addEventListener('abort', () => {
+                clearTimeout(timeoutId);
+                controller.abort();
+            }, { once: true });
+        }
+    }
+    controller.signal.addEventListener('abort', () => {
+        clearTimeout(timeoutId);
+    }, { once: true });
+    return controller.signal;
+}
+export async function requestText(fetchFn, url, args = {}) {
+    const headers = new Headers(args.headers);
+    let body = args.body;
+    if (args.json !== undefined) {
+        if (!headers.has('content-type')) {
+            headers.set('content-type', 'application/json');
+        }
+        body = JSON.stringify(args.json);
+    }
+    else if (args.form) {
+        if (!headers.has('content-type')) {
+            headers.set('content-type', 'application/x-www-form-urlencoded');
+        }
+        body = encodeForm(args.form).toString();
+    }
+    const signal = withTimeout(args.signal, args.timeoutMs);
+    let response;
+    try {
+        response = await fetchFn(url, {
+            method: args.method ?? (body ? 'POST' : 'GET'),
+            headers,
+            body,
+            signal,
+        });
+    }
+    catch (error) {
+        throw new LniError('NetworkError', `Network request failed: ${error?.message ?? 'unknown error'}`, {
+            cause: error,
+        });
+    }
+    const text = await response.text();
+    if (!response.ok) {
+        throw new LniError('Http', `HTTP ${response.status}: ${text || response.statusText}`, {
+            status: response.status,
+            body: text,
+        });
+    }
+    return text;
+}
+export async function requestJson(fetchFn, url, args = {}) {
+    const text = await requestText(fetchFn, url, args);
+    if (!text) {
+        return {};
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new LniError('Json', `Failed to parse JSON response: ${error?.message ?? 'unknown error'}`, {
+            body: text,
+            cause: error,
+        });
+    }
+}
+export async function requestMaybeJson(fetchFn, url, args = {}) {
+    const text = await requestText(fetchFn, url, args);
+    if (!text) {
+        return '';
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export function toTimeoutMs(timeoutSeconds) {
+    if (!timeoutSeconds || timeoutSeconds <= 0) {
+        return undefined;
+    }
+    return timeoutSeconds * 1000;
+}
+//# sourceMappingURL=http.js.map

package/dist/internal/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/internal/http.ts"],"names":[],"mappings":"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"}

package/dist/internal/polling.d.ts

@@ -0,0 +1,8 @@
+import type { InvoiceEventCallback, OnInvoiceEventParams, Transaction } from '../types.js';
+export interface PollInvoiceEventsArgs {
+    params: OnInvoiceEventParams;
+    lookup: () => Promise<Transaction>;
+    callback: InvoiceEventCallback;
+}
+export declare function pollInvoiceEvents(args: PollInvoiceEventsArgs): Promise<void>;
+//# sourceMappingURL=polling.d.ts.map

package/dist/internal/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/internal/polling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ3F,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBlF"}

package/dist/internal/polling.js

@@ -0,0 +1,26 @@
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export async function pollInvoiceEvents(args) {
+    const delayMs = Math.max(args.params.pollingDelaySec, 1) * 1000;
+    const maxDurationMs = Math.max(args.params.maxPollingSec, 1) * 1000;
+    const startedAt = Date.now();
+    while (Date.now() - startedAt <= maxDurationMs) {
+        try {
+            const tx = await args.lookup();
+            if (tx.settledAt > 0) {
+                args.callback('success', tx);
+                return;
+            }
+            args.callback('pending', tx);
+        }
+        catch {
+            args.callback('failure');
+        }
+        await sleep(delayMs);
+    }
+    args.callback('failure');
+}
+//# sourceMappingURL=polling.js.map

package/dist/internal/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/internal/polling.ts"],"names":[],"mappings":"AAEA,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAA2B;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC"}

package/dist/internal/transform.d.ts

@@ -0,0 +1,10 @@
+import type { NodeInfo, Transaction } from '../types.js';
+export declare function emptyNodeInfo(overrides?: Partial<NodeInfo>): NodeInfo;
+export declare function emptyTransaction(overrides?: Partial<Transaction>): Transaction;
+export declare function parseOptionalNumber(value: unknown): number;
+export declare function toUnixSeconds(value: unknown): number;
+export declare function rHashToHex(value: string): string;
+export declare function btcToMsats(amount: string | number): number;
+export declare function satsToMsats(amount: string | number): number;
+export declare function matchesSearch(tx: Transaction, search?: string): boolean;
+//# sourceMappingURL=transform.d.ts.map

package/dist/internal/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/internal/transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAiBzE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAelF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAM3D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAYvE"}

package/dist/internal/transform.js

@@ -0,0 +1,91 @@
+import { decodeBase64, bytesToHex } from './encoding.js';
+export function emptyNodeInfo(overrides = {}) {
+    return {
+        alias: '',
+        color: '',
+        pubkey: '',
+        network: '',
+        blockHeight: 0,
+        blockHash: '',
+        sendBalanceMsat: 0,
+        receiveBalanceMsat: 0,
+        feeCreditBalanceMsat: 0,
+        unsettledSendBalanceMsat: 0,
+        unsettledReceiveBalanceMsat: 0,
+        pendingOpenSendBalance: 0,
+        pendingOpenReceiveBalance: 0,
+        ...overrides,
+    };
+}
+export function emptyTransaction(overrides = {}) {
+    return {
+        type: '',
+        invoice: '',
+        description: '',
+        descriptionHash: '',
+        preimage: '',
+        paymentHash: '',
+        amountMsats: 0,
+        feesPaid: 0,
+        createdAt: 0,
+        expiresAt: 0,
+        settledAt: 0,
+        ...overrides,
+    };
+}
+export function parseOptionalNumber(value) {
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : 0;
+    }
+    if (typeof value === 'string') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : 0;
+    }
+    return 0;
+}
+export function toUnixSeconds(value) {
+    const parsed = parseOptionalNumber(value);
+    if (!parsed) {
+        return 0;
+    }
+    if (parsed > 10_000_000_000) {
+        return Math.floor(parsed / 1000);
+    }
+    return Math.floor(parsed);
+}
+export function rHashToHex(value) {
+    if (!value) {
+        return '';
+    }
+    try {
+        return bytesToHex(decodeBase64(value));
+    }
+    catch {
+        return value;
+    }
+}
+export function btcToMsats(amount) {
+    const num = typeof amount === 'string' ? Number(amount) : amount;
+    if (!Number.isFinite(num)) {
+        return 0;
+    }
+    return Math.round(num * 100_000_000_000);
+}
+export function satsToMsats(amount) {
+    const num = typeof amount === 'string' ? Number(amount) : amount;
+    if (!Number.isFinite(num)) {
+        return 0;
+    }
+    return Math.round(num * 1000);
+}
+export function matchesSearch(tx, search) {
+    if (!search) {
+        return true;
+    }
+    const normalized = search.toLowerCase();
+    return (tx.paymentHash.toLowerCase().includes(normalized) ||
+        tx.description.toLowerCase().includes(normalized) ||
+        (tx.payerNote ?? '').toLowerCase().includes(normalized) ||
+        tx.invoice.toLowerCase().includes(normalized));
+}
+//# sourceMappingURL=transform.js.map

package/dist/internal/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/internal/transform.ts"],"names":[],"mappings":"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"}

package/dist/lnurl.d.ts

@@ -0,0 +1,13 @@
+import type { FetchLike, PaymentInfo } from './types.js';
+export type PaymentDestinationType = 'bolt11' | 'bolt12' | 'lnurl' | 'lightning_address';
+export declare function detectPaymentType(destination: string): PaymentDestinationType;
+export declare function needsResolution(destination: string): boolean;
+export declare function lightningAddressToUrl(user: string, domain: string): string;
+export declare function decodeLnurl(lnurl: string): string;
+export declare function resolveToBolt11(destination: string, amountMsats?: number, options?: {
+    fetch?: FetchLike;
+}): Promise<string>;
+export declare function getPaymentInfo(destination: string, amountMsats?: number, options?: {
+    fetch?: FetchLike;
+}): Promise<PaymentInfo>;
+//# sourceMappingURL=lnurl.d.ts.map

package/dist/lnurl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lnurl.d.ts","sourceRoot":"","sources":["../src/lnurl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAqBzF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAqB7E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAejD;AAoED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAC9B,OAAO,CAAC,WAAW,CAAC,CAmCtB"}