@vacantthinker/firefox-addon-framework-easy 2026.616.2031 → 2026.617.739

package/dist/BaseNumberKeyORM.d.ts

@@ -0,0 +1,19 @@
+import { BaseORM } from './BaseORM';
+/**
+ * Abstract class for ORMs that store Map<number, V> data.
+ * Automatically handles the conversion between internal Record<number, V> and
+ * Map<number, V>.
+ */
+export declare abstract class BaseNumberKeyORM<V> extends BaseORM<Record<number, V>> {
+    protected constructor(prefix: string, id: string);
+    /**
+     * Fetches data as Record, handles legacy arrays/corruption,
+     * and converts it to Map<number, V> with properly cast number keys.
+     */
+    protected getMap(): Promise<Map<number, V>>;
+    /**
+     * Converts internal Map<number, V> back to Record for storage.
+     */
+    protected setMap(map: Map<number, V>): Promise<void>;
+}
+//# sourceMappingURL=BaseNumberKeyORM.d.ts.map

package/dist/BaseNumberKeyORM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseNumberKeyORM.d.ts","sourceRoot":"","sources":["../src/BaseNumberKeyORM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,SAAS,aAAa,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAKhD;;;OAGG;cACa,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAmBjD;;OAEG;cACa,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3D"}

package/dist/BaseNumberKeyORM.js

@@ -0,0 +1,37 @@
+import { BaseORM } from './BaseORM';
+/**
+ * Abstract class for ORMs that store Map<number, V> data.
+ * Automatically handles the conversion between internal Record<number, V> and
+ * Map<number, V>.
+ */
+export class BaseNumberKeyORM extends BaseORM {
+    constructor(prefix, id) {
+        // Hardcode the default value to an empty object
+        super(prefix, id, {});
+    }
+    /**
+     * Fetches data as Record, handles legacy arrays/corruption,
+     * and converts it to Map<number, V> with properly cast number keys.
+     */
+    async getMap() {
+        let data = await this.get();
+        // Data Migration / Corruption Guard (carried over from your original logic)
+        if (Array.isArray(data)) {
+            console.warn(`BaseNumberKeyORM: Old Array data detected for ${this.storageKey}. Migrating to Record.`);
+            data = Object.fromEntries(data);
+            await this.set(data);
+        }
+        else if (typeof data !== 'object' || data === null) {
+            data = {};
+            await this.set(data);
+        }
+        // Convert object entries back to Map, casting string keys to numbers
+        return new Map(Object.entries(data).map(([key, value]) => [Number(key), value]));
+    }
+    /**
+     * Converts internal Map<number, V> back to Record for storage.
+     */
+    async setMap(map) {
+        await this.set(Object.fromEntries(map));
+    }
+}

package/dist/BaseStringKeyORM.d.ts

@@ -0,0 +1,18 @@
+import { BaseORM } from './BaseORM';
+/**
+ * Abstract class for ORMs that store Map<string, V> data.
+ * Automatically handles the conversion between internal Record<string, V> and
+ * Map<string, V>.
+ */
+export declare abstract class BaseStringKeyORM<V> extends BaseORM<Record<string, V>> {
+    protected constructor(prefix: string, id: string);
+    /**
+     * Fetches data as Record and converts it to Map<string, V>.
+     */
+    protected getMap(): Promise<Map<string, V>>;
+    /**
+     * Converts internal Map<string, V> back to Record for storage.
+     */
+    protected setMap(map: Map<string, V>): Promise<void>;
+}
+//# sourceMappingURL=BaseStringKeyORM.d.ts.map

package/dist/BaseStringKeyORM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseStringKeyORM.d.ts","sourceRoot":"","sources":["../src/BaseStringKeyORM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,SAAS,aAAa,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAKhD;;OAEG;cACa,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAOjD;;OAEG;cACa,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3D"}

package/dist/BaseStringKeyORM.js

