castle-web-cli 0.4.256 → 0.4.258

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.
@@ -10,8 +10,8 @@
10
10
  <link rel="icon" type="image/png" sizes="32x32" href="/__castle/ide/favicon-32x32.png" />
11
11
  <link rel="icon" type="image/png" sizes="16x16" href="/__castle/ide/favicon-16x16.png" />
12
12
  <link rel="icon" href="/__castle/ide/favicon.ico" sizes="any" />
13
- <script type="module" crossorigin src="/__castle/ide/assets/index-Bec6LpAv.js"></script>
14
- <link rel="stylesheet" crossorigin href="/__castle/ide/assets/index-MVLfNYd9.css">
13
+ <script type="module" crossorigin src="/__castle/ide/assets/index-qtHLrC99.js"></script>
14
+ <link rel="stylesheet" crossorigin href="/__castle/ide/assets/index-BRjUJ9rX.css">
15
15
  </head>
16
16
  <body>
17
17
  <div id="root"></div>
@@ -82,7 +82,7 @@
82
82
  "title": "base",
83
83
  "deckId": "yRcmH4_aYllE",
84
84
  "cardId": "zkFdingmIm3m",
85
- "publishedVersion": "2026-11-19T09:37:15.255Z",
85
+ "publishedVersion": "2026-11-20T01:08:40.176Z",
86
86
  "provides": [
87
87
  "castle-web-sdk"
88
88
  ]
