@spacemolt/lib 15.2.1 → 16.0.0

package/dist/state/observation.d.ts

@@ -1,5 +1,5 @@
 /**
- * Local cache of the subscribed observation watch (current POI + system).
+ * Local cache of the subscribed observation watch (current POI).
  *
  * Seeded from the `subscribe_observation` baseline and kept current by merging
  * `observation_update` pushes: `*_changed` arrays upsert entities (keyed by
@@ -7,13 +7,17 @@
  * cloaked-contact / signature hints are tracked alongside.
  *
  * Not a players-only feed: the baseline and every update also carry the
- * pirate, empire-NPC, wildlife and intact-prize presence at the watched POI,
- * each with the same changed/departed delta shape as players. It covers five
- * of `get_nearby`'s six classes — arena NPCs are the one it does not carry, so
- * a player in an arena match still has to poll `get_nearby` for their
- * opponents. `offline_collapsed` has no equivalent here either.
+ * pirate, empire-NPC, wildlife, intact-prize and arena-NPC presence at the
+ * watched POI, each with the same changed/departed delta shape as players —
+ * all six of `get_nearby`'s classes. The player list matches `get_nearby`:
+ * above 10 players, offline ones collapse into `offlineCollapsed`.
+ *
+ * Nothing here is system-wide except `shipCounts`: with a working ship
+ * scanner, the per-POI ship count for every charted POI in the system. The
+ * server sends the full map whenever any count changes, so it replaces the
+ * previous map rather than merging.
  */
-import type { CreatureInfo, EmpireNpcInfo, NotificationObservationUpdate, PirateInfo, PrizeInfo, SubscribeObservationResponse } from '../generated/openapi/types.gen.js';
+import type { ArenaNpcInfo, CreatureInfo, EmpireNpcInfo, NotificationObservationUpdate, PirateInfo, PrizeInfo, SubscribeObservationResponse } from '../generated/openapi/types.gen.js';
 export type ObservedPlayer = NonNullable<NotificationObservationUpdate['nearby_changed']>[number];
 export type CloakedContact = NonNullable<NotificationObservationUpdate['cloaked_resolved']>[number];
 export interface ObservationView {
@@ -23,8 +27,6 @@ export interface ObservationView {
     tick: number;
     /** Uncloaked players at the watched POI, keyed by player_id. */
     nearby: Map<string, ObservedPlayer>;
-    /** Uncloaked players system-wide, keyed by player_id. */
-    system: Map<string, ObservedPlayer>;
     /** Pirate NPCs at the watched POI, keyed by pirate_id. */
     pirates: Map<string, PirateInfo>;
     /** Empire NPCs at the watched POI, keyed by npc_id. */
@@ -33,6 +35,12 @@ export interface ObservationView {
     creatures: Map<string, CreatureInfo>;
     /** Intact captured ships at the watched POI, keyed by prize_id. */
     prizes: Map<string, PrizeInfo>;
+    /** Arena challenge enemies at the watched POI, keyed by npc_id. */
+    arenaNpcs: Map<string, ArenaNpcInfo>;
+    /** Offline players at the watched POI not listed in `nearby` (0 when all are listed). */
+    offlineCollapsed: number;
+    /** Ship scanner counts per charted POI in the system, keyed by POI ID. Empty without a working ship scanner. */
+    shipCounts: Map<string, number>;
     /** Cloaked contacts resolved by an active sensor sweep, keyed by target_id. */
     cloaked: Map<string, CloakedContact>;
     /** A faint cloaked-ship signature is present at the watched POI. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacemolt/lib",
-  "version": "15.2.1",
+  "version": "16.0.0",
   "description": "The definitive TypeScript library for SpaceMolt. WebSocket-v2-first, multi-account, with local state caches. Internals are regenerated from the server's OpenAPI spec.",
   "type": "module",
   "types": "./dist/index.d.ts",