@crowdedkingdoms/crowdyjs 17.12.0-dev.1 → 17.14.0-dev.1

package/dist/stores/actors.js

@@ -43,6 +43,10 @@ export function localStorageUuidStore(key = 'crowdyjs:actor-uuid') {
         },
     };
 }
+function sendErrorCode(error) {
+    const code = error?.code;
+    return typeof code === 'string' && code !== '' ? code : 'SEND_FAILED';
+}
 /**
  * The SDK-managed **local actor**: identity (minted + persisted uuid), typed
  * replication state, current chunk, an automatic 5 Hz send loop with
@@ -62,6 +66,8 @@ export class LocalActorStore {
         this.lastSentRecord = null;
         this.lastAckRecord = null;
         this.lastErrorRecord = null;
+        /** The last send failed before reaching the server: the next tick sends even if unchanged. */
+        this.resendDue = false;
         this.inFlight = new Map(); // seq → sentAt
         this.sequences = new SequenceAllocator();
         this.now = config.now ?? Date.now;
@@ -110,8 +116,9 @@ export class LocalActorStore {
         const doc = globalThis.document;
         if ((config.refreshOnVisibility ?? true) && doc?.addEventListener) {
             const onVisibility = () => {
-                if (doc.visibilityState === 'visible')
-                    void this.refresh('visibility');
+                if (doc.visibilityState === 'visible') {
+                    this.refresh('visibility').catch(() => { });
+                }
             };
             doc.addEventListener('visibilitychange', onVisibility);
             ctx.onDispose(() => doc.removeEventListener('visibilitychange', onVisibility));
@@ -190,23 +197,26 @@ export class LocalActorStore {
             return;
         await this.send(reason);
     }
-    /** One send-loop tick: dedup unchanged state, keyframe when quiet. */
+    /**
+     * One send-loop tick: dedup unchanged state, keyframe when quiet. A failed
+     * loop send lands on {@link lastError} and the next tick sends again.
+     */
     tick() {
         if (!this.currentChunk)
             return;
         const encoded = this.config.codec.encode(this.currentState);
-        if ((this.config.sendOnChange ?? true) && this.lastSentRecord) {
+        if ((this.config.sendOnChange ?? true) && this.lastSentRecord && !this.resendDue) {
             const quietFor = this.now() - this.lastSentRecord.sentAt;
             const keyframeEvery = this.config.keyframeEveryMs ?? 3000;
             if (encoded === this.lastSentRecord.encoded && quietFor < keyframeEvery) {
                 return;
             }
             if (encoded === this.lastSentRecord.encoded) {
-                void this.send('keyframe', encoded);
+                this.send('keyframe', encoded).catch(() => { });
                 return;
             }
         }
-        void this.send('interval', encoded);
+        this.send('interval', encoded).catch(() => { });
     }
     async send(reason, preEncoded) {
         const chunk = this.currentChunk;
@@ -217,7 +227,9 @@ export class LocalActorStore {
         const encoded = preEncoded ?? this.config.codec.encode(state);
         const sequenceNumber = this.sequences.next();
         const sentAt = this.now();
-        this.lastSentRecord = { state, encoded, chunk, sequenceNumber, sentAt, reason };
+        const record = { state, encoded, chunk, sequenceNumber, sentAt, reason };
+        this.lastSentRecord = record;
+        this.resendDue = false;
         this.inFlight.set(sequenceNumber, sentAt);
         if (this.inFlight.size > 256) {
             const oldest = this.inFlight.keys().next().value;
@@ -231,17 +243,30 @@ export class LocalActorStore {
             uuid: this.uuid,
             detail: { reason },
         });
-        await this.ctx.client.udp.sendActorUpdate({
-            appId: this.ctx.appId,
-            chunk,
-            uuid: this.uuid,
-            state: encoded,
-            sequenceNumber,
-            ...(this.config.distance !== undefined ? { distance: this.config.distance } : {}),
-            ...(this.config.decayRate !== undefined
-                ? { decayRate: this.config.decayRate }
-                : {}),
-        });
+        try {
+            await this.ctx.client.udp.sendActorUpdate({
+                appId: this.ctx.appId,
+                chunk,
+                uuid: this.uuid,
+                state: encoded,
+                sequenceNumber,
+                ...(this.config.distance !== undefined ? { distance: this.config.distance } : {}),
+                ...(this.config.decayRate !== undefined
+                    ? { decayRate: this.config.decayRate }
+                    : {}),
+            });
+        }
+        catch (error) {
+            this.inFlight.delete(sequenceNumber);
+            this.lastErrorRecord = {
+                errorCode: sendErrorCode(error),
+                sequenceNumber,
+                receivedAt: this.now(),
+            };
+            if (this.lastSentRecord === record)
+                this.resendDue = true;
+            throw error;
+        }
     }
 }
 /**

package/dist/stores/chunks.d.ts

@@ -122,6 +122,9 @@ export declare class ChunkStore<TVoxelState = string, TChunkState = string> {
     private readonly config;
     private readonly chunks;
     private readonly inFlight;
+    private readonly hydrating;
+    /** Consecutive failed hydrations per chunk key. */
+    private readonly hydrateFailures;
     private readonly writeBackQueue;
     private readonly changeListeners;
     private readonly voxelStateCodec;
@@ -151,8 +154,17 @@ export declare class ChunkStore<TVoxelState = string, TChunkState = string> {
      * configured, marks server-unknown chunks `missing`, and seeds them via
      * `onMissing`. In-flight requests are deduped; safe to call every time the
      * player crosses a chunk boundary.
+     *
+     * Requests the platform refuses as busy are asked again with backoff, and
+     * at most 8 hydrations run at once. Hydration is best effort: a chunk whose
+     * states could not be fetched keeps the voxels the bulk load gave it
+     * (`hydrated` stays false) and is hydrated on a later call. A chunk whose
+     * bulk load failed is `failed` and is requested again by a later call. The
+     * promise rejects only when the bulk load itself fails.
      */
     ensureAround(center: ChunkCoord, radius: number): Promise<void>;
+    /** Hydrates chunks with at most {@link HYDRATE_CONCURRENCY} requests in flight. */
+    private hydrateAll;
     /**
      * Hydrate one chunk's sparse voxel states (and chunk state) via a
      * single-chunk fetch — bulk loads omit them.

package/dist/stores/chunks.d.ts.map

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

package/dist/stores/chunks.js

@@ -8,6 +8,33 @@
 import { generateCrowdyUuid, decodeBase64, encodeBase64 } from '../utils.js';
 import { rawCodec } from './codec.js';
 import { CHUNK_VOLUME, chunkDistance, chunkKey, chunksAround, fromChunkInput, toChunkInput, voxelIndex, } from './keys.js';
+/**
+ * Hydrations in flight at once. Each is one request, and a bulk load returns hundreds of
+ * chunks: sent together, the API refuses a share of them as busy.
+ */
+const HYDRATE_CONCURRENCY = 8;
+/** Attempts for a request the platform refused before running it. */
+const BUSY_ATTEMPTS = 4;
+/** A chunk whose hydration failed this many times in a row is not asked for again. */
+const HYDRATE_GIVE_UP = 3;
+/** The platform refused the call before running it: asking again can succeed. */
+function refusedBeforeRunning(error) {
+    const e = error;
+    const code = e?.code ?? e?.extensions?.code;
+    return code === 'PLATFORM_BUSY' || e?.extensions?.retryable === true;
+}
+async function whenNotBusy(call) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await call();
+        }
+        catch (error) {
+            if (attempt >= BUSY_ATTEMPTS || !refusedBeforeRunning(error))
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 200 * 2 ** (attempt - 1)));
+        }
+    }
+}
 /**
  * The SDK-managed **chunk/voxel cache** — the client-side source of truth
  * for terrain:
@@ -31,6 +58,9 @@ export class ChunkStore {
         this.config = config;
         this.chunks = new Map();
         this.inFlight = new Set();
+        this.hydrating = new Set();
+        /** Consecutive failed hydrations per chunk key. */
+        this.hydrateFailures = new Map();
         this.writeBackQueue = [];
         this.changeListeners = new Set();
         this.fallbackUuid = generateCrowdyUuid();
