hobots 1.7.5 → 1.8.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, SpanStatus, RunLogLevel, SpanData, CheckInStatus } from './protocol.cjs';
+import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData } 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. */
@@ -58,7 +58,6 @@ declare class Client {
     captureEvent(event: EventPayload, hint: CaptureHint | undefined, scope: Scope): string;
     private prepareEvent;
     sendTransaction(payload: TransactionPayload): void;
-    sendCheckIn(payload: CheckInPayload): void;
     sendHeartbeat(payload: HeartbeatPayload): void;
     flush(timeoutMs?: number): Promise<boolean>;
     close(timeoutMs?: number): Promise<boolean>;
@@ -66,27 +65,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 +95,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 +107,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, status?: SpanStatus | 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;
@@ -232,18 +231,6 @@ interface CaptureHint {
     fingerprint?: string[];
 }
 
-interface CheckInOptions {
-    monitorSlug: string;
-    status: CheckInStatus;
-    /** Reutilize o id retornado pelo check-in 'in_progress' para fechar a execução */
-    checkInId?: string;
-    durationMs?: number;
-    /** Expressão cron — cria/atualiza o monitor automaticamente no servidor */
-    schedule?: string;
-    timezone?: string;
-}
-type WithMonitorOptions = Pick<CheckInOptions, 'schedule' | 'timezone'>;
-
 /** Inicializa o SDK. Chame uma vez, o mais cedo possível no programa. */
 declare function init(options: InitOptions): void;
 declare function getClient(): Client | undefined;
@@ -261,10 +248,6 @@ declare function setExtra(key: string, value: unknown): void;
 declare function withScope<T>(callback: (scope: Scope) => T): T;
 /** Inicia uma transaction de performance. Chame .finish() para enviá-la. */
 declare function startTransaction(name: string, op?: string): Transaction;
-/** Check-in manual de um monitor cron. Retorna o check_in_id para fechar a execução depois. */
-declare function checkIn(options: CheckInOptions): string | undefined;
-/** Envolve um job monitorado: envia in_progress → ok/error com duração e captura a exceção em caso de falha. */
-declare function withMonitor<T>(monitorSlug: string, fn: () => T | Promise<T>, options?: WithMonitorOptions): Promise<T>;
 /** Aguarda o envio de tudo que está na fila (até timeoutMs). */
 declare function flush(timeoutMs?: number): Promise<boolean>;
 /** Registra o handler de uma task (o task_slug configurado no formulário do app, em Configurações → Formulários). */
@@ -284,4 +267,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, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, type RunContext, RunLogLevel, Scope, Severity, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withScope };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, CheckInPayload, HeartbeatPayload, SpanStatus, RunLogLevel, SpanData, CheckInStatus } from './protocol.js';
+import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData } 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. */
@@ -58,7 +58,6 @@ declare class Client {
     captureEvent(event: EventPayload, hint: CaptureHint | undefined, scope: Scope): string;
     private prepareEvent;
     sendTransaction(payload: TransactionPayload): void;
-    sendCheckIn(payload: CheckInPayload): void;
     sendHeartbeat(payload: HeartbeatPayload): void;
     flush(timeoutMs?: number): Promise<boolean>;
     close(timeoutMs?: number): Promise<boolean>;
@@ -66,27 +65,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 +95,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 +107,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, status?: SpanStatus | 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;
@@ -232,18 +231,6 @@ interface CaptureHint {
     fingerprint?: string[];
 }
 
-interface CheckInOptions {
-    monitorSlug: string;
-    status: CheckInStatus;
-    /** Reutilize o id retornado pelo check-in 'in_progress' para fechar a execução */
-    checkInId?: string;
-    durationMs?: number;
-    /** Expressão cron — cria/atualiza o monitor automaticamente no servidor */
-    schedule?: string;
-    timezone?: string;
-}
-type WithMonitorOptions = Pick<CheckInOptions, 'schedule' | 'timezone'>;
-
 /** Inicializa o SDK. Chame uma vez, o mais cedo possível no programa. */
 declare function init(options: InitOptions): void;
 declare function getClient(): Client | undefined;
@@ -261,10 +248,6 @@ declare function setExtra(key: string, value: unknown): void;
 declare function withScope<T>(callback: (scope: Scope) => T): T;
 /** Inicia uma transaction de performance. Chame .finish() para enviá-la. */
 declare function startTransaction(name: string, op?: string): Transaction;
-/** Check-in manual de um monitor cron. Retorna o check_in_id para fechar a execução depois. */
-declare function checkIn(options: CheckInOptions): string | undefined;
-/** Envolve um job monitorado: envia in_progress → ok/error com duração e captura a exceção em caso de falha. */
-declare function withMonitor<T>(monitorSlug: string, fn: () => T | Promise<T>, options?: WithMonitorOptions): Promise<T>;
 /** Aguarda o envio de tudo que está na fila (até timeoutMs). */
 declare function flush(timeoutMs?: number): Promise<boolean>;
 /** Registra o handler de uma task (o task_slug configurado no formulário do app, em Configurações → Formulários). */
@@ -284,4 +267,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, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, type RunContext, RunLogLevel, Scope, Severity, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, 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.5" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.8.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -457,16 +457,6 @@ var Client = class {
       }
     });
   }
