promptspeak-mcp-server 0.1.0

package/dist/swarm/ebay/rate-limiter.js

@@ -0,0 +1,264 @@
+/**
+ * eBay API Rate Limiter
+ *
+ * Token bucket rate limiter with exponential backoff for eBay API compliance.
+ * Tracks usage across multiple time windows (per minute, per day).
+ */
+import { getRateLimits } from './sandbox-config.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// RATE LIMITER CLASS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Token bucket rate limiter for eBay API.
+ */
+export class EbayRateLimiter {
+    state = new Map();
+    limits;
+    // Backoff configuration
+    baseBackoffMs = 1000;
+    maxBackoffMs = 60000;
+    backoffMultiplier = 2;
+    constructor() {
+        this.limits = getRateLimits();
+        this.initializeState();
+    }
+    /**
+     * Initialize rate limiter state for all categories.
+     */
+    initializeState() {
+        const categories = ['browse', 'offer', 'order'];
+        const now = Date.now();
+        for (const category of categories) {
+            const config = this.limits[category];
+            this.state.set(category, {
+                minuteWindowStart: now,
+                minuteTokens: config.perMinute,
+                dayWindowStart: now,
+                dayTokens: config.perDay,
+                backoffUntil: 0,
+                consecutiveFailures: 0,
+            });
+        }
+    }
+    /**
+     * Check if a request can proceed.
+     * Returns true if request is allowed, false if rate limited.
+     */
+    canProceed(category) {
+        this.refreshWindows(category);
+        const state = this.state.get(category);
+        // Check backoff
+        if (Date.now() < state.backoffUntil) {
+            return false;
+        }
+        // Check tokens
+        return state.minuteTokens > 0 && state.dayTokens > 0;
+    }
+    /**
+     * Acquire a token for making a request.
+     * Returns time to wait in ms if rate limited, 0 if request can proceed.
+     */
+    acquire(category) {
+        this.refreshWindows(category);
+        const state = this.state.get(category);
+        // Check backoff first
+        if (Date.now() < state.backoffUntil) {
+            return state.backoffUntil - Date.now();
+        }
+        // Check per-minute limit
+        if (state.minuteTokens <= 0) {
+            const waitTime = 60000 - (Date.now() - state.minuteWindowStart);
+            return Math.max(0, waitTime);
+        }
+        // Check per-day limit
+        if (state.dayTokens <= 0) {
+            const waitTime = 86400000 - (Date.now() - state.dayWindowStart);
+            return Math.max(0, waitTime);
+        }
+        // Consume tokens
+        state.minuteTokens--;
+        state.dayTokens--;
+        return 0;
+    }
+    /**
+     * Acquire with automatic waiting.
+     * Returns a promise that resolves when the request can proceed.
+     */
+    async acquireWithWait(category, maxWaitMs = 30000) {
+        const waitTime = this.acquire(category);
+        if (waitTime === 0) {
+            return;
+        }
+        if (waitTime > maxWaitMs) {
+            throw new EbayRateLimitError(`Rate limit would require waiting ${waitTime}ms, exceeds max wait of ${maxWaitMs}ms`, category, waitTime);
+        }
+        await this.sleep(waitTime);
+        // Try again after waiting
+        return this.acquireWithWait(category, maxWaitMs - waitTime);
+    }
+    /**
+     * Record a successful request.
+     * Resets backoff state.
+     */
+    recordSuccess(category) {
+        const state = this.state.get(category);
+        state.consecutiveFailures = 0;
+        state.backoffUntil = 0;
+    }
+    /**
+     * Record a failed request.
+     * Applies exponential backoff.
+     */
+    recordFailure(category, statusCode) {
+        const state = this.state.get(category);
+        // Only apply backoff for rate limit errors (429) or server errors (5xx)
+        if (statusCode && statusCode !== 429 && statusCode < 500) {
+            return;
+        }
+        state.consecutiveFailures++;
+        // Calculate backoff time with exponential increase
+        const backoffMs = Math.min(this.baseBackoffMs * Math.pow(this.backoffMultiplier, state.consecutiveFailures - 1), this.maxBackoffMs);
+        // Add jitter (±10%)
+        const jitter = backoffMs * 0.1 * (Math.random() * 2 - 1);
+        state.backoffUntil = Date.now() + backoffMs + jitter;
+    }
+    /**
+     * Refresh token windows if they've expired.
+     */
+    refreshWindows(category) {
+        const state = this.state.get(category);
+        const config = this.limits[category];
+        const now = Date.now();
+        // Refresh per-minute window
+        if (now - state.minuteWindowStart >= 60000) {
+            state.minuteWindowStart = now;
+            state.minuteTokens = config.perMinute;
+        }
+        // Refresh per-day window
+        if (now - state.dayWindowStart >= 86400000) {
+            state.dayWindowStart = now;
+            state.dayTokens = config.perDay;
+        }
+    }
+    /**
+     * Get current rate limiter status.
+     */
+    getStatus(category) {
+        this.refreshWindows(category);
+        const state = this.state.get(category);
+        const config = this.limits[category];
+        const now = Date.now();
+        return {
+            minuteTokens: state.minuteTokens,
+            minuteLimit: config.perMinute,
+            dayTokens: state.dayTokens,
+            dayLimit: config.perDay,
+            inBackoff: now < state.backoffUntil,
+            backoffRemainingMs: Math.max(0, state.backoffUntil - now),
+        };
+    }
+    /**
+     * Get status for all categories.
+     */
+    getAllStatus() {
+        return {
+            browse: this.getStatus('browse'),
+            offer: this.getStatus('offer'),
+            order: this.getStatus('order'),
+        };
+    }
+    /**
+     * Reset rate limiter (for testing).
+     */
+    reset() {
+        this.initializeState();
+    }
+    /**
+     * Sleep utility.
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// ERROR CLASS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * eBay-specific rate limit error.
+ * Contains category and wait time information specific to eBay API rate limiting.
+ *
+ * Note: For general rate limit errors, use RateLimitError from core/errors.
+ * This class is specifically for eBay API rate limiting with category tracking.
+ */
+export class EbayRateLimitError extends Error {
+    category;
+    waitTimeMs;
+    constructor(message, category, waitTimeMs) {
+        super(message);
+        this.category = category;
+        this.waitTimeMs = waitTimeMs;
+        this.name = 'EbayRateLimitError';
+    }
+}
+/**
+ * @deprecated Use EbayRateLimitError instead. This alias exists for backwards compatibility.
+ */
+export const RateLimitError = EbayRateLimitError;
+// ═══════════════════════════════════════════════════════════════════════════════
+// SINGLETON INSTANCE
+// ═══════════════════════════════════════════════════════════════════════════════
+let rateLimiterInstance = null;
+/**
+ * Get the rate limiter singleton.
+ */
+export function getEbayRateLimiter() {
+    if (!rateLimiterInstance) {
+        rateLimiterInstance = new EbayRateLimiter();
+    }
+    return rateLimiterInstance;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// DECORATOR FOR RATE LIMITED FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Decorator to rate limit a function.
+ * Usage: @rateLimited('browse')
+ */
+export function rateLimited(category) {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const limiter = getEbayRateLimiter();
+            await limiter.acquireWithWait(category);
+            try {
+                const result = await originalMethod.apply(this, args);
+                limiter.recordSuccess(category);
+                return result;
+            }
+            catch (error) {
+                limiter.recordFailure(category, error?.status || error?.statusCode);
+                throw error;
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Wrap a function with rate limiting.
+ */
+export function withRateLimit(fn, category) {
+    return (async (...args) => {
+        const limiter = getEbayRateLimiter();
+        await limiter.acquireWithWait(category);
+        try {
+            const result = await fn(...args);
+            limiter.recordSuccess(category);
+            return result;
+        }
+        catch (error) {
+            limiter.recordFailure(category, error?.status || error?.statusCode);
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/swarm/ebay/rate-limiter.js.map

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

package/dist/swarm/ebay/sandbox-config.d.ts

@@ -0,0 +1,280 @@
+/**
+ * eBay Sandbox Configuration
+ *
+ * Environment-specific configuration for eBay API endpoints.
+ * Defaults to sandbox mode for safe testing.
+ */
+/**
+ * Determine if we're in sandbox mode.
+ * Defaults to true (sandbox) for safety.
+ */
+export declare function isSandboxMode(): boolean;
+/**
+ * eBay API base URLs.
+ */
+export declare const EBAY_API_URLS: {
+    readonly sandbox: {
+        readonly api: "https://api.sandbox.ebay.com";
+        readonly auth: "https://auth.sandbox.ebay.com";
+        readonly signin: "https://signin.sandbox.ebay.com";
+    };
+    readonly production: {
+        readonly api: "https://api.ebay.com";
+        readonly auth: "https://auth.ebay.com";
+        readonly signin: "https://signin.ebay.com";
+    };
+};
+/**
+ * Get the appropriate API base URL.
+ */
+export declare function getApiBaseUrl(): string;
+/**
+ * Get the appropriate auth base URL.
+ */
+export declare function getAuthBaseUrl(): string;
+/**
+ * Browse API endpoints.
+ */
+export declare const BROWSE_API: {
+    /** Search for items */
+    readonly search: "/buy/browse/v1/item_summary/search";
+    /** Get item details */
+    readonly getItem: (itemId: string) => string;
+    /** Get items by group */
+    readonly getItemsByGroup: (itemGroupId: string) => string;
+    /** Check compatibility */
+    readonly checkCompatibility: (itemId: string) => string;
+};
+/**
+ * Buy Offer API endpoints (for auctions).
+ */
+export declare const OFFER_API: {
+    /** Place a bid on an auction item */
+    readonly placeBid: (itemId: string) => string;
+    /** Get bidding status for an item */
+    readonly getBidding: (itemId: string) => string;
+};
+/**
+ * Best Offer API endpoints.
+ */
+export declare const BEST_OFFER_API: {
+    /** Submit a best offer */
+    readonly createOffer: "/buy/offer/v1_beta/offer";
+    /** Get offer details */
+    readonly getOffer: (offerId: string) => string;
+    /** Accept/decline counter offer */
+    readonly respondToOffer: (offerId: string) => string;
+};
+/**
+ * Buy Order API endpoints.
+ */
+export declare const ORDER_API: {
+    /** Initiate checkout session */
+    readonly initiateCheckout: "/buy/order/v2/checkout_session/initiate";
+    /** Get checkout session */
+    readonly getCheckoutSession: (sessionId: string) => string;
+    /** Update checkout session */
+    readonly updateCheckoutSession: (sessionId: string) => string;
+    /** Place order */
+    readonly placeOrder: (sessionId: string) => string;
+    /** Get purchase order */
+    readonly getPurchaseOrder: (orderId: string) => string;
+};
+/**
+ * OAuth endpoints.
+ * NOTE: Authorization and token endpoints use DIFFERENT base URLs:
+ * - Authorization (user consent): auth.sandbox.ebay.com / auth.ebay.com
+ * - Token exchange: api.sandbox.ebay.com / api.ebay.com
+ */
+export declare const OAUTH_ENDPOINTS: {
+    /** Authorization URL (user consent) - uses AUTH base URL */
+    readonly authorize: "/oauth2/authorize";
+    /** Token exchange - uses API base URL */
+    readonly token: "/identity/v1/oauth2/token";
+};
+/**
+ * Get the token endpoint URL.
+ * Token requests go to the API server, not the auth server.
+ */
+export declare function getTokenUrl(): string;
+/**
+ * eBay API rate limits (sandbox has lower limits).
+ */
+export declare const RATE_LIMITS: {
+    readonly sandbox: {
+        readonly browse: {
+            readonly perDay: 5000;
+            readonly perMinute: 100;
+        };
+        readonly offer: {
+            readonly perDay: 1000;
+            readonly perMinute: 20;
+        };
+        readonly order: {
+            readonly perDay: 1000;
+            readonly perMinute: 20;
+        };
+    };
+    readonly production: {
+        readonly browse: {
+            readonly perDay: 25000;
+            readonly perMinute: 500;
+        };
+        readonly offer: {
+            readonly perDay: 5000;
+            readonly perMinute: 100;
+        };
+        readonly order: {
+            readonly perDay: 5000;
+            readonly perMinute: 100;
+        };
+    };
+};
+/**
+ * Get rate limits for current environment.
+ */
+export declare function getRateLimits(): {
+    readonly browse: {
+        readonly perDay: 5000;
+        readonly perMinute: 100;
+    };
+    readonly offer: {
+        readonly perDay: 1000;
+        readonly perMinute: 20;
+    };
+    readonly order: {
+        readonly perDay: 1000;
+        readonly perMinute: 20;
+    };
+} | {
+    readonly browse: {
+        readonly perDay: 25000;
+        readonly perMinute: 500;
+    };
+    readonly offer: {
+        readonly perDay: 5000;
+        readonly perMinute: 100;
+    };
+    readonly order: {
+        readonly perDay: 5000;
+        readonly perMinute: 100;
+    };
+};
+/**
+ * eBay marketplace IDs.
+ */
+export declare const MARKETPLACE_IDS: {
+    readonly EBAY_US: "EBAY_US";
+    readonly EBAY_GB: "EBAY_GB";
+    readonly EBAY_DE: "EBAY_DE";
+    readonly EBAY_AU: "EBAY_AU";
+    readonly EBAY_CA: "EBAY_CA";
+    readonly EBAY_FR: "EBAY_FR";
+    readonly EBAY_IT: "EBAY_IT";
+    readonly EBAY_ES: "EBAY_ES";
+};
+export type MarketplaceId = keyof typeof MARKETPLACE_IDS;
+/**
+ * Get the configured marketplace ID.
+ */
+export declare function getMarketplaceId(): string;
+/**
+ * Get standard headers for eBay API requests.
+ */
+export declare function getStandardHeaders(accessToken: string): Record<string, string>;
+/**
+ * Get headers for authentication requests.
+ */
+export declare function getAuthHeaders(clientId: string, clientSecret: string): Record<string, string>;
+/**
+ * Required environment variables for eBay integration.
+ */
+export declare const REQUIRED_ENV_VARS: readonly ["EBAY_CLIENT_ID", "EBAY_CLIENT_SECRET"];
+/**
+ * Required environment variables for PRODUCTION mode.
+ */
+export declare const PRODUCTION_REQUIRED_ENV_VARS: readonly ["EBAY_CLIENT_ID", "EBAY_CLIENT_SECRET", "EBAY_PRODUCTION_CLIENT_ID", "EBAY_PRODUCTION_CLIENT_SECRET"];
+/**
+ * Optional environment variables.
+ */
+export declare const OPTIONAL_ENV_VARS: readonly ["EBAY_REDIRECT_URI", "EBAY_MARKETPLACE", "EBAY_SANDBOX", "EBAY_TOKEN_ENCRYPTION_KEY", "EBAY_RATE_LIMIT_PER_MINUTE", "EBAY_RATE_LIMIT_PER_DAY", "EBAY_MODE", "EBAY_PRODUCTION_CONFIRMED"];
+/**
+ * eBay operation mode.
+ */
+export type EbayMode = 'sandbox' | 'production';
+/**
+ * Get the configured eBay mode.
+ */
+export declare function getEbayMode(): EbayMode;
+/**
+ * Validate that required environment variables are set.
+ */
+export declare function validateEbayConfig(): {
+    valid: boolean;
+    missing: string[];
+    mode: EbayMode;
+};
+/**
+ * Check if production mode is properly confirmed.
+ */
+export declare function isProductionConfirmed(): boolean;
+/**
+ * Get credentials for the current mode.
+ * Production can use separate credentials or fall back to sandbox credentials.
+ */
+export declare function getCredentials(): {
+    clientId: string;
+    clientSecret: string;
+};
+/**
+ * Get the full eBay configuration.
+ */
+export declare function getEbayConfig(): {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    marketplace: string;
+    sandbox: boolean;
+    mode: EbayMode;
+    productionConfirmed: boolean;
+    apiBaseUrl: string;
+    authBaseUrl: string;
+    rateLimits: {
+        readonly browse: {
+            readonly perDay: 5000;
+            readonly perMinute: 100;
+        };
+        readonly offer: {
+            readonly perDay: 1000;
+            readonly perMinute: 20;
+        };
+        readonly order: {
+            readonly perDay: 1000;
+            readonly perMinute: 20;
+        };
+    } | {
+        readonly browse: {
+            readonly perDay: 25000;
+            readonly perMinute: 500;
+        };
+        readonly offer: {
+            readonly perDay: 5000;
+            readonly perMinute: 100;
+        };
+        readonly order: {
+            readonly perDay: 5000;
+            readonly perMinute: 100;
+        };
+    };
+};
+/**
+ * Log a warning if production mode is enabled.
+ */
+export declare function warnIfProduction(): void;
+/**
+ * Require explicit confirmation for production mode.
+ * Call this before making any real purchases.
+ */
+export declare function requireProductionConfirmation(): void;
+export { REQUIRED_EBAY_SCOPES, type EbayOAuthScope } from './types.js';
+//# sourceMappingURL=sandbox-config.d.ts.map

package/dist/swarm/ebay/sandbox-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-config.d.ts","sourceRoot":"","sources":["../../../src/swarm/ebay/sandbox-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AAMD;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;CAWhB,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAMD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,uBAAuB;;IAEvB,uBAAuB;+BACL,MAAM;IACxB,yBAAyB;4CACM,MAAM;IACrC,0BAA0B;0CACG,MAAM;CAC3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,qCAAqC;gCAClB,MAAM;IACzB,qCAAqC;kCAChB,MAAM;CACnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,0BAA0B;;IAE1B,wBAAwB;iCACJ,MAAM;IAC1B,mCAAmC;uCACT,MAAM;CACxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,gCAAgC;;IAEhC,2BAA2B;6CACK,MAAM;IACtC,8BAA8B;gDACK,MAAM;IACzC,kBAAkB;qCACM,MAAM;IAC9B,yBAAyB;yCACG,MAAM;CAC1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,eAAe;IAC1B,4DAA4D;;IAE5D,yCAAyC;;CAEjC,CAAC;AAEX;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAMD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bd,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5B;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,eAAe,CAAC;AAEzD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7F;AAMD;;GAEG;AACH,eAAO,MAAM,iBAAiB,mDAGpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4BAA4B,iHAI/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,oMASpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAItC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CA2B1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAc3E;AAED;;GAEG;AACH,wBAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB5B;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAUpD;AAOD,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}