@sadhaka/loom-engine 0.12.0 → 0.14.0

package/dist/director/ai/plugin-context.js

@@ -0,0 +1,152 @@
+// PluginContext concrete implementations.
+//
+// MapPluginStorage  - in-memory KV backed by a single Map, namespaced
+//                     per (pluginName, key). Survives across ticks;
+//                     cleared when the registry calls clearPlugin().
+// ConsolePluginLogger - tags every line with the plugin name and
+//                       writes to console.{info,warn,error}. Suitable
+//                       for tests + dev; production consumers can
+//                       drop in a structured-log impl.
+//
+// These are reference implementations. Consumers wiring against
+// `@sadhaka/loom-engine/server` may substitute their own
+// PluginStorage / PluginLogger impls (e.g. Redis-backed storage,
+// pino-backed logger) without changing the SPI surface.
+//
+// The registry does not assume MapPluginStorage; the SPI is
+// the only contract. These exist so a consumer can stand a plugin
+// up in five lines without writing a storage adapter first.
+// ----- MapPluginStorage -----
+//
+// In-memory storage shared across all plugins; per-plugin namespace
+// is enforced by composing the storage key as `${pluginName}::${key}`.
+// `clearPlugin(name)` wipes every entry tagged with that plugin so
+// unregister + re-register starts clean.
+export class MapPluginStorage {
+    store = new Map();
+    // Build a per-plugin facade that satisfies the PluginStorage
+    // interface; the facade scopes get/set/delete to the plugin's
+    // namespace so plugin authors never see the composite key.
+    forPlugin(pluginName) {
+        var self = this;
+        return {
+            async get(key) {
+                return self.store.get(self.composeKey(pluginName, key));
+            },
+            async set(key, value) {
+                self.store.set(self.composeKey(pluginName, key), value);
+            },
+            async delete(key) {
+                self.store.delete(self.composeKey(pluginName, key));
+            },
+        };
+    }
+    // Wipe all entries belonging to a plugin. Called by the registry
+    // on unregister(). Iterates once; cost is O(total entries) but
+    // unregister is rare.
+    clearPlugin(pluginName) {
+        var prefix = pluginName + '::';
+        var keysToDelete = [];
+        var iter = this.store.keys();
+        var next = iter.next();
+        while (!next.done) {
+            var k = next.value;
+            if (k.startsWith(prefix)) {
+                keysToDelete.push(k);
+            }
+            next = iter.next();
+        }
+        for (var i = 0; i < keysToDelete.length; i++) {
+            var key = keysToDelete[i];
+            if (key !== undefined) {
+                this.store.delete(key);
+            }
+        }
+    }
+    // Inspect-only: total number of entries across all plugins. Useful
+    // in tests when asserting clearPlugin shrinks the store.
+    size() {
+        return this.store.size;
+    }
+    composeKey(pluginName, key) {
+        return pluginName + '::' + key;
+    }
+}
+// ----- ConsolePluginLogger -----
+//
+// Tags every line with `[plugin: <name>]` and forwards to the
+// matching console method. Meta is JSON-stringified and appended;
+// circular refs fall back to a short description so logging never
+// throws at the boundary.
+export class ConsolePluginLogger {
+    pluginName;
+    constructor(pluginName) {
+        this.pluginName = pluginName;
+    }
+    info(msg, meta) {
+        this.write('info', msg, meta);
+    }
+    warn(msg, meta) {
+        this.write('warn', msg, meta);
+    }
+    error(msg, meta) {
+        this.write('error', msg, meta);
+    }
+    write(level, msg, meta) {
+        var tag = '[plugin: ' + this.pluginName + ']';
+        var line = tag + ' ' + msg;
+        var metaStr = '';
+        if (meta) {
+            try {
+                metaStr = ' ' + JSON.stringify(meta);
+            }
+            catch {
+                metaStr = ' [meta-not-serializable]';
+            }
+        }
+        var out = line + metaStr;
+        if (level === 'info') {
+            console.info(out);
+        }
+        else if (level === 'warn') {
+            console.warn(out);
+        }
+        else {
+            console.error(out);
+        }
+    }
+}
+export function buildPluginContext(opts) {
+    var pluginName = opts.pluginName;
+    var logger = opts.logger ?? new ConsolePluginLogger(pluginName);
+    var storage = opts.storage.forPlugin(pluginName);
+    var getZonePeers = opts.getZonePeers ??
+        function () {
+            return [];
+        };
+    var getCharacterState = opts.getCharacterState ??
+        function (characterId) {
+            return {
+                characterId,
+                zone: '',
+                x: 0,
+                y: 0,
+                hp_current: 0,
+                hp_max: 0,
+            };
+        };
+    var getZoneState = opts.getZoneState ??
+        function () {
+            return new Map();
+        };
+    var now = opts.now ?? Date.now;
+    return {
+        getZonePeers,
+        getCharacterState,
+        getZoneState,
+        storage,
+        logger,
+        now,
+    };
+}
+//# sourceMappingURL=plugin-context.js.map