@@ -155,6 +155,20 @@ is. `session.place` is the hub place the host started the session for (see
155
155
  [`session.hub`](#sessionhub)), and `null` otherwise. It is never taken from a
156
156
  client.
157
157
 
158
+ ### `session.sessionSecret` and `session.assets.read`
159
+
160
+ Both are available in `onStart`. `session.sessionSecret` is the host-provided
161
+ signing key for this session, or `undefined` when the host supplies no key.
162
+ The key is read-only and omitted from object inspection, spread, and default JSON
163
+ serialization. Code that names the property, by reading it or by passing it in a
164
+ `JSON.stringify` property list, gets the key. Read it directly through `session.sessionSecret`.
165
+ Keep the key server-side and out of messages, logs, and storage.
166
+
167
+ `await session.assets.read(name)` returns the exact bytes of a mounted session
168
+ asset as a `Uint8Array`, or `null` if the name is absent. On older runtimes
169
+ without session asset support, the promise rejects with an unavailable error.
170
+ `session.assets` is omitted from object keys, spread, and JSON serialization.
171
+
158
172
  ### `session.storage`
159
173
 
160
174
  A session ends when its last player leaves, and its memory goes with it.
@@ -41,6 +41,8 @@ export interface PlatformWorldTimeConfig {
41
41
  advance: "wallClock";
42
42
  }
43
43
  export interface PlatformHandle {
44
+ readonly sessionSecret?: string;
45
+ readAsset?(name: string): Promise<Uint8Array | null>;
44
46
  send(connId: string, text: string): void;
45
47
  broadcast(text: string): void;
46
48
  sendBinary?(connId: string, bytes: Uint8Array | ArrayBuffer): void;
@@ -22,6 +22,10 @@ export interface MultiplayerServerSession {
22
22
  readonly sessionId: string;
23
23
  readonly deckId: string;
24
24
  readonly mode: MultiplayerSessionMode;
25
+ readonly sessionSecret?: string;
26
+ readonly assets: {
27
+ read(name: string): Promise<Uint8Array | null>;
28
+ };
25
29
  /**
26
30
  * The place the host started this session for (a hub door's destination, or
27
31
  * the hub place ghost pinned the session to), or null when the host stamped
@@ -247,7 +247,7 @@ function createAuthorSession(platformHandle, players, arrivals, hidden, variants
247
247
  return Boolean(hidden.get(a)?.has(userB) || hidden.get(b)?.has(userA));
248
248
  });
249
249
  const world = createServerWorld(platformHandle);
250
- return {
250
+ const session = {
251
251
  get players() {
252
252
  return Array.from(players.values());
253
253
  },
@@ -257,6 +257,14 @@ function createAuthorSession(platformHandle, players, arrivals, hidden, variants
257
257
  place: typeof platformHandle.config.place === "string"
258
258
  ? platformHandle.config.place
259
259
  : hub?.place ?? null,
260
+ assets: {
261
+ async read(name) {
262
+ if (typeof platformHandle.readAsset !== "function") {
263
+ throw new TypeError("This Castle runtime does not support session assets yet.");
264
+ }
265
+ return platformHandle.readAsset(name);
266
+ },
267
+ },
260
268
  storage: createServerStorage(platformHandle),
261
269
  world,
262
270
  characters: world?.characters ?? createPlaceCharacters(platformHandle),
@@ -308,6 +316,26 @@ function createAuthorSession(platformHandle, players, arrivals, hidden, variants
308
316
  platformHandle.disconnect(playerId, reason ?? 1000);
309
317
  },
310
318
  };
319
+ Object.defineProperty(session, "assets", { enumerable: false });
320
+ // Inspectors can invoke getters. Keep the key in a closure off the inspected target.
321
+ const sessionSecret = platformHandle.sessionSecret;
322
+ return new Proxy(session, {
323
+ get(target, property, receiver) {
324
+ if (property === "sessionSecret")
325
+ return sessionSecret;
326
+ return Reflect.get(target, property, receiver);
327
+ },
328
+ set(target, property, value, receiver) {
329
+ if (property === "sessionSecret")
330
+ return false;
331
+ return Reflect.set(target, property, value, receiver);
332
+ },
333
+ defineProperty(target, property, descriptor) {
334
+ if (property === "sessionSecret")
335
+ return false;
336
+ return Reflect.defineProperty(target, property, descriptor);
337
+ },
338
+ });
311
339
  }
312
340
  const WORLD_OPERATION_ID_MAX_BYTES = 128;
313
341
  const WORLD_OPERATION_ID_MAX_CHARACTERS = 120;
@@ -18,7 +18,7 @@
18
18
  "autoUpdateWhenImported": true,
19
19
  "deckId": "K6-Xs7dCoMVi",
20
20
  "cardId": "Kh_08IYATpC3",
21
- "publishedVersion": "2026-09-22T19:49:03.070Z",
21
+ "publishedVersion": "2026-11-20T01:08:45.103Z",
22
22
  "server": {
23
23
  "main": "code/server/index.js",
24
24
  "maxPlayers": 8,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "castle-web-cli",
3
- "version": "0.4.256",
3
+ "version": "0.4.258",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/castle-xyz/castle-experimental-web.git"
@@ -12,7 +12,7 @@
12
12
  "scripts": {
13
13
  "build": "rm -rf dist && tsc && chmod +x dist/index.js && vite build && vite build -c vite.cover-bridge.config.ts && cp -R src/castle-host dist/castle-host && chmod -R u+w kits 2>/dev/null; rm -rf kits && cp -R ../kits kits && chmod -R u+w kits && rm -rf kits/*/imports && node ../scripts/vendor-three.mjs",
14
14
  "dev": "tsc --watch",
15
- "check": "node ../scripts/sync-shared.mjs --check && node ../scripts/tests/icon-registry.mjs && node ../scripts/tests/sandbox-graphql-fields.mjs && node ../scripts/tests/kit-package-json.mjs && node ../scripts/tests/kit-catalog.mjs && node ../scripts/tests/import-order.mjs && node ../scripts/tests/import-deck-ref.mjs && node ../scripts/tests/restore-pinned-import.mjs && node ../scripts/tests/hub-server-config.mjs && node ../scripts/tests/server-invites-config.mjs && node ../scripts/tests/save-failure-reason.mjs && node ../scripts/tests/save-drop-guard.mjs && node ../scripts/tests/flow-draft-status.mjs && node ../scripts/tests/router-fences.mjs && node ../scripts/tests/held-tasks.mjs && node ../scripts/tests/task-archive.mjs && node ../scripts/tests/held-task-prompts.mjs && node ../scripts/tests/router-stops.mjs && node ../scripts/tests/task-steer.mjs && node ../scripts/tests/task-steer-store.mjs && node ../scripts/tests/task-steer-line.mjs && node ../scripts/tests/router-task-endings.mjs && node ../scripts/tests/router-task-report.mjs && node ../scripts/tests/task-resume.mjs && node ../scripts/tests/task-model-request.mjs && node ../scripts/tests/plan-answered-questions.mjs && node ../scripts/tests/plan-no-standing-nudge.mjs && node ../scripts/tests/sdk-readme-limits.mjs && node ../scripts/tests/task-account.mjs && node ../scripts/tests/effort-support.mjs && node ../scripts/tests/cli-login-pkce.mjs && node ../scripts/tests/publish-timeout.mjs && node ../scripts/tests/bundle-latin1.mjs && eslint . && jscpd && tsc --noEmit && tsc --noEmit -p src/shell/tsconfig.json"
15
+ "check": "node ../scripts/sync-shared.mjs --check && node ../scripts/tests/icon-registry.mjs && node ../scripts/tests/sandbox-graphql-fields.mjs && node ../scripts/tests/kit-package-json.mjs && node ../scripts/tests/kit-catalog.mjs && node ../scripts/tests/import-order.mjs && node ../scripts/tests/import-deck-ref.mjs && node ../scripts/tests/restore-pinned-import.mjs && node ../scripts/tests/hub-server-config.mjs && node ../scripts/tests/server-invites-config.mjs && node ../scripts/tests/save-failure-reason.mjs && node ../scripts/tests/save-drop-guard.mjs && node ../scripts/tests/flow-draft-status.mjs && node ../scripts/tests/router-fences.mjs && node ../scripts/tests/held-tasks.mjs && node ../scripts/tests/task-archive.mjs && node ../scripts/tests/held-task-prompts.mjs && node ../scripts/tests/router-stops.mjs && node ../scripts/tests/task-steer.mjs && node ../scripts/tests/agent-retry-activity.mjs && node ../scripts/tests/task-steer-store.mjs && node ../scripts/tests/task-steer-line.mjs && node ../scripts/tests/router-task-endings.mjs && node ../scripts/tests/router-task-report.mjs && node ../scripts/tests/task-resume.mjs && node ../scripts/tests/task-model-request.mjs && node ../scripts/tests/plan-answered-questions.mjs && node ../scripts/tests/plan-no-standing-nudge.mjs && node ../scripts/tests/sdk-readme-limits.mjs && node ../scripts/tests/task-account.mjs && node ../scripts/tests/effort-support.mjs && node ../scripts/tests/model-experiment.mjs && node ../scripts/tests/cli-login-pkce.mjs && node ../scripts/tests/publish-timeout.mjs && node ../scripts/tests/release-plan.mjs && node ../scripts/tests/bundle-latin1.mjs && eslint . && jscpd && tsc --noEmit && tsc --noEmit -p src/shell/tsconfig.json"
16
16
  },
17
17
  "jscpd": {
18
18
  "path": [