@happyvertical/payments 0.92.0 → 0.95.0

package/dist/checkout-gateway.d.ts

@@ -0,0 +1,119 @@
+import { PaymentError } from './errors.js';
+/**
+ * `getCheckout` was asked for a checkout this gateway did not create (for
+ * example a webhook for an invoice made by hand at the provider). Callers
+ * acknowledge and ignore it, like an event with `checkoutId: null`. Its code
+ * is `PAYMENT_NOT_OWNED` — routine, and distinct from the
+ * `PAYMENT_VERIFICATION_FAILED` of a forged or foreign-store delivery.
+ */
+export declare class CryptoCheckoutNotOwnedError extends PaymentError {
+    readonly checkoutId: string;
+    constructor(checkoutId: string);
+}
+/** Where a checkout is in its lifecycle. */
+export type CryptoCheckoutStatus = 
+/** Awaiting payment; the rate is locked until `expiresAt`. */
+'open'
+/** Enough has been paid but is not yet settled (for example 0-conf). */
+ | 'confirming'
+/** Settled under the gateway's confirmation policy. */
+ | 'settled'
+/** The rate lock ran out without a full, settled payment. */
+ | 'expired'
+/** The gateway invalidated it (for example a payment was double-spent or reorganized away). */
+ | 'invalid';
+/** A qualifier that needs a decision beyond the status. */
+export type CryptoCheckoutException = 'none'
+/** Less than the price was received. */
+ | 'underpaid'
+/** More than the price was received. */
+ | 'overpaid'
+/** Payment arrived after the rate lock expired. */
+ | 'paid_late'
+/** An operator marked it settled by hand at the gateway. */
+ | 'manually_marked';
+export interface CryptoCheckoutPayment {
+    id: string;
+    /** The asset paid, for example `BTC`. */
+    asset: string;
+    /** `onchain`, `lightning`, or a gateway-specific rail name. */
+    rail: string;
+    /** Decimal amount of `asset`. */
+    amount: string;
+    /** Decimal network or processing fee in `asset`, when reported. */
+    fee?: string;
+    status: 'confirming' | 'settled' | 'invalid';
+    /** Chain transaction id, for on-chain payments. */
+    transactionId?: string;
+    receivedAt?: Date;
+}
+export interface CryptoCheckout {
+    /** The gateway implementation id (`btcpay`, …). */
+    gateway: string;
+    id: string;
+    orderId?: string;
+    status: CryptoCheckoutStatus;
+    exception: CryptoCheckoutException;
+    /** Locked fiat price, integer minor units of `currency`. */
+    amount: number;
+    currency: string;
+    /** Fiat value received at the locked rate, minor units, rounded down. */
+    amountPaid: number;
+    /** The asset the price was quoted in (`BTC`), when known. */
+    settlementAsset?: string;
+    /** Decimal amount of `settlementAsset` the price required. */
+    nativeAmountDue?: string;
+    /** Decimal amount of `settlementAsset` received across payments. */
+    nativeAmountPaid?: string;
+    /** Decimal price of one `settlementAsset` in `currency`, as locked. */
+    rate?: string;
+    /** Where the rate came from, when the gateway or its operator says. */
+    rateSource?: string;
+    checkoutUrl?: string;
+    createdAt?: Date;
+    expiresAt?: Date;
+    metadata: Record<string, string>;
+    payments: CryptoCheckoutPayment[];
+    /** The gateway's own representation, for audit only. */
+    raw: unknown;
+}
+export interface CreateCryptoCheckoutInput {
+    /** Caller-owned order id; creation is idempotent by it. */
+    orderId: string;
+    /** Price in integer minor units of `currency`. */
+    amount: number;
+    currency: string;
+    description?: string;
+    buyerEmail?: string;
+    /** String metadata stored on the checkout and returned verbatim (only these keys). */
+    metadata?: Record<string, string>;
+    /** Where the payer is sent after paying. */
+    redirectUrl?: string;
+}
+/** An authenticated webhook delivery. Re-read the checkout to act on it. */
+export interface CryptoCheckoutEvent {
+    /** Stable across redeliveries of the same event. */
+    eventId: string;
+    /** The checkout the event is about; `null` for events about no checkout (acknowledge and ignore). */
+    checkoutId: string | null;
+    /** The gateway's event type, for logging. */
+    type: string;
+    redelivery: boolean;
+}
+export interface CryptoCheckoutGateway {
+    readonly id: string;
+    /** Return the live checkout for `orderId`, or create one. */
+    createCheckout(input: CreateCryptoCheckoutInput): Promise<CryptoCheckout>;
+    /** Throws `CryptoCheckoutNotOwnedError` for a checkout it did not create. */
+    getCheckout(checkoutId: string): Promise<CryptoCheckout>;
+    listCheckouts(input: {
+        orderId: string;
+    }): Promise<CryptoCheckout[]>;
+    /**
+     * Authenticate and parse a webhook delivery. Throws
+     * `PaymentVerificationError` for a bad signature or a delivery that does
+     * not belong to this gateway.
+     */
+    verifyWebhook(rawBody: string, headers: Headers | Record<string, string | undefined>): CryptoCheckoutEvent;
+}
+//# sourceMappingURL=checkout-gateway.d.ts.map

