@emmvish/stable-infra 1.0.0

package/dist/utilities/rate-limiter.js

@@ -0,0 +1,197 @@
+import { InfrastructurePersistenceCoordinator } from './infrastructure-persistence.js';
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    tokens;
+    lastRefillTime;
+    queue = [];
+    totalRequests = 0;
+    throttledRequests = 0;
+    completedRequests = 0;
+    peakQueueLength = 0;
+    totalQueueWaitTime = 0;
+    peakRequestRate = 0;
+    requestsInCurrentWindow = 0;
+    windowStartTime = Date.now();
+    persistence;
+    persistenceCoordinator;
+    initialized = false;
+    constructor(maxRequestsOrConfig, windowMs, persistence) {
+        if (typeof maxRequestsOrConfig === 'object') {
+            this.maxRequests = Math.max(1, Math.floor(maxRequestsOrConfig.maxRequests));
+            this.windowMs = Math.max(100, maxRequestsOrConfig.windowMs);
+            this.persistence = maxRequestsOrConfig.persistence;
+        }
+        else {
+            this.maxRequests = Math.max(1, Math.floor(maxRequestsOrConfig));
+            this.windowMs = Math.max(100, windowMs);
+            this.persistence = persistence;
+        }
+        this.persistenceCoordinator = this.persistence
+            ? new InfrastructurePersistenceCoordinator(this.persistence, 'rate-limiter')
+            : undefined;
+        this.tokens = this.maxRequests;
+        this.lastRefillTime = Date.now();
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.persistenceCoordinator) {
+            try {
+                const persistedState = await this.persistenceCoordinator.load();
+                if (persistedState) {
+                    this.restoreState(persistedState);
+                }
+            }
+            catch (error) {
+                console.warn('stable-infra: Unable to load rate limiter state from persistence.');
+            }
+        }
+        this.initialized = true;
+    }
+    restoreState(persistedState) {
+        this.tokens = persistedState.tokens;
+        this.lastRefillTime = persistedState.lastRefillTime;
+        this.totalRequests = persistedState.totalRequests;
+        this.throttledRequests = persistedState.throttledRequests;
+        this.completedRequests = persistedState.completedRequests;
+        this.peakQueueLength = persistedState.peakQueueLength;
+        this.totalQueueWaitTime = persistedState.totalQueueWaitTime;
+        this.peakRequestRate = persistedState.peakRequestRate;
+        this.requestsInCurrentWindow = persistedState.requestsInCurrentWindow;
+        this.windowStartTime = persistedState.windowStartTime;
+    }
+    getPersistedState() {
+        return {
+            tokens: this.tokens,
+            lastRefillTime: this.lastRefillTime,
+            totalRequests: this.totalRequests,
+            throttledRequests: this.throttledRequests,
+            completedRequests: this.completedRequests,
+            peakQueueLength: this.peakQueueLength,
+            totalQueueWaitTime: this.totalQueueWaitTime,
+            peakRequestRate: this.peakRequestRate,
+            requestsInCurrentWindow: this.requestsInCurrentWindow,
+            windowStartTime: this.windowStartTime
+        };
+    }
+    async persistState() {
+        if (this.persistenceCoordinator) {
+            try {
+                await this.persistenceCoordinator.store(this.getPersistedState());
+            }
+            catch (error) {
+                console.warn('stable-infra: Unable to store rate limiter state to persistence.');
+            }
+        }
+    }
+    refillTokens() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefillTime;
+        if (elapsed >= this.windowMs) {
+            const windowsPassed = Math.floor(elapsed / this.windowMs);
+            this.tokens = Math.min(this.maxRequests, this.tokens + (windowsPassed * this.maxRequests));
+            this.lastRefillTime = now;
+            this.requestsInCurrentWindow = 0;
+            this.windowStartTime = now;
+        }
+    }
+    async acquire() {
+        this.totalRequests++;
+        this.refillTokens();
+        if (this.tokens > 0) {
+            this.tokens--;
+            this.requestsInCurrentWindow++;
+            this.peakRequestRate = Math.max(this.peakRequestRate, this.requestsInCurrentWindow);
+            this.persistState();
+            return Promise.resolve();
+        }
+        this.throttledRequests++;
+        const queueStartTime = Date.now();
+        return new Promise((resolve) => {
+            this.queue.push(() => {
+                this.totalQueueWaitTime += (Date.now() - queueStartTime);
+                resolve();
+            });
+            this.peakQueueLength = Math.max(this.peakQueueLength, this.queue.length);
+            this.persistState();
+            this.scheduleRefill();
+        });
+    }
+    scheduleRefill() {
+        const now = Date.now();
+        const timeUntilRefill = this.windowMs - (now - this.lastRefillTime);
+        if (timeUntilRefill > 0) {
+            setTimeout(() => {
+                this.refillTokens();
+                this.processQueue();
+            }, timeUntilRefill);
+        }
+    }
+    processQueue() {
+        while (this.queue.length > 0 && this.tokens > 0) {
+            const next = this.queue.shift();
+            if (next) {
+                this.tokens--;
+                next();
+            }
+        }
+        if (this.queue.length > 0) {
+            this.scheduleRefill();
+        }
+        this.persistState();
+    }
+    async execute(fn) {
+        await this.acquire();
+        try {
+            const result = await fn();
+            this.completedRequests++;
+            this.persistState();
+            return result;
+        }
+        catch (error) {
+            this.completedRequests++;
+            this.persistState();
+            throw error;
+        }
+    }
+    async executeAll(fns) {
+        return Promise.all(fns.map(fn => this.execute(fn)));
+    }
+    getState() {
+        this.refillTokens();
+        const throttleRate = this.totalRequests > 0
+            ? (this.throttledRequests / this.totalRequests) * 100
+            : 0;
+        const averageQueueWaitTime = this.throttledRequests > 0
+            ? this.totalQueueWaitTime / this.throttledRequests
+            : 0;
+        const currentRate = this.requestsInCurrentWindow / ((Date.now() - this.windowStartTime) / 1000);
+        return {
+            availableTokens: this.tokens,
+            queueLength: this.queue.length,
+            maxRequests: this.maxRequests,
+            windowMs: this.windowMs,
+            totalRequests: this.totalRequests,
+            throttledRequests: this.throttledRequests,
+            completedRequests: this.completedRequests,
+            throttleRate: throttleRate,
+            peakQueueLength: this.peakQueueLength,
+            averageQueueWaitTime: averageQueueWaitTime,
+            peakRequestRate: this.peakRequestRate,
+            currentRequestRate: currentRate,
+            requestsInCurrentWindow: this.requestsInCurrentWindow
+        };
+    }
+}
+let globalRateLimiter = null;
+export function getGlobalRateLimiter(maxRequests, windowMs) {
+    if (!globalRateLimiter && maxRequests !== undefined && windowMs !== undefined) {
+        globalRateLimiter = new RateLimiter(maxRequests, windowMs);
+    }
+    return globalRateLimiter;
+}
+export function resetGlobalRateLimiter() {
+    globalRateLimiter = null;
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utilities/rate-limiter.js.map

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

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

@@ -0,0 +1,4 @@
+import { AxiosRequestConfig } from 'axios';
+import { ReqFnResponse, TRIAL_MODE_OPTIONS, CacheConfig, ExecutionContext } from '../types/index.js';
+export declare function reqFn<RequestDataType = any, ResponseDataType = any>(reqData: AxiosRequestConfig<RequestDataType>, resReq?: boolean, maxSerializableChars?: number, trialMode?: TRIAL_MODE_OPTIONS, cacheConfig?: CacheConfig, executionContext?: ExecutionContext): Promise<ReqFnResponse<ResponseDataType>>;
+//# sourceMappingURL=req-fn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"req-fn.d.ts","sourceRoot":"","sources":["../../src/utilities/req-fn.ts"],"names":[],"mappings":"AAAA,OAAc,EAAc,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMrG,wBAAsB,KAAK,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EACvE,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC5C,MAAM,UAAQ,EACd,oBAAoB,SAAO,EAC3B,SAAS,GAAE,kBAAuC,EAClD,WAAW,CAAC,EAAE,WAAW,EACzB,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAqG1C"}

package/dist/utilities/req-fn.js

@@ -0,0 +1,94 @@
+import axios from 'axios';
+import { safelyStringify } from './safely-stringify.js';
+import { isRetryableError } from './is-retryable-error.js';
+import { getGlobalCacheManager } from './cache-manager.js';
+import { formatLogContext } from './format-log-context.js';
+export async function reqFn(reqData, resReq = 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 = getGlobalCacheManager(cacheConfig);
+        const cached = cacheManager.get(reqData);
+        if (cached) {
+            return {
+                ok: true,
+                isRetryable: true,
+                data: resReq ? cached.data : undefined,
+                timestamp: new Date(cached.timestamp).toISOString(),
+                executionTime: 0,
+                statusCode: cached.status,
+                fromCache: true
+            };
+        }
+    }
+    try {
+        if (trialMode.enabled) {
+            const trialCondition = Math.random() <= (trialMode?.reqFailureProbability ?? 0);
+            if (trialCondition) {
+                console.error(`${formatLogContext(executionContext)}stable-infra: Request failed in trial mode.\nRequest data:\n`, safelyStringify(reqData, maxSerializableChars));
+                throw new Error('stable-infra: Request failed in trial mode.');
+            }
+            else {
+                stopTime = Date.now();
+                return {
+                    ok: true,
+                    isRetryable: true,
+                    timestamp,
+                    executionTime: stopTime - startTime,
+                    statusCode: 200,
+                    ...(resReq && { data: { trialMode } }),
+                    fromCache: false
+                };
+            }
+        }
+        const res = await axios.request(reqData);
+        stopTime = Date.now();
+        if (cacheManager) {
+            cacheManager.set(reqData, res.data, res.status, res.statusText, res.headers);
+        }
+        return resReq
+            ? {
+                ok: true,
+                isRetryable: true,
+                data: res?.data,
+                timestamp,
+                executionTime: stopTime - startTime,
+                statusCode: res?.status || 200,
+                fromCache: false
+            }
+            : {
+                ok: true,
+                isRetryable: true,
+                timestamp,
+                executionTime: stopTime - startTime,
+                statusCode: res?.status || 200,
+                fromCache: false
+            };
+    }
+    catch (e) {
+        stopTime = Date.now();
+        if (axios.isCancel(e)) {
+            return {
+                ok: false,
+                error: 'stable-infra: Request was cancelled.',
+                isRetryable: false,
+                timestamp,
+                executionTime: stopTime - startTime,
+                statusCode: e?.response?.status || 0,
+                fromCache: false
+            };
+        }
+        return {
+            ok: false,
+            error: `stable-infra: ${e?.response?.data ?? e?.message}`,
+            isRetryable: isRetryableError(e, trialMode),
+            timestamp,
+            executionTime: stopTime - startTime,
+            statusCode: e?.response?.status || 0,
+            fromCache: false
+        };
+    }
+}
+//# sourceMappingURL=req-fn.js.map

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

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

