@littlepartytime/sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { Player, GameAction, GameResult, Platform } from './types';
+export type { PlayerState, GameState, GameConfig, GameEngine, GameRendererProps } from './interfaces';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/interfaces.d.ts

@@ -0,0 +1,34 @@
+import type { Player, GameAction, GameResult, Platform } from './types';
+export interface PlayerState {
+    id: string;
+    [key: string]: unknown;
+}
+export interface GameState {
+    phase: string;
+    players: PlayerState[];
+    data: Record<string, unknown>;
+}
+export interface GameConfig {
+    id: string;
+    name: string;
+    description: string;
+    coverImage: string;
+    minPlayers: number;
+    maxPlayers: number;
+    tags: string[];
+    version: string;
+    sdkVersion: string;
+    price?: number;
+}
+export interface GameEngine {
+    init(players: Player[], options?: Record<string, unknown>): GameState;
+    handleAction(state: GameState, playerId: string, action: GameAction): GameState;
+    isGameOver(state: GameState): boolean;
+    getResult(state: GameState): GameResult;
+    getPlayerView(state: GameState, playerId: string): Partial<GameState>;
+}
+export interface GameRendererProps {
+    platform: Platform;
+    state: Partial<GameState>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACtE,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAChF,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IACtC,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IACxC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3B"}

package/dist/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

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

package/dist/testing/__tests__/game-simulator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=game-simulator.test.d.ts.map

package/dist/testing/__tests__/game-simulator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-simulator.test.d.ts","sourceRoot":"","sources":["../../../src/testing/__tests__/game-simulator.test.ts"],"names":[],"mappings":""}

package/dist/testing/__tests__/game-simulator.test.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+const counterEngine = {
+    init(players) {
+        return { phase: 'playing', players: players.map(p => ({ id: p.id })), data: { count: 0, currentPlayerIndex: 0 } };
+    },
+    handleAction(state, playerId, action) {
+        const data = state.data;
+        if (action.type !== 'INCREMENT')
+            return state;
+        const currentPlayer = state.players[data.currentPlayerIndex];
+        if (currentPlayer.id !== playerId)
+            return state;
+        const newCount = data.count + 1;
+        if (newCount >= 3) {
+            return { ...state, phase: 'ended', data: { count: newCount, currentPlayerIndex: data.currentPlayerIndex, winnerId: playerId } };
+        }
+        return { ...state, data: { count: newCount, currentPlayerIndex: (data.currentPlayerIndex + 1) % state.players.length } };
+    },
+    isGameOver(state) { return state.phase === 'ended'; },
+    getResult(state) {
+        const data = state.data;
+        return { rankings: state.players.map(p => ({ playerId: p.id, rank: p.id === data.winnerId ? 1 : 2, score: p.id === data.winnerId ? 10 : 0, isWinner: p.id === data.winnerId })) };
+    },
+    getPlayerView(state, _playerId) {
+        if (state.phase !== 'ended') {
+            const { winnerId, ...rest } = state.data;
+            return { ...state, data: rest };
+        }
+        return state;
+    },
+};
+(0, vitest_1.describe)('GameSimulator', () => {
+    (0, vitest_1.it)('should initialize with player count', () => {
+        const sim = new index_1.GameSimulator(counterEngine, { playerCount: 3 });
+        sim.start();
+        (0, vitest_1.expect)(sim.players).toHaveLength(3);
+        (0, vitest_1.expect)(sim.state.phase).toBe('playing');
+    });
+    (0, vitest_1.it)('should act by player index', () => {
+        const sim = new index_1.GameSimulator(counterEngine, { playerCount: 2 });
+        sim.start();
+        sim.act(0, { type: 'INCREMENT' });
+        (0, vitest_1.expect)(sim.state.data.count).toBe(1);
+    });
+    (0, vitest_1.it)('should return filtered view per player', () => {
+        const sim = new index_1.GameSimulator(counterEngine, { playerCount: 2 });
+        sim.start();
+        const view = sim.getView(0);
+        (0, vitest_1.expect)(view.data).not.toHaveProperty('winnerId');
+    });
+    (0, vitest_1.it)('should track action log', () => {
+        const sim = new index_1.GameSimulator(counterEngine, { playerCount: 2 });
+        sim.start();
+        sim.act(0, { type: 'INCREMENT' });
+        sim.act(1, { type: 'INCREMENT' });
+        (0, vitest_1.expect)(sim.actionLog).toHaveLength(2);
+        (0, vitest_1.expect)(sim.actionLog[0].playerIndex).toBe(0);
+        (0, vitest_1.expect)(sim.actionLog[0].action.type).toBe('INCREMENT');
+        (0, vitest_1.expect)(sim.actionLog[1].playerIndex).toBe(1);
+    });
+    (0, vitest_1.it)('should detect game over and get result', () => {
+        const sim = new index_1.GameSimulator(counterEngine, { playerCount: 2 });
+        sim.start();
+        sim.act(0, { type: 'INCREMENT' });
+        sim.act(1, { type: 'INCREMENT' });
+        sim.act(0, { type: 'INCREMENT' });
+        (0, vitest_1.expect)(sim.isGameOver()).toBe(true);
+        (0, vitest_1.expect)(sim.getResult().rankings.find((r) => r.isWinner)?.playerId).toBe(sim.players[0].id);
+    });
+    (0, vitest_1.it)('should expose currentTurn based on currentPlayerIndex', () => {
+        const sim = new index_1.GameSimulator(counterEngine, { playerCount: 2 });
+        sim.start();
+        (0, vitest_1.expect)(sim.currentTurn).toBe(0);
+        sim.act(0, { type: 'INCREMENT' });
+        (0, vitest_1.expect)(sim.currentTurn).toBe(1);
+    });
+});
+//# sourceMappingURL=game-simulator.test.js.map

package/dist/testing/__tests__/game-simulator.test.js.map

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

package/dist/testing/__tests__/game-tester.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=game-tester.test.d.ts.map

package/dist/testing/__tests__/game-tester.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-tester.test.d.ts","sourceRoot":"","sources":["../../../src/testing/__tests__/game-tester.test.ts"],"names":[],"mappings":""}

package/dist/testing/__tests__/game-tester.test.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+// Minimal counter engine for testing GameTester
+const counterEngine = {
+    init(players) {
+        return {
+            phase: 'playing',
+            players: players.map(p => ({ id: p.id })),
+            data: { count: 0, currentPlayerIndex: 0 },
+        };
+    },
+    handleAction(state, playerId, action) {
+        const data = state.data;
+        if (action.type !== 'INCREMENT')
+            return state;
+        const currentPlayer = state.players[data.currentPlayerIndex];
+        if (currentPlayer.id !== playerId)
+            return state;
+        const newCount = data.count + 1;
+        if (newCount >= 3) {
+            return { ...state, phase: 'ended', data: { count: newCount, currentPlayerIndex: data.currentPlayerIndex, winnerId: playerId } };
+        }
+        return { ...state, data: { count: newCount, currentPlayerIndex: (data.currentPlayerIndex + 1) % state.players.length } };
+    },
+    isGameOver(state) { return state.phase === 'ended'; },
+    getResult(state) {
+        const data = state.data;
+        return { rankings: state.players.map(p => ({ playerId: p.id, rank: p.id === data.winnerId ? 1 : 2, score: p.id === data.winnerId ? 10 : 0, isWinner: p.id === data.winnerId })) };
+    },
+    getPlayerView(state, _playerId) {
+        if (state.phase !== 'ended') {
+            const { winnerId, ...rest } = state.data;
+            return { ...state, data: rest };
+        }
+        return state;
+    },
+};
+(0, vitest_1.describe)('GameTester', () => {
+    (0, vitest_1.it)('should initialize with the engine', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        tester.init((0, index_1.createMockPlayers)(2));
+        (0, vitest_1.expect)(tester.state.phase).toBe('playing');
+        (0, vitest_1.expect)(tester.phase).toBe('playing');
+        (0, vitest_1.expect)(tester.playerStates).toHaveLength(2);
+    });
+    (0, vitest_1.it)('should apply actions and update state', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        tester.init((0, index_1.createMockPlayers)(2));
+        tester.act('player-1', { type: 'INCREMENT' });
+        (0, vitest_1.expect)(tester.state.data.count).toBe(1);
+    });
+    (0, vitest_1.it)('should ignore invalid actions (wrong player turn)', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        tester.init((0, index_1.createMockPlayers)(2));
+        const before = tester.state;
+        tester.act('player-2', { type: 'INCREMENT' });
+        (0, vitest_1.expect)(tester.state).toBe(before);
+    });
+    (0, vitest_1.it)('should detect game over', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        tester.init((0, index_1.createMockPlayers)(2));
+        (0, vitest_1.expect)(tester.isGameOver()).toBe(false);
+        tester.act('player-1', { type: 'INCREMENT' });
+        tester.act('player-2', { type: 'INCREMENT' });
+        tester.act('player-1', { type: 'INCREMENT' });
+        (0, vitest_1.expect)(tester.isGameOver()).toBe(true);
+    });
+    (0, vitest_1.it)('should return game result', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        tester.init((0, index_1.createMockPlayers)(2));
+        tester.act('player-1', { type: 'INCREMENT' });
+        tester.act('player-2', { type: 'INCREMENT' });
+        tester.act('player-1', { type: 'INCREMENT' });
+        const result = tester.getResult();
+        (0, vitest_1.expect)(result.rankings.find((r) => r.isWinner)?.playerId).toBe('player-1');
+    });
+    (0, vitest_1.it)('should return filtered player view', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        tester.init((0, index_1.createMockPlayers)(2));
+        tester.act('player-1', { type: 'INCREMENT' });
+        const view = tester.getPlayerView('player-2');
+        (0, vitest_1.expect)(view.data).not.toHaveProperty('winnerId');
+    });
+    (0, vitest_1.it)('should throw if act is called before init', () => {
+        const tester = new index_1.GameTester(counterEngine);
+        (0, vitest_1.expect)(() => tester.act('p1', { type: 'INCREMENT' })).toThrow();
+    });
+});
+//# sourceMappingURL=game-tester.test.js.map

