@dcl/sdk 7.29.1-35901015152.commit-d1b7b96 → 7.29.1-36041177279.commit-502e633

package/server/storage/index.js

@@ -0,0 +1,60 @@
+import { createStorageConfig } from './constants';
+import { createSceneStorage } from './scene';
+import { createPlayerStorage } from './player';
+/**
+ * Creates the Storage module with scene-scoped and player-scoped storage.
+ */
+const createStorage = () => {
+    const config = createStorageConfig();
+    const sceneStorage = createSceneStorage(config);
+    const playerStorage = createPlayerStorage(config);
+    return {
+        // Spread scene storage methods at top level
+        get: sceneStorage.get,
+        set: sceneStorage.set,
+        delete: sceneStorage.delete,
+        getValues: sceneStorage.getValues,
+        // Keep player as nested property
+        player: playerStorage,
+        configure(options) {
+            for (const [key, value] of Object.entries(options)) {
+                if (value !== undefined)
+                    config[key] = value;
+            }
+        }
+    };
+};
+/**
+ * Storage provides methods to store and retrieve key-value data from the
+ * Server Side Storage service.
+ *
+ * - Use Storage.get/set/delete/getValues for scene-scoped storage
+ * - Use Storage.player.get/set/delete/getValues for player-scoped storage
+ * - Use Storage.configure to change module-wide defaults (e.g. skipIfUnchanged, cacheReads)
+ *
+ * A failure is never reported as absence. A read that fails throws; get() resolves
+ * null only for a confirmed absence (a 404, or a delete that landed) or a stored
+ * JSON null, and getValues() returns an empty page only for a genuinely empty
+ * listing. A delete that fails throws, and resolves false only for a confirmed 404.
+ * set() reports failure through its boolean result, and throws for a value that
+ * cannot be JSON-serialized. A get() issued while writes to its key are pending
+ * waits for them, so it reflects them; getValues() does not wait. Nothing is
+ * retried — that is the caller's to decide.
+ *
+ * Reads are cached by default: get() serves values known from a network
+ * round-trip within the last cacheMaxAgeMs (including confirmed "not found"
+ * results) without hitting the service, and concurrent gets for the same key
+ * share one request. Overlapping writes to the same key are serialized so the
+ * service commits them in issue order, and rapid writes coalesce to the
+ * latest value; a set()/delete() settles once its own write, or the newer
+ * write that replaced it, lands or fails. By default (skipIfUnchanged)
+ * an unchanged set is skipped, but only when a previous confirmed round-trip
+ * proved the exact value is already stored. Out-of-band writers (e.g. CLI storage commands)
+ * may not be visible for up to cacheMaxAgeMs; use get(key, { fresh: true })
+ * for an authoritative read or Storage.configure({ cacheReads: false }) to
+ * disable read caching.
+ *
+ * This module only works when running on server-side scenes.
+ */
+export const Storage = createStorage();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmVyL3N0b3JhZ2UvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLG1CQUFtQixFQUFrQixNQUFNLGFBQWEsQ0FBQTtBQUNqRSxPQUFPLEVBQUUsa0JBQWtCLEVBQWlCLE1BQU0sU0FBUyxDQUFBO0FBQzNELE9BQU8sRUFBRSxtQkFBbUIsRUFBa0IsTUFBTSxVQUFVLENBQUE7QUF3QjlEOztHQUVHO0FBQ0gsTUFBTSxhQUFhLEdBQUcsR0FBYSxFQUFFO0lBQ25DLE1BQU0sTUFBTSxHQUFHLG1CQUFtQixFQUFFLENBQUE7SUFDcEMsTUFBTSxZQUFZLEdBQUcsa0JBQWtCLENBQUMsTUFBTSxDQUFDLENBQUE7SUFDL0MsTUFBTSxhQUFhLEdBQUcsbUJBQW1CLENBQUMsTUFBTSxDQUFDLENBQUE7SUFFakQsT0FBTztRQUNMLDRDQUE0QztRQUM1QyxHQUFHLEVBQUUsWUFBWSxDQUFDLEdBQUc7UUFDckIsR0FBRyxFQUFFLFlBQVksQ0FBQyxHQUFHO1FBQ3JCLE1BQU0sRUFBRSxZQUFZLENBQUMsTUFBTTtRQUMzQixTQUFTLEVBQUUsWUFBWSxDQUFDLFNBQVM7UUFDakMsaUNBQWlDO1FBQ2pDLE1BQU0sRUFBRSxhQUFhO1FBQ3JCLFNBQVMsQ0FBQyxPQUF1QjtZQUMvQixLQUFLLE1BQU0sQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsRUFBRTtnQkFDbEQsSUFBSSxLQUFLLEtBQUssU0FBUztvQkFBRyxNQUE2QyxDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQTthQUNyRjtRQUNILENBQUM7S0FDRixDQUFBO0FBQ0gsQ0FBQyxDQUFBO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0ErQkc7QUFDSCxNQUFNLENBQUMsTUFBTSxPQUFPLEdBQWEsYUFBYSxFQUFFLENBQUEiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBjcmVhdGVTdG9yYWdlQ29uZmlnLCBTdG9yYWdlT3B0aW9ucyB9IGZyb20gJy4vY29uc3RhbnRzJ1xuaW1wb3J0IHsgY3JlYXRlU2NlbmVTdG9yYWdlLCBJU2NlbmVTdG9yYWdlIH0gZnJvbSAnLi9zY2VuZSdcbmltcG9ydCB7IGNyZWF0ZVBsYXllclN0b3JhZ2UsIElQbGF5ZXJTdG9yYWdlIH0gZnJvbSAnLi9wbGF5ZXInXG5cbi8vIFJlLWV4cG9ydCBpbnRlcmZhY2VzIGFuZCB0eXBlc1xuZXhwb3J0IHsgR2V0T3B0aW9ucywgR2V0VmFsdWVzT3B0aW9ucywgR2V0VmFsdWVzUmVzdWx0LCBTZXRPcHRpb25zLCBTdG9yYWdlT3B0aW9ucyB9IGZyb20gJy4vY29uc3RhbnRzJ1xuZXhwb3J0IHsgSVNjZW5lU3RvcmFnZSB9IGZyb20gJy4vc2NlbmUnXG5leHBvcnQgeyBJUGxheWVyU3RvcmFnZSB9IGZyb20gJy4vcGxheWVyJ1xuXG4vKipcbiAqIFN0b3JhZ2UgaW50ZXJmYWNlIHdpdGggbWV0aG9kcyBmb3Igc2NlbmUtc2NvcGVkIGFuZCBwbGF5ZXItc2NvcGVkIHN0b3JhZ2UuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSVN0b3JhZ2UgZXh0ZW5kcyBJU2NlbmVTdG9yYWdlIHtcbiAgLyoqIFBsYXllci1zY29wZWQgc3RvcmFnZSBmb3Iga2V5LXZhbHVlIHBhaXJzICovXG4gIHBsYXllcjogSVBsYXllclN0b3JhZ2VcblxuICAvKipcbiAgICogU2V0cyBtb2R1bGUtd2lkZSBkZWZhdWx0cyBmb3IgYm90aCBzY2VuZS1zY29wZWQgYW5kIHBsYXllci1zY29wZWQgc3RvcmFnZS5cbiAgICogTWVyZ2VzIHRoZSBnaXZlbiBwYXJ0aWFsIG9wdGlvbnMgaW50byB0aGUgY3VycmVudCBjb25maWd1cmF0aW9uLlxuICAgKiBOb3RlOiBjYWNoZU1heEVudHJpZXMgYXBwbGllcyBwZXIgc2NvcGUgKHNjZW5lIGFuZCBwbGF5ZXIgZWFjaCBrZWVwIHRoZWlyXG4gICAqIG93biBjYWNoZSkgYW5kIGJvdW5kcyBlbnRyeSBjb3VudCwgbm90IGJ5dGVzIChlbnRyaWVzIGhvbGQgc2VyaWFsaXplZFxuICAgKiB2YWx1ZSBib2RpZXMpLlxuICAgKi9cbiAgY29uZmlndXJlKG9wdGlvbnM6IFN0b3JhZ2VPcHRpb25zKTogdm9pZFxufVxuXG4vKipcbiAqIENyZWF0ZXMgdGhlIFN0b3JhZ2UgbW9kdWxlIHdpdGggc2NlbmUtc2NvcGVkIGFuZCBwbGF5ZXItc2NvcGVkIHN0b3JhZ2UuXG4gKi9cbmNvbnN0IGNyZWF0ZVN0b3JhZ2UgPSAoKTogSVN0b3JhZ2UgPT4ge1xuICBjb25zdCBjb25maWcgPSBjcmVhdGVTdG9yYWdlQ29uZmlnKClcbiAgY29uc3Qgc2NlbmVTdG9yYWdlID0gY3JlYXRlU2NlbmVTdG9yYWdlKGNvbmZpZylcbiAgY29uc3QgcGxheWVyU3RvcmFnZSA9IGNyZWF0ZVBsYXllclN0b3JhZ2UoY29uZmlnKVxuXG4gIHJldHVybiB7XG4gICAgLy8gU3ByZWFkIHNjZW5lIHN0b3JhZ2UgbWV0aG9kcyBhdCB0b3AgbGV2ZWxcbiAgICBnZXQ6IHNjZW5lU3RvcmFnZS5nZXQsXG4gICAgc2V0OiBzY2VuZVN0b3JhZ2Uuc2V0LFxuICAgIGRlbGV0ZTogc2NlbmVTdG9yYWdlLmRlbGV0ZSxcbiAgICBnZXRWYWx1ZXM6IHNjZW5lU3RvcmFnZS5nZXRWYWx1ZXMsXG4gICAgLy8gS2VlcCBwbGF5ZXIgYXMgbmVzdGVkIHByb3BlcnR5XG4gICAgcGxheWVyOiBwbGF5ZXJTdG9yYWdlLFxuICAgIGNvbmZpZ3VyZShvcHRpb25zOiBTdG9yYWdlT3B0aW9ucyk6IHZvaWQge1xuICAgICAgZm9yIChjb25zdCBba2V5LCB2YWx1ZV0gb2YgT2JqZWN0LmVudHJpZXMob3B0aW9ucykpIHtcbiAgICAgICAgaWYgKHZhbHVlICE9PSB1bmRlZmluZWQpIChjb25maWcgYXMgdW5rbm93biBhcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPilba2V5XSA9IHZhbHVlXG4gICAgICB9XG4gICAgfVxuICB9XG59XG5cbi8qKlxuICogU3RvcmFnZSBwcm92aWRlcyBtZXRob2RzIHRvIHN0b3JlIGFuZCByZXRyaWV2ZSBrZXktdmFsdWUgZGF0YSBmcm9tIHRoZVxuICogU2VydmVyIFNpZGUgU3RvcmFnZSBzZXJ2aWNlLlxuICpcbiAqIC0gVXNlIFN0b3JhZ2UuZ2V0L3NldC9kZWxldGUvZ2V0VmFsdWVzIGZvciBzY2VuZS1zY29wZWQgc3RvcmFnZVxuICogLSBVc2UgU3RvcmFnZS5wbGF5ZXIuZ2V0L3NldC9kZWxldGUvZ2V0VmFsdWVzIGZvciBwbGF5ZXItc2NvcGVkIHN0b3JhZ2VcbiAqIC0gVXNlIFN0b3JhZ2UuY29uZmlndXJlIHRvIGNoYW5nZSBtb2R1bGUtd2lkZSBkZWZhdWx0cyAoZS5nLiBza2lwSWZVbmNoYW5nZWQsIGNhY2hlUmVhZHMpXG4gKlxuICogQSBmYWlsdXJlIGlzIG5ldmVyIHJlcG9ydGVkIGFzIGFic2VuY2UuIEEgcmVhZCB0aGF0IGZhaWxzIHRocm93czsgZ2V0KCkgcmVzb2x2ZXNcbiAqIG51bGwgb25seSBmb3IgYSBjb25maXJtZWQgYWJzZW5jZSAoYSA0MDQsIG9yIGEgZGVsZXRlIHRoYXQgbGFuZGVkKSBvciBhIHN0b3JlZFxuICogSlNPTiBudWxsLCBhbmQgZ2V0VmFsdWVzKCkgcmV0dXJucyBhbiBlbXB0eSBwYWdlIG9ubHkgZm9yIGEgZ2VudWluZWx5IGVtcHR5XG4gKiBsaXN0aW5nLiBBIGRlbGV0ZSB0aGF0IGZhaWxzIHRocm93cywgYW5kIHJlc29sdmVzIGZhbHNlIG9ubHkgZm9yIGEgY29uZmlybWVkIDQwNC5cbiAqIHNldCgpIHJlcG9ydHMgZmFpbHVyZSB0aHJvdWdoIGl0cyBib29sZWFuIHJlc3VsdCwgYW5kIHRocm93cyBmb3IgYSB2YWx1ZSB0aGF0XG4gKiBjYW5ub3QgYmUgSlNPTi1zZXJpYWxpemVkLiBBIGdldCgpIGlzc3VlZCB3aGlsZSB3cml0ZXMgdG8gaXRzIGtleSBhcmUgcGVuZGluZ1xuICogd2FpdHMgZm9yIHRoZW0sIHNvIGl0IHJlZmxlY3RzIHRoZW07IGdldFZhbHVlcygpIGRvZXMgbm90IHdhaXQuIE5vdGhpbmcgaXNcbiAqIHJldHJpZWQg4oCUIHRoYXQgaXMgdGhlIGNhbGxlcidzIHRvIGRlY2lkZS5cbiAqXG4gKiBSZWFkcyBhcmUgY2FjaGVkIGJ5IGRlZmF1bHQ6IGdldCgpIHNlcnZlcyB2YWx1ZXMga25vd24gZnJvbSBhIG5ldHdvcmtcbiAqIHJvdW5kLXRyaXAgd2l0aGluIHRoZSBsYXN0IGNhY2hlTWF4QWdlTXMgKGluY2x1ZGluZyBjb25maXJtZWQgXCJub3QgZm91bmRcIlxuICogcmVzdWx0cykgd2l0aG91dCBoaXR0aW5nIHRoZSBzZXJ2aWNlLCBhbmQgY29uY3VycmVudCBnZXRzIGZvciB0aGUgc2FtZSBrZXlcbiAqIHNoYXJlIG9uZSByZXF1ZXN0LiBPdmVybGFwcGluZyB3cml0ZXMgdG8gdGhlIHNhbWUga2V5IGFyZSBzZXJpYWxpemVkIHNvIHRoZVxuICogc2VydmljZSBjb21taXRzIHRoZW0gaW4gaXNzdWUgb3JkZXIsIGFuZCByYXBpZCB3cml0ZXMgY29hbGVzY2UgdG8gdGhlXG4gKiBsYXRlc3QgdmFsdWU7IGEgc2V0KCkvZGVsZXRlKCkgc2V0dGxlcyBvbmNlIGl0cyBvd24gd3JpdGUsIG9yIHRoZSBuZXdlclxuICogd3JpdGUgdGhhdCByZXBsYWNlZCBpdCwgbGFuZHMgb3IgZmFpbHMuIEJ5IGRlZmF1bHQgKHNraXBJZlVuY2hhbmdlZClcbiAqIGFuIHVuY2hhbmdlZCBzZXQgaXMgc2tpcHBlZCwgYnV0IG9ubHkgd2hlbiBhIHByZXZpb3VzIGNvbmZpcm1lZCByb3VuZC10cmlwXG4gKiBwcm92ZWQgdGhlIGV4YWN0IHZhbHVlIGlzIGFscmVhZHkgc3RvcmVkLiBPdXQtb2YtYmFuZCB3cml0ZXJzIChlLmcuIENMSSBzdG9yYWdlIGNvbW1hbmRzKVxuICogbWF5IG5vdCBiZSB2aXNpYmxlIGZvciB1cCB0byBjYWNoZU1heEFnZU1zOyB1c2UgZ2V0KGtleSwgeyBmcmVzaDogdHJ1ZSB9KVxuICogZm9yIGFuIGF1dGhvcml0YXRpdmUgcmVhZCBvciBTdG9yYWdlLmNvbmZpZ3VyZSh7IGNhY2hlUmVhZHM6IGZhbHNlIH0pIHRvXG4gKiBkaXNhYmxlIHJlYWQgY2FjaGluZy5cbiAqXG4gKiBUaGlzIG1vZHVsZSBvbmx5IHdvcmtzIHdoZW4gcnVubmluZyBvbiBzZXJ2ZXItc2lkZSBzY2VuZXMuXG4gKi9cbmV4cG9ydCBjb25zdCBTdG9yYWdlOiBJU3RvcmFnZSA9IGNyZWF0ZVN0b3JhZ2UoKVxuIl19

