stelo 1.0.1

package/dist/telemetry.js

@@ -0,0 +1,433 @@
+"use strict";
+// ============================================================================
+// Stelo — Telemetry & Observability
+// ============================================================================
+// Enterprise-grade monitoring, metrics, and event hooks for production systems.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.telemetry = void 0;
+exports.getCircuitBreakers = getCircuitBreakers;
+// Internal state
+let telemetryEnabled = false;
+let metricsEnabled = false;
+const eventHandlers = [];
+const metricsHandlers = [];
+const operationTimings = [];
+const startTime = Date.now();
+let totalOps = 0;
+let successOps = 0;
+let failureOps = 0;
+/**
+ * Generate a unique event ID
+ */
+function generateEventId() {
+    return `ax-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/**
+ * Telemetry system for enterprise observability
+ *
+ * @example
+ * ```typescript
+ * import { telemetry } from 'stelo';
+ *
+ * // Enable telemetry
+ * telemetry.enable();
+ *
+ * // Subscribe to events
+ * telemetry.onEvent((event) => {
+ *   console.log(`[${event.severity}] ${event.operation}: ${event.success}`);
+ * });
+ *
+ * // Get performance metrics
+ * const metrics = telemetry.getMetrics();
+ * console.log(`Ops/sec: ${metrics.opsPerSecond}`);
+ *
+ * // Run health checks
+ * const health = await telemetry.healthCheck();
+ * console.log(`System status: ${health.status}`);
+ * ```
+ */
+exports.telemetry = {
+    /**
+     * Enable telemetry collection
+     */
+    enable() {
+        telemetryEnabled = true;
+    },
+    /**
+     * Disable telemetry collection
+     */
+    disable() {
+        telemetryEnabled = false;
+    },
+    /**
+     * Check if telemetry is enabled
+     */
+    isEnabled() {
+        return telemetryEnabled;
+    },
+    /**
+     * Enable metrics collection
+     */
+    enableMetrics() {
+        metricsEnabled = true;
+    },
+    /**
+     * Disable metrics collection
+     */
+    disableMetrics() {
+        metricsEnabled = false;
+    },
+    /**
+     * Subscribe to telemetry events
+     */
+    onEvent(handler) {
+        eventHandlers.push(handler);
+        return () => {
+            const idx = eventHandlers.indexOf(handler);
+            if (idx >= 0)
+                eventHandlers.splice(idx, 1);
+        };
+    },
+    /**
+     * Subscribe to periodic metrics updates
+     */
+    onMetrics(handler) {
+        metricsHandlers.push(handler);
+        return () => {
+            const idx = metricsHandlers.indexOf(handler);
+            if (idx >= 0)
+                metricsHandlers.splice(idx, 1);
+        };
+    },
+    /**
+     * Emit a telemetry event
+     * @internal Used by Stelo internals
+     */
+    emit(category, operation, success, options) {
+        if (!telemetryEnabled && !metricsEnabled)
+            return;
+        totalOps++;
+        if (success) {
+            successOps++;
+        }
+        else {
+            failureOps++;
+        }
+        if (options?.durationMs !== undefined) {
+            operationTimings.push(options.durationMs);
+            // Keep only last 1000 timings for percentile calculations
+            if (operationTimings.length > 1000) {
+                operationTimings.shift();
+            }
+        }
+        if (!telemetryEnabled)
+            return;
+        const event = {
+            id: generateEventId(),
+            timestamp: new Date().toISOString(),
+            severity: options?.severity ?? (success ? 'info' : 'error'),
+            category,
+            operation,
+            success,
+            durationMs: options?.durationMs,
+            error: options?.error,
+            metadata: options?.metadata,
+        };
+        for (const handler of eventHandlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // Telemetry handlers should not throw
+            }
+        }
+    },
+    /**
+     * Get current performance metrics
+     */
+    getMetrics() {
+        const sorted = [...operationTimings].sort((a, b) => a - b);
+        const avgDuration = sorted.length > 0
+            ? sorted.reduce((a, b) => a + b, 0) / sorted.length
+            : 0;
+        const p95Idx = Math.floor(sorted.length * 0.95);
+        const p99Idx = Math.floor(sorted.length * 0.99);
+        const uptimeMs = Date.now() - startTime;
+        const opsPerSecond = uptimeMs > 0 ? (totalOps / uptimeMs) * 1000 : 0;
+        return {
+            totalOperations: totalOps,
+            successCount: successOps,
+            failureCount: failureOps,
+            avgDurationMs: Math.round(avgDuration * 100) / 100,
+            p95DurationMs: sorted[p95Idx] ?? 0,
+            p99DurationMs: sorted[p99Idx] ?? 0,
+            opsPerSecond: Math.round(opsPerSecond * 100) / 100,
+            activeCircuitBreakers: circuitBreakers
+                .filter((cb) => cb.isOpen())
+                .map((cb) => cb.name),
+            uptimeMs,
+        };
+    },
+    /**
+     * Run system health checks
+     */
+    async healthCheck() {
+        const checks = [];
+        const native = require('../index.js');
+        // Check 1: Native bindings available
+        const bindingStart = performance.now();
+        try {
+            const platform = native.getPlatform();
+            checks.push({
+                name: 'native_bindings',
+                status: platform ? 'pass' : 'fail',
+                message: `Platform: ${platform}`,
+                durationMs: Math.round(performance.now() - bindingStart),
+            });
+        }
+        catch (e) {
+            checks.push({
+                name: 'native_bindings',
+                status: 'fail',
+                message: e instanceof Error ? e.message : 'Unknown error',
+                durationMs: Math.round(performance.now() - bindingStart),
+            });
+        }
+        // Check 2: Screen capture available
+        const screenStart = performance.now();
+        try {
+            const size = native.screenGetSize();
+            checks.push({
+                name: 'screen_capture',
+                status: size.width > 0 ? 'pass' : 'warn',
+                message: `Screen: ${size.width}x${size.height}`,
+                durationMs: Math.round(performance.now() - screenStart),
+            });
+        }
+        catch (e) {
+            checks.push({
+                name: 'screen_capture',
+                status: 'fail',
+                message: e instanceof Error ? e.message : 'Unknown error',
+                durationMs: Math.round(performance.now() - screenStart),
+            });
+        }
+        // Check 3: Mouse access
+        const mouseStart = performance.now();
+        try {
+            const pos = native.mouseGetPosition();
+            checks.push({
+                name: 'mouse_access',
+                status: 'pass',
+                message: `Position: ${pos.x}, ${pos.y}`,
+                durationMs: Math.round(performance.now() - mouseStart),
+            });
+        }
+        catch (e) {
+            checks.push({
+                name: 'mouse_access',
+                status: 'fail',
+                message: e instanceof Error ? e.message : 'Unknown error',
+                durationMs: Math.round(performance.now() - mouseStart),
+            });
+        }
+        // Check 4: Safety system
+        const safetyStart = performance.now();
+        try {
+            const stopped = native.safetyIsStopped();
+            checks.push({
+                name: 'safety_system',
+                status: stopped ? 'warn' : 'pass',
+                message: stopped ? 'Emergency stop active' : 'Operational',
+                durationMs: Math.round(performance.now() - safetyStart),
+            });
+        }
+        catch (e) {
+            checks.push({
+                name: 'safety_system',
+                status: 'fail',
+                message: e instanceof Error ? e.message : 'Unknown error',
+                durationMs: Math.round(performance.now() - safetyStart),
+            });
+        }
+        // Check 5: Error rate
+        const errorRate = totalOps > 0 ? failureOps / totalOps : 0;
+        checks.push({
+            name: 'error_rate',
+            status: errorRate > 0.1 ? 'fail' : errorRate > 0.01 ? 'warn' : 'pass',
+            message: `${(errorRate * 100).toFixed(2)}% failure rate`,
+            durationMs: 0,
+        });
+        // Determine overall status
+        const hasFailure = checks.some((c) => c.status === 'fail');
+        const hasWarn = checks.some((c) => c.status === 'warn');
+        return {
+            status: hasFailure ? 'unhealthy' : hasWarn ? 'degraded' : 'healthy',
+            checks,
+            timestamp: new Date().toISOString(),
+        };
+    },
+    /**
+     * Reset all metrics
+     */
+    resetMetrics() {
+        totalOps = 0;
+        successOps = 0;
+        failureOps = 0;
+        operationTimings.length = 0;
+    },
+    /**
+     * Wrap an operation with telemetry tracking
+     */
+    track(category, operation, fn, metadata) {
+        const start = performance.now();
+        try {
+            const result = fn();
+            const durationMs = performance.now() - start;
+            this.emit(category, operation, true, { durationMs, metadata });
+            return result;
+        }
+        catch (e) {
+            const durationMs = performance.now() - start;
+            const error = e instanceof Error ? e : new Error(String(e));
+            this.emit(category, operation, false, {
+                durationMs,
+                error: {
+                    code: 'OPERATION_FAILED',
+                    message: error.message,
+                    recoverable: true,
+                },
+                metadata,
+            });
+            throw e;
+        }
+    },
+    /**
+     * Wrap an async operation with telemetry tracking
+     */
+    async trackAsync(category, operation, fn, metadata) {
+        const start = performance.now();
+        try {
+            const result = await fn();
+            const durationMs = performance.now() - start;
+            this.emit(category, operation, true, { durationMs, metadata });
+            return result;
+        }
+        catch (e) {
+            const durationMs = performance.now() - start;
+            const error = e instanceof Error ? e : new Error(String(e));
+            this.emit(category, operation, false, {
+                durationMs,
+                error: {
+                    code: 'OPERATION_FAILED',
+                    message: error.message,
+                    recoverable: true,
+                },
+                metadata,
+            });
+            throw e;
+        }
+    },
+};
+/**
+ * Circuit breaker for fault tolerance
+ */
+class CircuitBreaker {
+    name;
+    state = 'closed';
+    failureCount = 0;
+    successCount = 0;
+    lastFailureTime = 0;
+    failureThreshold;
+    resetTimeoutMs;
+    successThreshold;
+    constructor(name, options) {
+        this.name = name;
+        this.failureThreshold = options?.failureThreshold ?? 5;
+        this.resetTimeoutMs = options?.resetTimeoutMs ?? 30_000;
+        this.successThreshold = options?.successThreshold ?? 2;
+        circuitBreakers.push(this);
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        if (this.state === 'open') {
+            if (Date.now() - this.lastFailureTime >= this.resetTimeoutMs) {
+                this.state = 'half-open';
+                this.successCount = 0;
+            }
+        }
+        return this.state;
+    }
+    /**
+     * Check if circuit is open (blocking)
+     */
+    isOpen() {
+        return this.getState() === 'open';
+    }
+    /**
+     * Record a successful operation
+     */
+    recordSuccess() {
+        if (this.getState() === 'half-open') {
+            this.successCount++;
+            if (this.successCount >= this.successThreshold) {
+                this.state = 'closed';
+                this.failureCount = 0;
+            }
+        }
+        else if (this.state === 'closed') {
+            this.failureCount = 0;
+        }
+    }
+    /**
+     * Record a failed operation
+     */
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureTime = Date.now();
+        if (this.getState() === 'half-open') {
+            this.state = 'open';
+        }
+        else if (this.failureCount >= this.failureThreshold) {
+            this.state = 'open';
+        }
+    }
+    /**
+     * Execute an operation with circuit breaker protection
+     */
+    async execute(fn) {
+        if (this.isOpen()) {
+            throw new Error(`Circuit breaker '${this.name}' is open`);
+        }
+        try {
+            const result = await fn();
+            this.recordSuccess();
+            return result;
+        }
+        catch (e) {
+            this.recordFailure();
+            throw e;
+        }
+    }
+    /**
+     * Force reset the circuit breaker
+     */
+    reset() {
+        this.state = 'closed';
+        this.failureCount = 0;
+        this.successCount = 0;
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+// Global registry of circuit breakers
+const circuitBreakers = [];
+/**
+ * Get all registered circuit breakers
+ */
+function getCircuitBreakers() {
+    return [...circuitBreakers];
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+/** Mouse button identifiers */
+export type MouseButton = 'left' | 'right' | 'middle';
+/** Scroll direction */
+export type ScrollDirection = 'up' | 'down' | 'left' | 'right';
+/** Movement curve types for smooth mouse movement */
+export type CurveType = 'linear' | 'bezier' | 'ease-in-out' | 'ease-in' | 'ease-out' | 'humanized';
+/** 2D point with integer coordinates */
+export interface Point {
+    x: number;
+    y: number;
+}
+/** Screen/display dimensions */
+export interface ScreenSize {
+    width: number;
+    height: number;
+}
+/** RGB pixel color */
+export interface PixelColor {
+    r: number;
+    g: number;
+    b: number;
+    hex: string;
+}
+/** Display/monitor information */
+export interface DisplayInfo {
+    id: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    isPrimary: boolean;
+    scaleFactor: number;
+    name: string;
+}
+/** Window information */
+export interface WindowInfo {
+    id: number;
+    title: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    isVisible: boolean;
+    isMinimized: boolean;
+    processId: number;
+    processName: string;
+    processPath: string;
+}
+/** Screen capture result */
+export interface ScreenCapture {
+    /** Raw RGBA pixel data */
+    data: Buffer;
+    width: number;
+    height: number;
+}
+/** Rectangular region */
+export interface Region {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Options for smooth mouse movement */
+export interface SmoothMoveOptions {
+    /** Duration in milliseconds (default: 500) */
+    duration?: number;
+    /** Interpolation curve type (default: 'bezier') */
+    curve?: CurveType;
+    /** Steps per second — higher = smoother (default: 120) */
+    stepsPerSecond?: number;
+}
+/** Options for humanized mouse movement */
+export interface HumanizedMoveOptions {
+    /** Duration in milliseconds (default: 800) */
+    duration?: number;
+    /** Random deviation amount 0.0–1.0 (default: 0.5) */
+    jitter?: number;
+    /** Enable overshoot and correction (default: true) */
+    overshoot?: boolean;
+}
+/** Options for text typing */
+export interface TypeOptions {
+    /** Delay between characters in ms (default: 20) */
+    delay?: number;
+}
+/** Options for humanized typing */
+export interface HumanizedTypeOptions {
+    /** Minimum delay between characters in ms (default: 30) */
+    minDelay?: number;
+    /** Maximum delay between characters in ms (default: 120) */
+    maxDelay?: number;
+}
+/** Options for dragging */
+export interface DragOptions {
+    /** Mouse button to use (default: 'left') */
+    button?: MouseButton;
+    /** Duration of the drag movement in ms (default: 500) */
+    duration?: number;
+}
+/** Automation event for recording/playback */
+export type AutomationEvent = {
+    type: 'mouseMove';
+    x: number;
+    y: number;
+    timestamp: number;
+} | {
+    type: 'mouseClick';
+    button: MouseButton;
+    x: number;
+    y: number;
+    timestamp: number;
+} | {
+    type: 'mouseDown';
+    button: MouseButton;
+    x: number;
+    y: number;
+    timestamp: number;
+} | {
+    type: 'mouseUp';
+    button: MouseButton;
+    x: number;
+    y: number;
+    timestamp: number;
+} | {
+    type: 'mouseScroll';
+    amount: number;
+    direction: ScrollDirection;
+    timestamp: number;
+} | {
+    type: 'keyPress';
+    key: string;
+    timestamp: number;
+} | {
+    type: 'keyDown';
+    key: string;
+    timestamp: number;
+} | {
+    type: 'keyUp';
+    key: string;
+    timestamp: number;
+} | {
+    type: 'typeText';
+    text: string;
+    timestamp: number;
+} | {
+    type: 'delay';
+    duration: number;
+};
+/** Recording playback options */
+export interface PlaybackOptions {
+    /** Playback speed multiplier (default: 1.0) */
+    speed?: number;
+    /** Number of times to replay (default: 1) */
+    repeat?: number;
+}
+/** Safety configuration */
+export interface SafetyConfig {
+    /** Enable failsafe corners (default: true) */
+    failsafe?: boolean;
+    /** Failsafe corner threshold in pixels (default: 5) */
+    failsafeThreshold?: number;
+    /** Maximum actions per second (0 = unlimited) */
+    rateLimit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============================================================================
+// Stelo — TypeScript Type Definitions
+// ============================================================================
+// All public types for the Stelo automation framework.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E"}

package/dist/utils/bezier.d.ts

@@ -0,0 +1,51 @@
+export interface BezierPoint {
+    x: number;
+    y: number;
+}
+export interface CubicBezierOptions {
+    /** Number of sample points along the curve (default: 100) */
+    steps?: number;
+}
+/**
+ * Pure-TypeScript bezier curve utilities for path planning, easing, and
+ * visualization. These complement the native Rust bezier implementation
+ * used for actual mouse movement.
+ */
+export declare const bezier: {
+    /**
+     * Evaluate a cubic bezier curve at parameter t ∈ [0, 1].
+     */
+    cubic(p0: BezierPoint, p1: BezierPoint, p2: BezierPoint, p3: BezierPoint, t: number): BezierPoint;
+    /**
+     * Evaluate a quadratic bezier curve at parameter t ∈ [0, 1].
+     */
+    quadratic(p0: BezierPoint, p1: BezierPoint, p2: BezierPoint, t: number): BezierPoint;
+    /**
+     * Sample a cubic bezier curve and return an array of evenly-spaced points.
+     */
+    sampleCubic(p0: BezierPoint, p1: BezierPoint, p2: BezierPoint, p3: BezierPoint, options?: CubicBezierOptions): BezierPoint[];
+    /**
+     * Compute the approximate arc length of a cubic bezier by summing segment distances.
+     */
+    arcLength(p0: BezierPoint, p1: BezierPoint, p2: BezierPoint, p3: BezierPoint, samples?: number): number;
+    /**
+     * Generate random control points for a cubic bezier between two endpoints.
+     * Useful for creating natural-looking mouse movement curves.
+     */
+    randomControlPoints(start: BezierPoint, end: BezierPoint, spread?: number): {
+        p1: BezierPoint;
+        p2: BezierPoint;
+    };
+    /**
+     * Standard CSS-style cubic-bezier easing function.
+     * Returns y for a given x ∈ [0, 1] using Newton's method.
+     */
+    cssEasing(x1: number, y1: number, x2: number, y2: number, t: number): number;
+    /** Predefined easing: ease-in */
+    easeIn(t: number): number;
+    /** Predefined easing: ease-out */
+    easeOut(t: number): number;
+    /** Predefined easing: ease-in-out */
+    easeInOut(t: number): number;
+};
+//# sourceMappingURL=bezier.d.ts.map