chore: prepare Firefox release v2.0.3

This commit is contained in:
mirivlad 2026-07-12 22:33:47 +08:00
parent 8315d49a58
commit 39e93e0987
8 changed files with 36 additions and 31 deletions

View File

@ -62,7 +62,7 @@ current GitHub Release:
VERSTAK_BROWSER_ENV=/path/to/.env npm run publish:firefox
```
The first invocation publishes tag `v2.0.2` and bootstraps the
The first invocation publishes tag `v2.0.3` and bootstraps the
`releases/latest/download/updates.json` endpoint. Re-running the command
replaces those two release assets for the same tag.

View File

@ -1,7 +1,7 @@
{
"manifest_version": 3,
"name": "Verstak Bridge",
"version": "2.0.2",
"version": "2.0.3",
"description": "Send pages, selections, links, and files to the local Verstak browser inbox.",
"author": "Verstak",
"homepage_url": "https://git.mirv.top/verstak/verstak-browser-extension",

View File

@ -12,7 +12,7 @@
- Publish repository: `mirivlad/verstak-browser-extension`.
- Firefox addon ID: `verstak-bridge@verstak.app`.
- Initial GitHub release: `v2.0.2`; package and both browser manifests are version `2.0.2`.
- Initial GitHub release: `v2.0.3`; package and both browser manifests are version `2.0.3`.
- Every alpha GitHub release is ordinary/latest, not a prerelease.
- XPI remains Mozilla-signed as an unlisted/self-distributed addon before upload.
- `npm run release:firefox` remains a local sign-and-package action.
@ -41,19 +41,19 @@ Create `scripts/test-firefox-github-release.js` with:
const assert = require('assert');
const release = require('./firefox-github-release');
const version = '2.0.2';
const asset = 'verstak-firefox-2.0.2.xpi';
assert.equal(release.releaseTag(version), 'v2.0.2');
const version = '2.0.3';
const asset = 'verstak-firefox-2.0.3.xpi';
assert.equal(release.releaseTag(version), 'v2.0.3');
assert.equal(
release.releaseAssetURL(version, asset),
'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.2/verstak-firefox-2.0.2.xpi',
'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.3/verstak-firefox-2.0.3.xpi',
);
assert.deepEqual(release.updateManifest('verstak-bridge@verstak.app', version, asset), {
addons: {
'verstak-bridge@verstak.app': {
updates: [{
version: '2.0.2',
update_link: 'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.2/verstak-firefox-2.0.2.xpi',
version: '2.0.3',
update_link: 'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.3/verstak-firefox-2.0.3.xpi',
}],
},
},
@ -246,7 +246,7 @@ Rewrite the Firefox Release README section so it documents:
- `VERSTAK_BROWSER_ENV=/path/to/.env npm run publish:firefox`;
- that signing remains unlisted with Mozilla but distribution and automatic
updates use GitHub Release assets;
- that the first `v2.0.2` publish bootstraps the `latest/download/updates.json`
- that the first `v2.0.3` publish bootstraps the `latest/download/updates.json`
endpoint.
- [ ] **Step 4: Run checks without publishing**
@ -275,12 +275,12 @@ git push origin main
### Task 4: Bootstrap and verify the first public update release
**Files:**
- Generated: `release/firefox/verstak-firefox-2.0.2.xpi` (untracked)
- Generated: `release/firefox/verstak-firefox-2.0.3.xpi` (untracked)
- Generated: `release/firefox/updates.json` (untracked)
**Interfaces:**
- Consumes the Task 3 `npm run publish:firefox` command and valid AMO signing credentials.
- Produces GitHub Release tag `v2.0.2` and public XPI/update-manifest assets.
- Produces GitHub Release tag `v2.0.3` and public XPI/update-manifest assets.
- [ ] **Step 1: Verify release credentials before write operations**
@ -302,20 +302,20 @@ Run:
npm run publish:firefox
```
Expected: Mozilla signing succeeds, GitHub Release `v2.0.2` is latest, and it
contains `verstak-firefox-2.0.2.xpi` plus `updates.json`.
Expected: Mozilla signing succeeds, GitHub Release `v2.0.3` is latest, and it
contains `verstak-firefox-2.0.3.xpi` plus `updates.json`.
- [ ] **Step 3: Verify public delivery**
Run:
```bash
gh release view v2.0.2 --repo mirivlad/verstak-browser-extension --json isLatest,url,assets
gh release view v2.0.3 --repo mirivlad/verstak-browser-extension --json isLatest,url,assets
curl -fsSL https://github.com/mirivlad/verstak-browser-extension/releases/latest/download/updates.json
```
Expected: the release is latest and the JSON contains addon ID
`verstak-bridge@verstak.app`, version `2.0.2`, and the versioned GitHub XPI
`verstak-bridge@verstak.app`, version `2.0.3`, and the versioned GitHub XPI
asset URL.
- [ ] **Step 4: Record release verification without committing assets**

