@effect-gql/opentelemetry 0.1.0 → 1.0.0

package/dist/tracing-extension.d.ts

@@ -1,52 +0,0 @@
-import type { GraphQLExtension } from "@effect-gql/core";
-import { ExtensionsService } from "@effect-gql/core";
-/**
- * Configuration for the GraphQL tracing extension
- */
-export interface TracingExtensionConfig {
-    /**
-     * Include the query source in span attributes.
-     * Default: false (for security - queries may contain sensitive data)
-     */
-    readonly includeQuery?: boolean;
-    /**
-     * Include variables in span attributes.
-     * Default: false (for security - variables may contain sensitive data)
-     */
-    readonly includeVariables?: boolean;
-    /**
-     * Add trace ID and span ID to the GraphQL response extensions.
-     * Useful for correlating client requests with backend traces.
-     * Default: false
-     */
-    readonly exposeTraceIdInResponse?: boolean;
-    /**
-     * Custom attributes to add to all spans.
-     */
-    readonly customAttributes?: Record<string, string | number | boolean>;
-}
-/**
- * Creates a GraphQL extension that adds OpenTelemetry tracing to all execution phases.
- *
- * This extension:
- * - Creates spans for parse, validate phases
- * - Annotates the current span with operation metadata during execution
- * - Optionally exposes trace ID in response extensions
- *
- * Requires an OpenTelemetry tracer to be provided via Effect's tracing layer
- * (e.g., `@effect/opentelemetry` NodeSdk.layer or OtlpTracer.layer).
- *
- * @example
- * ```typescript
- * import { tracingExtension } from "@effect-gql/opentelemetry"
- *
- * const builder = GraphQLSchemaBuilder.empty.pipe(
- *   extension(tracingExtension({
- *     exposeTraceIdInResponse: true
- *   })),
- *   query("hello", { ... })
- * )
- * ```
- */
-export declare const tracingExtension: (config?: TracingExtensionConfig) => GraphQLExtension<ExtensionsService>;
-//# sourceMappingURL=tracing-extension.d.ts.map

package/dist/tracing-extension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing-extension.d.ts","sourceRoot":"","sources":["../src/tracing-extension.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAE/B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAA;IAE1C;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CACtE;AA0BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,sBAAsB,KAC9B,gBAAgB,CAAC,iBAAiB,CA2FnC,CAAA"}

package/dist/tracing-extension.js

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tracingExtension = void 0;
-const effect_1 = require("effect");
-const core_1 = require("@effect-gql/core");
-/**
- * Extract the operation name from a parsed GraphQL document
- */
-const getOperationName = (document) => {
-    for (const definition of document.definitions) {
-        if (definition.kind === "OperationDefinition") {
-            return definition.name?.value;
-        }
-    }
-    return undefined;
-};
-/**
- * Extract the operation type (query, mutation, subscription) from a parsed document
- */
-const getOperationType = (document) => {
-    for (const definition of document.definitions) {
-        if (definition.kind === "OperationDefinition") {
-            return definition.operation;
-        }
-    }
-    return "unknown";
-};
-/**
- * Creates a GraphQL extension that adds OpenTelemetry tracing to all execution phases.
- *
- * This extension:
- * - Creates spans for parse, validate phases
- * - Annotates the current span with operation metadata during execution
- * - Optionally exposes trace ID in response extensions
- *
- * Requires an OpenTelemetry tracer to be provided via Effect's tracing layer
- * (e.g., `@effect/opentelemetry` NodeSdk.layer or OtlpTracer.layer).
- *
- * @example
- * ```typescript
- * import { tracingExtension } from "@effect-gql/opentelemetry"
- *
- * const builder = GraphQLSchemaBuilder.empty.pipe(
- *   extension(tracingExtension({
- *     exposeTraceIdInResponse: true
- *   })),
- *   query("hello", { ... })
- * )
- * ```
- */
-const tracingExtension = (config) => ({
-    name: "opentelemetry-tracing",
-    description: "Adds OpenTelemetry tracing to GraphQL execution phases",
-    onParse: (source, document) => effect_1.Effect.withSpan("graphql.parse")(effect_1.Effect.gen(function* () {
-        const operationName = getOperationName(document) ?? "anonymous";
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.document.name", operationName);
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.document.operation_count", document.definitions.filter((d) => d.kind === "OperationDefinition").length);
-        if (config?.includeQuery) {
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.source", source);
-        }
-        // Add custom attributes if provided
-        if (config?.customAttributes) {
-            for (const [key, value] of Object.entries(config.customAttributes)) {
-                yield* effect_1.Effect.annotateCurrentSpan(key, value);
-            }
-        }
-    })),
-    onValidate: (document, errors) => effect_1.Effect.withSpan("graphql.validate")(effect_1.Effect.gen(function* () {
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.validation.error_count", errors.length);
-        if (errors.length > 0) {
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.validation.errors", JSON.stringify(errors.map((e) => e.message)));
-            yield* effect_1.Effect.annotateCurrentSpan("error", true);
-        }
-    })),
-    onExecuteStart: (args) => effect_1.Effect.gen(function* () {
-        const operationName = args.operationName ?? getOperationName(args.document) ?? "anonymous";
-        const operationType = getOperationType(args.document);
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.operation.name", operationName);
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.operation.type", operationType);
-        if (config?.includeVariables && args.variableValues) {
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.variables", JSON.stringify(args.variableValues));
-        }
-        // Expose trace ID in response extensions if configured
-        if (config?.exposeTraceIdInResponse) {
-            const currentSpanOption = yield* effect_1.Effect.option(effect_1.Effect.currentSpan);
-            if (effect_1.Option.isSome(currentSpanOption)) {
-                const span = currentSpanOption.value;
-                const ext = yield* core_1.ExtensionsService;
-                yield* ext.set("tracing", {
-                    traceId: span.traceId,
-                    spanId: span.spanId,
-                });
-            }
-        }
-    }),
-    onExecuteEnd: (result) => effect_1.Effect.gen(function* () {
-        const hasErrors = result.errors !== undefined && result.errors.length > 0;
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.response.has_errors", hasErrors);
-        yield* effect_1.Effect.annotateCurrentSpan("graphql.response.has_data", result.data !== null && result.data !== undefined);
-        if (hasErrors) {
-            yield* effect_1.Effect.annotateCurrentSpan("error", true);
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.errors", JSON.stringify(result.errors.map((e) => ({
-                message: e.message,
-                path: e.path,
-            }))));
-        }
-    }),
-});
-exports.tracingExtension = tracingExtension;
-//# sourceMappingURL=tracing-extension.js.map

