website-api 1.1.7 → 1.1.8

package/dist/src/cli/ext.js

@@ -10,6 +10,7 @@ import { defineSite } from "../core/define-site.js";
 import { addRegistry, installEntry, listInstalled, loadIndex, removeInstalled, removeRegistry, resolveEntry, resolveRegistries, searchRegistries, } from "../core/registry.js";
 import { getSite, loadSites } from "../core/runtime.js";
 import { parseArgsForWebsite } from "../util/args-parser.js";
+// #region Helpers
 /** Asks a yes/no question on the TTY; returns true on "y". */
 async function confirm(question) {
     if (!stdin.isTTY)
@@ -62,6 +63,7 @@ function printLocalHelp(site, entry) {
     }
     console.log();
 }
+// #endregion
 /** Registers the `ext` command group on the given Commander program. */
 export function registerExtCommands(program) {
     // `test` forwards unknown flags (e.g. --limit) to the site being tested, which
@@ -71,6 +73,7 @@ export function registerExtCommands(program) {
         .command("ext")
         .description("Discover and install website extensions from a public registry")
         .enablePositionalOptions();
+    // #region Command: ext test
     // ── test (run a local file directly, no install) ──
     ext
         .command("test <path> [args...]")
@@ -131,6 +134,91 @@ export function registerExtCommands(program) {
             await dispose();
         }
     });
+    // #endregion
+    // #region Command: ext run
+    // ── run (download/update and run in one command) ──
+    ext
+        .command("run <id> [args...]")
+        .description("Download/update a site from the registry and run it immediately")
+        .option("--registry <name>", "Disambiguate when multiple registries offer the id")
+        .allowUnknownOption()
+        .passThroughOptions()
+        .action(async (id, args, opts) => {
+        let resolved;
+        try {
+            resolved = await resolveEntry(id, {
+                registryName: opts.registry,
+                refresh: true, // Always pull the latest catalog from the network
+            });
+        }
+        catch (err) {
+            fail(errMsg(err));
+        }
+        console.error(chalk.gray(`▶ fetching and updating "${resolved.entry.id}" from registry "${resolved.source.name}"...`));
+        let dir;
+        try {
+            const result = await installEntry(resolved.source, resolved.index, resolved.entry, {
+                refresh: true, // Always pull the latest files from the network
+            });
+            dir = result.dir;
+        }
+        catch (err) {
+            fail(errMsg(err));
+        }
+        const entryFile = join(dir, resolved.entry.files[0].name);
+        let mod;
+        try {
+            mod = await import(pathToFileURL(entryFile).href);
+        }
+        catch (err) {
+            fail(`failed to import ${entryFile}: ${errMsg(err)}`);
+        }
+        const def = mod.default ?? mod.site;
+        if (!def || typeof def !== "object") {
+            fail(`${entryFile} does not default-export a site object`);
+        }
+        let site;
+        try {
+            site = defineSite(def);
+        }
+        catch (err) {
+            fail(errMsg(err));
+        }
+        site.origin = "extension";
+        let parsed;
+        try {
+            const siteArgs = (args ?? []).filter((a) => a !== "--");
+            parsed = parseArgsForWebsite(site.positionals, site.parameters, siteArgs);
+        }
+        catch (err) {
+            fail(errMsg(err));
+        }
+        if (parsed.helpRequested) {
+            printLocalHelp(site, entryFile);
+            return;
+        }
+        console.error(chalk.gray(`▶ running "${site.id}"`));
+        const { ctx, dispose } = createContext(site, parsed.options);
+        try {
+            const data = await site.run(ctx);
+            const output = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+            if (parsed.options.out) {
+                writeFileSync(parsed.options.out, output + "\n", "utf8");
+                console.error(chalk.green(`✓ wrote ${parsed.options.out}`));
+            }
+            else {
+                console.log(output);
+            }
+        }
+        catch (err) {
+            fail(errMsg(err));
+        }
+        finally {
+            await dispose();
+        }
+    });
+    // #endregion
+    // #region Command: ext search
     // ── search ──
     ext
         .command("search [query]")
@@ -166,6 +254,8 @@ export function registerExtCommands(program) {
         console.log(table.toString());
         console.log(`\nInstall one with: ${chalk.bold.cyan("npx website-api ext install <id>")}\n`);
     });
+    // #endregion
+    // #region Command: ext info
     // ── info ──
     ext
         .command("info <id>")
@@ -188,6 +278,8 @@ export function registerExtCommands(program) {
             console.log(`  ${chalk.bold((k + ":").padEnd(16))} ${v}`);
         console.log(`\nInstall with: ${chalk.bold.cyan(`npx website-api ext install ${entry.id}`)}\n`);
     });
+    // #endregion
+    // #region Command: ext install
     // ── install ──
     ext
         .command("install <id>")
@@ -224,6 +316,8 @@ export function registerExtCommands(program) {
         console.log(chalk.green(`\n✓ Installed ${entry.id} → ${dir}`));
         console.log(`Run it with: ${chalk.bold.cyan(`npx website-api ${entry.id}`)}\n`);
     });
+    // #endregion
+    // #region Command: ext list
     // ── list (installed) ──
     ext
         .command("list")
@@ -255,6 +349,8 @@ export function registerExtCommands(program) {
         }
         console.log(table.toString());
     });
+    // #endregion
+    // #region Command: ext remove
     // ── remove ──
     ext
         .command("remove <id>")
@@ -266,6 +362,8 @@ export function registerExtCommands(program) {
         else
             fail(`"${id}" is not installed`);
     });
+    // #endregion
+    // #region Command: ext update
     // ── update ──
     ext
         .command("update [id]")
@@ -298,6 +396,8 @@ export function registerExtCommands(program) {
         }
         console.log(updated ? chalk.green(`\nUpdated ${updated} site(s).`) : chalk.gray("\nNothing to update."));
     });
+    // #endregion
+    // #region Registry Management Commands
     // ── registry management ──
     const reg = ext.command("registry").description("Manage the registries searched for sites");
     reg
@@ -335,4 +435,5 @@ export function registerExtCommands(program) {
         else
             fail(`registry "${repoOrName}" not found in config`);
     });
+    // #endregion
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "website-api",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "CLI and library to query website private APIs with your real logged-in Chrome session",
   "main": "./dist/src/website-api.js",
   "types": "./dist/src/website-api.d.ts",