@debugbundle/cli 0.1.5 → 0.1.6

package/README.md

@@ -21,6 +21,7 @@ debugbundle setup --non-interactive
 debugbundle doctor --privacy
 debugbundle verify local
 debugbundle verify cloud --project-id <id> --trigger-5xx
+debugbundle verify cloud --project-id <id> --trigger-4xx 403
 debugbundle process
 debugbundle incidents
 debugbundle explain <incident-id> --source cloud

package/dist/main.cjs

@@ -24590,7 +24590,7 @@ function formatResult(input, exitCode, checks, errors, incidentId) {
   };
 }
 function buildCloudSuggestedActions(status, incidentId, mode = "passive_recent_incident") {
-  if (status === "healthy" && incidentId !== void 0 && mode === "active_5xx") {
+  if (status === "healthy" && incidentId !== void 0 && (mode === "active_5xx" || mode === "active_4xx")) {
     return [
       `Run debugbundle inspect ${incidentId} --source cloud to inspect why the incident fired.`,
       `Run debugbundle bundle ${incidentId} --source cloud to fetch the generated debug bundle.`
@@ -24660,11 +24660,11 @@ function localFailureStepName(checks) {
 function cloudVerificationRunId(now) {
   return now.toISOString().replace(/[-:.TZ]/g, "").slice(0, 14);
 }
-function requestFailureReason() {
+function requestFailureReason(responseStatus) {
   const incidentReason = deriveIncidentReasonFromSignal({
     event_type: "request_event",
     event_class: "incident_signal",
-    response_status: 503
+    response_status: responseStatus
   });
   if (incidentReason === null) {
     throw new Error("request_failure_reason_unavailable");
@@ -24673,6 +24673,9 @@ function requestFailureReason() {
 }
 function buildCloudVerificationEvent(input) {
   const runId = cloudVerificationRunId(input.now);
+  const is5xxVerification = input.responseStatus >= 500;
+  const routeTemplate = is5xxVerification ? "/debugbundle/verify/cloud" : `/debugbundle/verify/cloud/client-error/${input.responseStatus}`;
+  const verificationLabel = is5xxVerification ? "true" : `client-error-${input.responseStatus}`;
   return createEventEnvelope({
     event_type: "request_event",
     sdk_name: "debugbundle-cli",
@@ -24686,28 +24689,39 @@ function buildCloudVerificationEvent(input) {
     occurred_at: input.now.toISOString(),
     payload: {
       method: "GET",
-      path: "/debugbundle/verify/cloud",
-      route_template: "/debugbundle/verify/cloud",
+      path: routeTemplate,
+      route_template: routeTemplate,
       query: {
         debugbundle_verification: true,
-        run_id: runId
+        run_id: runId,
+        synthetic_status: input.responseStatus
       },
       headers: {
-        "x-debugbundle-verification": "true"
+        "x-debugbundle-verification": verificationLabel
       },
-      response_status: 503,
+      response_status: input.responseStatus,
       duration_ms: 37,
       response_headers: {
-        "x-debugbundle-verification": "true"
+        "x-debugbundle-verification": verificationLabel
       },
       response_body: {
-        error: "debugbundle_cloud_verification",
+        error: is5xxVerification ? "debugbundle_cloud_verification" : "debugbundle_cloud_client_error_verification",
         synthetic: true,
-        run_id: runId
+        run_id: runId,
+        response_status: input.responseStatus
       }
     }
   });
 }
+function validateActiveCloudVerificationInput(input) {
+  if (input.trigger5xx === true && input.trigger4xxStatus !== void 0) {
+    return "Choose either --trigger-5xx or --trigger-4xx, not both.";
+  }
+  if (input.trigger4xxStatus !== void 0 && (input.trigger4xxStatus < 400 || input.trigger4xxStatus > 499)) {
+    return "--trigger-4xx must be an integer status between 400 and 499.";
+  }
+  return null;
+}
 async function sendEventsToApi2(input, dependencies = {}) {
   const fetchImpl = dependencies.fetchImpl ?? fetch;
   const baseUrl = input.baseUrl.endsWith("/") ? input.baseUrl.slice(0, -1) : input.baseUrl;
@@ -24899,6 +24913,15 @@ async function verifyCloudCommand(input, dependencies = {}) {
   const checks = [];
   const environment = input.environment ?? "production";
   const maxAgeMinutes = input.maxAgeMinutes ?? 15;
+  const activeInputError = validateActiveCloudVerificationInput(input);
+  if (activeInputError !== null) {
+    checks.push({
+      name: "trigger-input",
+      status: "error",
+      message: activeInputError
+    });
+    return formatCloudResult(input, 4, checks, [activeInputError]);
+  }
   const readAuthState = dependencies.readAuthState ?? readCliAuthState;
   let authState;
   try {
@@ -24931,7 +24954,7 @@ async function verifyCloudCommand(input, dependencies = {}) {
     requestInput,
     dependencies.fetchImpl === void 0 ? {} : { fetchImpl: dependencies.fetchImpl }
   ));
-  if (input.trigger5xx === true) {
+  if (input.trigger5xx === true || input.trigger4xxStatus !== void 0) {
     const verificationStartedAt = now();
     const runId = cloudVerificationRunId(verificationStartedAt);
     const serviceName = input.service ?? `debugbundle-verify-cloud-${runId}`;
@@ -24939,16 +24962,20 @@ async function verifyCloudCommand(input, dependencies = {}) {
     const pollAttempts = dependencies.pollAttempts ?? 6;
     const pollIntervalMs = dependencies.pollIntervalMs ?? 2e3;
     const sleep = dependencies.sleep ?? ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+    const responseStatus = input.trigger4xxStatus ?? 503;
+    const activeMode = input.trigger4xxStatus !== void 0 ? "active_4xx" : "active_5xx";
+    const activeCheckName = input.trigger4xxStatus !== void 0 ? "active-4xx-event" : "active-5xx-event";
+    const statusLabel = input.trigger4xxStatus !== void 0 ? `${responseStatus}` : "5xx";
     const verification = {
-      mode: "active_5xx",
+      mode: activeMode,
       bundle_status: "unknown",
-      classification_reason: requestFailureReason()
+      classification_reason: requestFailureReason(responseStatus)
     };
     const errors = [];
     let exitCode = 0;
     let tokenId = null;
     let incidentId;
-    let activeStep = "active-5xx-event";
+    let activeStep = activeCheckName;
     try {
       const token = await createProjectToken({
         bearerToken: authState.bearer_token,
@@ -24962,7 +24989,8 @@ async function verifyCloudCommand(input, dependencies = {}) {
       const event = buildCloudVerificationEvent({
         now: verificationStartedAt,
         serviceName,
-        environment
+        environment,
+        responseStatus
       });
       const ingestion = await sendEvents({
         baseUrl: authState.base_url,
@@ -24971,12 +24999,12 @@ async function verifyCloudCommand(input, dependencies = {}) {
       });
       verification.accepted_event_count = ingestion.accepted;
       if (ingestion.accepted < 1 || ingestion.rejected > 0 || ingestion.errors.length > 0) {
-        throw new Error(`Synthetic 5xx ingestion was not fully accepted: accepted=${ingestion.accepted}, rejected=${ingestion.rejected}.`);
+        throw new Error(`Synthetic ${statusLabel} ingestion was not fully accepted: accepted=${ingestion.accepted}, rejected=${ingestion.rejected}.`);
       }
       checks.push({
-        name: "active-5xx-event",
+        name: activeCheckName,
         status: "ok",
-        message: "Sent synthetic 5xx request_event through cloud ingestion."
+        message: `Sent synthetic ${statusLabel} request_event through cloud ingestion.`
       });
       activeStep = "incident-retrieval";
       for (let attempt = 1; attempt <= pollAttempts; attempt += 1) {
@@ -24994,7 +25022,7 @@ async function verifyCloudCommand(input, dependencies = {}) {
         if (candidate !== void 0) {
           incidentId = candidate.incident_id;
           verification.incident_id = candidate.incident_id;
-          verification.classification_reason = candidate.incident_reason ?? requestFailureReason();
+          verification.classification_reason = candidate.incident_reason ?? requestFailureReason(responseStatus);
           break;
         }
         if (attempt < pollAttempts) {
@@ -25002,12 +25030,12 @@ async function verifyCloudCommand(input, dependencies = {}) {
         }
       }
       if (incidentId === void 0) {
-        throw new Error("Synthetic 5xx request was accepted but no matching cloud incident was visible yet.");
+        throw new Error(`Synthetic ${statusLabel} request was accepted but no matching cloud incident was visible yet.`);
       }
       checks.push({
         name: "incident-retrieval",
         status: "ok",
-        message: `Retrieved cloud incident ${incidentId} for the synthetic 5xx request.`
+        message: `Retrieved cloud incident ${incidentId} for the synthetic ${statusLabel} request.`
       });
       activeStep = "bundle-status";
       const bundle = await getBundle({
@@ -25273,7 +25301,7 @@ var CLI_USAGE_LINES = [
   "  debugbundle clean [--events] [--bundles] [--all] [--older-than <Nd>] [--json]",
   "  debugbundle validate [--fix] [--json]",
   "  debugbundle verify local [--json]",
-  "  debugbundle verify cloud --project-id <id> [--trigger-5xx] [--service <name>] [--environment <name>] [--max-age-minutes <n>] [--auth-file <path>] [--json]",
+  "  debugbundle verify cloud --project-id <id> [--trigger-5xx | --trigger-4xx <400-499>] [--service <name>] [--environment <name>] [--max-age-minutes <n>] [--auth-file <path>] [--json]",
   "  debugbundle smoke --project-id <id> [--service <name>] [--environment <name>] [--max-age-minutes <n>] [--auth-file <path>] [--json]",
   "  debugbundle login [--base-url <url>] [--auth-file <path>] [--json]",
   "  debugbundle login <member-token> [--base-url <url>] [--auth-file <path>] [--json]",
@@ -29519,7 +29547,7 @@ ${formatUsage()}`
         return await (dependencies.verifyLocalCommand ?? verifyLocalCommand)(readBooleanOption(parsedArgv, "json") === true ? { json: true } : {});
       }
       if (subcommand === "cloud") {
-        expectNoUnknownOptions(parsedArgv, ["auth-file", "json", "project-id", "service", "environment", "max-age-minutes", "trigger-5xx"]);
+        expectNoUnknownOptions(parsedArgv, ["auth-file", "json", "project-id", "service", "environment", "max-age-minutes", "trigger-5xx", "trigger-4xx"]);
         ensureNoExtraPositionals(parsedArgv, 2);
         const projectId = readStringOption(parsedArgv, "project-id");
         if (projectId === void 0) {
@@ -29537,6 +29565,10 @@ ${formatUsage()}`
         if (readBooleanOption(parsedArgv, "trigger-5xx") === true) {
           input.trigger5xx = true;
         }
+        const trigger4xxStatus = readIntegerOption(parsedArgv, "trigger-4xx");
+        if (trigger4xxStatus !== void 0) {
+          input.trigger4xxStatus = trigger4xxStatus;
+        }
         return await (dependencies.verifyCloudCommand ?? verifyCloudCommand)(input);
       }
       throw new CliInputError("Unknown verify command.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@debugbundle/cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "private": false,
   "description": "Command-line interface for DebugBundle",
   "license": "AGPL-3.0-only",