semantic-release-amo

A semantic-release plugin to publish Firefox add-ons to AMO (addons.mozilla.org).

Motivation

semantic-release-firefox-add-on is a great plugin to publish Firefox add-ons to AMO. However, it does not support submitting source code.

This plugin makes it possible to submit source code by using API V5.

Usage

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    [
      "semantic-release-amo",
      {
        "addonId": "my-addon-id",
        "addonDirPath": "dist",
        "approvalNotes": "To build this add-on, please run `yarn && yarn build`",
        "submitSource": true
      }
    ]
  ]
}

Steps

Step	Description
verifyConditions	Verify the environment variables and the options.
prepare	Update manifest.json and archive the add-on.
publish	Publish the add-on to AMO.

Environment variables

Variable	Description
AMO_API_KEY	REQUIRED The API key to publish the add-on to AMO.
AMO_API_SECRET	REQUIRED The API secret to publish the add-on to AMO.
AMO_BASE_URL	The base URL of AMO. Defaults to https://addons.mozilla.org/.

Options

Option	Description
addonId	REQUIRED The id of the add-on. Can be either a slug or a GUID.
addonDirPath	REQUIRED The path of the directory containing the add-on.
addonZipPath	The path of the zip file to archive the add-on. Defaults to "./semantic-release-amo/${nextRelease.version}.zip".
channel	The channel to publish the add-on. Can be either "listed" or "unlisted". Defaults to "listed".
approvalNotes	The notes for the Mozilla reviewers.
compatibility	The applications that the add-on is compatible with. Can be an array of "firefox" or "android". Defaults to ["firefox"].
submitReleaseNotes	Whether to submit the release notes typically generated by @semantic-release/release-notes-generator. Defaults to false.
submitSource	Whether to submit the source code archived by git archive. Defaults to false.

Exported function

updateAddon

import { updateAddon } from 'semantic-release-amo/update-addon';

await updateAddon({
  apiKey: '...',
  apiSecret: '...',
  baseURL: 'https://addons.mozilla.org/', // optional, defaults to 'https://addons.mozilla.org/'
  addonId: '...',
  addonZipPath: await generateAddonZip(),
  channel: 'listed', // optional, defaults to 'listed'
  approvalNotes: '...', // optional
  compatibility: ['firefox'], // optional, defaults to ['firefox']
  releaseNotes: '...', // optional
  sourceZipPath: await generateSourceZip(), // optional
  logger: console, // optional, defaults to console
});

Author

iorate (Twitter)

License

semantic-release-amo is licensed under MIT License.