@parallel-protocol/mpp 0.2.0 → 0.2.2

package/dist/express.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkRNM3RDKR_cjs = require('./chunk-RNM3RDKR.cjs');
-var chunkMEDPOLT4_cjs = require('./chunk-MEDPOLT4.cjs');
+var chunk76KPBYGA_cjs = require('./chunk-76KPBYGA.cjs');
 
 // src/express/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -27,15 +27,28 @@ var ExpressAdapter = class {
   getPath() {
     return this.req.path;
   }
+  getFullPath() {
+    return this.req.baseUrl + this.req.path;
+  }
   getUrl() {
     return `${this.req.protocol}://${this.req.headers.host}${this.req.originalUrl}`;
   }
   async runHandler() {
     const res = this.res;
     const next = this.next;
+    chunk76KPBYGA_cjs.dropConditionalHeaders(this.req.headers);
     const originalWriteHead = res.writeHead.bind(res);
     const originalWrite = res.write.bind(res);
     const originalEnd = res.end.bind(res);
+    const headersBefore = structuredClone(res.getHeaders());
+    const dropHandlerHeaders = () => {
+      for (const name of res.getHeaderNames())
+        if (!Object.hasOwn(headersBefore, name)) res.removeHeader(name);
+      for (const [name, value] of Object.entries(headersBefore))
+        if (value !== void 0) res.setHeader(name, value);
+      res.statusMessage = "";
+    };
+    const nodeWriters = Object.getPrototypeOf(res);
     const buffered = [];
     let settled = false;
     let discarded = false;
@@ -84,8 +97,17 @@ var ExpressAdapter = class {
         },
         sendResponse: () => {
           if (res.headersSent) return;
-          originalWriteHead(504, { "Content-Type": "application/json" });
-          originalEnd(TIMEOUT_BODY);
+          dropHandlerHeaders();
+          nodeWriters.writeHead.call(res, 504, {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(TIMEOUT_BODY)
+          });
+          nodeWriters.end.call(res, TIMEOUT_BODY, "utf8");
+          res.setHeader = (() => res);
+          res.setHeaders = (() => res);
+          res.appendHeader = (() => res);
+          res.removeHeader = () => {
+          };
         },
         discardResponse: () => {
         }
@@ -105,7 +127,9 @@ var ExpressAdapter = class {
       },
       discardResponse: () => {
         settled = true;
-        restore();
+        dropHandlerHeaders();
+        for (const name of ["writeHead", "write", "end"])
+          Reflect.deleteProperty(res, name);
       }
     };
   }
