@run402/sdk 4.121.0 → 4.122.0

package/dist/node/payment-offers.js

@@ -0,0 +1,145 @@
+/**
+ * Every payment a 402 offers, whichever protocol states it: x402 entries from
+ * `PAYMENT-REQUIRED`, MPP challenges from `WWW-Authenticate: Payment`. The
+ * wrong-rail error lists these and names the rail switch that would pay the
+ * first one (spec `tenant-x402-payment-client-surface`).
+ *
+ * Parsed without the paid stack: an x402-only install has no `mppx`, and the
+ * error still has to say what the seller wanted.
+ */
+const LNBTC_PREFIX = "lnbtc:";
+export function paymentOffers(response) {
+    return [...x402Offers(response), ...mppOffers(response)];
+}
+export function x402Offers(response) {
+    const header = response.headers.get("PAYMENT-REQUIRED");
+    if (!header)
+        return [];
+    try {
+        // base64url decoding accepts both alphabets, so it reads either seller encoding.
+        const decoded = JSON.parse(Buffer.from(header, "base64url").toString("utf8"));
+        if (!Array.isArray(decoded.accepts))
+            return [];
+        return decoded.accepts.flatMap((accept) => {
+            const entry = accept;
+            return typeof entry?.scheme === "string"
+                ? [{ protocol: "x402", method: entry.scheme, network: typeof entry.network === "string" ? entry.network : null }]
+                : [];
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/** The `Payment` challenges in `WWW-Authenticate`, with their decoded `request`. */
+export function mppChallenges(response) {
+    const header = response.headers.get("WWW-Authenticate");
+    if (!header)
+        return [];
+    return splitPaymentChallenges(header).flatMap((params) => {
+        if (!params.method || !params.intent)
+            return [];
+        return [{
+                ...(params.id ? { id: params.id } : {}),
+                method: params.method,
+                intent: params.intent,
+                request: decodeRequest(params.request),
+            }];
+    });
+}
+export function mppOffers(response) {
+    return mppChallenges(response).map((challenge) => ({
+        protocol: "mpp",
+        method: challenge.method,
+        intent: challenge.intent,
+        network: mppNetwork(challenge),
+    }));
+}
+/** `eip155:<chainId>` for a Tempo charge; the request's own network otherwise. */
+function mppNetwork(challenge) {
+    const details = challenge.request?.methodDetails;
+    if (challenge.method === "tempo" && (typeof details?.chainId === "number" || typeof details?.chainId === "string")) {
+        return `eip155:${String(details.chainId)}`;
+    }
+    return typeof details?.network === "string" ? details.network : null;
+}
+/** The rail that pays an offer: x402 EVM entries, MPP Tempo, and Lightning (either protocol). */
+export function railForOffer(offer) {
+    if (offer.method === "lightning" || offer.network?.startsWith(LNBTC_PREFIX))
+        return "lightning";
+    if (offer.protocol === "mpp")
+        return offer.method === "tempo" ? "mpp" : null;
+    return offer.method === "exact" ? "x402" : null;
+}
+/** The first offer's rail, when it is not the configured one. */
+export function switchRailFor(offers, configured) {
+    for (const offer of offers) {
+        const rail = railForOffer(offer);
+        if (rail && rail !== configured)
+            return rail;
+    }
+    return null;
+}
+/**
+ * RFC 9110 auth-params for every `Payment` scheme in the header. A header may
+ * carry several challenges, comma-joined; a new challenge starts where a
+ * scheme token is followed by a space instead of `=`.
+ */
+function splitPaymentChallenges(header) {
+    const challenges = [];
+    let index = 0;
+    while (index < header.length) {
+        index = skip(header, index, " \t,");
+        const token = readToken(header, index);
+        if (!token)
+            break;
+        index += token.length;
+        if (header[index] !== "=") {
+            challenges.push({ scheme: token.toLowerCase(), params: {} });
+            continue;
+        }
+        const current = challenges[challenges.length - 1];
+        const parsed = readParamValue(header, index + 1);
+        index = parsed.next;
+        if (current)
+            current.params[token.toLowerCase()] = parsed.value;
+    }
+    return challenges.filter((challenge) => challenge.scheme === "payment").map((challenge) => challenge.params);
+}
+function skip(value, index, chars) {
+    while (index < value.length && chars.includes(value[index]))
+        index += 1;
+    return index;
+}
+function readToken(value, index) {
+    const match = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+/.exec(value.slice(index));
+    return match ? match[0] : "";
+}
+function readParamValue(value, index) {
+    index = skip(value, index, " \t");
+    if (value[index] !== "\"") {
+        const token = /^[^,\s]*/.exec(value.slice(index))[0];
+        return { value: token, next: index + token.length };
+    }
+    let out = "";
+    let cursor = index + 1;
+    while (cursor < value.length && value[cursor] !== "\"") {
+        if (value[cursor] === "\\" && cursor + 1 < value.length)
+            cursor += 1;
+        out += value[cursor];
+        cursor += 1;
+    }
+    return { value: out, next: cursor + 1 };
+}
+function decodeRequest(encoded) {
+    if (!encoded)
+        return null;
+    try {
+        const value = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8"));
+        return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=payment-offers.js.map

package/dist/node/payment-offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-offers.js","sourceRoot":"","sources":["../../src/node/payment-offers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@run402/sdk",
-  "version": "4.121.0",
+  "version": "4.122.0",
   "description": "Typed TypeScript client for the Run402 API. Kernel shared by the run402-mcp server, the run402 CLI, and user-deployed run402 functions.",
   "type": "module",
   "main": "dist/index.js",