@happyvertical/payments 0.79.0 → 0.80.1

package/dist/chunks/shared-DVl6UzD9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-DVl6UzD9.js","names":[],"sources":["../../src/shared.ts"],"sourcesContent":["import {\n  PaymentConfigurationError,\n  PaymentProviderError,\n  PaymentUnsupportedError,\n} from './errors.js';\nimport type {\n  PaymentEvent,\n  PaymentStatus,\n  PaymentStatusResult,\n  WatchPaymentInput,\n} from './types.js';\n\nexport type FetchLike = (\n  input: string | URL | Request,\n  init?: RequestInit,\n) => Promise<Response>;\n\nexport const TERMINAL_PAYMENT_STATUSES = new Set<PaymentStatus>([\n  'confirmed',\n  'failed',\n  'expired',\n  'refunded',\n]);\nexport const DEFAULT_MAX_STORED_PAYMENT_OPTIONS = 1_000;\nconst MAX_DECIMAL_PRECISION = 100;\nconst ZERO_DECIMAL_CURRENCIES = new Set([\n  'BIF',\n  'CLP',\n  'DJF',\n  'GNF',\n  'JPY',\n  'KMF',\n  'KRW',\n  'MGA',\n  'PYG',\n  'RWF',\n  'VND',\n  'VUV',\n  'XAF',\n  'XOF',\n  'XPF',\n]);\nconst THREE_DECIMAL_CURRENCIES = new Set([\n  'BHD',\n  'IQD',\n  'JOD',\n  'KWD',\n  'LYD',\n  'OMR',\n  'TND',\n]);\nconst TWO_DECIMAL_WHOLE_UNIT_CURRENCIES = new Set(['ISK', 'UGX']);\n\nexport function getFetch(fetchLike?: FetchLike): FetchLike {\n  const resolved = fetchLike ?? globalThis.fetch;\n\n  if (!resolved) {\n    throw new PaymentProviderError(\n      'A fetch implementation is required in this runtime.',\n    );\n  }\n\n  if (typeof resolved !== 'function') {\n    throw new PaymentProviderError('Fetch implementation must be a function.');\n  }\n\n  return resolved.bind(globalThis) as FetchLike;\n}\n\nexport function normalizeDate(value: Date | string): Date {\n  if (!(value instanceof Date) && typeof value !== 'string') {\n    throw new PaymentProviderError(`Invalid date value: ${String(value)}`);\n  }\n\n  const date = value instanceof Date ? value : new Date(value);\n\n  if (Number.isNaN(date.getTime())) {\n    throw new PaymentProviderError(`Invalid date value: ${String(value)}`);\n  }\n\n  return date;\n}\n\nexport function normalizeFutureDate(\n  value: Date | string,\n  context: string,\n): Date {\n  const date = normalizeDate(value);\n\n  if (date.getTime() <= Date.now()) {\n    throw new PaymentProviderError(`${context} is in the past.`);\n  }\n\n  return date;\n}\n\nexport function normalizeAmount(value: string): string {\n  if (typeof value !== 'string') {\n    throw new PaymentProviderError('Monetary amounts must be decimal strings.');\n  }\n\n  const raw = value.trim();\n\n  if (!/^\\d+(\\.\\d+)?$/.test(raw)) {\n    throw new PaymentProviderError(`Invalid amount value: ${String(value)}`);\n  }\n\n  const [whole, fraction] = raw.split('.');\n  const normalizedWhole = whole.replace(/^0+(?=\\d)/, '') || '0';\n  const normalizedFraction = fraction?.replace(/0+$/, '');\n\n  return normalizedFraction\n    ? `${normalizedWhole}.${normalizedFraction}`\n    : normalizedWhole;\n}\n\nexport function normalizePositiveAmount(\n  value: string,\n  context: string,\n): string {\n  const amount = normalizeAmount(value);\n\n  if (amount === '0') {\n    throw new PaymentProviderError(`${context} must be greater than zero.`);\n  }\n\n  return amount;\n}\n\nexport function normalizeCurrency(value: string, context: string): string {\n  if (typeof value !== 'string') {\n    throw new PaymentProviderError(`${context} currency must be a string.`);\n  }\n\n  const normalized = value.trim().toUpperCase();\n\n  if (!/^[A-Z0-9]{3,10}$/.test(normalized)) {\n    throw new PaymentProviderError(\n      `${context} currency must be a currency code, received ${String(value)}.`,\n    );\n  }\n\n  return normalized;\n}\n\nexport function normalizeMinorUnitAmount(\n  value: number,\n  context: string,\n): number {\n  if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {\n    throw new PaymentProviderError(\n      `${context} must be a non-negative integer in the smallest currency unit, received ${String(value)}.`,\n    );\n  }\n\n  return value;\n}\n\nexport function normalizePositiveMinorUnitAmount(\n  value: number,\n  context: string,\n): number {\n  const amount = normalizeMinorUnitAmount(value, context);\n\n  if (amount === 0) {\n    throw new PaymentProviderError(`${context} must be greater than zero.`);\n  }\n\n  return amount;\n}\n\nexport function normalizePositivePaymentAmount(\n  value: number,\n  currency: string,\n  context: string,\n): number {\n  const amount = normalizePositiveMinorUnitAmount(value, context);\n  const normalizedCurrency = normalizeCurrency(currency, context);\n\n  if (\n    TWO_DECIMAL_WHOLE_UNIT_CURRENCIES.has(normalizedCurrency) &&\n    amount % 100 !== 0\n  ) {\n    throw new PaymentProviderError(\n      `${context} for ${normalizedCurrency} must be evenly divisible by 100.`,\n    );\n  }\n\n  return amount;\n}\n\nexport function normalizeMaxStoredPaymentOptions(\n  value: number | undefined,\n  context: string,\n): number {\n  if (value === undefined) {\n    return DEFAULT_MAX_STORED_PAYMENT_OPTIONS;\n  }\n\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new PaymentConfigurationError(\n      `${context} must be a positive safe integer.`,\n    );\n  }\n\n  return value;\n}\n\nexport function rememberPaymentOption<TOption>(\n  optionsByQuote: Map<string, TOption>,\n  quoteId: string,\n  option: TOption,\n  maxStoredPaymentOptions: number,\n): void {\n  optionsByQuote.delete(quoteId);\n  optionsByQuote.set(quoteId, option);\n\n  while (optionsByQuote.size > maxStoredPaymentOptions) {\n    const oldestQuoteId = optionsByQuote.keys().next().value;\n\n    if (oldestQuoteId === undefined) {\n      return;\n    }\n\n    optionsByQuote.delete(oldestQuoteId);\n  }\n}\n\nexport function normalizeNonEmptyString(\n  value: string,\n  context: string,\n): string {\n  if (typeof value !== 'string') {\n    throw new PaymentProviderError(`${context} must be a string.`);\n  }\n\n  const normalized = value.trim();\n\n  if (!normalized) {\n    throw new PaymentProviderError(`${context} must not be empty.`);\n  }\n\n  return normalized;\n}\n\nexport function normalizeUrlString(value: string, context: string): string {\n  const normalized = normalizeNonEmptyString(value, context);\n\n  try {\n    const url = new URL(normalized);\n\n    if (!['http:', 'https:'].includes(url.protocol)) {\n      throw new PaymentConfigurationError(`${context} must use http or https.`);\n    }\n  } catch (error) {\n    if (error instanceof PaymentConfigurationError) {\n      throw error;\n    }\n\n    throw new PaymentConfigurationError(`${context} must be a valid URL.`, {\n      cause: error,\n    });\n  }\n\n  return normalized;\n}\n\nexport function decimalToAtomicUnits(value: string, decimals: number): string {\n  const precision = normalizeDecimalPrecision(decimals);\n\n  const normalized = normalizeAmount(value);\n  const [whole, fraction = ''] = normalized.split('.');\n\n  if (fraction.length > precision) {\n    throw new PaymentProviderError(\n      `Amount ${String(value)} has more than ${precision} decimal places.`,\n    );\n  }\n\n  const padded = `${fraction}${'0'.repeat(precision)}`.slice(0, precision);\n  const combined = `${whole}${padded}`.replace(/^0+(?=\\d)/, '');\n\n  return combined || '0';\n}\n\nexport function atomicUnitsToDecimal(\n  value: string | bigint,\n  decimals: number,\n): string {\n  const precision = normalizeDecimalPrecision(decimals);\n\n  if (typeof value !== 'string' && typeof value !== 'bigint') {\n    throw new PaymentProviderError(\n      `Invalid atomic amount value: ${String(value)}`,\n    );\n  }\n\n  const raw = typeof value === 'bigint' ? value.toString() : value;\n\n  if (!/^\\d+$/.test(raw)) {\n    throw new PaymentProviderError(\n      `Invalid atomic amount value: ${String(value)}`,\n    );\n  }\n\n  if (precision === 0) {\n    return raw || '0';\n  }\n\n  const padded = raw.padStart(precision + 1, '0');\n  const whole = padded.slice(0, -precision);\n  const fraction = padded.slice(-precision).replace(/0+$/, '');\n\n  return fraction ? `${whole}.${fraction}` : whole;\n}\n\nexport function amountToMinorUnits(value: string, decimals = 2): string {\n  return decimalToAtomicUnits(value, decimals);\n}\n\nexport function minorUnitsToDecimal(value: number, decimals: number): string {\n  return atomicUnitsToDecimal(\n    BigInt(normalizeMinorUnitAmount(value, 'Minor-unit')),\n    decimals,\n  );\n}\n\nexport function decimalToMinorUnitAmount(\n  value: string | bigint,\n  decimals: number,\n  context: string,\n): number {\n  const atomic =\n    typeof value === 'bigint'\n      ? value\n      : BigInt(decimalToAtomicUnits(value, decimals));\n\n  if (atomic < 0n) {\n    throw new PaymentProviderError(\n      `Invalid atomic amount value: ${String(value)}`,\n    );\n  }\n\n  if (atomic > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new PaymentProviderError(\n      `${context} amount exceeds JavaScript's safe integer range.`,\n    );\n  }\n\n  return Number(atomic);\n}\n\nexport function currencyMinorUnitDecimals(currency: string): number {\n  const normalized = normalizeCurrency(currency, 'Payment');\n\n  if (normalized === 'BTC') {\n    return 8;\n  }\n\n  if (normalized === 'USDC') {\n    return 6;\n  }\n\n  if (THREE_DECIMAL_CURRENCIES.has(normalized)) {\n    return 3;\n  }\n\n  return ZERO_DECIMAL_CURRENCIES.has(normalized) ? 0 : 2;\n}\n\nexport function applyExpiryToPendingStatus(\n  status: PaymentStatus,\n  expiresAt?: Date,\n): PaymentStatus {\n  if (!expiresAt || expiresAt >= new Date()) {\n    return status;\n  }\n\n  return status === 'pending' || status === 'requires_action'\n    ? 'expired'\n    : status;\n}\n\nfunction normalizeDecimalPrecision(decimals: number): number {\n  if (\n    !Number.isSafeInteger(decimals) ||\n    decimals < 0 ||\n    decimals > MAX_DECIMAL_PRECISION\n  ) {\n    throw new PaymentProviderError(\n      `Invalid decimal precision: ${String(decimals)}`,\n    );\n  }\n\n  return decimals;\n}\n\nexport function compareDecimalAmounts(left: string, right: string): -1 | 0 | 1 {\n  const [leftWhole, leftFraction = ''] = normalizeAmount(left).split('.');\n  const [rightWhole, rightFraction = ''] = normalizeAmount(right).split('.');\n  const leftWholeValue = BigInt(leftWhole ?? '0');\n  const rightWholeValue = BigInt(rightWhole ?? '0');\n\n  if (leftWholeValue > rightWholeValue) {\n    return 1;\n  }\n\n  if (leftWholeValue < rightWholeValue) {\n    return -1;\n  }\n\n  const scale = Math.max(leftFraction.length, rightFraction.length);\n  const leftFractionValue = BigInt(\n    (leftFraction + '0'.repeat(scale)).slice(0, scale) || '0',\n  );\n  const rightFractionValue = BigInt(\n    (rightFraction + '0'.repeat(scale)).slice(0, scale) || '0',\n  );\n\n  if (leftFractionValue > rightFractionValue) {\n    return 1;\n  }\n\n  if (leftFractionValue < rightFractionValue) {\n    return -1;\n  }\n\n  return 0;\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted) {\n    return Promise.reject(signal.reason);\n  }\n\n  return new Promise((resolve, reject) => {\n    let timeout: ReturnType<typeof setTimeout>;\n    const handleAbort = (): void => {\n      clearTimeout(timeout);\n      reject(signal?.reason);\n    };\n    const handleResolve = (): void => {\n      signal?.removeEventListener('abort', handleAbort);\n      resolve();\n    };\n\n    timeout = setTimeout(handleResolve, ms);\n    signal?.addEventListener('abort', handleAbort, { once: true });\n  });\n}\n\nexport async function* pollPaymentStatus(\n  input: WatchPaymentInput,\n  getStatus: () => Promise<PaymentStatusResult>,\n): AsyncIterable<PaymentEvent> {\n  const startedAt = Date.now();\n  const pollIntervalMs = normalizePollIntervalMs(input.pollIntervalMs ?? 5_000);\n  const timeoutMs =\n    input.timeoutMs === undefined\n      ? undefined\n      : normalizeTimeoutMs(input.timeoutMs);\n  let lastStatus: PaymentStatus | undefined;\n  let lastResult: PaymentStatusResult | undefined;\n\n  const remainingTimeoutMs = (): number | undefined =>\n    timeoutMs === undefined ? undefined : timeoutMs - (Date.now() - startedAt);\n\n  const yieldTimeoutEvent = async (): Promise<PaymentEvent> => ({\n    ...(lastResult ?? (await getStatus())),\n    event: 'timeout',\n    status: lastResult?.status ?? 'pending',\n    updatedAt: new Date(),\n  });\n\n  while (!input.signal?.aborted) {\n    if ((remainingTimeoutMs() ?? 1) <= 0) {\n      yield await yieldTimeoutEvent();\n      return;\n    }\n\n    const status = await getStatus();\n    lastResult = status;\n\n    if (status.status !== lastStatus) {\n      const event = toPaymentEvent(status);\n      yield event;\n      lastStatus = status.status;\n\n      if (TERMINAL_PAYMENT_STATUSES.has(status.status)) {\n        return;\n      }\n    }\n\n    const remaining = remainingTimeoutMs();\n\n    if (remaining !== undefined && remaining <= 0) {\n      yield await yieldTimeoutEvent();\n      return;\n    }\n\n    await sleep(\n      remaining === undefined\n        ? pollIntervalMs\n        : Math.min(pollIntervalMs, remaining),\n      input.signal,\n    );\n  }\n}\n\nfunction normalizePollIntervalMs(value: number): number {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new PaymentProviderError(\n      `pollIntervalMs must be a positive integer, received ${String(value)}.`,\n    );\n  }\n\n  return value;\n}\n\nfunction normalizeTimeoutMs(value: number): number {\n  if (!Number.isInteger(value) || value < 0) {\n    throw new PaymentProviderError(\n      `timeoutMs must be a non-negative integer, received ${String(value)}.`,\n    );\n  }\n\n  return value;\n}\n\nexport function toPaymentEvent(status: PaymentStatusResult): PaymentEvent {\n  if (status.status === 'confirmed') {\n    return { ...status, event: 'confirmed' };\n  }\n\n  if (status.status === 'failed') {\n    return { ...status, event: 'failed' };\n  }\n\n  if (status.status === 'expired') {\n    return { ...status, event: 'expired' };\n  }\n\n  if (status.status === 'refunded') {\n    return { ...status, event: 'refunded' };\n  }\n\n  return { ...status, event: 'status' };\n}\n\nexport async function readJsonResponse<T>(\n  response: Response,\n  context: string,\n): Promise<T> {\n  const text = await response.text();\n  let body: unknown;\n\n  if (text) {\n    try {\n      body = JSON.parse(text);\n    } catch (error) {\n      if (response.ok) {\n        throw new PaymentProviderError(`${context}: invalid JSON response`, {\n          cause: error,\n        });\n      }\n\n      body = undefined;\n    }\n  }\n\n  if (!response.ok) {\n    const message =\n      body && typeof body === 'object' && 'message' in body\n        ? String((body as { message: unknown }).message)\n        : body &&\n            typeof body === 'object' &&\n            typeof (body as { error?: unknown }).error === 'string'\n          ? String((body as { error: string }).error)\n          : body &&\n              typeof body === 'object' &&\n              'error' in body &&\n              typeof (body as { error?: { message?: unknown } }).error\n                ?.message === 'string'\n            ? (body as { error: { message: string } }).error.message\n            : text || response.statusText;\n\n    throw new PaymentProviderError(`${context}: ${message}`, {\n      retryable: response.status >= 500,\n    });\n  }\n\n  if (body === undefined) {\n    throw new PaymentProviderError(`${context}: empty response body`);\n  }\n\n  return body as T;\n}\n\nexport function formEncode(params: Record<string, unknown>): string {\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    searchParams.set(key, String(value));\n  }\n\n  return searchParams.toString();\n}\n\nexport function throwUnsupported(message: string): never {\n  throw new PaymentUnsupportedError(message);\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -1,49 +1,35 @@
-import { P as PaymentConfigurationError } from "./chunks/errors-BgFC46qQ.js";
-import { a, b, c, d } from "./chunks/errors-BgFC46qQ.js";
+import { a as PaymentVerificationError, i as PaymentUnsupportedError, n as PaymentError, r as PaymentProviderError, t as PaymentConfigurationError } from "./chunks/errors-feZrwnTy.js";
+//#region src/factory.ts
 async function createPaymentBackend(options) {
-  if (!options || typeof options !== "object" || Array.isArray(options)) {
-    throw new PaymentConfigurationError(
-      "Payment backend options must be an object."
-    );
-  }
-  const type = options.type;
-  if (typeof type !== "string" || !type.trim()) {
-    throw new PaymentConfigurationError(
-      "Payment backend type must be a string."
-    );
-  }
-  const normalizedType = type.trim();
-  const backendOptions = {
-    ...options,
-    type: normalizedType
-  };
-  switch (backendOptions.type) {
-    case "base-usdc": {
-      const { BaseUsdcAdapter } = await import("./adapters/base-usdc.js");
-      return new BaseUsdcAdapter(backendOptions);
-    }
-    case "btc": {
-      const { BtcAdapter } = await import("./adapters/btc.js");
-      return new BtcAdapter(backendOptions);
-    }
-    case "stripe": {
-      const { StripeAdapter } = await import("./adapters/stripe.js");
-      return new StripeAdapter(backendOptions);
-    }
-    default:
-      throw new PaymentConfigurationError(
-        `Unknown payment backend type: ${normalizedType}`
-      );
-  }
+	if (!options || typeof options !== "object" || Array.isArray(options)) throw new PaymentConfigurationError("Payment backend options must be an object.");
+	const type = options.type;
+	if (typeof type !== "string" || !type.trim()) throw new PaymentConfigurationError("Payment backend type must be a string.");
+	const normalizedType = type.trim();
+	const backendOptions = {
+		...options,
+		type: normalizedType
+	};
+	switch (backendOptions.type) {
+		case "base-usdc": {
+			const { BaseUsdcAdapter } = await import("./adapters/base-usdc.js");
+			return new BaseUsdcAdapter(backendOptions);
+		}
+		case "btc": {
+			const { BtcAdapter } = await import("./adapters/btc.js");
+			return new BtcAdapter(backendOptions);
+		}
+		case "stripe": {
+			const { StripeAdapter } = await import("./adapters/stripe.js");
+			return new StripeAdapter(backendOptions);
+		}
+		default: throw new PaymentConfigurationError(`Unknown payment backend type: ${normalizedType}`);
+	}
 }
-const PACKAGE_VERSION_INITIALIZED = true;
-export {
-  PACKAGE_VERSION_INITIALIZED,
-  PaymentConfigurationError,
-  a as PaymentError,
-  b as PaymentProviderError,
-  c as PaymentUnsupportedError,
-  d as PaymentVerificationError,
-  createPaymentBackend
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+//#region src/index.ts
+/** @internal */
+var PACKAGE_VERSION_INITIALIZED = true;
+//#endregion
+export { PACKAGE_VERSION_INITIALIZED, PaymentConfigurationError, PaymentError, PaymentProviderError, PaymentUnsupportedError, PaymentVerificationError, createPaymentBackend };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/factory.ts","../src/index.ts"],"sourcesContent":["import type { BaseUsdcAdapterOptions } from './adapters/base-usdc.js';\nimport type { BtcAdapterOptions } from './adapters/btc.js';\nimport type { StripeAdapterOptions } from './adapters/stripe.js';\nimport { PaymentConfigurationError } from './errors.js';\nimport type { PaymentBackend } from './types.js';\n\nexport type PaymentBackendOptions =\n  | ({ type: 'base-usdc' } & BaseUsdcAdapterOptions)\n  | ({ type: 'btc' } & BtcAdapterOptions)\n  | ({ type: 'stripe' } & StripeAdapterOptions);\n\nexport async function createPaymentBackend(\n  options: PaymentBackendOptions,\n): Promise<PaymentBackend> {\n  if (!options || typeof options !== 'object' || Array.isArray(options)) {\n    throw new PaymentConfigurationError(\n      'Payment backend options must be an object.',\n    );\n  }\n\n  const type = (options as { type?: unknown }).type;\n\n  if (typeof type !== 'string' || !type.trim()) {\n    throw new PaymentConfigurationError(\n      'Payment backend type must be a string.',\n    );\n  }\n\n  const normalizedType = type.trim();\n  const backendOptions = {\n    ...options,\n    type: normalizedType,\n  } as PaymentBackendOptions;\n\n  switch (backendOptions.type) {\n    case 'base-usdc': {\n      const { BaseUsdcAdapter } = await import('./adapters/base-usdc.js');\n      return new BaseUsdcAdapter(backendOptions);\n    }\n    case 'btc': {\n      const { BtcAdapter } = await import('./adapters/btc.js');\n      return new BtcAdapter(backendOptions);\n    }\n    case 'stripe': {\n      const { StripeAdapter } = await import('./adapters/stripe.js');\n      return new StripeAdapter(backendOptions);\n    }\n    default:\n      throw new PaymentConfigurationError(\n        `Unknown payment backend type: ${normalizedType}`,\n      );\n  }\n}\n","/**\n * @happyvertical/payments - Multi-backend payment provider abstraction.\n *\n * The default entrypoint exports only provider contracts, shared errors, and\n * the dynamic factory. Adapter implementations live behind subpath exports:\n * `@happyvertical/payments/base-usdc`, `@happyvertical/payments/btc`, and\n * `@happyvertical/payments/stripe`.\n */\n\nexport * from './errors.js';\nexport * from './factory.js';\nexport * from './types.js';\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"names":[],"mappings":";;AAWA,eAAsB,qBACpB,SACyB;AACzB,MAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACrE,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,QAAM,OAAQ,QAA+B;AAE7C,MAAI,OAAO,SAAS,YAAY,CAAC,KAAK,QAAQ;AAC5C,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,QAAM,iBAAiB,KAAK,KAAA;AAC5B,QAAM,iBAAiB;AAAA,IACrB,GAAG;AAAA,IACH,MAAM;AAAA,EAAA;AAGR,UAAQ,eAAe,MAAA;AAAA,IACrB,KAAK,aAAa;AAChB,YAAM,EAAE,gBAAA,IAAoB,MAAM,OAAO,yBAAyB;AAClE,aAAO,IAAI,gBAAgB,cAAc;AAAA,IAC3C;AAAA,IACA,KAAK,OAAO;AACV,YAAM,EAAE,WAAA,IAAe,MAAM,OAAO,mBAAmB;AACvD,aAAO,IAAI,WAAW,cAAc;AAAA,IACtC;AAAA,IACA,KAAK,UAAU;AACb,YAAM,EAAE,cAAA,IAAkB,MAAM,OAAO,sBAAsB;AAC7D,aAAO,IAAI,cAAc,cAAc;AAAA,IACzC;AAAA,IACA;AACE,YAAM,IAAI;AAAA,QACR,iCAAiC,cAAc;AAAA,MAAA;AAAA,EACjD;AAEN;ACtCO,MAAM,8BAA8B;"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/factory.ts","../src/index.ts"],"sourcesContent":["import type { BaseUsdcAdapterOptions } from './adapters/base-usdc.js';\nimport type { BtcAdapterOptions } from './adapters/btc.js';\nimport type { StripeAdapterOptions } from './adapters/stripe.js';\nimport { PaymentConfigurationError } from './errors.js';\nimport type { PaymentBackend } from './types.js';\n\nexport type PaymentBackendOptions =\n  | ({ type: 'base-usdc' } & BaseUsdcAdapterOptions)\n  | ({ type: 'btc' } & BtcAdapterOptions)\n  | ({ type: 'stripe' } & StripeAdapterOptions);\n\nexport async function createPaymentBackend(\n  options: PaymentBackendOptions,\n): Promise<PaymentBackend> {\n  if (!options || typeof options !== 'object' || Array.isArray(options)) {\n    throw new PaymentConfigurationError(\n      'Payment backend options must be an object.',\n    );\n  }\n\n  const type = (options as { type?: unknown }).type;\n\n  if (typeof type !== 'string' || !type.trim()) {\n    throw new PaymentConfigurationError(\n      'Payment backend type must be a string.',\n    );\n  }\n\n  const normalizedType = type.trim();\n  const backendOptions = {\n    ...options,\n    type: normalizedType,\n  } as PaymentBackendOptions;\n\n  switch (backendOptions.type) {\n    case 'base-usdc': {\n      const { BaseUsdcAdapter } = await import('./adapters/base-usdc.js');\n      return new BaseUsdcAdapter(backendOptions);\n    }\n    case 'btc': {\n      const { BtcAdapter } = await import('./adapters/btc.js');\n      return new BtcAdapter(backendOptions);\n    }\n    case 'stripe': {\n      const { StripeAdapter } = await import('./adapters/stripe.js');\n      return new StripeAdapter(backendOptions);\n    }\n    default:\n      throw new PaymentConfigurationError(\n        `Unknown payment backend type: ${normalizedType}`,\n      );\n  }\n}\n","/**\n * @happyvertical/payments - Multi-backend payment provider abstraction.\n *\n * The default entrypoint exports only provider contracts, shared errors, and\n * the dynamic factory. Adapter implementations live behind subpath exports:\n * `@happyvertical/payments/base-usdc`, `@happyvertical/payments/btc`, and\n * `@happyvertical/payments/stripe`.\n */\n\nexport * from './errors.js';\nexport * from './factory.js';\nexport * from './types.js';\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"mappings":";;AAWA,eAAsB,qBACpB,SACyB;CACzB,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAClE,MAAM,IAAI,0BACR,4CACF;CAGF,MAAM,OAAQ,QAA+B;CAE7C,IAAI,OAAO,SAAS,YAAY,CAAC,KAAK,KAAK,GACzC,MAAM,IAAI,0BACR,wCACF;CAGF,MAAM,iBAAiB,KAAK,KAAK;CACjC,MAAM,iBAAiB;EACrB,GAAG;EACH,MAAM;CACR;CAEA,QAAQ,eAAe,MAAvB;EACE,KAAK,aAAa;GAChB,MAAM,EAAE,oBAAoB,MAAM,OAAO;GACzC,OAAO,IAAI,gBAAgB,cAAc;EAC3C;EACA,KAAK,OAAO;GACV,MAAM,EAAE,eAAe,MAAM,OAAO;GACpC,OAAO,IAAI,WAAW,cAAc;EACtC;EACA,KAAK,UAAU;GACb,MAAM,EAAE,kBAAkB,MAAM,OAAO;GACvC,OAAO,IAAI,cAAc,cAAc;EACzC;EACA,SACE,MAAM,IAAI,0BACR,iCAAiC,gBACnC;CACJ;AACF;;;;ACtCA,IAAa,8BAA8B"}

package/dist/testing/conformance.js

@@ -1,114 +1,98 @@
-const futureExpiryOffsetMs = 365 * 24 * 60 * 60 * 1e3;
-const defaultPaymentOptionInput = {
-  quoteId: "quote-conformance",
-  amount: 1234,
-  currency: "USD",
-  expiresAt: new Date(Date.now() + futureExpiryOffsetMs)
+//#region src/testing/conformance.ts
+var defaultPaymentOptionInput = {
+	quoteId: "quote-conformance",
+	amount: 1234,
+	currency: "USD",
+	expiresAt: new Date(Date.now() + 365 * 24 * 60 * 60 * 1e3)
 };
 function definePaymentBackendConformanceTests(backendName, harness, testApi = readGlobalConformanceTestApi()) {
-  const { describe, expect, it } = testApi;
-  describe(`${backendName} PaymentBackend conformance`, () => {
-    it("declares required capabilities", async () => {
-      const backend = await harness.createBackend();
-      expect(backend.capabilities.id).toEqual(expect.any(String));
-      expect(backend.capabilities.displayName).toEqual(expect.any(String));
-      expect(backend.capabilities.settlementCurrency).toEqual(
-        expect.any(String)
-      );
-      expect(backend.capabilities.chain).toEqual(expect.any(String));
-      expect(["address", "url", "psbt"]).toContain(
-        backend.capabilities.settlementShape
-      );
-      expect(typeof backend.capabilities.x402Capable).toBe("boolean");
-      expect(typeof backend.capabilities.supportsRefunds).toBe("boolean");
-      expect(typeof backend.capabilities.supportsPayouts).toBe("boolean");
-      expect(typeof backend.capabilities.supportsWebhooks).toBe("boolean");
-      expect(
-        backend.capabilities.confirmationLatency.expectedSeconds
-      ).toBeGreaterThanOrEqual(0);
-      expect(backend.capabilities).toMatchObject(
-        harness.expectedCapabilities ?? {}
-      );
-    });
-    it("creates a payment option with stable quote metadata", async () => {
-      const backend = await harness.createBackend();
-      const input = harness.createPaymentOptionInput ?? defaultPaymentOptionInput;
-      const option = await backend.createPaymentOption(input);
-      expect(option.backendId).toBe(backend.capabilities.id);
-      expect(option.quoteId).toBe(input.quoteId);
-      expect(option.payTo).toEqual(expect.any(String));
-      expect(option.settlementCurrency).toBe(
-        backend.capabilities.settlementCurrency
-      );
-      expect(option.settlementShape).toBe(backend.capabilities.settlementShape);
-      expect(option.settlementAmount).toEqual(expect.any(Number));
-      expect(option.amount).toBe(input.amount);
-      expect(option.currency).toBe(input.currency);
-      expect(option.expiresAt).toBeInstanceOf(Date);
-      expect(option).toMatchObject(harness.expectedOption ?? {});
-    });
-    it("reports idempotent status for an option", async () => {
-      const backend = await harness.createBackend();
-      const input = harness.createPaymentOptionInput ?? defaultPaymentOptionInput;
-      const option = await backend.createPaymentOption(input);
-      const status = await backend.getStatus(input.quoteId, option.payTo);
-      expect(status.backendId).toBe(backend.capabilities.id);
-      expect(status.quoteId).toBe(input.quoteId);
-      expect(status.payTo).toBe(option.payTo);
-      expect(status.updatedAt).toBeInstanceOf(Date);
-      expect(status).toMatchObject(harness.expectedStatus ?? {});
-    });
-    it("returns an async iterable from watchPayment", async () => {
-      const backend = await harness.createBackend();
-      const input = harness.createPaymentOptionInput ?? defaultPaymentOptionInput;
-      const option = await backend.createPaymentOption(input);
-      const stream = backend.watchPayment({
-        quoteId: input.quoteId,
-        payTo: option.payTo,
-        pollIntervalMs: 1,
-        timeoutMs: 1
-      });
-      expect(typeof stream[Symbol.asyncIterator]).toBe("function");
-      await expect(
-        stream[Symbol.asyncIterator]().next()
-      ).resolves.toMatchObject({
-        value: expect.objectContaining({
-          backendId: backend.capabilities.id,
-          quoteId: input.quoteId
-        })
-      });
-    });
-    it("sends payouts through the backend payout surface", async () => {
-      const backend = await harness.createBackend();
-      const payout = await backend.sendPayout(
-        harness.payoutInput ?? {
-          destination: "destination-conformance",
-          amount: 100,
-          currency: "USD"
-        }
-      );
-      expect(payout.backendId).toBe(backend.capabilities.id);
-      expect(payout.destination).toEqual(expect.any(String));
-      expect(payout.amount).toEqual(expect.any(Number));
-      expect(payout.currency).toEqual(expect.any(String));
-      expect(payout).toMatchObject(harness.expectedPayout ?? {});
-    });
-  });
+	const { describe, expect, it } = testApi;
+	describe(`${backendName} PaymentBackend conformance`, () => {
+		it("declares required capabilities", async () => {
+			const backend = await harness.createBackend();
+			expect(backend.capabilities.id).toEqual(expect.any(String));
+			expect(backend.capabilities.displayName).toEqual(expect.any(String));
+			expect(backend.capabilities.settlementCurrency).toEqual(expect.any(String));
+			expect(backend.capabilities.chain).toEqual(expect.any(String));
+			expect([
+				"address",
+				"url",
+				"psbt"
+			]).toContain(backend.capabilities.settlementShape);
+			expect(typeof backend.capabilities.x402Capable).toBe("boolean");
+			expect(typeof backend.capabilities.supportsRefunds).toBe("boolean");
+			expect(typeof backend.capabilities.supportsPayouts).toBe("boolean");
+			expect(typeof backend.capabilities.supportsWebhooks).toBe("boolean");
+			expect(backend.capabilities.confirmationLatency.expectedSeconds).toBeGreaterThanOrEqual(0);
+			expect(backend.capabilities).toMatchObject(harness.expectedCapabilities ?? {});
+		});
+		it("creates a payment option with stable quote metadata", async () => {
+			const backend = await harness.createBackend();
+			const input = harness.createPaymentOptionInput ?? defaultPaymentOptionInput;
+			const option = await backend.createPaymentOption(input);
+			expect(option.backendId).toBe(backend.capabilities.id);
+			expect(option.quoteId).toBe(input.quoteId);
+			expect(option.payTo).toEqual(expect.any(String));
+			expect(option.settlementCurrency).toBe(backend.capabilities.settlementCurrency);
+			expect(option.settlementShape).toBe(backend.capabilities.settlementShape);
+			expect(option.settlementAmount).toEqual(expect.any(Number));
+			expect(option.amount).toBe(input.amount);
+			expect(option.currency).toBe(input.currency);
+			expect(option.expiresAt).toBeInstanceOf(Date);
+			expect(option).toMatchObject(harness.expectedOption ?? {});
+		});
+		it("reports idempotent status for an option", async () => {
+			const backend = await harness.createBackend();
+			const input = harness.createPaymentOptionInput ?? defaultPaymentOptionInput;
+			const option = await backend.createPaymentOption(input);
+			const status = await backend.getStatus(input.quoteId, option.payTo);
+			expect(status.backendId).toBe(backend.capabilities.id);
+			expect(status.quoteId).toBe(input.quoteId);
+			expect(status.payTo).toBe(option.payTo);
+			expect(status.updatedAt).toBeInstanceOf(Date);
+			expect(status).toMatchObject(harness.expectedStatus ?? {});
+		});
+		it("returns an async iterable from watchPayment", async () => {
+			const backend = await harness.createBackend();
+			const input = harness.createPaymentOptionInput ?? defaultPaymentOptionInput;
+			const option = await backend.createPaymentOption(input);
+			const stream = backend.watchPayment({
+				quoteId: input.quoteId,
+				payTo: option.payTo,
+				pollIntervalMs: 1,
+				timeoutMs: 1
+			});
+			expect(typeof stream[Symbol.asyncIterator]).toBe("function");
+			await expect(stream[Symbol.asyncIterator]().next()).resolves.toMatchObject({ value: expect.objectContaining({
+				backendId: backend.capabilities.id,
+				quoteId: input.quoteId
+			}) });
+		});
+		it("sends payouts through the backend payout surface", async () => {
+			const backend = await harness.createBackend();
+			const payout = await backend.sendPayout(harness.payoutInput ?? {
+				destination: "destination-conformance",
+				amount: 100,
+				currency: "USD"
+			});
+			expect(payout.backendId).toBe(backend.capabilities.id);
+			expect(payout.destination).toEqual(expect.any(String));
+			expect(payout.amount).toEqual(expect.any(Number));
+			expect(payout.currency).toEqual(expect.any(String));
+			expect(payout).toMatchObject(harness.expectedPayout ?? {});
+		});
+	});
 }
 function readGlobalConformanceTestApi() {
-  const candidate = globalThis;
-  if (typeof candidate.describe === "function" && typeof candidate.it === "function" && typeof candidate.expect === "function" && typeof candidate.expect.any === "function" && typeof candidate.expect.objectContaining === "function") {
-    return {
-      describe: candidate.describe,
-      expect: candidate.expect,
-      it: candidate.it
-    };
-  }
-  throw new Error(
-    "definePaymentBackendConformanceTests requires a test API. Pass { describe, expect, it } from Vitest or enable compatible test globals."
-  );
+	const candidate = globalThis;
+	if (typeof candidate.describe === "function" && typeof candidate.it === "function" && typeof candidate.expect === "function" && typeof candidate.expect.any === "function" && typeof candidate.expect.objectContaining === "function") return {
+		describe: candidate.describe,
+		expect: candidate.expect,
+		it: candidate.it
+	};
+	throw new Error("definePaymentBackendConformanceTests requires a test API. Pass { describe, expect, it } from Vitest or enable compatible test globals.");
 }
-export {
-  definePaymentBackendConformanceTests
-};
-//# sourceMappingURL=conformance.js.map
+//#endregion
+export { definePaymentBackendConformanceTests };
+
+//# sourceMappingURL=conformance.js.map

package/dist/testing/conformance.js.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.js","sources":["../../src/testing/conformance.ts"],"sourcesContent":["import type {\n  CreatePaymentOptionInput,\n  PaymentBackend,\n  PaymentBackendCapabilities,\n  PaymentOption,\n  PaymentStatusResult,\n  PayoutResult,\n} from '../types.js';\n\ntype ConformanceExpectation = {\n  toBe(expected: unknown): void;\n  toEqual(expected: unknown): void;\n  toBeGreaterThanOrEqual(expected: number): void;\n  toBeInstanceOf(expected: unknown): void;\n  toContain(expected: unknown): void;\n  toMatchObject(expected: unknown): void;\n  resolves: {\n    toMatchObject(expected: unknown): Promise<void>;\n  };\n};\n\ntype ConformanceExpect = ((actual: unknown) => ConformanceExpectation) & {\n  any(expected: unknown): unknown;\n  objectContaining(expected: Record<string, unknown>): unknown;\n};\n\nexport interface PaymentBackendConformanceTestApi {\n  describe(name: string, callback: () => void): void;\n  it(name: string, callback: () => void | Promise<void>): void;\n  expect: ConformanceExpect;\n}\n\nexport interface PaymentBackendConformanceHarness {\n  createBackend(): PaymentBackend | Promise<PaymentBackend>;\n  createPaymentOptionInput?: CreatePaymentOptionInput;\n  expectedCapabilities?: Partial<PaymentBackendCapabilities>;\n  expectedOption?: Partial<PaymentOption>;\n  expectedStatus?: Partial<PaymentStatusResult>;\n  payoutInput?: Parameters<PaymentBackend['sendPayout']>[0];\n  expectedPayout?: Partial<PayoutResult>;\n}\n\nconst futureExpiryOffsetMs = 365 * 24 * 60 * 60 * 1_000;\n\nconst defaultPaymentOptionInput: CreatePaymentOptionInput = {\n  quoteId: 'quote-conformance',\n  amount: 1234,\n  currency: 'USD',\n  expiresAt: new Date(Date.now() + futureExpiryOffsetMs),\n};\n\nexport function definePaymentBackendConformanceTests(\n  backendName: string,\n  harness: PaymentBackendConformanceHarness,\n  testApi = readGlobalConformanceTestApi(),\n): void {\n  const { describe, expect, it } = testApi;\n\n  describe(`${backendName} PaymentBackend conformance`, () => {\n    it('declares required capabilities', async () => {\n      const backend = await harness.createBackend();\n\n      expect(backend.capabilities.id).toEqual(expect.any(String));\n      expect(backend.capabilities.displayName).toEqual(expect.any(String));\n      expect(backend.capabilities.settlementCurrency).toEqual(\n        expect.any(String),\n      );\n      expect(backend.capabilities.chain).toEqual(expect.any(String));\n      expect(['address', 'url', 'psbt']).toContain(\n        backend.capabilities.settlementShape,\n      );\n      expect(typeof backend.capabilities.x402Capable).toBe('boolean');\n      expect(typeof backend.capabilities.supportsRefunds).toBe('boolean');\n      expect(typeof backend.capabilities.supportsPayouts).toBe('boolean');\n      expect(typeof backend.capabilities.supportsWebhooks).toBe('boolean');\n      expect(\n        backend.capabilities.confirmationLatency.expectedSeconds,\n      ).toBeGreaterThanOrEqual(0);\n      expect(backend.capabilities).toMatchObject(\n        harness.expectedCapabilities ?? {},\n      );\n    });\n\n    it('creates a payment option with stable quote metadata', async () => {\n      const backend = await harness.createBackend();\n      const input =\n        harness.createPaymentOptionInput ?? defaultPaymentOptionInput;\n      const option = await backend.createPaymentOption(input);\n\n      expect(option.backendId).toBe(backend.capabilities.id);\n      expect(option.quoteId).toBe(input.quoteId);\n      expect(option.payTo).toEqual(expect.any(String));\n      expect(option.settlementCurrency).toBe(\n        backend.capabilities.settlementCurrency,\n      );\n      expect(option.settlementShape).toBe(backend.capabilities.settlementShape);\n      expect(option.settlementAmount).toEqual(expect.any(Number));\n      expect(option.amount).toBe(input.amount);\n      expect(option.currency).toBe(input.currency);\n      expect(option.expiresAt).toBeInstanceOf(Date);\n      expect(option).toMatchObject(harness.expectedOption ?? {});\n    });\n\n    it('reports idempotent status for an option', async () => {\n      const backend = await harness.createBackend();\n      const input =\n        harness.createPaymentOptionInput ?? defaultPaymentOptionInput;\n      const option = await backend.createPaymentOption(input);\n      const status = await backend.getStatus(input.quoteId, option.payTo);\n\n      expect(status.backendId).toBe(backend.capabilities.id);\n      expect(status.quoteId).toBe(input.quoteId);\n      expect(status.payTo).toBe(option.payTo);\n      expect(status.updatedAt).toBeInstanceOf(Date);\n      expect(status).toMatchObject(harness.expectedStatus ?? {});\n    });\n\n    it('returns an async iterable from watchPayment', async () => {\n      const backend = await harness.createBackend();\n      const input =\n        harness.createPaymentOptionInput ?? defaultPaymentOptionInput;\n      const option = await backend.createPaymentOption(input);\n      const stream = backend.watchPayment({\n        quoteId: input.quoteId,\n        payTo: option.payTo,\n        pollIntervalMs: 1,\n        timeoutMs: 1,\n      });\n\n      expect(typeof stream[Symbol.asyncIterator]).toBe('function');\n      await expect(\n        stream[Symbol.asyncIterator]().next(),\n      ).resolves.toMatchObject({\n        value: expect.objectContaining({\n          backendId: backend.capabilities.id,\n          quoteId: input.quoteId,\n        }),\n      });\n    });\n\n    it('sends payouts through the backend payout surface', async () => {\n      const backend = await harness.createBackend();\n      const payout = await backend.sendPayout(\n        harness.payoutInput ?? {\n          destination: 'destination-conformance',\n          amount: 100,\n          currency: 'USD',\n        },\n      );\n\n      expect(payout.backendId).toBe(backend.capabilities.id);\n      expect(payout.destination).toEqual(expect.any(String));\n      expect(payout.amount).toEqual(expect.any(Number));\n      expect(payout.currency).toEqual(expect.any(String));\n      expect(payout).toMatchObject(harness.expectedPayout ?? {});\n    });\n  });\n}\n\nfunction readGlobalConformanceTestApi(): PaymentBackendConformanceTestApi {\n  const candidate = globalThis as {\n    describe?: unknown;\n    expect?: unknown;\n    it?: unknown;\n  };\n\n  if (\n    typeof candidate.describe === 'function' &&\n    typeof candidate.it === 'function' &&\n    typeof candidate.expect === 'function' &&\n    typeof (candidate.expect as { any?: unknown }).any === 'function' &&\n    typeof (candidate.expect as { objectContaining?: unknown })\n      .objectContaining === 'function'\n  ) {\n    return {\n      describe:\n        candidate.describe as PaymentBackendConformanceTestApi['describe'],\n      expect: candidate.expect as ConformanceExpect,\n      it: candidate.it as PaymentBackendConformanceTestApi['it'],\n    };\n  }\n\n  throw new Error(\n    'definePaymentBackendConformanceTests requires a test API. Pass { describe, expect, it } from Vitest or enable compatible test globals.',\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"conformance.js","names":[],"sources":["../../src/testing/conformance.ts"],"sourcesContent":["import type {\n  CreatePaymentOptionInput,\n  PaymentBackend,\n  PaymentBackendCapabilities,\n  PaymentOption,\n  PaymentStatusResult,\n  PayoutResult,\n} from '../types.js';\n\ntype ConformanceExpectation = {\n  toBe(expected: unknown): void;\n  toEqual(expected: unknown): void;\n  toBeGreaterThanOrEqual(expected: number): void;\n  toBeInstanceOf(expected: unknown): void;\n  toContain(expected: unknown): void;\n  toMatchObject(expected: unknown): void;\n  resolves: {\n    toMatchObject(expected: unknown): Promise<void>;\n  };\n};\n\ntype ConformanceExpect = ((actual: unknown) => ConformanceExpectation) & {\n  any(expected: unknown): unknown;\n  objectContaining(expected: Record<string, unknown>): unknown;\n};\n\nexport interface PaymentBackendConformanceTestApi {\n  describe(name: string, callback: () => void): void;\n  it(name: string, callback: () => void | Promise<void>): void;\n  expect: ConformanceExpect;\n}\n\nexport interface PaymentBackendConformanceHarness {\n  createBackend(): PaymentBackend | Promise<PaymentBackend>;\n  createPaymentOptionInput?: CreatePaymentOptionInput;\n  expectedCapabilities?: Partial<PaymentBackendCapabilities>;\n  expectedOption?: Partial<PaymentOption>;\n  expectedStatus?: Partial<PaymentStatusResult>;\n  payoutInput?: Parameters<PaymentBackend['sendPayout']>[0];\n  expectedPayout?: Partial<PayoutResult>;\n}\n\nconst futureExpiryOffsetMs = 365 * 24 * 60 * 60 * 1_000;\n\nconst defaultPaymentOptionInput: CreatePaymentOptionInput = {\n  quoteId: 'quote-conformance',\n  amount: 1234,\n  currency: 'USD',\n  expiresAt: new Date(Date.now() + futureExpiryOffsetMs),\n};\n\nexport function definePaymentBackendConformanceTests(\n  backendName: string,\n  harness: PaymentBackendConformanceHarness,\n  testApi = readGlobalConformanceTestApi(),\n): void {\n  const { describe, expect, it } = testApi;\n\n  describe(`${backendName} PaymentBackend conformance`, () => {\n    it('declares required capabilities', async () => {\n      const backend = await harness.createBackend();\n\n      expect(backend.capabilities.id).toEqual(expect.any(String));\n      expect(backend.capabilities.displayName).toEqual(expect.any(String));\n      expect(backend.capabilities.settlementCurrency).toEqual(\n        expect.any(String),\n      );\n      expect(backend.capabilities.chain).toEqual(expect.any(String));\n      expect(['address', 'url', 'psbt']).toContain(\n        backend.capabilities.settlementShape,\n      );\n      expect(typeof backend.capabilities.x402Capable).toBe('boolean');\n      expect(typeof backend.capabilities.supportsRefunds).toBe('boolean');\n      expect(typeof backend.capabilities.supportsPayouts).toBe('boolean');\n      expect(typeof backend.capabilities.supportsWebhooks).toBe('boolean');\n      expect(\n        backend.capabilities.confirmationLatency.expectedSeconds,\n      ).toBeGreaterThanOrEqual(0);\n      expect(backend.capabilities).toMatchObject(\n        harness.expectedCapabilities ?? {},\n      );\n    });\n\n    it('creates a payment option with stable quote metadata', async () => {\n      const backend = await harness.createBackend();\n      const input =\n        harness.createPaymentOptionInput ?? defaultPaymentOptionInput;\n      const option = await backend.createPaymentOption(input);\n\n      expect(option.backendId).toBe(backend.capabilities.id);\n      expect(option.quoteId).toBe(input.quoteId);\n      expect(option.payTo).toEqual(expect.any(String));\n      expect(option.settlementCurrency).toBe(\n        backend.capabilities.settlementCurrency,\n      );\n      expect(option.settlementShape).toBe(backend.capabilities.settlementShape);\n      expect(option.settlementAmount).toEqual(expect.any(Number));\n      expect(option.amount).toBe(input.amount);\n      expect(option.currency).toBe(input.currency);\n      expect(option.expiresAt).toBeInstanceOf(Date);\n      expect(option).toMatchObject(harness.expectedOption ?? {});\n    });\n\n    it('reports idempotent status for an option', async () => {\n      const backend = await harness.createBackend();\n      const input =\n        harness.createPaymentOptionInput ?? defaultPaymentOptionInput;\n      const option = await backend.createPaymentOption(input);\n      const status = await backend.getStatus(input.quoteId, option.payTo);\n\n      expect(status.backendId).toBe(backend.capabilities.id);\n      expect(status.quoteId).toBe(input.quoteId);\n      expect(status.payTo).toBe(option.payTo);\n      expect(status.updatedAt).toBeInstanceOf(Date);\n      expect(status).toMatchObject(harness.expectedStatus ?? {});\n    });\n\n    it('returns an async iterable from watchPayment', async () => {\n      const backend = await harness.createBackend();\n      const input =\n        harness.createPaymentOptionInput ?? defaultPaymentOptionInput;\n      const option = await backend.createPaymentOption(input);\n      const stream = backend.watchPayment({\n        quoteId: input.quoteId,\n        payTo: option.payTo,\n        pollIntervalMs: 1,\n        timeoutMs: 1,\n      });\n\n      expect(typeof stream[Symbol.asyncIterator]).toBe('function');\n      await expect(\n        stream[Symbol.asyncIterator]().next(),\n      ).resolves.toMatchObject({\n        value: expect.objectContaining({\n          backendId: backend.capabilities.id,\n          quoteId: input.quoteId,\n        }),\n      });\n    });\n\n    it('sends payouts through the backend payout surface', async () => {\n      const backend = await harness.createBackend();\n      const payout = await backend.sendPayout(\n        harness.payoutInput ?? {\n          destination: 'destination-conformance',\n          amount: 100,\n          currency: 'USD',\n        },\n      );\n\n      expect(payout.backendId).toBe(backend.capabilities.id);\n      expect(payout.destination).toEqual(expect.any(String));\n      expect(payout.amount).toEqual(expect.any(Number));\n      expect(payout.currency).toEqual(expect.any(String));\n      expect(payout).toMatchObject(harness.expectedPayout ?? {});\n    });\n  });\n}\n\nfunction readGlobalConformanceTestApi(): PaymentBackendConformanceTestApi {\n  const candidate = globalThis as {\n    describe?: unknown;\n    expect?: unknown;\n    it?: unknown;\n  };\n\n  if (\n    typeof candidate.describe === 'function' &&\n    typeof candidate.it === 'function' &&\n    typeof candidate.expect === 'function' &&\n    typeof (candidate.expect as { any?: unknown }).any === 'function' &&\n    typeof (candidate.expect as { objectContaining?: unknown })\n      .objectContaining === 'function'\n  ) {\n    return {\n      describe:\n        candidate.describe as PaymentBackendConformanceTestApi['describe'],\n      expect: candidate.expect as ConformanceExpect,\n      it: candidate.it as PaymentBackendConformanceTestApi['it'],\n    };\n  }\n\n  throw new Error(\n    'definePaymentBackendConformanceTests requires a test API. Pass { describe, expect, it } from Vitest or enable compatible test globals.',\n  );\n}\n"],"mappings":"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"}

package/metadata.json

@@ -3,7 +3,7 @@
   "path": "packages/payments",
   "position": {
     "index": 20,
-    "count": 31
+    "count": 32
   },
   "description": "Payment backend abstraction with adapters for Base USDC, BTCPay Server, and Stripe",
   "provides": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/payments",
-  "version": "0.79.0",
+  "version": "0.80.1",
   "description": "Payment backend abstraction with adapters for Base USDC, BTCPay Server, and Stripe",
   "type": "module",
   "main": "./dist/index.js",
@@ -69,11 +69,11 @@
     "@noble/hashes": "2.0.1",
     "@scure/bip32": "2.0.1",
     "@types/node": "24.12.2",
-    "@vitest/coverage-v8": "4.1.5",
-    "typescript": "^5.9.3",
-    "vite": "7.3.2",
+    "@vitest/coverage-v8": "4.1.10",
+    "typescript": "5.9.3",
+    "vite": "8.1.4",
     "vite-plugin-dts": "4.5.4",
-    "vitest": "^4.1.5"
+    "vitest": "4.1.10"
   },
   "scripts": {
     "test": "vitest --config ../../vitest.package.config.ts run",

package/dist/chunks/errors-BgFC46qQ.js

@@ -1,45 +0,0 @@
-class PaymentError extends Error {
-  code;
-  retryable;
-  constructor(message, code = "PAYMENT_PROVIDER_ERROR", options = {}) {
-    super(
-      message,
-      options.cause === void 0 ? void 0 : { cause: options.cause }
-    );
-    this.name = "PaymentError";
-    this.code = code;
-    this.retryable = options.retryable ?? false;
-  }
-}
-class PaymentConfigurationError extends PaymentError {
-  constructor(message, options = {}) {
-    super(message, "PAYMENT_CONFIGURATION_ERROR", options);
-    this.name = "PaymentConfigurationError";
-  }
-}
-class PaymentProviderError extends PaymentError {
-  constructor(message, options = {}) {
-    super(message, "PAYMENT_PROVIDER_ERROR", options);
-    this.name = "PaymentProviderError";
-  }
-}
-class PaymentUnsupportedError extends PaymentError {
-  constructor(message, options = {}) {
-    super(message, "PAYMENT_UNSUPPORTED", options);
-    this.name = "PaymentUnsupportedError";
-  }
-}
-class PaymentVerificationError extends PaymentError {
-  constructor(message, options = {}) {
-    super(message, "PAYMENT_VERIFICATION_FAILED", options);
-    this.name = "PaymentVerificationError";
-  }
-}
-export {
-  PaymentConfigurationError as P,
-  PaymentError as a,
-  PaymentProviderError as b,
-  PaymentUnsupportedError as c,
-  PaymentVerificationError as d
-};
-//# sourceMappingURL=errors-BgFC46qQ.js.map

package/dist/chunks/errors-BgFC46qQ.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-BgFC46qQ.js","sources":["../../src/errors.ts"],"sourcesContent":["export type PaymentErrorCode =\n  | 'PAYMENT_CONFIGURATION_ERROR'\n  | 'PAYMENT_PROVIDER_ERROR'\n  | 'PAYMENT_UNSUPPORTED'\n  | 'PAYMENT_VERIFICATION_FAILED'\n  | 'PAYMENT_TIMEOUT'\n  | 'PAYMENT_INVALID_INPUT';\n\nexport class PaymentError extends Error {\n  readonly code: PaymentErrorCode;\n  readonly retryable: boolean;\n\n  constructor(\n    message: string,\n    code: PaymentErrorCode = 'PAYMENT_PROVIDER_ERROR',\n    options: { cause?: unknown; retryable?: boolean } = {},\n  ) {\n    super(\n      message,\n      options.cause === undefined ? undefined : { cause: options.cause },\n    );\n    this.name = 'PaymentError';\n    this.code = code;\n    this.retryable = options.retryable ?? false;\n  }\n}\n\nexport class PaymentConfigurationError extends PaymentError {\n  constructor(message: string, options: { cause?: unknown } = {}) {\n    super(message, 'PAYMENT_CONFIGURATION_ERROR', options);\n    this.name = 'PaymentConfigurationError';\n  }\n}\n\nexport class PaymentProviderError extends PaymentError {\n  constructor(\n    message: string,\n    options: { cause?: unknown; retryable?: boolean } = {},\n  ) {\n    super(message, 'PAYMENT_PROVIDER_ERROR', options);\n    this.name = 'PaymentProviderError';\n  }\n}\n\nexport class PaymentUnsupportedError extends PaymentError {\n  constructor(message: string, options: { cause?: unknown } = {}) {\n    super(message, 'PAYMENT_UNSUPPORTED', options);\n    this.name = 'PaymentUnsupportedError';\n  }\n}\n\nexport class PaymentVerificationError extends PaymentError {\n  constructor(message: string, options: { cause?: unknown } = {}) {\n    super(message, 'PAYMENT_VERIFICATION_FAILED', options);\n    this.name = 'PaymentVerificationError';\n  }\n}\n"],"names":[],"mappings":"AAQO,MAAM,qBAAqB,MAAM;AAAA,EAC7B;AAAA,EACA;AAAA,EAET,YACE,SACA,OAAyB,0BACzB,UAAoD,CAAA,GACpD;AACA;AAAA,MACE;AAAA,MACA,QAAQ,UAAU,SAAY,SAAY,EAAE,OAAO,QAAQ,MAAA;AAAA,IAAM;AAEnE,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,YAAY,QAAQ,aAAa;AAAA,EACxC;AACF;AAEO,MAAM,kCAAkC,aAAa;AAAA,EAC1D,YAAY,SAAiB,UAA+B,IAAI;AAC9D,UAAM,SAAS,+BAA+B,OAAO;AACrD,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,6BAA6B,aAAa;AAAA,EACrD,YACE,SACA,UAAoD,IACpD;AACA,UAAM,SAAS,0BAA0B,OAAO;AAChD,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,gCAAgC,aAAa;AAAA,EACxD,YAAY,SAAiB,UAA+B,IAAI;AAC9D,UAAM,SAAS,uBAAuB,OAAO;AAC7C,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,iCAAiC,aAAa;AAAA,EACzD,YAAY,SAAiB,UAA+B,IAAI;AAC9D,UAAM,SAAS,+BAA+B,OAAO;AACrD,SAAK,OAAO;AAAA,EACd;AACF;"}