@superblocksteam/telemetry 2.0.83-next.1

package/dist/testing/in-memory-exporter.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * In-Memory Exporters for Testing
+ *
+ * These exporters capture telemetry data in memory for assertion in tests.
+ * No external connections are made.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryLogExporter = exports.InMemoryMetricExporter = exports.InMemorySpanExporter = void 0;
+const core_1 = require("@opentelemetry/core");
+/**
+ * In-memory span exporter for testing.
+ * Captures all exported spans for assertion.
+ */
+class InMemorySpanExporter {
+    spans = [];
+    stopped = false;
+    /**
+     * Export spans to in-memory storage.
+     */
+    export(spans, resultCallback) {
+        if (this.stopped) {
+            resultCallback({ code: core_1.ExportResultCode.FAILED });
+            return;
+        }
+        this.spans.push(...spans);
+        resultCallback({ code: core_1.ExportResultCode.SUCCESS });
+    }
+    /**
+     * Shutdown the exporter.
+     */
+    shutdown() {
+        this.stopped = true;
+        return Promise.resolve();
+    }
+    /**
+     * Force flush (no-op for in-memory).
+     */
+    forceFlush() {
+        return Promise.resolve();
+    }
+    /**
+     * Get all captured spans.
+     */
+    getSpans() {
+        return [...this.spans];
+    }
+    /**
+     * Get the number of captured spans.
+     */
+    getSpanCount() {
+        return this.spans.length;
+    }
+    /**
+     * Clear captured spans.
+     */
+    reset() {
+        this.spans = [];
+    }
+    /**
+     * Find spans by name.
+     *
+     * @param name - Span name to search for
+     * @returns Matching spans
+     */
+    findSpansByName(name) {
+        return this.spans.filter((s) => s.name === name);
+    }
+    /**
+     * Find spans by name pattern (regex).
+     *
+     * @param pattern - Regex pattern to match span names
+     * @returns Matching spans
+     */
+    findSpansByPattern(pattern) {
+        return this.spans.filter((s) => pattern.test(s.name));
+    }
+    /**
+     * Find spans with a specific attribute value.
+     *
+     * @param key - Attribute key
+     * @param value - Attribute value (or regex for pattern matching)
+     * @returns Matching spans
+     */
+    findSpansByAttribute(key, value) {
+        return this.spans.filter((s) => {
+            const attr = s.attributes[key];
+            if (attr === undefined)
+                return false;
+            if (value instanceof RegExp) {
+                return value.test(String(attr));
+            }
+            return attr === value;
+        });
+    }
+    /**
+     * Assert no spans have a specific attribute value.
+     * Useful for ensuring Tier 1 data doesn't leak.
+     *
+     * @param key - Attribute key
+     * @param value - Forbidden attribute value (or regex pattern)
+     * @throws Error if forbidden attribute is found
+     */
+    assertNoAttribute(key, value) {
+        for (const span of this.spans) {
+            const attr = span.attributes[key];
+            if (attr === undefined)
+                continue;
+            const matches = value instanceof RegExp ? value.test(String(attr)) : attr === value;
+            if (matches) {
+                throw new Error(`Found forbidden attribute ${key}=${String(attr)} on span "${span.name}"`);
+            }
+        }
+    }
+    /**
+     * Assert all spans have a required attribute.
+     *
+     * @param key - Attribute key
+     * @throws Error if any span is missing the attribute
+     */
+    assertAllHaveAttribute(key) {
+        for (const span of this.spans) {
+            if (span.attributes[key] === undefined) {
+                throw new Error(`Span "${span.name}" is missing required attribute "${key}"`);
+            }
+        }
+    }
+    /**
+     * Get span names for debugging.
+     */
+    getSpanNames() {
+        return this.spans.map((s) => s.name);
+    }
+}
+exports.InMemorySpanExporter = InMemorySpanExporter;
+/**
+ * In-memory metric exporter for testing.
+ */
+class InMemoryMetricExporter {
+    metrics = [];
+    /**
+     * Export metrics to in-memory storage.
+     */
+    export(metrics) {
+        this.metrics.push(...metrics);
+    }
+    /**
+     * Get all captured metrics.
+     */
+    getMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Find metrics by name.
+     *
+     * @param name - Metric name
+     * @returns Matching metrics
+     */
+    findMetricsByName(name) {
+        return this.metrics.filter((m) => m.name === name);
+    }
+    /**
+     * Clear captured metrics.
+     */
+    reset() {
+        this.metrics = [];
+    }
+    /**
+     * Assert no metrics have a specific label value.
+     *
+     * @param labelKey - Label key
+     * @param value - Forbidden value
+     * @throws Error if forbidden label is found
+     */
+    assertNoLabel(labelKey, value) {
+        for (const metric of this.metrics) {
+            for (const dp of metric.dataPoints) {
+                const label = dp.attributes[labelKey];
+                if (label === undefined)
+                    continue;
+                const matches = value instanceof RegExp ? value.test(String(label)) : label === value;
+                if (matches) {
+                    throw new Error(`Found forbidden label ${labelKey}=${String(label)} on metric "${metric.name}"`);
+                }
+            }
+        }
+    }
+}
+exports.InMemoryMetricExporter = InMemoryMetricExporter;
+/**
+ * In-memory log exporter for testing.
+ */
+class InMemoryLogExporter {
+    logs = [];
+    /**
+     * Export logs to in-memory storage.
+     */
+    export(logs) {
+        this.logs.push(...logs);
+    }
+    /**
+     * Get all captured logs.
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Find logs by severity.
+     *
+     * @param severityNumber - Severity level (e.g., 9 for INFO, 13 for WARN, 17 for ERROR)
+     * @returns Matching logs
+     */
+    findLogsBySeverity(severityNumber) {
+        return this.logs.filter((l) => l.severityNumber === severityNumber);
+    }
+    /**
+     * Find logs containing text.
+     *
+     * @param text - Text to search for in log body
+     * @returns Matching logs
+     */
+    findLogsContaining(text) {
+        return this.logs.filter((l) => {
+            if (l.body === undefined)
+                return false;
+            const bodyStr = String(l.body);
+            return text instanceof RegExp ? text.test(bodyStr) : bodyStr.includes(text);
+        });
+    }
+    /**
+     * Clear captured logs.
+     */
+    reset() {
+        this.logs = [];
+    }
+    /**
+     * Assert no logs contain sensitive data.
+     *
+     * @param pattern - Pattern to check for (forbidden content)
+     * @throws Error if forbidden content is found
+     */
+    assertNoLogContains(pattern) {
+        for (const log of this.logs) {
+            if (log.body === undefined)
+                continue;
+            const bodyStr = String(log.body);
+            if (pattern.test(bodyStr)) {
+                throw new Error(`Found forbidden content in log: ${bodyStr.slice(0, 100)}...`);
+            }
+        }
+    }
+}
+exports.InMemoryLogExporter = InMemoryLogExporter;
+//# sourceMappingURL=in-memory-exporter.js.map

