fg-tracker-sdk 0.9.0 → 0.11.0

package/dist/infra/lambda.d.ts

@@ -1,3 +1,4 @@
+import { type SpanContext } from '../context.js';
 import type { TrackerCore } from '../tracker.js';
 /** Contexto mínimo da Lambda (tipo estrutural; sem `@types/aws-lambda`). */
 export interface LambdaContextLike {
@@ -13,7 +14,24 @@ export interface WrapLambdaOptions {
     flushTimeoutMs?: number;
     /** Cria um span raiz `custom` por invocação (spans de AWS/db/fetch passam a formar um trace). Default `true`. */
     span?: boolean;
+    /**
+     * Continua o trace de um evento de origem única: uma mensagem SQS (`Records` com um record),
+     * um evento do EventBridge (`detail.traceparent`) ou uma requisição HTTP (API Gateway, ALB,
+     * Function URL: header `traceparent`). Lote com várias mensagens fica num trace próprio, com
+     * links para cada produtor. Default `true`.
+     */
+    continueTrace?: boolean;
 }
+interface InvocationOrigin {
+    /** Contexto de um evento de origem única. */
+    remote?: SpanContext;
+    /** Contextos das mensagens de um lote (viram links). */
+    batch?: (SpanContext | undefined)[];
+    /** `aws:sqs`, `aws.events`, `http`. */
+    source?: string;
+}
+/** De onde veio a invocação e qual contexto ela traz; nunca lança. */
+export declare function invocationOrigin(event: unknown): InvocationOrigin;
 /** Caminho do executável da camada `fg-tracker-lambda-extension`. */
 export declare const LAMBDA_EXTENSION_PATH = "/opt/extensions/fg-tracker-extension";
 export declare function hasLambdaExtension(): boolean;
@@ -24,4 +42,5 @@ export declare function flushWithTimeout(core: TrackerCore, timeoutMs: number):
  * a fila sobrevive ao congelamento e é enviada no SIGTERM do encerramento.
  */
 export declare function wrapLambdaHandler<E, R, C extends LambdaContextLike>(core: TrackerCore, handler: LambdaHandler<E, R, C>, options?: WrapLambdaOptions): LambdaHandler<E, R, C>;
+export {};
 //# sourceMappingURL=lambda.d.ts.map

package/dist/infra/lambda.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lambda.d.ts","sourceRoot":"","sources":["../../src/infra/lambda.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,MAAM,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhJ,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iHAAiH;IACjH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAI5E,wBAAgB,kBAAkB,IAAI,OAAO,CAS5C;AAgBD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1F;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,iBAAiB,EACjE,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAiCxB"}
+{"version":3,"file":"lambda.d.ts","sourceRoot":"","sources":["../../src/infra/lambda.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,MAAM,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhJ,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iHAAiH;IACjH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,gBAAgB;IACxB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC;IACpC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAqBjE;AAED,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAI5E,wBAAgB,kBAAkB,IAAI,OAAO,CAS5C;AAgBD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1F;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,iBAAiB,EACjE,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAyCxB"}

package/dist/infra/lambda.js

@@ -1,4 +1,41 @@
 import { existsSync } from 'node:fs';
+import { parseTraceContext } from '../context.js';
+import { metaContext, readEventBridgeDetail, readSqsMessage, uniqueLinks } from './messaging.js';
+function headerValue(headers, name) {
+    if (!headers || typeof headers !== 'object')
+        return undefined;
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === name && typeof value === 'string')
+            return value;
+    }
+    return undefined;
+}
+/** De onde veio a invocação e qual contexto ela traz; nunca lança. */
+export function invocationOrigin(event) {
+    try {
+        if (!event || typeof event !== 'object')
+            return {};
+        const record = event;
+        if (Array.isArray(record.Records)) {
+            const sqs = record.Records.filter((item) => item?.eventSource === 'aws:sqs');
+            if (sqs.length === 0 || sqs.length !== record.Records.length)
+                return {};
+            const contexts = sqs.map((item) => metaContext(readSqsMessage(item)));
+            return sqs.length === 1 ? { remote: contexts[0], source: 'aws:sqs' } : { batch: contexts, source: 'aws:sqs' };
+        }
+        if (typeof record['detail-type'] === 'string' && typeof record.source === 'string') {
+            return { remote: readEventBridgeDetail(record.detail), source: 'aws.events' };
+        }
+        if (record.headers && typeof record.headers === 'object') {
+            const remote = parseTraceContext(headerValue(record.headers, 'traceparent'), headerValue(record.headers, 'tracestate'));
+            return remote ? { remote, source: 'http' } : {};
+        }
+    }
+    catch {
+        /* evento em formato inesperado: segue sem contexto */
+    }
+    return {};
+}
 /** Caminho do executável da camada `fg-tracker-lambda-extension`. */
 export const LAMBDA_EXTENSION_PATH = '/opt/extensions/fg-tracker-extension';
 let extensionDetected;
