@mixrpay/merchant-sdk 0.1.1 → 0.2.0

package/dist/middleware/fastify.d.mts

@@ -1,56 +0,0 @@
-import { FastifyPluginCallback, FastifyRequest, FastifyReply } from 'fastify';
-import { X as X402PaymentResult, b as X402Options } from '../types-BJNy6Hhb.mjs';
-
-/**
- * MixrPay Merchant SDK - Fastify Plugin
- *
- * Add x402 payment requirement to Fastify routes.
- *
- * @example
- * ```typescript
- * import Fastify from 'fastify';
- * import { x402Plugin, x402 } from '@mixrpay/merchant-sdk/fastify';
- *
- * const app = Fastify();
- *
- * // Register the plugin
- * app.register(x402Plugin, {
- *   recipient: '0x...',  // or use MIXRPAY_MERCHANT_ADDRESS env var
- * });
- *
- * // Use on routes
- * app.post('/api/query', { preHandler: x402({ price: 0.05 }) }, async (req, reply) => {
- *   return { result: 'success', payer: req.x402Payment?.payer };
- * });
- *
- * // With JWT receipts
- * app.post('/api/premium', { preHandler: x402({ price: 0.10, receiptMode: 'jwt' }) }, handler);
- * ```
- */
-
-declare module 'fastify' {
-    interface FastifyRequest {
-        x402Payment?: X402PaymentResult;
-    }
-}
-interface X402PluginOptions {
-    /** Default recipient address (can be overridden per route) */
-    recipient?: string;
-    /** Default chain ID */
-    chainId?: number;
-    /** Default facilitator URL */
-    facilitator?: string;
-}
-/**
- * Fastify plugin that adds x402 payment support.
- */
-declare const x402Plugin: FastifyPluginCallback<X402PluginOptions>;
-/**
- * Create a preHandler hook that requires x402 payment.
- *
- * @param options - x402 configuration options
- * @returns Fastify preHandler function
- */
-declare function x402(options: X402Options): (request: FastifyRequest, reply: FastifyReply) => Promise<undefined>;
-
-export { X402Options, X402PaymentResult, type X402PluginOptions, x402, x402Plugin };

package/dist/middleware/fastify.d.ts

@@ -1,56 +0,0 @@
-import { FastifyPluginCallback, FastifyRequest, FastifyReply } from 'fastify';
-import { X as X402PaymentResult, b as X402Options } from '../types-BJNy6Hhb.js';
-
-/**
- * MixrPay Merchant SDK - Fastify Plugin
- *
- * Add x402 payment requirement to Fastify routes.
- *
- * @example
- * ```typescript
- * import Fastify from 'fastify';
- * import { x402Plugin, x402 } from '@mixrpay/merchant-sdk/fastify';
- *
- * const app = Fastify();
- *
- * // Register the plugin
- * app.register(x402Plugin, {
- *   recipient: '0x...',  // or use MIXRPAY_MERCHANT_ADDRESS env var
- * });
- *
- * // Use on routes
- * app.post('/api/query', { preHandler: x402({ price: 0.05 }) }, async (req, reply) => {
- *   return { result: 'success', payer: req.x402Payment?.payer };
- * });
- *
- * // With JWT receipts
- * app.post('/api/premium', { preHandler: x402({ price: 0.10, receiptMode: 'jwt' }) }, handler);
- * ```
- */
-
-declare module 'fastify' {
-    interface FastifyRequest {
-        x402Payment?: X402PaymentResult;
-    }
-}
-interface X402PluginOptions {
-    /** Default recipient address (can be overridden per route) */
-    recipient?: string;
-    /** Default chain ID */
-    chainId?: number;
-    /** Default facilitator URL */
-    facilitator?: string;
-}
-/**
- * Fastify plugin that adds x402 payment support.
- */
-declare const x402Plugin: FastifyPluginCallback<X402PluginOptions>;
-/**
- * Create a preHandler hook that requires x402 payment.
- *
- * @param options - x402 configuration options
- * @returns Fastify preHandler function
- */
-declare function x402(options: X402Options): (request: FastifyRequest, reply: FastifyReply) => Promise<undefined>;
-
-export { X402Options, X402PaymentResult, type X402PluginOptions, x402, x402Plugin };

package/dist/middleware/nextjs.d.mts

