@lnbot/l402 0.1.0

package/dist/types-FRMMn5ej.d.ts

@@ -0,0 +1,52 @@
+import { Request } from 'express';
+
+/** Data attached to `req.l402` after successful L402 verification. */
+interface L402RequestData {
+    paymentHash: string;
+    caveats: string[] | null;
+}
+declare global {
+    namespace Express {
+        interface Request {
+            l402?: L402RequestData;
+        }
+    }
+}
+/** Options for the `l402.paywall()` middleware. */
+interface L402PaywallOptions {
+    /** Price in satoshis — fixed number or async function receiving the request. */
+    price: number | ((req: Request) => number | Promise<number>);
+    /** Invoice memo / description. */
+    description?: string;
+    /** Challenge expiry in seconds. */
+    expirySeconds?: number;
+    /** Macaroon caveats to attach. */
+    caveats?: string[];
+}
+/** Options for the `l402.client()` factory. */
+interface L402ClientOptions {
+    /** Max sats to pay for a single request (default: 1000). */
+    maxPrice?: number;
+    /** Total budget in sats for the period. */
+    budgetSats?: number;
+    /** Budget reset period. */
+    budgetPeriod?: "hour" | "day" | "week" | "month";
+    /** Token cache strategy (default: "memory"). */
+    store?: "memory" | "none" | TokenStore;
+}
+/** Pluggable token cache. */
+interface TokenStore {
+    get(url: string): Promise<L402Token | null>;
+    set(url: string, token: L402Token): Promise<void>;
+    delete(url: string): Promise<void>;
+}
+/** A cached L402 credential. */
+interface L402Token {
+    macaroon: string;
+    preimage: string;
+    authorization: string;
+    paidAt: Date;
+    expiresAt?: Date;
+}
+
+export type { L402ClientOptions as L, TokenStore as T, L402PaywallOptions as a, L402RequestData as b, L402Token as c };

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@lnbot/l402",
+  "version": "0.1.0",
+  "description": "L402 Lightning payment middleware for Express.js — paywall any API in one line",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server/index.d.ts",
+        "default": "./dist/server/index.js"
+      },
+      "require": {
+        "types": "./dist/server/index.d.cts",
+        "default": "./dist/server/index.cjs"
+      }
+    },
+    "./client": {
+      "import": {
+        "types": "./dist/client/index.d.ts",
+        "default": "./dist/client/index.js"
+      },
+      "require": {
+        "types": "./dist/client/index.d.cts",
+        "default": "./dist/client/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@lnbot/sdk": ">=0.1.0",
+    "express": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@lnbot/sdk": "^0.5.0",
+    "@types/express": "^5",
+    "express": "^5",
+    "tsup": "^8",
+    "typescript": "^5",
+    "vitest": "^3"
+  },
+  "keywords": [
+    "l402",
+    "lightning",
+    "bitcoin",
+    "paywall",
+    "micropayments",
+    "402",
+    "payment-required",
+    "express",
+    "middleware",
+    "lnbot",
+    "api-monetization",
+    "ai-agents",
+    "pay-per-request"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lnbotdev/typescript-l402"
+  },
+  "license": "MIT"
+}