@@ -33,7 +70,8 @@ export async function flushWithTimeout(core, timeoutMs) {
         timer.unref?.();
     });
     try {
-        await Promise.race([core.flush(true).catch(() => undefined), timeout]);
+        // O prazo vai para o envio: a requisição é abortada nele e nada fica pendurado no congelamento.
+        await Promise.race([core.flushUntil(Date.now() + timeoutMs).catch(() => undefined), timeout]);
     }
     finally {
         if (timer)
@@ -49,6 +87,7 @@ let coldStart = true;
 export function wrapLambdaHandler(core, handler, options = {}) {
     const flushTimeoutMs = Math.max(50, options.flushTimeoutMs ?? 1000);
     const withSpan = options.span ?? true;
+    const continueTrace = options.continueTrace ?? true;
     return async function fgTrackerLambda(event, context) {
         if (!core.enabled)
             return handler(event, context);
@@ -56,15 +95,29 @@ export function wrapLambdaHandler(core, handler, options = {}) {
         if (extension)
             installSigtermFlush(core, flushTimeoutMs);
         const functionName = context?.functionName ?? process.env.AWS_LAMBDA_FUNCTION_NAME ?? 'lambda';
-        const span = withSpan
-            ? core.startSpan('custom', `lambda ${functionName}`, {
-                'faas.name': functionName,
-                'faas.coldStart': coldStart,
-                ...(context?.awsRequestId ? { 'faas.requestId': context.awsRequestId } : {}),
-                ...(context?.invokedFunctionArn ? { 'aws.resourceArn': context.invokedFunctionArn } : {}),
-                ...(process.env.AWS_REGION ? { 'aws.region': process.env.AWS_REGION } : {}),
-            }, null)
-            : null;
+        const origin = withSpan && continueTrace ? invocationOrigin(event) : {};
+        const attributes = {
+            'faas.name': functionName,
+            'faas.coldStart': coldStart,
+            ...(context?.awsRequestId ? { 'faas.requestId': context.awsRequestId } : {}),
+            ...(context?.invokedFunctionArn ? { 'aws.resourceArn': context.invokedFunctionArn } : {}),
+            ...(process.env.AWS_REGION ? { 'aws.region': process.env.AWS_REGION } : {}),
+            ...(origin.source ? { 'faas.trigger.source': origin.source } : {}),
+        };
+        if (origin.batch) {
+            attributes['messaging.batch.message_count'] = origin.batch.length;
+            const { links, dropped } = uniqueLinks(origin.batch);
+            if (links.length > 0)
+                attributes.links = links;
+            if (dropped > 0)
+                attributes['links.dropped'] = dropped;
+        }
+        const name = `lambda ${functionName}`;
+        const span = !withSpan
+            ? null
+            : origin.remote
+                ? core.startRemoteRoot('custom', name, attributes, origin.remote)
+                : core.startSpan('custom', name, attributes, null);
         coldStart = false;
         try {
             return await (span ? core.runInSpan(span, () => handler(event, context)) : handler(event, context));

package/dist/infra/lambda.js.map

@@ -1 +1 @@
-{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../src/infra/lambda.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../src/infra/lambda.ts"],"names":[],"mappings":"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"}

package/dist/infra/messaging.d.ts

@@ -0,0 +1,133 @@
+import { type SpanContext } from '../context.js';
+/**
+ * Propagação do contexto W3C por mensagens (CONTRATO.md §16.1): `traceparent`/`tracestate` em
+ * `MessageAttributes` do SQS e no `Detail` do EventBridge, dentro das cotas de cada serviço.
+ * A regra é sempre a mesma: se o contexto não cabe, a mensagem segue exatamente como o usuário a
+ * montou. A publicação nunca falha por causa da instrumentação.
+ */
+/** SQS: no máximo 10 atributos por mensagem. */
+export declare const SQS_MAX_MESSAGE_ATTRIBUTES = 10;
+/** SQS: 1 MiB por mensagem (corpo + nome, tipo e valor dos atributos) e por lote (soma das entradas). */
+export declare const SQS_MAX_MESSAGE_BYTES = 1048576;
+export declare const SQS_MAX_BATCH_BYTES = 1048576;
+/** Menor `MaximumMessageSize` que uma fila aceita: abaixo disto nenhuma fila recusa por tamanho. */
+export declare const SQS_MIN_MESSAGE_BYTES = 1024;
+/** EventBridge `PutEvents`: a soma das entradas tem de ficar abaixo de 1 MiB. */
+export declare const EVENTBRIDGE_MAX_REQUEST_BYTES = 1048576;
+/** Atributos de mensagem que a instrumentação lê (o SQS só os devolve quando pedidos). */
+export declare const SQS_CONTEXT_ATTRIBUTES: readonly ["traceparent", "tracestate"];
+/** Atributos de sistema que dão o atraso de fila e as tentativas. */
+export declare const SQS_SYSTEM_ATTRIBUTES: readonly ["SentTimestamp", "ApproximateReceiveCount"];
+/** No máximo tantos links por span; o resto é contado em `links.dropped`. */
+export declare const MAX_LINKS = 32;
+export type PropagationSkip = 'present' | 'attribute_limit' | 'size_limit' | 'batch_size_limit' | 'not_json_object';
+export interface SqsAttributeValueLike {
+    DataType?: string;
+    StringValue?: string;
+    BinaryValue?: Uint8Array;
+    [key: string]: unknown;
+}
+/** Bytes de um atributo de mensagem como o SQS conta: nome + tipo + valor. */
+export declare function sqsAttributeBytes(name: string, value: unknown): number;
+/** Tamanho de uma mensagem SQS como a cota conta: corpo + atributos de mensagem. */
+export declare function sqsMessageBytes(body: unknown, attributes: unknown): number;
+export interface SqsInjection<E> {
+    entry: E;
+    injected: boolean;
+    addedBytes: number;
+    skipped?: PropagationSkip;
+}
+/**
+ * Acrescenta o contexto aos `MessageAttributes` de uma mensagem (`SendMessage` ou entrada de
+ * `SendMessageBatch`) quando cabe: atributo livre (máx. 10), bytes livres na mensagem e no
+ * orçamento do lote (`budgetBytes`). Sem espaço para os dois, vai só o `traceparent`. Contexto já
+ * presente fica como está. A entrada original nunca é alterada: a injetada é uma cópia.
+ */
+export declare function injectSqsContext<E extends Record<string, unknown>>(entry: E, ctx: SpanContext, limits: {
+    messageBytes: number;
+    budgetBytes: number;
+}): SqsInjection<E>;
+/**
+ * `MD5OfMessageAttributes` pelo algoritmo do SQS: atributos em ordem de nome; para cada um,
+ * tamanho (4 bytes, big-endian) + nome, tamanho + tipo, 1 byte de transporte (1 = String/Number,
+ * 2 = Binary) e tamanho + valor. `undefined` quando não há atributo.
+ */
+export declare function sqsAttributesMd5(attributes: unknown): string | undefined;
+export interface ReceivePlan {
+    input: Record<string, unknown>;
+    /** Atributos de mensagem que só a instrumentação pediu (removidos da resposta). */
+    extraMessageAttributes: string[];
+    /** Atributos de sistema que só a instrumentação pediu (removidos da resposta). */
+    extraSystemAttributes: string[];
+}
+/**
+ * `ReceiveMessage`: acrescenta `traceparent`/`tracestate` a `MessageAttributeNames` e
+ * `SentTimestamp`/`ApproximateReceiveCount` aos atributos de sistema, preservando o que o chamador
+ * pediu (`All` fica como está). Quem usa o campo legado `AttributeNames` recebe os de sistema nele.
+ */
+export declare function planReceive(input: Record<string, unknown>): ReceivePlan;
+/** O que a instrumentação leu de uma mensagem recebida. */
+export interface MessageMeta {
+    traceparent?: string;
+    tracestate?: string;
+    sentTimestamp?: number;
+    receiveCount?: number;
+    messageId?: string;
+}
+/**
+ * Lê o contexto e os atributos de sistema de uma mensagem SQS, no formato do AWS SDK v3
+ * (`MessageAttributes`/`Attributes`/`MessageId`) ou do evento da Lambda
+ * (`messageAttributes`/`attributes`/`messageId`).
+ */
+export declare function readSqsMessage(record: unknown): MessageMeta;
+export declare function metaContext(meta: MessageMeta | undefined): SpanContext | undefined;
+/**
+ * Remove de uma mensagem recebida o que só a instrumentação pediu e recalcula o
+ * `MD5OfMessageAttributes` sobre o que sobra (ou remove o campo quando não sobra atributo).
+ * Sem nada removido, a mensagem volta a mesma.
+ */
+export declare function stripReceivedMessage(message: Record<string, unknown>, plan: ReceivePlan): Record<string, unknown>;
+/**
+ * Mensagens recebidas por `ReceiveMessage` instrumentado: o contexto fica aqui (por `MessageId` e
+ * `ReceiptHandle`) para o `trackMessage` encontrar depois que os atributos foram retirados da
+ * resposta. Limitado em tamanho e tempo; o mais antigo sai primeiro.
+ */
+export declare class ReceivedMessages {
+    private readonly maxEntries;
+    private readonly ttlMs;
+    private readonly entries;
+    constructor(maxEntries?: number, ttlMs?: number);
+    remember(message: Record<string, unknown>, meta: MessageMeta): void;
+    lookup(record: unknown): MessageMeta | undefined;
+    get size(): number;
+}
+/** Tamanho de uma entrada de `PutEvents` como o EventBridge conta. */
+export declare function eventBridgeEntryBytes(entry: unknown): number;
+export interface DetailInjection<E> {
+    entry: E;
+    injected: boolean;
+    addedBytes: number;
+    skipped?: PropagationSkip;
+}
+/**
+ * Acrescenta o contexto ao `Detail` de uma entrada de `PutEvents` quando ele é um objeto JSON,
+ * ainda não tem `traceparent` e o acréscimo cabe no orçamento que sobra do pedido. O texto do
+ * usuário é preservado byte a byte: o contexto entra logo depois do `{` inicial.
+ */
+export declare function injectEventBridgeContext<E extends Record<string, unknown>>(entry: E, ctx: SpanContext, budgetBytes: number): DetailInjection<E>;
+/** Contexto de um evento do EventBridge entregue à Lambda (`detail.traceparent`). */
+export declare function readEventBridgeDetail(detail: unknown): SpanContext | undefined;
+export interface SpanLink {
+    traceId: string;
+    spanId: string;
+}
+/** Links únicos (por trace/span), no máximo `MAX_LINKS`; devolve também quantos ficaram de fora. */
+export declare function uniqueLinks(contexts: (SpanContext | undefined)[]): {
+    links: SpanLink[];
+    dropped: number;
+};
+/** Erro de validação do serviço (nada foi publicado): a chamada pode ser repetida sem o contexto. */
+export declare function isValidationError(error: unknown): boolean;
+/** Código de falha por entrada (lote) que indica limite ou atributo inválido. */
+export declare function isValidationCode(code: unknown): boolean;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/infra/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/infra/messaging.ts"],"names":[],"mappings":"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"}