fg-tracker-sdk 0.13.0 → 0.14.0

package/dist/pg.d.ts

@@ -7,8 +7,18 @@ import type { PgPoolLike } from './types.js';
  * - `pool.connect()`: span `custom` `pg connect` com a espera por conexão (`db.poolWaitMs`) e a
  *   ocupação do pool; o client devolvido também gera spans `db.query`;
  * - transação num client (`BEGIN` … `COMMIT`/`ROLLBACK`): span `custom` `pg transaction`, pai das
- *   queries dela, com `db.transaction.outcome` (`commit`, `rollback` ou `released_open` quando o
- *   client volta ao pool com a transação aberta).
+ *   queries dela, com `db.transaction.outcome` (`commit`, `rollback`, `prepared` ou `released_open`
+ *   quando o client volta ao pool com a transação aberta).
+ *
+ * Quem é pai de uma query num client com transação aberta (CONTRATO.md §16.1):
+ * - a mesma execução que abriu a transação (mesma raiz local, ou a raiz de mensagem que o
+ *   `trackMessage` abriu dentro dela), com as mesmas decisões de amostragem e exclusão: a transação,
+ *   salvo com um COMMIT/ROLLBACK dela já a caminho;
+ * - outra execução (outra requisição, mesmo do mesmo trace distribuído): o próprio contexto, com as
+ *   próprias decisões; se rodar dentro da transação confirmada, leva `links` para ela e
+ *   `db.transaction.foreign: true`;
+ * - quem envia sem contexto: a transação só na janela confirmada pelo servidor (BEGIN respondido,
+ *   nenhum comando de encerramento em voo em nenhuma leitura do texto); fora dela, nenhum span.
  */
 export declare function instrumentPgPool<T extends PgPoolLike>(core: TrackerCore, pool: T): T;
 //# sourceMappingURL=pg.d.ts.map

package/dist/pg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../src/pg.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiQ7C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAuTpF"}
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../src/pg.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAyY7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAgbpF"}