package/dist/testing/__tests__/game-tester.test.js.map

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

package/dist/testing/__tests__/mock-players.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mock-players.test.d.ts.map

package/dist/testing/__tests__/mock-players.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-players.test.d.ts","sourceRoot":"","sources":["../../../src/testing/__tests__/mock-players.test.ts"],"names":[],"mappings":""}

package/dist/testing/__tests__/mock-players.test.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+(0, vitest_1.describe)('createMockPlayers', () => {
+    (0, vitest_1.it)('should create the specified number of players', () => {
+        const players = (0, index_1.createMockPlayers)(3);
+        (0, vitest_1.expect)(players).toHaveLength(3);
+    });
+    (0, vitest_1.it)('should make the first player the host', () => {
+        const players = (0, index_1.createMockPlayers)(2);
+        (0, vitest_1.expect)(players[0].isHost).toBe(true);
+        (0, vitest_1.expect)(players[1].isHost).toBe(false);
+    });
+    (0, vitest_1.it)('should generate unique ids', () => {
+        const players = (0, index_1.createMockPlayers)(4);
+        const ids = players.map(p => p.id);
+        (0, vitest_1.expect)(new Set(ids).size).toBe(4);
+    });
+    (0, vitest_1.it)('should generate default nicknames', () => {
+        const players = (0, index_1.createMockPlayers)(2);
+        (0, vitest_1.expect)(players[0].nickname).toBe('Player 1');
+        (0, vitest_1.expect)(players[1].nickname).toBe('Player 2');
+    });
+    (0, vitest_1.it)('should accept overrides', () => {
+        const players = (0, index_1.createMockPlayers)(2, [
+            { nickname: 'Alice' },
+            { nickname: 'Bob', isHost: true },
+        ]);
+        (0, vitest_1.expect)(players[0].nickname).toBe('Alice');
+        (0, vitest_1.expect)(players[1].nickname).toBe('Bob');
+        (0, vitest_1.expect)(players[1].isHost).toBe(true);
+    });
+    (0, vitest_1.it)('should set avatarUrl to null by default', () => {
+        const players = (0, index_1.createMockPlayers)(1);
+        (0, vitest_1.expect)(players[0].avatarUrl).toBeNull();
+    });
+});
+//# sourceMappingURL=mock-players.test.js.map

