@geekmidas/telescope 10.0.0-alpha.2 → 10.0.0-alpha.21

package/dist/instrumentation/setup.d.cts

@@ -1,3 +1,83 @@
-import "../types-BRzW1NM8.cjs";
-import { TelemetryOptions, setupTelemetry, shutdownTelemetry } from "../setup-D58N1f9O.cjs";
-export { TelemetryOptions, setupTelemetry, shutdownTelemetry };
+import { SpanProcessorStrategy } from "../adapters/types.cjs";
+//#region src/instrumentation/setup.d.ts
+/**
+ * Options for configuring telemetry
+ */
+export interface TelemetryOptions {
+  /**
+   * Service name for resource identification
+   */
+  serviceName: string;
+  /**
+   * Service version
+   */
+  serviceVersion?: string;
+  /**
+   * OTLP endpoint URL (e.g., 'http://localhost:3000/__telescope/v1')
+   * If not provided, traces will be logged to console
+   */
+  endpoint?: string;
+  /**
+   * Whether to instrument Pino for log correlation
+   * @default true
+   */
+  instrumentPino?: boolean;
+  /**
+   * Whether to enable auto-instrumentation for common libraries
+   * (http, fetch, express, etc.)
+   * @default true
+   */
+  autoInstrument?: boolean;
+  /**
+   * Enable debug logging for OTel SDK
+   * @default false
+   */
+  debug?: boolean;
+  /**
+   * Additional resource attributes
+   */
+  resourceAttributes?: Record<string, string>;
+  /**
+   * Headers to send with OTLP requests
+   */
+  headers?: Record<string, string>;
+  /**
+   * Span processor strategy.
+   * - 'batch': Efficient batching for long-running servers (default)
+   * - 'simple': Immediate export for serverless environments (Lambda, Edge)
+   *
+   * If not specified, automatically selected based on environment detection.
+   */
+  spanProcessorStrategy?: SpanProcessorStrategy;
+  /**
+   * Environment type for automatic configuration
+   * @default 'server'
+   */
+  environment?: 'server' | 'lambda' | 'edge' | 'custom';
+}
+/**
+ * Set up OpenTelemetry instrumentation.
+ * Call this BEFORE importing your application code.
+ *
+ * @example
+ * ```typescript
+ * // instrumentation.ts (create this file)
+ * import { setupTelemetry } from '@geekmidas/telescope/instrumentation';
+ *
+ * setupTelemetry({
+ *   serviceName: 'my-api',
+ *   endpoint: 'http://localhost:3000/__telescope/v1',
+ * });
+ *
+ * // Then in your entry point:
+ * // import './instrumentation';
+ * // import { app } from './app';
+ * ```
+ */
+export declare function setupTelemetry(options: TelemetryOptions): void;
+/**
+ * Shut down telemetry (for testing or graceful shutdown)
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//#endregion
+//# sourceMappingURL=setup.d.cts.map

package/dist/instrumentation/setup.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.cts","names":[],"sources":["../../src/instrumentation/setup.ts"],"mappings":";;;;;iBA8BiB;;;;EAIhB;;;;EAKA;;;;;EAMA;;;;;EAMA;;;;;;EAOA;;;;;EAMA;;;;EAKA,qBAAqB;;;;EAKrB,UAAU;;;;;;;;EASV,wBAAwB;;;;;EAMxB;;;;;;;;;;;;;;;;;;;;;wBAwBe,eAAe,SAAS;;;;wBA0IlB,qBAAqB"}

package/dist/instrumentation/setup.d.mts

@@ -1,3 +1,83 @@
-import "../types-BzQ78Efw.mjs";
-import { TelemetryOptions, setupTelemetry, shutdownTelemetry } from "../setup-Bkxm4g6b.mjs";
-export { TelemetryOptions, setupTelemetry, shutdownTelemetry };
+import { SpanProcessorStrategy } from "../adapters/types.mjs";
+//#region src/instrumentation/setup.d.ts
+/**
+ * Options for configuring telemetry
+ */
+export interface TelemetryOptions {
+  /**
+   * Service name for resource identification
+   */
+  serviceName: string;
+  /**
+   * Service version
+   */
+  serviceVersion?: string;
+  /**
+   * OTLP endpoint URL (e.g., 'http://localhost:3000/__telescope/v1')
+   * If not provided, traces will be logged to console
+   */
+  endpoint?: string;
+  /**
+   * Whether to instrument Pino for log correlation
+   * @default true
+   */
+  instrumentPino?: boolean;
+  /**
+   * Whether to enable auto-instrumentation for common libraries
+   * (http, fetch, express, etc.)
+   * @default true
+   */
+  autoInstrument?: boolean;
+  /**
+   * Enable debug logging for OTel SDK
+   * @default false
+   */
+  debug?: boolean;
+  /**
+   * Additional resource attributes
+   */
+  resourceAttributes?: Record<string, string>;
+  /**
+   * Headers to send with OTLP requests
+   */
+  headers?: Record<string, string>;
+  /**
+   * Span processor strategy.
+   * - 'batch': Efficient batching for long-running servers (default)
+   * - 'simple': Immediate export for serverless environments (Lambda, Edge)
+   *
+   * If not specified, automatically selected based on environment detection.
+   */
+  spanProcessorStrategy?: SpanProcessorStrategy;
+  /**
+   * Environment type for automatic configuration
+   * @default 'server'
+   */
+  environment?: 'server' | 'lambda' | 'edge' | 'custom';
+}
+/**
+ * Set up OpenTelemetry instrumentation.
+ * Call this BEFORE importing your application code.
+ *
+ * @example
+ * ```typescript
+ * // instrumentation.ts (create this file)
+ * import { setupTelemetry } from '@geekmidas/telescope/instrumentation';
+ *
+ * setupTelemetry({
+ *   serviceName: 'my-api',
+ *   endpoint: 'http://localhost:3000/__telescope/v1',
+ * });
+ *
+ * // Then in your entry point:
+ * // import './instrumentation';
+ * // import { app } from './app';
+ * ```
+ */
+export declare function setupTelemetry(options: TelemetryOptions): void;
+/**
+ * Shut down telemetry (for testing or graceful shutdown)
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//#endregion
+//# sourceMappingURL=setup.d.mts.map

package/dist/instrumentation/setup.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.mts","names":[],"sources":["../../src/instrumentation/setup.ts"],"mappings":";;;;;iBA8BiB;;;;EAIhB;;;;EAKA;;;;;EAMA;;;;;EAMA;;;;;;EAOA;;;;;EAMA;;;;EAKA,qBAAqB;;;;EAKrB,UAAU;;;;;;;;EASV,wBAAwB;;;;;EAMxB;;;;;;;;;;;;;;;;;;;;;wBAwBe,eAAe,SAAS;;;;wBA0IlB,qBAAqB"}

package/dist/instrumentation/setup.mjs

@@ -1,4 +1,99 @@
-import "../core-D6hJ6exL.mjs";
-import { setupTelemetry, shutdownTelemetry } from "../setup-DC9JMEYZ.mjs";
+import { createSpanProcessor, getRecommendedStrategy, setGlobalLogProcessor, setGlobalSpanProcessor } from "./core.mjs";
+import { DiagConsoleLogger, DiagLogLevel, diag } from "@opentelemetry/api";
+import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { PinoInstrumentation } from "@opentelemetry/instrumentation-pino";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { BatchLogRecordProcessor, LoggerProvider } from "@opentelemetry/sdk-logs";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { ConsoleSpanExporter } from "@opentelemetry/sdk-trace-node";
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
+//#region src/instrumentation/setup.ts
+let sdk = null;
+/**
+* Set up OpenTelemetry instrumentation.
+* Call this BEFORE importing your application code.
+*
+* @example
+* ```typescript
+* // instrumentation.ts (create this file)
+* import { setupTelemetry } from '@geekmidas/telescope/instrumentation';
+*
+* setupTelemetry({
+*   serviceName: 'my-api',
+*   endpoint: 'http://localhost:3000/__telescope/v1',
+* });
+*
+* // Then in your entry point:
+* // import './instrumentation';
+* // import { app } from './app';
+* ```
+*/
+function setupTelemetry(options) {
+	if (sdk) return;
+	const { serviceName, serviceVersion = "1.0.0", endpoint, instrumentPino = true, autoInstrument = true, debug = false, resourceAttributes = {}, headers = {}, spanProcessorStrategy, environment = "server" } = options;
+	if (debug) diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);
+	const resource = resourceFromAttributes({
+		[ATTR_SERVICE_NAME]: serviceName,
+		[ATTR_SERVICE_VERSION]: serviceVersion,
+		...resourceAttributes
+	});
+	const instrumentations = [];
+	if (instrumentPino) instrumentations.push(new PinoInstrumentation({ logHook: (span, record) => {
+		record.trace_id = span.spanContext().traceId;
+		record.span_id = span.spanContext().spanId;
+		record.trace_flags = span.spanContext().traceFlags;
+	} }));
+	if (autoInstrument) instrumentations.push(getNodeAutoInstrumentations({
+		"@opentelemetry/instrumentation-fs": { enabled: false },
+		"@opentelemetry/instrumentation-http": { ignoreIncomingRequestHook: (request) => {
+			const path = request.url || "";
+			return path.includes("/__health") || path.includes("/__telescope") || path.includes("/favicon");
+		} }
+	}));
+	let traceExporter;
+	if (endpoint) traceExporter = new OTLPTraceExporter({
+		url: `${endpoint}/traces`,
+		headers
+	});
+	else traceExporter = new ConsoleSpanExporter();
+	const strategy = spanProcessorStrategy ?? getRecommendedStrategy(environment);
+	const spanProcessor = createSpanProcessor(traceExporter, { strategy });
+	setGlobalSpanProcessor(spanProcessor);
+	sdk = new NodeSDK({
+		resource,
+		traceExporter,
+		spanProcessors: [spanProcessor],
+		instrumentations
+	});
+	if (endpoint) {
+		const logExporter = new OTLPLogExporter({
+			url: `${endpoint}/logs`,
+			headers
+		});
+		const logProcessor = new BatchLogRecordProcessor({ exporter: logExporter });
+		new LoggerProvider({
+			resource,
+			processors: [logProcessor]
+		});
+		setGlobalLogProcessor(logProcessor);
+	}
+	sdk.start();
+	process.on("SIGTERM", () => {
+		sdk?.shutdown().then(() => {}).catch((_error) => {}).finally(() => process.exit(0));
+	});
+}
+/**
+* Shut down telemetry (for testing or graceful shutdown)
+*/
+async function shutdownTelemetry() {
+	if (sdk) {
+		await sdk.shutdown();
+		sdk = null;
+	}
+}
+//#endregion
+export { setupTelemetry, shutdownTelemetry };
 
