@debugbundle/cli 0.1.4 → 0.1.5

package/dist/main.cjs

@@ -14485,6 +14485,31 @@ var CaptureProbeEventsValues = ["buffer_only", "standalone_when_activated"];
 var CaptureProbeEventsSchema = external_exports.enum(CaptureProbeEventsValues);
 var RequestSignalClassificationValues = ["incident_signal", "context_signal"];
 var RequestSignalClassificationSchema = external_exports.enum(RequestSignalClassificationValues);
+var RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES = [401, 403, 409, 422];
+var ImmediateClientErrorStatusSchema = external_exports.number().int().min(400).max(499);
+function normalizeImmediateClientErrorStatuses(statuses) {
+  return Array.from(new Set(statuses)).sort((left, right) => left - right);
+}
+var ImmediateClientErrorStatusesSchema = external_exports.array(ImmediateClientErrorStatusSchema).max(12).transform((statuses) => normalizeImmediateClientErrorStatuses(statuses));
+var ResolvedCapturePolicySchema = external_exports.object({
+  preset: CapturePresetSchema,
+  capture_logs: CaptureLogsSchema,
+  capture_request_events: CaptureRequestEventsSchema,
+  capture_breadcrumbs: CaptureBreadcrumbsSchema,
+  capture_probe_events: CaptureProbeEventsSchema,
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema
+});
+var CapturePolicyOverridesSchema = external_exports.object({
+  capture_logs: CaptureLogsSchema.nullable(),
+  capture_request_events: CaptureRequestEventsSchema.nullable(),
+  capture_breadcrumbs: CaptureBreadcrumbsSchema.nullable(),
+  capture_probe_events: CaptureProbeEventsSchema.nullable(),
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable()
+});
+var CapturePolicyResponseSchema = external_exports.object({
+  policy: ResolvedCapturePolicySchema,
+  overrides: CapturePolicyOverridesSchema
+});
 var CapturePolicySchema = external_exports.object({
   project_id: external_exports.string().uuid(),
   preset: CapturePresetSchema,
@@ -14492,6 +14517,7 @@ var CapturePolicySchema = external_exports.object({
   capture_request_events: CaptureRequestEventsSchema.nullable(),
   capture_breadcrumbs: CaptureBreadcrumbsSchema.nullable(),
   capture_probe_events: CaptureProbeEventsSchema.nullable(),
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable(),
   updated_at: external_exports.string().datetime()
 });
 var CapturePolicyUpdateSchema = external_exports.object({
@@ -14499,21 +14525,48 @@ var CapturePolicyUpdateSchema = external_exports.object({
   capture_logs: CaptureLogsSchema.nullable().optional(),
   capture_request_events: CaptureRequestEventsSchema.nullable().optional(),
   capture_breadcrumbs: CaptureBreadcrumbsSchema.nullable().optional(),
-  capture_probe_events: CaptureProbeEventsSchema.nullable().optional()
+  capture_probe_events: CaptureProbeEventsSchema.nullable().optional(),
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable().optional()
 });
+var PRESET_DEFAULTS = {
+  minimal: {
+    capture_logs: "error",
+    capture_request_events: "failures_only",
+    capture_breadcrumbs: "local_only",
+    capture_probe_events: "buffer_only",
+    immediate_client_error_statuses: []
+  },
+  balanced: {
+    capture_logs: "warning",
+    capture_request_events: "failures_only",
+    capture_breadcrumbs: "exception_only",
+    capture_probe_events: "buffer_only",
+    immediate_client_error_statuses: []
+  },
+  investigative: {
+    capture_logs: "info",
+    capture_request_events: "all",
+    capture_breadcrumbs: "standalone",
+    capture_probe_events: "standalone_when_activated",
+    immediate_client_error_statuses: [...RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES]
+  }
+};
 var BALANCED_IMMEDIATE_REQUEST_STATUSES = /* @__PURE__ */ new Set([408, 423, 424, 425, 429]);
 var INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES = /* @__PURE__ */ new Set([...BALANCED_IMMEDIATE_REQUEST_STATUSES, 409]);
 var BALANCED_STANDARD_ANOMALY_STATUSES = /* @__PURE__ */ new Set([401, 403, 404, 409, 422]);
 var BALANCED_HIGH_VOLUME_ANOMALY_STATUSES = /* @__PURE__ */ new Set([400, 410]);
 var INVESTIGATIVE_ANOMALY_STATUSES = /* @__PURE__ */ new Set([...BALANCED_STANDARD_ANOMALY_STATUSES, ...BALANCED_HIGH_VOLUME_ANOMALY_STATUSES]);
 function classifyRequestStatus(input) {
-  const { responseStatus, capturePreset } = input;
+  const { responseStatus, capturePreset, immediateClientErrorStatuses = [] } = input;
   if (responseStatus === null || !Number.isFinite(responseStatus)) {
     return "context_signal";
   }
   if (responseStatus >= 500) {
     return "incident_signal";
   }
+  if (immediateClientErrorStatuses.includes(responseStatus)) {
+    return "incident_signal";
+  }
   if (capturePreset === "investigative") {
     return INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES.has(responseStatus) ? "incident_signal" : "context_signal";
   }
@@ -16565,7 +16618,7 @@ function getRequestResponseStatus(payload) {
   const status = payload?.["response_status"];
   return typeof status === "number" && Number.isFinite(status) ? status : null;
 }
-function classifyEvent(eventType, logLevel, probeActivationId, payload, capturePreset = "minimal") {
+function classifyEvent(eventType, logLevel, probeActivationId, payload, capturePreset = "minimal", immediateClientErrorStatuses = []) {
   switch (eventType) {
     case "backend_exception":
     case "frontend_exception":
@@ -16577,7 +16630,7 @@ function classifyEvent(eventType, logLevel, probeActivationId, payload, captureP
       return "context_signal";
     case "request_event": {
       const responseStatus = getRequestResponseStatus(payload);
-      return classifyRequestStatus({ responseStatus, capturePreset });
+      return classifyRequestStatus({ responseStatus, capturePreset, immediateClientErrorStatuses });
     }
     case "frontend_breadcrumb":
     case "deploy_metadata":
@@ -16680,6 +16733,13 @@ var STORAGE_SCHEMA_MIGRATIONS = [
         ON slack_destinations (organization_id, is_active, created_at)
       `
     ]
+  }),
+  defineStorageSchemaMigration({
+    id: "202605140001_add_capture_policy_immediate_client_error_statuses",
+    description: "Add nullable immediate client error status overrides to capture policies.",
+    statements: [
+      "ALTER TABLE capture_policies ADD COLUMN IF NOT EXISTS immediate_client_error_statuses jsonb"
+    ]
   })
 ];
 
@@ -25275,7 +25335,7 @@ var CLI_USAGE_LINES = [
   "  debugbundle weekly-report update <channel-id> [--day-of-week <day>] [--hour-of-day <0-23>] [--timezone <iana>] [--config-json <json>] [--is-enabled <true|false>] [--auth-file <path>] [--json]",
   "  debugbundle weekly-report delete <channel-id> [--auth-file <path>] [--json]",
   "  debugbundle capture-policy get --project <id> [--auth-file <path>] [--json]",
-  "  debugbundle capture-policy set --project <id> [--preset <minimal|balanced|investigative>] [--override <key=value>] [--auth-file <path>] [--json]",
+  "  debugbundle capture-policy set --project <id> [--preset <minimal|balanced|investigative>] [--override <key=value>] [--client-error-incidents <preset-default|none|recommended|custom>] [--client-error-statuses <400,401,...>] [--auth-file <path>] [--json]",
   "  debugbundle probe activate <project-id> --label-pattern <pattern> [--service <name>] [--environment <name>] [--ttl-seconds <n>] [--trigger-ttl-seconds <n>] [--auth-file <path>] [--json]",
   "  debugbundle probe list <project-id> [--auth-file <path>] [--json]",
   "  debugbundle probe deactivate <project-id> <activation-id> [--auth-file <path>] [--json]",
@@ -25942,16 +26002,6 @@ async function deleteAlertWithAuthCommand(input, dependencies) {
 }
 
 // src/capture-policy-commands.ts
-var ResolvedCapturePolicySchema = external_exports.object({
-  preset: CapturePresetSchema,
-  capture_logs: CaptureLogsSchema,
-  capture_request_events: CaptureRequestEventsSchema,
-  capture_breadcrumbs: CaptureBreadcrumbsSchema,
-  capture_probe_events: CaptureProbeEventsSchema
-});
-var CapturePolicyResponseSchema = external_exports.object({
-  policy: ResolvedCapturePolicySchema
-});
 var CapturePolicyApiError = class extends Error {
   status;
   constructor(status, message) {
@@ -25981,7 +26031,7 @@ function createCapturePolicyApi(httpClient) {
       if (!parsed.success) {
         throw new CapturePolicyApiError(500, "Invalid capture policy response.");
       }
-      return parsed.data.policy;
+      return parsed.data;
     },
     async updateCapturePolicy(input) {
       const response = await httpClient.request({
@@ -25997,7 +26047,7 @@ function createCapturePolicyApi(httpClient) {
       if (!parsed.success) {
         throw new CapturePolicyApiError(500, "Invalid capture policy response.");
       }
-      return parsed.data.policy;
+      return parsed.data;
     }
   };
 }
@@ -26016,24 +26066,48 @@ function mapErrorToExitCode5(error) {
   }
   return 1;
 }
-function formatPolicy(policy) {
+function statusesEqual(left, right) {
+  if (left.length !== right.length) {
+    return false;
+  }
+  return left.every((value, index) => value === right[index]);
+}
+function formatStatusList(statuses) {
+  return statuses.length === 0 ? "none" : statuses.join(", ");
+}
+function formatClientErrorIncidents(response) {
+  const rawOverride = response.overrides.immediate_client_error_statuses;
+  if (rawOverride === null) {
+    return `preset default (${formatStatusList(response.policy.immediate_client_error_statuses)})`;
+  }
+  if (rawOverride.length === 0) {
+    return "none (explicit)";
+  }
+  if (statusesEqual(rawOverride, RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES)) {
+    return `recommended (${formatStatusList(rawOverride)})`;
+  }
+  return `custom (${formatStatusList(rawOverride)})`;
+}
+function formatPolicy(response) {
+  const policy = response.policy;
   return [
     `preset: ${policy.preset}`,
     `capture_logs: ${policy.capture_logs}`,
     `capture_request_events: ${policy.capture_request_events}`,
     `capture_breadcrumbs: ${policy.capture_breadcrumbs}`,
-    `capture_probe_events: ${policy.capture_probe_events}`
+    `capture_probe_events: ${policy.capture_probe_events}`,
+    `client_error_incidents: ${formatClientErrorIncidents(response)}`
   ].join("\n");
 }
 async function getCapturePolicyCommand(input, api) {
   try {
-    const policy = await api.getCapturePolicy({
+    const response = await api.getCapturePolicy({
       bearerToken: input.bearerToken,
       projectId: input.projectId
     });
     return {
       exitCode: 0,
-      output: input.json ? JSON.stringify({ policy }) : formatPolicy(policy)
+      output: input.json ? JSON.stringify(response) : formatPolicy(response)
     };
   } catch (error) {
     return {
@@ -26051,15 +26125,15 @@ async function setCapturePolicyCommand(input, api) {
         output: "Invalid capture policy update."
       };
     }
-    const policy = await api.updateCapturePolicy({
+    const response = await api.updateCapturePolicy({
       bearerToken: input.bearerToken,
       projectId: input.projectId,
       update: parsedUpdate.data
     });
     return {
       exitCode: 0,
-      output: input.json ? JSON.stringify({ policy }) : `Capture policy updated.
-${formatPolicy(policy)}`
+      output: input.json ? JSON.stringify(response) : `Capture policy updated.
+${formatPolicy(response)}`
     };
   } catch (error) {
     return {
@@ -28568,6 +28642,28 @@ async function handleTokenCommand(parsedArgv, dependencies) {
   throw new CliInputError("Unknown token command.");
 }
 async function handleCapturePolicyCommand(parsedArgv, dependencies) {
+  function parseClientErrorStatusesOption(value) {
+    const parts = value.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+    if (parts.length === 0) {
+      throw new CliInputError("Invalid value for --client-error-statuses.");
+    }
+    const statuses = [];
+    for (const part of parts) {
+      if (!/^\d+$/.test(part)) {
+        throw new CliInputError("Invalid value for --client-error-statuses.");
+      }
+      const status = Number(part);
+      if (!Number.isInteger(status) || status < 400 || status > 499) {
+        throw new CliInputError("Invalid value for --client-error-statuses.");
+      }
+      statuses.push(status);
+    }
+    const normalized = Array.from(new Set(statuses)).sort((left, right) => left - right);
+    if (normalized.length > 12) {
+      throw new CliInputError("Invalid value for --client-error-statuses.");
+    }
+    return normalized;
+  }
   const action = requirePositional(parsedArgv, 1, "action");
   if (action === "get") {
     expectNoUnknownOptions(parsedArgv, ["auth-file", "json", "project"]);
@@ -28581,7 +28677,15 @@ async function handleCapturePolicyCommand(parsedArgv, dependencies) {
     );
   }
   if (action === "set") {
-    expectNoUnknownOptions(parsedArgv, ["auth-file", "json", "project", "preset", "override"]);
+    expectNoUnknownOptions(parsedArgv, [
+      "auth-file",
+      "json",
+      "project",
+      "preset",
+      "override",
+      "client-error-incidents",
+      "client-error-statuses"
+    ]);
     ensureNoExtraPositionals(parsedArgv, 2);
     const projectId = readStringOption(parsedArgv, "project");
     if (projectId === void 0) {
@@ -28605,6 +28709,32 @@ async function handleCapturePolicyCommand(parsedArgv, dependencies) {
       }
       update[key] = rawValue === "null" ? null : rawValue;
     }
+    const clientErrorIncidents = readStringOption(parsedArgv, "client-error-incidents");
+    const clientErrorStatuses = readStringOption(parsedArgv, "client-error-statuses");
+    if (clientErrorStatuses !== void 0 && clientErrorIncidents !== "custom") {
+      throw new CliInputError("Use --client-error-statuses only with --client-error-incidents custom.");
+    }
+    if (clientErrorIncidents !== void 0) {
+      switch (clientErrorIncidents) {
+        case "preset-default":
+          update.immediate_client_error_statuses = null;
+          break;
+        case "none":
+          update.immediate_client_error_statuses = [];
+          break;
+        case "recommended":
+          update.immediate_client_error_statuses = [...RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES];
+          break;
+        case "custom":
+          if (clientErrorStatuses === void 0) {
+            throw new CliInputError("Missing required option --client-error-statuses.");
+          }
+          update.immediate_client_error_statuses = parseClientErrorStatusesOption(clientErrorStatuses);
+          break;
+        default:
+          throw new CliInputError("Invalid value for --client-error-incidents.");
+      }
+    }
     if (Object.keys(update).length === 0) {
       throw new CliInputError("At least one capture policy field must be provided.");
     }

package/package.json

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