hobots 3.2.1 → 3.2.2

package/dist/index.cjs

@@ -95,7 +95,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "3.2.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "3.2.2" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -611,6 +611,8 @@ var Heartbeat = class {
     this.metadata = options.metadata;
     this.keepAlive = options.keepAlive ?? false;
   }
+  client;
+  sampler;
   intervalMs;
   instanceId;
   name;
@@ -747,6 +749,8 @@ var MachineSampler = class {
     this.instanceId = instanceId;
     this.logger = logger;
   }
+  instanceId;
+  logger;
   os;
   fs;
   ready = false;
@@ -874,6 +878,7 @@ var TasksApiError = class extends Error {
     this.status = status;
     this.name = "TasksApiError";
   }
+  status;
 };
 async function withRequestTimeout(timeoutMs, external, send) {
   const { signal, cleanup } = withTimeoutSignal(timeoutMs, external);
@@ -1114,6 +1119,9 @@ var Backoff = class {
     this.label = label;
     this.floorMs = floorMs;
   }
+  logger;
+  label;
+  floorMs;
   failures = 0;
   authFailures = 0;
   reset() {
@@ -1358,6 +1366,9 @@ var RunReporter = class {
       retry: (fn, options) => retryWithBackoff(fn, { ...options, signal, wait: sleep2 })
     };
   }
+  api;
+  runId;
+  logger;
   context;
   buffer = [];
   dead = false;
@@ -1682,6 +1693,7 @@ var RunReporter = class {
       }
       if (error instanceof TasksApiError) {
         this.logger.error(`lote de ${batch.length} item(ns) rejeitado pelo servidor:`, error);
+        this.log("warning", `${batch.length} item(ns) descartado(s): envio rejeitado pelo servidor (HTTP ${error.status})`);
         return;
       }
       this.itemsBuffer.unshift(...batch);
@@ -1908,6 +1920,10 @@ function currentRunReporter() {
 }
 
 // src/transaction.ts
+var MAX_STEP_MESSAGE_CHARS = 2e3;
+function stepMessage(text) {
+  return truncate(scrubSecrets(text), MAX_STEP_MESSAGE_CHARS);
+}
 function stepId() {
   return uuid4().slice(0, 16);
 }
@@ -1945,15 +1961,41 @@ var Step = class {
     this.op = op;
     this.description = description;
   }
+  transaction;
+  parentStepId;
+  op;
+  description;
   stepId = stepId();
   startTimestamp = nowISO();
   status = "ok";
   endTimestamp;
   data;
-  setStatus(status) {
+  /**
+   * Desfecho da step. `message` (opcional) é o motivo legível — vai em `data.message`
+   * e aparece na Central (performance e banner da execução) e no log de FINISH.
+   */
+  setStatus(status, message) {
     this.status = status;
+    if (message) this.setData("message", stepMessage(message));
     return this;
   }
+  /**
+   * Marca a step como `error` guardando o motivo em `data.error` ({ type, message }).
+   * Aceita qualquer valor lançado; `message` sobrescreve a mensagem do erro.
+   */
+  setError(error, message) {
+    this.status = "error";
+    const type = error instanceof Error ? error.name : typeof error === "object" && error !== null ? "Error" : void 0;
+    const raw = message ?? (error instanceof Error ? error.message || error.name : String(error));
+    this.setData("error", { ...type ? { type } : {}, message: stepMessage(raw) });
+    return this;
+  }
+  /** Motivo registrado via setStatus(…, message) ou setError — usado no log de FINISH. */
+  reason() {
+    const error = this.data?.error;
+    const text = typeof error?.message === "string" ? error.message : this.data?.message;
+    return typeof text === "string" && text ? text : void 0;
+  }
   setData(key, value) {
     this.data = { ...this.data, [key]: value };
     return this;
@@ -1971,7 +2013,8 @@ var Step = class {
       stepLabel(this.op, this.description),
       this.startTimestamp,
       this.endTimestamp,
-      this.status
+      this.status,
+      this.reason()
     );
   }
   toJSON() {
@@ -1995,6 +2038,10 @@ var Transaction = class {
     this.runId = runId;
     this.emit("transaction", "start", op ? `${name} (${op})` : name);
   }
+  client;
+  name;
+  op;
+  runId;
   eventId = uuid4();
   stepId = stepId();
   startTimestamp = nowISO();
@@ -2014,9 +2061,9 @@ var Transaction = class {
    * logs da run no app), e ecoa no terminal apenas com `debug: true` — o SDK não
    * escreve no stdout do processo do usuário sem permissão.
    */
-  emit(kind, phase, label, startTs, endTs, status) {
+  emit(kind, phase, label, startTs, endTs, status, reason) {
     const durationMs = startTs && endTs ? new Date(endTs).getTime() - new Date(startTs).getTime() : void 0;
-    const suffix = durationMs != null ? ` (${durationMs}ms)` : "";
+    const suffix = (durationMs != null ? ` (${durationMs}ms)` : "") + (reason ? `: ${reason}` : "");
     if (this.client?.debug) {
       const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? colorForStatus(status ?? "ok") : "cyan");
       console.log(`${tag} ${label}${suffix}`);
@@ -2221,6 +2268,7 @@ var TaskAgent = class {
     this.pollIntervalMs = Math.max(MIN_POLL_INTERVAL_MS, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
     this.backoff = new Backoff(this.logger, "poll", this.pollIntervalMs);
   }
+  options;
   logger;
   pollIntervalMs;
   api;
@@ -2387,6 +2435,8 @@ var LocalRunner = class {
       this.resolveDone = resolve2;
     });
   }
+  task;
+  deps;
   abort = new AbortController();
   backoff;
   /** Resolve quando a run terminou (ou o runner foi parado antes de abri-la). */
@@ -2472,6 +2522,7 @@ var RunTracker = class {
   constructor(api) {
     this.api = api;
   }
+  api;
   reporters = /* @__PURE__ */ new Set();
   waiters = /* @__PURE__ */ new Set();
   add(reporter) {