gthinking 1.2.1 → 2.1.1

package/dist/utils/metrics.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Metrics Utility for gthinking v2.0.0
+ * Performance metrics and monitoring
+ */
+import { EventEmitter } from 'events';
+/**
+ * Metric types
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'timer';
+/**
+ * Metric value type
+ */
+export type MetricValue = number | Record<string, number>;
+/**
+ * Metric interface
+ */
+export interface Metric {
+    name: string;
+    type: MetricType;
+    value: MetricValue;
+    labels: Record<string, string>;
+    timestamp: number;
+}
+/**
+ * Timer metric interface
+ */
+export interface TimerMetric {
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+}
+/**
+ * Histogram bucket interface
+ */
+export interface HistogramBucket {
+    upperBound: number;
+    count: number;
+}
+/**
+ * Metrics collector class
+ */
+export declare class MetricsCollector extends EventEmitter {
+    private metrics;
+    private timers;
+    private histograms;
+    private enabled;
+    /**
+     * Enable or disable metrics collection
+     * @param enabled - Whether to enable metrics
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Record a counter metric
+     * @param name - Metric name
+     * @param value - Counter value (default: 1)
+     * @param labels - Metric labels
+     */
+    counter(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * Record a gauge metric
+     * @param name - Metric name
+     * @param value - Gauge value
+     * @param labels - Metric labels
+     */
+    gauge(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Start a timer
+     * @param name - Timer name
+     * @param labels - Timer labels
+     */
+    startTimer(name: string, labels?: Record<string, string>): string;
+    /**
+     * End a timer and record the duration
+     * @param key - Timer key returned by startTimer
+     * @returns Duration in milliseconds
+     */
+    endTimer(key: string): number;
+    /**
+     * Record a histogram value
+     * @param name - Histogram name
+     * @param value - Value to record
+     * @param labels - Histogram labels
+     */
+    histogram(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Get all metrics
+     * @returns Array of all metrics
+     */
+    getMetrics(): Metric[];
+    /**
+     * Get metrics by name
+     * @param name - Metric name
+     * @returns Array of metrics with the given name
+     */
+    getMetricsByName(name: string): Metric[];
+    /**
+     * Get histogram statistics
+     * @param name - Histogram name
+     * @param labels - Histogram labels
+     * @returns Histogram statistics
+     */
+    getHistogramStats(name: string, labels?: Record<string, string>): {
+        count: number;
+        sum: number;
+        min: number;
+        max: number;
+        mean: number;
+        p50: number;
+        p95: number;
+        p99: number;
+    } | null;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Export metrics in Prometheus format
+     * @returns Metrics in Prometheus format
+     */
+    exportPrometheus(): string;
+    /**
+     * Export metrics as JSON
+     * @returns Metrics as JSON object
+     */
+    exportJSON(): Record<string, unknown>;
+    /**
+     * Generate a metric key from name and labels
+     * @param name - Metric name
+     * @param labels - Metric labels
+     * @returns Metric key
+     */
+    private getMetricKey;
+}
+export declare const metricsCollector: MetricsCollector;
+/**
+ * Decorator for timing function execution
+ * @param metricName - The metric name to use
+ * @returns Method decorator
+ */
+export declare function timed(metricName?: string): (target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => void;
+/**
+ * Track operation metrics
+ * @param operation - Operation name
+ * @param stage - Operation stage
+ * @param fn - Function to track
+ * @returns Function result
+ */
+export declare function trackOperation<T>(operation: string, stage: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=metrics.d.ts.map

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

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

package/dist/utils/metrics.js

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * Metrics Utility for gthinking v2.0.0
+ * Performance metrics and monitoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricsCollector = exports.MetricsCollector = void 0;
+exports.timed = timed;
+exports.trackOperation = trackOperation;
+const events_1 = require("events");
+const logger_1 = require("./logger");
+const logger = new logger_1.Logger('Metrics');
+/**
+ * Metrics collector class
+ */
+class MetricsCollector extends events_1.EventEmitter {
+    metrics = new Map();
+    timers = new Map();
+    histograms = new Map();
+    enabled = true;
+    /**
+     * Enable or disable metrics collection
+     * @param enabled - Whether to enable metrics
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Record a counter metric
+     * @param name - Metric name
+     * @param value - Counter value (default: 1)
+     * @param labels - Metric labels
+     */
+    counter(name, value = 1, labels = {}) {
+        if (!this.enabled)
+            return;
+        const key = this.getMetricKey(name, labels);
+        const existing = this.metrics.get(key);
+        if (existing && existing.type === 'counter') {
+            existing.value = existing.value + value;
+            existing.timestamp = Date.now();
+        }
+        else {
+            this.metrics.set(key, {
+                name,
+                type: 'counter',
+                value,
+                labels,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    /**
+     * Record a gauge metric
+     * @param name - Metric name
+     * @param value - Gauge value
+     * @param labels - Metric labels
+     */
+    gauge(name, value, labels = {}) {
+        if (!this.enabled)
+            return;
+        const key = this.getMetricKey(name, labels);
+        this.metrics.set(key, {
+            name,
+            type: 'gauge',
+            value,
+            labels,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Start a timer
+     * @param name - Timer name
+     * @param labels - Timer labels
+     */
+    startTimer(name, labels = {}) {
+        const key = this.getMetricKey(name, labels);
+        this.timers.set(key, { startTime: Date.now() });
+        return key;
+    }
+    /**
+     * End a timer and record the duration
+     * @param key - Timer key returned by startTimer
+     * @returns Duration in milliseconds
+     */
+    endTimer(key) {
+        const timer = this.timers.get(key);
+        if (!timer) {
+            logger.warn(`Timer not found: ${key}`);
+            return 0;
+        }
+        timer.endTime = Date.now();
+        timer.duration = timer.endTime - timer.startTime;
+        this.timers.delete(key);
+        // Record as histogram
+        this.histogram(key, timer.duration);
+        return timer.duration;
+    }
+    /**
+     * Record a histogram value
+     * @param name - Histogram name
+     * @param value - Value to record
+     * @param labels - Histogram labels
+     */
+    histogram(name, value, labels = {}) {
+        if (!this.enabled)
+            return;
+        const key = this.getMetricKey(name, labels);
+        const existing = this.histograms.get(key);
+        if (existing) {
+            existing.push(value);
+        }
+        else {
+            this.histograms.set(key, [value]);
+        }
+    }
+    /**
+     * Get all metrics
+     * @returns Array of all metrics
+     */
+    getMetrics() {
+        return Array.from(this.metrics.values());
+    }
+    /**
+     * Get metrics by name
+     * @param name - Metric name
+     * @returns Array of metrics with the given name
+     */
+    getMetricsByName(name) {
+        return this.getMetrics().filter(m => m.name === name);
+    }
+    /**
+     * Get histogram statistics
+     * @param name - Histogram name
+     * @param labels - Histogram labels
+     * @returns Histogram statistics
+     */
+    getHistogramStats(name, labels = {}) {
+        const key = this.getMetricKey(name, labels);
+        const values = this.histograms.get(key);
+        if (!values || values.length === 0) {
+            return null;
+        }
+        const sorted = [...values].sort((a, b) => a - b);
+        const count = sorted.length;
+        const sum = sorted.reduce((a, b) => a + b, 0);
+        const min = sorted[0];
+        const max = sorted[count - 1];
+        const mean = sum / count;
+        const percentile = (p) => {
+            const index = Math.ceil((p / 100) * count) - 1;
+            return sorted[Math.max(0, index)];
+        };
+        return {
+            count,
+            sum,
+            min,
+            max,
+            mean,
+            p50: percentile(50),
+            p95: percentile(95),
+            p99: percentile(99),
+        };
+    }
+    /**
+     * Clear all metrics
+     */
+    clear() {
+        this.metrics.clear();
+        this.timers.clear();
+        this.histograms.clear();
+    }
+    /**
+     * Export metrics in Prometheus format
+     * @returns Metrics in Prometheus format
+     */
+    exportPrometheus() {
+        const lines = [];
+        for (const metric of this.metrics.values()) {
+            const labels = Object.entries(metric.labels)
+                .map(([k, v]) => `${k}="${v}"`)
+                .join(',');
+            const labelStr = labels ? `{${labels}}` : '';
+            lines.push(`${metric.name}${labelStr} ${metric.value}`);
+        }
+        for (const [key, values] of this.histograms.entries()) {
+            const [name, ...labelParts] = key.split(':');
+            const labels = labelParts.join(':');
+            const stats = this.getHistogramStats(name, labels ? JSON.parse(labels) : {});
+            if (stats) {
+                lines.push(`${name}_count${labels ? `{${labels}}` : ''} ${stats.count}`);
+                lines.push(`${name}_sum${labels ? `{${labels}}` : ''} ${stats.sum}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Export metrics as JSON
+     * @returns Metrics as JSON object
+     */
+    exportJSON() {
+        const result = {
+            counters: {},
+            gauges: {},
+            histograms: {},
+            timestamps: {},
+        };
+        for (const metric of this.metrics.values()) {
+            const key = this.getMetricKey(metric.name, metric.labels);
+            if (metric.type === 'counter') {
+                result.counters[key] = metric.value;
+            }
+            else if (metric.type === 'gauge') {
+                result.gauges[key] = metric.value;
+            }
+            result.timestamps[key] = metric.timestamp;
+        }
+        for (const [key, values] of this.histograms.entries()) {
+            const [name, ...labelParts] = key.split(':');
+            const labels = labelParts.join(':');
+            const stats = this.getHistogramStats(name, labels ? JSON.parse(labels) : {});
+            if (stats) {
+                result.histograms[key] = stats;
+            }
+        }
+        return result;
+    }
+    /**
+     * Generate a metric key from name and labels
+     * @param name - Metric name
+     * @param labels - Metric labels
+     * @returns Metric key
+     */
+    getMetricKey(name, labels) {
+        if (Object.keys(labels).length === 0) {
+            return name;
+        }
+        return `${name}:${JSON.stringify(labels)}`;
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+// Export a singleton instance
+exports.metricsCollector = new MetricsCollector();
+/**
+ * Decorator for timing function execution
+ * @param metricName - The metric name to use
+ * @returns Method decorator
+ */
+function timed(metricName) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const name = metricName || `${target.constructor.name}_${propertyKey}`;
+        descriptor.value = function (...args) {
+            const timerKey = exports.metricsCollector.startTimer(name);
+            try {
+                const result = originalMethod.apply(this, args);
+                if (result instanceof Promise) {
+                    return result.finally(() => {
+                        exports.metricsCollector.endTimer(timerKey);
+                    });
+                }
+                else {
+                    exports.metricsCollector.endTimer(timerKey);
+                    return result;
+                }
+            }
+            catch (error) {
+                exports.metricsCollector.endTimer(timerKey);
+                throw error;
+            }
+        };
+    };
+}
+/**
+ * Track operation metrics
+ * @param operation - Operation name
+ * @param stage - Operation stage
+ * @param fn - Function to track
+ * @returns Function result
+ */
+async function trackOperation(operation, stage, fn) {
+    const timerKey = exports.metricsCollector.startTimer(`operation_${operation}`, { stage });
+    try {
+        const result = await fn();
+        exports.metricsCollector.counter(`operation_${operation}_success`, 1, { stage });
+        return result;
+    }
+    catch (error) {
+        exports.metricsCollector.counter(`operation_${operation}_error`, 1, { stage });
+        throw error;
+    }
+    finally {
+        exports.metricsCollector.endTimer(timerKey);
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

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

package/dist/utils/timer.d.ts

@@ -0,0 +1,7 @@
+export declare class Timer {
+    private start;
+    constructor();
+    elapsed(): number;
+    reset(): void;
+}
+//# sourceMappingURL=timer.d.ts.map

package/dist/utils/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/utils/timer.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAS;;IAMf,OAAO,IAAI,MAAM;IAIjB,KAAK,IAAI,IAAI;CAGrB"}

package/dist/utils/timer.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timer = void 0;
+class Timer {
+    start;
+    constructor() {
+        this.start = Date.now();
+    }
+    elapsed() {
+        return Date.now() - this.start;
+    }
+    reset() {
+        this.start = Date.now();
+    }
+}
+exports.Timer = Timer;
+//# sourceMappingURL=timer.js.map

package/dist/utils/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/utils/timer.ts"],"names":[],"mappings":";;;AAAA,MAAa,KAAK;IACR,KAAK,CAAS;IAEtB;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;IACjC,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;CACF;AAdD,sBAcC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Validation Utility for gthinking v2.0.0
+ * Input sanitization and validation functions
+ */
+import { z } from 'zod';
+/**
+ * Sanitize user input to prevent injection attacks
+ * @param input - The input string to sanitize
+ * @returns Sanitized string
+ */
+export declare function sanitizeInput(input: string): string;
+/**
+ * Sanitize a string for use in shell commands
+ * @param input - The input string to sanitize
+ * @returns Shell-safe string
+ */
+export declare function sanitizeForShell(input: string): string;
+/**
+ * Validate and sanitize an email address
+ * @param email - The email to validate
+ * @returns Validated email or null if invalid
+ */
+export declare function validateEmail(email: string): string | null;
+/**
+ * Validate a URL string
+ * @param url - The URL to validate
+ * @returns True if the URL is valid
+ */
+export declare function isValidURL(url: string): boolean;
+/**
+ * Validate that a string is not empty or whitespace only
+ * @param str - The string to validate
+ * @returns True if the string has content
+ */
+export declare function isNonEmptyString(str: unknown): str is string;
+/**
+ * Validate that a value is a positive integer
+ * @param value - The value to validate
+ * @returns True if the value is a positive integer
+ */
+export declare function isPositiveInteger(value: unknown): value is number;
+/**
+ * Validate that a value is within a range
+ * @param value - The value to validate
+ * @param min - The minimum allowed value
+ * @param max - The maximum allowed value
+ * @returns True if the value is within the range
+ */
+export declare function isInRange(value: number, min: number, max: number): boolean;
+/**
+ * Validate an array has unique elements
+ * @param arr - The array to validate
+ * @returns True if all elements are unique
+ */
+export declare function hasUniqueElements<T>(arr: T[]): boolean;
+/**
+ * Safe JSON parse with error handling
+ * @param json - The JSON string to parse
+ * @returns Parsed object or null if invalid
+ */
+export declare function safeJsonParse<T>(json: string): T | null;
+/**
+ * Safe JSON stringify with error handling
+ * @param obj - The object to stringify
+ * @returns JSON string or null if failed
+ */
+export declare function safeJsonStringify(obj: unknown): string | null;
+/**
+ * Validate schema with detailed error messages
+ * @param schema - The Zod schema to validate against
+ * @param data - The data to validate
+ * @returns Validated data
+ * @throws ValidationError if validation fails
+ */
+export declare function validateSchema<T>(schema: z.ZodType<T>, data: unknown): T;
+/**
+ * Validate schema asynchronously
+ * @param schema - The Zod schema to validate against
+ * @param data - The data to validate
+ * @returns Promise of validated data
+ * @throws ValidationError if validation fails
+ */
+export declare function validateSchemaAsync<T>(schema: z.ZodType<T>, data: unknown): Promise<T>;
+/**
+ * Check if an object has all required properties
+ * @param obj - The object to check
+ * @param requiredProps - The required property names
+ * @returns True if all properties exist
+ */
+export declare function hasRequiredProperties<T extends object>(obj: T, requiredProps: (keyof T)[]): boolean;
+/**
+ * Validate that a string length is within bounds
+ * @param str - The string to validate
+ * @param min - Minimum length (inclusive)
+ * @param max - Maximum length (inclusive)
+ * @returns True if the string length is valid
+ */
+export declare function isValidLength(str: string, min: number, max: number): boolean;
+/**
+ * Remove null and undefined values from an object
+ * @param obj - The object to clean
+ * @returns Object with null/undefined values removed
+ */
+export declare function removeNullValues<T extends object>(obj: T): Partial<T>;
+/**
+ * Deep clone an object
+ * @param obj - The object to clone
+ * @returns Deep cloned object
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Check if a value is a plain object
+ * @param value - The value to check
+ * @returns True if the value is a plain object
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Rate limiter for validation attempts
+ */
+export declare class ValidationRateLimiter {
+    private attempts;
+    private readonly maxAttempts;
+    private readonly windowMs;
+    constructor(maxAttempts?: number, windowMs?: number);
+    /**
+     * Check if a key is rate limited
+     * @param key - The key to check
+     * @returns True if the key is rate limited
+     */
+    isRateLimited(key: string): boolean;
+    /**
+     * Record an attempt for a key
+     * @param key - The key to record
+     */
+    recordAttempt(key: string): void;
+    /**
+     * Reset attempts for a key
+     * @param key - The key to reset
+     */
+    reset(key: string): void;
+    /**
+     * Clear all attempts
+     */
+    clear(): void;
+}
+export declare const validationRateLimiter: ValidationRateLimiter;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

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