package/dist/testing/__tests__/mock-players.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-players.test.js","sourceRoot":"","sources":["../../../src/testing/__tests__/mock-players.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,oCAA6C;AAE7C,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,WAAE,EAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAAC;QACrC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAAC;QACrC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,IAAA,eAAM,EAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAAC;QACrC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,CAAC,EAAE;YACnC,EAAE,QAAQ,EAAE,OAAO,EAAE;YACrB,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;SAClC,CAAC,CAAC;QACH,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAAC;QACrC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/testing/game-simulator.d.ts

@@ -0,0 +1,29 @@
+import type { GameEngine, GameState } from '../interfaces';
+import type { Player, GameAction, GameResult } from '../types';
+export interface ActionLogEntry {
+    playerIndex: number;
+    playerId: string;
+    action: GameAction;
+    stateBefore: GameState;
+    stateAfter: GameState;
+}
+export declare class GameSimulator {
+    private engine;
+    private playerCount;
+    private _players;
+    private _state;
+    private _actionLog;
+    constructor(engine: GameEngine, options: {
+        playerCount: number;
+    });
+    get players(): Player[];
+    get state(): GameState;
+    get actionLog(): ActionLogEntry[];
+    get currentTurn(): number;
+    start(options?: Record<string, unknown>): void;
+    act(playerIndex: number, action: GameAction): void;
+    getView(playerIndex: number): Partial<GameState>;
+    isGameOver(): boolean;
+    getResult(): GameResult;
+}
+//# sourceMappingURL=game-simulator.d.ts.map

