castle-web-cli 0.4.233 → 0.4.235

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 (383) 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 +266 -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 +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. 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.
@@ -1,12 +1,18 @@
1
1
  import { CastleError } from "./errors";
2
2
  import { hostRequest, setHubEventHandler } from "./transport";
3
+ import { HUB_FORBIDDEN_RETRY_MS, rejoinedRecently } from "./hubRejoin";
3
4
  export const Hub = {
4
5
  go,
5
6
  back,
6
7
  doors,
7
8
  friends,
9
+ invite,
10
+ canInvite,
11
+ inviteArrival,
12
+ undoInvite,
8
13
  hearts,
9
14
  setHearts,
15
+ signIn,
10
16
  jump,
11
17
  report,
12
18
  chat,
@@ -15,7 +21,7 @@ export const Hub = {
15
21
  cancel,
16
22
  onBack,
17
23
  };
18
- async function go(doorId) {
24
+ async function go(doorId, options = {}) {
19
25
  if (typeof doorId !== "string" || doorId.length === 0) {
20
26
  throw new CastleError({
21
27
  code: "INVALID_ARGUMENT",
@@ -23,7 +29,30 @@ async function go(doorId) {
23
29
  operation: "Hub.go",
24
30
  });
25
31
  }
26
- return hostRequest("hub.go", { doorId });
32
+ const ownerUserId = options?.ownerUserId;
33
+ if (ownerUserId !== undefined && (typeof ownerUserId !== "string" || !/^[1-9]\d{0,9}$/.test(ownerUserId))) {
34
+ throw new CastleError({
35
+ code: "INVALID_ARGUMENT",
36
+ message: "Hub.go ownerUserId must be a user id.",
37
+ operation: "Hub.go",
38
+ });
39
+ }
40
+ return untilListed(() => hostRequest("hub.go", ownerUserId === undefined ? { doorId } : { doorId, ownerUserId }));
41
+ }
42
+ // Right after the socket rejoined its session ghost may not list the player
43
+ // yet, and answers `forbidden` until it does. `Hub.cancel` ends the wait.
44
+ let cancels = 0;
45
+ async function untilListed(ask) {
46
+ const asked = cancels;
47
+ for (;;) {
48
+ const result = await ask();
49
+ if (result.status !== "forbidden" || !rejoinedRecently())
50
+ return result;
51
+ await new Promise((resolve) => setTimeout(resolve, HUB_FORBIDDEN_RETRY_MS));
52
+ if (cancels !== asked) {
53
+ return { status: "cancelled", url: null, nonce: null, sessionId: null, bundleHash: null, contentUrl: null };
54
+ }
55
+ }
27
56
  }
28
57
  async function back() {
29
58
  return hostRequest("hub.back", {});
@@ -34,6 +63,22 @@ async function doors() {
34
63
  async function friends() {
35
64
  return hostRequest("hub.friends", {});
36
65
  }
66
+ async function invite(options = {}) {
67
+ if (options.crew !== undefined && typeof options.crew !== "boolean")
68
+ throw new CastleError({ code: "INVALID_ARGUMENT", message: "Hub.invite crew must be a boolean.", operation: "Hub.invite" });
69
+ return hostRequest("hub.invite", options.crew !== false ? { crew: true } : {});
70
+ }
71
+ async function canInvite() {
72
+ return hostRequest("hub.canInvite", {});
73
+ }
74
+ async function inviteArrival() {
75
+ return hostRequest("hub.inviteArrival", {});
76
+ }
77
+ async function undoInvite(userId) {
78
+ if (!/^[1-9]\d{0,9}$/.test(userId))
79
+ throw new CastleError({ code: "INVALID_ARGUMENT", message: "Hub.undoInvite requires a userId.", operation: "Hub.undoInvite" });
80
+ return hostRequest("hub.undoInvite", { userId });
81
+ }
37
82
  async function hearts() {
38
83
  return hostRequest("hub.hearts", {});
39
84
  }
@@ -45,6 +90,23 @@ async function setHearts(doorIds) {
45
90
  }
46
91
  return hostRequest("hub.setHearts", { doorIds });
47
92
  }
93
+ const SIGN_IN_REASON_MAX_CHARACTERS = 200;
94
+ const SIGN_IN_REASON_MAX_BYTES = 512;
95
+ async function signIn(options) {
96
+ const reason = options?.reason;
97
+ if (typeof reason !== "string" ||
98
+ reason.length === 0 ||
99
+ reason.length > SIGN_IN_REASON_MAX_CHARACTERS ||
100
+ reason.includes("\0") ||
101
+ new TextEncoder().encode(reason).byteLength > SIGN_IN_REASON_MAX_BYTES) {
102
+ throw new CastleError({
103
+ code: "INVALID_ARGUMENT",
104
+ message: `Hub.signIn requires reason of at most ${SIGN_IN_REASON_MAX_CHARACTERS} characters and ${SIGN_IN_REASON_MAX_BYTES} bytes.`,
105
+ operation: "Hub.signIn",
106
+ });
107
+ }
108
+ return hostRequest("hub.signIn", { reason });
109
+ }
48
110
  async function jump(userId) {
49
111
  if (typeof userId !== "string" || userId.length === 0) {
50
112
  throw new CastleError({
@@ -53,7 +115,7 @@ async function jump(userId) {
53
115
  operation: "Hub.jump",
54
116
  });
55
117
  }
56
- return hostRequest("hub.jump", { userId });
118
+ return untilListed(() => hostRequest("hub.jump", { userId }));
57
119
  }
58
120
  async function report(userId, reason) {
59
121
  if (typeof userId !== "string" || userId.length === 0) {
@@ -78,7 +140,7 @@ async function say(text) {
78
140
  }
79
141
  return hostRequest("hub.say", { text });
80
142
  }
81
- async function reportChat(messageId) {
143
+ async function reportChat(messageId, options) {
82
144
  if (typeof messageId !== "string" || messageId.length === 0) {
83
145
  throw new CastleError({
84
146
  code: "INVALID_ARGUMENT",
@@ -86,9 +148,10 @@ async function reportChat(messageId) {
86
148
  operation: "Hub.reportChat",
87
149
  });
88
150
  }
89
- return hostRequest("hub.reportChat", { messageId });
151
+ return hostRequest("hub.reportChat", { messageId, ...(options?.block === true ? { block: true } : {}) });
90
152
  }
91
153
  async function cancel() {
154
+ cancels += 1;
92
155
  return hostRequest("hub.cancel", {});
93
156
  }
94
157
  const backListeners = new Set();
@@ -0,0 +1,4 @@
1
+ export declare const HUB_ROSTER_LAG_MS = 16000;
2
+ export declare const HUB_FORBIDDEN_RETRY_MS = 1000;
3
+ export declare function noteSessionRejoined(): void;
4
+ export declare function rejoinedRecently(): boolean;
@@ -0,0 +1,15 @@
1
+ // Ghost's source check for a door reads the session's heartbeat roster, which
2
+ // drops a player who was away and takes up to 15 s to list them again. The host
3
+ // waits that out after an arrival it saw; a socket that reconnected to the same
4
+ // session is one only the deck sees, so the deck waits it out itself.
5
+ export const HUB_ROSTER_LAG_MS = 16_000;
6
+ export const HUB_FORBIDDEN_RETRY_MS = 1_000;
7
+ let rejoinedAt = null;
8
+ // Monotonic where there is one: a wall-clock correction must not stretch or cut the wait.
9
+ const now = () => globalThis.performance?.now() ?? Date.now();
10
+ export function noteSessionRejoined() {
11
+ rejoinedAt = now();
12
+ }
13
+ export function rejoinedRecently() {
14
+ return rejoinedAt !== null && now() - rejoinedAt < HUB_ROSTER_LAG_MS;
15
+ }
@@ -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.