screeps-connectivity 0.13.1 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 0.14.0
+
+### Minor Changes
+
+- 57a7e1d: Hide the connection ("server") password field for xxscreeps servers.
+
+  `screeps-connectivity` adds a `hasOfficialLike(version)` capability helper that
+  detects the `official-like` feature advertised at `/api/version`. The login
+  screens (web and desktop) now use it to hide the server-password field on
+  xxscreeps servers, where the screepsmod-auth connection password does not apply.
+
+### Patch Changes
+
+- 5d46b8e: Fix flag removal and color changes failing with "invalid shard" on multi-shard servers. `removeFlag` and `changeFlagColor` now accept and forward the current shard, matching the other room-scoped game endpoints.
+- 3b9b951: Revamp the public profile page (`/profile/<username>`):
+
+  - Header now mirrors the self Overview chrome — small badge, the player's name
+    as the title, and a compact GCL/GPL readout rendered as rounded chips bordered
+    in the rank color (teal / red).
+  - The "Last 7 days" stat block is now a dropdown (1 hour / 24 hours / 7 days);
+    the tiles refetch the user's public stats for the selected window.
+  - Stat tiles now render correctly on servers that return `/api/user/stats`
+    metrics as a single pre-summed total per interval, not just per-tick buckets
+    (`ApiUserStatsResponse.stats` widened to `number | bucket[]`).
+  - Cross-links between the two account views: the username on the self Overview
+    links to the public profile, and your own public profile links back to your
+    private Overview.
+  - The top-bar Overview button no longer appears active while a profile is open —
+    a profile is a separate view.
+
+- 79bd3d0: Add a read-only per-room overview page at `/room-overview/<shard>/<room>` (or
+  `/room-overview/<room>` on single-shard servers):
+
+  - Header with the room name, owner (badge + profile link, or "Unclaimed room"),
+    and a room minimap thumbnail that opens the live room view.
+  - The same seven stat tiles as the account Overview, summed over a selectable
+    interval (1 hour / 24 hours / 7 days).
+  - A history graph rendering the six per-bucket metrics (energy harvested,
+    construction, control, energy on creeps, creeps produced/lost) as
+    opacity-scaled dot strips.
+  - Entry points: a chart button next to each room name on the self Overview and
+    public Profile pages, plus a button in the in-game room view's left toolbar
+    (between the World Map and History buttons).
+  - `screeps-connectivity`: the existing `game.roomOverview` endpoint is now typed
+    with the new exported `ApiRoomOverviewResponse` (was `unknown`).
+
 ## 0.13.1
 
 ### Patch Changes

package/package.json

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

package/src/http/endpoints/game.ts

@@ -19,6 +19,7 @@ import type {
   ApiMarketOrdersResponse,
   ApiMarketMyOrdersResponse,
   ApiMarketStatsResponse,
+  ApiRoomOverviewResponse,
 } from '../../types/api.js'
 import { createPowerCreepsEndpoints, type PowerCreepsEndpoints } from './power-creeps.js'
 