package/dist/tracing-extension.js.map

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

package/dist/tracing-middleware.d.ts

@@ -1,78 +0,0 @@
-import type { GraphQLResolveInfo } from "graphql";
-import type { MiddlewareRegistration } from "@effect-gql/core";
-/**
- * Configuration for resolver tracing middleware
- */
-export interface ResolverTracingConfig {
-    /**
-     * Minimum field depth to trace.
-     * Depth 0 = root fields (Query.*, Mutation.*).
-     * Default: 0 (trace all fields)
-     */
-    readonly minDepth?: number;
-    /**
-     * Maximum field depth to trace.
-     * Default: Infinity (no limit)
-     */
-    readonly maxDepth?: number;
-    /**
-     * Field patterns to exclude from tracing.
-     * Patterns are matched against "TypeName.fieldName".
-     *
-     * @example
-     * // Exclude introspection and internal fields
-     * excludePatterns: [/^Query\.__/, /\.id$/]
-     */
-    readonly excludePatterns?: readonly RegExp[];
-    /**
-     * Whether to include field arguments in span attributes.
-     * Default: false (for security - args may contain sensitive data)
-     */
-    readonly includeArgs?: boolean;
-    /**
-     * Whether to include parent type in span attributes.
-     * Default: true
-     */
-    readonly includeParentType?: boolean;
-    /**
-     * Whether to trace introspection fields (__schema, __type, etc.).
-     * Default: false
-     */
-    readonly traceIntrospection?: boolean;
-    /**
-     * Custom span name generator.
-     * Default: "graphql.resolve TypeName.fieldName"
-     */
-    readonly spanNameGenerator?: (info: GraphQLResolveInfo) => string;
-}
-/**
- * Creates middleware that wraps each resolver in an OpenTelemetry span.
- *
- * Each resolver execution creates a child span with GraphQL-specific attributes:
- * - `graphql.field.name`: The field being resolved
- * - `graphql.field.path`: Full path to the field (e.g., "Query.users.0.posts")
- * - `graphql.field.type`: The return type of the field
- * - `graphql.parent.type`: The parent type name
- * - `graphql.operation.name`: The operation name (if available)
- * - `error`: Set to true if the resolver fails
- * - `error.type`: Error type/class name
- * - `error.message`: Error message
- *
- * Requires an OpenTelemetry tracer to be provided via Effect's tracing layer.
- *
- * @example
- * ```typescript
- * import { resolverTracingMiddleware } from "@effect-gql/opentelemetry"
- *
- * const builder = GraphQLSchemaBuilder.empty.pipe(
- *   middleware(resolverTracingMiddleware({
- *     minDepth: 0,
- *     excludePatterns: [/^Query\.__/],
- *     includeArgs: false
- *   })),
- *   query("users", { ... })
- * )
- * ```
- */
-export declare const resolverTracingMiddleware: (config?: ResolverTracingConfig) => MiddlewareRegistration<never>;
-//# sourceMappingURL=tracing-middleware.d.ts.map