@@ -1,78 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server';
-import { X as X402PaymentResult, R as ReceiptMode } from '../types-BJNy6Hhb.mjs';
-
-/**
- * MixrPay Merchant SDK - Next.js Integration
- *
- * Add x402 payment requirement to Next.js API routes.
- *
- * @example
- * ```typescript
- * // app/api/query/route.ts
- * import { withX402 } from '@mixrpay/merchant-sdk/nextjs';
- *
- * async function handler(req: NextRequest, payment: X402PaymentResult) {
- *   // This handler only runs after payment is verified
- *   return NextResponse.json({
- *     result: 'success',
- *     payer: payment.payer,
- *     amount: payment.amount,
- *   });
- * }
- *
- * export const POST = withX402({ price: 0.05 }, handler);
- *
- * // With JWT receipts
- * export const POST = withX402({ price: 0.10, receiptMode: 'jwt' }, handler);
- * ```
- */
-
-interface X402Config {
-    /** Price in USD (e.g., 0.05 for 5 cents) */
-    price: number;
-    /** Your merchant wallet address to receive payments */
-    recipient?: string;
-    /** Chain ID (default: 8453 for Base) */
-    chainId?: number;
-    /** Facilitator URL */
-    facilitator?: string;
-    /** Description of what the payment is for */
-    description?: string;
-    /** Skip payment verification (for testing) */
-    testMode?: boolean;
-    /** Custom function to determine price dynamically */
-    getPrice?: (req: NextRequest) => number | Promise<number>;
-    /** Called after successful payment */
-    onPayment?: (payment: X402PaymentResult, req: NextRequest) => void | Promise<void>;
-    /**
-     * Receipt mode for payment verification responses.
-     * - 'jwt': Set X-Payment-Receipt header with JWT (no webhook)
-     * - 'webhook': Send webhook only (default, backwards compatible)
-     * - 'both': Set JWT header AND send webhook
-     */
-    receiptMode?: ReceiptMode;
-    /** MixrPay API URL for fetching JWT receipts (default: production) */
-    mixrpayApiUrl?: string;
-}
-type X402Handler = (req: NextRequest, payment: X402PaymentResult) => Promise<NextResponse> | NextResponse;
-/**
- * Wrap a Next.js API route handler with x402 payment requirement.
- *
- * @param config - x402 configuration
- * @param handler - The handler to wrap (receives req and payment result)
- * @returns Wrapped handler function
- */
-declare function withX402(config: X402Config, handler: X402Handler): (req: NextRequest) => Promise<NextResponse>;
-/**
- * Create a x402 payment requirements response.
- * Useful for building custom payment flows.
- */
-declare function createPaymentRequired(options: {
-    recipient: string;
-    amount: number;
-    chainId?: number;
-    facilitator?: string;
-    description?: string;
-}): NextResponse;
-
-export { type X402Config, X402PaymentResult, createPaymentRequired, withX402 };

package/dist/middleware/nextjs.d.ts

@@ -1,78 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server';
-import { X as X402PaymentResult, R as ReceiptMode } from '../types-BJNy6Hhb.js';
-
-/**
- * MixrPay Merchant SDK - Next.js Integration
- *
- * Add x402 payment requirement to Next.js API routes.
- *
- * @example
- * ```typescript
- * // app/api/query/route.ts
- * import { withX402 } from '@mixrpay/merchant-sdk/nextjs';
- *
- * async function handler(req: NextRequest, payment: X402PaymentResult) {
- *   // This handler only runs after payment is verified
- *   return NextResponse.json({
- *     result: 'success',
- *     payer: payment.payer,
- *     amount: payment.amount,
- *   });
- * }
- *
- * export const POST = withX402({ price: 0.05 }, handler);
- *
- * // With JWT receipts
- * export const POST = withX402({ price: 0.10, receiptMode: 'jwt' }, handler);
- * ```
- */
-
-interface X402Config {
-    /** Price in USD (e.g., 0.05 for 5 cents) */
-    price: number;
-    /** Your merchant wallet address to receive payments */
-    recipient?: string;
-    /** Chain ID (default: 8453 for Base) */
-    chainId?: number;
-    /** Facilitator URL */
-    facilitator?: string;
-    /** Description of what the payment is for */
-    description?: string;
-    /** Skip payment verification (for testing) */
-    testMode?: boolean;
-    /** Custom function to determine price dynamically */
-    getPrice?: (req: NextRequest) => number | Promise<number>;
-    /** Called after successful payment */
-    onPayment?: (payment: X402PaymentResult, req: NextRequest) => void | Promise<void>;
-    /**
-     * Receipt mode for payment verification responses.
-     * - 'jwt': Set X-Payment-Receipt header with JWT (no webhook)
-     * - 'webhook': Send webhook only (default, backwards compatible)
-     * - 'both': Set JWT header AND send webhook
-     */
-    receiptMode?: ReceiptMode;
-    /** MixrPay API URL for fetching JWT receipts (default: production) */
-    mixrpayApiUrl?: string;
-}
-type X402Handler = (req: NextRequest, payment: X402PaymentResult) => Promise<NextResponse> | NextResponse;
-/**
- * Wrap a Next.js API route handler with x402 payment requirement.
- *
- * @param config - x402 configuration
- * @param handler - The handler to wrap (receives req and payment result)
- * @returns Wrapped handler function
- */
-declare function withX402(config: X402Config, handler: X402Handler): (req: NextRequest) => Promise<NextResponse>;
-/**
- * Create a x402 payment requirements response.
- * Useful for building custom payment flows.
- */
-declare function createPaymentRequired(options: {
-    recipient: string;
-    amount: number;
-    chainId?: number;
-    facilitator?: string;
-    description?: string;
-}): NextResponse;
-
-export { type X402Config, X402PaymentResult, createPaymentRequired, withX402 };

