hobots 1.7.2 → 1.7.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, SpanStatus, SpanData, CheckInStatus } from './protocol.cjs';
-export { AgentInfo, Envelope, EnvelopeItem, ExceptionData, PollRequest, PollResponse, RunDescriptor, RunError, RunLogEntry, RunLogLevel, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.cjs';
+import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, RunLogLevel, SpanStatus, SpanData, 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. */
 declare const DEFAULT_BASE_URL = "https://api2.hobots.app";
@@ -64,6 +64,8 @@ declare class Client {
     close(timeoutMs?: number): Promise<boolean>;
 }
 
+/** Recebe os eventos de lifecycle da transaction para espelhá-los nos logs da run. */
+type LifecycleSink = (level: RunLogLevel, message: string) => void;
 declare class Span {
     private readonly transaction;
     readonly parentSpanId: string;
@@ -100,9 +102,19 @@ declare class Transaction {
     private readonly spans;
     private readonly tags;
     private finished;
+    private lifecycleSink?;
+    private lifecycleBacklog;
     constructor(client: Client | undefined, name: string, op?: string | undefined, sampled?: boolean, 
     /** 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
+     * 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;
+    /** 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;
@@ -272,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, 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, 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 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, SpanStatus, SpanData, CheckInStatus } from './protocol.js';
-export { AgentInfo, Envelope, EnvelopeItem, ExceptionData, PollRequest, PollResponse, RunDescriptor, RunError, RunLogEntry, RunLogLevel, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.js';
+import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, RunLogLevel, SpanStatus, SpanData, 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. */
 declare const DEFAULT_BASE_URL = "https://api2.hobots.app";
@@ -64,6 +64,8 @@ declare class Client {
     close(timeoutMs?: number): Promise<boolean>;
 }
 
+/** Recebe os eventos de lifecycle da transaction para espelhá-los nos logs da run. */
+type LifecycleSink = (level: RunLogLevel, message: string) => void;
 declare class Span {
     private readonly transaction;
     readonly parentSpanId: string;
@@ -100,9 +102,19 @@ declare class Transaction {
     private readonly spans;
     private readonly tags;
     private finished;
+    private lifecycleSink?;
+    private lifecycleBacklog;
     constructor(client: Client | undefined, name: string, op?: string | undefined, sampled?: boolean, 
     /** 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
+     * 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;
+    /** 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;
@@ -272,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, 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, 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 };

package/dist/index.js

@@ -103,7 +103,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "1.7.1" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.7.2" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -662,12 +662,6 @@ var Scope = class _Scope {
 function spanId() {
   return uuid4().slice(0, 16);
 }
-function printSpanLog(kind, phase, label, startTs, endTs) {
-  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 suffix = durationMs != null ? ` (${durationMs}ms)` : "";
-  console.log(`${tag} ${label}${suffix}`);
-}
 function spanLabel(op, description) {
   return [op, description].filter(Boolean).join(" \u2014 ") || "(sem nome)";
 }
@@ -698,7 +692,7 @@ var Span = class {
   finish() {
     if (this.endTimestamp) return;
     this.endTimestamp = nowISO();
-    printSpanLog("span", "finish", spanLabel(this.op, this.description), this.startTimestamp, this.endTimestamp);
+    this.transaction.emit("span", "finish", spanLabel(this.op, this.description), this.startTimestamp, this.endTimestamp);
   }
   toJSON() {
     return {
@@ -720,7 +714,7 @@ var Transaction = class {
     this.op = op;
     this.sampled = sampled;
     this.runId = runId;
-    printSpanLog("transaction", "start", op ? `${name} (${op})` : name);
+    this.emit("transaction", "start", op ? `${name} (${op})` : name);
   }
   eventId = uuid4();
   spanId = spanId();
@@ -729,10 +723,36 @@ var Transaction = class {
   spans = [];
   tags = {};
   finished = false;
+  lifecycleSink;
+  // eventos emitidos antes do sink existir (o START da transaction sai no construtor,
+  // antes do RunReporter conectar) — replay no setLifecycleSink
+  lifecycleBacklog = [];
+  /**
+   * Ecoa no terminal o início/fim de um span 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) {
+    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 suffix = durationMs != null ? ` (${durationMs}ms)` : "";
+    console.log(`${tag} ${label}${suffix}`);
+    const level = phase === "finish" ? "success" : "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]);
+  }
+  /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */
+  setLifecycleSink(sink) {
+    this.lifecycleSink = sink;
+    const backlog = this.lifecycleBacklog;
+    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);
-    printSpanLog("span", "start", spanLabel(op, description));
+    this.emit("span", "start", spanLabel(op, description));
     return span;
   }
   /** Span direto da transaction. */
@@ -756,7 +776,7 @@ var Transaction = class {
     this.finished = true;
     for (const span of this.spans) span.finish();
     const endTimestamp = nowISO();
-    printSpanLog(
+    this.emit(
       "transaction",
       "finish",
       this.op ? `${this.name} (${this.op})` : this.name,
@@ -964,6 +984,7 @@ var RunReporter = class {
       error: (message) => this.log("error", message),
       success: (message) => this.log("success", message)
     };
+    tx.setLifecycleSink((level, message) => this.push(level, message));
     const signal = this.abortController.signal;
     this.context = {
       runId,
@@ -1021,6 +1042,12 @@ var RunReporter = class {
     if (this.dead) return;
     const scrubbed = scrubSecrets(message);
     printRunLog(this.context.task, level, scrubbed);
+    this.push(level, scrubbed, true);
+  }
+  /** Bufferiza uma entrada de log sem eco no terminal (cap, truncate, flush). */
+  push(level, message, alreadyScrubbed = false) {
+    if (this.dead) return;
+    const scrubbed = alreadyScrubbed ? message : scrubSecrets(message);
     if (this.loggedCount >= MAX_LOGS_PER_RUN) {
       this.droppedCount++;
       return;
@@ -1417,15 +1444,16 @@ var TaskAgent = class {
       this.logger.debug(`executando run ${run.id} (${run.task})`);
       try {
         await runWithRunContext({ runId: run.id, tx }, () => this.invokeWithTimeout(handler, run, reporter));
-        reporter.reportSuccess();
         tx.setStatus("ok");
+        tx.finish();
+        reporter.reportSuccess();
         this.logger.debug(`run ${run.id} conclu\xEDda`);
       } catch (error) {
-        reporter.reportFailure(toRunError(error));
         tx.setStatus("error");
+        tx.finish();
+        reporter.reportFailure(toRunError(error));
         this.logger.debug(`run ${run.id} falhou: ${String(error)}`);
       }
-      tx.finish();
       await reporter.finalize();
     } finally {
       this.reporters.delete(reporter);