package/dist/testing/game-simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-simulator.d.ts","sourceRoot":"","sources":["../../src/testing/game-simulator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG/D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAwB;gBAE9B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAKhE,IAAI,OAAO,IAAI,MAAM,EAAE,CAA0B;IAEjD,IAAI,KAAK,IAAI,SAAS,CAGrB;IAED,IAAI,SAAS,IAAI,cAAc,EAAE,CAA4B;IAE7D,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9C,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAWlD,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOhD,UAAU,IAAI,OAAO;IAErB,SAAS,IAAI,UAAU;CACxB"}

package/dist/testing/game-simulator.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameSimulator = void 0;
+const mock_players_1 = require("./mock-players");
+class GameSimulator {
+    engine;
+    playerCount;
+    _players = [];
+    _state = null;
+    _actionLog = [];
+    constructor(engine, options) {
+        this.engine = engine;
+        this.playerCount = options.playerCount;
+    }
+    get players() { return this._players; }
+    get state() {
+        if (!this._state)
+            throw new Error('GameSimulator: call start() first');
+        return this._state;
+    }
+    get actionLog() { return this._actionLog; }
+    get currentTurn() {
+        const data = this.state.data;
+        return data.currentPlayerIndex ?? 0;
+    }
+    start(options) {
+        this._players = (0, mock_players_1.createMockPlayers)(this.playerCount);
+        this._state = this.engine.init(this._players, options);
+        this._actionLog = [];
+    }
+    act(playerIndex, action) {
+        if (!this._state)
+            throw new Error('GameSimulator: call start() first');
+        if (playerIndex < 0 || playerIndex >= this._players.length) {
+            throw new Error(`GameSimulator: invalid playerIndex ${playerIndex}`);
+        }
+        const playerId = this._players[playerIndex].id;
+        const stateBefore = this._state;
+        this._state = this.engine.handleAction(this._state, playerId, action);
+        this._actionLog.push({ playerIndex, playerId, action, stateBefore, stateAfter: this._state });
+    }
+    getView(playerIndex) {
+        if (playerIndex < 0 || playerIndex >= this._players.length) {
+            throw new Error(`GameSimulator: invalid playerIndex ${playerIndex}`);
+        }
+        return this.engine.getPlayerView(this.state, this._players[playerIndex].id);
+    }
+    isGameOver() { return this.engine.isGameOver(this.state); }
+    getResult() { return this.engine.getResult(this.state); }
+}
+exports.GameSimulator = GameSimulator;
+//# sourceMappingURL=game-simulator.js.map

