mppx 0.4.9 → 0.4.11

package/src/proxy/Service.ts

@@ -4,12 +4,14 @@ import { Value } from 'ox'
 export type Service = {
   /** Base URL of the upstream service (e.g. `'https://api.openai.com'`). */
   baseUrl: string
+  /** Free-form service categories for discovery metadata. */
+  categories?: string[] | undefined
   /** Short description of the service. */
   description?: string | undefined
+  /** Structured service documentation links for discovery metadata. */
+  docs?: Docs | undefined
   /** Unique identifier used as the URL prefix (e.g. `'openai'` → `/{id}/...`). */
   id: string
-  /** Returns a documentation URL. Called with no argument for the service root, or with a route pattern for per-endpoint docs. */
-  docsLlmsUrl?: ((options: { route?: string | undefined }) => string | undefined) | undefined
   /** Hook to modify the upstream request before sending (e.g. inject auth headers). */
   rewriteRequest?: ((req: Request, ctx: Context) => Request | Promise<Request>) | undefined
   /** Hook to modify the upstream response before returning to the client. */
@@ -20,6 +22,12 @@ export type Service = {
   title?: string | undefined
 }
 
+export type Docs = {
+  apiReference?: string | undefined
+  homepage?: string | undefined
+  llms?: string | undefined
+}
+
 /**
  * An endpoint definition.
  *
@@ -80,9 +88,10 @@ export function from<options = unknown>(id: string, config: from.Config<options>
   const rewriteFromConfig = resolveRewriteRequest(config)
   return {
     baseUrl: config.baseUrl,
+    categories: config.categories,
     description: config.description,
+    docs: resolveDocs(config),
     id,
-    docsLlmsUrl: resolveLlmsUrl(config.docsLlmsUrl),
     routes: config.routes,
     title: config.title,
     rewriteRequest: config.rewriteRequest
@@ -102,8 +111,12 @@ export declare namespace from {
     baseUrl: string
     /** Shorthand: inject `Authorization: Bearer {token}` header. */
     bearer?: string | undefined
+    /** Free-form service categories for discovery metadata. */
+    categories?: string[] | undefined
     /** Short description of the service. */
     description?: string | undefined
+    /** Structured service documentation links for discovery metadata. */
+    docs?: Docs | undefined
     /** Shorthand: inject custom headers. */
     headers?: Record<string, string> | undefined
     /** Documentation URL for the service. String for a static base URL, or a function receiving an optional endpoint pattern. */
@@ -157,32 +170,14 @@ function resolveRewriteRequest(
   return undefined
 }
 
-/** Serializes a service for discovery responses. */
-export function serialize(s: Service) {
-  return {
-    description: s.description,
-    id: s.id,
-    docsLlmsUrl: s.docsLlmsUrl?.({}),
-    routes: Object.entries(s.routes).map(([pattern, endpoint]) => {
-      const tokens = pattern.trim().split(/\s+/)
-      const hasMethod = tokens.length >= 2
-      const path = hasMethod ? tokens.slice(1).join(' ') : tokens[0]
-      return {
-        docsLlmsUrl: s.docsLlmsUrl?.({ route: pattern }),
-        method: hasMethod ? tokens[0] : undefined,
-        path: `/${s.id}${path}`,
-        pattern: hasMethod ? `${tokens[0]} /${s.id}${path}` : `/${s.id}${path}`,
-        payment: endpoint ? resolvePayment(endpoint) : null,
-      }
-    }),
-    title: s.title,
-  }
-}
-
 /** Renders an llms.txt markdown string for a list of services. */
 export function toLlmsTxt(
   services: Service[],
-  options?: { title?: string | undefined; description?: string | undefined },
+  options?: {
+    description?: string | undefined
+    openApiPath?: string | undefined
+    title?: string | undefined
+  },
 ): string {
   const lines: string[] = [
     `# ${options?.title ?? 'API Proxy'}`,
@@ -197,65 +192,13 @@ export function toLlmsTxt(
   for (const s of services) {
     const label = s.title ?? s.id
     const desc = s.description ? `: ${s.description}` : ''
-    lines.push(`- [${label}](/discover/${s.id}.md)${desc}`)
+    lines.push(`- ${label}${desc}`)
   }
-  lines.push('', '[See all service definitions](/discover/all.md)')
+  lines.push('', `[OpenAPI discovery](${options?.openApiPath ?? '/openapi.json'})`)
 
   return lines.join('\n')
 }
 
-/** Renders a full markdown listing of all services with their routes. */
-export function toServicesMarkdown(services: Service[]): string {
-  const lines: string[] = ['# Services', '']
-
-  if (services.length === 0) return lines.join('\n')
-
-  for (const s of services) {
-    lines.push(`## [${s.title ?? s.id}](/discover/${s.id}.md)`, '')
-    if (s.description) lines.push(s.description, '')
-    pushRoutes(lines, s)
-  }
-
-  return lines.join('\n')
-}
-
-/** Renders a markdown string for a single service. */
-export function toMarkdown(s: Service): string {
-  const docsLlmsUrl = s.docsLlmsUrl?.({})
-  const lines: string[] = [`# ${s.title ?? s.id}`, '']
-  if (docsLlmsUrl) lines.push(`> Documentation: ${docsLlmsUrl}`, '')
-  if (s.description) lines.push(s.description, '')
-  pushRoutes(lines, s, '##')
-  return lines.join('\n')
-}
-
-function pushRoutes(lines: string[], s: Service, heading: '##' | '###' = '###') {
-  lines.push(`${heading} Routes`, '')
-  const serialized = serialize(s)
-  for (const route of serialized.routes) {
-    const p = route.payment as Record<string, unknown> | null
-    const desc = p?.description ? `: ${p.description}` : ''
-    lines.push(`- \`${route.pattern}\`${desc}`)
-    if (!p) {
-      lines.push('  - Type: free')
-    } else {
-      lines.push(`  - Type: ${p.intent}`)
-      if (p.amount) {
-        const perUnit = p.unitType ? `/${p.unitType}` : ''
-        if (p.decimals !== undefined) {
-          const price = Number(p.amount) / 10 ** Number(p.decimals)
-          lines.push(`  - Price: ${price}${perUnit} (${p.amount} units, ${p.decimals} decimals)`)
-        } else {
-          lines.push(`  - Units: ${p.amount}${perUnit}`)
-        }
-      }
-      if (p.currency) lines.push(`  - Currency: ${p.currency}`)
-    }
-    if (route.docsLlmsUrl) lines.push(`  - Docs: ${route.docsLlmsUrl}`)
-    lines.push('')
-  }
-}
-
 /** Extracts per-endpoint options from an endpoint definition. */
 export function getOptions(endpoint: Endpoint): EndpointOptions | undefined {
   if (typeof endpoint === 'object' && endpoint !== null && 'options' in endpoint)
@@ -263,10 +206,10 @@ export function getOptions(endpoint: Endpoint): EndpointOptions | undefined {
   return undefined
 }
 
-function resolvePayment(endpoint: Endpoint): Record<string, unknown> | null {
+export function paymentOf(endpoint: Endpoint): Record<string, unknown> | null {
   if (endpoint === true) return null
   const handler = typeof endpoint === 'function' ? endpoint : endpoint.pay
-  if (!('_internal' in handler)) return {}
+  if (!('_internal' in handler)) return null
   const {
     name,
     intent,
@@ -283,10 +226,21 @@ function resolvePayment(endpoint: Endpoint): Record<string, unknown> | null {
   return { intent, method: name, ...rest, ...(amount !== undefined && { amount }) }
 }
 
-function resolveLlmsUrl(
+function resolveDocs(config: from.Config): Docs | undefined {
+  if (config.docs) {
+    return {
+      ...config.docs,
+      ...(config.docs.llms ? {} : { llms: resolveLlmsFromLegacy(config.docsLlmsUrl) }),
+    }
+  }
+  const llms = resolveLlmsFromLegacy(config.docsLlmsUrl)
+  return llms ? { llms } : undefined
+}
+
+function resolveLlmsFromLegacy(
   input: string | ((options: { route?: string | undefined }) => string | undefined) | undefined,
-): Service['docsLlmsUrl'] {
+): string | undefined {
   if (!input) return undefined
-  if (typeof input === 'function') return input
-  return ({ route }) => (route ? undefined : input)
+  if (typeof input === 'string') return input
+  return input({}) ?? undefined
 }

package/src/proxy/internal/Headers.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test } from 'vp/test'
 
 import * as Headers from './Headers.js'
 

package/src/proxy/internal/Route.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test } from 'vp/test'
 
 import * as Route from './Route.js'
 
@@ -24,6 +24,14 @@ describe('pathname', () => {
       Route.pathname(new URL('http://localhost/other/openai/v1/models'), '/api/proxy'),
     ).toBeNull()
   })
+
+  test('error: returns null for basePath prefix collision', () => {
+    expect(Route.pathname(new URL('http://localhost/proxy2/openai/v1/models'), '/proxy')).toBeNull()
+  })
+
+  test('behavior: returns empty string when pathname equals basePath', () => {
+    expect(Route.pathname(new URL('http://localhost/proxy'), '/proxy')).toBe('')
+  })
 })
 
 describe('parse', () => {

package/src/proxy/internal/Route.ts

@@ -5,7 +5,7 @@ export function pathname(url: URL, basePath?: string): string | null {
   let pathname = url.pathname
   if (basePath) {
     const base = basePath.replace(/\/+$/, '')
-    if (!pathname.startsWith(base)) return null
+    if (!(pathname === base || pathname.startsWith(`${base}/`))) return null
     pathname = pathname.slice(base.length)
   }
   return pathname

package/src/proxy/services/anthropic.test.ts

@@ -0,0 +1,132 @@
+import { Receipt } from 'mppx'
+import { Mppx as Mppx_client, tempo as tempo_client } from 'mppx/client'
+import { Mppx as Mppx_server, tempo as tempo_server } from 'mppx/server'
+import { afterEach, describe, expect, test } from 'vp/test'
+import * as Http from '~test/Http.js'
+import { accounts, asset, client } from '~test/tempo/viem.js'
+
+import * as ApiProxy from '../Proxy.js'
+import { anthropic } from './anthropic.js'
+
+const apiKey = 'sk-ant-test-fake-anthropic-key'
+const secretKey = 'test-secret-key'
+
+const mppx_server = Mppx_server.create({
+  methods: [
+    tempo_server({
+      account: accounts[0],
+      currency: asset,
+      getClient: () => client,
+    }),
+  ],
+  secretKey,
+})
+
+const mppx_client = Mppx_client.create({
+  polyfill: false,
+  methods: [
+    tempo_client({
+      account: accounts[1],
+      getClient: () => client,
+    }),
+  ],
+})
+
+let proxyServer: Awaited<ReturnType<typeof Http.createServer>> | undefined
+let upstreamServer: Awaited<ReturnType<typeof Http.createServer>> | undefined
+
+afterEach(() => {
+  proxyServer?.close()
+  upstreamServer?.close()
+})
+
+describe('anthropic', () => {
+  test('behavior: proxies POST /v1/messages with charge and injects x-api-key', async () => {
+    upstreamServer = await Http.createServer((req, res) => {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end(
+        JSON.stringify({
+          headers: {
+            'x-api-key': req.headers['x-api-key'],
+          },
+        }),
+      )
+    })
+
+    const proxy = ApiProxy.create({
+      services: [
+        anthropic({
+          apiKey,
+          baseUrl: upstreamServer.url,
+          routes: {
+            'POST /v1/messages': mppx_server.charge({ amount: '1', decimals: 6 }),
+          },
+        }),
+      ],
+    })
+    proxyServer = await Http.createServer(proxy.listener)
+
+    const res = await mppx_client.fetch(`${proxyServer.url}/anthropic/v1/messages`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ model: 'claude-3-opus-20240229', max_tokens: 1, messages: [] }),
+    })
+    expect(res.status).toBe(200)
+
+    const body = (await res.json()) as { headers: { 'x-api-key': string } }
+    expect(body.headers['x-api-key']).toBe(apiKey)
+
+    const receipt = Receipt.fromResponse(res)
+    expect(receipt.status).toBe('success')
+    expect(receipt.method).toBe('tempo')
+  })
+
+  test('behavior: returns 402 without credential', async () => {
+    upstreamServer = await Http.createServer((_req, res) => {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end('{}')
+    })
+
+    const proxy = ApiProxy.create({
+      services: [
+        anthropic({
+          apiKey,
+          baseUrl: upstreamServer.url,
+          routes: {
+            'POST /v1/messages': mppx_server.charge({ amount: '1', decimals: 6 }),
+          },
+        }),
+      ],
+    })
+    proxyServer = await Http.createServer(proxy.listener)
+
+    const res = await fetch(`${proxyServer.url}/anthropic/v1/messages`, {
+      method: 'POST',
+    })
+    expect(res.status).toBe(402)
+    expect(res.headers.get('WWW-Authenticate')).toContain('Payment')
+  })
+
+  test('behavior: returns 404 for unmatched route', async () => {
+    upstreamServer = await Http.createServer((_req, res) => {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end('{}')
+    })
+
+    const proxy = ApiProxy.create({
+      services: [
+        anthropic({
+          apiKey,
+          baseUrl: upstreamServer.url,
+          routes: {
+            'POST /v1/messages': mppx_server.charge({ amount: '1', decimals: 6 }),
+          },
+        }),
+      ],
+    })
+    proxyServer = await Http.createServer(proxy.listener)
+
+    const res = await fetch(`${proxyServer.url}/anthropic/v1/unknown`)
+    expect(res.status).toBe(404)
+  })
+})

package/src/proxy/services/anthropic.ts

@@ -20,7 +20,12 @@ import * as Service from '../Service.js'
 export function anthropic(config: anthropic.Config) {
   return Service.from<anthropic.Config>('anthropic', {
     baseUrl: config.baseUrl ?? 'https://api.anthropic.com',
+    categories: ['ai'],
     description: 'Claude language models for messages and completions.',
+    docs: {
+      apiReference: 'https://docs.anthropic.com/en/api/getting-started',
+      homepage: 'https://docs.anthropic.com/en/docs/intro-to-claude',
+    },
     rewriteRequest(request, ctx) {
       const apiKey = ctx.apiKey ?? config.apiKey
       request.headers.set('x-api-key', apiKey)

package/src/proxy/services/openai.test.ts

@@ -1,7 +1,7 @@
 import { Receipt } from 'mppx'
 import { Mppx as Mppx_client, tempo as tempo_client } from 'mppx/client'
 import { Mppx as Mppx_server, tempo as tempo_server } from 'mppx/server'
-import { afterEach, describe, expect, test } from 'vitest'
+import { afterEach, describe, expect, test } from 'vp/test'
 import * as Http from '~test/Http.js'
 import { accounts, asset, client } from '~test/tempo/viem.js'
 

package/src/proxy/services/openai.ts

@@ -20,11 +20,13 @@ import * as Service from '../Service.js'
 export function openai(config: openai.Config) {
   return Service.from<openai.Config>('openai', {
     baseUrl: config.baseUrl ?? 'https://api.openai.com',
+    categories: ['ai'],
     description: 'Chat completions, embeddings, image generation, and audio transcription.',
-    docsLlmsUrl: ({ route }) =>
-      route
-        ? `https://context7.com/websites/platform_openai/llms.txt?topic=${encodeURIComponent(route)}`
-        : 'https://context7.com/websites/platform_openai/llms.txt',
+    docs: {
+      apiReference: 'https://platform.openai.com/docs/api-reference',
+      homepage: 'https://platform.openai.com/docs',
+      llms: 'https://context7.com/websites/platform_openai/llms.txt',
+    },
     rewriteRequest(request, ctx) {
       const apiKey = ctx.apiKey ?? config.apiKey
       request.headers.set('Authorization', `Bearer ${apiKey}`)

package/src/proxy/services/stripe.test.ts

@@ -0,0 +1,132 @@
+import { Receipt } from 'mppx'
+import { Mppx as Mppx_client, tempo as tempo_client } from 'mppx/client'
+import { Mppx as Mppx_server, tempo as tempo_server } from 'mppx/server'
+import { afterEach, describe, expect, test } from 'vp/test'
+import * as Http from '~test/Http.js'
+import { accounts, asset, client } from '~test/tempo/viem.js'
+
+import * as ApiProxy from '../Proxy.js'
+import { stripe } from './stripe.js'
+
+const apiKey = 'sk_test_fake_stripe_key'
+const secretKey = 'test-secret-key'
+
+const mppx_server = Mppx_server.create({
+  methods: [
+    tempo_server({
+      account: accounts[0],
+      currency: asset,
+      getClient: () => client,
+    }),
+  ],
+  secretKey,
+})
+
+const mppx_client = Mppx_client.create({
+  polyfill: false,
+  methods: [
+    tempo_client({
+      account: accounts[1],
+      getClient: () => client,
+    }),
+  ],
+})
+
+let proxyServer: Awaited<ReturnType<typeof Http.createServer>> | undefined
+let upstreamServer: Awaited<ReturnType<typeof Http.createServer>> | undefined
+
+afterEach(() => {
+  proxyServer?.close()
+  upstreamServer?.close()
+})
+
+describe('stripe', () => {
+  test('behavior: proxies POST /v1/charges with charge and injects Basic auth', async () => {
+    upstreamServer = await Http.createServer((req, res) => {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end(
+        JSON.stringify({
+          headers: {
+            authorization: req.headers.authorization,
+          },
+        }),
+      )
+    })
+
+    const proxy = ApiProxy.create({
+      services: [
+        stripe({
+          apiKey,
+          baseUrl: upstreamServer.url,
+          routes: {
+            'POST /v1/charges': mppx_server.charge({ amount: '1', decimals: 6 }),
+          },
+        }),
+      ],
+    })
+    proxyServer = await Http.createServer(proxy.listener)
+
+    const res = await mppx_client.fetch(`${proxyServer.url}/stripe/v1/charges`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: 'amount=100&currency=usd',
+    })
+    expect(res.status).toBe(200)
+
+    const body = (await res.json()) as { headers: { authorization: string } }
+    expect(body.headers.authorization).toBe(`Basic ${btoa(`${apiKey}:`)}`)
+
+    const receipt = Receipt.fromResponse(res)
+    expect(receipt.status).toBe('success')
+    expect(receipt.method).toBe('tempo')
+  })
+
+  test('behavior: returns 402 without credential', async () => {
+    upstreamServer = await Http.createServer((_req, res) => {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end('{}')
+    })
+
+    const proxy = ApiProxy.create({
+      services: [
+        stripe({
+          apiKey,
+          baseUrl: upstreamServer.url,
+          routes: {
+            'POST /v1/charges': mppx_server.charge({ amount: '1', decimals: 6 }),
+          },
+        }),
+      ],
+    })
+    proxyServer = await Http.createServer(proxy.listener)
+
+    const res = await fetch(`${proxyServer.url}/stripe/v1/charges`, {
+      method: 'POST',
+    })
+    expect(res.status).toBe(402)
+    expect(res.headers.get('WWW-Authenticate')).toContain('Payment')
+  })
+
+  test('behavior: returns 404 for unmatched route', async () => {
+    upstreamServer = await Http.createServer((_req, res) => {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end('{}')
+    })
+
+    const proxy = ApiProxy.create({
+      services: [
+        stripe({
+          apiKey,
+          baseUrl: upstreamServer.url,
+          routes: {
+            'POST /v1/charges': mppx_server.charge({ amount: '1', decimals: 6 }),
+          },
+        }),
+      ],
+    })
+    proxyServer = await Http.createServer(proxy.listener)
+
+    const res = await fetch(`${proxyServer.url}/stripe/v1/unknown`)
+    expect(res.status).toBe(404)
+  })
+})

package/src/proxy/services/stripe.ts

@@ -20,11 +20,13 @@ import * as Service from '../Service.js'
 export function stripe(config: stripe.Config) {
   return Service.from<stripe.Config>('stripe', {
     baseUrl: config.baseUrl ?? 'https://api.stripe.com',
+    categories: ['payments'],
     description: 'Payment processing, customers, subscriptions, and invoices.',
-    docsLlmsUrl: ({ route }) =>
-      route
-        ? `https://context7.com/websites/stripe/llms.txt?topic=${encodeURIComponent(route)}`
-        : 'https://docs.stripe.com/llms.txt',
+    docs: {
+      apiReference: 'https://docs.stripe.com/api',
+      homepage: 'https://docs.stripe.com',
+      llms: 'https://docs.stripe.com/llms.txt',
+    },
     rewriteRequest(request, ctx) {
       const apiKey = ctx.apiKey ?? config.apiKey
       request.headers.set('Authorization', `Basic ${btoa(`${apiKey}:`)}`)

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

@@ -1,6 +1,6 @@
 import { Method, z } from 'mppx'
 import { Mppx } from 'mppx/server'
-import { assertType, describe, expectTypeOf, test } from 'vitest'
+import { assertType, describe, expectTypeOf, test } from 'vp/test'
 
 const mockChargeA = Method.from({
   name: 'alpha',

package/src/server/Mppx.test.ts

@@ -1,6 +1,6 @@
 import { Challenge, Credential, Method, z } from 'mppx'
 import { Mppx, Transport, tempo } from 'mppx/server'
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test } from 'vp/test'
 import * as Http from '~test/Http.js'
 import { accounts, asset, client } from '~test/tempo/viem.js'
 
@@ -9,6 +9,7 @@ const secretKey = 'test-secret-key'
 
 const method = tempo({
   getClient: () => client,
+  account: accounts[0],
 })
 
 describe('create', () => {

package/src/server/NodeListener.test.ts

@@ -1,5 +1,5 @@
 import { NodeListener, Request } from 'mppx/server'
-import { afterEach, describe, expect, test } from 'vitest'
+import { afterEach, describe, expect, test } from 'vp/test'
 import * as Http from '~test/Http.js'
 
 let server: Awaited<ReturnType<typeof Http.createServer>> | undefined

package/src/server/Request.test.ts

@@ -2,7 +2,7 @@ import { EventEmitter } from 'node:events'
 import type { IncomingMessage, ServerResponse } from 'node:http'
 
 import { Request } from 'mppx/server'
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test } from 'vp/test'
 
 function createMockRequest(options: {
   method?: string

package/src/server/Response.test.ts

@@ -1,6 +1,6 @@
 import { Challenge } from 'mppx'
 import { Response } from 'mppx/server'
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test } from 'vp/test'
 
 import * as Errors from '../Errors.js'
 

package/src/server/Transport.test.ts

@@ -1,7 +1,7 @@
 import { Challenge, Credential, Mcp, Receipt } from 'mppx'
 import { Transport } from 'mppx/server'
 import { Methods } from 'mppx/tempo'
-import { describe, expect, test } from 'vitest'
+import { describe, expect, test } from 'vp/test'
 
 import { BadRequestError, ChannelClosedError } from '../Errors.js'
 

package/src/stripe/Charge.integration.test.ts

@@ -1,7 +1,7 @@
 import { Challenge, Credential, Receipt } from 'mppx'
 import { Mppx as Mppx_client, stripe as stripe_client } from 'mppx/client'
 import { Mppx as Mppx_server, stripe as stripe_server } from 'mppx/server'
-import { afterEach, describe, expect, test } from 'vitest'
+import { afterEach, describe, expect, test } from 'vp/test'
 import * as Http from '~test/Http.js'
 
 const stripeSecretKey = process.env.VITE_STRIPE_SECRET_KEY

package/src/stripe/Methods.test.ts

@@ -1,5 +1,5 @@
 import { Methods } from 'mppx/stripe'
-import { describe, expect, expectTypeOf, test } from 'vitest'
+import { describe, expect, expectTypeOf, test } from 'vp/test'
 
 describe('charge', () => {
   test('has correct name and intent', () => {

package/src/stripe/client/Charge.test.ts

@@ -1,7 +1,7 @@
 import { Challenge, Credential } from 'mppx'
 import { Mppx, stripe } from 'mppx/client'
 import { Mppx as Mppx_server, stripe as stripe_server } from 'mppx/server'
-import { describe, expect, test, vi } from 'vitest'
+import { describe, expect, test, vi } from 'vp/test'
 
 import type { StripeJs } from '../internal/types.js'
 import { charge as clientCharge_ } from './Charge.js'

package/src/stripe/internal/types.ts

@@ -6,7 +6,11 @@
  */
 export type StripeClient = {
   paymentIntents: {
-    create(...args: any[]): Promise<{ id: string; status: string }>
+    create(...args: any[]): Promise<{
+      id: string
+      status: string
+      lastResponse?: { headers?: Record<string, string> }
+    }>
   }
 }