@@ -0,0 +1,26 @@
+import { BaseORM } from './BaseORM';
+/**
+ * Abstract class for ORMs that store Map<string, V> data.
+ * Automatically handles the conversion between internal Record<string, V> and
+ * Map<string, V>.
+ */
+export class BaseStringKeyORM extends BaseORM {
+    constructor(prefix, id) {
+        // Hardcode the default value to an empty object
+        super(prefix, id, {});
+    }
+    /**
+     * Fetches data as Record and converts it to Map<string, V>.
+     */
+    async getMap() {
+        const data = await this.get();
+        // Convert object entries to Map
+        return new Map(Object.entries(data || {}));
+    }
+    /**
+     * Converts internal Map<string, V> back to Record for storage.
+     */
+    async setMap(map) {
+        await this.set(Object.fromEntries(map));
+    }
+}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
+export * from './BaseNumberKeyORM';
 export * from './BaseORM';
+export * from './BaseStringKeyORM';
 export * from './browserBrowsingData';
 export * from './browserDownload';
 export * from './browserNotification';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
+export * from './BaseNumberKeyORM';
 export * from './BaseORM';
+export * from './BaseStringKeyORM';
 export * from './browserBrowsingData';
 export * from './browserDownload';
 export * from './browserNotification';

package/dist/opTab.d.ts

@@ -54,7 +54,8 @@ export declare function tabOpQueryDomain(domain: string): Promise<{
  */
 export declare function tabOpQueryUrl(url: string): Promise<number[]>;
 /**
- * browserRuntimeGetPagesURL("optionsALL.html"
+ * Ensures only one tab with the given URL exists, focuses/reloads it,
+ * or creates a new one if it doesn't exist. Closes duplicates if found.
  * @param url
  */
 export declare function tabOpCreateKeepOnlyOneFocusTrue(url: string): Promise<void>;

package/dist/opTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opTab.d.ts","sourceRoot":"","sources":["../src/opTab.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,WACf,SAAQ,OAAO,CAAC,IAAI,CAAC,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,WAAW,GAAG,IAAI,CAGtE;AA4BD;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAExG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAMnH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAKlH;AAED,UAAU,sBAAsB;IAC9B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC;IACjD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAc3F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAMvF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAEjE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9D,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CACvC,EAAE,CAAC,CAaH;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKlE;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,GAAG,EAAE,MAAM,iBAShE;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,iBAKxD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GACrD,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAKhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAcpE"}
+{"version":3,"file":"opTab.d.ts","sourceRoot":"","sources":["../src/opTab.ts"],"names":[],"mappings":"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"}

package/dist/opTab.js

@@ -118,24 +118,33 @@ export async function tabOpQueryUrl(url) {
         .map((t) => t.id);
 }
 /**
- * browserRuntimeGetPagesURL("optionsALL.html"
+ * Ensures only one tab with the given URL exists, focuses/reloads it,
+ * or creates a new one if it doesn't exist. Closes duplicates if found.
  * @param url
  */
 export async function tabOpCreateKeepOnlyOneFocusTrue(url) {
     const tabIds = await tabOpQueryUrl(url);
-    let tabId = tabIds.shift();
-    if (tabIds.length >= 1 && tabId) {
-        await tabOpFocus(tabId);
-        await tabOpReload(tabId);
+    if (tabIds.length > 0) {
+        // 1. Pick the first existing tab to focus and reload
+        const targetTabId = tabIds[0];
+        await tabOpFocus(targetTabId);
+        await tabOpReload(targetTabId);
+        // 2. Cleanup: If there are accidental duplicates, close them
+        if (tabIds.length > 1) {
+            const extraTabIds = tabIds.slice(1);
+            await tabOpRemove(extraTabIds);
+        }
     }
     else {
+        // 3. No tabs exist with this URL, create a new one
         await tabOpCreateActiveTrue({ url });
     }
 }
 export async function tabOpQueryThenReloadALL(url) {
     const tabIds = await tabOpQueryUrl(url);
     if (tabIds.length >= 1) {
-        tabIds.forEach(tabId => tabOpReload(tabId));
+        // Reload all matching tabs concurrently and wait for completion
+        await Promise.all(tabIds.map(tabId => tabOpReload(tabId)));
     }
 }
 /**

package/package.json

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