turn-based-mcp-shared 1.0.0

package/dist/testing/api-test-utils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared API Test Utilities
+ *
+ * Provides reusable mock factories and test utilities for API route testing
+ * to eliminate duplication across test files.
+ */
+import { vi } from 'vitest';
+import type { GameSession, Player, BaseGameState, GameType } from '../types/game.js';
+import type { TicTacToeGameState, RPSGameState, TicTacToeMove, RPSMove } from '../types/games.js';
+/**
+ * Generic game mock factory
+ * Creates a mock game instance with all required methods
+ */
+export declare function createGameMock(): {
+    getInitialState: ReturnType<typeof vi.fn>;
+    validateMove: ReturnType<typeof vi.fn>;
+    applyMove: ReturnType<typeof vi.fn>;
+    checkGameEnd: ReturnType<typeof vi.fn>;
+    getValidMoves: ReturnType<typeof vi.fn>;
+};
+/**
+ * Create mock players for testing
+ */
+export declare function createMockPlayers(): Player[];
+/**
+ * Create a mock TicTacToe game state
+ */
+export declare function createMockTicTacToeGameState(overrides?: Partial<TicTacToeGameState>): TicTacToeGameState;
+/**
+ * Create a mock Rock Paper Scissors game state
+ */
+export declare function createMockRPSGameState(overrides?: Partial<RPSGameState>): RPSGameState;
+/**
+ * Create a mock game session
+ */
+export declare function createMockGameSession<T extends BaseGameState>(gameState: T, gameType: GameType): GameSession<T>;
+/**
+ * Vitest mock configuration for shared package games
+ * Use this to create consistent mocks across API route tests
+ */
+export declare function createSharedGameMocks(gameClass: string): {
+    mockImplementation: () => Promise<Record<string, unknown>>;
+    mockGame: ReturnType<typeof createGameMock>;
+};
+/**
+ * Create storage function mocks for a specific game type
+ */
+export declare function createStorageMocks(gameType: GameType): Record<string, ReturnType<typeof vi.fn>>;
+/**
+ * Standard test moves for different games
+ */
+export declare const TEST_MOVES: {
+    ticTacToe: TicTacToeMove;
+    rockPaperScissors: RPSMove;
+};
+//# sourceMappingURL=api-test-utils.d.ts.map

package/dist/testing/api-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-test-utils.d.ts","sourceRoot":"","sources":["../../src/testing/api-test-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE9F;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAChC,eAAe,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1C,YAAY,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACvC,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACpC,YAAY,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACvC,aAAa,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;CACzC,CAQA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAK5C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,kBAAkB,CAmB5G;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAiB1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAO/G;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG;IACxD,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;CAC7C,CAUA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAc/F;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;eACY,aAAa;uBACL,OAAO;CACjD,CAAA"}

package/dist/testing/api-test-utils.js

