pmxtjs 0.1.0 → 0.1.2

package/test/exchanges/polymarket/DataValidation.test.ts

@@ -1,271 +0,0 @@
-import axios from 'axios';
-import { PolymarketExchange } from '../../../src/exchanges/Polymarket';
-
-/**
- * Polymarket Data Validation Test
- * 
- * What: Tests handling of malformed, missing, or edge-case data from the API.
- * Why: Real-world APIs can return unexpected data structures that must be handled gracefully.
- * How: Mocks various edge cases and verifies robust parsing and fallback logic.
- */
-
-jest.mock('axios');
-const mockedAxios = axios as jest.Mocked<typeof axios>;
-
-describe('PolymarketExchange - Data Validation', () => {
-    let exchange: PolymarketExchange;
-
-    beforeEach(() => {
-        exchange = new PolymarketExchange();
-        jest.clearAllMocks();
-    });
-
-    it('should handle stringified JSON in outcomes field', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',  // Stringified
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '100000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].outcomes.length).toBe(2);
-        expect(markets[0].outcomes[0].label).toBe('Yes');
-    });
-
-    it('should handle array outcomes field', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: ['Yes', 'No'],  // Already parsed
-                    outcomePrices: ['0.52', '0.48'],
-                    clobTokenIds: ['token1', 'token2'],
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '100000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].outcomes.length).toBe(2);
-    });
-
-    it('should handle malformed JSON in outcomes gracefully', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '{invalid json}',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '100000'
-                }]
-            }]
-        });
-
-        const consoleSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
-        const markets = await exchange.fetchMarkets();
-
-        expect(consoleSpy).toHaveBeenCalled();
-        expect(markets[0].outcomes.length).toBe(0);
-        consoleSpy.mockRestore();
-    });
-
-    it('should handle missing volume fields with fallback', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z'
-                    // Missing volume24hr and volume
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].volume24h).toBe(0);
-        expect(markets[0].volume).toBe(0);
-    });
-
-    it('should handle alternative volume field names', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume_24h: '50000'  // Alternative field name
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].volume24h).toBe(50000);
-    });
-
-    it('should handle missing liquidity with nested fallback', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '100000',
-                    rewards: { liquidity: 25000 }  // Nested liquidity
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].liquidity).toBe(25000);
-    });
-
-    it('should handle candidate name extraction for Yes/No markets', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Presidential Election',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Will Trump win?',
-                    groupItemTitle: 'Trump',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '100000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].outcomes[0].label).toBe('Trump');
-        expect(markets[0].outcomes[1].label).toBe('Not Trump');
-    });
-
-    it('should handle multi-outcome markets', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Winner Prediction',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Who will win?',
-                    outcomes: '["Trump", "Biden", "RFK Jr", "Other"]',
-                    outcomePrices: '["0.40", "0.35", "0.15", "0.10"]',
-                    clobTokenIds: '["token1", "token2", "token3", "token4"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '100000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].outcomes.length).toBe(4);
-        expect(markets[0].outcomes[0].label).toBe('Trump');
-        expect(markets[0].outcomes[3].label).toBe('Other');
-    });
-
-    it('should handle missing endDate with fallback', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    volume24hr: '100000'
-                    // Missing endDate
-                }]
-            }]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets[0].resolutionDate).toBeInstanceOf(Date);
-    });
-
-    it('should skip events without markets', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [
-                {
-                    id: 'event-1',
-                    slug: 'test',
-                    title: 'Test Event'
-                    // Missing markets field
-                },
-                {
-                    id: 'event-2',
-                    slug: 'test2',
-                    title: 'Test Event 2',
-                    markets: [{
-                        id: 'market-1',
-                        question: 'Test?',
-                        outcomes: '["Yes", "No"]',
-                        outcomePrices: '["0.52", "0.48"]',
-                        clobTokenIds: '["token1", "token2"]',
-                        endDate: '2025-12-31T00:00:00Z',
-                        volume24hr: '100000'
-                    }]
-                }
-            ]
-        });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets.length).toBe(1);
-        expect(markets[0].id).toBe('market-1');
-    });
-});

package/test/exchanges/polymarket/ErrorHandling.test.ts

@@ -1,34 +0,0 @@
-import axios from 'axios';
-import { PolymarketExchange } from '../../../src/exchanges/Polymarket';
-
-/**
- * Polymarket Error Handling Test
- * 
- * What: Tests how the Polymarket exchange handle API errors and network failures.
- * Why: To ensure application stability when external services are unavailable.
- * How: Mocks a rejected axios promise and verifies that the exchange returns an empty 
- *      array instead of throwing, and logs the error.
- */
-
-jest.mock('axios');
-const mockedAxios = axios as jest.Mocked<typeof axios>;
-
-describe('PolymarketExchange - Error Handling', () => {
-    let exchange: PolymarketExchange;
-
-    beforeEach(() => {
-        exchange = new PolymarketExchange();
-        jest.clearAllMocks();
-    });
-
-    it('should handle API errors by returning an empty list', async () => {
-        mockedAxios.get.mockRejectedValue(new Error('Network Error'));
-        const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets).toEqual([]);
-        expect(consoleSpy).toHaveBeenCalled();
-        consoleSpy.mockRestore();
-    });
-});