package/dist/tracing-middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing-middleware.d.ts","sourceRoot":"","sources":["../src/tracing-middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAqB,MAAM,kBAAkB,CAAA;AAGjF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAE5C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAE9B;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAEpC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAErC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,MAAM,CAAA;CAClE;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,qBAAqB,KAC7B,sBAAsB,CAAC,KAAK,CAwD7B,CAAA"}

package/dist/tracing-middleware.js

@@ -1,96 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolverTracingMiddleware = void 0;
-const effect_1 = require("effect");
-const utils_1 = require("./utils");
-/**
- * Check if a field should be traced based on configuration
- */
-const shouldTraceField = (info, config) => {
-    // Skip introspection fields unless explicitly enabled
-    if (!config?.traceIntrospection && (0, utils_1.isIntrospectionField)(info)) {
-        return false;
-    }
-    const depth = (0, utils_1.getFieldDepth)(info);
-    // Check depth bounds
-    if (config?.minDepth !== undefined && depth < config.minDepth) {
-        return false;
-    }
-    if (config?.maxDepth !== undefined && depth > config.maxDepth) {
-        return false;
-    }
-    // Check exclude patterns
-    if (config?.excludePatterns) {
-        const fieldPath = `${info.parentType.name}.${info.fieldName}`;
-        for (const pattern of config.excludePatterns) {
-            if (pattern.test(fieldPath)) {
-                return false;
-            }
-        }
-    }
-    return true;
-};
-/**
- * Creates middleware that wraps each resolver in an OpenTelemetry span.
- *
- * Each resolver execution creates a child span with GraphQL-specific attributes:
- * - `graphql.field.name`: The field being resolved
- * - `graphql.field.path`: Full path to the field (e.g., "Query.users.0.posts")
- * - `graphql.field.type`: The return type of the field
- * - `graphql.parent.type`: The parent type name
- * - `graphql.operation.name`: The operation name (if available)
- * - `error`: Set to true if the resolver fails
- * - `error.type`: Error type/class name
- * - `error.message`: Error message
- *
- * Requires an OpenTelemetry tracer to be provided via Effect's tracing layer.
- *
- * @example
- * ```typescript
- * import { resolverTracingMiddleware } from "@effect-gql/opentelemetry"
- *
- * const builder = GraphQLSchemaBuilder.empty.pipe(
- *   middleware(resolverTracingMiddleware({
- *     minDepth: 0,
- *     excludePatterns: [/^Query\.__/],
- *     includeArgs: false
- *   })),
- *   query("users", { ... })
- * )
- * ```
- */
-const resolverTracingMiddleware = (config) => ({
-    name: "opentelemetry-resolver-tracing",
-    description: "Wraps resolvers in OpenTelemetry spans",
-    match: (info) => shouldTraceField(info, config),
-    apply: (effect, context) => {
-        const { info } = context;
-        const spanName = config?.spanNameGenerator
-            ? config.spanNameGenerator(info)
-            : `graphql.resolve ${info.parentType.name}.${info.fieldName}`;
-        return effect_1.Effect.withSpan(spanName)(effect_1.Effect.gen(function* () {
-            // Add standard attributes
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.field.name", info.fieldName);
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.field.path", (0, utils_1.pathToString)(info.path));
-            yield* effect_1.Effect.annotateCurrentSpan("graphql.field.type", String(info.returnType));
-            if (config?.includeParentType !== false) {
-                yield* effect_1.Effect.annotateCurrentSpan("graphql.parent.type", info.parentType.name);
-            }
-            if (info.operation?.name?.value) {
-                yield* effect_1.Effect.annotateCurrentSpan("graphql.operation.name", info.operation.name.value);
-            }
-            if (config?.includeArgs && context.args && Object.keys(context.args).length > 0) {
-                yield* effect_1.Effect.annotateCurrentSpan("graphql.field.args", JSON.stringify(context.args));
-            }
-            // Execute resolver and handle errors
-            const result = yield* effect.pipe(effect_1.Effect.tapError((error) => effect_1.Effect.gen(function* () {
-                yield* effect_1.Effect.annotateCurrentSpan("error", true);
-                yield* effect_1.Effect.annotateCurrentSpan("error.type", error instanceof Error ? error.constructor.name : "Error");
-                yield* effect_1.Effect.annotateCurrentSpan("error.message", error instanceof Error ? error.message : String(error));
-            })));
-            return result;
-        }));
-    },
-});
-exports.resolverTracingMiddleware = resolverTracingMiddleware;
-//# sourceMappingURL=tracing-middleware.js.map