@@ -0,0 +1,125 @@
+/**
+ * Shared API Test Utilities
+ *
+ * Provides reusable mock factories and test utilities for API route testing
+ * to eliminate duplication across test files.
+ */
+import { vi } from 'vitest';
+/**
+ * Generic game mock factory
+ * Creates a mock game instance with all required methods
+ */
+export function createGameMock() {
+    return {
+        getInitialState: vi.fn(),
+        validateMove: vi.fn(),
+        applyMove: vi.fn(),
+        checkGameEnd: vi.fn(),
+        getValidMoves: vi.fn()
+    };
+}
+/**
+ * Create mock players for testing
+ */
+export function createMockPlayers() {
+    return [
+        { id: 'player1', name: 'Player', isAI: false },
+        { id: 'ai', name: 'AI', isAI: true }
+    ];
+}
+/**
+ * Create a mock TicTacToe game state
+ */
+export function createMockTicTacToeGameState(overrides = {}) {
+    return {
+        id: 'test-game-1',
+        players: createMockPlayers(),
+        currentPlayerId: 'player1',
+        status: 'playing',
+        createdAt: new Date('2024-01-01T10:00:00Z'),
+        updatedAt: new Date('2024-01-01T10:00:00Z'),
+        board: [
+            [null, null, null],
+            [null, null, null],
+            [null, null, null]
+        ],
+        playerSymbols: {
+            player1: 'X',
+            ai: 'O'
+        },
+        ...overrides
+    };
+}
+/**
+ * Create a mock Rock Paper Scissors game state
+ */
+export function createMockRPSGameState(overrides = {}) {
+    return {
+        id: 'test-rps-1',
+        players: createMockPlayers(),
+        currentPlayerId: 'player1',
+        status: 'playing',
+        createdAt: new Date('2024-01-01T10:00:00Z'),
+        updatedAt: new Date('2024-01-01T10:00:00Z'),
+        rounds: [],
+        currentRound: 0,
+        maxRounds: 3,
+        scores: {
+            player1: 0,
+            ai: 0
+        },
+        ...overrides
+    };
+}
+/**
+ * Create a mock game session
+ */
+export function createMockGameSession(gameState, gameType) {
+    return {
+        gameState,
+        gameType,
+        history: [],
+        difficulty: 'medium'
+    };
+}
+/**
+ * Vitest mock configuration for shared package games
+ * Use this to create consistent mocks across API route tests
+ */
+export function createSharedGameMocks(gameClass) {
+    const mockGame = createGameMock();
+    return {
+        mockImplementation: async () => ({
+            ...await vi.importActual('@turn-based-mcp/shared/constants'),
+            [gameClass]: vi.fn().mockImplementation(() => mockGame)
+        }),
+        mockGame
+    };
+}
+/**
+ * Create storage function mocks for a specific game type
+ */
+export function createStorageMocks(gameType) {
+    if (gameType === 'tic-tac-toe') {
+        return {
+            getTicTacToeGame: vi.fn(),
+            setTicTacToeGame: vi.fn(),
+            getAllTicTacToeGames: vi.fn()
+        };
+    }
+    else {
+        return {
+            getRPSGame: vi.fn(),
+            setRPSGame: vi.fn(),
+            getAllRPSGames: vi.fn()
+        };
+    }
+}
+/**
+ * Standard test moves for different games
+ */
+export const TEST_MOVES = {
+    ticTacToe: { row: 0, col: 0 },
+    rockPaperScissors: { choice: 'rock' }
+};
+//# sourceMappingURL=api-test-utils.js.map

package/dist/testing/api-test-utils.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Testing utilities for the turn-based games platform
+ *
+ * This module exports centralized testing utilities that can be used
+ * across all packages in the monorepo for consistent test setup.
+ */
+export { setupTestDatabase, teardownTestDatabase, clearTestDatabase, getTestDatabase, isTestDatabaseReady } from './test-database.js';
+export { createGameMock, createMockPlayers, createMockTicTacToeGameState, createMockRPSGameState, createMockGameSession, createSharedGameMocks, createStorageMocks, TEST_MOVES } from './api-test-utils.js';
+export { setupStandardTestDatabase } from './vitest-setup.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACX,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,yBAAyB,EAC1B,MAAM,gBAAgB,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+/**
+ * Testing utilities for the turn-based games platform
+ *
+ * This module exports centralized testing utilities that can be used
+ * across all packages in the monorepo for consistent test setup.
+ */
+export { setupTestDatabase, teardownTestDatabase, clearTestDatabase, getTestDatabase, isTestDatabaseReady } from './test-database.js';
+export { createGameMock, createMockPlayers, createMockTicTacToeGameState, createMockRPSGameState, createMockGameSession, createSharedGameMocks, createStorageMocks, TEST_MOVES } from './api-test-utils.js';
+export { setupStandardTestDatabase } from './vitest-setup.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACX,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,yBAAyB,EAC1B,MAAM,gBAAgB,CAAA"}

