@vacantthinker/firefox-addon-framework-easy 2026.618.1706 → 2026.619.849

package/dist/ContentJs.d.ts

@@ -6,8 +6,9 @@
  * @param filename
  * @param querySelector - Optional custom selector if you aren't targeting the
  *   first <img>.
+ * @param delayMs
  */
-export declare function ctJsDownloadYoutubeImageViaCanvas(filename: string, querySelector?: string): void;
+export declare function ctJsDownloadYoutubeImageViaCanvas(filename: string, querySelector?: string, delayMs?: number): Promise<void>;
 /**
  * Delays execution for a random period to emulate human actions and bypass
  * anti-bot detections.
@@ -58,6 +59,7 @@ export declare function ctJsRemoveCurrentTab(): Promise<void>;
 export declare function ctJsFocusTargetTab(targetTabId: number): Promise<void>;
 export declare function ctJsReloadTargetTab(targetTabId: number): Promise<void>;
 export declare function ctJsInfoToBackground(info: string): Promise<void>;
+export declare function ctJsDownloadFile(downlink: string, filename: string): Promise<void>;
 export declare function ctJsNotification(content: string): Promise<void>;
 export declare function ctJsBrowserRuntimeSendMessage<T extends {
     act: string;

package/dist/ContentJs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContentJs.d.ts","sourceRoot":"","sources":["../src/ContentJs.ts"],"names":[],"mappings":"AAUA;;;;;;;;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;AAED,QAAA,MAAM,YAAY;;;;;;CAMR,CAAC;AAEX,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,OAAO,YAAY,iBAGtE;AAID;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AAGD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,iBAE7C;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,iBAEzD;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,iBAExD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAKnD;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAW,EAAE,SAAS,UAAO,QAgB/D;AAED,wBAAsB,YAAY,kBAIjC;AAED,wBAAsB,oBAAoB,kBAIzC;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,iBAK3D;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,iBAK5D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,iBAGtD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,iBAIrD;AAED,wBAAsB,6BAA6B,CAAC,CAAC,SAAS;IAC5D,GAAG,EAAE,MAAM,CAAA;CACZ,EAAE,OAAO,EAAE,CAAC,iBAEZ"}
+{"version":3,"file":"ContentJs.d.ts","sourceRoot":"","sources":["../src/ContentJs.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,MAAc,EAC7B,OAAO,GAAE,MAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAoDf;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;AAED,QAAA,MAAM,YAAY;;;;;;CAMR,CAAC;AAEX,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,OAAO,YAAY,iBAGtE;AAID;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AAGD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,iBAE7C;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,iBAEzD;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,iBAExD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAKnD;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAW,EAAE,SAAS,UAAO,QAgB/D;AAED,wBAAsB,YAAY,kBAIjC;AAED,wBAAsB,oBAAoB,kBAIzC;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,iBAK3D;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,iBAK5D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,iBAGtD;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAIxE;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,iBAIrD;AAED,wBAAsB,6BAA6B,CAAC,CAAC,SAAS;IAC5D,GAAG,EAAE,MAAM,CAAA;CACZ,EAAE,OAAO,EAAE,CAAC,iBAEZ"}

package/dist/ContentJs.js

@@ -9,36 +9,50 @@ import { browserRuntimeSendMessage } from "./browserRuntime";
  * @param filename
  * @param querySelector - Optional custom selector if you aren't targeting the
  *   first <img>.
+ * @param delayMs
  */
