@weftlabs/sdk 0.25.0

package/examples/charge-api-hono.mjs

@@ -0,0 +1,40 @@
+import { Hono } from "hono";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+import { weftPaymentMiddlewareHono } from "@weftlabs/sdk/facilitator/middleware";
+
+const apiKey = process.env.WEFT_SELLER_API_KEY;
+if (!apiKey) {
+  throw new Error("Set WEFT_SELLER_API_KEY to a seller ax_live_* API key");
+}
+
+const payTo = process.env.WEFT_PAY_TO;
+if (!payTo) {
+  throw new Error("Set WEFT_PAY_TO to the wallet address that gets paid");
+}
+
+const network = process.env.WEFT_NETWORK ?? "eip155:8453";
+
+const app = new Hono();
+
+app.use(
+  weftPaymentMiddlewareHono(
+    {
+      "GET /v1/quote": {
+        accepts: { scheme: "exact", network, payTo, price: "$0.01" },
+      },
+    },
+    {
+      apiKey,
+      name: "Acme Pricing API",
+      type: "api",
+      tags: ["finance", "pricing"],
+      schemes: [{ network, server: new ExactEvmScheme() }],
+    },
+  ),
+);
+
+app.get("/v1/quote", (c) =>
+  c.json({ symbol: "ACME", price: "12.34", currency: "USD" }),
+);
+
+export default app;

package/examples/charge-api.mjs

@@ -0,0 +1,43 @@
+import express from "express";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+import { weftPaymentMiddleware } from "@weftlabs/sdk/facilitator/middleware";
+
+const apiKey = process.env.WEFT_SELLER_API_KEY;
+if (!apiKey) {
+  throw new Error("Set WEFT_SELLER_API_KEY to a seller ax_live_* API key");
+}
+
+const payTo = process.env.WEFT_PAY_TO;
+if (!payTo) {
+  throw new Error("Set WEFT_PAY_TO to the wallet address that gets paid");
+}
+
+const network = process.env.WEFT_NETWORK ?? "eip155:8453";
+
+const app = express();
+
+app.use(
+  weftPaymentMiddleware(
+    {
+      "GET /v1/quote": {
+        accepts: { scheme: "exact", network, payTo, price: "$0.01" },
+      },
+    },
+    {
+      apiKey,
+      name: "Acme Pricing API",
+      type: "api",
+      tags: ["finance", "pricing"],
+      schemes: [{ network, server: new ExactEvmScheme() }],
+    },
+  ),
+);
+
+app.get("/v1/quote", (_req, res) => {
+  res.json({ symbol: "ACME", price: "12.34", currency: "USD" });
+});
+
+const port = Number(process.env.PORT ?? 3000);
+app.listen(port, () => {
+  console.log(JSON.stringify({ listening: port }));
+});

package/examples/quickstart.mjs

@@ -0,0 +1,16 @@
+import { WeftClient } from "@weftlabs/sdk";
+
+const apiKey = process.env.WEFT_API_KEY;
+if (!apiKey) {
+  throw new Error("Set WEFT_API_KEY to a buyer wk_* API key");
+}
+
+const weft = new WeftClient({
+  apiKey,
+  ...(process.env.WEFT_BASE_URL ? { baseUrl: process.env.WEFT_BASE_URL } : {}),
+});
+
+const account = await weft.me();
+const search = await weft.search({ query: "weather data API" });
+
+console.log(JSON.stringify({ account: account.data, results: search.results }));

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@weftlabs/sdk",
+  "version": "0.25.0",
+  "description": "Unified Weft SDK for the Weft API and x402 Facilitator",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./facilitator": {
+      "import": {
+        "types": "./dist/facilitator/index.d.mts",
+        "default": "./dist/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/facilitator/index.d.ts",
+        "default": "./dist/facilitator/index.js"
+      }
+    },
+    "./facilitator/middleware": {
+      "import": {
+        "types": "./dist/facilitator/middleware/index.d.mts",
+        "default": "./dist/facilitator/middleware/index.mjs"
+      },
+      "require": {
+        "types": "./dist/facilitator/middleware/index.d.ts",
+        "default": "./dist/facilitator/middleware/index.js"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.mts",
+        "default": "./dist/server.mjs"
+      },
+      "require": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      }
+    }
+  },
+  "keywords": [
+    "weft",
+    "x402",
+    "payments",
+    "micropayments",
+    "coinbase",
+    "sdk"
+  ],
+  "author": "Weft Labs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/weftlabs/weft-sdk"
+  },
+  "peerDependencies": {
+    "@x402/core": "^2.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "@x402/core": "2.24.0",
+    "eslint": "^10.4.1",
+    "express": "^5.2.1",
+    "fast-check": "^4.8.0",
+    "hono": "^4.13.5",
+    "prettier": "3.9.6",
+    "tsup": "^8.4.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "lint": "eslint --fix",
+    "lint:check": "eslint",
+    "format": "prettier --write \"src/**/*.ts\" \"!src/generated/**\" \"examples/*.mjs\" \"../scripts/test-typescript-quickstarts.mjs\" \"../scripts/test-seller-quickstarts.mjs\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"!src/generated/**\" \"examples/*.mjs\" \"../scripts/test-typescript-quickstarts.mjs\" \"../scripts/test-seller-quickstarts.mjs\"",
+    "hooks:pre-push": "pnpm run lint:check && pnpm run format:check && vitest run",
+    "generate": "../scripts/generate-typescript.sh",
+    "smoke": "pnpm run build && node ../scripts/weft-smoke.mjs"
+  }
+}