@vacantthinker/firefox-addon-framework-easy 2026.613.1110 → 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/dist/browserTab.d.ts

@@ -2,17 +2,17 @@
  * Sends a message to a specific tab.
  */
 export declare function browserTabSendMessage(tabId: number, message: any): Promise<void>;
-export declare function browserTabExecuteScriptDocumentStart(tabId: number, code: string): Promise<any[]>;
-export declare function browserTabExecuteScript(tabId: number, code: string, runAt?: browser.extensionTypes.RunAt): Promise<any[]>;
+export declare function browserTabExecuteScriptCodeDocumentStart(tabId: number, code: string): Promise<any[]>;
+export declare function browserTabExecuteScriptDocumentStart(tabId: number, updateDetails: browser.extensionTypes.InjectDetails): Promise<any[]>;
+export declare function browserTabExecuteScript(tabId: number, details: browser.extensionTypes.InjectDetails): Promise<any[]>;
 export declare function browserTabSetZoom(tabId: number, zoomFactor: number): Promise<void>;
 export declare function browserTabGetZoom(tabId: number): Promise<number>;
-export declare function browserTabInsertCSSDocumentStart(tabId: number, code: string): Promise<void>;
+export declare function browserTabInsertCSSCodeDocumentStart(tabId: number, code: string): Promise<void>;
+export declare function browserTabInsertCSSDocumentStart(tabId: number, details: browser.extensionTypes.InjectDetails): Promise<void>;
 /**
  * Injects CSS code into a page.
  */
-export declare function browserTabInsertCSS(tabId: number, code: string, runAt: browser.extensionTypes.RunAt): Promise<void>;
-/**
- * Removes CSS code that was previously injected into a page.
- */
-export declare function browserTabRemoveCSS(tabId: number, code: string): Promise<void>;
+export declare function browserTabInsertCSS(tabId: number, details: browser.extensionTypes.InjectDetails): Promise<void>;
+export declare function browserTabRemoveCSSCode(tabId: number, code: string): Promise<void>;
+export declare function browserTabRemoveCSS(tabId: number, details: browser.extensionTypes.InjectDetails): Promise<void>;
 //# sourceMappingURL=browserTab.d.ts.map

package/dist/browserTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserTab.d.ts","sourceRoot":"","sources":["../src/browserTab.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,kBAOb;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,CAAC,cAAc,CAAC,KAAsB,kBAMrD;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,iBAMnB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,mBAGd;AAGD,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,GAClC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAKf"}
+{"version":3,"file":"browserTab.d.ts","sourceRoot":"","sources":["../src/browserTab.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,wCAAwC,CAC5D,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,kBAMb;AAED,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,kBAQpD;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,kBAM9C;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,iBAMnB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,mBAGd;AAED,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,GAC5C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,GAC5C,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,GAC5C,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/browserTab.js

@@ -4,11 +4,15 @@
 export async function browserTabSendMessage(tabId, message) {
     await browser.tabs.sendMessage(tabId, message);
 }
-export async function browserTabExecuteScriptDocumentStart(tabId, code) {
-    return await browserTabExecuteScript(tabId, code, "document_start");
+export async function browserTabExecuteScriptCodeDocumentStart(tabId, code) {
+    return browserTabExecuteScriptDocumentStart(tabId, { code });
 }
-export async function browserTabExecuteScript(tabId, code, runAt = "document_end") {
-    return await browser.tabs.executeScript(tabId, { code, runAt });
+export async function browserTabExecuteScriptDocumentStart(tabId, updateDetails) {
+    const details = { ...updateDetails, runAt: "document_start" };
+    return await browserTabExecuteScript(tabId, details);
+}
+export async function browserTabExecuteScript(tabId, details) {
+    return await browser.tabs.executeScript(tabId, details);
 }
 export async function browserTabSetZoom(tabId, zoomFactor) {
     return await browser.tabs.setZoom(tabId, zoomFactor);
@@ -16,18 +20,23 @@ export async function browserTabSetZoom(tabId, zoomFactor) {
 export async function browserTabGetZoom(tabId) {
     return await browser.tabs.getZoom(tabId);
 }
-export async function browserTabInsertCSSDocumentStart(tabId, code) {
-    await browserTabInsertCSS(tabId, code, "document_start");
+export async function browserTabInsertCSSCodeDocumentStart(tabId, code) {
+    const mergedDetails = { code };
+    await browserTabInsertCSSDocumentStart(tabId, mergedDetails);
+}
+export async function browserTabInsertCSSDocumentStart(tabId, details) {
+    const mergedDetails = { ...details, runAt: 'document_start' };
+    await browserTabInsertCSS(tabId, mergedDetails);
 }
 /**
  * Injects CSS code into a page.
  */
-export async function browserTabInsertCSS(tabId, code, runAt) {
-    await browser.tabs.insertCSS(tabId, { code, runAt });
+export async function browserTabInsertCSS(tabId, details) {
+    await browser.tabs.insertCSS(tabId, details);
 }
-/**
- * Removes CSS code that was previously injected into a page.
- */
-export async function browserTabRemoveCSS(tabId, code) {
-    await browser.tabs.removeCSS(tabId, { code });
+export async function browserTabRemoveCSSCode(tabId, code) {
+    await browserTabRemoveCSS(tabId, { code });
+}
+export async function browserTabRemoveCSS(tabId, details) {
+    await browser.tabs.removeCSS(tabId, details);
 }

package/package.json

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