castle-web-cli 0.4.229 → 0.4.231

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 (259) hide show
  1. package/dist/agent-prompts.d.ts +2 -0
  2. package/dist/agent-prompts.js +16 -8
  3. package/dist/agent.d.ts +2 -0
  4. package/dist/agent.js +21 -21
  5. package/dist/api.d.ts +28 -2
  6. package/dist/api.js +74 -16
  7. package/dist/castle-host/host.d.ts +91 -0
  8. package/dist/castle-host/host.js +860 -3
  9. package/dist/castleJson.d.ts +44 -0
  10. package/dist/castleJson.js +131 -0
  11. package/dist/check.js +27 -1
  12. package/dist/contentPack.d.ts +49 -0
  13. package/dist/contentPack.js +273 -0
  14. package/dist/devExperiments.d.ts +21 -0
  15. package/dist/devExperiments.js +139 -0
  16. package/dist/devHub.d.ts +55 -0
  17. package/dist/devHub.js +187 -0
  18. package/dist/devSaveStorage.d.ts +36 -0
  19. package/dist/devSaveStorage.js +469 -0
  20. package/dist/devSessionChild.js +25 -13
  21. package/dist/devSessionServer.d.ts +14 -1
  22. package/dist/devSessionServer.js +237 -46
  23. package/dist/devSessionStorage.d.ts +9 -0
  24. package/dist/devSessionStorage.js +66 -1
  25. package/dist/experimentAssignment.d.ts +15 -0
  26. package/dist/experimentAssignment.js +41 -0
  27. package/dist/importCheckHook.d.ts +40 -0
  28. package/dist/importCheckHook.js +171 -0
  29. package/dist/importRegression.d.ts +15 -0
  30. package/dist/importRegression.js +100 -0
  31. package/dist/importTrust.d.ts +2 -0
  32. package/dist/importTrust.js +27 -0
  33. package/dist/importUpdateHook.d.ts +18 -0
  34. package/dist/importUpdateHook.js +31 -8
  35. package/dist/importUpdateHookRunner.js +19 -7
  36. package/dist/imports.d.ts +16 -0
  37. package/dist/imports.js +141 -31
  38. package/dist/index.js +3 -1
  39. package/dist/init.d.ts +3 -0
  40. package/dist/init.js +126 -9
  41. package/dist/install.js +4 -1
  42. package/dist/localPaths.js +4 -0
  43. package/dist/login.js +2 -2
  44. package/dist/platformDoc.js +3 -8
  45. package/dist/playPagePolicy.js +3 -1
  46. package/dist/remix.js +5 -0
  47. package/dist/routerTaskReport.d.ts +28 -0
  48. package/dist/routerTaskReport.js +56 -0
  49. package/dist/save-deck.d.ts +18 -0
  50. package/dist/save-deck.js +142 -6
  51. package/dist/serve.d.ts +8 -0
  52. package/dist/serve.js +99 -14
  53. package/dist/serverBundle.d.ts +1 -1
  54. package/dist/serverBundle.js +5 -1
  55. package/dist/webSourceSync.d.ts +2 -0
  56. package/dist/webSourceSync.js +2 -0
  57. package/kits/base/CLAUDE.md +2 -3
  58. package/kits/base/castle.json +1 -1
  59. package/kits/base/sdk/README.md +406 -53
  60. package/kits/base/sdk/agent.js +4 -4
  61. package/kits/base/sdk/avatar.d.ts +12 -0
  62. package/kits/base/sdk/avatar.js +23 -0
  63. package/kits/base/sdk/castle.d.ts +9 -0
  64. package/kits/base/sdk/castle.js +5 -0
  65. package/kits/base/sdk/commands.d.ts +223 -0
  66. package/kits/base/sdk/commands.js +16 -0
  67. package/kits/base/sdk/context.d.ts +6 -0
  68. package/kits/base/sdk/experiments.d.ts +15 -0
  69. package/kits/base/sdk/experiments.js +83 -0
  70. package/kits/base/sdk/hub.d.ts +85 -0
  71. package/kits/base/sdk/hub.js +107 -0
  72. package/kits/base/sdk/multiplayer.d.ts +45 -1
  73. package/kits/base/sdk/multiplayer.js +158 -8
  74. package/kits/base/sdk/save.d.ts +197 -0
  75. package/kits/base/sdk/save.js +525 -0
  76. package/kits/base/sdk/saveCoordinator.d.ts +39 -0
  77. package/kits/base/sdk/saveCoordinator.js +252 -0
  78. package/kits/base/sdk/server/hub.d.ts +169 -0
  79. package/kits/base/sdk/server/hub.js +125 -0
  80. package/kits/base/sdk/server/platformHandle.d.ts +42 -1
  81. package/kits/base/sdk/server/storage.d.ts +58 -4
  82. package/kits/base/sdk/server/storage.js +25 -5
  83. package/kits/base/sdk/server/wrapper.d.ts +36 -2
  84. package/kits/base/sdk/server/wrapper.js +92 -11
  85. package/kits/base/sdk/store.d.ts +3 -2
  86. package/kits/base/sdk/store.js +5 -0
  87. package/kits/base/sdk/transport.d.ts +2 -1
  88. package/kits/base/sdk/transport.js +13 -1
  89. package/kits/hub-game/.prettierrc +5 -0
  90. package/kits/hub-game/CLAUDE.md +149 -0
  91. package/kits/hub-game/blueprints/avatar-0.scene +28 -0
  92. package/kits/hub-game/blueprints/avatar-1.scene +28 -0
  93. package/kits/hub-game/blueprints/avatar-2.scene +28 -0
  94. package/kits/hub-game/blueprints/avatar-3.scene +28 -0
  95. package/kits/hub-game/blueprints/bean/avatar-0.scene +28 -0
  96. package/kits/hub-game/blueprints/bean/avatar-1.scene +28 -0
  97. package/kits/hub-game/blueprints/bean/avatar-2.scene +28 -0
  98. package/kits/hub-game/blueprints/bean/avatar-3.scene +28 -0
  99. package/kits/hub-game/blueprints/blocky/avatar-0.scene +28 -0
  100. package/kits/hub-game/blueprints/blocky/avatar-1.scene +28 -0
  101. package/kits/hub-game/blueprints/blocky/avatar-2.scene +28 -0
  102. package/kits/hub-game/blueprints/blocky/avatar-3.scene +28 -0
  103. package/kits/hub-game/blueprints/pixel/avatar-0.scene +28 -0
  104. package/kits/hub-game/blueprints/pixel/avatar-1.scene +28 -0
  105. package/kits/hub-game/blueprints/pixel/avatar-2.scene +28 -0
  106. package/kits/hub-game/blueprints/pixel/avatar-3.scene +28 -0
  107. package/kits/hub-game/castle.json +96 -0
  108. package/kits/hub-game/code/client/attention.js +133 -0
  109. package/kits/hub-game/code/client/avatar.js +288 -0
  110. package/kits/hub-game/code/client/cabinets.js +90 -0
  111. package/kits/hub-game/code/client/chat.js +135 -0
  112. package/kits/hub-game/code/client/chrome.js +1035 -0
  113. package/kits/hub-game/code/client/doorFrame.js +15 -0
  114. package/kits/hub-game/code/client/firstJoin.js +14 -0
  115. package/kits/hub-game/code/client/grab.js +376 -0
  116. package/kits/hub-game/code/client/hookLayer.js +236 -0
  117. package/kits/hub-game/code/client/idle.js +326 -0
  118. package/kits/hub-game/code/client/keys.js +48 -0
  119. package/kits/hub-game/code/client/pack.js +232 -0
  120. package/kits/hub-game/code/client/packFormat.js +397 -0
  121. package/kits/hub-game/code/client/say.js +127 -0
  122. package/kits/hub-game/code/client/sha256.js +80 -0
  123. package/kits/hub-game/code/client/sound.js +147 -0
  124. package/kits/hub-game/code/client/state.js +143 -0
  125. package/kits/hub-game/code/client/talk.js +233 -0
  126. package/kits/hub-game/code/client/tiers.js +480 -0
  127. package/kits/hub-game/code/client/together.js +440 -0
  128. package/kits/hub-game/code/client/wear.js +149 -0
  129. package/kits/hub-game/code/server/actors.js +627 -0
  130. package/kits/hub-game/code/server/blocks.js +103 -0
  131. package/kits/hub-game/code/server/cabinets.js +309 -0
  132. package/kits/hub-game/code/server/game.js +137 -0
  133. package/kits/hub-game/code/server/grab.js +248 -0
  134. package/kits/hub-game/code/server/history.js +96 -0
  135. package/kits/hub-game/code/server/hub.js +1998 -0
  136. package/kits/hub-game/code/server/idle.js +412 -0
  137. package/kits/hub-game/code/server/index.js +64 -0
  138. package/kits/hub-game/code/server/labels.js +59 -0
  139. package/kits/hub-game/code/server/manifest.js +554 -0
  140. package/kits/hub-game/code/server/npcs.js +733 -0
  141. package/kits/hub-game/code/server/party.js +439 -0
  142. package/kits/hub-game/code/server/place.js +43 -0
  143. package/kits/hub-game/code/server/say.js +83 -0
  144. package/kits/hub-game/code/server/wear.js +142 -0
  145. package/kits/hub-game/code/systems/hub.js +2347 -0
  146. package/kits/hub-game/docs/content-pack.md +151 -0
  147. package/kits/hub-game/docs/contract.md +1209 -0
  148. package/kits/hub-game/docs/style.md +137 -0
  149. package/kits/hub-game/drawings/blocky/castle-eye.sprite +58 -0
  150. package/kits/hub-game/drawings/blocky/dash.sprite +59 -0
  151. package/kits/hub-game/drawings/blocky/pom.sprite +59 -0
  152. package/kits/hub-game/drawings/blocky/tabby.sprite +59 -0
  153. package/kits/hub-game/drawings/pixel/castle-arm.sprite +13 -0
  154. package/kits/hub-game/drawings/pixel/castle-body.sprite +23 -0
  155. package/kits/hub-game/drawings/pixel/castle-leg.sprite +12 -0
  156. package/kits/hub-game/drawings/pixel/kai-arm.sprite +14 -0
  157. package/kits/hub-game/drawings/pixel/kai-head.sprite +24 -0
  158. package/kits/hub-game/drawings/pixel/kai-leg.sprite +15 -0
  159. package/kits/hub-game/drawings/pixel/kai-torso.sprite +18 -0
  160. package/kits/hub-game/drawings/pixel/mimi-arm.sprite +13 -0
  161. package/kits/hub-game/drawings/pixel/mimi-head.sprite +23 -0
  162. package/kits/hub-game/drawings/pixel/mimi-leg.sprite +15 -0
  163. package/kits/hub-game/drawings/pixel/mimi-torso.sprite +18 -0
  164. package/kits/hub-game/drawings/pixel/nox-arm.sprite +13 -0
  165. package/kits/hub-game/drawings/pixel/nox-head.sprite +21 -0
  166. package/kits/hub-game/drawings/pixel/nox-leg.sprite +14 -0
  167. package/kits/hub-game/drawings/pixel/nox-torso.sprite +18 -0
  168. package/kits/hub-game/eslint.config.js +20 -0
  169. package/kits/hub-game/fonts.generated.js +9 -0
  170. package/kits/hub-game/index.html +22 -0
  171. package/kits/hub-game/main.jsx +6 -0
  172. package/kits/hub-game/models/avatar-0.pxmodel +21 -0
  173. package/kits/hub-game/models/avatar-1.pxmodel +24 -0
  174. package/kits/hub-game/models/avatar-2.pxmodel +27 -0
  175. package/kits/hub-game/models/avatar-3.pxmodel +22 -0
  176. package/kits/hub-game/models/bean/avatar-0.pxmodel +19 -0
  177. package/kits/hub-game/models/bean/avatar-1.pxmodel +24 -0
  178. package/kits/hub-game/models/bean/avatar-2.pxmodel +22 -0
  179. package/kits/hub-game/models/bean/avatar-3.pxmodel +24 -0
  180. package/kits/hub-game/models/blocky/avatar-0.pxmodel +21 -0
  181. package/kits/hub-game/models/blocky/avatar-1.pxmodel +30 -0
  182. package/kits/hub-game/models/blocky/avatar-2.pxmodel +28 -0
  183. package/kits/hub-game/models/blocky/avatar-3.pxmodel +27 -0
  184. package/kits/hub-game/models/pixel/avatar-0.pxmodel +24 -0
  185. package/kits/hub-game/models/pixel/avatar-1.pxmodel +16 -0
  186. package/kits/hub-game/models/pixel/avatar-2.pxmodel +19 -0
  187. package/kits/hub-game/models/pixel/avatar-3.pxmodel +23 -0
  188. package/kits/hub-game/package-lock.json +365 -0
  189. package/kits/hub-game/package.json +32 -0
  190. package/kits/hub-game/scenes/main.scene +318 -0
  191. package/kits/hub-game/scripts/check.mjs +339 -0
  192. package/kits/hub-game/scripts/fixtures/sdk-stub.mjs +3 -0
  193. package/kits/hub-game/scripts/gen-avatars-bean.mjs +748 -0
  194. package/kits/hub-game/scripts/gen-avatars-blocky.mjs +607 -0
  195. package/kits/hub-game/scripts/gen-avatars-pixel.mjs +771 -0
  196. package/kits/hub-game/scripts/gen-avatars.mjs +621 -0
  197. package/kits/hub-game/scripts/pack.mjs +192 -0
  198. package/kits/hub-game/scripts/test-actors.mjs +666 -0
  199. package/kits/hub-game/scripts/test-attention.mjs +103 -0
  200. package/kits/hub-game/scripts/test-avatar.mjs +472 -0
  201. package/kits/hub-game/scripts/test-ban-join.mjs +194 -0
  202. package/kits/hub-game/scripts/test-blocks.mjs +351 -0
  203. package/kits/hub-game/scripts/test-chat.mjs +98 -0
  204. package/kits/hub-game/scripts/test-classic.mjs +590 -0
  205. package/kits/hub-game/scripts/test-door-jump.mjs +131 -0
  206. package/kits/hub-game/scripts/test-door.mjs +56 -0
  207. package/kits/hub-game/scripts/test-grab-client.mjs +328 -0
  208. package/kits/hub-game/scripts/test-grab.mjs +331 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +835 -0
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +1518 -0
  211. package/kits/hub-game/scripts/test-idle.mjs +518 -0
  212. package/kits/hub-game/scripts/test-interest.mjs +413 -0
  213. package/kits/hub-game/scripts/test-keys.mjs +50 -0
  214. package/kits/hub-game/scripts/test-manifest.mjs +270 -0
  215. package/kits/hub-game/scripts/test-no-forms.mjs +16 -0
  216. package/kits/hub-game/scripts/test-npcs.mjs +724 -0
  217. package/kits/hub-game/scripts/test-pack.mjs +424 -0
  218. package/kits/hub-game/scripts/test-party.mjs +369 -0
  219. package/kits/hub-game/scripts/test-say.mjs +149 -0
  220. package/kits/hub-game/scripts/test-tiers.mjs +666 -0
  221. package/kits/hub-game/scripts/test-together.mjs +215 -0
  222. package/kits/hub-game/theme.style +3 -0
  223. package/kits/multiplayer-3d/castle.json +5 -5
  224. package/kits/multiplayer-3d/code/client/avatars.js +101 -1
  225. package/kits/multiplayer-3d/code/server/players.js +4 -1
  226. package/kits/multiplayer-3d/code/server/sceneBodies.js +27 -6
  227. package/kits/multiplayer-3d/code/server/world.js +20 -7
  228. package/kits/multiplayer-3d/code/systems/multiplayer.js +222 -11
  229. package/kits/physics-2d/CLAUDE.md +2 -0
  230. package/kits/physics-2d/castle.json +2 -2
  231. package/kits/physics-2d/engine/art.js +13 -0
  232. package/kits/physics-2d/engine/assets.js +4 -2
  233. package/kits/physics-2d/engine/scene.js +117 -5
  234. package/kits/physics-2d/package.json +1 -1
  235. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +254 -0
  236. package/kits/physics-3d/CLAUDE.md +285 -1
  237. package/kits/physics-3d/behaviors/Player.jsx +74 -1
  238. package/kits/physics-3d/castle.json +3 -3
  239. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +33 -5
  240. package/kits/physics-3d/engine3d/actornode.js +253 -0
  241. package/kits/physics-3d/engine3d/artobjects.js +2 -2
  242. package/kits/physics-3d/engine3d/materials.js +29 -1
  243. package/kits/physics-3d/engine3d/nearshadows.js +600 -0
  244. package/kits/physics-3d/engine3d/unchanged.js +153 -0
  245. package/kits/physics-3d/engine3d/world3d.js +527 -5
  246. package/kits/physics-3d/package.json +1 -1
  247. package/kits/physics-3d/scripts/test-camera-follow.mjs +533 -0
  248. package/kits/physics-3d/scripts/test-near-shadows.mjs +1073 -0
  249. package/kits/physics-3d/scripts/test-static-actors.mjs +662 -0
  250. package/kits/physics-3d/scripts/test-static-passes.mjs +459 -0
  251. package/kits/physics-3d/scripts/test-static-physics.mjs +128 -0
  252. package/kits/physics-3d/systems/physics3d.js +187 -5
  253. package/kits/real-time/castle.json +2 -2
  254. package/kits/real-time/code/client/connection.js +77 -7
  255. package/kits/real-time/code/client/gameHooks.js +63 -3
  256. package/kits/real-time/code/client/messages.js +7 -0
  257. package/kits/real-time/code/server/gameHooks.js +24 -0
  258. package/kits/real-time/code/server/session.js +390 -22
  259. package/package.json +2 -2
