json-function-engine 0.8.0

package/dist/engine/Executor.js

@@ -0,0 +1,260 @@
+import { runWithTimeout } from '../utils/regex.js';
+import { Pipeline } from './Pipeline.js';
+import { DEFAULT_TIMEOUT_MS } from '../constants.js';
+import { createDefaultLogger } from '../utils/factories.js';
+import { DefaultMetricsCollector } from '../utils/metrics.js';
+export class Executor {
+    registry;
+    logger;
+    options;
+    pipeline;
+    metrics;
+    errors;
+    cancelled = false;
+    constructor(dependencies, options = {}) {
+        if (!dependencies.registry) {
+            throw new Error('Executor requires a Registry to be provided in dependencies');
+        }
+        this.registry = dependencies.registry;
+        this.logger = dependencies.logger ?? createDefaultLogger();
+        this.metrics = dependencies.metrics ?? new DefaultMetricsCollector();
+        this.options = {
+            timeout: options.timeout ?? DEFAULT_TIMEOUT_MS,
+            parallel: options.parallel ?? true
+        };
+        this.pipeline = new Pipeline();
+        this.errors = [];
+    }
+    /**
+     * Cancel the current execution
+     */
+    cancel() {
+        this.cancelled = true;
+    }
+    /**
+     * Check if execution was cancelled
+     */
+    isCancelled() {
+        return this.cancelled;
+    }
+    /**
+     * Reset cancelled state for next execution
+     */
+    resetCancellation() {
+        this.cancelled = false;
+    }
+    /**
+     * Get the execution pipeline
+     */
+    getPipeline() {
+        return this.pipeline;
+    }
+    /**
+     * Execute functions against files
+     */
+    async execute(functions, files, context) {
+        this.resetCancellation(); // Reset cancelled state for new execution
+        const endTimer = this.metrics.startTimer('execute');
+        this.errors = []; // Reset errors for this execution
+        this.metrics.increment('functionsEnabled', functions.length);
+        this.metrics.increment('filesProcessed', files.length);
+        const enabledFunctions = functions.filter(f => f.enabled !== false);
+        // Run beforeExecute hooks
+        let pipelineData = { files, functions: enabledFunctions };
+        if (this.pipeline.hasHooks('beforeExecute')) {
+            pipelineData = await this.pipeline.execute('beforeExecute', context, pipelineData);
+        }
+        const allFindings = [];
+        try {
+            // Pre-split lines for each file
+            const filesWithLines = (pipelineData.files || files).map(f => ({
+                ...f,
+                lines: f.content.split('\n')
+            }));
+            // Process files (parallel or sequential)
+            const fileResults = this.options.parallel
+                ? await Promise.all(filesWithLines.map(f => this.processFile(f, enabledFunctions, context)))
+                : await this.sequentialProcess(filesWithLines, enabledFunctions, context);
+            for (const findings of fileResults) {
+                allFindings.push(...findings);
+            }
+            // Run afterExecute hooks
+            if (this.pipeline.hasHooks('afterExecute')) {
+                await this.pipeline.execute('afterExecute', context, { findings: allFindings });
+            }
+            // Track finding counts by severity
+            for (const finding of allFindings) {
+                this.metrics.increment('findings');
+                this.metrics.increment(`findings.${finding.severity}`);
+            }
+            return allFindings;
+        }
+        catch (error) {
+            // Run onError hooks
+            if (this.pipeline.hasHooks('onError') && error instanceof Error) {
+                await this.pipeline.execute('onError', context, { error, findings: allFindings });
+            }
+            throw error;
+        }
+        finally {
+            endTimer();
+        }
+    }
+    /**
+     * Get execution errors with classification
+     */
+    getErrors() {
+        return [...this.errors];
+    }
+    /**
+     * Get the metrics collector
+     */
+    getMetrics() {
+        return this.metrics;
+    }
+    /**
+     * Classify an error based on its characteristics
+     */
+    classifyError(error, functionId, file) {
+        const errorMessage = error.message.toLowerCase();
+        // Check for timeout errors
+        if (errorMessage.includes('timeout') || errorMessage.includes('timed out')) {
+            return {
+                functionId,
+                file,
+                error: error.message,
+                phase: 'condition',
+                type: 'timeout'
+            };
+        }
+        // Check for validation errors
+        if (errorMessage.includes('validation') || errorMessage.includes('invalid') || errorMessage.includes('schema')) {
+            return {
+                functionId,
+                file,
+                error: error.message,
+                phase: 'condition',
+                type: 'validation'
+            };
+        }
+        // Check for runtime errors
+        if (errorMessage.includes('typeerror') || errorMessage.includes('referenceerror') || errorMessage.includes('syntaxerror')) {
+            return {
+                functionId,
+                file,
+                error: error.message,
+                phase: 'action',
+                type: 'runtime'
+            };
+        }
+        // Default to unknown
+        return {
+            functionId,
+            file,
+            error: error.message,
+            phase: 'action',
+            type: 'unknown'
+        };
+    }
+    /**
+     * Process files sequentially
+     */
+    async sequentialProcess(files, fns, context) {
+        const results = [];
+        for (const file of files) {
+            // Check for cancellation between files
+            if (this.cancelled) {
+                break;
+            }
+            const findings = await this.processFile(file, fns, context);
+            results.push(findings);
+        }
+        return results;
+    }
+    /**
+     * Process a single file through all enabled functions
+     */
+    async processFile(file, fns, context) {
+        const findings = [];
+        const fileContext = { ...context, file: file.path, lines: file.lines };
+        for (const fn of fns) {
+            // Check for cancellation between functions
+            if (this.cancelled) {
+                break;
+            }
+            this.metrics.increment('functionsExecuted');
+            try {
+                const result = await runWithTimeout(this.evaluateFunction(fn, file, fileContext), this.options.timeout, `Function ${fn.id} timed out`);
+                if (result.findings) {
+                    for (const finding of result.findings) {
+                        finding.functionId = fn.id;
+                    }
+                    findings.push(...result.findings);
+                }
+                if (result.blocked) {
+                    this.logger.warn(`Execution blocked by function ${fn.id}: ${result.error}`);
+                    this.metrics.increment('blocked');
+                    break;
+                }
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    this.logger.warn(`Error executing function ${fn.id}:`, error);
+                    // Classify and track the error
+                    this.errors.push(this.classifyError(error, fn.id, file.path));
+                }
+                else {
+                    const errorMessage = String(error);
+                    this.logger.warn(`Error executing function ${fn.id}:`, error);
+                    this.errors.push({
+                        functionId: fn.id,
+                        file: file.path,
+                        error: errorMessage,
+                        phase: 'action',
+                        type: 'unknown'
+                    });
+                }
+                this.metrics.increment('errors');
+            }
+        }
+        return findings;
+    }
+    /**
+     * Evaluate a function against a file
+     */
+    async evaluateFunction(fn, file, context) {
+        // Inject evaluateCondition callback into context for composite conditions
+        const contextWithCallback = {
+            ...context,
+            evaluateCondition: (config, ctx, f) => this.registry.evaluateCondition(config, ctx, f)
+        };
+        // Evaluate condition
+        const conditionResult = await this.registry.evaluateCondition(fn.condition, contextWithCallback, file);
+        // Execute action
+        const actionResult = await this.registry.executeAction(fn.action, contextWithCallback, conditionResult, file);
+        // Assign function ID to findings
+        if (actionResult.findings) {
+            for (const finding of actionResult.findings) {
+                finding.functionId = fn.id;
+            }
+        }
+        return {
+            findings: actionResult.findings,
+            blocked: actionResult.blocked,
+            error: actionResult.error
+        };
+    }
+    /**
+     * Set the logger (acceptable to change at runtime)
+     */
+    setLogger(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Update options
+     */
+    setOptions(options) {
+        this.options = { ...this.options, ...options };
+    }
+}
+//# sourceMappingURL=Executor.js.map

