castle-web-cli 0.4.232 → 0.4.233
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.
- package/dist/agent-failures.d.ts +8 -0
- package/dist/agent-failures.js +19 -2
- package/dist/agent-prompts.d.ts +1 -1
- package/dist/agent-prompts.js +10 -3
- package/dist/agent.d.ts +64 -3
- package/dist/agent.js +170 -81
- package/dist/castle-host/host.d.ts +1 -0
- package/dist/castle-host/host.js +51 -3
- package/dist/castleJson.d.ts +4 -2
- package/dist/castleJson.js +2 -0
- package/dist/check.d.ts +3 -1
- package/dist/check.js +11 -1
- package/dist/devSessionStorage.js +47 -1
- package/dist/importPinMismatch.d.ts +22 -0
- package/dist/importPinMismatch.js +77 -0
- package/dist/importRegression.js +3 -15
- package/dist/imports.d.ts +10 -3
- package/dist/imports.js +88 -20
- package/dist/index.js +5 -4
- package/dist/init.js +1 -1
- package/dist/platformDoc.js +22 -0
- package/dist/routerFences.d.ts +5 -0
- package/dist/routerFences.js +12 -2
- package/dist/save-deck.d.ts +5 -0
- package/dist/save-deck.js +37 -4
- package/dist/serve.js +3 -0
- package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
- package/dist/shell/assets/index-MVLfNYd9.css +1 -0
- package/dist/shell/index.html +2 -2
- package/dist/taskSteer.d.ts +13 -0
- package/dist/taskSteer.js +22 -2
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +79 -2
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +1 -1
- package/kits/base/sdk/commands.d.ts +14 -0
- package/kits/base/sdk/hub.d.ts +6 -2
- package/kits/base/sdk/hub.js +13 -0
- package/kits/base/sdk/multiplayer.js +17 -1
- package/kits/base/sdk/save.js +2 -1
- package/kits/base/sdk/server/hub.d.ts +87 -0
- package/kits/base/sdk/server/hub.js +70 -0
- package/kits/base/sdk/server/platformHandle.d.ts +31 -1
- package/kits/base/sdk/server/storage.d.ts +13 -0
- package/kits/base/sdk/server/storage.js +46 -0
- package/kits/base/sdk/server/wrapper.d.ts +36 -5
- package/kits/base/sdk/server/wrapper.js +83 -8
- package/kits/hub-game/CLAUDE.md +329 -11
- package/kits/hub-game/blueprints/avatar-10.scene +28 -0
- package/kits/hub-game/blueprints/avatar-11.scene +28 -0
- package/kits/hub-game/blueprints/avatar-12.scene +28 -0
- package/kits/hub-game/blueprints/avatar-13.scene +28 -0
- package/kits/hub-game/blueprints/avatar-14.scene +28 -0
- package/kits/hub-game/blueprints/avatar-15.scene +28 -0
- package/kits/hub-game/blueprints/avatar-4.scene +28 -0
- package/kits/hub-game/blueprints/avatar-5.scene +28 -0
- package/kits/hub-game/blueprints/avatar-6.scene +28 -0
- package/kits/hub-game/blueprints/avatar-7.scene +28 -0
- package/kits/hub-game/blueprints/avatar-8.scene +28 -0
- package/kits/hub-game/blueprints/avatar-9.scene +28 -0
- package/kits/hub-game/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +309 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +251 -0
- package/kits/hub-game/code/client/ballot.js +467 -0
- package/kits/hub-game/code/client/build.js +22 -0
- package/kits/hub-game/code/client/chrome.js +1144 -50
- package/kits/hub-game/code/client/companion.js +716 -0
- package/kits/hub-game/code/client/companionDress.js +99 -0
- package/kits/hub-game/code/client/decor.js +509 -0
- package/kits/hub-game/code/client/earned.js +131 -0
- package/kits/hub-game/code/client/emoteBubble.js +75 -0
- package/kits/hub-game/code/client/grab.js +339 -20
- package/kits/hub-game/code/client/hookLayer.js +299 -13
- package/kits/hub-game/code/client/idle.js +163 -22
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +205 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -0
- package/kits/hub-game/code/client/pack.js +6 -2
- package/kits/hub-game/code/client/packFormat.js +3 -3
- package/kits/hub-game/code/client/rehello.js +167 -0
- package/kits/hub-game/code/client/shot.js +92 -0
- package/kits/hub-game/code/client/sound.js +63 -8
- package/kits/hub-game/code/client/soundscape.js +1151 -0
- package/kits/hub-game/code/client/soundscapeActions.js +99 -0
- package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
- package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
- package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
- package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
- package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
- package/kits/hub-game/code/client/soundscapeCues.js +362 -0
- package/kits/hub-game/code/client/soundscapeMap.js +181 -0
- package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
- package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
- package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
- package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
- package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
- package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
- package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
- package/kits/hub-game/code/client/soundscapeUi.js +211 -0
- package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
- package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
- package/kits/hub-game/code/client/spin.js +101 -0
- package/kits/hub-game/code/client/state.js +109 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +538 -47
- package/kits/hub-game/code/client/tiers.js +516 -27
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +32 -0
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- package/kits/hub-game/code/client/yours.js +199 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/actions.js +133 -0
- package/kits/hub-game/code/server/actors.js +9 -1
- package/kits/hub-game/code/server/ask.js +155 -0
- package/kits/hub-game/code/server/ballot.js +539 -0
- package/kits/hub-game/code/server/cells.js +100 -0
- package/kits/hub-game/code/server/companion.js +82 -0
- package/kits/hub-game/code/server/cues.js +70 -0
- package/kits/hub-game/code/server/decor.js +269 -0
- package/kits/hub-game/code/server/earned.js +461 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +232 -0
- package/kits/hub-game/code/server/history.js +5 -0
- package/kits/hub-game/code/server/hub.js +1254 -50
- package/kits/hub-game/code/server/idle.js +30 -11
- package/kits/hub-game/code/server/index.js +2 -2
- package/kits/hub-game/code/server/labels.js +28 -2
- package/kits/hub-game/code/server/manifest.js +378 -7
- package/kits/hub-game/code/server/menu.js +133 -0
- package/kits/hub-game/code/server/npcs.js +830 -80
- package/kits/hub-game/code/server/party.js +2 -2
- package/kits/hub-game/code/server/players.js +22 -0
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +124 -0
- package/kits/hub-game/code/server/vis.js +113 -0
- package/kits/hub-game/code/server/wear.js +12 -0
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/shot.js +19 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +845 -95
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +2244 -61
- package/kits/hub-game/docs/home-pieces.md +64 -0
- package/kits/hub-game/models/avatar-10.pxmodel +28 -0
- package/kits/hub-game/models/avatar-11.pxmodel +28 -0
- package/kits/hub-game/models/avatar-12.pxmodel +27 -0
- package/kits/hub-game/models/avatar-13.pxmodel +24 -0
- package/kits/hub-game/models/avatar-14.pxmodel +29 -0
- package/kits/hub-game/models/avatar-15.pxmodel +24 -0
- package/kits/hub-game/models/avatar-4.pxmodel +29 -0
- package/kits/hub-game/models/avatar-5.pxmodel +27 -0
- package/kits/hub-game/models/avatar-6.pxmodel +26 -0
- package/kits/hub-game/models/avatar-7.pxmodel +25 -0
- package/kits/hub-game/models/avatar-8.pxmodel +24 -0
- package/kits/hub-game/models/avatar-9.pxmodel +30 -0
- package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
- package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
- package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
- package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
- package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
- package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
- package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
- package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
- package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
- package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
- package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
- package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
- package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
- package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
- package/kits/hub-game/models/hats/cap.pxmodel +162 -0
- package/kits/hub-game/models/hats/captain.pxmodel +178 -0
- package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
- package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
- package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
- package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
- package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
- package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
- package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
- package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
- package/kits/hub-game/models/hats/straw.pxmodel +139 -0
- package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
- package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
- package/kits/hub-game/models/hats/witch.pxmodel +147 -0
- package/kits/hub-game/package-lock.json +2 -0
- package/kits/hub-game/package.json +2 -1
- package/kits/hub-game/scripts/check.mjs +78 -11
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
- package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
- package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
- package/kits/hub-game/scripts/gen-earned.mjs +285 -0
- package/kits/hub-game/scripts/gen-hats.mjs +827 -0
- package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
- package/kits/hub-game/scripts/test-actions.mjs +298 -0
- package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
- package/kits/hub-game/scripts/test-actors.mjs +19 -17
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask.mjs +269 -0
- package/kits/hub-game/scripts/test-attention.mjs +10 -1
- package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
- package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
- package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
- package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
- package/kits/hub-game/scripts/test-avatar.mjs +540 -7
- package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
- package/kits/hub-game/scripts/test-build.mjs +31 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +662 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
- package/kits/hub-game/scripts/test-companion.mjs +259 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
- package/kits/hub-game/scripts/test-decor.mjs +457 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1194 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
- package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
- package/kits/hub-game/scripts/test-idle.mjs +361 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +596 -0
- package/kits/hub-game/scripts/test-manifest.mjs +207 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
- package/kits/hub-game/scripts/test-menu.mjs +296 -0
- package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-picker.mjs +314 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
- package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
- package/kits/hub-game/scripts/test-shot.mjs +756 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +416 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
- package/kits/hub-game/scripts/test-tiers.mjs +477 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +343 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
- package/kits/hub-game/scripts/test-yours.mjs +372 -0
- package/kits/multiplayer-3d/CLAUDE.md +50 -0
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/avatars.js +7 -0
- package/kits/multiplayer-3d/code/client/gait.js +65 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/options.js +5 -0
- package/kits/multiplayer-3d/code/server/ownership.js +10 -2
- package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
- package/kits/multiplayer-3d/code/server/world.js +7 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
- package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
- package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
- package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
- package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
- package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
- package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/physics-2d/CLAUDE.md +9 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +253 -1
- package/kits/physics-2d/engine/skyKey.js +129 -0
- package/kits/physics-2d/engine/stillClock.js +106 -0
- package/kits/physics-2d/engine/updateBudget.js +21 -0
- package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +1169 -30
- package/kits/physics-3d/behaviors/Player.jsx +629 -72
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/pxmodel-format.md +8 -0
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
- package/kits/physics-3d/engine3d/actornode.js +86 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -0
- package/kits/physics-3d/engine3d/editorWorld.js +6 -0
- package/kits/physics-3d/engine3d/emptynodes.js +232 -0
- package/kits/physics-3d/engine3d/framecap.js +96 -0
- package/kits/physics-3d/engine3d/gait.js +118 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +507 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +37 -19
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +487 -9
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/shadowfade.js +882 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- package/kits/physics-3d/engine3d/unchanged.js +11 -0
- package/kits/physics-3d/engine3d/viewrange.js +52 -0
- package/kits/physics-3d/engine3d/world3d.js +796 -69
- package/kits/physics-3d/main.jsx +5 -0
- package/kits/physics-3d/package.json +1 -1
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- package/kits/physics-3d/scripts/test-gait.mjs +387 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
- package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
- package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
- package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +383 -6
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +97 -19
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
// On by use (v1.36): candidates, never the player's follow list. The host
|
|
2
|
+
// checks the connected player's account, age, blocks and recent client ask.
|
|
3
|
+
// The kit has no age data; friendBests keeps signed-in reporters' userId,
|
|
4
|
+
// username and best like game boards/results and per-player records. Only this
|
|
5
|
+
// gate shows them: ghost requires mutual follows, no block and both players
|
|
6
|
+
// answered over 13. Under-13 players see and show nobody; their client may ask
|
|
7
|
+
// Hub.friends, but ghost returns nothing and no data flows from that ask.
|
|
8
|
+
// Cell interest also primes candidate relations for server-only ordering;
|
|
9
|
+
// follows in either direction never become friends for the public/chat API.
|
|
10
|
+
export const USER_ID = /^\d{1,20}$/;
|
|
11
|
+
const EMPTY_MS = 40000;
|
|
12
|
+
const FRIEND_MS = 10 * 60000;
|
|
13
|
+
const MIN_READ_GAP_MS = 31000;
|
|
14
|
+
const ARRIVAL_MS = 60000;
|
|
15
|
+
const CHECK_MS = 5000;
|
|
16
|
+
const diagnostics = new WeakMap();
|
|
17
|
+
// The refusals a host or ghost answers with, by name; anything else is 'other'.
|
|
18
|
+
const REFUSAL_CODES = new Set([
|
|
19
|
+
'UNKNOWN_COMMAND',
|
|
20
|
+
'UNAVAILABLE',
|
|
21
|
+
'CAULDRON_STORAGE_INVALID_ARGUMENT',
|
|
22
|
+
'CAULDRON_STORAGE_UNAVAILABLE',
|
|
23
|
+
'CAULDRON_HUB_INVALID_ARGUMENT',
|
|
24
|
+
'CAULDRON_HUB_UNAVAILABLE',
|
|
25
|
+
'CAULDRON_HUB_FRIENDS_RATE_LIMITED',
|
|
26
|
+
'CAULDRON_HUB_FRIENDS_ACCOUNT_REQUIRED',
|
|
27
|
+
'CAULDRON_HUB_FRIENDS_AMONG_RATE_LIMITED',
|
|
28
|
+
'CAULDRON_HUB_FRIENDS_AMONG_INVALID',
|
|
29
|
+
]);
|
|
30
|
+
|
|
31
|
+
function warnOnce(session, outcome, message) {
|
|
32
|
+
let seen = diagnostics.get(session);
|
|
33
|
+
if (!seen) {
|
|
34
|
+
seen = new Set();
|
|
35
|
+
diagnostics.set(session, seen);
|
|
36
|
+
}
|
|
37
|
+
if (!seen.has(outcome)) {
|
|
38
|
+
seen.add(outcome);
|
|
39
|
+
console.warn(message);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export async function friendsAmong(h, playerId, userIds, userIdOf) {
|
|
44
|
+
try {
|
|
45
|
+
if (
|
|
46
|
+
typeof playerId !== 'string' ||
|
|
47
|
+
!USER_ID.test(userIdOf(h, playerId) ?? '') ||
|
|
48
|
+
!h.sim?.players.has(playerId) ||
|
|
49
|
+
!Array.isArray(userIds)
|
|
50
|
+
) {
|
|
51
|
+
return [];
|
|
52
|
+
}
|
|
53
|
+
const ids = [
|
|
54
|
+
...new Set(userIds.filter((id) => typeof id === 'string' && USER_ID.test(id))),
|
|
55
|
+
].slice(0, 100);
|
|
56
|
+
if (!h.friendsWanted?.has(playerId)) {
|
|
57
|
+
(h.friendsWanted ??= new Set()).add(playerId);
|
|
58
|
+
h.session?.send(playerId, { k: 'hub-friends-wanted' });
|
|
59
|
+
}
|
|
60
|
+
if (!ids.length) {
|
|
61
|
+
return [];
|
|
62
|
+
}
|
|
63
|
+
const now = Date.now();
|
|
64
|
+
const cache = (h.friendsCache ??= new Map());
|
|
65
|
+
// Retain a departing player's rate bound, but don't retain old visits forever.
|
|
66
|
+
for (const [id, entry] of cache) {
|
|
67
|
+
if (now - entry.at >= entry.ttl && !h.sim.players.has(id) && !entry.pending) {
|
|
68
|
+
cache.delete(id);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
let entry = cache.get(playerId);
|
|
72
|
+
if (h.cells) {
|
|
73
|
+
if (entry) {
|
|
74
|
+
entry.deckIds = ids;
|
|
75
|
+
}
|
|
76
|
+
if (entry?.pending) {
|
|
77
|
+
await entry.pending;
|
|
78
|
+
if (!h.sim?.players.has(playerId) || !USER_ID.test(userIdOf(h, playerId) ?? '')) {
|
|
79
|
+
return [];
|
|
80
|
+
}
|
|
81
|
+
// Another waiting ask may already have latched the covering read.
|
|
82
|
+
entry = cache.get(playerId);
|
|
83
|
+
}
|
|
84
|
+
const readAt = Date.now();
|
|
85
|
+
const placeIds = placeUsers(h, playerId, userIdOf);
|
|
86
|
+
if (!entry || (!entry.pending && readAt - entry.at >= MIN_READ_GAP_MS &&
|
|
87
|
+
(stale(entry, readAt, placeIds) || (hasNew(entry, ids) && !(entry.refused && readAt - entry.at < entry.ttl))))) {
|
|
88
|
+
entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt);
|
|
89
|
+
}
|
|
90
|
+
entry.deckIds = ids;
|
|
91
|
+
} else if (!entry || (!entry.pending && now - entry.at >= entry.ttl)) {
|
|
92
|
+
// Keyless calls keep the original TTL, candidates and pending behavior.
|
|
93
|
+
entry = startRead(h, playerId, ids, now);
|
|
94
|
+
}
|
|
95
|
+
await entry.pending;
|
|
96
|
+
return ids.filter((id) => entry.ids.includes(id));
|
|
97
|
+
} catch {
|
|
98
|
+
return [];
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
function placeUsers(h, playerId, userIdOf) {
|
|
103
|
+
return [...h.sim.players.keys()]
|
|
104
|
+
.filter((id) => id !== playerId)
|
|
105
|
+
.map((id) => userIdOf(h, id))
|
|
106
|
+
.filter((id) => typeof id === 'string' && USER_ID.test(id));
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
function hasNew(entry, placeIds) {
|
|
110
|
+
const asked = new Set(entry.asked);
|
|
111
|
+
return placeIds.some((id) => !asked.has(id));
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
function stale(entry, now, placeIds) {
|
|
115
|
+
const age = now - entry.at;
|
|
116
|
+
return age >= entry.ttl || (age >= ARRIVAL_MS && hasNew(entry, placeIds));
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
function startRead(h, playerId, ids, now) {
|
|
120
|
+
const entry = {
|
|
121
|
+
at: now, ttl: EMPTY_MS, ids: [], follows: [], followedBy: [], asked: ids, pending: null,
|
|
122
|
+
};
|
|
123
|
+
(h.friendsCache ??= new Map()).set(playerId, entry);
|
|
124
|
+
// Latch before awaiting: deck asks and background primes share this read.
|
|
125
|
+
entry.pending = read(h, playerId, ids).then((answer) => {
|
|
126
|
+
entry.ids = answer.friends;
|
|
127
|
+
entry.follows = answer.follows;
|
|
128
|
+
entry.followedBy = answer.followedBy;
|
|
129
|
+
entry.ttl = answer.friends.length ? FRIEND_MS : EMPTY_MS;
|
|
130
|
+
entry.refused = answer.refused === true;
|
|
131
|
+
entry.pending = null;
|
|
132
|
+
});
|
|
133
|
+
return entry;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
// Called after hello, and from the throttled tick check for early hellos/arrivals.
|
|
137
|
+
export function prime(h, playerId, userIdOf, placeIds) {
|
|
138
|
+
if (!h.cells || !h.players.get(playerId)?.hello || !h.sim?.players.has(playerId) ||
|
|
139
|
+
!USER_ID.test(userIdOf(h, playerId) ?? '')) {
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
const entry = h.friendsCache?.get(playerId);
|
|
143
|
+
if (entry?.pending) {
|
|
144
|
+
return;
|
|
145
|
+
}
|
|
146
|
+
const now = Date.now();
|
|
147
|
+
placeIds ??= placeUsers(h, playerId, userIdOf);
|
|
148
|
+
// Expiry retries even for an unchanged roster, including refused reads.
|
|
149
|
+
// Non-empty mutual-friend entries also refresh for arrivals after a minute.
|
|
150
|
+
if (entry && (now - entry.at < MIN_READ_GAP_MS || !stale(entry, now, placeIds))) {
|
|
151
|
+
return;
|
|
152
|
+
}
|
|
153
|
+
const ids = [...new Set([...(entry?.deckIds ?? []), ...placeIds])].slice(0, 100);
|
|
154
|
+
if (ids.length) {
|
|
155
|
+
const fresh = startRead(h, playerId, ids, now);
|
|
156
|
+
fresh.deckIds = entry?.deckIds ?? [];
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
export function tick(h, userIdOf) {
|
|
161
|
+
if (!h.cells || !h.sim) {
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
const now = Date.now();
|
|
165
|
+
if (now - (h.friendsCheckAt ?? -Infinity) < CHECK_MS) {
|
|
166
|
+
return;
|
|
167
|
+
}
|
|
168
|
+
h.friendsCheckAt = now;
|
|
169
|
+
const users = new Map([...h.sim.players.keys()].map((id) => [id, userIdOf(h, id)]));
|
|
170
|
+
const ids = [...users.values()].filter((id) => typeof id === 'string' && USER_ID.test(id));
|
|
171
|
+
for (const [playerId, userId] of users) {
|
|
172
|
+
prime(h, playerId, (_h, id) => users.get(id), ids.filter((id) => id !== userId));
|
|
173
|
+
}
|
|
174
|
+
for (const [id, entry] of h.friendsCache ?? []) {
|
|
175
|
+
if (now - entry.at >= entry.ttl && !h.sim.players.has(id) && !entry.pending) {
|
|
176
|
+
h.friendsCache.delete(id);
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
async function read(h, playerId, ids) {
|
|
182
|
+
const empty = { friends: [], follows: [], followedBy: [] };
|
|
183
|
+
try {
|
|
184
|
+
if (!h.session?.hub) {
|
|
185
|
+
// Only the local serve has a dev session id; a production named session
|
|
186
|
+
// without hub ops must still fail closed, even with this env var set.
|
|
187
|
+
return String(h.session?.sessionId ?? '').startsWith('dev') &&
|
|
188
|
+
typeof process !== 'undefined' &&
|
|
189
|
+
process.env.CASTLE_DEV_HUB_FRIENDS === 'all'
|
|
190
|
+
? { ...empty, friends: ids }
|
|
191
|
+
: empty;
|
|
192
|
+
}
|
|
193
|
+
if (h.cells && typeof h.session.hub.relationsAmong === 'function') {
|
|
194
|
+
const answer = await h.session.hub.relationsAmong(playerId, ids);
|
|
195
|
+
const list = (value) => Array.isArray(value) ? ids.filter((id) => value.includes(id)) : [];
|
|
196
|
+
const relations = {
|
|
197
|
+
friends: list(answer?.friends),
|
|
198
|
+
follows: list(answer?.follows),
|
|
199
|
+
followedBy: list(answer?.followedBy),
|
|
200
|
+
};
|
|
201
|
+
if (answer && typeof answer === 'object') {
|
|
202
|
+
warnOnce(h.session, 'answered', `[hub] friendsAmong: answered ${relations.friends.length} of ${ids.length}`);
|
|
203
|
+
}
|
|
204
|
+
return relations;
|
|
205
|
+
}
|
|
206
|
+
const answer = await h.session.hub.friendsAmong?.(playerId, ids);
|
|
207
|
+
const friends = Array.isArray(answer) ? ids.filter((id) => answer.includes(id)) : [];
|
|
208
|
+
if (Array.isArray(answer)) {
|
|
209
|
+
warnOnce(h.session, 'answered', `[hub] friendsAmong: answered ${friends.length} of ${ids.length}`);
|
|
210
|
+
}
|
|
211
|
+
return { ...empty, friends };
|
|
212
|
+
} catch (error) {
|
|
213
|
+
// Only a platform code's shape is logged (never a message, which may name someone).
|
|
214
|
+
const code = typeof error?.code === 'string' ? error.code : '';
|
|
215
|
+
const reason = REFUSAL_CODES.has(code) ? code : 'other';
|
|
216
|
+
warnOnce(h.session, `refused:${reason}`, `[hub] friendsAmong refused: ${reason}`);
|
|
217
|
+
return { ...empty, refused: true };
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
export function resend(h, playerId) {
|
|
222
|
+
if (h.friendsWanted?.has(playerId)) {
|
|
223
|
+
h.session?.send(playerId, { k: 'hub-friends-wanted' });
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
export function forget(h, playerId) {
|
|
228
|
+
h.friendsWanted?.delete(playerId);
|
|
229
|
+
for (const helper of h.friendBestHelpers?.values() ?? []) {
|
|
230
|
+
helper.forget(playerId);
|
|
231
|
+
}
|
|
232
|
+
}
|
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
// calling the host's results read itself. Only where the host has hub ops;
|
|
6
6
|
// null on the dev serve and for an anonymous player.
|
|
7
7
|
|
|
8
|
+
import { cleanHearts } from './yours.js';
|
|
9
|
+
|
|
8
10
|
export const HISTORY_EVERY_MS = 60000;
|
|
9
11
|
const MAX_ROWS = 20;
|
|
10
12
|
const MAX_USERS = 24;
|
|
@@ -52,6 +54,9 @@ export function take(h, playerId, read, startedAt = Date.now()) {
|
|
|
52
54
|
if (!entry || !read || (entry.historyFrom ?? -Infinity) > startedAt) {
|
|
53
55
|
return;
|
|
54
56
|
}
|
|
57
|
+
if (h.manifest?.yourGames) {
|
|
58
|
+
entry.hearts = cleanHearts(read.hearts);
|
|
59
|
+
}
|
|
55
60
|
entry.historyFrom = startedAt;
|
|
56
61
|
entry.history = {
|
|
57
62
|
recent: (Array.isArray(read.recent) ? read.recent : []).slice(0, MAX_ROWS).map(cleanRow),
|