@vacantthinker/firefox-addon-framework-easy 2026.611.821 → 2026.611.1153

package/src/BaseORM.js

@@ -1,66 +0,0 @@
-import {stoOpCheck, stoOpGet, stoOpRem, stoOpSet} from './opStorage.js';
-
-/**
- * Abstract base class BaseORM.
- * Provides encapsulated CRUD operations for JSON-serializable Key-Value pairs.
- */
-export class BaseORM {
-  #id;
-  #fullStorageKey;
-  #defaultValue;
-
-  constructor(prefix, id, defaultValue = {}) {
-    if (new.target === BaseORM) {
-      throw new TypeError(
-          'Cannot construct BaseORM instances directly (Abstract Class).');
-    }
-    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;
-  }
-
-  async #exists() {
-    return await stoOpCheck(this.#fullStorageKey);
-  }
-
-  async #initDefaultObject() {
-    await stoOpSet(this.#fullStorageKey, this.#defaultValue);
-  }
-
-  async get() {
-    if (!(await this.#exists())) {
-      await this.#initDefaultObject();
-    }
-    return await stoOpGet(this.#fullStorageKey);
-  }
-
-  async set(value) {
-    await stoOpSet(this.#fullStorageKey, value || this.#defaultValue);
-  }
-
-  async delete() {
-    const previousValue = await this.get();
-    await stoOpRem(this.#fullStorageKey);
-    return previousValue;
-  }
-
-  async updateValueKeyValue(objectKey, objectValue) {
-    const currentData = await this.get();
-    currentData[objectKey] = objectValue;
-    await this.set(currentData);
-    return currentData;
-  }
-}

package/src/DomainORM.js

@@ -1,11 +0,0 @@
-import {BaseORM} from './BaseORM.js';
-
-export class DomainORM extends BaseORM {
-  constructor(domain) {
-    super(`domainKey`, domain, {});
-  }
-
-  logKey() {
-    console.info(this.id); // domainKey 123sdfsdf
-  }
-}

package/src/browserDownload.js

@@ -1,23 +0,0 @@
-/**
- *
- * @param param0
- * @param param0.downlink{string}
- * @param param0.filename{string|null|undefined}
- * @returns {Promise<void>}
- */
-export async function browserDownloadByDownlink(
-    {
-      downlink,
-      filename = null,
-    }) {
-  let url = downlink;
-  /** @type {browser.downloads._DownloadOptions} */
-  let options = {
-    url,
-    saveAs: false,
-  };
-  if (filename) {
-    Object.assign(options, {filename});
-  }
-  await browser.downloads.download(options);
-}

package/src/browserNotification.js

@@ -1,22 +0,0 @@
-import {browserRuntimeManifestName} from './browserRuntime.js';
-
-/**
- *
- * @param content{ string}
- * @param title{string}
- * @returns {Promise<string>}
- */
-export async function browserNotificationCreate(
-    content,
-    title = browserRuntimeManifestName(),
-) {
-
-  const tag = 'browserNotificationCreate';
-  let notificationId = `${tag}cake-noti`;
-  await browser.notifications.create(notificationId, {
-    type: 'basic',
-    title,
-    message: `${content}`,
-  });
-  return notificationId;
-}

package/src/browserRuntime.js

@@ -1,65 +0,0 @@
-export function browserRuntimeReload() {
-  browser.runtime.reload();
-}
-
-/**
- *
- * @param url{string}
- */
-export async function browserRuntimeSetUninstallURL(
-    url = '',
-) {
-  await browser.runtime.setUninstallURL(url);
-}
-
-/**
- *
- * @param doWhat{function}
- */
-export function browserRuntimeOnUpdateAvailable(doWhat = null) {
-  browser.runtime.onUpdateAvailable.addListener(async (details) => {
-    if (doWhat) {
-      await doWhat(details);
-    }
-  });
-}
-
-/**
- *
- * @param path{string}
- * @returns {string}
- */
-export function browserRuntimeGetURL(path) {
-  return browser.runtime.getURL(path);
-}
-
-/**
- * @returns {browser._manifest.ExtensionID}
- */
-export function browserRuntimeGeckoId() {
-  return browser.runtime.getManifest().browser_specific_settings.gecko.id;
-}
-
-/**
- *
- * @returns {Promise<browser.runtime.PlatformInfo>}
- */
-export async function browserRuntimePlatformInfo() {
-  return await browser.runtime.getPlatformInfo();
-}
-
-/**
- * browser.runtime.getManifest().version;
- * @returns {string}
- */
-export function browserRuntimeManifestVersion() {
-  return browser.runtime.getManifest().version;
-}
-
-/**
- * browser.runtime.getManifest().name;
- * @returns {string}
- */
-export function browserRuntimeManifestName() {
-  return browser.runtime.getManifest().name;
-}

package/src/browserRuntimeOnMessageCommon.js

@@ -1,50 +0,0 @@
-import {tabOpFocus, tabOpRemove} from './opTab.js';
-import {serviceDownloadByDownlink} from './serviceCommon.js';
-import {browserTabSendMessage} from './browserTab.js';
-import {browserNotificationCreate} from './browserNotification.js';
-
-/**
- * Offer common act <=> function
- *
- * @param act{
- *   |'actLog'
- *   |'actMarco'
- *   |'actRequestTabIdTabUrl'
- *   |'actNotification'
- *   |'actRemoveTab'
- *   |'actFocusTab'
- *   |'actDownloadFile'
- *   |'actSendMessageToTab'
- *   }
- * @param message
- * @param message.tabId{number}
- * @param sendResponse
- */
-export function browserRuntimeOnMessageCommon(act, message, sendResponse) {
-  switch (act) {
-    case 'actLog':
-      console.log('act', act, 'message', message);
-      break;
-    case 'actMarco': //Marco Polo pool game
-      sendResponse({status: 'Polo'});
-      break;
-    case 'actRequestTabIdTabUrl':
-      sendResponse(message);
-      break;
-    case 'actNotification':
-      browserNotificationCreate(message.content);
-      break;
-    case 'actRemoveTab':
-      tabOpRemove(message.tabId);
-      break;
-    case 'actFocusTab':
-      tabOpFocus(message.tabId);
-      break;
-    case 'actDownloadFile':
-      serviceDownloadByDownlink(message);
-      break;
-    case 'actSendMessageToTab':
-      browserTabSendMessage(message.tabId, message);
-      break;
-  }
-}

package/src/browserTab.js

@@ -1,138 +0,0 @@
-// @ts-check
-
-import {tabOpCreateNear, tabOpGet, tabOpRemove} from './opTab.js';
-
-export async function browserTabSendMessage(
-    tabId,
-    message,
-) {
-  await browser.tabs.sendMessage(tabId, message);
-}
-
-export function browserTabWaitReloadThenSendMessageToContentJs(message) {
-  let tabId = message.tabId;
-  browser.tabs.onUpdated.addListener(
-      async function lis(
-          tabId,
-          changeInfo,
-      ) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          await browserTabSendMessage(tabId, message);
-        }
-      }
-      , {tabId, properties: ['status']});
-}
-
-/**
- * must has,  url
- * @param message
- * @param message.tabId{number}
- * @param message.url{string}
- * @param message.focusNewTab{boolean}
- * @returns {Promise<void>}
- */
-export async function browserTabCreateToDownload(message) {
-  let properties = {
-    url: message.url,
-  };
-  if (message.tabId) {
-    let tabId = message.tabId;
-    try {
-      await tabOpGet(tabId);
-      Object.assign(properties, {tabId});
-    } catch (e) {
-      delete message.tabId;
-    }
-  }
-  
-  if (message?.focusNewTab !== undefined) {
-    Object.assign(properties, {active: message.focusNewTab});
-  }
-
-  let {tabId} = await tabOpCreateNear(properties);
-  browser.tabs.onUpdated.addListener(
-      async function lis(
-          tabId,
-          changeInfo,
-      ) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          // todo code here
-          await tabOpRemove(tabId);
-        }
-      }
-      , {tabId, properties: ['status']});
-}
-
-/**
- * Safely handles incoming messages to create tabs and send messages to content scripts.
- * * @param {Object} message - The message payload.
- * @param {number} [message.tabId] - Optional Tab ID to attach to.
- * @param {string} [message.url] - The URL to open.
- * @param {boolean} [message.focusNewTab] - Whether the newly created tab should be active.
- * @returns {Promise<void>}
- */
-export async function browserTabCreateNearSendMessageToContentJs(message = {}) {
-  let properties = {
-    url: message.url,
-  };
-
-  // Strictly check for tabId presence to prevent passing undefined.
-  if (message.tabId !== undefined) {
-    let tabId = message.tabId;
-    try {
-      await tabOpGet(tabId);
-      Object.assign(properties, {tabId});
-    } catch (e) {
-      delete message.tabId;
-    }
-  }
-
-  // Use optional chaining to safely extract nested properties.
-  // Only assign 'active' if 'focusNewTab' was explicitly provided.
-  if (message?.focusNewTab !== undefined) {
-    Object.assign(properties, {active: message.focusNewTab});
-  }
-
-  let {tabId} = await tabOpCreateNear(properties);
-
-  browser.tabs.onUpdated.addListener(
-      async function lis(
-          updatedTabId,
-          changeInfo,
-      ) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-
-          // Execute further logic once the tab is completely loaded.
-          await browserTabSendMessage(
-              updatedTabId,
-              Object.assign({}, message, {tabId: updatedTabId}),
-          );
-        }
-      },
-      {tabId, properties: ['status']},
-  );
-}
-
-/**
- * tab exists, watch it, reload then close
- * @param param0
- * @param param0.tabId{number}
- */
-export function browserTabWaitReloadThenRemoveIt({tabId}) {
-  browser.tabs.onUpdated.addListener(
-      async function lis(
-          tabId,
-          changeInfo,
-      ) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          // todo code here
-          await tabOpRemove(tabId);
-        }
-      }
-      , {tabId, properties: ['status']});
-
-}