package/dist/utilities/safely-execute-unknown-function.d.ts

@@ -0,0 +1,2 @@
+export declare function safelyExecuteUnknownFunction(f: Function, ...args: any[]): Promise<any>;
+//# sourceMappingURL=safely-execute-unknown-function.d.ts.map

package/dist/utilities/safely-execute-unknown-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safely-execute-unknown-function.d.ts","sourceRoot":"","sources":["../../src/utilities/safely-execute-unknown-function.ts"],"names":[],"mappings":"AAAA,wBAAsB,4BAA4B,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,gBAM7E"}

package/dist/utilities/safely-execute-unknown-function.js

@@ -0,0 +1,8 @@
+export async function safelyExecuteUnknownFunction(f, ...args) {
+    const result = f(...args);
+    if (result instanceof Promise) {
+        await result;
+    }
+    return result;
+}
+//# sourceMappingURL=safely-execute-unknown-function.js.map

package/dist/utilities/safely-execute-unknown-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safely-execute-unknown-function.js","sourceRoot":"","sources":["../../src/utilities/safely-execute-unknown-function.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,CAAW,EAAE,GAAG,IAAW;IAC5E,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utilities/safely-stringify.d.ts

@@ -0,0 +1,4 @@
+export declare function safelyStringify(data: {
+    [key: string]: any;
+}, maxLength?: number): string;
+//# sourceMappingURL=safely-stringify.d.ts.map

