castle-web-sdk 0.4.44 → 0.4.46

package/dist/store.d.ts

@@ -1,5 +1,6 @@
 import type { StoreAllowance } from "./commands";
 import type { Json } from "./types";
+import { type SaveApi, type SaveBucketApi } from "./save";
 export interface StoreListOptions {
     /** Only keys beginning with this. Omit for every key in the scope. */
     prefix?: string;
@@ -21,7 +22,7 @@ export interface StoreListPage<T extends Json = Json> {
      */
     cursor: string | null;
 }
-export interface StoreScopeApi {
+export interface StoreScopeApi extends SaveBucketApi {
     /** Reads keys. Keys with no value are absent from the result. */
     get<T extends Json = Json>(keys: string[]): Promise<Record<string, T>>;
     /**
@@ -63,7 +64,7 @@ export interface StoreUsage {
     /** `Store.deck`: one allowance shared by every player of the deck. */
     shared: StoreAllowance;
 }
-export interface CastleStoreApi {
+export interface CastleStoreApi extends SaveApi {
     /** Shared by everyone playing the deck. */
     readonly deck: StoreScopeApi;
     /** The current player's data, which other players can read. */

package/dist/store.js

@@ -2,6 +2,7 @@ import { chunked } from "./chunk";
 import { decodeStorageValue, encodeStorageValue, storageError } from "./storageJson";
 import { hostRequest } from "./transport";
 import { onUnloadFlush } from "./unloadFlush";
+import { createSaveApi, createSaveBucket, } from "./save";
 // Per-key deck storage for Cauldron decks.
 //
 // The older Storage/SharedStorage keep one document per bucket and rewrite the
@@ -212,6 +213,7 @@ function assertKeys(keys, operation) {
 }
 function createScope(scope, subject) {
     return {
+        ...createSaveBucket(saveApi, scope, subject ?? undefined),
         async get(keys) {
             const { entries } = await hostRequest("cauldronStorage.get", {
                 scope,
@@ -309,7 +311,10 @@ async function usage() {
     const { usage: allowances } = await hostRequest("cauldronStorage.usage", {});
     return { player: allowances.player, shared: allowances.shared };
 }
+// Saves skip the write coalescing above: each is one request, sent at once.
+const saveApi = createSaveApi((verb, input) => hostRequest(`cauldronStorage.${verb}`, input));
 export const Store = {
+    ...saveApi,
     deck: createScope("deck", null),
     me: createScope("user", null),
     user(userId) {

package/dist/transport.d.ts

@@ -1,4 +1,4 @@
-import { type CommandName, type CommandParams, type CommandResult, type LifecycleEvent, type VoiceEvent } from "./commands";
+import { type CommandName, type CommandParams, type CommandResult, type HubEvent, type LifecycleEvent, type VoiceEvent } from "./commands";
 type PostChannel = "mobile" | "web";
 export interface HostStreamOptions {
     onStream?: (event: unknown) => void;
@@ -21,5 +21,6 @@ export declare function hostNotify(event: LifecycleEvent): void;
 export declare function postUnloadDone(unloadId: string, state?: string): void;
 export declare function setUnloadHandler(handler: (unloadId: string) => void): void;
 export declare function setVoiceEventHandler(handler: ((event: VoiceEvent) => void) | null): void;
+export declare function setHubEventHandler(handler: ((event: HubEvent) => void) | null): void;
 export declare function installHostListener(): void;
 export {};

package/dist/transport.js

@@ -11,7 +11,7 @@
 // A streaming command (agent.chat) gets stream envelopes on its requestId before
 // its response. Each one goes to the caller's onStream and restarts the wait,
 // and the caller's AbortSignal sends the host a cancel envelope.
-import { CASTLE_SDK_PROTOCOL, COMMAND_TIMEOUTS_MS, STREAM_IDLE_TIMEOUT_MS, isResponseEnvelope, isStreamEnvelope, unloadRequestId, voiceEventFrom, } from "./commands";
+import { CASTLE_SDK_PROTOCOL, COMMAND_TIMEOUTS_MS, STREAM_IDLE_TIMEOUT_MS, isResponseEnvelope, isStreamEnvelope, hubEventFrom, unloadRequestId, voiceEventFrom, } from "./commands";
 import { getCastleEmbed } from "./context";
 import { CastleError } from "./errors";
 import { cancelLocalCommand, releaseLocalCommand, sendLocalCommand } from "./runtime";
@@ -35,6 +35,7 @@ const pending = new Map();
 let listenersInstalled = false;
 let unloadHandler = null;
 let voiceEventHandler = null;
+let hubEventHandler = null;
 export async function hostRequest(command, params, stream = {}) {
     try {
         const env = await sendCommand(resolveChannel(), command, params, stream);
@@ -103,6 +104,12 @@ export function setVoiceEventHandler(handler) {
     if (handler)
         installHostListener();
 }
+// Registered by hub.ts while the deck listens for the host's Back control.
+export function setHubEventHandler(handler) {
+    hubEventHandler = handler;
+    if (handler)
+        installHostListener();
+}
 function resolveChannel() {
     if (typeof window === "undefined")
         return "local";
@@ -233,6 +240,11 @@ function receive(message) {
         voiceEventHandler?.(voiceEvent);
         return;
     }
+    const hubEvent = hubEventFrom(message);
+    if (hubEvent) {
+        hubEventHandler?.(hubEvent);
+        return;
+    }
     const unloadId = unloadRequestId(message);
     if (unloadId !== null)
         unloadHandler?.(unloadId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-sdk",
-  "version": "0.4.44",
+  "version": "0.4.46",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/castle-xyz/castle-experimental-web.git"