webext-schema 5.6.1 → 6.0.0

package/modules/browser.js

@@ -428,7 +428,7 @@ export const makeConnection = async (id, info) => {
 /**
  * send message
  * @param {number|string} id - tab ID / extension ID
- * @param {*} msg - message
+ * @param {string|Array|object} msg - message
  * @param {object} opt - options
  * @returns {Promise.<object>} - tabs.sendMessage() | runtime.sendMessage()
  */
@@ -679,7 +679,7 @@ export const getAllStorage = async (area = 'local') => {
 
 /**
  * get storage
- * @param {*} key - key
+ * @param {string|Array|object} key - key
  * @param {string} area - storage area
  * @returns {Promise.<object>} - stored data
  */
@@ -698,7 +698,7 @@ export const getStorage = async (key, area = 'local') => {
 
 /**
  * remove storage
- * @param {*} key - key
+ * @param {string|Array|object} key - key
  * @param {string} area - storage area
  * @returns {Promise.<void>} - void
  */
@@ -814,7 +814,7 @@ export const execScriptToTabs = async (opt = {}) => {
  * execute scripts to tab in order
  * @param {number|Array} tabId - tabId or array of options
  * @param {Array} opts - array of options
- * @returns {Promise.<*>} - result of the last executed script
+ * @returns {Promise.<?Array|boolean>} - result of the last executed script
  */
 export const execScriptsToTabInOrder = async (tabId, opts = []) => {
   const func = [];
@@ -1058,7 +1058,7 @@ export const captureVisibleTab = async (windowId, opt) => {
 
 /**
  * is tab
- * @param {*} tabId - tab ID
+ * @param {number} tabId - tab ID
  * @returns {Promise.<boolean>} - result
  */
 export const isTab = async tabId => {

package/modules/common.js

@@ -9,7 +9,7 @@ const TYPE_TO = -1;
 /**
  * throw error
  * @param {!object} e - Error
- * @throws - Error
+ * @throws {Error} - Error
  */
 export const throwErr = e => {
   throw e;
@@ -27,7 +27,7 @@ export const logErr = e => {
 
 /**
  * log warn
- * @param {*} msg - message
+ * @param {string|object} msg - message
  * @returns {boolean} - false
  */
 export const logWarn = msg => {
@@ -37,8 +37,8 @@ export const logWarn = msg => {
 
 /**
  * log message
- * @param {*} msg - message
- * @returns {*} - message
+ * @param {string|object} msg - message
+ * @returns {string|object} - message
  */
 export const logMsg = msg => {
   msg && console.log(msg);
@@ -47,7 +47,7 @@ export const logMsg = msg => {
 
 /**
  * get type
- * @param {*} o - object to check
+ * @param {object} o - object to check
  * @returns {string} - type of object
  */
 export const getType = o =>
@@ -55,7 +55,7 @@ export const getType = o =>
 
 /**
  * is object, and not an empty object
- * @param {*} o - object to check;
+ * @param {object} o - object to check;
  * @returns {boolean} - result
  */
 export const isObjectNotEmpty = o => {
@@ -65,7 +65,7 @@ export const isObjectNotEmpty = o => {
 
 /**
  * is string
- * @param {*} o - object to check
+ * @param {object} o - object to check
  * @returns {boolean} - result
  */
 export const isString = o => typeof o === 'string' || o instanceof String;

package/modules/schema.js

@@ -23,13 +23,13 @@ export class Schema {
    * @param {...(string|object)} [args] - optional arguments
    *                                      {string} - release channel.
    *                                                 one of "beta", "central",
-   *                                                 "release", "esr", "mail".
+   *                                                 "esr", "mail".
    *                                      {object} - sinon config
    */
   constructor(...args) {
     const [arg1, arg2] = args;
     this.#channel =
-      isString(arg1) && /(?:centra|mai)l|beta|esr|release/.test(arg1)
+      isString(arg1) && /(?:centra|mai)l|beta|esr/.test(arg1)
         ? arg1
         : 'beta';
     this._sandbox =
@@ -48,7 +48,7 @@ export class Schema {
   }
 
   set channel(ch) {
-    if (isString(ch) && /(?:centra|mai)l|beta|esr|release/.test(ch)) {
+    if (isString(ch) && /(?:centra|mai)l|beta|esr/.test(ch)) {
       this.#channel = ch;
     }
   }

package/modules/update.js

@@ -51,9 +51,6 @@ export const getChannelUrl = channel => {
     case 'mail':
       dir = 'comm-central/';
       break;
-    case 'release':
-      dir = 'releases/mozilla-release/';
-      break;
     default:
       dir = 'releases/mozilla-beta/';
   }
@@ -278,7 +275,6 @@ export const updateSchemas = async (cmdOpts = {}) => {
       saveSchemaFile('beta', info),
       saveSchemaFile('central', info),
       saveSchemaFile('esr', info),
-      saveSchemaFile('release', info),
       saveSchemaFile('mail', info)
     );
   }

package/package.json

@@ -19,26 +19,26 @@
   "types": "types/index.d.ts",
   "dependencies": {
     "camelize": "^1.0.1",
-    "commander": "^14.0.0",
-    "decamelize": "^6.0.0",
+    "commander": "^14.0.1",
+    "decamelize": "^6.0.1",
     "json5": "^2.2.3",
     "sinon": "^21.0.0"
   },
   "devDependencies": {
-    "@types/firefox-webext-browser": "^120.0.4",
-    "@types/node": "^24.1.0",
+    "@types/firefox-webext-browser": "^120.0.5",
+    "@types/node": "^24.6.2",
     "@types/sinon": "^17.0.4",
     "c8": "^10.1.3",
-    "eslint": "^9.32.0",
-    "eslint-plugin-jsdoc": "^52.0.2",
-    "eslint-plugin-regexp": "^2.9.1",
-    "eslint-plugin-unicorn": "^60.0.0",
-    "globals": "^16.3.0",
-    "mocha": "^11.7.1",
+    "eslint": "^9.37.0",
+    "eslint-plugin-jsdoc": "^60.8.0",
+    "eslint-plugin-regexp": "^2.10.0",
+    "eslint-plugin-unicorn": "^61.0.2",
+    "globals": "^16.4.0",
+    "mocha": "^11.7.4",
     "neostandard": "^0.12.2",
     "npm-run-all2": "^8.0.4",
-    "typescript": "^5.9.2",
-    "undici": "^7.13.0"
+    "typescript": "^5.9.3",
+    "undici": "^7.16.0"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -55,8 +55,7 @@
     "update:beta": "node index update --channel=beta -i",
     "update:central": "node index update --channel=central -i",
     "update:esr": "node index update --channel=esr -i",
-    "update:mail": "node index update --channel=mail -i",
-    "update:release": "node index update --channel=release -i"
+    "update:mail": "node index update --channel=mail -i"
   },
-  "version": "5.6.1"
+  "version": "6.0.0"
 }

package/schemas/beta/webext.json

@@ -6447,6 +6447,12 @@
                   ],
                   "description": "The tab's new favicon URL. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission."
                 },
+                "groupId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -1,
+                  "description": "The tab's new group ID. $(ref:tabGroups.TAB_GROUP_ID_NONE) (-1) if the tab no longer belongs to a tab group."
+                },
                 "hidden": {
                   "type": "boolean",
                   "optional": true,
@@ -9116,6 +9122,11 @@
               "optional": true,
               "description": "The JavaScript world for a script to execute within. Defaults to \"ISOLATED\"."
             },
+            "cssOrigin": {
+              "$ref": "extensionTypes.CSSOrigin",
+              "optional": true,
+              "description": "The css origin of the stylesheet to inject. Defaults to \"author\"."
+            },
             "cookieStoreId": {
               "choices": [
                 {
@@ -12564,7 +12575,8 @@
             "user",
             "author"
           ],
-          "description": "The origin of the CSS to inject, this affects the cascading order (priority) of the stylesheet."
+          "description": "The origin of the CSS to inject, this affects the cascading order (priority) of the stylesheet.",
+          "preprocess": "stringToLowerCase"
         },
         {
           "id": "InjectDetails",
@@ -12606,6 +12618,7 @@
             "cssOrigin": {
               "$ref": "CSSOrigin",
               "optional": true,
+              "default": "author",
               "description": "The css origin of the stylesheet to inject. Defaults to \"author\"."
             }
           }
@@ -14698,6 +14711,11 @@
                 "$ref": "ExtensionURL"
               }
             },
+            "css_origin": {
+              "$ref": "extensionTypes.CSSOrigin",
+              "default": "author",
+              "optional": true
+            },
             "js": {
               "type": "array",
               "optional": true,
@@ -16600,6 +16618,7 @@
             "aarch64",
             "arm",
             "ppc64",
+            "riscv64",
             "s390x",
             "sparc64",
             "x86-32",
@@ -17632,6 +17651,10 @@
               "items": {
                 "$ref": "manifest.ExtensionURL"
               }
+            },
+            "cssOrigin": {
+              "$ref": "extensionTypes.CSSOrigin",
+              "optional": true
             }
           }
         }
@@ -17889,7 +17912,6 @@
             },
             {
               "name": "getBytesInUse",
-              "unsupported": true,
               "type": "function",
               "description": "Gets the amount of space (in bytes) being used by one or more items.",
               "async": "callback",
@@ -17925,173 +17947,23 @@
               ]
             },
             {
-              "name": "set",
+              "name": "getKeys",
               "type": "function",
-              "description": "Sets multiple items.",
+              "description": "Gets the keys of all items in storage.",
               "async": "callback",
               "parameters": [
-                {
-                  "name": "items",
-                  "type": "object",
-                  "additionalProperties": {
-                    "type": "any"
-                  },
-                  "description": "<p>An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.</p><p>Primitive values such as numbers will serialize as expected. Values with a <code>typeof</code> <code>\"object\"</code> and <code>\"function\"</code> will typically serialize to <code>{}</code>, with the exception of <code>Array</code> (serializes as expected), <code>Date</code>, and <code>Regex</code> (serialize using their <code>String</code> representation).</p>"
-                },
                 {
                   "name": "callback",
                   "type": "function",
-                  "description": "Callback on success, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [],
-                  "optional": true
-                }
-              ]
-            },
-            {
-              "name": "remove",
-              "type": "function",
-              "description": "Removes one or more items from storage.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "keys",
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A single key or a list of keys for items to remove."
-                },
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback on success, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [],
-                  "optional": true
-                }
-              ]
-            },
-            {
-              "name": "clear",
-              "type": "function",
-              "description": "Removes all items from storage.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback on success, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [],
-                  "optional": true
-                }
-              ]
-            }
-          ],
-          "events": [
-            {
-              "name": "onChanged",
-              "type": "function",
-              "description": "Fired when one or more items change.",
-              "parameters": [
-                {
-                  "name": "changes",
-                  "type": "object",
-                  "additionalProperties": {
-                    "$ref": "StorageChange"
-                  },
-                  "description": "Object mapping each key that changed to its corresponding $(ref:storage.StorageChange) for that item."
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "id": "StorageAreaWithUsage",
-          "type": "object",
-          "functions": [
-            {
-              "name": "get",
-              "type": "function",
-              "description": "Gets one or more items from storage.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "keys",
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    },
-                    {
-                      "type": "object",
-                      "description": "Storage items to return in the callback, where the values are replaced with those from storage if they exist.",
-                      "additionalProperties": {
-                        "type": "any"
-                      }
-                    }
-                  ],
-                  "description": "A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object).  An empty list or object will return an empty result object.  Pass in <code>null</code> to get the entire contents of storage.",
-                  "optional": true
-                },
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback with storage items, or on failure (in which case $(ref:runtime.lastError) will be set).",
+                  "description": "Callback with the keys of all items in storage, or on failure (in which case $(ref:runtime.lastError) will be set).",
                   "parameters": [
                     {
-                      "name": "items",
-                      "type": "object",
-                      "additionalProperties": {
-                        "type": "any"
-                      },
-                      "description": "Object with items in their key-value mappings."
-                    }
-                  ]
-                }
-              ]
-            },
-            {
-              "name": "getBytesInUse",
-              "type": "function",
-              "description": "Gets the amount of space (in bytes) being used by one or more items.",
-              "async": "callback",
-              "parameters": [
-                {
-                  "name": "keys",
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
+                      "name": "keys",
                       "type": "array",
                       "items": {
                         "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A single key or list of keys to get the total usage for. An empty list will return 0. Pass in <code>null</code> to get the total usage of all of storage.",
-                  "optional": true
-                },
-                {
-                  "name": "callback",
-                  "type": "function",
-                  "description": "Callback with the amount of space being used by storage, or on failure (in which case $(ref:runtime.lastError) will be set).",
-                  "parameters": [
-                    {
-                      "name": "bytesInUse",
-                      "type": "integer",
-                      "description": "Amount of space being used in storage, in bytes."
+                      },
+                      "description": "The keys of all items in storage."
                     }
                   ]
                 }
@@ -18209,7 +18081,7 @@
       ],
       "properties": {
         "sync": {
-          "$ref": "StorageAreaWithUsage",
+          "$ref": "StorageArea",
           "description": "Items in the <code>sync</code> storage area are synced by the browser.",
           "properties": {
             "QUOTA_BYTES": {
@@ -18263,7 +18135,7 @@
           "allowedContexts": [
             "devtools"
           ],
-          "$ref": "StorageAreaWithUsage",
+          "$ref": "StorageArea",
           "description": "Items in the <code>session</code> storage area are kept in memory, and only until the either browser or extension is closed or reloaded.",
           "properties": {
             "QUOTA_BYTES": {