package/dist/testing/in-memory-exporter.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Testing Utilities
+ *
+ * In-memory exporters and test helpers for telemetry assertions.
+ */
+export { InMemorySpanExporter, InMemoryMetricExporter, InMemoryLogExporter, type CapturedMetric, type CapturedLogRecord, } from './in-memory-exporter.js';
+export { initTestTelemetry, getTestTelemetryInstance, resetTestTelemetry, getTestTracer, withTestSpan, type TestTelemetryInstance, } from './test-init.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Testing Utilities
+ *
+ * In-memory exporters and test helpers for telemetry assertions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTestSpan = exports.getTestTracer = exports.resetTestTelemetry = exports.getTestTelemetryInstance = exports.initTestTelemetry = exports.InMemoryLogExporter = exports.InMemoryMetricExporter = exports.InMemorySpanExporter = void 0;
+var in_memory_exporter_js_1 = require("./in-memory-exporter.js");
+Object.defineProperty(exports, "InMemorySpanExporter", { enumerable: true, get: function () { return in_memory_exporter_js_1.InMemorySpanExporter; } });
+Object.defineProperty(exports, "InMemoryMetricExporter", { enumerable: true, get: function () { return in_memory_exporter_js_1.InMemoryMetricExporter; } });
+Object.defineProperty(exports, "InMemoryLogExporter", { enumerable: true, get: function () { return in_memory_exporter_js_1.InMemoryLogExporter; } });
+var test_init_js_1 = require("./test-init.js");
+Object.defineProperty(exports, "initTestTelemetry", { enumerable: true, get: function () { return test_init_js_1.initTestTelemetry; } });
+Object.defineProperty(exports, "getTestTelemetryInstance", { enumerable: true, get: function () { return test_init_js_1.getTestTelemetryInstance; } });
+Object.defineProperty(exports, "resetTestTelemetry", { enumerable: true, get: function () { return test_init_js_1.resetTestTelemetry; } });
+Object.defineProperty(exports, "getTestTracer", { enumerable: true, get: function () { return test_init_js_1.getTestTracer; } });
+Object.defineProperty(exports, "withTestSpan", { enumerable: true, get: function () { return test_init_js_1.withTestSpan; } });
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iEAMiC;AAL/B,6HAAA,oBAAoB,OAAA;AACpB,+HAAA,sBAAsB,OAAA;AACtB,4HAAA,mBAAmB,OAAA;AAKrB,+CAOwB;AANtB,iHAAA,iBAAiB,OAAA;AACjB,wHAAA,wBAAwB,OAAA;AACxB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AACb,4GAAA,YAAY,OAAA"}

