@geekmidas/telescope 10.0.0-alpha.99 → 10.0.0

package/dist/http-DQzgLczm.mjs

@@ -0,0 +1,159 @@
+import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
+
+//#region src/instrumentation/http.ts
+const TRACER_NAME = "@geekmidas/constructs";
+/**
+* Get or create a tracer for constructs instrumentation
+*/
+function getConstructsTracer() {
+	return trace.getTracer(TRACER_NAME);
+}
+/**
+* Convert HTTP attributes to OpenTelemetry semantic conventions
+*/
+function toOtelAttributes(attrs) {
+	const otelAttrs = {};
+	if (attrs.method) otelAttrs["http.request.method"] = attrs.method;
+	if (attrs.url) otelAttrs["url.full"] = attrs.url;
+	if (attrs.path) otelAttrs["url.path"] = attrs.path;
+	if (attrs.route) otelAttrs["http.route"] = attrs.route;
+	if (attrs.host) otelAttrs["server.address"] = attrs.host;
+	if (attrs.scheme) otelAttrs["url.scheme"] = attrs.scheme;
+	if (attrs.userAgent) otelAttrs["user_agent.original"] = attrs.userAgent;
+	if (attrs.clientIp) otelAttrs["client.address"] = attrs.clientIp;
+	if (attrs.requestId) otelAttrs["http.request.id"] = attrs.requestId;
+	if (attrs.response?.statusCode) otelAttrs["http.response.status_code"] = attrs.response.statusCode;
+	if (attrs.response?.responseSize) otelAttrs["http.response.body.size"] = attrs.response.responseSize;
+	if (attrs.endpoint?.name) otelAttrs["endpoint.name"] = attrs.endpoint.name;
+	if (attrs.endpoint?.operationId) otelAttrs["endpoint.operation_id"] = attrs.endpoint.operationId;
+	if (attrs.endpoint?.tags?.length) otelAttrs["endpoint.tags"] = attrs.endpoint.tags;
+	if (attrs.user?.userId) otelAttrs["enduser.id"] = attrs.user.userId;
+	if (attrs.user?.sessionId) otelAttrs["session.id"] = attrs.user.sessionId;
+	if (attrs.user?.roles?.length) otelAttrs["enduser.role"] = attrs.user.roles.join(",");
+	if (attrs.custom) Object.assign(otelAttrs, attrs.custom);
+	return otelAttrs;
+}
+/**
+* Extract trace context from HTTP headers
+*/
+function extractTraceContext(headers) {
+	const normalizedHeaders = {};
+	for (const [key, value] of Object.entries(headers)) if (value) {
+		const stringValue = Array.isArray(value) ? value[0] : value;
+		if (stringValue) normalizedHeaders[key.toLowerCase()] = stringValue;
+	}
+	return propagation.extract(context.active(), normalizedHeaders);
+}
+/**
+* Inject trace context into HTTP headers
+*/
+function injectTraceContext(headers, ctx) {
+	const result = { ...headers };
+	propagation.inject(ctx ?? context.active(), result);
+	return result;
+}
+/**
+* Create an HTTP server span for an incoming request
+*/
+function createHttpServerSpan(attrs, parentContext) {
+	const tracer = getConstructsTracer();
+	const spanName = attrs.route ? `${attrs.method} ${attrs.route}` : `${attrs.method} ${attrs.path || "/"}`;
+	const ctx = parentContext ?? context.active();
+	return tracer.startSpan(spanName, {
+		kind: SpanKind.SERVER,
+		attributes: toOtelAttributes(attrs)
+	}, ctx);
+}
+/**
+* End an HTTP span with response data
+*/
+function endHttpSpan(span, response, error) {
+	span.setAttribute("http.response.status_code", response.statusCode);
+	if (response.responseSize) span.setAttribute("http.response.body.size", response.responseSize);
+	if (error) {
+		span.recordException(error);
+		span.setStatus({
+			code: SpanStatusCode.ERROR,
+			message: error.message
+		});
+	} else if (response.statusCode >= 400) span.setStatus({
+		code: SpanStatusCode.ERROR,
+		message: `HTTP ${response.statusCode}`
+	});
+	else span.setStatus({ code: SpanStatusCode.OK });
+	span.end();
+}
+/**
+* Execute a function within an HTTP server span context
+*
+* @example
+* ```typescript
+* const result = await withHttpSpan(
+*   { method: 'GET', path: '/users', route: '/users' },
+*   async (span) => {
+*     const users = await getUsers();
+*     return { statusCode: 200, body: users };
+*   }
+* );
+* ```
+*/
+async function withHttpSpan(attrs, fn, parentContext) {
+	const span = createHttpServerSpan(attrs, parentContext);
+	try {
+		const result = await context.with(trace.setSpan(parentContext ?? context.active(), span), () => fn(span));
+		const statusCode = result.statusCode ?? 200;
+		endHttpSpan(span, { statusCode });
+		return result;
+	} catch (error) {
+		endHttpSpan(span, { statusCode: 500 }, error instanceof Error ? error : new Error(String(error)));
+		throw error;
+	}
+}
+/**
+* Create a child span for internal operations (middleware, handlers, etc.)
+*/
+function createChildSpan(name, attributes) {
+	const tracer = getConstructsTracer();
+	return tracer.startSpan(name, {
+		kind: SpanKind.INTERNAL,
+		attributes
+	});
+}
+/**
+* Execute a function within a child span
+*/
+async function withChildSpan(name, fn, attributes) {
+	const span = createChildSpan(name, attributes);
+	try {
+		const result = await context.with(trace.setSpan(context.active(), span), () => fn(span));
+		span.setStatus({ code: SpanStatusCode.OK });
+		return result;
+	} catch (error) {
+		span.setStatus({
+			code: SpanStatusCode.ERROR,
+			message: error instanceof Error ? error.message : "Unknown error"
+		});
+		span.recordException(error instanceof Error ? error : new Error(String(error)));
+		throw error;
+	} finally {
+		span.end();
+	}
+}
+/**
+* Check if tracing is enabled (OpenTelemetry API is available and configured)
+*/
+function isTracingEnabled() {
+	try {
+		const tracer = trace.getTracer(TRACER_NAME);
+		const span = tracer.startSpan("test");
+		const isReal = span.spanContext().traceId !== "00000000000000000000000000000000";
+		span.end();
+		return isReal;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { createChildSpan, createHttpServerSpan, endHttpSpan, extractTraceContext, getConstructsTracer, injectTraceContext, isTracingEnabled, toOtelAttributes, withChildSpan, withHttpSpan };
+//# sourceMappingURL=http-DQzgLczm.mjs.map

package/dist/http-DQzgLczm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-DQzgLczm.mjs","names":["attrs: HttpSpanAttributes","otelAttrs: Attributes","headers: Record<string, string | string[] | undefined>","normalizedHeaders: Record<string, string>","headers: Record<string, string>","ctx?: Context","parentContext?: Context","span: Span","response: HttpResponseAttributes","error?: Error","fn: (span: Span) => Promise<T & { statusCode?: number }>","name: string","attributes?: Attributes","fn: (span: Span) => Promise<T>"],"sources":["../src/instrumentation/http.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\ttype Context,\n\tcontext,\n\tpropagation,\n\ttype Span,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * HTTP request attributes following OpenTelemetry semantic conventions\n */\nexport interface HttpRequestAttributes {\n\tmethod: string;\n\turl?: string;\n\tpath?: string;\n\troute?: string;\n\thost?: string;\n\tscheme?: 'http' | 'https';\n\tuserAgent?: string;\n\tclientIp?: string;\n\trequestId?: string;\n}\n\n/**\n * HTTP response attributes\n */\nexport interface HttpResponseAttributes {\n\tstatusCode: number;\n\tresponseSize?: number;\n}\n\n/**\n * Endpoint-specific attributes\n */\nexport interface EndpointAttributes {\n\tname?: string;\n\toperationId?: string;\n\ttags?: string[];\n}\n\n/**\n * User/session attributes\n */\nexport interface UserAttributes {\n\tuserId?: string;\n\tsessionId?: string;\n\troles?: string[];\n}\n\n/**\n * Full span attributes for HTTP requests\n */\nexport interface HttpSpanAttributes extends HttpRequestAttributes {\n\tresponse?: HttpResponseAttributes;\n\tendpoint?: EndpointAttributes;\n\tuser?: UserAttributes;\n\tcustom?: Attributes;\n}\n\nconst TRACER_NAME = '@geekmidas/constructs';\n\n/**\n * Get or create a tracer for constructs instrumentation\n */\nexport function getConstructsTracer() {\n\treturn trace.getTracer(TRACER_NAME);\n}\n\n/**\n * Convert HTTP attributes to OpenTelemetry semantic conventions\n */\nexport function toOtelAttributes(attrs: HttpSpanAttributes): Attributes {\n\tconst otelAttrs: Attributes = {};\n\n\t// HTTP request attributes (OpenTelemetry semantic conventions)\n\tif (attrs.method) otelAttrs['http.request.method'] = attrs.method;\n\tif (attrs.url) otelAttrs['url.full'] = attrs.url;\n\tif (attrs.path) otelAttrs['url.path'] = attrs.path;\n\tif (attrs.route) otelAttrs['http.route'] = attrs.route;\n\tif (attrs.host) otelAttrs['server.address'] = attrs.host;\n\tif (attrs.scheme) otelAttrs['url.scheme'] = attrs.scheme;\n\tif (attrs.userAgent) otelAttrs['user_agent.original'] = attrs.userAgent;\n\tif (attrs.clientIp) otelAttrs['client.address'] = attrs.clientIp;\n\tif (attrs.requestId) otelAttrs['http.request.id'] = attrs.requestId;\n\n\t// HTTP response attributes\n\tif (attrs.response?.statusCode) {\n\t\totelAttrs['http.response.status_code'] = attrs.response.statusCode;\n\t}\n\tif (attrs.response?.responseSize) {\n\t\totelAttrs['http.response.body.size'] = attrs.response.responseSize;\n\t}\n\n\t// Endpoint attributes\n\tif (attrs.endpoint?.name) otelAttrs['endpoint.name'] = attrs.endpoint.name;\n\tif (attrs.endpoint?.operationId) {\n\t\totelAttrs['endpoint.operation_id'] = attrs.endpoint.operationId;\n\t}\n\tif (attrs.endpoint?.tags?.length) {\n\t\totelAttrs['endpoint.tags'] = attrs.endpoint.tags;\n\t}\n\n\t// User attributes\n\tif (attrs.user?.userId) otelAttrs['enduser.id'] = attrs.user.userId;\n\tif (attrs.user?.sessionId) otelAttrs['session.id'] = attrs.user.sessionId;\n\tif (attrs.user?.roles?.length)\n\t\totelAttrs['enduser.role'] = attrs.user.roles.join(',');\n\n\t// Custom attributes\n\tif (attrs.custom) {\n\t\tObject.assign(otelAttrs, attrs.custom);\n\t}\n\n\treturn otelAttrs;\n}\n\n/**\n * Extract trace context from HTTP headers\n */\nexport function extractTraceContext(\n\theaders: Record<string, string | string[] | undefined>,\n): Context {\n\t// Normalize headers to Record<string, string>\n\tconst normalizedHeaders: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value) {\n\t\t\tconst stringValue = Array.isArray(value) ? value[0] : value;\n\t\t\tif (stringValue) {\n\t\t\t\tnormalizedHeaders[key.toLowerCase()] = stringValue;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn propagation.extract(context.active(), normalizedHeaders);\n}\n\n/**\n * Inject trace context into HTTP headers\n */\nexport function injectTraceContext(\n\theaders: Record<string, string>,\n\tctx?: Context,\n): Record<string, string> {\n\tconst result = { ...headers };\n\tpropagation.inject(ctx ?? context.active(), result);\n\treturn result;\n}\n\n/**\n * Create an HTTP server span for an incoming request\n */\nexport function createHttpServerSpan(\n\tattrs: HttpSpanAttributes,\n\tparentContext?: Context,\n): Span {\n\tconst tracer = getConstructsTracer();\n\tconst spanName = attrs.route\n\t\t? `${attrs.method} ${attrs.route}`\n\t\t: `${attrs.method} ${attrs.path || '/'}`;\n\n\tconst ctx = parentContext ?? context.active();\n\n\treturn tracer.startSpan(\n\t\tspanName,\n\t\t{\n\t\t\tkind: SpanKind.SERVER,\n\t\t\tattributes: toOtelAttributes(attrs),\n\t\t},\n\t\tctx,\n\t);\n}\n\n/**\n * End an HTTP span with response data\n */\nexport function endHttpSpan(\n\tspan: Span,\n\tresponse: HttpResponseAttributes,\n\terror?: Error,\n): void {\n\tspan.setAttribute('http.response.status_code', response.statusCode);\n\n\tif (response.responseSize) {\n\t\tspan.setAttribute('http.response.body.size', response.responseSize);\n\t}\n\n\tif (error) {\n\t\tspan.recordException(error);\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error.message,\n\t\t});\n\t} else if (response.statusCode >= 400) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: `HTTP ${response.statusCode}`,\n\t\t});\n\t} else {\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t}\n\n\tspan.end();\n}\n\n/**\n * Execute a function within an HTTP server span context\n *\n * @example\n * ```typescript\n * const result = await withHttpSpan(\n *   { method: 'GET', path: '/users', route: '/users' },\n *   async (span) => {\n *     const users = await getUsers();\n *     return { statusCode: 200, body: users };\n *   }\n * );\n * ```\n */\nexport async function withHttpSpan<T>(\n\tattrs: HttpSpanAttributes,\n\tfn: (span: Span) => Promise<T & { statusCode?: number }>,\n\tparentContext?: Context,\n): Promise<T> {\n\tconst span = createHttpServerSpan(attrs, parentContext);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(parentContext ?? context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\n\t\tconst statusCode = (result as { statusCode?: number }).statusCode ?? 200;\n\t\tendHttpSpan(span, { statusCode });\n\n\t\treturn result;\n\t} catch (error) {\n\t\tendHttpSpan(\n\t\t\tspan,\n\t\t\t{ statusCode: 500 },\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t}\n}\n\n/**\n * Create a child span for internal operations (middleware, handlers, etc.)\n */\nexport function createChildSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = getConstructsTracer();\n\treturn tracer.startSpan(name, {\n\t\tkind: SpanKind.INTERNAL,\n\t\tattributes,\n\t});\n}\n\n/**\n * Execute a function within a child span\n */\nexport async function withChildSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst span = createChildSpan(name, attributes);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Check if tracing is enabled (OpenTelemetry API is available and configured)\n */\nexport function isTracingEnabled(): boolean {\n\ttry {\n\t\tconst tracer = trace.getTracer(TRACER_NAME);\n\t\t// Check if we have a real tracer (not a no-op)\n\t\tconst span = tracer.startSpan('test');\n\t\tconst isReal =\n\t\t\tspan.spanContext().traceId !== '00000000000000000000000000000000';\n\t\tspan.end();\n\t\treturn isReal;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/http-D_Z8sYXZ.cjs

@@ -0,0 +1,219 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const __opentelemetry_api = require_chunk.__toESM(require("@opentelemetry/api"));
+
+//#region src/instrumentation/http.ts
+const TRACER_NAME = "@geekmidas/constructs";
+/**
+* Get or create a tracer for constructs instrumentation
+*/
+function getConstructsTracer() {
+	return __opentelemetry_api.trace.getTracer(TRACER_NAME);
+}
+/**
+* Convert HTTP attributes to OpenTelemetry semantic conventions
+*/
+function toOtelAttributes(attrs) {
+	const otelAttrs = {};
+	if (attrs.method) otelAttrs["http.request.method"] = attrs.method;
+	if (attrs.url) otelAttrs["url.full"] = attrs.url;
+	if (attrs.path) otelAttrs["url.path"] = attrs.path;
+	if (attrs.route) otelAttrs["http.route"] = attrs.route;
+	if (attrs.host) otelAttrs["server.address"] = attrs.host;
+	if (attrs.scheme) otelAttrs["url.scheme"] = attrs.scheme;
+	if (attrs.userAgent) otelAttrs["user_agent.original"] = attrs.userAgent;
+	if (attrs.clientIp) otelAttrs["client.address"] = attrs.clientIp;
+	if (attrs.requestId) otelAttrs["http.request.id"] = attrs.requestId;
+	if (attrs.response?.statusCode) otelAttrs["http.response.status_code"] = attrs.response.statusCode;
+	if (attrs.response?.responseSize) otelAttrs["http.response.body.size"] = attrs.response.responseSize;
+	if (attrs.endpoint?.name) otelAttrs["endpoint.name"] = attrs.endpoint.name;
+	if (attrs.endpoint?.operationId) otelAttrs["endpoint.operation_id"] = attrs.endpoint.operationId;
+	if (attrs.endpoint?.tags?.length) otelAttrs["endpoint.tags"] = attrs.endpoint.tags;
+	if (attrs.user?.userId) otelAttrs["enduser.id"] = attrs.user.userId;
+	if (attrs.user?.sessionId) otelAttrs["session.id"] = attrs.user.sessionId;
+	if (attrs.user?.roles?.length) otelAttrs["enduser.role"] = attrs.user.roles.join(",");
+	if (attrs.custom) Object.assign(otelAttrs, attrs.custom);
+	return otelAttrs;
+}
+/**
+* Extract trace context from HTTP headers
+*/
+function extractTraceContext(headers) {
+	const normalizedHeaders = {};
+	for (const [key, value] of Object.entries(headers)) if (value) {
+		const stringValue = Array.isArray(value) ? value[0] : value;
+		if (stringValue) normalizedHeaders[key.toLowerCase()] = stringValue;
+	}
+	return __opentelemetry_api.propagation.extract(__opentelemetry_api.context.active(), normalizedHeaders);
+}
+/**
+* Inject trace context into HTTP headers
+*/
+function injectTraceContext(headers, ctx) {
+	const result = { ...headers };
+	__opentelemetry_api.propagation.inject(ctx ?? __opentelemetry_api.context.active(), result);
+	return result;
+}
+/**
+* Create an HTTP server span for an incoming request
+*/
+function createHttpServerSpan(attrs, parentContext) {
+	const tracer = getConstructsTracer();
+	const spanName = attrs.route ? `${attrs.method} ${attrs.route}` : `${attrs.method} ${attrs.path || "/"}`;
+	const ctx = parentContext ?? __opentelemetry_api.context.active();
+	return tracer.startSpan(spanName, {
+		kind: __opentelemetry_api.SpanKind.SERVER,
+		attributes: toOtelAttributes(attrs)
+	}, ctx);
+}
+/**
+* End an HTTP span with response data
+*/
+function endHttpSpan(span, response, error) {
+	span.setAttribute("http.response.status_code", response.statusCode);
+	if (response.responseSize) span.setAttribute("http.response.body.size", response.responseSize);
+	if (error) {
+		span.recordException(error);
+		span.setStatus({
+			code: __opentelemetry_api.SpanStatusCode.ERROR,
+			message: error.message
+		});
+	} else if (response.statusCode >= 400) span.setStatus({
+		code: __opentelemetry_api.SpanStatusCode.ERROR,
+		message: `HTTP ${response.statusCode}`
+	});
+	else span.setStatus({ code: __opentelemetry_api.SpanStatusCode.OK });
+	span.end();
+}
+/**
+* Execute a function within an HTTP server span context
+*
+* @example
+* ```typescript
+* const result = await withHttpSpan(
+*   { method: 'GET', path: '/users', route: '/users' },
+*   async (span) => {
+*     const users = await getUsers();
+*     return { statusCode: 200, body: users };
+*   }
+* );
+* ```
+*/
+async function withHttpSpan(attrs, fn, parentContext) {
+	const span = createHttpServerSpan(attrs, parentContext);
+	try {
+		const result = await __opentelemetry_api.context.with(__opentelemetry_api.trace.setSpan(parentContext ?? __opentelemetry_api.context.active(), span), () => fn(span));
+		const statusCode = result.statusCode ?? 200;
+		endHttpSpan(span, { statusCode });
+		return result;
+	} catch (error) {
+		endHttpSpan(span, { statusCode: 500 }, error instanceof Error ? error : new Error(String(error)));
+		throw error;
+	}
+}
+/**
+* Create a child span for internal operations (middleware, handlers, etc.)
+*/
+function createChildSpan(name, attributes) {
+	const tracer = getConstructsTracer();
+	return tracer.startSpan(name, {
+		kind: __opentelemetry_api.SpanKind.INTERNAL,
+		attributes
+	});
+}
+/**
+* Execute a function within a child span
+*/
+async function withChildSpan(name, fn, attributes) {
+	const span = createChildSpan(name, attributes);
+	try {
+		const result = await __opentelemetry_api.context.with(__opentelemetry_api.trace.setSpan(__opentelemetry_api.context.active(), span), () => fn(span));
+		span.setStatus({ code: __opentelemetry_api.SpanStatusCode.OK });
+		return result;
+	} catch (error) {
+		span.setStatus({
+			code: __opentelemetry_api.SpanStatusCode.ERROR,
+			message: error instanceof Error ? error.message : "Unknown error"
+		});
+		span.recordException(error instanceof Error ? error : new Error(String(error)));
+		throw error;
+	} finally {
+		span.end();
+	}
+}
+/**
+* Check if tracing is enabled (OpenTelemetry API is available and configured)
+*/
+function isTracingEnabled() {
+	try {
+		const tracer = __opentelemetry_api.trace.getTracer(TRACER_NAME);
+		const span = tracer.startSpan("test");
+		const isReal = span.spanContext().traceId !== "00000000000000000000000000000000";
+		span.end();
+		return isReal;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+Object.defineProperty(exports, 'createChildSpan', {
+  enumerable: true,
+  get: function () {
+    return createChildSpan;
+  }
+});
+Object.defineProperty(exports, 'createHttpServerSpan', {
+  enumerable: true,
+  get: function () {
+    return createHttpServerSpan;
+  }
+});
+Object.defineProperty(exports, 'endHttpSpan', {
+  enumerable: true,
+  get: function () {
+    return endHttpSpan;
+  }
+});
+Object.defineProperty(exports, 'extractTraceContext', {
+  enumerable: true,
+  get: function () {
+    return extractTraceContext;
+  }
+});
+Object.defineProperty(exports, 'getConstructsTracer', {
+  enumerable: true,
+  get: function () {
+    return getConstructsTracer;
+  }
+});
+Object.defineProperty(exports, 'injectTraceContext', {
+  enumerable: true,
+  get: function () {
+    return injectTraceContext;
+  }
+});
+Object.defineProperty(exports, 'isTracingEnabled', {
+  enumerable: true,
+  get: function () {
+    return isTracingEnabled;
+  }
+});
+Object.defineProperty(exports, 'toOtelAttributes', {
+  enumerable: true,
+  get: function () {
+    return toOtelAttributes;
+  }
+});
+Object.defineProperty(exports, 'withChildSpan', {
+  enumerable: true,
+  get: function () {
+    return withChildSpan;
+  }
+});
+Object.defineProperty(exports, 'withHttpSpan', {
+  enumerable: true,
+  get: function () {
+    return withHttpSpan;
+  }
+});
+//# sourceMappingURL=http-D_Z8sYXZ.cjs.map

package/dist/http-D_Z8sYXZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-D_Z8sYXZ.cjs","names":["attrs: HttpSpanAttributes","otelAttrs: Attributes","headers: Record<string, string | string[] | undefined>","normalizedHeaders: Record<string, string>","headers: Record<string, string>","ctx?: Context","parentContext?: Context","SpanKind","span: Span","response: HttpResponseAttributes","error?: Error","SpanStatusCode","fn: (span: Span) => Promise<T & { statusCode?: number }>","name: string","attributes?: Attributes","fn: (span: Span) => Promise<T>"],"sources":["../src/instrumentation/http.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\ttype Context,\n\tcontext,\n\tpropagation,\n\ttype Span,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * HTTP request attributes following OpenTelemetry semantic conventions\n */\nexport interface HttpRequestAttributes {\n\tmethod: string;\n\turl?: string;\n\tpath?: string;\n\troute?: string;\n\thost?: string;\n\tscheme?: 'http' | 'https';\n\tuserAgent?: string;\n\tclientIp?: string;\n\trequestId?: string;\n}\n\n/**\n * HTTP response attributes\n */\nexport interface HttpResponseAttributes {\n\tstatusCode: number;\n\tresponseSize?: number;\n}\n\n/**\n * Endpoint-specific attributes\n */\nexport interface EndpointAttributes {\n\tname?: string;\n\toperationId?: string;\n\ttags?: string[];\n}\n\n/**\n * User/session attributes\n */\nexport interface UserAttributes {\n\tuserId?: string;\n\tsessionId?: string;\n\troles?: string[];\n}\n\n/**\n * Full span attributes for HTTP requests\n */\nexport interface HttpSpanAttributes extends HttpRequestAttributes {\n\tresponse?: HttpResponseAttributes;\n\tendpoint?: EndpointAttributes;\n\tuser?: UserAttributes;\n\tcustom?: Attributes;\n}\n\nconst TRACER_NAME = '@geekmidas/constructs';\n\n/**\n * Get or create a tracer for constructs instrumentation\n */\nexport function getConstructsTracer() {\n\treturn trace.getTracer(TRACER_NAME);\n}\n\n/**\n * Convert HTTP attributes to OpenTelemetry semantic conventions\n */\nexport function toOtelAttributes(attrs: HttpSpanAttributes): Attributes {\n\tconst otelAttrs: Attributes = {};\n\n\t// HTTP request attributes (OpenTelemetry semantic conventions)\n\tif (attrs.method) otelAttrs['http.request.method'] = attrs.method;\n\tif (attrs.url) otelAttrs['url.full'] = attrs.url;\n\tif (attrs.path) otelAttrs['url.path'] = attrs.path;\n\tif (attrs.route) otelAttrs['http.route'] = attrs.route;\n\tif (attrs.host) otelAttrs['server.address'] = attrs.host;\n\tif (attrs.scheme) otelAttrs['url.scheme'] = attrs.scheme;\n\tif (attrs.userAgent) otelAttrs['user_agent.original'] = attrs.userAgent;\n\tif (attrs.clientIp) otelAttrs['client.address'] = attrs.clientIp;\n\tif (attrs.requestId) otelAttrs['http.request.id'] = attrs.requestId;\n\n\t// HTTP response attributes\n\tif (attrs.response?.statusCode) {\n\t\totelAttrs['http.response.status_code'] = attrs.response.statusCode;\n\t}\n\tif (attrs.response?.responseSize) {\n\t\totelAttrs['http.response.body.size'] = attrs.response.responseSize;\n\t}\n\n\t// Endpoint attributes\n\tif (attrs.endpoint?.name) otelAttrs['endpoint.name'] = attrs.endpoint.name;\n\tif (attrs.endpoint?.operationId) {\n\t\totelAttrs['endpoint.operation_id'] = attrs.endpoint.operationId;\n\t}\n\tif (attrs.endpoint?.tags?.length) {\n\t\totelAttrs['endpoint.tags'] = attrs.endpoint.tags;\n\t}\n\n\t// User attributes\n\tif (attrs.user?.userId) otelAttrs['enduser.id'] = attrs.user.userId;\n\tif (attrs.user?.sessionId) otelAttrs['session.id'] = attrs.user.sessionId;\n\tif (attrs.user?.roles?.length)\n\t\totelAttrs['enduser.role'] = attrs.user.roles.join(',');\n\n\t// Custom attributes\n\tif (attrs.custom) {\n\t\tObject.assign(otelAttrs, attrs.custom);\n\t}\n\n\treturn otelAttrs;\n}\n\n/**\n * Extract trace context from HTTP headers\n */\nexport function extractTraceContext(\n\theaders: Record<string, string | string[] | undefined>,\n): Context {\n\t// Normalize headers to Record<string, string>\n\tconst normalizedHeaders: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value) {\n\t\t\tconst stringValue = Array.isArray(value) ? value[0] : value;\n\t\t\tif (stringValue) {\n\t\t\t\tnormalizedHeaders[key.toLowerCase()] = stringValue;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn propagation.extract(context.active(), normalizedHeaders);\n}\n\n/**\n * Inject trace context into HTTP headers\n */\nexport function injectTraceContext(\n\theaders: Record<string, string>,\n\tctx?: Context,\n): Record<string, string> {\n\tconst result = { ...headers };\n\tpropagation.inject(ctx ?? context.active(), result);\n\treturn result;\n}\n\n/**\n * Create an HTTP server span for an incoming request\n */\nexport function createHttpServerSpan(\n\tattrs: HttpSpanAttributes,\n\tparentContext?: Context,\n): Span {\n\tconst tracer = getConstructsTracer();\n\tconst spanName = attrs.route\n\t\t? `${attrs.method} ${attrs.route}`\n\t\t: `${attrs.method} ${attrs.path || '/'}`;\n\n\tconst ctx = parentContext ?? context.active();\n\n\treturn tracer.startSpan(\n\t\tspanName,\n\t\t{\n\t\t\tkind: SpanKind.SERVER,\n\t\t\tattributes: toOtelAttributes(attrs),\n\t\t},\n\t\tctx,\n\t);\n}\n\n/**\n * End an HTTP span with response data\n */\nexport function endHttpSpan(\n\tspan: Span,\n\tresponse: HttpResponseAttributes,\n\terror?: Error,\n): void {\n\tspan.setAttribute('http.response.status_code', response.statusCode);\n\n\tif (response.responseSize) {\n\t\tspan.setAttribute('http.response.body.size', response.responseSize);\n\t}\n\n\tif (error) {\n\t\tspan.recordException(error);\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error.message,\n\t\t});\n\t} else if (response.statusCode >= 400) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: `HTTP ${response.statusCode}`,\n\t\t});\n\t} else {\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t}\n\n\tspan.end();\n}\n\n/**\n * Execute a function within an HTTP server span context\n *\n * @example\n * ```typescript\n * const result = await withHttpSpan(\n *   { method: 'GET', path: '/users', route: '/users' },\n *   async (span) => {\n *     const users = await getUsers();\n *     return { statusCode: 200, body: users };\n *   }\n * );\n * ```\n */\nexport async function withHttpSpan<T>(\n\tattrs: HttpSpanAttributes,\n\tfn: (span: Span) => Promise<T & { statusCode?: number }>,\n\tparentContext?: Context,\n): Promise<T> {\n\tconst span = createHttpServerSpan(attrs, parentContext);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(parentContext ?? context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\n\t\tconst statusCode = (result as { statusCode?: number }).statusCode ?? 200;\n\t\tendHttpSpan(span, { statusCode });\n\n\t\treturn result;\n\t} catch (error) {\n\t\tendHttpSpan(\n\t\t\tspan,\n\t\t\t{ statusCode: 500 },\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t}\n}\n\n/**\n * Create a child span for internal operations (middleware, handlers, etc.)\n */\nexport function createChildSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = getConstructsTracer();\n\treturn tracer.startSpan(name, {\n\t\tkind: SpanKind.INTERNAL,\n\t\tattributes,\n\t});\n}\n\n/**\n * Execute a function within a child span\n */\nexport async function withChildSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst span = createChildSpan(name, attributes);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Check if tracing is enabled (OpenTelemetry API is available and configured)\n */\nexport function isTracingEnabled(): boolean {\n\ttry {\n\t\tconst tracer = trace.getTracer(TRACER_NAME);\n\t\t// Check if we have a real tracer (not a no-op)\n\t\tconst span = tracer.startSpan('test');\n\t\tconst isReal =\n\t\t\tspan.spanContext().traceId !== '00000000000000000000000000000000';\n\t\tspan.end();\n\t\treturn isReal;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/http-Dvca6fC3.d.cts

@@ -0,0 +1,107 @@
+import * as _opentelemetry_api2 from "@opentelemetry/api";
+import { Attributes, Context, Span } from "@opentelemetry/api";
+
+//#region src/instrumentation/http.d.ts
+/**
+ * HTTP request attributes following OpenTelemetry semantic conventions
+ */
+interface HttpRequestAttributes {
+  method: string;
+  url?: string;
+  path?: string;
+  route?: string;
+  host?: string;
+  scheme?: 'http' | 'https';
+  userAgent?: string;
+  clientIp?: string;
+  requestId?: string;
+}
+/**
+ * HTTP response attributes
+ */
+interface HttpResponseAttributes {
+  statusCode: number;
+  responseSize?: number;
+}
+/**
+ * Endpoint-specific attributes
+ */
+interface EndpointAttributes {
+  name?: string;
+  operationId?: string;
+  tags?: string[];
+}
+/**
+ * User/session attributes
+ */
+interface UserAttributes {
+  userId?: string;
+  sessionId?: string;
+  roles?: string[];
+}
+/**
+ * Full span attributes for HTTP requests
+ */
+interface HttpSpanAttributes extends HttpRequestAttributes {
+  response?: HttpResponseAttributes;
+  endpoint?: EndpointAttributes;
+  user?: UserAttributes;
+  custom?: Attributes;
+}
+/**
+ * Get or create a tracer for constructs instrumentation
+ */
+declare function getConstructsTracer(): _opentelemetry_api2.Tracer;
+/**
+ * Convert HTTP attributes to OpenTelemetry semantic conventions
+ */
+declare function toOtelAttributes(attrs: HttpSpanAttributes): Attributes;
+/**
+ * Extract trace context from HTTP headers
+ */
+declare function extractTraceContext(headers: Record<string, string | string[] | undefined>): Context;
+/**
+ * Inject trace context into HTTP headers
+ */
+declare function injectTraceContext(headers: Record<string, string>, ctx?: Context): Record<string, string>;
+/**
+ * Create an HTTP server span for an incoming request
+ */
+declare function createHttpServerSpan(attrs: HttpSpanAttributes, parentContext?: Context): Span;
+/**
+ * End an HTTP span with response data
+ */
+declare function endHttpSpan(span: Span, response: HttpResponseAttributes, error?: Error): void;
+/**
+ * Execute a function within an HTTP server span context
+ *
+ * @example
+ * ```typescript
+ * const result = await withHttpSpan(
+ *   { method: 'GET', path: '/users', route: '/users' },
+ *   async (span) => {
+ *     const users = await getUsers();
+ *     return { statusCode: 200, body: users };
+ *   }
+ * );
+ * ```
+ */
+declare function withHttpSpan<T>(attrs: HttpSpanAttributes, fn: (span: Span) => Promise<T & {
+  statusCode?: number;
+}>, parentContext?: Context): Promise<T>;
+/**
+ * Create a child span for internal operations (middleware, handlers, etc.)
+ */
+declare function createChildSpan(name: string, attributes?: Attributes): Span;
+/**
+ * Execute a function within a child span
+ */
+declare function withChildSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Attributes): Promise<T>;
+/**
+ * Check if tracing is enabled (OpenTelemetry API is available and configured)
+ */
+declare function isTracingEnabled(): boolean;
+//# sourceMappingURL=http.d.ts.map
+//#endregion
+export { EndpointAttributes, HttpRequestAttributes, HttpResponseAttributes, HttpSpanAttributes, UserAttributes, createChildSpan, createHttpServerSpan, endHttpSpan, extractTraceContext, getConstructsTracer, injectTraceContext, isTracingEnabled, toOtelAttributes, withChildSpan, withHttpSpan };
+//# sourceMappingURL=http-Dvca6fC3.d.cts.map

package/dist/http-Dvca6fC3.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-Dvca6fC3.d.cts","names":[],"sources":["../src/instrumentation/http.ts"],"sourcesContent":[],"mappings":";;;;;;;AAciB,UAAA,qBAAA,CAAqB;EAerB,MAAA,EAAA,MAAA;EAQA,GAAA,CAAA,EAAA,MAAA;EASA,IAAA,CAAA,EAAA,MAAA;EASA,KAAA,CAAA,EAAA,MAAA;EAAmB,IAAA,CAAA,EAAA,MAAA;EAAA,MACxB,CAAA,EAAA,MAAA,GAAA,OAAA;EAAsB,SACtB,CAAA,EAAA,MAAA;EAAkB,QACtB,CAAA,EAAA,MAAA;EAAc,SACZ,CAAA,EAAA,MAAA;;AAJuD;AAYjE;AAOA;AAAgC,UA7Cf,sBAAA,CA6Ce;EAAA,UAAQ,EAAA,MAAA;EAAkB,YAAG,CAAA,EAAA,MAAA;AAAU;AAgDvE;;;AAEG,UAvFc,kBAAA,CAuFd;EAAO,IAAA,CAAA,EAAA,MAAA;EAkBM,WAAA,CAAA,EAAA,MAAA;EAAkB,IAAA,CAAA,EAAA,MAAA,EAAA;;;;AAGzB;AASO,UA5GC,cAAA,CA4GmB;EAAA,MAAA,CAAA,EAAA,MAAA;EAAA,SAC5B,CAAA,EAAA,MAAA;EAAkB,KACT,CAAA,EAAA,MAAA,EAAA;;AACV;AAqBP;;AACO,UA5HU,kBAAA,SAA2B,qBA4HrC,CAAA;EAAI,QACA,CAAA,EA5HC,sBA4HD;EAAsB,QACxB,CAAA,EA5HG,kBA4HH;EAAK,IAAA,CAAA,EA3HN,cA2HM;EAwCQ,MAAA,CAAA,EAlKZ,UAkKwB;;;;;AAEb,iBA5JL,mBAAA,CAAA,CA4JK,EA5Jc,mBAAA,CAAA,MA4Jd;;;;AAEX,iBAvJM,gBAAA,CAuJN,KAAA,EAvJ8B,kBAuJ9B,CAAA,EAvJmD,UAuJnD;AA0BV;;;AAAwE,iBAjIxD,mBAAA,CAiIwD,OAAA,EAhI9D,MAgI8D,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,EAAA,GAAA,SAAA,CAAA,CAAA,EA/HrE,OA+HqE;AAAI;AAW5E;;AAEY,iBA1HI,kBAAA,CA0HJ,OAAA,EAzHF,MAyHE,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA,GAAA,CAAA,EAxHL,OAwHK,CAAA,EAvHT,MAuHS,CAAA,MAAA,EAAA,MAAA,CAAA;;;;AAED,iBAhHK,oBAAA,CAgHL,KAAA,EA/GH,kBA+GG,EAAA,aAAA,CAAA,EA9GM,OA8GN,CAAA,EA7GR,IA6GQ;;AAAD;AA2BV;iBAnHgB,WAAA,OACT,gBACI,gCACF;;;;;;;;;;;;;;;iBAwCa,uBACd,+BACI,SAAS,QAAQ;;oBACZ,UACd,QAAQ;;;;iBA0BK,eAAA,4BAA2C,aAAa;;;;iBAWlD,0CAEV,SAAS,QAAQ,iBACf,aACX,QAAQ;;;;iBA2BK,gBAAA,CAAA"}

package/dist/index-BL32-cvv.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/index-CsuikFeJ.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.cjs

@@ -1,8 +1,9 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_metrics_MetricsAggregator = require("./metrics/MetricsAggregator.cjs");
-const require_Telescope = require("./Telescope.cjs");
-require("./metrics/index.cjs");
-const require_storage_memory = require("./storage/memory.cjs");
-exports.InMemoryStorage = require_storage_memory.InMemoryStorage;
-exports.MetricsAggregator = require_metrics_MetricsAggregator.MetricsAggregator;
-exports.Telescope = require_Telescope.Telescope;
+const require_MetricsAggregator = require('./MetricsAggregator-B7lUICdH.cjs');
+require('./redact-DVaSSPZT.cjs');
+const require_Telescope = require('./Telescope-Cs3fv8jt.cjs');
+require('./metrics-fhD3l3C3.cjs');
+const require_memory = require('./memory-B0d_n1g5.cjs');
+
+exports.InMemoryStorage = require_memory.InMemoryStorage;
+exports.MetricsAggregator = require_MetricsAggregator.MetricsAggregator;
+exports.Telescope = require_Telescope.Telescope;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { C as TimeRange, S as TelescopeStorage, _ as TelescopeEvent, a as LogEntry, d as RequestContext, f as RequestEntry, g as StatusDistribution, h as StackFrame, i as ExceptionEntry, l as NormalizedTelescopeOptions, m as SourceContext, o as MetricsBucket, p as RequestMetrics, r as EndpointMetrics, s as MetricsQueryOptions, t as EndpointBucket, u as QueryOptions, v as TelescopeEventType, w as TimeSeriesPoint, x as TelescopeStats, y as TelescopeOptions } from "./types-BVujq4zd.cjs";
-import { n as MetricsAggregatorOptions, t as MetricsAggregator } from "./MetricsAggregator-CnC3oT5q.cjs";
-import { t as Telescope } from "./Telescope-DeqSHfuB.cjs";
-import { InMemoryStorage, InMemoryStorageOptions } from "./storage/memory.cjs";
-export { type EndpointBucket, type EndpointMetrics, type ExceptionEntry, InMemoryStorage, type InMemoryStorageOptions, type LogEntry, MetricsAggregator, type MetricsAggregatorOptions, type MetricsBucket, type MetricsQueryOptions, type NormalizedTelescopeOptions, type QueryOptions, type RequestContext, type RequestEntry, type RequestMetrics, type SourceContext, type StackFrame, type StatusDistribution, Telescope, type TelescopeEvent, type TelescopeEventType, type TelescopeOptions, type TelescopeStats, type TelescopeStorage, type TimeRange, type TimeSeriesPoint };
+import { EndpointBucket, EndpointMetrics, ExceptionEntry, LogEntry, MetricsBucket, MetricsQueryOptions, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, RequestMetrics, SourceContext, StackFrame, StatusDistribution, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage, TimeRange, TimeSeriesPoint } from "./types-l7Rlb5Mg.cjs";
+import { MetricsAggregator, MetricsAggregatorOptions } from "./MetricsAggregator-4SqelGcG.cjs";
+import { Telescope } from "./Telescope-D4nmwDRA.cjs";
+import "./index-BL32-cvv.cjs";
+import { InMemoryStorage, InMemoryStorageOptions } from "./memory--BK4iWiv.cjs";
+export { EndpointBucket, EndpointMetrics, ExceptionEntry, InMemoryStorage, InMemoryStorageOptions, LogEntry, MetricsAggregator, MetricsAggregatorOptions, MetricsBucket, MetricsQueryOptions, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, RequestMetrics, SourceContext, StackFrame, StatusDistribution, Telescope, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage, TimeRange, TimeSeriesPoint };

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { C as TimeRange, S as TelescopeStorage, _ as TelescopeEvent, a as LogEntry, d as RequestContext, f as RequestEntry, g as StatusDistribution, h as StackFrame, i as ExceptionEntry, l as NormalizedTelescopeOptions, m as SourceContext, o as MetricsBucket, p as RequestMetrics, r as EndpointMetrics, s as MetricsQueryOptions, t as EndpointBucket, u as QueryOptions, v as TelescopeEventType, w as TimeSeriesPoint, x as TelescopeStats, y as TelescopeOptions } from "./types-BVujq4zd.mjs";
-import { n as MetricsAggregatorOptions, t as MetricsAggregator } from "./MetricsAggregator-BJdIvfEv.mjs";
-import { t as Telescope } from "./Telescope-BVfDvVvY.mjs";
-import { InMemoryStorage, InMemoryStorageOptions } from "./storage/memory.mjs";
-export { type EndpointBucket, type EndpointMetrics, type ExceptionEntry, InMemoryStorage, type InMemoryStorageOptions, type LogEntry, MetricsAggregator, type MetricsAggregatorOptions, type MetricsBucket, type MetricsQueryOptions, type NormalizedTelescopeOptions, type QueryOptions, type RequestContext, type RequestEntry, type RequestMetrics, type SourceContext, type StackFrame, type StatusDistribution, Telescope, type TelescopeEvent, type TelescopeEventType, type TelescopeOptions, type TelescopeStats, type TelescopeStorage, type TimeRange, type TimeSeriesPoint };
+import { EndpointBucket, EndpointMetrics, ExceptionEntry, LogEntry, MetricsBucket, MetricsQueryOptions, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, RequestMetrics, SourceContext, StackFrame, StatusDistribution, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage, TimeRange, TimeSeriesPoint } from "./types-B1EIa_cQ.mjs";
+import { MetricsAggregator, MetricsAggregatorOptions } from "./MetricsAggregator-DZrW8ls6.mjs";
+import { Telescope } from "./Telescope-Dl6VSfxd.mjs";
+import "./index-CsuikFeJ.mjs";
+import { InMemoryStorage, InMemoryStorageOptions } from "./memory-DCirEVFW.mjs";
+export { EndpointBucket, EndpointMetrics, ExceptionEntry, InMemoryStorage, InMemoryStorageOptions, LogEntry, MetricsAggregator, MetricsAggregatorOptions, MetricsBucket, MetricsQueryOptions, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, RequestMetrics, SourceContext, StackFrame, StatusDistribution, Telescope, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage, TimeRange, TimeSeriesPoint };

package/dist/index.mjs

@@ -1,5 +1,7 @@
-import { MetricsAggregator } from "./metrics/MetricsAggregator.mjs";
-import { Telescope } from "./Telescope.mjs";
-import "./metrics/index.mjs";
-import { InMemoryStorage } from "./storage/memory.mjs";
-export { InMemoryStorage, MetricsAggregator, Telescope };
+import { MetricsAggregator } from "./MetricsAggregator-S3DQWNas.mjs";
+import "./redact-BzkITCNW.mjs";
+import { Telescope } from "./Telescope-Dh5av3FC.mjs";
+import "./metrics-D5YT-Rnq.mjs";
+import { InMemoryStorage } from "./memory-6S9H-IF5.mjs";
+
+export { InMemoryStorage, MetricsAggregator, Telescope };