@sharpee/engine 0.9.60-beta

package/dist/platform-operations.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Platform Operations Handler - Handles platform events (save/restore/quit/restart/undo)
+ *
+ * Extracted from GameEngine as part of Phase 4 remediation.
+ * Uses strategy pattern to handle different platform operation types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformOperationHandler = void 0;
+exports.createPlatformOperationHandler = createPlatformOperationHandler;
+const core_1 = require("@sharpee/core");
+const parser_interface_1 = require("./parser-interface");
+/**
+ * Handler for platform operations
+ */
+class PlatformOperationHandler {
+    saveRestoreHooks;
+    saveRestoreService;
+    stateProvider;
+    vocabularyManager;
+    constructor(saveRestoreHooks, saveRestoreService, stateProvider, vocabularyManager) {
+        this.saveRestoreHooks = saveRestoreHooks;
+        this.saveRestoreService = saveRestoreService;
+        this.stateProvider = stateProvider;
+        this.vocabularyManager = vocabularyManager;
+    }
+    /**
+     * Process all pending platform operations
+     *
+     * @param pendingOps - Array of pending platform operations
+     * @param context - Platform operation context
+     * @param engineCallbacks - Callbacks for engine-level operations
+     */
+    async processAll(pendingOps, context, engineCallbacks) {
+        // Ensure there's an entry for the current turn
+        if (!context.turnEvents.has(context.currentTurn)) {
+            context.turnEvents.set(context.currentTurn, []);
+        }
+        for (const platformOp of pendingOps) {
+            try {
+                const resultEvent = await this.handleOperation(platformOp, context, engineCallbacks);
+                if (resultEvent) {
+                    // Add to event source and turn events
+                    context.eventSource.emit(resultEvent);
+                    context.turnEvents.get(context.currentTurn)?.push(resultEvent);
+                    context.emitEvent(resultEvent);
+                }
+            }
+            catch (error) {
+                console.error(`Error processing platform operation ${platformOp.type}:`, error);
+                // Emit appropriate error event
+                const errorEvent = this.createErrorEvent(platformOp.type, error instanceof Error ? error.message : 'Unknown error');
+                if (errorEvent) {
+                    context.eventSource.emit(errorEvent);
+                    context.turnEvents.get(context.currentTurn)?.push(errorEvent);
+                    context.emitEvent(errorEvent);
+                }
+            }
+        }
+    }
+    /**
+     * Handle a single platform operation
+     */
+    async handleOperation(platformOp, context, engineCallbacks) {
+        switch (platformOp.type) {
+            case core_1.PlatformEventType.SAVE_REQUESTED:
+                return this.handleSave(platformOp);
+            case core_1.PlatformEventType.RESTORE_REQUESTED:
+                return this.handleRestore(platformOp, engineCallbacks);
+            case core_1.PlatformEventType.QUIT_REQUESTED:
+                return this.handleQuit(platformOp, context, engineCallbacks);
+            case core_1.PlatformEventType.RESTART_REQUESTED:
+                return this.handleRestart(platformOp, context, engineCallbacks);
+            case core_1.PlatformEventType.UNDO_REQUESTED:
+                return this.handleUndo(engineCallbacks);
+            default:
+                return null;
+        }
+    }
+    /**
+     * Handle save request
+     */
+    async handleSave(platformOp) {
+        if (!this.saveRestoreHooks?.onSaveRequested) {
+            return (0, core_1.createSaveCompletedEvent)(false, 'No save handler registered');
+        }
+        const saveContext = platformOp.payload.context;
+        const saveData = this.saveRestoreService.createSaveData(this.stateProvider);
+        // Add any additional context from the platform event
+        if (saveContext?.saveName) {
+            saveData.metadata.description = saveContext.saveName;
+        }
+        if (saveContext?.metadata) {
+            Object.assign(saveData.metadata, saveContext.metadata);
+        }
+        await this.saveRestoreHooks.onSaveRequested(saveData);
+        return (0, core_1.createSaveCompletedEvent)(true);
+    }
+    /**
+     * Handle restore request
+     */
+    async handleRestore(platformOp, engineCallbacks) {
+        if (!this.saveRestoreHooks?.onRestoreRequested) {
+            return (0, core_1.createRestoreCompletedEvent)(false, 'No restore handler registered');
+        }
+        const saveData = await this.saveRestoreHooks.onRestoreRequested();
+        if (!saveData) {
+            return (0, core_1.createRestoreCompletedEvent)(false, 'No save data available or restore cancelled');
+        }
+        const result = this.saveRestoreService.loadSaveData(saveData, this.stateProvider);
+        // Update context
+        engineCallbacks.updateContext({ currentTurn: result.currentTurn });
+        // Reset pronoun context
+        const parser = engineCallbacks.getParser();
+        if (parser && (0, parser_interface_1.hasPronounContext)(parser)) {
+            parser.resetPronounContext();
+        }
+        // Update vocabulary for current scope
+        engineCallbacks.updateScopeVocabulary();
+        engineCallbacks.emitStateChanged();
+        return (0, core_1.createRestoreCompletedEvent)(true);
+    }
+    /**
+     * Handle quit request
+     */
+    async handleQuit(platformOp, context, engineCallbacks) {
+        const quitContext = platformOp.payload.context;
+        if (this.saveRestoreHooks?.onQuitRequested) {
+            const shouldQuit = await this.saveRestoreHooks.onQuitRequested(quitContext || {});
+            if (shouldQuit) {
+                engineCallbacks.stopEngine('quit');
+                return (0, core_1.createQuitConfirmedEvent)();
+            }
+            else {
+                return (0, core_1.createQuitCancelledEvent)();
+            }
+        }
+        else {
+            // No quit hook registered, auto-confirm
+            return (0, core_1.createQuitConfirmedEvent)();
+        }
+    }
+    /**
+     * Handle restart request
+     */
+    async handleRestart(platformOp, context, engineCallbacks) {
+        const restartContext = platformOp.payload.context;
+        if (this.saveRestoreHooks?.onRestartRequested) {
+            const shouldRestart = await this.saveRestoreHooks.onRestartRequested(restartContext || {});
+            if (shouldRestart) {
+                // Reset pronoun context
+                const parser = engineCallbacks.getParser();
+                if (parser && (0, parser_interface_1.hasPronounContext)(parser)) {
+                    parser.resetPronounContext();
+                }
+                await engineCallbacks.restartStory();
+                return (0, core_1.createRestartCompletedEvent)(true);
+            }
+            else {
+                return (0, core_1.createRestartCompletedEvent)(false);
+            }
+        }
+        else {
+            // No restart hook registered - default behavior is to restart
+            const parser = engineCallbacks.getParser();
+            if (parser && (0, parser_interface_1.hasPronounContext)(parser)) {
+                parser.resetPronounContext();
+            }
+            await engineCallbacks.restartStory();
+            return (0, core_1.createRestartCompletedEvent)(true);
+        }
+    }
+    /**
+     * Handle undo request
+     */
+    handleUndo(engineCallbacks) {
+        const world = this.stateProvider.getWorld();
+        const result = this.saveRestoreService.undo(world);
+        if (result) {
+            // Update context with restored turn
+            engineCallbacks.updateContext({ currentTurn: result.turn });
+            // Update vocabulary for current scope
+            engineCallbacks.updateScopeVocabulary();
+            engineCallbacks.emitStateChanged();
+            return (0, core_1.createUndoCompletedEvent)(true, result.turn);
+        }
+        else {
+            return (0, core_1.createUndoCompletedEvent)(false, undefined, 'Nothing to undo');
+        }
+    }
+    /**
+     * Create an error event for a failed operation
+     */
+    createErrorEvent(operationType, errorMessage) {
+        switch (operationType) {
+            case core_1.PlatformEventType.SAVE_REQUESTED:
+                return (0, core_1.createSaveCompletedEvent)(false, errorMessage);
+            case core_1.PlatformEventType.RESTORE_REQUESTED:
+                return (0, core_1.createRestoreCompletedEvent)(false, errorMessage);
+            case core_1.PlatformEventType.QUIT_REQUESTED:
+                return (0, core_1.createQuitCancelledEvent)();
+            case core_1.PlatformEventType.RESTART_REQUESTED:
+                return (0, core_1.createRestartCompletedEvent)(false);
+            case core_1.PlatformEventType.UNDO_REQUESTED:
+                return (0, core_1.createUndoCompletedEvent)(false, undefined, errorMessage);
+            default:
+                return null;
+        }
+    }
+}
+exports.PlatformOperationHandler = PlatformOperationHandler;
+/**
+ * Create a platform operation handler instance
+ */
+function createPlatformOperationHandler(saveRestoreHooks, saveRestoreService, stateProvider, vocabularyManager) {
+    return new PlatformOperationHandler(saveRestoreHooks, saveRestoreService, stateProvider, vocabularyManager);
+}
+//# sourceMappingURL=platform-operations.js.map

