ball2d 0.3.0 → 0.3.2-next.0

package/dist/types/room.d.ts

@@ -1,44 +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;
-    /** Runs only when a peer changes its accepted key state; prevInput is the previous authoritative bitmask. */
-    onPlayerInput?: (p: HostPlayer, prevInput: number) => void;
-    onPlayerChat?: (p: HostPlayer, text: string) => boolean | void;
-    /** Host-visible direct chat; return false to suppress delivery to both participants. */
-    onPlayerDirectChat?: (p: HostPlayer, recipient: 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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ball2d",
-  "version": "0.3.0",
+  "version": "0.3.2-next.0",
   "description": "Ball2D SDK for browser integration and API-key-authorized Node.js room hosting",
   "type": "module",
   "sideEffects": false,