package/dist/utilities/safely-stringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safely-stringify.d.ts","sourceRoot":"","sources":["../../src/utilities/safely-stringify.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAAE,SAAS,SAAO,GAAG,MAAM,CAUtF"}

package/dist/utilities/safely-stringify.js

@@ -0,0 +1,13 @@
+export function safelyStringify(data, maxLength = 1000) {
+    try {
+        const str = JSON.stringify(data);
+        if (maxLength < 0) {
+            maxLength = 1000;
+        }
+        return str.length > maxLength ? str.slice(0, maxLength) + '...' : str;
+    }
+    catch {
+        return '[Unserializable data]';
+    }
+}
+//# sourceMappingURL=safely-stringify.js.map

package/dist/utilities/safely-stringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safely-stringify.js","sourceRoot":"","sources":["../../src/utilities/safely-stringify.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,IAA4B,EAAE,SAAS,GAAG,IAAI;IAC5E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/utilities/stable-buffer-replay.d.ts

@@ -0,0 +1,3 @@
+import type { StableBufferReplayOptions, StableBufferReplayResult } from '../types/index.js';
+export declare function replayStableBufferTransactions(options: StableBufferReplayOptions): Promise<StableBufferReplayResult>;
+//# sourceMappingURL=stable-buffer-replay.d.ts.map

