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