rn-gamekit 0.1.0 → 0.2.0

package/lib/module/storage/serialization.js

@@ -0,0 +1,249 @@
+"use strict";
+
+import { storageError } from "./errors.js";
+import { STORAGE_LIMITS } from "./types.js";
+const ENVELOPE_FORMAT = 'rn-gamekit.save';
+
+/**
+ * Bounded plain-data clone + validation for storage payloads.
+ *
+ * Mirrors the strictness of event payloads but with storage-sized limits.
+ * Rejects: functions, symbols, bigint, non-finite numbers, cycles,
+ * sparse holes, accessors, non-enumerable, unsafe prototype keys,
+ * array subclasses, class instances, React elements, thenables.
+ */
+export function cloneAndValidatePlainData(value, basePath = 'payload') {
+  let nodeCount = 0;
+  const ancestry = new WeakSet();
+  const fail = (path, reason, code = 'UNSUPPORTED_VALUE') => {
+    // Depth/size specific codes where useful
+    if (reason.includes('maximum depth')) {
+      throw storageError(`storage payload invalid at ${path}: ${reason}`, 'DEPTH_EXCEEDED', {
+        path
+      });
+    }
+    if (reason.includes('maximum payload size') || reason.includes('maximum serialized bytes') || reason.includes('exceeds maximum')) {
+      // Let caller turn size failures into SIZE_EXCEEDED where appropriate
+      if (reason.includes('nodes') || reason.includes('array') || reason.includes('object fields') || reason.includes('string')) {
+        throw storageError(`storage payload invalid at ${path}: ${reason}`, 'SIZE_EXCEEDED', {
+          path
+        });
+      }
+    }
+    throw storageError(`storage payload invalid at ${path}: ${reason}`, code, {
+      path
+    });
+  };
+  const isPlainRecord = v => {
+    const proto = Object.getPrototypeOf(v);
+    return proto === Object.prototype || proto === null;
+  };
+  const isReactElement = v => {
+    const desc = Object.getOwnPropertyDescriptor(v, '$$typeof');
+    if (desc !== undefined) return true;
+    return '$$typeof' in v;
+  };
+  const clone = (val, path, depth) => {
+    if (depth > STORAGE_LIMITS.MAX_DEPTH) {
+      fail(path, `exceeds maximum depth of ${STORAGE_LIMITS.MAX_DEPTH}`);
+    }
+    nodeCount += 1;
+    if (nodeCount > STORAGE_LIMITS.MAX_NODES) {
+      fail(path, `exceeds maximum payload size of ${STORAGE_LIMITS.MAX_NODES} nodes`);
+    }
+    if (val === null) return null;
+    const t = typeof val;
+    if (t === 'string') {
+      const s = val;
+      if (s.length > STORAGE_LIMITS.MAX_STRING_LENGTH) {
+        fail(path, `string exceeds maximum length of ${STORAGE_LIMITS.MAX_STRING_LENGTH}`);
+      }
+      return s;
+    }
+    if (t === 'boolean') return val;
+    if (t === 'number') {
+      const n = val;
+      if (!Number.isFinite(n)) fail(path, 'number must be finite');
+      return n;
+    }
+    if (t === 'bigint') fail(path, 'bigint is not a supported storage type');
+    if (t === 'symbol') fail(path, 'symbol is not a supported storage type');
+    if (t === 'function') fail(path, 'function is not a supported storage type');
+    if (t === 'undefined') fail(path, 'undefined is not a supported storage type (use null)');
+    if (t !== 'object') fail(path, `unsupported storage type "${t}"`);
+    const obj = val;
+    if (ancestry.has(obj)) fail(path, 'cycle detected in payload');
+    ancestry.add(obj);
+    try {
+      // GS-STORAGE-03 (coordinates GS-EVENT-03): thenables are rejected
+      // without invoking any user code. Only instanceof runs here; every
+      // other non-plain object fails at the array/record branches below.
+      // Own `then` functions are rejected later as function values.
+      if (obj instanceof Promise) {
+        fail(path, 'promise/thenable is not a supported storage type');
+      }
+      if (isReactElement(obj)) fail(path, 'React element is not a supported storage type');
+      if (Array.isArray(obj)) {
+        const arr = obj;
+        if (Object.getPrototypeOf(arr) !== Array.prototype) fail(path, 'array subclass is not a supported storage type');
+        if (arr.length > STORAGE_LIMITS.MAX_ARRAY_LENGTH) fail(path, `array exceeds maximum length of ${STORAGE_LIMITS.MAX_ARRAY_LENGTH}`);
+        const descs = Object.getOwnPropertyDescriptors(arr);
+        for (let i = 0; i < arr.length; i += 1) {
+          const key = String(i);
+          if (!(key in descs)) fail(`${path}[${i}]`, 'sparse array holes are not supported');
+          const d = descs[key];
+          if (d.get !== undefined || d.set !== undefined) fail(`${path}[${i}]`, 'accessor property is not supported');
+          if (d.enumerable === false) fail(`${path}[${i}]`, 'non-enumerable property is not supported');
+        }
+        const cloned = new Array(arr.length);
+        for (let i = 0; i < arr.length; i += 1) {
+          const key = String(i);
+          const d = descs[key];
+          cloned[i] = clone(d.value, `${path}[${i}]`, depth + 1);
+        }
+        for (const key of Reflect.ownKeys(descs)) {
+          if (typeof key === 'symbol') fail(`${path}[Symbol(${String(key).slice(7, -1)})]`, 'symbol-keyed property is not supported');
+          const k = key;
+          if (k === 'length') continue;
+          if (/^(0|[1-9]\d*)$/.test(k)) {
+            const idx = Number(k);
+            if (idx < arr.length && String(idx) === k) continue;
+          }
+          if (k === '__proto__' || k === 'constructor' || k === 'prototype') fail(`${path}.${k}`, 'unsafe prototype key is not supported');
+          const d = descs[k];
+          if (d.get !== undefined || d.set !== undefined) fail(`${path}.${k}`, 'accessor property is not supported');
+          if (d.enumerable === false) fail(`${path}.${k}`, 'non-enumerable property is not supported');
+          fail(`${path}.${k}`, 'array extra property is not a supported storage member');
+        }
+        Object.freeze(cloned);
+        return cloned;
+      }
+      if (!isPlainRecord(obj)) fail(path, 'only plain records and arrays are supported (class instance, Map, Set, Date, etc. are rejected)');
+      const proto = Object.getPrototypeOf(obj);
+      const descs = Object.getOwnPropertyDescriptors(obj);
+      const keys = Object.keys(descs);
+      if (keys.length > STORAGE_LIMITS.MAX_OBJECT_FIELDS) {
+        fail(path, `object exceeds maximum field count of ${STORAGE_LIMITS.MAX_OBJECT_FIELDS}`);
+      }
+      for (const key of Reflect.ownKeys(descs)) {
+        if (typeof key === 'symbol') fail(`${path}[Symbol(${String(key).slice(7, -1)})]`, 'symbol-keyed property is not supported');
+        const k = key;
+        if (k === '__proto__' || k === 'constructor' || k === 'prototype') fail(`${path}.${k}`, 'unsafe prototype key is not supported');
+        const d = descs[k];
+        if (d.get !== undefined || d.set !== undefined) fail(`${path}.${k}`, 'accessor property is not supported');
+        if (d.enumerable === false) fail(`${path}.${k}`, 'non-enumerable property is not supported');
+      }
+      const cloned = proto === null ? Object.create(null) : {};
+      for (const key of keys) {
+        const d = descs[key];
+        cloned[key] = clone(d.value, `${path}.${key}`, depth + 1);
+      }
+      Object.freeze(cloned);
+      return cloned;
+    } finally {
+      ancestry.delete(obj);
+    }
+  };
+  const result = clone(value, basePath, 0);
+  return result;
+}
+
+/**
+ * Exact UTF-8 byte length (GS-STORAGE-03): the single routine for every
+ * storage size check. TextEncoder is exact everywhere it exists (Node,
+ * browsers, modern Hermes); the scalar fallback below is bit-exact too,
+ * including unpaired surrogates (which encode as U+FFFD, 3 bytes).
+ */
+export function utf8ByteLength(str) {
+  if (typeof TextEncoder !== 'undefined') {
+    return new TextEncoder().encode(str).length;
+  }
+  return utf8ByteLengthScalar(str);
+}
+
+/** Bit-exact scalar UTF-8 length for runtimes without TextEncoder. */
+export function utf8ByteLengthScalar(str) {
+  let bytes = 0;
+  for (let i = 0; i < str.length; i++) {
+    const code = str.charCodeAt(i);
+    if (code < 0x80) {
+      bytes += 1;
+    } else if (code < 0x800) {
+      bytes += 2;
+    } else if (code >= 0xd800 && code <= 0xdbff && i + 1 < str.length) {
+      const next = str.charCodeAt(i + 1);
+      if (next >= 0xdc00 && next <= 0xdfff) {
+        bytes += 4;
+        i++;
+      } else {
+        bytes += 3;
+      }
+    } else {
+      bytes += 3;
+    }
+  }
+  return bytes;
+}
+function serializedByteLength(str) {
+  return utf8ByteLength(str);
+}
+export function serializeEnvelope(envelope) {
+  // Validate payload plain-data first
+  cloneAndValidatePlainData(envelope.payload, 'payload');
+  // Envelope itself is plain, but we validate its shape before stringify
+  if (envelope.format !== ENVELOPE_FORMAT) {
+    throw storageError(`envelope format must be "${ENVELOPE_FORMAT}"`, 'CORRUPT_ENVELOPE', {
+      path: 'format'
+    });
+  }
+  const json = JSON.stringify(envelope);
+  const bytes = serializedByteLength(json);
+  if (bytes > STORAGE_LIMITS.MAX_SERIALIZED_BYTES) {
+    throw storageError(`serialized envelope exceeds ${STORAGE_LIMITS.MAX_SERIALIZED_BYTES} bytes (got ${bytes})`, 'SIZE_EXCEEDED', {
+      path: 'envelope'
+    });
+  }
+  return json;
+}
+export function parseEnvelope(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (cause) {
+    throw storageError(`corrupt envelope: JSON parse failed`, 'CORRUPT_ENVELOPE', {
+      cause
+    });
+  }
+  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw storageError(`corrupt envelope: expected object`, 'CORRUPT_ENVELOPE');
+  }
+  const obj = parsed;
+  if (obj.format !== ENVELOPE_FORMAT) {
+    throw storageError(`corrupt envelope: expected format "${ENVELOPE_FORMAT}"`, 'CORRUPT_ENVELOPE', {
+      path: 'format'
+    });
+  }
+  if (typeof obj.schemaId !== 'string') {
+    throw storageError(`corrupt envelope: schemaId must be string`, 'CORRUPT_ENVELOPE', {
+      path: 'schemaId'
+    });
+  }
+  if (!Number.isSafeInteger(obj.schemaVersion)) {
+    throw storageError(`corrupt envelope: schemaVersion must be integer`, 'CORRUPT_ENVELOPE', {
+      path: 'schemaVersion'
+    });
+  }
+  if (typeof obj.savedAtMs !== 'number' || !Number.isFinite(obj.savedAtMs)) {
+    throw storageError(`corrupt envelope: savedAtMs must be finite number`, 'CORRUPT_ENVELOPE', {
+      path: 'savedAtMs'
+    });
+  }
+  if (!('payload' in obj)) {
+    throw storageError(`corrupt envelope: missing payload`, 'CORRUPT_ENVELOPE', {
+      path: 'payload'
+    });
+  }
+  return obj;
+}
+export const STORAGE_ENVELOPE_FORMAT = ENVELOPE_FORMAT;
+//# sourceMappingURL=serialization.js.map

