hobots 1.10.0 → 2.0.0

package/dist/index.cjs

@@ -161,7 +161,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "1.10.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "2.0.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -354,7 +354,8 @@ var Transport = class {
       return;
     }
     if (this.buffer.length >= this.maxQueueSize) {
-      this.buffer.shift();
+      const dropIndex = this.buffer.findIndex((queued) => queued.type !== "heartbeat");
+      this.buffer.splice(dropIndex === -1 ? 0 : dropIndex, 1);
       this.logger.warn("fila cheia, item mais antigo descartado");
     }
     this.buffer.push(item);
@@ -445,6 +446,8 @@ function runtimeContexts() {
 }
 var Client = class {
   logger;
+  /** Eco de lifecycle (Transaction.emit) e afins só imprimem no terminal com debug ligado. */
+  debug;
   // campos privados + getters de protótipo: o clientSecret não aparece em
   // JSON.stringify/serialização enumerável do Client (ex.: um objeto capturado
   // que referencie o client), mas client.options/config seguem funcionando
@@ -453,7 +456,8 @@ var Client = class {
   transport;
   constructor(options, config = resolveConfig(options)) {
     this.#options = options;
-    this.logger = makeLogger(!!options.debug);
+    this.debug = !!options.debug;
+    this.logger = makeLogger(this.debug);
     this.#config = config;
     this.transport = new Transport({
       endpoint: this.#config.ingestEndpoint,
@@ -540,6 +544,8 @@ var Client = class {
 
 // src/heartbeat.ts
 var DEFAULT_INTERVAL_MS = 3e4;
+var MIN_REPORTED_INTERVAL_MS = 1e3;
+var MAX_REPORTED_INTERVAL_MS = 9e5;
 var Heartbeat = class {
   constructor(client2, options = {}, instanceId) {
     this.client = client2;
@@ -556,12 +562,22 @@ var Heartbeat = class {
   start() {
     if (this.timer) return;
     this.beat();
-    this.timer = setInterval(() => this.beat(), this.intervalMs);
+    this.schedule();
+  }
+  /** Jitter de ±10%: uma frota iniciada junto não sincroniza todos os beats no mesmo segundo. */
+  schedule() {
+    this.timer = setTimeout(
+      () => {
+        this.beat();
+        this.schedule();
+      },
+      this.intervalMs * (0.9 + Math.random() * 0.2)
+    );
     unrefTimer(this.timer);
   }
   stop() {
     if (this.timer) {
-      clearInterval(this.timer);
+      clearTimeout(this.timer);
       this.timer = void 0;
     }
   }
@@ -569,7 +585,7 @@ var Heartbeat = class {
     this.client.sendHeartbeat({
       instance_id: this.instanceId,
       name: this.name,
-      interval_ms: this.intervalMs,
+      interval_ms: Math.min(Math.max(this.intervalMs, MIN_REPORTED_INTERVAL_MS), MAX_REPORTED_INTERVAL_MS),
       timestamp: nowISO(),
       metadata: this.metadata
     });
@@ -816,15 +832,18 @@ var Transaction = class {
   // antes do RunReporter conectar) — replay no setLifecycleSink
   lifecycleBacklog = [];
   /**
-   * 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.
+   * Registra o início/fim de uma step ou transaction: espelha a linha no sink de
+   * lifecycle, se conectado (é assim que os eventos de performance aparecem nos
+   * 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) {
     const durationMs = startTs && endTs ? new Date(endTs).getTime() - new Date(startTs).getTime() : void 0;
-    const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? colorForStatus(status ?? "ok") : "cyan");
     const suffix = durationMs != null ? ` (${durationMs}ms)` : "";
-    console.log(`${tag} ${label}${suffix}`);
+    if (this.client?.debug) {
+      const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? colorForStatus(status ?? "ok") : "cyan");
+      console.log(`${tag} ${label}${suffix}`);
+    }
     const level = phase === "finish" ? levelForStatus(status ?? "ok") : "info";
     const message = `[${kind}] ${phase.toUpperCase()} ${label}${suffix}`;
     if (this.lifecycleSink) this.lifecycleSink(level, message);
@@ -1871,13 +1890,17 @@ var TaskAgent = class {
     try {
       const response = await this.api.poll(
         {
-          agent: {
+          instance: {
             // identidade canônica do agente no painel — o mesmo instanceId do
             // heartbeat da Telemetria, então os dois canais convergem em um agente
             instance_id: this.instanceId,
             version: SDK_VERSION,
             host: hostname(),
-            tasks: [...this.registry.keys()]
+            tasks: [...this.registry.keys()],
+            // o servidor calcula a tolerância de offline (3×) a partir disto em
+            // agentes poll-only — sem o campo, um poll lento flaparia offline/online.
+            // Clampado à faixa aceita pelo schema do poll (1s..15min).
+            poll_interval_ms: Math.min(Math.max(this.pollIntervalMs, 1e3), 9e5)
           },
           max: Math.min(MAX_CONCURRENCY, this.concurrency - this.activeRuns.size),
           tasks: [...this.registry.keys()]