@rydr/game-sdk 8.16.0 → 8.17.0

package/dist/protocol/version.d.ts

@@ -9,5 +9,5 @@
 export declare const RYDR_PROTOCOL_VERSION: 32;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export declare const RYDR_SDK_VERSION = "8.16.0";
+export declare const RYDR_SDK_VERSION = "8.17.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/protocol/version.js

@@ -217,5 +217,5 @@
 export const RYDR_PROTOCOL_VERSION = 32;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export const RYDR_SDK_VERSION = "8.16.0";
+export const RYDR_SDK_VERSION = "8.17.0";
 //# sourceMappingURL=version.js.map

package/dist/three/README.md

@@ -22,6 +22,8 @@ import { loadWorld, mergeByMaterial, PerfOverlay, ScreenAnchor } from "@rydr/gam
 | `createGlbLoader` | fn | A configured GLB→`Object3D` loader (DRACO, caching) when you load assets yourself. |
 | `applyPlacement` | fn | Apply a `WorldPlacement` (position/rotation/scale) to a group. |
 | `clearWorldCache` | fn | Drop cached loaded worlds (by id, or all). |
+| `createGlbCache` | fn | The **persistent** GLB byte store (Cache Storage) that survives the shell destroying the game's iframe. On by default inside `loadWorld`/`createGlbLoader`; call it directly to show or clear the store. |
+| `requestPersistentStorage` | fn | Ask the browser to exempt this origin's storage from eviction. For the **shell** to call, not a guest game. |
 | `mergeByMaterial` | fn | Merge a subtree's meshes by shared material → far fewer draw calls. |
 | `ScreenAnchor` | class | Hover a DOM UI element a fixed height above the **top** of a 3D object, projected to screen px. |
 | `WaypointBeacon` | class | A "go here" glow beacon (column + base + expanding ground waves) that gracefully fades out when reached. |
@@ -35,6 +37,51 @@ import { loadWorld, mergeByMaterial, PerfOverlay, ScreenAnchor } from "@rydr/gam
 
 ---
 
+## Worlds are cached across the iframe being destroyed
+
+`loadWorld` already keeps a world in memory (GPU resources by `CoreWorld.id`, decoded GLBs by URL
+path), but the shell **destroys the game's iframe** when the rider leaves — and every in-memory cache
+goes with it. Under those two sits a third: the raw GLB bytes in Cache Storage, which survives the
+document. A rider who comes back re-decodes the map instead of re-downloading it.
+
+It is **on by default** and there is nothing to wire up:
+
+```ts
+const world = await loadWorld(coreWorld, { mergeStatics: true });
+// first ever visit:            downloads the map (a base map is 3-73 MB today)
+// after the iframe is killed:  same call, no download
+```
+
+Measured on a real platform world (73 MB base map, HTTP cache disabled so only Cache Storage can
+serve it): **2889 ms → 41 ms, 0 bytes over the wire** in a fresh document.
+
+The store is keyed by the asset URL's **path**, which is safe because a world upload mints a fresh
+uuid per object key (`worlds/<kind>/<uuid>-<file>.glb`) — re-uploading a map produces a new path,
+never new bytes at an old one. It holds 512 MB by default and evicts **least-recently-used** past
+that.
+
+```ts
+import { createGlbCache, requestPersistentStorage } from "@rydr/game-sdk/three";
+
+await loadWorld(coreWorld, { cache: { maxBytes: 256 * 1024 * 1024 } }); // smaller budget
+await loadWorld(coreWorld, { cache: false });                            // off (a cold-load bench)
+
+const store = createGlbCache();
+await store.stats();   // { entries, bytes } — for a dev panel
+await store.clear();   // drop the lot
+```
+
+Two things worth knowing:
+
+- **The HTTP cache is not a substitute.** Platform assets are served with no `Cache-Control` at all,
+  so a browser is free to re-fetch whenever it likes; what it does instead is apply *heuristic*
+  freshness, and a 73 MB entry is the first thing evicted when a real profile fills up.
+- **`requestPersistentStorage()` is the shell's to call,** not a guest game's — some browsers prompt,
+  and the decision is scored against the first-party origin. Without it the store is merely
+  best-effort (still evicted long after the HTTP cache would be).
+
+---
+
 ## `ScreenAnchor` — float UI above a 3D object
 
 The canonical "name tag / button prompt / health bar hovering over a thing" placement. **Do not