-  sendCheckIn(payload) {
-    this.transport.enqueue({
-      type: "check_in",
-      payload: {
-        ...payload,
-        release: payload.release ?? this.options.release,
-        environment: payload.environment ?? this.options.environment ?? "production"
-      }
-    });
-  }
   sendHeartbeat(payload) {
     this.transport.enqueue({
       type: "heartbeat",
@@ -659,10 +649,10 @@ 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)";
 }
 function levelForStatus(status) {
@@ -689,14 +679,14 @@ function colorForStatus(status) {
       return "green";
   }
 }
-var Span = class {
-  constructor(transaction, parentSpanId, op, description) {
+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;
@@ -709,17 +699,17 @@ 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",
+      "step",
       "finish",
-      spanLabel(this.op, this.description),
+      stepLabel(this.op, this.description),
       this.startTimestamp,
       this.endTimestamp,
       this.status
@@ -727,8 +717,8 @@ var Span = class {
   }
   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,
@@ -748,10 +738,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;
@@ -759,7 +749,7 @@ 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.
    */
@@ -780,15 +770,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;
@@ -805,7 +795,7 @@ 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",
@@ -823,7 +813,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
     };
@@ -831,34 +821,6 @@ var Transaction = class {
   }
 };
 
-// src/checkin.ts
-function sendCheckIn(client2, options) {
-  const checkInId = options.checkInId ?? uuid4();
-  client2.sendCheckIn({
-    check_in_id: checkInId,
-    monitor_slug: options.monitorSlug,
-    status: options.status,
-    duration_ms: options.durationMs,
-    schedule: options.schedule,
-    timezone: options.timezone
-  });
-  return checkInId;
-}
-async function withMonitorImpl(client2, captureError, monitorSlug, fn, options) {
-  const base = { monitorSlug, schedule: options?.schedule, timezone: options?.timezone };
-  const checkInId = sendCheckIn(client2, { ...base, status: "in_progress" });
-  const startedAt = Date.now();
-  try {
-    const result = await fn();
-    sendCheckIn(client2, { ...base, status: "ok", checkInId, durationMs: Date.now() - startedAt });
-    return result;
-  } catch (error) {
-    sendCheckIn(client2, { ...base, status: "error", checkInId, durationMs: Date.now() - startedAt });
-    captureError(error);
-    throw error;
-  }
-}
-
 // src/tasks/api.ts
 var POLL_TIMEOUT_MS = 3e4;
 var UPDATE_TIMEOUT_MS = 1e4;
@@ -1404,7 +1366,7 @@ var TaskAgent = class {
         {
           agent: {
             // identidade canônica do agente no painel — o mesmo instanceId do
-            // heartbeat do Monitor, então os dois canais convergem em um agente
+            // heartbeat da Telemetria, então os dois canais convergem em um agente
             instance_id: this.instanceId,
             version: SDK_VERSION,
             host: hostname(),
@@ -1606,19 +1568,6 @@ function startTransaction(name, op) {
   const sampled = rate >= 1 || Math.random() < rate;
   return new Transaction(client, name, op, sampled);
 }
-function checkIn(options) {
-  return client ? sendCheckIn(client, options) : void 0;
-}
-async function withMonitor(monitorSlug, fn, options) {
-  if (!client) return fn();
-  return withMonitorImpl(
-    client,
-    (error) => captureException(error, { tags: { monitor: monitorSlug } }),
-    monitorSlug,
-    fn,
-    options
-  );
-}
 function flush(timeoutMs) {
   return client ? client.flush(timeoutMs) : Promise.resolve(true);
 }
@@ -1654,12 +1603,11 @@ export {
   Client,
   DEFAULT_BASE_URL,
   Scope,
-  Span,
+  Step,
   Transaction,
   addBreadcrumb,
   captureException,
   captureMessage,
-  checkIn,
   close,
   flush,
   getClient,
@@ -1674,7 +1622,6 @@ export {
   start,
   startTransaction,
   stop,
-  withMonitor,
   withScope
 };
 //# sourceMappingURL=index.js.map