package/test/exchanges/polymarket/FetchAndNormalizeMarkets.test.ts

@@ -1,68 +0,0 @@
-import axios from 'axios';
-import { PolymarketExchange } from '../../../src/exchanges/Polymarket';
-
-/**
- * Polymarket Markets Normalization Test
- * 
- * What: Tests the normalization of Polymarket's Gamma API response.
- * Why: Polymarket's API often returns outcomes and prices as stringified JSON.
- *      We need to ensure these are correctly parsed regardless of whether 
- *      the API returns them as strings or actual arrays.
- * How: Mocks various response formats from the Gamma API and validates the UnifiedMarket output.
- */
-
-jest.mock('axios');
-const mockedAxios = axios as jest.Mocked<typeof axios>;
-
-describe('PolymarketExchange - Fetch and Normalize Markets', () => {
-    let exchange: PolymarketExchange;
-
-    beforeEach(() => {
-        exchange = new PolymarketExchange();
-        jest.clearAllMocks();
-    });
-
-    const mockGammaResponse = [
-        {
-            id: "eventId1",
-            title: "Presidential Election 2024",
-            markets: [
-                {
-                    id: "marketId1",
-                    question: "Winner",
-                    volume_24h: 1000000,
-                    outcomePrices: "[\"0.60\", \"0.40\"]", // Stringified JSON
-                    outcomes: "[\"Candidate A\", \"Candidate B\"]", // Stringified JSON
-                    rewards: { liquidity: 50000 }
-                },
-                {
-                    id: "marketId2",
-                    question: "Runner Up",
-                    outcomes: ["A", "B"], // Actual array
-                    outcomePrices: ["0.1", "0.9"], // Actual array
-                    volume24hr: "500" // Alternative field name
-                }
-            ]
-        }
-    ];
-
-    it('should correctly parse stringified and non-stringified outcomes/prices', async () => {
-        mockedAxios.get.mockResolvedValue({ data: mockGammaResponse });
-
-        const markets = await exchange.fetchMarkets();
-
-        expect(markets).toHaveLength(2);
-
-        // Check Market 1 (Stringified)
-        const m1 = markets[0];
-        expect(m1.id).toBe("marketId1");
-        expect(m1.outcomes[0].label).toBe("Candidate A");
-        expect(m1.outcomes[0].price).toBe(0.60);
-
-        // Check Market 2 (Array)
-        const m2 = markets[1];
-        expect(m2.id).toBe("marketId2");
-        expect(m2.outcomes[0].label).toBe("A");
-        expect(m2.volume24h).toBe(500);
-    });
-});

package/test/exchanges/polymarket/GetMarketsBySlug.test.ts