package/dist/testing/game-simulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-simulator.js","sourceRoot":"","sources":["../../src/testing/game-simulator.ts"],"names":[],"mappings":";;;AAEA,iDAAmD;AAUnD,MAAa,aAAa;IAChB,MAAM,CAAa;IACnB,WAAW,CAAS;IACpB,QAAQ,GAAa,EAAE,CAAC;IACxB,MAAM,GAAqB,IAAI,CAAC;IAChC,UAAU,GAAqB,EAAE,CAAC;IAE1C,YAAY,MAAkB,EAAE,OAAgC;QAC9D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,KAAe,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjD,IAAI,KAAK;QACP,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,SAAS,KAAuB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAE7D,IAAI,WAAW;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAuC,CAAC;QAChE,OAAO,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAiC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAA,gCAAiB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,WAAmB,EAAE,MAAkB;QACzC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvE,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,CAAC,WAAmB;QACzB,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,UAAU,KAAc,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpE,SAAS,KAAiB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CACtE;AArDD,sCAqDC"}

package/dist/testing/game-tester.d.ts

@@ -0,0 +1,16 @@
+import type { GameEngine, GameState } from '../interfaces';
+import type { Player, GameAction, GameResult } from '../types';
+export declare class GameTester {
+    private engine;
+    private _state;
+    constructor(engine: GameEngine);
+    get state(): GameState;
+    get phase(): string;
+    get playerStates(): import("../interfaces").PlayerState[];
+    init(players: Player[], options?: Record<string, unknown>): GameState;
+    act(playerId: string, action: GameAction): GameState;
+    isGameOver(): boolean;
+    getResult(): GameResult;
+    getPlayerView(playerId: string): Partial<GameState>;
+}
+//# sourceMappingURL=game-tester.d.ts.map

package/dist/testing/game-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-tester.d.ts","sourceRoot":"","sources":["../../src/testing/game-tester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/D,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,UAAU;IAI9B,IAAI,KAAK,IAAI,SAAS,CAGrB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,YAAY,0CAEf;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAKrE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS;IAMpD,UAAU,IAAI,OAAO;IAIrB,SAAS,IAAI,UAAU;IAIvB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAGpD"}

package/dist/testing/game-tester.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameTester = void 0;
+class GameTester {
+    engine;
+    _state = null;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    get state() {
+        if (!this._state)
+            throw new Error('GameTester: call init() before accessing state');
+        return this._state;
+    }
+    get phase() {
+        return this.state.phase;
+    }
+    get playerStates() {
+        return this.state.players;
+    }
+    init(players, options) {
+        this._state = this.engine.init(players, options);
+        return this._state;
+    }
+    act(playerId, action) {
+        if (!this._state)
+            throw new Error('GameTester: call init() before act()');
+        this._state = this.engine.handleAction(this._state, playerId, action);
+        return this._state;
+    }
+    isGameOver() {
+        return this.engine.isGameOver(this.state);
+    }
+    getResult() {
+        return this.engine.getResult(this.state);
+    }
+    getPlayerView(playerId) {
+        return this.engine.getPlayerView(this.state, playerId);
+    }
+}
+exports.GameTester = GameTester;
+//# sourceMappingURL=game-tester.js.map