package/dist/utilities/stable-buffer-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-buffer-replay.d.ts","sourceRoot":"","sources":["../../src/utilities/stable-buffer-replay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,yBAAyB,EACzB,wBAAwB,EAGzB,MAAM,mBAAmB,CAAC;AAsC3B,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA8EnC"}

package/dist/utilities/stable-buffer-replay.js

@@ -0,0 +1,94 @@
+import { StableBuffer } from '../core/stable-buffer.js';
+import { isStableBuffer } from './buffer-utils.js';
+const resolveBuffer = (buffer, initialState) => {
+    if (isStableBuffer(buffer)) {
+        return buffer;
+    }
+    if (buffer && typeof buffer === 'object') {
+        return new StableBuffer({ initialState: buffer });
+    }
+    return new StableBuffer({ initialState: initialState ?? {} });
+};
+const resolveTimestamp = (value) => {
+    if (!value)
+        return 0;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? 0 : parsed;
+};
+const orderLogs = (logs) => {
+    return [...logs].sort((a, b) => {
+        const byStarted = resolveTimestamp(a.startedAt) - resolveTimestamp(b.startedAt);
+        if (byStarted !== 0)
+            return byStarted;
+        const byQueued = resolveTimestamp(a.queuedAt) - resolveTimestamp(b.queuedAt);
+        if (byQueued !== 0)
+            return byQueued;
+        return (a.transactionId || '').localeCompare(b.transactionId || '');
+    });
+};
+const resolveHookHandler = (handlerMap, hookName) => {
+    if (!hookName)
+        return undefined;
+    return handlerMap[hookName];
+};
+export async function replayStableBufferTransactions(options) {
+    const { logs, handlers, buffer, initialState, allowUnknownHooks = false, dedupe = true, activityFilter, sort = true, onApply, onSkip, onError } = options;
+    const resolvedBuffer = resolveBuffer(buffer, initialState);
+    const orderedLogs = sort ? orderLogs(logs) : logs;
+    const appliedIds = new Set();
+    let applied = 0;
+    let skipped = 0;
+    const errors = [];
+    for (const log of orderedLogs) {
+        if (activityFilter && !activityFilter(log)) {
+            skipped += 1;
+            onSkip?.(log, 'filtered');
+            continue;
+        }
+        if (dedupe && log.transactionId && appliedIds.has(log.transactionId)) {
+            skipped += 1;
+            onSkip?.(log, 'duplicate');
+            continue;
+        }
+        const handler = resolveHookHandler(handlers, log.hookName);
+        if (!handler) {
+            if (!allowUnknownHooks) {
+                const error = new Error(`No replay handler registered for hook '${log.hookName ?? 'unknown'}'`);
+                errors.push({ log, error });
+                onError?.(log, error);
+                continue;
+            }
+            skipped += 1;
+            onSkip?.(log, 'missing-handler');
+            continue;
+        }
+        const transactionOptions = {
+            activity: 'replay',
+            hookName: log.hookName,
+            hookParams: log.hookParams,
+            workflowId: log.workflowId,
+            branchId: log.branchId,
+            phaseId: log.phaseId,
+            requestId: log.requestId
+        };
+        try {
+            await resolvedBuffer.run((state) => handler(state, log), transactionOptions);
+            applied += 1;
+            if (dedupe && log.transactionId) {
+                appliedIds.add(log.transactionId);
+            }
+            onApply?.(log);
+        }
+        catch (error) {
+            errors.push({ log, error });
+            onError?.(log, error);
+        }
+    }
+    return {
+        buffer: resolvedBuffer,
+        applied,
+        skipped,
+        errors
+    };
+}
+//# sourceMappingURL=stable-buffer-replay.js.map

package/dist/utilities/stable-buffer-replay.js.map

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