package/dist/tracing-middleware.js.map

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

package/dist/utils.d.ts

@@ -1,19 +0,0 @@
-import type { GraphQLResolveInfo, ResponsePath } from "graphql";
-/**
- * Convert a GraphQL response path to a string representation.
- *
- * @example
- * // For path: Query -> users -> 0 -> posts -> 1 -> title
- * // Returns: "Query.users.0.posts.1.title"
- */
-export declare const pathToString: (path: ResponsePath | undefined) => string;
-/**
- * Get the depth of a field in the query tree.
- * Root fields (Query.*, Mutation.*) have depth 0.
- */
-export declare const getFieldDepth: (info: GraphQLResolveInfo) => number;
-/**
- * Check if a field is an introspection field (__schema, __type, etc.)
- */
-export declare const isIntrospectionField: (info: GraphQLResolveInfo) => boolean;
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,YAAY,GAAG,SAAS,KAAG,MAY7D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,kBAAkB,KAAG,MAaxD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,kBAAkB,KAAG,OAE/D,CAAA"}

package/dist/utils.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isIntrospectionField = exports.getFieldDepth = exports.pathToString = void 0;
-/**
- * Convert a GraphQL response path to a string representation.
- *
- * @example
- * // For path: Query -> users -> 0 -> posts -> 1 -> title
- * // Returns: "Query.users.0.posts.1.title"
- */
-const pathToString = (path) => {
-    if (!path)
-        return "";
-    const segments = [];
-    let current = path;
-    while (current) {
-        segments.unshift(current.key);
-        current = current.prev;
-    }
-    return segments.join(".");
-};
-exports.pathToString = pathToString;
-/**
- * Get the depth of a field in the query tree.
- * Root fields (Query.*, Mutation.*) have depth 0.
- */
-const getFieldDepth = (info) => {
-    let depth = 0;
-    let current = info.path;
-    while (current?.prev) {
-        // Skip array indices in depth calculation
-        if (typeof current.key === "string") {
-            depth++;
-        }
-        current = current.prev;
-    }
-    return depth;
-};
-exports.getFieldDepth = getFieldDepth;
-/**
- * Check if a field is an introspection field (__schema, __type, etc.)
- */
-const isIntrospectionField = (info) => {
-    return info.fieldName.startsWith("__");
-};
-exports.isIntrospectionField = isIntrospectionField;
-//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,IAA8B,EAAU,EAAE;IACrE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,MAAM,QAAQ,GAAwB,EAAE,CAAA;IACxC,IAAI,OAAO,GAA6B,IAAI,CAAA;IAE5C,OAAO,OAAO,EAAE,CAAC;QACf,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC7B,OAAO,GAAG,OAAO,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC,CAAA;AAZY,QAAA,YAAY,gBAYxB;AAED;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,IAAwB,EAAU,EAAE;IAChE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,OAAO,GAA6B,IAAI,CAAC,IAAI,CAAA;IAEjD,OAAO,OAAO,EAAE,IAAI,EAAE,CAAC;QACrB,0CAA0C;QAC1C,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,KAAK,EAAE,CAAA;QACT,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAbY,QAAA,aAAa,iBAazB;AAED;;GAEG;AACI,MAAM,oBAAoB,GAAG,CAAC,IAAwB,EAAW,EAAE;IACxE,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC,CAAA;AAFY,QAAA,oBAAoB,wBAEhC"}

package/src/context-propagation.ts

