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

package/src/opTab.js

@@ -1,237 +0,0 @@
-/**
- * Enhances a tab object by explicitly attaching its ID to the 'tabId' property.
- *
- * @param {browser.tabs.Tab} tab
- * @returns {browser.tabs.Tab & {tabId: number}|null}
- */
-export function tabOpEnhance(tab) {
-  if (!tab || typeof tab.id !== 'number') return null;
-  return {...tab, tabId: tab.id};
-}
-
-/**
- * Creates a normal tab using a properties object.
- *
- * @param {Object} properties
- * @returns {Promise<browser.tabs.Tab & {tabId: number}>}
- */
-export async function tabOpCreate(properties) {
-  const tab = await browser.tabs.create(properties);
-  return tabOpEnhance(tab);
-}
-
-/**
- * Creates a new tab positioned immediately after a specified existing tab.
- * Does not mutate the original properties object.
- *
- * @param {Object & {tabId?: number}} properties
- * @returns {Promise<browser.tabs.Tab & {tabId: number}>}
- */
-export async function tabOpCreateNear(properties) {
-  // Destructure tabId out to avoid mutating the original properties object
-  const {tabId, ...restProperties} = properties;
-
-  if (tabId) {
-    const tabPrev = await tabOpGet(tabId);
-    if (tabPrev) {
-      Object.assign(restProperties, {
-        index: tabPrev.index + 1,
-        openerTabId: tabPrev.id,
-      });
-    }
-  }
-
-  const tab = await browser.tabs.create(restProperties);
-  return tabOpEnhance(tab);
-}
-
-/**
- * Creates a tab in the background (inactive and muted).
- *
- * @param {Object} properties
- * @returns {Promise<browser.tabs.Tab & {tabId: number}>}
- */
-export async function tabOpCreateActiveFalse(properties) {
-  const mergedProperties = {
-    ...properties,
-    active: false,
-    muted: true,
-  };
-  const tab = await browser.tabs.create(mergedProperties);
-  return tabOpEnhance(tab);
-}
-
-/**
- * Creates a completely new window and returns its initial tab.
- *
- * @param {string} url
- * @returns {Promise<(browser.tabs.Tab & {tabId: number})|undefined>}
- */
-export async function tabOpCreateByWindow(url) {
-  if (typeof url !== 'string') return undefined;
-
-  const window = await browser.windows.create({url});
-  if (window && window.tabs && window.tabs.length > 0) {
-    return tabOpEnhance(window.tabs[0]);
-  }
-  return undefined;
-}
-
-/**
- * Retrieves details about the specified tab.
- *
- * @param {number} tabId
- * @returns {Promise<browser.tabs.Tab>}
- */
-export function tabOpGet(tabId) {
-  return browser.tabs.get(tabId);
-}
-
-/**
- * Retrieves all tabs across all windows.
- *
- * @returns {Promise<browser.tabs.Tab[]>}
- */
-export function tabOpQueryAll() {
-  return browser.tabs.query({});
-}
-
-/**
- * Retrieves an array of tab IDs that match the specified URL pattern.
- *
- * @param {string} urlQuery
- * @returns {Promise<number[]>}
- */
-export async function tabOpQueryUrl(urlQuery) {
-  const tabs = await browser.tabs.query({url: urlQuery});
-  return tabs.map(tab => tab.id);
-}
-
-/**
- * Finds all tabs matching the URL pattern and removes them simultaneously.
- * [Optimization]: browser.tabs.remove accepts an array of numbers, which is
- * significantly faster than looping and awaiting individually.
- *
- * @param {string} urlQuery
- * @returns {Promise<void>}
- */
-export async function tabOpQueryUrlThenRemove(urlQuery) {
-  const ids = await tabOpQueryUrl(urlQuery);
-  if (ids.length > 0) {
-    await browser.tabs.remove(ids);
-  }
-}
-
-/**
- * Reloads the given tab.
- *
- * @param {number} tabId
- * @returns {Promise<void>}
- */
-export function tabOpReload(tabId) {
-  return browser.tabs.reload(tabId);
-}
-
-/**
- * Reloads the given tab, bypassing the local web cache.
- *
- * @param {number} tabId
- * @returns {Promise<void>}
- */
-export function tabOpReloadByPassCacheTrue(tabId) {
-  return browser.tabs.reload(tabId, {bypassCache: true});
-}
-
-/**
- * Closes one or more tabs.
- *
- * @param {number|number[]} tabId
- * @returns {Promise<void>}
- */
-export function tabOpRemove(tabId) {
-  return browser.tabs.remove(tabId);
-}
-
-/**
- * Hides one or more tabs (Firefox specific API).
- *
- * @param {number|number[]} tabId
- * @returns {Promise<number[]>}
- */
-export function tabOpHide(tabId) {
-  return browser.tabs.hide(tabId);
-}
-
-/**
- * Modifies the properties of a tab.
- *
- * @param {number} tabId
- * @param {Object} updateProperties
- * @returns {Promise<browser.tabs.Tab & {tabId: number}>}
- */
-export async function tabOpUpdate(
-    tabId,
-    updateProperties,
-) {
-  const tab = await browser.tabs.update(tabId, updateProperties);
-  return tabOpEnhance(tab);
-}
-
-/**
- * Updates a tab to be inactive and muted.
- *
- * @param {number} tabId
- * @returns {Promise<browser.tabs.Tab & {tabId: number}>}
- */
-export function tabOpUpdateActiveFalse(tabId) {
-  return tabOpUpdate(tabId, {active: false, muted: true});
-}
-
-/**
- * Focuses the window containing the tab, then highlights and activates the tab.
- *
- * @param {number} tabId
- * @returns {Promise<browser.tabs.Tab & {tabId: number}>}
- */
-export async function tabOpFocus(tabId) {
-  const tab = await tabOpGet(tabId);
-  if (!tab || !tab.windowId) throw new Error(`Tab ${tabId} not found.`);
-
-  await browser.windows.update(tab.windowId, {focused: true});
-
-  const tabUpdated = await browser.tabs.update(tabId, {
-    active: true,
-    highlighted: true,
-  });
-
-  return tabOpEnhance(tabUpdated);
-}
-
-/**
- * Injects CSS code into a page.
- * Note: Check manifest version compatibility for 'insertCSS'.
- *
- * @param {number} tabId
- * @param {string} code
- * @returns {Promise<void>}
- */
-export function tabOpInsertCssCode(
-    tabId,
-    code,
-) {
-  return browser.tabs.insertCSS(tabId, {code});
-}
-
-/**
- * Removes CSS code that was previously injected into a page.
- *
- * @param {number} tabId
- * @param {string} code
- * @returns {Promise<void>}
- */
-export function tabOpRemoveCssCode(
-    tabId,
-    code,
-) {
-  return browser.tabs.removeCSS(tabId, {code});
-}

