@atxp/common 0.2.5

package/README.md

@@ -0,0 +1,176 @@
+# @atxp/common
+
+ATXP Core - Shared utilities and types for Authorization Token Exchange Protocol.
+
+## Overview
+
+The ATXP Common package provides shared utilities, types, and core functionality used by both ATXP client and server implementations. It contains the foundational components for OAuth authentication, JWT token handling, payment processing, and MCP protocol utilities.
+
+**🚀 Getting Started**: Learn more about ATXP in [the docs](https://docs.atxp.ai/atxp).
+
+## Features
+
+- 🔐 **JWT Token Management**: Secure token creation, validation, and parsing
+- 🗄️ **OAuth Database**: Abstract database interface with memory and SQLite implementations
+- 📡 **MCP JSON Utilities**: Type-safe MCP protocol message handling
+- 💰 **Payment Error Handling**: Structured payment requirement error types
+- 🛠️ **Platform Utilities**: Cross-platform compatibility helpers
+- 📊 **SSE Parser**: Server-sent events parsing for real-time communication
+- 🔧 **Logger**: Configurable logging system
+
+## Installation
+
+```bash
+npm install @atxp/common
+```
+
+This package is typically installed automatically as a dependency of `@atxp/client` or `@atxp/server`.
+
+## Key Components
+
+### JWT Token Management
+
+```typescript
+import { createJWT, verifyJWT, parseJWT } from '@atxp/common';
+
+// Create signed JWT
+const token = await createJWT({ userId: '123' }, secretKey);
+
+// Verify and parse JWT
+const payload = await verifyJWT(token, secretKey);
+
+// Parse without verification (for debugging)
+const { header, payload } = parseJWT(token);
+```
+
+### OAuth Database Interface
+
+```typescript
+import { OAuthDb, MemoryOAuthDb } from '@atxp/common';
+
+// Use in-memory database for development
+const oAuthDb = new MemoryOAuthDb();
+
+// Store OAuth tokens
+await oAuthDb.storeTokens('client123', {
+  access_token: 'token',
+  refresh_token: 'refresh',
+  expires_in: 3600
+});
+
+// Retrieve tokens
+const tokens = await oAuthDb.getTokens('client123');
+```
+
+### MCP Protocol Utilities
+
+```typescript
+import { 
+  MCPRequest, 
+  MCPResponse, 
+  MCPError,
+  createMCPResponse,
+  createMCPError 
+} from '@atxp/common';
+
+// Type-safe MCP request handling
+function handleMCPRequest(request: MCPRequest): MCPResponse {
+  if (request.method === 'tools/call') {
+    return createMCPResponse(request.id, { result: 'success' });
+  }
+  return createMCPError(request.id, -32601, 'Method not found');
+}
+```
+
+### Payment Error Handling
+
+```typescript
+import { PaymentRequiredError } from '@atxp/common';
+
+// Throw structured payment requirement
+throw new PaymentRequiredError({
+  amount: '0.01',
+  currency: 'USDC',
+  destination: 'solana-wallet-address',
+  reference: 'unique-payment-reference'
+});
+```
+
+### Platform Utilities
+
+```typescript
+import { Platform } from '@atxp/common';
+
+// Detect runtime environment
+const platform = Platform.detect();
+
+if (platform.isNode) {
+  // Node.js specific code
+} else if (platform.isExpo) {
+  // Expo/React Native specific code
+}
+
+// Get appropriate database implementation
+const db = Platform.createOAuthDb();
+```
+
+## Type Definitions
+
+The package exports comprehensive TypeScript types for:
+
+- **OAuth Types**: Token responses, authorization flows, client configurations
+- **MCP Types**: Protocol messages, tool definitions, error structures  
+- **Payment Types**: Payment requirements, transaction references, currency info
+- **Server Types**: Authentication contexts, middleware definitions
+
+## Database Implementations
+
+### MemoryOAuthDb
+
+In-memory OAuth token storage for development and testing:
+
+```typescript
+import { MemoryOAuthDb } from '@atxp/common';
+
+const db = new MemoryOAuthDb();
+// Tokens stored in memory, cleared on process restart
+```
+
+### SQLite Implementation
+
+Platform-specific SQLite implementations are automatically selected:
+- Node.js: Uses `better-sqlite3`
+- Expo/React Native: Uses `expo-sqlite`
+
+## Logging
+
+Configurable logging system with multiple levels:
+
+```typescript
+import { Logger } from '@atxp/common';
+
+const logger = new Logger('MyComponent');
+
+logger.debug('Debug message');
+logger.info('Info message'); 
+logger.warn('Warning message');
+logger.error('Error message');
+```
+
+## Utilities
+
+Various utility functions for:
+- Async operation helpers
+- Data validation and sanitization
+- Error handling and formatting
+- Time and date operations
+
+## Examples
+
+This package is used internally by the client and server packages. See:
+- `@atxp/client` for client-side usage examples
+- `@atxp/server` for server-side usage examples
+
+## License
+
+MIT

package/dist/commonTestHelpers.d.ts

@@ -0,0 +1,83 @@
+import { UrlString } from './types.js';
+import { JSONRPCResponse, Result, CallToolResult, ContentBlock, JSONRPCError } from '@modelcontextprotocol/sdk/types.js';
+export declare const DESTINATION = "testDestination";
+export declare const SOURCE = "testSource";
+export declare function mcpResponse({ id, result }?: {
+    id?: number;
+    result?: Result;
+}): JSONRPCResponse;
+export declare function mcpToolResult({ content, structuredContent, isError }?: {
+    content?: ContentBlock[];
+    structuredContent?: any;
+    isError?: boolean;
+}): CallToolResult;
+export declare function mcpToolErrorResponse({ content, structuredContent, }?: {
+    content?: ContentBlock[];
+    structuredContent?: any;
+}): JSONRPCResponse;
+export declare function paymentRequiredMessage(paymentUrl: UrlString, id: string): string;
+/**
+ * Creates a 401 Unauthorized response with OAuth challenge
+ */
+export declare function authRequiredResponse(resourceMetadataUrl?: string): {
+    status: number;
+    headers: {
+        'www-authenticate': string;
+    };
+};
+/**
+ * Creates an MCP initialize response with the full JSON-RPC wrapper
+ */
+export declare function mcpInitializeResponse(id?: number, protocolVersion?: string): {
+    jsonrpc: "2.0";
+    id: string | number;
+    result: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+};
+/**
+ * Creates an MCP tool call response with custom content
+ */
+export declare function mcpToolResponse(id?: number, text?: string): {
+    jsonrpc: "2.0";
+    id: string | number;
+    result: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+};
+export declare function mcpResponseHandler(toolResponse?: JSONRPCResponse): (url: any, opts: any) => {
+    status: number;
+    body: {
+        jsonrpc: "2.0";
+        id: string | number;
+        result: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        };
+    };
+} | {
+    status: number;
+    body: {};
+};
+export declare function mcpErrorResponse({ id, code, message, data }: {
+    id?: number;
+    code?: number;
+    message?: string;
+    data?: any;
+}): JSONRPCError;
+export declare function mcpElicitationRequiredErrorResponse({ id, message, elicitationId, url, data }: {
+    id?: number;
+    message?: string;
+    elicitationId?: string;
+    url?: string;
+    data?: any;
+}): JSONRPCError;
+//# sourceMappingURL=commonTestHelpers.d.ts.map

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/commonTestHelpers.js

