@ms-cloudpack/telemetry 0.10.19 → 0.11.0

package/lib/FilteredBatchSpanProcessor.d.ts

@@ -0,0 +1,12 @@
+import { BatchSpanProcessor, type SpanExporter, type ReadableSpan } from '@opentelemetry/sdk-trace-base';
+/**
+ * FilteredBatchSpanProcessor is a custom span processor that filters spans
+ * based on a provided filter function before passing them to the exporter.
+ * This allows for more granular control over which spans are exported.
+ */
+export declare class FilteredBatchSpanProcessor extends BatchSpanProcessor {
+    private readonly filterFn;
+    constructor(exporter: SpanExporter, filterFn: (span: ReadableSpan) => boolean);
+    onEnd(span: ReadableSpan): void;
+}
+//# sourceMappingURL=FilteredBatchSpanProcessor.d.ts.map

package/lib/SpanEnrichingProcessor.d.ts

@@ -5,7 +5,8 @@ import type { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base'
  */
 export declare class SpanEnrichingProcessor implements SpanProcessor {
     private sharedSpanAttributes;
-    constructor(sharedSpanAttributes: Attributes);
+    private readonly filter?;
+    constructor(sharedSpanAttributes: Attributes, filter?: ((span: ReadableSpan) => boolean) | undefined);
     forceFlush(): Promise<void>;
     shutdown(): Promise<void>;
     onStart(): void;

package/lib/index.d.ts

@@ -1,9 +1,10 @@
 export type { Span } from '@opentelemetry/api';
-export { SpanStatusCode } from '@opentelemetry/api';
-export { createTelemetryClient } from './createTelemetryClient.js';
+export type { TelemetryApi } from './types/TelemetryApi.js';
 export type { LogLevel } from './types/LogLevel.js';
 export type { TelemetryClient } from './types/TelemetryClient.js';
 export type { TelemetryOptions } from './types/TelemetryOptions.js';
-export { createNoOpTelemetryClient } from './createNoOpTelemetryClient.js';
 export type { AsyncTracer } from './proxies/createProxiedTracer.js';
+export { SpanStatusCode } from '@opentelemetry/api';
+export { startTelemetry } from './startTelemetry.js';
+export { createNoOpTelemetryClient } from './createNoOpTelemetryClient.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/proxies/createImprovedStartActiveSpan.d.ts

@@ -1,6 +1,6 @@
-import type { Tracer, Span, SpanOptions, Context } from '@opentelemetry/api';
+import { type Tracer, type Span, type SpanOptions, type Context } from '@opentelemetry/api';
 export type SpanFunction<T> = (span: Span) => T | Promise<T>;
 type StartActiveSpanFn = <T>(name: string, optionsOrFn?: SpanOptions | SpanFunction<T>, contextOrFn?: Context | SpanFunction<T>, maybeFn?: SpanFunction<T>) => T;
-export declare function createImprovedStartActiveSpan(target: Tracer): <T>(name: string, optionsOrFn?: SpanOptions | SpanFunction<unknown> | undefined, contextOrFn?: Context | SpanFunction<unknown> | undefined, maybeFn?: SpanFunction<unknown> | undefined) => Promise<T>;
+export declare function createImprovedStartActiveSpan(target: Tracer, getRootContext?: () => Context): <T>(name: string, optionsOrFn?: SpanOptions | SpanFunction<unknown> | undefined, contextOrFn?: Context | SpanFunction<unknown> | undefined, maybeFn?: SpanFunction<unknown> | undefined) => Promise<T>;
 export {};
 //# sourceMappingURL=createImprovedStartActiveSpan.d.ts.map

package/lib/proxies/createProxiedTracer.d.ts

@@ -11,5 +11,5 @@ export type AsyncTracer = Omit<Tracer, 'startActiveSpan'> & {
  * @param tracer - The tracer to proxy
  * @returns - Proxied tracer
  */
-export declare function createProxiedTracer(tracer: Tracer): AsyncTracer;
+export declare function createProxiedTracer(tracer: Tracer, getRootContext?: () => Context): AsyncTracer;
 //# sourceMappingURL=createProxiedTracer.d.ts.map

package/lib/startTelemetry.d.ts

@@ -0,0 +1,8 @@
+import type { TelemetryOptions } from './types/TelemetryOptions.js';
+import type { TelemetryApi } from './types/TelemetryApi.js';
+/**
+ * Initialize the telemetry infrastructure.
+ * This function sets up the OpenTelemetry, configures the tracer provider.
+ */
+export declare function startTelemetry(options: TelemetryOptions): TelemetryApi;
+//# sourceMappingURL=startTelemetry.d.ts.map

package/lib/types/TelemetryApi.d.ts

@@ -0,0 +1,13 @@
+import type { TelemetryClient } from './TelemetryClient.js';
+export interface TelemetryApi {
+    /**
+     * Flushes all telemetry and shuts down the telemetry client.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Creates a telemetry client with the given connection string.
+     * @param connectionString - The connection string for the telemetry client.
+     */
+    createClient(connectionString?: string): Promise<TelemetryClient>;
+}
+//# sourceMappingURL=TelemetryApi.d.ts.map

package/lib/types/TelemetryClient.d.ts

@@ -1,23 +1,9 @@
-import type { Context, ContextAPI } from '@opentelemetry/api';
 import type { AsyncTracer } from '../proxies/createProxiedTracer.js';
 export interface TelemetryClient {
-    /**
-     * Flushes all telemetry and shuts down the telemetry client.
-     */
-    shutdown(): Promise<void>;
     /**
      * Gets the OpenTelemetry tracer.
      * @returns the OpenTelemetry tracer
      */
     get tracer(): AsyncTracer;
-    /**
-     * Gets the OpenTelemetry context.
-     */
-    get context(): ContextAPI;
-    /**
-     * Sets the root context.
-     * @param context - the root context for the telemetry client
-     */
-    setRootContext(context: Context | undefined): void;
 }
 //# sourceMappingURL=TelemetryClient.d.ts.map

package/lib/types/TelemetryOptions.d.ts

@@ -1,9 +1,5 @@
 import type { LogLevel } from './LogLevel.js';
 export interface TelemetryOptions {
-    /**
-     * The connection string for the Application Insights.
-     */
-    connectionString?: string;
     /**
      * The log level for the telemetry client.
      */
@@ -12,11 +8,6 @@ export interface TelemetryOptions {
      * The version of the product. This will be added as a shared attribute to all spans.
      */
     productVersion: string;
-    /**
-     * A string value having a meaning that helps to distinguish a group of services, for example the team name that owns a group of services.
-     * Possible values: cloudpack, cloudpack.services, etc.
-     */
-    serviceNamespace: string;
     /**
      * Logic name of the service
      * Possible values: cli, bundler-service, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/telemetry",
-  "version": "0.10.19",
+  "version": "0.11.0",
   "description": "Helpers for reporting telemetry in Cloudpack.",
   "license": "MIT",
   "type": "module",