@sharpee/core 0.9.56-beta

package/dist/events/event-source.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Generic event source infrastructure for the narrative engine.
+ * This provides a simple pub/sub mechanism for any type of event.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleEventSource = void 0;
+exports.createEventSource = createEventSource;
+/**
+ * Simple synchronous implementation of EventSource
+ */
+class SimpleEventSource {
+    handlers = [];
+    emit(event) {
+        // Create a copy to avoid issues if handlers modify the array
+        const currentHandlers = [...this.handlers];
+        currentHandlers.forEach(handler => {
+            try {
+                handler(event);
+            }
+            catch (error) {
+                // Prevent one handler's error from affecting others
+                console.error('Error in event handler:', error);
+            }
+        });
+    }
+    subscribe(handler) {
+        this.handlers.push(handler);
+        // Return unsubscribe function
+        return () => {
+            const index = this.handlers.indexOf(handler);
+            if (index > -1) {
+                this.handlers.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Get the current number of subscribers
+     */
+    get subscriberCount() {
+        return this.handlers.length;
+    }
+    /**
+     * Remove all subscribers
+     */
+    clear() {
+        this.handlers = [];
+    }
+}
+exports.SimpleEventSource = SimpleEventSource;
+/**
+ * Create a new event source for a specific event type
+ */
+function createEventSource() {
+    return new SimpleEventSource();
+}
+//# sourceMappingURL=event-source.js.map

package/dist/events/event-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-source.js","sourceRoot":"","sources":["../../src/events/event-source.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmEH,8CAEC;AAnDD;;GAEG;AACH,MAAa,iBAAiB;IACpB,QAAQ,GAA2B,EAAE,CAAC;IAE9C,IAAI,CAAC,KAAQ;QACX,6DAA6D;QAC7D,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAChC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,oDAAoD;gBACpD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAA2B;QACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5B,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;CACF;AAzCD,8CAyCC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,IAAI,iBAAiB,EAAK,CAAC;AACpC,CAAC"}

package/dist/events/event-system.d.ts

@@ -0,0 +1,27 @@
+import { ISemanticEvent } from './types';
+import { EntityId } from '../types/entity';
+import { ISemanticEventSource } from './semantic-event-source';
+/**
+ * Create a new semantic event
+ */
+export declare function createEvent(type: string, data?: Record<string, unknown>, entities?: {
+    actor?: EntityId;
+    target?: EntityId;
+    instrument?: EntityId;
+    location?: EntityId;
+    others?: EntityId[];
+}, metadata?: {
+    tags?: string[];
+    priority?: number;
+    narrate?: boolean;
+    source?: string;
+    sessionId?: string;
+    [key: string]: unknown;
+}): ISemanticEvent;
+export { SemanticEventSourceImpl as EventSourceImpl } from './semantic-event-source';
+/**
+ * Create a new event source
+ * @deprecated Use createSemanticEventSource from './semantic-event-source'
+ */
+export declare function createEventSource(): ISemanticEventSource;
+//# sourceMappingURL=event-system.d.ts.map

package/dist/events/event-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-system.d.ts","sourceRoot":"","sources":["../../src/events/event-system.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAA6B,MAAM,yBAAyB,CAAC;AAE1F;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,CAAC,EAAE;IACT,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB,EACD,QAAQ,CAAC,EAAE;IACT,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACA,cAAc,CA+BhB;AAID,OAAO,EAAE,uBAAuB,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAoBrF;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,CAExD"}

package/dist/events/event-system.js

@@ -0,0 +1,64 @@
+"use strict";
+// packages/core/src/events/event-system.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventSourceImpl = void 0;
+exports.createEvent = createEvent;
+exports.createEventSource = createEventSource;
+const semantic_event_source_1 = require("./semantic-event-source");
+/**
+ * Create a new semantic event
+ */
+function createEvent(type, data, entities, metadata) {
+    // Extract values from metadata
+    const tags = metadata?.tags || [];
+    const priority = metadata?.priority ?? 0;
+    const narrate = metadata?.narrate ?? true;
+    // Clean metadata for storage (remove known properties)
+    const cleanMetadata = metadata ? { ...metadata } : undefined;
+    if (cleanMetadata) {
+        delete cleanMetadata.tags;
+        delete cleanMetadata.priority;
+        delete cleanMetadata.narrate;
+    }
+    const event = {
+        id: generateEventId(),
+        type,
+        timestamp: Date.now(),
+        entities: entities || {},
+        data: data || {},
+        tags,
+        priority,
+        narrate
+    };
+    // Add metadata if provided (excluding extracted properties)
+    if (cleanMetadata && Object.keys(cleanMetadata).length > 0) {
+        event.metadata = cleanMetadata;
+    }
+    return event;
+}
+// Event source implementation moved to semantic-event-source.ts
+// Re-export for backwards compatibility
+var semantic_event_source_2 = require("./semantic-event-source");
+Object.defineProperty(exports, "EventSourceImpl", { enumerable: true, get: function () { return semantic_event_source_2.SemanticEventSourceImpl; } });
+// Counter for ensuring unique IDs even with same timestamp
+let eventCounter = 0;
+/**
+ * Generate a unique ID for an event
+ */
+function generateEventId() {
+    // Use the expected format: evt_timestamp_random
+    // Increment counter and reset if it gets too large
+    eventCounter = (eventCounter + 1) % 10000;
+    // Use both random and counter for better uniqueness
+    const random = Math.floor(Math.random() * 1000);
+    const unique = random + (eventCounter * 1000);
+    return `evt_${Date.now()}_${unique}`;
+}
+/**
+ * Create a new event source
+ * @deprecated Use createSemanticEventSource from './semantic-event-source'
+ */
+function createEventSource() {
+    return (0, semantic_event_source_1.createSemanticEventSource)();
+}
+//# sourceMappingURL=event-system.js.map

package/dist/events/event-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-system.js","sourceRoot":"","sources":["../../src/events/event-system.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAS3C,kCAiDC;AA4BD,8CAEC;AApFD,mEAA0F;AAE1F;;GAEG;AACH,SAAgB,WAAW,CACzB,IAAY,EACZ,IAA8B,EAC9B,QAMC,EACD,QAOC;IAED,+BAA+B;IAC/B,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,IAAI,CAAC;IAE1C,uDAAuD;IACvD,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC,IAAI,CAAC;QAC1B,OAAO,aAAa,CAAC,QAAQ,CAAC;QAC9B,OAAO,aAAa,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAmB;QAC5B,EAAE,EAAE,eAAe,EAAE;QACrB,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,IAAI,EAAE,IAAI,IAAI,EAAE;QAChB,IAAI;QACJ,QAAQ;QACR,OAAO;KACR,CAAC;IAEF,4DAA4D;IAC5D,IAAI,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAa,CAAC,QAAQ,GAAG,aAAa,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAChE,wCAAwC;AACxC,iEAAqF;AAA5E,wHAAA,uBAAuB,OAAmB;AAEnD,2DAA2D;AAC3D,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB;;GAEG;AACH,SAAS,eAAe;IACtB,gDAAgD;IAChD,mDAAmD;IACnD,YAAY,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAE1C,oDAAoD;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAE9C,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,IAAA,iDAAyB,GAAE,CAAC;AACrC,CAAC"}

package/dist/events/game-events.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Game lifecycle events for tracking game state transitions
+ * These events mark important milestones in a game session
+ */
+import { ISemanticEvent } from './types';
+/** Story metadata included in game events */
+export interface GameEventStoryData {
+    id?: string;
+    title?: string;
+    author?: string;
+    version?: string;
+}
+/** Session tracking data */
+export interface GameEventSessionData {
+    startTime?: number;
+    endTime?: number;
+    turns?: number;
+    score?: number;
+    moves?: number;
+}
+/** Ending/conclusion data for game end events */
+export interface GameEventEndingData {
+    type?: 'victory' | 'defeat' | 'quit' | 'abort';
+    reason?: string;
+    achieved?: string[];
+    score?: number;
+    maxScore?: number;
+    ranking?: string;
+}
+/** Error data for failure events */
+export interface GameEventErrorData {
+    code?: string;
+    message?: string;
+    stack?: string;
+}
+/** Game state values */
+export type GameState = 'initializing' | 'ready' | 'running' | 'ending' | 'ended';
+export interface GameLifecycleInitializingData {
+    gameState: 'initializing';
+    [key: string]: unknown;
+}
+export interface GameLifecycleInitializedData {
+    gameState: 'ready';
+    [key: string]: unknown;
+}
+export interface GameLifecycleStoryLoadingData {
+    story?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleStoryLoadedData {
+    story: GameEventStoryData;
+    gameState: 'ready';
+    [key: string]: unknown;
+}
+export interface GameLifecycleStartingData {
+    story?: GameEventStoryData;
+    gameState: 'ready';
+    [key: string]: unknown;
+}
+export interface GameLifecycleStartedData {
+    story?: GameEventStoryData;
+    engineVersion?: string;
+    clientVersion?: string;
+    gameState: 'running';
+    session: {
+        startTime: number;
+        turns: number;
+        moves: number;
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleEndingData {
+    gameState: 'ending';
+    session?: GameEventSessionData;
+    ending?: {
+        reason?: string;
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleEndedData {
+    gameState: 'ended';
+    session?: GameEventSessionData & {
+        endTime: number;
+    };
+    ending: GameEventEndingData & {
+        type: 'victory' | 'defeat' | 'quit' | 'abort';
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleWonData {
+    gameState: 'ended';
+    session?: GameEventSessionData & {
+        endTime: number;
+    };
+    ending: GameEventEndingData & {
+        type: 'victory';
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleLostData {
+    gameState: 'ended';
+    session?: GameEventSessionData & {
+        endTime: number;
+    };
+    ending: {
+        type: 'defeat';
+        reason: string;
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleQuitData {
+    gameState: 'ended';
+    session?: GameEventSessionData & {
+        endTime: number;
+    };
+    ending: {
+        type: 'quit';
+        reason: string;
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleAbortedData {
+    gameState: 'ended';
+    session?: GameEventSessionData & {
+        endTime: number;
+    };
+    ending: {
+        type: 'abort';
+        reason: string;
+    };
+    error: {
+        message: string;
+    };
+    [key: string]: unknown;
+}
+export interface GameLifecycleSessionSavingData {
+    saveId?: string;
+    [key: string]: unknown;
+}
+export interface GameLifecycleSessionSavedData {
+    saveId?: string;
+    timestamp: number;
+    [key: string]: unknown;
+}
+export interface GameLifecycleSessionRestoringData {
+    saveId?: string;
+    [key: string]: unknown;
+}
+export interface GameLifecycleSessionRestoredData {
+    saveId?: string;
+    timestamp: number;
+    [key: string]: unknown;
+}
+export interface GameLifecycleInitFailedData {
+    error: GameEventErrorData;
+    [key: string]: unknown;
+}
+export interface GameLifecycleStoryLoadFailedData {
+    story?: {
+        id?: string;
+    };
+    error: GameEventErrorData;
+    [key: string]: unknown;
+}
+export interface GameLifecycleFatalErrorData {
+    error: GameEventErrorData;
+    [key: string]: unknown;
+}
+/**
+ * Game event types for lifecycle transitions
+ */
+export declare const GameEventType: {
+    readonly GAME_INITIALIZING: "game.initializing";
+    readonly GAME_INITIALIZED: "game.initialized";
+    readonly STORY_LOADING: "game.story_loading";
+    readonly STORY_LOADED: "game.story_loaded";
+    readonly GAME_STARTING: "game.starting";
+    readonly GAME_STARTED: "game.started";
+    readonly GAME_ENDING: "game.ending";
+    readonly GAME_ENDED: "game.ended";
+    readonly GAME_WON: "game.won";
+    readonly GAME_LOST: "game.lost";
+    readonly GAME_QUIT: "game.quit";
+    readonly GAME_ABORTED: "game.aborted";
+    readonly SESSION_SAVING: "game.session_saving";
+    readonly SESSION_SAVED: "game.session_saved";
+    readonly SESSION_RESTORING: "game.session_restoring";
+    readonly SESSION_RESTORED: "game.session_restored";
+    readonly INITIALIZATION_FAILED: "game.initialization_failed";
+    readonly STORY_LOAD_FAILED: "game.story_load_failed";
+    readonly FATAL_ERROR: "game.fatal_error";
+};
+export type GameEventTypeValue = typeof GameEventType[keyof typeof GameEventType];
+/**
+ * Check if an event is a game lifecycle event (any GameEventType).
+ * Use specific type guards (isGameStartedEvent, etc.) for typed data access.
+ */
+export declare function isGameEvent(event: ISemanticEvent): boolean;
+/**
+ * Check if an event is part of the game start sequence.
+ */
+export declare function isGameStartSequenceEvent(event: ISemanticEvent): boolean;
+/**
+ * Check if an event is part of the game end sequence.
+ */
+export declare function isGameEndSequenceEvent(event: ISemanticEvent): boolean;
+/**
+ * Create a generic game event with typed data.
+ * Use specific creators (createGameStartedEvent, etc.) when possible for type safety.
+ */
+export declare function createGameEvent<T extends Record<string, unknown>>(type: GameEventTypeValue, data?: T): ISemanticEvent;
+export declare function createGameInitializingEvent(): ISemanticEvent;
+export declare function createGameInitializedEvent(): ISemanticEvent;
+export declare function createStoryLoadingEvent(storyId?: string): ISemanticEvent;
+export declare function createStoryLoadedEvent(story: GameEventStoryData): ISemanticEvent;
+export declare function createGameStartingEvent(story?: GameEventStoryData): ISemanticEvent;
+export declare function createGameStartedEvent(story?: GameEventStoryData, startTime?: number, engineVersion?: string, clientVersion?: string): ISemanticEvent;
+export declare function createGameEndingEvent(reason?: string, session?: GameEventSessionData): ISemanticEvent;
+export declare function createGameEndedEvent(endingType: 'victory' | 'defeat' | 'quit' | 'abort', session?: GameEventSessionData, ending?: Partial<GameEventEndingData>): ISemanticEvent;
+export declare function createGameWonEvent(session?: GameEventSessionData, ending?: Partial<GameEventEndingData>): ISemanticEvent;
+export declare function createGameLostEvent(reason: string, session?: GameEventSessionData): ISemanticEvent;
+export declare function createGameQuitEvent(session?: GameEventSessionData): ISemanticEvent;
+export declare function createGameAbortedEvent(error: string, session?: GameEventSessionData): ISemanticEvent;
+/** Type guard to check if an event has specific data type */
+export declare function isGameStartedEvent(event: ISemanticEvent): event is ISemanticEvent & {
+    data: GameLifecycleStartedData;
+};
+export declare function isGameEndedEvent(event: ISemanticEvent): event is ISemanticEvent & {
+    data: GameLifecycleEndedData;
+};
+export declare function isGameWonEvent(event: ISemanticEvent): event is ISemanticEvent & {
+    data: GameLifecycleWonData;
+};
+export declare function isGameLostEvent(event: ISemanticEvent): event is ISemanticEvent & {
+    data: GameLifecycleLostData;
+};
+export declare function isGameQuitEvent(event: ISemanticEvent): event is ISemanticEvent & {
+    data: GameLifecycleQuitData;
+};
+export declare function isGameAbortedEvent(event: ISemanticEvent): event is ISemanticEvent & {
+    data: GameLifecycleAbortedData;
+};
+//# sourceMappingURL=game-events.d.ts.map

package/dist/events/game-events.d.ts.map

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

package/dist/events/game-events.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * Game lifecycle events for tracking game state transitions
+ * These events mark important milestones in a game session
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameEventType = void 0;
+exports.isGameEvent = isGameEvent;
+exports.isGameStartSequenceEvent = isGameStartSequenceEvent;
+exports.isGameEndSequenceEvent = isGameEndSequenceEvent;
+exports.createGameEvent = createGameEvent;
+exports.createGameInitializingEvent = createGameInitializingEvent;
+exports.createGameInitializedEvent = createGameInitializedEvent;
+exports.createStoryLoadingEvent = createStoryLoadingEvent;
+exports.createStoryLoadedEvent = createStoryLoadedEvent;
+exports.createGameStartingEvent = createGameStartingEvent;
+exports.createGameStartedEvent = createGameStartedEvent;
+exports.createGameEndingEvent = createGameEndingEvent;
+exports.createGameEndedEvent = createGameEndedEvent;
+exports.createGameWonEvent = createGameWonEvent;
+exports.createGameLostEvent = createGameLostEvent;
+exports.createGameQuitEvent = createGameQuitEvent;
+exports.createGameAbortedEvent = createGameAbortedEvent;
+exports.isGameStartedEvent = isGameStartedEvent;
+exports.isGameEndedEvent = isGameEndedEvent;
+exports.isGameWonEvent = isGameWonEvent;
+exports.isGameLostEvent = isGameLostEvent;
+exports.isGameQuitEvent = isGameQuitEvent;
+exports.isGameAbortedEvent = isGameAbortedEvent;
+// =============================================================================
+// Game Event Type Constants
+// =============================================================================
+/**
+ * Game event types for lifecycle transitions
+ */
+exports.GameEventType = {
+    // Game start events
+    GAME_INITIALIZING: 'game.initializing', // Engine is setting up
+    GAME_INITIALIZED: 'game.initialized', // Engine ready, before story
+    STORY_LOADING: 'game.story_loading', // Story is being loaded
+    STORY_LOADED: 'game.story_loaded', // Story loaded successfully
+    GAME_STARTING: 'game.starting', // Game is about to start
+    GAME_STARTED: 'game.started', // Game has started, ready for input
+    // Game end events  
+    GAME_ENDING: 'game.ending', // Game is about to end
+    GAME_ENDED: 'game.ended', // Game has ended normally
+    GAME_WON: 'game.won', // Player achieved victory
+    GAME_LOST: 'game.lost', // Player was defeated
+    GAME_QUIT: 'game.quit', // Player quit the game
+    GAME_ABORTED: 'game.aborted', // Game ended abnormally
+    // Session events
+    SESSION_SAVING: 'game.session_saving', // Save in progress
+    SESSION_SAVED: 'game.session_saved', // Save completed
+    SESSION_RESTORING: 'game.session_restoring', // Restore in progress  
+    SESSION_RESTORED: 'game.session_restored', // Restore completed
+    // Error events
+    INITIALIZATION_FAILED: 'game.initialization_failed',
+    STORY_LOAD_FAILED: 'game.story_load_failed',
+    FATAL_ERROR: 'game.fatal_error'
+};
+/**
+ * Check if an event is a game lifecycle event (any GameEventType).
+ * Use specific type guards (isGameStartedEvent, etc.) for typed data access.
+ */
+function isGameEvent(event) {
+    return Object.values(exports.GameEventType).includes(event.type);
+}
+/**
+ * Check if an event is part of the game start sequence.
+ */
+function isGameStartSequenceEvent(event) {
+    return (event.type === exports.GameEventType.GAME_INITIALIZING ||
+        event.type === exports.GameEventType.GAME_INITIALIZED ||
+        event.type === exports.GameEventType.STORY_LOADING ||
+        event.type === exports.GameEventType.STORY_LOADED ||
+        event.type === exports.GameEventType.GAME_STARTING ||
+        event.type === exports.GameEventType.GAME_STARTED);
+}
+/**
+ * Check if an event is part of the game end sequence.
+ */
+function isGameEndSequenceEvent(event) {
+    return (event.type === exports.GameEventType.GAME_ENDING ||
+        event.type === exports.GameEventType.GAME_ENDED ||
+        event.type === exports.GameEventType.GAME_WON ||
+        event.type === exports.GameEventType.GAME_LOST ||
+        event.type === exports.GameEventType.GAME_QUIT ||
+        event.type === exports.GameEventType.GAME_ABORTED);
+}
+// =============================================================================
+// Helper Functions to Create Game Events
+// =============================================================================
+/**
+ * Generate a unique event ID
+ */
+function generateEventId() {
+    return `game-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Create a generic game event with typed data.
+ * Use specific creators (createGameStartedEvent, etc.) when possible for type safety.
+ */
+function createGameEvent(type, data) {
+    return {
+        id: generateEventId(),
+        type,
+        timestamp: Date.now(),
+        entities: {},
+        data: data || {}
+    };
+}
+// Specific event creators - all return ISemanticEvent with typed data
+function createGameInitializingEvent() {
+    return createGameEvent(exports.GameEventType.GAME_INITIALIZING, {
+        gameState: 'initializing'
+    });
+}
+function createGameInitializedEvent() {
+    return createGameEvent(exports.GameEventType.GAME_INITIALIZED, {
+        gameState: 'ready'
+    });
+}
+function createStoryLoadingEvent(storyId) {
+    return createGameEvent(exports.GameEventType.STORY_LOADING, {
+        story: { id: storyId }
+    });
+}
+function createStoryLoadedEvent(story) {
+    return createGameEvent(exports.GameEventType.STORY_LOADED, {
+        story,
+        gameState: 'ready'
+    });
+}
+function createGameStartingEvent(story) {
+    return createGameEvent(exports.GameEventType.GAME_STARTING, {
+        story,
+        gameState: 'ready'
+    });
+}
+function createGameStartedEvent(story, startTime, engineVersion, clientVersion) {
+    return createGameEvent(exports.GameEventType.GAME_STARTED, {
+        story,
+        engineVersion,
+        clientVersion,
+        gameState: 'running',
+        session: {
+            startTime: startTime || Date.now(),
+            turns: 0,
+            moves: 0
+        }
+    });
+}
+function createGameEndingEvent(reason, session) {
+    return createGameEvent(exports.GameEventType.GAME_ENDING, {
+        gameState: 'ending',
+        session,
+        ending: { reason }
+    });
+}
+function createGameEndedEvent(endingType, session, ending) {
+    return createGameEvent(exports.GameEventType.GAME_ENDED, {
+        gameState: 'ended',
+        session: {
+            ...session,
+            endTime: Date.now()
+        },
+        ending: {
+            ...ending,
+            type: endingType
+        }
+    });
+}
+function createGameWonEvent(session, ending) {
+    return createGameEvent(exports.GameEventType.GAME_WON, {
+        gameState: 'ended',
+        session: {
+            ...session,
+            endTime: Date.now()
+        },
+        ending: {
+            ...ending,
+            type: 'victory'
+        }
+    });
+}
+function createGameLostEvent(reason, session) {
+    return createGameEvent(exports.GameEventType.GAME_LOST, {
+        gameState: 'ended',
+        session: {
+            ...session,
+            endTime: Date.now()
+        },
+        ending: {
+            type: 'defeat',
+            reason
+        }
+    });
+}
+function createGameQuitEvent(session) {
+    return createGameEvent(exports.GameEventType.GAME_QUIT, {
+        gameState: 'ended',
+        session: {
+            ...session,
+            endTime: Date.now()
+        },
+        ending: {
+            type: 'quit',
+            reason: 'Player quit'
+        }
+    });
+}
+function createGameAbortedEvent(error, session) {
+    return createGameEvent(exports.GameEventType.GAME_ABORTED, {
+        gameState: 'ended',
+        session: {
+            ...session,
+            endTime: Date.now()
+        },
+        ending: {
+            type: 'abort',
+            reason: error
+        },
+        error: {
+            message: error
+        }
+    });
+}
+// =============================================================================
+// Type Guards for Game Events
+// =============================================================================
+/** Type guard to check if an event has specific data type */
+function isGameStartedEvent(event) {
+    return event.type === exports.GameEventType.GAME_STARTED;
+}
+function isGameEndedEvent(event) {
+    return event.type === exports.GameEventType.GAME_ENDED;
+}
+function isGameWonEvent(event) {
+    return event.type === exports.GameEventType.GAME_WON;
+}
+function isGameLostEvent(event) {
+    return event.type === exports.GameEventType.GAME_LOST;
+}
+function isGameQuitEvent(event) {
+    return event.type === exports.GameEventType.GAME_QUIT;
+}
+function isGameAbortedEvent(event) {
+    return event.type === exports.GameEventType.GAME_ABORTED;
+}
+//# sourceMappingURL=game-events.js.map