@supercheck/cli 0.1.1-beta.1 → 0.1.1-beta.2

package/README.md

@@ -76,9 +76,11 @@ supercheck upgrade
   supercheck test run --local --all --type custom
   ```
 
-  **Run tests in the cloud**:
+  For remote execution with persisted run history, trigger a job:
   ```bash
-  supercheck test run --cloud --id <test-id>
+  supercheck job run --id <job-id>
+  # or (CI/CD trigger key flow)
+  supercheck job trigger <job-id> --wait
   ```
 
 ## Command Reference
@@ -102,29 +104,55 @@ supercheck upgrade
 | `supercheck validate` | Validate local test scripts (same rules as Playground) |
 | `supercheck destroy --force` | Remove all managed resources from the cloud |
 | `supercheck config validate` | Validate your `supercheck.config.ts` |
+| `supercheck config print` | Print resolved `supercheck.config.ts` |
+
+> Note: In the current API, status pages are readable/deletable from CLI sync flows, but create/update endpoints are not available.
 
 ### Jobs & Runs
 
 | Command | Description |
 |---|---|
 | `supercheck job list` | List all jobs |
+| `supercheck job get <id>` | Get job details |
 | `supercheck job create --name <name> --tests <test-id...>` | Create a new job with tests |
-| `supercheck job run` | Run a job immediately |
+| `supercheck job update <id> --name ...` | Update job fields |
+| `supercheck job delete <id>` | Delete a job |
+| `supercheck job keys <jobId>` | List trigger keys for a job |
+| `supercheck job keys create <jobId> --name <name>` | Create a trigger key |
+| `supercheck job keys delete <jobId> <keyId>` | Revoke a trigger key |
+| `supercheck job run --id <job-id>` | Run a job immediately |
 | `supercheck job run --local` | Run a job locally using local test files |
 | `supercheck job trigger <id> --wait` | Trigger a job and wait for completion (CI/CD) |
 | `supercheck run list` | List recent execution runs |
+| `supercheck run get <id>` | Get run details |
+| `supercheck run status <id>` | Get run status |
+| `supercheck run permissions <id>` | Get run permissions |
 | `supercheck run stream <id>` | Stream live console output |
+| `supercheck run cancel <id>` | Cancel a running execution |
 
 ### Tests & Monitors
 
 | Command | Description |
 |---|---|
 | `supercheck test list` | List all tests |
+| `supercheck test get <id>` | Get test details |
 | `supercheck test create` | Create a new test (browser, performance, api, database, custom) |
+| `supercheck test update <id>` | Update a test |
+| `supercheck test delete <id>` | Delete a test |
 | `supercheck test validate` | Validate local test scripts (same rules as Playground) |
-| `supercheck test run` | Run tests locally or in the cloud |
+| `supercheck test run` | Run tests locally |
+| `supercheck test tags <id>` | List tags for a test |
+| `supercheck test status <id>` | Stream live status events for a test |
 | `supercheck monitor list` | List all monitors |
-| `supercheck monitor status <id>` | Check real-time monitor status |
+| `supercheck monitor get <id>` | Get monitor details |
+| `supercheck monitor results <id>` | Get monitor check results |
+| `supercheck monitor stats <id>` | Get monitor statistics |
+| `supercheck monitor status <id>` | Get current monitor status |
+| `supercheck monitor create ...` | Create a monitor |
+| `supercheck monitor update <id> ...` | Update a monitor |
+| `supercheck monitor delete <id>` | Delete a monitor |
+
+`supercheck test run` is local-only. `--cloud`, `--id`, and `--location` are deprecated for direct test execution.
 
 ### Variables, Tags & Notifications
 
@@ -132,7 +160,7 @@ supercheck upgrade
 |---|---|
 | `supercheck var list / get / set / delete` | Manage project variables |
 | `supercheck tag list / create / delete` | Manage tags |
-| `supercheck notification list / delete` | Manage notification providers |
+| `supercheck notification list / get / create / update / delete / test` | Manage notification providers |
 | `supercheck alert history` | View alert history |
 | `supercheck audit` | View audit logs (admin) |
 
@@ -142,6 +170,7 @@ supercheck upgrade
 |---|---|
 | `supercheck health` | Check API health |
 | `supercheck locations` | List available execution locations |
+| `supercheck doctor` | Validate local CLI dependencies and config |
 | `supercheck upgrade` | Upgrade the CLI to the latest release |
 
 ## Configuration

package/dist/bin/supercheck.js

@@ -216,7 +216,7 @@ function requireTriggerKey() {
 }
 
 // src/version.ts
-var CLI_VERSION = true ? "0.1.1-beta.1" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.1.1-beta.2" : "0.0.0-dev";
 
 // src/utils/proxy.ts
 import { ProxyAgent } from "undici";
@@ -312,40 +312,6 @@ var ApiClient = class {
     }
     return url.toString();
   }
-  getProxyEnv(url) {
-    if (this.proxy) return this.proxy;
-    const noProxyRaw = process.env.NO_PROXY ?? process.env.no_proxy;
-    if (noProxyRaw && this.isNoProxyMatch(url, noProxyRaw)) {
-      return null;
-    }
-    if (url.protocol === "https:") {
-      return process.env.HTTPS_PROXY ?? process.env.https_proxy ?? process.env.HTTP_PROXY ?? process.env.http_proxy ?? null;
-    }
-    if (url.protocol === "http:") {
-      return process.env.HTTP_PROXY ?? process.env.http_proxy ?? null;
-    }
-    return null;
-  }
-  isNoProxyMatch(url, noProxyRaw) {
-    const hostname = url.hostname;
-    const port = url.port || (url.protocol === "https:" ? "443" : "80");
-    const entries = noProxyRaw.split(",").map((entry) => entry.trim()).filter(Boolean);
-    if (entries.includes("*")) return true;
-    for (const entry of entries) {
-      const [hostPart, portPart] = entry.split(":");
-      const host = hostPart.trim();
-      const entryPort = portPart?.trim();
-      if (!host) continue;
-      if (entryPort && entryPort !== port) continue;
-      if (host.startsWith(".")) {
-        if (hostname.endsWith(host)) return true;
-        continue;
-      }
-      if (hostname === host) return true;
-      if (hostname.endsWith(`.${host}`)) return true;
-    }
-    return false;
-  }
   /**
    * Execute an HTTP request with retries, timeout, and rate limit handling.
    */
@@ -360,7 +326,7 @@ var ApiClient = class {
       try {
         const controller = new AbortController();
         timeoutId = setTimeout(() => controller.abort(), this.timeout);
-        const proxy = this.getProxyEnv(parsedUrl);
+        const proxy = this.proxy || getProxyEnv(parsedUrl);
         const fetchOptions = {
           method,
           headers,
@@ -1690,6 +1656,11 @@ function isNodeInstalled() {
 }
 async function installPlaywrightBrowsers(cwd, browser = "chromium") {
   try {
+    const allowedBrowsers = ["chromium", "firefox", "webkit", "chrome", "msedge"];
+    if (!allowedBrowsers.includes(browser)) {
+      logger.error(`Invalid browser: ${browser}. Allowed: ${allowedBrowsers.join(", ")}`);
+      return false;
+    }
     logger.info(`Installing Playwright ${browser} browser...`);
     execSync(`npx playwright install ${browser}`, {
       cwd,
@@ -2128,9 +2099,11 @@ async function validateScripts(client, inputs) {
 import { spawn } from "child_process";
 function runCommand(command, args, cwd) {
   return new Promise((resolve10, reject) => {
-    const child = spawn(command, args, {
+    const executable = process.platform === "win32" && command === "npx" ? "npx.cmd" : command;
+    const child = spawn(executable, args, {
       stdio: "inherit",
-      shell: true,
+      shell: false,
+      // ✓ SECURE: Prevents command injection
       cwd
     });
     child.on("error", (err) => reject(err));
@@ -2435,7 +2408,7 @@ jobCommand.command("run").description("Run a job immediately").requiredOption("-
     "Running job",
     () => client.post(
       "/api/jobs/run",
-      { jobId: options.id, tests: payloadTests, trigger: "manual" }
+      { jobId: options.id, tests: payloadTests, trigger: "remote" }
     )
   );
   logger.success(`Job started. Run ID: ${data.runId}`);
@@ -2870,24 +2843,15 @@ testCommand.command("delete <id>").description("Delete a test").option("--force"
   );
   logger.success(`Test ${id} deleted`);
 });
-testCommand.command("run").description("Run tests locally or in the cloud").option("--local", "Run locally").option("--cloud", "Run on cloud").option("--file <path>", "Local test file path").option("--all", "Run all local tests").option("--type <type>", "Local test type filter (browser, performance, api, database, custom)").option("--id <id>", "Cloud test ID").option("--location <location>", "Execution location (k6 cloud only)").action(async (options) => {
+testCommand.command("run").description("Run tests locally").option("--local", "Run locally").option("--cloud", "DEPRECATED: Cloud test execution is no longer supported from CLI").option("--file <path>", "Local test file path").option("--all", "Run all local tests").option("--type <type>", "Local test type filter (browser, performance, api, database, custom)").option("--id <id>", "DEPRECATED: Test ID (cloud execution removed)").option("--location <location>", "Execution location (k6 cloud only)").action(async (options) => {
   if (options.local && options.cloud) {
     throw new CLIError("--local and --cloud are mutually exclusive.", 3 /* ConfigError */);
   }
-  const useCloud = options.cloud || !options.local && !!options.id;
-  if (useCloud) {
-    if (!options.id) {
-      throw new CLIError("Cloud runs require --id <testId>.", 3 /* ConfigError */);
-    }
-    const client2 = createAuthenticatedClient();
-    const body = {};
-    if (options.location) body.location = options.location;
-    const { data } = await withSpinner(
-      "Executing test",
-      () => client2.post(`/api/tests/${options.id}/execute`, body)
+  if (options.cloud || options.id || options.location) {
+    throw new CLIError(
+      "Cloud execution for single tests has been removed from CLI because results are not persisted as job runs. Use `supercheck test run --local ...` for local validation or create/trigger a job (`supercheck job run` / `supercheck job trigger`) for remote executions with run history.",
+      3 /* ConfigError */
     );
-    outputDetail(data);
-    return;
   }
   if (!options.file && !options.all) {
     throw new CLIError("Local runs require --file <path> or --all.", 3 /* ConfigError */);
@@ -2935,15 +2899,11 @@ testCommand.command("run").description("Run tests locally or in the cloud").opti
     await runK6Tests(k6Tests, cwd);
   }
 });
-testCommand.command("execute <id>").description("Execute a test immediately").option("--location <location>", "Execution location (k6 only)").action(async (id, options) => {
-  const client = createAuthenticatedClient();
-  const body = {};
-  if (options.location) body.location = options.location;
-  const { data } = await withSpinner(
-    "Executing test",
-    () => client.post(`/api/tests/${id}/execute`, body)
+testCommand.command("execute <id>").description("DEPRECATED: test execute has been removed").action(async () => {
+  throw new CLIError(
+    "The `test execute` command has been removed. Use `supercheck test run --local ...` for local validation or create/trigger a job (`supercheck job run` / `supercheck job trigger`) for remote executions with run history.",
+    3 /* ConfigError */
   );
-  outputDetail(data);
 });
 testCommand.command("tags <id>").description("Get test tags").action(async (id) => {
   const client = createAuthenticatedClient();
@@ -3539,7 +3499,8 @@ async function applyChange(client, change, opts) {
     const endpoint = getApiEndpoint(change.type);
     switch (change.action) {
       case "create": {
-        const { id: _id, ...rawBody } = change.local.definition;
+        const rawBody = { ...change.local.definition };
+        delete rawBody.id;
         const body = prepareBodyForApi(change.type, rawBody);
         const response = await client.post(endpoint, body);
         if (change.type === "test") {
@@ -3562,7 +3523,8 @@ async function applyChange(client, change, opts) {
       }
       case "update": {
         const id = change.id ?? change.remote.id;
-        const { id: _id, ...rawBody } = change.local.definition;
+        const rawBody = { ...change.local.definition };
+        delete rawBody.id;
         const body = prepareBodyForApi(change.type, rawBody);
         await client.put(`${endpoint}/${id}`, body);
         return { success: true };
@@ -3601,6 +3563,15 @@ var deployCommand = new Command12("deploy").description("Push local config resou
     changes = changes.filter((c) => c.action !== "delete");
   }
   const actionable = changes.filter((c) => c.action !== "no-change");
+  const unsupportedStatusPageMutations = actionable.filter(
+    (c) => c.type === "statusPage" && (c.action === "create" || c.action === "update")
+  );
+  if (unsupportedStatusPageMutations.length > 0) {
+    throw new CLIError(
+      "Status page create/update is not supported by the current API. Remove statusPages create/update changes from config (or apply them in the dashboard) and run deploy again.",
+      3 /* ConfigError */
+    );
+  }
   if (actionable.length === 0) {
     logger.success("No changes to deploy. Everything is in sync.");
     return;
@@ -3885,7 +3856,11 @@ function decodeScript(script) {
     if (reEncoded !== trimmed) {
       return script;
     }
-    if (/^[\x09\x0a\x0d\x20-\x7e\u00a0-\uffff]*$/.test(decoded) && decoded.length > 0) {
+    const isTextLike = decoded.length > 0 && Array.from(decoded).every((char) => {
+      const code = char.codePointAt(0) ?? 0;
+      return code === 9 || code === 10 || code === 13 || code >= 32;
+    });
+    if (isTextLike) {
       return decoded;
     }
   } catch {
@@ -4228,7 +4203,7 @@ function generateConfigContent(opts) {
   parts.push(" *");
   parts.push(" *   supercheck test list           List all tests");
   parts.push(" *   supercheck test validate       Validate a local test script");
-  parts.push(" *   supercheck test execute <id>   Execute a test immediately");
+  parts.push(" *   supercheck test run --local    Run local test scripts");
   parts.push(" *");
   parts.push(" *   supercheck monitor list        List all monitors");
   parts.push(" *   supercheck job list            List all jobs");