@ebowwa/crm 0.1.0

package/dist/telemetry/logger.js

@@ -0,0 +1,256 @@
+/**
+ * Logger module for CRM system
+ *
+ * Provides structured logging with multiple log levels and formatters.
+ * Supports JSON output for production and pretty printing for development.
+ */
+const LOG_LEVELS = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+};
+/**
+ * Structured logger with context support
+ */
+export class Logger {
+    level;
+    config;
+    defaultContext;
+    constructor(config) {
+        this.config = {
+            level: config.level ?? (process.env.NODE_ENV === 'production' ? 'info' : 'debug'),
+            version: config.version ?? '0.1.0',
+            env: config.env ?? process.env.NODE_ENV ?? 'development',
+            prettyPrint: config.prettyPrint ?? process.env.LOG_PRETTY === 'true',
+            includeStackTrace: config.includeStackTrace ?? true,
+            ...config,
+        };
+        this.level = LOG_LEVELS[this.config.level];
+        this.defaultContext = {
+            service: this.config.service,
+            version: this.config.version,
+            env: this.config.env,
+        };
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(context) {
+        return new ChildLogger(this, { ...this.defaultContext, ...context });
+    }
+    /**
+     * Log at trace level (most verbose)
+     */
+    trace(message, context) {
+        this.log('trace', message, context);
+    }
+    /**
+     * Log at debug level
+     */
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    /**
+     * Log at info level
+     */
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    /**
+     * Log at warn level
+     */
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    /**
+     * Log at error level
+     */
+    error(message, error, context) {
+        const entry = this.createEntry('error', message, context);
+        if (error instanceof Error) {
+            entry.error = {
+                name: error.name,
+                message: error.message,
+                stack: this.config.includeStackTrace ? error.stack : undefined,
+            };
+        }
+        else if (error !== undefined) {
+            entry.context = { ...entry.context, error: String(error) };
+        }
+        this.output(entry);
+    }
+    /**
+     * Log at fatal level (application should exit after this)
+     */
+    fatal(message, error, context) {
+        const entry = this.createEntry('fatal', message, context);
+        if (error instanceof Error) {
+            entry.error = {
+                name: error.name,
+                message: error.message,
+                stack: this.config.includeStackTrace ? error.stack : undefined,
+            };
+        }
+        else if (error !== undefined) {
+            entry.context = { ...entry.context, error: String(error) };
+        }
+        this.output(entry);
+    }
+    /**
+     * Log with timing information
+     */
+    time(message, durationMs, context) {
+        const entry = this.createEntry('info', message, context);
+        entry.duration = durationMs;
+        this.output(entry);
+    }
+    /**
+     * Create a timer that logs duration when stopped
+     */
+    startTimer(message, context) {
+        const start = performance.now();
+        return () => {
+            const duration = performance.now() - start;
+            this.time(message, duration, context);
+            return duration;
+        };
+    }
+    /**
+     * Add trace context to logs
+     */
+    withTrace(traceId, spanId) {
+        const logger = new Logger(this.config);
+        logger.defaultContext = {
+            ...this.defaultContext,
+            traceId,
+            spanId,
+        };
+        return logger;
+    }
+    log(level, message, context) {
+        if (LOG_LEVELS[level] < this.level) {
+            return;
+        }
+        const entry = this.createEntry(level, message, context);
+        this.output(entry);
+    }
+    createEntry(level, message, context) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context: { ...this.defaultContext, ...context },
+        };
+        return entry;
+    }
+    output(entry) {
+        if (this.config.prettyPrint && this.config.env !== 'production') {
+            this.prettyOutput(entry);
+        }
+        else {
+            this.jsonOutput(entry);
+        }
+    }
+    jsonOutput(entry) {
+        const output = JSON.stringify(entry);
+        if (entry.level === 'fatal' || entry.level === 'error') {
+            console.error(output);
+        }
+        else if (entry.level === 'warn') {
+            console.warn(output);
+        }
+        else {
+            console.log(output);
+        }
+    }
+    prettyOutput(entry) {
+        const levelColors = {
+            trace: '\x1b[90m', // gray
+            debug: '\x1b[36m', // cyan
+            info: '\x1b[32m', // green
+            warn: '\x1b[33m', // yellow
+            error: '\x1b[31m', // red
+            fatal: '\x1b[35m', // magenta
+        };
+        const reset = '\x1b[0m';
+        const color = levelColors[entry.level];
+        const timestamp = entry.timestamp.split('T')[1]?.split('.')[0] ?? entry.timestamp;
+        const level = entry.level.toUpperCase().padEnd(5);
+        let output = `${color}[${timestamp}] ${level}${reset} ${entry.message}`;
+        if (entry.context && Object.keys(entry.context).length > 0) {
+            output += ` ${reset}\x1b[90m${JSON.stringify(entry.context)}\x1b[0m`;
+        }
+        if (entry.duration !== undefined) {
+            output += ` ${reset}\x1b[90m(${entry.duration.toFixed(2)}ms)\x1b[0m`;
+        }
+        if (entry.error) {
+            output += `\n  \x1b[31m${entry.error.name}: ${entry.error.message}\x1b[0m`;
+            if (entry.error.stack && this.config.includeStackTrace) {
+                const stackLines = entry.error.stack.split('\n').slice(1, 5);
+                output += `\n  \x1b[90m${stackLines.join('\n  ')}\x1b[0m`;
+            }
+        }
+        if (entry.level === 'fatal' || entry.level === 'error') {
+            console.error(output);
+        }
+        else if (entry.level === 'warn') {
+            console.warn(output);
+        }
+        else {
+            console.log(output);
+        }
+    }
+}
+/**
+ * Child logger with bound context
+ */
+class ChildLogger {
+    parent;
+    context;
+    constructor(parent, context) {
+        this.parent = parent;
+        this.context = context;
+    }
+    trace(message, additionalContext) {
+        this.parent.trace(message, { ...this.context, ...additionalContext });
+    }
+    debug(message, additionalContext) {
+        this.parent.debug(message, { ...this.context, ...additionalContext });
+    }
+    info(message, additionalContext) {
+        this.parent.info(message, { ...this.context, ...additionalContext });
+    }
+    warn(message, additionalContext) {
+        this.parent.warn(message, { ...this.context, ...additionalContext });
+    }
+    error(message, error, additionalContext) {
+        this.parent.error(message, error, { ...this.context, ...additionalContext });
+    }
+    fatal(message, error, additionalContext) {
+        this.parent.fatal(message, error, { ...this.context, ...additionalContext });
+    }
+    time(message, durationMs, additionalContext) {
+        const stop = this.parent.startTimer(message, { ...this.context, ...additionalContext });
+        // Already logged by startTimer
+    }
+    startTimer(message, additionalContext) {
+        return this.parent.startTimer(message, { ...this.context, ...additionalContext });
+    }
+}
+/**
+ * Default logger instance
+ */
+export const logger = new Logger({
+    service: 'crm',
+    version: '0.1.0',
+});
+/**
+ * Create a new logger instance
+ */
+export function createLogger(config) {
+    return new Logger(config);
+}
+//# sourceMappingURL=logger.js.map

