@lntpay/sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## 0.1.0
+- Initial release with charges, withdrawals, webhooks, and TypeScript types.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LNTPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# @lntpay/sdk
+
+Official LNTPay SDK for Node.js (TypeScript-first).
+
+## Installation
+
+```bash
+npm install @lntpay/sdk
+```
+
+## Authentication
+
+```ts
+import LNTPay from "@lntpay/sdk";
+
+const client = new LNTPay({
+  apiKey: process.env.LNTPAY_API_KEY!
+});
+```
+
+## Create a charge (BOLT11)
+
+```ts
+const charge = await client.charges.create({
+  amount: 2500,
+  currency: "USD",
+  memo: "Coffee"
+});
+
+console.log(charge.bolt11);
+```
+
+## Create a withdrawal
+
+```ts
+const withdrawal = await client.withdrawals.create({
+  amount: 5000,
+  currency: "USD",
+  description: "Refund"
+});
+```
+
+## Webhook signature validation
+
+```ts
+import type { WebhookEvent } from "@lntpay/sdk";
+
+const rawBody = req.body; // Buffer
+const signatureHeader = req.headers["lntpay-signature"] as string;
+
+const event = client.webhooks.constructEvent<WebhookEvent>(
+  rawBody,
+  signatureHeader,
+  process.env.LNTPAY_WEBHOOK_SECRET!
+);
+
+console.log(event.type);
+```
+
+## Idempotency
+
+```ts
+await client.charges.create(
+  { amount: 1000, currency: "USD" },
+  { idempotencyKey: "charge-2026-02-02-0001" }
+);
+```
+
+## Request options and retries
+
+`RequestOptions` supports `retries` for GET requests only. POST retries are ignored.
+
+```ts
+const charge = await client.charges.retrieve("ch_123", { retries: 2 });
+```
+
+## Examples
+
+Examples live in `/examples`.
+
+```bash
+export LNTPAY_API_KEY="..."
+export LNTPAY_WEBHOOK_SECRET="..."
+# optional
+export LNTPAY_BASE_URL="https://api.lntpay.com"
+
+npm install
+npm run build
+node examples/node-pay-per-request.mjs
+```
+
+Webhook receiver example:
+
+```bash
+node examples/webhook-receiver.mjs
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,260 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LNTPay: () => LNTPay,
+  LNTPayAPIError: () => LNTPayAPIError,
+  LNTPayError: () => LNTPayError,
+  LNTPayNetworkError: () => LNTPayNetworkError,
+  LNTPayWebhookSignatureError: () => LNTPayWebhookSignatureError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var LNTPayError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LNTPayError";
+  }
+};
+var LNTPayAPIError = class extends LNTPayError {
+  status;
+  code;
+  type;
+  requestId;
+  raw;
+  constructor(message, status, opts) {
+    super(message);
+    this.name = "LNTPayAPIError";
+    this.status = status;
+    this.code = opts?.code;
+    this.type = opts?.type;
+    this.requestId = opts?.requestId;
+    this.raw = opts?.raw;
+  }
+};
+var LNTPayNetworkError = class extends LNTPayError {
+  constructor(message) {
+    super(message);
+    this.name = "LNTPayNetworkError";
+  }
+};
+var LNTPayWebhookSignatureError = class extends LNTPayError {
+  constructor(message) {
+    super(message);
+    this.name = "LNTPayWebhookSignatureError";
+  }
+};
+
+// src/internal/request.ts
+async function request(config, method, path, body, options = {}) {
+  const url = buildUrl(config.baseUrl, path);
+  const retries = method.toUpperCase() === "GET" ? Math.max(0, options.retries ?? 0) : 0;
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt += 1) {
+    try {
+      return await doFetch(config, method, url, body, options);
+    } catch (err) {
+      if (err instanceof LNTPayNetworkError && attempt < retries) {
+        lastError = err;
+        continue;
+      }
+      throw err;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new LNTPayNetworkError("Network error");
+}
+function buildUrl(baseUrl, path) {
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  return `${normalizedBase}${normalizedPath}`;
+}
+async function doFetch(config, method, url, body, options) {
+  const controller = new AbortController();
+  const timeoutMs = options.timeoutMs ?? config.timeoutMs;
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    "Content-Type": "application/json",
+    "User-Agent": config.userAgent,
+    ...options.headers
+  };
+  if (options.idempotencyKey) {
+    headers["Idempotency-Key"] = options.idempotencyKey;
+  }
+  if (options.requestId) {
+    headers["X-Request-Id"] = options.requestId;
+  }
+  const hasBody = body !== void 0 && method.toUpperCase() !== "GET";
+  const init = {
+    method,
+    headers,
+    signal: controller.signal
+  };
+  if (hasBody) {
+    init.body = JSON.stringify(body);
+  }
+  try {
+    const response = await fetch(url, init);
+    clearTimeout(timeout);
+    if (!response.ok) {
+      const errorPayload = await safeJson(response);
+      const { message, code, type, request_id } = normalizeError(errorPayload);
+      throw new LNTPayAPIError(message ?? `HTTP ${response.status}`, response.status, {
+        code,
+        type,
+        requestId: request_id,
+        raw: errorPayload
+      });
+    }
+    if (response.status === 204) {
+      return void 0;
+    }
+    try {
+      return await response.json();
+    } catch {
+      return void 0;
+    }
+  } catch (err) {
+    clearTimeout(timeout);
+    if (err instanceof LNTPayAPIError) {
+      throw err;
+    }
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new LNTPayNetworkError(`Request timed out after ${timeoutMs}ms`);
+    }
+    throw new LNTPayNetworkError("Network error");
+  }
+}
+async function safeJson(response) {
+  try {
+    return await response.json();
+  } catch {
+    return void 0;
+  }
+}
+function normalizeError(payload) {
+  const typed = payload;
+  if (typed?.error) {
+    return {
+      message: typed.error.message,
+      code: typed.error.code,
+      type: typed.error.type,
+      request_id: typed.error.request_id
+    };
+  }
+  return {};
+}
+
+// src/webhooks.ts
+var import_node_crypto = require("crypto");
+function verifySignature(rawBody, signatureHeader, secret) {
+  if (!signatureHeader || !secret) {
+    return false;
+  }
+  const payload = typeof rawBody === "string" ? Buffer.from(rawBody, "utf8") : rawBody;
+  const expected = (0, import_node_crypto.createHmac)("sha256", secret).update(payload).digest("hex");
+  const candidates = extractSignatures(signatureHeader);
+  for (const candidate of candidates) {
+    if (safeEqual(candidate, expected)) {
+      return true;
+    }
+  }
+  return false;
+}
+function constructEvent(rawBody, signatureHeader, secret) {
+  if (!verifySignature(rawBody, signatureHeader, secret)) {
+    throw new LNTPayWebhookSignatureError("Invalid webhook signature");
+  }
+  const body = typeof rawBody === "string" ? rawBody : rawBody.toString("utf8");
+  return JSON.parse(body);
+}
+function extractSignatures(signatureHeader) {
+  const trimmed = signatureHeader.trim();
+  if (trimmed.includes("v1=")) {
+    return trimmed.split(",").map((part) => part.trim()).filter((part) => part.startsWith("v1=")).map((part) => part.slice(3)).filter(Boolean);
+  }
+  return [trimmed];
+}
+function safeEqual(a, b) {
+  const aBuf = Buffer.from(a, "utf8");
+  const bBuf = Buffer.from(b, "utf8");
+  if (aBuf.length !== bBuf.length) {
+    return false;
+  }
+  return (0, import_node_crypto.timingSafeEqual)(aBuf, bBuf);
+}
+
+// src/index.ts
+var LNTPay = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  userAgent;
+  charges;
+  withdrawals;
+  webhooks;
+  constructor(config) {
+    if (!config?.apiKey) {
+      throw new LNTPayError("apiKey is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? "https://api.lntpay.com";
+    this.timeoutMs = config.timeoutMs ?? 3e4;
+    this.userAgent = config.userAgent ?? "@lntpay/sdk";
+    this.charges = {
+      create: (params, options) => this.request("POST", "/v0/charges", params, options),
+      retrieve: (chargeId, options) => this.request("GET", `/v0/charges/${encodeURIComponent(chargeId)}`, void 0, options)
+    };
+    this.withdrawals = {
+      create: (params, options) => this.request("POST", "/v0/withdrawals", params, options)
+    };
+    this.webhooks = {
+      verifySignature,
+      constructEvent
+    };
+  }
+  async request(method, path, body, options = {}) {
+    return request(
+      {
+        apiKey: this.apiKey,
+        baseUrl: this.baseUrl,
+        timeoutMs: this.timeoutMs,
+        userAgent: this.userAgent
+      },
+      method,
+      path,
+      body,
+      options
+    );
+  }
+};
+var index_default = LNTPay;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LNTPay,
+  LNTPayAPIError,
+  LNTPayError,
+  LNTPayNetworkError,
+  LNTPayWebhookSignatureError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/internal/request.ts","../src/webhooks.ts"],"sourcesContent":["import { request } from \"./internal/request\";\nimport { constructEvent, verifySignature } from \"./webhooks\";\nimport type {\n  Charge,\n  ChargeCreateParams,\n  LNTPayErrorResponse,\n  RequestOptions,\n  Withdrawal,\n  WithdrawalCreateParams,\n  WebhookEvent\n} from \"./types\";\nimport {\n  LNTPayAPIError,\n  LNTPayError,\n  LNTPayNetworkError,\n  LNTPayWebhookSignatureError\n} from \"./errors\";\n\nexport interface LNTPayConfig {\n  apiKey: string;\n  baseUrl?: string;\n  timeoutMs?: number;\n  userAgent?: string;\n}\n\nexport class LNTPay {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeoutMs: number;\n  private userAgent: string;\n\n  charges: {\n    create: (params: ChargeCreateParams, options?: RequestOptions) => Promise<Charge>;\n    retrieve: (chargeId: string, options?: RequestOptions) => Promise<Charge>;\n  };\n\n  withdrawals: {\n    create: (params: WithdrawalCreateParams, options?: RequestOptions) => Promise<Withdrawal>;\n  };\n\n  webhooks: {\n    verifySignature: (rawBody: string | Buffer, signatureHeader: string, secret: string) => boolean;\n    constructEvent: <T = WebhookEvent>(\n      rawBody: string | Buffer,\n      signatureHeader: string,\n      secret: string\n    ) => T;\n  };\n\n  constructor(config: LNTPayConfig) {\n    if (!config?.apiKey) {\n      throw new LNTPayError(\"apiKey is required\");\n    }\n\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? \"https://api.lntpay.com\";\n    this.timeoutMs = config.timeoutMs ?? 30_000;\n    this.userAgent = config.userAgent ?? \"@lntpay/sdk\";\n\n    this.charges = {\n      create: (params, options) => this.request<Charge>(\"POST\", \"/v0/charges\", params, options),\n      retrieve: (chargeId, options) =>\n        this.request<Charge>(\"GET\", `/v0/charges/${encodeURIComponent(chargeId)}`, undefined, options)\n    };\n\n    this.withdrawals = {\n      create: (params, options) => this.request<Withdrawal>(\"POST\", \"/v0/withdrawals\", params, options)\n    };\n\n    this.webhooks = {\n      verifySignature,\n      constructEvent\n    };\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    options: RequestOptions = {}\n  ): Promise<T> {\n    return request<T>(\n      {\n        apiKey: this.apiKey,\n        baseUrl: this.baseUrl,\n        timeoutMs: this.timeoutMs,\n        userAgent: this.userAgent\n      },\n      method,\n      path,\n      body,\n      options\n    );\n  }\n}\n\nexport {\n  Charge,\n  ChargeCreateParams,\n  RequestOptions,\n  LNTPayErrorResponse,\n  Withdrawal,\n  WithdrawalCreateParams,\n  WebhookEvent,\n  LNTPayAPIError,\n  LNTPayError,\n  LNTPayNetworkError,\n  LNTPayWebhookSignatureError\n};\n\nexport default LNTPay;\n","export class LNTPayError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LNTPayError\";\n  }\n}\n\nexport class LNTPayAPIError extends LNTPayError {\n  status: number;\n  code?: string;\n  type?: string;\n  requestId?: string;\n  raw?: unknown;\n\n  constructor(message: string, status: number, opts?: { code?: string; type?: string; requestId?: string; raw?: unknown }) {\n    super(message);\n    this.name = \"LNTPayAPIError\";\n    this.status = status;\n    this.code = opts?.code;\n    this.type = opts?.type;\n    this.requestId = opts?.requestId;\n    this.raw = opts?.raw;\n  }\n}\n\nexport class LNTPayNetworkError extends LNTPayError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LNTPayNetworkError\";\n  }\n}\n\nexport class LNTPayWebhookSignatureError extends LNTPayError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LNTPayWebhookSignatureError\";\n  }\n}\n","import { LNTPayAPIError, LNTPayNetworkError } from \"../errors\";\nimport type { LNTPayErrorResponse, RequestOptions } from \"../types\";\n\nexport interface ClientConfig {\n  apiKey: string;\n  baseUrl: string;\n  timeoutMs: number;\n  userAgent: string;\n}\n\nexport async function request<T>(\n  config: ClientConfig,\n  method: string,\n  path: string,\n  body?: unknown,\n  options: RequestOptions = {}\n): Promise<T> {\n  const url = buildUrl(config.baseUrl, path);\n  const retries = method.toUpperCase() === \"GET\" ? Math.max(0, options.retries ?? 0) : 0;\n\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= retries; attempt += 1) {\n    try {\n      return await doFetch<T>(config, method, url, body, options);\n    } catch (err) {\n      if (err instanceof LNTPayNetworkError && attempt < retries) {\n        lastError = err;\n        continue;\n      }\n      throw err;\n    }\n  }\n\n  throw lastError instanceof Error ? lastError : new LNTPayNetworkError(\"Network error\");\n}\n\nfunction buildUrl(baseUrl: string, path: string): string {\n  const normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${normalizedBase}${normalizedPath}`;\n}\n\nasync function doFetch<T>(\n  config: ClientConfig,\n  method: string,\n  url: string,\n  body: unknown,\n  options: RequestOptions\n): Promise<T> {\n  const controller = new AbortController();\n  const timeoutMs = options.timeoutMs ?? config.timeoutMs;\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  const headers: Record<string, string> = {\n    Authorization: `Bearer ${config.apiKey}`,\n    \"Content-Type\": \"application/json\",\n    \"User-Agent\": config.userAgent,\n    ...options.headers\n  };\n\n  if (options.idempotencyKey) {\n    headers[\"Idempotency-Key\"] = options.idempotencyKey;\n  }\n\n  if (options.requestId) {\n    headers[\"X-Request-Id\"] = options.requestId;\n  }\n\n  const hasBody = body !== undefined && method.toUpperCase() !== \"GET\";\n  const init: RequestInit = {\n    method,\n    headers,\n    signal: controller.signal\n  };\n\n  if (hasBody) {\n    init.body = JSON.stringify(body);\n  }\n\n  try {\n    const response = await fetch(url, init);\n    clearTimeout(timeout);\n\n    if (!response.ok) {\n      const errorPayload = await safeJson(response);\n      const { message, code, type, request_id } = normalizeError(errorPayload);\n      throw new LNTPayAPIError(message ?? `HTTP ${response.status}`, response.status, {\n        code,\n        type,\n        requestId: request_id,\n        raw: errorPayload\n      });\n    }\n\n    if (response.status === 204) {\n      return undefined as T;\n    }\n\n    try {\n      return (await response.json()) as T;\n    } catch {\n      return undefined as T;\n    }\n  } catch (err) {\n    clearTimeout(timeout);\n    if (err instanceof LNTPayAPIError) {\n      throw err;\n    }\n    if (err instanceof Error && err.name === \"AbortError\") {\n      throw new LNTPayNetworkError(`Request timed out after ${timeoutMs}ms`);\n    }\n    throw new LNTPayNetworkError(\"Network error\");\n  }\n}\n\nasync function safeJson(response: Response): Promise<unknown> {\n  try {\n    return await response.json();\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeError(payload: unknown): {\n  message?: string;\n  code?: string;\n  type?: string;\n  request_id?: string;\n} {\n  const typed = payload as LNTPayErrorResponse | undefined;\n  if (typed?.error) {\n    return {\n      message: typed.error.message,\n      code: typed.error.code,\n      type: typed.error.type,\n      request_id: typed.error.request_id\n    };\n  }\n  return {};\n}\n","import { timingSafeEqual, createHmac } from \"node:crypto\";\nimport { LNTPayWebhookSignatureError } from \"./errors\";\n\nexport function verifySignature(rawBody: string | Buffer, signatureHeader: string, secret: string): boolean {\n  if (!signatureHeader || !secret) {\n    return false;\n  }\n\n  const payload = typeof rawBody === \"string\" ? Buffer.from(rawBody, \"utf8\") : rawBody;\n  const expected = createHmac(\"sha256\", secret).update(payload).digest(\"hex\");\n  const candidates = extractSignatures(signatureHeader);\n\n  for (const candidate of candidates) {\n    if (safeEqual(candidate, expected)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function constructEvent<T>(\n  rawBody: string | Buffer,\n  signatureHeader: string,\n  secret: string\n): T {\n  if (!verifySignature(rawBody, signatureHeader, secret)) {\n    throw new LNTPayWebhookSignatureError(\"Invalid webhook signature\");\n  }\n\n  const body = typeof rawBody === \"string\" ? rawBody : rawBody.toString(\"utf8\");\n  return JSON.parse(body) as T;\n}\n\nfunction extractSignatures(signatureHeader: string): string[] {\n  const trimmed = signatureHeader.trim();\n  if (trimmed.includes(\"v1=\")) {\n    return trimmed\n      .split(\",\")\n      .map((part) => part.trim())\n      .filter((part) => part.startsWith(\"v1=\"))\n      .map((part) => part.slice(3))\n      .filter(Boolean);\n  }\n  return [trimmed];\n}\n\nfunction safeEqual(a: string, b: string): boolean {\n  const aBuf = Buffer.from(a, \"utf8\");\n  const bBuf = Buffer.from(b, \"utf8\");\n  if (aBuf.length !== bBuf.length) {\n    return false;\n  }\n  return timingSafeEqual(aBuf, bBuf);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,111 @@
+interface RequestOptions {
+    idempotencyKey?: string;
+    requestId?: string;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    retries?: number;
+}
+interface LNTPayErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        type?: string;
+        request_id?: string;
+    };
+}
+type ChargeStatus = "pending" | "paid" | "expired" | "canceled" | string;
+interface Charge {
+    id: string;
+    amount?: number;
+    currency?: string;
+    status?: ChargeStatus;
+    bolt11?: string;
+    created_at?: string;
+    expires_at?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ChargeCreateParams {
+    amount: number;
+    currency?: string;
+    memo?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+type WithdrawalStatus = "pending" | "paid" | "expired" | "canceled" | string;
+interface Withdrawal {
+    id: string;
+    amount?: number;
+    currency?: string;
+    status?: WithdrawalStatus;
+    lnurl?: string;
+    created_at?: string;
+    expires_at?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface WithdrawalCreateParams {
+    amount: number;
+    currency?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface WebhookEvent<T = unknown> {
+    id: string;
+    type: string;
+    data: T;
+    created_at?: string;
+    [key: string]: unknown;
+}
+
+declare class LNTPayError extends Error {
+    constructor(message: string);
+}
+declare class LNTPayAPIError extends LNTPayError {
+    status: number;
+    code?: string;
+    type?: string;
+    requestId?: string;
+    raw?: unknown;
+    constructor(message: string, status: number, opts?: {
+        code?: string;
+        type?: string;
+        requestId?: string;
+        raw?: unknown;
+    });
+}
+declare class LNTPayNetworkError extends LNTPayError {
+    constructor(message: string);
+}
+declare class LNTPayWebhookSignatureError extends LNTPayError {
+    constructor(message: string);
+}
+
+interface LNTPayConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+declare class LNTPay {
+    private apiKey;
+    private baseUrl;
+    private timeoutMs;
+    private userAgent;
+    charges: {
+        create: (params: ChargeCreateParams, options?: RequestOptions) => Promise<Charge>;
+        retrieve: (chargeId: string, options?: RequestOptions) => Promise<Charge>;
+    };
+    withdrawals: {
+        create: (params: WithdrawalCreateParams, options?: RequestOptions) => Promise<Withdrawal>;
+    };
+    webhooks: {
+        verifySignature: (rawBody: string | Buffer, signatureHeader: string, secret: string) => boolean;
+        constructEvent: <T = WebhookEvent>(rawBody: string | Buffer, signatureHeader: string, secret: string) => T;
+    };
+    constructor(config: LNTPayConfig);
+    private request;
+}
+
+export { type Charge, type ChargeCreateParams, LNTPay, LNTPayAPIError, type LNTPayConfig, LNTPayError, type LNTPayErrorResponse, LNTPayNetworkError, LNTPayWebhookSignatureError, type RequestOptions, type WebhookEvent, type Withdrawal, type WithdrawalCreateParams, LNTPay as default };

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+interface RequestOptions {
+    idempotencyKey?: string;
+    requestId?: string;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    retries?: number;
+}
+interface LNTPayErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        type?: string;
+        request_id?: string;
+    };
+}
+type ChargeStatus = "pending" | "paid" | "expired" | "canceled" | string;
+interface Charge {
+    id: string;
+    amount?: number;
+    currency?: string;
+    status?: ChargeStatus;
+    bolt11?: string;
+    created_at?: string;
+    expires_at?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ChargeCreateParams {
+    amount: number;
+    currency?: string;
+    memo?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+type WithdrawalStatus = "pending" | "paid" | "expired" | "canceled" | string;
+interface Withdrawal {
+    id: string;
+    amount?: number;
+    currency?: string;
+    status?: WithdrawalStatus;
+    lnurl?: string;
+    created_at?: string;
+    expires_at?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface WithdrawalCreateParams {
+    amount: number;
+    currency?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface WebhookEvent<T = unknown> {
+    id: string;
+    type: string;
+    data: T;
+    created_at?: string;
+    [key: string]: unknown;
+}
+
+declare class LNTPayError extends Error {
+    constructor(message: string);
+}
+declare class LNTPayAPIError extends LNTPayError {
+    status: number;
+    code?: string;
+    type?: string;
+    requestId?: string;
+    raw?: unknown;
+    constructor(message: string, status: number, opts?: {
+        code?: string;
+        type?: string;
+        requestId?: string;
+        raw?: unknown;
+    });
+}
+declare class LNTPayNetworkError extends LNTPayError {
+    constructor(message: string);
+}
+declare class LNTPayWebhookSignatureError extends LNTPayError {
+    constructor(message: string);
+}
+
+interface LNTPayConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+declare class LNTPay {
+    private apiKey;
+    private baseUrl;
+    private timeoutMs;
+    private userAgent;
+    charges: {
+        create: (params: ChargeCreateParams, options?: RequestOptions) => Promise<Charge>;
+        retrieve: (chargeId: string, options?: RequestOptions) => Promise<Charge>;
+    };
+    withdrawals: {
+        create: (params: WithdrawalCreateParams, options?: RequestOptions) => Promise<Withdrawal>;
+    };
+    webhooks: {
+        verifySignature: (rawBody: string | Buffer, signatureHeader: string, secret: string) => boolean;
+        constructEvent: <T = WebhookEvent>(rawBody: string | Buffer, signatureHeader: string, secret: string) => T;
+    };
+    constructor(config: LNTPayConfig);
+    private request;
+}
+
+export { type Charge, type ChargeCreateParams, LNTPay, LNTPayAPIError, type LNTPayConfig, LNTPayError, type LNTPayErrorResponse, LNTPayNetworkError, LNTPayWebhookSignatureError, type RequestOptions, type WebhookEvent, type Withdrawal, type WithdrawalCreateParams, LNTPay as default };

package/dist/index.js

@@ -0,0 +1,229 @@
+// src/errors.ts
+var LNTPayError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LNTPayError";
+  }
+};
+var LNTPayAPIError = class extends LNTPayError {
+  status;
+  code;
+  type;
+  requestId;
+  raw;
+  constructor(message, status, opts) {
+    super(message);
+    this.name = "LNTPayAPIError";
+    this.status = status;
+    this.code = opts?.code;
+    this.type = opts?.type;
+    this.requestId = opts?.requestId;
+    this.raw = opts?.raw;
+  }
+};
+var LNTPayNetworkError = class extends LNTPayError {
+  constructor(message) {
+    super(message);
+    this.name = "LNTPayNetworkError";
+  }
+};
+var LNTPayWebhookSignatureError = class extends LNTPayError {
+  constructor(message) {
+    super(message);
+    this.name = "LNTPayWebhookSignatureError";
+  }
+};
+
+// src/internal/request.ts
+async function request(config, method, path, body, options = {}) {
+  const url = buildUrl(config.baseUrl, path);
+  const retries = method.toUpperCase() === "GET" ? Math.max(0, options.retries ?? 0) : 0;
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt += 1) {
+    try {
+      return await doFetch(config, method, url, body, options);
+    } catch (err) {
+      if (err instanceof LNTPayNetworkError && attempt < retries) {
+        lastError = err;
+        continue;
+      }
+      throw err;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new LNTPayNetworkError("Network error");
+}
+function buildUrl(baseUrl, path) {
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  return `${normalizedBase}${normalizedPath}`;
+}
+async function doFetch(config, method, url, body, options) {
+  const controller = new AbortController();
+  const timeoutMs = options.timeoutMs ?? config.timeoutMs;
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    "Content-Type": "application/json",
+    "User-Agent": config.userAgent,
+    ...options.headers
+  };
+  if (options.idempotencyKey) {
+    headers["Idempotency-Key"] = options.idempotencyKey;
+  }
+  if (options.requestId) {
+    headers["X-Request-Id"] = options.requestId;
+  }
+  const hasBody = body !== void 0 && method.toUpperCase() !== "GET";
+  const init = {
+    method,
+    headers,
+    signal: controller.signal
+  };
+  if (hasBody) {
+    init.body = JSON.stringify(body);
+  }
+  try {
+    const response = await fetch(url, init);
+    clearTimeout(timeout);
+    if (!response.ok) {
+      const errorPayload = await safeJson(response);
+      const { message, code, type, request_id } = normalizeError(errorPayload);
+      throw new LNTPayAPIError(message ?? `HTTP ${response.status}`, response.status, {
+        code,
+        type,
+        requestId: request_id,
+        raw: errorPayload
+      });
+    }
+    if (response.status === 204) {
+      return void 0;
+    }
+    try {
+      return await response.json();
+    } catch {
+      return void 0;
+    }
+  } catch (err) {
+    clearTimeout(timeout);
+    if (err instanceof LNTPayAPIError) {
+      throw err;
+    }
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new LNTPayNetworkError(`Request timed out after ${timeoutMs}ms`);
+    }
+    throw new LNTPayNetworkError("Network error");
+  }
+}
+async function safeJson(response) {
+  try {
+    return await response.json();
+  } catch {
+    return void 0;
+  }
+}
+function normalizeError(payload) {
+  const typed = payload;
+  if (typed?.error) {
+    return {
+      message: typed.error.message,
+      code: typed.error.code,
+      type: typed.error.type,
+      request_id: typed.error.request_id
+    };
+  }
+  return {};
+}
+
+// src/webhooks.ts
+import { timingSafeEqual, createHmac } from "crypto";
+function verifySignature(rawBody, signatureHeader, secret) {
+  if (!signatureHeader || !secret) {
+    return false;
+  }
+  const payload = typeof rawBody === "string" ? Buffer.from(rawBody, "utf8") : rawBody;
+  const expected = createHmac("sha256", secret).update(payload).digest("hex");
+  const candidates = extractSignatures(signatureHeader);
+  for (const candidate of candidates) {
+    if (safeEqual(candidate, expected)) {
+      return true;
+    }
+  }
+  return false;
+}
+function constructEvent(rawBody, signatureHeader, secret) {
+  if (!verifySignature(rawBody, signatureHeader, secret)) {
+    throw new LNTPayWebhookSignatureError("Invalid webhook signature");
+  }
+  const body = typeof rawBody === "string" ? rawBody : rawBody.toString("utf8");
+  return JSON.parse(body);
+}
+function extractSignatures(signatureHeader) {
+  const trimmed = signatureHeader.trim();
+  if (trimmed.includes("v1=")) {
+    return trimmed.split(",").map((part) => part.trim()).filter((part) => part.startsWith("v1=")).map((part) => part.slice(3)).filter(Boolean);
+  }
+  return [trimmed];
+}
+function safeEqual(a, b) {
+  const aBuf = Buffer.from(a, "utf8");
+  const bBuf = Buffer.from(b, "utf8");
+  if (aBuf.length !== bBuf.length) {
+    return false;
+  }
+  return timingSafeEqual(aBuf, bBuf);
+}
+
+// src/index.ts
+var LNTPay = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  userAgent;
+  charges;
+  withdrawals;
+  webhooks;
+  constructor(config) {
+    if (!config?.apiKey) {
+      throw new LNTPayError("apiKey is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? "https://api.lntpay.com";
+    this.timeoutMs = config.timeoutMs ?? 3e4;
+    this.userAgent = config.userAgent ?? "@lntpay/sdk";
+    this.charges = {
+      create: (params, options) => this.request("POST", "/v0/charges", params, options),
+      retrieve: (chargeId, options) => this.request("GET", `/v0/charges/${encodeURIComponent(chargeId)}`, void 0, options)
+    };
+    this.withdrawals = {
+      create: (params, options) => this.request("POST", "/v0/withdrawals", params, options)
+    };
+    this.webhooks = {
+      verifySignature,
+      constructEvent
+    };
+  }
+  async request(method, path, body, options = {}) {
+    return request(
+      {
+        apiKey: this.apiKey,
+        baseUrl: this.baseUrl,
+        timeoutMs: this.timeoutMs,
+        userAgent: this.userAgent
+      },
+      method,
+      path,
+      body,
+      options
+    );
+  }
+};
+var index_default = LNTPay;
+export {
+  LNTPay,
+  LNTPayAPIError,
+  LNTPayError,
+  LNTPayNetworkError,
+  LNTPayWebhookSignatureError,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/internal/request.ts","../src/webhooks.ts","../src/index.ts"],"sourcesContent":["export class LNTPayError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LNTPayError\";\n  }\n}\n\nexport class LNTPayAPIError extends LNTPayError {\n  status: number;\n  code?: string;\n  type?: string;\n  requestId?: string;\n  raw?: unknown;\n\n  constructor(message: string, status: number, opts?: { code?: string; type?: string; requestId?: string; raw?: unknown }) {\n    super(message);\n    this.name = \"LNTPayAPIError\";\n    this.status = status;\n    this.code = opts?.code;\n    this.type = opts?.type;\n    this.requestId = opts?.requestId;\n    this.raw = opts?.raw;\n  }\n}\n\nexport class LNTPayNetworkError extends LNTPayError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LNTPayNetworkError\";\n  }\n}\n\nexport class LNTPayWebhookSignatureError extends LNTPayError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LNTPayWebhookSignatureError\";\n  }\n}\n","import { LNTPayAPIError, LNTPayNetworkError } from \"../errors\";\nimport type { LNTPayErrorResponse, RequestOptions } from \"../types\";\n\nexport interface ClientConfig {\n  apiKey: string;\n  baseUrl: string;\n  timeoutMs: number;\n  userAgent: string;\n}\n\nexport async function request<T>(\n  config: ClientConfig,\n  method: string,\n  path: string,\n  body?: unknown,\n  options: RequestOptions = {}\n): Promise<T> {\n  const url = buildUrl(config.baseUrl, path);\n  const retries = method.toUpperCase() === \"GET\" ? Math.max(0, options.retries ?? 0) : 0;\n\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= retries; attempt += 1) {\n    try {\n      return await doFetch<T>(config, method, url, body, options);\n    } catch (err) {\n      if (err instanceof LNTPayNetworkError && attempt < retries) {\n        lastError = err;\n        continue;\n      }\n      throw err;\n    }\n  }\n\n  throw lastError instanceof Error ? lastError : new LNTPayNetworkError(\"Network error\");\n}\n\nfunction buildUrl(baseUrl: string, path: string): string {\n  const normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${normalizedBase}${normalizedPath}`;\n}\n\nasync function doFetch<T>(\n  config: ClientConfig,\n  method: string,\n  url: string,\n  body: unknown,\n  options: RequestOptions\n): Promise<T> {\n  const controller = new AbortController();\n  const timeoutMs = options.timeoutMs ?? config.timeoutMs;\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  const headers: Record<string, string> = {\n    Authorization: `Bearer ${config.apiKey}`,\n    \"Content-Type\": \"application/json\",\n    \"User-Agent\": config.userAgent,\n    ...options.headers\n  };\n\n  if (options.idempotencyKey) {\n    headers[\"Idempotency-Key\"] = options.idempotencyKey;\n  }\n\n  if (options.requestId) {\n    headers[\"X-Request-Id\"] = options.requestId;\n  }\n\n  const hasBody = body !== undefined && method.toUpperCase() !== \"GET\";\n  const init: RequestInit = {\n    method,\n    headers,\n    signal: controller.signal\n  };\n\n  if (hasBody) {\n    init.body = JSON.stringify(body);\n  }\n\n  try {\n    const response = await fetch(url, init);\n    clearTimeout(timeout);\n\n    if (!response.ok) {\n      const errorPayload = await safeJson(response);\n      const { message, code, type, request_id } = normalizeError(errorPayload);\n      throw new LNTPayAPIError(message ?? `HTTP ${response.status}`, response.status, {\n        code,\n        type,\n        requestId: request_id,\n        raw: errorPayload\n      });\n    }\n\n    if (response.status === 204) {\n      return undefined as T;\n    }\n\n    try {\n      return (await response.json()) as T;\n    } catch {\n      return undefined as T;\n    }\n  } catch (err) {\n    clearTimeout(timeout);\n    if (err instanceof LNTPayAPIError) {\n      throw err;\n    }\n    if (err instanceof Error && err.name === \"AbortError\") {\n      throw new LNTPayNetworkError(`Request timed out after ${timeoutMs}ms`);\n    }\n    throw new LNTPayNetworkError(\"Network error\");\n  }\n}\n\nasync function safeJson(response: Response): Promise<unknown> {\n  try {\n    return await response.json();\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeError(payload: unknown): {\n  message?: string;\n  code?: string;\n  type?: string;\n  request_id?: string;\n} {\n  const typed = payload as LNTPayErrorResponse | undefined;\n  if (typed?.error) {\n    return {\n      message: typed.error.message,\n      code: typed.error.code,\n      type: typed.error.type,\n      request_id: typed.error.request_id\n    };\n  }\n  return {};\n}\n","import { timingSafeEqual, createHmac } from \"node:crypto\";\nimport { LNTPayWebhookSignatureError } from \"./errors\";\n\nexport function verifySignature(rawBody: string | Buffer, signatureHeader: string, secret: string): boolean {\n  if (!signatureHeader || !secret) {\n    return false;\n  }\n\n  const payload = typeof rawBody === \"string\" ? Buffer.from(rawBody, \"utf8\") : rawBody;\n  const expected = createHmac(\"sha256\", secret).update(payload).digest(\"hex\");\n  const candidates = extractSignatures(signatureHeader);\n\n  for (const candidate of candidates) {\n    if (safeEqual(candidate, expected)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function constructEvent<T>(\n  rawBody: string | Buffer,\n  signatureHeader: string,\n  secret: string\n): T {\n  if (!verifySignature(rawBody, signatureHeader, secret)) {\n    throw new LNTPayWebhookSignatureError(\"Invalid webhook signature\");\n  }\n\n  const body = typeof rawBody === \"string\" ? rawBody : rawBody.toString(\"utf8\");\n  return JSON.parse(body) as T;\n}\n\nfunction extractSignatures(signatureHeader: string): string[] {\n  const trimmed = signatureHeader.trim();\n  if (trimmed.includes(\"v1=\")) {\n    return trimmed\n      .split(\",\")\n      .map((part) => part.trim())\n      .filter((part) => part.startsWith(\"v1=\"))\n      .map((part) => part.slice(3))\n      .filter(Boolean);\n  }\n  return [trimmed];\n}\n\nfunction safeEqual(a: string, b: string): boolean {\n  const aBuf = Buffer.from(a, \"utf8\");\n  const bBuf = Buffer.from(b, \"utf8\");\n  if (aBuf.length !== bBuf.length) {\n    return false;\n  }\n  return timingSafeEqual(aBuf, bBuf);\n}\n","import { request } from \"./internal/request\";\nimport { constructEvent, verifySignature } from \"./webhooks\";\nimport type {\n  Charge,\n  ChargeCreateParams,\n  LNTPayErrorResponse,\n  RequestOptions,\n  Withdrawal,\n  WithdrawalCreateParams,\n  WebhookEvent\n} from \"./types\";\nimport {\n  LNTPayAPIError,\n  LNTPayError,\n  LNTPayNetworkError,\n  LNTPayWebhookSignatureError\n} from \"./errors\";\n\nexport interface LNTPayConfig {\n  apiKey: string;\n  baseUrl?: string;\n  timeoutMs?: number;\n  userAgent?: string;\n}\n\nexport class LNTPay {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeoutMs: number;\n  private userAgent: string;\n\n  charges: {\n    create: (params: ChargeCreateParams, options?: RequestOptions) => Promise<Charge>;\n    retrieve: (chargeId: string, options?: RequestOptions) => Promise<Charge>;\n  };\n\n  withdrawals: {\n    create: (params: WithdrawalCreateParams, options?: RequestOptions) => Promise<Withdrawal>;\n  };\n\n  webhooks: {\n    verifySignature: (rawBody: string | Buffer, signatureHeader: string, secret: string) => boolean;\n    constructEvent: <T = WebhookEvent>(\n      rawBody: string | Buffer,\n      signatureHeader: string,\n      secret: string\n    ) => T;\n  };\n\n  constructor(config: LNTPayConfig) {\n    if (!config?.apiKey) {\n      throw new LNTPayError(\"apiKey is required\");\n    }\n\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? \"https://api.lntpay.com\";\n    this.timeoutMs = config.timeoutMs ?? 30_000;\n    this.userAgent = config.userAgent ?? \"@lntpay/sdk\";\n\n    this.charges = {\n      create: (params, options) => this.request<Charge>(\"POST\", \"/v0/charges\", params, options),\n      retrieve: (chargeId, options) =>\n        this.request<Charge>(\"GET\", `/v0/charges/${encodeURIComponent(chargeId)}`, undefined, options)\n    };\n\n    this.withdrawals = {\n      create: (params, options) => this.request<Withdrawal>(\"POST\", \"/v0/withdrawals\", params, options)\n    };\n\n    this.webhooks = {\n      verifySignature,\n      constructEvent\n    };\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    options: RequestOptions = {}\n  ): Promise<T> {\n    return request<T>(\n      {\n        apiKey: this.apiKey,\n        baseUrl: this.baseUrl,\n        timeoutMs: this.timeoutMs,\n        userAgent: this.userAgent\n      },\n      method,\n      path,\n      body,\n      options\n    );\n  }\n}\n\nexport {\n  Charge,\n  ChargeCreateParams,\n  RequestOptions,\n  LNTPayErrorResponse,\n  Withdrawal,\n  WithdrawalCreateParams,\n  WebhookEvent,\n  LNTPayAPIError,\n  LNTPayError,\n  LNTPayNetworkError,\n  LNTPayWebhookSignatureError\n};\n\nexport default LNTPay;\n"],"mappings":";AAAO,IAAM,cAAN,cAA0B,MAAM;AAAA,EACrC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,iBAAN,cAA6B,YAAY;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,QAAgB,MAA4E;AACvH,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OAAO,MAAM;AAClB,SAAK,OAAO,MAAM;AAClB,SAAK,YAAY,MAAM;AACvB,SAAK,MAAM,MAAM;AAAA,EACnB;AACF;AAEO,IAAM,qBAAN,cAAiC,YAAY;AAAA,EAClD,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,8BAAN,cAA0C,YAAY;AAAA,EAC3D,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;AC3BA,eAAsB,QACpB,QACA,QACA,MACA,MACA,UAA0B,CAAC,GACf;AACZ,QAAM,MAAM,SAAS,OAAO,SAAS,IAAI;AACzC,QAAM,UAAU,OAAO,YAAY,MAAM,QAAQ,KAAK,IAAI,GAAG,QAAQ,WAAW,CAAC,IAAI;AAErF,MAAI;AACJ,WAAS,UAAU,GAAG,WAAW,SAAS,WAAW,GAAG;AACtD,QAAI;AACF,aAAO,MAAM,QAAW,QAAQ,QAAQ,KAAK,MAAM,OAAO;AAAA,IAC5D,SAAS,KAAK;AACZ,UAAI,eAAe,sBAAsB,UAAU,SAAS;AAC1D,oBAAY;AACZ;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,qBAAqB,QAAQ,YAAY,IAAI,mBAAmB,eAAe;AACvF;AAEA,SAAS,SAAS,SAAiB,MAAsB;AACvD,QAAM,iBAAiB,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI;AACtE,QAAM,iBAAiB,KAAK,WAAW,GAAG,IAAI,OAAO,IAAI,IAAI;AAC7D,SAAO,GAAG,cAAc,GAAG,cAAc;AAC3C;AAEA,eAAe,QACb,QACA,QACA,KACA,MACA,SACY;AACZ,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,YAAY,QAAQ,aAAa,OAAO;AAC9C,QAAM,UAAU,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAE9D,QAAM,UAAkC;AAAA,IACtC,eAAe,UAAU,OAAO,MAAM;AAAA,IACtC,gBAAgB;AAAA,IAChB,cAAc,OAAO;AAAA,IACrB,GAAG,QAAQ;AAAA,EACb;AAEA,MAAI,QAAQ,gBAAgB;AAC1B,YAAQ,iBAAiB,IAAI,QAAQ;AAAA,EACvC;AAEA,MAAI,QAAQ,WAAW;AACrB,YAAQ,cAAc,IAAI,QAAQ;AAAA,EACpC;AAEA,QAAM,UAAU,SAAS,UAAa,OAAO,YAAY,MAAM;AAC/D,QAAM,OAAoB;AAAA,IACxB;AAAA,IACA;AAAA,IACA,QAAQ,WAAW;AAAA,EACrB;AAEA,MAAI,SAAS;AACX,SAAK,OAAO,KAAK,UAAU,IAAI;AAAA,EACjC;AAEA,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,KAAK,IAAI;AACtC,iBAAa,OAAO;AAEpB,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,eAAe,MAAM,SAAS,QAAQ;AAC5C,YAAM,EAAE,SAAS,MAAM,MAAM,WAAW,IAAI,eAAe,YAAY;AACvE,YAAM,IAAI,eAAe,WAAW,QAAQ,SAAS,MAAM,IAAI,SAAS,QAAQ;AAAA,QAC9E;AAAA,QACA;AAAA,QACA,WAAW;AAAA,QACX,KAAK;AAAA,MACP,CAAC;AAAA,IACH;AAEA,QAAI,SAAS,WAAW,KAAK;AAC3B,aAAO;AAAA,IACT;AAEA,QAAI;AACF,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,SAAS,KAAK;AACZ,iBAAa,OAAO;AACpB,QAAI,eAAe,gBAAgB;AACjC,YAAM;AAAA,IACR;AACA,QAAI,eAAe,SAAS,IAAI,SAAS,cAAc;AACrD,YAAM,IAAI,mBAAmB,2BAA2B,SAAS,IAAI;AAAA,IACvE;AACA,UAAM,IAAI,mBAAmB,eAAe;AAAA,EAC9C;AACF;AAEA,eAAe,SAAS,UAAsC;AAC5D,MAAI;AACF,WAAO,MAAM,SAAS,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,eAAe,SAKtB;AACA,QAAM,QAAQ;AACd,MAAI,OAAO,OAAO;AAChB,WAAO;AAAA,MACL,SAAS,MAAM,MAAM;AAAA,MACrB,MAAM,MAAM,MAAM;AAAA,MAClB,MAAM,MAAM,MAAM;AAAA,MAClB,YAAY,MAAM,MAAM;AAAA,IAC1B;AAAA,EACF;AACA,SAAO,CAAC;AACV;;;AC3IA,SAAS,iBAAiB,kBAAkB;AAGrC,SAAS,gBAAgB,SAA0B,iBAAyB,QAAyB;AAC1G,MAAI,CAAC,mBAAmB,CAAC,QAAQ;AAC/B,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,OAAO,YAAY,WAAW,OAAO,KAAK,SAAS,MAAM,IAAI;AAC7E,QAAM,WAAW,WAAW,UAAU,MAAM,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK;AAC1E,QAAM,aAAa,kBAAkB,eAAe;AAEpD,aAAW,aAAa,YAAY;AAClC,QAAI,UAAU,WAAW,QAAQ,GAAG;AAClC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,eACd,SACA,iBACA,QACG;AACH,MAAI,CAAC,gBAAgB,SAAS,iBAAiB,MAAM,GAAG;AACtD,UAAM,IAAI,4BAA4B,2BAA2B;AAAA,EACnE;AAEA,QAAM,OAAO,OAAO,YAAY,WAAW,UAAU,QAAQ,SAAS,MAAM;AAC5E,SAAO,KAAK,MAAM,IAAI;AACxB;AAEA,SAAS,kBAAkB,iBAAmC;AAC5D,QAAM,UAAU,gBAAgB,KAAK;AACrC,MAAI,QAAQ,SAAS,KAAK,GAAG;AAC3B,WAAO,QACJ,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,CAAC,SAAS,KAAK,WAAW,KAAK,CAAC,EACvC,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,EAC3B,OAAO,OAAO;AAAA,EACnB;AACA,SAAO,CAAC,OAAO;AACjB;AAEA,SAAS,UAAU,GAAW,GAAoB;AAChD,QAAM,OAAO,OAAO,KAAK,GAAG,MAAM;AAClC,QAAM,OAAO,OAAO,KAAK,GAAG,MAAM;AAClC,MAAI,KAAK,WAAW,KAAK,QAAQ;AAC/B,WAAO;AAAA,EACT;AACA,SAAO,gBAAgB,MAAM,IAAI;AACnC;;;AC7BO,IAAM,SAAN,MAAa;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAER;AAAA,EAKA;AAAA,EAIA;AAAA,EASA,YAAY,QAAsB;AAChC,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,YAAY,oBAAoB;AAAA,IAC5C;AAEA,SAAK,SAAS,OAAO;AACrB,SAAK,UAAU,OAAO,WAAW;AACjC,SAAK,YAAY,OAAO,aAAa;AACrC,SAAK,YAAY,OAAO,aAAa;AAErC,SAAK,UAAU;AAAA,MACb,QAAQ,CAAC,QAAQ,YAAY,KAAK,QAAgB,QAAQ,eAAe,QAAQ,OAAO;AAAA,MACxF,UAAU,CAAC,UAAU,YACnB,KAAK,QAAgB,OAAO,eAAe,mBAAmB,QAAQ,CAAC,IAAI,QAAW,OAAO;AAAA,IACjG;AAEA,SAAK,cAAc;AAAA,MACjB,QAAQ,CAAC,QAAQ,YAAY,KAAK,QAAoB,QAAQ,mBAAmB,QAAQ,OAAO;AAAA,IAClG;AAEA,SAAK,WAAW;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,QACZ,QACA,MACA,MACA,UAA0B,CAAC,GACf;AACZ,WAAO;AAAA,MACL;AAAA,QACE,QAAQ,KAAK;AAAA,QACb,SAAS,KAAK;AAAA,QACd,WAAW,KAAK;AAAA,QAChB,WAAW,KAAK;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAgBA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@lntpay/sdk",
+  "version": "0.1.0",
+  "description": "Official LNTPay SDK for Node.js",
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/lntpay/lntpay-sdk.git" },
+  "homepage": "https://github.com/lntpay/lntpay-sdk#readme",
+  "bugs": { "url": "https://github.com/lntpay/lntpay-sdk/issues" },
+  "keywords": ["lightning", "bitcoin", "payments", "ln", "lntpay", "sdk"],
+  "publishConfig": { "access": "public" },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE", "CHANGELOG.md"],
+  "scripts": {
+    "build": "tsup",
+    "test": "npm run build && node -e \"const m=require('./dist/index.cjs'); if(!(m.LNTPay||m.default)) process.exit(1); console.log('ok');\"",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": { "node": ">=18" },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "tsup": "^8.0.1",
+    "typescript": "^5.4.5"
+  }
+}