@sharpee/core 0.9.56-beta

package/dist/events/game-events.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Core event system
+ *
+ * Provides a generic event bus and text processing system
+ * without knowledge of specific event types
+ */
+export * from './types';
+export * from './standard-events';
+export * from './system-event';
+export * from './platform-events';
+export * from './game-events';
+export * from './event-registry';
+export * from './typed-event';
+export * from './event-factory';
+export * from './event-helpers';
+export { IGenericEventSource, SimpleEventSource, createEventSource as createGenericEventSource } from './event-source';
+export { ISemanticEventSource, SemanticEventSourceImpl, createSemanticEventSource } from './semantic-event-source';
+export { createEvent, EventSourceImpl, createEventSource } from './event-system';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAG9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,IAAI,wBAAwB,EAC9C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,WAAW,EACX,eAAe,EACf,iBAAiB,EAClB,MAAM,gBAAgB,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,51 @@
+"use strict";
+// packages/core/src/events/index.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventSource = exports.EventSourceImpl = exports.createEvent = exports.createSemanticEventSource = exports.SemanticEventSourceImpl = exports.createGenericEventSource = exports.SimpleEventSource = void 0;
+/**
+ * Core event system
+ *
+ * Provides a generic event bus and text processing system
+ * without knowledge of specific event types
+ */
+// Export types first
+__exportStar(require("./types"), exports);
+__exportStar(require("./standard-events"), exports);
+__exportStar(require("./system-event"), exports);
+__exportStar(require("./platform-events"), exports);
+__exportStar(require("./game-events"), exports);
+// Export typed event system (ADR-082)
+__exportStar(require("./event-registry"), exports);
+__exportStar(require("./typed-event"), exports);
+__exportStar(require("./event-factory"), exports);
+__exportStar(require("./event-helpers"), exports);
+// Export event sources with specific names to avoid conflicts
+var event_source_1 = require("./event-source");
+Object.defineProperty(exports, "SimpleEventSource", { enumerable: true, get: function () { return event_source_1.SimpleEventSource; } });
+Object.defineProperty(exports, "createGenericEventSource", { enumerable: true, get: function () { return event_source_1.createEventSource; } });
+var semantic_event_source_1 = require("./semantic-event-source");
+Object.defineProperty(exports, "SemanticEventSourceImpl", { enumerable: true, get: function () { return semantic_event_source_1.SemanticEventSourceImpl; } });
+Object.defineProperty(exports, "createSemanticEventSource", { enumerable: true, get: function () { return semantic_event_source_1.createSemanticEventSource; } });
+// Export from event-system
+var event_system_1 = require("./event-system");
+Object.defineProperty(exports, "createEvent", { enumerable: true, get: function () { return event_system_1.createEvent; } });
+Object.defineProperty(exports, "EventSourceImpl", { enumerable: true, get: function () { return event_system_1.EventSourceImpl; } });
+Object.defineProperty(exports, "createEventSource", { enumerable: true, get: function () { return event_system_1.createEventSource; } });
+// message-resolver moved to stdlib (uses GameContext)
+// enhanced-text-processor moved to stdlib (uses GameContext) 
+// message-builder moved to stdlib (uses GameContext)
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;;AAEpC;;;;;GAKG;AAEH,qBAAqB;AACrB,0CAAwB;AACxB,oDAAkC;AAClC,iDAA+B;AAC/B,oDAAkC;AAClC,gDAA8B;AAE9B,sCAAsC;AACtC,mDAAiC;AACjC,gDAA8B;AAC9B,kDAAgC;AAChC,kDAAgC;AAEhC,8DAA8D;AAC9D,+CAIwB;AAFtB,iHAAA,iBAAiB,OAAA;AACjB,wHAAA,iBAAiB,OAA4B;AAG/C,iEAIiC;AAF/B,gIAAA,uBAAuB,OAAA;AACvB,kIAAA,yBAAyB,OAAA;AAG3B,2BAA2B;AAC3B,+CAIwB;AAHtB,2GAAA,WAAW,OAAA;AACX,+GAAA,eAAe,OAAA;AACf,iHAAA,iBAAiB,OAAA;AAGnB,sDAAsD;AACtD,8DAA8D;AAC9D,qDAAqD"}

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