package/dist/checkout-gateway.d.ts.map

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

package/dist/chunks/checkout-gateway-DG-LY0oG.js

@@ -0,0 +1,42 @@
+import { n as PaymentError } from "./errors-feZrwnTy.js";
+//#region src/checkout-gateway.ts
+/**
+* A provider-neutral port for **hosted crypto checkouts priced in fiat**.
+*
+* Billing code (for example smrt-commerce) talks only to this interface. The
+* BTCPay implementation (`createBtcpayCheckoutGateway` in
+* `@happyvertical/payments/btcpay`) is one adapter; a dedicated crypto-payments
+* service client can implement the same port later without changing callers.
+*
+* Rules every implementation keeps:
+*
+* - **Settlement belongs to the gateway.** `status: 'settled'` means the
+*   gateway's own confirmation policy is met. Callers never count
+*   confirmations.
+* - **Fiat is exact.** `amount` and `amountPaid` are integer minor units of
+*   `currency`; `amountPaid` is rounded down.
+* - **Webhooks carry ids only.** `verifyWebhook` authenticates a delivery and
+*   names the checkout; callers act on `getCheckout()`, never on the body.
+* - **Creation is idempotent by `orderId`.** A live checkout for the order is
+*   returned instead of creating another; an expired or invalid one is not
+*   revived.
+*/
+/**
+* `getCheckout` was asked for a checkout this gateway did not create (for
+* example a webhook for an invoice made by hand at the provider). Callers
+* acknowledge and ignore it, like an event with `checkoutId: null`. Its code
+* is `PAYMENT_NOT_OWNED` — routine, and distinct from the
+* `PAYMENT_VERIFICATION_FAILED` of a forged or foreign-store delivery.
+*/
+var CryptoCheckoutNotOwnedError = class extends PaymentError {
+	checkoutId;
+	constructor(checkoutId) {
+		super(`Checkout ${checkoutId} was not created by this gateway.`, "PAYMENT_NOT_OWNED");
+		this.name = "CryptoCheckoutNotOwnedError";
+		this.checkoutId = checkoutId;
+	}
+};
+//#endregion
+export { CryptoCheckoutNotOwnedError as t };
+
+//# sourceMappingURL=checkout-gateway-DG-LY0oG.js.map

