@al8b/io 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @al8b/io
+
+Storage and IO helpers for the L8B runtime. Today this package centers on persistent storage through a single service abstraction.
+
+## Public API
+
+- `StorageService`
+
+## Notes
+
+- Used by `@al8b/vm` and `@al8b/runtime`.
+- Keep persistence concerns here rather than coupling them to VM or runtime orchestration.
+
+## Scripts
+
+```bash
+bun run build
+bun run test
+bun run typecheck
+bun run clean
+```

package/dist/index.cjs

@@ -0,0 +1,203 @@
+'use strict';
+
+var diagnostics = require('@al8b/diagnostics');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var StorageService = class {
+  static {
+    __name(this, "StorageService");
+  }
+  namespace;
+  cache = /* @__PURE__ */ new Map();
+  pendingWrites = /* @__PURE__ */ new Map();
+  writeTimer = null;
+  runtime;
+  constructor(namespace = "/l8b", preserve = false, runtime) {
+    this.namespace = namespace;
+    this.runtime = runtime;
+    if (!preserve && typeof localStorage !== "undefined") {
+      this.clear();
+    }
+  }
+  /**
+  * Get value from storage
+  */
+  get(name) {
+    if (!name || typeof name !== "string" || name.trim() === "") {
+      diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7063, {
+        key: String(name)
+      });
+      return null;
+    }
+    if (this.cache.has(name)) {
+      return this.cache.get(name);
+    }
+    if (typeof localStorage !== "undefined") {
+      try {
+        const key = `${this.namespace}.${name}`;
+        const value = localStorage.getItem(key);
+        if (value !== null) {
+          const parsed = JSON.parse(value);
+          this.cache.set(name, parsed);
+          return parsed;
+        }
+      } catch (err) {
+        diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7062, {
+          error: `Get operation failed: ${String(err)}`
+        });
+      }
+    }
+    return null;
+  }
+  /**
+  * Set value in storage (batched write)
+  */
+  set(name, value) {
+    if (!name || typeof name !== "string" || name.trim() === "") {
+      diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7063, {
+        key: String(name)
+      });
+      return;
+    }
+    this.cache.set(name, value);
+    this.pendingWrites.set(name, value);
+    if (this.writeTimer === null) {
+      const schedule = typeof window !== "undefined" && typeof window.setTimeout === "function" ? window.setTimeout.bind(window) : setTimeout;
+      this.writeTimer = schedule(() => {
+        this.flush();
+      }, 100);
+    }
+  }
+  /**
+  * Flush pending writes to localStorage
+  */
+  flush() {
+    if (this.writeTimer !== null) {
+      clearTimeout(this.writeTimer);
+      this.writeTimer = null;
+    }
+    if (typeof localStorage === "undefined") {
+      this.pendingWrites.clear();
+      return;
+    }
+    for (const [name, value] of this.pendingWrites) {
+      try {
+        const key = `${this.namespace}.${name}`;
+        const serialized = JSON.stringify(this.sanitize(value));
+        localStorage.setItem(key, serialized);
+      } catch (err) {
+        if (err.name === "QuotaExceededError" || err.code === 22) {
+          diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7061, {});
+        } else {
+          diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7062, {
+            error: `Set operation failed: ${String(err)}`
+          });
+        }
+      }
+    }
+    this.pendingWrites.clear();
+  }
+  /**
+  * Check if there are pending writes and flush if needed
+  */
+  check() {
+    if (this.pendingWrites.size > 0) {
+      this.flush();
+    }
+  }
+  /**
+  * Delete a single key from storage (cache + localStorage + any pending write)
+  */
+  delete(name) {
+    if (!name || typeof name !== "string" || name.trim() === "") {
+      diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7063, {
+        key: String(name)
+      });
+      return;
+    }
+    this.cache.delete(name);
+    this.pendingWrites.delete(name);
+    if (typeof localStorage !== "undefined") {
+      try {
+        localStorage.removeItem(`${this.namespace}.${name}`);
+      } catch (err) {
+        diagnostics.reportRuntimeError(this.runtime?.listener, diagnostics.APIErrorCode.E7062, {
+          error: `Delete operation failed: ${String(err)}`
+        });
+      }
+    }
+  }
+  /**
+  * Clear all storage for this namespace
+  */
+  clear() {
+    if (typeof localStorage === "undefined") {
+      return;
+    }
+    const prefix = `${this.namespace}.`;
+    const keysToRemove = [];
+    for (let i = 0; i < localStorage.length; i++) {
+      const key = localStorage.key(i);
+      if (key && key.startsWith(prefix)) {
+        keysToRemove.push(key);
+      }
+    }
+    for (const key of keysToRemove) {
+      localStorage.removeItem(key);
+    }
+    this.cache.clear();
+    this.pendingWrites.clear();
+  }
+  /**
+  * Sanitize value for JSON serialization
+  * Removes functions and handles circular references
+  */
+  sanitize(value, seen = /* @__PURE__ */ new WeakSet()) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (typeof value !== "object") {
+      if (typeof value === "function") {
+        return void 0;
+      }
+      return value;
+    }
+    if (seen.has(value)) {
+      return void 0;
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+      return value.map((item) => this.sanitize(item, seen)).filter((item) => item !== void 0);
+    }
+    const result = {};
+    for (const key in value) {
+      if (Object.hasOwn(value, key)) {
+        const sanitized = this.sanitize(value[key], seen);
+        if (sanitized !== void 0) {
+          result[key] = sanitized;
+        }
+      }
+    }
+    return result;
+  }
+  interfaceCache = null;
+  /**
+  * Get storage interface for game code
+  */
+  getInterface() {
+    if (this.interfaceCache) {
+      return this.interfaceCache;
+    }
+    this.interfaceCache = {
+      set: /* @__PURE__ */ __name((name, value) => this.set(name, value), "set"),
+      get: /* @__PURE__ */ __name((name) => this.get(name), "get"),
+      delete: /* @__PURE__ */ __name((name) => this.delete(name), "delete")
+    };
+    return this.interfaceCache;
+  }
+};
+
+exports.StorageService = StorageService;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/index.ts"],"names":["StorageService","namespace","cache","Map","pendingWrites","writeTimer","runtime","preserve","localStorage","clear","get","name","trim","reportRuntimeError","listener","APIErrorCode","E7063","key","String","has","value","getItem","parsed","JSON","parse","set","err","E7062","error","schedule","window","setTimeout","bind","flush","clearTimeout","serialized","stringify","sanitize","setItem","code","E7061","check","size","delete","removeItem","prefix","keysToRemove","i","length","startsWith","push","seen","WeakSet","undefined","add","Array","isArray","map","item","filter","result","Object","hasOwn","sanitized","interfaceCache","getInterface"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Storage service - localStorage wrapper with automatic serialization\n */\n\nimport { APIErrorCode, reportRuntimeError } from \"@al8b/diagnostics\";\n\nexport class StorageService {\n\tprivate namespace: string;\n\tprivate cache: Map<string, any> = new Map();\n\tprivate pendingWrites: Map<string, any> = new Map();\n\tprivate writeTimer: ReturnType<typeof setTimeout> | null = null;\n\tprivate runtime?: any;\n\n\tconstructor(namespace = \"/l8b\", preserve = false, runtime?: any) {\n\t\tthis.namespace = namespace;\n\t\tthis.runtime = runtime;\n\n\t\t// Clear storage if not preserving\n\t\tif (!preserve && typeof localStorage !== \"undefined\") {\n\t\t\tthis.clear();\n\t\t}\n\t}\n\n\t/**\n\t * Get value from storage\n\t */\n\tget(name: string): any {\n\t\t// Validate storage key\n\t\tif (!name || typeof name !== \"string\" || name.trim() === \"\") {\n\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, { key: String(name) });\n\t\t\treturn null;\n\t\t}\n\n\t\t// Check cache first\n\t\tif (this.cache.has(name)) {\n\t\t\treturn this.cache.get(name);\n\t\t}\n\n\t\t// Try localStorage\n\t\tif (typeof localStorage !== \"undefined\") {\n\t\t\ttry {\n\t\t\t\tconst key = `${this.namespace}.${name}`;\n\t\t\t\tconst value = localStorage.getItem(key);\n\t\t\t\tif (value !== null) {\n\t\t\t\t\tconst parsed = JSON.parse(value);\n\t\t\t\t\tthis.cache.set(name, parsed);\n\t\t\t\t\treturn parsed;\n\t\t\t\t}\n\t\t\t} catch (err: any) {\n\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, { error: `Get operation failed: ${String(err)}` });\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\n\t/**\n\t * Set value in storage (batched write)\n\t */\n\tset(name: string, value: any): void {\n\t\t// Validate storage key\n\t\tif (!name || typeof name !== \"string\" || name.trim() === \"\") {\n\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, { key: String(name) });\n\t\t\treturn;\n\t\t}\n\n\t\t// Update cache\n\t\tthis.cache.set(name, value);\n\n\t\t// Queue write\n\t\tthis.pendingWrites.set(name, value);\n\n\t\t// Schedule batch write\n\t\tif (this.writeTimer === null) {\n\t\t\tconst schedule =\n\t\t\t\ttypeof window !== \"undefined\" && typeof window.setTimeout === \"function\"\n\t\t\t\t\t? window.setTimeout.bind(window)\n\t\t\t\t\t: setTimeout;\n\n\t\t\tthis.writeTimer = schedule(() => {\n\t\t\t\tthis.flush();\n\t\t\t}, 100);\n\t\t}\n\t}\n\n\t/**\n\t * Flush pending writes to localStorage\n\t */\n\tflush(): void {\n\t\tif (this.writeTimer !== null) {\n\t\t\tclearTimeout(this.writeTimer);\n\t\t\tthis.writeTimer = null;\n\t\t}\n\n\t\tif (typeof localStorage === \"undefined\") {\n\t\t\tthis.pendingWrites.clear();\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const [name, value] of this.pendingWrites) {\n\t\t\ttry {\n\t\t\t\tconst key = `${this.namespace}.${name}`;\n\t\t\t\tconst serialized = JSON.stringify(this.sanitize(value));\n\t\t\t\tlocalStorage.setItem(key, serialized);\n\t\t\t} catch (err: any) {\n\t\t\t\t// Check for quota exceeded error\n\t\t\t\tif (err.name === \"QuotaExceededError\" || err.code === 22) {\n\t\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7061, {});\n\t\t\t\t} else {\n\t\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, { error: `Set operation failed: ${String(err)}` });\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthis.pendingWrites.clear();\n\t}\n\n\t/**\n\t * Check if there are pending writes and flush if needed\n\t */\n\tcheck(): void {\n\t\tif (this.pendingWrites.size > 0) {\n\t\t\tthis.flush();\n\t\t}\n\t}\n\n\t/**\n\t * Delete a single key from storage (cache + localStorage + any pending write)\n\t */\n\tdelete(name: string): void {\n\t\tif (!name || typeof name !== \"string\" || name.trim() === \"\") {\n\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, { key: String(name) });\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove from in-memory state\n\t\tthis.cache.delete(name);\n\t\tthis.pendingWrites.delete(name);\n\n\t\t// Remove from localStorage\n\t\tif (typeof localStorage !== \"undefined\") {\n\t\t\ttry {\n\t\t\t\tlocalStorage.removeItem(`${this.namespace}.${name}`);\n\t\t\t} catch (err: any) {\n\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, {\n\t\t\t\t\terror: `Delete operation failed: ${String(err)}`,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Clear all storage for this namespace\n\t */\n\tclear(): void {\n\t\tif (typeof localStorage === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\n\t\tconst prefix = `${this.namespace}.`;\n\t\tconst keysToRemove: string[] = [];\n\n\t\t// Find all keys with this namespace\n\t\tfor (let i = 0; i < localStorage.length; i++) {\n\t\t\tconst key = localStorage.key(i);\n\t\t\tif (key && key.startsWith(prefix)) {\n\t\t\t\tkeysToRemove.push(key);\n\t\t\t}\n\t\t}\n\n\t\t// Remove them\n\t\tfor (const key of keysToRemove) {\n\t\t\tlocalStorage.removeItem(key);\n\t\t}\n\n\t\t// Clear cache\n\t\tthis.cache.clear();\n\t\tthis.pendingWrites.clear();\n\t}\n\n\t/**\n\t * Sanitize value for JSON serialization\n\t * Removes functions and handles circular references\n\t */\n\tprivate sanitize(value: any, seen = new WeakSet()): any {\n\t\tif (value === null || value === undefined) {\n\t\t\treturn value;\n\t\t}\n\n\t\t// Primitives\n\t\tif (typeof value !== \"object\") {\n\t\t\t// Remove functions\n\t\t\tif (typeof value === \"function\") {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn value;\n\t\t}\n\n\t\t// Check for circular reference\n\t\tif (seen.has(value)) {\n\t\t\treturn undefined;\n\t\t}\n\t\tseen.add(value);\n\n\t\t// Arrays\n\t\tif (Array.isArray(value)) {\n\t\t\treturn value.map((item) => this.sanitize(item, seen)).filter((item) => item !== undefined);\n\t\t}\n\n\t\t// Objects\n\t\tconst result: any = {};\n\t\tfor (const key in value) {\n\t\t\tif (Object.hasOwn(value, key)) {\n\t\t\t\tconst sanitized = this.sanitize(value[key], seen);\n\t\t\t\tif (sanitized !== undefined) {\n\t\t\t\t\tresult[key] = sanitized;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\n\tprivate interfaceCache: {\n\t\tset: (name: string, value: unknown) => void;\n\t\tget: (name: string) => unknown;\n\t\tdelete: (name: string) => void;\n\t} | null = null;\n\n\t/**\n\t * Get storage interface for game code\n\t */\n\tgetInterface() {\n\t\tif (this.interfaceCache) {\n\t\t\treturn this.interfaceCache;\n\t\t}\n\t\tthis.interfaceCache = {\n\t\t\tset: (name: string, value: any) => this.set(name, value),\n\t\t\tget: (name: string) => this.get(name),\n\t\t\tdelete: (name: string) => this.delete(name),\n\t\t};\n\t\treturn this.interfaceCache;\n\t}\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,51 @@
+/**
+ * Storage service - localStorage wrapper with automatic serialization
+ */
+declare class StorageService {
+    private namespace;
+    private cache;
+    private pendingWrites;
+    private writeTimer;
+    private runtime?;
+    constructor(namespace?: string, preserve?: boolean, runtime?: any);
+    /**
+     * Get value from storage
+     */
+    get(name: string): any;
+    /**
+     * Set value in storage (batched write)
+     */
+    set(name: string, value: any): void;
+    /**
+     * Flush pending writes to localStorage
+     */
+    flush(): void;
+    /**
+     * Check if there are pending writes and flush if needed
+     */
+    check(): void;
+    /**
+     * Delete a single key from storage (cache + localStorage + any pending write)
+     */
+    delete(name: string): void;
+    /**
+     * Clear all storage for this namespace
+     */
+    clear(): void;
+    /**
+     * Sanitize value for JSON serialization
+     * Removes functions and handles circular references
+     */
+    private sanitize;
+    private interfaceCache;
+    /**
+     * Get storage interface for game code
+     */
+    getInterface(): {
+        set: (name: string, value: unknown) => void;
+        get: (name: string) => unknown;
+        delete: (name: string) => void;
+    };
+}
+
+export { StorageService };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Storage service - localStorage wrapper with automatic serialization
+ */
+declare class StorageService {
+    private namespace;
+    private cache;
+    private pendingWrites;
+    private writeTimer;
+    private runtime?;
+    constructor(namespace?: string, preserve?: boolean, runtime?: any);
+    /**
+     * Get value from storage
+     */
+    get(name: string): any;
+    /**
+     * Set value in storage (batched write)
+     */
+    set(name: string, value: any): void;
+    /**
+     * Flush pending writes to localStorage
+     */
+    flush(): void;
+    /**
+     * Check if there are pending writes and flush if needed
+     */
+    check(): void;
+    /**
+     * Delete a single key from storage (cache + localStorage + any pending write)
+     */
+    delete(name: string): void;
+    /**
+     * Clear all storage for this namespace
+     */
+    clear(): void;
+    /**
+     * Sanitize value for JSON serialization
+     * Removes functions and handles circular references
+     */
+    private sanitize;
+    private interfaceCache;
+    /**
+     * Get storage interface for game code
+     */
+    getInterface(): {
+        set: (name: string, value: unknown) => void;
+        get: (name: string) => unknown;
+        delete: (name: string) => void;
+    };
+}
+
+export { StorageService };

