hobots 1.7.4 → 1.7.6

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, RunLogLevel, SpanStatus, SpanData, CheckInStatus } from './protocol.cjs';
+import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, CheckInStatus } from './protocol.cjs';
 export { AgentInfo, Envelope, EnvelopeItem, ExceptionData, PollRequest, PollResponse, RunDescriptor, RunError, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.cjs';
 
 /** API oficial da Hobots — o SDK sempre fala com ela em produção. */
@@ -66,27 +66,27 @@ declare class Client {
 
 /** Recebe os eventos de lifecycle da transaction para espelhá-los nos logs da run. */
 type LifecycleSink = (level: RunLogLevel, message: string) => void;
-declare class Span {
+declare class Step {
     private readonly transaction;
-    readonly parentSpanId: string;
+    readonly parentStepId: string;
     readonly op?: string | undefined;
     readonly description?: string | undefined;
-    readonly spanId: string;
+    readonly stepId: string;
     readonly startTimestamp: string;
-    status: SpanStatus;
+    status: StepStatus;
     endTimestamp?: string;
     data?: Record<string, unknown>;
-    constructor(transaction: Transaction, parentSpanId: string, op?: string | undefined, description?: string | undefined);
-    setStatus(status: SpanStatus): this;
+    constructor(transaction: Transaction, parentStepId: string, op?: string | undefined, description?: string | undefined);
+    setStatus(status: StepStatus): this;
     setData(key: string, value: unknown): this;
-    /** Span aninhado (filho deste span). */
-    startChild(op?: string, description?: string): Span;
+    /** Step aninhada (filha desta step). */
+    startChild(op?: string, description?: string): Step;
     finish(): void;
-    toJSON(): SpanData;
+    toJSON(): StepData;
 }
 /**
  * Uma unidade de trabalho nomeada (ex.: uma execução de rotina, uma sincronização).
- * Spans filhos medem as etapas internas (chamadas HTTP, queries, etc.).
+ * Steps filhas medem as etapas internas (chamadas HTTP, queries, etc.).
  */
 declare class Transaction {
     private readonly client;
@@ -96,10 +96,10 @@ declare class Transaction {
     /** Correlaciona a uma execução de task — preenchido automaticamente em ctx.tx */
     private readonly runId?;
     readonly eventId: string;
-    readonly spanId: string;
+    readonly stepId: string;
     readonly startTimestamp: string;
     status: string;
-    private readonly spans;
+    private readonly steps;
     private readonly tags;
     private finished;
     private lifecycleSink?;
@@ -108,16 +108,16 @@ declare class Transaction {
     /** Correlaciona a uma execução de task — preenchido automaticamente em ctx.tx */
     runId?: string | undefined);
     /**
-     * Ecoa no terminal o início/fim de um span ou transaction (sempre, independente de
+     * Ecoa no terminal o início/fim de uma step ou transaction (sempre, independente de
      * sampling ou do debug) e espelha a linha no sink de lifecycle, se conectado — é
      * assim que os eventos de performance também aparecem nos logs da run no app.
      */
-    emit(kind: 'transaction' | 'span', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string): void;
+    emit(kind: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string): void;
     /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */
     setLifecycleSink(sink: LifecycleSink): void;
-    createSpan(parentSpanId: string, op?: string, description?: string): Span;
-    /** Span direto da transaction. */
-    startChild(op?: string, description?: string): Span;
+    createStep(parentStepId: string, op?: string, description?: string): Step;
+    /** Step direta da transaction. */
+    startChild(op?: string, description?: string): Step;
     setTag(key: string, value: string): this;
     setStatus(status: string): this;
     setName(name: string): this;
@@ -284,4 +284,4 @@ declare function close(timeoutMs?: number): Promise<boolean>;
 
 declare function scrubSecrets(text: string): string;
 
-export { Breadcrumb, type BreadcrumbInput, type CaptureHint, type CheckInOptions, CheckInPayload, CheckInStatus, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, type RunContext, RunLogLevel, Scope, Severity, Span, SpanData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, type WithMonitorOptions, addBreadcrumb, captureException, captureMessage, checkIn, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withMonitor, withScope };
+export { Breadcrumb, type BreadcrumbInput, type CaptureHint, type CheckInOptions, CheckInPayload, CheckInStatus, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, type RunContext, RunLogLevel, Scope, Severity, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, type WithMonitorOptions, addBreadcrumb, captureException, captureMessage, checkIn, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withMonitor, withScope };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, RunLogLevel, SpanStatus, SpanData, CheckInStatus } from './protocol.js';
+import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, CheckInStatus } from './protocol.js';
 export { AgentInfo, Envelope, EnvelopeItem, ExceptionData, PollRequest, PollResponse, RunDescriptor, RunError, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.js';
 
 /** API oficial da Hobots — o SDK sempre fala com ela em produção. */
@@ -66,27 +66,27 @@ declare class Client {
 
 /** Recebe os eventos de lifecycle da transaction para espelhá-los nos logs da run. */
 type LifecycleSink = (level: RunLogLevel, message: string) => void;
-declare class Span {
+declare class Step {
     private readonly transaction;
-    readonly parentSpanId: string;
+    readonly parentStepId: string;
     readonly op?: string | undefined;
     readonly description?: string | undefined;
-    readonly spanId: string;
+    readonly stepId: string;
     readonly startTimestamp: string;
-    status: SpanStatus;
+    status: StepStatus;
     endTimestamp?: string;
     data?: Record<string, unknown>;
-    constructor(transaction: Transaction, parentSpanId: string, op?: string | undefined, description?: string | undefined);
-    setStatus(status: SpanStatus): this;
+    constructor(transaction: Transaction, parentStepId: string, op?: string | undefined, description?: string | undefined);
+    setStatus(status: StepStatus): this;
     setData(key: string, value: unknown): this;
-    /** Span aninhado (filho deste span). */
-    startChild(op?: string, description?: string): Span;
+    /** Step aninhada (filha desta step). */
+    startChild(op?: string, description?: string): Step;
     finish(): void;
-    toJSON(): SpanData;
+    toJSON(): StepData;
 }
 /**
  * Uma unidade de trabalho nomeada (ex.: uma execução de rotina, uma sincronização).
- * Spans filhos medem as etapas internas (chamadas HTTP, queries, etc.).
+ * Steps filhas medem as etapas internas (chamadas HTTP, queries, etc.).
  */
 declare class Transaction {
     private readonly client;
@@ -96,10 +96,10 @@ declare class Transaction {
     /** Correlaciona a uma execução de task — preenchido automaticamente em ctx.tx */
     private readonly runId?;
     readonly eventId: string;
-    readonly spanId: string;
+    readonly stepId: string;
     readonly startTimestamp: string;
     status: string;
-    private readonly spans;
+    private readonly steps;
     private readonly tags;
     private finished;
     private lifecycleSink?;
@@ -108,16 +108,16 @@ declare class Transaction {
     /** Correlaciona a uma execução de task — preenchido automaticamente em ctx.tx */
     runId?: string | undefined);
     /**
-     * Ecoa no terminal o início/fim de um span ou transaction (sempre, independente de
+     * Ecoa no terminal o início/fim de uma step ou transaction (sempre, independente de
      * sampling ou do debug) e espelha a linha no sink de lifecycle, se conectado — é
      * assim que os eventos de performance também aparecem nos logs da run no app.
      */
-    emit(kind: 'transaction' | 'span', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string): void;
+    emit(kind: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string): void;
     /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */
     setLifecycleSink(sink: LifecycleSink): void;
-    createSpan(parentSpanId: string, op?: string, description?: string): Span;
-    /** Span direto da transaction. */
-    startChild(op?: string, description?: string): Span;
+    createStep(parentStepId: string, op?: string, description?: string): Step;
+    /** Step direta da transaction. */
+    startChild(op?: string, description?: string): Step;
     setTag(key: string, value: string): this;
     setStatus(status: string): this;
     setName(name: string): this;
@@ -284,4 +284,4 @@ declare function close(timeoutMs?: number): Promise<boolean>;
 
 declare function scrubSecrets(text: string): string;
 
-export { Breadcrumb, type BreadcrumbInput, type CaptureHint, type CheckInOptions, CheckInPayload, CheckInStatus, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, type RunContext, RunLogLevel, Scope, Severity, Span, SpanData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, type WithMonitorOptions, addBreadcrumb, captureException, captureMessage, checkIn, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withMonitor, withScope };
+export { Breadcrumb, type BreadcrumbInput, type CaptureHint, type CheckInOptions, CheckInPayload, CheckInStatus, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, type RunContext, RunLogLevel, Scope, Severity, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, type WithMonitorOptions, addBreadcrumb, captureException, captureMessage, checkIn, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withMonitor, withScope };

package/dist/index.js

@@ -103,7 +103,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "1.7.2" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.7.6" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -659,20 +659,44 @@ var Scope = class _Scope {
 };
 
 // src/transaction.ts
-function spanId() {
+function stepId() {
   return uuid4().slice(0, 16);
 }
-function spanLabel(op, description) {
+function stepLabel(op, description) {
   return [op, description].filter(Boolean).join(" \u2014 ") || "(sem nome)";
 }
-var Span = class {
-  constructor(transaction, parentSpanId, op, description) {
+function levelForStatus(status) {
+  switch (status) {
+    case "warning":
+      return "warning";
+    case "error":
+      return "error";
+    case "cancelled":
+      return "warning";
+    default:
+      return "success";
+  }
+}
+function colorForStatus(status) {
+  switch (status) {
+    case "warning":
+      return "yellow";
+    case "error":
+      return "red";
+    case "cancelled":
+      return "gray";
+    default:
+      return "green";
+  }
+}
+var Step = class {
+  constructor(transaction, parentStepId, op, description) {
     this.transaction = transaction;
-    this.parentSpanId = parentSpanId;
+    this.parentStepId = parentStepId;
     this.op = op;
     this.description = description;
   }
-  spanId = spanId();
+  stepId = stepId();
   startTimestamp = nowISO();
   status = "ok";
   endTimestamp;
@@ -685,19 +709,26 @@ var Span = class {
     this.data = { ...this.data, [key]: value };
     return this;
   }
-  /** Span aninhado (filho deste span). */
+  /** Step aninhada (filha desta step). */
   startChild(op, description) {
-    return this.transaction.createSpan(this.spanId, op, description);
+    return this.transaction.createStep(this.stepId, op, description);
   }
   finish() {
     if (this.endTimestamp) return;
     this.endTimestamp = nowISO();
-    this.transaction.emit("span", "finish", spanLabel(this.op, this.description), this.startTimestamp, this.endTimestamp);
+    this.transaction.emit(
+      "step",
+      "finish",
+      stepLabel(this.op, this.description),
+      this.startTimestamp,
+      this.endTimestamp,
+      this.status
+    );
   }
   toJSON() {
     return {
-      span_id: this.spanId,
-      parent_span_id: this.parentSpanId,
+      step_id: this.stepId,
+      parent_step_id: this.parentStepId,
       op: this.op,
       description: this.description,
       status: this.status,
@@ -717,10 +748,10 @@ var Transaction = class {
     this.emit("transaction", "start", op ? `${name} (${op})` : name);
   }
   eventId = uuid4();
-  spanId = spanId();
+  stepId = stepId();
   startTimestamp = nowISO();
   status = "ok";
-  spans = [];
+  steps = [];
   tags = {};
   finished = false;
   lifecycleSink;
@@ -728,16 +759,16 @@ var Transaction = class {
   // antes do RunReporter conectar) — replay no setLifecycleSink
   lifecycleBacklog = [];
   /**
-   * Ecoa no terminal o início/fim de um span ou transaction (sempre, independente de
+   * Ecoa no terminal o início/fim de uma step ou transaction (sempre, independente de
    * sampling ou do debug) e espelha a linha no sink de lifecycle, se conectado — é
    * assim que os eventos de performance também aparecem nos logs da run no app.
    */
-  emit(kind, phase, label, startTs, endTs) {
+  emit(kind, phase, label, startTs, endTs, status) {
     const durationMs = startTs && endTs ? new Date(endTs).getTime() - new Date(startTs).getTime() : void 0;
-    const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? "green" : "cyan");
+    const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? colorForStatus(status ?? "ok") : "cyan");
     const suffix = durationMs != null ? ` (${durationMs}ms)` : "";
     console.log(`${tag} ${label}${suffix}`);
-    const level = phase === "finish" ? "success" : "info";
+    const level = phase === "finish" ? levelForStatus(status ?? "ok") : "info";
     const message = `[${kind}] ${phase.toUpperCase()} ${label}${suffix}`;
     if (this.lifecycleSink) this.lifecycleSink(level, message);
     else if (this.lifecycleBacklog.length < 100) this.lifecycleBacklog.push([level, message]);
@@ -749,15 +780,15 @@ var Transaction = class {
     this.lifecycleBacklog = [];
     for (const [level, message] of backlog) sink(level, message);
   }
-  createSpan(parentSpanId, op, description) {
-    const span = new Span(this, parentSpanId, op, description);
-    this.spans.push(span);
-    this.emit("span", "start", spanLabel(op, description));
-    return span;
+  createStep(parentStepId, op, description) {
+    const step = new Step(this, parentStepId, op, description);
+    this.steps.push(step);
+    this.emit("step", "start", stepLabel(op, description));
+    return step;
   }
-  /** Span direto da transaction. */
+  /** Step direta da transaction. */
   startChild(op, description) {
-    return this.createSpan(this.spanId, op, description);
+    return this.createStep(this.stepId, op, description);
   }
   setTag(key, value) {
     this.tags[key] = value;
@@ -774,14 +805,15 @@ var Transaction = class {
   finish() {
     if (this.finished) return;
     this.finished = true;
-    for (const span of this.spans) span.finish();
+    for (const step of this.steps) step.finish();
     const endTimestamp = nowISO();
     this.emit(
       "transaction",
       "finish",
       this.op ? `${this.name} (${this.op})` : this.name,
       this.startTimestamp,
-      endTimestamp
+      endTimestamp,
+      this.status
     );
     if (!this.sampled || !this.client) return;
     const payload = {
@@ -791,7 +823,7 @@ var Transaction = class {
       status: this.status,
       start_timestamp: this.startTimestamp,
       timestamp: endTimestamp,
-      spans: this.spans.map((span) => span.toJSON()),
+      steps: this.steps.map((step) => step.toJSON()),
       tags: Object.keys(this.tags).length > 0 ? this.tags : void 0,
       run_id: this.runId
     };
@@ -1622,7 +1654,7 @@ export {
   Client,
   DEFAULT_BASE_URL,
   Scope,
-  Span,
+  Step,
   Transaction,
   addBreadcrumb,
   captureException,