@respan/tracing 1.0.45

package/dist/main.d.ts

@@ -0,0 +1,162 @@
+import { WithFunctionType } from "./types/decoratorTypes.js";
+import { RespanOptions, ProcessorConfig } from "./types/clientTypes.js";
+import { withRespanSpanAttributes } from "./contexts/span.js";
+/**
+ * Respan client for trace management and instrumentation.
+ * This class provides an interface for initializing and managing OpenTelemetry-based tracing
+ * for various AI/ML services and frameworks.
+ *
+ * ## Instrumentation Management
+ *
+ * ### Automatic Discovery (Default)
+ * By default, Respan will attempt to load all available instrumentations automatically:
+ * ```typescript
+ * const respan = new RespanTelemetry({
+ *   apiKey: 'your-api-key',
+ *   logLevel: 'info' // Shows what gets loaded successfully
+ * });
+ * ```
+ *
+ * ### Manual Instrumentation (Next.js/Webpack environments)
+ * For environments where dynamic imports don't work properly:
+ * ```typescript
+ * import OpenAI from 'openai';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const respan = new RespanTelemetry({
+ *   apiKey: 'your-api-key',
+ *   instrumentModules: {
+ *     openAI: OpenAI,
+ *     anthropic: Anthropic
+ *   }
+ * });
+ * ```
+ *
+ * ### Disable Specific Instrumentations
+ * Block instrumentations you don't want to use:
+ * ```typescript
+ * const respan = new RespanTelemetry({
+ *   apiKey: 'your-api-key',
+ *   disabledInstrumentations: ['bedrock', 'chromaDB', 'qdrant']
+ * });
+ * ```
+ *
+ * ### Available Instrumentations (consistent camelCase naming)
+ * - `openAI` - OpenAI API instrumentation
+ * - `anthropic` - Anthropic API instrumentation
+ * - `azureOpenAI` - Azure OpenAI instrumentation
+ * - `cohere` - Cohere API instrumentation
+ * - `bedrock` - AWS Bedrock instrumentation
+ * - `googleVertexAI` - Google Vertex AI instrumentation
+ * - `googleAIPlatform` - Google AI Platform instrumentation
+ * - `pinecone` - Pinecone vector database instrumentation
+ * - `together` - Together AI instrumentation
+ * - `langChain` - LangChain framework instrumentation
+ * - `llamaIndex` - LlamaIndex framework instrumentation
+ * - `chromaDB` - ChromaDB vector database instrumentation
+ * - `qdrant` - Qdrant vector database instrumentation
+ *
+ * ### Debugging Instrumentation Loading
+ * Set `logLevel: 'info'` or `logLevel: 'debug'` to see:
+ * - Which instrumentations loaded successfully
+ * - Which ones failed and installation instructions
+ * - Which ones were disabled by configuration
+ */
+export declare class RespanTelemetry {
+    private options;
+    private initialized;
+    private initializing;
+    constructor(options: RespanOptions);
+    private _initialize;
+    /**
+     * Manually initialize tracing. This is useful if you want to ensure
+     * tracing is fully initialized before proceeding.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if tracing has been initialized
+     */
+    isInitialized(): boolean;
+    withTask: WithFunctionType;
+    withWorkflow: WithFunctionType;
+    withAgent: WithFunctionType;
+    withTool: WithFunctionType;
+    withRespanSpanAttributes: typeof withRespanSpanAttributes;
+    /**
+     * Enable instrumentation for a specific provider
+     * @param name - The name of the instrumentation (e.g., 'openai', 'anthropic')
+     */
+    enableInstrumentation(name: string): Promise<void>;
+    /**
+     * Enable multiple instrumentations
+     * @param names - Array of instrumentation names
+     */
+    enableInstrumentations(names: string[]): Promise<void>;
+    /**
+     * Flush and shutdown tracing
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Add a processor for routing spans to different destinations.
+     *
+     * Note: A default processor is automatically configured to send spans to Respan.
+     * You only need to call this method if you want to route spans to additional destinations.
+     *
+     * @param config - Processor configuration
+     *
+     * @example
+     * ```typescript
+     * // Add debug processor (in addition to default Respan processor)
+     * respan.addProcessor({
+     *   exporter: new FileExporter("./debug.json"),
+     *   name: "debug"
+     * });
+     *
+     * // Route specific spans to debug processor
+     * await respan.withTask(
+     *   { name: "my_task", processors: "debug" },
+     *   async () => { ... }
+     * );
+     *
+     * // Spans without processors attribute go to default Respan processor
+     * await respan.withTask(
+     *   { name: "normal_task" },
+     *   async () => { ... }  // <- Goes to default processor
+     * );
+     * ```
+     */
+    addProcessor(config: ProcessorConfig): void;
+    /**
+     * Get the client API for span management.
+     * Provides methods to update spans, add events, record exceptions, etc.
+     *
+     * @returns The Respan client instance
+     *
+     * @example
+     * ```typescript
+     * const client = respan.getClient();
+     * const traceId = client.getCurrentTraceId();
+     * client.updateCurrentSpan({
+     *   respanParams: {
+     *     customerIdentifier: "user-123"
+     *   }
+     * });
+     * ```
+     */
+    getClient(): import("./utils/client.js").RespanClient;
+    /**
+     * Get the span buffer manager for manual span control.
+     *
+     * @returns The span buffer manager
+     *
+     * @example
+     * ```typescript
+     * const manager = respan.getSpanBufferManager();
+     * const buffer = manager.createBuffer("trace-123");
+     * buffer.createSpan("step1", { status: "completed" });
+     * const spans = buffer.getAllSpans();
+     * await manager.processSpans(spans);
+     * ```
+     */
+    getSpanBufferManager(): import("./utils/spanBuffer.js").SpanBufferManager;
+}

