mppx 0.8.17 → 0.8.18

package/src/Errors.test.ts

@@ -1,520 +0,0 @@
-import { describe, expect, test } from 'vp/test'
-
-import {
-  AmountExceedsDepositError,
-  BadRequestError,
-  ChannelClosedError,
-  ChannelNotFoundError,
-  DeltaTooSmallError,
-  InsufficientBalanceError,
-  InvalidChallengeError,
-  InvalidPayloadError,
-  InvalidSignatureError,
-  MalformedCredentialError,
-  PaymentActionRequiredError,
-  PaymentExpiredError,
-  PaymentInsufficientError,
-  PaymentMethodUnsupportedError,
-  PaymentRequiredError,
-  SignerMismatchError,
-  VerificationFailedError,
-} from './Errors.js'
-
-function errorSnapshot(error: Error & { type: string; status: number }) {
-  return {
-    name: error.name,
-    message: error.message,
-    type: error.type,
-    status: error.status,
-  }
-}
-
-describe('MalformedCredentialError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new MalformedCredentialError())).toMatchInlineSnapshot(`
-      {
-        "message": "Credential is malformed.",
-        "name": "MalformedCredentialError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/malformed-credential",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new MalformedCredentialError({ reason: 'invalid base64url' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Credential is malformed: invalid base64url.",
-          "name": "MalformedCredentialError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/malformed-credential",
-        }
-      `)
-  })
-})
-
-describe('InvalidChallengeError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new InvalidChallengeError())).toMatchInlineSnapshot(`
-      {
-        "message": "Challenge is invalid.",
-        "name": "InvalidChallengeError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/invalid-challenge",
-      }
-    `)
-  })
-
-  test('with id', () => {
-    expect(errorSnapshot(new InvalidChallengeError({ id: 'abc123' }))).toMatchInlineSnapshot(`
-      {
-        "message": "Challenge "abc123" is invalid.",
-        "name": "InvalidChallengeError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/invalid-challenge",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new InvalidChallengeError({ reason: 'expired' }))).toMatchInlineSnapshot(`
-      {
-        "message": "Challenge is invalid: expired.",
-        "name": "InvalidChallengeError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/invalid-challenge",
-      }
-    `)
-  })
-
-  test('with id and reason', () => {
-    expect(errorSnapshot(new InvalidChallengeError({ id: 'abc123', reason: 'already used' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Challenge "abc123" is invalid: already used.",
-          "name": "InvalidChallengeError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/invalid-challenge",
-        }
-      `)
-  })
-})
-
-describe('VerificationFailedError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new VerificationFailedError())).toMatchInlineSnapshot(`
-      {
-        "message": "Payment verification failed.",
-        "name": "VerificationFailedError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/verification-failed",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new VerificationFailedError({ reason: 'invalid signature' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Payment verification failed: invalid signature.",
-          "name": "VerificationFailedError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/verification-failed",
-        }
-      `)
-  })
-
-  test('with relay metadata', () => {
-    const error = new VerificationFailedError({
-      details: { party: 'originator' },
-      reason: 'Originator matched a sanctions list',
-    })
-
-    expect(error.details).toEqual({ party: 'originator' })
-    expect(error.toProblemDetails('challenge-id')).toEqual({
-      challengeId: 'challenge-id',
-      detail: 'Payment verification failed: Originator matched a sanctions list.',
-      details: { party: 'originator' },
-      status: 402,
-      title: 'Verification Failed',
-      type: 'https://paymentauth.org/problems/verification-failed',
-    })
-  })
-
-  test('omits empty details', () => {
-    const error = new VerificationFailedError({ details: {} })
-
-    expect(error.toProblemDetails()).not.toHaveProperty('details')
-  })
-})
-
-describe('PaymentExpiredError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new PaymentExpiredError())).toMatchInlineSnapshot(`
-      {
-        "message": "Payment has expired.",
-        "name": "PaymentExpiredError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/payment-expired",
-      }
-    `)
-  })
-
-  test('with expires', () => {
-    expect(errorSnapshot(new PaymentExpiredError({ expires: '2025-01-26T12:00:00Z' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Payment expired at 2025-01-26T12:00:00Z.",
-          "name": "PaymentExpiredError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/payment-expired",
-        }
-      `)
-  })
-})
-
-describe('PaymentRequiredError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new PaymentRequiredError())).toMatchInlineSnapshot(`
-      {
-        "message": "Payment is required.",
-        "name": "PaymentRequiredError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/payment-required",
-      }
-    `)
-  })
-
-  test('with description', () => {
-    expect(errorSnapshot(new PaymentRequiredError({ description: 'API access fee' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Payment is required (API access fee).",
-          "name": "PaymentRequiredError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/payment-required",
-        }
-      `)
-  })
-
-  test('toProblemDetails includes hint', () => {
-    const error = new PaymentRequiredError({ description: 'API access fee' })
-    expect(error.toProblemDetails('ch_abc')).toMatchInlineSnapshot(`
-      {
-        "challengeId": "ch_abc",
-        "detail": "Payment is required (API access fee).",
-        "hint": "Use a supported wallet to pay for this resource using one of the supported payment methods returned in the WWW-Authenticate header. See https://mpp.dev/tools/wallet.md",
-        "status": 402,
-        "title": "Payment Required",
-        "type": "https://paymentauth.org/problems/payment-required",
-      }
-    `)
-  })
-})
-
-describe('InvalidPayloadError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new InvalidPayloadError())).toMatchInlineSnapshot(`
-      {
-        "message": "Credential payload is invalid.",
-        "name": "InvalidPayloadError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/invalid-payload",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new InvalidPayloadError({ reason: 'missing signature field' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Credential payload is invalid: missing signature field.",
-          "name": "InvalidPayloadError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/invalid-payload",
-        }
-      `)
-  })
-})
-
-describe('BadRequestError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new BadRequestError())).toMatchInlineSnapshot(`
-      {
-        "message": "Bad request.",
-        "name": "BadRequestError",
-        "status": 400,
-        "type": "https://paymentauth.org/problems/bad-request",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new BadRequestError({ reason: 'cannot combine hash type with feePayer' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Bad request: cannot combine hash type with feePayer.",
-          "name": "BadRequestError",
-          "status": 400,
-          "type": "https://paymentauth.org/problems/bad-request",
-        }
-      `)
-  })
-})
-
-describe('PaymentInsufficientError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new PaymentInsufficientError())).toMatchInlineSnapshot(`
-      {
-        "message": "Payment amount is insufficient.",
-        "name": "PaymentInsufficientError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/payment-insufficient",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new PaymentInsufficientError({ reason: 'expected 1000, received 500' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Payment insufficient: expected 1000, received 500.",
-          "name": "PaymentInsufficientError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/payment-insufficient",
-        }
-      `)
-  })
-})
-
-describe('PaymentMethodUnsupportedError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new PaymentMethodUnsupportedError())).toMatchInlineSnapshot(`
-      {
-        "message": "Payment method is not supported.",
-        "name": "PaymentMethodUnsupportedError",
-        "status": 400,
-        "type": "https://paymentauth.org/problems/method-unsupported",
-      }
-    `)
-  })
-
-  test('with method', () => {
-    expect(errorSnapshot(new PaymentMethodUnsupportedError({ method: 'bitcoin' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Payment method "bitcoin" is not supported.",
-          "name": "PaymentMethodUnsupportedError",
-          "status": 400,
-          "type": "https://paymentauth.org/problems/method-unsupported",
-        }
-      `)
-  })
-
-  test('toProblemDetails includes hint', () => {
-    const error = new PaymentMethodUnsupportedError({ method: 'bitcoin' })
-    expect(error.toProblemDetails()).toMatchInlineSnapshot(`
-      {
-        "detail": "Payment method "bitcoin" is not supported.",
-        "hint": "Use a supported wallet to pay for this resource using one of the supported payment methods returned in the WWW-Authenticate header. See https://mpp.dev/tools/wallet.md",
-        "status": 400,
-        "title": "Method Unsupported",
-        "type": "https://paymentauth.org/problems/method-unsupported",
-      }
-    `)
-  })
-})
-
-describe('InsufficientBalanceError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new InsufficientBalanceError())).toMatchInlineSnapshot(`
-      {
-        "message": "Insufficient balance.",
-        "name": "InsufficientBalanceError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/session/insufficient-balance",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new InsufficientBalanceError({ reason: 'requested 500, available 100' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Insufficient balance: requested 500, available 100.",
-          "name": "InsufficientBalanceError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/session/insufficient-balance",
-        }
-      `)
-  })
-})
-
-describe('InvalidSignatureError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new InvalidSignatureError())).toMatchInlineSnapshot(`
-      {
-        "message": "Invalid signature.",
-        "name": "InvalidSignatureError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/session/invalid-signature",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new InvalidSignatureError({ reason: 'ECDSA recovery failed' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Invalid signature: ECDSA recovery failed.",
-          "name": "InvalidSignatureError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/session/invalid-signature",
-        }
-      `)
-  })
-})
-
-describe('SignerMismatchError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new SignerMismatchError())).toMatchInlineSnapshot(`
-      {
-        "message": "Signer is not authorized for this channel.",
-        "name": "SignerMismatchError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/session/signer-mismatch",
-      }
-    `)
-  })
-})
-
-describe('AmountExceedsDepositError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new AmountExceedsDepositError())).toMatchInlineSnapshot(`
-      {
-        "message": "Voucher amount exceeds channel deposit.",
-        "name": "AmountExceedsDepositError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/session/amount-exceeds-deposit",
-      }
-    `)
-  })
-})
-
-describe('DeltaTooSmallError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new DeltaTooSmallError())).toMatchInlineSnapshot(`
-      {
-        "message": "Amount increase below minimum voucher delta.",
-        "name": "DeltaTooSmallError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/session/delta-too-small",
-      }
-    `)
-  })
-})
-
-describe('ChannelNotFoundError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new ChannelNotFoundError())).toMatchInlineSnapshot(`
-      {
-        "message": "No channel with this ID exists.",
-        "name": "ChannelNotFoundError",
-        "status": 410,
-        "type": "https://paymentauth.org/problems/session/channel-not-found",
-      }
-    `)
-  })
-})
-
-describe('ChannelClosedError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new ChannelClosedError())).toMatchInlineSnapshot(`
-      {
-        "message": "Channel is closed.",
-        "name": "ChannelClosedError",
-        "status": 410,
-        "type": "https://paymentauth.org/problems/session/channel-finalized",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new ChannelClosedError({ reason: 'channel is finalized on-chain' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Channel closed: channel is finalized on-chain.",
-          "name": "ChannelClosedError",
-          "status": 410,
-          "type": "https://paymentauth.org/problems/session/channel-finalized",
-        }
-      `)
-  })
-})
-
-describe('PaymentActionRequiredError', () => {
-  test('default', () => {
-    expect(errorSnapshot(new PaymentActionRequiredError())).toMatchInlineSnapshot(`
-      {
-        "message": "Payment requires action.",
-        "name": "PaymentActionRequiredError",
-        "status": 402,
-        "type": "https://paymentauth.org/problems/payment-action-required",
-      }
-    `)
-  })
-
-  test('with reason', () => {
-    expect(errorSnapshot(new PaymentActionRequiredError({ reason: 'requires_action' })))
-      .toMatchInlineSnapshot(`
-        {
-          "message": "Payment requires action: requires_action.",
-          "name": "PaymentActionRequiredError",
-          "status": 402,
-          "type": "https://paymentauth.org/problems/payment-action-required",
-        }
-      `)
-  })
-
-  test('toProblemDetails', () => {
-    const error = new PaymentActionRequiredError({ reason: 'Stripe PaymentIntent requires action' })
-    expect(error.toProblemDetails('ch_123')).toMatchInlineSnapshot(`
-      {
-        "challengeId": "ch_123",
-        "detail": "Payment requires action: Stripe PaymentIntent requires action.",
-        "status": 402,
-        "title": "Payment Action Required",
-        "type": "https://paymentauth.org/problems/payment-action-required",
-      }
-    `)
-  })
-})
-
-describe('toProblemDetails', () => {
-  test('without challengeId', () => {
-    const error = new MalformedCredentialError({ reason: 'invalid JSON' })
-    expect(error.toProblemDetails()).toMatchInlineSnapshot(`
-      {
-        "detail": "Credential is malformed: invalid JSON.",
-        "hint": "Use a supported wallet to construct valid credentials for one of the supported payment methods returned in the WWW-Authenticate header. See https://mpp.dev/tools/wallet.md",
-        "status": 402,
-        "title": "Malformed Credential",
-        "type": "https://paymentauth.org/problems/malformed-credential",
-      }
-    `)
-  })
-
-  test('with challengeId', () => {
-    const error = new InvalidChallengeError({ id: 'abc123', reason: 'expired' })
-    expect(error.toProblemDetails('abc123')).toMatchInlineSnapshot(`
-      {
-        "challengeId": "abc123",
-        "detail": "Challenge "abc123" is invalid: expired.",
-        "status": 402,
-        "title": "Invalid Challenge",
-        "type": "https://paymentauth.org/problems/invalid-challenge",
-      }
-    `)
-  })
-})