package/dist/chunks/checkout-gateway-DG-LY0oG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-gateway-DG-LY0oG.js","names":[],"sources":["../../src/checkout-gateway.ts"],"sourcesContent":["/**\n * A provider-neutral port for **hosted crypto checkouts priced in fiat**.\n *\n * Billing code (for example smrt-commerce) talks only to this interface. The\n * BTCPay implementation (`createBtcpayCheckoutGateway` in\n * `@happyvertical/payments/btcpay`) is one adapter; a dedicated crypto-payments\n * service client can implement the same port later without changing callers.\n *\n * Rules every implementation keeps:\n *\n * - **Settlement belongs to the gateway.** `status: 'settled'` means the\n *   gateway's own confirmation policy is met. Callers never count\n *   confirmations.\n * - **Fiat is exact.** `amount` and `amountPaid` are integer minor units of\n *   `currency`; `amountPaid` is rounded down.\n * - **Webhooks carry ids only.** `verifyWebhook` authenticates a delivery and\n *   names the checkout; callers act on `getCheckout()`, never on the body.\n * - **Creation is idempotent by `orderId`.** A live checkout for the order is\n *   returned instead of creating another; an expired or invalid one is not\n *   revived.\n */\n\nimport { PaymentError } from './errors.js';\n\n/**\n * `getCheckout` was asked for a checkout this gateway did not create (for\n * example a webhook for an invoice made by hand at the provider). Callers\n * acknowledge and ignore it, like an event with `checkoutId: null`. Its code\n * is `PAYMENT_NOT_OWNED` — routine, and distinct from the\n * `PAYMENT_VERIFICATION_FAILED` of a forged or foreign-store delivery.\n */\nexport class CryptoCheckoutNotOwnedError extends PaymentError {\n  readonly checkoutId: string;\n\n  constructor(checkoutId: string) {\n    super(\n      `Checkout ${checkoutId} was not created by this gateway.`,\n      'PAYMENT_NOT_OWNED',\n    );\n    this.name = 'CryptoCheckoutNotOwnedError';\n    this.checkoutId = checkoutId;\n  }\n}\n\n/** Where a checkout is in its lifecycle. */\nexport type CryptoCheckoutStatus =\n  /** Awaiting payment; the rate is locked until `expiresAt`. */\n  | 'open'\n  /** Enough has been paid but is not yet settled (for example 0-conf). */\n  | 'confirming'\n  /** Settled under the gateway's confirmation policy. */\n  | 'settled'\n  /** The rate lock ran out without a full, settled payment. */\n  | 'expired'\n  /** The gateway invalidated it (for example a payment was double-spent or reorganized away). */\n  | 'invalid';\n\n/** A qualifier that needs a decision beyond the status. */\nexport type CryptoCheckoutException =\n  | 'none'\n  /** Less than the price was received. */\n  | 'underpaid'\n  /** More than the price was received. */\n  | 'overpaid'\n  /** Payment arrived after the rate lock expired. */\n  | 'paid_late'\n  /** An operator marked it settled by hand at the gateway. */\n  | 'manually_marked';\n\nexport interface CryptoCheckoutPayment {\n  id: string;\n  /** The asset paid, for example `BTC`. */\n  asset: string;\n  /** `onchain`, `lightning`, or a gateway-specific rail name. */\n  rail: string;\n  /** Decimal amount of `asset`. */\n  amount: string;\n  /** Decimal network or processing fee in `asset`, when reported. */\n  fee?: string;\n  status: 'confirming' | 'settled' | 'invalid';\n  /** Chain transaction id, for on-chain payments. */\n  transactionId?: string;\n  receivedAt?: Date;\n}\n\nexport interface CryptoCheckout {\n  /** The gateway implementation id (`btcpay`, …). */\n  gateway: string;\n  id: string;\n  orderId?: string;\n  status: CryptoCheckoutStatus;\n  exception: CryptoCheckoutException;\n  /** Locked fiat price, integer minor units of `currency`. */\n  amount: number;\n  currency: string;\n  /** Fiat value received at the locked rate, minor units, rounded down. */\n  amountPaid: number;\n  /** The asset the price was quoted in (`BTC`), when known. */\n  settlementAsset?: string;\n  /** Decimal amount of `settlementAsset` the price required. */\n  nativeAmountDue?: string;\n  /** Decimal amount of `settlementAsset` received across payments. */\n  nativeAmountPaid?: string;\n  /** Decimal price of one `settlementAsset` in `currency`, as locked. */\n  rate?: string;\n  /** Where the rate came from, when the gateway or its operator says. */\n  rateSource?: string;\n  checkoutUrl?: string;\n  createdAt?: Date;\n  expiresAt?: Date;\n  metadata: Record<string, string>;\n  payments: CryptoCheckoutPayment[];\n  /** The gateway's own representation, for audit only. */\n  raw: unknown;\n}\n\nexport interface CreateCryptoCheckoutInput {\n  /** Caller-owned order id; creation is idempotent by it. */\n  orderId: string;\n  /** Price in integer minor units of `currency`. */\n  amount: number;\n  currency: string;\n  description?: string;\n  buyerEmail?: string;\n  /** String metadata stored on the checkout and returned verbatim (only these keys). */\n  metadata?: Record<string, string>;\n  /** Where the payer is sent after paying. */\n  redirectUrl?: string;\n}\n\n/** An authenticated webhook delivery. Re-read the checkout to act on it. */\nexport interface CryptoCheckoutEvent {\n  /** Stable across redeliveries of the same event. */\n  eventId: string;\n  /** The checkout the event is about; `null` for events about no checkout (acknowledge and ignore). */\n  checkoutId: string | null;\n  /** The gateway's event type, for logging. */\n  type: string;\n  redelivery: boolean;\n}\n\nexport interface CryptoCheckoutGateway {\n  readonly id: string;\n  /** Return the live checkout for `orderId`, or create one. */\n  createCheckout(input: CreateCryptoCheckoutInput): Promise<CryptoCheckout>;\n  /** Throws `CryptoCheckoutNotOwnedError` for a checkout it did not create. */\n  getCheckout(checkoutId: string): Promise<CryptoCheckout>;\n  listCheckouts(input: { orderId: string }): Promise<CryptoCheckout[]>;\n  /**\n   * Authenticate and parse a webhook delivery. Throws\n   * `PaymentVerificationError` for a bad signature or a delivery that does\n   * not belong to this gateway.\n   */\n  verifyWebhook(\n    rawBody: string,\n    headers: Headers | Record<string, string | undefined>,\n  ): CryptoCheckoutEvent;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAa,8BAAb,cAAiD,aAAa;CAC5D;CAEA,YAAY,YAAoB;EAC9B,MACE,YAAY,WAAW,oCACvB,mBACF;EACA,KAAK,OAAO;EACZ,KAAK,aAAa;CACpB;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"errors-feZrwnTy.js","names":[],"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"],"mappings":";AAQA,IAAa,eAAb,cAAkC,MAAM;CACtC;CACA;CAEA,YACE,SACA,OAAyB,0BACzB,UAAoD,CAAC,GACrD;EACA,MACE,SACA,QAAQ,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,CACnE;EACA,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ,aAAa;CACxC;AACF;AAEA,IAAa,4BAAb,cAA+C,aAAa;CAC1D,YAAY,SAAiB,UAA+B,CAAC,GAAG;EAC9D,MAAM,SAAS,+BAA+B,OAAO;EACrD,KAAK,OAAO;CACd;AACF;AAEA,IAAa,uBAAb,cAA0C,aAAa;CACrD,YACE,SACA,UAAoD,CAAC,GACrD;EACA,MAAM,SAAS,0BAA0B,OAAO;EAChD,KAAK,OAAO;CACd;AACF;AAEA,IAAa,0BAAb,cAA6C,aAAa;CACxD,YAAY,SAAiB,UAA+B,CAAC,GAAG;EAC9D,MAAM,SAAS,uBAAuB,OAAO;EAC7C,KAAK,OAAO;CACd;AACF;AAEA,IAAa,2BAAb,cAA8C,aAAa;CACzD,YAAY,SAAiB,UAA+B,CAAC,GAAG;EAC9D,MAAM,SAAS,+BAA+B,OAAO;EACrD,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"errors-feZrwnTy.js","names":[],"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_NOT_OWNED'\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"],"mappings":";AASA,IAAa,eAAb,cAAkC,MAAM;CACtC;CACA;CAEA,YACE,SACA,OAAyB,0BACzB,UAAoD,CAAC,GACrD;EACA,MACE,SACA,QAAQ,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,CACnE;EACA,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ,aAAa;CACxC;AACF;AAEA,IAAa,4BAAb,cAA+C,aAAa;CAC1D,YAAY,SAAiB,UAA+B,CAAC,GAAG;EAC9D,MAAM,SAAS,+BAA+B,OAAO;EACrD,KAAK,OAAO;CACd;AACF;AAEA,IAAa,uBAAb,cAA0C,aAAa;CACrD,YACE,SACA,UAAoD,CAAC,GACrD;EACA,MAAM,SAAS,0BAA0B,OAAO;EAChD,KAAK,OAAO;CACd;AACF;AAEA,IAAa,0BAAb,cAA6C,aAAa;CACxD,YAAY,SAAiB,UAA+B,CAAC,GAAG;EAC9D,MAAM,SAAS,uBAAuB,OAAO;EAC7C,KAAK,OAAO;CACd;AACF;AAEA,IAAa,2BAAb,cAA8C,aAAa;CACzD,YAAY,SAAiB,UAA+B,CAAC,GAAG;EAC9D,MAAM,SAAS,+BAA+B,OAAO;EACrD,KAAK,OAAO;CACd;AACF"}

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export type PaymentErrorCode = 'PAYMENT_CONFIGURATION_ERROR' | 'PAYMENT_PROVIDER_ERROR' | 'PAYMENT_UNSUPPORTED' | 'PAYMENT_VERIFICATION_FAILED' | 'PAYMENT_TIMEOUT' | 'PAYMENT_INVALID_INPUT';
+export type PaymentErrorCode = 'PAYMENT_CONFIGURATION_ERROR' | 'PAYMENT_PROVIDER_ERROR' | 'PAYMENT_UNSUPPORTED' | 'PAYMENT_VERIFICATION_FAILED' | 'PAYMENT_NOT_OWNED' | 'PAYMENT_TIMEOUT' | 'PAYMENT_INVALID_INPUT';
 export declare class PaymentError extends Error {
     readonly code: PaymentErrorCode;
     readonly retryable: boolean;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,6BAA6B,GAC7B,wBAAwB,GACxB,qBAAqB,GACrB,6BAA6B,GAC7B,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,gBAA2C,EACjD,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;CAUzD;AAED,qBAAa,yBAA0B,SAAQ,YAAY;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI/D;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBAElD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;CAKzD;AAED,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI/D;AAED,qBAAa,wBAAyB,SAAQ,YAAY;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI/D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,6BAA6B,GAC7B,wBAAwB,GACxB,qBAAqB,GACrB,6BAA6B,GAC7B,mBAAmB,GACnB,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,gBAA2C,EACjD,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;CAUzD;AAED,qBAAa,yBAA0B,SAAQ,YAAY;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI/D;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBAElD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;CAKzD;AAED,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI/D;AAED,qBAAa,wBAAyB,SAAQ,YAAY;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAI/D"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@
  * `@happyvertical/payments/btcpay` (BTCPay Greenfield client), and
  * `@happyvertical/payments/stripe`.
  */
+export * from './checkout-gateway.js';
 export * from './errors.js';
 export * from './factory.js';
 export * from './types.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,4 +1,5 @@
 import { a as PaymentVerificationError, i as PaymentUnsupportedError, n as PaymentError, r as PaymentProviderError, t as PaymentConfigurationError } from "./chunks/errors-feZrwnTy.js";
+import { t as CryptoCheckoutNotOwnedError } from "./chunks/checkout-gateway-DG-LY0oG.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.");
@@ -30,6 +31,6 @@ async function createPaymentBackend(options) {
 /** @internal */
 var PACKAGE_VERSION_INITIALIZED = true;
 //#endregion
-export { PACKAGE_VERSION_INITIALIZED, PaymentConfigurationError, PaymentError, PaymentProviderError, PaymentUnsupportedError, PaymentVerificationError, createPaymentBackend };
+export { CryptoCheckoutNotOwnedError, 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","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`,\n * `@happyvertical/payments/btcpay` (BTCPay Greenfield client), 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;;;;ACrCA,IAAa,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`,\n * `@happyvertical/payments/btcpay` (BTCPay Greenfield client), and\n * `@happyvertical/payments/stripe`.\n */\n\nexport * from './checkout-gateway.js';\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;;;;ACpCA,IAAa,8BAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/payments",
-  "version": "0.92.0",
+  "version": "0.95.0",
   "description": "Payment backend abstraction with adapters for Base USDC, BTCPay Server, and Stripe",
   "type": "module",
   "main": "./dist/index.js",