castle-web-cli 0.4.233 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (381) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +260 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -1,4 +1,4 @@
1
- import type { SaveClaimed, SaveClaimInput, SaveInitializeInput, SaveOpened, SaveOperation, SaveReadTarget, SaveReceipt, SaveSnapshot, SaveTransactionInput } from "./save";
1
+ import type { SaveClaimed, SaveConditionalWriteInput, SaveClaimInput, SaveInitializeInput, SaveOpened, SaveOperation, SaveReadTarget, SaveRecentOperationsInput, SaveRecentOperationsPage, SaveReceipt, SaveSnapshot, SaveTransactionInput } from "./save";
2
2
  import type { Json } from "./types";
3
3
  export declare const CASTLE_SDK_PROTOCOL = 1;
4
4
  export type StorageBlob = Record<string, string>;
@@ -84,8 +84,49 @@ export type PortalInfoResult = {
84
84
  export interface PortalPrefetchResult {
85
85
  status: PortalPrefetchStatus;
86
86
  }
87
+ /** One mutual Castle friend visible to a Cauldron deck. */
88
+ export interface SocialFriend {
89
+ userId: string;
90
+ username: string;
91
+ photoUrl?: string;
92
+ }
93
+ export interface SocialPresence extends SocialFriend {
94
+ sessionId: string;
95
+ routeId?: string;
96
+ slot?: string;
97
+ updatedAt: string;
98
+ }
99
+ export type PartyStatus = "invited" | "joined" | "rejected" | "left" | "party_closed" | "banned";
100
+ export interface PartySummary {
101
+ partyId: string;
102
+ name: string;
103
+ status: PartyStatus;
104
+ hasUnreadMessages: boolean;
105
+ }
106
+ export interface PartyMember extends SocialFriend {
107
+ status: PartyStatus;
108
+ role: "member" | "host" | "owner";
109
+ }
110
+ export interface PartyMessage {
111
+ id: string;
112
+ fromUserId: string;
113
+ fromUsername: string | null;
114
+ body: Json;
115
+ text: string | null;
116
+ createdAt: string;
117
+ }
118
+ export interface PartyMessagesResult {
119
+ messages: PartyMessage[];
120
+ cursor: string | null;
121
+ }
87
122
  export interface HubGoParams {
88
123
  doorId: string;
124
+ /**
125
+ * A House door only: visit this owner's House instead of the player's own.
126
+ * Ghost admits it only when the two are connected and the owner is home;
127
+ * a host that predates it ignores it and acquires the player's own House.
128
+ */
129
+ ownerUserId?: string;
89
130
  }
90
131
  export type HubPlacementKind = "layer" | "pad" | "exact";
91
132
  export type HubHandoffStatus = "ok" | "cancelled" | "full" | "unavailable" | "not_found" | "forbidden" | "party_required";
@@ -141,6 +182,12 @@ export interface HubFriend {
141
182
  * of its doors: that door's id. Null for a friend in a layer of this place.
142
183
  */
143
184
  door: string | null;
185
+ /**
186
+ * Present only for a friend inside their own House behind `door`: `home` is
187
+ * true and `ownerUserId` is the owner to pass to `Hub.go` to visit them.
188
+ */
189
+ home?: true;
190
+ ownerUserId?: string;
144
191
  }
145
192
  /** Hub.report: another player, by user id, and an optional short reason. */
146
193
  export interface HubReportParams {
@@ -150,6 +197,17 @@ export interface HubReportParams {
150
197
  /** `unavailable` on hosts without hub support or outside a hub session. */
151
198
  export interface HubReportResult {
152
199
  status: "ok" | "unavailable";
200
+ /** Present only when a chat sender was also blocked successfully. */
201
+ blocked?: true;
202
+ }
203
+ /** Why the hub is asking the player to replace an anonymous account. */
204
+ export interface HubSignInParams {
205
+ reason: string;
206
+ }
207
+ /** The outcome of the host-owned sign-in flow. */
208
+ export interface HubSignInResult {
209
+ status: "signedIn" | "dismissed" | "unavailable";
210
+ userId?: string;
153
211
  }
154
212
  export type HubFriendsResult = {
155
213
  status: "ok";
@@ -158,6 +216,45 @@ export type HubFriendsResult = {
158
216
  status: "unavailable";
159
217
  friends: null;
160
218
  };
219
+ export interface HubInviteResult {
220
+ status: "ok" | "unavailable";
221
+ url?: string;
222
+ expiresAt?: string;
223
+ }
224
+ /**
225
+ * Whether the host will make invite links for this player: Castle's invite
226
+ * rule for the account (signed in, over 13, in the invite audience), as the
227
+ * host resolved it. `unavailable` on hosts without hub support. With
228
+ * `canInvite: true`, `userId` names the account the links belong to (a guest's
229
+ * included), so a deck offers them only to the player that account plays as;
230
+ * older hosts leave it out.
231
+ */
232
+ export type HubCanInviteResult = {
233
+ status: "ok";
234
+ canInvite: boolean;
235
+ userId?: string;
236
+ } | {
237
+ status: "unavailable";
238
+ canInvite: false;
239
+ };
240
+ export interface HubInviteArrivalResult {
241
+ status: "ok" | "unavailable" | "route";
242
+ doorId?: string;
243
+ destination?: {
244
+ hub: {
245
+ version: 1;
246
+ townDeckId: string;
247
+ target: {
248
+ kind: "player";
249
+ id: string;
250
+ };
251
+ };
252
+ };
253
+ friends?: Array<{
254
+ userId: string;
255
+ username: string;
256
+ }>;
257
+ }
161
258
  /** Account-wide hub door hearts, in oldest-first order (at most eight). */
162
259
  export interface HubHeartsResult {
163
260
  status: "ok" | "unavailable";
@@ -213,6 +310,8 @@ export interface HubSayResult {
213
310
  /** Hub.reportChat: a message this player was returned, by its id. */
214
311
  export interface HubReportChatParams {
215
312
  messageId: string;
313
+ /** Also block the sender identified by the stored message. */
314
+ block?: boolean;
216
315
  }
217
316
  /** Public door row; destination identity and return tickets stay host-owned. */
218
317
  export interface HubDoor {
@@ -532,14 +631,51 @@ export interface CommandParams {
532
631
  "portal.info": {
533
632
  targetDeckId: string;
534
633
  };
634
+ "social.friends": Record<string, never>;
635
+ "social.presence": Record<string, never>;
636
+ "party.current": Record<string, never>;
637
+ "party.create": {
638
+ userIds: string[];
639
+ };
640
+ "party.invite": {
641
+ partyId: string;
642
+ userIds: string[];
643
+ };
644
+ "party.respond": {
645
+ partyId: string;
646
+ accept: boolean;
647
+ };
648
+ "party.members": {
649
+ partyId: string;
650
+ };
651
+ "party.leave": {
652
+ partyId: string;
653
+ };
654
+ "party.messages": {
655
+ partyId: string;
656
+ cursor?: string;
657
+ };
658
+ "party.say": {
659
+ partyId: string;
660
+ text: string;
661
+ };
535
662
  "hub.go": HubGoParams;
536
663
  "hub.back": Record<string, never>;
537
664
  "hub.doors": Record<string, never>;
538
665
  "hub.friends": Record<string, never>;
666
+ "hub.invite": {
667
+ crew?: boolean;
668
+ };
669
+ "hub.canInvite": Record<string, never>;
670
+ "hub.inviteArrival": Record<string, never>;
671
+ "hub.undoInvite": {
672
+ userId: string;
673
+ };
539
674
  "hub.hearts": Record<string, never>;
540
675
  "hub.setHearts": {
541
676
  doorIds: string[];
542
677
  };
678
+ "hub.signIn": HubSignInParams;
543
679
  "hub.jump": HubJumpParams;
544
680
  "hub.report": HubReportParams;
545
681
  "hub.chat": HubChatParams;
@@ -601,6 +737,8 @@ export interface CommandParams {
601
737
  "cauldronStorage.transaction": SaveTransactionInput;
602
738
  "cauldronStorage.claim": SaveClaimInput;
603
739
  "cauldronStorage.initialize": SaveInitializeInput;
740
+ "cauldronStorage.conditionalWrite": SaveConditionalWriteInput;
741
+ "cauldronStorage.recentOperations": SaveRecentOperationsInput;
604
742
  "cauldronStorage.operation": {
605
743
  operationId: string;
606
744
  };
@@ -706,12 +844,33 @@ export interface CommandResult {
706
844
  "portal.open": PortalOpenResult;
707
845
  "portal.prefetch": PortalPrefetchResult;
708
846
  "portal.info": PortalInfoResult;
847
+ "social.friends": SocialFriend[];
848
+ "social.presence": SocialPresence[];
849
+ "party.current": PartySummary | null;
850
+ "party.create": PartySummary;
851
+ "party.invite": {
852
+ ok: true;
853
+ };
854
+ "party.respond": {
855
+ ok: true;
856
+ };
857
+ "party.members": PartyMember[];
858
+ "party.leave": {
859
+ ok: true;
860
+ };
861
+ "party.messages": PartyMessagesResult;
862
+ "party.say": PartyMessage;
709
863
  "hub.go": HubGoResult;
710
864
  "hub.back": HubBackResult;
711
865
  "hub.doors": HubDoorsResult;
712
866
  "hub.friends": HubFriendsResult;
867
+ "hub.invite": HubInviteResult;
868
+ "hub.canInvite": HubCanInviteResult;
869
+ "hub.inviteArrival": HubInviteArrivalResult;
870
+ "hub.undoInvite": HubReportResult;
713
871
  "hub.hearts": HubHeartsResult;
714
872
  "hub.setHearts": HubHeartsResult;
873
+ "hub.signIn": HubSignInResult;
715
874
  "hub.jump": HubJumpResult;
716
875
  "hub.report": HubReportResult;
717
876
  "hub.chat": HubChatResult;
@@ -747,6 +906,8 @@ export interface CommandResult {
747
906
  "cauldronStorage.transaction": SaveReceipt;
748
907
  "cauldronStorage.claim": SaveClaimed;
749
908
  "cauldronStorage.initialize": SaveOpened;
909
+ "cauldronStorage.conditionalWrite": SaveReceipt;
910
+ "cauldronStorage.recentOperations": SaveRecentOperationsPage;
750
911
  "cauldronStorage.operation": SaveOperation;
751
912
  "cauldronStorage.get": {
752
913
  entries: StoreEntry[];
@@ -29,6 +29,9 @@ export const COMMAND_TIMEOUTS_MS = {
29
29
  "hub.go": 30_000,
30
30
  "hub.back": 30_000,
31
31
  "hub.jump": 30_000,
32
+ // Native auth may include a provider handoff, but it must not leave a deck
33
+ // waiting forever if the host loses the completion callback.
34
+ "hub.signIn": 120_000,
32
35
  };
33
36
  // Once a host streams a command, each stream envelope restarts the wait at this
34
37
  // length instead. The deck-agent service sends a heartbeat every 15 seconds, and the host
@@ -1,6 +1,9 @@
1
1
  export type DeckLayout = "card" | "fill";
2
+ export type DeckOrientation = "landscape" | "portrait" | "any";
2
3
  export interface DeckDisplay {
3
4
  layout: DeckLayout;
5
+ /** The orientation the deck prefers the host to use. */
6
+ orientation?: DeckOrientation;
4
7
  /** Narrowest width / height the deck accepts. */
5
8
  minAspect: number;
6
9
  /** Widest width / height the deck accepts. */
@@ -5,6 +5,7 @@
5
5
  //
6
6
  // <meta name="castle-display" content="layout=fill">
7
7
  // <meta name="castle-display" content="layout=fill, min-aspect=9/16, max-aspect=16/9">
8
+ // <meta name="castle-display" content="layout=fill, orientation=landscape">
8
9
  //
9
10
  // With no tag the deck is a `card`: the classic 5:7 portrait card, exactly as
10
11
  // before. A `fill` deck takes whatever box the host gives it, as long as the
@@ -42,13 +43,18 @@ export function parseDisplayContent(content) {
42
43
  continue;
43
44
  fields[part.slice(0, eq).trim().toLowerCase()] = part.slice(eq + 1).trim();
44
45
  }
45
- if (fields.layout?.toLowerCase() !== "fill")
46
- return CARD_DISPLAY;
46
+ const declaredOrientation = fields.orientation?.toLowerCase();
47
+ const orientation = declaredOrientation === "landscape" || declaredOrientation === "portrait"
48
+ ? declaredOrientation
49
+ : "any";
50
+ if (fields.layout?.toLowerCase() !== "fill") {
51
+ return orientation === "any" ? CARD_DISPLAY : { ...CARD_DISPLAY, orientation };
52
+ }
47
53
  let minAspect = parseAspect(fields["min-aspect"] ?? "") ?? FILL_MIN_ASPECT;
48
54
  let maxAspect = parseAspect(fields["max-aspect"] ?? "") ?? FILL_MAX_ASPECT;
49
55
  if (minAspect > maxAspect)
50
56
  [minAspect, maxAspect] = [maxAspect, minAspect];
51
- return { layout: "fill", minAspect, maxAspect };
57
+ return { layout: "fill", orientation, minAspect, maxAspect };
52
58
  }
53
59
  let cached = null;
54
60
  /** The display this deck declared in its index.html (a card when it declared none). */
@@ -1,5 +1,5 @@
1
- import type { HubBackResult, HubCancelResult, HubChatResult, HubDoorsResult, HubFriendsResult, HubHeartsResult, HubGoResult, HubJumpResult, HubReportResult, HubSayResult } from "./commands";
2
- export type { HubBackResult, HubCancelResult, HubCancelStatus, HubChatMessage, HubChatResult, HubDoor, HubDoorsResult, HubFriend, HubFriendsResult, HubHeartsResult, HubGoParams, HubGoResult, HubHandoffResult, HubHandoffStatus, HubJumpResult, HubPlacementKind, HubReportResult, HubSayResult, } from "./commands";
1
+ import type { HubBackResult, HubCancelResult, HubChatResult, HubDoorsResult, HubFriendsResult, HubInviteResult, HubCanInviteResult, HubInviteArrivalResult, HubHeartsResult, HubGoResult, HubJumpResult, HubReportResult, HubSayResult, HubSignInResult } from "./commands";
2
+ export type { HubBackResult, HubCancelResult, HubCancelStatus, HubChatMessage, HubChatResult, HubDoor, HubDoorsResult, HubFriend, HubFriendsResult, HubInviteResult, HubCanInviteResult, HubInviteArrivalResult, HubHeartsResult, HubGoParams, HubGoResult, HubHandoffResult, HubHandoffStatus, HubJumpResult, HubPlacementKind, HubReportResult, HubSayResult, HubSignInParams, HubSignInResult, } from "./commands";
3
3
  /**
4
4
  * Doors between hub places. Every hub-kit deck is a place; ghost's door table
5
5
  * is the allowlist, and the host supplies real authentication and the current
@@ -17,9 +17,13 @@ export interface CastleHubApi {
17
17
  /**
18
18
  * Acquire the destination behind a door of the current place. A door used
19
19
  * within seconds of arriving may take up to 15 s while ghost catches up with
20
- * the arrival. `unavailable` on hosts without hub support.
20
+ * the arrival. `unavailable` on hosts without hub support. `ownerUserId`
21
+ * (a House door only) visits that friend's House, as `Hub.friends()` names
22
+ * it; a host that predates it acquires the player's own House instead.
21
23
  */
22
- go(doorId: string): Promise<HubGoResult>;
24
+ go(doorId: string, options?: {
25
+ ownerUserId?: string;
26
+ }): Promise<HubGoResult>;
23
27
  /**
24
28
  * Acquire the way back through the door this player came in by: the layer
25
29
  * left behind if it has room, else the party's, else the usual pick. The deck
@@ -35,10 +39,29 @@ export interface CastleHubApi {
35
39
  * on hosts without hub support.
36
40
  */
37
41
  friends(): Promise<HubFriendsResult>;
42
+ /** Create an expiring link from this hub session. Links admit up to five invitees by default. */
43
+ invite(options?: {
44
+ crew?: boolean;
45
+ }): Promise<HubInviteResult>;
46
+ /**
47
+ * Whether `invite` can make a link for this player: Castle's invite rule for
48
+ * the account, as the host resolved it. Ask before offering an invite;
49
+ * `unavailable` on hosts without hub support, and a host older than this
50
+ * command rejects it, so treat anything but `canInvite: true` as no.
51
+ */
52
+ canInvite(): Promise<HubCanInviteResult>;
53
+ /** Hub-kit arrival hook: the trusted host retains the invite token. */
54
+ inviteArrival(): Promise<HubInviteArrivalResult>;
55
+ /** Undo both follow directions for one pair from this host's invite arrival. */
56
+ undoInvite(userId: string): Promise<HubReportResult>;
38
57
  /** Read this signed-in account's hub door hearts. */
39
58
  hearts(): Promise<HubHeartsResult>;
40
59
  /** Replace the hearts, oldest first, at most eight distinct door ids. */
41
60
  setHearts(doorIds: string[]): Promise<HubHeartsResult>;
61
+ /** Ask the host to let an anonymous player sign in to a permanent account. */
62
+ signIn(options: {
63
+ reason: string;
64
+ }): Promise<HubSignInResult>;
42
65
  /**
43
66
  * Acquire the layer of this place a friend is in. The destination is this
44
67
  * same place in another session; join it exactly like a door's
@@ -70,10 +93,14 @@ export interface CastleHubApi {
70
93
  say(text: string): Promise<HubSayResult>;
71
94
  /**
72
95
  * Report a chat message this player was returned to Castle's moderators, by
73
- * its id. Hub chrome only: the host fills in the place and session.
96
+ * its id. Pass `{ block: true }` to also block the stored sender; only a
97
+ * result with `blocked: true` confirms that block. Hub chrome only:
98
+ * the host fills in the place and session.
74
99
  * `unavailable` on hosts without hub support or outside a hub session.
75
100
  */
76
- reportChat(messageId: string): Promise<HubReportResult>;
101
+ reportChat(messageId: string, options?: {
102
+ block?: boolean;
103
+ }): Promise<HubReportResult>;
77
104
  /**
78
105
  * Abandon an acquisition the deck will not join (its content failed to load,
79
106
  * the player walked away). Optional: an unjoined one expires on its own.
@@ -5,8 +5,13 @@ export const Hub = {
5
5
  back,
6
6
  doors,
7
7
  friends,
8
+ invite,
9
+ canInvite,
10
+ inviteArrival,
11
+ undoInvite,
8
12
  hearts,
9
13
  setHearts,
14
+ signIn,
10
15
  jump,
11
16
  report,
12
17
  chat,
@@ -15,7 +20,7 @@ export const Hub = {
15
20
  cancel,
16
21
  onBack,
17
22
  };
18
- async function go(doorId) {
23
+ async function go(doorId, options = {}) {
19
24
  if (typeof doorId !== "string" || doorId.length === 0) {
20
25
  throw new CastleError({
21
26
  code: "INVALID_ARGUMENT",
@@ -23,7 +28,15 @@ async function go(doorId) {
23
28
  operation: "Hub.go",
24
29
  });
25
30
  }
26
- return hostRequest("hub.go", { doorId });
31
+ const ownerUserId = options?.ownerUserId;
32
+ if (ownerUserId !== undefined && (typeof ownerUserId !== "string" || !/^[1-9]\d{0,9}$/.test(ownerUserId))) {
33
+ throw new CastleError({
34
+ code: "INVALID_ARGUMENT",
35
+ message: "Hub.go ownerUserId must be a user id.",
36
+ operation: "Hub.go",
37
+ });
38
+ }
39
+ return hostRequest("hub.go", ownerUserId === undefined ? { doorId } : { doorId, ownerUserId });
27
40
  }
28
41
  async function back() {
29
42
  return hostRequest("hub.back", {});
@@ -34,6 +47,22 @@ async function doors() {
34
47
  async function friends() {
35
48
  return hostRequest("hub.friends", {});
36
49
  }
50
+ async function invite(options = {}) {
51
+ if (options.crew !== undefined && typeof options.crew !== "boolean")
52
+ throw new CastleError({ code: "INVALID_ARGUMENT", message: "Hub.invite crew must be a boolean.", operation: "Hub.invite" });
53
+ return hostRequest("hub.invite", options.crew !== false ? { crew: true } : {});
54
+ }
55
+ async function canInvite() {
56
+ return hostRequest("hub.canInvite", {});
57
+ }
58
+ async function inviteArrival() {
59
+ return hostRequest("hub.inviteArrival", {});
60
+ }
61
+ async function undoInvite(userId) {
62
+ if (!/^[1-9]\d{0,9}$/.test(userId))
63
+ throw new CastleError({ code: "INVALID_ARGUMENT", message: "Hub.undoInvite requires a userId.", operation: "Hub.undoInvite" });
64
+ return hostRequest("hub.undoInvite", { userId });
65
+ }
37
66
  async function hearts() {
38
67
  return hostRequest("hub.hearts", {});
39
68
  }
@@ -45,6 +74,23 @@ async function setHearts(doorIds) {
45
74
  }
46
75
  return hostRequest("hub.setHearts", { doorIds });
47
76
  }
77
+ const SIGN_IN_REASON_MAX_CHARACTERS = 200;
78
+ const SIGN_IN_REASON_MAX_BYTES = 512;
79
+ async function signIn(options) {
80
+ const reason = options?.reason;
81
+ if (typeof reason !== "string" ||
82
+ reason.length === 0 ||
83
+ reason.length > SIGN_IN_REASON_MAX_CHARACTERS ||
84
+ reason.includes("\0") ||
85
+ new TextEncoder().encode(reason).byteLength > SIGN_IN_REASON_MAX_BYTES) {
86
+ throw new CastleError({
87
+ code: "INVALID_ARGUMENT",
88
+ message: `Hub.signIn requires reason of at most ${SIGN_IN_REASON_MAX_CHARACTERS} characters and ${SIGN_IN_REASON_MAX_BYTES} bytes.`,
89
+ operation: "Hub.signIn",
90
+ });
91
+ }
92
+ return hostRequest("hub.signIn", { reason });
93
+ }
48
94
  async function jump(userId) {
49
95
  if (typeof userId !== "string" || userId.length === 0) {
50
96
  throw new CastleError({
@@ -78,7 +124,7 @@ async function say(text) {
78
124
  }
79
125
  return hostRequest("hub.say", { text });
80
126
  }
81
- async function reportChat(messageId) {
127
+ async function reportChat(messageId, options) {
82
128
  if (typeof messageId !== "string" || messageId.length === 0) {
83
129
  throw new CastleError({
84
130
  code: "INVALID_ARGUMENT",
@@ -86,7 +132,7 @@ async function reportChat(messageId) {
86
132
  operation: "Hub.reportChat",
87
133
  });
88
134
  }
89
- return hostRequest("hub.reportChat", { messageId });
135
+ return hostRequest("hub.reportChat", { messageId, ...(options?.block === true ? { block: true } : {}) });
90
136
  }
91
137
  async function cancel() {
92
138
  return hostRequest("hub.cancel", {});
@@ -4,7 +4,7 @@ import type { Json } from "./types";
4
4
  import { type MultiplayerPlayer, type MultiplayerCharacterDisclosure, type MultiplayerCharacterTurnStatus } from "./multiplayerProtocol";
5
5
  import { type MultiplayerVoice } from "./multiplayerVoice";
6
6
  export type { MultiplayerJoinHint } from "./commands";
7
- export type MultiplayerJoinOptions = {
7
+ export type MultiplayerJoinOptions = ({
8
8
  mode: "named";
9
9
  key: string;
10
10
  } | {
@@ -14,6 +14,9 @@ export type MultiplayerJoinOptions = {
14
14
  } | {
15
15
  mode: "hub";
16
16
  handoff: HubHandoffResult;
17
+ }) & {
18
+ /** Experimental opt-in: reconnect if a keepalive ping receives no pong. */
19
+ pongTimeoutMs?: number;
17
20
  };
18
21
  export interface MultiplayerDestinationOptions {
19
22
  routeId: string;
@@ -184,6 +187,9 @@ export interface MultiplayerConnection {
184
187
  readonly state: MultiplayerConnectionState;
185
188
  readonly playerId: string;
186
189
  readonly sessionId: string;
190
+ /** Current host publication diagnostics; null when unavailable or not connected. */
191
+ readonly serverBundleSha256: string | null;
192
+ readonly serverBundleId: string | null;
187
193
  readonly isSolo: boolean;
188
194
  /**
189
195
  * Why the join fell back to solo; null while multiplayer is live.