aipp-node 1.1.0 → 1.2.1

package/src/types.ts

@@ -1,32 +1,86 @@
-export interface AippConfig {
-  apiKey: string;
-  baseUrl?: string;
-}
-
-export interface ChargeParams {
-  amountSats?: number;
-  amountUsd?: 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;
-}
+export interface AippConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+export interface ChargeParams {
+  amountSats?: number;
+  amountUsd?: number;
+  memo?: string;
+  protocol?: 'L402' | 'x402';
+}
+
+export interface ChargeResponse {
+  payment_hash: string;
+  protocol: 'L402' | 'x402';
+  amount_usd?: number;
+  pay_to?: string;
+  network?: string;
+  token?: string;
+  payment_request?: string; // For L402
+  amount_sats?: number; // For L402
+}
+
+export interface ChargeStatus {
+  paid: boolean;
+  status: 'pending' | 'settled';
+  preimage: string | null;
+}
+
+export interface AippErrorResponse {
+  error: string;
+  code?: string;
+}
+
+export interface PayoutResponse {
+  message: string;
+  amount_sats?: number;
+  amount_usd?: number;
+}
+
+export interface ReceiptCompliance {
+  regulation: string;
+  note: string;
+}
+
+export interface ReceiptFinancials {
+  currency: string;
+  total_amount: number;
+  merchant_amount: number;
+  platform_fee: number;
+}
+
+export interface ReceiptPaymentDetails {
+  protocol: string;
+  proof: string | null;
+  merchant_destination: string | null;
+}
+
+/** EU AI Act Article 26 compliant receipt for a settled invoice */
+export interface ReceiptResponse {
+  receipt_id: string;
+  transaction_id: string;
+  date: string;
+  status: string;
+  compliance: ReceiptCompliance;
+  payment_details: ReceiptPaymentDetails;
+  financials: ReceiptFinancials;
+}
+
+export interface MarketplaceTool {
+  name: string;
+  description: string;
+  priceUsdt: number;
+}
+
+/** PaidMCP.dev compatible manifest for listing on AI agent marketplaces */
+export interface MarketplaceManifest {
+  id: string;
+  name: string;
+  tagline: string;
+  description: string;
+  endpoint: string;
+  chains: string[];
+  tools: MarketplaceTool[];
+  tags: string[];
+}

package/tsconfig.json

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

package/dist/index.d.mts

@@ -1,58 +0,0 @@
-interface AippConfig {
-    apiKey: string;
-    baseUrl?: string;
-}
-interface ChargeParams {
-    amountSats?: number;
-    amountUsd?: 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>;
-}
-
-interface L402Options {
-    client: Aipp;
-    jwtSecret: string;
-    resourceId: string;
-    amountSats?: number;
-    amountUsd?: number;
-    expiresInSeconds?: number;
-}
-declare function l402Paywall(options: L402Options): (req: any, res: any, next: any) => Promise<any>;
-
-export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type L402Options, type PayoutResponse, l402Paywall };

package/dist/index.mjs

@@ -1,165 +0,0 @@
-// 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.amountUsd) {
-      throw new Error("AIPP: Either amountSats or amountUsd is required");
-    }
-    const body = { memo: params.memo };
-    if (params.amountSats) body.amount_sats = params.amountSats;
-    if (params.amountUsd) body.amount_usd = params.amountUsd;
-    return this.request("/invoice/create", {
-      method: "POST",
-      body: JSON.stringify(body)
-    });
-  }
-  /**
-   * 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"
-    });
-  }
-};
-
-// src/middleware.ts
-import crypto2 from "crypto";
-
-// src/jwt.ts
-import crypto from "crypto";
-function base64urlEncode(str) {
-  const buf = Buffer.isBuffer(str) ? str : Buffer.from(str);
-  return buf.toString("base64url");
-}
-function base64urlDecode(str) {
-  return Buffer.from(str, "base64url").toString("utf8");
-}
-function signJwt(payload, secret) {
-  const header = { alg: "HS256", typ: "JWT" };
-  const encodedHeader = base64urlEncode(JSON.stringify(header));
-  const encodedPayload = base64urlEncode(JSON.stringify(payload));
-  const data = `${encodedHeader}.${encodedPayload}`;
-  const signature = crypto.createHmac("sha256", secret).update(data).digest("base64url");
-  return `${data}.${signature}`;
-}
-function verifyJwt(token, secret) {
-  const parts = token.split(".");
-  if (parts.length !== 3) {
-    throw new Error("Invalid JWT format");
-  }
-  const [encodedHeader, encodedPayload, signature] = parts;
-  const data = `${encodedHeader}.${encodedPayload}`;
-  const expectedSignature = crypto.createHmac("sha256", secret).update(data).digest("base64url");
-  const signatureBuffer = Buffer.from(signature);
-  const expectedBuffer = Buffer.from(expectedSignature);
-  if (signatureBuffer.length !== expectedBuffer.length || !crypto.timingSafeEqual(signatureBuffer, expectedBuffer)) {
-    throw new Error("Invalid JWT signature");
-  }
-  const payload = JSON.parse(base64urlDecode(encodedPayload));
-  if (payload.exp && Date.now() >= payload.exp * 1e3) {
-    throw new Error("JWT expired");
-  }
-  return payload;
-}
-
-// src/middleware.ts
-function l402Paywall(options) {
-  if (!options.amountSats && !options.amountUsd) {
-    throw new Error("Either amountSats or amountUsd must be provided for l402Paywall");
-  }
-  return async (req, res, next) => {
-    const authHeader = req.headers.authorization || req.headers.Authorization;
-    let valid = false;
-    if (authHeader && typeof authHeader === "string" && authHeader.startsWith("L402 ")) {
-      const parts = authHeader.substring(5).split(":");
-      if (parts.length === 2) {
-        const [macaroonStr, preimage] = parts;
-        try {
-          const payload = verifyJwt(macaroonStr, options.jwtSecret);
-          if (payload.resource_id !== options.resourceId) {
-            throw new Error("Invalid resource");
-          }
-          const preimageHash = crypto2.createHash("sha256").update(Buffer.from(preimage, "hex")).digest("hex");
-          const expectedHash = payload.payment_hash;
-          if (typeof expectedHash === "string" && expectedHash.length === preimageHash.length && crypto2.timingSafeEqual(Buffer.from(preimageHash, "hex"), Buffer.from(expectedHash, "hex"))) {
-            valid = true;
-          }
-        } catch (e) {
-        }
-      }
-    }
-    if (valid) {
-      return next();
-    }
-    try {
-      const charge = await options.client.createCharge({
-        amountSats: options.amountSats,
-        amountUsd: options.amountUsd,
-        memo: `L402 Payment for ${options.resourceId}`
-      });
-      const expiresIn = options.expiresInSeconds || 3600;
-      const payload = {
-        payment_hash: charge.payment_hash,
-        resource_id: options.resourceId,
-        exp: Math.floor(Date.now() / 1e3) + expiresIn
-      };
-      const jwtToken = signJwt(payload, options.jwtSecret);
-      res.status(402);
-      res.setHeader("Www-Authenticate", `L402 macaroon="${jwtToken}" invoice="${charge.payment_request}"`);
-      res.json({
-        error: "Payment Required",
-        code: "L402",
-        payment_request: charge.payment_request,
-        macaroon: jwtToken
-      });
-    } catch (err) {
-      res.status(500).json({ error: "Failed to generate L402 challenge", details: err.message || err });
-    }
-  };
-}
-export {
-  Aipp,
-  l402Paywall
-};