@vacantthinker/firefox-addon-framework-easy 2026.613.1125 → 2026.613.1536

package/dist/BaseORM.d.ts

@@ -4,37 +4,32 @@
  * Uses Generics (T) to ensure type safety for the stored object structure.
  */
 export declare abstract class BaseORM<T extends Record<string, any>> {
-    #private;
-    /**
-     * @param prefix The prefix for the storage key.
-     * @param id The unique identifier for this instance.
-     * @param defaultValue The initial value to use if the key does not exist.
-     */
+    protected readonly id: string;
+    protected readonly storageKey: string;
+    private readonly defaultValue;
+    private initPromise;
     protected constructor(prefix: string, id: string, defaultValue?: T);
-    get id(): string;
-    get storageKey(): string;
     /**
      * Retrieve the value associated with the bound key.
      * @returns {Promise<T>}
      */
-    get(): Promise<T>;
+    protected get(): Promise<T>;
+    /**
+     * Safely initialize the default object. Prevents multiple concurrent
+     * requests from writing the default value simultaneously.
+     */
+    private safeInit;
     /**
      * Overwrite the value of the bound key completely.
      * @param {T} value
      * @returns {Promise<void>}
      */
-    set(value: T): Promise<void>;
+    protected set(value: T): Promise<void>;
     /**
      * Wipe the bound key from storage.
      * @returns {Promise<T>}
      */
-    delete(): Promise<T>;
-    /**
-     * Modify a single targeted key-value pair nested deep within the stored object.
-     * @param {K} key The internal key path inside the main value object.
-     * @param {T[K]} value The new value to map to that key.
-     */
-    updateValueKeyValue<K extends keyof T>(key: K, value: T[K]): Promise<void>;
+    protected delete(): Promise<T>;
     private exists;
     private initDefaultObject;
 }

package/dist/BaseORM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseORM.d.ts","sourceRoot":"","sources":["../src/BaseORM.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,8BAAsB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;IAKzD;;;;OAIG;IACH,SAAS,aACP,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,CAAW;IAe3B,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAOvB;;;;OAIG;IACG,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;IAM1B;;;;OAIG;IACG,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,EACzC,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,IAAI,CAAC;YAMF,MAAM;YAIN,iBAAiB;CAMhC"}
+{"version":3,"file":"BaseORM.d.ts","sourceRoot":"","sources":["../src/BaseORM.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,8BAAsB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACzD,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAI;IAGjC,OAAO,CAAC,WAAW,CAA8B;IAEjD,SAAS,aACP,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,CAAW;IAkB3B;;;OAGG;cACa,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAQjC;;;OAGG;YACW,QAAQ;IAgBtB;;;;OAIG;cACa,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C;;;OAGG;cACa,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;YAMtB,MAAM;YAIN,iBAAiB;CAMhC"}

package/dist/BaseORM.js

@@ -5,14 +5,11 @@ import { stoOpCheck, stoOpGet, stoOpRem, stoOpSet } from './opStorage';
  * Uses Generics (T) to ensure type safety for the stored object structure.
  */
 export class BaseORM {
-    #id;
-    #fullStorageKey;
-    #defaultValue;
-    /**
-     * @param prefix The prefix for the storage key.
-     * @param id The unique identifier for this instance.
-     * @param defaultValue The initial value to use if the key does not exist.
-     */
+    id;
+    storageKey;
+    defaultValue;
+    // The Mutex "Lock" for preventing race conditions during initialization
+    initPromise = null;
     constructor(prefix, id, defaultValue = {}) {
         if (new.target === BaseORM) {
             throw new TypeError('Cannot construct BaseORM instances directly (Abstract Class).');
@@ -20,16 +17,12 @@ export class BaseORM {
         if (!prefix || !id) {
             throw new Error('Both prefix and id must be specified.');
         }
-        this.#id = id;
-        const formattedPrefix = prefix.endsWith(' ') ? prefix : `${prefix} `;
-        this.#fullStorageKey = `${formattedPrefix}${id}`;
-        this.#defaultValue = JSON.parse(JSON.stringify(defaultValue));
-    }
-    get id() {
-        return this.#id;
-    }
-    get storageKey() {
-        return this.#fullStorageKey;
+        this.id = id;
+        const formattedPrefix = prefix.endsWith(' ') ?
+            prefix :
+            `${prefix} `;
+        this.storageKey = `${formattedPrefix}${id}`;
+        this.defaultValue = structuredClone(defaultValue);
     }
     /**
      * Retrieve the value associated with the bound key.
@@ -37,9 +30,27 @@ export class BaseORM {
      */
     async get() {
         if (!(await this.exists())) {
-            await this.initDefaultObject();
+            // Calls the lock-protected initialization instead of initDefaultObject directly
+            await this.safeInit();
         }
-        return (await stoOpGet(this.#fullStorageKey));
+        return (await stoOpGet(this.storageKey));
+    }
+    /**
+     * Safely initialize the default object. Prevents multiple concurrent
+     * requests from writing the default value simultaneously.
+     */
+    async safeInit() {
+        // If an initialization is already in progress, wait for it
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        // Start initialization and store the Promise as the lock
+        this.initPromise = this.initDefaultObject()
+            .finally(() => {
+            // Clear the lock whether the initialization succeeds or fails
+            this.initPromise = null;
+        });
+        return this.initPromise;
     }
     /**
      * Overwrite the value of the bound key completely.
@@ -47,7 +58,7 @@ export class BaseORM {
      * @returns {Promise<void>}
      */
     async set(value) {
-        await stoOpSet(this.#fullStorageKey, value || this.#defaultValue);
+        await stoOpSet(this.storageKey, value ?? this.defaultValue);
     }
     /**
      * Wipe the bound key from storage.
@@ -55,23 +66,13 @@ export class BaseORM {
      */
     async delete() {
         const previousValue = await this.get();
-        await stoOpRem(this.#fullStorageKey);
+        await stoOpRem(this.storageKey);
         return previousValue;
     }
-    /**
-     * Modify a single targeted key-value pair nested deep within the stored object.
-     * @param {K} key The internal key path inside the main value object.
-     * @param {T[K]} value The new value to map to that key.
-     */
-    async updateValueKeyValue(key, value) {
-        const data = await this.get();
-        data[key] = value;
-        await this.set(data);
-    }
     async exists() {
-        return await stoOpCheck(this.#fullStorageKey);
+        return await stoOpCheck(this.storageKey);
     }
     async initDefaultObject() {
-        await stoOpSet(this.#fullStorageKey, this.#defaultValue);
+        await stoOpSet(this.storageKey, this.defaultValue);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0613.1125",
+  "version": "2026.0613.1536",
   "description": "",
   "type": "module",
   "main": "dist/index.js",