package/dist/testing/test-init.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Test Telemetry Initialization
+ *
+ * Initialize telemetry for testing with in-memory exporters.
+ * No external connections are made.
+ */
+import { trace } from "@opentelemetry/api";
+import { InMemorySpanExporter, InMemoryMetricExporter, InMemoryLogExporter } from "./in-memory-exporter.js";
+import { TelemetryPolicyEvaluator } from "../common/policy-evaluator.js";
+import type { BaseTelemetryConfig } from "../types/index.js";
+/**
+ * Test telemetry instance with in-memory exporters.
+ */
+export interface TestTelemetryInstance {
+    /** In-memory span exporter */
+    spanExporter: InMemorySpanExporter;
+    /** In-memory metric exporter */
+    metricExporter: InMemoryMetricExporter;
+    /** In-memory log exporter */
+    logExporter: InMemoryLogExporter;
+    /** Policy evaluator */
+    policyEvaluator: TelemetryPolicyEvaluator;
+    /** Reset all exporters (call in beforeEach) */
+    reset: () => void;
+    /** Shutdown (call in afterAll) */
+    shutdown: () => Promise<void>;
+}
+/**
+ * Initialize telemetry for testing.
+ *
+ * Uses in-memory exporters, no external connections.
+ * Call once per test file, use reset() in beforeEach.
+ *
+ * @param config - Optional test configuration
+ * @returns Test telemetry instance
+ *
+ * @example
+ * ```typescript
+ * import { initTestTelemetry } from '@superblocksteam/telemetry/testing';
+ *
+ * describe('MyService', () => {
+ *   const { spanExporter, reset } = initTestTelemetry();
+ *
+ *   beforeEach(() => reset());
+ *
+ *   it('creates expected spans', async () => {
+ *     // ... test code ...
+ *     expect(spanExporter.getSpans()).toHaveLength(1);
+ *   });
+ * });
+ * ```
+ */
+export declare function initTestTelemetry(config?: Partial<BaseTelemetryConfig>): TestTelemetryInstance;
+/**
+ * Get the test telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+export declare function getTestTelemetryInstance(): TestTelemetryInstance;
+/**
+ * Reset the test telemetry (for cleanup between test files).
+ */
+export declare function resetTestTelemetry(): Promise<void>;
+/**
+ * Get a tracer for tests.
+ *
+ * @param name - Tracer name
+ * @returns Tracer instance
+ */
+export declare function getTestTracer(name?: string): ReturnType<typeof trace.getTracer>;
+/**
+ * Run a function within a test span.
+ * Useful for testing span creation.
+ *
+ * @param name - Span name
+ * @param fn - Function to run
+ * @returns Function result
+ */
+export declare function withTestSpan<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+//# sourceMappingURL=test-init.d.ts.map

package/dist/testing/test-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-init.d.ts","sourceRoot":"","sources":["../../src/testing/test-init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,YAAY,EAAE,oBAAoB,CAAC;IACnC,gCAAgC;IAChC,cAAc,EAAE,sBAAsB,CAAC;IACvC,6BAA6B;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,uBAAuB;IACvB,eAAe,EAAE,wBAAwB,CAAC;IAC1C,+CAA+C;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAeD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,qBAAqB,CA2CvB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAOhE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,SAAS,GACZ,UAAU,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,CAEpC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CASZ"}