@@ -1,268 +0,0 @@
-import axios from 'axios';
-import { PolymarketExchange } from '../../../src/exchanges/Polymarket';
-
-/**
- * Polymarket getMarketsBySlug() Test
- * 
- * What: Tests fetching specific markets by their event slug (from URL).
- * Why: This is a CRITICAL user-facing feature for deep-linking to specific events.
- * How: Mocks Gamma API responses for slug-based queries and verifies data extraction.
- */
-
-jest.mock('axios');
-const mockedAxios = axios as jest.Mocked<typeof axios>;
-
-describe('PolymarketExchange - getMarketsBySlug', () => {
-    let exchange: PolymarketExchange;
-
-    beforeEach(() => {
-        exchange = new PolymarketExchange();
-        jest.clearAllMocks();
-    });
-
-    it('should fetch markets by slug successfully', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'fed-rate-decision',
-                title: 'Federal Reserve Rate Decision',
-                description: 'Will the Fed cut rates?',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Rate cut in March?',
-                    description: 'Federal Reserve rate decision',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-03-31T00:00:00Z',
-                    volume24hr: '100000',
-                    volume: '500000',
-                    liquidity: '50000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('fed-rate-decision');
-
-        expect(markets.length).toBe(1);
-        expect(markets[0].id).toBe('market-1');
-        expect(markets[0].title).toBe('Federal Reserve Rate Decision');
-        expect(markets[0].outcomes.length).toBe(2);
-    });
-
-    it('should handle empty events array', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: []
-        });
-
-        const markets = await exchange.getMarketsBySlug('nonexistent-slug');
-
-        expect(markets).toEqual([]);
-    });
-
-    it('should handle null events', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: null
-        });
-
-        const markets = await exchange.getMarketsBySlug('invalid-slug');
-
-        expect(markets).toEqual([]);
-    });
-
-    it('should skip events without markets', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test-event',
-                title: 'Test Event'
-                // Missing markets field
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('test-event');
-
-        expect(markets).toEqual([]);
-    });
-
-    it('should handle candidate name extraction', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'election-2024',
-                title: 'Presidential Election',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Will Trump win?',
-                    groupItemTitle: 'Trump',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.48", "0.52"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2024-11-05T00:00:00Z',
-                    volume24hr: '1000000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('election-2024');
-
-        expect(markets[0].outcomes[0].label).toBe('Trump');
-        expect(markets[0].outcomes[1].label).toBe('Not Trump');
-    });
-
-    it('should fallback to question for candidate name', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Biden',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.50", "0.50"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '10000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(markets[0].outcomes[0].label).toBe('Biden');
-    });
-
-    it('should handle JSON parsing errors gracefully', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test Event',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '{invalid json}',
-                    outcomePrices: '["0.50", "0.50"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '10000'
-                }]
-            }]
-        });
-
-        const consoleSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(consoleSpy).toHaveBeenCalled();
-        expect(markets[0].outcomes.length).toBe(0);
-        consoleSpy.mockRestore();
-    });
-
-    it('should handle price change data', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.52", "0.48"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '10000',
-                    oneDayPriceChange: 0.05
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(markets[0].outcomes[0].priceChange24h).toBe(0.05);
-    });
-
-    it('should handle missing endDate with fallback', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.50", "0.50"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    volume24hr: '10000'
-                    // Missing endDate
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(markets[0].resolutionDate).toBeInstanceOf(Date);
-    });
-
-    it('should handle API errors gracefully', async () => {
-        mockedAxios.get.mockRejectedValue(new Error('API Error'));
-        const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
-
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(markets).toEqual([]);
-        expect(consoleSpy).toHaveBeenCalled();
-        consoleSpy.mockRestore();
-    });
-
-    it('should include image data', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test',
-                image: 'https://example.com/image.jpg',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.50", "0.50"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume24hr: '10000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(markets[0].image).toBe('https://example.com/image.jpg');
-    });
-
-    it('should handle volume field variations', async () => {
-        mockedAxios.get.mockResolvedValue({
-            data: [{
-                id: 'event-1',
-                slug: 'test',
-                title: 'Test',
-                markets: [{
-                    id: 'market-1',
-                    question: 'Test?',
-                    outcomes: '["Yes", "No"]',
-                    outcomePrices: '["0.50", "0.50"]',
-                    clobTokenIds: '["token1", "token2"]',
-                    endDate: '2025-12-31T00:00:00Z',
-                    volume_24h: '25000',  // Alternative field name
-                    volume: '100000'
-                }]
-            }]
-        });
-
-        const markets = await exchange.getMarketsBySlug('test');
-
-        expect(markets[0].volume24h).toBe(25000);
-        expect(markets[0].volume).toBe(100000);
-    });
-});

package/test/exchanges/polymarket/LiveApi.integration.test.ts

@@ -1,44 +0,0 @@
-import { PolymarketExchange } from '../../../src/exchanges/Polymarket';
-
-/**
- * Polymarket Integration Test (Live API)
- * 
- * What: Verifies real-world connectivity and data structure from Polymarket's Gamma API.
- * Why: Polymarket data is complex and frequently changes; live tests catch schema drift.
- * How: Makes actual HTTP requests to Polymarket and validates the properties 
- *      of the returned UnifiedMarket objects.
- */
-
-describe('PolymarketExchange - Live API Integration', () => {
-    const exchange = new PolymarketExchange();
-    jest.setTimeout(15000);
-
-    it('should fetch real active markets with correct schema', async () => {
-        const markets = await exchange.fetchMarkets({ limit: 5 });
-
-        expect(markets.length).toBeGreaterThan(0);
-
-        const m = markets[0];
-        expect(m.id).toBeDefined();
-        expect(m.title.length).toBeGreaterThan(0);
-        expect(m.outcomes.length).toBeGreaterThanOrEqual(2);
-        expect(m.url).toContain('polymarket.com');
-        expect(m.resolutionDate).toBeInstanceOf(Date);
-    });
-
-    it('should support pagination on live API', async () => {
-        const page1 = await exchange.fetchMarkets({ limit: 1, offset: 0 });
-        const page2 = await exchange.fetchMarkets({ limit: 1, offset: 1 });
-
-        if (page1.length > 0 && page2.length > 0) {
-            expect(page1[0].id).not.toBe(page2[0].id);
-        }
-    });
-
-    it('should return top markets with non-zero volume', async () => {
-        const markets = await exchange.fetchMarkets({ limit: 3, sort: 'volume' });
-        if (markets.length > 0) {
-            expect(markets[0].volume24h).toBeGreaterThan(0);
-        }
-    });
-});