@emmvish/stable-request 1.8.1 → 2.0.0

package/dist/utilities/execute-sequentially.js

@@ -1,61 +1,46 @@
-import { stableRequest } from "../core/index.js";
-import { prepareApiRequestData } from "./prepare-api-request-data.js";
-import { prepareApiRequestOptions } from './prepare-api-request-options.js';
+import { executeGatewayItem } from "./execute-gateway-item.js";
+import { RequestOrFunction } from "../enums/index.js";
 import { CircuitBreaker, CircuitBreakerOpenError } from "./circuit-breaker.js";
-export async function executeSequentially(requests = [], requestExecutionOptions = {}) {
+export async function executeSequentially(items = [], requestExecutionOptions = {}) {
     const responses = [];
     const circuitBreaker = requestExecutionOptions.circuitBreaker
         ? (requestExecutionOptions.circuitBreaker instanceof CircuitBreaker
             ? requestExecutionOptions.circuitBreaker
             : new CircuitBreaker(requestExecutionOptions.circuitBreaker))
         : null;
-    for (let i = 0; i < requests.length; i++) {
-        const req = requests[i];
-        try {
-            if (circuitBreaker && !circuitBreaker.getState().config.trackIndividualAttempts) {
-                const canExecute = await circuitBreaker.canExecute();
-                if (!canExecute) {
-                    throw new CircuitBreakerOpenError(`stable-request: Circuit breaker is ${circuitBreaker.getState().state}. Request blocked.`);
-                }
-            }
-            const finalRequestOptions = {
-                reqData: prepareApiRequestData(req, requestExecutionOptions),
-                ...prepareApiRequestOptions(req, requestExecutionOptions),
-                commonBuffer: requestExecutionOptions.sharedBuffer ?? req.requestOptions.commonBuffer,
-                ...(circuitBreaker ? { circuitBreaker } : {}),
-                executionContext: {
-                    ...requestExecutionOptions.executionContext,
-                    requestId: req.id
-                }
+    // Convert to unified format if needed
+    const unifiedItems = items.map(item => {
+        if ('type' in item) {
+            return item;
+        }
+        else {
+            return {
+                type: RequestOrFunction.REQUEST,
+                request: item
             };
-            const requestResult = await stableRequest(finalRequestOptions);
-            if (circuitBreaker && !circuitBreaker.getState().config.trackIndividualAttempts) {
-                circuitBreaker.recordSuccess();
+        }
+    });
+    for (let i = 0; i < unifiedItems.length; i++) {
+        const item = unifiedItems[i];
+        try {
+            const response = await executeGatewayItem(item, requestExecutionOptions, circuitBreaker);
+            responses.push(response);
+            if (!response.success && requestExecutionOptions.stopOnFirstError) {
+                break;
             }
-            responses.push({
-                requestId: req.id,
-                ...(req.groupId && { groupId: req.groupId }),
-                success: requestResult.success,
-                ...(requestResult.data !== undefined && { data: requestResult.data }),
-                ...(!requestResult.success && {
-                    error: requestResult.error || 'Request was unsuccessful, but the error was analyzed successfully!'
-                })
-            });
         }
         catch (error) {
-            if (circuitBreaker &&
-                !(error instanceof CircuitBreakerOpenError) &&
-                !circuitBreaker.getState().config.trackIndividualAttempts) {
-                circuitBreaker.recordFailure();
-            }
+            const itemId = item.type === RequestOrFunction.REQUEST ? item.request.id : item.function.id;
+            const groupId = item.type === RequestOrFunction.REQUEST ? item.request.groupId : item.function.groupId;
             const isCircuitBreakerError = error instanceof CircuitBreakerOpenError;
             responses.push({
-                requestId: req.id,
-                ...(req.groupId && { groupId: req.groupId }),
+                requestId: itemId,
+                ...(groupId && { groupId }),
                 success: false,
                 error: isCircuitBreakerError
                     ? `Circuit breaker open: ${error.message}`
-                    : (error?.message || 'An error occurred! Error description is unavailable.')
+                    : (error?.message || 'An error occurred! Error description is unavailable.'),
+                type: item.type
             });
             if (requestExecutionOptions.stopOnFirstError) {
                 break;

package/dist/utilities/execute-sequentially.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute-sequentially.js","sourceRoot":"","sources":["../../src/utilities/execute-sequentially.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execute-sequentially.js","sourceRoot":"","sources":["../../src/utilities/execute-sequentially.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAOtD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,QAAsI,EAAE,EACxI,0BAAmG,EAAE;IAErG,MAAM,SAAS,GAA6C,EAAE,CAAC;IAE/D,MAAM,cAAc,GAAG,uBAAuB,CAAC,cAAc;QACzD,CAAC,CAAC,CAAC,uBAAuB,CAAC,cAAc,YAAY,cAAc;YAC/D,CAAC,CAAC,uBAAuB,CAAC,cAAc;YACxC,CAAC,CAAC,IAAI,cAAc,CAAC,uBAAuB,CAAC,cAAqB,CAAC,CAAC;QACxE,CAAC,CAAC,IAAI,CAAC;IAEX,sCAAsC;IACtC,MAAM,YAAY,GAAsE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACrG,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACjB,OAAO,IAAuE,CAAC;QACnF,CAAC;aAAM,CAAC;YACJ,OAAO;gBACH,IAAI,EAAE,iBAAiB,CAAC,OAAO;gBAC/B,OAAO,EAAE,IAA8D;aAC1E,CAAC;QACN,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAE7B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,uBAAuB,EAAE,cAAc,CAAC,CAAC;YACzF,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEzB,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;gBAChE,MAAM;YACV,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACvG,MAAM,qBAAqB,GAAG,KAAK,YAAY,uBAAuB,CAAC;YAEvE,SAAS,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,MAAM;gBACjB,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC3B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,qBAAqB;oBACxB,CAAC,CAAC,yBAAyB,KAAK,CAAC,OAAO,EAAE;oBAC1C,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,sDAAsD,CAAC;gBAChF,IAAI,EAAE,IAAI,CAAC,IAAI;aAClB,CAAC,CAAC;YAEH,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;gBAC3C,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/utilities/execute-workflow-graph.d.ts

@@ -0,0 +1,3 @@
+import { WorkflowGraph, WorkflowGraphOptions, STABLE_WORKFLOW_RESULT } from '../types/index.js';
+export declare function executeWorkflowGraph<RequestDataType = any, ResponseDataType = any>(graph: WorkflowGraph<RequestDataType, ResponseDataType>, options: WorkflowGraphOptions<RequestDataType, ResponseDataType>): Promise<STABLE_WORKFLOW_RESULT<ResponseDataType>>;
+//# sourceMappingURL=execute-workflow-graph.d.ts.map

package/dist/utilities/execute-workflow-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-workflow-graph.d.ts","sourceRoot":"","sources":["../../src/utilities/execute-workflow-graph.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EAIvB,MAAM,mBAAmB,CAAC;AAS3B,wBAAsB,oBAAoB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EACtF,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,gBAAgB,CAAC,EACvD,OAAO,EAAE,oBAAoB,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAC/D,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,CAqZnD"}

package/dist/utilities/execute-workflow-graph.js

@@ -0,0 +1,326 @@
+import { WorkflowNodeTypes, WorkflowEdgeConditionTypes } from '../enums/index.js';
+import { validateWorkflowGraph } from './validate-workflow-graph.js';
+import { executePhase } from './execute-phase.js';
+import { executeBranchWorkflow } from './execute-branch-workflow.js';
+import { formatLogContext } from './format-log-context.js';
+import { safelyStringify } from './safely-stringify.js';
+import { MetricsAggregator } from './metrics-aggregator.js';
+import { executeWithPersistence } from './execute-with-persistence.js';
+export async function executeWorkflowGraph(graph, options) {
+    const startTime = Date.now();
+    const workflowId = options.workflowId || `workflow-graph-${Date.now()}`;
+    if (options.validateGraph !== false) {
+        const validation = validateWorkflowGraph(graph);
+        if (!validation.valid) {
+            throw new Error(`Invalid workflow graph:\n${validation.errors.join('\n')}`);
+        }
+        if (validation.warnings.length > 0 && options.logPhaseResults) {
+            console.warn(`${formatLogContext({ workflowId })}stable-request: Workflow graph warnings:\n${validation.errors.join('\n')}`);
+        }
+    }
+    const results = new Map();
+    const visited = new Set();
+    const executionHistory = [];
+    const phaseResults = [];
+    const sharedBuffer = options.sharedBuffer || {};
+    let totalRequests = 0;
+    let successfulRequests = 0;
+    let failedRequests = 0;
+    let terminatedEarly = false;
+    let terminationReason;
+    const areDependenciesSatisfied = (nodeId, waitForNodes) => {
+        return waitForNodes.every(depId => visited.has(depId));
+    };
+    const executeNode = async (nodeId) => {
+        if (visited.has(nodeId) || terminatedEarly) {
+            return;
+        }
+        const node = graph.nodes.get(nodeId);
+        if (!node) {
+            throw new Error(`${formatLogContext({ workflowId })}Node '${nodeId}' not found in graph`);
+        }
+        if (node.type === WorkflowNodeTypes.MERGE_POINT && node.waitForNodes) {
+            if (!areDependenciesSatisfied(nodeId, node.waitForNodes)) {
+                return;
+            }
+            visited.add(nodeId);
+            if (options.logPhaseResults) {
+                console.info(`${formatLogContext({ workflowId })}stable-request: Merge point '${nodeId}' synchronized (waited for: ${node.waitForNodes.join(', ')})`);
+            }
+            const edges = graph.edges.get(nodeId) || [];
+            for (const edge of edges) {
+                if (terminatedEarly)
+                    break;
+                await executeNode(edge.to);
+            }
+            return;
+        }
+        switch (node.type) {
+            case WorkflowNodeTypes.PHASE:
+                await executePhaseNode(node, nodeId);
+                break;
+            case WorkflowNodeTypes.BRANCH:
+                await executeBranchNode(node, nodeId);
+                break;
+            case WorkflowNodeTypes.CONDITIONAL:
+                await executeConditionalNode(node, nodeId);
+                return;
+            case WorkflowNodeTypes.PARALLEL_GROUP:
+                await executeParallelGroupNode(node, nodeId);
+                break;
+        }
+        visited.add(nodeId);
+        if (terminatedEarly) {
+            return;
+        }
+        const edges = graph.edges.get(nodeId) || [];
+        for (const edge of edges) {
+            if (edge.condition) {
+                let shouldTraverse = false;
+                if (edge.condition.type === WorkflowEdgeConditionTypes.ALWAYS) {
+                    shouldTraverse = true;
+                }
+                else if (edge.condition.type === WorkflowEdgeConditionTypes.SUCCESS) {
+                    const result = results.get(nodeId);
+                    shouldTraverse = result?.success === true;
+                }
+                else if (edge.condition.type === WorkflowEdgeConditionTypes.FAILURE) {
+                    const result = results.get(nodeId);
+                    shouldTraverse = result?.success === false;
+                }
+                else if (edge.condition.type === WorkflowEdgeConditionTypes.CUSTOM && edge.condition.evaluate) {
+                    shouldTraverse = await edge.condition.evaluate({
+                        results,
+                        sharedBuffer,
+                        executionHistory,
+                        currentNodeId: nodeId
+                    });
+                }
+                if (!shouldTraverse) {
+                    continue;
+                }
+            }
+            if (terminatedEarly)
+                break;
+            await executeNode(edge.to);
+        }
+    };
+    const executePhaseNode = async (node, nodeId) => {
+        if (!node.phase) {
+            throw new Error(`${formatLogContext({ workflowId })}Phase node '${nodeId}' has no phase configuration`);
+        }
+        const phaseIndex = phaseResults.length;
+        const phaseId = node.phase.id || nodeId;
+        let executionNumber = 1;
+        let shouldReplay = false;
+        do {
+            try {
+                let phase = node.phase;
+                if (options.prePhaseExecutionHook) {
+                    phase = await executeWithPersistence(options.prePhaseExecutionHook, {
+                        phase,
+                        phaseId,
+                        phaseIndex,
+                        workflowId,
+                        sharedBuffer,
+                        params: options.workflowHookParams?.prePhaseExecutionHookParams
+                    }, options.statePersistence, { workflowId, phaseId }, sharedBuffer);
+                }
+                const phaseResult = await executePhase(phase, phaseIndex, workflowId, options, options.requestGroups || [], options.logPhaseResults || false, options.handlePhaseCompletion || (async () => { }), options.maxSerializableChars || 1000, options.workflowHookParams || {}, sharedBuffer, undefined, options.prePhaseExecutionHook);
+                results.set(nodeId, phaseResult);
+                phaseResults.push(phaseResult);
+                totalRequests += phaseResult.totalRequests;
+                successfulRequests += phaseResult.successfulRequests;
+                failedRequests += phaseResult.failedRequests;
+                const executionRecord = {
+                    phaseId,
+                    phaseIndex,
+                    executionNumber,
+                    timestamp: phaseResult.timestamp,
+                    success: phaseResult.success,
+                    executionTime: phaseResult.executionTime
+                };
+                shouldReplay = false;
+                if (node.phaseDecisionHook) {
+                    const decision = await executeWithPersistence(node.phaseDecisionHook, {
+                        workflowId,
+                        phaseResult,
+                        phaseId,
+                        phaseIndex,
+                        executionHistory,
+                        sharedBuffer,
+                        params: options.workflowHookParams?.handlePhaseDecisionParams
+                    }, options.statePersistence, { workflowId, phaseId }, sharedBuffer);
+                    executionRecord.decision = decision;
+                    if (decision.action === 'replay') {
+                        shouldReplay = true;
+                        executionNumber++;
+                        if (options.logPhaseResults) {
+                            console.info(`${formatLogContext({ workflowId, phaseId })}stable-request: Phase decision - REPLAY (execution ${executionNumber})`);
+                        }
+                    }
+                    else if (decision.action === 'terminate') {
+                        terminatedEarly = true;
+                        terminationReason = decision.reason || 'Phase decision hook requested termination';
+                        if (options.logPhaseResults) {
+                            console.info(`${formatLogContext({ workflowId, phaseId })}stable-request: Phase decision - TERMINATE: ${terminationReason}`);
+                        }
+                    }
+                }
+                executionHistory.push(executionRecord);
+                if (options.logPhaseResults) {
+                    const logContext = formatLogContext({
+                        workflowId,
+                        phaseId
+                    });
+                    console.info(`${logContext}stable-request: Phase completed - Success: ${phaseResult.success}, Requests: ${phaseResult.totalRequests}`);
+                    console.info(`${logContext}stable-request: ${safelyStringify(phaseResult, options.maxSerializableChars || 1000)}`);
+                }
+                if (options.handlePhaseCompletion) {
+                    await executeWithPersistence(options.handlePhaseCompletion, {
+                        phaseResult,
+                        phaseId,
+                        phaseIndex,
+                        workflowId,
+                        sharedBuffer,
+                        params: options.workflowHookParams?.handlePhaseCompletionParams
+                    }, options.statePersistence, { workflowId, phaseId }, sharedBuffer);
+                }
+                if (!phaseResult.success && options.stopOnFirstPhaseError) {
+                    terminatedEarly = true;
+                    terminationReason = `Phase '${phaseId}' failed`;
+                    shouldReplay = false;
+                }
+            }
+            catch (error) {
+                const errorResult = {
+                    workflowId,
+                    phaseId,
+                    phaseIndex,
+                    success: false,
+                    executionTime: Date.now() - startTime,
+                    timestamp: new Date().toISOString(),
+                    totalRequests: 0,
+                    successfulRequests: 0,
+                    failedRequests: 0,
+                    responses: [],
+                    error: error.message || 'Unknown error'
+                };
+                results.set(nodeId, errorResult);
+                phaseResults.push(errorResult);
+                terminatedEarly = true;
+                terminationReason = error.message || `${formatLogContext({ workflowId })}stable-request: Unknown error during execution`;
+                shouldReplay = false;
+            }
+        } while (shouldReplay && !terminatedEarly);
+    };
+    const executeBranchNode = async (node, nodeId) => {
+        if (!node.branch) {
+            throw new Error(`${formatLogContext({ workflowId })}Branch node '${nodeId}' has no branch configuration`);
+        }
+        const branchResult = await executeBranchWorkflow({
+            branches: [node.branch],
+            workflowId,
+            commonGatewayOptions: options,
+            requestGroups: options.requestGroups || [],
+            logPhaseResults: options.logPhaseResults || false,
+            handlePhaseCompletion: options.handlePhaseCompletion || (async () => { }),
+            handlePhaseError: options.handlePhaseError || (async () => { }),
+            handleBranchCompletion: options.handleBranchCompletion,
+            preBranchExecutionHook: options.preBranchExecutionHook,
+            prePhaseExecutionHook: options.prePhaseExecutionHook,
+            maxSerializableChars: options.maxSerializableChars || 1000,
+            workflowHookParams: options.workflowHookParams || {},
+            sharedBuffer,
+            stopOnFirstPhaseError: options.stopOnFirstPhaseError || false,
+            maxWorkflowIterations: options.maxWorkflowIterations || 1000
+        });
+        if (branchResult.branchResults.length > 0) {
+            const branch = branchResult.branchResults[0];
+            const branchPhaseResult = {
+                workflowId,
+                branchId: branch.branchId,
+                phaseId: `branch-${branch.branchId}`,
+                phaseIndex: phaseResults.length,
+                success: branch.success,
+                executionTime: branch.executionTime,
+                timestamp: new Date().toISOString(),
+                totalRequests: branchResult.totalRequests,
+                successfulRequests: branchResult.successfulRequests,
+                failedRequests: branchResult.failedRequests,
+                responses: []
+            };
+            results.set(nodeId, branchPhaseResult);
+            phaseResults.push(branchPhaseResult);
+            totalRequests += branchResult.totalRequests;
+            successfulRequests += branchResult.successfulRequests;
+            failedRequests += branchResult.failedRequests;
+            phaseResults.push(...branchResult.allPhaseResults);
+        }
+    };
+    const executeConditionalNode = async (node, nodeId) => {
+        if (!node.condition) {
+            throw new Error(`${formatLogContext({ workflowId })}Conditional node '${nodeId}' has no condition`);
+        }
+        visited.add(nodeId);
+        const nextNodeId = await executeWithPersistence(node.condition.evaluate, {
+            results,
+            sharedBuffer,
+            executionHistory,
+            currentNodeId: nodeId
+        }, options.statePersistence, { workflowId, phaseId: nodeId }, sharedBuffer);
+        if (options.logPhaseResults) {
+            console.info(`${formatLogContext({ workflowId, phaseId: nodeId })}stable-request: Conditional '${nodeId}' evaluated to: ${nextNodeId}`);
+        }
+        if (graph.nodes.has(nextNodeId)) {
+            await executeNode(nextNodeId);
+        }
+        else {
+            throw new Error(`${formatLogContext({ workflowId })}Conditional node '${nodeId}' evaluated to non-existent node '${nextNodeId}'`);
+        }
+    };
+    const executeParallelGroupNode = async (node, nodeId) => {
+        if (!node.parallelNodes || node.parallelNodes.length === 0) {
+            throw new Error(`${formatLogContext({ workflowId })}Parallel group node '${nodeId}' has no parallel nodes`);
+        }
+        if (options.logPhaseResults) {
+            console.info(`${formatLogContext({ workflowId })}stable-request: Starting parallel execution of: ${node.parallelNodes.join(', ')}`);
+        }
+        await Promise.all(node.parallelNodes.map(parallelNodeId => executeNode(parallelNodeId)));
+        if (options.logPhaseResults) {
+            console.info(`${formatLogContext({ workflowId })}stable-request: Parallel execution completed for: ${node.parallelNodes.join(', ')}`);
+        }
+    };
+    try {
+        await executeNode(graph.entryPoint);
+    }
+    catch (error) {
+        if (!terminatedEarly) {
+            terminatedEarly = true;
+            terminationReason = error.message || `${formatLogContext({ workflowId })}stable-request: Unknown error during execution`;
+        }
+    }
+    const executionTime = Date.now() - startTime;
+    const result = {
+        workflowId,
+        success: !terminatedEarly && failedRequests === 0,
+        executionTime,
+        timestamp: new Date().toISOString(),
+        totalPhases: phaseResults.length,
+        completedPhases: phaseResults.filter(p => p.success).length,
+        totalRequests,
+        successfulRequests,
+        failedRequests,
+        phases: phaseResults,
+        executionHistory,
+        terminatedEarly,
+        terminationReason
+    };
+    try {
+        result.metrics = MetricsAggregator.extractWorkflowMetrics(result);
+    }
+    catch (error) {
+    }
+    return result;
+}
+//# sourceMappingURL=execute-workflow-graph.js.map

package/dist/utilities/execute-workflow-graph.js.map

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

package/dist/utilities/fn-exec.d.ts

@@ -0,0 +1,3 @@
+import { FnExecResponse, TRIAL_MODE_OPTIONS, FunctionCacheConfig, ExecutionContext } from '../types/index.js';
+export declare function fnExec<TArgs extends any[] = any[], TReturn = any>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, args: TArgs, returnResult?: boolean, maxSerializableChars?: number, trialMode?: TRIAL_MODE_OPTIONS, cacheConfig?: FunctionCacheConfig<TArgs, TReturn>, executionContext?: ExecutionContext): Promise<FnExecResponse<TReturn>>;
+//# sourceMappingURL=fn-exec.d.ts.map

package/dist/utilities/fn-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-exec.d.ts","sourceRoot":"","sources":["../../src/utilities/fn-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK9G,wBAAsB,MAAM,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EACrE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAClD,IAAI,EAAE,KAAK,EACX,YAAY,UAAQ,EACpB,oBAAoB,SAAO,EAC3B,SAAS,GAAE,kBAAuC,EAClD,WAAW,CAAC,EAAE,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,EACjD,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAsElC"}

package/dist/utilities/fn-exec.js

@@ -0,0 +1,66 @@
+import { safelyStringify } from './safely-stringify.js';
+import { getGlobalFunctionCacheManager } from './function-cache-manager.js';
+import { formatLogContext } from './format-log-context.js';
+export async function fnExec(fn, args, returnResult = false, maxSerializableChars = 1000, trialMode = { enabled: false }, cacheConfig, executionContext) {
+    const startTime = Date.now();
+    let stopTime = 0;
+    const timestamp = new Date(startTime).toISOString();
+    let cacheManager = null;
+    if (cacheConfig?.enabled) {
+        cacheManager = getGlobalFunctionCacheManager(cacheConfig);
+        const cached = cacheManager.get(fn, args);
+        if (cached) {
+            return {
+                ok: true,
+                isRetryable: true,
+                data: returnResult ? cached.data : undefined,
+                timestamp: new Date(cached.timestamp).toISOString(),
+                executionTime: 0,
+                fromCache: true
+            };
+        }
+    }
+    try {
+        if (trialMode.enabled) {
+            const trialCondition = Math.random() <= (trialMode?.reqFailureProbability ?? 0);
+            if (trialCondition) {
+                console.error(`${formatLogContext(executionContext)}stable-request: Function execution failed in trial mode.\nFunction: ${fn.name || 'anonymous'}\nArgs:\n`, safelyStringify(args, maxSerializableChars));
+                throw new Error(`${formatLogContext(executionContext)}stable-request: Function execution failed in trial mode.`);
+            }
+            else {
+                stopTime = Date.now();
+                return {
+                    ok: true,
+                    isRetryable: true,
+                    data: returnResult ? { trialMode } : undefined,
+                    timestamp,
+                    executionTime: stopTime - startTime
+                };
+            }
+        }
+        const result = await fn(...args);
+        stopTime = Date.now();
+        if (cacheManager) {
+            cacheManager.set(fn, args, result);
+        }
+        return {
+            ok: true,
+            isRetryable: true,
+            data: returnResult ? result : undefined,
+            timestamp,
+            executionTime: stopTime - startTime
+        };
+    }
+    catch (error) {
+        stopTime = Date.now();
+        const executionTime = stopTime - startTime;
+        return {
+            ok: false,
+            isRetryable: true,
+            error: `${formatLogContext(executionContext)}stable-request: ${error.message || String(error)}`,
+            timestamp,
+            executionTime
+        };
+    }
+}
+//# sourceMappingURL=fn-exec.js.map

package/dist/utilities/fn-exec.js.map

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

package/dist/utilities/function-cache-manager.d.ts

@@ -0,0 +1,30 @@
+import { FunctionCacheConfig } from '../types/index.js';
+export interface CachedFunctionResponse<T = any> {
+    data: T;
+    timestamp: number;
+    expiresAt: number;
+}
+export declare class FunctionCacheManager {
+    private cache;
+    private config;
+    private stats;
+    constructor(config: FunctionCacheConfig<any, any>);
+    private generateKey;
+    get<TArgs extends any[], TReturn>(fn: (...args: TArgs) => any, args: TArgs): CachedFunctionResponse<TReturn> | null;
+    set<TArgs extends any[], TReturn>(fn: (...args: TArgs) => any, args: TArgs, data: TReturn): void;
+    clear(): void;
+    getStats(): {
+        hits: number;
+        misses: number;
+        hitRate: number;
+        missRate: number;
+        sets: number;
+        evictions: number;
+        size: number;
+        maxSize: number;
+        averageGetTime: number;
+        averageSetTime: number;
+    };
+}
+export declare function getGlobalFunctionCacheManager(config?: FunctionCacheConfig<any, any>): FunctionCacheManager;
+//# sourceMappingURL=function-cache-manager.d.ts.map

package/dist/utilities/function-cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-cache-manager.d.ts","sourceRoot":"","sources":["../../src/utilities/function-cache-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,GAAG;IAC7C,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,KAAK,CAOX;gBAEU,MAAM,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC;IASjD,OAAO,CAAC,WAAW;IAWnB,GAAG,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC9B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAC3B,IAAI,EAAE,KAAK,GACV,sBAAsB,CAAC,OAAO,CAAC,GAAG,IAAI;IA0BzC,GAAG,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC9B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAC3B,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,OAAO,GACZ,IAAI;IA4BP,KAAK,IAAI,IAAI;IAIb,QAAQ;;;;;;;;;;;;CAmBT;AAID,wBAAgB,6BAA6B,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,oBAAoB,CAK1G"}