mppx 0.3.14 → 0.3.15

package/src/client/Mppx.test-d.ts

@@ -28,6 +28,15 @@ describe('Mppx', () => {
     expectTypeOf(mppx.createCredential).toBeFunction()
     expectTypeOf(mppx.createCredential).returns.toMatchTypeOf<Promise<string>>()
   })
+
+  test('has rawFetch with standard fetch signature', () => {
+    const method = charge({
+      account: {} as Account,
+    })
+    const mppx = Mppx.create({ methods: [method] })
+
+    expectTypeOf(mppx.rawFetch).toEqualTypeOf<typeof globalThis.fetch>()
+  })
 })
 
 describe('create.Config', () => {

package/src/client/Mppx.test.ts

@@ -28,6 +28,7 @@ describe('Mppx.create', () => {
     expect(mppx.transport.name).toBe('http')
     expect(typeof mppx.createCredential).toBe('function')
     expect(typeof mppx.fetch).toBe('function')
+    expect(typeof mppx.rawFetch).toBe('function')
   })
 
   test('behavior: with mcp transport', () => {
@@ -471,3 +472,80 @@ describe('restore', () => {
     expect(globalThis.fetch).toBe(originalFetch)
   })
 })
+
+describe('rawFetch', () => {
+  test('default: returns the original fetch when polyfill is enabled', () => {
+    const originalFetch = globalThis.fetch
+
+    const mppx = Mppx.create({
+      methods: [
+        tempo({
+          account: accounts[1],
+          getClient: () => client,
+        }),
+      ],
+    })
+
+    expect(globalThis.fetch).not.toBe(originalFetch)
+    expect(mppx.rawFetch).toBe(originalFetch)
+  })
+
+  test('behavior: returns the original fetch when polyfill is disabled', () => {
+    const originalFetch = globalThis.fetch
+
+    const mppx = Mppx.create({
+      polyfill: false,
+      methods: [
+        tempo({
+          account: accounts[1],
+          getClient: () => client,
+        }),
+      ],
+    })
+
+    expect(mppx.rawFetch).toBe(originalFetch)
+  })
+
+  test('behavior: returns custom fetch when provided', () => {
+    const customFetch = async () => new Response('custom')
+
+    const mppx = Mppx.create({
+      polyfill: false,
+      fetch: customFetch as typeof globalThis.fetch,
+      methods: [
+        tempo({
+          account: accounts[1],
+          getClient: () => client,
+        }),
+      ],
+    })
+
+    expect(mppx.rawFetch).toBe(customFetch)
+  })
+
+  test('behavior: rawFetch does not intercept 402 responses', async () => {
+    const mppx = Mppx.create({
+      methods: [
+        tempo({
+          account: accounts[1],
+          getClient: () => client,
+        }),
+      ],
+    })
+
+    const httpServer = await Http.createServer(async (req, res) => {
+      const result = await Mppx_server.toNodeListener(
+        server.charge({
+          amount: '1',
+        }),
+      )(req, res)
+      if (result.status === 402) return
+      res.end('OK')
+    })
+
+    const response = await mppx.rawFetch(httpServer.url)
+    expect(response.status).toBe(402)
+
+    httpServer.close()
+  })
+})

package/src/client/Mppx.ts

@@ -15,6 +15,8 @@ export type Mppx<
 > = {
   /** Payment-aware fetch function that automatically handles 402 responses. */
   fetch: Fetch.from.Fetch<FlattenMethods<methods>>
+  /** The original, unwrapped fetch function (pre-polyfill). Useful when you need to make requests that should not be intercepted (e.g. 402 probes for websocket auth). */
+  rawFetch: typeof globalThis.fetch
   /** Methods to configure. */
   methods: FlattenMethods<methods>
   /** The transport used. */
@@ -56,6 +58,8 @@ export function create<
 >(config: create.Config<methods, transport>): Mppx<methods, transport> {
   const { onChallenge, polyfill = true, transport = Transport.http() as transport } = config
 
+  const rawFetch = config.fetch ?? globalThis.fetch
+
   const methods = config.methods.flat() as unknown as FlattenMethods<methods>
 
   const resolvedOnChallenge = onChallenge as Fetch.from.Config<
@@ -71,6 +75,7 @@ export function create<
   if (polyfill) Fetch.polyfill(config_fetch)
   return {
     fetch,
+    rawFetch,
     methods,
     transport,
     async createCredential(response: Transport.ResponseOf<transport>, context?: unknown) {