aipp-node 1.0.1

package/dist/index.d.mts

@@ -0,0 +1,47 @@
+interface AippConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+interface ChargeParams {
+    amountSats: number;
+    memo?: string;
+}
+interface ChargeResponse {
+    payment_request: string;
+    payment_hash: string;
+    amount_sats: number;
+}
+interface ChargeStatus {
+    status: 'pending' | 'settled';
+    payment_hash: string;
+    amount_sats: number;
+}
+interface AippErrorResponse {
+    error: string;
+    code?: string;
+}
+interface PayoutResponse {
+    message: string;
+    amount_sats?: number;
+}
+
+declare class Aipp {
+    private apiKey;
+    private baseUrl;
+    constructor(config: AippConfig);
+    private request;
+    /**
+     * Creates a new Lightning Invoice
+     */
+    createCharge(params: ChargeParams): Promise<ChargeResponse>;
+    /**
+     * Checks the status of an existing charge
+     */
+    getCharge(paymentHash: string): Promise<ChargeStatus>;
+    /**
+     * Triggers a manual withdrawal of your merchant balance
+     */
+    payout(): Promise<PayoutResponse>;
+}
+
+export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type PayoutResponse };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+interface AippConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+interface ChargeParams {
+    amountSats: number;
+    memo?: string;
+}
+interface ChargeResponse {
+    payment_request: string;
+    payment_hash: string;
+    amount_sats: number;
+}
+interface ChargeStatus {
+    status: 'pending' | 'settled';
+    payment_hash: string;
+    amount_sats: number;
+}
+interface AippErrorResponse {
+    error: string;
+    code?: string;
+}
+interface PayoutResponse {
+    message: string;
+    amount_sats?: number;
+}
+
+declare class Aipp {
+    private apiKey;
+    private baseUrl;
+    constructor(config: AippConfig);
+    private request;
+    /**
+     * Creates a new Lightning Invoice
+     */
+    createCharge(params: ChargeParams): Promise<ChargeResponse>;
+    /**
+     * Checks the status of an existing charge
+     */
+    getCharge(paymentHash: string): Promise<ChargeStatus>;
+    /**
+     * Triggers a manual withdrawal of your merchant balance
+     */
+    payout(): Promise<PayoutResponse>;
+}
+
+export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type PayoutResponse };

package/dist/index.js

