promptspeak-mcp-server 0.1.0

package/dist/swarm/ebay/auth.js

@@ -0,0 +1,268 @@
+/**
+ * eBay OAuth 2.0 Authentication
+ *
+ * Handles OAuth 2.0 authentication flow for eBay APIs,
+ * including token management and refresh.
+ */
+import { getEbayConfig, getAuthHeaders, getTokenUrl, OAUTH_ENDPOINTS, REQUIRED_EBAY_SCOPES, } from './sandbox-config.js';
+let currentToken = null;
+// ═══════════════════════════════════════════════════════════════════════════════
+// EBAY AUTH CLASS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * eBay OAuth 2.0 authentication handler.
+ */
+export class EbayAuth {
+    clientId;
+    clientSecret;
+    redirectUri;
+    authBaseUrl;
+    tokenRefreshBuffer = 300000; // 5 minutes in ms
+    constructor() {
+        const config = getEbayConfig();
+        this.clientId = config.clientId;
+        this.clientSecret = config.clientSecret;
+        this.redirectUri = config.redirectUri;
+        this.authBaseUrl = config.authBaseUrl;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // APPLICATION TOKEN (Client Credentials Grant)
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get an application access token using client credentials.
+     * This is for API calls that don't require user authorization.
+     */
+    async getApplicationToken(scopes = ['https://api.ebay.com/oauth/api_scope']) {
+        // Check if we have a valid cached token
+        if (currentToken && this.isTokenValid(currentToken)) {
+            return currentToken.accessToken;
+        }
+        // Request new token (token endpoint is on API server, not auth server)
+        const tokenUrl = getTokenUrl();
+        const body = new URLSearchParams({
+            grant_type: 'client_credentials',
+            scope: scopes.join(' '),
+        });
+        const response = await fetch(tokenUrl, {
+            method: 'POST',
+            headers: getAuthHeaders(this.clientId, this.clientSecret),
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new EbayAuthError(`Failed to get application token: ${response.status} ${response.statusText}`, errorData);
+        }
+        const tokenData = await response.json();
+        // Store token
+        currentToken = {
+            accessToken: tokenData.access_token,
+            expiresAt: Date.now() + (tokenData.expires_in * 1000),
+            scopes: scopes,
+        };
+        return currentToken.accessToken;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // USER TOKEN (Authorization Code Grant)
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get the authorization URL for user consent.
+     * Redirect the user to this URL to authorize the application.
+     */
+    getAuthorizationUrl(scopes = REQUIRED_EBAY_SCOPES, state) {
+        const params = new URLSearchParams({
+            client_id: this.clientId,
+            redirect_uri: this.redirectUri,
+            response_type: 'code',
+            scope: scopes.join(' '),
+        });
+        if (state) {
+            params.set('state', state);
+        }
+        return `${this.authBaseUrl}${OAUTH_ENDPOINTS.authorize}?${params.toString()}`;
+    }
+    /**
+     * Exchange authorization code for user access token.
+     * Call this after the user is redirected back from eBay.
+     */
+    async exchangeAuthorizationCode(code) {
+        const tokenUrl = getTokenUrl();
+        const body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            code,
+            redirect_uri: this.redirectUri,
+        });
+        const response = await fetch(tokenUrl, {
+            method: 'POST',
+            headers: getAuthHeaders(this.clientId, this.clientSecret),
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new EbayAuthError(`Failed to exchange authorization code: ${response.status} ${response.statusText}`, errorData);
+        }
+        const tokenData = await response.json();
+        // Store token
+        currentToken = {
+            accessToken: tokenData.access_token,
+            refreshToken: tokenData.refresh_token,
+            expiresAt: Date.now() + (tokenData.expires_in * 1000),
+            refreshExpiresAt: tokenData.refresh_token_expires_in
+                ? Date.now() + (tokenData.refresh_token_expires_in * 1000)
+                : undefined,
+            scopes: REQUIRED_EBAY_SCOPES,
+        };
+        return currentToken;
+    }
+    /**
+     * Refresh the user access token using the refresh token.
+     */
+    async refreshAccessToken() {
+        if (!currentToken?.refreshToken) {
+            throw new EbayAuthError('No refresh token available. User must re-authorize.');
+        }
+        // Check if refresh token is still valid
+        if (currentToken.refreshExpiresAt && Date.now() >= currentToken.refreshExpiresAt) {
+            throw new EbayAuthError('Refresh token has expired. User must re-authorize.');
+        }
+        const tokenUrl = getTokenUrl();
+        const body = new URLSearchParams({
+            grant_type: 'refresh_token',
+            refresh_token: currentToken.refreshToken,
+            scope: currentToken.scopes.join(' '),
+        });
+        const response = await fetch(tokenUrl, {
+            method: 'POST',
+            headers: getAuthHeaders(this.clientId, this.clientSecret),
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new EbayAuthError(`Failed to refresh token: ${response.status} ${response.statusText}`, errorData);
+        }
+        const tokenData = await response.json();
+        // Update stored token
+        currentToken = {
+            ...currentToken,
+            accessToken: tokenData.access_token,
+            expiresAt: Date.now() + (tokenData.expires_in * 1000),
+            // Refresh token may or may not be returned
+            refreshToken: tokenData.refresh_token || currentToken.refreshToken,
+        };
+        return currentToken.accessToken;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // TOKEN MANAGEMENT
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get a valid access token, refreshing if necessary.
+     */
+    async getAccessToken() {
+        if (!currentToken) {
+            // No token, get application token for Browse API
+            return this.getApplicationToken();
+        }
+        // Check if token needs refresh
+        if (this.tokenNeedsRefresh(currentToken)) {
+            if (currentToken.refreshToken) {
+                return this.refreshAccessToken();
+            }
+            else {
+                // Application token - get a new one
+                return this.getApplicationToken();
+            }
+        }
+        return currentToken.accessToken;
+    }
+    /**
+     * Check if token is still valid (not expired).
+     */
+    isTokenValid(token) {
+        return Date.now() < token.expiresAt;
+    }
+    /**
+     * Check if token should be refreshed (approaching expiry).
+     */
+    tokenNeedsRefresh(token) {
+        return Date.now() >= (token.expiresAt - this.tokenRefreshBuffer);
+    }
+    /**
+     * Check if we have a user token (vs application token).
+     */
+    hasUserToken() {
+        return currentToken !== null && currentToken.refreshToken !== undefined;
+    }
+    /**
+     * Get current token info (for debugging).
+     */
+    getTokenInfo() {
+        if (!currentToken) {
+            return {
+                hasToken: false,
+                isUserToken: false,
+                expiresIn: null,
+                scopes: [],
+            };
+        }
+        return {
+            hasToken: true,
+            isUserToken: !!currentToken.refreshToken,
+            expiresIn: Math.max(0, Math.floor((currentToken.expiresAt - Date.now()) / 1000)),
+            scopes: currentToken.scopes,
+        };
+    }
+    /**
+     * Clear stored tokens (logout).
+     */
+    clearTokens() {
+        currentToken = null;
+    }
+    /**
+     * Set token from external storage (e.g., database).
+     */
+    setStoredToken(token) {
+        currentToken = token;
+    }
+    /**
+     * Get stored token for persistence.
+     */
+    getStoredToken() {
+        return currentToken;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// ERROR CLASS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * eBay authentication error.
+ */
+export class EbayAuthError extends Error {
+    errorData;
+    constructor(message, errorData) {
+        super(message);
+        this.name = 'EbayAuthError';
+        this.errorData = errorData;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// SINGLETON INSTANCE
+// ═══════════════════════════════════════════════════════════════════════════════
+let authInstance = null;
+/**
+ * Get the eBay auth singleton.
+ */
+export function getEbayAuth() {
+    if (!authInstance) {
+        authInstance = new EbayAuth();
+    }
+    return authInstance;
+}
+/**
+ * Initialize eBay auth (validates configuration).
+ */
+export async function initializeEbayAuth() {
+    const auth = getEbayAuth();
+    // Validate by attempting to get an application token
+    await auth.getApplicationToken();
+    return auth;
+}
+//# sourceMappingURL=auth.js.map

package/dist/swarm/ebay/auth.js.map

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

package/dist/swarm/ebay/client.d.ts

@@ -0,0 +1,111 @@
+/**
+ * eBay API Client
+ *
+ * Unified client for interacting with eBay Browse, Buy, and Offer APIs.
+ * Handles authentication, rate limiting, and error handling.
+ */
+import { type RateLimitAllStatus } from './rate-limiter.js';
+import { type EbaySearchResponse, type EbayPlaceBidResponse, type EbayOfferResponse, type EbayInitiateCheckoutRequest, type EbayCheckoutSessionResponse, type EbayPlaceOrderResponse, type EbayError, type SearchQuery, type NormalizedListing } from './types.js';
+/**
+ * eBay API error.
+ */
+export declare class EbayApiError extends Error {
+    readonly statusCode: number;
+    readonly errors: EbayError[];
+    readonly warnings?: EbayError[] | undefined;
+    constructor(message: string, statusCode: number, errors: EbayError[], warnings?: EbayError[] | undefined);
+    /**
+     * Check if error is retryable.
+     */
+    isRetryable(): boolean;
+}
+/**
+ * eBay API client for market agent operations.
+ */
+export declare class EbayClient {
+    private baseUrl;
+    private auth;
+    private rateLimiter;
+    constructor();
+    /**
+     * Search for items using the Browse API.
+     */
+    searchItems(query: SearchQuery): Promise<NormalizedListing[]>;
+    /**
+     * Get detailed item information.
+     */
+    getItem(itemId: string): Promise<NormalizedListing | null>;
+    /**
+     * Search with raw eBay response (for debugging).
+     */
+    searchItemsRaw(query: SearchQuery): Promise<EbaySearchResponse>;
+    /**
+     * Place a bid on an auction item.
+     * Requires user authorization.
+     */
+    placeBid(itemId: string, maxAmount: number, currency?: string): Promise<EbayPlaceBidResponse>;
+    /**
+     * Get current bidding status for an item.
+     */
+    getBiddingStatus(itemId: string): Promise<EbayPlaceBidResponse | null>;
+    /**
+     * Submit a best offer on an item.
+     * Requires user authorization.
+     */
+    submitOffer(itemId: string, offerAmount: number, quantity?: number, message?: string, currency?: string): Promise<EbayOfferResponse>;
+    /**
+     * Get offer status.
+     */
+    getOffer(offerId: string): Promise<EbayOfferResponse | null>;
+    /**
+     * Accept or decline a counter offer.
+     */
+    respondToCounterOffer(offerId: string, accept: boolean, counterAmount?: number, message?: string, currency?: string): Promise<EbayOfferResponse>;
+    /**
+     * Initiate checkout for an item.
+     * This is typically used after winning an auction or accepting an offer.
+     */
+    initiateCheckout(request: EbayInitiateCheckoutRequest): Promise<EbayCheckoutSessionResponse>;
+    /**
+     * Place an order from a checkout session.
+     */
+    placeOrder(checkoutSessionId: string): Promise<EbayPlaceOrderResponse>;
+    /**
+     * Build search query parameters.
+     */
+    private buildSearchParams;
+    /**
+     * Make an authenticated API request.
+     */
+    private makeRequest;
+    /**
+     * Check if client is properly configured.
+     */
+    checkConnection(): Promise<{
+        connected: boolean;
+        sandbox: boolean;
+        hasUserAuth: boolean;
+        rateLimitStatus: RateLimitAllStatus;
+    }>;
+    /**
+     * Get the authorization URL for user consent.
+     */
+    getAuthorizationUrl(state?: string): string;
+    /**
+     * Handle OAuth callback.
+     */
+    handleAuthCallback(code: string): Promise<void>;
+    /**
+     * Check if we have user authorization.
+     */
+    hasUserAuthorization(): boolean;
+}
+/**
+ * Get the eBay client singleton.
+ */
+export declare function getEbayClient(): EbayClient;
+/**
+ * Initialize and validate the eBay client.
+ */
+export declare function initializeEbayClient(): Promise<EbayClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/swarm/ebay/client.d.ts.map

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