x402check 0.0.1 → 0.1.0

package/dist/index.cjs

@@ -1824,9 +1824,101 @@ function runPipeline(input, options) {
 	};
 }
 
+//#endregion
+//#region src/extraction/extract.ts
+/**
+* Get a header value, case-insensitive.
+* Supports both Headers objects and plain Record<string, string>.
+*/
+function getHeader(headers, name) {
+	if (!headers) return null;
+	if (typeof headers.get === "function") return headers.get(name);
+	const lower = name.toLowerCase();
+	for (const key of Object.keys(headers)) if (key.toLowerCase() === lower) return headers[key];
+	return null;
+}
+/**
+* Decode base64 string to UTF-8 text.
+* Works in both browser (atob) and Node (Buffer).
+*/
+function decodeBase64(encoded) {
+	if (typeof atob === "function") return atob(encoded);
+	return Buffer.from(encoded, "base64").toString("utf-8");
+}
+/**
+* Check if a parsed object looks like it contains x402 config fields.
+*/
+function hasX402Fields(obj) {
+	if (!obj || typeof obj !== "object") return false;
+	const rec = obj;
+	return !!(rec.accepts || rec.payTo || rec.x402Version);
+}
+/**
+* Try to parse the PAYMENT-REQUIRED header value as a base64-encoded JSON config.
+*/
+function tryHeaderExtraction(headers) {
+	const headerValue = getHeader(headers, "payment-required");
+	if (!headerValue) return null;
+	try {
+		const decoded = decodeBase64(headerValue);
+		const parsed = JSON.parse(decoded);
+		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return {
+			config: parsed,
+			source: "header"
+		};
+	} catch {}
+	try {
+		const parsed = JSON.parse(headerValue);
+		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return {
+			config: parsed,
+			source: "header"
+		};
+	} catch {}
+	return null;
+}
+/**
+* Extract an x402 config from an HTTP 402 response.
+*
+* Extraction priority:
+* 1. JSON body — if it parses and has x402 fields (accepts, payTo, x402Version)
+* 2. PAYMENT-REQUIRED header — base64-decoded JSON fallback
+*
+* Never throws. Returns structured result with error message on failure.
+*
+* @param response - Response-like object with body and/or headers
+* @returns Extraction result with config, source, and error
+*/
+function extractConfig(response) {
+	const body = response.body;
+	if (body && typeof body === "object" && !Array.isArray(body) && hasX402Fields(body)) return {
+		config: body,
+		source: "body",
+		error: null
+	};
+	if (typeof body === "string" && body.trim()) try {
+		const parsed = JSON.parse(body);
+		if (parsed && typeof parsed === "object" && !Array.isArray(parsed) && hasX402Fields(parsed)) return {
+			config: parsed,
+			source: "body",
+			error: null
+		};
+	} catch {}
+	const headerResult = tryHeaderExtraction(response.headers);
+	if (headerResult) return {
+		config: headerResult.config,
+		source: headerResult.source,
+		error: null
+	};
+	return {
+		config: null,
+		source: null,
+		error: "No x402 config found in response body or PAYMENT-REQUIRED header"
+	};
+}
+
 //#endregion
 //#region src/index.ts
-const VERSION = "0.0.1";
+const VERSION = "0.1.0";
 
 //#endregion
 exports.CAIP2_REGEX = CAIP2_REGEX;
@@ -1838,6 +1930,7 @@ exports.SIMPLE_NAME_TO_CAIP2 = SIMPLE_NAME_TO_CAIP2;
 exports.VERSION = VERSION;
 exports.decodeBase58 = decodeBase58;
 exports.detect = detect;
+exports.extractConfig = extractConfig;
 exports.getAssetInfo = getAssetInfo;
 exports.getCanonicalNetwork = getCanonicalNetwork;
 exports.getNetworkInfo = getNetworkInfo;