@csaimonitor/sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Synchronous client for CSMonitor SDK.
+ *
+ * This module provides the main CSMonitor class for tracking agent events.
+ */
+import { CSMonitorConfig, CSMonitorConfigOptions } from './config';
+import { Event } from './models';
+import { createTrackDecorator } from './decorators';
+import { setupLogger } from './utils';
+/**
+ * Context manager for tracking events.
+ * This class is returned by trackEvent() and allows manual control over event attributes.
+ */
+export declare class TrackedEvent {
+    private readonly monitor;
+    readonly eventType: string;
+    private inputData?;
+    private outputData?;
+    private metadata;
+    private costUsd?;
+    private status;
+    private errorMessage?;
+    private startTime?;
+    private startTimestamp?;
+    constructor(monitor: CSMonitor, eventType: string, inputData?: Record<string, unknown>);
+    /**
+     * Set output data for the event.
+     * @param outputData - Output data to track
+     */
+    setOutput(outputData: unknown): void;
+    /**
+     * Set metadata fields.
+     * @param metadata - Metadata key-value pairs
+     */
+    setMetadata(metadata: Record<string, unknown>): void;
+    /**
+     * Set cost in USD.
+     * @param costUsd - Cost in US dollars
+     */
+    setCost(costUsd: number): void;
+    /**
+     * Set event status.
+     * @param status - Status string ("success" or "failure")
+     */
+    setStatus(status: string): void;
+    /**
+     * Set error message and status.
+     * @param errorMessage - Error message
+     */
+    setError(errorMessage: string): void;
+    /**
+     * Start tracking (enter context).
+     */
+    start(): void;
+    /**
+     * Finish tracking and log event (exit context).
+     * @param error - Optional error that occurred
+     */
+    finish(error?: unknown): void;
+}
+/**
+ * Main client for tracking agent events.
+ *
+ * This class provides multiple ways to track events:
+ * 1. Decorator: @monitor.track()
+ * 2. Context manager: monitor.trackEvent(...)
+ * 3. Manual: monitor.logEvent(...)
+ *
+ * @example
+ * ```typescript
+ * const monitor = new CSMonitor({
+ *   apiKey: 'your_key',
+ *   agentId: 'my_agent',
+ *   apiUrl: 'http://localhost:3002/api/v1'
+ * });
+ *
+ * @monitor.track()
+ * function myFunction(x: number): number {
+ *   return x * 2;
+ * }
+ *
+ * const result = myFunction(5);
+ * monitor.flush();
+ * ```
+ */
+export declare class CSMonitor {
+    readonly config: CSMonitorConfig;
+    readonly logger: ReturnType<typeof setupLogger>;
+    private readonly _batchQueue;
+    constructor(options: CSMonitorConfigOptions);
+    /**
+     * Decorator to automatically track function execution.
+     * @param options - Tracking options
+     * @returns Decorator function
+     *
+     * @example
+     * ```typescript
+     * @monitor.track({ eventType: 'query' })
+     * function askQuestion(question: string): string {
+     *   return generateAnswer(question);
+     * }
+     * ```
+     */
+    track(options?: Parameters<ReturnType<typeof createTrackDecorator>>[0]): <T extends (...args: unknown[]) => unknown>(target: T, _propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => T | PropertyDescriptor;
+    /**
+     * Create a context manager for tracking an event.
+     * @param eventType - Type of event
+     * @param inputData - Initial input data
+     * @returns TrackedEvent context manager
+     *
+     * @example
+     * ```typescript
+     * const event = monitor.trackEvent('action');
+     * event.start();
+     * const result = performAction();
+     * event.setOutput({ result });
+     * event.setMetadata({ model: 'gpt-4' });
+     * event.finish();
+     * ```
+     */
+    trackEvent(eventType: string, inputData?: Record<string, unknown>): TrackedEvent;
+    /**
+     * Manually log an event.
+     * @param options - Event data
+     *
+     * @example
+     * ```typescript
+     * monitor.logEvent({
+     *   eventType: 'decision',
+     *   inputData: { query: 'test' },
+     *   outputData: { answer: 'response' },
+     *   metadata: { model: 'gpt-4' }
+     * });
+     * ```
+     */
+    logEvent(options: {
+        eventType: string;
+        inputData?: Record<string, unknown>;
+        outputData?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+        costUsd?: number;
+        latencyMs?: number;
+        status?: string;
+        errorMessage?: string;
+        timestamp?: string;
+    }): void;
+    /**
+     * Add event to batch queue (internal method).
+     * @param event - Event to add
+     */
+    _addEvent(event: Event): void;
+    /**
+     * Flush all pending events immediately (blocking).
+     * Call this before your application exits to ensure all events are sent.
+     *
+     * @example
+     * ```typescript
+     * monitor.flush();
+     * ```
+     */
+    flush(): void;
+    /**
+     * Close the monitor and cleanup resources.
+     * This will stop the background timer and flush any pending events.
+     * After calling close(), the monitor should not be used.
+     *
+     * @example
+     * ```typescript
+     * monitor.close();
+     * ```
+     */
+    close(): void;
+    /**
+     * String representation.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * Synchronous client for CSMonitor SDK.
+ *
+ * This module provides the main CSMonitor class for tracking agent events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSMonitor = exports.TrackedEvent = void 0;
+const config_1 = require("./config");
+const models_1 = require("./models");
+const batcher_1 = require("./batcher");
+const decorators_1 = require("./decorators");
+const utils_1 = require("./utils");
+/**
+ * Context manager for tracking events.
+ * This class is returned by trackEvent() and allows manual control over event attributes.
+ */
+class TrackedEvent {
+    constructor(monitor, eventType, inputData) {
+        this.metadata = {};
+        this.status = 'success';
+        this.monitor = monitor;
+        this.eventType = eventType;
+        this.inputData = inputData;
+    }
+    /**
+     * Set output data for the event.
+     * @param outputData - Output data to track
+     */
+    setOutput(outputData) {
+        this.outputData = (0, utils_1.safeSerialize)(outputData);
+    }
+    /**
+     * Set metadata fields.
+     * @param metadata - Metadata key-value pairs
+     */
+    setMetadata(metadata) {
+        this.metadata = { ...this.metadata, ...metadata };
+    }
+    /**
+     * Set cost in USD.
+     * @param costUsd - Cost in US dollars
+     */
+    setCost(costUsd) {
+        this.costUsd = costUsd;
+    }
+    /**
+     * Set event status.
+     * @param status - Status string ("success" or "failure")
+     */
+    setStatus(status) {
+        this.status = status;
+    }
+    /**
+     * Set error message and status.
+     * @param errorMessage - Error message
+     */
+    setError(errorMessage) {
+        this.status = 'failure';
+        this.errorMessage = errorMessage;
+    }
+    /**
+     * Start tracking (enter context).
+     */
+    start() {
+        this.startTime = Date.now();
+        this.startTimestamp = (0, utils_1.getIsoTimestamp)();
+    }
+    /**
+     * Finish tracking and log event (exit context).
+     * @param error - Optional error that occurred
+     */
+    finish(error) {
+        // Calculate latency
+        let latencyMs;
+        if (this.startTime) {
+            latencyMs = Date.now() - this.startTime;
+        }
+        // Handle exception
+        if (error) {
+            this.status = 'failure';
+            this.errorMessage = (0, utils_1.formatErrorMessage)(error);
+        }
+        // Apply redaction
+        let finalInputData = this.inputData;
+        let finalOutputData = this.outputData;
+        if (this.monitor.config.redactKeys.length > 0) {
+            if (finalInputData) {
+                finalInputData = (0, utils_1.redactSensitiveData)(finalInputData, this.monitor.config.redactKeys);
+            }
+            if (finalOutputData) {
+                finalOutputData = (0, utils_1.redactSensitiveData)(finalOutputData, this.monitor.config.redactKeys);
+            }
+        }
+        // Create event
+        const event = models_1.Event.create(this.monitor.config.agentId, this.eventType, finalInputData, finalOutputData, Object.keys(this.metadata).length > 0 ? this.metadata : undefined, this.costUsd, latencyMs, this.status, this.errorMessage, this.startTimestamp);
+        // Log event
+        this.monitor._addEvent(event);
+    }
+}
+exports.TrackedEvent = TrackedEvent;
+/**
+ * Main client for tracking agent events.
+ *
+ * This class provides multiple ways to track events:
+ * 1. Decorator: @monitor.track()
+ * 2. Context manager: monitor.trackEvent(...)
+ * 3. Manual: monitor.logEvent(...)
+ *
+ * @example
+ * ```typescript
+ * const monitor = new CSMonitor({
+ *   apiKey: 'your_key',
+ *   agentId: 'my_agent',
+ *   apiUrl: 'http://localhost:3002/api/v1'
+ * });
+ *
+ * @monitor.track()
+ * function myFunction(x: number): number {
+ *   return x * 2;
+ * }
+ *
+ * const result = myFunction(5);
+ * monitor.flush();
+ * ```
+ */
+class CSMonitor {
+    constructor(options) {
+        // Create config
+        this.config = new config_1.CSMonitorConfig(options);
+        this.logger = (0, utils_1.setupLogger)(this.config.debug);
+        // Initialize batch queue
+        this._batchQueue = new batcher_1.BatchQueue(this.config, options.onError);
+        this._batchQueue.start();
+        this.logger.info(`CSMonitor initialized for agent '${this.config.agentId}'`);
+    }
+    /**
+     * Decorator to automatically track function execution.
+     * @param options - Tracking options
+     * @returns Decorator function
+     *
+     * @example
+     * ```typescript
+     * @monitor.track({ eventType: 'query' })
+     * function askQuestion(question: string): string {
+     *   return generateAnswer(question);
+     * }
+     * ```
+     */
+    track(options) {
+        const decoratorFactory = (0, decorators_1.createTrackDecorator)(this);
+        return decoratorFactory(options);
+    }
+    /**
+     * Create a context manager for tracking an event.
+     * @param eventType - Type of event
+     * @param inputData - Initial input data
+     * @returns TrackedEvent context manager
+     *
+     * @example
+     * ```typescript
+     * const event = monitor.trackEvent('action');
+     * event.start();
+     * const result = performAction();
+     * event.setOutput({ result });
+     * event.setMetadata({ model: 'gpt-4' });
+     * event.finish();
+     * ```
+     */
+    trackEvent(eventType, inputData) {
+        const event = new TrackedEvent(this, eventType, inputData);
+        event.start();
+        return event;
+    }
+    /**
+     * Manually log an event.
+     * @param options - Event data
+     *
+     * @example
+     * ```typescript
+     * monitor.logEvent({
+     *   eventType: 'decision',
+     *   inputData: { query: 'test' },
+     *   outputData: { answer: 'response' },
+     *   metadata: { model: 'gpt-4' }
+     * });
+     * ```
+     */
+    logEvent(options) {
+        // Apply redaction
+        let finalInputData = options.inputData;
+        let finalOutputData = options.outputData;
+        if (this.config.redactKeys.length > 0) {
+            if (finalInputData) {
+                finalInputData = (0, utils_1.redactSensitiveData)(finalInputData, this.config.redactKeys);
+            }
+            if (finalOutputData) {
+                finalOutputData = (0, utils_1.redactSensitiveData)(finalOutputData, this.config.redactKeys);
+            }
+        }
+        // Create event
+        const event = models_1.Event.create(this.config.agentId, options.eventType, finalInputData, finalOutputData, options.metadata, options.costUsd, options.latencyMs, options.status || 'success', options.errorMessage, options.timestamp);
+        // Add to queue
+        this._addEvent(event);
+    }
+    /**
+     * Add event to batch queue (internal method).
+     * @param event - Event to add
+     */
+    _addEvent(event) {
+        this._batchQueue.addEvent(event);
+    }
+    /**
+     * Flush all pending events immediately (blocking).
+     * Call this before your application exits to ensure all events are sent.
+     *
+     * @example
+     * ```typescript
+     * monitor.flush();
+     * ```
+     */
+    flush() {
+        this.logger.debug('Flushing pending events');
+        this._batchQueue.flush();
+    }
+    /**
+     * Close the monitor and cleanup resources.
+     * This will stop the background timer and flush any pending events.
+     * After calling close(), the monitor should not be used.
+     *
+     * @example
+     * ```typescript
+     * monitor.close();
+     * ```
+     */
+    close() {
+        this.logger.info('Closing CSMonitor');
+        this._batchQueue.stop();
+    }
+    /**
+     * String representation.
+     */
+    toString() {
+        return `CSMonitor(agentId='${this.config.agentId}', enabled=${this.config.enabled})`;
+    }
+}
+exports.CSMonitor = CSMonitor;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Configuration management for CSMonitor SDK.
+ *
+ * This module handles SDK configuration and validation.
+ */
+/**
+ * Default API URL
+ */
+export declare const DEFAULT_API_URL = "https://api.agentmonitor.io/api/v1";
+/**
+ * Default batch settings
+ */
+export declare const DEFAULT_BATCH_SIZE = 10;
+export declare const DEFAULT_FLUSH_INTERVAL = 5;
+/**
+ * Default retry settings
+ */
+export declare const DEFAULT_RETRY_ATTEMPTS = 3;
+export declare const DEFAULT_TIMEOUT = 30;
+/**
+ * Configuration options for CSMonitor client.
+ */
+export interface CSMonitorConfigOptions {
+    apiKey: string;
+    agentId: string;
+    apiUrl?: string;
+    batchSize?: number;
+    flushInterval?: number;
+    retryAttempts?: number;
+    timeout?: number;
+    debug?: boolean;
+    enabled?: boolean;
+    redactKeys?: string[];
+    onError?: (error: Error) => void;
+}
+/**
+ * Configuration for CSMonitor client.
+ */
+export declare class CSMonitorConfig {
+    readonly apiKey: string;
+    readonly agentId: string;
+    readonly apiUrl: string;
+    readonly batchSize: number;
+    readonly flushInterval: number;
+    readonly retryAttempts: number;
+    readonly timeout: number;
+    readonly debug: boolean;
+    readonly enabled: boolean;
+    readonly redactKeys: string[];
+    readonly onError?: (error: Error) => void;
+    constructor(options: CSMonitorConfigOptions);
+    /**
+     * Validate configuration after initialization.
+     * @throws ConfigError if configuration is invalid
+     */
+    private validate;
+    /**
+     * Get the full URL for batch event ingestion.
+     * @returns Full URL for /events/batch endpoint
+     */
+    get batchUrl(): string;
+    /**
+     * Get HTTP headers for API requests.
+     * @returns Dictionary of headers including authentication
+     */
+    get headers(): Record<string, string>;
+    /**
+     * String representation with redacted API key.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,eAAO,MAAM,eAAe,uCAAuC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,sBAAsB,IAAM,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,KAAK,EAAE,OAAO,CAAC;IAC/B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrC,SAAgB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;gBAErC,OAAO,EAAE,sBAAsB;IAuB3C;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAwChB;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKpC;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM;CAYnB"}

package/dist/config.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Configuration management for CSMonitor SDK.
+ *
+ * This module handles SDK configuration and validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSMonitorConfig = exports.DEFAULT_TIMEOUT = exports.DEFAULT_RETRY_ATTEMPTS = exports.DEFAULT_FLUSH_INTERVAL = exports.DEFAULT_BATCH_SIZE = exports.DEFAULT_API_URL = void 0;
+const exceptions_1 = require("./exceptions");
+const utils_1 = require("./utils");
+/**
+ * Default API URL
+ */
+exports.DEFAULT_API_URL = 'https://api.agentmonitor.io/api/v1';
+/**
+ * Default batch settings
+ */
+exports.DEFAULT_BATCH_SIZE = 10;
+exports.DEFAULT_FLUSH_INTERVAL = 5.0;
+/**
+ * Default retry settings
+ */
+exports.DEFAULT_RETRY_ATTEMPTS = 3;
+exports.DEFAULT_TIMEOUT = 30;
+/**
+ * Configuration for CSMonitor client.
+ */
+class CSMonitorConfig {
+    constructor(options) {
+        // Required fields
+        this.apiKey = options.apiKey;
+        this.agentId = options.agentId;
+        // Optional fields with defaults - normalize API URL
+        let apiUrl = options.apiUrl || exports.DEFAULT_API_URL;
+        apiUrl = apiUrl.replace(/\/+$/, ''); // Remove trailing slashes
+        this.apiUrl = apiUrl;
+        this.batchSize = options.batchSize ?? exports.DEFAULT_BATCH_SIZE;
+        this.flushInterval = options.flushInterval ?? exports.DEFAULT_FLUSH_INTERVAL;
+        this.retryAttempts = options.retryAttempts ?? exports.DEFAULT_RETRY_ATTEMPTS;
+        this.timeout = options.timeout ?? exports.DEFAULT_TIMEOUT;
+        this.debug = options.debug ?? false;
+        this.enabled = options.enabled ?? true;
+        this.redactKeys = options.redactKeys || [];
+        this.onError = options.onError;
+        // Validate configuration
+        this.validate();
+    }
+    /**
+     * Validate configuration after initialization.
+     * @throws ConfigError if configuration is invalid
+     */
+    validate() {
+        // Validate API key
+        if (!(0, utils_1.validateApiKey)(this.apiKey)) {
+            throw new exceptions_1.ConfigError('Invalid API key. API key must be at least 32 characters long. ' +
+                'Get your API key from the CSMonitor dashboard.');
+        }
+        // Validate agent ID
+        if (!(0, utils_1.validateAgentId)(this.agentId)) {
+            throw new exceptions_1.ConfigError('Invalid agent_id. Agent ID must be a non-empty string.');
+        }
+        // Validate API URL (already normalized in constructor)
+        if (!this.apiUrl || typeof this.apiUrl !== 'string') {
+            throw new exceptions_1.ConfigError('Invalid api_url. Must be a non-empty string.');
+        }
+        // Validate batch size
+        if (!Number.isInteger(this.batchSize) || this.batchSize < 1 || this.batchSize > 100) {
+            throw new exceptions_1.ConfigError('Invalid batch_size. Must be an integer between 1 and 100.');
+        }
+        // Validate flush interval
+        if (typeof this.flushInterval !== 'number' || this.flushInterval < 0.1) {
+            throw new exceptions_1.ConfigError('Invalid flush_interval. Must be a number >= 0.1 seconds.');
+        }
+        // Validate retry attempts
+        if (!Number.isInteger(this.retryAttempts) || this.retryAttempts < 0 || this.retryAttempts > 10) {
+            throw new exceptions_1.ConfigError('Invalid retry_attempts. Must be an integer between 0 and 10.');
+        }
+        // Validate timeout
+        if (typeof this.timeout !== 'number' || this.timeout < 1) {
+            throw new exceptions_1.ConfigError('Invalid timeout. Must be a number >= 1 second.');
+        }
+    }
+    /**
+     * Get the full URL for batch event ingestion.
+     * @returns Full URL for /events/batch endpoint
+     */
+    get batchUrl() {
+        return `${this.apiUrl}/events/batch`;
+    }
+    /**
+     * Get HTTP headers for API requests.
+     * @returns Dictionary of headers including authentication
+     */
+    get headers() {
+        return {
+            'X-API-Key': this.apiKey,
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * String representation with redacted API key.
+     */
+    toString() {
+        const redactedKey = this.apiKey.substring(0, 8) + '...' + this.apiKey.substring(this.apiKey.length - 4);
+        return (`CSMonitorConfig(` +
+            `apiKey='${redactedKey}', ` +
+            `agentId='${this.agentId}', ` +
+            `apiUrl='${this.apiUrl}', ` +
+            `batchSize=${this.batchSize}, ` +
+            `flushInterval=${this.flushInterval}, ` +
+            `enabled=${this.enabled})`);
+    }
+}
+exports.CSMonitorConfig = CSMonitorConfig;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/decorators.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Decorators for automatic event tracking.
+ *
+ * This module provides the @track decorator for automatic monitoring of functions.
+ */
+import type { CSMonitor } from './client';
+import type { AsyncCSMonitor } from './async-client';
+/**
+ * Track decorator options.
+ */
+export interface TrackOptions {
+    eventType?: string;
+    captureInput?: boolean;
+    captureOutput?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create a track decorator bound to a monitor instance.
+ * @param monitorInstance - CSMonitor or AsyncCSMonitor instance
+ * @returns Track decorator function
+ */
+export declare function createTrackDecorator(monitorInstance: CSMonitor | AsyncCSMonitor): (options?: TrackOptions) => <T extends (...args: unknown[]) => unknown>(target: T, _propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => T | PropertyDescriptor;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,SAAS,GAAG,cAAc,IACxD,UAAS,YAAiB,MAQpB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACjE,QAAQ,CAAC,EACT,eAAe,MAAM,GAAG,MAAM,EAC9B,aAAa,kBAAkB,KAC9B,CAAC,GAAG,kBAAkB,CAsE5B"}