package/dist/testing/test-database.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Sets up a test database with clean state
+ * Uses in-memory storage, so setup is a no-op
+ */
+export declare function setupTestDatabase(useMemory?: boolean, testName?: string): Promise<void>;
+/**
+ * Cleans up the test database
+ * Uses in-memory storage, so teardown is a no-op
+ */
+export declare function teardownTestDatabase(): Promise<void>;
+/**
+ * Clears all data from test database tables
+ */
+export declare function clearTestDatabase(): Promise<void>;
+/**
+ * Gets the current test database instance
+ * Returns null for in-memory storage
+ */
+export declare function getTestDatabase(): null;
+/**
+ * Utility function for tests that need to check if database is ready
+ */
+export declare function isTestDatabaseReady(): boolean;
+//# sourceMappingURL=test-database.d.ts.map

package/dist/testing/test-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-database.d.ts","sourceRoot":"","sources":["../../src/testing/test-database.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,GAAE,OAAc,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}

package/dist/testing/test-database.js

@@ -0,0 +1,39 @@
+// Mock test database utilities for in-memory storage
+import { resetDatabaseInstance } from '../storage/sqlite-storage.js';
+/**
+ * Sets up a test database with clean state
+ * Uses in-memory storage, so setup is a no-op
+ */
+export async function setupTestDatabase(useMemory = true, testName) {
+    // In-memory storage doesn't need setup
+    // Just clear any existing data
+    await resetDatabaseInstance();
+}
+/**
+ * Cleans up the test database
+ * Uses in-memory storage, so teardown is a no-op
+ */
+export async function teardownTestDatabase() {
+    // In-memory storage doesn't need teardown
+    await resetDatabaseInstance();
+}
+/**
+ * Clears all data from test database tables
+ */
+export async function clearTestDatabase() {
+    await resetDatabaseInstance();
+}
+/**
+ * Gets the current test database instance
+ * Returns null for in-memory storage
+ */
+export function getTestDatabase() {
+    return null;
+}
+/**
+ * Utility function for tests that need to check if database is ready
+ */
+export function isTestDatabaseReady() {
+    return true;
+}
+//# sourceMappingURL=test-database.js.map

package/dist/testing/test-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-database.js","sourceRoot":"","sources":["../../src/testing/test-database.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAAqB,IAAI,EACzB,QAAiB;IAEjB,uCAAuC;IACvC,+BAA+B;IAC/B,MAAM,qBAAqB,EAAE,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,0CAA0C;IAC1C,MAAM,qBAAqB,EAAE,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,qBAAqB,EAAE,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/testing/vitest-setup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared Vitest Setup Functions
+ *
+ * Provides standardized test setup and teardown functions to reduce
+ * duplication across package vitest setup files.
+ */
+/**
+ * Standard database setup for all packages
+ * Call this in vitest.setup.ts files to ensure consistent database setup
+ */
+export declare function setupStandardTestDatabase(): void;
+//# sourceMappingURL=vitest-setup.d.ts.map

package/dist/testing/vitest-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.d.ts","sourceRoot":"","sources":["../../src/testing/vitest-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAoBhD"}

package/dist/testing/vitest-setup.js

@@ -0,0 +1,35 @@
+/**
+ * Shared Vitest Setup Functions
+ *
+ * Provides standardized test setup and teardown functions to reduce
+ * duplication across package vitest setup files.
+ */
+import { beforeAll, afterAll } from 'vitest';
+import { setupTestDatabase, teardownTestDatabase } from './test-database.js';
+/**
+ * Standard database setup for all packages
+ * Call this in vitest.setup.ts files to ensure consistent database setup
+ */
+export function setupStandardTestDatabase() {
+    // Setup test database before all tests
+    beforeAll(async () => {
+        try {
+            await setupTestDatabase(true); // Use in-memory database for speed
+        }
+        catch (error) {
+            console.error('Failed to setup test database:', error);
+            throw error;
+        }
+    });
+    // Cleanup test database after all tests
+    afterAll(async () => {
+        try {
+            await teardownTestDatabase();
+        }
+        catch (error) {
+            console.error('Failed to teardown test database:', error);
+            // Don't throw here to avoid masking other test failures
+        }
+    });
+}
+//# sourceMappingURL=vitest-setup.js.map

