@effect-gql/opentelemetry 0.1.0

package/dist/traced-router.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTracedRouter = exports.makeTracedGraphQLRouter = void 0;
+const platform_1 = require("@effect/platform");
+const effect_1 = require("effect");
+const server_1 = require("@effect-gql/core/server");
+const context_propagation_1 = require("./context-propagation");
+/**
+ * Create an Effect span options object from trace context
+ */
+const createSpanOptions = (traceContext, request, config) => {
+    const attributes = {
+        "http.method": request.method,
+        "http.url": request.url,
+        "http.target": request.url,
+        ...config.rootSpanAttributes,
+    };
+    if (traceContext && config.propagateContext !== false) {
+        return {
+            attributes,
+            parent: effect_1.Tracer.externalSpan({
+                traceId: traceContext.traceId,
+                spanId: traceContext.parentSpanId,
+                sampled: (traceContext.traceFlags & 0x01) === 0x01,
+            }),
+        };
+    }
+    return { attributes };
+};
+/**
+ * Creates a GraphQL router with OpenTelemetry tracing at the HTTP level.
+ *
+ * This wraps the standard makeGraphQLRouter to:
+ * 1. Extract trace context from incoming HTTP headers (W3C Trace Context)
+ * 2. Create a root span for the entire HTTP request
+ * 3. Propagate trace context to child spans created by extensions/middleware
+ *
+ * **Span Hierarchy:**
+ * ```
+ * graphql.http (created by this router)
+ * ├── graphql.parse (from tracing extension)
+ * ├── graphql.validate (from tracing extension)
+ * └── graphql.resolve Query.* (from tracing middleware)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { makeTracedGraphQLRouter } from "@effect-gql/opentelemetry"
+ * import { NodeSdk } from "@effect/opentelemetry"
+ *
+ * const router = makeTracedGraphQLRouter(schema, serviceLayer, {
+ *   path: "/graphql",
+ *   graphiql: { path: "/graphiql" },
+ *   rootSpanName: "graphql.http",
+ *   rootSpanAttributes: {
+ *     "service.name": "my-api"
+ *   }
+ * })
+ *
+ * // Provide OpenTelemetry layer when serving
+ * const TracingLayer = NodeSdk.layer(() => ({
+ *   resource: { serviceName: "my-graphql-api" },
+ *   spanProcessor: new BatchSpanProcessor(new OTLPTraceExporter())
+ * }))
+ * ```
+ *
+ * @param schema - The GraphQL schema
+ * @param layer - Effect layer providing services required by resolvers
+ * @param options - Router and tracing configuration
+ * @returns An HttpRouter with tracing enabled
+ */
+const makeTracedGraphQLRouter = (schema, layer, options = {}) => {
+    const rootSpanName = options.rootSpanName ?? "graphql.http";
+    // Create the base router (handles GraphQL logic)
+    const baseRouter = (0, server_1.makeGraphQLRouter)(schema, layer, options);
+    // Convert base router to an HttpApp for Effect-based handling
+    const baseApp = platform_1.HttpRouter.toHttpApp(baseRouter);
+    // Wrap with tracing
+    return platform_1.HttpRouter.empty.pipe(platform_1.HttpRouter.all("*", effect_1.Effect.gen(function* () {
+        const request = yield* platform_1.HttpServerRequest.HttpServerRequest;
+        // Extract trace context from headers (if enabled)
+        const traceContext = options.propagateContext !== false
+            ? yield* context_propagation_1.extractTraceContext.pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(null)))
+            : null;
+        // Create span options with parent context if available
+        const spanOptions = createSpanOptions(traceContext, request, options);
+        // Execute the request inside a root span
+        return yield* effect_1.Effect.withSpan(rootSpanName, spanOptions)(effect_1.Effect.gen(function* () {
+            // Delegate to the base app (which handles the request from context)
+            const app = yield* baseApp;
+            const response = yield* app.pipe(effect_1.Effect.catchTag("RouteNotFound", () => platform_1.HttpServerResponse.text(JSON.stringify({ errors: [{ message: "Not Found" }] }), {
+                status: 404,
+                headers: { "content-type": "application/json" },
+            })));
+            // Annotate span with response info
+            yield* effect_1.Effect.annotateCurrentSpan("http.status_code", response.status);
+            return response;
+        }));
+    })));
+};
+exports.makeTracedGraphQLRouter = makeTracedGraphQLRouter;
+/**
+ * Wrap an existing HttpRouter with OpenTelemetry tracing.
+ *
+ * This is useful when you already have a router and want to add
+ * request-level tracing without recreating it.
+ *
+ * @example
+ * ```typescript
+ * import { toRouter } from "@effect-gql/core/server"
+ * import { withTracedRouter } from "@effect-gql/opentelemetry"
+ *
+ * const baseRouter = toRouter(builder, serviceLayer)
+ * const tracedRouter = withTracedRouter(baseRouter, {
+ *   rootSpanName: "graphql.http"
+ * })
+ * ```
+ */
+const withTracedRouter = (router, options = {}) => {
+    const rootSpanName = options.rootSpanName ?? "graphql.http";
+    // Convert router to an HttpApp for Effect-based handling
+    const baseApp = platform_1.HttpRouter.toHttpApp(router);
+    return platform_1.HttpRouter.empty.pipe(platform_1.HttpRouter.all("*", effect_1.Effect.gen(function* () {
+        const request = yield* platform_1.HttpServerRequest.HttpServerRequest;
+        // Extract trace context from headers
+        const traceContext = options.propagateContext !== false
+            ? yield* context_propagation_1.extractTraceContext.pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(null)))
+            : null;
+        const spanOptions = {
+            attributes: {
+                "http.method": request.method,
+                "http.url": request.url,
+                ...options.rootSpanAttributes,
+            },
+        };
+        if (traceContext && options.propagateContext !== false) {
+            spanOptions.parent = effect_1.Tracer.externalSpan({
+                traceId: traceContext.traceId,
+                spanId: traceContext.parentSpanId,
+                sampled: (traceContext.traceFlags & 0x01) === 0x01,
+            });
+        }
+        return yield* effect_1.Effect.withSpan(rootSpanName, spanOptions)(effect_1.Effect.gen(function* () {
+            // Delegate to the base app (which handles the request from context)
+            const app = yield* baseApp;
+            const response = yield* app;
+            // Annotate span with response info
+            yield* effect_1.Effect.annotateCurrentSpan("http.status_code", response.status);
+            return response;
+        }));
+    })));
+};
+exports.withTracedRouter = withTracedRouter;
+//# sourceMappingURL=traced-router.js.map

package/dist/traced-router.js.map

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

package/dist/tracing-extension.d.ts

@@ -0,0 +1,52 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,110 @@
+"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

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

package/dist/tracing-middleware.d.ts

@@ -0,0 +1,78 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,96 @@
+"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

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

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,47 @@
+"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

@@ -0,0 +1 @@
+{"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/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@effect-gql/opentelemetry",
+  "version": "0.1.0",
+  "description": "OpenTelemetry tracing integration for @effect-gql/core",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "peerDependencies": {
+    "@effect-gql/core": "^0.1.0",
+    "@effect/opentelemetry": "^0.3.0",
+    "@effect/platform": "^0.94.0",
+    "effect": "^3.19.0",
+    "graphql": "^16.0.0"
+  },
+  "devDependencies": {
+    "@effect-gql/core": "*",
+    "@effect/opentelemetry": "^0.60.0",
+    "@effect/platform": "^0.94.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.2.0",
+    "effect": "^3.19.13",
+    "graphql": "^16.0.0"
+  },
+  "keywords": [
+    "effect",
+    "graphql",
+    "opentelemetry",
+    "tracing",
+    "observability"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:watch": "vitest"
+  }
+}