@ggakila/agentx-framework 0.1.0

package/dist/security/SecurityManager.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Security Manager
+ * Provides comprehensive security features for production
+ */
+import { Logger } from '../types/tool';
+/**
+ * Input Validator
+ * Validates and sanitizes user input
+ */
+export declare class InputValidator {
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Sanitize string input
+     */
+    sanitizeString(input: string, options?: {
+        maxLength?: number;
+        allowHtml?: boolean;
+        allowNewlines?: boolean;
+    }): string;
+    /**
+     * Validate email format
+     */
+    isValidEmail(email: string): boolean;
+    /**
+     * Validate URL format
+     */
+    isValidUrl(url: string, options?: {
+        allowedProtocols?: string[];
+        requireHttps?: boolean;
+    }): boolean;
+    /**
+     * Validate JSON schema
+     */
+    validateSchema(data: unknown, schema: Record<string, unknown>): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Escape SQL special characters
+     */
+    escapeSql(input: string): string;
+    /**
+     * Escape shell special characters
+     */
+    escapeShell(input: string): string;
+}
+/**
+ * Role-Based Access Control (RBAC)
+ */
+export interface Role {
+    name: string;
+    permissions: string[];
+    inherits?: string[];
+}
+export interface User {
+    id: string;
+    roles: string[];
+    metadata?: Record<string, unknown>;
+}
+export declare class RBACManager {
+    private roles;
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Define a role
+     */
+    defineRole(role: Role): void;
+    /**
+     * Get all permissions for a role (including inherited)
+     */
+    getRolePermissions(roleName: string, visited?: Set<string>): string[];
+    /**
+     * Check if user has permission
+     */
+    hasPermission(user: User, permission: string): boolean;
+    /**
+     * Get all permissions for a user
+     */
+    getUserPermissions(user: User): string[];
+    /**
+     * List all defined roles
+     */
+    listRoles(): Role[];
+}
+/**
+ * Security Audit Logger
+ */
+export interface AuditEvent {
+    id: string;
+    timestamp: Date;
+    type: string;
+    userId?: string;
+    action: string;
+    resource?: string;
+    details?: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+    success: boolean;
+    error?: string;
+}
+export declare class AuditLogger {
+    private events;
+    private logger;
+    private maxEvents;
+    constructor(logger: Logger, maxEvents?: number);
+    /**
+     * Log an audit event
+     */
+    log(event: Omit<AuditEvent, 'id' | 'timestamp'>): void;
+    /**
+     * Query audit events
+     */
+    query(filter: {
+        type?: string;
+        userId?: string;
+        action?: string;
+        startTime?: Date;
+        endTime?: Date;
+        success?: boolean;
+        limit?: number;
+    }): AuditEvent[];
+    /**
+     * Get recent events
+     */
+    getRecent(count?: number): AuditEvent[];
+    /**
+     * Clear all events
+     */
+    clear(): void;
+}
+/**
+ * Rate Limiter
+ */
+export interface RateLimitConfig {
+    windowMs: number;
+    maxRequests: number;
+}
+export declare class RateLimiter {
+    private requests;
+    private config;
+    private logger;
+    constructor(config: RateLimitConfig, logger: Logger);
+    /**
+     * Check if request is allowed
+     */
+    isAllowed(key: string): boolean;
+    /**
+     * Get remaining requests for a key
+     */
+    getRemaining(key: string): number;
+    /**
+     * Get time until reset for a key
+     */
+    getResetTime(key: string): number;
+    /**
+     * Reset rate limit for a key
+     */
+    reset(key: string): void;
+    /**
+     * Clear all rate limits
+     */
+    clear(): void;
+}
+/**
+ * Circuit Breaker
+ */
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeout: number;
+    halfOpenRequests: number;
+}
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private lastFailureTime?;
+    private config;
+    private logger;
+    constructor(config: CircuitBreakerConfig, logger: Logger);
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Record a success
+     */
+    private onSuccess;
+    /**
+     * Record a failure
+     */
+    private onFailure;
+    /**
+     * Get current state
+     */
+    getState(): CircuitState;
+    /**
+     * Force reset the circuit breaker
+     */
+    reset(): void;
+}
+/**
+ * Health Check Manager
+ */
+export interface HealthCheck {
+    name: string;
+    check: () => Promise<boolean>;
+    critical?: boolean;
+}
+export interface HealthStatus {
+    healthy: boolean;
+    checks: Record<string, {
+        healthy: boolean;
+        latency: number;
+        error?: string;
+    }>;
+    timestamp: Date;
+}
+export declare class HealthCheckManager {
+    private checks;
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Register a health check
+     */
+    register(check: HealthCheck): void;
+    /**
+     * Unregister a health check
+     */
+    unregister(name: string): void;
+    /**
+     * Run all health checks
+     */
+    check(): Promise<HealthStatus>;
+    /**
+     * Check if system is ready
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Check if system is alive (basic liveness)
+     */
+    isAlive(): boolean;
+}
+//# sourceMappingURL=SecurityManager.d.ts.map

package/dist/security/SecurityManager.d.ts.map

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