mppx 0.8.17 → 0.8.18

package/src/cli/validate/helpers.ts

@@ -1,166 +0,0 @@
-import { pc } from '../utils.js'
-
-export type CheckResult = {
-  label: string
-  detail?: string | undefined
-  hint?: string | undefined
-  severity: 'pass' | 'fail' | 'warn' | 'skip'
-}
-
-export type EndpointSpec = {
-  method: string
-  path: string
-  amount?: string | undefined
-  parameters?: PathParameter[] | undefined
-}
-
-export type PathParameter = {
-  name: string
-  in: 'path' | 'query' | 'header' | 'cookie'
-  schema?: {
-    type?: string
-    format?: string
-    pattern?: string
-    enum?: unknown[]
-    example?: unknown
-    default?: unknown
-  }
-  example?: unknown
-}
-
-export function check(label: string, detail?: string): CheckResult {
-  return detail ? { label, detail, severity: 'pass' } : { label, severity: 'pass' }
-}
-
-export function fail(label: string, detail?: string, hint?: string): CheckResult {
-  const r: CheckResult = { label, severity: 'fail' }
-  if (detail) r.detail = detail
-  if (hint) r.hint = hint
-  return r
-}
-
-export function warn(label: string, detail?: string, hint?: string): CheckResult {
-  const r: CheckResult = { label, severity: 'warn' }
-  if (detail) r.detail = detail
-  if (hint) r.hint = hint
-  return r
-}
-
-export function skip(label: string, detail?: string, hint?: string): CheckResult {
-  const r: CheckResult = detail ? { label, detail, severity: 'skip' } : { label, severity: 'skip' }
-  if (hint) r.hint = hint
-  return r
-}
-
-const SEVERITY_ICONS = {
-  pass: pc.green('✓'),
-  fail: pc.red('✗'),
-  warn: pc.yellow('⚠'),
-  skip: pc.dim('○'),
-} as const
-
-export function printCheck(result: CheckResult) {
-  const icon = SEVERITY_ICONS[result.severity]
-  const text = result.detail ? `${result.label} (${result.detail})` : result.label
-  console.log(`  ${icon} ${text}`)
-  if (result.hint && result.severity !== 'pass') {
-    console.log(pc.dim(`    → ${result.hint}`))
-  }
-}
-
-export function printSection(title: string) {
-  console.log(`\n${pc.bold(title)}`)
-}
-
-export type Counts = { passed: number; failed: number; warnings: number; skipped: number }
-
-export function printResults(results: CheckResult[], counts: Counts) {
-  for (const result of results) {
-    printCheck(result)
-    if (result.severity === 'pass') counts.passed++
-    else if (result.severity === 'fail') counts.failed++
-    else if (result.severity === 'warn') counts.warnings++
-    else if (result.severity === 'skip') counts.skipped++
-  }
-}
-
-export async function fetchWithTimeout(
-  url: string,
-  init: RequestInit,
-  timeoutMs = 15_000,
-): Promise<Response> {
-  const controller = new AbortController()
-  const timeout = setTimeout(() => controller.abort(), timeoutMs)
-  try {
-    return await fetch(url, { ...init, signal: controller.signal })
-  } finally {
-    clearTimeout(timeout)
-  }
-}
-
-export function formatBytes(bytes: number): string {
-  if (bytes < 1024) return `${bytes}B`
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`
-  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`
-}
-
-export const HTTP_METHODS = new Set([
-  'get',
-  'post',
-  'put',
-  'patch',
-  'delete',
-  'head',
-  'options',
-  'trace',
-])
-
-export function isValidAddress(addr: unknown): boolean {
-  return typeof addr === 'string' && /^0x[0-9a-fA-F]{40}$/.test(addr)
-}
-
-export function isValidIntegerAmount(amount: unknown): boolean {
-  return typeof amount === 'string' && /^(0|[1-9][0-9]*)$/.test(amount)
-}
-
-export function parseEndpointArg(input: string): EndpointSpec | null {
-  const sep = input.indexOf(':')
-  if (sep < 1) return null
-  const method = input.slice(0, sep).toLowerCase()
-  if (!HTTP_METHODS.has(method)) return null
-  const path = input.slice(sep + 1)
-  if (!path) return null
-  const normalizedPath = path.startsWith('/') ? path : '/' + path
-  return { method: method.toUpperCase(), path: normalizedPath }
-}
-
-// Resolves --body input: if JSON with all keys starting with /, it's a
-// per-path mapping. Otherwise it's a global body for all endpoints.
-export function resolveBodyForEndpoint(
-  rawBody: string | undefined,
-  endpointPath: string,
-): string | undefined {
-  if (!rawBody) return undefined
-  try {
-    const parsed = JSON.parse(rawBody)
-    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-      const keys = Object.keys(parsed)
-      if (keys.length > 0 && keys.every((k) => k.startsWith('/'))) {
-        const value = parsed[endpointPath]
-        if (value === undefined) return undefined
-        return typeof value === 'string' ? value : JSON.stringify(value)
-      }
-    }
-  } catch {}
-  return rawBody
-}
-
-export function parseHeaders(raw: string[] | undefined): Record<string, string> {
-  if (!raw) return {}
-  const headers: Record<string, string> = {}
-  for (const h of raw) {
-    const idx = h.indexOf(':')
-    if (idx > 0) headers[h.slice(0, idx).trim().toLowerCase()] = h.slice(idx + 1).trim()
-  }
-  return headers
-}

