webext-schema 5.4.2 → 5.5.0

package/modules/browser.js

@@ -39,7 +39,7 @@ export const createBookmark = async opt => {
 /**
  * get bookmark tree node
  * @param {string|Array} [id] - bookmark ID or array of bookmark IDs
- * @returns {Promise.<?Array>} - array of bookmarks.BookmarkTreeNode
+ * @returns {Promise.<?Array.<object>>} - array of bookmarks.BookmarkTreeNode
  */
 export const getBookmarkTreeNode = async id => {
   const isGranted = await isPermissionGranted({
@@ -182,7 +182,7 @@ export const updateCommand = async (id, value = '') => {
 /* contextualIdentities */
 /**
  * get all contextual identities
- * @returns {Promise.<?Array>} - array of contextualIdentities.ContextualIdentity
+ * @returns {Promise.<?Array.<object>>} - array of contextualIdentities.ContextualIdentity
  */
 export const getAllContextualIdentities = async () => {
   const isGranted = await isPermissionGranted({
@@ -219,7 +219,7 @@ export const getContextualId = async cookieStoreId => {
 /* management */
 /**
  * get enabled theme
- * @returns {Promise.<?Array>} - array of management.ExtensionInfo
+ * @returns {Promise.<?Array.<object>>} - array of management.ExtensionInfo
  */
 export const getEnabledTheme = async () => {
   const isGranted = await isPermissionGranted({
@@ -258,7 +258,7 @@ export const getExtensionInfo = async id => {
 
 /**
  * get external extensions
- * @returns {Promise.<?Array|boolean>} - array of management.extensionInfo
+ * @returns {Promise.<?Array.<object>>} - array of management.extensionInfo
  */
 export const getExternalExtensions = async () => {
   const isGranted = await isPermissionGranted({
@@ -469,7 +469,7 @@ export const isScriptingAvailable = async () => {
 /**
  * execute script to tab
  * @param {object} opt - options
- * @returns {Promise.<?Array|boolean>} - array of InjectionResult object
+ * @returns {Promise.<?Array.<object>>} - array of InjectionResult object
  */
 export const executeScriptToTab = async (opt = {}) => {
   const { args, injectImmediately, files, func, target } = opt;
@@ -496,6 +496,32 @@ export const executeScriptToTab = async (opt = {}) => {
 };
 
 /* search */
+/**
+ * search in new tab
+ * @param {string} text - query string
+ * @param {object} opt - create tab options
+ * @returns {Promise.<object>} - tabs.Tab
+ */
+export const searchInNewTab = async (text, opt) => {
+  if (!isString(text)) {
+    throw new TypeError(`Expected String but got ${getType(text)}.`);
+  }
+  const isGranted = await isPermissionGranted({
+    permissions: ['search']
+  });
+  let tab;
+  if (isGranted) {
+    const { search } = browser;
+    const { id: tabId } = await tabs.create(isObjectNotEmpty(opt) ? opt : null);
+    await search.query({
+      tabId,
+      text
+    });
+    tab = await tabs.get(tabId);
+  }
+  return tab ?? null;
+};
+
 /**
  * search with a search engine
  * @param {string} query - search query
@@ -732,7 +758,7 @@ export const duplicateTab = async (tabId, opt) => {
 /**
  * query tabs
  * @param {object} opt - options
- * @returns {Promise.<?Array>} - result
+ * @returns {Promise.<Array.<object>>} - array of tabs.Tab
  */
 export const queryTabs = async opt => {
   const res = await tabs.query(opt);
@@ -852,7 +878,7 @@ export const getActiveTabId = async windowId => {
 /**
  * get all tabs in window
  * @param {number} [windowId] - window ID
- * @returns {Promise.<?Array>} - array of tabs.Tab
+ * @returns {Promise.<Array.<object>>} - array of tabs.Tab
  */
 export const getAllTabsInWindow = async windowId => {
   if (!Number.isInteger(windowId)) {
@@ -868,7 +894,7 @@ export const getAllTabsInWindow = async windowId => {
 /**
  * get highlighted tab
  * @param {number} [windowId] - window ID
- * @returns {Promise.<?Array>} - array of tabs.Tab
+ * @returns {Promise.<Array.<object>>} - array of tabs.Tab
  */
 export const getHighlightedTab = async windowId => {
   if (!Number.isInteger(windowId)) {
@@ -923,7 +949,7 @@ export const highlightTab = async (index, windowId) => {
  * move tab
  * @param {number|Array} tabId - tab ID
  * @param {object} [opt] - options
- * @returns {Promise.<?Array>} - array of tabs.Tab
+ * @returns {Promise.<?Array.<object>>} - array of tabs.Tab
  */
 export const moveTab = async (tabId, opt) => {
   if (!(Array.isArray(tabId) || Number.isInteger(tabId))) {
@@ -1083,7 +1109,7 @@ export const createNewWindow = async opt => {
 /**
  * get all windows
  * @param {boolean} populate - populate tabs
- * @returns {Promise.<Array>} - array of windows.Window
+ * @returns {Promise.<Array.<object>>} - array of windows.Window
  */
 export const getAllNormalWindows = async (populate = false) => {
   const arr = await windows.getAll({

package/modules/schema.js

@@ -55,6 +55,7 @@ export class Schema {
 
   /**
    * get target from namespace key
+   * @private
    * @param {string} key - namespace key
    * @returns {object} - target object
    */
@@ -81,6 +82,7 @@ export class Schema {
 
   /**
    * assign imported values
+   * @private
    * @returns {void}
    */
   _assignImportMap() {
@@ -107,6 +109,7 @@ export class Schema {
 
   /**
    * assign referred values
+   * @private
    * @returns {void}
    */
   _assignRefMap() {
@@ -133,6 +136,7 @@ export class Schema {
 
   /**
    * mock events
+   * @private
    * @param {object} target - target object
    * @param {Array} events - events
    * @returns {object} - target object
@@ -158,6 +162,7 @@ export class Schema {
 
   /**
    * mock functions
+   * @private
    * @param {object} target - target object
    * @param {Array} funcs - functions
    * @returns {object} - target object
@@ -180,6 +185,7 @@ export class Schema {
 
   /**
    * mock properties
+   * @private
    * @param {object} target - target object
    * @param {object} props - properties
    * @param {string} namespace - namespace
@@ -220,6 +226,7 @@ export class Schema {
 
   /**
    * mock types
+   * @private
    * @param {object} target - target object
    * @param {Array} types - types
    * @param {string} namespace - namespace
@@ -257,6 +264,7 @@ export class Schema {
 
   /**
    * parse schema content
+   * @private
    * @returns {object} - schema
    */
   _parseSchemaContent() {
@@ -274,7 +282,7 @@ export class Schema {
   /**
    * get schema
    * @param {string} name - API name or file name
-   * @returns {Array} - schema
+   * @returns {?Array.<object>} - schema
    */
   get(name) {
     if (!isString(name)) {
@@ -304,7 +312,7 @@ export class Schema {
 
   /**
    * list schemas
-   * @returns {Array} - file list
+   * @returns {Array.<string>} - file list
    */
   list() {
     const schemas = this._schema ?? this._parseSchemaContent();

package/modules/update.js

@@ -1,6 +1,7 @@
 /**
  * update.js
  */
+/* eslint-disable no-await-in-loop */
 
 /* api */
 import path from 'node:path';
@@ -108,46 +109,57 @@ export const getFileList = async baseUrl => {
 /**
  * get all schema data
  * @param {string} baseUrl - base URL
- * @returns {Promise.<Array>} - schemas data in array
+ * @param {boolean} info - console info
+ * @returns {Promise.<Array.<object>>} - schemas data in array
  */
-export const getAllSchemaData = async baseUrl => {
+export const getAllSchemaData = async (baseUrl, info) => {
   if (!isString(baseUrl)) {
     throw new TypeError(`Expected String but got ${getType(baseUrl)}.`);
   }
+  const schemas = [];
   const items = await getFileList(baseUrl);
-  const func = [];
   for (const item of items) {
-    func.push(getSchemaData(item, baseUrl));
+    if (info) {
+      console.info(`Fetching ${item}`);
+    }
+    const schema = await getSchemaData(item, baseUrl);
+    schemas.push(schema);
   }
-  return Promise.all(func);
+  return schemas;
 };
 
 /**
  * get listed schema data
  * @param {string} baseUrl - base URL
  * @param {Array} arr - array of schema file names
- * @returns {Promise.<Array>} - schema data in array
+ * @param {boolean} info - console info
+ * @returns {Promise.<Array.<object>>} - schema data in array
  */
-export const getListedSchemaData = async (baseUrl, arr) => {
+export const getListedSchemaData = async (baseUrl, arr, info) => {
   if (!isString(baseUrl)) {
     throw new TypeError(`Expected String but got ${getType(baseUrl)}.`);
   }
   if (!Array.isArray(arr)) {
     throw new TypeError(`Expected Array but got ${getType(arr)}.`);
   }
-  const func = [];
+  const schemas = [];
   for (const item of arr) {
-    func.push(getSchemaData(item, baseUrl));
+    if (info) {
+      console.info(`Fetching ${item}`);
+    }
+    const schema = await getSchemaData(item, baseUrl);
+    schemas.push(schema);
   }
-  return Promise.all(func);
+  return schemas;
 };
 
 /**
  * get MailExtensions schema data
  * @param {string} baseUrl - base URL
- * @returns {Promise.<Array>} - results of each handler
+ * @param {boolean} info - console info
+ * @returns {Promise.<Array.<object>>} - results of each handler
  */
-export const getMailExtSchemaData = async baseUrl => {
+export const getMailExtSchemaData = async (baseUrl, info) => {
   if (!isString(baseUrl)) {
     throw new TypeError(`Expected String but got ${getType(baseUrl)}.`);
   }
@@ -157,19 +169,26 @@ export const getMailExtSchemaData = async baseUrl => {
     'commands.json',
     'pkcs11.json'
   ];
-  const func = [];
+  const schemas = [];
   for (const item of items) {
-    !excludeFile.includes(item) && func.push(getSchemaData(item, schemaUrl));
+    if (!excludeFile.includes(item)) {
+      if (info) {
+        console.info(`Fetching ${item}`);
+      }
+      const schema = await getSchemaData(item, schemaUrl);
+      schemas.push(schema);
+    }
   }
-  return Promise.all(func);
+  return schemas;
 };
 
 /**
  * create unified schema
  * @param {string} channel - release channel
+ * @param {boolean} info - console info
  * @returns {Promise.<object>} - schema
  */
-export const createUnifiedSchema = async channel => {
+export const createUnifiedSchema = async (channel, info) => {
   const channelUrl = getChannelUrl(channel);
   const schema = {};
   let arr;
@@ -187,14 +206,16 @@ export const createUnifiedSchema = async channel => {
     const toolkitBaseUrl =
       `${getChannelUrl('central')}toolkit/components/extensions/schemas/`;
     arr = await Promise.all([
-      getListedSchemaData(browserBaseUrl, browserItems),
-      getListedSchemaData(toolkitBaseUrl, toolkitItems),
-      getMailExtSchemaData(`${channelUrl}mail/components/extensions/`)
+      getListedSchemaData(browserBaseUrl, browserItems, info),
+      getListedSchemaData(toolkitBaseUrl, toolkitItems, info),
+      getMailExtSchemaData(`${channelUrl}mail/components/extensions/`, info)
     ]);
   } else {
     arr = await Promise.all([
-      getAllSchemaData(`${channelUrl}browser/components/extensions/schemas/`),
-      getAllSchemaData(`${channelUrl}toolkit/components/extensions/schemas/`)
+      getAllSchemaData(`${channelUrl}browser/components/extensions/schemas/`,
+        info),
+      getAllSchemaData(`${channelUrl}toolkit/components/extensions/schemas/`,
+        info)
     ]);
   }
   for (const items of arr) {
@@ -216,7 +237,7 @@ export const saveSchemaFile = async (channel, info) => {
   if (!isString(channel)) {
     throw new TypeError(`Expected String but got ${getType(channel)}.`);
   }
-  const schema = await createUnifiedSchema(channel);
+  const schema = await createUnifiedSchema(channel, info);
   const content = `${JSON.stringify(schema, null, INDENT)}\n`;
   const fileName = channel === 'mail' ? 'mailext' : 'webext';
   const filePath =

package/package.json

@@ -21,20 +21,21 @@
   },
   "devDependencies": {
     "@types/firefox-webext-browser": "^120.0.4",
-    "@types/node": "^22.5.5",
+    "@types/node": "^22.8.2",
     "@types/sinon": "^17.0.3",
     "c8": "^10.1.2",
-    "chai": "^5.1.1",
-    "eslint": "^8.57.0",
-    "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.30.0",
-    "eslint-plugin-jsdoc": "^50.2.4",
+    "chai": "^5.1.2",
+    "eslint": "^9.13.0",
+    "eslint-plugin-import-x": "^4.3.1",
+    "eslint-plugin-jsdoc": "^50.4.3",
     "eslint-plugin-regexp": "^2.6.0",
-    "eslint-plugin-unicorn": "^55.0.0",
+    "eslint-plugin-unicorn": "^56.0.0",
+    "globals": "^15.11.0",
     "mocha": "^10.7.3",
-    "npm-run-all": "^4.1.5",
-    "typescript": "^5.6.2",
-    "undici": "^6.19.8"
+    "neostandard": "^0.11.7",
+    "npm-run-all2": "^7.0.1",
+    "typescript": "^5.6.3",
+    "undici": "^6.20.1"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -54,5 +55,5 @@
     "update-mail": "node index update --channel=mail -i",
     "update-release": "node index update --channel=release -i"
   },
-  "version": "5.4.2"
+  "version": "5.5.0"
 }

package/schemas/beta/webext.json

@@ -9085,6 +9085,11 @@
               "type": "string",
               "optional": true,
               "description": "The first-party URL of the cookie, if the cookie is in storage partitioned by the top-level site."
+            },
+            "hasCrossSiteAncestor": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether or not the cookie is in a third-party context, respecting ancestor chains."
             }
           }
         },
@@ -12439,7 +12444,8 @@
             "responsiveness",
             "cpufreq",
             "bandwidth",
-            "memory"
+            "memory",
+            "tracing"
           ]
         },
         {
@@ -17703,64 +17709,6 @@
     {
       "namespace": "manifest",
       "types": [
-        {
-          "$extend": "WebExtensionManifest",
-          "properties": {
-            "telemetry": {
-              "type": "object",
-              "optional": true,
-              "additionalProperties": {
-                "$ref": "UnrecognizedProperty"
-              },
-              "properties": {
-                "ping_type": {
-                  "type": "string"
-                },
-                "schemaNamespace": {
-                  "type": "string"
-                },
-                "public_key": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string"
-                    },
-                    "key": {
-                      "type": "object",
-                      "properties": {
-                        "crv": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "kty": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "x": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "y": {
-                          "type": "string",
-                          "optional": "false"
-                        }
-                      }
-                    }
-                  }
-                },
-                "study_name": {
-                  "type": "string",
-                  "optional": true
-                },
-                "pioneer_id": {
-                  "type": "boolean",
-                  "optional": true,
-                  "default": false
-                }
-              }
-            }
-          }
-        },
         {
           "$extend": "PermissionPrivileged",
           "choices": [
@@ -17917,39 +17865,6 @@
             }
           ]
         },
-        {
-          "name": "submitEncryptedPing",
-          "type": "function",
-          "description": "Submits a custom ping to the Telemetry back-end, with an encrypted payload. Requires a telemetry entry in the manifest to be used.",
-          "parameters": [
-            {
-              "name": "message",
-              "type": "object",
-              "additionalProperties": {
-                "type": "any"
-              },
-              "description": "The data payload for the ping, which will be encrypted."
-            },
-            {
-              "description": "Options object.",
-              "name": "options",
-              "type": "object",
-              "properties": {
-                "schemaName": {
-                  "type": "string",
-                  "optional": false,
-                  "description": "Schema name used for payload."
-                },
-                "schemaVersion": {
-                  "type": "integer",
-                  "optional": false,
-                  "description": "Schema version used for payload."
-                }
-              }
-            }
-          ],
-          "async": true
-        },
         {
           "name": "canUpload",
           "type": "function",
@@ -18118,6 +18033,7 @@
         },
         {
           "name": "recordEvent",
+          "deprecated": "`recordEvent` is a no-op since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Record an event in Telemetry. Throws when trying to record an unknown event.",
           "async": true,
@@ -18177,6 +18093,7 @@
         },
         {
           "name": "registerEvents",
+          "deprecated": "`registerEvents` is a no-op since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Register new events to record them from addons. See nsITelemetry.idl for more details.",
           "async": true,
@@ -18198,8 +18115,9 @@
         },
         {
           "name": "setEventRecordingEnabled",
+          "deprecated": "`setEventRecordingEnabled` is a no-op since Firefox 133 (see bug 1920562)",
           "type": "function",
-          "description": "Enable recording of events in a category. Events default to recording disabled. This allows to toggle recording for all events in the specified category.",
+          "description": "Enable recording of events in a category. Events default to recording enabled. This allows to toggle recording for all events in the specified category.",
           "async": true,
           "parameters": [
             {

package/schemas/central/webext.json

@@ -9085,6 +9085,11 @@
               "type": "string",
               "optional": true,
               "description": "The first-party URL of the cookie, if the cookie is in storage partitioned by the top-level site."
+            },
+            "hasCrossSiteAncestor": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether or not the cookie is in a third-party context, respecting ancestor chains."
             }
           }
         },
@@ -12439,7 +12444,8 @@
             "responsiveness",
             "cpufreq",
             "bandwidth",
-            "memory"
+            "memory",
+            "tracing"
           ]
         },
         {
@@ -18027,7 +18033,7 @@
         },
         {
           "name": "recordEvent",
-          "deprecated": "`recordEvent` has been deprecated since Firefox 132 (see bug 1894533)",
+          "deprecated": "`recordEvent` is a no-op since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Record an event in Telemetry. Throws when trying to record an unknown event.",
           "async": true,
@@ -18087,7 +18093,7 @@
         },
         {
           "name": "registerEvents",
-          "deprecated": "`registerEvents` has been deprecated since Firefox 132 (see bug 1894533)",
+          "deprecated": "`registerEvents` is a no-op since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Register new events to record them from addons. See nsITelemetry.idl for more details.",
           "async": true,
@@ -18109,8 +18115,9 @@
         },
         {
           "name": "setEventRecordingEnabled",
+          "deprecated": "`setEventRecordingEnabled` is a no-op since Firefox 133 (see bug 1920562)",
           "type": "function",
-          "description": "Enable recording of events in a category. Events default to recording disabled. This allows to toggle recording for all events in the specified category.",
+          "description": "Enable recording of events in a category. Events default to recording enabled. This allows to toggle recording for all events in the specified category.",
           "async": true,
           "parameters": [
             {

package/schemas/mail/mailext.json

@@ -8631,7 +8631,7 @@
                 "STORAGE",
                 "MESSAGE"
               ],
-              "description": "The type of the quota as defined by RFC2087. A <var>STORAGE</var> quota is constraining the available storage in bytes, a <var>MESSAGE</var> quota is constraining the number of storable messages."
+              "description": "The type of the quota as defined by RFC 2087. A <var>STORAGE</var> quota is constraining the available storage in bytes, a <var>MESSAGE</var> quota is constraining the number of storable messages."
             },
             "limit": {
               "type": "integer",
@@ -10611,7 +10611,7 @@
         {
           "name": "getSelectedFolders",
           "type": "function",
-          "description": "Lists the selected folders in the folder pane.",
+          "description": "Lists the selected folders in the folder pane. Does not include folders which are context-clicked, but not selected. The context-clicked folders are always returned by the $(ref:menus.onClicked) event of the menus API.",
           "permissions": [
             "accountsRead"
           ],
@@ -10642,7 +10642,7 @@
         {
           "name": "getSelectedMessages",
           "type": "function",
-          "description": "Lists the selected messages in the current folder.",
+          "description": "Lists the selected messages in the current folder. Includes messages in collapsed threads. Does not include messages which are context-clicked, but not selected. The context-clicked messages are always returned by the $(ref:menus.onClicked) event of the menus API.",
           "permissions": [
             "messagesRead"
           ],
@@ -10670,7 +10670,7 @@
         {
           "name": "setSelectedMessages",
           "type": "function",
-          "description": "Selects none, one or multiple messages.",
+          "description": "Selects none, one or multiple messages. Opens collapsed threads to show the selection, if required.",
           "permissions": [
             "messagesRead",
             "accountsRead"
@@ -12886,7 +12886,7 @@
           "properties": {
             "body": {
               "type": "string",
-              "description": "The content of the part.",
+              "description": "The quoted-printable or base64 decoded content of the part. Only present for parts with a content type of <var>text/*</var> and only if requested, see the <var>decodeContent</var> option of $(ref:messages.getFull). Use $(ref:messages.getAttachmentFile) to retrieve the content of parts which have a content type other than <var>text/*</var>.",
               "optional": true
             },
             "contentType": {
@@ -12906,7 +12906,7 @@
             },
             "headers": {
               "type": "object",
-              "description": "A <em>dictionary object</em> of part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>.",
+              "description": "A <em>dictionary object</em> of RFC 2047 decoded part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>. Only present if requested, see the <var>decodeHeaders</var> option of $(ref:messages.getFull).",
               "optional": true,
               "additionalProperties": {
                 "type": "array",
@@ -12933,6 +12933,22 @@
               "description": "Any sub-parts of this part.",
               "optional": true
             },
+            "rawBody": {
+              "type": "string",
+              "description": "The raw content of the part. Only present if requested, see the <var>decodeContent</var> option of $(ref:messages.getFull).",
+              "optional": true
+            },
+            "rawHeaders": {
+              "type": "object",
+              "description": "A <em>dictionary object</em> of raw part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>. Only present if requested, see the <var>decodeHeaders</var> option of $(ref:messages.getFull).",
+              "optional": true,
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
             "size": {
               "type": "integer",
               "optional": true,
@@ -13252,7 +13268,17 @@
               "properties": {
                 "decrypt": {
                   "type": "boolean",
-                  "description": "Whether the message should be decrypted. If the message could not be decrypted, its parts are omitted. Defaults to true.",
+                  "description": "Whether the message should be decrypted. If the message could not be decrypted, its parts are omitted. Defaults to <var>true</var>.",
+                  "optional": true
+                },
+                "decodeHeaders": {
+                  "type": "boolean",
+                  "description": "Whether to decode RFC 2047 encoded headers of message parts. Defaults to <var>true</var>. **Note:** Automatic decoding of headers containing a list of comma separated mailbox strings can have unwanted side effects. Example: <literalinclude>includes/messages/badHeader.js<lang>JavaScript</lang></literalinclude>",
+                  "optional": true
+                },
+                "decodeContent": {
+                  "type": "boolean",
+                  "description": "Whether to decode quoted-printable or base64 encoded content of message parts. Defaults to <var>true</var>.",
                   "optional": true
                 }
               },
@@ -13273,12 +13299,20 @@
         {
           "name": "getRaw",
           "type": "function",
-          "description": "Returns the unmodified source of a message. Throws if the message could not be read, for example due to network issues.",
+          "description": "Returns the raw content of a message. Throws if the message could not be read, for example due to network issues.",
           "async": "callback",
           "parameters": [
             {
-              "name": "messageId",
-              "$ref": "messages.MessageId"
+              "name": "message",
+              "description": "Either a $(ref:messages.MessageId) of an existing message, or a $(ref:messages.MessagePart) with raw header and raw content data representing a full RFC 822 message (the provided data will be used as-is without applying any further encoding). See the <var>decodeHeaders</var> and <var>decodeContent</var> options of $(ref:messages.getFull) for further details on how to retrieve a $(ref:messages.MessagePart) with raw values. You can use $(ref:messengerUtilities.decodeMimeHeader) and $(ref:messengerUtilities.encodeMimeHeader) to manipulate a raw MessagePart.",
+              "choices": [
+                {
+                  "$ref": "messages.MessageId"
+                },
+                {
+                  "$ref": "messages.MessagePart"
+                }
+              ]
             },
             {
               "name": "options",
@@ -13399,7 +13433,7 @@
             {
               "name": "partName",
               "type": "string",
-              "pattern": "^\\d+(\\.\\d+)*$"
+              "pattern": "^\\d+(\\.\\d+\\$?)*$"
             },
             {
               "type": "function",
@@ -13829,7 +13863,7 @@
           "name": "import",
           "type": "function",
           "max_manifest_version": 2,
-          "description": "Imports a message into a local Thunderbird folder. To import a message into an IMAP folder, add it to a local folder first and then move it to the IMAP folder.",
+          "description": "Imports a message into a folder. Supports local folders, POP and IMAP folders. Throws, if the destination folder already contains a message with the Message-ID of the message being imported.",
           "async": "callback",
           "permissions": [
             "accountsRead",
@@ -13876,7 +13910,7 @@
           "name": "import",
           "type": "function",
           "min_manifest_version": 3,
-          "description": "Imports a message into a local Thunderbird folder. To import a message into an IMAP folder, add it to a local folder first and then move it to the IMAP folder.",
+          "description": "Imports a message into a folder. Supports local folders, POP and IMAP folders. Throws, if the destination folder already contains a message with the Message-ID of the message being imported.",
           "async": "callback",
           "permissions": [
             "accountsRead",
@@ -15841,6 +15875,31 @@
               "description": "The members of the group, if available."
             }
           }
+        },
+        {
+          "id": "MailboxHeaders",
+          "type": "string",
+          "description": "MIME headers, which by default are treated as containing one or more mailbox strings.",
+          "enum": [
+            "bcc",
+            "cc",
+            "from",
+            "reply-to",
+            "resent-bcc",
+            "resent-cc",
+            "resent-from",
+            "resent-reply-to",
+            "resent-sender",
+            "resent-to",
+            "sender",
+            "to",
+            "approved",
+            "disposition-notification-to",
+            "delivered-to",
+            "return-receipt-to",
+            "mail-reply-to",
+            "mail-followup-to"
+          ]
         }
       ],
       "functions": [
@@ -15933,6 +15992,96 @@
               ]
             }
           ]
+        },
+        {
+          "name": "decodeMimeHeader",
+          "type": "function",
+          "description": "Decode the provided header into a readable format according to RFC 2047.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "headerName",
+              "type": "string"
+            },
+            {
+              "name": "headerValue",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "name": "isMailBoxHeader",
+              "type": "boolean",
+              "optional": true,
+              "description": "Headers containing multiple mailbox strings need special handling. For example the header <var>=?UTF-8?Q?H=C3=B6rst=2C_Kenny?= <K.Hoerst@invalid>, new@thunderbird.bug</var> will be wrongly decoded to <var>Hörst, Kenny <K.Hoerst@invalid>, new@thunderbird.bug</var>, corrupting the structure of the first mailbox string. This option overrides the default behavior of treating the headers defined in $(ref:messengerUtilities.MailboxHeaders) as mailbox headers."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "encodeMimeHeader",
+          "type": "function",
+          "description": "Encode the provided header according to RFC 2047.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "headerName",
+              "type": "string"
+            },
+            {
+              "name": "headerValue",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "name": "isMailBoxHeader",
+              "type": "boolean",
+              "optional": true,
+              "description": "Headers containing multiple mailbox strings need special handling. This option overrides the default behavior of treating the headers defined in $(ref:messengerUtilities.MailboxHeaders) as mailbox headers."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          ]
         }
       ]
     }
@@ -16260,7 +16409,7 @@
                 "allowScriptsToClose": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Allow scripts running inside the window to close the window by calling <code>window.close()</code>."
+                  "description": "Allow scripts running inside the window to close the window by calling <code>window.close()</code>. Defaults to <var>true</var> when the given URL points to an extension page (a page included with this extension and loaded with the <var>moz-extension:</var> protocol), defaults to <var>false</var> otherwise."
                 },
                 "cookieStoreId": {
                   "type": "string",

package/schemas/release/webext.json

@@ -4445,7 +4445,7 @@
             },
             "openerTabId": {
               "type": "integer",
-              "minimum": 0,
+              "minimum": -1,
               "optional": true,
               "description": "The ID of the tab that opened this tab, if any. This property is only present if the opener tab still exists."
             },
@@ -4989,7 +4989,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as the newly created tab."
                 },
@@ -5203,7 +5203,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
                 },
@@ -5353,7 +5353,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
                 },
@@ -9085,6 +9085,11 @@
               "type": "string",
               "optional": true,
               "description": "The first-party URL of the cookie, if the cookie is in storage partitioned by the top-level site."
+            },
+            "hasCrossSiteAncestor": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether or not the cookie is in a third-party context, respecting ancestor chains."
             }
           }
         },
@@ -17437,7 +17442,7 @@
           ]
         },
         {
-          "id": "StorageAreaSync",
+          "id": "StorageAreaWithUsage",
           "type": "object",
           "functions": [
             {
@@ -17634,7 +17639,7 @@
       ],
       "properties": {
         "sync": {
-          "$ref": "StorageAreaSync",
+          "$ref": "StorageAreaWithUsage",
           "description": "Items in the <code>sync</code> storage area are synced by the browser.",
           "properties": {
             "QUOTA_BYTES": {
@@ -17688,8 +17693,13 @@
           "allowedContexts": [
             "devtools"
           ],
-          "$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."
+          "$ref": "StorageAreaWithUsage",
+          "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": {
+              "description": "The maximum amount of data (in bytes, currently at 10MB) that can be stored in session storage, as measured by the StructuredCloneHolder of every value plus every key's length."
+            }
+          }
         }
       }
     }
@@ -17698,64 +17708,6 @@
     {
       "namespace": "manifest",
       "types": [
-        {
-          "$extend": "WebExtensionManifest",
-          "properties": {
-            "telemetry": {
-              "type": "object",
-              "optional": true,
-              "additionalProperties": {
-                "$ref": "UnrecognizedProperty"
-              },
-              "properties": {
-                "ping_type": {
-                  "type": "string"
-                },
-                "schemaNamespace": {
-                  "type": "string"
-                },
-                "public_key": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string"
-                    },
-                    "key": {
-                      "type": "object",
-                      "properties": {
-                        "crv": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "kty": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "x": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "y": {
-                          "type": "string",
-                          "optional": "false"
-                        }
-                      }
-                    }
-                  }
-                },
-                "study_name": {
-                  "type": "string",
-                  "optional": true
-                },
-                "pioneer_id": {
-                  "type": "boolean",
-                  "optional": true,
-                  "default": false
-                }
-              }
-            }
-          }
-        },
         {
           "$extend": "PermissionPrivileged",
           "choices": [
@@ -17912,39 +17864,6 @@
             }
           ]
         },
-        {
-          "name": "submitEncryptedPing",
-          "type": "function",
-          "description": "Submits a custom ping to the Telemetry back-end, with an encrypted payload. Requires a telemetry entry in the manifest to be used.",
-          "parameters": [
-            {
-              "name": "message",
-              "type": "object",
-              "additionalProperties": {
-                "type": "any"
-              },
-              "description": "The data payload for the ping, which will be encrypted."
-            },
-            {
-              "description": "Options object.",
-              "name": "options",
-              "type": "object",
-              "properties": {
-                "schemaName": {
-                  "type": "string",
-                  "optional": false,
-                  "description": "Schema name used for payload."
-                },
-                "schemaVersion": {
-                  "type": "integer",
-                  "optional": false,
-                  "description": "Schema version used for payload."
-                }
-              }
-            }
-          ],
-          "async": true
-        },
         {
           "name": "canUpload",
           "type": "function",
@@ -18113,6 +18032,7 @@
         },
         {
           "name": "recordEvent",
+          "deprecated": "`recordEvent` has been deprecated since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Record an event in Telemetry. Throws when trying to record an unknown event.",
           "async": true,
@@ -18172,6 +18092,7 @@
         },
         {
           "name": "registerEvents",
+          "deprecated": "`registerEvents` has been deprecated since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Register new events to record them from addons. See nsITelemetry.idl for more details.",
           "async": true,

package/tsconfig.json

@@ -12,5 +12,8 @@
     "resolveJsonModule": true,
     "target": "esnext"
   },
-  "include": ["index.js", "modules/browser.js"]
+  "include": [
+    "index.js",
+    "modules/browser.js"
+  ]
 }

package/types/modules/browser.d.ts

@@ -1,17 +1,17 @@
 export function isPermissionGranted(perm: object): Promise<boolean>;
 export function createBookmark(opt: object): Promise<object>;
-export function getBookmarkTreeNode(id?: string | any[]): Promise<any[] | null>;
+export function getBookmarkTreeNode(id?: string | any[]): Promise<Array<object> | null>;
 export function getCloseTabsByDoubleClickValue(): Promise<object>;
 export function setContextMenuOnMouseup(): Promise<boolean>;
 export function clearContextMenuOnMouseup(): Promise<boolean>;
 export function getNewTabPositionValue(): Promise<object>;
 export function isCommandCustomizable(): Promise<boolean>;
 export function updateCommand(id: string, value?: string): Promise<void | null>;
-export function getAllContextualIdentities(): Promise<any[] | null>;
+export function getAllContextualIdentities(): Promise<Array<object> | null>;
 export function getContextualId(cookieStoreId: string): Promise<object>;
-export function getEnabledTheme(): Promise<any[] | null>;
+export function getEnabledTheme(): Promise<Array<object> | null>;
 export function getExtensionInfo(id: string): Promise<object>;
-export function getExternalExtensions(): Promise<(any[] | boolean) | null>;
+export function getExternalExtensions(): Promise<Array<object> | null>;
 export function clearNotification(id: string): Promise<boolean | null>;
 export function createNotification(id: string, opt: object): Promise<string | null>;
 export function removePermission(perm: string | any[]): Promise<boolean>;
@@ -22,7 +22,8 @@ export function getOs(): Promise<string>;
 export function makeConnection(id?: number | string, info?: object | boolean): Promise<object>;
 export function sendMessage(id: number | string, msg: any, opt: object): Promise<object>;
 export function isScriptingAvailable(): Promise<boolean>;
-export function executeScriptToTab(opt?: object): Promise<(any[] | boolean) | null>;
+export function executeScriptToTab(opt?: object): Promise<Array<object> | null>;
+export function searchInNewTab(text: string, opt: object): Promise<object>;
 export function searchWithSearchEngine(query: string, opt?: object): Promise<void>;
 export function getRecentlyClosedTab(windowId?: number): Promise<object>;
 export function getSessionWindowValue(key: string, windowId?: number): Promise<string | null>;
@@ -35,17 +36,17 @@ export function removeStorage(key: any, area?: string): Promise<void>;
 export function setStorage(obj: object, area?: string): Promise<void>;
 export function createTab(opt?: object): Promise<object>;
 export function duplicateTab(tabId: number, opt: object): Promise<object>;
-export function queryTabs(opt: object): Promise<any[] | null>;
+export function queryTabs(opt: object): Promise<Array<object>>;
 export function execScriptToTab(tabId: number | object, opt?: object): Promise<(any[] | boolean) | null>;
 export function execScriptToTabs(opt?: object): Promise<any[]>;
 export function execScriptsToTabInOrder(tabId: number | any[], opts?: any[]): Promise<any>;
 export function getActiveTab(windowId?: number): Promise<object>;
 export function getActiveTabId(windowId?: number): Promise<number | null>;
-export function getAllTabsInWindow(windowId?: number): Promise<any[] | null>;
-export function getHighlightedTab(windowId?: number): Promise<any[] | null>;
+export function getAllTabsInWindow(windowId?: number): Promise<Array<object>>;
+export function getHighlightedTab(windowId?: number): Promise<Array<object>>;
 export function getTab(tabId: number): Promise<object>;
 export function highlightTab(index: number | any[], windowId?: number): Promise<object>;
-export function moveTab(tabId: number | any[], opt?: object): Promise<any[] | null>;
+export function moveTab(tabId: number | any[], opt?: object): Promise<Array<object> | null>;
 export function reloadTab(tabId: number, opt: object): Promise<void>;
 export function removeTab(arg: number | any[]): Promise<void>;
 export function updateTab(tabId: number, opt: object): Promise<object>;
@@ -54,7 +55,7 @@ export function captureVisibleTab(windowId: number, opt: object): Promise<string
 export function isTab(tabId: any): Promise<boolean>;
 export function getCurrentTheme(windowId?: number): Promise<object>;
 export function createNewWindow(opt: object): Promise<object>;
-export function getAllNormalWindows(populate?: boolean): Promise<any[]>;
+export function getAllNormalWindows(populate?: boolean): Promise<Array<object>>;
 export function getCurrentWindow(opt: object): Promise<object>;
 export function getWindow(windowId: number, opt: object): Promise<object>;
 export function checkIncognitoWindowExists(): Promise<boolean>;

package/types/modules/schema.d.ts

@@ -9,17 +9,17 @@ export class Schema {
     _schema: any;
     set channel(ch: any);
     get channel(): any;
-    _getTargetFromNamespace(key: string): object;
-    _assignImportMap(): void;
-    _assignRefMap(): void;
-    _mockEvents(target: object, events: any[]): object;
-    _mockFunctions(target: object, funcs: any[]): object;
-    _mockProperties(target: object, props: object, namespace: string): object;
-    _mockTypes(target: object, types: any[], namespace: string): object;
-    _parseSchemaContent(): object;
-    get(name: string): any[];
+    private _getTargetFromNamespace;
+    private _assignImportMap;
+    private _assignRefMap;
+    private _mockEvents;
+    private _mockFunctions;
+    private _mockProperties;
+    private _mockTypes;
+    private _parseSchemaContent;
+    get(name: string): Array<object> | null;
     getAll(): object;
-    list(): any[];
+    list(): Array<string>;
     mock(): object;
     #private;
 }

package/types/modules/update.d.ts

@@ -3,9 +3,9 @@ export function fetchText(url: string): Promise<string>;
 export function getChannelUrl(channel: string): string;
 export function getSchemaData(file: string, baseUrl: string): Promise<object>;
 export function getFileList(baseUrl: string): Promise<Array<string>>;
-export function getAllSchemaData(baseUrl: string): Promise<any[]>;
-export function getListedSchemaData(baseUrl: string, arr: any[]): Promise<any[]>;
-export function getMailExtSchemaData(baseUrl: string): Promise<any[]>;
-export function createUnifiedSchema(channel: string): Promise<object>;
+export function getAllSchemaData(baseUrl: string, info: boolean): Promise<Array<object>>;
+export function getListedSchemaData(baseUrl: string, arr: any[], info: boolean): Promise<Array<object>>;
+export function getMailExtSchemaData(baseUrl: string, info: boolean): Promise<Array<object>>;
+export function createUnifiedSchema(channel: string, info: boolean): Promise<object>;
 export function saveSchemaFile(channel: string, info: boolean): Promise<string>;
 export function updateSchemas(cmdOpts?: object): Promise<void>;