package/dist/three/glb-cache.d.ts

@@ -0,0 +1,87 @@
+/**
+ * glb-cache — a **persistent** byte cache for GLB assets, in the browser's Cache Storage.
+ *
+ * ## Why this exists
+ *
+ * A game runs in a cross-origin iframe that the shell **destroys** when the rider leaves it. Every
+ * in-memory cache dies with it: the per-world handle cache in {@link import("./world-loader.js").loadWorld}
+ * and the per-URL dedup inside {@link import("./world-loader.js").createGlbLoader} both start empty on
+ * the next visit. So a rider who plays, leaves, and comes back downloads the whole map again — and a
+ * platform world's base map is 3–73 MB today.
+ *
+ * The HTTP cache is not an answer to this. Platform assets are served from R2 with **no
+ * `Cache-Control` header at all**, so a browser is free to re-fetch at will; what it does instead is
+ * apply *heuristic* freshness, which happens to work on an empty profile and is exactly what gets
+ * evicted first on a full one (a 73 MB entry is the cheapest thing a browser can throw away). Cache
+ * Storage is a promise rather than a hint: it is origin-scoped, survives the document, and is only
+ * cleared under real storage pressure — and never before the HTTP cache (see
+ * {@link requestPersistentStorage} to take it off the eviction list entirely).
+ *
+ * ## The key is the URL PATH
+ *
+ * Same rule as the in-memory dedup in `createGlbLoader`: platform assets can arrive with per-request
+ * query strings, so the path is the asset's identity. That is safe *because* a world upload mints a
+ * fresh uuid per object key (`worlds/<kind>/<uuid>-<filename>.glb`) — re-uploading a map produces a
+ * new path, never new bytes at an old one. A cached path can therefore never be stale.
+ *
+ * ## Degrading
+ *
+ * Everything here is best-effort by construction: no Cache Storage (an insecure context, a browser
+ * with storage disabled, a quota refusal) means {@link GlbCache.bytes} still fetches and still
+ * resolves — it just doesn't remember. A caller never needs to branch on availability.
+ */
+export interface GlbCacheOptions {
+    /** Cache Storage bucket name. Default `"rydr-glb-v1"`. */
+    name?: string;
+    /**
+     * Byte budget. Once a write takes the store past it, least-recently-USED entries are deleted
+     * until it fits again. Default 512 MB.
+     */
+    maxBytes?: number;
+}
+/** What the store currently holds. */
+export interface GlbCacheStats {
+    entries: number;
+    bytes: number;
+}
+/**
+ * A persistent GLB byte store. Created by {@link createGlbCache}; wired into
+ * {@link import("./world-loader.js").createGlbLoader} by default, so most games never touch it
+ * directly — reach for it when you load GLBs yourself, or to show/clear the store in a dev panel.
+ */
+export interface GlbCache {
+    /**
+     * The bytes for `url` — from the store when it has them, otherwise fetched and stored.
+     *
+     * Rejects exactly when a plain `fetch` would: a network failure or a non-2xx response. A storage
+     * failure never rejects (the bytes are returned uncached).
+     */
+    bytes(url: string): Promise<ArrayBuffer>;
+    /** Entry count + total bytes held. `{ entries: 0, bytes: 0 }` where Cache Storage is unavailable. */
+    stats(): Promise<GlbCacheStats>;
+    /** Delete every entry in this bucket. */
+    clear(): Promise<void>;
+}
+/** Whether this context can persist anything at all (Cache Storage needs a secure context). */
+export declare function glbCacheAvailable(): boolean;
+/**
+ * The cache key for an asset URL: its origin + path, with the query string and fragment dropped.
+ * Exported because it is the identity the whole store is keyed on — a dev panel listing entries
+ * wants the same answer.
+ */
+export declare function glbCacheKey(url: string): string;
+/**
+ * Ask the browser to make this origin's storage **persistent** — exempt from eviction under disk
+ * pressure, instead of merely best-effort.
+ *
+ * Not called automatically, and deliberately: some browsers surface a permission prompt, which is
+ * the shell's call to make (and the shell is the first-party origin whose engagement the decision is
+ * scored on), not a guest game's. Resolves `false` when the browser declines or doesn't support it.
+ */
+export declare function requestPersistentStorage(): Promise<boolean>;
+/**
+ * Open (lazily) a persistent GLB byte store. Cheap to call — nothing touches storage until the first
+ * {@link GlbCache.bytes}.
+ */
+export declare function createGlbCache(opts?: GlbCacheOptions): GlbCache;
+//# sourceMappingURL=glb-cache.d.ts.map

