stringray-ai 1.0.0

package/dist/utils/import-resolver.js

@@ -0,0 +1,198 @@
+/**
+ * Import Resolver Utility
+ * Dynamically resolves module imports across different environments
+ *
+ * This solves the systemic path resolution issue where hardcoded paths
+ * break between development, built, and deployed environments.
+ */
+import { fileURLToPath } from "url";
+import { dirname, join, resolve } from "path";
+export class ImportResolver {
+    static instance;
+    currentDir;
+    projectRoot;
+    isDevelopment;
+    isBuilt;
+    isInstalled;
+    isTesting;
+    constructor() {
+        this.currentDir = this.getCurrentDirectory();
+        this.projectRoot = this.findProjectRoot();
+        this.isDevelopment = this.detectDevelopment();
+        this.isBuilt = this.detectBuilt();
+        this.isInstalled = this.detectInstalled();
+        this.isTesting = this.detectTesting();
+    }
+    static getInstance() {
+        if (!ImportResolver.instance) {
+            ImportResolver.instance = new ImportResolver();
+        }
+        return ImportResolver.instance;
+    }
+    getCurrentDirectory() {
+        try {
+            const currentFile = fileURLToPath(import.meta.url);
+            return dirname(currentFile);
+        }
+        catch (error) {
+            return process.cwd();
+        }
+    }
+    findProjectRoot() {
+        let dir = this.currentDir;
+        const maxDepth = 10;
+        for (let i = 0; i < maxDepth; i++) {
+            if (this.fileExists(join(dir, "package.json"))) {
+                return dir;
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break; // Reached root
+            dir = parent;
+        }
+        return process.cwd(); // Fallback
+    }
+    fileExists(filePath) {
+        try {
+            require.resolve(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    detectDevelopment() {
+        return (this.currentDir.includes("/src/") ||
+            this.currentDir.includes("\\src\\") ||
+            process.env.NODE_ENV === "development" ||
+            this.fileExists(join(this.projectRoot, "tsconfig.json")));
+    }
+    detectBuilt() {
+        return (this.currentDir.includes("/dist/") ||
+            this.currentDir.includes("\\dist\\") ||
+            this.currentDir.includes("node_modules") ||
+            !this.fileExists(join(this.projectRoot, "src")));
+    }
+    detectInstalled() {
+        return (this.currentDir.includes("/node_modules/") ||
+            this.currentDir.includes("\\node_modules\\") ||
+            (this.currentDir.includes("strray") &&
+                !this.currentDir.includes(this.projectRoot)));
+    }
+    detectTesting() {
+        return (process.env.NODE_ENV === "test" ||
+            process.env.VITEST === "true" ||
+            this.currentDir.includes("/__tests__/") ||
+            this.currentDir.includes("\\__tests__\\"));
+    }
+    /**
+     * Resolve module import path for any module
+     */
+    resolveModulePath(moduleName, subPath = "") {
+        const fullModuleName = subPath ? `${subPath}/${moduleName}` : moduleName;
+        if (this.isTesting) {
+            // In tests, prefer built versions to avoid import issues
+            return `../dist/plugin/${fullModuleName}.js`;
+        }
+        else if (this.isDevelopment) {
+            // In development, use source files
+            return `../src/${fullModuleName}.ts`;
+        }
+        else if (this.isBuilt || this.isInstalled) {
+            // In built/deployed environments, use compiled files
+            return `../dist/plugin/${fullModuleName}.js`;
+        }
+        else {
+            // Fallback - try built first, then source
+            return `../dist/plugin/${fullModuleName}.js`;
+        }
+    }
+    /**
+     * Resolve agent import path (special case for agents)
+     */
+    resolveAgentPath(agentName) {
+        if (this.isDevelopment) {
+            return `./agents/${agentName}.js`;
+        }
+        else if (this.isBuilt || this.isInstalled) {
+            return `../agents/${agentName}.js`;
+        }
+        else {
+            return `../agents/${agentName}.js`;
+        }
+    }
+    /**
+     * Dynamic import with comprehensive environment resolution
+     */
+    async importModule(moduleName, subPath = "") {
+        const primaryPath = this.resolveModulePath(moduleName, subPath);
+        // Try primary path first
+        try {
+            console.log(`🔗 Importing ${moduleName} from: ${primaryPath}`);
+            return await import(primaryPath);
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to import ${moduleName} from primary path: ${primaryPath}`);
+            // Try alternative paths based on environment
+            const altPaths = this.generateAlternativePaths(moduleName, subPath);
+            for (const altPath of altPaths) {
+                try {
+                    console.log(`🔄 Trying alternative path: ${altPath}`);
+                    return await import(altPath);
+                }
+                catch (altError) {
+                    continue;
+                }
+            }
+            // Final fallback - try to resolve from project root
+            try {
+                const rootPath = join(this.projectRoot, "dist/plugin", subPath, `${moduleName}.js`);
+                console.log(`🏠 Trying project root path: ${rootPath}`);
+                return await import(rootPath);
+            }
+            catch (rootError) {
+                throw new Error(`Cannot import module ${moduleName} from any path. Primary: ${primaryPath}, Alternatives tried: ${altPaths.length}`);
+            }
+        }
+    }
+    /**
+     * Generate alternative import paths for fallback
+     */
+    generateAlternativePaths(moduleName, subPath) {
+        const fullModuleName = subPath ? `${subPath}/${moduleName}` : moduleName;
+        const paths = [];
+        if (this.isDevelopment) {
+            // Development alternatives
+            paths.push(`../dist/plugin/${fullModuleName}.js`, `../src/${fullModuleName}.ts`, `./${fullModuleName}.ts`, `../dist/${fullModuleName}.js`);
+        }
+        else {
+            // Built/deployed alternatives
+            paths.push(`../src/${fullModuleName}.ts`, `../dist/plugin/${fullModuleName}.js`, `./${fullModuleName}.js`, `../dist/${fullModuleName}.js`);
+        }
+        // Add absolute paths as last resort
+        try {
+            const absPath = resolve(this.projectRoot, "dist/plugin", subPath, `${moduleName}.js`);
+            paths.push(absPath);
+        }
+        catch {
+            // Ignore absolute path generation errors
+        }
+        return [...new Set(paths)]; // Remove duplicates
+    }
+    /**
+     * Get comprehensive environment information
+     */
+    getEnvironmentInfo() {
+        return {
+            currentDir: this.currentDir,
+            projectRoot: this.projectRoot,
+            isDevelopment: this.isDevelopment,
+            isBuilt: this.isBuilt,
+            isInstalled: this.isInstalled,
+            isTesting: this.isTesting,
+            nodeEnv: process.env.NODE_ENV,
+        };
+    }
+}
+export const importResolver = ImportResolver.getInstance();
+//# sourceMappingURL=import-resolver.js.map

package/dist/utils/import-resolver.js.map

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

package/dist/utils/memory-pool.d.ts

@@ -0,0 +1,90 @@
+import { EventEmitter } from "events";
+/**
+ * Memory Pool System - Reusable object pooling to reduce GC pressure
+ * Implements efficient object reuse for frequently allocated objects
+ */
+export interface MemoryPoolConfig {
+    maxSize: number;
+    factory: () => any;
+    reset?: ((obj: any) => void) | undefined;
+    validate?: (obj: any) => boolean;
+}
+export interface PoolMetrics {
+    name: string;
+    allocated: number;
+    available: number;
+    totalCreated: number;
+    hitRate: number;
+    averageUsage: number;
+}
+export declare class MemoryPool<T = any> extends EventEmitter {
+    private available;
+    private created;
+    private totalRequests;
+    private cacheHits;
+    private config;
+    constructor(config: MemoryPoolConfig);
+    /**
+     * Get an object from the pool or create a new one
+     */
+    get(): T;
+    /**
+     * Return an object to the pool for reuse
+     */
+    release(obj: T): void;
+    /**
+     * Create a new object using the factory
+     */
+    private createNew;
+    /**
+     * Get pool metrics and statistics
+     */
+    getMetrics(): PoolMetrics;
+    /**
+     * Clear all objects from the pool
+     */
+    clear(): void;
+    /**
+     * Get current pool status
+     */
+    getStatus(): {
+        available: number;
+        created: number;
+        maxSize: number;
+        utilization: number;
+    };
+}
+/**
+ * Global Memory Pool Manager
+ * Manages multiple memory pools and provides optimization recommendations
+ */
+export declare class MemoryPoolManager extends EventEmitter {
+    private pools;
+    private monitoringInterval;
+    constructor();
+    /**
+     * Create or get a memory pool
+     */
+    getPool<T>(name: string, config: MemoryPoolConfig): MemoryPool<T>;
+    /**
+     * Get metrics for all pools
+     */
+    getAllMetrics(): Record<string, PoolMetrics>;
+    /**
+     * Get optimization recommendations
+     */
+    getOptimizationRecommendations(): string[];
+    /**
+     * Start monitoring pools and emitting metrics
+     */
+    private startMonitoring;
+    /**
+     * Stop monitoring and clear all pools
+     */
+    stop(): void;
+}
+export declare const memoryPoolManager: MemoryPoolManager;
+export declare function createSessionPool(maxSize?: number): MemoryPool<any>;
+export declare function createMetricsPool(maxSize?: number): MemoryPool<any>;
+export declare function createAlertPool(maxSize?: number): MemoryPool<any>;
+//# sourceMappingURL=memory-pool.d.ts.map

package/dist/utils/memory-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-pool.d.ts","sourceRoot":"","sources":["../../src/utils/memory-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY;IACnD,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAKpC;;OAEG;IACH,GAAG,IAAI,CAAC;IAmBR;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAmBrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,UAAU,IAAI,WAAW;IAezB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,SAAS;;;;;;CAWV;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,kBAAkB,CAA+B;;IAOzD;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC;IAiBjE;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAU5C;;OAEG;IACH,8BAA8B,IAAI,MAAM,EAAE;IA8B1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,IAAI,IAAI,IAAI;CAYb;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAGzD,wBAAgB,iBAAiB,CAAC,OAAO,SAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAkBhE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,SAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAgBhE;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAoB7D"}

package/dist/utils/memory-pool.js

@@ -0,0 +1,245 @@
+import { EventEmitter } from "events";
+export class MemoryPool extends EventEmitter {
+    available = [];
+    created = 0;
+    totalRequests = 0;
+    cacheHits = 0;
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Get an object from the pool or create a new one
+     */
+    get() {
+        this.totalRequests++;
+        if (this.available.length > 0) {
+            this.cacheHits++;
+            const obj = this.available.pop();
+            // Validate object if validator provided
+            if (this.config.validate && !this.config.validate(obj)) {
+                // Object is invalid, create new one
+                return this.createNew();
+            }
+            return obj;
+        }
+        return this.createNew();
+    }
+    /**
+     * Return an object to the pool for reuse
+     */
+    release(obj) {
+        if (!obj)
+            return;
+        // Reset object if reset function provided
+        if (this.config.reset) {
+            try {
+                this.config.reset(obj);
+            }
+            catch (error) {
+                // Reset failed, don't reuse this object
+                return;
+            }
+        }
+        // Only keep if under max size
+        if (this.available.length < this.config.maxSize) {
+            this.available.push(obj);
+        }
+    }
+    /**
+     * Create a new object using the factory
+     */
+    createNew() {
+        this.created++;
+        const obj = this.config.factory();
+        this.emit("objectCreated", {
+            pool: this,
+            object: obj,
+            totalCreated: this.created,
+        });
+        return obj;
+    }
+    /**
+     * Get pool metrics and statistics
+     */
+    getMetrics() {
+        const hitRate = this.totalRequests > 0 ? this.cacheHits / this.totalRequests : 0;
+        return {
+            name: "memoryPool",
+            allocated: this.created - this.available.length,
+            available: this.available.length,
+            totalCreated: this.created,
+            hitRate,
+            averageUsage: this.totalRequests > 0 ? this.created / this.totalRequests : 0,
+        };
+    }
+    /**
+     * Clear all objects from the pool
+     */
+    clear() {
+        this.available = [];
+        this.emit("poolCleared", { pool: this });
+    }
+    /**
+     * Get current pool status
+     */
+    getStatus() {
+        return {
+            available: this.available.length,
+            created: this.created,
+            maxSize: this.config.maxSize,
+            utilization: this.created > 0
+                ? (this.created - this.available.length) / this.created
+                : 0,
+        };
+    }
+}
+/**
+ * Global Memory Pool Manager
+ * Manages multiple memory pools and provides optimization recommendations
+ */
+export class MemoryPoolManager extends EventEmitter {
+    pools = new Map();
+    monitoringInterval = null;
+    constructor() {
+        super();
+        this.startMonitoring();
+    }
+    /**
+     * Create or get a memory pool
+     */
+    getPool(name, config) {
+        if (!this.pools.has(name)) {
+            const pool = new MemoryPool(config);
+            this.pools.set(name, pool);
+            pool.on("objectCreated", (data) => {
+                this.emit("poolObjectCreated", { poolName: name, ...data });
+            });
+            pool.on("poolCleared", (data) => {
+                this.emit("poolCleared", { poolName: name, ...data });
+            });
+        }
+        return this.pools.get(name);
+    }
+    /**
+     * Get metrics for all pools
+     */
+    getAllMetrics() {
+        const metrics = {};
+        for (const [name, pool] of this.pools) {
+            metrics[name] = pool.getMetrics();
+        }
+        return metrics;
+    }
+    /**
+     * Get optimization recommendations
+     */
+    getOptimizationRecommendations() {
+        const recommendations = [];
+        const metrics = this.getAllMetrics();
+        for (const [name, metric] of Object.entries(metrics)) {
+            if (metric.hitRate < 0.5) {
+                recommendations.push(`Pool '${name}' has low hit rate (${(metric.hitRate * 100).toFixed(1)}%). ` +
+                    "Consider reducing pool size or increasing object lifetime.");
+            }
+            if (metric.averageUsage > 2) {
+                recommendations.push(`Pool '${name}' has high object creation rate (${metric.averageUsage.toFixed(1)} objects per request). ` +
+                    "Consider increasing pool size or implementing object reuse.");
+            }
+            if (metric.available === 0 && metric.allocated > 10) {
+                recommendations.push(`Pool '${name}' is fully utilized (${metric.allocated} objects). ` +
+                    "Consider increasing max pool size.");
+            }
+        }
+        return recommendations;
+    }
+    /**
+     * Start monitoring pools and emitting metrics
+     */
+    startMonitoring() {
+        this.monitoringInterval = setInterval(() => {
+            const metrics = this.getAllMetrics();
+            this.emit("metricsUpdate", metrics);
+            // Check for optimization opportunities
+            const recommendations = this.getOptimizationRecommendations();
+            if (recommendations.length > 0) {
+                this.emit("optimizationRecommendations", recommendations);
+            }
+        }, 300000); // Every 5 minutes
+    }
+    /**
+     * Stop monitoring and clear all pools
+     */
+    stop() {
+        if (this.monitoringInterval) {
+            clearInterval(this.monitoringInterval);
+        }
+        this.monitoringInterval = null;
+        for (const pool of this.pools.values()) {
+            pool.clear();
+        }
+        this.pools.clear();
+    }
+}
+// Global instance
+export const memoryPoolManager = new MemoryPoolManager();
+// Convenience functions for common object types
+export function createSessionPool(maxSize = 100) {
+    return memoryPoolManager.getPool("sessions", {
+        maxSize,
+        factory: () => ({
+            id: "",
+            createdAt: Date.now(),
+            lastActivity: Date.now(),
+            metadata: new Map(),
+            isActive: true,
+        }),
+        reset: (session) => {
+            session.id = "";
+            session.createdAt = Date.now();
+            session.lastActivity = Date.now();
+            session.metadata.clear();
+            session.isActive = true;
+        },
+    });
+}
+export function createMetricsPool(maxSize = 200) {
+    return memoryPoolManager.getPool("metrics", {
+        maxSize,
+        factory: () => ({
+            timestamp: Date.now(),
+            type: "",
+            value: 0,
+            metadata: {},
+        }),
+        reset: (metric) => {
+            metric.timestamp = Date.now();
+            metric.type = "";
+            metric.value = 0;
+            metric.metadata = {};
+        },
+    });
+}
+export function createAlertPool(maxSize = 50) {
+    return memoryPoolManager.getPool("alerts", {
+        maxSize,
+        factory: () => ({
+            id: "",
+            type: "",
+            severity: "low",
+            message: "",
+            timestamp: Date.now(),
+            resolved: false,
+        }),
+        reset: (alert) => {
+            alert.id = "";
+            alert.type = "";
+            alert.severity = "low";
+            alert.message = "";
+            alert.timestamp = Date.now();
+            alert.resolved = false;
+        },
+    });
+}
+//# sourceMappingURL=memory-pool.js.map

package/dist/utils/memory-pool.js.map

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

package/dist/utils/path-resolver.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Path Resolution Utility for StringRay Framework
+ * Resolves import paths that work across development, build, and installed environments
+ */
+export declare class PathResolver {
+    private static instance;
+    private currentDir;
+    private isDevelopment;
+    private isBuilt;
+    private isInstalled;
+    private constructor();
+    static getInstance(): PathResolver;
+    /**
+     * Get current working directory
+     */
+    private getCurrentDirectory;
+    /**
+     * Detect if we're running in development environment (src/ directory)
+     */
+    private detectDevelopment;
+    /**
+     * Detect if we're running in built environment (dist/ directory)
+     */
+    private detectBuilt;
+    /**
+     * Detect if we're running in installed package environment
+     */
+    private detectInstalled;
+    /**
+     * Resolve agent import path for current environment
+     */
+    resolveAgentPath(agentName: string): string;
+    /**
+     * Resolve any module path for current environment
+     */
+    resolveModulePath(modulePath: string): string;
+    /**
+     * Get environment information for debugging
+     */
+    getEnvironmentInfo(): {
+        currentDir: string;
+        isDevelopment: boolean;
+        isBuilt: boolean;
+        isInstalled: boolean;
+        nodeEnv: string | undefined;
+    };
+}
+export declare const pathResolver: PathResolver;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/utils/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/path-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAU;IAE7B,OAAO;IAQP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAwB3C;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAqB7C;;OAEG;IACH,kBAAkB,IAAI;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B;CASF;AAGD,eAAO,MAAM,YAAY,cAA6B,CAAC"}