-export function ctJsDownloadYoutubeImageViaCanvas(filename, querySelector = 'img') {
-    const img = document.body.querySelector(querySelector);
-    if (!img) {
-        console.warn("downloadYoutubeImageViaCanvas: No image element found on the page.");
-        return;
-    }
-    // Map YouTube naturalWidths to their expected canvas proportions (handling
-    // black bars)
-    const sizes = new Map();
-    sizes.set(1280, { w: 1280, h: 720 });
-    sizes.set(320, { w: 1280, h: 720 });
-    sizes.set(640, { w: 1280, h: 900 });
-    sizes.set(480, { w: 1280, h: 900 });
-    const { w, h } = sizes.get(img.naturalWidth) || {
-        w: img.naturalWidth,
-        h: img.naturalHeight
-    };
-    const canvas = document.createElement('canvas');
-    canvas.width = w;
-    canvas.height = h;
-    const ctx = canvas.getContext('2d');
-    if (!ctx)
-        return;
-    ctx.drawImage(img, 0, 0, w, h);
-    const canvasUrl = canvas.toDataURL('image/jpeg', 1.0);
-    const eleA = document.createElement('a');
-    eleA.href = canvasUrl;
-    eleA.download = filename;
-    eleA.click();
+export function ctJsDownloadYoutubeImageViaCanvas(filename, querySelector = 'img', delayMs = 300) {
+    return new Promise((resolve, reject) => {
+        const img = document.body.querySelector(querySelector);
+        if (!img) {
+            console.warn("No image element found on the page.");
+            return resolve();
+        }
+        const sizes = new Map();
+        sizes.set(1280, { w: 1280, h: 720 });
+        sizes.set(320, { w: 1280, h: 720 });
+        sizes.set(640, { w: 1280, h: 900 });
+        sizes.set(480, { w: 1280, h: 900 });
+        const { w, h } = sizes.get(img.naturalWidth) || {
+            w: img.naturalWidth,
+            h: img.naturalHeight
+        };
+        const canvas = document.createElement('canvas');
+        canvas.width = w;
+        canvas.height = h;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            return resolve();
+        ctx.drawImage(img, 0, 0, w, h);
+        // BETTER WAY: Use toBlob instead of toDataURL
+        canvas.toBlob((blob) => {
+            if (!blob) {
+                return reject(new Error("Canvas to Blob conversion failed"));
+            }
+            // Create a temporary local URL for the binary data
+            const blobUrl = URL.createObjectURL(blob);
+            const eleA = document.createElement('a');
+            eleA.href = blobUrl;
+            eleA.download = filename;
+            eleA.click();
+            // Clean up the memory immediately after the click
+            URL.revokeObjectURL(blobUrl);
+            // Wait for the browser to register the download before resolving
+            setTimeout(() => {
+                resolve();
+            }, delayMs);
+        }, 'image/jpeg', 1.0);
+    });
 }
 /**
  * Delays execution for a random period to emulate human actions and bypass
@@ -176,6 +190,11 @@ export async function ctJsReloadTargetTab(targetTabId) {
 export async function ctJsInfoToBackground(info) {
     await browserRuntimeSendMessage({ act: "actInfo", info, });
 }
+export async function ctJsDownloadFile(downlink, filename) {
+    await browserRuntimeSendMessage({
+        act: "actDownloadFile", downloadParams: { downlink, filename }
+    });
+}
 export async function ctJsNotification(content) {
     await browserRuntimeSendMessage({
         act: "actNotification", content,

package/dist/backgroundJs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundJs.d.ts","sourceRoot":"","sources":["../src/backgroundJs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,wBAAwB,EAAC,MAAM,SAAS,CAAC;AAGjD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,GAAG,wBAAwB,KACpF,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,EAC5D,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,EACnC,MAAM,GAAE,MAAyB,QAqBlC"}
+{"version":3,"file":"backgroundJs.d.ts","sourceRoot":"","sources":["../src/backgroundJs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,wBAAwB,EAA6B,MAAM,SAAS,CAAC;AAI7E,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,GAAG,wBAAwB,KACpF,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAiCzB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,EAC5D,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,EACnC,MAAM,GAAE,MAAyB,QAqBlC"}

package/dist/backgroundJs.js

@@ -2,6 +2,7 @@
 import { browserTabSendMessageMarcoPolo } from "./browserTab";
 import { tabOpFocus, tabOpReload, tabOpRemove } from "./opTab";
 import { browserNotificationCreateBasicContent } from "./browserNotification";
+import { serviceDownloadByDownlink } from "./serviceCommon";
 /**
  * Uses <T extends string> so the app can pass its own union type.
  * It defaults to FrameworkBaseAction if no type is passed.
@@ -10,6 +11,11 @@ export function bkJsCreateActionBaseHandlers() {
     // We use `any` internally to set the map up without TS complaining,
     // but we return the strictly typed generic Map.
     const map = new Map();
+    map.set("actDownloadFile", async (rest) => {
+        if (rest && rest.downloadParams) {
+            await serviceDownloadByDownlink(rest.downloadParams);
+        }
+    });
     map.set("actNotification", async (rest) => {
         if (rest && rest.content) {
             await browserNotificationCreateBasicContent(rest.content);

package/dist/browserDownload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserDownload.d.ts","sourceRoot":"","sources":["../src/browserDownload.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAsB,yBAAyB,CAAC,EACE,QAAQ,EACR,QAAe,GAChB,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhF"}
+{"version":3,"file":"browserDownload.d.ts","sourceRoot":"","sources":["../src/browserDownload.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAsB,yBAAyB,CAC7C,EACE,QAAQ,EACR,QAAe,GAChB,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlC"}

package/dist/serviceCommon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceCommon.d.ts","sourceRoot":"","sources":["../src/serviceCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAK5E;;GAEG;AACH,wBAAsB,iBAAiB,kBAGtC;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrF"}
+{"version":3,"file":"serviceCommon.d.ts","sourceRoot":"","sources":["../src/serviceCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAK5E;;GAEG;AACH,wBAAsB,iBAAiB,kBAGtC;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvC"}

package/dist/serviceCommon.js

@@ -20,8 +20,7 @@ export async function serviceDownloadByDownlink(params) {
     try {
         // Attempt 1: Full download with provided parameters
         await browserDownloadByDownlink(params);
-        await browserNotificationCreateBasicContent(`downloading! ${filename ??
-            'file'}`);
+        await browserNotificationCreateBasicContent(`downloading! ${filename ?? 'file'}`);
     }
     catch (error) {
         // Notify about the failure

package/dist/types.d.ts

@@ -1,7 +1,11 @@
-export type MessageActionBaseOptions = "actNotification" | 'actInfo' | "actMarco" | "actRemoveCurrentTab" | "actFocusTargetTab" | "actReloadTargetTab";
+import { DownloadParams } from "./browserDownload";
+export type MessageActionBaseOptions = "actDownloadFile" | "actNotification" | 'actInfo' | "actMarco" | "actRemoveCurrentTab" | "actFocusTargetTab" | "actReloadTargetTab";
 export interface MessagePayloadAction {
     act: MessageActionBaseOptions;
 }
+export interface MessagePayloadDownloadInfo extends MessagePayloadAction {
+    downloadParams: DownloadParams;
+}
 export interface MessagePayloadNotification extends MessagePayloadAction {
     content: string;
     title?: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,SAAS,GACT,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,CAAA;AAExB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,wBAAwB,CAAA;CAC9B;AAED,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AACnE,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,iBAAiB,GACjB,SAAS,GACT,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,CAAA;AAExB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,wBAAwB,CAAA;CAC9B;AAED,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AACnE,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC"}

package/package.json

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