package/dist/telemetry/logger.js.map

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

package/dist/telemetry/metrics.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Metrics module for CRM system
+ *
+ * Provides a simple metrics collection system with counters, gauges, and histograms.
+ * Supports exporting metrics in Prometheus format.
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+export interface MetricLabel {
+    [key: string]: string | number;
+}
+export interface MetricValue {
+    value: number;
+    timestamp: number;
+    labels: MetricLabel;
+}
+export interface MetricDefinition {
+    name: string;
+    type: MetricType;
+    description: string;
+    unit?: string;
+}
+export interface HistogramOptions {
+    buckets?: number[];
+}
+interface CounterMetric extends MetricDefinition {
+    type: 'counter';
+    values: MetricValue[];
+}
+interface GaugeMetric extends MetricDefinition {
+    type: 'gauge';
+    values: MetricValue[];
+}
+interface HistogramMetric extends MetricDefinition {
+    type: 'histogram';
+    values: {
+        sum: number;
+        count: number;
+        buckets: {
+            boundary: number;
+            count: number;
+        }[];
+        timestamp: number;
+        labels: MetricLabel;
+    }[];
+    options: HistogramOptions;
+}
+type Metric = CounterMetric | GaugeMetric | HistogramMetric;
+/**
+ * Metrics registry for collecting and exporting metrics
+ */
+export declare class MetricsRegistry {
+    private readonly metrics;
+    private readonly prefix;
+    constructor(prefix?: string);
+    /**
+     * Register a counter metric
+     */
+    registerCounter(name: string, description: string, unit?: string): void;
+    /**
+     * Register a gauge metric
+     */
+    registerGauge(name: string, description: string, unit?: string): void;
+    /**
+     * Register a histogram metric
+     */
+    registerHistogram(name: string, description: string, unit?: string, options?: HistogramOptions): void;
+    /**
+     * Increment a counter
+     */
+    increment(name: string, value?: number, labels?: MetricLabel): void;
+    /**
+     * Decrement a counter (useful for error tracking)
+     */
+    decrement(name: string, value?: number, labels?: MetricLabel): void;
+    /**
+     * Set a gauge value
+     */
+    gauge(name: string, value: number, labels?: MetricLabel): void;
+    /**
+     * Observe a value for histogram
+     */
+    observe(name: string, value: number, labels?: MetricLabel): void;
+    /**
+     * Create a timer that records duration in a histogram
+     */
+    startTimer(name: string, labels?: MetricLabel): () => number;
+    /**
+     * Get all metrics
+     */
+    getMetrics(): Metric[];
+    /**
+     * Export metrics in Prometheus text format
+     */
+    exportPrometheus(): string;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get metric by name
+     */
+    getMetric(name: string): Metric | undefined;
+    private labelsMatch;
+    private formatLabels;
+}
+/**
+ * Default metrics registry
+ */
+export declare const metrics: MetricsRegistry;
+/**
+ * Pre-registered CRM metrics
+ */
+export declare function initializeCrmMetrics(registry?: MetricsRegistry): void;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/telemetry/metrics.d.ts.map

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

