Compile the code of the extension:

npm run build:chrome

Bundle and sign the Chrome extension:

This command creates the folder `dist` with both the unpacked and packed (.crx) Chrome extension.

This extension requires the [webRequestBlocking](https://developer.chrome.com/docs/extensions/reference/api/webRequest) permission, which in turn requires of an [Enterprise policy](https://support.google.com/chrome/a/answer/187202?hl=en) to be configured on Chrome.

Follow these steps to configure Chrome with such a policy and force it to install the extension locally.

First, run in another terminal:

npm run start:config

This starts a server at http://localhost:8000 for installing extension locally.

Then, copy the policy file in the correspondent system path:

On Linux:

cp policy/policy.json /etc/opt/chrome/policies/managed/policy.json

On MacOS:

cp policy/com.google.Chrome.managed.plist /Library/Managed\ Preferences/

You can confirm the policy is installed by navigating to [chrome://policy/](chrome://policy/) and make sure to reload the policies.

"version": "0.2.0",

"build:chrome": "tsup src/background.ts --format esm --platform browser --target chrome100 --clean --out-dir dist/mv3/chromium --external node:crypto",

"bundle:chrome": "npm run build:chrome && node ./scripts/build_web_artifacts.mjs",

"start:config": "http-server ./dist/web-ext-artifacts -p 8000",

"test": "echo \"Error: no test specified\" && exit 1",

"clean": "rimraf dist"

"rimraf": "6.0.1",

<key>********************************</key>

"********************************": {

import ChromeExtension from "crx";

import * as fs from "node:fs";

import path from "node:path";

const { KeyObject } = await import("node:crypto");

const { subtle } = globalThis.crypto;

import pkg from '../package.json' with { type: "json" };

function makePolicy(extensionID) {

const MarkerString = "********************************";

const policyPath = path.join(path.dirname("."), "policy");

if (!fs.existsSync(policyPath)) {

fs.mkdirSync(policyPath, { recursive: true });

}

for (let fileName of ["com.google.Chrome.managed.plist", "policy.json"]) {

const template = fs.readFileSync(

path.join(policyPath, fileName + ".templ"),

"utf8"

);

const fileContent = template.split(MarkerString).join(extensionID);

fs.writeFileSync(path.join(policyPath, fileName), fileContent);

}

function setManifestVersion(version) {

const manifestInputPath = path.join(path.dirname("."), "platform", "mv3", "chromium", 'manifest.json');

const manifestOutputPath = path.join(path.dirname("."), "dist", "mv3", "chromium", 'manifest.json');

const manifestStr = fs.readFileSync(manifestInputPath, "utf8");

const manifest = JSON.parse(manifestStr);

manifest.version = version;

fs.writeFileSync(manifestOutputPath, JSON.stringify(manifest, null, 2));

(async function main() {

const distPath = path.join(path.dirname("."), "dist", "web-ext-artifacts");

if (!fs.existsSync(distPath)) {

fs.mkdirSync(distPath, { recursive: true });

}

const { privateKey, publicKey } = await subtle.generateKey(

{

name: "RSASSA-PKCS1-v1_5",

modulusLength: 2048,

publicExponent: Uint8Array.from([1, 0, 1]),

hash: "SHA-256",

},

true,

["sign", "verify"]

);

const skPEM = KeyObject.from(privateKey).export({

type: "pkcs8",

format: "pem",

});

const pkBytes = KeyObject.from(publicKey).export({

type: "pkcs1",

format: "der",

});

const crx = new ChromeExtension({

codebase: "http://localhost:8000/" + pkg.name + '.crx',

privateKey: skPEM,

publicKey: pkBytes,

});

setManifestVersion(pkg.version);

await crx.load(path.join(path.dirname("."), "dist", "mv3", "chromium"))

const extensionBytes = await crx.pack();

const extensionID = crx.generateAppId();

fs.writeFileSync("private_key.pem", skPEM);

fs.writeFileSync(path.join(distPath, pkg.name + '.crx'), extensionBytes);

fs.writeFileSync(path.join(distPath, "update.xml"), crx.generateUpdateXML());

makePolicy(extensionID);

console.log(`Build Extension with ID: ${extensionID}`)