@okxweb3/app-x402-core 0.1.2

package/dist/esm/schemas/index.d.mts

@@ -0,0 +1,309 @@
+import { z } from 'zod';
+export { z } from 'zod';
+
+/**
+ * Non-empty string schema - a string with at least one character.
+ * Used for required string fields that cannot be empty.
+ */
+declare const NonEmptyString: z.ZodString;
+type NonEmptyString = z.infer<typeof NonEmptyString>;
+/**
+ * Any record schema - an object with unknown keys and values.
+ * Used for scheme-specific payloads and other extensible objects.
+ */
+declare const Any: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+type Any = z.infer<typeof Any>;
+/**
+ * Optional any record schema - an optional object with unknown keys and values.
+ * Used for optional extension fields like `extra` and `extensions`.
+ */
+declare const OptionalAny: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+type OptionalAny = z.infer<typeof OptionalAny>;
+/**
+ * Network identifier schema - CAIP-2 format validation.
+ * Requires minimum length of 3 and a colon separator (e.g., "eip155:196", "eip155:196").
+ */
+declare const NetworkSchema: z.ZodEffects<z.ZodString, string, string>;
+type Network = z.infer<typeof NetworkSchema>;
+/**
+ * ResourceInfo schema for V2 - describes the protected resource.
+ */
+declare const ResourceInfoSchema: z.ZodObject<{
+    url: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    description?: string | undefined;
+    mimeType?: string | undefined;
+}, {
+    url: string;
+    description?: string | undefined;
+    mimeType?: string | undefined;
+}>;
+type ResourceInfo = z.infer<typeof ResourceInfoSchema>;
+/**
+ * PaymentRequirements schema.
+ */
+declare const PaymentRequirementsSchema: z.ZodObject<{
+    scheme: z.ZodString;
+    network: z.ZodEffects<z.ZodString, string, string>;
+    amount: z.ZodString;
+    asset: z.ZodString;
+    payTo: z.ZodString;
+    maxTimeoutSeconds: z.ZodNumber;
+    extra: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    scheme: string;
+    network: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: Record<string, unknown> | null | undefined;
+}, {
+    amount: string;
+    scheme: string;
+    network: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: Record<string, unknown> | null | undefined;
+}>;
+type PaymentRequirements = z.infer<typeof PaymentRequirementsSchema>;
+/**
+ * PaymentRequired (402 response) schema.
+ * Contains payment requirements when a resource requires payment.
+ */
+declare const PaymentRequiredSchema: z.ZodObject<{
+    x402Version: z.ZodLiteral<2>;
+    error: z.ZodOptional<z.ZodString>;
+    resource: z.ZodObject<{
+        url: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }, {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }>;
+    accepts: z.ZodArray<z.ZodObject<{
+        scheme: z.ZodString;
+        network: z.ZodEffects<z.ZodString, string, string>;
+        amount: z.ZodString;
+        asset: z.ZodString;
+        payTo: z.ZodString;
+        maxTimeoutSeconds: z.ZodNumber;
+        extra: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    }, {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    }>, "many">;
+    extensions: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    x402Version: 2;
+    resource: {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    };
+    accepts: {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    }[];
+    extensions?: Record<string, unknown> | null | undefined;
+    error?: string | undefined;
+}, {
+    x402Version: 2;
+    resource: {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    };
+    accepts: {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    }[];
+    extensions?: Record<string, unknown> | null | undefined;
+    error?: string | undefined;
+}>;
+type PaymentRequired = z.infer<typeof PaymentRequiredSchema>;
+/**
+ * PaymentPayload schema.
+ * Contains the payment data sent by the client.
+ */
+declare const PaymentPayloadSchema: z.ZodObject<{
+    x402Version: z.ZodLiteral<2>;
+    resource: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }, {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }>>;
+    accepted: z.ZodObject<{
+        scheme: z.ZodString;
+        network: z.ZodEffects<z.ZodString, string, string>;
+        amount: z.ZodString;
+        asset: z.ZodString;
+        payTo: z.ZodString;
+        maxTimeoutSeconds: z.ZodNumber;
+        extra: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    }, {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    }>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    extensions: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    x402Version: 2;
+    payload: Record<string, unknown>;
+    accepted: {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    };
+    extensions?: Record<string, unknown> | null | undefined;
+    resource?: {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    } | undefined;
+}, {
+    x402Version: 2;
+    payload: Record<string, unknown>;
+    accepted: {
+        amount: string;
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown> | null | undefined;
+    };
+    extensions?: Record<string, unknown> | null | undefined;
+    resource?: {
+        url: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    } | undefined;
+}>;
+type PaymentPayload = z.infer<typeof PaymentPayloadSchema>;
+/**
+ * Validates a PaymentRequired object (V1 or V2).
+ *
+ * @param value - The value to validate
+ * @returns A result object with success status and data or error
+ */
+declare function parsePaymentRequired(value: unknown): z.SafeParseReturnType<unknown, PaymentRequired>;
+/**
+ * Validates a PaymentRequired object and throws on error.
+ *
+ * @param value - The value to validate
+ * @returns The validated PaymentRequired
+ * @throws ZodError if validation fails
+ */
+declare function validatePaymentRequired(value: unknown): PaymentRequired;
+/**
+ * Type guard for PaymentRequired (V1 or V2).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid PaymentRequired
+ */
+declare function isPaymentRequired(value: unknown): value is PaymentRequired;
+/**
+ * Validates a PaymentRequirements object (V1 or V2).
+ *
+ * @param value - The value to validate
+ * @returns A result object with success status and data or error
+ */
+declare function parsePaymentRequirements(value: unknown): z.SafeParseReturnType<unknown, PaymentRequirements>;
+/**
+ * Validates a PaymentRequirements object and throws on error.
+ *
+ * @param value - The value to validate
+ * @returns The validated PaymentRequirements
+ * @throws ZodError if validation fails
+ */
+declare function validatePaymentRequirements(value: unknown): PaymentRequirements;
+/**
+ * Type guard for PaymentRequirements (V1 or V2).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid PaymentRequirements
+ */
+declare function isPaymentRequirements(value: unknown): value is PaymentRequirements;
+/**
+ * Validates a PaymentPayload object (V1 or V2).
+ *
+ * @param value - The value to validate
+ * @returns A result object with success status and data or error
+ */
+declare function parsePaymentPayload(value: unknown): z.SafeParseReturnType<unknown, PaymentPayload>;
+/**
+ * Validates a PaymentPayload object and throws on error.
+ *
+ * @param value - The value to validate
+ * @returns The validated PaymentPayload
+ * @throws ZodError if validation fails
+ */
+declare function validatePaymentPayload(value: unknown): PaymentPayload;
+/**
+ * Type guard for PaymentPayload (V1 or V2).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid PaymentPayload
+ */
+declare function isPaymentPayload(value: unknown): value is PaymentPayload;
+
+export { Any, type Network, NetworkSchema, NonEmptyString, OptionalAny, type PaymentPayload, PaymentPayloadSchema, type PaymentRequired, PaymentRequiredSchema, type PaymentRequirements, PaymentRequirementsSchema, type ResourceInfo, ResourceInfoSchema, isPaymentPayload, isPaymentRequired, isPaymentRequirements, parsePaymentPayload, parsePaymentRequired, parsePaymentRequirements, validatePaymentPayload, validatePaymentRequired, validatePaymentRequirements };

