screeps-connectivity 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.5.0
+
+### Minor Changes
+
+- 1e7161f: Add `http.game.roomHistory(room, time, shard?)` to `GameEndpoints` — handles both official server (path-based URL) and private server (query-param URL) automatically. `HistoryPlayer` in `screeps-client` is refactored to use this endpoint instead of a raw `fetch()` with manual token injection.
+
+## 0.4.0
+
+### Minor Changes
+
+- de4fd47: Add memory watch panel with live WebSocket subscriptions, persistent watchlist, temp creep watch, and inline editing.
+
+  `screeps-connectivity` gains `UserStore.subscribeMemory(path, shard?)` and a new `user:memory` event on `UserStoreEvents`. `screeps-client` adds a full Memory pane to the bottom bar: a persistent watchlist, a temporary per-creep watch triggered from the Eye button on the selection panel, a recursive type-aware `MemoryTree` with expand/collapse, insert-to-console, and inline leaf editing.
+
 ## 0.3.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "screeps-connectivity",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "license": "ISC",
   "type": "module",
   "repository": {

package/src/http/endpoints/game.ts

@@ -13,6 +13,7 @@ import type {
   ApiGenUniqueObjectNameResponse,
   ApiCheckUniqueObjectNameResponse,
   ApiGameTickResponse,
+  RoomHistoryChunk,
 } from '../../types/api.js'
 import { createPowerCreepsEndpoints, type PowerCreepsEndpoints } from './power-creeps.js'
 
@@ -39,6 +40,8 @@ export interface GameEndpoints {
   removeConstructionSite(room: string, ids: string[], shard?: string | null): Promise<{ ok: number }>
   addObjectIntent(id: string, room: string, name: string, intent: unknown, shard?: string | null): Promise<{ ok: number }>
   addGlobalIntent(name: string, intent: unknown): Promise<{ ok: number }>
+  /** Fetch a room history chunk. Pass shard for official multi-shard servers; omit for private servers. */
+  roomHistory(room: string, time: number, shard?: string | null): Promise<RoomHistoryChunk>
   setNotifyWhenAttacked(id: string, enabled: boolean): Promise<{ ok: number }>
   createInvader(room: string, x: number, y: number, size: number, type: string, boosted?: boolean): Promise<{ ok: number }>
   removeInvader(id: string): Promise<{ ok: number }>
@@ -85,6 +88,10 @@ export function createGameEndpoints(http: HttpClient): GameEndpoints {
     removeConstructionSite: (room, ids, shard) => http.request('POST', '/api/game/add-object-intent', withShard({ _id: 'room', room, name: 'removeConstructionSite', intent: ids.map(id => ({ id, roomName: room })) }, shard)),
     addObjectIntent: (id, room, name, intent, shard) => http.request('POST', '/api/game/add-object-intent', withShard({ _id: id, room, name, intent }, shard)),
     addGlobalIntent: (name, intent) => http.request('POST', '/api/game/add-global-intent', { name, intent }),
+    roomHistory: (room, time, shard) =>
+      shard
+        ? http.request('GET', `/room-history/${encodeURIComponent(shard)}/${encodeURIComponent(room)}/${time}.json`)
+        : http.request('GET', '/room-history', { room, time }),
     setNotifyWhenAttacked: (id, enabled) => http.request('POST', '/api/game/set-notify-when-attacked', { _id: id, enabled }),
     createInvader: (room, x, y, size, type, boosted) => http.request('POST', '/api/game/create-invader', { room, x, y, size, type, ...(boosted != null ? { boosted } : {}) }),
     removeInvader: (id) => http.request('POST', '/api/game/remove-invader', { _id: id }),

package/src/index.ts

@@ -39,6 +39,7 @@ export type {
 
 export { fetchServerVersion, fetchAuthModInfo, checkUsername, checkEmail, registerUser, getServerFeature, getScreepsmodAuth } from './http/fetchServerVersion.js'
 export type { ApiAuthModInfoResponse } from './http/fetchServerVersion.js'
+export type { RoomHistoryChunk } from './types/api.js'
 
 export { badgeToSvg } from './badge/index.js'
 export { BadgeColors } from './badge/colors.js'

package/src/types/api.ts

@@ -2,6 +2,13 @@ export interface ApiOkResponse {
   ok: number
 }
 
+export interface RoomHistoryChunk {
+  timestamp: number
+  room: string
+  base: number
+  ticks: Record<string, import('./game.js').RoomObjectDiff>
+}
+
 export interface ApiAuthSigninResponse {
   ok: number
   token: string

package/tests/http/endpoints/game.test.ts

@@ -207,4 +207,32 @@ describe('game endpoints', () => {
     expect(url).toContain('/api/game/tick')
     expect(res.tick).toBe(500)
   })
+
+  it('roomHistory uses path URL for official server (shard provided)', async () => {
+    const chunk = { timestamp: 1000, room: 'W1N1', base: 1000, ticks: {} }
+    fetchMock.mockResolvedValue(mockResponse(chunk))
+    const http = new HttpClient({ url: 'http://test.local', auth: new TokenAuth({ token: 't' }) })
+
+    const res = await http.game.roomHistory('W1N1', 1000, 'shard0')
+
+    const [url, init] = fetchMock.mock.calls[0] as [string, RequestInit]
+    expect(init.method).toBe('GET')
+    expect(url).toBe('http://test.local/room-history/shard0/W1N1/1000.json')
+    expect(res.base).toBe(1000)
+  })
+
+  it('roomHistory uses query params for private server (no shard)', async () => {
+    const chunk = { timestamp: 1000, room: 'W1N1', base: 1000, ticks: {} }
+    fetchMock.mockResolvedValue(mockResponse(chunk))
+    const http = new HttpClient({ url: 'http://test.local', auth: new TokenAuth({ token: 't' }) })
+
+    const res = await http.game.roomHistory('W1N1', 1000)
+
+    const [url, init] = fetchMock.mock.calls[0] as [string, RequestInit]
+    expect(init.method).toBe('GET')
+    expect(url).toMatch(/\/room-history/)
+    expect(url).toContain('room=W1N1')
+    expect(url).toContain('time=1000')
+    expect(res.base).toBe(1000)
+  })
 })