@@ -0,0 +1,115 @@
+import { paymentRequiredError } from './paymentRequiredError.js';
+export const DESTINATION = 'testDestination';
+export const SOURCE = 'testSource';
+export function mcpResponse({ id = 1, result = mcpToolResult() } = {}) {
+    return { jsonrpc: "2.0", id, result };
+}
+export function mcpToolResult({ content = [{ type: 'text', text: 'tool-result' }], structuredContent = undefined, isError = false } = {}) {
+    return { content, structuredContent, isError };
+}
+export function mcpToolErrorResponse({ content = [{ type: 'text', text: 'tool-error' }], structuredContent = undefined, } = {}) {
+    const result = mcpToolResult({ isError: true, content, structuredContent });
+    return mcpResponse({ result });
+}
+export function paymentRequiredMessage(paymentUrl, id) {
+    const err = paymentRequiredError(paymentUrl, id);
+    return err.message;
+}
+/**
+ * Creates a 401 Unauthorized response with OAuth challenge
+ */
+export function authRequiredResponse(resourceMetadataUrl = 'https://example.com/.well-known/oauth-protected-resource/mcp') {
+    return {
+        status: 401,
+        headers: {
+            'www-authenticate': `Bearer resource_metadata="${resourceMetadataUrl}"`
+        }
+    };
+}
+/**
+ * Creates an MCP initialize response with the full JSON-RPC wrapper
+ */
+export function mcpInitializeResponse(id = 0, protocolVersion = '2025-06-18') {
+    return mcpResponse({
+        id,
+        result: {
+            protocolVersion,
+            capabilities: {},
+            serverInfo: {
+                name: 'test-server',
+                version: '1.0.0'
+            }
+        }
+    });
+}
+/**
+ * Creates an MCP tool call response with custom content
+ */
+export function mcpToolResponse(id = 1, text = 'tool-result') {
+    return mcpResponse({
+        id,
+        result: mcpToolResult({
+            content: [{ type: 'text', text }]
+        })
+    });
+}
+export function mcpResponseHandler(toolResponse = mcpToolResponse(1, 'hello world')) {
+    return function (url, opts) {
+        // fetch-mock might pass the URL and options differently
+        let body;
+        if (typeof url === 'string' && opts && opts.body) {
+            body = opts.body;
+        }
+        else if (url && url.options && url.options.body) {
+            body = url.options.body;
+        }
+        else {
+            // Return a default response
+            return {
+                status: 200,
+                body: mcpResponse()
+            };
+        }
+        // Parse the request to get the ID and method
+        const request = JSON.parse(body);
+        // Return a response based on the request method
+        if (request.method === 'initialize') {
+            return {
+                status: 200,
+                body: mcpInitializeResponse(request.id)
+            };
+        }
+        else if (request.method === 'tools/call') {
+            toolResponse.id = request.id;
+            return {
+                status: 200,
+                body: toolResponse
+            };
+        }
+        else if (request.method === 'notifications/initialized') {
+            // No response needed for notifications
+            return { status: 200, body: {} };
+        }
+        else {
+            // Default response
+            return {
+                status: 200,
+                body: mcpResponse({ id: request.id, result: {} })
+            };
+        }
+    };
+}
+export function mcpErrorResponse({ id = 1, code = -32000, message = 'test error', data = undefined }) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: { code, message, data }
+    };
+}
+export function mcpElicitationRequiredErrorResponse({ id = 1, message = 'test error', elicitationId = '123', url = 'https://auth.atxp.ai/payment-request/123', data = {} }) {
+    // Code as per https://github.com/modelcontextprotocol/modelcontextprotocol/pull/887
+    const code = -32604;
+    const elicitationData = { elicitations: [{ mode: 'url', elicitationId, url }] };
+    return mcpErrorResponse({ id, code, message, data: { ...data, ...elicitationData } });
+}
+//# sourceMappingURL=commonTestHelpers.js.map

