@happyvertical/payments 0.74.8

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @happyvertical/payments - Multi-backend payment provider abstraction.
+ *
+ * The default entrypoint exports only provider contracts, shared errors, and
+ * the dynamic factory. Adapter implementations live behind subpath exports:
+ * `@happyvertical/payments/base-usdc`, `@happyvertical/payments/btc`, and
+ * `@happyvertical/payments/stripe`.
+ */
+export * from './errors.js';
+export * from './factory.js';
+export * from './types.js';
+/** @internal */
+export declare const PACKAGE_VERSION_INITIALIZED = true;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import { P as PaymentConfigurationError } from "./chunks/errors-BgFC46qQ.js";
+import { a, b, c, d } from "./chunks/errors-BgFC46qQ.js";
+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}`
+      );
+  }
+}
+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

package/dist/index.js.map

@@ -0,0 +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;"}

package/dist/shared.d.ts

@@ -0,0 +1,32 @@
+import { PaymentEvent, PaymentStatus, PaymentStatusResult, WatchPaymentInput } from './types.js';
+export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export declare const TERMINAL_PAYMENT_STATUSES: Set<PaymentStatus>;
+export declare const DEFAULT_MAX_STORED_PAYMENT_OPTIONS = 1000;
+export declare function getFetch(fetchLike?: FetchLike): FetchLike;
+export declare function normalizeDate(value: Date | string): Date;
+export declare function normalizeFutureDate(value: Date | string, context: string): Date;
+export declare function normalizeAmount(value: string): string;
+export declare function normalizePositiveAmount(value: string, context: string): string;
+export declare function normalizeCurrency(value: string, context: string): string;
+export declare function normalizeMinorUnitAmount(value: number, context: string): number;
+export declare function normalizePositiveMinorUnitAmount(value: number, context: string): number;
+export declare function normalizePositivePaymentAmount(value: number, currency: string, context: string): number;
+export declare function normalizeMaxStoredPaymentOptions(value: number | undefined, context: string): number;
+export declare function rememberPaymentOption<TOption>(optionsByQuote: Map<string, TOption>, quoteId: string, option: TOption, maxStoredPaymentOptions: number): void;
+export declare function normalizeNonEmptyString(value: string, context: string): string;
+export declare function normalizeUrlString(value: string, context: string): string;
+export declare function decimalToAtomicUnits(value: string, decimals: number): string;
+export declare function atomicUnitsToDecimal(value: string | bigint, decimals: number): string;
+export declare function amountToMinorUnits(value: string, decimals?: number): string;
+export declare function minorUnitsToDecimal(value: number, decimals: number): string;
+export declare function decimalToMinorUnitAmount(value: string | bigint, decimals: number, context: string): number;
+export declare function currencyMinorUnitDecimals(currency: string): number;
+export declare function applyExpiryToPendingStatus(status: PaymentStatus, expiresAt?: Date): PaymentStatus;
+export declare function compareDecimalAmounts(left: string, right: string): -1 | 0 | 1;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export declare function pollPaymentStatus(input: WatchPaymentInput, getStatus: () => Promise<PaymentStatusResult>): AsyncIterable<PaymentEvent>;
+export declare function toPaymentEvent(status: PaymentStatusResult): PaymentEvent;
+export declare function readJsonResponse<T>(response: Response, context: string): Promise<T>;
+export declare function formEncode(params: Record<string, unknown>): string;
+export declare function throwUnsupported(message: string): never;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}

package/dist/testing/conformance.d.ts

@@ -0,0 +1,33 @@
+import { CreatePaymentOptionInput, PaymentBackend, PaymentBackendCapabilities, PaymentOption, PaymentStatusResult, PayoutResult } from '../types.js';
+type ConformanceExpectation = {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toBeGreaterThanOrEqual(expected: number): void;
+    toBeInstanceOf(expected: unknown): void;
+    toContain(expected: unknown): void;
+    toMatchObject(expected: unknown): void;
+    resolves: {
+        toMatchObject(expected: unknown): Promise<void>;
+    };
+};
+type ConformanceExpect = ((actual: unknown) => ConformanceExpectation) & {
+    any(expected: unknown): unknown;
+    objectContaining(expected: Record<string, unknown>): unknown;
+};
+export interface PaymentBackendConformanceTestApi {
+    describe(name: string, callback: () => void): void;
+    it(name: string, callback: () => void | Promise<void>): void;
+    expect: ConformanceExpect;
+}
+export interface PaymentBackendConformanceHarness {
+    createBackend(): PaymentBackend | Promise<PaymentBackend>;
+    createPaymentOptionInput?: CreatePaymentOptionInput;
+    expectedCapabilities?: Partial<PaymentBackendCapabilities>;
+    expectedOption?: Partial<PaymentOption>;
+    expectedStatus?: Partial<PaymentStatusResult>;
+    payoutInput?: Parameters<PaymentBackend['sendPayout']>[0];
+    expectedPayout?: Partial<PayoutResult>;
+}
+export declare function definePaymentBackendConformanceTests(backendName: string, harness: PaymentBackendConformanceHarness, testApi?: PaymentBackendConformanceTestApi): void;
+export {};
+//# sourceMappingURL=conformance.d.ts.map

package/dist/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,aAAa,EACb,mBAAmB,EACnB,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,KAAK,sBAAsB,GAAG;IAC5B,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE;QACR,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACjD,CAAC;CACH,CAAC;AAEF,KAAK,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,sBAAsB,CAAC,GAAG;IACvE,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9D,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,IAAI,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,oBAAoB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACxC;AAWD,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,gCAAgC,EACzC,OAAO,mCAAiC,GACvC,IAAI,CAsGN"}

package/dist/testing/conformance.js

@@ -0,0 +1,114 @@
+const futureExpiryOffsetMs = 365 * 24 * 60 * 60 * 1e3;
+const defaultPaymentOptionInput = {
+  quoteId: "quote-conformance",
+  amount: 1234,
+  currency: "USD",
+  expiresAt: new Date(Date.now() + futureExpiryOffsetMs)
+};
+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 ?? {});
+    });
+  });
+}
+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."
+  );
+}
+export {
+  definePaymentBackendConformanceTests
+};
+//# sourceMappingURL=conformance.js.map

package/dist/testing/conformance.js.map

@@ -0,0 +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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"}

package/dist/types.d.ts

@@ -0,0 +1,174 @@
+export type PaymentSettlementShape = 'address' | 'url' | 'psbt';
+export type PaymentStatus = 'pending' | 'processing' | 'confirmed' | 'failed' | 'expired' | 'refunded' | 'requires_action';
+export interface PaymentConfirmationLatency {
+    expectedSeconds: number;
+    minConfirmations?: number;
+    maxExpectedSeconds?: number;
+    description?: string;
+}
+export interface PaymentBackendCapabilities {
+    id: string;
+    displayName: string;
+    settlementCurrency: string;
+    supportedSettlementCurrencies?: string[];
+    chain: string;
+    settlementShape: PaymentSettlementShape;
+    x402Capable: boolean;
+    confirmationLatency: PaymentConfirmationLatency;
+    supportsRefunds: boolean;
+    supportsPayouts: boolean;
+    supportsWebhooks: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface CreatePaymentOptionInput {
+    quoteId: string;
+    amount: number;
+    currency: string;
+    expiresAt: Date | string;
+    idempotencyKey?: string;
+    buyerEmail?: string;
+    description?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    metadata?: Record<string, string | number | boolean | null | undefined>;
+}
+export interface PaymentOption {
+    backendId: string;
+    quoteId: string;
+    payTo: string;
+    settlementShape: PaymentSettlementShape;
+    settlementCurrency: string;
+    settlementAmount: number;
+    amount: number;
+    currency: string;
+    expiresAt: Date;
+    memo?: string;
+    providerPaymentId?: string;
+    paymentUri?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PaymentStatusResult {
+    backendId: string;
+    quoteId: string;
+    payTo: string;
+    status: PaymentStatus;
+    settlementCurrency: string;
+    settlementAmount?: number;
+    receivedAmount?: number;
+    amount?: number;
+    currency?: string;
+    requiredConfirmations?: number;
+    confirmations?: number;
+    transactionId?: string;
+    providerPaymentId?: string;
+    updatedAt: Date;
+    raw?: unknown;
+}
+export interface PaymentStatusContext {
+    settlementAmount?: number;
+    amount?: number;
+    currency?: string;
+    expiresAt?: Date | string;
+    providerPaymentId?: string;
+    requiredConfirmations?: number;
+    searchStartBlock?: string | number | bigint;
+    metadata?: Record<string, unknown>;
+}
+export interface WatchPaymentInput {
+    quoteId: string;
+    payTo: string;
+    signal?: AbortSignal;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    statusContext?: PaymentStatusContext;
+}
+export interface PaymentEvent extends PaymentStatusResult {
+    event: 'status' | 'confirmed' | 'failed' | 'expired' | 'refunded' | 'timeout';
+}
+export interface PaymentWebhookEvent {
+    id?: string;
+    deliveryId?: string;
+    invoiceId?: string;
+    quoteId?: string;
+    type?: string;
+    status: PaymentStatus;
+    providerPaymentId?: string;
+    duplicate?: boolean;
+    raw: unknown;
+}
+export interface VerifyX402ProofInput {
+    paymentHeader: string;
+    quoteId: string;
+    payTo: string;
+    amount: number;
+    currency: string;
+    resource?: string;
+    method?: string;
+    network?: string;
+    scheme?: string;
+    expiresAt?: Date | string;
+}
+export interface X402VerificationResult {
+    valid: boolean;
+    backendId: string;
+    quoteId: string;
+    payTo: string;
+    transactionId?: string;
+    payer?: string;
+    amount?: number;
+    currency?: string;
+    network?: string;
+    reason?: string;
+    raw?: unknown;
+}
+export interface SendPayoutInput {
+    destination: string;
+    amount: number;
+    currency?: string;
+    quoteId?: string;
+    idempotencyKey?: string;
+    memo?: string;
+    metadata?: Record<string, string | number | boolean | null | undefined>;
+}
+export interface PayoutResult {
+    backendId: string;
+    status: 'submitted' | 'pending_signature' | 'requires_action' | 'failed';
+    payoutId?: string;
+    transactionId?: string;
+    psbt?: string;
+    destination: string;
+    amount: number;
+    currency: string;
+    raw?: unknown;
+}
+export interface RefundPaymentInput {
+    paymentId?: string;
+    transactionId?: string;
+    destination?: string;
+    amount?: number;
+    currency?: string;
+    idempotencyKey?: string;
+    reason?: string;
+    metadata?: Record<string, string | number | boolean | null | undefined>;
+}
+export interface RefundResult {
+    backendId: string;
+    status: 'submitted' | 'succeeded' | 'failed' | 'requires_action';
+    refundId?: string;
+    transactionId?: string;
+    amount?: number;
+    currency?: string;
+    raw?: unknown;
+}
+export interface PaymentBackend {
+    readonly capabilities: PaymentBackendCapabilities;
+    createPaymentOption(input: CreatePaymentOptionInput): Promise<PaymentOption>;
+    watchPayment(input: WatchPaymentInput): AsyncIterable<PaymentEvent>;
+    getStatus(quoteId: string, payTo: string, context?: PaymentStatusContext): Promise<PaymentStatusResult>;
+    verifyX402Proof?(input: VerifyX402ProofInput): Promise<X402VerificationResult>;
+    sendPayout(input: SendPayoutInput): Promise<PayoutResult>;
+    refundPayment?(input: RefundPaymentInput): Promise<RefundResult>;
+    parseWebhookEvent?(payload: string, signature?: string): PaymentWebhookEvent;
+}
+export type PaymentBackendFactory<TOptions> = (options: TOptions) => PaymentBackend | Promise<PaymentBackend>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/metadata.json

@@ -0,0 +1,30 @@
+{
+  "name": "@happyvertical/payments",
+  "path": "packages/payments",
+  "position": {
+    "index": 20,
+    "count": 30
+  },
+  "description": "Payment backend abstraction with adapters for Base USDC, BTCPay Server, and Stripe",
+  "provides": [
+    "Payment backend abstraction with adapters for Base USDC, BTCPay Server, and Stripe"
+  ],
+  "implements": [],
+  "requires": {
+    "workspace": [],
+    "externalHappyVertical": [],
+    "external": [
+      "@noble/curves",
+      "@noble/hashes",
+      "@scure/bip32"
+    ]
+  },
+  "dependents": [],
+  "stability": {
+    "level": "stable",
+    "reason": "Primary package surface is described as implemented and production-oriented."
+  },
+  "keywords": [
+    "payments"
+  ]
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@happyvertical/payments",
+  "version": "0.74.8",
+  "description": "Payment backend abstraction with adapters for Base USDC, BTCPay Server, and Stripe",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./base-usdc": {
+      "types": "./dist/adapters/base-usdc.d.ts",
+      "import": "./dist/adapters/base-usdc.js"
+    },
+    "./btc": {
+      "types": "./dist/adapters/btc.d.ts",
+      "import": "./dist/adapters/btc.js"
+    },
+    "./stripe": {
+      "types": "./dist/adapters/stripe.d.ts",
+      "import": "./dist/adapters/stripe.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/conformance.d.ts",
+      "import": "./dist/testing/conformance.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENT.md",
+    "metadata.json"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/sdk.git",
+    "directory": "packages/payments"
+  },
+  "bugs": {
+    "url": "https://github.com/happyvertical/sdk/issues"
+  },
+  "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/payments#readme",
+  "license": "MIT",
+  "peerDependencies": {
+    "@noble/curves": "~2.0.1",
+    "@noble/hashes": "~2.0.1",
+    "@scure/bip32": "~2.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@noble/curves": {
+      "optional": true
+    },
+    "@noble/hashes": {
+      "optional": true
+    },
+    "@scure/bip32": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@noble/curves": "2.0.1",
+    "@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",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "test": "npx vitest run",
+    "test:watch": "npx vitest",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "docs": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules",
+    "docs:watch": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules --watch",
+    "clean": "rm -rf dist docs",
+    "dev": "npm run build:watch & npm run test:watch"
+  }
+}