@@ -113,11 +137,12 @@ var ExpressAdapter = class {
 
 // src/express/index.ts
 function paymentMiddleware(config) {
-  const middleware = chunkMEDPOLT4_cjs.createMppPaymentMiddleware(config);
+  const middleware = chunk76KPBYGA_cjs.createMppPaymentMiddleware(config);
   return async (req, res, next) => {
     const result = await middleware(new ExpressAdapter(req, res, next));
     if ("pass" in result) {
       if (result.handlerRan) return;
+      if (result.preflight) chunk76KPBYGA_cjs.answerAsPreflight(res);
       return next();
     }
     for (const [key, value] of Object.entries(result.headers)) {

package/dist/express.d.cts

@@ -1,5 +1,5 @@
 import { Request, Response, NextFunction } from 'express';
-import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-CCE-FI8i.cjs';
+import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-BSzM92sD.cjs';
 import '@parallel-protocol/mpp-types';
 import 'viem';
 
@@ -11,6 +11,7 @@ declare class ExpressAdapter implements HTTPAdapter {
     getHeader(name: string): string | undefined;
     getMethod(): string;
     getPath(): string;
+    getFullPath(): string;
     getUrl(): string;
     runHandler(): Promise<RunHandlerResult>;
 }

package/dist/express.d.ts

@@ -1,5 +1,5 @@
 import { Request, Response, NextFunction } from 'express';
-import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-CCE-FI8i.js';
+import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-BSzM92sD.js';
 import '@parallel-protocol/mpp-types';
 import 'viem';
 
@@ -11,6 +11,7 @@ declare class ExpressAdapter implements HTTPAdapter {
     getHeader(name: string): string | undefined;
     getMethod(): string;
     getPath(): string;
+    getFullPath(): string;
     getUrl(): string;
     runHandler(): Promise<RunHandlerResult>;
 }

package/dist/express.js

@@ -1,5 +1,5 @@
 import { raceTimeout, HANDLER_TIMEOUT } from './chunk-DXHOWEAQ.js';
-import { createMppPaymentMiddleware } from './chunk-CQ62EEHN.js';
+import { dropConditionalHeaders, createMppPaymentMiddleware, answerAsPreflight } from './chunk-BYNIZG5S.js';
 
 // src/express/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -25,15 +25,28 @@ var ExpressAdapter = class {
   getPath() {
     return this.req.path;
   }
+  getFullPath() {
+    return this.req.baseUrl + this.req.path;
+  }
   getUrl() {
     return `${this.req.protocol}://${this.req.headers.host}${this.req.originalUrl}`;
   }
   async runHandler() {
     const res = this.res;
     const next = this.next;
+    dropConditionalHeaders(this.req.headers);
     const originalWriteHead = res.writeHead.bind(res);
     const originalWrite = res.write.bind(res);
     const originalEnd = res.end.bind(res);
+    const headersBefore = structuredClone(res.getHeaders());
+    const dropHandlerHeaders = () => {
+      for (const name of res.getHeaderNames())
+        if (!Object.hasOwn(headersBefore, name)) res.removeHeader(name);
+      for (const [name, value] of Object.entries(headersBefore))
+        if (value !== void 0) res.setHeader(name, value);
+      res.statusMessage = "";
+    };
+    const nodeWriters = Object.getPrototypeOf(res);
     const buffered = [];
     let settled = false;
     let discarded = false;
@@ -82,8 +95,17 @@ var ExpressAdapter = class {
         },
         sendResponse: () => {
           if (res.headersSent) return;
-          originalWriteHead(504, { "Content-Type": "application/json" });
-          originalEnd(TIMEOUT_BODY);
+          dropHandlerHeaders();
+          nodeWriters.writeHead.call(res, 504, {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(TIMEOUT_BODY)
+          });
+          nodeWriters.end.call(res, TIMEOUT_BODY, "utf8");
+          res.setHeader = (() => res);
+          res.setHeaders = (() => res);
+          res.appendHeader = (() => res);
+          res.removeHeader = () => {
+          };
         },
         discardResponse: () => {
         }
@@ -103,7 +125,9 @@ var ExpressAdapter = class {
       },
       discardResponse: () => {
         settled = true;
-        restore();
+        dropHandlerHeaders();
+        for (const name of ["writeHead", "write", "end"])
+          Reflect.deleteProperty(res, name);
       }
     };
   }
@@ -116,6 +140,7 @@ function paymentMiddleware(config) {
     const result = await middleware(new ExpressAdapter(req, res, next));
     if ("pass" in result) {
       if (result.handlerRan) return;
+      if (result.preflight) answerAsPreflight(res);
       return next();
     }
     for (const [key, value] of Object.entries(result.headers)) {

package/dist/fastify.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkMEDPOLT4_cjs = require('./chunk-MEDPOLT4.cjs');
+var chunk76KPBYGA_cjs = require('./chunk-76KPBYGA.cjs');
 var mppTypes = require('@parallel-protocol/mpp-types');
 
 // src/fastify/adapter.ts
@@ -25,25 +25,85 @@ var FastifyAdapter = class {
 };
 
 // src/fastify/index.ts
+function refuseRawResponse() {
+  throw new Error(
+    "mpp: raw responses are not supported on paid routes. Return the body from the handler so the payment can settle"
+  );
+}
+function keepCookiesBefore(reply, cookies) {
+  const raw = reply.raw;
+  const writeHead = raw.writeHead;
+  raw.writeHead = ((...args) => {
+    for (const arg of args)
+      if (typeof arg === "object" && arg !== null && !Array.isArray(arg))
+        delete arg["set-cookie"];
+    raw.removeHeader("set-cookie");
+    if (cookies !== void 0) raw.setHeader("set-cookie", cookies);
+    return writeHead.apply(raw, args);
+  });
+}
+function release(payload) {
+  if (payload instanceof ReadableStream) payload.cancel().catch(() => {
+  });
+  else if (typeof payload?.destroy === "function")
+    payload.destroy();
+}
+function restoreReply(reply, before) {
+  for (const name of Object.keys(reply.getHeaders())) reply.removeHeader(name);
+  for (const [name, value] of Object.entries(before.headers))
+    if (value !== void 0) reply.header(name, value);
+  for (const name of before.trailers) reply.removeTrailer(name);
+  for (const name of ["writeHead", "write", "end"])
+    Reflect.deleteProperty(reply.raw, name);
+  keepCookiesBefore(reply, before.headers["set-cookie"]);
+  reply.raw.statusMessage = "";
+}
 function paymentMiddleware(config) {
   return async (fastify) => {
-    const gate = chunkMEDPOLT4_cjs.createMppPaymentGate(config);
+    const gate = chunk76KPBYGA_cjs.createMppPaymentGate(config);
     const settleMap = /* @__PURE__ */ new WeakMap();
+    const replyBefore = /* @__PURE__ */ new WeakMap();
+    const rawWriters = /* @__PURE__ */ new WeakMap();
     fastify.addHook("onRequest", async (req, reply) => {
       const gateResult = await gate(new FastifyAdapter(req));
-      if (gateResult.type === "pass") return;
+      if (gateResult.type === "pass") {
+        if (gateResult.preflight) chunk76KPBYGA_cjs.answerAsPreflight(reply.raw);
+        return;
+      }
       if (gateResult.type === "error") {
         for (const [key, value] of Object.entries(gateResult.result.headers)) {
           reply.header(key, value);
         }
-        reply.status(gateResult.result.status).send(gateResult.result.body);
-        return;
+        return reply.status(gateResult.result.status).send(gateResult.result.body);
       }
       settleMap.set(req, gateResult.settle);
+      chunk76KPBYGA_cjs.dropConditionalHeaders(req.headers);
+      const trailers = /* @__PURE__ */ new Set();
+      const headers = structuredClone(reply.getHeaders());
+      replyBefore.set(req, { headers, trailers });
+      const trailer = reply.trailer.bind(reply);
+      reply.trailer = ((name, fn) => {
+        trailers.add(name.toLowerCase());
+        return trailer(name, fn);
+      });
+      const raw = reply.raw;
+      rawWriters.set(req, {
+        write: raw.write,
+        end: raw.end,
+        writeHead: raw.writeHead
+      });
+      raw.write = refuseRawResponse;
+      raw.end = refuseRawResponse;
+      raw.writeHead = refuseRawResponse;
     });
     fastify.addHook("onSend", async (req, reply, payload) => {
+      const writers = rawWriters.get(req);
+      if (writers) {
+        Object.assign(reply.raw, writers);
+        rawWriters.delete(req);
+      }
       const settle = settleMap.get(req);
-      if (!settle || !chunkMEDPOLT4_cjs.isSuccessStatus(reply.statusCode)) {
+      if (!settle || !chunk76KPBYGA_cjs.isSuccessStatus(reply.statusCode)) {
         return payload;
       }
       let settled = false;
@@ -60,7 +120,10 @@ function paymentMiddleware(config) {
       } catch {
       }
       if (!settled) {
-        const body = JSON.stringify(chunkMEDPOLT4_cjs.SETTLE_FAILURE_BODY);
+        release(payload);
+        const before = replyBefore.get(req);
+        if (before) restoreReply(reply, before);
+        const body = JSON.stringify(chunk76KPBYGA_cjs.SETTLE_FAILURE_BODY);
         reply.status(402);
         reply.header("Content-Type", "application/json");
         reply.header("Content-Length", Buffer.byteLength(body));

package/dist/fastify.d.cts

@@ -1,5 +1,5 @@
 import { FastifyRequest, FastifyPluginAsync } from 'fastify';
-import { H as HTTPAdapter, M as MppMiddlewareConfig } from './types-CCE-FI8i.cjs';
+import { H as HTTPAdapter, M as MppMiddlewareConfig } from './types-BSzM92sD.cjs';
 import '@parallel-protocol/mpp-types';
 import 'viem';
 

package/dist/fastify.d.ts

@@ -1,5 +1,5 @@
 import { FastifyRequest, FastifyPluginAsync } from 'fastify';
-import { H as HTTPAdapter, M as MppMiddlewareConfig } from './types-CCE-FI8i.js';
+import { H as HTTPAdapter, M as MppMiddlewareConfig } from './types-BSzM92sD.js';
 import '@parallel-protocol/mpp-types';
 import 'viem';
 

package/dist/fastify.js

@@ -1,4 +1,4 @@
-import { createMppPaymentGate, isSuccessStatus, SETTLE_FAILURE_BODY } from './chunk-CQ62EEHN.js';
+import { createMppPaymentGate, answerAsPreflight, dropConditionalHeaders, isSuccessStatus, SETTLE_FAILURE_BODY } from './chunk-BYNIZG5S.js';
 import { encodeBase64Url } from '@parallel-protocol/mpp-types';
 
 // src/fastify/adapter.ts
@@ -23,23 +23,83 @@ var FastifyAdapter = class {
 };
 
 // src/fastify/index.ts
+function refuseRawResponse() {
+  throw new Error(
+    "mpp: raw responses are not supported on paid routes. Return the body from the handler so the payment can settle"
+  );
+}
+function keepCookiesBefore(reply, cookies) {
+  const raw = reply.raw;
+  const writeHead = raw.writeHead;
+  raw.writeHead = ((...args) => {
+    for (const arg of args)
+      if (typeof arg === "object" && arg !== null && !Array.isArray(arg))
+        delete arg["set-cookie"];
+    raw.removeHeader("set-cookie");
+    if (cookies !== void 0) raw.setHeader("set-cookie", cookies);
+    return writeHead.apply(raw, args);
+  });
+}
+function release(payload) {
+  if (payload instanceof ReadableStream) payload.cancel().catch(() => {
+  });
+  else if (typeof payload?.destroy === "function")
+    payload.destroy();
+}
+function restoreReply(reply, before) {
+  for (const name of Object.keys(reply.getHeaders())) reply.removeHeader(name);
+  for (const [name, value] of Object.entries(before.headers))
+    if (value !== void 0) reply.header(name, value);
+  for (const name of before.trailers) reply.removeTrailer(name);
+  for (const name of ["writeHead", "write", "end"])
+    Reflect.deleteProperty(reply.raw, name);
+  keepCookiesBefore(reply, before.headers["set-cookie"]);
+  reply.raw.statusMessage = "";
+}
 function paymentMiddleware(config) {
   return async (fastify) => {
     const gate = createMppPaymentGate(config);
     const settleMap = /* @__PURE__ */ new WeakMap();
+    const replyBefore = /* @__PURE__ */ new WeakMap();
+    const rawWriters = /* @__PURE__ */ new WeakMap();
     fastify.addHook("onRequest", async (req, reply) => {
       const gateResult = await gate(new FastifyAdapter(req));
-      if (gateResult.type === "pass") return;
+      if (gateResult.type === "pass") {
+        if (gateResult.preflight) answerAsPreflight(reply.raw);
+        return;
+      }
       if (gateResult.type === "error") {
         for (const [key, value] of Object.entries(gateResult.result.headers)) {
           reply.header(key, value);
         }
-        reply.status(gateResult.result.status).send(gateResult.result.body);
-        return;
+        return reply.status(gateResult.result.status).send(gateResult.result.body);
       }
       settleMap.set(req, gateResult.settle);
+      dropConditionalHeaders(req.headers);
+      const trailers = /* @__PURE__ */ new Set();
+      const headers = structuredClone(reply.getHeaders());
+      replyBefore.set(req, { headers, trailers });
+      const trailer = reply.trailer.bind(reply);
+      reply.trailer = ((name, fn) => {
+        trailers.add(name.toLowerCase());
+        return trailer(name, fn);
+      });
+      const raw = reply.raw;
+      rawWriters.set(req, {
+        write: raw.write,
+        end: raw.end,
+        writeHead: raw.writeHead
+      });
+      raw.write = refuseRawResponse;
+      raw.end = refuseRawResponse;
+      raw.writeHead = refuseRawResponse;
     });
     fastify.addHook("onSend", async (req, reply, payload) => {
+      const writers = rawWriters.get(req);
+      if (writers) {
+        Object.assign(reply.raw, writers);
+        rawWriters.delete(req);
+      }
       const settle = settleMap.get(req);
       if (!settle || !isSuccessStatus(reply.statusCode)) {
         return payload;
@@ -58,6 +118,9 @@ function paymentMiddleware(config) {
       } catch {
       }
       if (!settled) {
+        release(payload);
+        const before = replyBefore.get(req);
+        if (before) restoreReply(reply, before);
         const body = JSON.stringify(SETTLE_FAILURE_BODY);
         reply.status(402);
         reply.header("Content-Type", "application/json");

package/dist/hono.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkRNM3RDKR_cjs = require('./chunk-RNM3RDKR.cjs');
-var chunkMEDPOLT4_cjs = require('./chunk-MEDPOLT4.cjs');
+var chunk76KPBYGA_cjs = require('./chunk-76KPBYGA.cjs');
 
 // src/hono/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -28,18 +28,20 @@ var HonoAdapter = class {
     return this.c.req.url;
   }
   async runHandler() {
+    const headersBefore = new Headers(this.c.res.headers);
+    const replace = (body, status) => {
+      const headers = new Headers(headersBefore);
+      if (body !== null) headers.set("Content-Type", "application/json");
+      this.c.res = void 0;
+      this.c.res = new Response(body, { status, headers });
+    };
     const outcome = await chunkRNM3RDKR_cjs.raceTimeout(this.next());
     if (outcome === chunkRNM3RDKR_cjs.HANDLER_TIMEOUT) {
       return {
         status: 504,
         setResponseHeader: () => {
         },
-        sendResponse: () => {
-          this.c.res = new Response(TIMEOUT_BODY, {
-            status: 504,
-            headers: { "Content-Type": "application/json" }
-          });
-        },
+        sendResponse: () => replace(TIMEOUT_BODY, 504),
         discardResponse: () => {
         }
       };
@@ -50,7 +52,11 @@ var HonoAdapter = class {
       setResponseHeader: (name, value) => res.headers.set(name, value),
       sendResponse: () => {
       },
+      // Cancel the body so its source stops, then drop the response.
       discardResponse: () => {
+        res.body?.cancel().catch(() => {
+        });
+        replace(null);
       }
     };
   }
@@ -58,15 +64,20 @@ var HonoAdapter = class {
 
 // src/hono/index.ts
 function paymentMiddleware(config) {
-  const middleware = chunkMEDPOLT4_cjs.createMppPaymentMiddleware(config);
+  const middleware = chunk76KPBYGA_cjs.createMppPaymentMiddleware(config);
   return async (c, next) => {
     const result = await middleware(new HonoAdapter(c, next));
     if ("pass" in result) {
       if (result.handlerRan) return;
       await next();
+      if (result.preflight) {
+        const init = chunk76KPBYGA_cjs.preflightInit(c.res);
+        c.res = void 0;
+        c.res = new Response(null, init);
+      }
       return;
     }
-    return new Response(JSON.stringify(result.body), {
+    c.res = new Response(JSON.stringify(result.body), {
       status: result.status,
       headers: { ...result.headers, "Content-Type": "application/json" }
     });

package/dist/hono.d.cts

@@ -1,5 +1,5 @@
 import { Context, Next, MiddlewareHandler } from 'hono';
-import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-CCE-FI8i.cjs';
+import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-BSzM92sD.cjs';
 import '@parallel-protocol/mpp-types';
 import 'viem';
 

package/dist/hono.d.ts

@@ -1,5 +1,5 @@
 import { Context, Next, MiddlewareHandler } from 'hono';
-import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-CCE-FI8i.js';
+import { H as HTTPAdapter, R as RunHandlerResult, M as MppMiddlewareConfig } from './types-BSzM92sD.js';
 import '@parallel-protocol/mpp-types';
 import 'viem';
 

package/dist/hono.js

@@ -1,5 +1,5 @@
 import { raceTimeout, HANDLER_TIMEOUT } from './chunk-DXHOWEAQ.js';
-import { createMppPaymentMiddleware } from './chunk-CQ62EEHN.js';
+import { createMppPaymentMiddleware, preflightInit } from './chunk-BYNIZG5S.js';
 
 // src/hono/adapter.ts
 var TIMEOUT_BODY = JSON.stringify({
@@ -26,18 +26,20 @@ var HonoAdapter = class {
     return this.c.req.url;
   }
   async runHandler() {
+    const headersBefore = new Headers(this.c.res.headers);
+    const replace = (body, status) => {
+      const headers = new Headers(headersBefore);
+      if (body !== null) headers.set("Content-Type", "application/json");
+      this.c.res = void 0;
+      this.c.res = new Response(body, { status, headers });
+    };
     const outcome = await raceTimeout(this.next());
     if (outcome === HANDLER_TIMEOUT) {
       return {
         status: 504,
         setResponseHeader: () => {
         },
-        sendResponse: () => {
-          this.c.res = new Response(TIMEOUT_BODY, {
-            status: 504,
-            headers: { "Content-Type": "application/json" }
-          });
-        },
+        sendResponse: () => replace(TIMEOUT_BODY, 504),
         discardResponse: () => {
         }
       };
@@ -48,7 +50,11 @@ var HonoAdapter = class {
       setResponseHeader: (name, value) => res.headers.set(name, value),
       sendResponse: () => {
       },
+      // Cancel the body so its source stops, then drop the response.
       discardResponse: () => {
+        res.body?.cancel().catch(() => {
+        });
+        replace(null);
       }
     };
   }
@@ -62,9 +68,14 @@ function paymentMiddleware(config) {
     if ("pass" in result) {
       if (result.handlerRan) return;
       await next();
+      if (result.preflight) {
+        const init = preflightInit(c.res);
+        c.res = void 0;
+        c.res = new Response(null, init);
+      }
       return;
     }
-    return new Response(JSON.stringify(result.body), {
+    c.res = new Response(JSON.stringify(result.body), {
       status: result.status,
       headers: { ...result.headers, "Content-Type": "application/json" }
     });

package/dist/index.cjs

@@ -1,57 +1,57 @@
 'use strict';
 
-var chunkMEDPOLT4_cjs = require('./chunk-MEDPOLT4.cjs');
+var chunk76KPBYGA_cjs = require('./chunk-76KPBYGA.cjs');
 var mppTypes = require('@parallel-protocol/mpp-types');
 
 
 
 Object.defineProperty(exports, "MPP_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.MPP_ERROR_CODES; }
+  get: function () { return chunk76KPBYGA_cjs.MPP_ERROR_CODES; }
 });
 Object.defineProperty(exports, "MppConfigError", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.MppConfigError; }
+  get: function () { return chunk76KPBYGA_cjs.MppConfigError; }
 });
 Object.defineProperty(exports, "MppFacilitatorClient", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.MppFacilitatorClient; }
+  get: function () { return chunk76KPBYGA_cjs.MppFacilitatorClient; }
 });
 Object.defineProperty(exports, "MppRuntimeError", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.MppRuntimeError; }
+  get: function () { return chunk76KPBYGA_cjs.MppRuntimeError; }
 });
 Object.defineProperty(exports, "buildChallenge", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.buildChallenge; }
+  get: function () { return chunk76KPBYGA_cjs.buildChallenge; }
 });
 Object.defineProperty(exports, "chainIdFromSlug", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.chainIdFromSlug; }
+  get: function () { return chunk76KPBYGA_cjs.chainIdFromSlug; }
 });
 Object.defineProperty(exports, "createMppPaymentGate", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.createMppPaymentGate; }
+  get: function () { return chunk76KPBYGA_cjs.createMppPaymentGate; }
 });
 Object.defineProperty(exports, "createMppPaymentMiddleware", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.createMppPaymentMiddleware; }
+  get: function () { return chunk76KPBYGA_cjs.createMppPaymentMiddleware; }
 });
 Object.defineProperty(exports, "matchRoute", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.matchRoute; }
+  get: function () { return chunk76KPBYGA_cjs.matchRoute; }
 });
 Object.defineProperty(exports, "parseAuthorizationHeader", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.parseAuthorizationHeader; }
+  get: function () { return chunk76KPBYGA_cjs.parseAuthorizationHeader; }
 });
 Object.defineProperty(exports, "parsePrice", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.parsePrice; }
+  get: function () { return chunk76KPBYGA_cjs.parsePrice; }
 });
 Object.defineProperty(exports, "serializeChallenge", {
   enumerable: true,
-  get: function () { return chunkMEDPOLT4_cjs.serializeChallenge; }
+  get: function () { return chunk76KPBYGA_cjs.serializeChallenge; }
 });
 Object.defineProperty(exports, "decodeBase64Url", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { MppChargeCredential } from '@parallel-protocol/mpp-types';
 export { MppChargeCredential, MppReceipt, decodeBase64Url, encodeBase64Url } from '@parallel-protocol/mpp-types';
-import { a as MppRouteConfig, b as MppFacilitatorConfig, c as MppSettleResult, M as MppMiddlewareConfig, H as HTTPAdapter, P as PaymentGateResult, d as MiddlewareResult, e as PassResult } from './types-CCE-FI8i.cjs';
-export { f as MppSettleFailure, g as MppSettleSuccess, R as RunHandlerResult } from './types-CCE-FI8i.cjs';
+import { a as MppRouteConfig, b as MppFacilitatorConfig, c as MppSettleResult, M as MppMiddlewareConfig, H as HTTPAdapter, P as PaymentGateResult, d as MiddlewareResult, e as PassResult } from './types-BSzM92sD.cjs';
+export { f as MppSettleFailure, g as MppSettleSuccess, R as RunHandlerResult } from './types-BSzM92sD.cjs';
 import 'viem';
 
 /** The challenge echoed back inside a credential (derived — mpp-types has no standalone export). */
@@ -39,6 +39,8 @@ declare const MPP_ERROR_CODES: {
     readonly FACILITATOR_UNAVAILABLE: "FACILITATOR_UNAVAILABLE";
     readonly FACILITATOR_INVALID_RESPONSE: "FACILITATOR_INVALID_RESPONSE";
     readonly INVALID_CREDENTIAL: "INVALID_CREDENTIAL";
+    /** A path with `.` or `..` segments on a paid route, refused with 400. */
+    readonly INVALID_PATH: "INVALID_PATH";
     readonly METHOD_MISMATCH: "METHOD_MISMATCH";
 };
 type MppErrorCode = (typeof MPP_ERROR_CODES)[keyof typeof MPP_ERROR_CODES];
@@ -50,13 +52,14 @@ declare class MppRuntimeError extends Error {
     constructor(code: string);
 }
 
-declare function createMppPaymentGate(config: MppMiddlewareConfig): (adapter: Pick<HTTPAdapter, "getHeader" | "getPath" | "getUrl" | "getMethod">) => Promise<PaymentGateResult>;
+declare function createMppPaymentGate(config: MppMiddlewareConfig): (adapter: Pick<HTTPAdapter, "getHeader" | "getPath" | "getFullPath" | "getUrl" | "getMethod">) => Promise<PaymentGateResult>;
 declare function createMppPaymentMiddleware(config: MppMiddlewareConfig): (adapter: HTTPAdapter) => Promise<MiddlewareResult | PassResult>;
 
 /** Parse a human price ("0.01") or pass a bigint through. Default 6 decimals (stablecoins). */
 declare function parsePrice(price: string | bigint, decimals?: number): bigint;
 /** Resolve an EVM chain id from a chain slug via the static catalogue. */
 declare function chainIdFromSlug(network: string): number | undefined;
+/** The route a request path falls under, see `findRoute`. */
 declare function matchRoute<T>(path: string, routes: Record<string, T>): T | undefined;
 
 export { HTTPAdapter, MPP_ERROR_CODES, MiddlewareResult, type MppChallenge, MppConfigError, type MppErrorCode, MppFacilitatorClient, MppFacilitatorConfig, MppMiddlewareConfig, MppRouteConfig, MppRuntimeError, MppSettleResult, PassResult, PaymentGateResult, buildChallenge, chainIdFromSlug, createMppPaymentGate, createMppPaymentMiddleware, matchRoute, parseAuthorizationHeader, parsePrice, serializeChallenge };