creative-upload-extension-updater 0.1.1 → 0.1.2

package/README.md

@@ -5,7 +5,7 @@ macOS Native Messaging updater for the unpacked Creative Upload Chrome extension
 ## First installation
 
 ```bash
-npm install -g creative-upload-extension-updater
+npm install -g @ttam/creative-upload-extension-updater
 creative-upload-extension-updater install
 ```
 
@@ -20,13 +20,14 @@ The extension ID is fixed to `amfhocfbdlbooohhoinhhhgobfdmaljc`. Do not change t
 creative-upload-extension-updater diagnose
 creative-upload-extension-updater update
 creative-upload-extension-updater rollback
+creative-upload-updater uninstall
+creative-upload-updater uninstall --purge
 ```
 
-`creative-upload-updater` is kept as a shorter command alias. Both commands
-run the same updater and are supported for backward compatibility.
-
 `update` immediately checks the Registry and applies a newer verified release when available. On macOS it then opens a controlled extension URL so the running extension calls `chrome.runtime.reload()` automatically; pass `--no-reload` to only replace files. `rollback` restores the previous verified extension directory. Chrome must then reload the extension once.
 
+`uninstall` removes the Native Messaging registration and updater configuration but retains the downloaded extension. `uninstall --purge` additionally deletes the extension and rollback files. Both modes require manually removing the loaded extension in `chrome://extensions`; uninstall the CLI itself with `npm uninstall -g creative-upload-extension-updater`.
+
 ## Security
 
 The updater accepts only the configured Registry URL, checks the release SHA256, verifies the detached Ed25519 signature, and verifies the manifest version and fixed Extension ID before replacing files. HTTP is a temporary internal-network transport exception; the signing private key is never stored in this package or in the Registry.

package/bin/creative-upload-extension-updater.js

@@ -1,7 +1,21 @@
 #!/usr/bin/env node
 const fs = require('node:fs');
 const path = require('node:path');
