castle-web-cli 0.4.232 → 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 (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -41,8 +41,18 @@ export interface CastleJson {
41
41
  devDecks?: Record<string, string>;
42
42
  experiments?: Record<string, ExperimentConfig>;
43
43
  devExperiments?: Record<string, string>;
44
+ bundle?: {
45
+ chunks?: 'classic';
46
+ };
44
47
  [key: string]: unknown;
45
48
  }
49
+ /**
50
+ * Whether this deck publishes a classic chunked bundle: castle.json
51
+ * `"bundle": { "chunks": "classic" }` or the save's own `--chunked-bundle`.
52
+ * Throws on a `bundle` block it does not understand, rather than quietly
53
+ * publishing something the deck did not ask for.
54
+ */
55
+ export declare function resolveBundleChunks(castleJson: CastleJson | null, flag?: boolean): boolean;
46
56
  export interface ExperimentConfig {
47
57
  variants: string[];
48
58
  weights?: number[];
@@ -105,15 +115,26 @@ export interface ResolvedServerConfig {
105
115
  * What ghost keeps of castle.json `hub` (the hub contract's place manifest): each
106
116
  * place's title and declared result shape. Ghost normalizes and validates it and
107
117
  * pins it to the place's sessions, so a session's results are checked against
108
- * what was published rather than what its code says. Every other field of the
109
- * block is the kit's and stays out of the bundle config.
118
+ * what was published rather than what its code says. The deck-wide `unlocks`
119
+ * list and optional analytics opt-in go too (below). Every other field is the kit's and stays
120
+ * out of the bundle config.
110
121
  */
111
122
  export interface ServerHubPlaceConfig {
123
+ push?: {
124
+ version: 1;
125
+ };
112
126
  title?: unknown;
113
127
  result?: unknown;
128
+ maxDurationSec?: unknown;
114
129
  }
115
130
  export interface ServerHubConfig extends ServerHubPlaceConfig {
131
+ analytics?: boolean;
132
+ analyticsV111?: boolean;
133
+ fpsTelemetry?: unknown;
134
+ bringFriend?: true;
135
+ invite?: true;
116
136
  places?: Record<string, ServerHubPlaceConfig>;
137
+ unlocks?: unknown;
117
138
  }
118
139
  export declare function resolveServerConfig(dir: string): ResolvedServerConfig | null;
119
140
  export declare function deckStarterScene(dir: string): string;
@@ -25,6 +25,28 @@ export const IMPORTS_DIR = 'imports';
25
25
  // Defined here rather than in imports.ts so forks.ts can name it without a
26
26
  // cycle.
27
27
  export const IMPORT_VERSION_FILE = '.castle-import-version.json';
28
+ /**
29
+ * Whether this deck publishes a classic chunked bundle: castle.json
30
+ * `"bundle": { "chunks": "classic" }` or the save's own `--chunked-bundle`.
31
+ * Throws on a `bundle` block it does not understand, rather than quietly
32
+ * publishing something the deck did not ask for.
33
+ */
34
+ export function resolveBundleChunks(castleJson, flag = false) {
35
+ const block = castleJson?.bundle;
36
+ if (block !== undefined) {
37
+ if (block === null || typeof block !== 'object' || Array.isArray(block)) {
38
+ throw new Error('castle.json "bundle" must be an object, like { "chunks": "classic" }.');
39
+ }
40
+ for (const key of Object.keys(block)) {
41
+ if (key !== 'chunks')
42
+ throw new Error(`castle.json "bundle" has an unknown key "${key}" (use chunks).`);
43
+ }
44
+ if (block.chunks !== undefined && block.chunks !== 'classic') {
45
+ throw new Error(`castle.json "bundle.chunks" must be "classic"; got ${JSON.stringify(block.chunks)}.`);
46
+ }
47
+ }
48
+ return flag || block?.chunks === 'classic';
49
+ }
28
50
  export const EXPERIMENTS_CAP = 8;
29
51
  export const EXPERIMENT_VARIANTS_MIN = 2;
30
52
  export const EXPERIMENT_VARIANTS_CAP = 8;
@@ -168,8 +190,9 @@ export function resolveServerConfig(dir) {
168
190
  ...(castleJson?.hub === undefined ? {} : { hub: serverHubConfig(castleJson.hub) }),
169
191
  };
170
192
  }
171
- // Never throws: `serve` and `check` resolve this too, and the hub block is
172
- // checked by the kit at publish and by ghost when it is saved. A block that is
193
+ // `serve` and `check` resolve this too, and the hub block is
194
+ // checked by the kit at publish and by ghost when it is saved. Invalid push capability
195
+ // keys are refused here; other blocks that are
173
196
  // not the shape reduced here goes to ghost as written, for ghost to refuse.
174
197
  function serverHubConfig(value) {
175
198
  if (!isPlainObject(value))
@@ -183,14 +206,35 @@ function serverHubConfig(value) {
183
206
  ]))
184
207
  : value.places;
185
208
  }
209
+ if (value.unlocks !== undefined)
210
+ hub.unlocks = value.unlocks;
211
+ if (typeof value.analytics === 'boolean')
212
+ hub.analytics = value.analytics;
213
+ // New routing capability is server-only and absent from existing invite-only bundles.
214
+ if (value.bringFriend === true) {
215
+ hub.bringFriend = true;
216
+ if (value.invite === true)
217
+ hub.invite = true;
218
+ }
219
+ if (value.fpsTelemetry !== undefined)
220
+ hub.fpsTelemetry = value.fpsTelemetry;
221
+ if (typeof value.analyticsV111 === 'boolean')
222
+ hub.analyticsV111 = value.analyticsV111;
186
223
  return hub;
187
224
  }
