@atxp/common 0.2.5

package/dist/redisOAuthDb.js

@@ -0,0 +1,160 @@
+import { ConsoleLogger } from './logger.js';
+export class RedisOAuthDb {
+    constructor({ redis, encrypt = (data) => data, decrypt = (data) => data, logger = new ConsoleLogger(), keyPrefix = 'oauth:', ttl }) {
+        if (typeof redis === 'string') {
+            // Dynamic import to avoid bundling issues
+            this.redis = this.createRedisClient(redis);
+        }
+        else {
+            this.redis = redis;
+        }
+        this.encrypt = encrypt;
+        this.decrypt = decrypt;
+        this.logger = logger;
+        this.keyPrefix = keyPrefix;
+        this.ttl = ttl;
+    }
+    async createRedisClient(redisUrl) {
+        // Use dynamic import to avoid bundling issues with optional dependencies
+        try {
+            const { default: Redis } = await import('ioredis');
+            return new Redis(redisUrl);
+        }
+        catch (error) {
+            throw new Error(`Failed to create Redis client from URL "${redisUrl}". Make sure ioredis is installed: npm install ioredis. Error: ${error}`);
+        }
+    }
+    async getRedisClient() {
+        if (this.redis instanceof Promise) {
+            this.redis = await this.redis; // Resolve once and cache
+        }
+        return this.redis;
+    }
+    getKey(type, ...parts) {
+        return `${this.keyPrefix}${type}:${parts.join(':')}`;
+    }
+    async getClientCredentials(resourceUrl) {
+        const redis = await this.getRedisClient();
+        const key = this.getKey('client_credentials', resourceUrl);
+        const data = await redis.get(key);
+        if (!data)
+            return null;
+        try {
+            const parsed = JSON.parse(data);
+            return {
+                clientId: this.decrypt(parsed.encrypted_client_id),
+                clientSecret: this.decrypt(parsed.encrypted_client_secret),
+                redirectUri: parsed.redirect_uri
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to parse client credentials for ${resourceUrl}: ${error}`);
+            return null;
+        }
+    }
+    async saveClientCredentials(resourceUrl, credentials) {
+        const redis = await this.getRedisClient();
+        const key = this.getKey('client_credentials', resourceUrl);
+        const data = JSON.stringify({
+            encrypted_client_id: this.encrypt(credentials.clientId),
+            encrypted_client_secret: this.encrypt(credentials.clientSecret),
+            redirect_uri: credentials.redirectUri
+        });
+        await redis.set(key, data);
+    }
+    async getPKCEValues(userId, state) {
+        const redis = await this.getRedisClient();
+        const key = this.getKey('pkce', userId, state);
+        const data = await redis.get(key);
+        if (!data)
+            return null;
+        try {
+            const parsed = JSON.parse(data);
+            return {
+                codeVerifier: this.decrypt(parsed.encrypted_code_verifier),
+                codeChallenge: this.decrypt(parsed.encrypted_code_challenge),
+                resourceUrl: parsed.resource_url,
+                url: parsed.url
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to parse PKCE values for ${userId}:${state}: ${error}`);
+            return null;
+        }
+    }
+    async savePKCEValues(userId, state, values) {
+        const key = this.getKey('pkce', userId, state);
+        const data = JSON.stringify({
+            encrypted_code_verifier: this.encrypt(values.codeVerifier),
+            encrypted_code_challenge: this.encrypt(values.codeChallenge),
+            resource_url: values.resourceUrl,
+            url: values.url
+        });
+        // PKCE values are short-lived, set a reasonable TTL (10 minutes)
+        const redis = await this.getRedisClient();
+        const pkceTtl = 600; // 10 minutes
+        await redis.setex(key, pkceTtl, data);
+    }
+    async getAccessToken(userId, url) {
+        const redis = await this.getRedisClient();
+        const key = this.getKey('access_token', userId, url);
+        const data = await redis.get(key);
+        if (!data)
+            return null;
+        try {
+            const parsed = JSON.parse(data);
+            // Check if token is expired
+            if (parsed.expires_at) {
+                const expiresAt = parseInt(parsed.expires_at);
+                if (Date.now() >= expiresAt * 1000) {
+                    // Token is expired, remove it
+                    await redis.del(key);
+                    return null;
+                }
+            }
+            return {
+                accessToken: this.decrypt(parsed.encrypted_access_token),
+                refreshToken: parsed.encrypted_refresh_token ? this.decrypt(parsed.encrypted_refresh_token) : undefined,
+                expiresAt: parsed.expires_at ? parseInt(parsed.expires_at) : undefined,
+                resourceUrl: parsed.resource_url
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to parse access token for ${userId}:${url}: ${error}`);
+            return null;
+        }
+    }
+    async saveAccessToken(userId, url, token) {
+        const redis = await this.getRedisClient();
+        const key = this.getKey('access_token', userId, url);
+        const data = JSON.stringify({
+            resource_url: token.resourceUrl,
+            encrypted_access_token: this.encrypt(token.accessToken),
+            encrypted_refresh_token: token.refreshToken ? this.encrypt(token.refreshToken) : null,
+            expires_at: token.expiresAt?.toString() ?? null
+        });
+        if (this.ttl) {
+            // Use configured TTL
+            await redis.setex(key, this.ttl, data);
+        }
+        else if (token.expiresAt) {
+            // Use token's expiration time
+            const ttlSeconds = Math.max(1, token.expiresAt - Math.floor(Date.now() / 1000));
+            await redis.setex(key, ttlSeconds, data);
+        }
+        else {
+            // No expiration, store indefinitely
+            await redis.set(key, data);
+        }
+    }
+    async close() {
+        try {
+            const redis = await this.getRedisClient();
+            await redis.quit();
+        }
+        catch (error) {
+            this.logger.warn(`Error closing Redis connection: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=redisOAuthDb.js.map

package/dist/redisOAuthDb.js.map

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

package/dist/servers.d.ts

@@ -0,0 +1,14 @@
+export declare const Servers: {
+    readonly browse: "https://browse.mcp.novellum.ai";
+    readonly filestore: "https://filestore.mcp.novellum.ai";
+    readonly database: "https://database.mcp.novellum.ai";
+    readonly code: "https://code.mcp.novellum.ai";
+    readonly search: "https://search.mcp.novellum.ai";
+    readonly crawl: "https://crawl.mcp.novellum.ai";
+    readonly video: "https://video.mcp.novellum.ai";
+    readonly image: "https://image.mcp.novellum.ai";
+    readonly music: "https://music.mcp.novellum.ai";
+    readonly research: "https://research.mcp.novellum.ai";
+    readonly shop: "https://shop.mcp.novellum.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/servers.js

@@ -0,0 +1,14 @@
+export const Servers = {
+    browse: 'https://browse.mcp.novellum.ai',
+    filestore: 'https://filestore.mcp.novellum.ai',
+    database: 'https://database.mcp.novellum.ai',
+    code: 'https://code.mcp.novellum.ai',
+    search: 'https://search.mcp.novellum.ai',
+    crawl: 'https://crawl.mcp.novellum.ai',
+    video: 'https://video.mcp.novellum.ai',
+    image: 'https://image.mcp.novellum.ai',
+    music: 'https://music.mcp.novellum.ai',
+    research: 'https://research.mcp.novellum.ai',
+    shop: 'https://shop.mcp.novellum.ai'
+};
+//# sourceMappingURL=servers.js.map

package/dist/servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.js","sourceRoot":"","sources":["../src/servers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,gCAAgC;IACxC,SAAS,EAAE,mCAAmC;IAC9C,QAAQ,EAAE,kCAAkC;IAC5C,IAAI,EAAE,8BAA8B;IACpC,MAAM,EAAE,gCAAgC;IACxC,KAAK,EAAE,+BAA+B;IACtC,KAAK,EAAE,+BAA+B;IACtC,KAAK,EAAE,+BAA+B;IACtC,KAAK,EAAE,+BAA+B;IACtC,QAAQ,EAAE,kCAAkC;IAC5C,IAAI,EAAE,8BAA8B;CAC5B,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/sseParser.js

@@ -0,0 +1,100 @@
+/**
+ * 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 function parseSSEMessages(sseText) {
+    const messages = [];
+    const lines = sseText.split('\n');
+    let currentMessage = {};
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Empty line indicates end of message
+        if (trimmedLine === '') {
+            if (currentMessage.data !== undefined) {
+                messages.push(currentMessage);
+                currentMessage = {};
+            }
+            continue;
+        }
+        // Parse field: value format
+        const colonIndex = trimmedLine.indexOf(':');
+        if (colonIndex === -1) {
+            continue; // Skip malformed lines
+        }
+        const field = trimmedLine.substring(0, colonIndex);
+        const value = trimmedLine.substring(colonIndex + 1);
+        let retryValue;
+        switch (field) {
+            case 'event':
+                currentMessage.event = value;
+                break;
+            case 'data':
+                // SSE spec allows multiple data fields to be concatenated
+                currentMessage.data = currentMessage.data ? currentMessage.data + '\n' + value : value;
+                break;
+            case 'id':
+                currentMessage.id = value;
+                break;
+            case 'retry':
+                retryValue = parseInt(value, 10);
+                if (!isNaN(retryValue)) {
+                    currentMessage.retry = retryValue;
+                }
+                break;
+        }
+    }
+    // Don't forget the last message if it doesn't end with an empty line
+    if (currentMessage.data !== undefined) {
+        messages.push(currentMessage);
+    }
+    return messages;
+}
+/**
+ * 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 function extractJSONFromSSE(sseMessages, logger) {
+    const jsonMessages = [];
+    for (const sseMessage of sseMessages) {
+        try {
+            if (sseMessage.data) {
+                const parsed = JSON.parse(sseMessage.data);
+                jsonMessages.push(parsed);
+            }
+        }
+        catch (error) {
+            logger?.warn(`Failed to parse SSE data as JSON: ${sseMessage.data}`);
+            logger?.debug(`Parse error: ${error}`);
+        }
+    }
+    return jsonMessages;
+}
+/**
+ * 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 function isSSEResponse(body) {
+    if (typeof body !== 'string') {
+        return false;
+    }
+    const lines = body.split('\n');
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine === '')
+            continue;
+        // Check for SSE field format (field: value)
+        const colonIndex = trimmedLine.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const field = trimmedLine.substring(0, colonIndex);
+        if (['event', 'data', 'id', 'retry'].includes(field)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=sseParser.js.map

package/dist/sseParser.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+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';
+export type PaymentRequestData = {
+    amount: BigNumber;
+    currency: Currency;
+    network: Network;
+    destination: string;
+    source: string;
+    resource: URL;
+    resourceName: string;
+    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/types.js

@@ -0,0 +1,9 @@
+export const DEFAULT_AUTHORIZATION_SERVER = 'https://auth.atxp.ai';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GAAG,sBAAsB,CAAC;AAEnE,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB"}

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/dist/utils.js

@@ -0,0 +1,24 @@
+/**
+ * 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 function assertNever(value, message) {
+    const errorMessage = message || `Unhandled case: ${JSON.stringify(value)}`;
+    throw new Error(errorMessage);
+}
+/**
+ * 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 function isEnumValue(enumObj, value) {
+    return Object.values(enumObj).includes(value);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAgB;IACxD,MAAM,YAAY,GAAG,OAAO,IAAI,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3E,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,OAAU,EACV,KAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@atxp/common",
+  "version": "0.2.5",
+  "description": "ATXP Core - Shared utilities and types for Authorization Token Exchange Protocol",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novellum-ai/paymcp-client.git",
+    "directory": "packages/atxp-common"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "test": "vitest run",
+    "test:integration": "vitest run src/redisOAuthDb.integration.test.ts --reporter=verbose"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.2.0",
+    "bignumber.js": "^9.3.0",
+    "ioredis": "^5.7.0",
+    "jose": "^6.0.11",
+    "oauth4webapi": "^3.5.0",
+    "tweetnacl": "^1.0.3",
+    "tweetnacl-util": "^0.15.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "eslint": "^9.32.0",
+    "jsdom": "^25.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.9"
+  }
+}