package/server/storage/player.d.ts

@@ -0,0 +1,60 @@
+import { GetOptions, GetValuesOptions, GetValuesResult, SetOptions } from './constants';
+/**
+ * Player-scoped storage interface for key-value pairs from the Server Side Storage service.
+ * This is NOT filesystem storage - data is stored in the remote storage service.
+ */
+export interface IPlayerStorage {
+    /**
+     * Retrieves a value from a player's storage by key from the Server Side Storage service.
+     *
+     * By default (cacheReads), values read or written during the last cacheMaxAgeMs
+     * are served from a local cache without a network request, including confirmed
+     * "not found" results. Concurrent gets for the same player and key share one
+     * request. Out-of-band writers (e.g. CLI storage commands) may not be visible
+     * for up to cacheMaxAgeMs — pass { fresh: true } to force a network read.
+     * A read first waits for writes to the same key that were pending when it was
+     * issued, so it reflects every write issued before it.
+     * @param address - The player's wallet address
+     * @param key - The key to retrieve
+     * @param options - Optional { fresh } to bypass the read cache
+     * @returns A promise that resolves to the parsed JSON value, or null if not found
+     * @throws Error if the read fails, so a failure is never mistaken for a missing key
+     * @throws TypeError if the address or key is invalid
+     */
+    get<T = unknown>(address: string, key: string, options?: GetOptions): Promise<T | null>;
+    /**
+     * Stores a value in a player's storage in the Server Side Storage service.
+     * @param address - The player's wallet address
+     * @param key - The key to store the value under
+     * @param value - The value to store (will be JSON serialized)
+     * @param options - Optional { skipIfUnchanged } to skip the network write when the value is already stored
+     * @returns true once stored, or once a newer write that replaced this one lands
+     * (rapid writes coalesce); false if the write, or its replacement, fails
+     * @throws TypeError if the address or key is invalid, or the value cannot be stored unchanged: undefined,
+     * circular, a BigInt, or containing a function, a symbol, a non-finite number, an undefined array
+     * element or hole, a Map, Set, typed array or other built-in with no JSON form, or text with an
+     * unpaired surrogate or a NUL character. An undefined object property is dropped; a Date is
+     * stored as its ISO string and a class instance as its own enumerable data.
+     */
+    set<T = unknown>(address: string, key: string, value: T, options?: SetOptions): Promise<boolean>;
+    /**
+     * Deletes a value from a player's storage in the Server Side Storage service.
+     * @param address - The player's wallet address
+     * @param key - The key to delete
+     * @returns true once applied, or once a newer write that replaced it lands;
+     * false only for a confirmed 404
+     * @throws Error if the delete, or its replacement, fails; a failure is never reported as absence
+     * @throws TypeError if the address or key is invalid
+     */
+    delete(address: string, key: string): Promise<boolean>;
+    /**
+     * Returns key-value entries from a player's storage, optionally filtered by prefix.
+     * Supports pagination via limit and offset.
+     * @param address - The player's wallet address
+     * @param options - Optional { prefix, limit, offset } for filtering and pagination.
+     * @returns A promise that resolves to { data, pagination: { offset, total } } for pagination UI
+     * @throws Error if the read fails, so a failure is never mistaken for an empty page
+     * @throws TypeError if the address is invalid
+     */
+    getValues(address: string, options?: GetValuesOptions): Promise<GetValuesResult>;
+}

