@atxp/common 0.7.2 → 0.7.4

package/dist/cache.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Cache interface for abstracting cache mechanisms
+ * This allows for easy mocking in tests and potential future
+ * support for different cache backends (e.g., React Native AsyncStorage)
+ */
+export interface ICache<T = string> {
+    get(key: string): T | null;
+    set(key: string, value: T): void;
+    delete(key: string): void;
+}
+/**
+ * Type-safe cache wrapper for JSON data
+ */
+export declare class JsonCache<T> {
+    private cache;
+    constructor(cache: ICache<string>);
+    get(key: string): T | null;
+    set(key: string, data: T): void;
+    delete(key: string): void;
+}
+/**
+ * Browser localStorage implementation
+ */
+export declare class BrowserCache implements ICache<string> {
+    private isAvailable;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+}
+/**
+ * In-memory cache implementation for testing
+ */
+export declare class MemoryCache implements ICache<string> {
+    private store;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,MAAM;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;IAEzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAY1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAI/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,MAAM,CAAC,MAAM,CAAC;IACjD,OAAO,CAAC,WAAW;IAInB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAI1B;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,MAAM,CAAC,MAAM,CAAC;IAChD,OAAO,CAAC,KAAK,CAAkC;IAE/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/commonTestHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonTestHelpers.d.ts","sourceRoot":"","sources":["../src/commonTestHelpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGzH,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAC7C,eAAO,MAAM,MAAM,eAAe,CAAC;AAGnC,wBAAgB,WAAW,CAAC,EAAC,EAAM,EAAE,MAAwB,EAAC,GAAE;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GAAG,eAAe,CAEvB;AAED,wBAAgB,aAAa,CAAC,EAC1B,OAA+C,EAC/C,iBAA6B,EAC7B,OAAe,EAChB,GAAE;IACD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GAAG,cAAc,CAExB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,OAA8C,EAC9C,iBAA6B,GAC9B,GAAE;IACD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACpB,GAAG,eAAe,CAGvB;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,mBAAmB,GAAE,MAAuE;;;;;EAOhI;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,GAAE,MAAU,EAAE,eAAe,GAAE,MAAqB;;;;;;;;;EAY3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,GAAE,MAAU,EAAE,IAAI,GAAE,MAAsB;;;;;;;;;EAO3E;AAED,wBAAgB,kBAAkB,CAAC,YAAY,GAAE,eAAmD,IAClF,KAAK,GAAG,EAAE,MAAM,GAAG;;;;;;;;;;;;;;;EAyCpC;AAED,wBAAgB,gBAAgB,CAAC,EAAC,EAAM,EAAE,IAAa,EAAE,OAAsB,EAAE,IAAgB,EAAC,EAAG;IACnG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAA;CACX,GAAG,YAAY,CAMf;AAED,wBAAgB,mCAAmC,CAAC,EAAC,EAAM,EAAE,OAAsB,EAAE,aAAqB,EAAE,GAAgD,EAAE,IAAS,EAAC,EAAG;IACzK,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,GAAG,CAAA;CACX,GAAG,YAAY,CAKf"}

package/dist/eip1271JwtHelper.d.ts

@@ -0,0 +1,49 @@
+/**
+ * EIP-1271 JWT helper utilities for creating properly formatted JWTs
+ * from EIP-1271 auth data.
+ */
+interface EIP1271AuthData {
+    type: 'EIP1271_AUTH';
+    walletAddress: string;
+    message: string;
+    signature: string;
+    timestamp: number;
+    nonce?: string;
+    code_challenge?: string;
+    payment_request_id?: string;
+}
+/**
+ * Convert EIP-1271 auth data to JWT format
+ * @param authData The EIP-1271 auth data (signature will be moved to JWT signature section)
+ * @returns JWT string in the format header.payload.signature
+ */
+export declare function createEIP1271JWT(authData: EIP1271AuthData): string;
+/**
+ * Legacy function to create the old base64url encoded auth data format
+ * This is kept for backward compatibility during transition period
+ */
+export declare function createLegacyEIP1271Auth(authData: EIP1271AuthData): string;
+/**
+ * Create auth data structure from signing parameters
+ */
+export declare function createEIP1271AuthData({ walletAddress, message, signature, timestamp, nonce, codeChallenge, paymentRequestId }: {
+    walletAddress: string;
+    message: string;
+    signature: string;
+    timestamp: number;
+    nonce?: string;
+    codeChallenge?: string;
+    paymentRequestId?: string;
+}): EIP1271AuthData;
+/**
+ * Construct the standardized message format for EIP-1271 signing
+ */
+export declare function constructEIP1271Message({ walletAddress, timestamp, nonce, codeChallenge, paymentRequestId }: {
+    walletAddress: string;
+    timestamp: number;
+    nonce?: string;
+    codeChallenge?: string;
+    paymentRequestId?: string;
+}): string;
+export {};
+//# sourceMappingURL=eip1271JwtHelper.d.ts.map

package/dist/eip1271JwtHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip1271JwtHelper.d.ts","sourceRoot":"","sources":["../src/eip1271JwtHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,eAAe;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA4BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA4BlE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,aAAa,EACb,OAAO,EACP,SAAS,EACT,SAAS,EACT,KAAK,EACL,aAAa,EACb,gBAAgB,EACjB,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,eAAe,CAWlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,aAAa,EACb,SAAS,EACT,KAAK,EACL,aAAa,EACb,gBAAgB,EACjB,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAsBT"}

package/dist/index.d.ts

@@ -26,7 +26,7 @@ type Logger = {
 type UrlString = `http://${string}` | `https://${string}`;
 type AuthorizationServerUrl = UrlString;
 type Currency = 'USDC';
-type Network = 'solana' | 'base' | 'world' | 'base_sepolia' | 'world_sepolia';
+type Network = 'solana' | 'base' | 'world' | 'base_sepolia' | 'world_sepolia' | 'atxp_base' | 'atxp_base_sepolia';
 type PaymentRequestDestination = {
     network: Network;
     currency: Currency;

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EACL,4BAA4B,EAC5B,QAAQ,EACR,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,cAAc,EACnB,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,MAAM,EACP,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,MAAM,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC"}

package/dist/jwt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate a JWT using the jose library and EdDSA (Ed25519) private key.
+ * @param walletId - The subject (public key, wallet address, etc.)
+ * @param privateKey - Ed25519 private key as a CryptoKey or Uint8Array
+ * @param paymentIds - Optional array of payment IDs to include in the payload
+ * @returns JWT string
+ */
+export declare const generateJWT: (walletId: string, privateKey: CryptoKey | Uint8Array, paymentRequestId: string, codeChallenge: string) => Promise<string>;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../src/jwt.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,EAChB,YAAY,SAAS,GAAG,UAAU,EAClC,kBAAkB,MAAM,EACxB,eAAe,MAAM,KACpB,OAAO,CAAC,MAAM,CAehB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+import { Logger, LogLevel } from './types.js';
+export declare class ConsoleLogger implements Logger {
+    private readonly prefix;
+    private _level;
+    constructor({ prefix, level }?: Partial<{
+        prefix: string;
+        level: LogLevel;
+    }>);
+    get level(): LogLevel;
+    set level(level: LogLevel);
+    private log;
+    private getConsoleMethod;
+    debug: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,MAAM,CAAW;gBAEb,EAAC,MAAiB,EAAE,KAAqB,EAAC,GAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAC,CAAM;IAKvG,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,EAExB;IAED,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,gBAAgB;IAUxB,KAAK,GAAI,SAAS,MAAM,UAEvB;IACD,IAAI,GAAI,SAAS,MAAM,UAEtB;IACD,IAAI,GAAI,SAAS,MAAM,UAEtB;IACD,KAAK,GAAI,SAAS,MAAM,UAEvB;CACF"}

package/dist/mcpJson.d.ts

@@ -0,0 +1,9 @@
+import { AuthorizationServerUrl } from './types.js';
+import { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import { Logger } from './types.js';
+export declare function parsePaymentRequests(message: JSONRPCMessage): {
+    url: AuthorizationServerUrl;
+    id: string;
+}[];
+export declare function parseMcpMessages(json: unknown, logger?: Logger): Promise<JSONRPCMessage[]>;
+//# sourceMappingURL=mcpJson.d.ts.map

package/dist/mcpJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpJson.d.ts","sourceRoot":"","sources":["../src/mcpJson.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAmE,cAAc,EAAwB,MAAM,oCAAoC,CAAC;AAC3J,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG;IAAC,GAAG,EAAE,sBAAsB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,EAAE,CAsDzG;AAeD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAiDhG"}

package/dist/memoryOAuthDb.d.ts

@@ -0,0 +1,25 @@
+import { OAuthDb, ClientCredentials, PKCEValues, AccessToken, Logger } from './types.js';
+export interface MemoryOAuthDbConfig {
+    logger?: Logger;
+}
+export declare class MemoryOAuthDb implements OAuthDb {
+    private clientCredentials;
+    private pkceValues;
+    private accessTokens;
+    private logger;
+    constructor(config?: MemoryOAuthDbConfig);
+    getClientCredentials(serverUrl: string): Promise<ClientCredentials | null>;
+    saveClientCredentials(serverUrl: string, credentials: ClientCredentials): Promise<void>;
+    getPKCEValues(userId: string, state: string): Promise<PKCEValues | null>;
+    savePKCEValues(userId: string, state: string, values: PKCEValues): Promise<void>;
+    getAccessToken(userId: string, url: string): Promise<AccessToken | null>;
+    saveAccessToken(userId: string, url: string, token: AccessToken): Promise<void>;
+    close(): Promise<void>;
+    getStats(): {
+        clientCredentials: number;
+        pkceValues: number;
+        accessTokens: number;
+    };
+    cleanupExpiredTokens(): number;
+}
+//# sourceMappingURL=memoryOAuthDb.d.ts.map

package/dist/memoryOAuthDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryOAuthDb.d.ts","sourceRoot":"","sources":["../src/memoryOAuthDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAY,MAAM,YAAY,CAAC;AAGnG,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,mBAAwB;IAMtC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAW1E,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMxE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhF,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAqBxE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,QAAQ;;;;;IASR,oBAAoB,IAAI,MAAM;CAiB/B"}

package/dist/oAuthResource.d.ts

@@ -0,0 +1,35 @@
+import * as oauth from 'oauth4webapi';
+import { ClientCredentials, FetchLike, OAuthResourceDb, OAuthDb, TokenData, Logger } from './types.js';
+export interface OAuthResourceClientConfig {
+    db: OAuthDb;
+    callbackUrl?: string;
+    isPublic?: boolean;
+    sideChannelFetch?: FetchLike;
+    strict?: boolean;
+    allowInsecureRequests?: boolean;
+    clientName?: string;
+    logger?: Logger;
+}
+export declare class OAuthResourceClient {
+    protected db: OAuthResourceDb;
+    protected allowInsecureRequests: boolean;
+    protected callbackUrl: string;
+    protected sideChannelFetch: FetchLike;
+    protected strict: boolean;
+    protected clientName: string;
+    protected isPublic: boolean;
+    protected logger: Logger;
+    private registrationLocks;
+    constructor({ db, callbackUrl, isPublic, sideChannelFetch, strict, allowInsecureRequests, clientName, logger }: OAuthResourceClientConfig);
+    static trimToPath: (url: string) => string;
+    static getParentPath: (url: string) => string | null;
+    introspectToken: (authorizationServerUrl: string, token: string, additionalParameters?: Record<string, string>) => Promise<TokenData>;
+    getAuthorizationServer: (resourceServerUrl: string) => Promise<oauth.AuthorizationServer>;
+    authorizationServerFromUrl: (authServerUrl: URL) => Promise<oauth.AuthorizationServer>;
+    protected normalizeResourceServerUrl: (resourceServerUrl: string) => string;
+    protected getRegistrationMetadata: () => Promise<Partial<oauth.OmitSymbolProperties<oauth.Client>>>;
+    protected registerClient: (authorizationServer: oauth.AuthorizationServer) => Promise<ClientCredentials>;
+    protected getClientCredentials: (authorizationServer: oauth.AuthorizationServer) => Promise<ClientCredentials>;
+    protected makeOAuthClientAndAuth: (credentials: ClientCredentials) => [oauth.Client, oauth.ClientAuth];
+}
+//# sourceMappingURL=oAuthResource.d.ts.map

package/dist/oAuthResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuthResource.d.ts","sourceRoot":"","sources":["../src/oAuthResource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGvG,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAK9B,SAAS,CAAC,EAAE,EAAE,eAAe,CAAC;IAC9B,SAAS,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACzC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,gBAAgB,EAAE,SAAS,CAAC;IACtC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAG7B,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,iBAAiB,CAAiD;gBAE9D,EACV,EAAE,EACF,WAAkE,EAClE,QAAgB,EAChB,gBAAwB,EACxB,MAAc,EACd,qBAA8D,EAC9D,UAAyC,EACzC,MAA4B,EAC7B,EAAE,yBAAyB;IAa5B,MAAM,CAAC,UAAU,GAAI,KAAK,MAAM,KAAG,MAAM,CAWxC;IAED,MAAM,CAAC,aAAa,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAAI,CAKlD;IAED,eAAe,GAAU,wBAAwB,MAAM,EAAE,OAAO,MAAM,EAAE,uBAAuB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,OAAO,CAAC,SAAS,CAAC,CAkEzI;IAED,sBAAsB,GAAU,mBAAmB,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CA8D7F;IAED,0BAA0B,GAAU,eAAe,GAAG,KAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAmB1F;IAED,SAAS,CAAC,0BAA0B,GAAI,mBAAmB,MAAM,KAAG,MAAM,CAQzE;IAED,SAAS,CAAC,uBAAuB,QAAa,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAYvG;IAED,SAAS,CAAC,cAAc,GAAU,qBAAqB,KAAK,CAAC,mBAAmB,KAAG,OAAO,CAAC,iBAAiB,CAAC,CAyC5G;IAED,SAAS,CAAC,oBAAoB,GAAU,qBAAqB,KAAK,CAAC,mBAAmB,KAAG,OAAO,CAAC,iBAAiB,CAAC,CAyBlH;IAED,SAAS,CAAC,sBAAsB,GAC9B,aAAa,iBAAiB,KAC7B,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAkBlC;CACF"}

package/dist/paymentRequiredError.d.ts

@@ -0,0 +1,6 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { AuthorizationServerUrl } from "./types.js";
+export declare const PAYMENT_REQUIRED_ERROR_CODE = -30402;
+export declare const PAYMENT_REQUIRED_PREAMBLE = "Payment via ATXP is required. ";
+export declare function paymentRequiredError(server: AuthorizationServerUrl, paymentRequestId: string, chargeAmount?: BigNumber): McpError;
+//# sourceMappingURL=paymentRequiredError.d.ts.map

package/dist/paymentRequiredError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentRequiredError.d.ts","sourceRoot":"","sources":["../src/paymentRequiredError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAGlD,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAE1E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,SAAS,GAAG,QAAQ,CAQjI"}

package/dist/platform/index.d.ts

@@ -0,0 +1,14 @@
+import type { FetchLike } from '../types.js';
+export interface PlatformCrypto {
+    digest: (data: Uint8Array) => Promise<Uint8Array>;
+    randomUUID: () => string;
+    toHex: (data: Uint8Array) => string;
+}
+export declare function getIsReactNative(): boolean;
+export declare const isNode: boolean;
+export declare const isBrowser: boolean;
+export declare const isNextJS: boolean;
+export declare const isWebEnvironment: boolean;
+export declare const createReactNativeSafeFetch: (originalFetch: FetchLike) => FetchLike;
+export declare let crypto: PlatformCrypto;
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;CACrC;AAID,wBAAgB,gBAAgB,YAG/B;AACD,eAAO,MAAM,MAAM,SAA6D,CAAC;AACjF,eAAO,MAAM,SAAS,SAAmE,CAAC;AAC1F,eAAO,MAAM,QAAQ,SAA2E,CAAC;AACjG,eAAO,MAAM,gBAAgB,SAAwB,CAAC;AAmDtD,eAAO,MAAM,0BAA0B,GAAI,eAAe,SAAS,KAAG,SA4BrE,CAAC;AA6GF,eAAO,IAAI,MAAM,EAAE,cAAc,CAAC"}

package/dist/servers.d.ts

@@ -0,0 +1,14 @@
+export declare const Servers: {
+    readonly browse: "https://browse.mcp.atxp.ai";
+    readonly filestore: "https://filestore.mcp.atxp.ai";
+    readonly database: "https://database.mcp.atxp.ai";
+    readonly code: "https://code.mcp.atxp.ai";
+    readonly search: "https://search.mcp.atxp.ai";
+    readonly crawl: "https://crawl.mcp.atxp.ai";
+    readonly video: "https://video.mcp.atxp.ai";
+    readonly image: "https://image.mcp.atxp.ai";
+    readonly music: "https://music.mcp.atxp.ai";
+    readonly research: "https://research.mcp.atxp.ai";
+    readonly shop: "https://shop.mcp.atxp.ai";
+};
+//# sourceMappingURL=servers.d.ts.map

package/dist/servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../src/servers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO;;;;;;;;;;;;CAYV,CAAC"}

package/dist/sseParser.d.ts

@@ -0,0 +1,27 @@
+import { Logger } from './types.js';
+export interface SSEMessage {
+    event?: string;
+    data: string;
+    id?: string;
+    retry?: number;
+}
+/**
+ * Parses SSE (Server-Sent Events) formatted text into individual messages
+ * @param sseText - The raw SSE text to parse
+ * @returns Array of parsed SSE messages
+ */
+export declare function parseSSEMessages(sseText: string): SSEMessage[];
+/**
+ * Extracts JSON-RPC messages from SSE data fields
+ * @param sseMessages - Array of SSE messages
+ * @param logger - Optional logger for debugging
+ * @returns Array of parsed JSON objects from SSE data fields
+ */
+export declare function extractJSONFromSSE(sseMessages: SSEMessage[], logger?: Logger): unknown[];
+/**
+ * Determines if a response body appears to be SSE formatted
+ * @param body - The response body to check
+ * @returns true if the body appears to be SSE formatted
+ */
+export declare function isSSEResponse(body: unknown): boolean;
+//# sourceMappingURL=sseParser.d.ts.map

package/dist/sseParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParser.d.ts","sourceRoot":"","sources":["../src/sseParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAsD9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAgBxF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAqBpD"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+export declare const DEFAULT_AUTHORIZATION_SERVER = "https://auth.atxp.ai";
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export type Logger = {
+    debug: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+};
+export type UrlString = `http://${string}` | `https://${string}`;
+export type AuthorizationServerUrl = UrlString;
+export type Currency = 'USDC';
+export type Network = 'solana' | 'base' | 'world' | 'base_sepolia' | 'world_sepolia' | 'atxp_base' | 'atxp_base_sepolia';
+export type PaymentRequestDestination = {
+    network: Network;
+    currency: Currency;
+    address: string;
+    amount: BigNumber;
+};
+export type PaymentRequestData = {
+    destinations?: PaymentRequestDestination[];
+    amount?: BigNumber;
+    currency?: Currency;
+    network?: Network;
+    destination?: string;
+    source: string;
+    resource: URL;
+    resourceName: string;
+    payeeName?: string | null;
+    iss: string;
+};
+export type CustomJWTPayload = {
+    code_challenge?: string;
+    payment_request_id?: string;
+};
+export type ClientCredentials = {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+};
+export type PKCEValues = {
+    codeVerifier: string;
+    codeChallenge: string;
+    resourceUrl: string;
+    url: string;
+};
+export type AccessToken = {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    resourceUrl: string;
+};
+export interface OAuthResourceDb {
+    getClientCredentials(serverUrl: string): Promise<ClientCredentials | null>;
+    saveClientCredentials(serverUrl: string, credentials: ClientCredentials): Promise<void>;
+    close(): Promise<void>;
+}
+export interface OAuthDb extends OAuthResourceDb {
+    getPKCEValues(userId: string, state: string): Promise<PKCEValues | null>;
+    savePKCEValues(userId: string, state: string, values: PKCEValues): Promise<void>;
+    getAccessToken(userId: string, url: string): Promise<AccessToken | null>;
+    saveAccessToken(userId: string, url: string, token: AccessToken): Promise<void>;
+}
+export type TokenData = {
+    active: boolean;
+    scope?: string;
+    sub?: string;
+    aud?: string | string[];
+};
+export type FetchLike = (url: string | URL, init?: RequestInit) => Promise<Response>;
+export type RequirePaymentConfig = {
+    price: BigNumber;
+    getExistingPaymentId?: () => Promise<string | null>;
+};
+//# 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/dist/utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Exhaustiveness check for switch statements.
+ * This function should never be called at runtime.
+ * It's used to ensure all cases of a union type or enum are handled.
+ *
+ * @param value - The value that should have been handled by all cases
+ * @param message - Optional error message
+ * @throws {Error} Always throws an error indicating unhandled case
+ */
+export declare function assertNever(value: never, message?: string): never;
+/**
+ * Type-safe way to check if a value is one of the enum values.
+ *
+ * @param enumObj - The enum object
+ * @param value - The value to check
+ * @returns True if the value is a valid enum value
+ */
+export declare function isEnumValue<T extends Record<string, string | number>>(enumObj: T, value: unknown): value is T[keyof T];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAGjE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACnE,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAErB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atxp/common",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "ATXP Core - Shared utilities and types for Authorization Token Exchange Protocol",
   "license": "MIT",
   "repository": {