@@ -94,56 +124,98 @@ export class ChunkStore {
      * configured, marks server-unknown chunks `missing`, and seeds them via
      * `onMissing`. In-flight requests are deduped; safe to call every time the
      * player crosses a chunk boundary.
+     *
+     * Requests the platform refuses as busy are asked again with backoff, and
+     * at most 8 hydrations run at once. Hydration is best effort: a chunk whose
+     * states could not be fetched keeps the voxels the bulk load gave it
+     * (`hydrated` stays false) and is hydrated on a later call. A chunk whose
+     * bulk load failed is `failed` and is requested again by a later call. The
+     * promise rejects only when the bulk load itself fails.
      */
     async ensureAround(center, radius) {
-        const wanted = chunksAround(center, radius).filter((coord) => {
+        const around = chunksAround(center, radius);
+        const wanted = around.filter((coord) => {
             const key = chunkKey(coord);
-            return !this.chunks.has(key) && !this.inFlight.has(key);
+            if (this.inFlight.has(key))
+                return false;
+            const chunk = this.chunks.get(key);
+            return !chunk || chunk.loadState === 'failed';
         });
-        if (wanted.length === 0)
-            return;
-        for (const coord of wanted)
-            this.inFlight.add(chunkKey(coord));
-        try {
-            const response = await this.ctx.client.chunks.byDistance({
-                appId: this.ctx.appId,
-                centerCoordinate: toChunkInput(center),
-                maxDistance: Math.max(1, Math.min(8, radius)),
-                limit: (2 * radius + 1) ** 3,
-            });
-            const returned = new Set();
-            for (const chunk of response.chunks) {
-                const coord = fromChunkInput(chunk.coordinates);
-                returned.add(chunkKey(coord));
-                this.applyServerChunk(coord, chunk.voxels ?? null, chunk.chunkState ?? null);
+        const returned = new Set();
+        if (wanted.length > 0) {
+            for (const coord of wanted)
+                this.inFlight.add(chunkKey(coord));
+            try {
+                const response = await whenNotBusy(() => this.ctx.client.chunks.byDistance({
+                    appId: this.ctx.appId,
+                    centerCoordinate: toChunkInput(center),
+                    maxDistance: Math.max(1, Math.min(8, radius)),
+                    limit: (2 * radius + 1) ** 3,
+                }));
+                for (const chunk of response.chunks) {
+                    const coord = fromChunkInput(chunk.coordinates);
+                    returned.add(chunkKey(coord));
+                    this.applyServerChunk(coord, chunk.voxels ?? null, chunk.chunkState ?? null);
+                }
+                // Requested-but-absent chunks have never been stored server-side.
+                for (const coord of wanted) {
+                    if (returned.has(chunkKey(coord)))
+                        continue;
+                    this.markMissing(coord);
+                }
             }
-            // Requested-but-absent chunks have never been stored server-side.
-            for (const coord of wanted) {
-                if (returned.has(chunkKey(coord)))
-                    continue;
-                this.markMissing(coord);
+            catch (error) {
+                for (const coord of wanted) {
+                    const key = chunkKey(coord);
+                    const chunk = this.chunks.get(key);
+                    if (!chunk || chunk.loadState === 'failed') {
+                        const entry = this.ensureEntry(coord);
+                        entry.loadState = 'failed';
+                        this.touch(entry);
+                    }
+                }
+                throw error;
             }
-            if (this.hydrateStates) {
-                await Promise.all(wanted
-                    .filter((coord) => returned.has(chunkKey(coord)))
-                    .map((coord) => this.hydrate(coord)));
+            finally {
+                for (const coord of wanted)
+                    this.inFlight.delete(chunkKey(coord));
             }
         }
-        catch (error) {
-            for (const coord of wanted) {
+        if (this.hydrateStates) {
+            // What the bulk load just returned, and what an earlier call failed to hydrate.
+            // Chunks seeded here and written back are the server's copy already.
+            await this.hydrateAll(around.filter((coord) => {
+                const key = chunkKey(coord);
+                const chunk = this.chunks.get(key);
+                const failures = this.hydrateFailures.get(key) ?? 0;
+                return (chunk?.loadState === 'loaded' &&
+                    !chunk.hydrated &&
+                    !this.hydrating.has(key) &&
+                    (returned.has(key) || (failures > 0 && failures < HYDRATE_GIVE_UP)));
+            }));
+        }
+    }
+    /** Hydrates chunks with at most {@link HYDRATE_CONCURRENCY} requests in flight. */
+    async hydrateAll(coords) {
+        let next = 0;
+        const worker = async () => {
+            while (next < coords.length) {
+                const coord = coords[next++];
                 const key = chunkKey(coord);
-                if (!this.chunks.has(key)) {
-                    const chunk = this.ensureEntry(coord);
-                    chunk.loadState = 'failed';
-                    this.touch(chunk);
+                this.hydrating.add(key);
+                try {
+                    await whenNotBusy(() => this.hydrate(coord));
+                    this.hydrateFailures.delete(key);
+                }
+                catch {
+                    this.hydrateFailures.set(key, (this.hydrateFailures.get(key) ?? 0) + 1);
+                }
+                finally {
+                    this.hydrating.delete(key);
                 }
             }
-            throw error;
-        }
-        finally {
-            for (const coord of wanted)
-                this.inFlight.delete(chunkKey(coord));
-        }
+        };
+        await Promise.all(Array.from({ length: Math.min(HYDRATE_CONCURRENCY, coords.length) }, worker));
     }
     /**
      * Hydrate one chunk's sparse voxel states (and chunk state) via a
@@ -259,6 +331,7 @@ export class ChunkStore {
                 continue;
             if (chunkDistance(chunk.coord, center) > radius) {
                 this.chunks.delete(key);
+                this.hydrateFailures.delete(key);
                 this.revisionValue += 1;
             }
         }

package/dist/stores/durable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable.d.ts","sourceRoot":"","sources":["../../src/stores/durable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"durable.d.ts","sourceRoot":"","sources":["../../src/stores/durable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMxD,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;gBAGzD,GAAG,EAAE,mBAAmB,EACxB,MAAM,GAAE,iBAAsB;IAOjD,yEAAyE;IACzE,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,uDAAuD;IACvD,IAAI,MAAM,IAAI,OAAO,CAMpB;IAED,wFAAwF;IACxF,aAAa,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAKxE,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAa5B;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,mBAAmB,EACxB,MAAM,GAAE,iBAAsB,GAC7B,WAAW,CAEb;AAMD,2CAA2C;AAC3C,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,cAAc,CAAC,CAAC;IASzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAGhB,GAAG,EAAE,mBAAmB,EACzC,MAAM,GAAE,eAAe,CAAC,CAAC,CAAM;IAejC,oEAAoE;IACpE,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,CAEpB;IAED,6CAA6C;IAC7C,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,8CAA8C;IAC9C,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,wEAAwE;IAClE,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe/B,uEAAuE;IACvE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKnB,uEAAuE;IACvE,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9B,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAc5B;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,mBAAmB,EACxB,MAAM,GAAE,eAAe,CAAC,CAAC,CAAM,GAC9B,cAAc,CAAC,CAAC,CAAC,CAEnB;AAMD,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI;IACxD,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,yEAAyE;IACzE,YAAY,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB,CAAC,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IAU/E,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAGzB,GAAG,EAAE,mBAAmB,EACzC,MAAM,GAAE,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAM;IAQzD,yEAAyE;IACzE,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,uCAAuC;IACvC,IAAI,WAAW,IAAI,OAAO,GAAG,IAAI,CAEhC;IAED,qDAAqD;IACrD,IAAI,YAAY,IAAI,QAAQ,GAAG,IAAI,CAElC;IAED,wCAAwC;IACxC,IAAI,QAAQ,IAAI,IAAI,GAAG,IAAI,CAE1B;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,0EAA0E;IACpE,gBAAgB,CAAC,KAAK,EAAE;QAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjB,kEAAkE;IAC5D,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,UAAU;CAQnB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EACrF,GAAG,EAAE,mBAAmB,EACxB,MAAM,GAAE,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAM,GACtD,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAE3C"}

package/dist/stores/durable.js

@@ -80,8 +80,9 @@ export class SaveStateStore {
         const autosave = config.autosaveMs ?? false;
         if (autosave !== false && autosave > 0) {
             ctx.onDispose(ctx.ticker.every(autosave, () => {
+                // A failed autosave stays dirty, so the next one retries it.
                 if (this.dirtyFlag && !this.saving)
-                    void this.save();
+                    this.save().catch(() => { });
             }));
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdoms/crowdyjs",
-  "version": "17.12.0-dev.1",
+  "version": "17.14.0-dev.1",
   "description": "Browser-first Crowded Kingdoms SDK with GraphQL, realtime, and local Rust authoring support",
   "type": "module",
   "main": "dist/index.js",