package/dist/utilities/validate-trial-mode-probabilities.d.ts

@@ -0,0 +1,3 @@
+import { TRIAL_MODE_OPTIONS } from '../types/index.js';
+export declare function validateTrialModeProbabilities(trialMode: TRIAL_MODE_OPTIONS): void;
+//# sourceMappingURL=validate-trial-mode-probabilities.d.ts.map

package/dist/utilities/validate-trial-mode-probabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-trial-mode-probabilities.d.ts","sourceRoot":"","sources":["../../src/utilities/validate-trial-mode-probabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,kBAAkB,QAe3E"}

package/dist/utilities/validate-trial-mode-probabilities.js

@@ -0,0 +1,13 @@
+export function validateTrialModeProbabilities(trialMode) {
+    if (trialMode.enabled) {
+        const reqFailureProbability = trialMode.reqFailureProbability ?? 0;
+        const retryFailureProbability = trialMode.retryFailureProbability ?? 0;
+        if (reqFailureProbability < 0 || reqFailureProbability > 1) {
+            throw new Error('stable-infra: Unable to proceed as request failure probability must be between 0 and 1.');
+        }
+        if (retryFailureProbability < 0 || retryFailureProbability > 1) {
+            throw new Error('stable-infra: Unable to proceed as retry failure probability must be between 0 and 1.');
+        }
+    }
+}
+//# sourceMappingURL=validate-trial-mode-probabilities.js.map

package/dist/utilities/validate-trial-mode-probabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-trial-mode-probabilities.js","sourceRoot":"","sources":["../../src/utilities/validate-trial-mode-probabilities.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,8BAA8B,CAAC,SAA6B;IAC1E,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,qBAAqB,GAAG,SAAS,CAAC,qBAAqB,IAAI,CAAC,CAAC;QACnE,MAAM,uBAAuB,GAAG,SAAS,CAAC,uBAAuB,IAAI,CAAC,CAAC;QACvE,IAAI,qBAAqB,GAAG,CAAC,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QACD,IAAI,uBAAuB,GAAG,CAAC,IAAI,uBAAuB,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+import { WorkflowGraph, WorkflowGraphValidationResult } from '../types/index.js';
+export declare function validateWorkflowGraph<RequestDataType = any, ResponseDataType = any, FunctionArgsType extends any[] = any, FunctionReturnType = any>(graph: WorkflowGraph<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>): WorkflowGraphValidationResult;
+export declare function detectCycles<RequestDataType = any, ResponseDataType = any, FunctionArgsType extends any[] = any[], FunctionReturnType = any>(graph: WorkflowGraph<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>): string[][];
+export declare function detectUnreachableNodes<RequestDataType = any, ResponseDataType = any, FunctionArgsType extends any[] = any[], FunctionReturnType = any>(graph: WorkflowGraph<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>): string[];
+export declare function detectOrphanNodes<RequestDataType = any, ResponseDataType = any, FunctionArgsType extends any[] = any[], FunctionReturnType = any>(graph: WorkflowGraph<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>): string[];
+export declare function calculateGraphDepth<RequestDataType = any, ResponseDataType = any, FunctionArgsType extends any[] = any[], FunctionReturnType = any>(graph: WorkflowGraph<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>): number;
+//# sourceMappingURL=validate-workflow-graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow-graph.d.ts","sourceRoot":"","sources":["../../src/utilities/validate-workflow-graph.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,6BAA6B,EAE9B,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,qBAAqB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAAE,gBAAgB,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,kBAAkB,GAAG,GAAG,EACjJ,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,GAC5F,6BAA6B,CA0D/B;AAiED,wBAAgB,YAAY,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAAE,gBAAgB,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,kBAAkB,GAAG,GAAG,EAC1I,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,GAC5F,MAAM,EAAE,EAAE,CAyCZ;AAED,wBAAgB,sBAAsB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAAE,gBAAgB,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,kBAAkB,GAAG,GAAG,EACpJ,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,GAC5F,MAAM,EAAE,CAoDV;AAED,wBAAgB,iBAAiB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAAE,gBAAgB,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,kBAAkB,GAAG,GAAG,EAC/I,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,GAC5F,MAAM,EAAE,CA+BV;AAED,wBAAgB,mBAAmB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAAE,gBAAgB,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,kBAAkB,GAAG,GAAG,EACjJ,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,GAC5F,MAAM,CA4BR"}