package/lib/module/storage/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["storageError","STORAGE_LIMITS","ENVELOPE_FORMAT","cloneAndValidatePlainData","value","basePath","nodeCount","ancestry","WeakSet","fail","path","reason","code","includes","isPlainRecord","v","proto","Object","getPrototypeOf","prototype","isReactElement","desc","getOwnPropertyDescriptor","undefined","clone","val","depth","MAX_DEPTH","MAX_NODES","t","s","length","MAX_STRING_LENGTH","n","Number","isFinite","obj","has","add","Promise","Array","isArray","arr","MAX_ARRAY_LENGTH","descs","getOwnPropertyDescriptors","i","key","String","d","get","set","enumerable","cloned","Reflect","ownKeys","slice","k","test","idx","freeze","keys","MAX_OBJECT_FIELDS","create","delete","result","utf8ByteLength","str","TextEncoder","encode","utf8ByteLengthScalar","bytes","charCodeAt","next","serializedByteLength","serializeEnvelope","envelope","payload","format","json","JSON","stringify","MAX_SERIALIZED_BYTES","parseEnvelope","raw","parsed","parse","cause","schemaId","isSafeInteger","schemaVersion","savedAtMs","STORAGE_ENVELOPE_FORMAT"],"sourceRoot":"../../../src","sources":["storage/serialization.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/storage/store.js

@@ -0,0 +1,387 @@
+"use strict";
+
+import { GameStorageError, storageError } from "./errors.js";
+import { STORAGE_LIMITS } from "./types.js";
+import { storageKey, legacyStorageKey, validateNamespace, validateSlot } from "./validation.js";
+import { createDefaultData, migratePayload, validateCurrentData } from "./schema.js";
+import { cloneAndValidatePlainData, parseEnvelope, serializeEnvelope, utf8ByteLength, STORAGE_ENVELOPE_FORMAT } from "./serialization.js";
+export function createGameSaveStore(options) {
+  const schema = options.schema;
+  const adapter = options.adapter;
+  const namespace = options.namespace;
+  validateNamespace(namespace);
+
+  // Per-slot serialized queue: slot -> tail promise. Retained until every accepted operation settles.
+  const slotQueues = new Map();
+  // Active operation promises for flush() snapshotting. Each flush gets its own immutable snapshot.
+  const active = new Set();
+  let disposed = false;
+  function track(p) {
+    const wrapped = p.finally(() => {
+      active.delete(wrapped);
+    });
+    active.add(wrapped);
+    return wrapped;
+  }
+  function enqueue(slot, op) {
+    // Acceptance boundary is the successful public method call; already-accepted ops are never cancelled by later dispose.
+    const tail = slotQueues.get(slot) ?? Promise.resolve();
+    let resolveTail = () => {};
+    const nextTail = new Promise(res => {
+      resolveTail = res;
+    });
+    slotQueues.set(slot, nextTail);
+    const run = tail.catch(() => {
+      // Previous failure does not block next; continue
+    }).then(() => op()).finally(() => {
+      // Clean only when this tail is still the current tail; otherwise a newer operation has already replaced it.
+      if (slotQueues.get(slot) === nextTail) {
+        slotQueues.delete(slot);
+      }
+      resolveTail();
+    });
+
+    // Ensure nextTail mirrors run settlement without creating an unhandled rejection.
+    run.then(() => {}, () => {});
+    return track(run);
+  }
+  async function loadInternal(slot) {
+    validateSlot(slot);
+    const key = storageKey(namespace, slot);
+    let raw;
+    try {
+      raw = await adapter.read(key);
+    } catch (cause) {
+      throw storageError(`backend read failed for slot "${slot}"`, 'BACKEND_READ_FAILED', {
+        operation: 'load',
+        namespace,
+        slot,
+        cause
+      });
+    }
+    // GS-STORAGE-01: read-only legacy fallback — pre-upgrade records load
+    // without any rewrite. A v2 miss costs one extra read for heritage.
+    if (raw === undefined) {
+      try {
+        raw = await adapter.read(legacyStorageKey(namespace, slot));
+      } catch (cause) {
+        throw storageError(`backend read failed for slot "${slot}"`, 'BACKEND_READ_FAILED', {
+          operation: 'load',
+          namespace,
+          slot,
+          cause
+        });
+      }
+    }
+    if (raw === undefined) {
+      const data = createDefaultData(schema);
+      return {
+        status: 'default',
+        data
+      };
+    }
+
+    // F3: measure raw UTF-8 byte length before JSON.parse and reject oversized records.
+    const rawBytes = utf8ByteLength(raw);
+    if (rawBytes > STORAGE_LIMITS.MAX_SERIALIZED_BYTES) {
+      throw storageError(`stored record for slot "${slot}" exceeds ${STORAGE_LIMITS.MAX_SERIALIZED_BYTES} bytes (got ${rawBytes})`, 'SIZE_EXCEEDED', {
+        operation: 'load',
+        namespace,
+        slot,
+        schemaId: schema.id,
+        schemaVersion: schema.version,
+        path: 'envelope'
+      });
+    }
+
+    // Validate loaded bytes as untrusted before migration
+    let envelope;
+    try {
+      envelope = parseEnvelope(raw);
+    } catch (cause) {
+      if (cause instanceof GameStorageError) {
+        throw new GameStorageError(cause.message, {
+          code: cause.code,
+          operation: 'load',
+          namespace,
+          slot,
+          schemaId: schema.id,
+          schemaVersion: schema.version,
+          path: cause.path,
+          cause: cause.cause ?? cause
+        });
+      }
+      throw storageError(`corrupt envelope for slot "${slot}"`, 'CORRUPT_ENVELOPE', {
+        operation: 'load',
+        namespace,
+        slot,
+        cause
+      });
+    }
+    if (envelope.schemaId !== schema.id) {
+      throw storageError(`schema id mismatch: expected "${schema.id}" got "${envelope.schemaId}"`, 'SCHEMA_ID_MISMATCH', {
+        operation: 'load',
+        namespace,
+        slot,
+        schemaId: schema.id,
+        schemaVersion: schema.version
+      });
+    }
+    if (!Number.isSafeInteger(envelope.schemaVersion) || envelope.schemaVersion < 1) {
+      throw storageError(`corrupt envelope: invalid schemaVersion`, 'CORRUPT_ENVELOPE', {
+        operation: 'load',
+        namespace,
+        slot,
+        schemaId: schema.id
+      });
+    }
+    if (envelope.schemaVersion > schema.version) {
+      throw storageError(`stored version ${envelope.schemaVersion} is newer than current ${schema.version}`, 'FUTURE_VERSION', {
+        operation: 'load',
+        namespace,
+        slot,
+        schemaId: schema.id,
+        schemaVersion: schema.version
+      });
+    }
+
+    // F3: bounded plain-data validation of the loaded payload BEFORE any migration sees it.
+    try {
+      cloneAndValidatePlainData(envelope.payload, 'payload');
+    } catch (cause) {
+      if (cause instanceof GameStorageError) {
+        throw new GameStorageError(cause.message, {
+          code: cause.code,
+          operation: 'load',
+          namespace,
+          slot,
+          schemaId: schema.id,
+          schemaVersion: schema.version,
+          path: cause.path,
+          cause: cause.cause ?? cause
+        });
+      }
+      throw storageError(`payload validation failed`, 'VALIDATION_FAILED', {
+        operation: 'load',
+        namespace,
+        slot,
+        cause
+      });
+    }
+
+    // Migrate if needed — each migration receives a deeply frozen engine-owned input and its output is bounded-cloned/frozen.
+    let payload = envelope.payload;
+    let fromVersion = envelope.schemaVersion;
+    let toVersion = schema.version;
+    let migrated = false;
+    if (fromVersion !== toVersion) {
+      try {
+        const result = migratePayload(schema, fromVersion, payload);
+        payload = result.data;
+        fromVersion = result.fromVersion;
+        toVersion = result.toVersion;
+        migrated = true;
+      } catch (cause) {
+        if (cause instanceof GameStorageError) {
+          throw new GameStorageError(cause.message, {
+            code: cause.code,
+            operation: 'load',
+            namespace,
+            slot,
+            schemaId: schema.id,
+            schemaVersion: schema.version,
+            path: cause.path,
+            cause: cause.cause ?? cause
+          });
+        }
+        throw storageError(`migration failed`, 'MIGRATION_FAILED', {
+          operation: 'load',
+          namespace,
+          slot,
+          cause
+        });
+      }
+    }
+
+    // Final validation — never overwrites stored record on failure
+    let data;
+    try {
+      data = validateCurrentData(schema, payload, 'payload');
+    } catch (cause) {
+      if (cause instanceof GameStorageError) {
+        throw new GameStorageError(cause.message, {
+          code: 'VALIDATION_FAILED',
+          operation: 'load',
+          namespace,
+          slot,
+          schemaId: schema.id,
+          schemaVersion: schema.version,
+          path: cause.path,
+          cause: cause.cause ?? cause
+        });
+      }
+      throw storageError(`final validation failed`, 'VALIDATION_FAILED', {
+        operation: 'load',
+        namespace,
+        slot,
+        cause
+      });
+    }
+    if (migrated) {
+      return {
+        status: 'migrated',
+        data,
+        fromVersion: envelope.schemaVersion,
+        toVersion
+      };
+    }
+    return {
+      status: 'stored',
+      data
+    };
+  }
+  async function saveInternal(slot, data) {
+    validateSlot(slot);
+    // GS-STORAGE-02: save() already validated, normalized, cloned, and
+    // froze this snapshot at acceptance — re-running domain validation
+    // here would double-apply normalizing validators. Serialization still
+    // bounds-checks the bytes at its own boundary.
+    const envelope = {
+      format: STORAGE_ENVELOPE_FORMAT,
+      schemaId: schema.id,
+      schemaVersion: schema.version,
+      savedAtMs: Date.now(),
+      payload: data
+    };
+    let serialized;
+    try {
+      serialized = serializeEnvelope(envelope);
+    } catch (cause) {
+      if (cause instanceof GameStorageError) {
+        throw new GameStorageError(cause.message, {
+          code: cause.code === 'SIZE_EXCEEDED' || cause.code === 'DEPTH_EXCEEDED' ? cause.code : 'SERIALIZATION_FAILED',
+          operation: 'save',
+          namespace,
+          slot,
+          schemaId: schema.id,
+          schemaVersion: schema.version,
+          path: cause.path,
+          cause: cause.cause ?? cause
+        });
+      }
+      throw storageError(`serialization failed for slot "${slot}"`, 'SERIALIZATION_FAILED', {
+        operation: 'save',
+        namespace,
+        slot,
+        cause
+      });
+    }
+    const key = storageKey(namespace, slot);
+    try {
+      await adapter.write(key, serialized);
+    } catch (cause) {
+      throw storageError(`backend write failed for slot "${slot}"`, 'BACKEND_WRITE_FAILED', {
+        operation: 'save',
+        namespace,
+        slot,
+        cause
+      });
+    }
+  }
+  async function removeInternal(slot) {
+    validateSlot(slot);
+    // GS-STORAGE-01: delete the versioned record and its legacy heritage.
+    // Heritage deletion matches v1 shared-fate semantics for colliding
+    // pairs and converges to independence as pairs save under v2.
+    const key = storageKey(namespace, slot);
+    const legacyKey = legacyStorageKey(namespace, slot);
+    try {
+      await adapter.remove(key);
+      if (legacyKey !== key) {
+        await adapter.remove(legacyKey);
+      }
+    } catch (cause) {
+      throw storageError(`backend remove failed for slot "${slot}"`, 'BACKEND_REMOVE_FAILED', {
+        operation: 'remove',
+        namespace,
+        slot,
+        cause
+      });
+    }
+  }
+  const store = {
+    get disposed() {
+      return disposed;
+    },
+    load(slot) {
+      if (disposed) {
+        return Promise.reject(storageError(`store is disposed`, 'DISPOSED', {
+          operation: 'load',
+          namespace,
+          slot
+        }));
+      }
+      try {
+        validateSlot(slot);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+      return enqueue(slot, () => loadInternal(slot));
+    },
+    save(slot, data) {
+      if (disposed) {
+        return Promise.reject(storageError(`store is disposed`, 'DISPOSED', {
+          operation: 'save',
+          namespace,
+          slot
+        }));
+      }
+      try {
+        validateSlot(slot);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+      // Snapshot synchronously so caller mutation after save() does not affect stored bytes
+      let snapshot;
+      try {
+        snapshot = validateCurrentData(schema, data, 'data');
+      } catch (e) {
+        return Promise.reject(e);
+      }
+      return enqueue(slot, () => saveInternal(slot, snapshot));
+    },
+    remove(slot) {
+      if (disposed) {
+        return Promise.reject(storageError(`store is disposed`, 'DISPOSED', {
+          operation: 'remove',
+          namespace,
+          slot
+        }));
+      }
+      try {
+        validateSlot(slot);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+      return enqueue(slot, () => removeInternal(slot));
+    },
+    delete(slot) {
+      return store.remove(slot);
+    },
+    async flush() {
+      // Snapshot the currently tracked operation promises; do not let operations accepted after the call delay this flush.
+      const snapshot = Array.from(active);
+      if (snapshot.length === 0) return;
+      await Promise.allSettled(snapshot);
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      // Do not use generation to suppress already-accepted Promise results.
+      // Retain queue/tail ownership until every accepted operation settles; tails clean themselves when still current.
+      // New work is rejected at the public boundary above.
+    }
+  };
+  return store;
+}
+//# sourceMappingURL=store.js.map

package/lib/module/storage/store.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GameStorageError","storageError","STORAGE_LIMITS","storageKey","legacyStorageKey","validateNamespace","validateSlot","createDefaultData","migratePayload","validateCurrentData","cloneAndValidatePlainData","parseEnvelope","serializeEnvelope","utf8ByteLength","STORAGE_ENVELOPE_FORMAT","createGameSaveStore","options","schema","adapter","namespace","slotQueues","Map","active","Set","disposed","track","p","wrapped","finally","delete","add","enqueue","slot","op","tail","get","Promise","resolve","resolveTail","nextTail","res","set","run","catch","then","loadInternal","key","raw","read","cause","operation","undefined","data","status","rawBytes","MAX_SERIALIZED_BYTES","schemaId","id","schemaVersion","version","path","envelope","message","code","Number","isSafeInteger","payload","fromVersion","toVersion","migrated","result","saveInternal","format","savedAtMs","Date","now","serialized","write","removeInternal","legacyKey","remove","store","load","reject","e","save","snapshot","flush","Array","from","length","allSettled","dispose"],"sourceRoot":"../../../src","sources":["storage/store.ts"],"mappings":"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","ignoreList":[]}