package/dist/engine/Executor.js.map

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

package/dist/engine/FileLoader.d.ts

@@ -0,0 +1,51 @@
+import type { FunctionDefinition, FileSystem, Logger } from '../types/index.js';
+export interface FileLoaderDependencies {
+    fileSystem?: FileSystem;
+    logger?: Logger;
+}
+export interface ExpandedResult {
+    loaded: number;
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+    functions: FunctionDefinition[];
+}
+export declare class FileLoader {
+    private fileSystem;
+    private logger;
+    constructor(dependencies?: FileLoaderDependencies);
+    /**
+     * Load functions from JSON files
+     */
+    load(paths: string | string[], options?: {
+        include?: string[];
+        exclude?: string[];
+    }): Promise<ExpandedResult>;
+    /**
+     * Load a single file and parse its functions
+     */
+    loadFile(path: string): Promise<{
+        path: string;
+        error?: string;
+        functions: FunctionDefinition[];
+    }>;
+    /**
+     * Expand glob pattern to list of file paths
+     */
+    expandGlob(pattern: string): Promise<string[]>;
+    /**
+     * Match a name against a glob pattern
+     */
+    private matchGlob;
+    /**
+     * Get compiled regex from shared cache
+     */
+    private getCompiledRegex;
+    /**
+     * Clear the regex cache (delegates to shared cache)
+     * @deprecated Cache is now managed by the shared LRU cache in regex.ts
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=FileLoader.d.ts.map

package/dist/engine/FileLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLoader.d.ts","sourceRoot":"","sources":["../../src/engine/FileLoader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAe,UAAU,EAAE,MAAM,EAAyC,MAAM,mBAAmB,CAAC;AAMpI,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAgDD,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,YAAY,GAAE,sBAA2B;IAKrD;;OAEG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GACvD,OAAO,CAAC,cAAc,CAAC;IA6C1B;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;IAqC7E;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkDpD;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;OAGG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/engine/FileLoader.js

@@ -0,0 +1,195 @@
+import { join } from 'path';
+import { filterFunctionsByPattern, compileRegex } from '../utils/regex.js';
+import { validateFunctionSet } from '../utils/schema.js';
+import { createDefaultFileSystem, createDefaultLogger } from '../utils/factories.js';
+import { FileError } from '../utils/errors.js';
+/**
+ * Validate regex patterns in condition configurations
+ */
+function validateRegexPatterns(functions) {
+    const errors = [];
+    for (const fn of functions) {
+        if (!fn.condition)
+            continue;
+        const conditionErrors = validateConditionPatterns(fn.id, fn.condition);
+        errors.push(...conditionErrors);
+    }
+    return errors;
+}
+function validateConditionPatterns(functionId, config, path = '') {
+    const errors = [];
+    if (config.type === 'regex') {
+        const regexConfig = config;
+        if (regexConfig.pattern) {
+            try {
+                new RegExp(regexConfig.pattern);
+            }
+            catch (e) {
+                errors.push(`Invalid regex pattern in function '${functionId}'${path}: ${regexConfig.pattern}`);
+            }
+        }
+    }
+    // Recursively validate composite conditions
+    if (config.type === 'composite' && 'conditions' in config) {
+        const compositeConfig = config;
+        for (let i = 0; i < compositeConfig.conditions.length; i++) {
+            const childErrors = validateConditionPatterns(functionId, compositeConfig.conditions[i], `${path}/conditions[${i}]`);
+            errors.push(...childErrors);
+        }
+    }
+    return errors;
+}
+export class FileLoader {
+    fileSystem;
+    logger;
+    constructor(dependencies = {}) {
+        this.fileSystem = dependencies.fileSystem ?? createDefaultFileSystem();
+        this.logger = dependencies.logger ?? createDefaultLogger();
+    }
+    /**
+     * Load functions from JSON files
+     */
+    async load(paths, options = {}) {
+        const filePaths = Array.isArray(paths) ? paths : [paths];
+        const loadedFunctions = [];
+        const errors = [];
+        // Use parallel loading
+        const loadResults = await Promise.all(filePaths.map(async (filePath) => {
+            const expandedPaths = await this.expandGlob(filePath);
+            return Promise.all(expandedPaths.map(async (path) => {
+                try {
+                    return await this.loadFile(path);
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    return { path, error: errorMessage, functions: [] };
+                }
+            }));
+        }));
+        // Flatten results
+        for (const fileResults of loadResults) {
+            for (const result of fileResults) {
+                if (result.error) {
+                    errors.push({ path: result.path, error: result.error });
+                    this.logger.warn(`Failed to load functions from ${result.path}:`, result.error);
+                }
+                else {
+                    loadedFunctions.push(...result.functions);
+                }
+            }
+        }
+        // Filter by pattern
+        const filteredFunctions = filterFunctionsByPattern(loadedFunctions, options.include || [], options.exclude || []);
+        return { loaded: filteredFunctions.length, errors, functions: filteredFunctions };
+    }
+    /**
+     * Load a single file and parse its functions
+     */
+    async loadFile(path) {
+        let content;
+        try {
+            content = await this.fileSystem.readFile(path, 'utf-8');
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            throw new FileError(`Failed to read file '${path}': ${error.message}`, path, error);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            throw new FileError(`Failed to parse JSON in '${path}': ${error.message}`, path, error);
+        }
+        // Only accept "functions" key in JSON
+        const functions = (parsed.functions || []);
+        const functionSet = { version: parsed.version, functions: functions };
+        // Validate against schema
+        const validationErrors = validateFunctionSet(functionSet);
+        if (validationErrors.length > 0) {
+            const errorMessages = validationErrors.map(e => `${e.path}: ${e.message}`).join('; ');
+            return { path, error: `Schema validation failed: ${errorMessages}`, functions: [] };
+        }
+        // Validate regex patterns
+        const regexErrors = validateRegexPatterns(functions);
+        if (regexErrors.length > 0) {
+            return { path, error: `Invalid regex patterns: ${regexErrors.join('; ')}`, functions: [] };
+        }
+        return { path, functions };
+    }
+    /**
+     * Expand glob pattern to list of file paths
+     */
+    async expandGlob(pattern) {
+        const parts = pattern.split('/');
+        let currentDir = '.';
+        // Find the directory part
+        const globIndex = parts.findIndex(p => p.includes('*') || p.includes('?'));
+        if (globIndex === -1) {
+            // No glob, return as-is if file exists
+            try {
+                await this.fileSystem.stat(pattern);
+                return [pattern];
+            }
+            catch {
+                return [];
+            }
+        }
+        // Join non-glob parts as directory
+        if (globIndex > 0) {
+            currentDir = join(...parts.slice(0, globIndex));
+        }
+        const globPart = parts[globIndex];
+        const remainingParts = parts.slice(globIndex + 1);
+        try {
+            const entries = await this.fileSystem.readdir(currentDir);
+            const matches = entries.filter(name => this.matchGlob(name, globPart));
+            if (remainingParts.length > 0) {
+                // Recurse into matched directories
+                const result = [];
+                for (const match of matches) {
+                    const subPath = join(currentDir, match);
+                    const stats = await this.fileSystem.stat(subPath);
+                    if (stats.isDirectory()) {
+                        const subResults = await this.expandGlob(join(subPath, ...remainingParts));
+                        result.push(...subResults);
+                    }
+                }
+                return result;
+            }
+            return matches.map(m => join(currentDir, m));
+        }
+        catch (error) {
+            // Log warning for failed glob expansion
+            this.logger.warn(`Failed to expand glob pattern '${pattern}':`, error);
+            return [];
+        }
+    }
+    /**
+     * Match a name against a glob pattern
+     */
+    matchGlob(name, pattern) {
+        const regexPattern = pattern
+            .replace(/\./g, '\\.')
+            .replace(/\*/g, '.*')
+            .replace(/\?/g, '.');
+        const regex = this.getCompiledRegex(`^${regexPattern}$`);
+        return regex.test(name);
+    }
+    /**
+     * Get compiled regex from shared cache
+     */
+    getCompiledRegex(pattern) {
+        return compileRegex(pattern);
+    }
+    /**
+     * Clear the regex cache (delegates to shared cache)
+     * @deprecated Cache is now managed by the shared LRU cache in regex.ts
+     */
+    clearCache() {
+        // No-op: cache is now managed by the shared LRU cache in regex.ts
+        // This method is kept for API compatibility
+    }
+}
+//# sourceMappingURL=FileLoader.js.map

package/dist/engine/FileLoader.js.map

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

package/dist/engine/Pipeline.d.ts

@@ -0,0 +1,54 @@
+import type { FunctionDefinition, FileInput, ExecutionContext, Finding, Logger } from '../types/index.js';
+export type PipelineHookType = 'beforeLoad' | 'beforeExecute' | 'afterExecute' | 'onError';
+export interface PipelineHook {
+    type: PipelineHookType;
+    name: string;
+    handler: PipelineHandler;
+}
+export type PipelineHandler = (context: ExecutionContext, data: PipelineData) => Promise<PipelineData> | PipelineData;
+export interface PipelineData {
+    files?: FileInput[];
+    findings?: Finding[];
+    functions?: FunctionDefinition[];
+    error?: Error;
+    result?: unknown;
+}
+export interface PipelineOptions {
+    logger?: Logger;
+    parallel?: boolean;
+}
+export declare class Pipeline {
+    private hooks;
+    private logger;
+    private parallel;
+    constructor(options?: PipelineOptions);
+    /**
+     * Register a hook to the pipeline
+     */
+    register(hook: PipelineHook): void;
+    /**
+     * Unregister a hook from the pipeline
+     */
+    unregister(type: PipelineHookType, name: string): void;
+    /**
+     * Execute hooks of a specific type
+     */
+    execute(type: PipelineHookType, context: ExecutionContext, data: PipelineData): Promise<PipelineData>;
+    /**
+     * Get all registered hooks
+     */
+    getHooks(type?: PipelineHookType): PipelineHook[];
+    /**
+     * Clear all hooks
+     */
+    clear(): void;
+    /**
+     * Check if pipeline has hooks of a specific type
+     */
+    hasHooks(type: PipelineHookType): boolean;
+}
+/**
+ * Create a pipeline hook helper
+ */
+export declare function createHook(type: PipelineHookType, name: string, handler: PipelineHandler): PipelineHook;
+//# sourceMappingURL=Pipeline.d.ts.map

package/dist/engine/Pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../../src/engine/Pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG1G,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,SAAS,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,YAAY,KACf,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAoD;IACjE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,GAAE,eAAoB;IAKzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAMlC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAuC3G;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE;IAOjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;CAI1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,YAAY,CAEd"}