-export { setupTelemetry, shutdownTelemetry };
+//# sourceMappingURL=setup.mjs.map

package/dist/instrumentation/setup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.mjs","names":[],"sources":["../../src/instrumentation/setup.ts"],"sourcesContent":["import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { PinoInstrumentation } from '@opentelemetry/instrumentation-pino';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport {\n\tBatchLogRecordProcessor,\n\tLoggerProvider,\n} from '@opentelemetry/sdk-logs';\nimport { NodeSDK } from '@opentelemetry/sdk-node';\nimport {\n\tConsoleSpanExporter,\n\ttype SpanExporter,\n} from '@opentelemetry/sdk-trace-node';\nimport {\n\tATTR_SERVICE_NAME,\n\tATTR_SERVICE_VERSION,\n} from '@opentelemetry/semantic-conventions';\nimport type { SpanProcessorStrategy } from '../adapters/types';\nimport {\n\tcreateSpanProcessor,\n\tgetRecommendedStrategy,\n\tsetGlobalLogProcessor,\n\tsetGlobalSpanProcessor,\n} from './core';\n\n/**\n * Options for configuring telemetry\n */\nexport interface TelemetryOptions {\n\t/**\n\t * Service name for resource identification\n\t */\n\tserviceName: string;\n\n\t/**\n\t * Service version\n\t */\n\tserviceVersion?: string;\n\n\t/**\n\t * OTLP endpoint URL (e.g., 'http://localhost:3000/__telescope/v1')\n\t * If not provided, traces will be logged to console\n\t */\n\tendpoint?: string;\n\n\t/**\n\t * Whether to instrument Pino for log correlation\n\t * @default true\n\t */\n\tinstrumentPino?: boolean;\n\n\t/**\n\t * Whether to enable auto-instrumentation for common libraries\n\t * (http, fetch, express, etc.)\n\t * @default true\n\t */\n\tautoInstrument?: boolean;\n\n\t/**\n\t * Enable debug logging for OTel SDK\n\t * @default false\n\t */\n\tdebug?: boolean;\n\n\t/**\n\t * Additional resource attributes\n\t */\n\tresourceAttributes?: Record<string, string>;\n\n\t/**\n\t * Headers to send with OTLP requests\n\t */\n\theaders?: Record<string, string>;\n\n\t/**\n\t * Span processor strategy.\n\t * - 'batch': Efficient batching for long-running servers (default)\n\t * - 'simple': Immediate export for serverless environments (Lambda, Edge)\n\t *\n\t * If not specified, automatically selected based on environment detection.\n\t */\n\tspanProcessorStrategy?: SpanProcessorStrategy;\n\n\t/**\n\t * Environment type for automatic configuration\n\t * @default 'server'\n\t */\n\tenvironment?: 'server' | 'lambda' | 'edge' | 'custom';\n}\n\nlet sdk: NodeSDK | null = null;\n\n/**\n * Set up OpenTelemetry instrumentation.\n * Call this BEFORE importing your application code.\n *\n * @example\n * ```typescript\n * // instrumentation.ts (create this file)\n * import { setupTelemetry } from '@geekmidas/telescope/instrumentation';\n *\n * setupTelemetry({\n *   serviceName: 'my-api',\n *   endpoint: 'http://localhost:3000/__telescope/v1',\n * });\n *\n * // Then in your entry point:\n * // import './instrumentation';\n * // import { app } from './app';\n * ```\n */\nexport function setupTelemetry(options: TelemetryOptions): void {\n\tif (sdk) {\n\t\treturn;\n\t}\n\n\tconst {\n\t\tserviceName,\n\t\tserviceVersion = '1.0.0',\n\t\tendpoint,\n\t\tinstrumentPino = true,\n\t\tautoInstrument = true,\n\t\tdebug = false,\n\t\tresourceAttributes = {},\n\t\theaders = {},\n\t\tspanProcessorStrategy,\n\t\tenvironment = 'server',\n\t} = options;\n\n\t// Enable debug logging if requested\n\tif (debug) {\n\t\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);\n\t}\n\n\t// Create resource\n\t// `new Resource(...)` went in resources 2.x — a resource is now made from\n\t// attributes by a function, so a detector and a literal produce the same\n\t// thing rather than two shapes that had to be merged.\n\tconst resource = resourceFromAttributes({\n\t\t[ATTR_SERVICE_NAME]: serviceName,\n\t\t[ATTR_SERVICE_VERSION]: serviceVersion,\n\t\t...resourceAttributes,\n\t});\n\n\t// Build instrumentations list\n\tconst instrumentations = [];\n\n\t// Add Pino instrumentation for log correlation\n\tif (instrumentPino) {\n\t\tinstrumentations.push(\n\t\t\tnew PinoInstrumentation({\n\t\t\t\t// Inject trace context into log records\n\t\t\t\tlogHook: (span, record) => {\n\t\t\t\t\trecord.trace_id = span.spanContext().traceId;\n\t\t\t\t\trecord.span_id = span.spanContext().spanId;\n\t\t\t\t\trecord.trace_flags = span.spanContext().traceFlags;\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Add auto-instrumentations for common libraries\n\tif (autoInstrument) {\n\t\tinstrumentations.push(\n\t\t\tgetNodeAutoInstrumentations({\n\t\t\t\t// Disable file system instrumentation (too noisy)\n\t\t\t\t'@opentelemetry/instrumentation-fs': { enabled: false },\n\t\t\t\t// Configure HTTP instrumentation\n\t\t\t\t'@opentelemetry/instrumentation-http': {\n\t\t\t\t\tignoreIncomingRequestHook: (request) => {\n\t\t\t\t\t\t// Ignore health checks and internal routes\n\t\t\t\t\t\tconst path = request.url || '';\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\tpath.includes('/__health') ||\n\t\t\t\t\t\t\tpath.includes('/__telescope') ||\n\t\t\t\t\t\t\tpath.includes('/favicon')\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Create exporters\n\tlet traceExporter: SpanExporter;\n\tif (endpoint) {\n\t\ttraceExporter = new OTLPTraceExporter({\n\t\t\turl: `${endpoint}/traces`,\n\t\t\theaders,\n\t\t});\n\t} else {\n\t\t// Fall back to console exporter for debugging\n\t\ttraceExporter = new ConsoleSpanExporter();\n\t}\n\n\t// Determine span processor strategy\n\tconst strategy = spanProcessorStrategy ?? getRecommendedStrategy(environment);\n\tconst spanProcessor = createSpanProcessor(traceExporter, { strategy });\n\n\t// Register globally for flush operations\n\tsetGlobalSpanProcessor(spanProcessor);\n\n\t// Create and configure SDK\n\tsdk = new NodeSDK({\n\t\tresource,\n\t\ttraceExporter,\n\t\tspanProcessors: [spanProcessor],\n\t\tinstrumentations,\n\t});\n\n\t// Set up log exporter if endpoint is provided\n\tif (endpoint) {\n\t\tconst logExporter = new OTLPLogExporter({\n\t\t\turl: `${endpoint}/logs`,\n\t\t\theaders,\n\t\t});\n\n\t\t// Both changed in sdk-logs 2.x, and for the same reason the trace SDK\n\t\t// changed: a provider whose processors could be swapped after it had begun\n\t\t// emitting was never safe, so processors are constructor-only and the\n\t\t// exporter is named rather than positional.\n\t\tconst logProcessor = new BatchLogRecordProcessor({\n\t\t\texporter: logExporter,\n\t\t});\n\t\tconst loggerProvider = new LoggerProvider({\n\t\t\tresource,\n\t\t\tprocessors: [logProcessor],\n\t\t});\n\n\t\t// Register for flush operations\n\t\tsetGlobalLogProcessor(logProcessor);\n\t}\n\n\t// Start the SDK\n\tsdk.start();\n\n\t// Graceful shutdown\n\tprocess.on('SIGTERM', () => {\n\t\tsdk\n\t\t\t?.shutdown()\n\t\t\t.then(() => {})\n\t\t\t.catch((_error) => {})\n\t\t\t.finally(() => process.exit(0));\n\t});\n}\n\n/**\n * Shut down telemetry (for testing or graceful shutdown)\n */\nexport async function shutdownTelemetry(): Promise<void> {\n\tif (sdk) {\n\t\tawait sdk.shutdown();\n\t\tsdk = null;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AA4FA,IAAI,MAAsB;;;;;;;;;;;;;;;;;;;;AAqB1B,SAAgB,eAAe,SAAiC;CAC/D,IAAI,KACH;CAGD,MAAM,EACL,aACA,iBAAiB,SACjB,UACA,iBAAiB,MACjB,iBAAiB,MACjB,QAAQ,OACR,qBAAqB,CAAC,GACtB,UAAU,CAAC,GACX,uBACA,cAAc,aACX;CAGJ,IAAI,OACH,KAAK,UAAU,IAAI,kBAAkB,GAAG,aAAa,KAAK;CAO3D,MAAM,WAAW,uBAAuB;GACtC,oBAAoB;GACpB,uBAAuB;EACxB,GAAG;CACJ,CAAC;CAGD,MAAM,mBAAmB,CAAC;CAG1B,IAAI,gBACH,iBAAiB,KAChB,IAAI,oBAAoB,EAEvB,UAAU,MAAM,WAAW;EAC1B,OAAO,WAAW,KAAK,YAAY,CAAC,CAAC;EACrC,OAAO,UAAU,KAAK,YAAY,CAAC,CAAC;EACpC,OAAO,cAAc,KAAK,YAAY,CAAC,CAAC;CACzC,EACD,CAAC,CACF;CAID,IAAI,gBACH,iBAAiB,KAChB,4BAA4B;EAE3B,qCAAqC,EAAE,SAAS,MAAM;EAEtD,uCAAuC,EACtC,4BAA4B,YAAY;GAEvC,MAAM,OAAO,QAAQ,OAAO;GAC5B,OACC,KAAK,SAAS,WAAW,KACzB,KAAK,SAAS,cAAc,KAC5B,KAAK,SAAS,UAAU;EAE1B,EACD;CACD,CAAC,CACF;CAID,IAAI;CACJ,IAAI,UACH,gBAAgB,IAAI,kBAAkB;EACrC,KAAK,GAAG,SAAS;EACjB;CACD,CAAC;MAGD,gBAAgB,IAAI,oBAAoB;CAIzC,MAAM,WAAW,yBAAyB,uBAAuB,WAAW;CAC5E,MAAM,gBAAgB,oBAAoB,eAAe,EAAE,SAAS,CAAC;CAGrE,uBAAuB,aAAa;CAGpC,MAAM,IAAI,QAAQ;EACjB;EACA;EACA,gBAAgB,CAAC,aAAa;EAC9B;CACD,CAAC;CAGD,IAAI,UAAU;EACb,MAAM,cAAc,IAAI,gBAAgB;GACvC,KAAK,GAAG,SAAS;GACjB;EACD,CAAC;EAMD,MAAM,eAAe,IAAI,wBAAwB,EAChD,UAAU,YACX,CAAC;EACsB,IAAI,eAAe;GACzC;GACA,YAAY,CAAC,YAAY;EAC1B,CAAC;EAGD,sBAAsB,YAAY;CACnC;CAGA,IAAI,MAAM;CAGV,QAAQ,GAAG,iBAAiB;EAC3B,KACG,SAAS,CAAC,CACX,WAAW,CAAC,CAAC,CAAC,CACd,OAAO,WAAW,CAAC,CAAC,CAAC,CACrB,cAAc,QAAQ,KAAK,CAAC,CAAC;CAChC,CAAC;AACF;;;;AAKA,eAAsB,oBAAmC;CACxD,IAAI,KAAK;EACR,MAAM,IAAI,SAAS;EACnB,MAAM;CACP;AACD"}

package/dist/instrumentation/tracing.cjs

@@ -1,11 +1,115 @@
-const require_tracing = require('../tracing-Bt1zWRlb.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _opentelemetry_api = require("@opentelemetry/api");
+//#region src/instrumentation/tracing.ts
+/**
+* Get the currently active span
+*/
+function getActiveSpan() {
+	return _opentelemetry_api.trace.getActiveSpan();
+}
+/**
+* Set attributes on the active span
+*/
+function setSpanAttributes(attributes) {
+	const span = getActiveSpan();
+	if (span) span.setAttributes(attributes);
+}
+/**
+* Create a new span as a child of the current span
+*/
+function createSpan(name, attributes) {
+	return _opentelemetry_api.trace.getTracer("@geekmidas/telescope").startSpan(name, { attributes });
+}
+/**
+* Execute a function within a new span context
+*
+* @example
+* ```typescript
+* const result = await withSpan('processOrder', async (span) => {
+*   span.setAttribute('order.id', orderId);
+*   const order = await processOrder(orderId);
+*   return order;
+* });
+* ```
+*/
+async function withSpan(name, fn, attributes) {
+	const span = _opentelemetry_api.trace.getTracer("@geekmidas/telescope").startSpan(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();
+	}
+}
+/**
+* Synchronous version of withSpan
+*/
+function withSpanSync(name, fn, attributes) {
+	const span = _opentelemetry_api.trace.getTracer("@geekmidas/telescope").startSpan(name, { attributes });
+	try {
+		const result = _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();
+	}
+}
+/**
+* Get the current trace ID (useful for log correlation)
+*/
+function getTraceId() {
+	return getActiveSpan()?.spanContext().traceId;
+}
+/**
+* Get the current span ID
+*/
+function getSpanId() {
+	return getActiveSpan()?.spanContext().spanId;
+}
+/**
+* Record an exception on the current span
+*/
+function recordException(error) {
+	const span = getActiveSpan();
+	if (span) {
+		span.recordException(error);
+		span.setStatus({
+			code: _opentelemetry_api.SpanStatusCode.ERROR,
+			message: error.message
+		});
+	}
+}
+/**
+* Add an event to the current span
+*/
+function addSpanEvent(name, attributes) {
+	const span = getActiveSpan();
+	if (span) span.addEvent(name, attributes);
+}
+//#endregion
+exports.addSpanEvent = addSpanEvent;
+exports.createSpan = createSpan;
+exports.getActiveSpan = getActiveSpan;
+exports.getSpanId = getSpanId;
+exports.getTraceId = getTraceId;
+exports.recordException = recordException;
+exports.setSpanAttributes = setSpanAttributes;
+exports.withSpan = withSpan;
+exports.withSpanSync = withSpanSync;
 
-exports.addSpanEvent = require_tracing.addSpanEvent;
-exports.createSpan = require_tracing.createSpan;
-exports.getActiveSpan = require_tracing.getActiveSpan;
-exports.getSpanId = require_tracing.getSpanId;
-exports.getTraceId = require_tracing.getTraceId;
-exports.recordException = require_tracing.recordException;
-exports.setSpanAttributes = require_tracing.setSpanAttributes;
-exports.withSpan = require_tracing.withSpan;
-exports.withSpanSync = require_tracing.withSpanSync;
+//# sourceMappingURL=tracing.cjs.map

package/dist/instrumentation/tracing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.cjs","names":["trace","context","SpanStatusCode"],"sources":["../../src/instrumentation/tracing.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\tcontext,\n\ttype Span,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * Get the currently active span\n */\nexport function getActiveSpan(): Span | undefined {\n\treturn trace.getActiveSpan();\n}\n\n/**\n * Set attributes on the active span\n */\nexport function setSpanAttributes(attributes: Attributes): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.setAttributes(attributes);\n\t}\n}\n\n/**\n * Create a new span as a child of the current span\n */\nexport function createSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\treturn span;\n}\n\n/**\n * Execute a function within a new span context\n *\n * @example\n * ```typescript\n * const result = await withSpan('processOrder', async (span) => {\n *   span.setAttribute('order.id', orderId);\n *   const order = await processOrder(orderId);\n *   return order;\n * });\n * ```\n */\nexport async function withSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(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 * Synchronous version of withSpan\n */\nexport function withSpanSync<T>(\n\tname: string,\n\tfn: (span: Span) => T,\n\tattributes?: Attributes,\n): T {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\n\ttry {\n\t\tconst result = context.with(trace.setSpan(context.active(), span), () =>\n\t\t\tfn(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 * Get the current trace ID (useful for log correlation)\n */\nexport function getTraceId(): string | undefined {\n\tconst span = getActiveSpan();\n\treturn span?.spanContext().traceId;\n}\n\n/**\n * Get the current span ID\n */\nexport function getSpanId(): string | undefined {\n\tconst span = getActiveSpan();\n\treturn span?.spanContext().spanId;\n}\n\n/**\n * Record an exception on the current span\n */\nexport function recordException(error: Error): void {\n\tconst span = getActiveSpan();\n\tif (span) {\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}\n}\n\n/**\n * Add an event to the current span\n */\nexport function addSpanEvent(name: string, attributes?: Attributes): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.addEvent(name, attributes);\n\t}\n}\n"],"mappings":";;;;;;AAWA,SAAgB,gBAAkC;CACjD,OAAOA,mBAAAA,MAAM,cAAc;AAC5B;;;;AAKA,SAAgB,kBAAkB,YAA8B;CAC/D,MAAM,OAAO,cAAc;CAC3B,IAAI,MACH,KAAK,cAAc,UAAU;AAE/B;;;;AAKA,SAAgB,WAAW,MAAc,YAA+B;CAGvE,OAFeA,mBAAAA,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CACvC;AACX;;;;;;;;;;;;;AAcA,eAAsB,SACrB,MACA,IACA,YACa;CAEb,MAAM,OADSA,mBAAAA,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CAAC;CAElD,IAAI;EACH,MAAM,SAAS,MAAMC,mBAAAA,QAAQ,KAC5BD,mBAAAA,MAAM,QAAQC,mBAAAA,QAAQ,OAAO,GAAG,IAAI,SAC9B,GAAG,IAAI,CACd;EACA,KAAK,UAAU,EAAE,MAAMC,mBAAAA,eAAe,GAAG,CAAC;EAC1C,OAAO;CACR,SAAS,OAAO;EACf,KAAK,UAAU;GACd,MAAMA,mBAAAA,eAAe;GACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EACnD,CAAC;EACD,KAAK,gBACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CACzD;EACA,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD;;;;AAKA,SAAgB,aACf,MACA,IACA,YACI;CAEJ,MAAM,OADSF,mBAAAA,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CAAC;CAElD,IAAI;EACH,MAAM,SAASC,mBAAAA,QAAQ,KAAKD,mBAAAA,MAAM,QAAQC,mBAAAA,QAAQ,OAAO,GAAG,IAAI,SAC/D,GAAG,IAAI,CACR;EACA,KAAK,UAAU,EAAE,MAAMC,mBAAAA,eAAe,GAAG,CAAC;EAC1C,OAAO;CACR,SAAS,OAAO;EACf,KAAK,UAAU;GACd,MAAMA,mBAAAA,eAAe;GACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EACnD,CAAC;EACD,KAAK,gBACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CACzD;EACA,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD;;;;AAKA,SAAgB,aAAiC;CAEhD,OADa,cACH,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B;;;;AAKA,SAAgB,YAAgC;CAE/C,OADa,cACH,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B;;;;AAKA,SAAgB,gBAAgB,OAAoB;CACnD,MAAM,OAAO,cAAc;CAC3B,IAAI,MAAM;EACT,KAAK,gBAAgB,KAAK;EAC1B,KAAK,UAAU;GACd,MAAMA,mBAAAA,eAAe;GACrB,SAAS,MAAM;EAChB,CAAC;CACF;AACD;;;;AAKA,SAAgB,aAAa,MAAc,YAA+B;CACzE,MAAM,OAAO,cAAc;CAC3B,IAAI,MACH,KAAK,SAAS,MAAM,UAAU;AAEhC"}

package/dist/instrumentation/tracing.d.cts

@@ -1,2 +1,49 @@
-import { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync } from "../tracing-BX8uY2nR.cjs";
-export { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync };
+import { Attributes, Span } from "@opentelemetry/api";
+//#region src/instrumentation/tracing.d.ts
+/**
+ * Get the currently active span
+ */
+export declare function getActiveSpan(): Span | undefined;
+/**
+ * Set attributes on the active span
+ */
+export declare function setSpanAttributes(attributes: Attributes): void;
+/**
+ * Create a new span as a child of the current span
+ */
+export declare function createSpan(name: string, attributes?: Attributes): Span;
+/**
+ * Execute a function within a new span context
+ *
+ * @example
+ * ```typescript
+ * const result = await withSpan('processOrder', async (span) => {
+ *   span.setAttribute('order.id', orderId);
+ *   const order = await processOrder(orderId);
+ *   return order;
+ * });
+ * ```
+ */
+export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Attributes): Promise<T>;
+/**
+ * Synchronous version of withSpan
+ */
+export declare function withSpanSync<T>(name: string, fn: (span: Span) => T, attributes?: Attributes): T;
+/**
+ * Get the current trace ID (useful for log correlation)
+ */
+export declare function getTraceId(): string | undefined;
+/**
+ * Get the current span ID
+ */
+export declare function getSpanId(): string | undefined;
+/**
+ * Record an exception on the current span
+ */
+export declare function recordException(error: Error): void;
+/**
+ * Add an event to the current span
+ */
+export declare function addSpanEvent(name: string, attributes?: Attributes): void;
+//#endregion
+//# sourceMappingURL=tracing.d.cts.map

package/dist/instrumentation/tracing.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.cts","names":[],"sources":["../../src/instrumentation/tracing.ts"],"mappings":";;;;;wBAWgB,iBAAiB;;;;wBAOjB,kBAAkB,YAAY;;;;wBAU9B,WAAW,cAAc,aAAa,aAAa;;;;;;;;;;;;;wBAkB7C,SAAS,GAC9B,cACA,KAAK,MAAM,SAAS,QAAQ,IAC5B,aAAa,aACX,QAAQ;;;;wBA4BK,aAAa,GAC5B,cACA,KAAK,MAAM,SAAS,GACpB,aAAa,aACX;;;;wBA2Ba;;;;wBAQA;;;;wBAQA,gBAAgB,OAAO;;;;wBAcvB,aAAa,cAAc,aAAa"}

package/dist/instrumentation/tracing.d.mts

@@ -1,2 +1,49 @@
-import { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync } from "../tracing-PnECEbEu.mjs";
-export { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync };
+import { Attributes, Span } from "@opentelemetry/api";
+//#region src/instrumentation/tracing.d.ts
+/**
+ * Get the currently active span
+ */
+export declare function getActiveSpan(): Span | undefined;
+/**
+ * Set attributes on the active span
+ */
+export declare function setSpanAttributes(attributes: Attributes): void;
+/**
+ * Create a new span as a child of the current span
+ */
+export declare function createSpan(name: string, attributes?: Attributes): Span;
+/**
+ * Execute a function within a new span context
+ *
+ * @example
+ * ```typescript
+ * const result = await withSpan('processOrder', async (span) => {
+ *   span.setAttribute('order.id', orderId);
+ *   const order = await processOrder(orderId);
+ *   return order;
+ * });
+ * ```
+ */
+export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Attributes): Promise<T>;
+/**
+ * Synchronous version of withSpan
+ */
+export declare function withSpanSync<T>(name: string, fn: (span: Span) => T, attributes?: Attributes): T;
+/**
+ * Get the current trace ID (useful for log correlation)
+ */
+export declare function getTraceId(): string | undefined;
+/**
+ * Get the current span ID
+ */
+export declare function getSpanId(): string | undefined;
+/**
+ * Record an exception on the current span
+ */
+export declare function recordException(error: Error): void;
+/**
+ * Add an event to the current span
+ */
+export declare function addSpanEvent(name: string, attributes?: Attributes): void;
+//#endregion
+//# sourceMappingURL=tracing.d.mts.map

package/dist/instrumentation/tracing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.mts","names":[],"sources":["../../src/instrumentation/tracing.ts"],"mappings":";;;;;wBAWgB,iBAAiB;;;;wBAOjB,kBAAkB,YAAY;;;;wBAU9B,WAAW,cAAc,aAAa,aAAa;;;;;;;;;;;;;wBAkB7C,SAAS,GAC9B,cACA,KAAK,MAAM,SAAS,QAAQ,IAC5B,aAAa,aACX,QAAQ;;;;wBA4BK,aAAa,GAC5B,cACA,KAAK,MAAM,SAAS,GACpB,aAAa,aACX;;;;wBA2Ba;;;;wBAQA;;;;wBAQA,gBAAgB,OAAO;;;;wBAcvB,aAAa,cAAc,aAAa"}

package/dist/instrumentation/tracing.mjs

@@ -1,3 +1,106 @@
-import { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync } from "../tracing-Cijm_5NI.mjs";
+import { SpanStatusCode, context, trace } from "@opentelemetry/api";
+//#region src/instrumentation/tracing.ts
+/**
+* Get the currently active span
+*/
+function getActiveSpan() {
+	return trace.getActiveSpan();
+}
+/**
+* Set attributes on the active span
+*/
+function setSpanAttributes(attributes) {
+	const span = getActiveSpan();
+	if (span) span.setAttributes(attributes);
+}
+/**
+* Create a new span as a child of the current span
+*/
+function createSpan(name, attributes) {
+	return trace.getTracer("@geekmidas/telescope").startSpan(name, { attributes });
+}
+/**
+* Execute a function within a new span context
+*
+* @example
+* ```typescript
+* const result = await withSpan('processOrder', async (span) => {
+*   span.setAttribute('order.id', orderId);
+*   const order = await processOrder(orderId);
+*   return order;
+* });
+* ```
+*/
+async function withSpan(name, fn, attributes) {
+	const span = trace.getTracer("@geekmidas/telescope").startSpan(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();
+	}
+}
+/**
+* Synchronous version of withSpan
+*/
+function withSpanSync(name, fn, attributes) {
+	const span = trace.getTracer("@geekmidas/telescope").startSpan(name, { attributes });
+	try {
+		const result = 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();
+	}
+}
+/**
+* Get the current trace ID (useful for log correlation)
+*/
+function getTraceId() {
+	return getActiveSpan()?.spanContext().traceId;
+}
+/**
+* Get the current span ID
+*/
+function getSpanId() {
+	return getActiveSpan()?.spanContext().spanId;
+}
+/**
+* Record an exception on the current span
+*/
+function recordException(error) {
+	const span = getActiveSpan();
+	if (span) {
+		span.recordException(error);
+		span.setStatus({
+			code: SpanStatusCode.ERROR,
+			message: error.message
+		});
+	}
+}
+/**
+* Add an event to the current span
+*/
+function addSpanEvent(name, attributes) {
+	const span = getActiveSpan();
+	if (span) span.addEvent(name, attributes);
+}
+//#endregion
+export { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync };
 
-export { addSpanEvent, createSpan, getActiveSpan, getSpanId, getTraceId, recordException, setSpanAttributes, withSpan, withSpanSync };
+//# sourceMappingURL=tracing.mjs.map