ball2d 0.2.3 → 0.3.2-next.0

package/dist/types/room.d.ts

@@ -1,40 +1,40 @@
+import type { MatchXgRuntimeConfig, MatchXgRuntimeStatus } from './match-xg-runtime.js';
 import type { HostPlayer, HostScores, HostDiscProperties } from './player.js';
 import type { DiscPropertyPatch } from './disc.js';
 import type { MatchState } from './match-state.js';
 import type { AnnouncementStyle } from './announcement.js';
+import type { RoomHooks } from './room-hooks.js';
+import type { AtmospherePack, AtmospherePolicy, CommentaryCue, CommentaryGoalGeometry, CommentaryPlayerFact, CommentaryPlayerFactInput, CommentaryPolicy, CommentaryPolicyPatch } from './commentary.js';
+import type { MatchIntelligencePolicy, MatchIntelligencePolicyPatch, MatchIntelligenceRoleAssignment, MatchIntelligenceRoleInput, MatchIntelligenceSnapshot } from './match-intelligence.js';
 /** Public room contract: runtime classes and transport types are deliberately absent. */
-export interface Room {
+export interface Room extends RoomHooks {
     readonly roomId: string;
     readonly roomLink: string;
     readonly roomName: string;
     readonly signal: AbortSignal;
     readonly lastRecording: Blob | null;
-    onRecordingComplete?: (blob: Blob, reason: string) => void;
-    onRoomLink?: (url: string) => void;
-    onPlayerJoin?: (p: HostPlayer) => void;
-    onPlayerTeamChange?: (p: HostPlayer, byPlayer: HostPlayer | null) => void;
-    onPlayerMuteChange?: (p: HostPlayer, byPlayer: HostPlayer | null) => void;
-    onPlayerAdminChange?: (p: HostPlayer, byPlayer: HostPlayer | null) => void;
-    onGameStart?: (byPlayer: HostPlayer | null) => void;
-    onGameStop?: (byPlayer: HostPlayer | null) => void;
-    onTeamVictory?: (scores: HostScores) => void;
-    /** Legacy Ball2D callback; prefer onTeamVictory. */
-    onGameVictory?: (scores: HostScores) => void;
-    onGamePauseChange?: (paused: boolean) => void;
-    onGamePause?: (byPlayer: HostPlayer | null) => void;
-    onGameUnpause?: (byPlayer: HostPlayer | null) => void;
-    onPlayerLeave?: (p: HostPlayer) => void;
-    onPlayerKicked?: (p: HostPlayer, reason: string, ban: boolean, byPlayer: HostPlayer | null) => void;
-    onPlayerActivity?: (p: HostPlayer) => void;
-    onPlayerChat?: (p: HostPlayer, text: string) => boolean | void;
-    onPlayerBallKick?: (p: HostPlayer) => void;
-    onTeamGoal?: (team: 1 | 2) => void;
-    onPositionsReset?: () => void;
-    onStadiumChange?: (name: string, byPlayer: HostPlayer | null) => void;
-    onTeamsLockChange?: (locked: boolean, byPlayer: HostPlayer | null) => void;
-    onKickRateLimitSet?: (min: number, rate: number, burst: number, byPlayer: HostPlayer | null) => void;
-    onGameTick?: () => void;
-    onError?: (message: string) => void;
+    /** Host-local opt-in; preparation performs hashes outside the simulation loop. null disables. */
+    setMatchXgConfig(config: MatchXgRuntimeConfig | null): Promise<void>;
+    getMatchXgStatus(): MatchXgRuntimeStatus;
+    setCommentaryPolicy(patch: CommentaryPolicyPatch): Promise<void>;
+    getCommentaryPolicy(): CommentaryPolicy;
+    setMatchIntelligencePolicy(patch: MatchIntelligencePolicyPatch): Promise<void>;
+    getMatchIntelligencePolicy(): MatchIntelligencePolicy;
+    /** Replaces all explicit role assignments; [] clears them. Only current field players qualify. */
+    setMatchIntelligenceRoles(roles: readonly MatchIntelligenceRoleInput[]): Promise<void>;
+    getMatchIntelligenceRoles(): readonly MatchIntelligenceRoleAssignment[];
+    /** In-memory observations for this match, never persistent player statistics. */
+    getMatchIntelligenceSnapshot(): MatchIntelligenceSnapshot;
+    setPlayerCommentaryContext(id: number, facts: readonly CommentaryPlayerFactInput[] | null): Promise<void>;
+    getPlayerCommentaryContext(id: number): CommentaryPlayerFact[];
+    setCommentaryGeometry(goals: readonly CommentaryGoalGeometry[] | null): Promise<void>;
+    getCommentaryGeometry(): readonly CommentaryGoalGeometry[];
+    setCommentaryCatalog(cues: readonly CommentaryCue[] | null): Promise<void>;
+    getCommentaryCatalog(): readonly CommentaryCue[] | null;
+    setAtmospherePolicy(patch: Partial<AtmospherePolicy>): Promise<void>;
+    getAtmospherePolicy(): AtmospherePolicy;
+    setAtmospherePack(pack: AtmospherePack | null): Promise<void>;
+    getAtmospherePack(): AtmospherePack | null;
     getPlayerList(): HostPlayer[];
     getPlayer(id: number): HostPlayer | null;
     setTeamColors(team: number, angle: number, textColor: number, colors: number[]): Promise<void>;
@@ -49,18 +49,16 @@ export interface Room {
     clearBan(id: number): Promise<void>;
     clearBans(): Promise<void>;
     sendChat(text: string, targetId?: number | null): Promise<void>;
+    /** Literal text, up to 1,000 characters. RGB color 0x000000–0xffffff;
+     * null target broadcasts. Sound 0/1/2 is subject to recipient preferences. */
     sendAnnouncement(text: string, targetId?: number | null, color?: number | null, style?: AnnouncementStyle | null, sound?: number | null): Promise<void>;
     startGame(): Promise<void>;
     stopGame(): Promise<void>;
     pauseGame(paused: boolean): Promise<void>;
     setKickRateLimit(min?: number, rate?: number, burst?: number): Promise<void>;
-    /** Enable the wet-grass preset or restore dry ground; requires a stopped match. */
-    setSurfaceEnabled(enabled: boolean): Promise<void>;
     setPassword(password: string | null): Promise<void>;
     readonly requireVerification: boolean | null;
     setRequireVerification(required: boolean): Promise<void>;
-    /** Migration alias: Ball2D uses Turnstile, not Google's reCAPTCHA. */
-    setRequireRecaptcha(required: boolean): Promise<void>;
     setScoreLimit(limit: number): Promise<void>;
     setTimeLimit(minutes: number): Promise<void>;
     setDefaultStadium(name: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ball2d",
-  "version": "0.2.3",
+  "version": "0.3.2-next.0",
   "description": "Ball2D SDK for browser integration and API-key-authorized Node.js room hosting",
   "type": "module",
   "sideEffects": false,
@@ -32,6 +32,7 @@
     "url": "https://github.com/fillbyte/ball2d/issues"
   },
   "scripts": {
+    "test": "node --test scripts/*.test.mjs",
     "check": "node scripts/check.mjs",
     "check:docs": "node scripts/check-docs.mjs",
     "format:check": "prettier --check .",