package/src/serviceCommon.js

@@ -1,22 +0,0 @@
-import {browserDownloadByDownlink} from './browserDownload.js';
-import {browserNotificationCreate} from './browserNotification.js';
-
-/**
- * service, download by downlink, if success, notification the filename
- *
- * if failed, nootification the reason, then try download only use downlink
- * @param message
- * @returns {Promise<void>}
- */
-export async function serviceDownloadByDownlink(message) {
-  let {filename, downlink} = message;
-
-  try {
-    await browserDownloadByDownlink(message);
-    await browserNotificationCreate(`downloading! ${filename}`);
-  } catch (e) {
-    await browserNotificationCreate(`reason=${e}`);
-    await browserDownloadByDownlink({downlink});
-  }
-
-}

package/src/serviceFetch.js

@@ -1,65 +0,0 @@
-/**
- *
- * @param serverUrl{string}
- * @param message{{}}
- * @returns {Promise<Response>}
- */
-export async function servicePostJson(
-    serverUrl,
-    message,
-) {
-
-  let body = JSON.stringify(message);
-  const fetchResponse = await fetch(serverUrl, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-    },
-    body: body,
-  });
-
-  return fetchResponse;
-}
-
-/**
- *
- * @param message{ {
- *        downlink:string,
- *        filename:string|null,
- *        rpcsecret:string,
- *        rpcport:string
- *        }}
- * @returns {Promise<Response|null>}
- */
-export async function serviceSendDataToLocalAria2(message) {
-  let {downlink, filename, rpcsecret, rpcport} = message;
-
-  const secret = rpcsecret;
-  const port = rpcport;
-
-  const params = [`token:${secret}`, [downlink]];
-  if (filename) {
-    const options = {
-      out: filename,
-    };
-    params.push(options);
-  }
-
-  const data = {
-    jsonrpc: '2.0',
-    id: 'qwer',
-    method: 'aria2.addUri',
-    params,
-  };
-
-  const response = await fetch(`http://localhost:${port}/jsonrpc`, {
-    method: 'POST',
-    headers: {
-      Accept: 'application/json',
-      'Content-Type': 'application/json;charset=UTF-8',
-    },
-    body: JSON.stringify(data),
-  });
-
-  return response;
-}

