hobots 3.2.0 → 3.2.2

package/dist/index.d.cts

@@ -256,7 +256,18 @@ declare class Step {
     endTimestamp?: string;
     data?: Record<string, unknown>;
     constructor(transaction: Transaction, parentStepId: string, op?: string | undefined, description?: string | undefined);
-    setStatus(status: StepStatus): this;
+    /**
+     * 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: StepStatus, message?: string): 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: unknown, message?: string): this;
+    /** Motivo registrado via setStatus(…, message) ou setError — usado no log de FINISH. */
+    private reason;
     setData(key: string, value: unknown): this;
     /** Step aninhada (filha desta step). */
     startChild(op?: string, description?: string): Step;
@@ -292,7 +303,7 @@ declare class Transaction {
      * 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: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string): void;
+    emit(kind: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string, reason?: string): void;
     /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */
     setLifecycleSink(sink: LifecycleSink): void;
     /**

package/dist/index.d.ts

@@ -256,7 +256,18 @@ declare class Step {
     endTimestamp?: string;
     data?: Record<string, unknown>;
     constructor(transaction: Transaction, parentStepId: string, op?: string | undefined, description?: string | undefined);
-    setStatus(status: StepStatus): this;
+    /**
+     * 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: StepStatus, message?: string): 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: unknown, message?: string): this;
+    /** Motivo registrado via setStatus(…, message) ou setError — usado no log de FINISH. */
+    private reason;
     setData(key: string, value: unknown): this;
     /** Step aninhada (filha desta step). */
     startChild(op?: string, description?: string): Step;
@@ -292,7 +303,7 @@ declare class Transaction {
      * 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: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string): void;
+    emit(kind: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string, reason?: string): void;
     /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */
     setLifecycleSink(sink: LifecycleSink): void;
     /**

package/dist/index.js

@@ -53,7 +53,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";
 }
@@ -569,6 +569,8 @@ var Heartbeat = class {
     this.metadata = options.metadata;
     this.keepAlive = options.keepAlive ?? false;
   }
+  client;
+  sampler;
   intervalMs;
   instanceId;
   name;
@@ -705,6 +707,8 @@ var MachineSampler = class {
     this.instanceId = instanceId;
     this.logger = logger;
   }
+  instanceId;
+  logger;
   os;
   fs;
   ready = false;
@@ -832,6 +836,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);
@@ -1072,6 +1077,9 @@ var Backoff = class {
     this.label = label;
     this.floorMs = floorMs;
   }
+  logger;
+  label;
+  floorMs;
   failures = 0;
   authFailures = 0;
   reset() {
@@ -1316,6 +1324,9 @@ var RunReporter = class {
       retry: (fn, options) => retryWithBackoff(fn, { ...options, signal, wait: sleep2 })
     };
   }
+  api;
+  runId;
+  logger;
   context;
   buffer = [];
   dead = false;
@@ -1640,6 +1651,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);
@@ -1866,6 +1878,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);
 }
@@ -1903,15 +1919,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;
@@ -1929,7 +1971,8 @@ var Step = class {
       stepLabel(this.op, this.description),
       this.startTimestamp,
       this.endTimestamp,
-      this.status
+      this.status,
+      this.reason()
     );
   }
   toJSON() {
@@ -1953,6 +1996,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();
@@ -1972,9 +2019,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}`);
@@ -2179,6 +2226,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;
@@ -2345,6 +2393,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). */
@@ -2430,6 +2480,7 @@ var RunTracker = class {
   constructor(api) {
     this.api = api;
   }
+  api;
   reporters = /* @__PURE__ */ new Set();
   waiters = /* @__PURE__ */ new Set();
   add(reporter) {