package/dist/testing/vitest-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.js","sourceRoot":"","sources":["../../src/testing/vitest-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEzE;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,uCAAuC;IACvC,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA,CAAC,mCAAmC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAA;YACtD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,wCAAwC;IACxC,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,oBAAoB,EAAE,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;YACzD,wDAAwD;QAC1D,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/types/game.d.ts

@@ -0,0 +1,39 @@
+import type { PlayerId, GameStatus, GameType, Difficulty } from '../constants/game-constants.js';
+export type { PlayerId, GameStatus, GameType, Difficulty };
+export interface Player {
+    id: PlayerId;
+    name: string;
+    isAI: boolean;
+}
+export interface BaseGameState {
+    id: string;
+    players: Player[];
+    currentPlayerId: PlayerId;
+    status: GameStatus;
+    winner?: PlayerId | 'draw';
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface GameMove<T = unknown> {
+    playerId: PlayerId;
+    move: T;
+    timestamp: Date;
+}
+export interface GameResult {
+    winner?: PlayerId | 'draw';
+    reason: string;
+}
+export interface Game<TGameState extends BaseGameState, TMove> {
+    validateMove(gameState: TGameState, move: TMove, playerId: PlayerId): boolean;
+    applyMove(gameState: TGameState, move: TMove, playerId: PlayerId): TGameState;
+    checkGameEnd(gameState: TGameState): GameResult | null;
+    getValidMoves(gameState: TGameState, playerId: PlayerId): TMove[];
+    getInitialState(players: Player[], options?: Record<string, unknown>): TGameState;
+}
+export interface GameSession<TGameState extends BaseGameState = BaseGameState> {
+    gameState: TGameState;
+    gameType: GameType;
+    history: GameMove[];
+    difficulty?: Difficulty;
+}
+//# sourceMappingURL=game.d.ts.map

package/dist/types/game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/types/game.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7F,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;AAE1D,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,QAAQ,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,IAAI,CAAC,UAAU,SAAS,aAAa,EAAE,KAAK;IAC3D,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC9E,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9E,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IACvD,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,CAAC;IAClE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;CACnF;AAGD,MAAM,WAAW,WAAW,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa;IAC3E,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB"}

package/dist/types/game.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=game.js.map

package/dist/types/game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../src/types/game.ts"],"names":[],"mappings":""}

package/dist/types/games.d.ts

@@ -0,0 +1,26 @@
+import { BaseGameState } from './game.js';
+export type CellValue = 'X' | 'O' | null;
+export type Board = CellValue[][];
+export interface TicTacToeMove {
+    row: number;
+    col: number;
+}
+export interface TicTacToeGameState extends BaseGameState {
+    board: Board;
+    playerSymbols: Record<string, 'X' | 'O'>;
+}
+export type RPSChoice = 'rock' | 'paper' | 'scissors';
+export interface RPSMove {
+    choice: RPSChoice;
+}
+export interface RPSGameState extends BaseGameState {
+    rounds: Array<{
+        player1Choice?: RPSChoice;
+        player2Choice?: RPSChoice;
+        winner?: string | 'draw';
+    }>;
+    currentRound: number;
+    maxRounds: number;
+    scores: Record<string, number>;
+}
+//# sourceMappingURL=games.d.ts.map

package/dist/types/games.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"games.d.ts","sourceRoot":"","sources":["../../src/types/games.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,KAAK,GAAG,SAAS,EAAE,EAAE,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;CAC1C;AAGD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}

package/dist/types/games.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=games.js.map

package/dist/types/games.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"games.js","sourceRoot":"","sources":["../../src/types/games.ts"],"names":[],"mappings":""}

package/dist/utils/http-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared HTTP client utilities for communicating with the web API
+ *
+ * Provides centralized HTTP functions to eliminate duplication between
+ * the MCP server and shared library API clients.
+ */
+export declare const WEB_API_BASE: string;
+/**
+ * Performs an HTTP GET request
+ *
+ * @param url - The URL to fetch from
+ * @returns Promise resolving to the JSON response
+ * @throws Error if the request fails or returns non-2xx status
+ */
+export declare function httpGet<T = unknown>(url: string): Promise<T>;
+/**
+ * Performs an HTTP POST request with JSON data
+ *
+ * @param url - The URL to post to
+ * @param data - The data to send in the request body
+ * @returns Promise resolving to the JSON response
+ * @throws Error if the request fails or returns non-2xx status
+ */
+export declare function httpPost<T = unknown>(url: string, data: unknown): Promise<T>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/utils/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,YAAY,QAAsD,CAAA;AAE/E;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAMlE;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAUlF"}

package/dist/utils/http-client.js

@@ -0,0 +1,42 @@
+/**
+ * Shared HTTP client utilities for communicating with the web API
+ *
+ * Provides centralized HTTP functions to eliminate duplication between
+ * the MCP server and shared library API clients.
+ */
+// Web app base URL for API calls (configurable via environment)
+export const WEB_API_BASE = process.env.WEB_API_BASE || 'http://localhost:3000';
+/**
+ * Performs an HTTP GET request
+ *
+ * @param url - The URL to fetch from
+ * @returns Promise resolving to the JSON response
+ * @throws Error if the request fails or returns non-2xx status
+ */
+export async function httpGet(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    return response.json();
+}
+/**
+ * Performs an HTTP POST request with JSON data
+ *
+ * @param url - The URL to post to
+ * @param data - The data to send in the request body
+ * @returns Promise resolving to the JSON response
+ * @throws Error if the request fails or returns non-2xx status
+ */
+export async function httpPost(url, data) {
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(data)
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    return response.json();
+}
+//# sourceMappingURL=http-client.js.map

package/dist/utils/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,uBAAuB,CAAA;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAc,GAAW;IACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,GAAW,EAAE,IAAa;IACpE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAA;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;AACxB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,15 @@
+import { GameType } from '../types/game.js';
+/**
+ * Generate a unique game ID
+ */
+export declare function generateGameId(): string;
+/**
+ * Format a date for display
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Get game display name
+ */
+export declare function getGameDisplayName(gameType: GameType): string;
+export * from './http-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAS7D;AAGD,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,34 @@
+/**
+ * Generate a unique game ID
+ */
+export function generateGameId() {
+    return crypto.randomUUID();
+}
+/**
+ * Format a date for display
+ */
+export function formatDate(date) {
+    return new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+    }).format(date);
+}
+/**
+ * Get game display name
+ */
+export function getGameDisplayName(gameType) {
+    switch (gameType) {
+        case 'tic-tac-toe':
+            return 'Tic-Tac-Toe';
+        case 'rock-paper-scissors':
+            return 'Rock Paper Scissors';
+        default:
+            return 'Unknown Game';
+    }
+}
+// Re-export HTTP client utilities
+export * from './http-client.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QACtC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,qBAAqB;YACxB,OAAO,qBAAqB,CAAC;QAC/B;YACE,OAAO,cAAc,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kCAAkC;AAClC,cAAc,eAAe,CAAC"}

package/eslint.config.js

@@ -0,0 +1,41 @@
+// @ts-check
+
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    files: ['**/*.{js,mjs,cjs,ts}'],
+    languageOptions: {
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      // Shared library specific rules
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/explicit-function-return-type': 'warn',
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+  {
+    files: ['**/*.test.ts', '**/*.test.tsx', 'vitest.*.ts'],
+    rules: {
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+  },
+  {
+    ignores: [
+      'node_modules/**',
+      'dist/**',
+      'coverage/**',
+      '*.config.js',
+      '*.config.ts',
+      'games.db',
+    ],
+  }
+);

package/package.json

@@ -0,0 +1 @@
+{"name": "turn-based-mcp-shared", "version": "1.0.0", "description": "Shared types and game logic for turn-based games", "type": "module", "main": "dist/index.js", "types": "dist/index.d.ts", "exports": {".": {"import": "./dist/index.js", "types": "./dist/index.d.ts"}, "./testing": {"import": "./dist/testing/index.js", "types": "./dist/testing/index.d.ts"}, "./constants": {"import": "./dist/constants/index.js", "types": "./dist/constants/index.d.ts"}}}