@@ -1,177 +0,0 @@
-import { Effect, Context } from "effect"
-import { HttpServerRequest } from "@effect/platform"
-
-/**
- * W3C Trace Context header names
- * @see https://www.w3.org/TR/trace-context/
- */
-export const TRACEPARENT_HEADER = "traceparent"
-export const TRACESTATE_HEADER = "tracestate"
-
-/**
- * Parsed W3C Trace Context from incoming HTTP headers
- */
-export interface TraceContext {
-  /**
-   * Version of the trace context format (always "00" for current spec)
-   */
-  readonly version: string
-
-  /**
-   * Trace ID - 32 character lowercase hex string
-   */
-  readonly traceId: string
-
-  /**
-   * Parent Span ID - 16 character lowercase hex string
-   */
-  readonly parentSpanId: string
-
-  /**
-   * Trace flags - determines if trace is sampled
-   * Bit 0 (0x01) = sampled flag
-   */
-  readonly traceFlags: number
-
-  /**
-   * Optional trace state from upstream services
-   */
-  readonly traceState?: string
-}
-
-/**
- * Context tag for TraceContext
- */
-export class TraceContextTag extends Context.Tag("@effect-gql/opentelemetry/TraceContext")<
-  TraceContextTag,
-  TraceContext
->() {}
-
-/**
- * Parse a W3C traceparent header value.
- *
- * Format: {version}-{trace-id}-{parent-id}-{trace-flags}
- * Example: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
- *
- * @see https://www.w3.org/TR/trace-context/#traceparent-header
- *
- * @param header - The traceparent header value
- * @returns Parsed trace context or null if invalid
- */
-export const parseTraceParent = (header: string): TraceContext | null => {
-  const trimmed = header.trim().toLowerCase()
-  const parts = trimmed.split("-")
-
-  if (parts.length !== 4) {
-    return null
-  }
-
-  const [version, traceId, parentSpanId, flagsHex] = parts
-
-  // Validate version (2 hex chars)
-  if (version.length !== 2 || !/^[0-9a-f]{2}$/.test(version)) {
-    return null
-  }
-
-  // Validate trace ID (32 hex chars, not all zeros)
-  if (traceId.length !== 32 || !/^[0-9a-f]{32}$/.test(traceId)) {
-    return null
-  }
-  if (traceId === "00000000000000000000000000000000") {
-    return null
-  }
-
-  // Validate parent span ID (16 hex chars, not all zeros)
-  if (parentSpanId.length !== 16 || !/^[0-9a-f]{16}$/.test(parentSpanId)) {
-    return null
-  }
-  if (parentSpanId === "0000000000000000") {
-    return null
-  }
-
-  // Validate trace flags (2 hex chars)
-  if (flagsHex.length !== 2 || !/^[0-9a-f]{2}$/.test(flagsHex)) {
-    return null
-  }
-
-  const traceFlags = parseInt(flagsHex, 16)
-
-  return {
-    version,
-    traceId,
-    parentSpanId,
-    traceFlags,
-  }
-}
-
-/**
- * Check if a trace context is sampled (should be recorded)
- */
-export const isSampled = (context: TraceContext): boolean => {
-  return (context.traceFlags & 0x01) === 0x01
-}
-
-/**
- * Extract trace context from HTTP request headers.
- *
- * Looks for the W3C Trace Context headers:
- * - `traceparent`: Required, contains trace ID, span ID, and flags
- * - `tracestate`: Optional, vendor-specific trace data
- *
- * @example
- * ```typescript
- * const context = yield* extractTraceContext
- * if (context) {
- *   console.log(`Continuing trace: ${context.traceId}`)
- * }
- * ```
- */
-export const extractTraceContext: Effect.Effect<
-  TraceContext | null,
-  never,
-  HttpServerRequest.HttpServerRequest
-> = Effect.gen(function* () {
-  const request = yield* HttpServerRequest.HttpServerRequest
-  const headers = request.headers
-
-  // Get traceparent header (case-insensitive)
-  const traceparentKey = Object.keys(headers).find((k) => k.toLowerCase() === TRACEPARENT_HEADER)
-
-  if (!traceparentKey) {
-    return null
-  }
-
-  const traceparentValue = headers[traceparentKey]
-  const traceparent = Array.isArray(traceparentValue) ? traceparentValue[0] : traceparentValue
-
-  if (!traceparent) {
-    return null
-  }
-
-  const context = parseTraceParent(traceparent)
-  if (!context) {
-    return null
-  }
-
-  // Get optional tracestate header
-  const tracestateKey = Object.keys(headers).find((k) => k.toLowerCase() === TRACESTATE_HEADER)
-
-  if (tracestateKey) {
-    const tracestateValue = headers[tracestateKey]
-    const tracestate = Array.isArray(tracestateValue) ? tracestateValue[0] : tracestateValue
-
-    if (tracestate) {
-      return { ...context, traceState: tracestate }
-    }
-  }
-
-  return context
-})
-
-/**
- * Format a trace context as a traceparent header value
- */
-export const formatTraceParent = (context: TraceContext): string => {
-  const flags = context.traceFlags.toString(16).padStart(2, "0")
-  return `${context.version}-${context.traceId}-${context.parentSpanId}-${flags}`
-}