webext-schema 7.1.0 → 7.1.1

package/.prettierignore

@@ -0,0 +1,8 @@
+**/.next
+**/.nx/cache
+**/.svelte-kit
+**/build
+**/coverage
+**/dist
+**/docs
+**/codemods/**/__testfixtures__

package/SECURITY.md

@@ -4,13 +4,7 @@ We take security vulnerabilities seriously. Thank you for improving the security
 
 ## Supported Versions
 
-The following versions of this project are currently supported with security updates:
-
-| Version | Supported          |
-| ------- | ------------------ |
-| 7.x.x   | :white_check_mark: |
-| 6.x.x   | :white_check_mark: |
-| < 6.0.0 | :x:                |
+We currently provide security updates **only for the latest major release**.
 
 ## Reporting a Vulnerability
 

package/eslint.config.mjs

@@ -1,15 +1,20 @@
 import jsdoc from 'eslint-plugin-jsdoc';
+import prettierRecommended from 'eslint-plugin-prettier/recommended';
 import regexp from 'eslint-plugin-regexp';
 import unicorn from 'eslint-plugin-unicorn';
 import globals from 'globals';
-import neostandard, { plugins as neostdplugins } from 'neostandard';
+import neostandard from 'neostandard';
 
 export default [
   ...neostandard({
-    semi: true
+    noStyle: true
   }),
   jsdoc.configs['flat/recommended'],
   regexp.configs['flat/recommended'],
+  prettierRecommended,
+  {
+    ignores: ['test/file/']
+  },
   {
     languageOptions: {
       globals: {
@@ -22,23 +27,32 @@ export default [
       reportUnusedDisableDirectives: true
     },
     plugins: {
-      '@stylistic': neostdplugins['@stylistic'],
       regexp,
       unicorn
     },
+    settings: {
+      jsdoc: {
+        mode: 'typescript'
+      }
+    },
     rules: {
-      '@stylistic/space-before-function-paren': ['error', {
-        anonymous: 'always',
-        asyncArrow: 'always',
-        named: 'never'
-      }],
+      curly: ['error', 'all'],
+      'jsdoc/no-undefined-types': [
+        'error',
+        {
+          definedTypes: ['ReadonlyArray']
+        }
+      ],
       'no-await-in-loop': 'error',
-      'no-use-before-define': ['error', {
-        allowNamedExports: false,
-        classes: true,
-        functions: true,
-        variables: true
-      }],
+      'no-use-before-define': [
+        'error',
+        {
+          allowNamedExports: false,
+          classes: true,
+          functions: true,
+          variables: true
+        }
+      ],
       'prefer-object-has-own': 'error',
       'unicorn/prefer-node-protocol': 'error'
     }

package/modules/browser.js

@@ -34,7 +34,7 @@ const getType = o =>
  */
 const isObjectNotEmpty = o => {
   const items = /Object/i.test(getType(o)) && Object.keys(o);
-  return !!(items?.length);
+  return !!items?.length;
 };
 
 /**
@@ -106,7 +106,9 @@ export const getCloseTabsByDoubleClickValue = async () => {
   });
   let userValue;
   if (isGranted) {
-    const { browserSettings: { closeTabsByDoubleClick } } = browser;
+    const {
+      browserSettings: { closeTabsByDoubleClick }
+    } = browser;
     userValue = await closeTabsByDoubleClick.get({});
   }
   return userValue ?? null;
@@ -122,7 +124,9 @@ export const setContextMenuOnMouseup = async () => {
   });
   let res;
   if (isGranted) {
-    const { browserSettings: { contextMenuShowEvent } } = browser;
+    const {
+      browserSettings: { contextMenuShowEvent }
+    } = browser;
     const { levelOfControl, value } = await contextMenuShowEvent.get({});
     if (value === 'mouseup') {
       res = true;
@@ -145,7 +149,9 @@ export const clearContextMenuOnMouseup = async () => {
   });
   let res;
   if (isGranted) {
-    const { browserSettings: { contextMenuShowEvent } } = browser;
+    const {
+      browserSettings: { contextMenuShowEvent }
+    } = browser;
     res = await contextMenuShowEvent.clear({});
   }
   return !!res;
@@ -161,7 +167,9 @@ export const getNewTabPositionValue = async () => {
   });
   let res;
   if (isGranted) {
-    const { browserSettings: { newTabPosition } } = browser;
+    const {
+      browserSettings: { newTabPosition }
+    } = browser;
     res = await newTabPosition.get({});
   }
   return res ?? null;
@@ -179,8 +187,9 @@ export const isCommandCustomizable = async () => {
   let bool;
   if (isGranted) {
     const { commands } = browser;
-    bool = typeof commands.update === 'function' &&
-           typeof commands.reset === 'function';
+    bool =
+      typeof commands.update === 'function' &&
+      typeof commands.reset === 'function';
   }
   return !!bool;
 };
@@ -201,11 +210,16 @@ export const updateCommand = async (id, value = '') => {
   let func;
   if (await isCommandCustomizable()) {
     const { commands } = browser;
-    const shortcut =
-      value.trim().replace(/\+([a-z])$/, (m, c) => `+${c.toUpperCase()}`);
+    const shortcut = value
+      .trim()
+      .replace(/\+([a-z])$/, (m, c) => `+${c.toUpperCase()}`);
     if (shortcut === '') {
       func = commands.reset(id);
-    } else if (/^(?:(?:Alt|Command|(?:Mac)?Ctrl)(?:\+Shift)?|Alt\+(?:Command|(?:Mac)?Ctrl)|Command\+(?:Alt|MacCtrl)|Ctrl\+(?:Alt|MacCtrl)|MacCtrl\+(?:Alt|Command|Ctrl))\+[\dA-Z]|F[1-9]|Media(?:(?:Next|Prev)Track|PlayPause|Stop)$/.test(shortcut)) {
+    } else if (
+      /^(?:(?:Alt|Command|(?:Mac)?Ctrl)(?:\+Shift)?|Alt\+(?:Command|(?:Mac)?Ctrl)|Command\+(?:Alt|MacCtrl)|Ctrl\+(?:Alt|MacCtrl)|MacCtrl\+(?:Alt|Command|Ctrl))\+[\dA-Z]|F[1-9]|Media(?:(?:Next|Prev)Track|PlayPause|Stop)$/.test(
+        shortcut
+      )
+    ) {
       func = commands.update({
         shortcut,
         name: id
@@ -1063,19 +1077,24 @@ export const warmupTab = async tabId => {
 export const captureVisibleTab = async (windowId, opt) => {
   const info = await runtime.getBrowserInfo();
   let isGranted;
-  if (info.vender === 'Mozilla') {
+  if (info.vendor === 'Mozilla') {
     const browserVersion = parseFloat(info.version);
-    isGranted = (browserVersion >= 126 && await isPermissionGranted({
-      permissions: ['activeTab']
-    })) || await isPermissionGranted({
-      origins: ['<all_urls>']
-    });
+    isGranted =
+      (browserVersion >= 126 &&
+        (await isPermissionGranted({
+          permissions: ['activeTab']
+        }))) ||
+      (await isPermissionGranted({
+        origins: ['<all_urls>']
+      }));
   } else {
-    isGranted = await isPermissionGranted({
-      permissions: ['activeTab']
-    }) || await isPermissionGranted({
-      origins: ['<all_urls>']
-    });
+    isGranted =
+      (await isPermissionGranted({
+        permissions: ['activeTab']
+      })) ||
+      (await isPermissionGranted({
+        origins: ['<all_urls>']
+      }));
   }
   let url;
   if (isGranted) {
@@ -1125,8 +1144,9 @@ export const getCurrentTheme = async windowId => {
   let currentTheme;
   if (isGranted) {
     const { theme } = browser;
-    currentTheme =
-      await theme.getCurrent(Number.isInteger(windowId) ? windowId : null);
+    currentTheme = await theme.getCurrent(
+      Number.isInteger(windowId) ? windowId : null
+    );
   }
   return currentTheme ?? null;
 };

package/modules/commander.js

@@ -38,13 +38,18 @@ export const parseCommand = args => {
     commander.exitOverride();
     commander.version(process.env.npm_package_version, '-v, --version');
     if (args.includes('clean') || args.includes('c')) {
-      commander.command('clean').alias('c')
+      commander
+        .command('clean')
+        .alias('c')
         .description('clean directory')
         .option('-d, --dir <name>', 'specify directory')
         .option('-i, --info', 'console info')
         .action(cleanDirectory);
     } else if (args.includes('update') || args.includes('u')) {
-      commander.command('update').alias('u').description('update schemas')
+      commander
+        .command('update')
+        .alias('u')
+        .description('update schemas')
         .option('-c, --channel <name>', 'specify the release channel')
         .option('-i, --info', 'console info')
         .action(updateSchemas);
@@ -54,6 +59,4 @@ export const parseCommand = args => {
 };
 
 /* For test */
-export {
-  commander
-};
+export { commander };

package/modules/common.js

@@ -60,7 +60,7 @@ export const getType = o =>
  */
 export const isObjectNotEmpty = o => {
   const items = /Object/i.test(getType(o)) && Object.keys(o);
-  return !!(items?.length);
+  return !!items?.length;
 };
 
 /**

package/modules/file-util.js

@@ -94,8 +94,9 @@ export const isExecutable = (file, mask = MASK_BIT) => {
   let res;
   const stat = getStat(file);
   if (stat) {
-    res = !!(stat.mode & mask) ||
-          (IS_WIN && /\.(?:bat|cmd|exe|ps1|wsh)$/i.test(file));
+    res =
+      !!(stat.mode & mask) ||
+      (IS_WIN && /\.(?:bat|cmd|exe|ps1|wsh)$/i.test(file));
   }
   return !!res;
 };
@@ -118,8 +119,11 @@ export const getFileTimestamp = file => {
  */
 export const getFileNameFromFilePath = (file, subst = SUBST) => {
   let name;
-  if (isString(file) && isFile(file) &&
-      /^[^.]+(?:\..+)?$/.test(path.basename(file))) {
+  if (
+    isString(file) &&
+    isFile(file) &&
+    /^[^.]+(?:\..+)?$/.test(path.basename(file))
+  ) {
     [, name] = /^([^.]+)(?:\..+)?$/.exec(path.basename(file));
   }
   return name || subst;
@@ -179,7 +183,7 @@ export const createDirectory = async (dir, mode = PERM_DIR) => {
     mode,
     recursive: true
   };
-  !isDir(dirPath) && await fsPromise.mkdir(dirPath, opt);
+  !isDir(dirPath) && (await fsPromise.mkdir(dirPath, opt));
   return dirPath;
 };
 
@@ -193,14 +197,23 @@ export const createDirectory = async (dir, mode = PERM_DIR) => {
  * @param {number|string} [opt.mode] - file permission
  * @returns {Promise.<string>} - file path
  */
-export const createFile = async (file, value, opt = {
-  encoding: null, flag: 'w', mode: PERM_FILE
-}) => {
+export const createFile = async (
+  file,
+  value,
+  opt = {
+    encoding: null,
+    flag: 'w',
+    mode: PERM_FILE
+  }
+) => {
   if (!isString(file)) {
     throw new TypeError(`Expected String but got ${getType(file)}.`);
   }
-  if (!isString(value) && !Buffer.isBuffer(value) &&
-      !(value instanceof Uint8Array)) {
+  if (
+    !isString(value) &&
+    !Buffer.isBuffer(value) &&
+    !(value instanceof Uint8Array)
+  ) {
     throw new TypeError(
       `Expected String, Buffer, Uint8Array but got ${getType(value)}.`
     );

package/modules/schema.js

@@ -28,9 +28,7 @@ export class Schema {
   constructor(...args) {
     const [arg1, arg2] = args;
     this.#channel =
-      isString(arg1) && /^(?:central|mail)$/.test(arg1)
-        ? arg1
-        : 'beta';
+      isString(arg1) && /^(?:central|mail)$/.test(arg1) ? arg1 : 'beta';
     this._sandbox =
       (isObjectNotEmpty(arg1) && sinon.createSandbox(arg1)) ||
       (isObjectNotEmpty(arg2) && sinon.createSandbox(arg2)) ||
@@ -209,12 +207,18 @@ export class Schema {
           target[key] = item.value;
         } else if (type === 'function') {
           target[key] = this._sandbox.stub();
-        } else if (type === 'object' || $ref ||
-                   Object.hasOwn(item, 'properties')) {
+        } else if (
+          type === 'object' ||
+          $ref ||
+          Object.hasOwn(item, 'properties')
+        ) {
           target[key] ??= {};
-          properties && this._mockProperties(
-            target[key], properties, `${namespace}.${key}`
-          );
+          properties &&
+            this._mockProperties(
+              target[key],
+              properties,
+              `${namespace}.${key}`
+            );
         } else {
           target[key] = null;
         }
@@ -339,14 +343,17 @@ export class Schema {
     for (const [key, value] of schemaItems) {
       const items = Object.values(value);
       for (const item of items) {
-        const {
-          $import, events, functions, namespace, properties, types
-        } = item;
+        const { $import, events, functions, namespace, properties, types } =
+          item;
         const fileKey = camelize(key.replace(/\.json$/, '')).toLowerCase();
         const itemKey = namespace.replace(/\./g, '').toLowerCase();
-        if (fileKey === itemKey || fileKey.startsWith(itemKey) ||
-            itemKey.startsWith(fileKey) || aliasKeys.includes(itemKey) ||
-            $import) {
+        if (
+          fileKey === itemKey ||
+          fileKey.startsWith(itemKey) ||
+          itemKey.startsWith(fileKey) ||
+          aliasKeys.includes(itemKey) ||
+          $import
+        ) {
           const mapKey = [];
           let ns;
           if (namespace.includes('.')) {

package/modules/update.js

@@ -50,7 +50,7 @@ export const getChannelUrl = channel => {
     default:
       dir = 'releases/mozilla-beta/';
   }
-  return `https://hg.mozilla.org/${dir}raw-file/tip/`;
+  return `https://hg-edge.mozilla.org/${dir}raw-file/tip/`;
 };
 
 /**
@@ -70,7 +70,8 @@ export const getSchemaData = async (file, baseUrl) => {
   const text = await fetchText(href);
   const schema = JSON5.parse(text);
   return {
-    file, schema
+    file,
+    schema
   };
 };
 
@@ -158,10 +159,7 @@ export const getMailExtSchemaData = async (baseUrl, info) => {
   }
   const items = await getFileList(baseUrl);
   const schemaUrl = `${baseUrl}schemas/`;
-  const excludeFile = [
-    'commands.json',
-    'pkcs11.json'
-  ];
+  const excludeFile = ['commands.json', 'pkcs11.json'];
   const schemas = [];
   for (const item of items) {
     if (!excludeFile.includes(item)) {
@@ -185,26 +183,33 @@ export const createUnifiedSchema = async (channel, info) => {
   const channelUrl = getChannelUrl(channel);
   const schema = {};
   if (channel === 'mail') {
-    const browserItems = [
-      'commands.json',
-      'pkcs11.json'
-    ];
-    const browserUrl =
-      `${getChannelUrl('central')}browser/components/extensions/schemas/`;
-    const browserSchemas =
-      await getListedSchemaData(browserUrl, browserItems, info);
+    const browserItems = ['commands.json', 'pkcs11.json'];
+    const browserUrl = `${getChannelUrl('central')}browser/components/extensions/schemas/`;
+    const browserSchemas = await getListedSchemaData(
+      browserUrl,
+      browserItems,
+      info
+    );
     for (const item of browserSchemas) {
       const { file, schema: itemSchema } = item;
       schema[file] = itemSchema;
     }
     const toolkitItems = [
-      'content_scripts.json', 'experiments.json', 'extension.json', 'i18n.json',
-      'management.json', 'permissions.json', 'runtime.json', 'theme.json'
+      'content_scripts.json',
+      'experiments.json',
+      'extension.json',
+      'i18n.json',
+      'management.json',
+      'permissions.json',
+      'runtime.json',
+      'theme.json'
     ];
-    const toolkitUrl =
-      `${getChannelUrl('central')}toolkit/components/extensions/schemas/`;
-    const toolkitSchemas =
-      await getListedSchemaData(toolkitUrl, toolkitItems, info);
+    const toolkitUrl = `${getChannelUrl('central')}toolkit/components/extensions/schemas/`;
+    const toolkitSchemas = await getListedSchemaData(
+      toolkitUrl,
+      toolkitItems,
+      info
+    );
     for (const item of toolkitSchemas) {
       const { file, schema: itemSchema } = item;
       schema[file] = itemSchema;
@@ -245,10 +250,16 @@ export const saveSchemaFile = async (channel, info) => {
   const schema = await createUnifiedSchema(channel, info);
   const content = `${JSON.stringify(schema, null, INDENT)}\n`;
   const fileName = channel === 'mail' ? 'mailext' : 'webext';
-  const filePath =
-    path.resolve(DIR_CWD, 'schemas', channel, `${fileName}.json`);
+  const filePath = path.resolve(
+    DIR_CWD,
+    'schemas',
+    channel,
+    `${fileName}.json`
+  );
   const file = await createFile(filePath, content, {
-    encoding: CHAR, flag: 'w', mode: PERM_FILE
+    encoding: CHAR,
+    flag: 'w',
+    mode: PERM_FILE
   });
   if (file && info) {
     console.info(`Created: ${file}`);

package/package.json

@@ -25,32 +25,23 @@
     "sinon": "^22.1.0"
   },
   "devDependencies": {
-    "@types/firefox-webext-browser": "^143.0.0",
-    "@types/node": "^26.1.1",
+    "@types/firefox-webext-browser": "^143.0.1",
+    "@types/node": "^26.6.4",
     "@types/sinon": "^22.0.0",
     "c8": "^12.0.0",
-    "eslint": "^9.39.5",
-    "eslint-plugin-jsdoc": "^63.2.2",
-    "eslint-plugin-regexp": "^3.1.1",
-    "eslint-plugin-unicorn": "^64.0.0",
-    "globals": "^17.7.0",
-    "mocha": "^11.7.6",
-    "neostandard": "^0.13.0",
+    "eslint": "^10.12.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-jsdoc": "^65.2.1",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-regexp": "^3.3.1",
+    "eslint-plugin-unicorn": "^77.0.0",
+    "globals": "^17.13.0",
+    "mocha": "^12.0.3",
+    "neostandard": "^0.14.0",
+    "prettier": "^3.9.9",
+    "prettier-plugin-brace-style": "^0.10.3",
     "typescript": "^7.0.2",
-    "undici": "^8.9.0"
-  },
-  "overrides": {
-    "c8": {
-      "yargs": "^18.0.0"
-    },
-    "eslint": {
-      "js-yaml": "^4.3.0"
-    },
-    "mocha": {
-      "diff": "^8.0.3",
-      "js-yaml": "^4.3.0"
-    },
-    "serialize-javascript": "^7.0.4"
+    "undici": "^8.11.2"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -66,5 +57,5 @@
     "update:central": "node index update --channel=central -i",
     "update:mail": "node index update --channel=mail -i"
   },
-  "version": "7.1.0"
+  "version": "7.1.1"
 }

package/prettier.config.mjs

@@ -0,0 +1,14 @@
+export default {
+  plugins: ['prettier-plugin-brace-style'],
+  arrowParens: 'avoid',
+  braceStyle: '1tbs',
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'none',
+  overrides: [
+    {
+      files: ['*.md', '*.mdx'],
+      options: {}
+    }
+  ]
+};