package/dist/testing/test-init.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Test Telemetry Initialization
+ *
+ * Initialize telemetry for testing with in-memory exporters.
+ * No external connections are made.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initTestTelemetry = initTestTelemetry;
+exports.getTestTelemetryInstance = getTestTelemetryInstance;
+exports.resetTestTelemetry = resetTestTelemetry;
+exports.getTestTracer = getTestTracer;
+exports.withTestSpan = withTestSpan;
+const api_1 = require("@opentelemetry/api");
+const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const context_async_hooks_1 = require("@opentelemetry/context-async-hooks");
+const core_1 = require("@opentelemetry/core");
+const in_memory_exporter_js_1 = require("./in-memory-exporter.js");
+const resource_js_1 = require("../common/resource.js");
+const policy_evaluator_js_1 = require("../common/policy-evaluator.js");
+const policy_js_1 = require("../types/policy.js");
+// Singleton for tests
+let testInstance;
+let tracerProvider;
+/**
+ * Default test configuration.
+ */
+const DEFAULT_TEST_CONFIG = {
+    serviceName: "test-service",
+    serviceVersion: "0.0.0-test",
+    environment: "test",
+};
+/**
+ * Initialize telemetry for testing.
+ *
+ * Uses in-memory exporters, no external connections.
+ * Call once per test file, use reset() in beforeEach.
+ *
+ * @param config - Optional test configuration
+ * @returns Test telemetry instance
+ *
+ * @example
+ * ```typescript
+ * import { initTestTelemetry } from '@superblocksteam/telemetry/testing';
+ *
+ * describe('MyService', () => {
+ *   const { spanExporter, reset } = initTestTelemetry();
+ *
+ *   beforeEach(() => reset());
+ *
+ *   it('creates expected spans', async () => {
+ *     // ... test code ...
+ *     expect(spanExporter.getSpans()).toHaveLength(1);
+ *   });
+ * });
+ * ```
+ */
+function initTestTelemetry(config) {
+    if (testInstance) {
+        return testInstance;
+    }
+    const mergedConfig = { ...DEFAULT_TEST_CONFIG, ...config };
+    const resource = (0, resource_js_1.buildResource)(mergedConfig);
+    const spanExporter = new in_memory_exporter_js_1.InMemorySpanExporter();
+    const metricExporter = new in_memory_exporter_js_1.InMemoryMetricExporter();
+    const logExporter = new in_memory_exporter_js_1.InMemoryLogExporter();
+    const policyEvaluator = new policy_evaluator_js_1.TelemetryPolicyEvaluator(policy_js_1.CLOUD_DEFAULT_POLICY);
+    // Create provider with span processors in constructor (OTEL v2.x API)
+    tracerProvider = new sdk_trace_node_1.NodeTracerProvider({
+        resource,
+        spanProcessors: [new sdk_trace_base_1.SimpleSpanProcessor(spanExporter)],
+    });
+    // Register the provider
+    tracerProvider.register({
+        propagator: new core_1.W3CTraceContextPropagator(),
+        contextManager: new context_async_hooks_1.AsyncLocalStorageContextManager(),
+    });
+    testInstance = {
+        spanExporter,
+        metricExporter,
+        logExporter,
+        policyEvaluator,
+        reset: () => {
+            spanExporter.reset();
+            metricExporter.reset();
+            logExporter.reset();
+        },
+        shutdown: async () => {
+            await tracerProvider?.shutdown();
+            testInstance = undefined;
+            tracerProvider = undefined;
+        },
+    };
+    return testInstance;
+}
+/**
+ * Get the test telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+function getTestTelemetryInstance() {
+    if (!testInstance) {
+        throw new Error("[TestTelemetry] Not initialized. Call initTestTelemetry() first.");
+    }
+    return testInstance;
+}
+/**
+ * Reset the test telemetry (for cleanup between test files).
+ */
+async function resetTestTelemetry() {
+    if (testInstance) {
+        await testInstance.shutdown();
+    }
+}
+/**
+ * Get a tracer for tests.
+ *
+ * @param name - Tracer name
+ * @returns Tracer instance
+ */
+function getTestTracer(name = "test") {
+    return api_1.trace.getTracer(name);
+}
+/**
+ * Run a function within a test span.
+ * Useful for testing span creation.
+ *
+ * @param name - Span name
+ * @param fn - Function to run
+ * @returns Function result
+ */
+async function withTestSpan(name, fn) {
+    const tracer = getTestTracer();
+    return tracer.startActiveSpan(name, async (span) => {
+        try {
+            return await fn();
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+//# sourceMappingURL=test-init.js.map

package/dist/testing/test-init.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Telemetry Types
+ *
+ * Re-exports policy types and config interfaces.
+ */
+export * from './policy.js';
+/**
+ * Base configuration for telemetry initialization.
+ */
+export interface BaseTelemetryConfig {
+    /** Service name (e.g., 'superblocks-server') */
+    serviceName: string;
+    /** Service version (e.g., '1.0.0') */
+    serviceVersion: string;
+    /** Deployment environment (e.g., 'production', 'staging', 'development') */
+    environment: string;
+    /** Additional resource attributes */
+    resourceAttributes?: Record<string, string>;
+}
+/**
+ * Node.js specific telemetry configuration.
+ */
+export interface NodeTelemetryConfig extends BaseTelemetryConfig {
+    /** OTLP collector URL (e.g., http://localhost:4318) */
+    otlpUrl?: string;
+    /** OpenTelemetry instrumentations to enable */
+    instrumentations?: unknown[];
+    /** Whether to enable metrics collection */
+    metricsEnabled?: boolean;
+    /** Whether to enable log collection */
+    logsEnabled?: boolean;
+}
+/**
+ * Browser specific telemetry configuration.
+ */
+export interface BrowserTelemetryConfig extends BaseTelemetryConfig {
+    /** OTLP traces endpoint URL */
+    otlpUrl: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAE7B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Telemetry Types
+ *
+ * Re-exports policy types and config interfaces.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./policy.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,8CAA4B"}