@sharpee/world-model 0.9.100 → 0.9.102

package/world/WorldSerializer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * WorldSerializer — persistence logic for WorldModel.
+ *
+ * Public interface: serialize, deserialize.
+ *
+ * Owner context: packages/world-model (issue #70). Extracted from WorldModel
+ * to isolate serialization concerns and make the JSON shape independently
+ * testable and versionable.
+ */
+import { IFEntity } from '../entities/if-entity';
+import { SpatialIndex } from './SpatialIndex';
+import { ICapabilityStore } from './capabilities';
+import type { ScoreLedger } from './ScoreLedger';
+/**
+ * References to WorldModel's internal state needed for serialization.
+ * These are the same references returned by WorldModel.getDataStore().
+ */
+export interface SerializableState {
+    entities: Map<string, IFEntity>;
+    spatialIndex: SpatialIndex;
+    state: Record<string, unknown>;
+    playerId?: string;
+    relationships: Map<string, Map<string, Set<string>>>;
+    idCounters: Map<string, number>;
+    capabilities: ICapabilityStore;
+}
+/**
+ * Handles serialization and deserialization of WorldModel state.
+ * Composes with ScoreLedger and WorldEventSystem for their
+ * respective serialization.
+ */
+export declare class WorldSerializer {
+    /**
+     * Serialize the world state to a JSON string.
+     *
+     * @param state - References to WorldModel's internal data structures
+     * @param scoreLedger - The score ledger instance
+     * @returns JSON string of the complete world state
+     */
+    serialize(state: SerializableState, scoreLedger: ScoreLedger): string;
+    /**
+     * Deserialize a JSON string into world state.
+     *
+     * Expects that the caller has already preserved code registrations
+     * (event chains, capabilities) and called clear() before invoking this.
+     *
+     * @param json - JSON string from a previous serialize() call
+     * @param state - References to WorldModel's internal data structures
+     * @param scoreLedger - The score ledger instance
+     */
+    deserialize(json: string, state: SerializableState, scoreLedger: ScoreLedger): void;
+    /**
+     * Rebuild ID counters by scanning existing entities.
+     * Used for backward compatibility when loading saves without idCounters.
+     *
+     * @param entities - The entity map to scan
+     * @param idCounters - The counter map to populate
+     */
+    static rebuildIdCounters(entities: Map<string, IFEntity>, idCounters: Map<string, number>): void;
+}
+//# sourceMappingURL=WorldSerializer.d.ts.map

package/world/WorldSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorldSerializer.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/world/WorldSerializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAE1B;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM;IA2BrE;;;;;;;;;OASG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,WAAW,GACvB,IAAI;IAsDP;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;CAmBR"}

package/world/WorldSerializer.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * WorldSerializer — persistence logic for WorldModel.
+ *
+ * Public interface: serialize, deserialize.
+ *
+ * Owner context: packages/world-model (issue #70). Extracted from WorldModel
+ * to isolate serialization concerns and make the JSON shape independently
+ * testable and versionable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorldSerializer = void 0;
+const if_entity_1 = require("../entities/if-entity");
+/**
+ * Handles serialization and deserialization of WorldModel state.
+ * Composes with ScoreLedger and WorldEventSystem for their
+ * respective serialization.
+ */
+class WorldSerializer {
+    /**
+     * Serialize the world state to a JSON string.
+     *
+     * @param state - References to WorldModel's internal data structures
+     * @param scoreLedger - The score ledger instance
+     * @returns JSON string of the complete world state
+     */
+    serialize(state, scoreLedger) {
+        const data = {
+            entities: Array.from(state.entities.entries()).map(([id, entity]) => ({
+                id,
+                entity: entity.toJSON()
+            })),
+            state: state.state,
+            playerId: state.playerId,
+            spatialIndex: state.spatialIndex.toJSON(),
+            relationships: Array.from(state.relationships.entries()).map(([entityId, rels]) => ({
+                entityId,
+                relationships: Array.from(rels.entries()).map(([type, related]) => ({
+                    type,
+                    related: Array.from(related)
+                }))
+            })),
+            idCounters: Array.from(state.idCounters.entries()),
+            ...scoreLedger.toJSON(),
+            capabilities: Object.entries(state.capabilities).map(([name, cap]) => ({
+                name,
+                data: cap.data,
+                schema: cap.schema
+            }))
+        };
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * Deserialize a JSON string into world state.
+     *
+     * Expects that the caller has already preserved code registrations
+     * (event chains, capabilities) and called clear() before invoking this.
+     *
+     * @param json - JSON string from a previous serialize() call
+     * @param state - References to WorldModel's internal data structures
+     * @param scoreLedger - The score ledger instance
+     */
+    deserialize(json, state, scoreLedger) {
+        const data = JSON.parse(json);
+        // Restore entities
+        for (const { id, entity } of data.entities) {
+            const newEntity = if_entity_1.IFEntity.fromJSON(entity);
+            state.entities.set(id, newEntity);
+        }
+        // Restore state
+        Object.assign(state.state, data.state || {});
+        state.playerId = data.playerId;
+        // Restore spatial index
+        if (data.spatialIndex) {
+            state.spatialIndex.loadJSON(data.spatialIndex);
+        }
+        // Restore relationships
+        if (data.relationships) {
+            for (const { entityId, relationships } of data.relationships) {
+                const entityRels = new Map();
+                for (const { type, related } of relationships) {
+                    entityRels.set(type, new Set(related));
+                }
+                state.relationships.set(entityId, entityRels);
+            }
+        }
+        // Restore ID counters
+        if (data.idCounters) {
+            state.idCounters.clear();
+            for (const [key, value] of data.idCounters) {
+                state.idCounters.set(key, value);
+            }
+        }
+        else {
+            // Rebuild from entities for backward compatibility
+            WorldSerializer.rebuildIdCounters(state.entities, state.idCounters);
+        }
+        // Restore capabilities
+        if (data.capabilities) {
+            for (const { name, data: capData, schema } of data.capabilities) {
+                state.capabilities[name] = {
+                    data: capData,
+                    schema
+                };
+            }
+        }
+        // Restore score ledger
+        scoreLedger.fromJSON(data);
+    }
+    /**
+     * Rebuild ID counters by scanning existing entities.
+     * Used for backward compatibility when loading saves without idCounters.
+     *
+     * @param entities - The entity map to scan
+     * @param idCounters - The counter map to populate
+     */
+    static rebuildIdCounters(entities, idCounters) {
+        idCounters.clear();
+        for (const entity of entities.values()) {
+            const id = entity.id;
+            if (id.length >= 3) {
+                const prefix = id[0];
+                const numPart = id.substring(1);
+                const num = parseInt(numPart, 36);
+                if (!isNaN(num)) {
+                    const currentMax = idCounters.get(prefix) || 0;
+                    if (num > currentMax) {
+                        idCounters.set(prefix, num);
+                    }
+                }
+            }
+        }
+    }
+}
+exports.WorldSerializer = WorldSerializer;
+//# sourceMappingURL=WorldSerializer.js.map

package/world/WorldSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorldSerializer.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/world/WorldSerializer.ts"],"names":[],"mappings":"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"}