package/dist/three/glb-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glb-cache.d.ts","sourceRoot":"","sources":["../../src/three/glb-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAcH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,qGAAqG;IACrG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,yCAAyC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,eAAoB,GAAG,QAAQ,CA6FnE"}

package/dist/three/glb-cache.js

@@ -0,0 +1,272 @@
+/**
+ * glb-cache — a **persistent** byte cache for GLB assets, in the browser's Cache Storage.
+ *
+ * ## Why this exists
+ *
+ * A game runs in a cross-origin iframe that the shell **destroys** when the rider leaves it. Every
+ * in-memory cache dies with it: the per-world handle cache in {@link import("./world-loader.js").loadWorld}
+ * and the per-URL dedup inside {@link import("./world-loader.js").createGlbLoader} both start empty on
+ * the next visit. So a rider who plays, leaves, and comes back downloads the whole map again — and a
+ * platform world's base map is 3–73 MB today.
+ *
+ * The HTTP cache is not an answer to this. Platform assets are served from R2 with **no
+ * `Cache-Control` header at all**, so a browser is free to re-fetch at will; what it does instead is
+ * apply *heuristic* freshness, which happens to work on an empty profile and is exactly what gets
+ * evicted first on a full one (a 73 MB entry is the cheapest thing a browser can throw away). Cache
+ * Storage is a promise rather than a hint: it is origin-scoped, survives the document, and is only
+ * cleared under real storage pressure — and never before the HTTP cache (see
+ * {@link requestPersistentStorage} to take it off the eviction list entirely).
+ *
+ * ## The key is the URL PATH
+ *
+ * Same rule as the in-memory dedup in `createGlbLoader`: platform assets can arrive with per-request
+ * query strings, so the path is the asset's identity. That is safe *because* a world upload mints a
+ * fresh uuid per object key (`worlds/<kind>/<uuid>-<filename>.glb`) — re-uploading a map produces a
+ * new path, never new bytes at an old one. A cached path can therefore never be stale.
+ *
+ * ## Degrading
+ *
+ * Everything here is best-effort by construction: no Cache Storage (an insecure context, a browser
+ * with storage disabled, a quota refusal) means {@link GlbCache.bytes} still fetches and still
+ * resolves — it just doesn't remember. A caller never needs to branch on availability.
+ */
+/** Cache Storage bucket name. Bump the suffix to orphan every previous entry at once. */
+const DEFAULT_CACHE_NAME = "rydr-glb-v1";
+/** Default byte budget for the store — a handful of maps, at 3–73 MB each. */
+const DEFAULT_MAX_BYTES = 512 * 1024 * 1024;
+/** Where the recency index is parked. Never fetched — it is a Cache Storage key, not a real URL. */
+const INDEX_URL = "https://rydr-glb-cache.invalid/index.json";
+/** Response header carrying an entry's byte length, so a trim needn't read bodies. */
+const BYTES_HEADER = "x-rydr-bytes";
+/** Whether this context can persist anything at all (Cache Storage needs a secure context). */
+export function glbCacheAvailable() {
+    // `!== false` rather than a truthiness test: a runtime that doesn't define `isSecureContext` at all
+    // (a worker in an older browser) still has a usable `caches`.
+    return typeof caches !== "undefined" && globalThis.isSecureContext !== false;
+}
+/**
+ * The cache key for an asset URL: its origin + path, with the query string and fragment dropped.
+ * Exported because it is the identity the whole store is keyed on — a dev panel listing entries
+ * wants the same answer.
+ */
+export function glbCacheKey(url) {
+    const cut = url.search(/[?#]/);
+    return cut === -1 ? url : url.slice(0, cut);
+}
+/**
+ * Ask the browser to make this origin's storage **persistent** — exempt from eviction under disk
+ * pressure, instead of merely best-effort.
+ *
+ * Not called automatically, and deliberately: some browsers surface a permission prompt, which is
+ * the shell's call to make (and the shell is the first-party origin whose engagement the decision is
+ * scored on), not a guest game's. Resolves `false` when the browser declines or doesn't support it.
+ */
+export async function requestPersistentStorage() {
+    try {
+        if (!navigator.storage?.persist)
+            return false;
+        if (await navigator.storage.persisted())
+            return true;
+        return await navigator.storage.persist();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Open (lazily) a persistent GLB byte store. Cheap to call — nothing touches storage until the first
+ * {@link GlbCache.bytes}.
+ */
+export function createGlbCache(opts = {}) {
+    const name = opts.name ?? DEFAULT_CACHE_NAME;
+    const maxBytes = opts.maxBytes ?? DEFAULT_MAX_BYTES;
+    /**
+     * Fetches in flight, by key, so two loaders in one document can't both pull 73 MB.
+     *
+     * `taken` is which caller gets the buffer ITSELF: the first one. A second caller awaiting the same
+     * load is handed a copy, because a consumer is free to detach the buffer it is given (transferring
+     * it to a worker), which would empty the one the other is holding. Copying for everyone would mean
+     * a 73 MB allocation on the common path, where there is only ever one caller.
+     */
+    const inFlight = new Map();
+    let opened = null;
+    /**
+     * Every mutation runs on ONE chain.
+     *
+     * The recency index is a read-modify-write of a single cache entry, and world loads are
+     * concurrent by nature (a map plus its props, two screens booting). Interleaved writes lose each
+     * other's timestamps, and a trim running on a stale index evicts the entry that was just used —
+     * which is precisely the case the cache exists for. Serializing costs nothing: writes are already
+     * off the critical path (`bytes` resolves before them).
+     */
+    let writes = Promise.resolve();
+    const enqueue = (task) => {
+        const next = writes.then(task, task).catch(() => { });
+        writes = next;
+        return next;
+    };
+    /**
+     * Uses recorded the INSTANT they happen, flushed to the persisted index by the write queue.
+     *
+     * A read is not queued (it must not wait behind a 73 MB write), so a hit can land while a trim is
+     * already queued behind it. Stamping only on the queue would let that trim evict the entry the
+     * rider is using right now — the one thing an LRU must never do. Recording here, synchronously,
+     * is what makes the use visible to a trim that has not run yet.
+     */
+    const recent = new Map();
+    const open = () => {
+        if (!opened) {
+            opened = glbCacheAvailable()
+                ? caches.open(name).catch(() => null)
+                : Promise.resolve(null);
+        }
+        return opened;
+    };
+    const load = async (url, key) => {
+        const cache = await open();
+        if (cache) {
+            const hit = await cache.match(key).catch(() => undefined);
+            if (hit) {
+                recent.set(key, Date.now());
+                void enqueue(() => stamp(cache, recent, maxBytes));
+                return await hit.arrayBuffer();
+            }
+        }
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`[rydr-sdk] glb fetch failed (${res.status}) — ${key}`);
+        const buf = await res.arrayBuffer();
+        if (cache) {
+            recent.set(key, Date.now());
+            void enqueue(() => store(cache, recent, key, buf, res.headers.get("content-type"), maxBytes));
+        }
+        return buf;
+    };
+    return {
+        bytes(url) {
+            const key = glbCacheKey(url);
+            let entry = inFlight.get(key);
+            if (!entry) {
+                entry = { bytes: load(url, key).finally(() => inFlight.delete(key)), taken: false };
+                inFlight.set(key, entry);
+            }
+            const mine = entry;
+            const first = !mine.taken;
+            mine.taken = true;
+            return mine.bytes.then((buf) => (first ? buf : buf.slice(0)));
+        },
+        async stats() {
+            const cache = await open();
+            if (!cache)
+                return { entries: 0, bytes: 0 };
+            const entries = await assetEntries(cache);
+            return { entries: entries.length, bytes: entries.reduce((n, e) => n + e.bytes, 0) };
+        },
+        async clear() {
+            opened = null;
+            if (glbCacheAvailable())
+                await caches.delete(name).catch(() => { });
+        },
+    };
+}
+// ==================== storage ====================
+/**
+ * Write `buf` under `key`, then bring the bucket back inside its budget. Never throws.
+ *
+ * Always run through the caller's write queue — see `enqueue` in {@link createGlbCache}.
+ */
+async function store(cache, recent, key, buf, contentType, maxBytes) {
+    try {
+        await cache.put(key, new Response(buf, {
+            headers: {
+                "content-type": contentType || "model/gltf-binary",
+                [BYTES_HEADER]: String(buf.byteLength),
+            },
+        }));
+        await stamp(cache, recent, maxBytes);
+    }
+    catch {
+        // Quota refusal, a private-mode browser, a storage policy — the bytes are already in hand and
+        // the load succeeds either way. Trim so the next write has a chance of landing.
+        await stamp(cache, recent, maxBytes).catch(() => { });
+    }
+}
+/**
+ * Flush the uses recorded since the last flush into the persisted index, then trim. Never throws.
+ *
+ * Always run through the caller's write queue — see `enqueue` in {@link createGlbCache}.
+ */
+async function stamp(cache, recent, maxBytes) {
+    try {
+        const used = await readIndex(cache);
+        for (const [key, at] of recent)
+            used[key] = at;
+        await trim(cache, used, maxBytes);
+        await writeIndex(cache, used);
+    }
+    catch {
+        /* recency is a hint; losing it costs eviction ORDER, never correctness */
+    }
+}
+/**
+ * Delete least-recently-used entries until the bucket fits `maxBytes`.
+ *
+ * The index is reconciled against what the cache actually holds first, so it is self-healing: an
+ * entry with no timestamp (written by an older build, or a lost index) is stamped now and survives
+ * this round rather than being evicted as "oldest".
+ */
+async function trim(cache, used, maxBytes) {
+    const entries = await assetEntries(cache);
+    const now = Date.now();
+    let total = 0;
+    for (const e of entries) {
+        if (used[e.key] === undefined)
+            used[e.key] = now;
+        total += e.bytes;
+    }
+    for (const key of Object.keys(used)) {
+        if (!entries.some((e) => e.key === key))
+            delete used[key];
+    }
+    if (total > maxBytes) {
+        for (const e of [...entries].sort((a, b) => (used[a.key] ?? 0) - (used[b.key] ?? 0))) {
+            if (total <= maxBytes)
+                break;
+            if (await cache.delete(e.key)) {
+                total -= e.bytes;
+                delete used[e.key];
+            }
+        }
+    }
+}
+/** Every ASSET entry (the recency index itself excluded) with its stored byte length. */
+async function assetEntries(cache) {
+    const out = [];
+    for (const req of await cache.keys()) {
+        if (req.url === INDEX_URL)
+            continue;
+        const res = await cache.match(req);
+        if (!res)
+            continue;
+        const stamped = Number(res.headers.get(BYTES_HEADER) ?? res.headers.get("content-length"));
+        out.push({ key: req.url, bytes: Number.isFinite(stamped) ? stamped : 0 });
+    }
+    return out;
+}
+/** The recency index: cache key → last-used epoch ms. `{}` when absent or unreadable. */
+async function readIndex(cache) {
+    try {
+        const res = await cache.match(INDEX_URL);
+        if (!res)
+            return {};
+        const parsed = await res.json();
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function writeIndex(cache, used) {
+    await cache.put(INDEX_URL, new Response(JSON.stringify(used), { headers: { "content-type": "application/json" } }));
+}
+//# sourceMappingURL=glb-cache.js.map

package/dist/three/glb-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glb-cache.js","sourceRoot":"","sources":["../../src/three/glb-cache.ts"],"names":[],"mappings":"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"}

package/dist/three/index.d.ts

@@ -6,6 +6,7 @@
  * `GLTFLoader` + DRACO + caching per game.
  */
 export * from "./world-loader.js";
+export * from "./glb-cache.js";
 export * from "./merge.js";
 export * from "./perf-marks.js";
 export * from "./perf-overlay.js";

package/dist/three/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/three/index.js

@@ -6,6 +6,7 @@
  * `GLTFLoader` + DRACO + caching per game.
  */
 export * from "./world-loader.js";
+export * from "./glb-cache.js";
 export * from "./merge.js";
 export * from "./perf-marks.js";
 export * from "./perf-overlay.js";

package/dist/three/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/three/world-loader.d.ts

@@ -11,9 +11,14 @@
  *
  * A platform world is a static environment, so it is fetched, DRACO-decoded, uploaded to the GPU and
  * shader-compiled **once** ({@link loadWorld}, cached by {@link CoreWorld.id}) and then reused — a game
- * that tears down and rebuilds gameplay on every restart still gets an instant world. Two caches back
- * this: a per-URL GLB dedup inside {@link createGlbLoader} (repeated props clone shared
- * geometry/material instead of re-downloading), and the per-world {@link LoadedWorld} handle cache.
+ * that tears down and rebuilds gameplay on every restart still gets an instant world. THREE caches back
+ * this, and they survive different things:
+ *  - the per-world {@link LoadedWorld} handle cache — GPU resources, per document;
+ *  - a per-URL GLB decode dedup inside {@link createGlbLoader} — repeated props clone shared
+ *    geometry/material instead of re-downloading, per document;
+ *  - the raw bytes in Cache Storage ({@link import("./glb-cache.js").createGlbCache}) — which
+ *    **outlives the document**, so a rider returning to a game the shell already tore down re-decodes
+ *    its map instead of re-downloading 3–73 MB of it.
  *
  * ## The handle owns the GPU resources — disposal is safe
  *
@@ -23,12 +28,19 @@
  * no "remember to detach, never dispose the shared group" rule to get wrong.
  */
 import * as THREE from "three";
+import type { GlbCacheOptions } from "./glb-cache.js";
 import type { CoreWorld } from "../protocol/worlds.js";
 /** DRACO decoder — pinned to the same version the platform world editor uses. */
 export declare const DRACO_DECODER_PATH = "https://www.gstatic.com/draco/versioned/decoders/1.5.6/";
 export interface GlbLoaderOptions {
     /** Override the DRACO decoder directory (defaults to {@link DRACO_DECODER_PATH}). */
     dracoDecoderPath?: string;
+    /**
+     * The **persistent** byte cache (see {@link import("./glb-cache.js").GlbCache}), which is what
+     * makes a world survive the shell destroying the game's iframe. On by default; pass options to
+     * size it, or `false` to fetch every time (a bench measuring cold loads, say).
+     */
+    cache?: GlbCacheOptions | false;
 }
 /** A transform applied to a loaded world group: translate · Y-rotation · uniform scale. */
 export interface WorldPlacement {
@@ -85,6 +97,13 @@ export interface LoadedWorld {
  * R2 URLs whose signature/expiry query string varies per request, so the same prop placed N times
  * arrives as N distinct full URLs. Keying by path (the R2 object identity) collapses them to one
  * decode; without it every placement re-fetches and re-DRACO-decodes the same glb (slow level loads).
+ *
+ * **Two caches, and they answer different questions.** The decode map above is per-document and dies
+ * with the iframe; under it, {@link import("./glb-cache.js").createGlbCache} keeps the raw BYTES in
+ * Cache Storage, which does not — so a rider who leaves the game and comes back re-decodes a map
+ * instead of re-downloading it. That is why this fetches and calls `parse` itself rather than
+ * `loader.loadAsync(url)`: the bytes have to pass through our hands to be stored. Disable it with
+ * `cache: false`.
  */
 export declare function createGlbLoader(opts?: GlbLoaderOptions): (url: string) => Promise<THREE.Object3D>;
 /**

package/dist/three/world-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-loader.d.ts","sourceRoot":"","sources":["../../src/three/world-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,4DAA4D,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,kGAAkG;IAClG,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,6GAA6G;IAC7G,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrC,2GAA2G;IAC3G,MAAM,IAAI,IAAI,CAAC;IACf,iGAAiG;IACjG,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAgBrG;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAcjG;AAwBD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAWjD"}
+{"version":3,"file":"world-loader.d.ts","sourceRoot":"","sources":["../../src/three/world-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,4DAA4D,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;CACjC;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,kGAAkG;IAClG,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,6GAA6G;IAC7G,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrC,2GAA2G;IAC3G,MAAM,IAAI,IAAI,CAAC;IACf,iGAAiG;IACjG,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAmBrG;AAmBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAcjG;AAwBD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAWjD"}

package/dist/three/world-loader.js

@@ -11,9 +11,14 @@
  *
  * A platform world is a static environment, so it is fetched, DRACO-decoded, uploaded to the GPU and
  * shader-compiled **once** ({@link loadWorld}, cached by {@link CoreWorld.id}) and then reused — a game
- * that tears down and rebuilds gameplay on every restart still gets an instant world. Two caches back
- * this: a per-URL GLB dedup inside {@link createGlbLoader} (repeated props clone shared
- * geometry/material instead of re-downloading), and the per-world {@link LoadedWorld} handle cache.
+ * that tears down and rebuilds gameplay on every restart still gets an instant world. THREE caches back
+ * this, and they survive different things:
+ *  - the per-world {@link LoadedWorld} handle cache — GPU resources, per document;
+ *  - a per-URL GLB decode dedup inside {@link createGlbLoader} — repeated props clone shared
+ *    geometry/material instead of re-downloading, per document;
+ *  - the raw bytes in Cache Storage ({@link import("./glb-cache.js").createGlbCache}) — which
+ *    **outlives the document**, so a rider returning to a game the shell already tore down re-decodes
+ *    its map instead of re-downloading 3–73 MB of it.
  *
  * ## The handle owns the GPU resources — disposal is safe
  *
@@ -27,6 +32,7 @@ import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
 import { DRACOLoader } from "three/addons/loaders/DRACOLoader.js";
 import { applyWorld } from "../world-runtime.js";
 import { mergeByMaterial } from "./merge.js";
+import { createGlbCache } from "./glb-cache.js";
 /** DRACO decoder — pinned to the same version the platform world editor uses. */
 export const DRACO_DECODER_PATH = "https://www.gstatic.com/draco/versioned/decoders/1.5.6/";
 /**
@@ -42,6 +48,13 @@ export const DRACO_DECODER_PATH = "https://www.gstatic.com/draco/versioned/decod
  * R2 URLs whose signature/expiry query string varies per request, so the same prop placed N times
  * arrives as N distinct full URLs. Keying by path (the R2 object identity) collapses them to one
  * decode; without it every placement re-fetches and re-DRACO-decodes the same glb (slow level loads).
+ *
+ * **Two caches, and they answer different questions.** The decode map above is per-document and dies
+ * with the iframe; under it, {@link import("./glb-cache.js").createGlbCache} keeps the raw BYTES in
+ * Cache Storage, which does not — so a rider who leaves the game and comes back re-decodes a map
+ * instead of re-downloading it. That is why this fetches and calls `parse` itself rather than
+ * `loader.loadAsync(url)`: the bytes have to pass through our hands to be stored. Disable it with
+ * `cache: false`.
  */
 export function createGlbLoader(opts = {}) {
     const loader = new GLTFLoader();
@@ -49,17 +62,33 @@ export function createGlbLoader(opts = {}) {
     draco.setDecoderPath(opts.dracoDecoderPath ?? DRACO_DECODER_PATH);
     loader.setDRACOLoader(draco);
     const decoded = new Map();
+    const bytes = opts.cache === false ? null : createGlbCache(opts.cache);
     return (url) => {
         const cut = url.search(/[?#]/); // dedup by asset path; presigned query strings vary per placement
         const key = cut === -1 ? url : url.slice(0, cut);
         let p = decoded.get(key);
         if (!p) {
-            p = loader.loadAsync(url).then((g) => g.scene);
+            p = bytes
+                ? bytes.bytes(url).then((buf) => parseGlb(loader, buf, key))
+                : loader.loadAsync(url).then((g) => g.scene);
             decoded.set(key, p);
         }
         return p.then((scene) => scene.clone());
     };
 }
+/**
+ * Decode glb bytes with the shared loader, resolving to the asset's root scene.
+ *
+ * `path` is the asset's own directory, which is what a `.gltf` referencing a sibling `.bin` or a
+ * texture resolves against. Platform assets are self-contained `.glb`s, so nothing is fetched
+ * through it today — passing it anyway costs nothing and keeps a non-embedded asset working.
+ */
+function parseGlb(loader, buf, url) {
+    const path = url.slice(0, url.lastIndexOf("/") + 1);
+    return new Promise((resolve, reject) => {
+        loader.parse(buf, path, (gltf) => resolve(gltf.scene), reject);
+    });
+}
 /** Loaded worlds, keyed by {@link CoreWorld.id}. See the module doc for the lifecycle contract. */
 const worldCache = new Map();
 /**

package/dist/three/world-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"world-loader.js","sourceRoot":"","sources":["../../src/three/world-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"world-loader.js","sourceRoot":"","sources":["../../src/three/world-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rydr/game-sdk",
-  "version": "8.16.0",
+  "version": "8.17.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bdefrenne/rydr-game-sdk.git"