@fluxa-pay/fluxa-connect-mcp 0.1.4 → 0.1.6

package/dist/utils/jwt-utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * JWT utilities for parsing, validation, and refresh
+ */
+export interface JWTPayload {
+    agent_id: string;
+    email: string;
+    iat: number;
+    exp: number;
+}
+export declare class JWTError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse JWT and extract payload
+ * Note: This does NOT validate the signature, just parses the payload
+ */
+export declare function parseJWT(jwt: string): JWTPayload;
+/**
+ * Check if JWT is expired or expiring soon
+ * @param jwt - JWT token to check
+ * @param bufferSeconds - How many seconds before expiry to consider "expired" (default: 300 = 5 minutes)
+ * @returns true if expired or expiring soon
+ */
+export declare function isJWTExpired(jwt: string, bufferSeconds?: number): boolean;
+//# sourceMappingURL=jwt-utils.d.ts.map

package/dist/utils/jwt-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-utils.d.ts","sourceRoot":"","sources":["../../src/utils/jwt-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAuBhD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAY,GAAG,OAAO,CA0B9E"}

package/dist/utils/jwt-utils.js

@@ -0,0 +1,68 @@
+/**
+ * JWT utilities for parsing, validation, and refresh
+ */
+import { logger } from './logger.js';
+export class JWTError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'JWTError';
+    }
+}
+/**
+ * Parse JWT and extract payload
+ * Note: This does NOT validate the signature, just parses the payload
+ */
+export function parseJWT(jwt) {
+    try {
+        const parts = jwt.split('.');
+        if (parts.length !== 3) {
+            throw new JWTError('Invalid JWT format');
+        }
+        // Decode base64url payload (middle part)
+        const payload = parts[1];
+        const decoded = Buffer.from(payload, 'base64url').toString('utf-8');
+        const parsed = JSON.parse(decoded);
+        if (!parsed.exp || !parsed.agent_id) {
+            throw new JWTError('JWT missing required fields (exp, agent_id)');
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof JWTError) {
+            throw error;
+        }
+        throw new JWTError(`Failed to parse JWT: ${error.message}`);
+    }
+}
+/**
+ * Check if JWT is expired or expiring soon
+ * @param jwt - JWT token to check
+ * @param bufferSeconds - How many seconds before expiry to consider "expired" (default: 300 = 5 minutes)
+ * @returns true if expired or expiring soon
+ */
+export function isJWTExpired(jwt, bufferSeconds = 300) {
+    try {
+        const payload = parseJWT(jwt);
+        const expiresAt = payload.exp * 1000; // Convert to milliseconds
+        const now = Date.now();
+        const bufferMs = bufferSeconds * 1000;
+        const isExpired = (expiresAt - now) <= bufferMs;
+        if (isExpired) {
+            const timeUntilExpiry = Math.floor((expiresAt - now) / 1000);
+            logger.debug('jwt-utils', 'JWT expired or expiring soon', {
+                expiresAt: new Date(expiresAt).toISOString(),
+                timeUntilExpiry: `${timeUntilExpiry}s`,
+                bufferSeconds
+            });
+        }
+        return isExpired;
+    }
+    catch (error) {
+        // If we can't parse the JWT, treat it as expired
+        logger.warn('jwt-utils', 'Failed to parse JWT, treating as expired', {
+            error: error.message
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=jwt-utils.js.map

package/dist/utils/jwt-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-utils.js","sourceRoot":"","sources":["../../src/utils/jwt-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QAC3C,CAAC;QAED,yCAAyC;QACzC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,QAAQ,CAAC,6CAA6C,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,MAAoB,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,gBAAwB,GAAG;IACnE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,0BAA0B;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,aAAa,GAAG,IAAI,CAAC;QAEtC,MAAM,SAAS,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,QAAQ,CAAC;QAEhD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,8BAA8B,EAAE;gBACxD,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBAC5C,eAAe,EAAE,GAAG,eAAe,GAAG;gBACtC,aAAa;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,iDAAiD;QACjD,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,0CAA0C,EAAE;YACnE,KAAK,EAAE,KAAK,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Structured logging utility
+ * Logs to stderr to avoid interfering with MCP stdio protocol
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    [key: string]: any;
+}
+declare class Logger {
+    private minLevel;
+    private levelPriority;
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private format;
+    private sanitizeContext;
+    debug(component: string, message: string, context?: LogContext): void;
+    info(component: string, message: string, context?: LogContext): void;
+    warn(component: string, message: string, context?: LogContext): void;
+    error(component: string, message: string, context?: LogContext): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,QAAQ,CAAoB;IAEpC,OAAO,CAAC,aAAa,CAKnB;IAEF,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAIxB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,eAAe;IAqBvB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU;IAM9D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU;IAM7D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU;IAM7D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU;CAK/D;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,75 @@
+/**
+ * Structured logging utility
+ * Logs to stderr to avoid interfering with MCP stdio protocol
+ */
+class Logger {
+    minLevel = 'info';
+    levelPriority = {
+        debug: 0,
+        info: 1,
+        warn: 2,
+        error: 3
+    };
+    setLevel(level) {
+        this.minLevel = level;
+    }
+    shouldLog(level) {
+        return this.levelPriority[level] >= this.levelPriority[this.minLevel];
+    }
+    format(level, component, message, context) {
+        const timestamp = new Date().toISOString();
+        const levelStr = level.toUpperCase().padEnd(5);
+        const componentStr = `[${component}]`;
+        let output = `${timestamp} ${levelStr} ${componentStr} ${message}`;
+        if (context && Object.keys(context).length > 0) {
+            // Filter out sensitive data
+            const sanitized = this.sanitizeContext(context);
+            output += ` ${JSON.stringify(sanitized)}`;
+        }
+        return output;
+    }
+    sanitizeContext(context) {
+        const sanitized = { ...context };
+        // Remove or mask sensitive fields
+        const sensitiveKeys = ['jwt', 'token', 'password', 'secret', 'authorization'];
+        for (const key of Object.keys(sanitized)) {
+            const lowerKey = key.toLowerCase();
+            if (sensitiveKeys.some(s => lowerKey.includes(s))) {
+                if (typeof sanitized[key] === 'string') {
+                    // Show only length for sensitive strings
+                    sanitized[key] = `[REDACTED:length=${sanitized[key].length}]`;
+                }
+                else {
+                    sanitized[key] = '[REDACTED]';
+                }
+            }
+        }
+        return sanitized;
+    }
+    debug(component, message, context) {
+        if (this.shouldLog('debug')) {
+            console.error(this.format('debug', component, message, context));
+        }
+    }
+    info(component, message, context) {
+        if (this.shouldLog('info')) {
+            console.error(this.format('info', component, message, context));
+        }
+    }
+    warn(component, message, context) {
+        if (this.shouldLog('warn')) {
+            console.error(this.format('warn', component, message, context));
+        }
+    }
+    error(component, message, context) {
+        if (this.shouldLog('error')) {
+            console.error(this.format('error', component, message, context));
+        }
+    }
+}
+// Singleton instance
+export const logger = new Logger();
+// Set log level from environment
+const logLevel = process.env.LOG_LEVEL?.toLowerCase() || 'info';
+logger.setLevel(logLevel);
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,MAAM;IACF,QAAQ,GAAa,MAAM,CAAC;IAE5B,aAAa,GAA6B;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IAEO,MAAM,CAAC,KAAe,EAAE,SAAiB,EAAE,OAAe,EAAE,OAAoB;QACtF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,IAAI,SAAS,GAAG,CAAC;QAEtC,IAAI,MAAM,GAAG,GAAG,SAAS,IAAI,QAAQ,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;QAEnE,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,4BAA4B;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,OAAmB;QACzC,MAAM,SAAS,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAEjC,kCAAkC;QAClC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QAE9E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACvC,yCAAyC;oBACzC,SAAS,CAAC,GAAG,CAAC,GAAG,oBAAoB,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;gBAChE,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,OAAe,EAAE,OAAoB;QAC5D,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,OAAe,EAAE,OAAoB;QAC3D,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,OAAe,EAAE,OAAoB;QAC3D,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,OAAe,EAAE,OAAoB;QAC5D,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAEnC,iCAAiC;AACjC,MAAM,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAe,IAAI,MAAM,CAAC;AAC9E,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@fluxa-pay/fluxa-connect-mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "MCP server with FluxA Wallet Service integration for X402 payments",
   "bin": {
-    "fluxa-connect-mcp": "dist/stdio-server.js"
+    "fluxa-connect-mcp": "dist/server/stdio-server.js"
   },
   "files": [
     "dist",
@@ -31,8 +31,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.18.2",
-    "x402-fetch": "^0.7.0",
-    "dotenv": "^16.0.0"
+    "axios": "^1.6.0",
+    "dotenv": "^16.0.0",
+    "x402-fetch": "^0.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",