package/dist/director/ai/plugin-context.js.map

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

package/dist/director/ai/plugin.d.ts

@@ -0,0 +1,57 @@
+import type { DirectorEvent } from '../event-envelope.js';
+import type { ZoneEvent } from '../zone/zone-event-envelope.js';
+export type { ZoneEvent };
+export interface EmittedEvents {
+    characterEvents?: DirectorEvent[];
+    zoneEvents?: ZoneEvent[];
+}
+export interface PeerInfo {
+    characterId: string;
+    userId: string;
+    zone: string;
+    x: number;
+    y: number;
+    name: string | null;
+}
+export interface PlayerAction {
+    kind: 'damage' | 'interact' | 'speak' | 'use_item' | (string & {});
+    payload: Record<string, unknown>;
+}
+export interface CharacterState {
+    characterId: string;
+    zone: string;
+    x: number;
+    y: number;
+    hp_current: number;
+    hp_max: number;
+}
+export interface PluginStorage {
+    get(key: string): Promise<unknown | undefined>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export interface PluginLogger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface PluginContext {
+    getZonePeers(zoneId: string): ReadonlyArray<PeerInfo>;
+    getCharacterState(characterId: string): Readonly<CharacterState>;
+    getZoneState(zoneId: string): ReadonlyMap<string, unknown>;
+    storage: PluginStorage;
+    logger: PluginLogger;
+    now: () => number;
+}
+export interface IAIPlugin {
+    readonly name: string;
+    readonly version: string;
+    readonly priority: number;
+    onTick?(ctx: PluginContext): Promise<EmittedEvents>;
+    onPeerJoin?(ctx: PluginContext, peer: PeerInfo): Promise<EmittedEvents>;
+    onPeerLeave?(ctx: PluginContext, peer: PeerInfo): Promise<EmittedEvents>;
+    onZoneEnter?(ctx: PluginContext, peer: PeerInfo, fromZone: string | null): Promise<EmittedEvents>;
+    onPlayerAction?(ctx: PluginContext, peer: PeerInfo, action: PlayerAction): Promise<EmittedEvents>;
+    dispose?(): Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/director/ai/plugin.d.ts.map

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

package/dist/director/ai/plugin.js

@@ -0,0 +1,32 @@
+// IAIPlugin - server-side plugin SPI for the Director.
+//
+// Per LOOM-DIRECTOR-PROTOCOL-V2 Section 5: the engine no longer
+// hardcodes a single Anthropic flow. Consumers register any number of
+// IAIPlugin implementations against the AIPluginRegistry, and the
+// runtime dispatches lifecycle hooks (tick, peer join/leave, zone
+// enter, player action). Each hook returns EmittedEvents - either
+// per-character v1 envelopes, v2 zone events, or both.
+//
+// This module is server-only. The browser bundle never imports it.
+// It is exposed only via the `@sadhaka/loom-engine/server` entry
+// point so consumers can wire LLM-backed plugins (Anthropic, OpenAI,
+// local models, deterministic state machines, ...) on the Node side
+// while the browser engine stays small.
+//
+// `ZoneEvent` (LOOM-DIRECTOR-PROTOCOL-V2 §3) is defined in
+// `src/director/zone/zone-event-envelope.ts` (Track A, merged into
+// 0.14.0 alongside this module). The registry carries zone events
+// opaquely - it never dereferences fields beyond the discriminated
+// union - so the only consumer of the strict type is plugin authors
+// constructing ZoneEvent values in their hook returns.
+//
+// Spec invariants preserved:
+//   - All hooks are async; they return EmittedEvents.
+//   - Hooks not implemented by a plugin are simply omitted; the
+//     registry checks `typeof plugin.onX === 'function'` before call.
+//   - Plugins are pure-ish: given a context, they return events.
+//     State mutation is the engine's job (open question 8.2 resolved).
+//   - Plugin-direct event emission outside its returned EmittedEvents
+//     is not supported; the registry is the single funnel.
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/director/ai/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/director/ai/plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,gEAAgE;AAChE,sEAAsE;AACtE,kEAAkE;AAClE,kEAAkE;AAClE,kEAAkE;AAClE,uDAAuD;AACvD,EAAE;AACF,mEAAmE;AACnE,iEAAiE;AACjE,qEAAqE;AACrE,oEAAoE;AACpE,wCAAwC;AACxC,EAAE;AACF,2DAA2D;AAC3D,mEAAmE;AACnE,kEAAkE;AAClE,mEAAmE;AACnE,oEAAoE;AACpE,uDAAuD;AACvD,EAAE;AACF,6BAA6B;AAC7B,sDAAsD;AACtD,gEAAgE;AAChE,sEAAsE;AACtE,iEAAiE;AACjE,uEAAuE;AACvE,sEAAsE;AACtE,2DAA2D"}

package/dist/director/index.d.ts

@@ -0,0 +1,27 @@
+export type { EventEnvelope, DirectorEvent, DirectorEventType, DirectorEventDataMap, EventPriority, EncounterSpawnData, EncounterTickData, EncounterEndData, EncounterLootData, KnotContextData, KnotPaletteHex, KnotMood, VeBudgetUpdateData, VeilTier, SceneTransitionData, SceneTransitionKind, NarratorLineData, NarratorVoice, SystemHeartbeatData, SystemReplayCompleteData, SystemSnapshotRequiredData, MobSpec, BossSpec, DropSpec, } from './event-envelope.js';
+export { parseEnvelope, parseEnvelopeJson, priorityFor, EventEnvelopeParseError, } from './event-envelope.js';
+export type { IDirectorBridge, DirectorBridgeStatus, DirectorBridgeStats, } from './director-bridge.js';
+export { RESOURCE_DIRECTOR_BRIDGE, RESOURCE_KNOT_CONTEXT, } from './director-bridge.js';
+export { MockDirectorBridge } from './mock-director-bridge.js';
+export type { SSEDirectorBridgeOptions } from './sse-director-bridge.js';
+export { SSEDirectorBridge } from './sse-director-bridge.js';
+export type { KnotPaletteRgba } from './knot-context-resource.js';
+export { KnotContextResource } from './knot-context-resource.js';
+export type { DirectorEventLog } from './director-system.js';
+export { DirectorSystem, RESOURCE_DIRECTOR_LOG, createDirectorEventLog, } from './director-system.js';
+export type { DirectorEncounterSystemOptions } from './director-encounter-system.js';
+export { DirectorEncounterSystem } from './director-encounter-system.js';
+export type { ZoneEventEnvelope, ZoneEvent, ZoneEventType, ZoneEventDataMap, ZoneBossSpec, ZoneBossSpawnData, ZoneBossTickData, ZoneBossEndData, ZoneBossOutcome, ZoneBossHit, ZoneNarratorData, ZoneKnotData, ZoneStateData, ZoneSnapshotData, ZoneStateChange, } from './zone/zone-event-envelope.js';
+export { parseZoneEnvelope, parseZoneEnvelopeJson, priorityFor as zonePriorityFor, ZoneEventEnvelopeParseError, } from './zone/zone-event-envelope.js';
+export type { IZoneEventBridge, ZoneEventBridgeStatus, ZoneEventBridgeStats, } from './zone/zone-event-bridge.js';
+export { RESOURCE_ZONE_EVENT_BRIDGE } from './zone/zone-event-bridge.js';
+export { MockZoneBridge } from './zone/mock-zone-bridge.js';
+export type { SSEZoneBridgeOptions, SSEZoneBridgeEventSource, } from './zone/sse-zone-bridge.js';
+export { SSEZoneBridge } from './zone/sse-zone-bridge.js';
+export type { ZoneEventLog, ZoneEventLogEntry, } from './zone/zone-event-log.js';
+export { RESOURCE_ZONE_EVENT_LOG, ZONE_RING_SIZE, createZoneEventLog, getOrCreateZoneEntry, pushZoneEvent, } from './zone/zone-event-log.js';
+export type { DirectorZoneStateResource } from './zone/zone-state-resource.js';
+export { RESOURCE_DIRECTOR_ZONE_STATE, createDirectorZoneStateResource, getOrCreateZoneStateMap, applyZoneStateChanges, replaceZoneStateFromSnapshot, } from './zone/zone-state-resource.js';
+export type { ZoneEventSystemOptions } from './zone/zone-event-system.js';
+export { ZoneEventSystem } from './zone/zone-event-system.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/director/index.ts"],"names":[],"mappings":"AAaA,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,IAAI,eAAe,EAC9B,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/director/index.js

@@ -0,0 +1,26 @@
+// Director module barrel - re-exports the v1 (Phase 6) surface plus
+// the v2 (Phase 16) zone-event surface.
+//
+// v1 lives at the top level of src/director/. v2 lives under
+// src/director/zone/. Track B's AI Plugin SPI lives under
+// src/director/ai/ and is re-exported via @sadhaka/loom-engine/server,
+// not from here. We do not pull AI plugin types into this barrel so
+// the browser bundle stays small.
+//
+// Engine-level public re-exports happen in ../index.ts. Internal
+// callers can import from this barrel for convenience.
+export { parseEnvelope, parseEnvelopeJson, priorityFor, EventEnvelopeParseError, } from './event-envelope.js';
+export { RESOURCE_DIRECTOR_BRIDGE, RESOURCE_KNOT_CONTEXT, } from './director-bridge.js';
+export { MockDirectorBridge } from './mock-director-bridge.js';
+export { SSEDirectorBridge } from './sse-director-bridge.js';
+export { KnotContextResource } from './knot-context-resource.js';
+export { DirectorSystem, RESOURCE_DIRECTOR_LOG, createDirectorEventLog, } from './director-system.js';
+export { DirectorEncounterSystem } from './director-encounter-system.js';
+export { parseZoneEnvelope, parseZoneEnvelopeJson, priorityFor as zonePriorityFor, ZoneEventEnvelopeParseError, } from './zone/zone-event-envelope.js';
+export { RESOURCE_ZONE_EVENT_BRIDGE } from './zone/zone-event-bridge.js';
+export { MockZoneBridge } from './zone/mock-zone-bridge.js';
+export { SSEZoneBridge } from './zone/sse-zone-bridge.js';
+export { RESOURCE_ZONE_EVENT_LOG, ZONE_RING_SIZE, createZoneEventLog, getOrCreateZoneEntry, pushZoneEvent, } from './zone/zone-event-log.js';
+export { RESOURCE_DIRECTOR_ZONE_STATE, createDirectorZoneStateResource, getOrCreateZoneStateMap, applyZoneStateChanges, replaceZoneStateFromSnapshot, } from './zone/zone-state-resource.js';
+export { ZoneEventSystem } from './zone/zone-event-system.js';
+//# sourceMappingURL=index.js.map

package/dist/director/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/director/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,wCAAwC;AACxC,EAAE;AACF,6DAA6D;AAC7D,0DAA0D;AAC1D,uEAAuE;AACvE,oEAAoE;AACpE,kCAAkC;AAClC,EAAE;AACF,iEAAiE;AACjE,uDAAuD;AA6BvD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAoBzE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,IAAI,eAAe,EAC9B,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAK5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/director/zone/mock-zone-bridge.d.ts

@@ -0,0 +1,22 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+import { type IZoneEventBridge, type ZoneEventBridgeStatus, type ZoneEventBridgeStats } from './zone-event-bridge.js';
+export declare class MockZoneBridge implements IZoneEventBridge {
+    private queue;
+    private statusValue;
+    private readonly lastEventIdByZone;
+    private readonly statsValue;
+    start(): void;
+    stop(): void;
+    status(): ZoneEventBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(zone: string): number;
+    pollEvents(): ZoneEvent[];
+    stats(): Readonly<ZoneEventBridgeStats>;
+    enqueueIncoming(event: ZoneEvent): void;
+    enqueueIncomingJson(json: string): boolean;
+    enqueueAll(events: ReadonlyArray<ZoneEvent>): void;
+    bumpReconnect(): void;
+    setServerDrops(p1: number, p2: number): void;
+    pending(): number;
+}
+//# sourceMappingURL=mock-zone-bridge.d.ts.map

package/dist/director/zone/mock-zone-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-zone-bridge.d.ts","sourceRoot":"","sources":["../../../src/director/zone/mock-zone-bridge.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,cAAe,YAAW,gBAAgB;IACrD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAYzB;IAEF,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,qBAAqB;IAI/B,WAAW,IAAI,OAAO;IAItB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,UAAU,IAAI,SAAS,EAAE;IAOzB,KAAK,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAmBvC,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAavC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ1C,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI;IAQlD,aAAa,IAAI,IAAI;IAKrB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAM5C,OAAO,IAAI,MAAM;CAGlB"}

package/dist/director/zone/mock-zone-bridge.js

@@ -0,0 +1,107 @@
+// MockZoneBridge - in-memory v2 zone-event source for tests + offline
+// demos.
+//
+// Tests inject envelopes via enqueueIncoming() and let ZoneEventSystem
+// drain them. The demo path can also use this when running without a
+// backend connection. pollEvents() drains the queue in FIFO order.
+//
+// Tracks per-zone lastEventId so the IZoneEventBridge contract is
+// satisfied. Does not reconnect, does not validate envelopes when fed
+// objects directly - that's parseZoneEnvelope's job upstream of
+// enqueueIncoming(). enqueueIncomingJson() is a convenience that runs
+// the parser first and silently drops malformed payloads (mirrors how
+// SSEZoneBridge would handle a bad frame).
+import { parseZoneEnvelopeJson } from './zone-event-envelope.js';
+export class MockZoneBridge {
+    queue = [];
+    statusValue = 'idle';
+    lastEventIdByZone = new Map();
+    statsValue = {
+        eventsReceived: 0,
+        reconnects: 0,
+        outOfOrderEvents: 0,
+        serverDropsP1: 0,
+        serverDropsP2: 0,
+    };
+    start() {
+        this.statusValue = 'connected';
+    }
+    stop() {
+        this.statusValue = 'closed';
+    }
+    status() {
+        return this.statusValue;
+    }
+    isConnected() {
+        return this.statusValue === 'connected';
+    }
+    getLastEventId(zone) {
+        return this.lastEventIdByZone.get(zone) ?? 0;
+    }
+    pollEvents() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    stats() {
+        // Allocate the read-only view fresh each call so mutations after
+        // the call don't leak through. lastEventIdByZone is wrapped in a
+        // shallow clone; spec calls this rare so cost is fine.
+        return {
+            eventsReceived: this.statsValue.eventsReceived,
+            reconnects: this.statsValue.reconnects,
+            outOfOrderEvents: this.statsValue.outOfOrderEvents,
+            serverDropsP1: this.statsValue.serverDropsP1,
+            serverDropsP2: this.statsValue.serverDropsP2,
+            lastEventIdByZone: new Map(this.lastEventIdByZone),
+        };
+    }
+    // ----- Mock-only injection helpers -----
+    // Enqueue a parsed envelope as if the server pushed it. Out-of-order
+    // injection is allowed; the consumer's per-zone gap detection should
+    // handle it.
+    enqueueIncoming(event) {
+        this.queue.push(event);
+        this.statsValue.eventsReceived++;
+        const prev = this.lastEventIdByZone.get(event.zone_id) ?? 0;
+        if (event.id > prev) {
+            this.lastEventIdByZone.set(event.zone_id, event.id);
+        }
+        else {
+            this.statsValue.outOfOrderEvents++;
+        }
+    }
+    // Convenience: enqueue from a JSON string. Silently drops malformed
+    // payloads, matching the SSE bridge's parse-error behaviour.
+    enqueueIncomingJson(json) {
+        const ev = parseZoneEnvelopeJson(json);
+        if (!ev)
+            return false;
+        this.enqueueIncoming(ev);
+        return true;
+    }
+    // Convenience: bulk enqueue.
+    enqueueAll(events) {
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            if (e)
+                this.enqueueIncoming(e);
+        }
+    }
+    // Mock-only: simulate the server crediting a reconnect.
+    bumpReconnect() {
+        this.statsValue.reconnects++;
+    }
+    // Mock-only: simulate server-side drop counters from a heartbeat.
+    setServerDrops(p1, p2) {
+        this.statsValue.serverDropsP1 = p1;
+        this.statsValue.serverDropsP2 = p2;
+    }
+    // Inspect-only: how many events are buffered waiting for a poll.
+    pending() {
+        return this.queue.length;
+    }
+}
+//# sourceMappingURL=mock-zone-bridge.js.map

package/dist/director/zone/mock-zone-bridge.js.map

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

package/dist/director/zone/sse-zone-bridge.d.ts

@@ -0,0 +1,40 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+import { type IZoneEventBridge, type ZoneEventBridgeStatus, type ZoneEventBridgeStats } from './zone-event-bridge.js';
+export interface SSEZoneBridgeEventSource {
+    readonly readyState: number;
+    addEventListener(type: string, listener: (event: {
+        data?: unknown;
+    }) => void): void;
+    removeEventListener?(type: string, listener: (event: {
+        data?: unknown;
+    }) => void): void;
+}
+export interface SSEZoneBridgeOptions {
+    eventSource: SSEZoneBridgeEventSource;
+    characterId: string;
+    currentZone: () => string;
+    eventName?: string;
+    filterAtReceive?: boolean;
+}
+export declare class SSEZoneBridge implements IZoneEventBridge {
+    private readonly es;
+    private readonly characterId;
+    private readonly currentZone;
+    private readonly eventName;
+    private readonly filterAtReceive;
+    private listener;
+    private queue;
+    private statusValue;
+    private readonly lastEventIdByZone;
+    private readonly statsValue;
+    constructor(opts: SSEZoneBridgeOptions);
+    start(): void;
+    stop(): void;
+    status(): ZoneEventBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(zone: string): number;
+    pollEvents(): ZoneEvent[];
+    stats(): Readonly<ZoneEventBridgeStats>;
+    private handleRaw;
+}
+//# sourceMappingURL=sse-zone-bridge.d.ts.map

package/dist/director/zone/sse-zone-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-zone-bridge.d.ts","sourceRoot":"","sources":["../../../src/director/zone/sse-zone-bridge.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC5C,IAAI,CAAC;IACR,mBAAmB,CAAC,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC5C,IAAI,CAAC;CAGT;AAED,MAAM,WAAW,oBAAoB;IAInC,WAAW,EAAE,wBAAwB,CAAC;IAItC,WAAW,EAAE,MAAM,CAAC;IAMpB,WAAW,EAAE,MAAM,MAAM,CAAC;IAG1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAOD,qBAAa,aAAc,YAAW,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAE1C,OAAO,CAAC,QAAQ,CAAsD;IACtE,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAYzB;gBAEU,IAAI,EAAE,oBAAoB;IAWtC,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,qBAAqB;IAe/B,WAAW,IAAI,OAAO;IAItB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,UAAU,IAAI,SAAS,EAAE;IAOzB,KAAK,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAavC,OAAO,CAAC,SAAS;CA6BlB"}