package/dist/telemetry/metrics.js

@@ -0,0 +1,292 @@
+/**
+ * Metrics module for CRM system
+ *
+ * Provides a simple metrics collection system with counters, gauges, and histograms.
+ * Supports exporting metrics in Prometheus format.
+ */
+/**
+ * Default histogram buckets (in seconds for latency)
+ */
+const DEFAULT_BUCKETS = [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+/**
+ * Metrics registry for collecting and exporting metrics
+ */
+export class MetricsRegistry {
+    metrics = new Map();
+    prefix;
+    constructor(prefix = 'crm_') {
+        this.prefix = prefix;
+    }
+    /**
+     * Register a counter metric
+     */
+    registerCounter(name, description, unit) {
+        const metricName = this.prefix + name;
+        if (this.metrics.has(metricName)) {
+            throw new Error(`Metric ${metricName} already registered`);
+        }
+        this.metrics.set(metricName, {
+            name: metricName,
+            type: 'counter',
+            description,
+            unit,
+            values: [],
+        });
+    }
+    /**
+     * Register a gauge metric
+     */
+    registerGauge(name, description, unit) {
+        const metricName = this.prefix + name;
+        if (this.metrics.has(metricName)) {
+            throw new Error(`Metric ${metricName} already registered`);
+        }
+        this.metrics.set(metricName, {
+            name: metricName,
+            type: 'gauge',
+            description,
+            unit,
+            values: [],
+        });
+    }
+    /**
+     * Register a histogram metric
+     */
+    registerHistogram(name, description, unit, options) {
+        const metricName = this.prefix + name;
+        if (this.metrics.has(metricName)) {
+            throw new Error(`Metric ${metricName} already registered`);
+        }
+        this.metrics.set(metricName, {
+            name: metricName,
+            type: 'histogram',
+            description,
+            unit,
+            options: { buckets: options?.buckets ?? DEFAULT_BUCKETS },
+            values: [],
+        });
+    }
+    /**
+     * Increment a counter
+     */
+    increment(name, value = 1, labels = {}) {
+        const metricName = this.prefix + name;
+        const metric = this.metrics.get(metricName);
+        if (!metric) {
+            throw new Error(`Metric ${metricName} not found`);
+        }
+        if (metric.type !== 'counter') {
+            throw new Error(`Metric ${metricName} is not a counter`);
+        }
+        const existingIndex = metric.values.findIndex(v => this.labelsMatch(v.labels, labels));
+        if (existingIndex >= 0) {
+            metric.values[existingIndex].value += value;
+            metric.values[existingIndex].timestamp = Date.now();
+        }
+        else {
+            metric.values.push({
+                value,
+                timestamp: Date.now(),
+                labels,
+            });
+        }
+    }
+    /**
+     * Decrement a counter (useful for error tracking)
+     */
+    decrement(name, value = 1, labels = {}) {
+        this.increment(name, -value, labels);
+    }
+    /**
+     * Set a gauge value
+     */
+    gauge(name, value, labels = {}) {
+        const metricName = this.prefix + name;
+        const metric = this.metrics.get(metricName);
+        if (!metric) {
+            throw new Error(`Metric ${metricName} not found`);
+        }
+        if (metric.type !== 'gauge') {
+            throw new Error(`Metric ${metricName} is not a gauge`);
+        }
+        const existingIndex = metric.values.findIndex(v => this.labelsMatch(v.labels, labels));
+        if (existingIndex >= 0) {
+            metric.values[existingIndex].value = value;
+            metric.values[existingIndex].timestamp = Date.now();
+        }
+        else {
+            metric.values.push({
+                value,
+                timestamp: Date.now(),
+                labels,
+            });
+        }
+    }
+    /**
+     * Observe a value for histogram
+     */
+    observe(name, value, labels = {}) {
+        const metricName = this.prefix + name;
+        const metric = this.metrics.get(metricName);
+        if (!metric) {
+            throw new Error(`Metric ${metricName} not found`);
+        }
+        if (metric.type !== 'histogram') {
+            throw new Error(`Metric ${metricName} is not a histogram`);
+        }
+        const existingIndex = metric.values.findIndex(v => this.labelsMatch(v.labels, labels));
+        if (existingIndex >= 0) {
+            const existing = metric.values[existingIndex];
+            existing.sum += value;
+            existing.count += 1;
+            for (const bucket of existing.buckets) {
+                if (value <= bucket.boundary) {
+                    bucket.count += 1;
+                }
+            }
+            existing.timestamp = Date.now();
+        }
+        else {
+            const buckets = metric.options.buckets ?? DEFAULT_BUCKETS;
+            metric.values.push({
+                sum: value,
+                count: 1,
+                buckets: buckets.map(boundary => ({
+                    boundary,
+                    count: value <= boundary ? 1 : 0,
+                })),
+                timestamp: Date.now(),
+                labels,
+            });
+        }
+    }
+    /**
+     * Create a timer that records duration in a histogram
+     */
+    startTimer(name, labels = {}) {
+        const start = process.hrtime.bigint();
+        return () => {
+            const end = process.hrtime.bigint();
+            const durationSeconds = Number(end - start) / 1e9;
+            this.observe(name, durationSeconds, labels);
+            return durationSeconds;
+        };
+    }
+    /**
+     * Get all metrics
+     */
+    getMetrics() {
+        return Array.from(this.metrics.values());
+    }
+    /**
+     * Export metrics in Prometheus text format
+     */
+    exportPrometheus() {
+        const lines = [];
+        for (const metric of this.metrics.values()) {
+            // Add help and type comments
+            lines.push(`# HELP ${metric.name} ${metric.description}`);
+            lines.push(`# TYPE ${metric.name} ${metric.type}`);
+            if (metric.type === 'counter' || metric.type === 'gauge') {
+                for (const value of metric.values) {
+                    const labelStr = this.formatLabels(value.labels);
+                    lines.push(`${metric.name}${labelStr} ${value.value}`);
+                }
+            }
+            else if (metric.type === 'histogram') {
+                for (const value of metric.values) {
+                    const labelStr = this.formatLabels(value.labels);
+                    // Bucket counts
+                    for (const bucket of value.buckets) {
+                        const bucketLabels = { ...value.labels, le: bucket.boundary.toString() };
+                        const bucketLabelStr = this.formatLabels(bucketLabels);
+                        lines.push(`${metric.name}_bucket${bucketLabelStr} ${bucket.count}`);
+                    }
+                    // +Inf bucket (same as count)
+                    const infLabels = { ...value.labels, le: '+Inf' };
+                    const infLabelStr = this.formatLabels(infLabels);
+                    lines.push(`${metric.name}_bucket${infLabelStr} ${value.count}`);
+                    // Sum and count
+                    lines.push(`${metric.name}_sum${labelStr} ${value.sum}`);
+                    lines.push(`${metric.name}_count${labelStr} ${value.count}`);
+                }
+            }
+            lines.push(''); // Empty line between metrics
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        for (const metric of this.metrics.values()) {
+            if (metric.type === 'histogram') {
+                metric.values = [];
+            }
+            else {
+                metric.values = [];
+            }
+        }
+    }
+    /**
+     * Get metric by name
+     */
+    getMetric(name) {
+        return this.metrics.get(this.prefix + name);
+    }
+    labelsMatch(a, b) {
+        const keysA = Object.keys(a).sort();
+        const keysB = Object.keys(b).sort();
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((key, i) => {
+            if (key !== keysB[i])
+                return false;
+            return a[key] === b[key];
+        });
+    }
+    formatLabels(labels) {
+        const entries = Object.entries(labels);
+        if (entries.length === 0)
+            return '';
+        const formatted = entries.map(([key, value]) => {
+            const escapedValue = String(value).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+            return `${key}="${escapedValue}"`;
+        });
+        return `{${formatted.join(',')}}`;
+    }
+}
+/**
+ * Default metrics registry
+ */
+export const metrics = new MetricsRegistry('crm_');
+/**
+ * Pre-registered CRM metrics
+ */
+export function initializeCrmMetrics(registry = metrics) {
+    // Contact metrics
+    registry.registerCounter('contacts_created_total', 'Total number of contacts created');
+    registry.registerCounter('contacts_updated_total', 'Total number of contacts updated');
+    registry.registerCounter('contacts_deleted_total', 'Total number of contacts deleted');
+    registry.registerGauge('contacts_active_count', 'Current number of active contacts');
+    // Deal metrics
+    registry.registerCounter('deals_created_total', 'Total number of deals created');
+    registry.registerCounter('deals_won_total', 'Total number of deals won');
+    registry.registerCounter('deals_lost_total', 'Total number of deals lost');
+    registry.registerGauge('deals_active_count', 'Current number of active deals');
+    registry.registerGauge('deals_pipeline_value', 'Total value of deals in pipeline', 'USD');
+    // Activity metrics
+    registry.registerCounter('activities_created_total', 'Total number of activities created');
+    registry.registerCounter('activities_completed_total', 'Total number of activities completed');
+    registry.registerGauge('activities_pending_count', 'Current number of pending activities');
+    // API metrics
+    registry.registerHistogram('api_request_duration_seconds', 'API request duration in seconds');
+    registry.registerCounter('api_requests_total', 'Total number of API requests');
+    registry.registerCounter('api_errors_total', 'Total number of API errors');
+    // Search metrics
+    registry.registerHistogram('search_duration_seconds', 'Search query duration in seconds');
+    registry.registerCounter('search_queries_total', 'Total number of search queries');
+}
+// Initialize default metrics
+initializeCrmMetrics();
+//# sourceMappingURL=metrics.js.map