View File

@ -22,10 +22,10 @@ Each release uploads two assets:
- `updates.json`, whose `update_link` points to that same release tag's XPI
asset.
For version `2.0.2`, the versioned link is:
For version `2.0.3`, the versioned link is:
```text
https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.2/verstak-firefox-2.0.2.xpi
https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.3/verstak-firefox-2.0.3.xpi
```
The stable `latest/download` endpoint lets already installed extensions discover
@ -46,10 +46,10 @@ endpoint.
## Bootstrap
There is currently no GitHub Release in this repository. After the code change,
the first `v2.0.2` signed release must be published before shipping a manifest
the first `v2.0.3` signed release must be published before shipping a manifest
that points to `latest/download/updates.json`; until then that URL is a 404.
The current package, Chromium manifest and Firefox manifest all use version
`2.0.2`, so the initial tag and XPI asset name are unambiguous.
`2.0.3`, so the initial tag and XPI asset name are unambiguous.
## Documentation

View File

@ -1,7 +1,7 @@
{
"manifest_version": 2,
"name": "Verstak Bridge",
"version": "2.0.2",
"version": "2.0.3",
"description": "Send pages, selections, links, and files to the local Verstak browser inbox.",
"author": "Verstak",
"homepage_url": "https://github.com/mirivlad/verstak-browser-extension",

4
package-lock.json generated
View File

@ -1,12 +1,12 @@
{
"name": "verstak-browser-extension",
"version": "2.0.2",
"version": "2.0.3",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "verstak-browser-extension",
"version": "2.0.2",
"version": "2.0.3",
"devDependencies": {
"web-ext": "^8.3.0"
}

View File

@ -1,6 +1,6 @@
{
"name": "verstak-browser-extension",
"version": "2.0.2",
"version": "2.0.3",
"private": true,
"description": "Verstak browser capture extension for Chromium and Firefox",
"license": "AGPL-3.0-or-later",

View File

@ -2,27 +2,32 @@
const assert = require('assert');
const fs = require('fs');
const release = require('./firefox-github-release');
const packageManifest = require('../package.json');
const chromiumManifest = require('../chromium/manifest.json');
const firefoxManifest = require('../firefox/manifest.json');
const version = '2.0.2';
const asset = 'verstak-firefox-2.0.2.xpi';
const version = '2.0.3';
const asset = 'verstak-firefox-2.0.3.xpi';
assert.equal(release.releaseTag(version), 'v2.0.2');
assert.equal(packageManifest.version, version);
assert.equal(chromiumManifest.version, version);
assert.equal(firefoxManifest.version, version);
assert.equal(release.releaseTag(version), 'v2.0.3');
assert.equal(
release.releaseAssetURL(version, asset),
'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.2/verstak-firefox-2.0.2.xpi',
'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.3/verstak-firefox-2.0.3.xpi',
);
assert.deepEqual(release.updateManifest('verstak-bridge@verstak.app', version, asset), {
addons: {
'verstak-bridge@verstak.app': {
updates: [{
version: '2.0.2',
update_link: 'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.2/verstak-firefox-2.0.2.xpi',
version: '2.0.3',
update_link: 'https://github.com/mirivlad/verstak-browser-extension/releases/download/v2.0.3/verstak-firefox-2.0.3.xpi',
}],
},
},
});
const firefoxManifest = require('../firefox/manifest.json');
assert.equal(firefoxManifest.homepage_url, 'https://github.com/mirivlad/verstak-browser-extension');
assert.equal(
firefoxManifest.browser_specific_settings.gecko.update_url,