package/dist/index.js

@@ -0,0 +1,201 @@
+import { reportRuntimeError, APIErrorCode } from '@al8b/diagnostics';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var StorageService = class {
+  static {
+    __name(this, "StorageService");
+  }
+  namespace;
+  cache = /* @__PURE__ */ new Map();
+  pendingWrites = /* @__PURE__ */ new Map();
+  writeTimer = null;
+  runtime;
+  constructor(namespace = "/l8b", preserve = false, runtime) {
+    this.namespace = namespace;
+    this.runtime = runtime;
+    if (!preserve && typeof localStorage !== "undefined") {
+      this.clear();
+    }
+  }
+  /**
+  * Get value from storage
+  */
+  get(name) {
+    if (!name || typeof name !== "string" || name.trim() === "") {
+      reportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, {
+        key: String(name)
+      });
+      return null;
+    }
+    if (this.cache.has(name)) {
+      return this.cache.get(name);
+    }
+    if (typeof localStorage !== "undefined") {
+      try {
+        const key = `${this.namespace}.${name}`;
+        const value = localStorage.getItem(key);
+        if (value !== null) {
+          const parsed = JSON.parse(value);
+          this.cache.set(name, parsed);
+          return parsed;
+        }
+      } catch (err) {
+        reportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, {
+          error: `Get operation failed: ${String(err)}`
+        });
+      }
+    }
+    return null;
+  }
+  /**
+  * Set value in storage (batched write)
+  */
+  set(name, value) {
+    if (!name || typeof name !== "string" || name.trim() === "") {
+      reportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, {
+        key: String(name)
+      });
+      return;
+    }
+    this.cache.set(name, value);
+    this.pendingWrites.set(name, value);
+    if (this.writeTimer === null) {
+      const schedule = typeof window !== "undefined" && typeof window.setTimeout === "function" ? window.setTimeout.bind(window) : setTimeout;
+      this.writeTimer = schedule(() => {
+        this.flush();
+      }, 100);
+    }
+  }
+  /**
+  * Flush pending writes to localStorage
+  */
+  flush() {
+    if (this.writeTimer !== null) {
+      clearTimeout(this.writeTimer);
+      this.writeTimer = null;
+    }
+    if (typeof localStorage === "undefined") {
+      this.pendingWrites.clear();
+      return;
+    }
+    for (const [name, value] of this.pendingWrites) {
+      try {
+        const key = `${this.namespace}.${name}`;
+        const serialized = JSON.stringify(this.sanitize(value));
+        localStorage.setItem(key, serialized);
+      } catch (err) {
+        if (err.name === "QuotaExceededError" || err.code === 22) {
+          reportRuntimeError(this.runtime?.listener, APIErrorCode.E7061, {});
+        } else {
+          reportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, {
+            error: `Set operation failed: ${String(err)}`
+          });
+        }
+      }
+    }
+    this.pendingWrites.clear();
+  }
+  /**
+  * Check if there are pending writes and flush if needed
+  */
+  check() {
+    if (this.pendingWrites.size > 0) {
+      this.flush();
+    }
+  }
+  /**
+  * Delete a single key from storage (cache + localStorage + any pending write)
+  */
+  delete(name) {
+    if (!name || typeof name !== "string" || name.trim() === "") {
+      reportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, {
+        key: String(name)
+      });
+      return;
+    }
+    this.cache.delete(name);
+    this.pendingWrites.delete(name);
+    if (typeof localStorage !== "undefined") {
+      try {
+        localStorage.removeItem(`${this.namespace}.${name}`);
+      } catch (err) {
+        reportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, {
+          error: `Delete operation failed: ${String(err)}`
+        });
+      }
+    }
+  }
+  /**
+  * Clear all storage for this namespace
+  */
+  clear() {
+    if (typeof localStorage === "undefined") {
+      return;
+    }
+    const prefix = `${this.namespace}.`;
+    const keysToRemove = [];
+    for (let i = 0; i < localStorage.length; i++) {
+      const key = localStorage.key(i);
+      if (key && key.startsWith(prefix)) {
+        keysToRemove.push(key);
+      }
+    }
+    for (const key of keysToRemove) {
+      localStorage.removeItem(key);
+    }
+    this.cache.clear();
+    this.pendingWrites.clear();
+  }
+  /**
+  * Sanitize value for JSON serialization
+  * Removes functions and handles circular references
+  */
+  sanitize(value, seen = /* @__PURE__ */ new WeakSet()) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (typeof value !== "object") {
+      if (typeof value === "function") {
+        return void 0;
+      }
+      return value;
+    }
+    if (seen.has(value)) {
+      return void 0;
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+      return value.map((item) => this.sanitize(item, seen)).filter((item) => item !== void 0);
+    }
+    const result = {};
+    for (const key in value) {
+      if (Object.hasOwn(value, key)) {
+        const sanitized = this.sanitize(value[key], seen);
+        if (sanitized !== void 0) {
+          result[key] = sanitized;
+        }
+      }
+    }
+    return result;
+  }
+  interfaceCache = null;
+  /**
+  * Get storage interface for game code
+  */
+  getInterface() {
+    if (this.interfaceCache) {
+      return this.interfaceCache;
+    }
+    this.interfaceCache = {
+      set: /* @__PURE__ */ __name((name, value) => this.set(name, value), "set"),
+      get: /* @__PURE__ */ __name((name) => this.get(name), "get"),
+      delete: /* @__PURE__ */ __name((name) => this.delete(name), "delete")
+    };
+    return this.interfaceCache;
+  }
+};
+
+export { StorageService };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/index.ts"],"names":["StorageService","namespace","cache","Map","pendingWrites","writeTimer","runtime","preserve","localStorage","clear","get","name","trim","reportRuntimeError","listener","APIErrorCode","E7063","key","String","has","value","getItem","parsed","JSON","parse","set","err","E7062","error","schedule","window","setTimeout","bind","flush","clearTimeout","serialized","stringify","sanitize","setItem","code","E7061","check","size","delete","removeItem","prefix","keysToRemove","i","length","startsWith","push","seen","WeakSet","undefined","add","Array","isArray","map","item","filter","result","Object","hasOwn","sanitized","interfaceCache","getInterface"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Storage service - localStorage wrapper with automatic serialization\n */\n\nimport { APIErrorCode, reportRuntimeError } from \"@al8b/diagnostics\";\n\nexport class StorageService {\n\tprivate namespace: string;\n\tprivate cache: Map<string, any> = new Map();\n\tprivate pendingWrites: Map<string, any> = new Map();\n\tprivate writeTimer: ReturnType<typeof setTimeout> | null = null;\n\tprivate runtime?: any;\n\n\tconstructor(namespace = \"/l8b\", preserve = false, runtime?: any) {\n\t\tthis.namespace = namespace;\n\t\tthis.runtime = runtime;\n\n\t\t// Clear storage if not preserving\n\t\tif (!preserve && typeof localStorage !== \"undefined\") {\n\t\t\tthis.clear();\n\t\t}\n\t}\n\n\t/**\n\t * Get value from storage\n\t */\n\tget(name: string): any {\n\t\t// Validate storage key\n\t\tif (!name || typeof name !== \"string\" || name.trim() === \"\") {\n\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, { key: String(name) });\n\t\t\treturn null;\n\t\t}\n\n\t\t// Check cache first\n\t\tif (this.cache.has(name)) {\n\t\t\treturn this.cache.get(name);\n\t\t}\n\n\t\t// Try localStorage\n\t\tif (typeof localStorage !== \"undefined\") {\n\t\t\ttry {\n\t\t\t\tconst key = `${this.namespace}.${name}`;\n\t\t\t\tconst value = localStorage.getItem(key);\n\t\t\t\tif (value !== null) {\n\t\t\t\t\tconst parsed = JSON.parse(value);\n\t\t\t\t\tthis.cache.set(name, parsed);\n\t\t\t\t\treturn parsed;\n\t\t\t\t}\n\t\t\t} catch (err: any) {\n\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, { error: `Get operation failed: ${String(err)}` });\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\n\t/**\n\t * Set value in storage (batched write)\n\t */\n\tset(name: string, value: any): void {\n\t\t// Validate storage key\n\t\tif (!name || typeof name !== \"string\" || name.trim() === \"\") {\n\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, { key: String(name) });\n\t\t\treturn;\n\t\t}\n\n\t\t// Update cache\n\t\tthis.cache.set(name, value);\n\n\t\t// Queue write\n\t\tthis.pendingWrites.set(name, value);\n\n\t\t// Schedule batch write\n\t\tif (this.writeTimer === null) {\n\t\t\tconst schedule =\n\t\t\t\ttypeof window !== \"undefined\" && typeof window.setTimeout === \"function\"\n\t\t\t\t\t? window.setTimeout.bind(window)\n\t\t\t\t\t: setTimeout;\n\n\t\t\tthis.writeTimer = schedule(() => {\n\t\t\t\tthis.flush();\n\t\t\t}, 100);\n\t\t}\n\t}\n\n\t/**\n\t * Flush pending writes to localStorage\n\t */\n\tflush(): void {\n\t\tif (this.writeTimer !== null) {\n\t\t\tclearTimeout(this.writeTimer);\n\t\t\tthis.writeTimer = null;\n\t\t}\n\n\t\tif (typeof localStorage === \"undefined\") {\n\t\t\tthis.pendingWrites.clear();\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const [name, value] of this.pendingWrites) {\n\t\t\ttry {\n\t\t\t\tconst key = `${this.namespace}.${name}`;\n\t\t\t\tconst serialized = JSON.stringify(this.sanitize(value));\n\t\t\t\tlocalStorage.setItem(key, serialized);\n\t\t\t} catch (err: any) {\n\t\t\t\t// Check for quota exceeded error\n\t\t\t\tif (err.name === \"QuotaExceededError\" || err.code === 22) {\n\t\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7061, {});\n\t\t\t\t} else {\n\t\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, { error: `Set operation failed: ${String(err)}` });\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthis.pendingWrites.clear();\n\t}\n\n\t/**\n\t * Check if there are pending writes and flush if needed\n\t */\n\tcheck(): void {\n\t\tif (this.pendingWrites.size > 0) {\n\t\t\tthis.flush();\n\t\t}\n\t}\n\n\t/**\n\t * Delete a single key from storage (cache + localStorage + any pending write)\n\t */\n\tdelete(name: string): void {\n\t\tif (!name || typeof name !== \"string\" || name.trim() === \"\") {\n\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7063, { key: String(name) });\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove from in-memory state\n\t\tthis.cache.delete(name);\n\t\tthis.pendingWrites.delete(name);\n\n\t\t// Remove from localStorage\n\t\tif (typeof localStorage !== \"undefined\") {\n\t\t\ttry {\n\t\t\t\tlocalStorage.removeItem(`${this.namespace}.${name}`);\n\t\t\t} catch (err: any) {\n\t\t\t\treportRuntimeError(this.runtime?.listener, APIErrorCode.E7062, {\n\t\t\t\t\terror: `Delete operation failed: ${String(err)}`,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Clear all storage for this namespace\n\t */\n\tclear(): void {\n\t\tif (typeof localStorage === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\n\t\tconst prefix = `${this.namespace}.`;\n\t\tconst keysToRemove: string[] = [];\n\n\t\t// Find all keys with this namespace\n\t\tfor (let i = 0; i < localStorage.length; i++) {\n\t\t\tconst key = localStorage.key(i);\n\t\t\tif (key && key.startsWith(prefix)) {\n\t\t\t\tkeysToRemove.push(key);\n\t\t\t}\n\t\t}\n\n\t\t// Remove them\n\t\tfor (const key of keysToRemove) {\n\t\t\tlocalStorage.removeItem(key);\n\t\t}\n\n\t\t// Clear cache\n\t\tthis.cache.clear();\n\t\tthis.pendingWrites.clear();\n\t}\n\n\t/**\n\t * Sanitize value for JSON serialization\n\t * Removes functions and handles circular references\n\t */\n\tprivate sanitize(value: any, seen = new WeakSet()): any {\n\t\tif (value === null || value === undefined) {\n\t\t\treturn value;\n\t\t}\n\n\t\t// Primitives\n\t\tif (typeof value !== \"object\") {\n\t\t\t// Remove functions\n\t\t\tif (typeof value === \"function\") {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn value;\n\t\t}\n\n\t\t// Check for circular reference\n\t\tif (seen.has(value)) {\n\t\t\treturn undefined;\n\t\t}\n\t\tseen.add(value);\n\n\t\t// Arrays\n\t\tif (Array.isArray(value)) {\n\t\t\treturn value.map((item) => this.sanitize(item, seen)).filter((item) => item !== undefined);\n\t\t}\n\n\t\t// Objects\n\t\tconst result: any = {};\n\t\tfor (const key in value) {\n\t\t\tif (Object.hasOwn(value, key)) {\n\t\t\t\tconst sanitized = this.sanitize(value[key], seen);\n\t\t\t\tif (sanitized !== undefined) {\n\t\t\t\t\tresult[key] = sanitized;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\n\tprivate interfaceCache: {\n\t\tset: (name: string, value: unknown) => void;\n\t\tget: (name: string) => unknown;\n\t\tdelete: (name: string) => void;\n\t} | null = null;\n\n\t/**\n\t * Get storage interface for game code\n\t */\n\tgetInterface() {\n\t\tif (this.interfaceCache) {\n\t\t\treturn this.interfaceCache;\n\t\t}\n\t\tthis.interfaceCache = {\n\t\t\tset: (name: string, value: any) => this.set(name, value),\n\t\t\tget: (name: string) => this.get(name),\n\t\t\tdelete: (name: string) => this.delete(name),\n\t\t};\n\t\treturn this.interfaceCache;\n\t}\n}\n"]}

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "@al8b/io",
+	"version": "0.1.0",
+	"description": "IO and Storage utilities for L8B Engine",
+	"type": "module",
+	"files": [
+		"dist/**/*",
+		"package.json",
+		"README.md"
+	],
+	"exports": {
+		".": "./dist/index.js"
+	},
+	"scripts": {
+		"build": "tsup",
+		"clean": "bun --bun ../../../scripts/clean-package.mjs dist",
+		"test": "vitest run --passWithNoTests",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@al8b/diagnostics": "workspace:*"
+	},
+	"devDependencies": {
+		"tsup": "^8.0.0",
+		"typescript": "^5.9.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}