package/src/cli/validate/index.ts

@@ -1,229 +0,0 @@
-import { Cli, z } from 'incur'
-
-import { validate as validateCore, validateStream } from '../../validation/core.js'
-import { isAgentEnvironment, pc } from '../utils.js'
-import type { Counts } from './helpers.js'
-import { printResults, printSection } from './helpers.js'
-import { missingDiscoverySuggestion } from './messages.js'
-
-const validate = Cli.create('validate', {
-  description: 'Validate an MPP server implementation end-to-end',
-  args: z.object({
-    url: z.string().describe('Base URL of the MPP server to validate'),
-  }),
-  options: z.object({
-    endpoint: z.string().optional().describe('Endpoint to test (METHOD:path). Skips discovery.'),
-    body: z
-      .string()
-      .optional()
-      .describe(
-        'Request body. With --endpoint, used directly. In discovery mode, JSON with / keys is a per-path mapping.',
-      ),
-    query: z.array(z.string()).optional().describe('Query parameter (key=value, repeatable)'),
-    header: z.array(z.string()).optional().describe('Request header (key:value, repeatable)'),
-    verbose: z.number().default(0).meta({ count: true }).describe('Verbosity level'),
-    yes: z.boolean().default(false).describe('Auto-approve mainnet payments'),
-    outputJson: z
-      .boolean()
-      .default(false)
-      .describe('Output results as JSON (auto-enabled in known agent environments)'),
-  }),
-  alias: {
-    endpoint: 'e',
-    header: 'H',
-    verbose: 'v',
-    yes: 'y',
-    outputJson: 'j',
-  },
-  async run(c) {
-    const outputJson = c.options.outputJson || isAgentEnvironment()
-
-    // JSON mode: batch everything
-    if (outputJson) {
-      const result = await validateCore({
-        url: c.args.url,
-        endpoint: c.options.endpoint,
-        body: c.options.body,
-        query: c.options.query,
-        headers: c.options.header,
-        verbose: c.options.verbose > 0,
-        yes: c.options.yes,
-        interactive: false,
-      })
-      console.log(JSON.stringify(result, null, 2))
-      const noEndpoints = result.endpoints.length === 0 && !c.options.endpoint
-      if (result.summary.failed > 0 || !result.discovery.found || noEndpoints) process.exit(1)
-      return
-    }
-
-    // Streaming human-readable output
-    const baseUrl = c.args.url.replace(/\/$/, '').replace(/\/openapi\.json$/i, '')
-    console.log(`\n${pc.bold('mppx validate')} ${pc.dim(baseUrl)}\n`)
-
-    const counts: Counts = { passed: 0, failed: 0, warnings: 0, skipped: 0 }
-    let sawMppEndpoint = false
-    let sawNonMppPaymentEndpoint = false
-    let sawMalformedChallenge = false
-    let sawTestnet = false
-    let sawMainnet = false
-    let paymentSucceeded = false
-    let discoveryFound = false
-    let endpointCount = 0
-
-    for await (const event of validateStream({
-      url: c.args.url,
-      endpoint: c.options.endpoint,
-      body: c.options.body,
-      query: c.options.query,
-      headers: c.options.header,
-      verbose: c.options.verbose > 0,
-      yes: c.options.yes,
-      interactive: !!process.stdin.isTTY,
-      onPaymentResults: (results) => printResults(results, counts),
-    })) {
-      switch (event.phase) {
-        case 'discovery':
-          printSection('Discovery (/openapi.json)')
-          printResults(event.results, counts)
-          discoveryFound = event.discovery.found
-          if (!discoveryFound && !c.options.endpoint) {
-            console.log('')
-            const [headline, ...lines] = missingDiscoverySuggestion.split('\n')
-            console.log(pc.yellow(`  ${headline}`))
-            for (const line of lines) console.log(line ? pc.dim(`  ${line}`) : '')
-            console.log('')
-            process.exit(1)
-          }
-          if (event.discovery.endpoints.length === 0 && !c.options.endpoint && discoveryFound) {
-            console.log(pc.dim('  Use --endpoint to specify endpoints manually.'))
-            console.log('')
-            process.exit(1)
-          }
-          break
-        case 'endpoint':
-          endpointCount++
-          printSection(`${event.endpoint.method} ${event.endpoint.path}`)
-          break
-        case 'challenge':
-          console.log(pc.dim('  Challenge'))
-          printResults(event.results, counts)
-          if (event.isMpp) {
-            sawMppEndpoint = true
-            if (event.isTestnet) sawTestnet = true
-            if (event.isMainnet) sawMainnet = true
-          }
-          if (event.isNonMppPayment) sawNonMppPaymentEndpoint = true
-          if (event.isMalformedChallenge) sawMalformedChallenge = true
-          break
-        case 'errorHandling':
-          console.log(pc.dim('  Error Handling'))
-          printResults(event.results, counts)
-          break
-        case 'payment':
-          if (event.succeeded) paymentSucceeded = true
-          break
-      }
-    }
-
-    // Summary
-    printSummary(
-      counts,
-      {
-        sawMppEndpoint,
-        sawNonMppPaymentEndpoint,
-        sawMalformedChallenge,
-        sawTestnet,
-        sawMainnet,
-        paymentSucceeded,
-      },
-      endpointCount,
-    )
-  },
-})
-
-export default validate
-
-function printSummary(
-  counts: Counts,
-  flags: {
-    sawMppEndpoint: boolean
-    sawNonMppPaymentEndpoint: boolean
-    sawMalformedChallenge: boolean
-    sawTestnet: boolean
-    sawMainnet: boolean
-    paymentSucceeded: boolean
-  },
-  endpointsLength: number,
-): void {
-  if (!flags.sawMppEndpoint && endpointsLength > 0) {
-    console.log('')
-    if (flags.sawMalformedChallenge) {
-      console.log(
-        pc.yellow(
-          `  Payment scheme detected but challenge format is invalid on ${endpointsLength} endpoint(s).`,
-        ),
-      )
-      console.log(
-        pc.dim(
-          '  The server uses WWW-Authenticate: Payment but the challenge parameters do not conform to MPP.',
-        ),
-      )
-      console.log(
-        pc.dim(
-          '  Fix: encode payment details as base64url JSON in a request="..." parameter. See errors above.',
-        ),
-      )
-    } else if (flags.sawNonMppPaymentEndpoint) {
-      console.log(
-        pc.yellow(
-          `  No MPP endpoints found. Tested ${endpointsLength} endpoint(s) but none use WWW-Authenticate: Payment.`,
-        ),
-      )
-      console.log(pc.dim('  This server may use x402 or another payment protocol.'))
-    } else if (counts.skipped > 0 && counts.failed === 0) {
-      console.log(
-        pc.yellow(`  Could not reach payment gate on any endpoint (all returned 401/403/200).`),
-      )
-      console.log(
-        pc.dim(
-          '  The server may require authentication before payment. Try providing auth or use --endpoint with a public path.',
-        ),
-      )
-    } else {
-      console.log(
-        pc.yellow(
-          `  No MPP endpoints found. Tested ${endpointsLength} endpoint(s) but none use WWW-Authenticate: Payment.`,
-        ),
-      )
-      console.log(pc.dim('  This server may use x402 or another payment protocol.'))
-    }
-    console.log('')
-    process.exit(1)
-  }
-
-  console.log('')
-  const parts: string[] = []
-  if (counts.passed > 0) parts.push(pc.green(`${counts.passed} passed`))
-  if (counts.failed > 0) parts.push(pc.red(`${counts.failed} failed`))
-  if (counts.warnings > 0) parts.push(pc.yellow(`${counts.warnings} warning(s)`))
-  if (counts.skipped > 0) parts.push(pc.yellow(`${counts.skipped} skipped`))
-  console.log(`${pc.bold('Summary:')} ${parts.join(', ')}`)
-
-  if (flags.paymentSucceeded && flags.sawTestnet && !flags.sawMainnet) {
-    console.log('')
-    console.log(
-      pc.dim('  Tip: also validate your mainnet server to confirm real payments work end-to-end.'),
-    )
-  } else if (flags.sawMainnet && !flags.sawTestnet) {
-    console.log('')
-    console.log(
-      pc.dim(
-        '  Tip: also validate your testnet server for free. This CLI automatically provisions and funds a testnet wallet for testing.',
-      ),
-    )
-  }
-
-  console.log('')
-
-  if (counts.failed > 0) process.exit(1)
-}

package/src/cli/validate/messages.ts

@@ -1,7 +0,0 @@
-export const missingDiscoverySuggestion = [
-  'No discovery document found, endpoints could not be automatically found.',
-  'MPP servers must serve an OpenAPI document at /openapi.json with x-payment-info extensions.',
-  'The MPP SDKs can automatically expose this endpoint. See https://mpp.dev/sdk.',
-  '',
-  'To test a specific endpoint: mppx validate <url> --endpoint POST:/your/path',
-].join('\n')