-const { diagnose, install, requestChromeReload, rollback, update, TRANSITION_HTTP_REGISTRY_ORIGIN } = require('../lib/updater');
+const { diagnose, install, requestChromeReload, rollback, uninstall, update, TRANSITION_HTTP_REGISTRY_ORIGIN } = require('../lib/updater');
+
+const packageVersion = require('../package.json').version;
+const usage = `用法：creative-upload-updater <命令> [选项]
+
+命令：
+  install [--registry <url>] [--allow-insecure]  安装更新器与首次插件版本
+  update [--no-reload]                           下载并应用最新插件版本
+  diagnose                                       输出本机安装诊断
+  rollback                                       回滚到上一插件版本
+  uninstall [--purge]                            移除更新器注册；--purge 同时删除插件文件
+
+选项：
+  --help, -h       显示帮助
+  --version, -v    显示版本`;
 
 const parseArguments = (values) =>
   values.reduce((result, value, index) => {
@@ -15,6 +29,14 @@ const parseArguments = (values) =>
 const main = async () => {
   const [command] = process.argv.slice(2);
   const args = parseArguments(process.argv.slice(3));
+  if (!command || command === '--help' || command === '-h' || args.help === true) {
+    process.stdout.write(`${usage}\n`);
+    return;
+  }
+  if (command === '--version' || command === '-v' || args.version === true) {
+    process.stdout.write(`${packageVersion}\n`);
+    return;
+  }
   if (command === 'install') {
     const publicKey =
       typeof args['public-key'] === 'string'
@@ -40,9 +62,8 @@ const main = async () => {
     return process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   }
   if (command === 'rollback') return process.stdout.write(`${JSON.stringify(rollback(), null, 2)}\n`);
-  throw new Error(
-    '用法：creative-upload-extension-updater install [--registry <url>] [--allow-insecure] | update [--no-reload] | diagnose | rollback。默认使用当前 Devbox 过渡地址。',
-  );
+  if (command === 'uninstall') return process.stdout.write(`${JSON.stringify(uninstall({ purge: args.purge === true }), null, 2)}\n`);
+  throw new Error(`未知命令：${command}\n\n${usage}`);
 };
 
 main().catch((error) => {

package/lib/updater.js

@@ -16,6 +16,15 @@ const configPath = path.join(baseDirectory, 'updater.json');
 const extensionDirectory = path.join(baseDirectory, 'extension');
 const previousDirectory = path.join(baseDirectory, 'previous');
 const nativeHostLauncherPath = path.join(baseDirectory, 'native-host');
+const nativeHostManifestPath = path.join(
+  os.homedir(),
+  'Library',
+  'Application Support',
+  'Google',
+  'Chrome',
+  'NativeMessagingHosts',
+  `${HOST_NAME}.json`,
+);
 
 const readConfig = () => {
   if (!fs.existsSync(configPath)) throw new Error('更新器尚未安装。请运行 creative-upload-extension-updater install。');
@@ -148,12 +157,26 @@ const install = async ({ registryUrl = TRANSITION_HTTP_REGISTRY_ORIGIN, extensio
   const config = { registryUrl: registryUrl.replace(/\/$/, ''), extensionId, signingPublicKey: publicKey, allowInsecure };
   writeConfig(config);
   const update = await checkAndUpdate({ extensionId, currentVersion: '0.0.0' });
-  const manifestDirectory = path.join(os.homedir(), 'Library', 'Application Support', 'Google', 'Chrome', 'NativeMessagingHosts');
+  const manifestDirectory = path.dirname(nativeHostManifestPath);
   fs.mkdirSync(manifestDirectory, { recursive: true, mode: 0o700 });
   const launcherPath = installNativeHostLauncher(hostPath);
-  fs.writeFileSync(path.join(manifestDirectory, `${HOST_NAME}.json`), `${JSON.stringify({ name: HOST_NAME, description: 'Creative Upload Extension Updater', path: launcherPath, type: 'stdio', allowed_origins: [`chrome-extension://${extensionId}/`] }, null, 2)}\n`, { mode: 0o600 });
+  fs.writeFileSync(nativeHostManifestPath, `${JSON.stringify({ name: HOST_NAME, description: 'Creative Upload Extension Updater', path: launcherPath, type: 'stdio', allowed_origins: [`chrome-extension://${extensionId}/`] }, null, 2)}\n`, { mode: 0o600 });
   return { ...update, extensionDirectory, extensionId };
 };
+const uninstall = ({ purge = false } = {}) => {
+  const nativeHostRegistered = fs.existsSync(nativeHostManifestPath);
+  fs.rmSync(nativeHostManifestPath, { force: true });
+  fs.rmSync(configPath, { force: true });
+  fs.rmSync(nativeHostLauncherPath, { force: true });
+  if (purge) fs.rmSync(baseDirectory, { recursive: true, force: true });
+  return {
+    nativeHostRemoved: nativeHostRegistered,
+    extensionDirectory,
+    extensionRetained: !purge && fs.existsSync(extensionDirectory),
+    purged: purge,
+    chromeAction: '请在 chrome://extensions 手动移除已加载的扩展。',
+  };
+};
 const rollback = () => {
   if (!fs.existsSync(previousDirectory)) throw new Error('没有可回滚的上一版本。');
   const currentDirectory = `${extensionDirectory}.rollback-${Date.now()}`;
@@ -164,8 +187,7 @@ const rollback = () => {
 };
 const diagnose = () => {
   const config = readConfig();
-  const manifestPath = path.join(os.homedir(), 'Library', 'Application Support', 'Google', 'Chrome', 'NativeMessagingHosts', `${HOST_NAME}.json`);
-  return { extensionDirectory, extensionLoaded: fs.existsSync(path.join(extensionDirectory, 'manifest.json')), nativeHostRegistered: fs.existsSync(manifestPath), registryUrl: config.registryUrl, extensionId: config.extensionId };
+  return { extensionDirectory, extensionLoaded: fs.existsSync(path.join(extensionDirectory, 'manifest.json')), nativeHostRegistered: fs.existsSync(nativeHostManifestPath), registryUrl: config.registryUrl, extensionId: config.extensionId };
 };
 
-module.exports = { DEFAULT_EXTENSION_ID, HOST_NAME, TRANSITION_HTTP_REGISTRY_ORIGIN, checkAndUpdate, diagnose, install, requestChromeReload, rollback, update };
+module.exports = { DEFAULT_EXTENSION_ID, HOST_NAME, TRANSITION_HTTP_REGISTRY_ORIGIN, checkAndUpdate, diagnose, install, requestChromeReload, rollback, uninstall, update };

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "creative-upload-extension-updater",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "private": false,
   "description": "Native Messaging updater for the Creative Upload unpacked Chrome extension.",
   "bin": {
-    "creative-upload-updater": "bin/creative-upload-extension-updater.js",
-    "creative-upload-extension-updater": "bin/creative-upload-extension-updater.js"
+    "creative-upload-updater": "bin/creative-upload-extension-updater.js"
   },
   "engines": {
     "node": ">=18"