@@ -0,0 +1,161 @@
+/**
+ * Platform events for operations that require client/host intervention
+ * These events are processed after turn completion but before text service
+ */
+import { ISemanticEvent } from './types';
+import { IQuitContext, IRestartContext } from '../types/save-data';
+/**
+ * Platform event types for save, restore, quit, and restart operations
+ */
+export declare const PlatformEventType: {
+    readonly SAVE_REQUESTED: "platform.save_requested";
+    readonly RESTORE_REQUESTED: "platform.restore_requested";
+    readonly QUIT_REQUESTED: "platform.quit_requested";
+    readonly RESTART_REQUESTED: "platform.restart_requested";
+    readonly UNDO_REQUESTED: "platform.undo_requested";
+    readonly AGAIN_REQUESTED: "platform.again_requested";
+    readonly SAVE_COMPLETED: "platform.save_completed";
+    readonly RESTORE_COMPLETED: "platform.restore_completed";
+    readonly QUIT_CONFIRMED: "platform.quit_confirmed";
+    readonly RESTART_COMPLETED: "platform.restart_completed";
+    readonly UNDO_COMPLETED: "platform.undo_completed";
+    readonly SAVE_FAILED: "platform.save_failed";
+    readonly RESTORE_FAILED: "platform.restore_failed";
+    readonly QUIT_CANCELLED: "platform.quit_cancelled";
+    readonly RESTART_CANCELLED: "platform.restart_cancelled";
+    readonly UNDO_FAILED: "platform.undo_failed";
+    readonly AGAIN_FAILED: "platform.again_failed";
+};
+export type PlatformEventTypeValue = typeof PlatformEventType[keyof typeof PlatformEventType];
+/**
+ * Base interface for all platform events
+ */
+export interface IPlatformEvent extends ISemanticEvent {
+    type: PlatformEventTypeValue;
+    /**
+     * Indicates this event requires client action and should be processed
+     * after turn completion but before text service
+     */
+    requiresClientAction: true;
+    /**
+     * Platform-specific context for the operation
+     */
+    payload: {
+        /**
+         * Context specific to the platform operation
+         */
+        context?: unknown;
+        /**
+         * For completion/error events: whether the operation succeeded
+         */
+        success?: boolean;
+        /**
+         * For error events: error message or reason
+         */
+        error?: string;
+        /**
+         * Any additional data specific to the platform operation
+         */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Context for save operations
+ */
+export interface ISaveContext {
+    /**
+     * Optional name for the save
+     */
+    saveName?: string;
+    /**
+     * Save slot identifier
+     */
+    slot?: string | number;
+    /**
+     * Whether this is an autosave
+     */
+    autosave?: boolean;
+    /**
+     * Additional metadata to store with the save
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Timestamp when save was requested
+     */
+    timestamp: number;
+}
+/**
+ * Context for restore operations
+ */
+export interface IRestoreContext {
+    /**
+     * Specific save slot to restore
+     */
+    slot?: string | number;
+    /**
+     * List of available saves (if known)
+     */
+    availableSaves?: Array<{
+        slot: string | number;
+        name?: string;
+        timestamp: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /**
+     * Information about the last save
+     */
+    lastSave?: {
+        slot: string | number;
+        timestamp: number;
+    };
+}
+export { IQuitContext, IRestartContext };
+/**
+ * Type guards for platform events
+ */
+export declare function isPlatformEvent(event: ISemanticEvent): event is IPlatformEvent;
+export declare function isPlatformRequestEvent(event: ISemanticEvent): boolean;
+export declare function isPlatformCompletionEvent(event: ISemanticEvent): boolean;
+/**
+ * Helper functions to create platform events
+ */
+export declare function createPlatformEvent(type: PlatformEventTypeValue, context?: unknown, additionalPayload?: Record<string, unknown>): IPlatformEvent;
+export declare function createSaveRequestedEvent(context: ISaveContext): IPlatformEvent;
+export declare function createRestoreRequestedEvent(context: IRestoreContext): IPlatformEvent;
+export declare function createQuitRequestedEvent(context: IQuitContext): IPlatformEvent;
+export declare function createRestartRequestedEvent(context: IRestartContext): IPlatformEvent;
+/**
+ * Helper functions for completion events
+ */
+export declare function createSaveCompletedEvent(success: boolean, error?: string): IPlatformEvent;
+export declare function createRestoreCompletedEvent(success: boolean, error?: string): IPlatformEvent;
+export declare function createQuitConfirmedEvent(): IPlatformEvent;
+export declare function createQuitCancelledEvent(): IPlatformEvent;
+export declare function createRestartCompletedEvent(success: boolean): IPlatformEvent;
+/**
+ * Context for undo operations
+ */
+export interface IUndoContext {
+    /**
+     * Number of turns to undo (default 1)
+     */
+    turns?: number;
+}
+export declare function createUndoRequestedEvent(context?: IUndoContext): IPlatformEvent;
+export declare function createUndoCompletedEvent(success: boolean, restoredToTurn?: number, error?: string): IPlatformEvent;
+/**
+ * Context for again (repeat) operations
+ */
+export interface IAgainContext {
+    /**
+     * The original command text to repeat
+     */
+    command: string;
+    /**
+     * The action ID of the command to repeat
+     */
+    actionId: string;
+}
+export declare function createAgainRequestedEvent(context: IAgainContext): IPlatformEvent;
+export declare function createAgainFailedEvent(error: string): IPlatformEvent;
+//# sourceMappingURL=platform-events.d.ts.map

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

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

package/dist/events/platform-events.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Platform events for operations that require client/host intervention
+ * These events are processed after turn completion but before text service
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformEventType = void 0;
+exports.isPlatformEvent = isPlatformEvent;
+exports.isPlatformRequestEvent = isPlatformRequestEvent;
+exports.isPlatformCompletionEvent = isPlatformCompletionEvent;
+exports.createPlatformEvent = createPlatformEvent;
+exports.createSaveRequestedEvent = createSaveRequestedEvent;
+exports.createRestoreRequestedEvent = createRestoreRequestedEvent;
+exports.createQuitRequestedEvent = createQuitRequestedEvent;
+exports.createRestartRequestedEvent = createRestartRequestedEvent;
+exports.createSaveCompletedEvent = createSaveCompletedEvent;
+exports.createRestoreCompletedEvent = createRestoreCompletedEvent;
+exports.createQuitConfirmedEvent = createQuitConfirmedEvent;
+exports.createQuitCancelledEvent = createQuitCancelledEvent;
+exports.createRestartCompletedEvent = createRestartCompletedEvent;
+exports.createUndoRequestedEvent = createUndoRequestedEvent;
+exports.createUndoCompletedEvent = createUndoCompletedEvent;
+exports.createAgainRequestedEvent = createAgainRequestedEvent;
+exports.createAgainFailedEvent = createAgainFailedEvent;
+/**
+ * Platform event types for save, restore, quit, and restart operations
+ */
+exports.PlatformEventType = {
+    // Request events - emitted by actions
+    SAVE_REQUESTED: 'platform.save_requested',
+    RESTORE_REQUESTED: 'platform.restore_requested',
+    QUIT_REQUESTED: 'platform.quit_requested',
+    RESTART_REQUESTED: 'platform.restart_requested',
+    UNDO_REQUESTED: 'platform.undo_requested',
+    AGAIN_REQUESTED: 'platform.again_requested',
+    // Completion events - emitted by engine after processing
+    SAVE_COMPLETED: 'platform.save_completed',
+    RESTORE_COMPLETED: 'platform.restore_completed',
+    QUIT_CONFIRMED: 'platform.quit_confirmed',
+    RESTART_COMPLETED: 'platform.restart_completed',
+    UNDO_COMPLETED: 'platform.undo_completed',
+    // Error events
+    SAVE_FAILED: 'platform.save_failed',
+    RESTORE_FAILED: 'platform.restore_failed',
+    QUIT_CANCELLED: 'platform.quit_cancelled',
+    RESTART_CANCELLED: 'platform.restart_cancelled',
+    UNDO_FAILED: 'platform.undo_failed',
+    AGAIN_FAILED: 'platform.again_failed'
+};
+/**
+ * Type guards for platform events
+ */
+function isPlatformEvent(event) {
+    return 'requiresClientAction' in event && event.requiresClientAction === true;
+}
+function isPlatformRequestEvent(event) {
+    return isPlatformEvent(event) && (event.type === exports.PlatformEventType.SAVE_REQUESTED ||
+        event.type === exports.PlatformEventType.RESTORE_REQUESTED ||
+        event.type === exports.PlatformEventType.QUIT_REQUESTED ||
+        event.type === exports.PlatformEventType.RESTART_REQUESTED ||
+        event.type === exports.PlatformEventType.UNDO_REQUESTED ||
+        event.type === exports.PlatformEventType.AGAIN_REQUESTED);
+}
+function isPlatformCompletionEvent(event) {
+    return isPlatformEvent(event) && (event.type === exports.PlatformEventType.SAVE_COMPLETED ||
+        event.type === exports.PlatformEventType.RESTORE_COMPLETED ||
+        event.type === exports.PlatformEventType.QUIT_CONFIRMED ||
+        event.type === exports.PlatformEventType.RESTART_COMPLETED ||
+        event.type === exports.PlatformEventType.UNDO_COMPLETED ||
+        event.type === exports.PlatformEventType.SAVE_FAILED ||
+        event.type === exports.PlatformEventType.RESTORE_FAILED ||
+        event.type === exports.PlatformEventType.QUIT_CANCELLED ||
+        event.type === exports.PlatformEventType.RESTART_CANCELLED ||
+        event.type === exports.PlatformEventType.UNDO_FAILED ||
+        event.type === exports.PlatformEventType.AGAIN_FAILED);
+}
+/**
+ * Helper functions to create platform events
+ */
+function createPlatformEvent(type, context, additionalPayload) {
+    return {
+        id: `platform-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+        type,
+        timestamp: Date.now(),
+        requiresClientAction: true,
+        entities: {},
+        payload: {
+            context,
+            ...additionalPayload
+        }
+    };
+}
+function createSaveRequestedEvent(context) {
+    return createPlatformEvent(exports.PlatformEventType.SAVE_REQUESTED, context);
+}
+function createRestoreRequestedEvent(context) {
+    return createPlatformEvent(exports.PlatformEventType.RESTORE_REQUESTED, context);
+}
+function createQuitRequestedEvent(context) {
+    return createPlatformEvent(exports.PlatformEventType.QUIT_REQUESTED, context);
+}
+function createRestartRequestedEvent(context) {
+    return createPlatformEvent(exports.PlatformEventType.RESTART_REQUESTED, context);
+}
+/**
+ * Helper functions for completion events
+ */
+function createSaveCompletedEvent(success, error) {
+    return createPlatformEvent(success ? exports.PlatformEventType.SAVE_COMPLETED : exports.PlatformEventType.SAVE_FAILED, undefined, { success, error });
+}
+function createRestoreCompletedEvent(success, error) {
+    return createPlatformEvent(success ? exports.PlatformEventType.RESTORE_COMPLETED : exports.PlatformEventType.RESTORE_FAILED, undefined, { success, error });
+}
+function createQuitConfirmedEvent() {
+    return createPlatformEvent(exports.PlatformEventType.QUIT_CONFIRMED, undefined, { success: true });
+}
+function createQuitCancelledEvent() {
+    return createPlatformEvent(exports.PlatformEventType.QUIT_CANCELLED, undefined, { success: false });
+}
+function createRestartCompletedEvent(success) {
+    return createPlatformEvent(success ? exports.PlatformEventType.RESTART_COMPLETED : exports.PlatformEventType.RESTART_CANCELLED, undefined, { success });
+}
+function createUndoRequestedEvent(context) {
+    return createPlatformEvent(exports.PlatformEventType.UNDO_REQUESTED, context);
+}
+function createUndoCompletedEvent(success, restoredToTurn, error) {
+    return createPlatformEvent(success ? exports.PlatformEventType.UNDO_COMPLETED : exports.PlatformEventType.UNDO_FAILED, undefined, { success, restoredToTurn, error });
+}
+function createAgainRequestedEvent(context) {
+    return createPlatformEvent(exports.PlatformEventType.AGAIN_REQUESTED, context);
+}
+function createAgainFailedEvent(error) {
+    return createPlatformEvent(exports.PlatformEventType.AGAIN_FAILED, undefined, { success: false, error });
+}
+//# sourceMappingURL=platform-events.js.map

package/dist/events/platform-events.js.map

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

package/dist/events/semantic-event-source.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Semantic event source - specialized event source for story events
+ * Builds on the generic event source infrastructure
+ */
+import { IGenericEventSource, SimpleEventSource } from './event-source';
+import { ISemanticEvent, IEventEmitter } from './types';
+import { EntityId } from '../types/entity';
+/**
+ * Specialized event source for semantic (story) events
+ * Provides additional filtering and query capabilities
+ */
+export interface ISemanticEventSource extends IGenericEventSource<ISemanticEvent> {
+    /**
+     * Add an event to the source
+     */
+    addEvent(event: ISemanticEvent): void;
+    /**
+     * Get all events in the source
+     */
+    getAllEvents(): ISemanticEvent[];
+    /**
+     * Get events of a specific type
+     */
+    getEventsByType(type: string): ISemanticEvent[];
+    /**
+     * Get events involving a specific entity
+     */
+    getEventsByEntity(entityId: EntityId): ISemanticEvent[];
+    /**
+     * Get events with a specific tag
+     */
+    getEventsByTag(tag: string): ISemanticEvent[];
+    /**
+     * Clear all events
+     */
+    clearEvents(): void;
+    /**
+     * Apply a filter to the events
+     */
+    filter(predicate: (event: ISemanticEvent) => boolean): ISemanticEvent[];
+    /**
+     * Get the event emitter associated with this source
+     */
+    getEmitter(): IEventEmitter;
+}
+/**
+ * Implementation of semantic event source
+ */
+export declare class SemanticEventSourceImpl extends SimpleEventSource<ISemanticEvent> implements ISemanticEventSource {
+    private events;
+    private eventEmitter;
+    private lastProcessedIndex;
+    constructor();
+    addEvent(event: ISemanticEvent): void;
+    getAllEvents(): ISemanticEvent[];
+    getEventsByType(type: string): ISemanticEvent[];
+    getEventsByEntity(entityId: EntityId): ISemanticEvent[];
+    getEventsByTag(tag: string): ISemanticEvent[];
+    filter(predicate: (event: ISemanticEvent) => boolean): ISemanticEvent[];
+    clearEvents(): void;
+    getEmitter(): IEventEmitter;
+    /**
+     * Get events since a specific event ID
+     */
+    getEventsSince(eventId?: string): ISemanticEvent[];
+    /**
+     * Get unprocessed events and mark them as processed
+     */
+    getUnprocessedEvents(): ISemanticEvent[];
+}
+/**
+ * Create a new semantic event source
+ */
+export declare function createSemanticEventSource(): ISemanticEventSource;
+/**
+ * Type alias for backwards compatibility
+ * @deprecated Use SemanticEventSource instead
+ */
+export type EventSource = ISemanticEventSource;
+/**
+ * Create event source for backwards compatibility
+ * @deprecated Use createSemanticEventSource instead
+ */
+export declare function createEventSource(): EventSource;
+//# sourceMappingURL=semantic-event-source.d.ts.map

package/dist/events/semantic-event-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-event-source.d.ts","sourceRoot":"","sources":["../../src/events/semantic-event-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC/E;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAEtC;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE,CAAC;IAEjC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IAEhD;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE,CAAC;IAExD;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IAE9C;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE,CAAC;IAExE;;OAEG;IACH,UAAU,IAAI,aAAa,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,iBAAiB,CAAC,cAAc,CAAE,YAAW,oBAAoB;IAC5G,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,kBAAkB,CAAa;;IAYvC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAKrC,YAAY,IAAI,cAAc,EAAE;IAIhC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAI/C,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE;IAavD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE;IAI7C,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE;IAIvE,WAAW,IAAI,IAAI;IAInB,UAAU,IAAI,aAAa;IAI3B;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAalD;;OAEG;IACH,oBAAoB,IAAI,cAAc,EAAE;CAKzC;AA4DD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,oBAAoB,CAEhE;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

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

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Semantic event source - specialized event source for story events
+ * Builds on the generic event source infrastructure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticEventSourceImpl = void 0;
+exports.createSemanticEventSource = createSemanticEventSource;
+exports.createEventSource = createEventSource;
+const event_source_1 = require("./event-source");
+/**
+ * Implementation of semantic event source
+ */
+class SemanticEventSourceImpl extends event_source_1.SimpleEventSource {
+    events = [];
+    eventEmitter;
+    lastProcessedIndex = 0;
+    constructor() {
+        super();
+        this.eventEmitter = new EventEmitterImpl();
+        // Bridge between generic event source and semantic event emitter
+        this.subscribe((event) => {
+            this.eventEmitter.emit(event);
+        });
+    }
+    addEvent(event) {
+        this.events.push(event);
+        this.emit(event);
+    }
+    getAllEvents() {
+        return [...this.events];
+    }
+    getEventsByType(type) {
+        return this.events.filter(event => event.type === type);
+    }
+    getEventsByEntity(entityId) {
+        return this.events.filter(event => {
+            const entities = event.entities;
+            return (entities.actor === entityId ||
+                entities.target === entityId ||
+                entities.instrument === entityId ||
+                entities.location === entityId ||
+                (entities.others && entities.others.includes(entityId)));
+        });
+    }
+    getEventsByTag(tag) {
+        return this.events.filter(event => event.tags && event.tags.includes(tag));
+    }
+    filter(predicate) {
+        return this.events.filter(predicate);
+    }
+    clearEvents() {
+        this.events = [];
+    }
+    getEmitter() {
+        return this.eventEmitter;
+    }
+    /**
+     * Get events since a specific event ID
+     */
+    getEventsSince(eventId) {
+        if (!eventId) {
+            return this.getAllEvents();
+        }
+        const index = this.events.findIndex(e => e.id === eventId);
+        if (index === -1) {
+            return this.getAllEvents();
+        }
+        return this.events.slice(index + 1);
+    }
+    /**
+     * Get unprocessed events and mark them as processed
+     */
+    getUnprocessedEvents() {
+        const unprocessed = this.events.slice(this.lastProcessedIndex);
+        this.lastProcessedIndex = this.events.length;
+        return unprocessed;
+    }
+}
+exports.SemanticEventSourceImpl = SemanticEventSourceImpl;
+/**
+ * Implementation of the EventEmitter interface
+ */
+class EventEmitterImpl {
+    listeners = new Map();
+    globalListeners = new Set();
+    on(type, listener) {
+        if (type === '*') {
+            this.globalListeners.add(listener);
+            return;
+        }
+        if (!this.listeners.has(type)) {
+            this.listeners.set(type, new Set());
+        }
+        this.listeners.get(type).add(listener);
+    }
+    off(type, listener) {
+        if (type === '*') {
+            this.globalListeners.delete(listener);
+            return;
+        }
+        const typeListeners = this.listeners.get(type);
+        if (typeListeners) {
+            typeListeners.delete(listener);
+            if (typeListeners.size === 0) {
+                this.listeners.delete(type);
+            }
+        }
+    }
+    emit(event) {
+        // Emit to specific type listeners
+        const typeListeners = this.listeners.get(event.type);
+        if (typeListeners) {
+            for (const listener of typeListeners) {
+                try {
+                    listener(event);
+                }
+                catch (error) {
+                    console.error(`Error in event listener for ${event.type}:`, error);
+                }
+            }
+        }
+        // Emit to global listeners
+        for (const listener of this.globalListeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error(`Error in global event listener:`, error);
+            }
+        }
+    }
+}
+/**
+ * Create a new semantic event source
+ */
+function createSemanticEventSource() {
+    return new SemanticEventSourceImpl();
+}
+/**
+ * Create event source for backwards compatibility
+ * @deprecated Use createSemanticEventSource instead
+ */
+function createEventSource() {
+    return createSemanticEventSource();
+}
+//# sourceMappingURL=semantic-event-source.js.map

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

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