package/dist/commonTestHelpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './jwt.js';
+export * from './logger.js';
+export * from './oAuthDb.js';
+export * from './memoryOAuthDb.js';
+export * from './oAuthDbFactory.js';
+export * from './redisOAuthDb.js';
+export * from './oAuthResource.js';
+export * from './paymentRequiredError.js';
+export * from './servers.js';
+export * from './types.js';
+export * from './utils.js';
+export * from './mcpJson.js';
+export * from './sseParser.js';
+export * from './platform/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './jwt.js';
+export * from './logger.js';
+export * from './oAuthDb.js';
+export * from './memoryOAuthDb.js';
+export * from './oAuthDbFactory.js';
+export * from './redisOAuthDb.js';
+export * from './oAuthResource.js';
+export * from './paymentRequiredError.js';
+export * from './servers.js';
+export * from './types.js';
+export * from './utils.js';
+export * from './mcpJson.js';
+export * from './sseParser.js';
+export * from './platform/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,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/jwt.js

@@ -0,0 +1,29 @@
+import { SignJWT } from 'jose';
+// TODO: revisit this
+const ISSUER = 'atxp.ai';
+const AUDIENCE = 'https://api.atxp.ai';
+/**
+ * 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 const generateJWT = async (walletId, privateKey, paymentRequestId, codeChallenge) => {
+    const payload = {
+        code_challenge: codeChallenge,
+    };
+    if (paymentRequestId)
+        payload.payment_request_id = paymentRequestId;
+    if (codeChallenge)
+        payload.code_challenge = codeChallenge;
+    return await new SignJWT(payload)
+        .setProtectedHeader({ alg: 'EdDSA', typ: 'JWT' })
+        .setIssuedAt()
+        .setIssuer(ISSUER)
+        .setAudience(AUDIENCE)
+        .setSubject(walletId)
+        .setExpirationTime('2m')
+        .sign(privateKey);
+};
+//# sourceMappingURL=jwt.js.map

package/dist/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../src/jwt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,qBAAqB;AACrB,MAAM,MAAM,GAAG,SAAS,CAAC;AACzB,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,QAAgB,EAChB,UAAkC,EAClC,gBAAwB,EACxB,aAAqB,EACJ,EAAE;IACnB,MAAM,OAAO,GAAqB;QAChC,cAAc,EAAE,aAAa;KAC9B,CAAC;IACF,IAAI,gBAAgB;QAAE,OAAO,CAAC,kBAAkB,GAAG,gBAAgB,CAAC;IACpE,IAAI,aAAa;QAAE,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC;IAE1D,OAAO,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;SAC9B,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;SAChD,WAAW,EAAE;SACb,SAAS,CAAC,MAAM,CAAC;SACjB,WAAW,CAAC,QAAQ,CAAC;SACrB,UAAU,CAAC,QAAQ,CAAC;SACpB,iBAAiB,CAAC,IAAI,CAAC;SACvB,IAAI,CAAC,UAAU,CAAC,CAAC;AACtB,CAAC,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/logger.js

@@ -0,0 +1,43 @@
+/* eslint-disable no-console */
+import { assertNever } from './utils.js';
+import { LogLevel } from './types.js';
+export class ConsoleLogger {
+    constructor({ prefix = '[atxp]', level = LogLevel.INFO } = {}) {
+        this.debug = (message) => {
+            this.log(LogLevel.DEBUG, message);
+        };
+        this.info = (message) => {
+            this.log(LogLevel.INFO, message);
+        };
+        this.warn = (message) => {
+            this.log(LogLevel.WARN, message);
+        };
+        this.error = (message) => {
+            this.log(LogLevel.ERROR, message);
+        };
+        this.prefix = prefix;
+        this._level = level;
+    }
+    get level() {
+        return this._level;
+    }
+    set level(level) {
+        this._level = level;
+    }
+    log(level, message) {
+        if (level >= this._level) {
+            const consoleMethod = this.getConsoleMethod(level);
+            consoleMethod(`${this.prefix} ${message}`);
+        }
+    }
+    getConsoleMethod(level) {
+        switch (level) {
+            case LogLevel.DEBUG: return console.debug.bind(console);
+            case LogLevel.INFO: return console.info.bind(console);
+            case LogLevel.WARN: return console.warn.bind(console);
+            case LogLevel.ERROR: return console.error.bind(console);
+            default: return assertNever(level, `Unknown log level: ${level}`);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAU,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,OAAO,aAAa;IAIxB,YAAY,EAAC,MAAM,GAAG,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC,IAAI,KAAgD,EAAE;QA8BvG,UAAK,GAAG,CAAC,OAAe,EAAE,EAAE;YAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC,CAAA;QACD,SAAI,GAAG,CAAC,OAAe,EAAE,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAA;QACD,SAAI,GAAG,CAAC,OAAe,EAAE,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAA;QACD,UAAK,GAAG,CAAC,OAAe,EAAE,EAAE;YAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC,CAAA;QAxCC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,CAAC,KAAe;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe;QAC1C,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACnD,aAAa,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,KAAe;QACtC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxD,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtD,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtD,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,EAAE,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;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"}