@@ -0,0 +1,331 @@
1
+ // Grabbing and throwing (contract §6, v1.3), the server's half: a client's
2
+ // `hub-grab` is checked against the simulation (a loose object of the place,
3
+ // near the player, this player's to simulate), offered to the place's `grab`
4
+ // hook, rate-limited and answered `hub-grab-deny` when refused; `hub.drop`
5
+ // tells a holder to let go; a thrown object is not slowed to a shove's speed
6
+ // while it flies. `npm run check` runs it; it needs nothing installed.
7
+
8
+ import assert from 'node:assert/strict';
9
+ import { register } from 'node:module';
10
+
11
+ const sceneStub = 'export const readScene = () => globalThis.__hubTestActors ?? [];';
12
+ register(
13
+ `data:text/javascript,${encodeURIComponent(`
14
+ export async function resolve(specifier, context, next) {
15
+ if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') {
16
+ return { url: 'data:text/javascript,${encodeURIComponent(sceneStub)}', shortCircuit: true };
17
+ }
18
+ return next(specifier, context);
19
+ }
20
+ `)}`,
21
+ );
22
+ const { layer } = await import('../code/server/hub.js');
23
+ const Grab = await import('../code/server/grab.js');
24
+
25
+ const crateShape = { kind: 'box', width: 0.8, height: 0.8, depth: 0.8 };
26
+ globalThis.__hubTestActors = [
27
+ { id: 'spawn', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
28
+ {
29
+ id: 'crate',
30
+ components: { Transform: { x: 1, y: 0.4, z: 0 }, Shape: crateShape, Body: { type: 'dynamic' } },
31
+ },
32
+ {
33
+ id: 'barrel',
34
+ components: {
35
+ Transform: { x: -1, y: 0.4, z: 0 },
36
+ Shape: crateShape,
37
+ Body: { type: 'dynamic' },
38
+ },
39
+ },
40
+ {
41
+ id: 'far',
42
+ components: {
43
+ Transform: { x: 12, y: 0.4, z: 0 },
44
+ Shape: crateShape,
45
+ Body: { type: 'dynamic' },
46
+ },
47
+ },
48
+ {
49
+ id: 'gate',
50
+ components: { Transform: { x: 0, y: 1, z: 1 }, Shape: crateShape, Body: { type: 'kinematic' } },
51
+ },
52
+ ];
53
+
54
+ function rigid(at) {
55
+ const state = { at: { ...at }, v: { x: 0, y: 0, z: 0 } };
56
+ return {
57
+ state,
58
+ translation: () => ({ ...state.at }),
59
+ linvel: () => ({ ...state.v }),
60
+ setLinvel: (v) => {
61
+ state.v = { ...v };
62
+ },
63
+ setEnabled() {},
64
+ };
65
+ }
66
+
67
+ function boot(options = {}) {
68
+ const grab = 'grab' in options ? options.grab : true;
69
+ const hooks = options.hooks ?? {};
70
+ const json = {
71
+ server: { maxPlayers: 8 },
72
+ hub: { contract: 1, title: 'Bumper', result: {}, ...(grab === undefined ? {} : { grab }) },
73
+ };
74
+ let hub = null;
75
+ const sent = [];
76
+ const h = layer(json, { ...hooks, ready: (x) => (hub = x) }, {}, () => true);
77
+ const players = [
78
+ { playerId: 'p1', username: 'ada' },
79
+ { playerId: 'p2', username: 'bo' },
80
+ ];
81
+ const session = {
82
+ sessionId: 's-1',
83
+ players,
84
+ hub: null,
85
+ send: (id, d) => sent.push([id, d]),
86
+ broadcast() {},
87
+ };
88
+ h.sceneFor(session);
89
+ const body = () => ({ at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
90
+ const objects = new Map();
91
+ for (const actor of globalThis.__hubTestActors) {
92
+ const b = actor.components.Body;
93
+ if (b) {
94
+ objects.set(actor.id, {
95
+ body: rigid(actor.components.Transform),
96
+ claimable: b.type === 'dynamic',
97
+ fast: false,
98
+ owner: null,
99
+ });
100
+ }
101
+ }
102
+ const world = {
103
+ timeMs: 0,
104
+ players: new Map([
105
+ ['p1', body()],
106
+ ['p2', body()],
107
+ ]),
108
+ bodies: new Map([...objects].map(([id, e]) => [id, e.body])),
109
+ objects,
110
+ scenePath: 'scenes/main.scene',
111
+ };
112
+ h.ready(world);
113
+ for (const p of players) {
114
+ h.message(session, p, { k: 'hub-hello', avatar: 0, party: 2 });
115
+ }
116
+ h.place(world);
117
+ // Everyone stands at the origin; p1 simulates the crate and the barrel.
118
+ for (const p of world.players.values()) {
119
+ p.at = { x: 0, y: 1, z: 0 };
120
+ }
121
+ objects.get('crate').owner = 'p1';
122
+ objects.get('barrel').owner = 'p1';
123
+ objects.get('far').owner = 'p1';
124
+ const say = (playerId, data) => h.message(session, { playerId }, { k: 'hub-grab', ...data });
125
+ const denies = () => sent.filter(([, d]) => d.k === 'hub-grab-deny');
126
+ return { h, hub, world, objects, sent, say, denies };
127
+ }
128
+
129
+ const warn = console.warn;
130
+ console.warn = () => {};
131
+ let n = 0;
132
+ function test(name, fn) {
133
+ fn();
134
+ n += 1;
135
+ }
136
+
137
+ test('a grab of a loose object this player simulates is taken and offered to the hook', () => {
138
+ const calls = [];
139
+ const { hub, say, denies } = boot({ hooks: { grab: (x, ...args) => calls.push(args) } });
140
+ say('p1', { actor: 'crate', op: 'grab' });
141
+ assert.deepEqual(calls, [['p1', 'crate', 'grab']]);
142
+ assert.equal(hub.holding('p1'), 'crate');
143
+ assert.deepEqual(denies(), []);
144
+ // One hold at a time: grabbing the barrel replaces it.
145
+ say('p1', { actor: 'barrel', op: 'grab' });
146
+ assert.equal(hub.holding('p1'), 'barrel');
147
+ });
148
+
149
+ test('the hook vetoes a grab with false, and a hook that throws vetoes it too', () => {
150
+ const { hub, say, denies } = boot({
151
+ hooks: { grab: (x, playerId, actorId) => actorId !== 'crate' },
152
+ });
153
+ say('p1', { actor: 'crate', op: 'grab' });
154
+ assert.deepEqual(denies(), [['p1', { k: 'hub-grab-deny', actor: 'crate' }]]);
155
+ assert.equal(hub.holding('p1'), null);
156
+ say('p1', { actor: 'barrel', op: 'grab' });
157
+ assert.equal(hub.holding('p1'), 'barrel');
158
+ const broken = boot({
159
+ hooks: {
160
+ grab: () => {
161
+ throw new Error('boom');
162
+ },
163
+ },
164
+ });
165
+ broken.say('p1', { actor: 'crate', op: 'grab' });
166
+ assert.equal(broken.denies().length, 1);
167
+ assert.equal(broken.hub.holding('p1'), null);
168
+ });
169
+
170
+ test('refused: too far, not dynamic, unknown, hidden, someone else’s, or a held player', () => {
171
+ let asked = 0;
172
+ const { hub, say, denies, world, objects } = boot({ hooks: { grab: () => (asked += 1) } });
173
+ say('p1', { actor: 'far', op: 'grab' });
174
+ say('p1', { actor: 'gate', op: 'grab' });
175
+ world.timeMs += 1000;
176
+ say('p1', { actor: 'spawn', op: 'grab' });
177
+ say('p1', { actor: 'nobody', op: 'grab' });
178
+ // p2 stands beside the crate, but p1 simulates it.
179
+ say('p2', { actor: 'crate', op: 'grab' });
180
+ world.timeMs += 1000;
181
+ hub.hide('barrel');
182
+ say('p1', { actor: 'barrel', op: 'grab' });
183
+ hub.show('barrel');
184
+ hub.hold('p1');
185
+ say('p1', { actor: 'barrel', op: 'grab' });
186
+ hub.release('p1');
187
+ objects.get('crate').owner = null;
188
+ say('p1', { actor: 'crate', op: 'grab' });
189
+ assert.equal(denies().length, 8);
190
+ assert.equal(asked, 0);
191
+ assert.equal(hub.holding('p1'), null);
192
+ assert.equal(hub.holding('p2'), null);
193
+ });
194
+
195
+ test('a place without grab ignores the message entirely', () => {
196
+ let asked = 0;
197
+ for (const grab of [undefined, false]) {
198
+ const { hub, say, sent } = boot({ grab, hooks: { grab: () => (asked += 1) } });
199
+ const before = sent.length;
200
+ say('p1', { actor: 'crate', op: 'grab' });
201
+ assert.equal(sent.length, before);
202
+ assert.equal(hub.holding('p1'), null);
203
+ assert.equal(hub.drop(), 0);
204
+ }
205
+ assert.equal(asked, 0);
206
+ });
207
+
208
+ test('malformed messages are dropped without an answer', () => {
209
+ let asked = 0;
210
+ const { say, sent } = boot({ hooks: { grab: () => (asked += 1) } });
211
+ const before = sent.length;
212
+ say('p1', { actor: 'crate', op: 'yank' });
213
+ say('p1', { actor: 7, op: 'grab' });
214
+ say('p1', { op: 'grab' });
215
+ say('p1', { actor: 'x'.repeat(200), op: 'grab' });
216
+ say('p1', {});
217
+ assert.equal(sent.length, before);
218
+ assert.equal(asked, 0);
219
+ });
220
+
221
+ test('hub-grab is rate-limited per player; a grab past the rate is denied unheard', () => {
222
+ let asked = 0;
223
+ const { say, denies, world } = boot({ hooks: { grab: () => (asked += 1) } });
224
+ for (let i = 0; i < Grab.GRAB_BURST + 3; i += 1) {
225
+ say('p1', { actor: 'crate', op: 'grab' });
226
+ }
227
+ assert.equal(asked, Grab.GRAB_BURST);
228
+ assert.equal(denies().length, 3);
229
+ // Another player has their own budget.
230
+ say('p2', { actor: 'nobody', op: 'grab' });
231
+ assert.equal(denies().length, 4);
232
+ world.timeMs += 1000;
233
+ say('p1', { actor: 'crate', op: 'grab' });
234
+ assert.equal(asked, Grab.GRAB_BURST + 1);
235
+ });
236
+
237
+ test('a throw ends the hold, is told to the hook, and flies at its own cap, not a shove cap, until it lands', () => {
238
+ const calls = [];
239
+ const { h, hub, say, world, objects } = boot({
240
+ hooks: { grab: (x, ...args) => calls.push(args) },
241
+ });
242
+ // A throw of something not held is dropped.
243
+ say('p1', { actor: 'crate', op: 'throw' });
244
+ assert.deepEqual(calls, []);
245
+ say('p1', { actor: 'crate', op: 'grab' });
246
+ say('p1', { actor: 'crate', op: 'throw' });
247
+ assert.deepEqual(calls, [
248
+ ['p1', 'crate', 'grab'],
249
+ ['p1', 'crate', 'throw'],
250
+ ]);
251
+ assert.equal(hub.holding('p1'), null);
252
+ const crate = objects.get('crate');
253
+ assert.equal(typeof crate.speedCap, 'number');
254
+ // Still the thrower's: it flies.
255
+ h.place(world);
256
+ assert.equal(typeof crate.speedCap, 'number');
257
+ // Back to the server at speed: still flying.
258
+ crate.owner = null;
259
+ crate.body.state.v = { x: 10, y: 1, z: 0 };
260
+ h.place(world);
261
+ assert.equal(typeof crate.speedCap, 'number');
262
+ // Landed: the shove cap applies again.
263
+ crate.body.state.v = { x: 1, y: 0, z: 0 };
264
+ h.place(world);
265
+ assert.equal(crate.speedCap, undefined);
266
+ // A flight also runs out.
267
+ crate.owner = 'p1';
268
+ say('p1', { actor: 'crate', op: 'grab' });
269
+ world.timeMs += 1000;
270
+ say('p1', { actor: 'crate', op: 'throw' });
271
+ assert.equal(typeof crate.speedCap, 'number');
272
+ world.timeMs += Grab.FLIGHT_MS;
273
+ h.place(world);
274
+ assert.equal(crate.speedCap, undefined);
275
+ });
276
+
277
+ test("a flight in the server's hands never outruns the place's throw; a stale holder's throw does nothing", () => {
278
+ const { h, say, world, objects } = boot();
279
+ const crate = objects.get('crate');
280
+ say('p1', { actor: 'crate', op: 'grab' });
281
+ // The thrower says it let go at 40 m/s.
282
+ crate.body.state.v = { x: 40, y: 0, z: 0 };
283
+ say('p1', { actor: 'crate', op: 'throw' });
284
+ const speed = () => Math.hypot(crate.body.state.v.x, crate.body.state.v.y, crate.body.state.v.z);
285
+ assert.ok(speed() <= 10 * Grab.THROW_SLACK + 0.5 + 1e-9);
286
+ // Handed back to the server later at speed: held to the throw again.
287
+ crate.owner = null;
288
+ crate.body.state.v = { x: 30, y: 0, z: 0 };
289
+ h.place(world);
290
+ assert.ok(speed() <= 10 * Grab.THROW_SLACK + 0.5 + 1e-9);
291
+ // A holder whose object went to someone else cannot set it flying.
292
+ delete crate.speedCap;
293
+ crate.owner = 'p1';
294
+ world.timeMs += 10000;
295
+ h.place(world);
296
+ say('p1', { actor: 'crate', op: 'grab' });
297
+ crate.owner = 'p2';
298
+ say('p1', { actor: 'crate', op: 'throw' });
299
+ assert.equal(crate.speedCap, undefined);
300
+ });
301
+
302
+ test('hub.drop tells a holder to let go, and only holders', () => {
303
+ const { hub, say, sent } = boot();
304
+ say('p1', { actor: 'crate', op: 'grab' });
305
+ const drops = () => sent.filter(([, d]) => d.k === 'hub-drop');
306
+ assert.equal(hub.drop('p2'), 0);
307
+ assert.equal(hub.drop('p1'), 1);
308
+ assert.deepEqual(drops(), [['p1', { k: 'hub-drop', actor: 'crate' }]]);
309
+ assert.equal(hub.holding('p1'), null);
310
+ assert.equal(hub.drop(), 0);
311
+ say('p1', { actor: 'barrel', op: 'grab' });
312
+ assert.equal(hub.drop(), 1);
313
+ assert.equal(drops().length, 2);
314
+ });
315
+
316
+ test('a hold the multiplayer kit or the place ended is forgotten', () => {
317
+ const { h, hub, say, world, objects } = boot();
318
+ say('p1', { actor: 'crate', op: 'grab' });
319
+ h.place(world);
320
+ assert.equal(hub.holding('p1'), 'crate');
321
+ objects.get('crate').owner = 'p2';
322
+ h.place(world);
323
+ assert.equal(hub.holding('p1'), null);
324
+ say('p1', { actor: 'barrel', op: 'grab' });
325
+ hub.hide('barrel');
326
+ h.place(world);
327
+ assert.equal(hub.holding('p1'), null);
328
+ });
329
+
330
+ console.warn = warn;
331
+ console.log(`test-grab: ${n} passed`);