package/dist/esm/schemas/index.mjs

@@ -0,0 +1,41 @@
+import {
+  Any,
+  NetworkSchema,
+  NonEmptyString,
+  OptionalAny,
+  PaymentPayloadSchema,
+  PaymentRequiredSchema,
+  PaymentRequirementsSchema,
+  ResourceInfoSchema,
+  isPaymentPayload,
+  isPaymentRequired,
+  isPaymentRequirements,
+  parsePaymentPayload,
+  parsePaymentRequired,
+  parsePaymentRequirements,
+  validatePaymentPayload,
+  validatePaymentRequired,
+  validatePaymentRequirements,
+  z
+} from "../chunk-CS33MEMU.mjs";
+export {
+  Any,
+  NetworkSchema,
+  NonEmptyString,
+  OptionalAny,
+  PaymentPayloadSchema,
+  PaymentRequiredSchema,
+  PaymentRequirementsSchema,
+  ResourceInfoSchema,
+  isPaymentPayload,
+  isPaymentRequired,
+  isPaymentRequirements,
+  parsePaymentPayload,
+  parsePaymentRequired,
+  parsePaymentRequirements,
+  validatePaymentPayload,
+  validatePaymentRequired,
+  validatePaymentRequirements,
+  z
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/schemas/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/server/index.d.mts

@@ -0,0 +1,2 @@
+export { D as DEFAULT_POLL_DEADLINE_MS, k as DEFAULT_POLL_INTERVAL_MS, d as FacilitatorClient, e as FacilitatorConfig, f as FacilitatorResponseError, H as HTTPFacilitatorClient, l as PollResult, R as ResourceConfig, m as SettleResultContext, n as SettlementOverrides, g as getFacilitatorResponseError, x as x402ResourceServer } from '../mechanisms-sojpSwWW.mjs';
+export { C as CompiledRoute, H as HTTPAdapter, b as HTTPProcessResult, c as HTTPRequestContext, d as HTTPResponseBody, e as HTTPResponseInstructions, f as HTTPTransportContext, g as PaywallConfig, h as PaywallProvider, i as ProcessSettleFailureResponse, j as ProcessSettleResultResponse, k as ProcessSettleSuccessResponse, R as RouteConfig, m as RouteConfigurationError, n as RouteValidationError, o as RoutesConfig, p as SETTLEMENT_OVERRIDES_HEADER, S as SettlementFailedResponseBody, U as UnpaidResponseBody, x as x402HTTPResourceServer } from '../x402HTTPResourceServer-DBeutKxq.mjs';

package/dist/esm/server/index.mjs

@@ -0,0 +1,28 @@
+import {
+  DEFAULT_POLL_DEADLINE_MS,
+  DEFAULT_POLL_INTERVAL_MS,
+  HTTPFacilitatorClient,
+  RouteConfigurationError,
+  SETTLEMENT_OVERRIDES_HEADER,
+  x402HTTPResourceServer,
+  x402ResourceServer
+} from "../chunk-XBQG2CDV.mjs";
+import "../chunk-O3IYMTNT.mjs";
+import {
+  FacilitatorResponseError,
+  getFacilitatorResponseError
+} from "../chunk-CAXWAW23.mjs";
+import "../chunk-TDLQZ6MP.mjs";
+import "../chunk-CS33MEMU.mjs";
+export {
+  DEFAULT_POLL_DEADLINE_MS,
+  DEFAULT_POLL_INTERVAL_MS,
+  FacilitatorResponseError,
+  HTTPFacilitatorClient,
+  RouteConfigurationError,
+  SETTLEMENT_OVERRIDES_HEADER,
+  getFacilitatorResponseError,
+  x402HTTPResourceServer,
+  x402ResourceServer
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/index.d.mts

@@ -0,0 +1 @@
+export { A as AssetAmount, p as FacilitatorContext, F as FacilitatorExtension, f as FacilitatorResponseError, M as Money, q as MoneyParser, N as Network, P as PaymentPayload, r as PaymentPayloadContext, s as PaymentPayloadResult, c as PaymentRequired, t as PaymentRequiredContext, a as PaymentRequirements, o as Price, u as ResourceInfo, v as ResourceServerExtension, j as SchemeNetworkClient, b as SchemeNetworkFacilitator, w as SchemeNetworkServer, y as SettleError, z as SettleRequest, S as SettleResponse, m as SettleResultContext, i as SettleStatusResponse, h as SupportedResponse, B as VerifyError, C as VerifyRequest, V as VerifyResponse, g as getFacilitatorResponseError } from '../mechanisms-sojpSwWW.mjs';

package/dist/esm/types/index.mjs

@@ -0,0 +1,13 @@
+import {
+  FacilitatorResponseError,
+  SettleError,
+  VerifyError,
+  getFacilitatorResponseError
+} from "../chunk-CAXWAW23.mjs";
+export {
+  FacilitatorResponseError,
+  SettleError,
+  VerifyError,
+  getFacilitatorResponseError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/utils/index.d.mts

@@ -0,0 +1,48 @@
+import { N as Network } from '../mechanisms-sojpSwWW.mjs';
+
+/**
+ * Scheme data structure for facilitator storage
+ */
+interface SchemeData<T> {
+    facilitator: T;
+    networks: Set<Network>;
+    pattern: Network;
+}
+declare const findSchemesByNetwork: <T>(map: Map<string, Map<string, T>>, network: Network) => Map<string, T> | undefined;
+declare const findByNetworkAndScheme: <T>(map: Map<string, Map<string, T>>, scheme: string, network: Network) => T | undefined;
+/**
+ * Finds a facilitator by scheme and network using pattern matching.
+ * Works with new SchemeData storage structure.
+ *
+ * @param schemeMap - Map of scheme names to SchemeData
+ * @param scheme - The scheme to find
+ * @param network - The network to match against
+ * @returns The facilitator if found, undefined otherwise
+ */
+declare const findFacilitatorBySchemeAndNetwork: <T>(schemeMap: Map<string, SchemeData<T>>, scheme: string, network: Network) => T | undefined;
+declare const Base64EncodedRegex: RegExp;
+/**
+ * Encodes a string to base64 format
+ *
+ * @param data - The string to be encoded to base64
+ * @returns The base64 encoded string
+ */
+declare function safeBase64Encode(data: string): string;
+/**
+ * Decodes a base64 string back to its original format
+ *
+ * @param data - The base64 encoded string to be decoded
+ * @returns The decoded string in UTF-8 format
+ */
+declare function safeBase64Decode(data: string): string;
+/**
+ * Deep equality comparison for payment requirements
+ * Uses a normalized JSON.stringify for consistent comparison
+ *
+ * @param obj1 - First object to compare
+ * @param obj2 - Second object to compare
+ * @returns True if objects are deeply equal
+ */
+declare function deepEqual(obj1: unknown, obj2: unknown): boolean;
+
+export { Base64EncodedRegex, type SchemeData, deepEqual, findByNetworkAndScheme, findFacilitatorBySchemeAndNetwork, findSchemesByNetwork, safeBase64Decode, safeBase64Encode };

package/dist/esm/utils/index.mjs

@@ -0,0 +1,19 @@
+import {
+  Base64EncodedRegex,
+  deepEqual,
+  findByNetworkAndScheme,
+  findFacilitatorBySchemeAndNetwork,
+  findSchemesByNetwork,
+  safeBase64Decode,
+  safeBase64Encode
+} from "../chunk-TDLQZ6MP.mjs";
+export {
+  Base64EncodedRegex,
+  deepEqual,
+  findByNetworkAndScheme,
+  findFacilitatorBySchemeAndNetwork,
+  findSchemesByNetwork,
+  safeBase64Decode,
+  safeBase64Encode
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}