package/src/generate.js

@@ -1,177 +0,0 @@
-/**
- *
- * @param videoInfo
- * @param videoInfo.vid{string}
- * @param videoInfo.videoTitle{string}
- * @return {string}
- */
-export function generateMkvScriptForSystemWindows(videoInfo) {
-  return `if (true) {
-  const path = require('path');
-  const fs = require('fs');
-  const {execSync, exec} = require('node:child_process');
-  let pathDownload = path.join(__dirname);
-  let dot = '.';
-  let extMKV = 'mkv';
-
-  let {vid, videoTitle} = ${JSON.stringify(videoInfo)};
-  let playVideoAfterMerged = true;
-  let pathToMkvmerge = 'C:\\\\Program Files\\\\MKVToolNix\\\\mkvmerge.exe';
-
-  let pathMKVOutput = path.join(pathDownload, videoTitle.concat(dot, extMKV));
-  let pathOutput = path.join(pathDownload, vid.concat(dot, extMKV));
-  let pathInputAudio = path.join(pathDownload, vid.concat(dot, "mp3"));
-  let pathInputVideo = path.join(pathDownload, vid.concat(dot, "mp4"));
-  let pathJsFile = path.join(__filename);
-
-  if (
-    fs.existsSync(pathToMkvmerge)
-  ) {
-
-    console.log('');
-    console.log(['file check ok!', videoTitle].join(' '));
-
-    let cmd_merge = [
-      [pathToMkvmerge].map(v => '"' + v + '"').join(''),
-
-      '-o',
-      [pathOutput]
-        .map(value => '"' + value + '"')
-        .join(' '),
-
-      '--no-video',
-      [pathInputAudio]
-        .map(value => '"' + value + '"')
-        .join(' '),
-
-      '--no-audio',
-      [pathInputVideo]
-        .map(value => '"' + value + '"')
-        .join(' '),
-    ].join(' ');
-
-    console.log('execute script merge ...')
-    console.log(cmd_merge);
-
-    let exec_merge = exec(cmd_merge);
-    exec_merge.stdout.on('data', (data) => {
-      console.log(data);
-    });
-    exec_merge.stderr.on('data', (data) => {
-      console.log('error', data);
-    });
-    exec_merge.stdout.on('close', (data) => {
-      console.log(['merge finish!', videoTitle].join(' '));
-
-      if (true) {
-        console.log('remove inputFile');
-        fs.unlinkSync(pathInputVideo);
-        fs.unlinkSync(pathInputAudio);
-      }
-
-      console.log('rename output mkv video...');
-      fs.renameSync(pathOutput, pathMKVOutput);
-
-      if (playVideoAfterMerged) {
-        console.log('play mkv video...');
-        execSync('"' + pathMKVOutput + '"');
-      }
-
-      if (true) {
-        console.log('remove script file');
-        fs.unlinkSync(pathJsFile);
-      }
-    });
-
-  } else {
-    console.log('pathToMkvmerge error')
-
-  }
-}
-  `;
-}
-
-/**
- *
- * @param videoInfo
- * @param videoInfo.vid{string}
- * @param videoInfo.videoTitle{string}
- * @return {string}
- */
-export function generateMkvScriptForSystemFedora(videoInfo) {
-  // We wrap the Node.js script inside a Linux Shell script block
-  return `#!/usr/bin/env bash
-# This header tells Fedora to treat this file as a runnable bash script
-
-# Open a terminal window if not already running inside one
-if [ -z "$VTE_VERSION" ] && [ -z "$ALACRITTY_WINDOW_ID" ] && [ -z "$KITTY_WINDOW_ID" ] && [ "$1" != "--child" ]; then
-    # Re-run this same script inside a visible terminal window so the user sees progress
-    gnome-terminal -- "$0" --child
-    exit 0
-fi
-
-# Run the embedded Node.js code below
-node << 'EOF'
-const path = require('path');
-const fs = require('fs');
-const { execSync } = require('node:child_process');
-
-let pathDownload = path.join(__dirname);
-let dot = '.';
-let extMKV = 'mkv';
-
-let {vid, videoTitle} = ${JSON.stringify(videoInfo)};
-let playVideoAfterMerged = true;
-let pathToMkvmerge = '/usr/bin/mkvmerge';
-
-let pathMKVOutput = path.join(pathDownload, videoTitle.concat(dot, extMKV));
-let pathOutput = path.join(pathDownload, vid.concat(dot, extMKV));
-let pathInputAudio = path.join(pathDownload, vid.concat(dot, "mp3"));
-let pathInputVideo = path.join(pathDownload, vid.concat(dot, "mp4"));
-
-if (fs.existsSync(pathToMkvmerge)) {
-  console.log('\\nfile check ok! ' + videoTitle);
-
-  let cmd_merge = [
-    '"' + pathToMkvmerge + '"',
-    '-o', '"' + pathOutput + '"',
-    '--no-video', '"' + pathInputAudio + '"',
-    '--no-audio', '"' + pathInputVideo + '"',
-  ].join(' ');
-
-  console.log('execute script merge ...\\n' + cmd_merge);
-
-  try {
-    // Run merge synchronously so stdout pipes directly to the terminal
-    execSync(cmd_merge, { stdio: 'inherit' });
-    console.log('merge finish! ' + videoTitle);
-
-    console.log('remove inputFile');
-    if (fs.existsSync(pathInputVideo)) fs.unlinkSync(pathInputVideo);
-    if (fs.existsSync(pathInputAudio)) fs.unlinkSync(pathInputAudio);
-
-    console.log('rename output mkv video...');
-    fs.renameSync(pathOutput, pathMKVOutput);
-
-    if (playVideoAfterMerged) {
-      console.log('play mkv video...');
-      // xdg-open usually hands off to the player and exits immediately
-      execSync('xdg-open "' + pathMKVOutput + '"');
-    }
-  } catch (err) {
-    console.error('An error occurred during processing:', err.message);
-  }
-} else {
-  console.log('pathToMkvmerge error. run: sudo dnf install mkvtoolnix')
-}
-EOF
-
-# Prevent the terminal window from closing instantly so the user can read messages
-echo ""
-echo "Press Enter to exit and automatically delete this script..."
-read unused_input
-
-# Deletes the shell script file itself after completion
-rm -- "$0"
-`;
-}