package/dist/types-BJNy6Hhb.d.mts

@@ -1,166 +0,0 @@
-/**
- * MixrPay Merchant SDK - Type definitions
- */
-interface X402Options {
-    /** Price in USD (e.g., 0.05 for 5 cents) */
-    price: number;
-    /** Your merchant wallet address to receive payments */
-    recipient?: string;
-    /** Chain ID (default: 8453 for Base) */
-    chainId?: number;
-    /** Facilitator URL for payment settlement */
-    facilitator?: string;
-    /** Description of what the payment is for */
-    description?: string;
-    /** Custom function to determine price dynamically */
-    getPrice?: (context: PriceContext) => number | Promise<number>;
-    /** Called after successful payment verification */
-    onPayment?: (payment: X402PaymentResult) => void | Promise<void>;
-    /** Skip payment for certain requests (return true to skip) */
-    skip?: (context: SkipContext) => boolean | Promise<boolean>;
-    /** Allow test payments (for development) */
-    testMode?: boolean;
-    /**
-     * Receipt mode for payment verification responses.
-     * - 'jwt': Set X-Payment-Receipt header with JWT (no webhook)
-     * - 'webhook': Send webhook only (default, backwards compatible)
-     * - 'both': Set JWT header AND send webhook
-     */
-    receiptMode?: ReceiptMode;
-    /** MixrPay API URL for fetching JWT receipts (default: production) */
-    mixrpayApiUrl?: string;
-}
-interface PriceContext {
-    /** Request path */
-    path: string;
-    /** Request method */
-    method: string;
-    /** Request headers */
-    headers: Record<string, string | string[] | undefined>;
-    /** Request body (if parsed) */
-    body?: unknown;
-}
-type SkipContext = PriceContext;
-interface X402PaymentResult {
-    /** Whether the payment is valid */
-    valid: boolean;
-    /** Error message if invalid */
-    error?: string;
-    /** Address that paid (if valid) */
-    payer?: string;
-    /** Amount in USDC (major units, e.g., 0.05) */
-    amount?: number;
-    /** Amount in USDC minor units (e.g., 50000) */
-    amountMinor?: bigint;
-    /** Settlement transaction hash */
-    txHash?: string;
-    /** When the payment was settled */
-    settledAt?: Date;
-    /** The nonce used for this payment */
-    nonce?: string;
-    /** JWT payment receipt (when receiptMode is 'jwt' or 'both') */
-    receipt?: string;
-}
-interface X402PaymentRequired {
-    /** Recipient wallet address */
-    recipient: string;
-    /** Amount in USDC minor units (6 decimals) as string */
-    amount: string;
-    /** Currency code */
-    currency: string;
-    /** Chain ID */
-    chainId: number;
-    /** Facilitator URL */
-    facilitator: string;
-    /** Unique nonce for this payment request */
-    nonce: string;
-    /** Unix timestamp when payment requirements expire */
-    expiresAt: number;
-    /** Description of the payment */
-    description?: string;
-}
-interface X402PaymentPayload {
-    x402Version: number;
-    scheme: 'exact';
-    network: 'base' | 'base-sepolia';
-    payload: {
-        signature: string;
-        authorization: {
-            from: string;
-            to: string;
-            value: string;
-            validAfter: string;
-            validBefore: string;
-            nonce: string;
-        };
-    };
-}
-interface EIP712Domain {
-    name: string;
-    version: string;
-    chainId: number;
-    verifyingContract: `0x${string}`;
-}
-interface TransferWithAuthorizationMessage {
-    from: `0x${string}`;
-    to: `0x${string}`;
-    value: bigint;
-    validAfter: bigint;
-    validBefore: bigint;
-    nonce: `0x${string}`;
-}
-interface VerifyOptions {
-    /** Expected amount in USDC minor units */
-    expectedAmount: bigint;
-    /** Expected recipient address */
-    expectedRecipient: string;
-    /** Chain ID (default: 8453 for Base) */
-    chainId?: number;
-    /** Facilitator URL */
-    facilitator?: string;
-    /** Skip on-chain settlement (for testing) */
-    skipSettlement?: boolean;
-}
-/**
- * Verified payment receipt from MixrPay.
- */
-interface PaymentReceipt {
-    /** Unique payment ID */
-    paymentId: string;
-    /** Amount in USDC minor units (6 decimals) as string */
-    amount: string;
-    /** Amount in USD */
-    amountUsd: number;
-    /** Payer wallet address */
-    payer: string;
-    /** Recipient wallet address */
-    recipient: string;
-    /** Blockchain chain ID */
-    chainId: number;
-    /** Settlement transaction hash */
-    txHash: string;
-    /** When the payment was settled (ISO string) */
-    settledAt: string;
-    /** When the receipt was issued */
-    issuedAt?: Date;
-    /** When the receipt expires */
-    expiresAt?: Date;
-}
-/**
- * Options for verifying a payment receipt.
- */
-interface VerifyReceiptOptions {
-    /** Custom JWKS URL (default: MixrPay production JWKS) */
-    jwksUrl?: string;
-    /** Expected issuer (for additional validation) */
-    issuer?: string;
-}
-/**
- * Receipt mode for x402 middleware.
- * - 'jwt': Only generate JWT receipt (no webhook)
- * - 'webhook': Only send webhook (default, backwards compatible)
- * - 'both': Generate JWT receipt AND send webhook
- */
-type ReceiptMode = 'jwt' | 'webhook' | 'both';
-
-export type { EIP712Domain as E, PaymentReceipt as P, ReceiptMode as R, SkipContext as S, TransferWithAuthorizationMessage as T, VerifyOptions as V, X402PaymentResult as X, VerifyReceiptOptions as a, X402Options as b, X402PaymentRequired as c, X402PaymentPayload as d, PriceContext as e };

