@vacantthinker/firefox-addon-framework-easy 2026.616.2042 → 2026.617.1148

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/{serviceOpContentJsYTB.d.ts → ContentJsYTB.d.ts}

@@ -42,4 +42,11 @@ export interface MessagePayloadFocusTargetTab {
 export declare function ctJsFocusTargetTabUseRuntimeMessage(targetTabId: number): Promise<void>;
 export declare function ctJsFocusTargetTab(targetTabId: number): Promise<void>;
 export declare function ctJsRemoveDomainCache(domain: string): Promise<void>;
-//# sourceMappingURL=serviceOpContentJsYTB.d.ts.map
+/**
+ * Executes a provided function once the DOM is ready.
+ * If the DOM is already ready, it executes immediately.
+ * * @param fn - The function to execute. Can be a synchronous or asynchronous
+ * function.
+ */
+export declare function ctJsExecuteOnReady(fn: () => void | Promise<void>): Promise<void>;
+//# sourceMappingURL=ContentJsYTB.d.ts.map

package/dist/ContentJsYTB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentJsYTB.d.ts","sourceRoot":"","sources":["../src/ContentJsYTB.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAE,MAAc,GAAG,IAAI,CAmCvG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,uBAAuB,kBAE5C;AAED,wBAAsB,sBAAsB,kBAE3C;AAGD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAW,EAAE,SAAS,UAAQ,QAShE;AAED,wBAAsB,YAAY,kBAIjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,mBAAmB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,mCAAmC,CAAC,WAAW,EAAE,MAAM,iBAM5E;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,iBAE3D;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,iBAEzD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtF"}

package/dist/{serviceOpContentJsYTB.js → ContentJsYTB.js}

@@ -106,3 +106,24 @@ export async function ctJsFocusTargetTab(targetTabId) {
 export async function ctJsRemoveDomainCache(domain) {
     await browserBrowsingDataRemoveDomainCache(domain);
 }
+/**
+ * Executes a provided function once the DOM is ready.
+ * If the DOM is already ready, it executes immediately.
+ * * @param fn - The function to execute. Can be a synchronous or asynchronous
+ * function.
+ */
+export async function ctJsExecuteOnReady(fn) {
+    if (document.readyState === 'loading') {
+        // DOM is still loading, wait for the event
+        await new Promise((resolve) => {
+            document.addEventListener('DOMContentLoaded', async () => {
+                await fn();
+                resolve();
+            }, { once: true });
+        });
+    }
+    else {
+        // DOM is already ready, execute immediately
+        await fn();
+    }
+}

package/dist/index.d.ts

@@ -1,15 +1,17 @@
+export * from './BaseNumberKeyORM';
 export * from './BaseORM';
+export * from './BaseStringKeyORM';
 export * from './browserBrowsingData';
 export * from './browserDownload';
 export * from './browserNotification';
 export * from './browserRuntime';
 export * from './browserTab';
+export * from './ContentJsYTB';
 export * from './opStorage';
 export * from './opTab';
 export * from './serviceCommon';
 export * from './serviceFetch';
 export * from './serviceGet';
-export * from './serviceOpContentJsYTB';
 export * from './serviceOpContent';
 export * from './serviceOperationYTB';
 export * from './serviceOpJavascript';

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,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,15 +1,17 @@
+export * from './BaseNumberKeyORM';
 export * from './BaseORM';
+export * from './BaseStringKeyORM';
 export * from './browserBrowsingData';
 export * from './browserDownload';
 export * from './browserNotification';
 export * from './browserRuntime';
 export * from './browserTab';
+export * from './ContentJsYTB';
 export * from './opStorage';
 export * from './opTab';
 export * from './serviceCommon';
 export * from './serviceFetch';
 export * from './serviceGet';
-export * from './serviceOpContentJsYTB';
 export * from './serviceOpContent';
 export * from './serviceOperationYTB';
 export * from './serviceOpJavascript';

package/package.json

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

package/dist/serviceOpContentJsYTB.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serviceOpContentJsYTB.d.ts","sourceRoot":"","sources":["../src/serviceOpContentJsYTB.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAE,MAAc,GAAG,IAAI,CAmCvG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,uBAAuB,kBAE5C;AAED,wBAAsB,sBAAsB,kBAE3C;AAGD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAW,EAAE,SAAS,UAAQ,QAShE;AAED,wBAAsB,YAAY,kBAIjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,mBAAmB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,mCAAmC,CAAC,WAAW,EAAE,MAAM,iBAM5E;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,iBAE3D;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,iBAEzD"}