package/src/opStorage.js

@@ -1,76 +0,0 @@
-/**
- *
- * @param k{string}
- * @returns {Promise<boolean>}
- */
-export async function stoOpCheck(k) {
-  let key = k.toString();
-
-  let objGet = await browser.storage.local.get(key);
-  let b = objGet.hasOwnProperty(key);
-  return b;
-}
-
-/**
- *
- * @param k{string}
- * @returns {Promise<any|null>}
- */
-export async function stoOpGet(k) {
-  let key = k.toString();
-  let objGet = await browser.storage.local.get(key);
-  let v = objGet[key];
-  return v;
-}
-
-/**
- *
- * @returns {Promise<{[p: string]: any}|null>}
- */
-export async function stoOpGetAll() {
-  return await browser.storage.local.get();
-}
-
-/**
- *
- * @param k{string}
- * @returns {Promise<string[]|null>}
- */
-export async function stoOpQueryStartWith(k) {
-  let objAll = await browser.storage.local.get();
-  let keys = Object.keys(objAll);
-  return keys.filter(value => value.startsWith(k.toString()));
-}
-
-/**
- *
- * @param k{string}
- * @param v{any}
- * @returns {Promise<void>}
- */
-export async function stoOpSet(k, v) {
-  let key = k.toString();
-
-  let objNew = {};
-  objNew[key] = v;
-  await browser.storage.local.set(objNew);
-}
-
-/**
- *
- * @param k{string}
- * @returns {Promise<void>}
- */
-export async function stoOpRem(k) {
-  let key = k.toString();
-  await browser.storage.local.remove(key);
-}
-
-/**
- *
- * @param k{string}
- * @returns {Promise<void>}
- */
-export async function stoOpSetNull(k) {
-  await stoOpSet(k, null);
-}