package/dist/platform-operations.js.map

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

package/dist/save-restore-service.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Save/Restore Service - Manages game state persistence and undo
+ *
+ * Extracted from GameEngine as part of Phase 4 remediation.
+ * Handles save/restore data creation, undo snapshots, and serialization.
+ */
+import { WorldModel } from '@sharpee/world-model';
+import { ISaveData, ISerializedTurn, ISemanticEventSource } from '@sharpee/core';
+import { ISchedulerService } from './scheduler';
+import { TurnResult, GameContext } from './types';
+import { Story } from './story';
+/**
+ * Interface for accessing engine state needed for save/restore
+ */
+export interface ISaveRestoreStateProvider {
+    getWorld(): WorldModel;
+    getContext(): GameContext;
+    getStory(): Story | undefined;
+    getEventSource(): ISemanticEventSource;
+    getScheduler(): ISchedulerService;
+    getParser(): unknown | undefined;
+}
+/**
+ * Configuration for the undo system
+ */
+export interface UndoConfig {
+    maxSnapshots: number;
+}
+/**
+ * Service for managing save/restore and undo functionality
+ */
+export declare class SaveRestoreService {
+    private undoSnapshots;
+    private undoSnapshotTurns;
+    private maxUndoSnapshots;
+    constructor(config?: UndoConfig);
+    /**
+     * Create an undo snapshot of the current world state
+     */
+    createUndoSnapshot(world: WorldModel, currentTurn: number): void;
+    /**
+     * Undo to previous turn
+     * @returns The turn number restored to, or null if nothing to undo
+     */
+    undo(world: WorldModel): {
+        turn: number;
+    } | null;
+    /**
+     * Check if undo is available
+     */
+    canUndo(): boolean;
+    /**
+     * Get number of undo levels available
+     */
+    getUndoLevels(): number;
+    /**
+     * Clear all undo snapshots (e.g., after restore)
+     */
+    clearUndoSnapshots(): void;
+    /**
+     * Create save data from current engine state
+     */
+    createSaveData(provider: ISaveRestoreStateProvider): ISaveData;
+    /**
+     * Load save data into engine state
+     * @returns New event source with restored events
+     */
+    loadSaveData(saveData: ISaveData, provider: ISaveRestoreStateProvider): {
+        eventSource: ISemanticEventSource;
+        currentTurn: number;
+    };
+    /**
+     * Serialize event source
+     */
+    private serializeEventSource;
+    /**
+     * Serialize event data, handling functions and special types
+     */
+    private serializeEventData;
+    /**
+     * Deserialize event source
+     */
+    private deserializeEventSource;
+    /**
+     * Deserialize event data, handling function markers
+     */
+    private deserializeEventData;
+    /**
+     * Serialize spatial index (world state)
+     */
+    private serializeSpatialIndex;
+    /**
+     * Deserialize spatial index
+     */
+    private deserializeSpatialIndex;
+    /**
+     * Serialize turn history
+     */
+    private serializeTurnHistory;
+    /**
+     * Deserialize turn history
+     */
+    deserializeTurnHistory(turns: ISerializedTurn[], eventSource: ISemanticEventSource): TurnResult[];
+    /**
+     * Serialize parser state
+     */
+    private serializeParserState;
+    /**
+     * Serialize scheduler state (daemons and fuses)
+     */
+    private serializeSchedulerState;
+    /**
+     * Deserialize scheduler state
+     */
+    private deserializeSchedulerState;
+    /**
+     * Serialize a trait
+     */
+    private serializeTrait;
+    /**
+     * Deserialize a trait
+     */
+    private deserializeTrait;
+    /**
+     * Extract connections from a location entity
+     */
+    private extractConnections;
+}
+/**
+ * Create a save/restore service instance
+ */
+export declare function createSaveRestoreService(config?: UndoConfig): SaveRestoreService;
+//# sourceMappingURL=save-restore-service.d.ts.map

package/dist/save-restore-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-restore-service.d.ts","sourceRoot":"","sources":["../src/save-restore-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EAIX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,SAAS,EAQT,eAAe,EAGf,oBAAoB,EAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,IAAI,UAAU,CAAC;IACvB,UAAU,IAAI,WAAW,CAAC;IAC1B,QAAQ,IAAI,KAAK,GAAG,SAAS,CAAC;IAC9B,cAAc,IAAI,oBAAoB,CAAC;IACvC,YAAY,IAAI,iBAAiB,CAAC;IAClC,SAAS,IAAI,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,CAAC,EAAE,UAAU;IAI/B;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAiBhE;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAehD;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAK1B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,yBAAyB,GAAG,SAAS;IAwC9D;;;OAGG;IACH,YAAY,CACV,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,yBAAyB,GAClC;QACD,WAAW,EAAE,oBAAoB,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC;KACrB;IAwCD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyC7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoC/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,sBAAsB,CACpB,KAAK,EAAE,eAAe,EAAE,EACxB,WAAW,EAAE,oBAAoB,GAChC,UAAU,EAAE;IAyBf;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA0C3B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAEhF"}