package/dist/types-BJNy6Hhb.d.ts

@@ -1,166 +0,0 @@
-/**
- * MixrPay Merchant SDK - Type definitions
- */
-interface X402Options {
-    /** Price in USD (e.g., 0.05 for 5 cents) */
-    price: number;
-    /** Your merchant wallet address to receive payments */
-    recipient?: string;
-    /** Chain ID (default: 8453 for Base) */
-    chainId?: number;
-    /** Facilitator URL for payment settlement */
-    facilitator?: string;
-    /** Description of what the payment is for */
-    description?: string;
-    /** Custom function to determine price dynamically */
-    getPrice?: (context: PriceContext) => number | Promise<number>;
-    /** Called after successful payment verification */
-    onPayment?: (payment: X402PaymentResult) => void | Promise<void>;
-    /** Skip payment for certain requests (return true to skip) */
-    skip?: (context: SkipContext) => boolean | Promise<boolean>;
-    /** Allow test payments (for development) */
-    testMode?: boolean;
-    /**
-     * Receipt mode for payment verification responses.
-     * - 'jwt': Set X-Payment-Receipt header with JWT (no webhook)
-     * - 'webhook': Send webhook only (default, backwards compatible)
-     * - 'both': Set JWT header AND send webhook
-     */
-    receiptMode?: ReceiptMode;
-    /** MixrPay API URL for fetching JWT receipts (default: production) */
-    mixrpayApiUrl?: string;
-}
-interface PriceContext {
-    /** Request path */
-    path: string;
-    /** Request method */
-    method: string;
-    /** Request headers */
-    headers: Record<string, string | string[] | undefined>;
-    /** Request body (if parsed) */
-    body?: unknown;
-}
-type SkipContext = PriceContext;
-interface X402PaymentResult {
-    /** Whether the payment is valid */
-    valid: boolean;
-    /** Error message if invalid */
-    error?: string;
-    /** Address that paid (if valid) */
-    payer?: string;
-    /** Amount in USDC (major units, e.g., 0.05) */
-    amount?: number;
-    /** Amount in USDC minor units (e.g., 50000) */
-    amountMinor?: bigint;
-    /** Settlement transaction hash */
-    txHash?: string;
-    /** When the payment was settled */
-    settledAt?: Date;
-    /** The nonce used for this payment */
-    nonce?: string;
-    /** JWT payment receipt (when receiptMode is 'jwt' or 'both') */
-    receipt?: string;
-}
-interface X402PaymentRequired {
-    /** Recipient wallet address */
-    recipient: string;
-    /** Amount in USDC minor units (6 decimals) as string */
-    amount: string;
-    /** Currency code */
-    currency: string;
-    /** Chain ID */
-    chainId: number;
-    /** Facilitator URL */
-    facilitator: string;
-    /** Unique nonce for this payment request */
-    nonce: string;
-    /** Unix timestamp when payment requirements expire */
-    expiresAt: number;
-    /** Description of the payment */
-    description?: string;
-}
-interface X402PaymentPayload {
-    x402Version: number;
-    scheme: 'exact';
-    network: 'base' | 'base-sepolia';
-    payload: {
-        signature: string;
-        authorization: {
-            from: string;
-            to: string;
-            value: string;
-            validAfter: string;
-            validBefore: string;
-            nonce: string;
-        };
-    };
-}
-interface EIP712Domain {
-    name: string;
-    version: string;
-    chainId: number;
-    verifyingContract: `0x${string}`;
-}
-interface TransferWithAuthorizationMessage {
-    from: `0x${string}`;
-    to: `0x${string}`;
-    value: bigint;
-    validAfter: bigint;
-    validBefore: bigint;
-    nonce: `0x${string}`;
-}
-interface VerifyOptions {
-    /** Expected amount in USDC minor units */
-    expectedAmount: bigint;
-    /** Expected recipient address */
-    expectedRecipient: string;
-    /** Chain ID (default: 8453 for Base) */
-    chainId?: number;
-    /** Facilitator URL */
-    facilitator?: string;
-    /** Skip on-chain settlement (for testing) */
-    skipSettlement?: boolean;
-}
-/**
- * Verified payment receipt from MixrPay.
- */
-interface PaymentReceipt {
-    /** Unique payment ID */
-    paymentId: string;
-    /** Amount in USDC minor units (6 decimals) as string */
-    amount: string;
-    /** Amount in USD */
-    amountUsd: number;
-    /** Payer wallet address */
-    payer: string;
-    /** Recipient wallet address */
-    recipient: string;
-    /** Blockchain chain ID */
-    chainId: number;
-    /** Settlement transaction hash */
-    txHash: string;
-    /** When the payment was settled (ISO string) */
-    settledAt: string;
-    /** When the receipt was issued */
-    issuedAt?: Date;
-    /** When the receipt expires */
-    expiresAt?: Date;
-}
-/**
- * Options for verifying a payment receipt.
- */
-interface VerifyReceiptOptions {
-    /** Custom JWKS URL (default: MixrPay production JWKS) */
-    jwksUrl?: string;
-    /** Expected issuer (for additional validation) */
-    issuer?: string;
-}
-/**
- * Receipt mode for x402 middleware.
- * - 'jwt': Only generate JWT receipt (no webhook)
- * - 'webhook': Only send webhook (default, backwards compatible)
- * - 'both': Generate JWT receipt AND send webhook
- */
-type ReceiptMode = 'jwt' | 'webhook' | 'both';
-
-export type { EIP712Domain as E, PaymentReceipt as P, ReceiptMode as R, SkipContext as S, TransferWithAuthorizationMessage as T, VerifyOptions as V, X402PaymentResult as X, VerifyReceiptOptions as a, X402Options as b, X402PaymentRequired as c, X402PaymentPayload as d, PriceContext as e };