188
225
  function hubPlaceConfig(place) {
189
226
  return {
227
+ ...(place.push === undefined ? {} : { push: pushConfig(place.push) }),
190
228
  ...(place.title === undefined ? {} : { title: place.title }),
191
229
  ...(place.result === undefined ? {} : { result: place.result }),
230
+ ...(place.maxDurationSec === undefined ? {} : { maxDurationSec: place.maxDurationSec }),
192
231
  };
193
232
  }
233
+ function pushConfig(value) {
234
+ if (!isPlainObject(value) || Object.keys(value).join(',') !== 'version' || value.version !== 1)
235
+ throw new Error('hub.push must be { version: 1 } or absent.');
236
+ return { version: 1 };
237
+ }
194
238
  function validateServerDestinations(value) {
195
239
  if (!Array.isArray(value) || value.length > SERVER_DESTINATIONS_CAP) {
196
240
  throw new Error(`server.destinations must be an array of at most ${SERVER_DESTINATIONS_CAP} routes.`);
package/dist/check.d.ts CHANGED
@@ -1 +1,3 @@
1
- export declare function check(dir: string): Promise<void>;
1
+ export declare function check(dir: string, opts?: {
2
+ pinInstalledImports?: boolean;
3
+ }): Promise<void>;
package/dist/check.js CHANGED
@@ -1,8 +1,10 @@
1
1
  import * as fs from 'fs';
2
2
  import * as path from 'path';
3
- import { bundleProject } from './bundle.js';
4
- import { readCastleJson, resolveServerConfig, validateExperiments } from './castleJson.js';
3
+ import { bundleProject, bundleProjectChunked } from './bundle.js';
4
+ import { isSandboxEnv } from './cloudGit.js';
5
+ import { readCastleJson, resolveBundleChunks, resolveServerConfig, validateExperiments } from './castleJson.js';
5
6
  import { importChecksFailedMessage, runImportChecks } from './importCheckHook.js';
7
+ import { settleImportPins } from './importPinMismatch.js';
6
8
  import { buildServerBundle } from './serverBundle.js';
7
9
  import { buildContentPack } from './contentPack.js';
8
10
  // `castle-web check` -- do this deck and its authoritative server still build?
@@ -17,15 +19,30 @@ import { buildContentPack } from './contentPack.js';
17
19
  // rules a kit holds the decks built on it to, which no bundler can see. Those
18
20
  // gate `save-deck` the same way (importCheckHook.ts). Then the content pack, when
19
21
  // an import exports one (contentPack.ts).
20
- export async function check(dir) {
22
+ export async function check(dir, opts = {}) {
21
23
  const deckDir = path.resolve(dir);
22
24
  if (!fs.existsSync(path.join(deckDir, 'index.html'))) {
23
25
  console.error(`No index.html in ${deckDir} -- is this a deck?`);
24
26
  process.exit(1);
25
27
  }
28
+ // The same refusal `save-deck` makes: imports/ at other versions than pinned.
29
+ // In a cloud sandbox, as in a cloud save, it is a warning: an agent's check of
30
+ // a deck nobody touched there must not start failing over it.
31
+ if (!settleImportPins(deckDir, dir, 'check', opts.pinInstalledImports === true)) {
32
+ if (!isSandboxEnv(process.env))
33
+ process.exit(1);
34
+ console.error('Checking anyway (cloud sandbox).');
35
+ }
26
36
  try {
27
37
  await bundleProject(deckDir);
28
38
  console.log('Bundle OK.');
39
+ // A deck that publishes chunks (castle.json `bundle.chunks`) is checked the way it saves.
40
+ if (resolveBundleChunks(readCastleJson(deckDir))) {
41
+ const chunked = await bundleProjectChunked(deckDir);
42
+ for (const warning of chunked.warnings)
43
+ console.warn(`Warning: ${warning}`);
44
+ console.log(`Chunked bundle OK (${chunked.chunks.length} chunks).`);
45
+ }
29
46
  if (resolveServerConfig(deckDir)) {
30
47
  const serverBundle = await buildServerBundle(deckDir);
31
48
  if (!serverBundle)
@@ -0,0 +1,3 @@
1
+ /** Chunk name -> [url, names of the chunks it statically requires]. */
2
+ export type ChunkMap = Record<string, [string, string[]]>;
3
+ export declare function castleChunkBoot(map: ChunkMap, entry: string, statics: string[]): void;
@@ -0,0 +1,111 @@
1
+ // The boot script of a classic chunked bundle (bundle.ts `bundleProjectChunked`).
2
+ //
3
+ // Why classic scripts at all: Android WebView keeps V8's code cache across
4
+ // launches only for classic `<script src>` files fetched over the network, each
5
+ // under a few MB. An inline script or an ES module never hits it. So the deck's
6
+ // ES modules are built as CommonJS chunks, each wrapped as
7
+ //
8
+ // __castleDefine("<name>", function (require, module, exports, __castleImport, __castleUrl, __castleMeta) {"use strict"; ...});
9
+ //
10
+ // `__castleUrl(name)` is the URL the map gives any chunk, which is how a script
11
+ // finds a wasm chunk it fetches itself (Rapier's, see bundle.ts).
12
+ // `__castleMeta` stands in for `import.meta` (which CommonJS output has not):
13
+ // `.url` is the chunk's own absolute URL and `.resolve(spec)` resolves against it.
14
+ //
15
+ // and loaded by `<script defer src>` tags (the entry's static closure) or on
16
+ // demand (a dynamic `import()`, rewritten to `__castleImport("<name>")`).
17
+ // Defining a chunk runs nothing: a chunk's code runs the first time it is
18
+ // required. ES-module evaluation order across chunks comes from the build's
19
+ // `strictExecutionOrder` (each module's top level is an init function its
20
+ // importers call in import order), not from the order chunks are required.
21
+ //
22
+ // The semantics this keeps from ES modules: strict mode, each chunk evaluated
23
+ // once, a circular require gets the partial exports (CommonJS semantics), and
24
+ // the entry runs before DOMContentLoaded, as a module script would -- as soon as
25
+ // the last static chunk has registered.
26
+ //
27
+ // `castleChunkBoot` is serialized into the page with `.toString()`, so it must
28
+ // stay self-contained: no imports, no closures over this module.
29
+ export function castleChunkBoot(map, entry, statics) {
30
+ const defined = Object.create(null);
31
+ const modules = Object.create(null);
32
+ const loading = Object.create(null);
33
+ let started = false;
34
+ const nameOf = (spec) => spec.replace(/^\.\//, '');
35
+ function require(spec) {
36
+ const name = nameOf(spec);
37
+ const cached = modules[name];
38
+ if (cached)
39
+ return cached.exports;
40
+ const define = defined[name];
41
+ if (!define)
42
+ throw new Error(`castle: chunk ${name} is not loaded`);
43
+ const module = (modules[name] = { exports: {} });
44
+ // Absolute, as import.meta.url is: the map may hold a relative base ("./").
45
+ const metaUrl = () => new URL(map[name][0], document.baseURI).href;
46
+ const meta = {
47
+ get url() {
48
+ return metaUrl();
49
+ },
50
+ resolve: (spec) => new URL(spec, metaUrl()).href,
51
+ };
52
+ try {
53
+ define.call(undefined, require, module, module.exports, castleImport, castleUrl, meta);
54
+ }
55
+ catch (e) {
56
+ // As CommonJS does: a chunk that threw is not cached as loaded.
57
+ delete modules[name];
58
+ throw e;
59
+ }
60
+ return module.exports;
61
+ }
62
+ function load(name) {
63
+ if (defined[name])
64
+ return Promise.resolve();
65
+ if (!map[name])
66
+ return Promise.reject(new Error(`castle: unknown chunk ${name}`));
67
+ return (loading[name] ??= new Promise((resolve, reject) => {
68
+ const script = document.createElement('script');
69
+ script.src = map[name][0];
70
+ script.crossOrigin = 'anonymous';
71
+ script.onload = () => defined[name] ? resolve() : reject(new Error(`castle: chunk ${name} did not register`));
72
+ script.onerror = () => {
73
+ delete loading[name];
74
+ reject(new Error(`castle: failed to load chunk ${name}`));
75
+ };
76
+ document.head.appendChild(script);
77
+ }));
78
+ }
79
+ function castleUrl(name) {
80
+ const known = map[nameOf(name)];
81
+ if (!known)
82
+ throw new Error(`castle: unknown chunk ${name}`);
83
+ return known[0];
84
+ }
85
+ // A dynamic import: the chunk and every chunk it statically requires.
86
+ function castleImport(spec) {
87
+ const needed = [];
88
+ const visit = (name) => {
89
+ if (needed.includes(name))
90
+ return;
91
+ needed.push(name);
92
+ for (const dep of map[name]?.[1] ?? [])
93
+ visit(dep);
94
+ };
95
+ visit(nameOf(spec));
96
+ return Promise.all(needed.map(load)).then(() => require(spec));
97
+ }
98
+ globalThis.__castleDefine = (name, define) => {
99
+ defined[name] = define;
100
+ if (!started && statics.every((s) => defined[s])) {
101
+ started = true;
102
+ require(entry);
103
+ }
104
+ };
105
+ document.addEventListener('DOMContentLoaded', () => {
106
+ if (started)
107
+ return;
108
+ const missing = statics.filter((s) => !defined[s]);
109
+ console.error(`castle: the game did not start; chunks failed to load: ${missing.join(', ')}`);
110
+ });
111
+ }
@@ -0,0 +1,26 @@
1
+ import type { GraphqlResponse, HostContext } from './castle-host/host.js';
2
+ /** In-memory party fixtures owned by one `castle-web serve` process. */
3
+ export declare class DevPartyStore {
4
+ private readonly now;
5
+ private readonly parties;
6
+ private nextParty;
7
+ private nextMessage;
8
+ constructor(now?: () => string);
9
+ /** The launch party is fixed by the fixture identity, not by later creates. */
10
+ launchPartyId(userId: string | null): string | null;
11
+ handles(query: string): boolean;
12
+ graphql(ctx: HostContext, query: string, variables: Record<string, unknown>): GraphqlResponse;
13
+ private current;
14
+ private create;
15
+ private invite;
16
+ private respond;
17
+ private members;
18
+ private leave;
19
+ private messages;
20
+ private say;
21
+ private summary;
22
+ private message;
23
+ private party;
24
+ private channelParty;
25
+ private cursorOffset;
26
+ }
@@ -0,0 +1,231 @@
1
+ import { devSocialUserForId } from './devSocial.js';
2
+ const SEEDED_PARTY_ID = 'dev-party-1';
3
+ const PAGE_SIZE = 20;
4
+ /** In-memory party fixtures owned by one `castle-web serve` process. */
5
+ export class DevPartyStore {
6
+ now;
7
+ parties = new Map();
8
+ nextParty = 2;
9
+ nextMessage = 2;
10
+ constructor(now = () => new Date().toISOString()) {
11
+ this.now = now;
12
+ this.parties.set(SEEDED_PARTY_ID, {
13
+ partyId: SEEDED_PARTY_ID,
14
+ name: "Alice's Party",
15
+ members: new Map([
16
+ ['dev-alice', { userId: 'dev-alice', status: 'joined', role: 'owner' }],
17
+ ['dev-bob', { userId: 'dev-bob', status: 'invited', role: 'member' }],
18
+ ]),
19
+ messages: [
20
+ {
21
+ id: 'dev-message-1',
22
+ fromUserId: 'dev-alice',
23
+ body: { message: [{ text: 'Welcome to the party!' }] },
24
+ createdAt: '2026-01-01T00:00:00.000Z',
25
+ },
26
+ ],
27
+ unread: new Set(['dev-bob']),
28
+ });
29
+ }
30
+ /** The launch party is fixed by the fixture identity, not by later creates. */
31
+ launchPartyId(userId) {
32
+ return userId === 'dev-alice' || userId === 'dev-bob' ? SEEDED_PARTY_ID : null;
33
+ }
34
+ handles(query) {
35
+ return [
36
+ 'party(partyId:',
37
+ 'createParty(',
38
+ 'inviteToParty(',
39
+ 'acceptPartyInvite(',
40
+ 'rejectPartyInvite(',
41
+ 'usersForParty(',
42
+ 'leaveParty(',
43
+ 'chatMessages(',
44
+ 'sendChatMessage(',
45
+ ].some((field) => query.includes(field));
46
+ }
47
+ graphql(ctx, query, variables) {
48
+ const userId = ctx.userId ?? 'dev-user';
49
+ if (query.includes('createParty('))
50
+ return this.create(userId, ctx, variables);
51
+ if (query.includes('inviteToParty('))
52
+ return this.invite(userId, variables);
53
+ if (query.includes('acceptPartyInvite('))
54
+ return this.respond(userId, variables, true);
55
+ if (query.includes('rejectPartyInvite('))
56
+ return this.respond(userId, variables, false);
57
+ if (query.includes('usersForParty('))
58
+ return this.members(userId, ctx, variables);
59
+ if (query.includes('leaveParty('))
60
+ return this.leave(userId, variables);
61
+ if (query.includes('chatMessages('))
62
+ return this.messages(userId, ctx, variables);
63
+ if (query.includes('sendChatMessage('))
64
+ return this.say(userId, ctx, variables);
65
+ return this.current(userId, variables);
66
+ }
67
+ current(userId, variables) {
68
+ const party = this.party(variables.partyId);
69
+ if (!party)
70
+ return { data: { party: null } };
71
+ const member = party.members.get(userId);
72
+ if (!member)
73
+ return failure('You are not a member of this party', 'PARTY_INVALID_PERMISSIONS');
74
+ return { data: { party: this.summary(party, member) } };
75
+ }
76
+ create(userId, ctx, variables) {
77
+ const ids = Array.isArray(variables.userIds)
78
+ ? variables.userIds.filter((id) => typeof id === 'string')
79
+ : [];
80
+ const partyId = `dev-party-${this.nextParty++}`;
81
+ const owner = devSocialUserForId(userId, ctx);
82
+ const members = new Map();
83
+ for (const id of ids) {
84
+ members.set(id, {
85
+ userId: id,
86
+ status: id === userId ? 'joined' : 'invited',
87
+ role: id === userId ? 'owner' : 'member',
88
+ });
89
+ }
90
+ if (!members.has(userId)) {
91
+ members.set(userId, { userId, status: 'joined', role: 'owner' });
92
+ }
93
+ const party = {
94
+ partyId,
95
+ name: `${owner.username}'s Party`,
96
+ members,
97
+ messages: [],
98
+ unread: new Set(ids.filter((id) => id !== userId)),
99
+ };
100
+ this.parties.set(partyId, party);
101
+ return { data: { createParty: this.summary(party, members.get(userId)) } };
102
+ }
103
+ invite(userId, variables) {
104
+ const party = this.party(variables.partyId);
105
+ const permission = joinedParty(party, userId);
106
+ if ('errors' in permission)
107
+ return permission;
108
+ const ids = Array.isArray(variables.userIds)
109
+ ? variables.userIds.filter((id) => typeof id === 'string')
110
+ : [];
111
+ for (const id of ids) {
112
+ const member = party.members.get(id);
113
+ if (!member || member.status === 'left' || member.status === 'rejected') {
114
+ party.members.set(id, { userId: id, status: 'invited', role: member?.role ?? 'member' });
115
+ party.unread.add(id);
116
+ }
117
+ }
118
+ return { data: { inviteToParty: null } };
119
+ }
120
+ respond(userId, variables, accept) {
121
+ const party = this.party(variables.partyId);
122
+ const member = party?.members.get(userId);
123
+ if (!party || !member) {
124
+ return failure('You are not a member of this party', 'PARTY_INVALID_PERMISSIONS');
125
+ }
126
+ if (member.status === 'invited')
127
+ member.status = accept ? 'joined' : 'rejected';
128
+ return { data: { [accept ? 'acceptPartyInvite' : 'rejectPartyInvite']: null } };
129
+ }
130
+ members(userId, ctx, variables) {
131
+ const party = this.party(variables.partyId);
132
+ if (!party?.members.has(userId)) {
133
+ return failure('You are not a member of this party', 'PARTY_INVALID_PERMISSIONS');
134
+ }
135
+ const usersForParty = [...party.members.values()]
136
+ .filter((member) => member.status === 'joined' || member.status === 'invited' || member.status === 'banned')
137
+ .map((member) => ({
138
+ user: devSocialUserForId(member.userId, ctx),
139
+ status: member.status,
140
+ role: member.role,
141
+ }));
142
+ return { data: { usersForParty } };
143
+ }
144
+ leave(userId, variables) {
145
+ const party = this.party(variables.partyId);
146
+ const permission = joinedParty(party, userId);
147
+ if ('errors' in permission)
148
+ return permission;
149
+ party.members.get(userId).status = 'left';
150
+ return { data: { leaveParty: null } };
151
+ }
152
+ messages(userId, ctx, variables) {
153
+ const party = this.channelParty(variables.chatChannelId);
154
+ if (!party?.members.has(userId)) {
155
+ return failure('You are not a member of this party', 'PARTY_INVALID_PERMISSIONS');
156
+ }
157
+ const start = this.cursorOffset(party, variables.paginateToken);
158
+ if (start === null)
159
+ return failure('Invalid paginate token', 'INVALID_PAGINATE_TOKEN');
160
+ const page = party.messages.slice(start, start + PAGE_SIZE);
161
+ const end = start + page.length;
162
+ return {
163
+ data: {
164
+ chatMessages: {
165
+ chatMessages: page.map((message) => this.message(message, ctx)),
166
+ paginateToken: end < party.messages.length ? `dev:${party.partyId}:${end}` : null,
167
+ },
168
+ },
169
+ };
170
+ }
171
+ say(userId, ctx, variables) {
172
+ const party = this.channelParty(variables.chatChannelId);
173
+ const permission = joinedParty(party, userId);
174
+ if ('errors' in permission)
175
+ return permission;
176
+ const text = typeof variables.message === 'string' ? variables.message : '';
177
+ const message = {
178
+ id: `dev-message-${this.nextMessage++}`,
179
+ fromUserId: userId,
180
+ body: { message: [{ text }] },
181
+ createdAt: this.now(),
182
+ };
183
+ party.messages.unshift(message);
184
+ for (const member of party.members.values()) {
185
+ if (member.status === 'joined' && member.userId !== userId)
186
+ party.unread.add(member.userId);
187
+ }
188
+ return { data: { sendChatMessage: this.message(message, ctx) } };
189
+ }
190
+ summary(party, member) {
191
+ return {
192
+ partyId: party.partyId,
193
+ name: party.name,
194
+ status: member.status,
195
+ chatChannel: { hasUnreadMessages: party.unread.has(member.userId) },
196
+ };
197
+ }
198
+ message(message, ctx) {
199
+ return {
200
+ chatMessageId: message.id,
201
+ fromUserId: message.fromUserId,
202
+ fromUser: { username: devSocialUserForId(message.fromUserId, ctx).username },
203
+ body: message.body,
204
+ createdTime: message.createdAt,
205
+ };
206
+ }
207
+ party(value) {
208
+ return typeof value === 'string' ? (this.parties.get(value) ?? null) : null;
209
+ }
210
+ channelParty(value) {
211
+ return typeof value === 'string' && value.startsWith('party-')
212
+ ? (this.parties.get(value.slice('party-'.length)) ?? null)
213
+ : null;
214
+ }
215
+ cursorOffset(party, value) {
216
+ if (value === null || value === undefined)
217
+ return 0;
218
+ if (typeof value !== 'string')
219
+ return null;
220
+ const match = /^dev:([^:]+):(\d+)$/.exec(value);
221
+ return match && match[1] === party.partyId ? Number(match[2]) : null;
222
+ }
223
+ }
224
+ function joinedParty(party, userId) {
225
+ if (party?.members.get(userId)?.status === 'joined')
226
+ return { ok: true };
227
+ return failure('You have not joined this party', 'PARTY_INVALID_PERMISSIONS');
228
+ }
229
+ function failure(message, code) {
230
+ return { errors: [{ message, extensions: { code } }] };
231
+ }
@@ -5,6 +5,8 @@ export const SAVE_VERBS = new Set([
5
5
  'transaction',
6
6
  'claim',
7
7
  'initialize',
8
+ 'conditionalWrite',
9
+ 'recentOperations',
8
10
  ]);
9
11
  const MAX_KEY_BYTES = 128;
10
12
  const MAX_SUBJECT_BYTES = 256;
@@ -32,6 +34,8 @@ export class DevSaveStorage {
32
34
  try {
33
35
  if (!input || typeof input !== 'object')
34
36
  fail('INVALID_ARGUMENT', 'Expected an object.');
37
+ if (verb === 'conditionalWrite' || verb === 'recentOperations')
38
+ fail('UNAVAILABLE', 'Conditional storage requires the gated platform service; the dev memory store does not emulate durable recovery.');
35
39
  if (verb === 'snapshot') {
36
40
  return this.reply(caller, this.snapshot(this.state, reads(input.targets, caller)));
37
41
  }
@@ -31,6 +31,8 @@ const SAVE_FIELDS = {
31
31
  cauldronStorageTransaction: 'transaction',
32
32
  cauldronStorageClaim: 'claim',
33
33
  cauldronStorageInitialize: 'initialize',
34
+ cauldronStorageConditionalWrite: 'conditionalWrite',
35
+ cauldronStorageRecentOperations: 'recentOperations',
34
36
  };
35
37
  /**
36
38
  * A page's save, answered in place of the GraphQL call the browser host makes
@@ -260,7 +262,7 @@ const OPERATIONS = {
260
262
  playthroughOpen: {
261
263
  field: 'cauldronPlaythroughOpen',
262
264
  query: `mutation CastleDevPlaythroughOpen($deckId: ID!, $subject: ID!) {
263
- cauldronPlaythroughOpen(deckId: $deckId, subject: $subject, asServer: true) { generation }
265
+ cauldronPlaythroughOpen(deckId: $deckId, subject: $subject, asServer: true) { generation resetGeneration }
264
266
  }`,
265
267
  },
266
268
  playthroughGet: {
@@ -407,6 +409,46 @@ const OPERATIONS = {
407
409
  },
408
410
  };
409
411
  export async function runDevStorageOperation(deckId, op, args, connectedUserIds = []) {
412
+ if (args.place !== undefined && args.place !== 'town') {
413
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'unknown storage place');
414
+ }
415
+ const town = args.place === 'town';
416
+ if (town) {
417
+ if (!['get', 'set', 'delete', 'increment'].includes(op) || args.scope !== 'DECK') {
418
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires a plain deck-scope operation');
419
+ }
420
+ if (typeof args.subject !== 'string' || !args.subject || Buffer.byteLength(args.subject) > 256) {
421
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires a user id of at most 256 bytes');
422
+ }
423
+ const entries = args.entries;
424
+ if (op === 'set' && !Array.isArray(entries)) {
425
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires entries');
426
+ }
427
+ const keys = op === 'increment' ? [args.key]
428
+ : op === 'set' && Array.isArray(entries) ? entries.map((entry) => entry?.key)
429
+ : args.keys;
430
+ if (!Array.isArray(keys)) {
431
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires keys');
432
+ }
433
+ for (const key of keys) {
434
+ const segments = typeof key === 'string' ? key.split(':') : [];
435
+ // The same namespaces ghost allows (tokens, spent, own, hat, chirp).
436
+ if (!['tokens', 'spent', 'own', 'hat', 'chirp'].includes(segments[0]) || segments[1] !== args.subject) {
437
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', `invalid town storage key ${JSON.stringify(key)}`);
438
+ }
439
+ }
440
+ // Dev has no trusted door-to-town binding. Isolate these rows in the DEV
441
+ // deck's own scope so an author testing a door never edits a real town.
442
+ const plain = { ...args };
443
+ delete plain.place;
444
+ args = { ...plain, scope: 'DECK', subject: null };
445
+ if (op === 'increment')
446
+ args.key = `town/${keys[0]}`;
447
+ else if (op === 'set')
448
+ args.entries = entries.map((entry) => ({ ...entry, key: `town/${String(entry.key)}` }));
449
+ else
450
+ args.keys = keys.map((key) => `town/${String(key)}`);
451
+ }
410
452
  const operation = OPERATIONS[op];
411
453
  if (!operation) {
412
454
  return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', `unknown storage operation ${op}`);
@@ -469,7 +511,13 @@ export async function runDevStorageOperation(deckId, op, args, connectedUserIds
469
511
  },
470
512
  };
471
513
  }
472
- return { ok: true, value: response.data?.[operation.field] ?? null };
514
+ const value = response.data?.[operation.field] ?? null;
515
+ return {
516
+ ok: true,
517
+ value: town && op === 'get' && Array.isArray(value)
518
+ ? value.map((entry) => ({ ...entry, key: entry.key.slice('town/'.length) }))
519
+ : value,
520
+ };
473
521
  }
474
522
  catch (error) {
475
523
  return failure('CAULDRON_STORAGE_UNAVAILABLE', error instanceof Error ? error.message : 'storage request failed');
@@ -0,0 +1,24 @@
1
+ import type { GraphqlResponse, HostContext } from './castle-host/host.js';
2
+ export type DevSocialFixtureKey = 'alice' | 'bob' | 'cara';
3
+ export interface DevSocialUser {
4
+ userId: string;
5
+ username: string;
6
+ photo?: {
7
+ smallAvatarUrl?: string;
8
+ } | null;
9
+ }
10
+ export declare function devSocialFixtureKey(value: unknown): DevSocialFixtureKey | null;
11
+ export declare function devSocialUser(key: DevSocialFixtureKey | null, fallback: {
12
+ userId: string | null;
13
+ username: string | null;
14
+ }): {
15
+ userId: string | null;
16
+ username: string | null;
17
+ };
18
+ export declare function devSocialUserForId(userId: string, ctx?: HostContext): DevSocialUser;
19
+ /**
20
+ * Answers only Social's two GraphQL documents. A null answer means this is not
21
+ * a social fixture query. Unknown `?as=` values deliberately use the harmless
22
+ * developer fixture (no friends and no presence), never an arbitrary user id.
23
+ */
24
+ export declare function devSocialGraphql(key: DevSocialFixtureKey | null, deckId: string | null, query: string): GraphqlResponse | null;