@@ -28,7 +29,7 @@ export interface GameEndpoints {
   roomObjects(room: string, shard?: string | null): Promise<ApiRoomObjectsResponse>
   roomDecorations(room: string, shard?: string | null): Promise<ApiRoomDecorationsResponse>
   roomStatus(room: string, shard?: string | null): Promise<{ ok: number; status: string; novice?: string }>
-  roomOverview(room: string, interval?: number, shard?: string | null): Promise<unknown>
+  roomOverview(room: string, interval?: number, shard?: string | null): Promise<ApiRoomOverviewResponse>
   time(shard?: string | null): Promise<{ ok: number; time: number }>
   tick(): Promise<ApiGameTickResponse>
   worldSize(shard?: string | null): Promise<unknown>
@@ -37,8 +38,8 @@ export interface GameEndpoints {
   createFlag(room: string, x: number, y: number, name: string, color: number, secondaryColor: number, shard?: string | null): Promise<ApiCreateFlagResponse>
   genUniqueFlagName(): Promise<ApiGenUniqueFlagNameResponse>
   checkUniqueFlagName(name: string): Promise<ApiCheckUniqueFlagNameResponse>
-  changeFlagColor(room: string, name: string, color: number, secondaryColor: number): Promise<ApiChangeFlagColorResponse>
-  removeFlag(room: string, name: string): Promise<ApiRemoveFlagResponse>
+  changeFlagColor(room: string, name: string, color: number, secondaryColor: number, shard?: string | null): Promise<ApiChangeFlagColorResponse>
+  removeFlag(room: string, name: string, shard?: string | null): Promise<ApiRemoveFlagResponse>
   genUniqueObjectName(type: string, shard?: string | null): Promise<ApiGenUniqueObjectNameResponse>
   checkUniqueObjectName(type: string, name: string, shard?: string | null): Promise<ApiCheckUniqueObjectNameResponse>
   placeSpawn(room: string, x: number, y: number, name?: string, shard?: string | null): Promise<{ ok: number }>
@@ -88,8 +89,8 @@ export function createGameEndpoints(http: HttpClient, decorationsMock?: ApiRoomD
     createFlag: (room, x, y, name, color, secondaryColor, shard) => http.request('POST', '/api/game/create-flag', withShard({ room, x, y, name, color, secondaryColor }, shard)),
     genUniqueFlagName: () => http.request('POST', '/api/game/gen-unique-flag-name'),
     checkUniqueFlagName: (name) => http.request('POST', '/api/game/check-unique-flag-name', { name }),
-    changeFlagColor: (room, name, color, secondaryColor) => http.request('POST', '/api/game/change-flag-color', { room, name, color, secondaryColor }),
-    removeFlag: (room, name) => http.request('POST', '/api/game/remove-flag', { room, name }),
+    changeFlagColor: (room, name, color, secondaryColor, shard) => http.request('POST', '/api/game/change-flag-color', withShard({ room, name, color, secondaryColor }, shard)),
+    removeFlag: (room, name, shard) => http.request('POST', '/api/game/remove-flag', withShard({ room, name }, shard)),
     genUniqueObjectName: (type, shard) => http.request('POST', '/api/game/gen-unique-object-name', withShard({ type }, shard)),
     checkUniqueObjectName: (type, name, shard) => http.request('POST', '/api/game/check-unique-object-name', withShard({ type, name }, shard)),
     placeSpawn: (room, x, y, name, shard) => http.request('POST', '/api/game/place-spawn', withShard({ room, x, y, ...(name ? { name } : {}) }, shard)),

package/src/http/fetchServerVersion.ts

@@ -206,3 +206,16 @@ export function getXxscreepsModClientFeature(version: ServerVersion): XxscreepsM
 export function getDiscordFeature(version: ServerVersion): DiscordFeature | undefined {
   return getServerFeature<DiscordFeature>(version, 'discord')
 }
+
+/**
+ * Returns `true` when the server advertises the `official-like` feature — the
+ * marker xxscreeps servers publish at `/api/version`. Such servers do not
+ * implement the screepsmod-auth connection ("server") password, so the client
+ * can hide that field entirely.
+ *
+ * @example
+ * if (hasOfficialLike(version)) hideServerPasswordField()
+ */
+export function hasOfficialLike(version: ServerVersion): boolean {
+  return getServerFeature(version, 'official-like') !== undefined
+}

package/src/index.ts

@@ -42,9 +42,9 @@ export type {
   MapVisualEntry,
 } from './types/game.js'
 
-export { fetchServerVersion, fetchAuthModInfo, checkUsername, checkEmail, registerUser, fetchAuthMeWithToken, completeProviderRegistration, getServerFeature, getScreepsmodAuth, getXxscreepsModClientFeature, getDiscordFeature } from './http/fetchServerVersion.js'
+export { fetchServerVersion, fetchAuthModInfo, checkUsername, checkEmail, registerUser, fetchAuthMeWithToken, completeProviderRegistration, getServerFeature, getScreepsmodAuth, getXxscreepsModClientFeature, getDiscordFeature, hasOfficialLike } from './http/fetchServerVersion.js'
 export type { ApiAuthModInfoResponse } from './http/fetchServerVersion.js'
-export type { ApiAuthMeResponse, RoomHistoryChunk, ApiRoomDecorationsResponse, ApiRoomDecorationItem, ApiRoomDecorationDef, ApiRoomDecorationGraphic, ApiRoomDecorationActive, ApiUserOverviewResponse, ApiUserOverviewTotals, ApiUserRoomsResponse, ApiUserStatsResponse, ApiLeaderboardFindResponse, ApiUserMoneyHistoryResponse, ApiMarketOrder, ApiMarketOrdersIndexResponse, ApiMarketOrdersResponse, ApiMarketMyOrdersResponse, ApiMarketStat, ApiMarketStatsResponse, ApiPowerCreep, ApiPowerCreepsListResponse, ApiUserMessage, ApiUserMessagesListResponse, ApiUserMessagesIndexEntry, ApiUserMessagesIndexResponse, ApiUserMessagesUnreadCountResponse, ApiUserFindResponse } from './types/api.js'
+export type { ApiAuthMeResponse, RoomHistoryChunk, ApiRoomDecorationsResponse, ApiRoomDecorationItem, ApiRoomDecorationDef, ApiRoomDecorationGraphic, ApiRoomDecorationActive, ApiUserOverviewResponse, ApiUserOverviewTotals, ApiRoomOverviewResponse, ApiUserRoomsResponse, ApiUserStatsResponse, ApiLeaderboardFindResponse, ApiUserMoneyHistoryResponse, ApiMarketOrder, ApiMarketOrdersIndexResponse, ApiMarketOrdersResponse, ApiMarketMyOrdersResponse, ApiMarketStat, ApiMarketStatsResponse, ApiPowerCreep, ApiPowerCreepsListResponse, ApiUserMessage, ApiUserMessagesListResponse, ApiUserMessagesIndexEntry, ApiUserMessagesIndexResponse, ApiUserMessagesUnreadCountResponse, ApiUserFindResponse } from './types/api.js'
 export { ROOM_DECORATIONS_MOCK } from './mocks/roomDecorations.js'
 
 export { badgeToSvg } from './badge/index.js'

package/src/types/api.ts

@@ -46,6 +46,15 @@ export interface ApiUserOverviewResponse {
   statsMax?: number
 }
 
+/** Response of GET /api/game/room-overview?room=&interval=&shard=. `stats` holds per-stat time-series buckets over the requested interval (same metric keys as the account overview tiles); `owner` is absent for unowned rooms. */
+export interface ApiRoomOverviewResponse {
+  ok: number
+  owner?: { username: string; badge: import('./game.js').Badge } | null
+  stats?: Record<string, Array<{ value: number; endTime: number }>>
+  statsMax?: Record<string, number>
+  totals?: ApiUserOverviewTotals
+}
+
 /** Response of GET /api/user/rooms?id=<userId> — the rooms a user owns. Multishard servers key by shard; single-shard servers may return a flat list. */
 export interface ApiUserRoomsResponse {
   ok: number
@@ -271,10 +280,14 @@ export interface ApiUserFindResponse {
   }
 }
 
-/** Response of GET /api/user/stats?id=&interval=. `stats` maps a metric to per-tick buckets; consumers sum the bucket values over the interval. */
+/**
+ * Response of GET /api/user/stats?id=&interval=. `stats` maps a metric to
+ * either per-tick buckets (consumers sum the bucket values over the interval)
+ * or a single pre-summed total for the interval — servers differ on which.
+ */
 export interface ApiUserStatsResponse {
   ok: number
-  stats?: Record<string, Array<{ value: number; endTime?: number }>>
+  stats?: Record<string, number | Array<{ value: number; endTime?: number }>>
   statsMax?: Record<string, number>
 }