@profullstack/x402-gateway 0.10.1 → 0.10.2

package/README.md

@@ -18,7 +18,7 @@ npm install @profullstack/x402-gateway
 | --- | --- |
 | A person, Googlebot, Bingbot, Applebot, OAI-SearchBot, Claude-SearchBot, PerplexityBot… | the site, untouched |
 | GPTBot, ClaudeBot, CCBot, meta-externalagent, Bytespider, Applebot-Extended… | `402` with an x402 offer, or the HTML sales page if it asked for HTML |
-| Anyone at `/crawl` | the sales page (HTML) or the offer (JSON), and the place to pay |
+| Anyone at `/crawl` | the sales page (HTML, or always with `?format=html`) or the offer (JSON), and the place to pay. The 402 prose points at `/crawl?format=html`, so a client that sent no Accept header still reaches the explanation |
 | A request with a valid pass | the site |
 
 The sales page explains the price, how to pay with an x402 client, and how to pay with the CoinPay CLI:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/x402-gateway",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "type": "module",
   "description": "Sell crawl access to AI training crawlers by the day over x402, settled by CoinPay. One middleware: 402 with an offer, a sales page with CLI instructions, signed passes, Profullstack Power Keys honoured as a pass, and a robots.txt that keeps search crawlers welcome.",
   "keywords": [

package/src/index.js

@@ -106,6 +106,13 @@ export function createGateway(options = {}) {
   const money = (cents) => `${(cents / 100).toFixed(2)} ${o.currency}`;
   const price = money(o.priceCents);
   const buyUrl = `${o.siteUrl}${o.path}`;
+  /*
+   * Where the prose points. A bare GET of the sales page answers JSON, because
+   * the body is the only place an x402 client reads the offer from, so a
+   * pointer to it would loop for the reader who needs the explanation most.
+   * `?format=html` is the explainer whatever the Accept header says.
+   */
+  const howUrl = `${buyUrl}?format=html`;
 
   /**
    * How many terms a request is asking to buy: `?days=N`, clamped to
@@ -374,7 +381,7 @@ export function createGateway(options = {}) {
       );
     }
 
-    if (wantsHtml(request.headers.get('accept'))) {
+    if (wantsHtml(request.headers.get('accept')) || new URL(request.url).searchParams.get('format') === 'html') {
       return html(o.page(pageCtx(asked, usage, quota)), 402, rateHeaders);
     }
 
@@ -401,7 +408,7 @@ export function createGateway(options = {}) {
       );
     }
 
-    return json(receipt(asked, { error: `Payment required for training crawlers. Read ${buyUrl} for how.` }), 402);
+    return json(receipt(asked, { error: `Payment required for training crawlers. Read ${howUrl} for how.` }), 402);
   }
 
   /**
@@ -472,7 +479,7 @@ export function createGateway(options = {}) {
         if (!wantsHtml(request.headers.get('accept'))) {
           return json(
             receipt(1, {
-              error: `${path} is read in a browser (it sets a cookie with one line of script) or with a pass. Read ${buyUrl} for how.`,
+              error: `${path} is read in a browser (it sets a cookie with one line of script) or with a pass. Read ${howUrl} for how.`,
             }),
             402,
           );