@@ -0,0 +1,95 @@
+"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, {
+  Aipp: () => Aipp
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var Aipp = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("AIPP: apiKey is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || "https://aipp.dev";
+  }
+  async request(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "X-Api-Key": this.apiKey,
+      ...options.headers
+    };
+    const response = await fetch(url, { ...options, headers });
+    if (!response.ok) {
+      let errorData;
+      try {
+        errorData = await response.json();
+      } catch (err) {
+        throw new Error(`AIPP API Error: ${response.status} ${response.statusText}`);
+      }
+      throw new Error(`AIPP API Error: ${errorData.error || response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Creates a new Lightning Invoice
+   */
+  async createCharge(params) {
+    if (!params.amountSats || params.amountSats <= 0) {
+      throw new Error("AIPP: amountSats must be greater than 0");
+    }
+    return this.request("/invoice/create", {
+      method: "POST",
+      body: JSON.stringify({
+        amount_sats: params.amountSats,
+        memo: params.memo
+      })
+    });
+  }
+  /**
+   * Checks the status of an existing charge
+   */
+  async getCharge(paymentHash) {
+    if (!paymentHash) {
+      throw new Error("AIPP: paymentHash is required");
+    }
+    return this.request(`/invoice/status/${paymentHash}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Triggers a manual withdrawal of your merchant balance
+   */
+  async payout() {
+    return this.request("/merchant/payout", {
+      method: "POST"
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Aipp
+});

package/dist/index.mjs

@@ -0,0 +1,68 @@
+// src/client.ts
+var Aipp = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("AIPP: apiKey is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || "https://aipp.dev";
+  }
+  async request(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "X-Api-Key": this.apiKey,
+      ...options.headers
+    };
+    const response = await fetch(url, { ...options, headers });
+    if (!response.ok) {
+      let errorData;
+      try {
+        errorData = await response.json();
+      } catch (err) {
+        throw new Error(`AIPP API Error: ${response.status} ${response.statusText}`);
+      }
+      throw new Error(`AIPP API Error: ${errorData.error || response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Creates a new Lightning Invoice
+   */
+  async createCharge(params) {
+    if (!params.amountSats || params.amountSats <= 0) {
+      throw new Error("AIPP: amountSats must be greater than 0");
+    }
+    return this.request("/invoice/create", {
+      method: "POST",
+      body: JSON.stringify({
+        amount_sats: params.amountSats,
+        memo: params.memo
+      })
+    });
+  }
+  /**
+   * Checks the status of an existing charge
+   */
+  async getCharge(paymentHash) {
+    if (!paymentHash) {
+      throw new Error("AIPP: paymentHash is required");
+    }
+    return this.request(`/invoice/status/${paymentHash}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Triggers a manual withdrawal of your merchant balance
+   */
+  async payout() {
+    return this.request("/merchant/payout", {
+      method: "POST"
+    });
+  }
+};
+export {
+  Aipp
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "aipp-node",
+  "version": "1.0.1",
+  "description": "Official Node.js SDK for AIPP - The Lightning Network Split-Payment Gateway",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "aipp",
+    "bitcoin",
+    "lightning",
+    "payments",
+    "l402",
+    "ai"
+  ],
+  "author": "AIPP",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aippde/aipp-key.git"
+  }
+}

package/src/client.ts

@@ -0,0 +1,74 @@
+import { AippConfig, ChargeParams, ChargeResponse, ChargeStatus, AippErrorResponse } from './types';
+
+export class Aipp {
+  private apiKey: string;
+  private baseUrl: string;
+
+  constructor(config: AippConfig) {
+    if (!config.apiKey) {
+      throw new Error('AIPP: apiKey is required');
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || 'https://aipp.dev';
+  }
+
+  private async request<T>(endpoint: string, options: RequestInit = {}): Promise<T> {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      'Content-Type': 'application/json',
+      'X-Api-Key': this.apiKey,
+      ...options.headers,
+    };
+
+    const response = await fetch(url, { ...options, headers });
+    
+    if (!response.ok) {
+      let errorData: AippErrorResponse;
+      try {
+        errorData = await response.json();
+      } catch (err) {
+        throw new Error(`AIPP API Error: ${response.status} ${response.statusText}`);
+      }
+      throw new Error(`AIPP API Error: ${errorData.error || response.statusText}`);
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  /**
+   * Creates a new Lightning Invoice
+   */
+  async createCharge(params: ChargeParams): Promise<ChargeResponse> {
+    if (!params.amountSats || params.amountSats <= 0) {
+      throw new Error('AIPP: amountSats must be greater than 0');
+    }
+    return this.request<ChargeResponse>('/invoice/create', {
+      method: 'POST',
+      body: JSON.stringify({
+        amount_sats: params.amountSats,
+        memo: params.memo,
+      }),
+    });
+  }
+
+  /**
+   * Checks the status of an existing charge
+   */
+  async getCharge(paymentHash: string): Promise<ChargeStatus> {
+    if (!paymentHash) {
+      throw new Error('AIPP: paymentHash is required');
+    }
+    return this.request<ChargeStatus>(`/invoice/status/${paymentHash}`, {
+      method: 'GET',
+    });
+  }
+
+  /**
+   * Triggers a manual withdrawal of your merchant balance
+   */
+  async payout(): Promise<import('./types').PayoutResponse> {
+    return this.request<import('./types').PayoutResponse>('/merchant/payout', {
+      method: 'POST',
+    });
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './client';
+export * from './types';

package/src/types.ts

@@ -0,0 +1,31 @@
+export interface AippConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+export interface ChargeParams {
+  amountSats: number;
+  memo?: string;
+}
+
+export interface ChargeResponse {
+  payment_request: string;
+  payment_hash: string;
+  amount_sats: number;
+}
+
+export interface ChargeStatus {
+  status: 'pending' | 'settled';
+  payment_hash: string;
+  amount_sats: number;
+}
+
+export interface AippErrorResponse {
+  error: string;
+  code?: string;
+}
+
+export interface PayoutResponse {
+  message: string;
+  amount_sats?: number;
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "module": "esnext",
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}