@puga-labs/x402-mantle-sdk 0.3.2 → 0.3.3

package/dist/types-C7EPJ6Hd.d.ts

@@ -1,85 +0,0 @@
-import { N as NetworkId, P as PaymentRequirements } from './types-2zqbJvcz.js';
-
-/** Unique key for a protected route, e.g. "GET /api/protected". */
-type RouteKey = string;
-/** Pricing config for a single route. */
-interface RoutePricingConfig {
-    /** Price in USD cents, e.g. 1 => $0.01. */
-    priceUsdCents: number;
-    /** Network identifier (e.g. "mantle-mainnet"). */
-    network: NetworkId;
-}
-/** Map of route keys to pricing config. */
-type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
-/** Log entry for a successfully settled payment. */
-interface PaymentLogEntry {
-    id: string;
-    from: string;
-    to: string;
-    valueAtomic: string;
-    network: NetworkId;
-    asset: string;
-    route?: RouteKey;
-    txHash?: string;
-    timestamp: number;
-    facilitatorUrl?: string;
-    paymentRequirements?: PaymentRequirements;
-}
-/** Config for optional telemetry (billing/analytics). */
-interface TelemetryConfig {
-    /** Project key from nosubs.ai dashboard. */
-    projectKey: string;
-    /**
-     * Telemetry endpoint URL.
-     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
-     */
-    endpoint?: string;
-}
-/**
- * Minimal config for mantlePaywall() - simplified API for single-route protection.
- * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
- */
-interface MinimalPaywallOptions {
-    /** Price in USD (e.g. 0.01 for 1 cent). */
-    priceUsd: number;
-    /** Recipient address (developer wallet). */
-    payTo: `0x${string}`;
-    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
-    facilitatorUrl?: string;
-    /** Optional telemetry config. */
-    telemetry?: TelemetryConfig;
-    /** Optional payment settled hook. */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
-/** Input for checkPayment function. */
-interface PaymentCheckInput {
-    /** X-PAYMENT header value (base64 encoded), or null if not present. */
-    paymentHeader: string | null;
-    /** Payment requirements for this route. */
-    paymentRequirements: PaymentRequirements;
-    /** Facilitator URL for verification. */
-    facilitatorUrl: string;
-    /** Route key for logging, e.g. "POST /api/generate-image". */
-    routeKey?: RouteKey;
-    /** Network ID for this payment. */
-    network: NetworkId;
-    /** Asset address (ERC-20 token). */
-    asset: string;
-    /** Telemetry config (optional). */
-    telemetry?: TelemetryConfig;
-    /** Payment settled callback (optional). */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
-/** Result from checkPayment function. */
-interface PaymentCheckResult {
-    /** Status of the payment check. */
-    status: "require_payment" | "verification_error" | "invalid_payment" | "verified";
-    /** HTTP status code to return. */
-    statusCode: 402 | 500 | 200;
-    /** Response body to return (null if verified). */
-    responseBody: any | null;
-    /** Whether payment is valid (only true if status is "verified"). */
-    isValid: boolean;
-}
-
-export type { MinimalPaywallOptions as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, PaymentCheckInput as c, PaymentCheckResult as d };

package/dist/types-CEttmr1U.d.cts

@@ -1,97 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import { N as NetworkId, P as PaymentRequirements } from './types-2zqbJvcz.cjs';
-
-/** Unique key for a protected route, e.g. "GET /api/protected". */
-type RouteKey = string;
-/** Pricing config for a single route. */
-interface RoutePricingConfig {
-    /** Price in USD cents, e.g. 1 => $0.01. */
-    priceUsdCents: number;
-    /** Network identifier (e.g. "mantle-mainnet"). */
-    network: NetworkId;
-}
-/** Map of route keys to pricing config. */
-type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
-/** Log entry for a successfully settled payment. */
-interface PaymentLogEntry {
-    id: string;
-    from: string;
-    to: string;
-    valueAtomic: string;
-    network: NetworkId;
-    asset: string;
-    route?: RouteKey;
-    txHash?: string;
-    timestamp: number;
-    facilitatorUrl?: string;
-    paymentRequirements?: PaymentRequirements;
-}
-/** Config for optional telemetry (billing/analytics). */
-interface TelemetryConfig {
-    /** Project key from nosubs.ai dashboard. */
-    projectKey: string;
-    /**
-     * Telemetry endpoint URL.
-     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
-     * If both are undefined, telemetry is not sent.
-     */
-    endpoint?: string;
-}
-/** Telemetry event payload for payment_verified. */
-interface TelemetryEvent {
-    event: "payment_verified";
-    ts: number;
-    projectKey: string;
-    network: string;
-    buyer: string;
-    payTo: string;
-    amountAtomic: string;
-    asset: string;
-    decimals: number;
-    nonce: string;
-    route: string;
-    facilitatorType: "hosted" | "self-hosted";
-    facilitatorUrl?: string;
-    facilitatorAddress?: string;
-    txHash?: string;
-    priceUsd?: string;
-}
-/** Config for createPaymentMiddleware. */
-interface PaymentMiddlewareConfig {
-    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
-    facilitatorUrl: string;
-    /** Recipient address (developer). */
-    receiverAddress: `0x${string}`;
-    /** Map of protected routes and their pricing. */
-    routes: RoutesConfig;
-    /**
-     * Optional hook called whenever a payment is successfully settled.
-     * You can use this to push logs into your DB / analytics pipeline.
-     */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-    /** Optional: Send usage telemetry for billing/analytics. */
-    telemetry?: TelemetryConfig;
-}
-/**
- * Minimal config for mantlePaywall() - simplified API for single-route protection.
- * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
- */
-interface MinimalPaywallOptions {
-    /** Price in USD (e.g. 0.01 for 1 cent). */
-    priceUsd: number;
-    /** Recipient address (developer wallet). */
-    payTo: `0x${string}`;
-    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
-    facilitatorUrl?: string;
-    /** Optional telemetry config. */
-    telemetry?: TelemetryConfig;
-    /** Optional payment settled hook. */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
-/**
- * Express middleware function type for Mantle paywall.
- * Async function that returns Promise<void>.
- */
-type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
-
-export type { MantleMiddleware as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, TelemetryEvent as c, PaymentMiddlewareConfig as d, MinimalPaywallOptions as e };

package/dist/types-D20K36pc.d.ts

@@ -1,97 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import { N as NetworkId, P as PaymentRequirements } from './types-2zqbJvcz.js';
-
-/** Unique key for a protected route, e.g. "GET /api/protected". */
-type RouteKey = string;
-/** Pricing config for a single route. */
-interface RoutePricingConfig {
-    /** Price in USD cents, e.g. 1 => $0.01. */
-    priceUsdCents: number;
-    /** Network identifier (e.g. "mantle-mainnet"). */
-    network: NetworkId;
-}
-/** Map of route keys to pricing config. */
-type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
-/** Log entry for a successfully settled payment. */
-interface PaymentLogEntry {
-    id: string;
-    from: string;
-    to: string;
-    valueAtomic: string;
-    network: NetworkId;
-    asset: string;
-    route?: RouteKey;
-    txHash?: string;
-    timestamp: number;
-    facilitatorUrl?: string;
-    paymentRequirements?: PaymentRequirements;
-}
-/** Config for optional telemetry (billing/analytics). */
-interface TelemetryConfig {
-    /** Project key from nosubs.ai dashboard. */
-    projectKey: string;
-    /**
-     * Telemetry endpoint URL.
-     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
-     * If both are undefined, telemetry is not sent.
-     */
-    endpoint?: string;
-}
-/** Telemetry event payload for payment_verified. */
-interface TelemetryEvent {
-    event: "payment_verified";
-    ts: number;
-    projectKey: string;
-    network: string;
-    buyer: string;
-    payTo: string;
-    amountAtomic: string;
-    asset: string;
-    decimals: number;
-    nonce: string;
-    route: string;
-    facilitatorType: "hosted" | "self-hosted";
-    facilitatorUrl?: string;
-    facilitatorAddress?: string;
-    txHash?: string;
-    priceUsd?: string;
-}
-/** Config for createPaymentMiddleware. */
-interface PaymentMiddlewareConfig {
-    /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
-    facilitatorUrl: string;
-    /** Recipient address (developer). */
-    receiverAddress: `0x${string}`;
-    /** Map of protected routes and their pricing. */
-    routes: RoutesConfig;
-    /**
-     * Optional hook called whenever a payment is successfully settled.
-     * You can use this to push logs into your DB / analytics pipeline.
-     */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-    /** Optional: Send usage telemetry for billing/analytics. */
-    telemetry?: TelemetryConfig;
-}
-/**
- * Minimal config for mantlePaywall() - simplified API for single-route protection.
- * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
- */
-interface MinimalPaywallOptions {
-    /** Price in USD (e.g. 0.01 for 1 cent). */
-    priceUsd: number;
-    /** Recipient address (developer wallet). */
-    payTo: `0x${string}`;
-    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
-    facilitatorUrl?: string;
-    /** Optional telemetry config. */
-    telemetry?: TelemetryConfig;
-    /** Optional payment settled hook. */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
-/**
- * Express middleware function type for Mantle paywall.
- * Async function that returns Promise<void>.
- */
-type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
-
-export type { MantleMiddleware as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, TelemetryEvent as c, PaymentMiddlewareConfig as d, MinimalPaywallOptions as e };

package/dist/types-xkNm0uzE.d.cts

@@ -1,85 +0,0 @@
-import { N as NetworkId, P as PaymentRequirements } from './types-2zqbJvcz.cjs';
-
-/** Unique key for a protected route, e.g. "GET /api/protected". */
-type RouteKey = string;
-/** Pricing config for a single route. */
-interface RoutePricingConfig {
-    /** Price in USD cents, e.g. 1 => $0.01. */
-    priceUsdCents: number;
-    /** Network identifier (e.g. "mantle-mainnet"). */
-    network: NetworkId;
-}
-/** Map of route keys to pricing config. */
-type RoutesConfig = Record<RouteKey, RoutePricingConfig>;
-/** Log entry for a successfully settled payment. */
-interface PaymentLogEntry {
-    id: string;
-    from: string;
-    to: string;
-    valueAtomic: string;
-    network: NetworkId;
-    asset: string;
-    route?: RouteKey;
-    txHash?: string;
-    timestamp: number;
-    facilitatorUrl?: string;
-    paymentRequirements?: PaymentRequirements;
-}
-/** Config for optional telemetry (billing/analytics). */
-interface TelemetryConfig {
-    /** Project key from nosubs.ai dashboard. */
-    projectKey: string;
-    /**
-     * Telemetry endpoint URL.
-     * If not specified, uses DEFAULT_TELEMETRY_ENDPOINT (see server/constants.ts).
-     */
-    endpoint?: string;
-}
-/**
- * Minimal config for mantlePaywall() - simplified API for single-route protection.
- * This is the "sweet path" for Mantle mainnet + USDC with sensible defaults.
- */
-interface MinimalPaywallOptions {
-    /** Price in USD (e.g. 0.01 for 1 cent). */
-    priceUsd: number;
-    /** Recipient address (developer wallet). */
-    payTo: `0x${string}`;
-    /** Optional facilitator URL (defaults to localhost:8080 or NEXT_PUBLIC_FACILITATOR_URL). */
-    facilitatorUrl?: string;
-    /** Optional telemetry config. */
-    telemetry?: TelemetryConfig;
-    /** Optional payment settled hook. */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
-/** Input for checkPayment function. */
-interface PaymentCheckInput {
-    /** X-PAYMENT header value (base64 encoded), or null if not present. */
-    paymentHeader: string | null;
-    /** Payment requirements for this route. */
-    paymentRequirements: PaymentRequirements;
-    /** Facilitator URL for verification. */
-    facilitatorUrl: string;
-    /** Route key for logging, e.g. "POST /api/generate-image". */
-    routeKey?: RouteKey;
-    /** Network ID for this payment. */
-    network: NetworkId;
-    /** Asset address (ERC-20 token). */
-    asset: string;
-    /** Telemetry config (optional). */
-    telemetry?: TelemetryConfig;
-    /** Payment settled callback (optional). */
-    onPaymentSettled?: (entry: PaymentLogEntry) => void;
-}
-/** Result from checkPayment function. */
-interface PaymentCheckResult {
-    /** Status of the payment check. */
-    status: "require_payment" | "verification_error" | "invalid_payment" | "verified";
-    /** HTTP status code to return. */
-    statusCode: 402 | 500 | 200;
-    /** Response body to return (null if verified). */
-    responseBody: any | null;
-    /** Whether payment is valid (only true if status is "verified"). */
-    isValid: boolean;
-}
-
-export type { MinimalPaywallOptions as M, PaymentLogEntry as P, RouteKey as R, TelemetryConfig as T, RoutePricingConfig as a, RoutesConfig as b, PaymentCheckInput as c, PaymentCheckResult as d };

package/dist/web-standards-C3D2vdTg.d.ts

@@ -1,77 +0,0 @@
-import { M as MinimalPaywallOptions } from './types-C7EPJ6Hd.js';
-
-/**
- * Web Standards route handler type.
- * Takes a Request and returns a Response.
- */
-type WebHandler = (request: Request) => Promise<Response>;
-/**
- * Wrapper function that adds x402 payment verification to Web Standards handler.
- */
-type WebPaywallWrapper = (handler: WebHandler) => WebHandler;
-/**
- * Create Web Standards middleware for x402 payment verification.
- * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
- *
- * Compatible with:
- * - Hono
- * - Cloudflare Workers
- * - Deno
- * - Bun
- * - Any platform supporting Web Request/Response API
- *
- * @example
- * ```typescript
- * // Hono example
- * import { Hono } from 'hono'
- * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web'
- *
- * const app = new Hono()
- * const pay = mantlePaywall({
- *   priceUsd: 0.01,
- *   payTo: '0x...',
- * });
- *
- * app.post('/api/generate', pay(async (req) => {
- *   const body = await req.json();
- *   // Your handler code here
- *   return new Response(JSON.stringify({ success: true }), {
- *     headers: { 'Content-Type': 'application/json' }
- *   });
- * }));
- * ```
- *
- * @example
- * ```typescript
- * // Cloudflare Workers example
- * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web'
- *
- * const pay = mantlePaywall({
- *   priceUsd: 0.01,
- *   payTo: '0x...',
- * });
- *
- * export default {
- *   async fetch(request: Request) {
- *     const handler = pay(async (req) => {
- *       // Your handler code here
- *       return new Response('Hello World');
- *     });
- *     return handler(request);
- *   }
- * }
- * ```
- *
- * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
- * @returns Function that wraps Web Standards handlers with payment verification.
- */
-declare function mantlePaywall(opts: MinimalPaywallOptions): WebPaywallWrapper;
-
-type webStandards_WebHandler = WebHandler;
-type webStandards_WebPaywallWrapper = WebPaywallWrapper;
-declare const webStandards_mantlePaywall: typeof mantlePaywall;
-declare namespace webStandards {
-  export { type webStandards_WebHandler as WebHandler, type webStandards_WebPaywallWrapper as WebPaywallWrapper, webStandards_mantlePaywall as mantlePaywall };
-}
-
-export { type WebHandler as W, type WebPaywallWrapper as a, mantlePaywall as m, webStandards as w };

package/dist/web-standards-DOYp0UDT.d.cts

@@ -1,77 +0,0 @@
-import { M as MinimalPaywallOptions } from './types-xkNm0uzE.cjs';
-
-/**
- * Web Standards route handler type.
- * Takes a Request and returns a Response.
- */
-type WebHandler = (request: Request) => Promise<Response>;
-/**
- * Wrapper function that adds x402 payment verification to Web Standards handler.
- */
-type WebPaywallWrapper = (handler: WebHandler) => WebHandler;
-/**
- * Create Web Standards middleware for x402 payment verification.
- * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
- *
- * Compatible with:
- * - Hono
- * - Cloudflare Workers
- * - Deno
- * - Bun
- * - Any platform supporting Web Request/Response API
- *
- * @example
- * ```typescript
- * // Hono example
- * import { Hono } from 'hono'
- * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web'
- *
- * const app = new Hono()
- * const pay = mantlePaywall({
- *   priceUsd: 0.01,
- *   payTo: '0x...',
- * });
- *
- * app.post('/api/generate', pay(async (req) => {
- *   const body = await req.json();
- *   // Your handler code here
- *   return new Response(JSON.stringify({ success: true }), {
- *     headers: { 'Content-Type': 'application/json' }
- *   });
- * }));
- * ```
- *
- * @example
- * ```typescript
- * // Cloudflare Workers example
- * import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web'
- *
- * const pay = mantlePaywall({
- *   priceUsd: 0.01,
- *   payTo: '0x...',
- * });
- *
- * export default {
- *   async fetch(request: Request) {
- *     const handler = pay(async (req) => {
- *       // Your handler code here
- *       return new Response('Hello World');
- *     });
- *     return handler(request);
- *   }
- * }
- * ```
- *
- * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
- * @returns Function that wraps Web Standards handlers with payment verification.
- */
-declare function mantlePaywall(opts: MinimalPaywallOptions): WebPaywallWrapper;
-
-type webStandards_WebHandler = WebHandler;
-type webStandards_WebPaywallWrapper = WebPaywallWrapper;
-declare const webStandards_mantlePaywall: typeof mantlePaywall;
-declare namespace webStandards {
-  export { type webStandards_WebHandler as WebHandler, type webStandards_WebPaywallWrapper as WebPaywallWrapper, webStandards_mantlePaywall as mantlePaywall };
-}
-
-export { type WebHandler as W, type WebPaywallWrapper as a, mantlePaywall as m, webStandards as w };