youeduc-sdk-messaging 0.0.0 → 0.5.0

package/dist/w3c.js

@@ -0,0 +1,119 @@
+/**
+ * Minimal W3C Trace Context (`traceparent`/`tracestate`) + W3C Baggage propagator, built only
+ * on `@opentelemetry/api`.
+ *
+ * Python's OpenTelemetry API defaults the global propagator to `tracecontext,baggage`; the JS
+ * API defaults to a no-op propagator until an SDK registers one. `OtelTelemetry` falls back to
+ * this propagator while the global one is the no-op, so a Node service propagates trace context
+ * exactly like a Python one even when the application only set a tracer provider.
+ */
+import { createTraceState, isSpanContextValid, isValidSpanId, isValidTraceId, propagation, trace, } from '@opentelemetry/api';
+const TRACEPARENT = 'traceparent';
+const TRACESTATE = 'tracestate';
+const BAGGAGE = 'baggage';
+const TRACEPARENT_RE = /^([\da-f]{2})-([\da-f]{32})-([\da-f]{16})-([\da-f]{2})(-.*)?$/;
+const MAX_BAGGAGE_LENGTH = 8192;
+const MAX_BAGGAGE_ENTRIES = 180;
+function first(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
+function parseTraceparent(header) {
+    const match = TRACEPARENT_RE.exec(header.trim());
+    if (match === null)
+        return null;
+    const [, version, traceId, spanId, flags, rest] = match;
+    if (version === undefined || traceId === undefined || spanId === undefined || flags === undefined)
+        return null;
+    if (version === 'ff' || (version === '00' && rest !== undefined))
+        return null;
+    if (!isValidTraceId(traceId) || !isValidSpanId(spanId))
+        return null;
+    return { traceId, spanId, traceFlags: Number.parseInt(flags, 16) };
+}
+function encodeBaggage(context) {
+    const baggage = propagation.getBaggage(context);
+    if (baggage === undefined)
+        return undefined;
+    const parts = [];
+    let length = 0;
+    for (const [key, entry] of baggage.getAllEntries()) {
+        if (parts.length >= MAX_BAGGAGE_ENTRIES)
+            break;
+        let part = `${encodeURIComponent(key)}=${encodeURIComponent(entry.value)}`;
+        if (entry.metadata !== undefined)
+            part += `;${entry.metadata.toString()}`;
+        if (length + part.length + (parts.length > 0 ? 1 : 0) > MAX_BAGGAGE_LENGTH)
+            break;
+        length += part.length + (parts.length > 0 ? 1 : 0);
+        parts.push(part);
+    }
+    return parts.length > 0 ? parts.join(',') : undefined;
+}
+function decodeComponent(value) {
+    try {
+        return decodeURIComponent(value.trim());
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractBaggage(context, header) {
+    const entries = {};
+    let count = 0;
+    for (const item of header.split(',')) {
+        const [pair] = item.split(';');
+        if (pair === undefined)
+            continue;
+        const separator = pair.indexOf('=');
+        if (separator <= 0)
+            continue;
+        const key = decodeComponent(pair.slice(0, separator));
+        const value = decodeComponent(pair.slice(separator + 1));
+        if (key === undefined || value === undefined || key === '')
+            continue;
+        entries[key] = { value };
+        count += 1;
+        if (count >= MAX_BAGGAGE_ENTRIES)
+            break;
+    }
+    if (count === 0)
+        return context;
+    return propagation.setBaggage(context, propagation.createBaggage(entries));
+}
+/** W3C `traceparent`, `tracestate` and `baggage`. */
+export class W3CPropagator {
+    inject(context, carrier, setter) {
+        const spanContext = trace.getSpanContext(context);
+        if (spanContext !== undefined && isSpanContextValid(spanContext)) {
+            const flags = (spanContext.traceFlags & 0xff).toString(16).padStart(2, '0');
+            setter.set(carrier, TRACEPARENT, `00-${spanContext.traceId}-${spanContext.spanId}-${flags}`);
+            const state = spanContext.traceState?.serialize();
+            if (state)
+                setter.set(carrier, TRACESTATE, state);
+        }
+        const baggage = encodeBaggage(context);
+        if (baggage !== undefined)
+            setter.set(carrier, BAGGAGE, baggage);
+    }
+    extract(context, carrier, getter) {
+        let result = context;
+        const traceparent = first(getter.get(carrier, TRACEPARENT));
+        const parsed = traceparent === undefined ? null : parseTraceparent(traceparent);
+        if (parsed !== null) {
+            const tracestate = first(getter.get(carrier, TRACESTATE));
+            result = trace.setSpanContext(result, {
+                ...parsed,
+                isRemote: true,
+                ...(tracestate ? { traceState: createTraceState(tracestate) } : {}),
+            });
+        }
+        const baggage = first(getter.get(carrier, BAGGAGE));
+        if (baggage)
+            result = extractBaggage(result, baggage);
+        return result;
+    }
+    fields() {
+        return [TRACEPARENT, TRACESTATE, BAGGAGE];
+    }
+}
+//# sourceMappingURL=w3c.js.map

package/dist/w3c.js.map

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

package/package.json

@@ -1 +1,74 @@
-{"name": "youeduc-sdk-messaging", "version": "0.0.0", "description": "Reserva de nome: use a versão mais recente.", "license": "MIT"}
+{
+  "name": "youeduc-sdk-messaging",
+  "version": "0.5.0",
+  "description": "SDK de mensageria assíncrona orientada a eventos sobre Apache Kafka (@confluentinc/kafka-javascript)",
+  "keywords": [
+    "kafka",
+    "librdkafka",
+    "messaging",
+    "events",
+    "typescript",
+    "json-schema",
+    "retry",
+    "dlq"
+  ],
+  "author": "YouEduc",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./redis": {
+      "types": "./dist/integrations/redis.d.ts",
+      "import": "./dist/integrations/redis.js",
+      "default": "./dist/integrations/redis.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "test": "vitest run --project unit",
+    "test:integration": "vitest run --project integration"
+  },
+  "dependencies": {
+    "@confluentinc/kafka-javascript": "1.10.1",
+    "@opentelemetry/api": "1.9.1",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "pino": "10.3.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.14",
+    "@opentelemetry/sdk-metrics": "2.11.0",
+    "@opentelemetry/sdk-trace-base": "2.11.0",
+    "@types/node": "22.20.4",
+    "redis": "6.2.1",
+    "typescript": "7.0.2",
+    "vitest": "5.0.2"
+  },
+  "peerDependencies": {
+    "redis": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "redis": {
+      "optional": true
+    }
+  }
+}