package/src/serviceGet.js

@@ -1,31 +0,0 @@
-/**
- *
- * @param url{string}
- * @returns {string}
- */
-export function serviceGetDomainByUrl(url) {
-  let urlWrap = new URL(url);
-  let domain = urlWrap.hostname;
-  return domain;
-}
-
-/**
- * eg 2222_12_25_11h_47m_24s_302
- * @return {string}
- */
-export function serviceGetCurrentDateYYYYMMDDHHMMSS() {
-  let date = new Date();
-  let m = [
-    [date.getFullYear(), ''].join(''),
-    [date.getMonth() + 1, ''].join(''),
-    [date.getDate(), ''].join(''),
-
-    [date.getHours(), 'h'].join(''),
-    [date.getMinutes(), 'm'].join(''),
-    [date.getSeconds(), 's'].join(''),
-    date.getMilliseconds(),
-  ];
-  let r = m.join('_');
-  return r;
-}
-

package/src/serviceOpContent.js

@@ -1,83 +0,0 @@
-import {browserRuntimePlatformInfo} from './browserRuntime.js';
-import {
-  generateMkvScriptForSystemFedora,
-  generateMkvScriptForSystemWindows,
-} from './generate.js';
-
-/**
- * @param   data
- * @returns {Promise<void>}
- */
-export async function serviceCopyContentToClipboard(data) {
-  return await window.navigator.clipboard.writeText(data);
-}
-
-/**
- * Eg: fnName('this is content', 'this is a filename without ext', 'txt')
- *
- * @param {string} content
- * @param {string} filename Eg: abc
- * @param {string} ext      Txt json
- */
-export function serviceSaveContentToLocal(content, filename, ext = 'txt') {
-  const eleBtn = document.createElement('button');
-  eleBtn.addEventListener(
-      'click',
-      function() {
-        const eleA = document.createElement('a');
-
-        const extObj = {
-          txt: 'text/plain',
-          json: 'application/json',
-        };
-        const type = extObj[ext];
-
-        const file = new Blob([content], {type});
-        eleA.href = URL.createObjectURL(file);
-        eleA.download = [filename, ext].join('.');
-        eleA.click();
-        URL.revokeObjectURL(eleA.href);
-      },
-      false,
-  );
-  eleBtn.click();
-  // eleBtn.previousElementSibling
-}
-
-/**
- * Need install nodejs mkvtoolnix
- *
- * @param   message{{               Vid, title,
- *   }}
- * @returns {Promise<void>}
- */
-export async function serviceGenerateMkvToolNixScript({vid, title}) {
-  let message = {vid, title};
-  const platformInfo = await browserRuntimePlatformInfo();
-  if (platformInfo.os === 'win') {
-    let content = generateMkvScriptForSystemWindows(message);
-    serviceSaveContentToLocal(content, title, 'js');
-  }
-  else if (platformInfo.os === 'linux') {
-    let content = generateMkvScriptForSystemFedora(message);
-    serviceSaveContentToLocal(content, title, 'sh');
-  }
-}
-
-/**
- * @param   {string} value -
- * @returns {string}       -
- */
-export function serviceRemoveIllegalWord(value) {
-  if (!value) return '';
-
-  let name = value.trim().split(/\r?\n/).shift();
-
-  name = name.replace(/[\p{P}\p{S}\p{C}]/gu, ' ');
-
-  name = name.replace(/[~"#%&*:<>?/\\{|}]/g, ' ');
-
-  name = name.replace(/[\s\u3000]+/g, ' ').trim();
-
-  return name.replace(/^[-.]+|[-.]+$/g, '');
-}