@atxp/client 0.2.5

package/README.md

@@ -0,0 +1,112 @@
+# @atxp/client
+
+ATXP Client - MCP client with OAuth authentication and payment processing capabilities.
+
+## Overview
+
+The ATXP Client package provides a comprehensive solution for connecting to MCP (Model Context Protocol) servers that require OAuth authentication and payment processing. It handles the complete flow from initial connection through authentication, payment verification, and tool execution.
+
+**🚀 Getting Started**: Learn more about ATXP in [the docs](https://docs.atxp.ai/atxp), and follow the [Agent Quickstart](https://docs.atxp.ai/client) to build your first ATXP-powered agent.
+
+## Features
+
+- 🔐 **OAuth Authentication**: Full OAuth 2.0 flow implementation
+- 💰 **Payment Processing**: Solana-based payment integration  
+- 🔌 **MCP Protocol**: Complete Model Context Protocol client implementation
+- 📱 **Multi-Platform**: Supports Node.js and React Native/Expo environments
+- 🛡️ **Type Safety**: Full TypeScript support with comprehensive type definitions
+- 🔄 **Event System**: Real-time connection and authentication status updates
+
+## Installation
+
+```bash
+npm install @atxp/client
+```
+
+## Basic Usage
+
+```typescript
+import { ATXPClient } from '@atxp/client';
+
+const client = new ATXPClient({
+  serverUrl: 'http://localhost:3010',
+  clientId: 'your-oauth-client-id',
+  authServerUrl: 'https://auth.atxp.ai'
+});
+
+// Connect and authenticate
+await client.connect();
+
+// Call tools that require payment
+const result = await client.callTool('hello_world', {
+  name: 'Alice',
+  message: 'Hello from ATXP!'
+});
+```
+
+## Platform Support
+
+- **Node.js**: Full support with built-in OAuth database
+- **React Native/Expo**: Requires `expo-crypto` and `expo-sqlite` peer dependencies
+
+## Authentication Flow
+
+1. Client initiates connection to MCP server
+2. Server responds with OAuth challenge
+3. Client redirects user to authentication server
+4. User completes OAuth flow and returns with authorization code
+5. Client exchanges code for access token
+6. Authenticated requests can now be made to the server
+
+## Payment Processing
+
+When a tool requires payment, the client automatically:
+
+1. Detects payment requirement from server response
+2. Creates Solana payment transaction
+3. Prompts user to approve payment
+4. Submits payment proof to server
+5. Retries original tool call upon payment confirmation
+
+## API Reference
+
+### ATXPClient
+
+Main client class for ATXP protocol communication.
+
+#### Constructor Options
+
+```typescript
+interface ATXPClientConfig {
+  serverUrl: string;           // MCP server URL
+  clientId: string;            // OAuth client ID  
+  authServerUrl?: string;      // Auth server URL (defaults to https://auth.atxp.ai)
+  oAuthDb?: OAuthDb;          // Custom OAuth database implementation
+}
+```
+
+#### Methods
+
+- `connect()`: Establish connection to MCP server
+- `disconnect()`: Close connection and cleanup resources
+- `callTool(name, args)`: Execute server tool with automatic auth/payment handling
+- `listTools()`: Get available tools from server
+- `getAuthStatus()`: Check current authentication status
+
+#### Events
+
+- `authenticated`: Fired when OAuth flow completes successfully
+- `paymentRequired`: Fired when tool execution requires payment
+- `paymentCompleted`: Fired when payment is confirmed
+- `error`: Fired on connection or protocol errors
+
+## Examples
+
+See the `examples/` directory for complete working examples:
+
+- `examples/basic/`: Simple Node.js client implementation
+- `examples/server/`: Compatible MCP server with payment requirements
+
+## License
+
+MIT

package/dist/atxpAccount.d.ts

@@ -0,0 +1,13 @@
+import type { Account, PaymentMaker } from './types.js';
+import type { FetchLike } from '@atxp/common';
+export declare class ATXPAccount implements Account {
+    accountId: string;
+    paymentMakers: {
+        [key: string]: PaymentMaker;
+    };
+    constructor(connectionString: string, opts?: {
+        fetchFn?: FetchLike;
+        network?: string;
+    });
+}
+//# sourceMappingURL=atxpAccount.d.ts.map

package/dist/atxpAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atxpAccount.d.ts","sourceRoot":"","sources":["../src/atxpAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAgF7C,qBAAa,WAAY,YAAW,OAAO;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE,CAAC;gBAEnC,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAWvF"}

package/dist/atxpAccount.js

@@ -0,0 +1,81 @@
+function toBasicAuth(token) {
+    // Basic auth is base64("username:password"), password is blank
+    const b64 = Buffer.from(`${token}:`).toString('base64');
+    return `Basic ${b64}`;
+}
+function parseConnectionString(connectionString) {
+    const url = new URL(connectionString);
+    const origin = url.origin;
+    const token = url.searchParams.get('connection_token') || '';
+    if (!token) {
+        throw new Error('ATXPAccount: connection string missing connection token');
+    }
+    return { origin, token };
+}
+class ATXPHttpPaymentMaker {
+    constructor(origin, token, fetchFn = fetch) {
+        this.origin = origin;
+        this.token = token;
+        this.fetchFn = fetchFn;
+    }
+    async makePayment(amount, currency, receiver, memo) {
+        const body = {
+            amount: amount.toString(),
+            currency: (currency || '').toLowerCase() === 'usdc' ? 'usdc' : 'usdc',
+            receiver,
+            memo,
+        };
+        const response = await this.fetchFn(`${this.origin}/pay`, {
+            method: 'POST',
+            headers: {
+                'Authorization': toBasicAuth(this.token),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`ATXPAccount: /pay failed: ${response.status} ${response.statusText} ${text}`);
+        }
+        const json = await response.json();
+        if (!json?.txHash) {
+            throw new Error('ATXPAccount: /pay did not return txHash');
+        }
+        return json.txHash;
+    }
+    async generateJWT(params) {
+        const response = await this.fetchFn(`${this.origin}/sign`, {
+            method: 'POST',
+            headers: {
+                'Authorization': toBasicAuth(this.token),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                paymentRequestId: params.paymentRequestId,
+                codeChallenge: params.codeChallenge,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`ATXPAccount: /sign failed: ${response.status} ${response.statusText} ${text}`);
+        }
+        const json = await response.json();
+        if (!json?.jwt) {
+            throw new Error('ATXPAccount: /sign did not return jwt');
+        }
+        return json.jwt;
+    }
+}
+export class ATXPAccount {
+    constructor(connectionString, opts) {
+        const { origin, token } = parseConnectionString(connectionString);
+        const fetchFn = opts?.fetchFn ?? fetch;
+        const network = opts?.network ?? 'solana';
+        // Use token as a stable accountId namespace to keep OAuth/ATXP state per-connection
+        this.accountId = `atxp:${token}`;
+        this.paymentMakers = {
+            [network]: new ATXPHttpPaymentMaker(origin, token, fetchFn),
+        };
+    }
+}
+//# sourceMappingURL=atxpAccount.js.map

package/dist/atxpAccount.js.map

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

package/dist/atxpClient.d.ts

@@ -0,0 +1,14 @@
+import { ClientConfig } from "./types.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+type RequiredClientConfigFields = 'mcpServer' | 'account';
+type RequiredClientConfig = Pick<ClientConfig, RequiredClientConfigFields>;
+type OptionalClientConfig = Omit<ClientConfig, RequiredClientConfigFields>;
+export type ClientArgs = RequiredClientConfig & Partial<OptionalClientConfig>;
+type BuildableClientConfigFields = 'oAuthDb' | 'logger';
+export declare const DEFAULT_CLIENT_CONFIG: Required<Omit<OptionalClientConfig, BuildableClientConfigFields>>;
+export declare function buildClientConfig(args: ClientArgs): ClientConfig;
+export declare function buildStreamableTransport(args: ClientArgs): StreamableHTTPClientTransport;
+export declare function atxpClient(args: ClientArgs): Promise<Client>;
+export {};
+//# sourceMappingURL=atxpClient.d.ts.map

package/dist/atxpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atxpClient.d.ts","sourceRoot":"","sources":["../src/atxpClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,KAAK,0BAA0B,GAAG,WAAW,GAAG,SAAS,CAAC;AAC1D,KAAK,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;AAC3E,KAAK,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;AAC3E,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAC9E,KAAK,2BAA2B,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,2BAA2B,CAAC,CAiBnG,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAehE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,6BAA6B,CAoBxF;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlE"}

package/dist/atxpClient.js

@@ -0,0 +1,67 @@
+import { MemoryOAuthDb, ConsoleLogger, DEFAULT_AUTHORIZATION_SERVER } from "@atxp/common";
+import { ATXPFetcher } from "./atxpFetcher.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+export const DEFAULT_CLIENT_CONFIG = {
+    allowedAuthorizationServers: [DEFAULT_AUTHORIZATION_SERVER],
+    approvePayment: async (_p) => true,
+    fetchFn: fetch,
+    oAuthChannelFetch: fetch,
+    allowHttp: false, // may be overridden in buildClientConfig by process.env.NODE_ENV
+    clientInfo: {
+        name: 'ATXPClient',
+        version: '0.0.1'
+    },
+    clientOptions: {
+        capabilities: {}
+    },
+    onAuthorize: async () => { },
+    onAuthorizeFailure: async () => { },
+    onPayment: async () => { },
+    onPaymentFailure: async () => { }
+};
+export function buildClientConfig(args) {
+    // Use fetchFn for oAuthChannelFetch if the latter isn't explicitly set
+    if (args.fetchFn && !args.oAuthChannelFetch) {
+        args.oAuthChannelFetch = args.fetchFn;
+    }
+    // Read environment variable at runtime, not module load time
+    const envDefaults = {
+        ...DEFAULT_CLIENT_CONFIG,
+        allowHttp: process.env.NODE_ENV === 'development',
+    };
+    const withDefaults = { ...envDefaults, ...args };
+    const logger = withDefaults.logger ?? new ConsoleLogger();
+    const oAuthDb = withDefaults.oAuthDb ?? new MemoryOAuthDb({ logger });
+    const built = { oAuthDb, logger };
+    return Object.freeze({ ...withDefaults, ...built });
+}
+;
+export function buildStreamableTransport(args) {
+    const config = buildClientConfig(args);
+    const fetcher = new ATXPFetcher({
+        accountId: args.account.accountId,
+        db: config.oAuthDb,
+        paymentMakers: args.account.paymentMakers,
+        fetchFn: config.fetchFn,
+        sideChannelFetch: config.oAuthChannelFetch,
+        allowInsecureRequests: config.allowHttp,
+        allowedAuthorizationServers: config.allowedAuthorizationServers,
+        approvePayment: config.approvePayment,
+        logger: config.logger,
+        onAuthorize: config.onAuthorize,
+        onAuthorizeFailure: config.onAuthorizeFailure,
+        onPayment: config.onPayment,
+        onPaymentFailure: config.onPaymentFailure
+    });
+    const transport = new StreamableHTTPClientTransport(new URL(args.mcpServer), { fetch: fetcher.fetch });
+    return transport;
+}
+export async function atxpClient(args) {
+    const config = buildClientConfig(args);
+    const transport = buildStreamableTransport(config);
+    const client = new Client(config.clientInfo, config.clientOptions);
+    await client.connect(transport);
+    return client;
+}
+//# sourceMappingURL=atxpClient.js.map

package/dist/atxpClient.js.map

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

package/dist/atxpFetcher.d.ts

@@ -0,0 +1,71 @@
+import { OAuthAuthenticationRequiredError, OAuthClient } from './oAuth.js';
+import { AccessToken, AuthorizationServerUrl, FetchLike, OAuthDb, PaymentRequestData, Logger } from '@atxp/common';
+import type { PaymentMaker, ProspectivePayment } from './types.js';
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
+export interface ATXPFetcherConfig {
+    accountId: string;
+    db: OAuthDb;
+    paymentMakers: {
+        [key: string]: PaymentMaker;
+    };
+    fetchFn?: FetchLike;
+    sideChannelFetch?: FetchLike;
+    strict?: boolean;
+    allowInsecureRequests?: boolean;
+    allowedAuthorizationServers?: AuthorizationServerUrl[];
+    approvePayment?: (payment: ProspectivePayment) => Promise<boolean>;
+    logger?: Logger;
+    onAuthorize?: (args: {
+        authorizationServer: AuthorizationServerUrl;
+        userId: string;
+    }) => Promise<void>;
+    onAuthorizeFailure?: (args: {
+        authorizationServer: AuthorizationServerUrl;
+        userId: string;
+        error: Error;
+    }) => Promise<void>;
+    onPayment?: (args: {
+        payment: ProspectivePayment;
+    }) => Promise<void>;
+    onPaymentFailure?: (args: {
+        payment: ProspectivePayment;
+        error: Error;
+    }) => Promise<void>;
+}
+export declare function atxpFetch(config: ATXPFetcherConfig): FetchLike;
+export declare class ATXPFetcher {
+    protected oauthClient: OAuthClient;
+    protected paymentMakers: Map<string, PaymentMaker>;
+    protected sideChannelFetch: FetchLike;
+    protected db: OAuthDb;
+    protected accountId: string;
+    protected allowedAuthorizationServers: AuthorizationServerUrl[];
+    protected approvePayment: (payment: ProspectivePayment) => Promise<boolean>;
+    protected logger: Logger;
+    protected onAuthorize: (args: {
+        authorizationServer: AuthorizationServerUrl;
+        userId: string;
+    }) => Promise<void>;
+    protected onAuthorizeFailure: (args: {
+        authorizationServer: AuthorizationServerUrl;
+        userId: string;
+        error: Error;
+    }) => Promise<void>;
+    protected onPayment: (args: {
+        payment: ProspectivePayment;
+    }) => Promise<void>;
+    protected onPaymentFailure: (args: {
+        payment: ProspectivePayment;
+        error: Error;
+    }) => Promise<void>;
+    constructor({ accountId, db, paymentMakers, fetchFn, sideChannelFetch, strict, allowInsecureRequests, allowedAuthorizationServers, approvePayment, logger, onAuthorize, onAuthorizeFailure, onPayment, onPaymentFailure }: ATXPFetcherConfig);
+    protected handlePaymentRequestError: (paymentRequestError: McpError) => Promise<boolean>;
+    protected getPaymentRequestData: (paymentRequestUrl: string) => Promise<PaymentRequestData | null>;
+    protected isAllowedAuthServer: (url: string | URL) => boolean;
+    protected makeAuthRequestWithPaymentMaker: (authorizationUrl: URL, paymentMaker: PaymentMaker) => Promise<string>;
+    protected authToService: (error: OAuthAuthenticationRequiredError) => Promise<void>;
+    protected exchangeToken: (myToken: AccessToken, newResourceUrl: string) => Promise<AccessToken>;
+    protected checkForATXPResponse: (response: Response) => Promise<void>;
+    fetch: FetchLike;
+}
+//# sourceMappingURL=atxpFetcher.d.ts.map

package/dist/atxpFetcher.d.ts.map

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