hobots 5.1.0 → 5.2.0

package/dist/index.d.cts

@@ -272,7 +272,8 @@ interface RunItemOptions extends RunItemImageOptions {
 /**
  * O item em processamento dentro de `items.each`: o desfecho (`succeeded`/`failed`/
  * `occurrence`) com o `id` e o payload base já resolvidos, e o handle `step` da etapa do
- * item (`warning`/`image`/`data`). Sub-etapas: `hobots.step(...)` dentro do handler já
+ * item (`warning`/`image`/`data`), e `data(...)` para ir guardando o payload do item sem
+ * decidir o desfecho. Sub-etapas: `hobots.step(...)` dentro do handler já
  * aninha na etapa do item. Sem chamada explícita, o SDK decide: retornou → `succeeded`;
  * lançou → `failed` com a mensagem do erro.
  */
@@ -289,7 +290,14 @@ interface RunItemHandle {
     readonly status: RunItemStatus | undefined;
     /** Tentativa em curso (1-based) — o handler pode ler para logar. */
     readonly attempt: number;
-    /** Item processado com sucesso. `payload` é mesclado sobre o payload base de `options.payload`. */
+    /**
+     * Guarda atributos do item sem registrar desfecho — vai mesclando a cada chamada (chave repetida:
+     * a última vence). Entra em qualquer desfecho, inclusive nos implícitos (handler retornou →
+     * `succeeded`; lançou → `failed`), entre o payload base de `options.payload` e o payload da
+     * chamada de desfecho. Uma nova tentativa começa do zero. Depois do desfecho só acumula: nada é reenviado.
+     */
+    data(payload: Record<string, unknown>): void;
+    /** Item processado com sucesso. `payload` é mesclado sobre o payload base e o de `item.data`. */
     succeeded(payload?: Record<string, unknown>, options?: RunItemImageOptions): void;
     /** Falha sem lançar — o loop segue igual; a etapa vira `error` com o motivo. A imagem vai no item. */
     failed(message: string, payload?: Record<string, unknown>, options?: RunItemImageOptions): void;

package/dist/index.d.ts

@@ -272,7 +272,8 @@ interface RunItemOptions extends RunItemImageOptions {
 /**
  * O item em processamento dentro de `items.each`: o desfecho (`succeeded`/`failed`/
  * `occurrence`) com o `id` e o payload base já resolvidos, e o handle `step` da etapa do
- * item (`warning`/`image`/`data`). Sub-etapas: `hobots.step(...)` dentro do handler já
+ * item (`warning`/`image`/`data`), e `data(...)` para ir guardando o payload do item sem
+ * decidir o desfecho. Sub-etapas: `hobots.step(...)` dentro do handler já
  * aninha na etapa do item. Sem chamada explícita, o SDK decide: retornou → `succeeded`;
  * lançou → `failed` com a mensagem do erro.
  */
@@ -289,7 +290,14 @@ interface RunItemHandle {
     readonly status: RunItemStatus | undefined;
     /** Tentativa em curso (1-based) — o handler pode ler para logar. */
     readonly attempt: number;
-    /** Item processado com sucesso. `payload` é mesclado sobre o payload base de `options.payload`. */
+    /**
+     * Guarda atributos do item sem registrar desfecho — vai mesclando a cada chamada (chave repetida:
+     * a última vence). Entra em qualquer desfecho, inclusive nos implícitos (handler retornou →
+     * `succeeded`; lançou → `failed`), entre o payload base de `options.payload` e o payload da
+     * chamada de desfecho. Uma nova tentativa começa do zero. Depois do desfecho só acumula: nada é reenviado.
+     */
+    data(payload: Record<string, unknown>): void;
+    /** Item processado com sucesso. `payload` é mesclado sobre o payload base e o de `item.data`. */
     succeeded(payload?: Record<string, unknown>, options?: RunItemImageOptions): void;
     /** Falha sem lançar — o loop segue igual; a etapa vira `error` com o motivo. A imagem vai no item. */
     failed(message: string, payload?: Record<string, unknown>, options?: RunItemImageOptions): void;

package/dist/index.js

@@ -4,7 +4,7 @@ import {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "5.1.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "5.2.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -1873,6 +1873,10 @@ var ItemHandle = class {
   reported = false;
   status;
   attempt = 1;
+  accumulated = {};
+  data(payload) {
+    Object.assign(this.accumulated, payload);
+  }
   succeeded(payload, options) {
     this.record("succeeded", void 0, payload, options?.image);
   }
@@ -1889,6 +1893,7 @@ var ItemHandle = class {
     this.attempt = attempt;
     this.reported = false;
     this.status = void 0;
+    this.accumulated = {};
     if (this.step && (this.step.status === "error" || this.step.status === "warning")) {
       this.step._setStatus("ok");
       this.step._deleteData("message");
@@ -1897,7 +1902,7 @@ var ItemHandle = class {
   record(status, message, payload, image3) {
     this.reported = true;
     this.status = status;
-    const merged = { ...this.basePayload ?? {}, ...payload ?? {} };
+    const merged = { ...this.basePayload ?? {}, ...this.accumulated, ...payload ?? {} };
     this.sink.report(status, message, Object.keys(merged).length > 0 ? merged : void 0, this.id, image3);
   }
 };