package/dist/testing/game-tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-tester.js","sourceRoot":"","sources":["../../src/testing/game-tester.ts"],"names":[],"mappings":";;;AAGA,MAAa,UAAU;IACb,MAAM,CAAa;IACnB,MAAM,GAAqB,IAAI,CAAC;IAExC,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,OAAiB,EAAE,OAAiC;QACvD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,QAAgB,EAAE,MAAkB;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;CACF;AA3CD,gCA2CC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+export { createMockPlayers } from './mock-players';
+export { GameTester } from './game-tester';
+export { GameSimulator } from './game-simulator';
+export type { ActionLogEntry } from './game-simulator';
+//# 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,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameSimulator = exports.GameTester = exports.createMockPlayers = void 0;
+var mock_players_1 = require("./mock-players");
+Object.defineProperty(exports, "createMockPlayers", { enumerable: true, get: function () { return mock_players_1.createMockPlayers; } });
+var game_tester_1 = require("./game-tester");
+Object.defineProperty(exports, "GameTester", { enumerable: true, get: function () { return game_tester_1.GameTester; } });
+var game_simulator_1 = require("./game-simulator");
+Object.defineProperty(exports, "GameSimulator", { enumerable: true, get: function () { return game_simulator_1.GameSimulator; } });
+//# 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,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA;AAC1B,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/testing/mock-players.d.ts

@@ -0,0 +1,3 @@
+import type { Player } from '../types';
+export declare function createMockPlayers(count: number, overrides?: Partial<Player>[]): Player[];
+//# sourceMappingURL=mock-players.d.ts.map

package/dist/testing/mock-players.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-players.d.ts","sourceRoot":"","sources":["../../src/testing/mock-players.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,GAC5B,MAAM,EAAE,CAQV"}

package/dist/testing/mock-players.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMockPlayers = createMockPlayers;
+function createMockPlayers(count, overrides) {
+    return Array.from({ length: count }, (_, i) => ({
+        id: `player-${i + 1}`,
+        nickname: `Player ${i + 1}`,
+        avatarUrl: null,
+        isHost: i === 0,
+        ...overrides?.[i],
+    }));
+}
+//# sourceMappingURL=mock-players.js.map

package/dist/testing/mock-players.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-players.js","sourceRoot":"","sources":["../../src/testing/mock-players.ts"],"names":[],"mappings":";;AAEA,8CAWC;AAXD,SAAgB,iBAAiB,CAC/B,KAAa,EACb,SAA6B;IAE7B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;QACrB,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;QAC3B,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;KAClB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export interface Player {
+    id: string;
+    nickname: string;
+    avatarUrl: string | null;
+    isHost: boolean;
+}
+export interface GameAction {
+    type: string;
+    payload?: Record<string, unknown>;
+}
+export interface GameResult {
+    rankings: {
+        playerId: string;
+        rank: number;
+        score: number;
+        isWinner: boolean;
+    }[];
+    data?: Record<string, unknown>;
+}
+export interface Platform {
+    getPlayers(): Player[];
+    getLocalPlayer(): Player;
+    send(action: GameAction): void;
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    reportResult(result: GameResult): void;
+}
+//# 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":"AAAA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,IAAI,MAAM,EAAE,CAAC;IACvB,cAAc,IAAI,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@littlepartytime/sdk",
+  "version": "1.0.0",
+  "description": "Game SDK for Little Party Time platform - type definitions and testing utilities",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "require": "./dist/testing/index.js",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": ["dist"],
+  "keywords": ["boardgame", "sdk", "game-engine", "littlepartytime"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chesterli710/littlepartytime-sdk.git",
+    "directory": "packages/sdk"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "vitest": "^3"
+  }
+}