package/server/storage/player.js

@@ -0,0 +1,244 @@
+import { getStorageServerUrl } from '../storage-url';
+import { assertIsServer, wrapSignedFetch } from '../utils';
+import { createStorageConfig, MODULE_NAME } from './constants';
+import { createValueCache } from './value-cache';
+import { errorMessage } from './error-message';
+import { assertPlayerAddress, assertStorageKey, serializeStorageValue } from './serialize';
+import { createWriteQueue, SupersedingWriteFailed } from './write-queue';
+/**
+ * Creates player-scoped storage that provides methods to interact with
+ * player-specific key-value pairs from the Server Side Storage service.
+ * This module only works when running on server-side scenes.
+ * @internal
+ */
+export const createPlayerStorage = (config = createStorageConfig()) => {
+    const cache = createValueCache(config);
+    // Each in-flight GET is tracked by a wrapper object whose identity marks
+    // ownership: a landed write detaches the pending GET so its stale response is not cached.
+    const inflightGets = new Map();
+    // Lowercased so checksummed callers share an entry.
+    const cacheKey = (address, key) => JSON.stringify([address.toLowerCase(), key]);
+    // Writes to the same player key are serialized (and rapid ones coalesced to
+    // the latest value) so the service commits them in issue order — overlapping
+    // PUTs would otherwise leave both the kept value and the cached value to
+    // response-order chance. Keyed by the same case-insensitive cache key.
+    const writes = createWriteQueue();
+    async function executeSet(address, key, ck, body) {
+        let baseUrl;
+        try {
+            baseUrl = await getStorageServerUrl();
+        }
+        catch (error) {
+            cache.delete(ck);
+            console.error(`Failed to set player storage value '${key}' for '${address}': ${errorMessage(error)}`);
+            return false;
+        }
+        const url = `${baseUrl}/players/${encodeURIComponent(address)}/values/${encodeURIComponent(key)}`;
+        const [error] = await wrapSignedFetch({
+            url,
+            init: {
+                method: 'PUT',
+                headers: {
+                    'content-type': 'application/json'
+                },
+                body
+            }
+        });
+        // Either way the entry changed server-side (or may have): detach any
+        // overlapping in-flight GET so its stale response is not cached.
+        inflightGets.delete(ck);
+        if (error) {
+            // The PUT may have reached the server, so the cached body is no
+            // longer reliable.
+            cache.delete(ck);
+            return false;
+        }
+        cache.set(ck, { body });
+        return true;
+    }
+    async function executeDelete(address, key, ck) {
+        let baseUrl;
+        try {
+            baseUrl = await getStorageServerUrl();
+        }
+        catch (error) {
+            cache.delete(ck);
+            throw new Error(`Failed to delete player storage value '${key}' for '${address}': ${errorMessage(error)}`);
+        }
+        const url = `${baseUrl}/players/${encodeURIComponent(address)}/values/${encodeURIComponent(key)}`;
+        const [error, , status] = await wrapSignedFetch({
+            url,
+            init: {
+                method: 'DELETE',
+                headers: {}
+            }
+        });
+        // Detach again: a GET may have started while the DELETE was in flight.
+        inflightGets.delete(ck);
+        if (error) {
+            // A 404 still confirms the key is absent server-side.
+            if (status === 404) {
+                cache.setAbsent(ck);
+                return false;
+            }
+            // The DELETE may have reached the server, so the cached body is unreliable.
+            cache.delete(ck);
+            throw new Error(`Failed to delete player storage value '${key}' for '${address}': ${errorMessage(error)}`);
+        }
+        cache.setAbsent(ck);
+        return true;
+    }
+    return {
+        async get(address, key, options) {
+            assertIsServer(MODULE_NAME);
+            assertPlayerAddress(address, 'Storage.player.get()');
+            assertStorageKey(key, 'Storage.player.get()');
+            const ck = cacheKey(address, key);
+            if (writes.isPending(ck))
+                await writes.settled(ck);
+            if (config.cacheReads && !options?.fresh) {
+                const entry = cache.get(ck);
+                if (entry?.absent)
+                    return null;
+                // Parse per hit so each caller gets a fresh object (no shared mutation).
+                if (entry?.body !== undefined)
+                    return JSON.parse(entry.body).value;
+            }
+            // Coalesce concurrent gets (even fresh ones: an in-flight response is
+            // milliseconds old, not TTL-stale) into a single network request.
+            const joined = inflightGets.get(ck);
+            if (joined)
+                return joined.promise;
+            const inflight = {};
+            inflight.promise = (async () => {
+                try {
+                    let baseUrl;
+                    try {
+                        baseUrl = await getStorageServerUrl();
+                    }
+                    catch (error) {
+                        throw new Error(`Failed to get player storage value '${key}' for '${address}': ${errorMessage(error)}`);
+                    }
+                    const url = `${baseUrl}/players/${encodeURIComponent(address)}/values/${encodeURIComponent(key)}`;
+                    const [error, data, status] = await wrapSignedFetch({ url });
+                    const isOwner = inflightGets.get(ck) === inflight;
+                    if (error) {
+                        // A confirmed 404 is a first-class "absent" outcome, not a failure.
+                        if (status === 404) {
+                            if (isOwner)
+                                cache.setAbsent(ck);
+                            return null;
+                        }
+                        throw new Error(`Failed to get player storage value '${key}' for '${address}': ${errorMessage(error)}`);
+                    }
+                    // wrapSignedFetch parses an empty 2xx body as {}: a missing value is a fault, not an absence.
+                    if (!data || data.value === undefined) {
+                        throw new Error(`Failed to get player storage value '${key}' for '${address}': response carried no value`);
+                    }
+                    // Same serialization shape as set()'s PUT body, so a read followed by
+                    // an unchanged write can be skipped.
+                    const body = JSON.stringify({ value: data.value });
+                    if (isOwner)
+                        cache.set(ck, { body });
+                    return data.value;
+                }
+                finally {
+                    if (inflightGets.get(ck) === inflight)
+                        inflightGets.delete(ck);
+                }
+            })();
+            inflightGets.set(ck, inflight);
+            return inflight.promise;
+        },
+        async set(address, key, value, options) {
+            assertIsServer(MODULE_NAME);
+            assertPlayerAddress(address, 'Storage.player.set()');
+            assertStorageKey(key, 'Storage.player.set()');
+            const ck = cacheKey(address, key);
+            const body = serializeStorageValue(value, `Storage.player.set('${address}', '${key}')`);
+            const skipIfUnchanged = options?.skipIfUnchanged ?? config.skipIfUnchanged;
+            // Dedup against confirmed state only while no write is pending — a
+            // pending write makes the cache momentarily stale; enqueue() coalesces
+            // against pending writes instead.
+            if (skipIfUnchanged && writes.pending(ck) === undefined && cache.get(ck)?.body === body) {
+                return true;
+            }
+            return writes.enqueue(ck, body, (b) => executeSet(address, key, ck, b), skipIfUnchanged);
+        },
+        async delete(address, key) {
+            assertIsServer(MODULE_NAME);
+            assertPlayerAddress(address, 'Storage.player.delete()');
+            assertStorageKey(key, 'Storage.player.delete()');
+            const ck = cacheKey(address, key);
+            return writes
+                .enqueue(ck, null, () => executeDelete(address, key, ck), true)
+                .catch((error) => {
+                if (error instanceof SupersedingWriteFailed) {
+                    throw new Error(`Failed to delete player storage value '${key}' for '${address}': ${error.message}`);
+                }
+                throw error;
+            });
+        },
+        async getValues(address, options) {
+            assertIsServer(MODULE_NAME);
+            assertPlayerAddress(address, 'Storage.player.getValues()');
+            const { prefix, limit, offset } = options ?? {};
+            let baseUrl;
+            try {
+                baseUrl = await getStorageServerUrl();
+            }
+            catch (error) {
+                throw new Error(`Failed to get player storage values for '${address}': ${errorMessage(error)}`);
+            }
+            const parts = [];
+            if (!!prefix) {
+                parts.push(`prefix=${encodeURIComponent(prefix)}`);
+            }
+            if (!!limit) {
+                parts.push(`limit=${limit}`);
+            }
+            if (!!offset) {
+                parts.push(`offset=${offset}`);
+            }
+            const query = parts.join('&');
+            const url = query
+                ? `${baseUrl}/players/${encodeURIComponent(address)}/values?${query}`
+                : `${baseUrl}/players/${encodeURIComponent(address)}/values`;
+            const watcher = cache.watch();
+            const [error, response] = await wrapSignedFetch({ url });
+            watcher.stop();
+            if (error) {
+                throw new Error(`Failed to get player storage values for '${address}': ${errorMessage(error)}`);
+            }
+            const data = response?.data;
+            if (!Array.isArray(data)) {
+                throw new Error(`Failed to get player storage values for '${address}': response carried no data array`);
+            }
+            if (data.some((entry) => typeof entry?.key !== 'string' || entry.value === undefined)) {
+                throw new Error(`Failed to get player storage values for '${address}': response carried a malformed entry`);
+            }
+            // Seed the per-key cache so subsequent get()/set() on returned keys can
+            // skip the network. Only keys with no live entry and no pending write
+            // are seeded: existing per-key state comes from a confirmed operation
+            // that this page snapshot — whose request started earlier — must not
+            // clobber with stale data. Absence is never seeded (prefix/pagination
+            // make it non-authoritative). A page larger than cacheMaxEntries churns
+            // the cache; entries repopulate lazily.
+            for (const entry of data) {
+                const ck = cacheKey(address, entry.key);
+                if (watcher.mutated(ck) || writes.isPending(ck) || inflightGets.has(ck))
+                    continue;
+                if (cache.get(ck) === undefined) {
+                    cache.set(ck, { body: JSON.stringify({ value: entry.value }) });
+                }
+            }
+            const requestedOffset = offset ?? 0;
+            const pagination = {
+                offset: response.pagination?.offset ?? requestedOffset,
+                total: response.pagination?.total ?? data.length
+            };
+            return { data, pagination };
+        }
+    };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGxheWVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcnZlci9zdG9yYWdlL3BsYXllci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQTtBQUNwRCxPQUFPLEVBQUUsY0FBYyxFQUFFLGVBQWUsRUFBRSxNQUFNLFVBQVUsQ0FBQTtBQUMxRCxPQUFPLEVBQ0wsbUJBQW1CLEVBSW5CLFdBQVcsRUFHWixNQUFNLGFBQWEsQ0FBQTtBQUNwQixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxlQUFlLENBQUE7QUFDaEQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGlCQUFpQixDQUFBO0FBQzlDLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxnQkFBZ0IsRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGFBQWEsQ0FBQTtBQUMxRixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxlQUFlLENBQUE7QUFpRXhFOzs7OztHQUtHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQUcsQ0FBQyxTQUE2QixtQkFBbUIsRUFBRSxFQUFrQixFQUFFO0lBQ3hHLE1BQU0sS0FBSyxHQUFHLGdCQUFnQixDQUFDLE1BQU0sQ0FBQyxDQUFBO0lBQ3RDLHlFQUF5RTtJQUN6RSwwRkFBMEY7SUFDMUYsTUFBTSxZQUFZLEdBQUcsSUFBSSxHQUFHLEVBQXlDLENBQUE7SUFFckUsb0RBQW9EO0lBQ3BELE1BQU0sUUFBUSxHQUFHLENBQUMsT0FBZSxFQUFFLEdBQVcsRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxXQUFXLEVBQUUsRUFBRSxHQUFHLENBQUMsQ0FBQyxDQUFBO0lBRS9GLDRFQUE0RTtJQUM1RSw2RUFBNkU7SUFDN0UseUVBQXlFO0lBQ3pFLHVFQUF1RTtJQUN2RSxNQUFNLE1BQU0sR0FBRyxnQkFBZ0IsRUFBRSxD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QUFNLElBQUksQ0FBQyxDQUFBO1lBQ25DLE1BQU0sVUFBVSxHQUFHO2dCQUNqQixNQUFNLEVBQUUsUUFBUyxDQUFDLFVBQVUsRUFBRSxNQUFNLElBQUksZUFBZTtnQkFDdkQsS0FBSyxFQUFFLFFBQVMsQ0FBQyxVQUFVLEVBQUUsS0FBSyxJQUFJLElBQUksQ0FBQyxNQUFNO2FBQ2xELENBQUE7WUFFRCxPQUFPLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxDQUFBO1FBQzdCLENBQUM7S0FDRixDQUFBO0FBQ0gsQ0FBQyxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgZ2V0U3RvcmFnZVNlcnZlclVybCB9IGZyb20gJy4uL3N0b3JhZ2UtdXJsJ1xuaW1wb3J0IHsgYXNzZXJ0SXNTZXJ2ZXIsIHdyYXBTaWduZWRGZXRjaCB9IGZyb20gJy4uL3V0aWxzJ1xuaW1wb3J0IHtcbiAgY3JlYXRlU3RvcmFnZUNvbmZpZyxcbiAgR2V0T3B0aW9ucyxcbiAgR2V0VmFsdWVzT3B0aW9ucyxcbiAgR2V0VmFsdWVzUmVzdWx0LFxuICBNT0RVTEVfTkFNRSxcbiAgU2V0T3B0aW9ucyxcbiAgU3RvcmFnZUNvbmZpZ1N0YXRlXG59IGZyb20gJy4vY29uc3RhbnRzJ1xuaW1wb3J0IHsgY3JlYXRlVmFsdWVDYWNoZSB9IGZyb20gJy4vdmFsdWUtY2FjaGUnXG5pbXBvcnQgeyBlcnJvck1lc3NhZ2UgfSBmcm9tICcuL2Vycm9yLW1lc3NhZ2UnXG5pbXBvcnQgeyBhc3NlcnRQbGF5ZXJBZGRyZXNzLCBhc3NlcnRTdG9yYWdlS2V5LCBzZXJpYWxpemVTdG9yYWdlVmFsdWUgfSBmcm9tICcuL3NlcmlhbGl6ZSdcbmltcG9ydCB7IGNyZWF0ZVdyaXRlUXVldWUsIFN1cGVyc2VkaW5nV3JpdGVGYWlsZWQgfSBmcm9tICcuL3dyaXRlLXF1ZXVlJ1xuXG4vKipcbiAqIFBsYXllci1zY29wZWQgc3RvcmFnZSBpbnRlcmZhY2UgZm9yIGtleS12YWx1ZSBwYWlycyBmcm9tIHRoZSBTZXJ2ZXIgU2lkZSBTdG9yYWdlIHNlcnZpY2UuXG4gKiBUaGlzIGlzIE5PVCBmaWxlc3lzdGVtIHN0b3JhZ2UgLSBkYXRhIGlzIHN0b3JlZCBpbiB0aGUgcmVtb3RlIHN0b3JhZ2Ugc2VydmljZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJUGxheWVyU3RvcmFnZSB7XG4gIC8qKlxuICAgKiBSZXRyaWV2ZXMgYSB2YWx1ZSBmcm9tIGEgcGxheWVyJ3Mgc3RvcmFnZSBieSBrZXkgZnJvbSB0aGUgU2VydmVyIFNpZGUgU3RvcmFnZSBzZXJ2aWNlLlxuICAgKlxuICAgKiBCeSBkZWZhdWx0IChjYWNoZVJlYWRzKSwgdmFsdWVzIHJlYWQgb3Igd3JpdHRlbiBkdXJpbmcgdGhlIGxhc3QgY2FjaGVNYXhBZ2VNc1xuICAgKiBhcmUgc2VydmVkIGZyb20gYSBsb2NhbCBjYWNoZSB3aXRob3V0IGEgbmV0d29yayByZXF1ZXN0LCBpbmNsdWRpbmcgY29uZmlybWVkXG4gICAqIFwibm90IGZvdW5kXCIgcmVzdWx0cy4gQ29uY3VycmVudCBnZXRzIGZvciB0aGUgc2FtZSBwbGF5ZXIgYW5kIGtleSBzaGFyZSBvbmVcbiAgICogcmVxdWVzdC4gT3V0LW9mLWJhbmQgd3JpdGVycyAoZS5nLiBDTEkgc3RvcmFnZSBjb21tYW5kcykgbWF5IG5vdCBiZSB2aXNpYmxlXG4gICAqIGZvciB1cCB0byBjYWNoZU1heEFnZU1zIOKAlCBwYXNzIHsgZnJlc2g6IHRydWUgfSB0byBmb3JjZSBhIG5ldHdvcmsgcmVhZC5cbiAgICogQSByZWFkIGZpcnN0IHdhaXRzIGZvciB3cml0ZXMgdG8gdGhlIHNhbWUga2V5IHRoYXQgd2VyZSBwZW5kaW5nIHdoZW4gaXQgd2FzXG4gICAqIGlzc3VlZCwgc28gaXQgcmVmbGVjdHMgZXZlcnkgd3JpdGUgaXNzdWVkIGJlZm9yZSBpdC5cbiAgICogQHBhcmFtIGFkZHJlc3MgLSBUaGUgcGxheWVyJ3Mgd2FsbGV0IGFkZHJlc3NcbiAgICogQHBhcmFtIGtleSAtIFRoZSBrZXkgdG8gcmV0cmlldmVcbiAgICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25hbCB7IGZyZXNoIH0gdG8gYnlwYXNzIHRoZSByZWFkIGNhY2hlXG4gICAqIEByZXR1cm5zIEEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIHRvIHRoZSBwYXJzZWQgSlNPTiB2YWx1ZSwgb3IgbnVsbCBpZiBub3QgZm91bmRcbiAgICogQHRocm93cyBFcnJvciBpZiB0aGUgcmVhZCBmYWlscywgc28gYSBmYWlsdXJlIGlzIG5ldmVyIG1pc3Rha2VuIGZvciBhIG1pc3Npbmcga2V5XG4gICAqIEB0aHJvd3MgVHlwZUVycm9yIGlmIHRoZSBhZGRyZXNzIG9yIGtleSBpcyBpbnZhbGlkXG4gICAqL1xuICBnZXQ8VCA9IHVua25vd24+KGFkZHJlc3M6IHN0cmluZywga2V5OiBzdHJpbmcsIG9wdGlvbnM/OiBHZXRPcHRpb25zKTogUHJvbWlzZTxUIHwgbnVsbD5cblxuICAvKipcbiAgICogU3RvcmVzIGEgdmFsdWUgaW4gYSBwbGF5ZXIncyBzdG9yYWdlIGluIHRoZSBTZXJ2ZXIgU2lkZSBTdG9yYWdlIHNlcnZpY2UuXG4gICAqIEBwYXJhbSBhZGRyZXNzIC0gVGhlIHBsYXllcidzIHdhbGxldCBhZGRyZXNzXG4gICAqIEBwYXJhbSBrZXkgLSBUaGUga2V5IHRvIHN0b3JlIHRoZSB2YWx1ZSB1bmRlclxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgdmFsdWUgdG8gc3RvcmUgKHdpbGwgYmUgSlNPTiBzZXJpYWxpemVkKVxuICAgKiBAcGFyYW0gb3B0aW9ucyAtIE9wdGlvbmFsIHsgc2tpcElmVW5jaGFuZ2VkIH0gdG8gc2tpcCB0aGUgbmV0d29yayB3cml0ZSB3aGVuIHRoZSB2YWx1ZSBpcyBhbHJlYWR5IHN0b3JlZFxuICAgKiBAcmV0dXJucyB0cnVlIG9uY2Ugc3RvcmVkLCBvciBvbmNlIGEgbmV3ZXIgd3JpdGUgdGhhdCByZXBsYWNlZCB0aGlzIG9uZSBsYW5kc1xuICAgKiAocmFwaWQgd3JpdGVzIGNvYWxlc2NlKTsgZmFsc2UgaWYgdGhlIHdyaXRlLCBvciBpdHMgcmVwbGFjZW1lbnQsIGZhaWxzXG4gICAqIEB0aHJvd3MgVHlwZUVycm9yIGlmIHRoZSBhZGRyZXNzIG9yIGtleSBpcyBpbnZhbGlkLCBvciB0aGUgdmFsdWUgY2Fubm90IGJlIHN0b3JlZCB1bmNoYW5nZWQ6IHVuZGVmaW5lZCxcbiAgICogY2lyY3VsYXIsIGEgQmlnSW50LCBvciBjb250YWluaW5nIGEgZnVuY3Rpb24sIGEgc3ltYm9sLCBhIG5vbi1maW5pdGUgbnVtYmVyLCBhbiB1bmRlZmluZWQgYXJyYXlcbiAgICogZWxlbWVudCBvciBob2xlLCBhIE1hcCwgU2V0LCB0eXBlZCBhcnJheSBvciBvdGhlciBidWlsdC1pbiB3aXRoIG5vIEpTT04gZm9ybSwgb3IgdGV4dCB3aXRoIGFuXG4gICAqIHVucGFpcmVkIHN1cnJvZ2F0ZSBvciBhIE5VTCBjaGFyYWN0ZXIuIEFuIHVuZGVmaW5lZCBvYmplY3QgcHJvcGVydHkgaXMgZHJvcHBlZDsgYSBEYXRlIGlzXG4gICAqIHN0b3JlZCBhcyBpdHMgSVNPIHN0cmluZyBhbmQgYSBjbGFzcyBpbnN0YW5jZSBhcyBpdHMgb3duIGVudW1lcmFibGUgZGF0YS5cbiAgICovXG4gIHNldDxUID0gdW5rbm93bj4oYWRkcmVzczogc3RyaW5nLCBrZXk6IHN0cmluZywgdmFsdWU6IFQsIG9wdGlvbnM/OiBTZXRPcHRpb25zKTogUHJvbWlzZTxib29sZWFuPlxuXG4gIC8qKlxuICAgKiBEZWxldGVzIGEgdmFsdWUgZnJvbSBhIHBsYXllcidzIHN0b3JhZ2UgaW4gdGhlIFNlcnZlciBTaWRlIFN0b3JhZ2Ugc2VydmljZS5cbiAgICogQHBhcmFtIGFkZHJlc3MgLSBUaGUgcGxheWVyJ3Mgd2FsbGV0IGFkZHJlc3NcbiAgICogQHBhcmFtIGtleSAtIFRoZSBrZXkgdG8gZGVsZXRlXG4gICAqIEByZXR1cm5zIHRydWUgb25jZSBhcHBsaWVkLCBvciBvbmNlIGEgbmV3ZXIgd3JpdGUgdGhhdCByZXBsYWNlZCBpdCBsYW5kcztcbiAgICogZmFsc2Ugb25seSBmb3IgYSBjb25maXJtZWQgNDA0XG4gICAqIEB0aHJvd3MgRXJyb3IgaWYgdGhlIGRlbGV0ZSwgb3IgaXRzIHJlcGxhY2VtZW50LCBmYWlsczsgYSBmYWlsdXJlIGlzIG5ldmVyIHJlcG9ydGVkIGFzIGFic2VuY2VcbiAgICogQHRocm93cyBUeXBlRXJyb3IgaWYgdGhlIGFkZHJlc3Mgb3Iga2V5IGlzIGludmFsaWRcbiAgICovXG4gIGRlbGV0ZShhZGRyZXNzOiBzdHJpbmcsIGtleTogc3RyaW5nKTogUHJvbWlzZTxib29sZWFuPlxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIGtleS12YWx1ZSBlbnRyaWVzIGZyb20gYSBwbGF5ZXIncyBzdG9yYWdlLCBvcHRpb25hbGx5IGZpbHRlcmVkIGJ5IHByZWZpeC5cbiAgICogU3VwcG9ydHMgcGFnaW5hdGlvbiB2aWEgbGltaXQgYW5kIG9mZnNldC5cbiAgICogQHBhcmFtIGFkZHJlc3MgLSBUaGUgcGxheWVyJ3Mgd2FsbGV0IGFkZHJlc3NcbiAgICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25hbCB7IHByZWZpeCwgbGltaXQsIG9mZnNldCB9IGZvciBmaWx0ZXJpbmcgYW5kIHBhZ2luYXRpb24uXG4gICAqIEByZXR1cm5zIEEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIHRvIHsgZGF0YSwgcGFnaW5hdGlvbjogeyBvZmZzZXQsIHRvdGFsIH0gfSBmb3IgcGFnaW5hdGlvbiBVSVxuICAgKiBAdGhyb3dzIEVycm9yIGlmIHRoZSByZWFkIGZhaWxzLCBzbyBhIGZhaWx1cmUgaXMgbmV2ZXIgbWlzdGFrZW4gZm9yIGFuIGVtcHR5IHBhZ2VcbiAgICogQHRocm93cyBUeXBlRXJyb3IgaWYgdGhlIGFkZHJlc3MgaXMgaW52YWxpZFxuICAgKi9cbiAgZ2V0VmFsdWVzKGFkZHJlc3M6IHN0cmluZywgb3B0aW9ucz86IEdldFZhbHVlc09wdGlvbnMpOiBQcm9taXNlPEdldFZhbHVlc1Jlc3VsdD5cbn1cblxuLyoqXG4gKiBDcmVhdGVzIHBsYXllci1zY29wZWQgc3RvcmFnZSB0aGF0IHByb3ZpZGVzIG1ldGhvZHMgdG8gaW50ZXJhY3Qgd2l0aFxuICogcGxheWVyLXNwZWNpZmljIGtleS12YWx1ZSBwYWlycyBmcm9tIHRoZSBTZXJ2ZXIgU2lkZSBTdG9yYWdlIHNlcnZpY2UuXG4gKiBUaGlzIG1vZHVsZSBvbmx5IHdvcmtzIHdoZW4gcnVubmluZyBvbiBzZXJ2ZXItc2lkZSBzY2VuZXMuXG4gKiBAaW50ZXJuYWxcbiAqL1xuZXhwb3J0IGNvbnN0IGNyZWF0ZVBsYXllclN0b3JhZ2UgPSAoY29uZmlnOiBTdG9yYWdlQ29uZmlnU3RhdGUgPSBjcmVhdGVTdG9yYWdlQ29uZmlnKCkpOiBJUGxheWVyU3RvcmFnZSA9PiB7XG4gIGNvbnN0IGNhY2hlID0gY3JlYXRlVmFsdWVDYWNoZShjb25maWcpXG4gIC8vIEVhY2ggaW4tZmxpZ2h0IEdFVCBpcyB0cmFja2VkIGJ5IGEgd3JhcHBlciBvYmplY3Qgd2hvc2UgaWRlbnRpdHkgbWFya3NcbiAgLy8gb3duZXJzaGlwOiBhIGxhbmRlZCB3cml0ZSBkZXRhY2hlcyB0aGUgcGVuZGluZyBHRVQgc28gaXRzIHN0YWxlIHJlc3BvbnNlIGlzIG5vdCBjYWNoZWQuXG4gIGNvbnN0IGluZmxpZ2h0R2V0cyA9IG5ldyBNYXA8c3RyaW5nLCB7IHByb21pc2U6IFByb21pc2U8dW5rbm93bj4gfT4oKVxuXG4gIC8vIExvd2VyY2FzZWQgc28gY2hlY2tzdW1tZWQgY2FsbGVycyBzaGFyZSBhbiBlbnRyeS5cbiAgY29uc3QgY2FjaGVLZXkgPSAoYWRkcmVzczogc3RyaW5nLCBrZXk6IHN0cmluZykgPT4gSlNPTi5zdHJpbmdpZnkoW2FkZHJlc3MudG9Mb3dlckNhc2UoKSwga2V5XSlcblxuICAvLyBXcml0ZXMgdG8gdGhlIHNhbWUgcGxheWVyIGtleSBhcmUgc2VyaWFsaXplZCAoYW5kIHJhcGlkIG9uZXMgY29hbGVzY2VkIHRvXG4gIC8vIHRoZSBsYXRlc3QgdmFsdWUpIHNvIHRoZSBzZXJ2aWNlIGNvbW1pdHMgdGhlbSBpbiBpc3N1ZSBvcmRlciDigJQgb3ZlcmxhcHBpbmdcbiAgLy8gUFVUcyB3b3VsZCBvdGhlcndpc2UgbGVhdmUgYm90aCB0aGUga2VwdCB2YWx1ZSBhbmQgdGhlIGNhY2hlZCB2YWx1ZSB0b1xuICAvLyByZXNwb25zZS1vcmRlciBjaGFuY2UuIEtleWVkIGJ5IHRoZSBzYW1lIGNhc2UtaW5zZW5zaXRpdmUgY2FjaGUga2V5LlxuICBjb25zdCB3cml0ZXMgPSBjcmVhdGVXcml0ZVF1ZXVlKClcblxuICBhc3luYyBmdW5jdGlvbiBleGVjdXRlU2V0KGFkZHJlc3M6IHN0cmluZywga2V5OiBzdHJpbmcsIGNrOiBzdHJpbmcsIGJvZHk6IHN0cmluZyk6IFByb21pc2U8Ym9vbGVhbj4ge1xuICAgIGxldCBiYXNlVXJsOiBzdHJpbmdcbiAgICB0cnkge1xuICAgICAgYmFzZVVybCA9IGF3YWl0IGdldFN0b3JhZ2VTZXJ2ZXJVcmwoKVxuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBjYWNoZS5kZWxldGUoY2spXG4gICAgICBjb25zb2xlLmVycm9yKGBGYWlsZWQgdG8gc2V0IHBsYXllciBzdG9yYWdlIHZhbHVlICcke2tleX0nIGZvciAnJHthZGRyZXNzfSc6ICR7ZXJyb3JNZXNzYWdlKGVycm9yKX1gKVxuICAgICAgcmV0dXJuIGZhbHNlXG4gICAgfVxuICAgIGNvbnN0IHVybCA9IGAke2Jhc2VVcmx9L3BsYXllcnMvJHtlbmNvZGVVUklDb21wb25lbnQoYWRkcmVzcyl9L3ZhbHVlcy8ke2VuY29kZVVSSUNvbXBvbmVudChrZXkpfWBcblxuICAgIGNvbnN0IFtlcnJvcl0gPSBhd2FpdCB3cmFwU2lnbmVkRmV0Y2goe1xuICAgICAgdXJsLFxuICAgICAgaW5pdDoge1xuICAgICAgICBtZXRob2Q6ICdQVVQnLFxuICAgICAgICBoZWFkZXJzOiB7XG4gICAgICAgICAgJ2NvbnRlbnQtdHlwZSc6ICdhcHBsaWNhdGlvbi9qc29uJ1xuICAgICAgICB9LFxuICAgICAgICBib2R5XG4gICAgICB9XG4gICAgfSlcblxuICAgIC8vIEVpdGhlciB3YXkgdGhlIGVudHJ5IGNoYW5nZWQgc2VydmVyLXNpZGUgKG9yIG1heSBoYXZlKTogZGV0YWNoIGFueVxuICAgIC8vIG92ZXJsYXBwaW5nIGluLWZsaWdodCBHRVQgc28gaXRzIHN0YWxlIHJlc3BvbnNlIGlzIG5vdCBjYWNoZWQuXG4gICAgaW5mbGlnaHRHZXRzLmRlbGV0ZShjaylcblxuICAgIGlmIChlcnJvcikge1xuICAgICAgLy8gVGhlIFBVVCBtYXkgaGF2ZSByZWFjaGVkIHRoZSBzZXJ2ZXIsIHNvIHRoZSBjYWNoZWQgYm9keSBpcyBub1xuICAgICAgLy8gbG9uZ2VyIHJlbGlhYmxlLlxuICAgICAgY2FjaGUuZGVsZXRlKGNrKVxuICAgICAgcmV0dXJuIGZhbHNlXG4gICAgfVxuXG4gICAgY2FjaGUuc2V0KGNrLCB7IGJvZHkgfSlcbiAgICByZXR1cm4gdHJ1ZVxuICB9XG5cbiAgYXN5bmMgZnVuY3Rpb24gZXhlY3V0ZURlbGV0ZShhZGRyZXNzOiBzdHJpbmcsIGtleTogc3RyaW5nLCBjazogc3RyaW5nKTogUHJvbWlzZTxib29sZWFuPiB7XG4gICAgbGV0IGJhc2VVcmw6IHN0cmluZ1xuICAgIHRyeSB7XG4gICAgICBiYXNlVXJsID0gYXdhaXQgZ2V0U3RvcmFnZVNlcnZlclVybCgpXG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIGNhY2hlLmRlbGV0ZShjaylcbiAgICAgIHRocm93IG5ldyBFcnJvcihgRmFpbGVkIHRvIGRlbGV0ZSBwbGF5ZXIgc3RvcmFnZSB2YWx1ZSAnJHtrZXl9JyBmb3IgJyR7YWRkcmVzc30nOiAke2Vycm9yTWVzc2FnZShlcnJvcil9YClcbiAgICB9XG4gICAgY29uc3QgdXJsID0gYCR7YmFzZVVybH0vcGxheWVycy8ke2VuY29kZVVSSUNvbXBvbmVudChhZGRyZXNzKX0vdmFsdWVzLyR7ZW5jb2RlVVJJQ29tcG9uZW50KGtleSl9YFxuXG4gICAgY29uc3QgW2Vycm9yLCAsIHN0YXR1c10gPSBhd2FpdCB3cmFwU2lnbmVkRmV0Y2goe1xuICAgICAgdXJsLFxuICAgICAgaW5pdDoge1xuICAgICAgICBtZXRob2Q6ICdERUxFVEUnLFxuICAgICAgICBoZWFkZXJzOiB7fVxuICAgICAgfVxuICAgIH0pXG5cbiAgICAvLyBEZXRhY2ggYWdhaW46IGEgR0VUIG1heSBoYXZlIHN0YXJ0ZWQgd2hpbGUgdGhlIERFTEVURSB3YXMgaW4gZmxpZ2h0LlxuICAgIGluZmxpZ2h0R2V0cy5kZWxldGUoY2spXG5cbiAgICBpZiAoZXJyb3IpIHtcbiAgICAgIC8vIEEgNDA0IHN0aWxsIGNvbmZpcm1zIHRoZSBrZXkgaXMgYWJzZW50IHNlcnZlci1zaWRlLlxuICAgICAgaWYgKHN0YXR1cyA9PT0gNDA0KSB7XG4gICAgICAgIGNhY2hlLnNldEFic2VudChjaylcbiAgICAgICAgcmV0dXJuIGZhbHNlXG4gICAgICB9XG4gICAgICAvLyBUaGUgREVMRVRFIG1heSBoYXZlIHJlYWNoZWQgdGhlIHNlcnZlciwgc28gdGhlIGNhY2hlZCBib2R5IGlzIHVucmVsaWFibGUuXG4gICAgICBjYWNoZS5kZWxldGUoY2spXG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYEZhaWxlZCB0byBkZWxldGUgcGxheWVyIHN0b3JhZ2UgdmFsdWUgJyR7a2V5fScgZm9yICcke2FkZHJlc3N9JzogJHtlcnJvck1lc3NhZ2UoZXJyb3IpfWApXG4gICAgfVxuXG4gICAgY2FjaGUuc2V0QWJzZW50KGNrKVxuICAgIHJldHVybiB0cnVlXG4gIH1cblxuICByZXR1cm4ge1xuICAgIGFzeW5jIGdldDxUID0gdW5rbm93bj4oYWRkcmVzczogc3RyaW5nLCBrZXk6IHN0cmluZywgb3B0aW9ucz86IEdldE9wdGlvbnMpOiBQcm9taXNlPFQgfCBudWxsPiB7XG4gICAgICBhc3NlcnRJc1NlcnZlcihNT0RVTEVfTkFNRSlcbiAgICAgIGFzc2VydFBsYXllckFkZHJlc3MoYWRkcmVzcywgJ1N0b3JhZ2UucGxheWVyLmdldCgpJylcbiAgICAgIGFzc2VydFN0b3JhZ2VLZXkoa2V5LCAnU3RvcmFnZS5wbGF5ZXIuZ2V0KCknKVxuXG4gICAgICBjb25zdCBjayA9IGNhY2hlS2V5KGFkZHJlc3MsIGtleSlcblxuICAgICAgaWYgKHdyaXRlcy5pc1BlbmRpbmcoY2spKSBhd2FpdCB3cml0ZXMuc2V0dGxlZChjaylcblxuICAgICAgaWYgKGNvbmZpZy5jYWNoZVJlYWRzICYmICFvcHRpb25zPy5mcmVzaCkge1xuICAgICAgICBjb25zdCBlbnRyeSA9IGNhY2hlLmdldChjaylcbiAgICAgICAgaWYgKGVudHJ5Py5hYnNlbnQpIHJldHVybiBudWxsXG4gICAgICAgIC8vIFBhcnNlIHBlciBoaXQgc28gZWFjaCBjYWxsZXIgZ2V0cyBhIGZyZXNoIG9iamVjdCAobm8gc2hhcmVkIG11dGF0aW9uKS5cbiAgICAgICAgaWYgKGVudHJ5Py5ib2R5ICE9PSB1bmRlZmluZWQpIHJldHVybiBKU09OLnBhcnNlKGVudHJ5LmJvZHkpLnZhbHVlIGFzIFRcbiAgICAgIH1cblxuICAgICAgLy8gQ29hbGVzY2UgY29uY3VycmVudCBnZXRzIChldmVuIGZyZXNoIG9uZXM6IGFuIGluLWZsaWdodCByZXNwb25zZSBpc1xuICAgICAgLy8gbWlsbGlzZWNvbmRzIG9sZCwgbm90IFRUTC1zdGFsZSkgaW50byBhIHNpbmdsZSBuZXR3b3JrIHJlcXVlc3QuXG4gICAgICBjb25zdCBqb2luZWQgPSBpbmZsaWdodEdldHMuZ2V0KGNrKVxuICAgICAgaWYgKGpvaW5lZCkgcmV0dXJuIGpvaW5lZC5wcm9taXNlIGFzIFByb21pc2U8VCB8IG51bGw+XG5cbiAgICAgIGNvbnN0IGluZmxpZ2h0ID0ge30gYXMgeyBwcm9taXNlOiBQcm9taXNlPFQgfCBudWxsPiB9XG4gICAgICBpbmZsaWdodC5wcm9taXNlID0gKGFzeW5jICgpID0+IHtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICBsZXQgYmFzZVVybDogc3RyaW5nXG4gICAgICAgICAgdHJ5IHtcbiAgICAgICAgICAgIGJhc2VVcmwgPSBhd2FpdCBnZXRTdG9yYWdlU2VydmVyVXJsKClcbiAgICAgICAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBGYWlsZWQgdG8gZ2V0IHBsYXllciBzdG9yYWdlIHZhbHVlICcke2tleX0nIGZvciAnJHthZGRyZXNzfSc6ICR7ZXJyb3JNZXNzYWdlKGVycm9yKX1gKVxuICAgICAgICAgIH1cbiAgICAgICAgICBjb25zdCB1cmwgPSBgJHtiYXNlVXJsfS9wbGF5ZXJzLyR7ZW5jb2RlVVJJQ29tcG9uZW50KGFkZHJlc3MpfS92YWx1ZXMvJHtlbmNvZGVVUklDb21wb25lbnQoa2V5KX1gXG5cbiAgICAgICAgICBjb25zdCBbZXJyb3IsIGRhdGEsIHN0YXR1c10gPSBhd2FpdCB3cmFwU2lnbmVkRmV0Y2g8eyB2YWx1ZTogVCB9Pih7IHVybCB9KVxuXG4gICAgICAgICAgY29uc3QgaXNPd25lciA9IGluZmxpZ2h0R2V0cy5nZXQoY2spID09PSBpbmZsaWdodFxuXG4gICAgICAgICAgaWYgKGVycm9yKSB7XG4gICAgICAgICAgICAvLyBBIGNvbmZpcm1lZCA0MDQgaXMgYSBmaXJzdC1jbGFzcyBcImFic2VudFwiIG91dGNvbWUsIG5vdCBhIGZhaWx1cmUuXG4gICAgICAgICAgICBpZiAoc3RhdHVzID09PSA0MDQpIHtcbiAgICAgICAgICAgICAgaWYgKGlzT3duZXIpIGNhY2hlLnNldEFic2VudChjaylcbiAgICAgICAgICAgICAgcmV0dXJuIG51bGxcbiAgICAgICAgICAgIH1cbiAgICAgICAgICAgIHRocm93IG5ldyBFcnJvcihgRmFpbGVkIHRvIGdldCBwbGF5ZXIgc3RvcmFnZSB2YWx1ZSAnJHtrZXl9JyBmb3IgJyR7YWRkcmVzc30nOiAke2Vycm9yTWVzc2FnZShlcnJvcil9YClcbiAgICAgICAgICB9XG5cbiAgICAgICAgICAvLyB3cmFwU2lnbmVkRmV0Y2ggcGFyc2VzIGFuIGVtcHR5IDJ4eCBib2R5IGFzIHt9OiBhIG1pc3NpbmcgdmFsdWUgaXMgYSBmYXVsdCwgbm90IGFuIGFic2VuY2UuXG4gICAgICAgICAgaWYgKCFkYXRhIHx8IGRhdGEudmFsdWUgPT09IHVuZGVmaW5lZCkge1xuICAgICAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBGYWlsZWQgdG8gZ2V0IHBsYXllciBzdG9yYWdlIHZhbHVlICcke2tleX0nIGZvciAnJHthZGRyZXNzfSc6IHJlc3BvbnNlIGNhcnJpZWQgbm8gdmFsdWVgKVxuICAgICAgICAgIH1cblxuICAgICAgICAgIC8vIFNhbWUgc2VyaWFsaXphdGlvbiBzaGFwZSBhcyBzZXQoKSdzIFBVVCBib2R5LCBzbyBhIHJlYWQgZm9sbG93ZWQgYnlcbiAgICAgICAgICAvLyBhbiB1bmNoYW5nZWQgd3JpdGUgY2FuIGJlIHNraXBwZWQuXG4gICAgICAgICAgY29uc3QgYm9keSA9IEpTT04uc3RyaW5naWZ5KHsgdmFsdWU6IGRhdGEudmFsdWUgfSlcbiAgICAgICAgICBpZiAoaXNPd25lcikgY2FjaGUuc2V0KGNrLCB7IGJvZHkgfSlcbiAgICAgICAgICByZXR1cm4gZGF0YS52YWx1ZVxuICAgICAgICB9IGZpbmFsbHkge1xuICAgICAgICAgIGlmIChpbmZsaWdodEdldHMuZ2V0KGNrKSA9PT0gaW5mbGlnaHQpIGluZmxpZ2h0R2V0cy5kZWxldGUoY2spXG4gICAgICAgIH1cbiAgICAgIH0pKClcblxuICAgICAgaW5mbGlnaHRHZXRzLnNldChjaywgaW5mbGlnaHQpXG4gICAgICByZXR1cm4gaW5mbGlnaHQucHJvbWlzZVxuICAgIH0sXG5cbiAgICBhc3luYyBzZXQ8VCA9IHVua25vd24+KGFkZHJlc3M6IHN0cmluZywga2V5OiBzdHJpbmcsIHZhbHVlOiBULCBvcHRpb25zPzogU2V0T3B0aW9ucyk6IFByb21pc2U8Ym9vbGVhbj4ge1xuICAgICAgYXNzZXJ0SXNTZXJ2ZXIoTU9EVUxFX05BTUUpXG4gICAgICBhc3NlcnRQbGF5ZXJBZGRyZXNzKGFkZHJlc3MsICdTdG9yYWdlLnBsYXllci5zZXQoKScpXG4gICAgICBhc3NlcnRTdG9yYWdlS2V5KGtleSwgJ1N0b3JhZ2UucGxheWVyLnNldCgpJylcblxuICAgICAgY29uc3QgY2sgPSBjYWNoZUtleShhZGRyZXNzLCBrZXkpXG4gICAgICBjb25zdCBib2R5ID0gc2VyaWFsaXplU3RvcmFnZVZhbHVlKHZhbHVlLCBgU3RvcmFnZS5wbGF5ZXIuc2V0KCcke2FkZHJlc3N9JywgJyR7a2V5fScpYClcbiAgICAgIGNvbnN0IHNraXBJZlVuY2hhbmdlZCA9IG9wdGlvbnM/LnNraXBJZlVuY2hhbmdlZCA/PyBjb25maWcuc2tpcElmVW5jaGFuZ2VkXG5cbiAgICAgIC8vIERlZHVwIGFnYWluc3QgY29uZmlybWVkIHN0YXRlIG9ubHkgd2hpbGUgbm8gd3JpdGUgaXMgcGVuZGluZyDigJQgYVxuICAgICAgLy8gcGVuZGluZyB3cml0ZSBtYWtlcyB0aGUgY2FjaGUgbW9tZW50YXJpbHkgc3RhbGU7IGVucXVldWUoKSBjb2FsZXNjZXNcbiAgICAgIC8vIGFnYWluc3QgcGVuZGluZyB3cml0ZXMgaW5zdGVhZC5cbiAgICAgIGlmIChza2lwSWZVbmNoYW5nZWQgJiYgd3JpdGVzLnBlbmRpbmcoY2spID09PSB1bmRlZmluZWQgJiYgY2FjaGUuZ2V0KGNrKT8uYm9keSA9PT0gYm9keSkge1xuICAgICAgICByZXR1cm4gdHJ1ZVxuICAgICAgfVxuXG4gICAgICByZXR1cm4gd3JpdGVzLmVucXVldWUoY2ssIGJvZHksIChiKSA9PiBleGVjdXRlU2V0KGFkZHJlc3MsIGtleSwgY2ssIGIgYXMgc3RyaW5nKSwgc2tpcElmVW5jaGFuZ2VkKVxuICAgIH0sXG5cbiAgICBhc3luYyBkZWxldGUoYWRkcmVzczogc3RyaW5nLCBrZXk6IHN0cmluZyk6IFByb21pc2U8Ym9vbGVhbj4ge1xuICAgICAgYXNzZXJ0SXNTZXJ2ZXIoTU9EVUxFX05BTUUpXG4gICAgICBhc3NlcnRQbGF5ZXJBZGRyZXNzKGFkZHJlc3MsICdTdG9yYWdlLnBsYXllci5kZWxldGUoKScpXG4gICAgICBhc3NlcnRTdG9yYWdlS2V5KGtleSwgJ1N0b3JhZ2UucGxheWVyLmRlbGV0ZSgpJylcblxuICAgICAgY29uc3QgY2sgPSBjYWNoZUtleShhZGRyZXNzLCBrZXkpXG5cbiAgICAgIHJldHVybiB3cml0ZXNcbiAgICAgICAgLmVucXVldWUoY2ssIG51bGwsICgpID0+IGV4ZWN1dGVEZWxldGUoYWRkcmVzcywga2V5LCBjayksIHRydWUpXG4gICAgICAgIC5jYXRjaCgoZXJyb3I6IHVua25vd24pID0+IHtcbiAgICAgICAgICBpZiAoZXJyb3IgaW5zdGFuY2VvZiBTdXBlcnNlZGluZ1dyaXRlRmFpbGVkKSB7XG4gICAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYEZhaWxlZCB0byBkZWxldGUgcGxheWVyIHN0b3JhZ2UgdmFsdWUgJyR7a2V5fScgZm9yICcke2FkZHJlc3N9JzogJHtlcnJvci5tZXNzYWdlfWApXG4gICAgICAgICAgfVxuICAgICAgICAgIHRocm93IGVycm9yXG4gICAgICAgIH0pXG4gICAgfSxcblxuICAgIGFzeW5jIGdldFZhbHVlcyhhZGRyZXNzOiBzdHJpbmcsIG9wdGlvbnM/OiBHZXRWYWx1ZXNPcHRpb25zKTogUHJvbWlzZTxHZXRWYWx1ZXNSZXN1bHQ+IHtcbiAgICAgIGFzc2VydElzU2VydmVyKE1PRFVMRV9OQU1FKVxuICAgICAgYXNzZXJ0UGxheWVyQWRkcmVzcyhhZGRyZXNzLCAnU3RvcmFnZS5wbGF5ZXIuZ2V0VmFsdWVzKCknKVxuXG4gICAgICBjb25zdCB7IHByZWZpeCwgbGltaXQsIG9mZnNldCB9ID0gb3B0aW9ucyA/PyB7fVxuICAgICAgbGV0IGJhc2VVcmw6IHN0cmluZ1xuICAgICAgdHJ5IHtcbiAgICAgICAgYmFzZVVybCA9IGF3YWl0IGdldFN0b3JhZ2VTZXJ2ZXJVcmwoKVxuICAgICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBGYWlsZWQgdG8gZ2V0IHBsYXllciBzdG9yYWdlIHZhbHVlcyBmb3IgJyR7YWRkcmVzc30nOiAke2Vycm9yTWVzc2FnZShlcnJvcil9YClcbiAgICAgIH1cbiAgICAgIGNvbnN0IHBhcnRzOiBzdHJpbmdbXSA9IFtdXG5cbiAgICAgIGlmICghIXByZWZpeCkge1xuICAgICAgICBwYXJ0cy5wdXNoKGBwcmVmaXg9JHtlbmNvZGVVUklDb21wb25lbnQocHJlZml4KX1gKVxuICAgICAgfVxuXG4gICAgICBpZiAoISFsaW1pdCkge1xuICAgICAgICBwYXJ0cy5wdXNoKGBsaW1pdD0ke2xpbWl0fWApXG4gICAgICB9XG5cbiAgICAgIGlmICghIW9mZnNldCkge1xuICAgICAgICBwYXJ0cy5wdXNoKGBvZmZzZXQ9JHtvZmZzZXR9YClcbiAgICAgIH1cblxuICAgICAgY29uc3QgcXVlcnkgPSBwYXJ0cy5qb2luKCcmJylcbiAgICAgIGNvbnN0IHVybCA9IHF1ZXJ5XG4gICAgICAgID8gYCR7YmFzZVVybH0vcGxheWVycy8ke2VuY29kZVVSSUNvbXBvbmVudChhZGRyZXNzKX0vdmFsdWVzPyR7cXVlcnl9YFxuICAgICAgICA6IGAke2Jhc2VVcmx9L3BsYXllcnMvJHtlbmNvZGVVUklDb21wb25lbnQoYWRkcmVzcyl9L3ZhbHVlc2BcblxuICAgICAgY29uc3Qgd2F0Y2hlciA9IGNhY2hlLndhdGNoKClcbiAgICAgIGNvbnN0IFtlcnJvciwgcmVzcG9uc2VdID0gYXdhaXQgd3JhcFNpZ25lZEZldGNoPEdldFZhbHVlc1Jlc3VsdD4oeyB1cmwgfSlcbiAgICAgIHdhdGNoZXIuc3RvcCgpXG5cbiAgICAgIGlmIChlcnJvcikge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYEZhaWxlZCB0byBnZXQgcGxheWVyIHN0b3JhZ2UgdmFsdWVzIGZvciAnJHthZGRyZXNzfSc6ICR7ZXJyb3JNZXNzYWdlKGVycm9yKX1gKVxuICAgICAgfVxuXG4gICAgICBjb25zdCBkYXRhID0gcmVzcG9uc2U/LmRhdGFcbiAgICAgIGlmICghQXJyYXkuaXNBcnJheShkYXRhKSkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYEZhaWxlZCB0byBnZXQgcGxheWVyIHN0b3JhZ2UgdmFsdWVzIGZvciAnJHthZGRyZXNzfSc6IHJlc3BvbnNlIGNhcnJpZWQgbm8gZGF0YSBhcnJheWApXG4gICAgICB9XG4gICAgICBpZiAoZGF0YS5zb21lKChlbnRyeSkgPT4gdHlwZW9mIGVudHJ5Py5rZXkgIT09ICdzdHJpbmcnIHx8IGVudHJ5LnZhbHVlID09PSB1bmRlZmluZWQpKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihgRmFpbGVkIHRvIGdldCBwbGF5ZXIgc3RvcmFnZSB2YWx1ZXMgZm9yICcke2FkZHJlc3N9JzogcmVzcG9uc2UgY2FycmllZCBhIG1hbGZvcm1lZCBlbnRyeWApXG4gICAgICB9XG5cbiAgICAgIC8vIFNlZWQgdGhlIHBlci1rZXkgY2FjaGUgc28gc3Vic2VxdWVudCBnZXQoKS9zZXQoKSBvbiByZXR1cm5lZCBrZXlzIGNhblxuICAgICAgLy8gc2tpcCB0aGUgbmV0d29yay4gT25seSBrZXlzIHdpdGggbm8gbGl2ZSBlbnRyeSBhbmQgbm8gcGVuZGluZyB3cml0ZVxuICAgICAgLy8gYXJlIHNlZWRlZDogZXhpc3RpbmcgcGVyLWtleSBzdGF0ZSBjb21lcyBmcm9tIGEgY29uZmlybWVkIG9wZXJhdGlvblxuICAgICAgLy8gdGhhdCB0aGlzIHBhZ2Ugc25hcHNob3Qg4oCUIHdob3NlIHJlcXVlc3Qgc3RhcnRlZCBlYXJsaWVyIOKAlCBtdXN0IG5vdFxuICAgICAgLy8gY2xvYmJlciB3aXRoIHN0YWxlIGRhdGEuIEFic2VuY2UgaXMgbmV2ZXIgc2VlZGVkIChwcmVmaXgvcGFnaW5hdGlvblxuICAgICAgLy8gbWFrZSBpdCBub24tYXV0aG9yaXRhdGl2ZSkuIEEgcGFnZSBsYXJnZXIgdGhhbiBjYWNoZU1heEVudHJpZXMgY2h1cm5zXG4gICAgICAvLyB0aGUgY2FjaGU7IGVudHJpZXMgcmVwb3B1bGF0ZSBsYXppbHkuXG4gICAgICBmb3IgKGNvbnN0IGVudHJ5IG9mIGRhdGEpIHtcbiAgICAgICAgY29uc3QgY2sgPSBjYWNoZUtleShhZGRyZXNzLCBlbnRyeS5rZXkpXG4gICAgICAgIGlmICh3YXRjaGVyLm11dGF0ZWQoY2spIHx8IHdyaXRlcy5pc1BlbmRpbmcoY2spIHx8IGluZmxpZ2h0R2V0cy5oYXMoY2spKSBjb250aW51ZVxuICAgICAgICBpZiAoY2FjaGUuZ2V0KGNrKSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICAgICAgY2FjaGUuc2V0KGNrLCB7IGJvZHk6IEpTT04uc3RyaW5naWZ5KHsgdmFsdWU6IGVudHJ5LnZhbHVlIH0pIH0pXG4gICAgICAgIH1cbiAgICAgIH1cblxuICAgICAgY29uc3QgcmVxdWVzdGVkT2Zmc2V0ID0gb2Zmc2V0ID8/IDBcbiAgICAgIGNvbnN0IHBhZ2luYXRpb24gPSB7XG4gICAgICAgIG9mZnNldDogcmVzcG9uc2UhLnBhZ2luYXRpb24/Lm9mZnNldCA/PyByZXF1ZXN0ZWRPZmZzZXQsXG4gICAgICAgIHRvdGFsOiByZXNwb25zZSEucGFnaW5hdGlvbj8udG90YWwgPz8gZGF0YS5sZW5ndGhcbiAgICAgIH1cblxuICAgICAgcmV0dXJuIHsgZGF0YSwgcGFnaW5hdGlvbiB9XG4gICAgfVxuICB9XG59XG4iXX0=

package/server/storage/scene.d.ts

@@ -0,0 +1,55 @@
+import { GetOptions, GetValuesOptions, GetValuesResult, SetOptions } from './constants';
+/**
+ * Scene-scoped storage interface for key-value pairs from the Server Side Storage service.
+ * This is NOT filesystem storage - data is stored in the remote storage service.
+ */
+export interface ISceneStorage {
+    /**
+     * Retrieves a value from scene storage by key from the Server Side Storage service.
+     *
+     * By default (cacheReads), values read or written during the last cacheMaxAgeMs
+     * are served from a local cache without a network request, including confirmed
+     * "not found" results. Concurrent gets for the same key share one request.
+     * Out-of-band writers (e.g. CLI storage commands) may not be visible for up to
+     * cacheMaxAgeMs — pass { fresh: true } to force a network read.
+     * A read first waits for writes to the same key that were pending when it was
+     * issued, so it reflects every write issued before it.
+     * @param key - The key to retrieve
+     * @param options - Optional { fresh } to bypass the read cache
+     * @returns A promise that resolves to the parsed JSON value, or null if not found
+     * @throws Error if the read fails, so a failure is never mistaken for a missing key
+     * @throws TypeError if the key is invalid
+     */
+    get<T = unknown>(key: string, options?: GetOptions): Promise<T | null>;
+    /**
+     * Stores a value in scene storage in the Server Side Storage service.
+     * @param key - The key to store the value under
+     * @param value - The value to store (will be JSON serialized)
+     * @param options - Optional { skipIfUnchanged } to skip the network write when the value is already stored
+     * @returns true once stored, or once a newer write that replaced this one lands
+     * (rapid writes coalesce); false if the write, or its replacement, fails
+     * @throws TypeError if the key is invalid, or the value cannot be stored unchanged: undefined,
+     * circular, a BigInt, or containing a function, a symbol, a non-finite number, an undefined array
+     * element or hole, a Map, Set, typed array or other built-in with no JSON form, or text with an
+     * unpaired surrogate or a NUL character. An undefined object property is dropped; a Date is
+     * stored as its ISO string and a class instance as its own enumerable data.
+     */
+    set<T = unknown>(key: string, value: T, options?: SetOptions): Promise<boolean>;
+    /**
+     * Deletes a value from scene storage in the Server Side Storage service.
+     * @param key - The key to delete
+     * @returns true once applied, or once a newer write that replaced it lands;
+     * false only for a confirmed 404
+     * @throws Error if the delete, or its replacement, fails; a failure is never reported as absence
+     * @throws TypeError if the key is invalid
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Returns key-value entries from scene storage, optionally filtered by prefix.
+     * Supports pagination via limit and offset.
+     * @param options - Optional { prefix, limit, offset } for filtering and pagination.
+     * @returns A promise that resolves to { data, pagination: { offset, total } } for pagination UI
+     * @throws Error if the read fails, so a failure is never mistaken for an empty page
+     */
+    getValues(options?: GetValuesOptions): Promise<GetValuesResult>;
+}