package/dist/main.js

@@ -0,0 +1,212 @@
+import { withTask, withWorkflow, withAgent, withTool } from "./decorators/index.js";
+import { withRespanSpanAttributes } from "./contexts/span.js";
+import { startTracing, forceFlush, addProcessorToSDK } from "./utils/tracing.js";
+import { enableInstrumentation } from "./instrumentation/index.js";
+import { getClient as getClientAPI } from "./utils/client.js";
+import { getSpanBufferManager } from "./utils/spanBuffer.js";
+/**
+ * Respan client for trace management and instrumentation.
+ * This class provides an interface for initializing and managing OpenTelemetry-based tracing
+ * for various AI/ML services and frameworks.
+ *
+ * ## Instrumentation Management
+ *
+ * ### Automatic Discovery (Default)
+ * By default, Respan will attempt to load all available instrumentations automatically:
+ * ```typescript
+ * const respan = new RespanTelemetry({
+ *   apiKey: 'your-api-key',
+ *   logLevel: 'info' // Shows what gets loaded successfully
+ * });
+ * ```
+ *
+ * ### Manual Instrumentation (Next.js/Webpack environments)
+ * For environments where dynamic imports don't work properly:
+ * ```typescript
+ * import OpenAI from 'openai';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const respan = new RespanTelemetry({
+ *   apiKey: 'your-api-key',
+ *   instrumentModules: {
+ *     openAI: OpenAI,
+ *     anthropic: Anthropic
+ *   }
+ * });
+ * ```
+ *
+ * ### Disable Specific Instrumentations
+ * Block instrumentations you don't want to use:
+ * ```typescript
+ * const respan = new RespanTelemetry({
+ *   apiKey: 'your-api-key',
+ *   disabledInstrumentations: ['bedrock', 'chromaDB', 'qdrant']
+ * });
+ * ```
+ *
+ * ### Available Instrumentations (consistent camelCase naming)
+ * - `openAI` - OpenAI API instrumentation
+ * - `anthropic` - Anthropic API instrumentation
+ * - `azureOpenAI` - Azure OpenAI instrumentation
+ * - `cohere` - Cohere API instrumentation
+ * - `bedrock` - AWS Bedrock instrumentation
+ * - `googleVertexAI` - Google Vertex AI instrumentation
+ * - `googleAIPlatform` - Google AI Platform instrumentation
+ * - `pinecone` - Pinecone vector database instrumentation
+ * - `together` - Together AI instrumentation
+ * - `langChain` - LangChain framework instrumentation
+ * - `llamaIndex` - LlamaIndex framework instrumentation
+ * - `chromaDB` - ChromaDB vector database instrumentation
+ * - `qdrant` - Qdrant vector database instrumentation
+ *
+ * ### Debugging Instrumentation Loading
+ * Set `logLevel: 'info'` or `logLevel: 'debug'` to see:
+ * - Which instrumentations loaded successfully
+ * - Which ones failed and installation instructions
+ * - Which ones were disabled by configuration
+ */
+export class RespanTelemetry {
+    options;
+    initialized = false;
+    initializing = false;
+    constructor(options) {
+        this.options = {
+            appName: options.appName || process.env.RESPAN_APP_NAME || "default",
+            disableBatch: options.disableBatch || false,
+            baseURL: options.baseURL || process.env.RESPAN_BASE_URL || "https://api.respan.co",
+            apiKey: options.apiKey || process.env.RESPAN_API_KEY || "",
+            instrumentModules: options.instrumentModules || {},
+            disabledInstrumentations: options.disabledInstrumentations || [],
+            tracingEnabled: options.tracingEnabled !== false,
+            traceContent: options.traceContent !== false,
+            logLevel: options.logLevel || "error",
+            silenceInitializationMessage: options.silenceInitializationMessage || false,
+        };
+        // Don't auto-initialize - let user call initialize() explicitly
+        // This prevents timing issues and double initialization
+    }
+    async _initialize() {
+        if (this.initialized || this.initializing) {
+            return;
+        }
+        this.initializing = true;
+        try {
+            await startTracing(this.options);
+            this.initialized = true;
+        }
+        catch (error) {
+            console.error("Failed to initialize Respan tracing:", error);
+        }
+        finally {
+            this.initializing = false;
+        }
+    }
+    /**
+     * Manually initialize tracing. This is useful if you want to ensure
+     * tracing is fully initialized before proceeding.
+     */
+    async initialize() {
+        await this._initialize();
+    }
+    /**
+     * Check if tracing has been initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    withTask = withTask;
+    withWorkflow = withWorkflow;
+    withAgent = withAgent;
+    withTool = withTool;
+    withRespanSpanAttributes = withRespanSpanAttributes;
+    /**
+     * Enable instrumentation for a specific provider
+     * @param name - The name of the instrumentation (e.g., 'openai', 'anthropic')
+     */
+    async enableInstrumentation(name) {
+        await enableInstrumentation(name);
+    }
+    /**
+     * Enable multiple instrumentations
+     * @param names - Array of instrumentation names
+     */
+    async enableInstrumentations(names) {
+        await Promise.all(names.map(name => enableInstrumentation(name)));
+    }
+    /**
+     * Flush and shutdown tracing
+     */
+    async shutdown() {
+        await forceFlush();
+    }
+    /**
+     * Add a processor for routing spans to different destinations.
+     *
+     * Note: A default processor is automatically configured to send spans to Respan.
+     * You only need to call this method if you want to route spans to additional destinations.
+     *
+     * @param config - Processor configuration
+     *
+     * @example
+     * ```typescript
+     * // Add debug processor (in addition to default Respan processor)
+     * respan.addProcessor({
+     *   exporter: new FileExporter("./debug.json"),
+     *   name: "debug"
+     * });
+     *
+     * // Route specific spans to debug processor
+     * await respan.withTask(
+     *   { name: "my_task", processors: "debug" },
+     *   async () => { ... }
+     * );
+     *
+     * // Spans without processors attribute go to default Respan processor
+     * await respan.withTask(
+     *   { name: "normal_task" },
+     *   async () => { ... }  // <- Goes to default processor
+     * );
+     * ```
+     */
+    addProcessor(config) {
+        addProcessorToSDK(config);
+    }
+    /**
+     * Get the client API for span management.
+     * Provides methods to update spans, add events, record exceptions, etc.
+     *
+     * @returns The Respan client instance
+     *
+     * @example
+     * ```typescript
+     * const client = respan.getClient();
+     * const traceId = client.getCurrentTraceId();
+     * client.updateCurrentSpan({
+     *   respanParams: {
+     *     customerIdentifier: "user-123"
+     *   }
+     * });
+     * ```
+     */
+    getClient() {
+        return getClientAPI();
+    }
+    /**
+     * Get the span buffer manager for manual span control.
+     *
+     * @returns The span buffer manager
+     *
+     * @example
+     * ```typescript
+     * const manager = respan.getSpanBufferManager();
+     * const buffer = manager.createBuffer("trace-123");
+     * buffer.createSpan("step1", { status: "completed" });
+     * const spans = buffer.getAllSpans();
+     * await manager.processSpans(spans);
+     * ```
+     */
+    getSpanBufferManager() {
+        return getSpanBufferManager();
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/processor/composite.d.ts

@@ -0,0 +1,29 @@
+import { Context } from "@opentelemetry/api";
+import { SpanProcessor, ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import { MultiProcessorManager } from "./manager.js";
+/**
+ * Composite processor that combines filtering with multi-processor routing.
+ *
+ * Flow:
+ * 1. Filter spans (keep only user-decorated spans and their children)
+ * 2. Apply postprocess callback if configured
+ * 3. Route filtered spans to appropriate processors
+ *
+ * This ensures only meaningful spans are routed to processors.
+ */
+export declare class RespanCompositeProcessor implements SpanProcessor {
+    private readonly _processorManager;
+    private readonly _postprocessCallback?;
+    constructor(processorManager: MultiProcessorManager, postprocessCallback?: (span: ReadableSpan) => void);
+    onStart(span: ReadableSpan, parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    /**
+     * Get the entity path from context
+     */
+    /**
+     * Get the processor manager (for adding new processors)
+     */
+    getProcessorManager(): MultiProcessorManager;
+}

package/dist/processor/composite.js

@@ -0,0 +1,106 @@
+import { SpanAttributes } from "@traceloop/ai-semantic-conventions";
+import { getEntityPath } from "../utils/context.js";
+/**
+ * Composite processor that combines filtering with multi-processor routing.
+ *
+ * Flow:
+ * 1. Filter spans (keep only user-decorated spans and their children)
+ * 2. Apply postprocess callback if configured
+ * 3. Route filtered spans to appropriate processors
+ *
+ * This ensures only meaningful spans are routed to processors.
+ */
+export class RespanCompositeProcessor {
+    _processorManager;
+    _postprocessCallback;
+    constructor(processorManager, postprocessCallback) {
+        this._processorManager = processorManager;
+        this._postprocessCallback = postprocessCallback;
+    }
+    onStart(span, parentContext) {
+        // Check if this span is being created within an entity context
+        // If so, add the entityPath attribute so it gets preserved by our filtering
+        const entityPath = getEntityPath(parentContext);
+        if (entityPath && !span.attributes[SpanAttributes.TRACELOOP_SPAN_KIND]) {
+            // This is an auto-instrumentation span within an entity context
+            // Add the entityPath attribute so it doesn't get filtered out
+            console.debug(`[Respan Debug] Adding entityPath to auto-instrumentation span: ${span.name} (entityPath: ${entityPath})`);
+            // We need to cast to any to set attributes during onStart
+            span.setAttribute(SpanAttributes.TRACELOOP_ENTITY_PATH, entityPath);
+        }
+        // Forward to processor manager
+        this._processorManager.onStart(span, parentContext);
+    }
+    onEnd(span) {
+        const spanKind = span.attributes[SpanAttributes.TRACELOOP_SPAN_KIND];
+        const entityPath = span.attributes[SpanAttributes.TRACELOOP_ENTITY_PATH];
+        // Apply postprocess callback if provided
+        if (this._postprocessCallback) {
+            try {
+                this._postprocessCallback(span);
+            }
+            catch (error) {
+                console.error("[Respan] Error in span postprocess callback:", error);
+            }
+        }
+        // Check if this is an LLM instrumentation span (OpenAI, Anthropic, etc.)
+        // These have gen_ai.* or llm.* attributes
+        const isLLMSpan = span.attributes['gen_ai.system'] !== undefined ||
+            span.attributes['llm.system'] !== undefined ||
+            span.attributes['gen_ai.request.model'] !== undefined ||
+            span.name.includes('anthropic.messages') ||
+            span.name.includes('openai.chat') ||
+            span.name.includes('chat.completions');
+        // Filter: only process spans that are user-decorated, within entity context, or LLM calls
+        if (spanKind) {
+            // This is a user-decorated span (withWorkflow, withTask, etc.) - make it a root span
+            console.debug(`[Respan Debug] Processing user-decorated span as root: ${span.name} (kind: ${spanKind})`);
+            // Create a wrapper that makes the span appear as a root span
+            const rootSpan = Object.create(Object.getPrototypeOf(span));
+            Object.assign(rootSpan, span);
+            // Override the parentSpanId to make it a root span
+            Object.defineProperty(rootSpan, 'parentSpanId', {
+                value: undefined,
+                writable: false,
+                configurable: true,
+                enumerable: true
+            });
+            // Route to processors
+            this._processorManager.onEnd(rootSpan);
+        }
+        else if (entityPath && entityPath !== "") {
+            // This span doesn't have a kind but has entityPath - it's a child span within a withEntity context
+            // Keep it as a normal child span (preserve parent relationships)
+            console.debug(`[Respan Debug] Processing child span within entity context: ${span.name} (entityPath: ${entityPath})`);
+            // Route to processors
+            this._processorManager.onEnd(span);
+        }
+        else if (isLLMSpan) {
+            // This is an LLM instrumentation span - keep it!
+            console.debug(`[Respan Debug] Processing LLM instrumentation span: ${span.name}`);
+            // Route to processors
+            this._processorManager.onEnd(span);
+        }
+        else {
+            // This span has none of the above - it's pure auto-instrumentation noise (HTTP calls, etc.)
+            console.debug(`[Respan Debug] Filtering out auto-instrumentation span: ${span.name}`);
+        }
+    }
+    async shutdown() {
+        await this._processorManager.shutdown();
+    }
+    async forceFlush() {
+        await this._processorManager.forceFlush();
+    }
+    /**
+     * Get the entity path from context
+     */
+    // Removed - now using imported getEntityPath function
+    /**
+     * Get the processor manager (for adding new processors)
+     */
+    getProcessorManager() {
+        return this._processorManager;
+    }
+}
+//# sourceMappingURL=composite.js.map

package/dist/processor/composite.js.map

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

package/dist/processor/filtering.d.ts

@@ -0,0 +1,19 @@
+import { Context } from "@opentelemetry/api";
+import { SpanProcessor, ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+/**
+ * Custom span processor that implements intelligent span filtering:
+ * 1. User-decorated spans (withEntity) become root spans (no parent hierarchy)
+ * 2. Auto-instrumentation spans within withEntity context get entityPath and are preserved
+ * 3. Pure auto-instrumentation spans (no context) are filtered out
+ *
+ * This eliminates noise while preserving useful spans like OpenAI/HTTP calls within user workflows.
+ */
+export declare class RespanFilteringSpanProcessor implements SpanProcessor {
+    private readonly _spanProcessor;
+    private readonly _postprocessCallback?;
+    constructor(exporter: SpanExporter, postprocessCallback?: (span: ReadableSpan) => void);
+    onStart(span: ReadableSpan, parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}

package/dist/processor/filtering.js

@@ -0,0 +1,78 @@
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { SpanAttributes } from "@traceloop/ai-semantic-conventions";
+import { getEntityPath } from "../utils/context.js";
+/**
+ * Custom span processor that implements intelligent span filtering:
+ * 1. User-decorated spans (withEntity) become root spans (no parent hierarchy)
+ * 2. Auto-instrumentation spans within withEntity context get entityPath and are preserved
+ * 3. Pure auto-instrumentation spans (no context) are filtered out
+ *
+ * This eliminates noise while preserving useful spans like OpenAI/HTTP calls within user workflows.
+ */
+export class RespanFilteringSpanProcessor {
+    _spanProcessor;
+    _postprocessCallback;
+    constructor(exporter, postprocessCallback) {
+        this._spanProcessor = new BatchSpanProcessor(exporter);
+        this._postprocessCallback = postprocessCallback;
+    }
+    onStart(span, parentContext) {
+        // Check if this span is being created within an entity context
+        // If so, add the entityPath attribute so it gets preserved by our filtering
+        const entityPath = getEntityPath(parentContext);
+        if (entityPath && !span.attributes[SpanAttributes.TRACELOOP_SPAN_KIND]) {
+            // This is an auto-instrumentation span within an entity context
+            // Add the entityPath attribute so it doesn't get filtered out
+            console.debug(`[Respan Debug] Adding entityPath to auto-instrumentation span: ${span.name} (entityPath: ${entityPath})`);
+            // We need to cast to any to set attributes during onStart
+            span.setAttribute(SpanAttributes.TRACELOOP_ENTITY_PATH, entityPath);
+        }
+        // Always call onStart for all spans to maintain proper span lifecycle
+        this._spanProcessor.onStart(span, parentContext);
+    }
+    onEnd(span) {
+        const spanKind = span.attributes[SpanAttributes.TRACELOOP_SPAN_KIND];
+        const entityPath = span.attributes[SpanAttributes.TRACELOOP_ENTITY_PATH];
+        // Apply postprocess callback if provided
+        if (this._postprocessCallback) {
+            try {
+                this._postprocessCallback(span);
+            }
+            catch (error) {
+                console.error("[Respan] Error in span postprocess callback:", error);
+            }
+        }
+        if (spanKind) {
+            // This is a user-decorated span (withWorkflow, withTask, etc.) - make it a root span
+            console.debug(`[Respan Debug] Sending user-decorated span as root: ${span.name} (kind: ${spanKind})`);
+            // Create a wrapper that makes the span appear as a root span
+            const rootSpan = Object.create(Object.getPrototypeOf(span));
+            Object.assign(rootSpan, span);
+            // Override the parentSpanId to make it a root span
+            Object.defineProperty(rootSpan, 'parentSpanId', {
+                value: undefined,
+                writable: false,
+                configurable: true,
+                enumerable: true
+            });
+            this._spanProcessor.onEnd(rootSpan);
+        }
+        else if (entityPath && entityPath !== "") {
+            // This span doesn't have a kind but has entityPath - it's a child span within a withEntity context
+            // Keep it as a normal child span (preserve parent relationships)
+            console.debug(`[Respan Debug] Sending child span within entity context: ${span.name} (entityPath: ${entityPath})`);
+            this._spanProcessor.onEnd(span);
+        }
+        else {
+            // This span has neither kind nor entityPath - it's pure auto-instrumentation noise
+            console.debug(`[Respan Debug] Filtering out auto-instrumentation span: ${span.name} (no TRACELOOP_SPAN_KIND or entityPath)`);
+        }
+    }
+    shutdown() {
+        return this._spanProcessor.shutdown();
+    }
+    forceFlush() {
+        return this._spanProcessor.forceFlush();
+    }
+}
+//# sourceMappingURL=filtering.js.map

package/dist/processor/filtering.js.map

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

package/dist/processor/index.d.ts

@@ -0,0 +1,3 @@
+export * from './filtering.js';
+export * from './manager.js';
+export * from './composite.js';

package/dist/processor/index.js

@@ -0,0 +1,4 @@
+export * from './filtering.js';
+export * from './manager.js';
+export * from './composite.js';
+//# sourceMappingURL=index.js.map

package/dist/processor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/processor/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}