@emmvish/stable-infra 1.0.0

package/dist/constants/index.d.ts

@@ -0,0 +1,15 @@
+import { API_GATEWAY_OPTIONS, ApiRequestOptionsMapping } from "../types/index.js";
+export declare const extractCommonOptionsKeys: (keyof API_GATEWAY_OPTIONS)[];
+export declare const PrepareApiRequestOptionsMapping: ApiRequestOptionsMapping[];
+export declare const REQUEST_METRICS_TO_VALIDATE_KEYS: readonly ["totalAttempts", "successfulAttempts", "failedAttempts", "totalExecutionTime", "averageAttemptTime"];
+export declare const API_GATEWAY_METRICS_TO_VALIDATE_KEYS: readonly ["totalRequests", "successfulRequests", "failedRequests", "successRate", "failureRate", "executionTime", "throughput", "averageRequestDuration"];
+export declare const WORKFLOW_METRICS_TO_VALIDATE_KEYS: readonly ["totalPhases", "completedPhases", "failedPhases", "totalRequests", "successfulRequests", "failedRequests", "requestSuccessRate", "requestFailureRate", "executionTime", "averagePhaseExecutionTime", "throughput", "phaseCompletionRate"];
+export declare const CIRCUIT_BREAKER_METRICS_TO_VALIDATE_KEYS: readonly ["failureRate", "totalRequests", "failedRequests"];
+export declare const CACHE_METRICS_TO_VALIDATE_KEYS: readonly ["hitRate", "missRate", "utilizationPercentage", "evictionRate"];
+export declare const RATE_LIMITER_METRICS_TO_VALIDATE_KEYS: readonly ["throttleRate", "queueLength", "utilizationPercentage", "averageQueueWaitTime"];
+export declare const CONCURRENCY_LIMITER_METRICS_TO_VALIDATE_KEYS: readonly ["utilizationPercentage", "queueLength", "averageQueueWaitTime"];
+export declare const PHASE_METRICS_TO_VALIDATE_KEYS: readonly ["totalRequests", "successfulRequests", "failedRequests", "requestSuccessRate", "requestFailureRate", "executionTime"];
+export declare const BRANCH_METRICS_TO_VALIDATE_KEYS: readonly ["totalPhases", "completedPhases", "failedPhases", "phaseCompletionRate", "totalRequests", "successfulRequests", "failedRequests", "requestSuccessRate", "executionTime"];
+export declare const SCHEDULER_METRICS_TO_VALIDATE_KEYS: readonly ["totalJobs", "queued", "running", "completed", "failed", "dropped", "totalRuns", "successRate", "failureRate", "throughput", "averageExecutionTime", "averageQueueDelay"];
+export declare const STABLE_BUFFER_METRICS_TO_VALIDATE_KEYS: readonly ["totalTransactions", "averageQueueWaitMs"];
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElF,eAAO,MAAM,wBAAwB,EAAE,CAAC,MAAM,mBAAmB,CAAC,EAsBxD,CAAC;AAEX,eAAO,MAAM,+BAA+B,EAAE,wBAAwB,EAqB5D,CAAC;AAEX,eAAO,MAAM,gCAAgC,gHAMnC,CAAC;AAEX,eAAO,MAAM,oCAAoC,2JASvC,CAAC;AAEX,eAAO,MAAM,iCAAiC,qPAapC,CAAC;AAEX,eAAO,MAAM,wCAAwC,6DAI3C,CAAC;AAEX,eAAO,MAAM,8BAA8B,2EAKjC,CAAC;AAEX,eAAO,MAAM,qCAAqC,2FAKxC,CAAC;AAEX,eAAO,MAAM,4CAA4C,2EAI/C,CAAC;AAEX,eAAO,MAAM,8BAA8B,iIAOjC,CAAC;AAEX,eAAO,MAAM,+BAA+B,oLAUlC,CAAC;AAEX,eAAO,MAAM,kCAAkC,qLAarC,CAAC;AAEX,eAAO,MAAM,sCAAsC,sDAGzC,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,136 @@
+export const extractCommonOptionsKeys = [
+    'commonPreExecution',
+    'commonHookParams',
+    'commonMaxAllowedWait',
+    'commonRequestData',
+    'commonResponseAnalyzer',
+    'commonHandleErrors',
+    'commonHandleSuccessfulAttemptData',
+    'commonFinalErrorAnalyzer',
+    'commonResReq',
+    'commonAttempts',
+    'commonPerformAllAttempts',
+    'commonWait',
+    'commonRetryStrategy',
+    'commonJitter',
+    'commonLogAllErrors',
+    'commonLogAllSuccessfulAttempts',
+    'commonMaxSerializableChars',
+    'commonTrialMode',
+    'commonCache',
+    'commonStatePersistence',
+    'commonExecutionTimeout',
+];
+export const PrepareApiRequestOptionsMapping = [
+    { localKey: 'preExecution', commonKey: 'commonPreExecution', groupCommonKey: 'commonPreExecution', targetKey: 'preExecution' },
+    { localKey: 'hookParams', commonKey: 'commonHookParams', groupCommonKey: 'commonHookParams', targetKey: 'hookParams' },
+    { localKey: 'maxAllowedWait', commonKey: 'commonMaxAllowedWait', groupCommonKey: 'commonMaxAllowedWait', targetKey: 'maxAllowedWait' },
+    { localKey: 'resReq', commonKey: 'commonResReq', groupCommonKey: 'commonResReq', targetKey: 'resReq' },
+    { localKey: 'attempts', commonKey: 'commonAttempts', groupCommonKey: 'commonAttempts', targetKey: 'attempts' },
+    { localKey: 'performAllAttempts', commonKey: 'commonPerformAllAttempts', groupCommonKey: 'commonPerformAllAttempts', targetKey: 'performAllAttempts' },
+    { localKey: 'wait', commonKey: 'commonWait', groupCommonKey: 'commonWait', targetKey: 'wait' },
+    { localKey: 'retryStrategy', commonKey: 'commonRetryStrategy', groupCommonKey: 'commonRetryStrategy', targetKey: 'retryStrategy' },
+    { localKey: 'jitter', commonKey: 'commonJitter', groupCommonKey: 'commonJitter', targetKey: 'jitter' },
+    { localKey: 'logAllErrors', commonKey: 'commonLogAllErrors', groupCommonKey: 'commonLogAllErrors', targetKey: 'logAllErrors' },
+    { localKey: 'logAllSuccessfulAttempts', commonKey: 'commonLogAllSuccessfulAttempts', groupCommonKey: 'commonLogAllSuccessfulAttempts', targetKey: 'logAllSuccessfulAttempts' },
+    { localKey: 'maxSerializableChars', commonKey: 'commonMaxSerializableChars', groupCommonKey: 'commonMaxSerializableChars', targetKey: 'maxSerializableChars' },
+    { localKey: 'trialMode', commonKey: 'commonTrialMode', groupCommonKey: 'commonTrialMode', targetKey: 'trialMode' },
+    { localKey: 'responseAnalyzer', commonKey: 'commonResponseAnalyzer', groupCommonKey: 'commonResponseAnalyzer', targetKey: 'responseAnalyzer' },
+    { localKey: 'handleErrors', commonKey: 'commonHandleErrors', groupCommonKey: 'commonHandleErrors', targetKey: 'handleErrors' },
+    { localKey: 'handleSuccessfulAttemptData', commonKey: 'commonHandleSuccessfulAttemptData', groupCommonKey: 'commonHandleSuccessfulAttemptData', targetKey: 'handleSuccessfulAttemptData' },
+    { localKey: 'finalErrorAnalyzer', commonKey: 'commonFinalErrorAnalyzer', groupCommonKey: 'commonFinalErrorAnalyzer', targetKey: 'finalErrorAnalyzer' },
+    { localKey: 'cache', commonKey: 'commonCache', groupCommonKey: 'commonCache', targetKey: 'cache' },
+    { localKey: 'commonBuffer', commonKey: 'sharedBuffer', groupCommonKey: 'sharedBuffer', targetKey: 'commonBuffer' },
+    { localKey: 'statePersistence', commonKey: 'commonStatePersistence', groupCommonKey: 'commonStatePersistence', targetKey: 'statePersistence' },
+];
+export const REQUEST_METRICS_TO_VALIDATE_KEYS = [
+    'totalAttempts',
+    'successfulAttempts',
+    'failedAttempts',
+    'totalExecutionTime',
+    'averageAttemptTime'
+];
+export const API_GATEWAY_METRICS_TO_VALIDATE_KEYS = [
+    'totalRequests',
+    'successfulRequests',
+    'failedRequests',
+    'successRate',
+    'failureRate',
+    'executionTime',
+    'throughput',
+    'averageRequestDuration'
+];
+export const WORKFLOW_METRICS_TO_VALIDATE_KEYS = [
+    'totalPhases',
+    'completedPhases',
+    'failedPhases',
+    'totalRequests',
+    'successfulRequests',
+    'failedRequests',
+    'requestSuccessRate',
+    'requestFailureRate',
+    'executionTime',
+    'averagePhaseExecutionTime',
+    'throughput',
+    'phaseCompletionRate'
+];
+export const CIRCUIT_BREAKER_METRICS_TO_VALIDATE_KEYS = [
+    'failureRate',
+    'totalRequests',
+    'failedRequests'
+];
+export const CACHE_METRICS_TO_VALIDATE_KEYS = [
+    'hitRate',
+    'missRate',
+    'utilizationPercentage',
+    'evictionRate'
+];
+export const RATE_LIMITER_METRICS_TO_VALIDATE_KEYS = [
+    'throttleRate',
+    'queueLength',
+    'utilizationPercentage',
+    'averageQueueWaitTime'
+];
+export const CONCURRENCY_LIMITER_METRICS_TO_VALIDATE_KEYS = [
+    'utilizationPercentage',
+    'queueLength',
+    'averageQueueWaitTime'
+];
+export const PHASE_METRICS_TO_VALIDATE_KEYS = [
+    'totalRequests',
+    'successfulRequests',
+    'failedRequests',
+    'requestSuccessRate',
+    'requestFailureRate',
+    'executionTime'
+];
+export const BRANCH_METRICS_TO_VALIDATE_KEYS = [
+    'totalPhases',
+    'completedPhases',
+    'failedPhases',
+    'phaseCompletionRate',
+    'totalRequests',
+    'successfulRequests',
+    'failedRequests',
+    'requestSuccessRate',
+    'executionTime'
+];
+export const SCHEDULER_METRICS_TO_VALIDATE_KEYS = [
+    'totalJobs',
+    'queued',
+    'running',
+    'completed',
+    'failed',
+    'dropped',
+    'totalRuns',
+    'successRate',
+    'failureRate',
+    'throughput',
+    'averageExecutionTime',
+    'averageQueueDelay'
+];
+export const STABLE_BUFFER_METRICS_TO_VALIDATE_KEYS = [
+    'totalTransactions',
+    'averageQueueWaitMs'
+];
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+export { stableRequest } from './stable-request.js';
+export { stableFunction } from './stable-function.js';
+export { stableApiGateway } from './stable-api-gateway.js';
+export { stableWorkflow } from './stable-workflow.js';
+export { stableWorkflowGraph } from './stable-workflow-graph.js';
+export { StableScheduler } from './stable-scheduler.js';
+export { StableBuffer } from './stable-buffer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+export { stableRequest } from './stable-request.js';
+export { stableFunction } from './stable-function.js';
+export { stableApiGateway } from './stable-api-gateway.js';
+export { stableWorkflow } from './stable-workflow.js';
+export { stableWorkflowGraph } from './stable-workflow-graph.js';
+export { StableScheduler } from './stable-scheduler.js';
+export { StableBuffer } from './stable-buffer.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/stable-api-gateway.d.ts

@@ -0,0 +1,4 @@
+import { API_GATEWAY_OPTIONS, API_GATEWAY_REQUEST, API_GATEWAY_FUNCTION, API_GATEWAY_ITEM, API_GATEWAY_RESULT } from '../types/index.js';
+export declare function stableApiGateway<RequestDataType = any, ResponseDataType = any>(requests: API_GATEWAY_REQUEST<RequestDataType, ResponseDataType>[] | API_GATEWAY_ITEM<RequestDataType, ResponseDataType, any[], any>[], options: API_GATEWAY_OPTIONS<RequestDataType, ResponseDataType>): Promise<API_GATEWAY_RESULT<ResponseDataType>>;
+export declare function stableApiGateway<RequestDataType = any, ResponseDataType = any, FunctionArgsType extends any[] = any[], FunctionReturnType = any>(requests: API_GATEWAY_REQUEST<RequestDataType, ResponseDataType>[] | API_GATEWAY_ITEM<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>[], functions: API_GATEWAY_FUNCTION<FunctionArgsType, FunctionReturnType>[], options: API_GATEWAY_OPTIONS<RequestDataType, ResponseDataType, FunctionArgsType, FunctionReturnType>): Promise<API_GATEWAY_RESULT<ResponseDataType | FunctionReturnType>>;
+//# sourceMappingURL=stable-api-gateway.d.ts.map

package/dist/core/stable-api-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-api-gateway.d.ts","sourceRoot":"","sources":["../../src/core/stable-api-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAEhB,kBAAkB,EAQrB,MAAM,mBAAmB,CAAC;AAe3B,wBAAsB,gBAAgB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAChF,QAAQ,EAAE,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,CAAC,eAAe,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,EAAE,EACtI,OAAO,EAAE,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAChE,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEjD,wBAAsB,gBAAgB,CAAC,eAAe,GAAG,GAAG,EAAE,gBAAgB,GAAG,GAAG,EAAE,gBAAgB,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,kBAAkB,GAAG,GAAG,EAClJ,QAAQ,EAAE,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,EAChK,SAAS,EAAE,oBAAoB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,EACvE,OAAO,EAAE,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,GACtG,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,CAAC,CAAC"}

package/dist/core/stable-api-gateway.js

@@ -0,0 +1,146 @@
+import { executeConcurrently, executeSequentially, extractCommonRequestConfigOptions as extractCommonOptions, MetricsAggregator, MetricsValidator, CircuitBreaker, getGlobalCircuitBreaker, getGlobalCacheManager, getGlobalRateLimiter, getGlobalConcurrencyLimiter } from '../utilities/index.js';
+import { RequestOrFunction } from '../enums/index.js';
+export async function stableApiGateway(requests = [], functionsOrOptions, options) {
+    const startTime = Date.now();
+    let functions = [];
+    let finalOptions = {};
+    if (Array.isArray(functionsOrOptions)) {
+        functions = functionsOrOptions;
+        finalOptions = options || {};
+    }
+    else {
+        finalOptions = functionsOrOptions || {};
+    }
+    if (finalOptions.maxTimeout) {
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                const contextStr = finalOptions.executionContext
+                    ? ` [${Object.entries(finalOptions.executionContext).map(([k, v]) => `${k}=${v}`).join(', ')}]`
+                    : '';
+                reject(new Error(`stable-infra: Gateway execution exceeded maxTimeout of ${finalOptions.maxTimeout}ms${contextStr}`));
+            }, finalOptions.maxTimeout);
+        });
+        const executionPromise = executeGateway(requests, functions, finalOptions, startTime);
+        return Promise.race([executionPromise, timeoutPromise]);
+    }
+    return executeGateway(requests, functions, finalOptions, startTime);
+}
+async function executeGateway(requests, functions, finalOptions, startTime) {
+    let transactionLogs = finalOptions.transactionLogs;
+    if (finalOptions.loadTransactionLogs) {
+        try {
+            transactionLogs = await finalOptions.loadTransactionLogs(finalOptions.executionContext || {});
+        }
+        catch (e) {
+            console.error(`stable-infra: Failed to load transaction logs: ${e.message}`);
+        }
+    }
+    const { concurrentExecution = true, stopOnFirstError = false, requestGroups = [], maxConcurrentRequests, rateLimit, circuitBreaker, enableRacing = false, } = finalOptions;
+    let items = [];
+    if (requests.length > 0 && 'type' in requests[0]) {
+        items = requests;
+    }
+    else {
+        items = requests.map(req => ({
+            type: RequestOrFunction.REQUEST,
+            request: req
+        }));
+        items.push(...functions.map(fn => ({
+            type: RequestOrFunction.FUNCTION,
+            function: fn
+        })));
+    }
+    if (items.length === 0) {
+        const executionTime = Date.now() - startTime;
+        const emptyResult = [];
+        emptyResult.metrics = {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            successRate: 0,
+            failureRate: 0,
+            executionTime,
+            timestamp: new Date().toISOString(),
+            throughput: 0,
+            averageRequestDuration: 0
+        };
+        return emptyResult;
+    }
+    const requestExecutionOptions = {
+        stopOnFirstError,
+        requestGroups,
+        sharedBuffer: finalOptions.sharedBuffer,
+        ...(maxConcurrentRequests !== undefined && { maxConcurrentRequests }),
+        ...(rateLimit !== undefined && { rateLimit }),
+        ...(circuitBreaker !== undefined && { circuitBreaker }),
+        ...(enableRacing !== undefined && { enableRacing }),
+        ...extractCommonOptions(finalOptions),
+        executionContext: finalOptions.executionContext,
+        transactionLogs
+    };
+    let responses;
+    if (concurrentExecution) {
+        responses = await executeConcurrently(items, requestExecutionOptions);
+    }
+    else {
+        responses = await executeSequentially(items, requestExecutionOptions);
+    }
+    const successfulRequests = responses.filter(r => r.success).length;
+    const failedRequests = responses.filter(r => !r.success).length;
+    const totalRequests = responses.length;
+    const executionTime = Date.now() - startTime;
+    const throughput = executionTime > 0 ? (totalRequests / (executionTime / 1000)) : 0;
+    const averageRequestDuration = totalRequests > 0 ? executionTime / totalRequests : 0;
+    const result = responses;
+    result.metrics = {
+        totalRequests,
+        successfulRequests,
+        failedRequests,
+        successRate: totalRequests > 0 ? (successfulRequests / totalRequests) * 100 : 0,
+        failureRate: totalRequests > 0 ? (failedRequests / totalRequests) * 100 : 0,
+        executionTime,
+        timestamp: new Date().toISOString(),
+        throughput,
+        averageRequestDuration,
+        requestGroups: MetricsAggregator.extractRequestGroupMetrics(responses)
+    };
+    const infrastructureMetrics = {};
+    if (circuitBreaker) {
+        const cb = circuitBreaker instanceof CircuitBreaker ? circuitBreaker : getGlobalCircuitBreaker();
+        if (cb) {
+            infrastructureMetrics.circuitBreaker = MetricsAggregator.extractCircuitBreakerMetrics(cb);
+        }
+    }
+    if (finalOptions.commonCache) {
+        const cache = getGlobalCacheManager();
+        if (cache) {
+            infrastructureMetrics.cache = MetricsAggregator.extractCacheMetrics(cache);
+        }
+    }
+    if (rateLimit) {
+        const rateLimiter = getGlobalRateLimiter();
+        if (rateLimiter) {
+            infrastructureMetrics.rateLimiter = MetricsAggregator.extractRateLimiterMetrics(rateLimiter);
+        }
+    }
+    if (maxConcurrentRequests) {
+        const concurrencyLimiter = getGlobalConcurrencyLimiter();
+        if (concurrencyLimiter) {
+            infrastructureMetrics.concurrencyLimiter = MetricsAggregator.extractConcurrencyLimiterMetrics(concurrencyLimiter);
+        }
+    }
+    if (Object.keys(infrastructureMetrics).length > 0) {
+        result.metrics.infrastructureMetrics = infrastructureMetrics;
+    }
+    if (finalOptions.metricsGuardrails) {
+        const validation = MetricsValidator.validateApiGatewayMetrics(result.metrics, finalOptions.metricsGuardrails);
+        if (result.metrics.infrastructureMetrics) {
+            const infraValidation = MetricsValidator.validateInfrastructureMetrics(result.metrics.infrastructureMetrics, finalOptions.metricsGuardrails);
+            validation.anomalies.push(...infraValidation.anomalies);
+            validation.isValid = validation.isValid && infraValidation.isValid;
+        }
+        result.metrics.validation = validation;
+    }
+    return result;
+}
+//# sourceMappingURL=stable-api-gateway.js.map

package/dist/core/stable-api-gateway.js.map

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

package/dist/core/stable-buffer.d.ts

@@ -0,0 +1,23 @@
+import type { StableBufferMetrics, StableBufferState, StableBufferOptions, StableBufferTransactionOptions } from '../types/index.js';
+export declare class StableBuffer {
+    private state;
+    private queue;
+    private totalTransactions;
+    private totalWaitMs;
+    private transactionSequence;
+    private cloneState;
+    private metricsGuardrails?;
+    private transactionTimeoutMs?;
+    private logTransaction?;
+    constructor(options?: StableBufferOptions);
+    read(): StableBufferState;
+    getState(): StableBufferState;
+    setState(nextState: StableBufferState): void;
+    run<T>(fn: (state: StableBufferState) => T | Promise<T>, options?: StableBufferTransactionOptions): Promise<T>;
+    private wrapWithTimeout;
+    update(mutator: (state: StableBufferState) => void | Promise<void>, options?: StableBufferTransactionOptions): Promise<void>;
+    transaction<T>(fn: (state: StableBufferState) => T | Promise<T>, options?: StableBufferTransactionOptions): Promise<T>;
+    private createTransactionId;
+    getMetrics(): StableBufferMetrics;
+}
+//# sourceMappingURL=stable-buffer.d.ts.map

package/dist/core/stable-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-buffer.d.ts","sourceRoot":"","sources":["../../src/core/stable-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,EAE/B,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,iBAAiB,CAAC,CAAgC;IAC1D,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,cAAc,CAAC,CAAgC;gBAE3C,OAAO,GAAE,mBAAwB;IAa7C,IAAI,IAAI,iBAAiB;IAIzB,QAAQ,IAAI,iBAAiB;IAI7B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAItC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,CAAC,CAAC;YAqD1G,eAAe;IAoBvB,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5H,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5H,OAAO,CAAC,mBAAmB;IAK3B,UAAU,IAAI,mBAAmB;CAiBlC"}

package/dist/core/stable-buffer.js

@@ -0,0 +1,127 @@
+import { MetricsValidator } from '../utilities/index.js';
+export class StableBuffer {
+    state;
+    queue = Promise.resolve();
+    totalTransactions = 0;
+    totalWaitMs = 0;
+    transactionSequence = 0;
+    cloneState;
+    metricsGuardrails;
+    transactionTimeoutMs;
+    logTransaction;
+    constructor(options = {}) {
+        this.state = options.initialState ? { ...options.initialState } : {};
+        this.cloneState = options.clone ?? ((value) => {
+            if (typeof structuredClone === 'function') {
+                return structuredClone(value);
+            }
+            return JSON.parse(JSON.stringify(value));
+        });
+        this.metricsGuardrails = options.metricsGuardrails;
+        this.transactionTimeoutMs = options.transactionTimeoutMs ?? 0;
+        this.logTransaction = options.logTransaction;
+    }
+    read() {
+        return this.cloneState(this.state);
+    }
+    getState() {
+        return this.state;
+    }
+    setState(nextState) {
+        this.state = nextState;
+    }
+    async run(fn, options = {}) {
+        const queuedAt = Date.now();
+        const transactionId = this.createTransactionId();
+        const task = async () => {
+            const startAt = Date.now();
+            const queueWaitMs = Math.max(0, startAt - queuedAt);
+            this.totalWaitMs += queueWaitMs;
+            this.totalTransactions += 1;
+            const stateBefore = this.cloneState(this.state);
+            let success = false;
+            let errorMessage;
+            try {
+                const result = await fn(this.state);
+                success = true;
+                return result;
+            }
+            catch (error) {
+                errorMessage = error instanceof Error ? error.message : String(error);
+                throw error;
+            }
+            finally {
+                const finishedAt = Date.now();
+                const stateAfter = this.cloneState(this.state);
+                if (this.logTransaction) {
+                    const logEntry = {
+                        ...options,
+                        transactionId,
+                        queuedAt: new Date(queuedAt).toISOString(),
+                        startedAt: new Date(startAt).toISOString(),
+                        finishedAt: new Date(finishedAt).toISOString(),
+                        durationMs: Math.max(0, finishedAt - startAt),
+                        queueWaitMs,
+                        success,
+                        errorMessage,
+                        stateBefore,
+                        stateAfter
+                    };
+                    try {
+                        await this.logTransaction(logEntry);
+                    }
+                    catch {
+                        // Swallow logging errors to avoid breaking transactions
+                    }
+                }
+            }
+        };
+        const executionPromise = this.queue.then(task, task);
+        this.queue = executionPromise.then(() => undefined, () => undefined);
+        return this.wrapWithTimeout(executionPromise, this.transactionTimeoutMs);
+    }
+    async wrapWithTimeout(promise, timeoutMs) {
+        if (!timeoutMs || timeoutMs <= 0) {
+            return promise;
+        }
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                reject(new Error(`StableBuffer transaction timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+        return Promise.race([promise, timeoutPromise]).finally(() => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        });
+    }
+    async update(mutator, options) {
+        await this.run(async (state) => {
+            await mutator(state);
+        }, options);
+    }
+    async transaction(fn, options) {
+        return this.run(fn, options);
+    }
+    createTransactionId() {
+        this.transactionSequence += 1;
+        return `stable-buffer-${Date.now()}-${this.transactionSequence}`;
+    }
+    getMetrics() {
+        const metrics = {
+            totalTransactions: this.totalTransactions,
+            averageQueueWaitMs: this.totalTransactions > 0 ? this.totalWaitMs / this.totalTransactions : 0
+        };
+        if (!this.metricsGuardrails) {
+            return metrics;
+        }
+        return {
+            ...metrics,
+            validation: MetricsValidator.validateStableBufferMetrics(metrics, {
+                stableBuffer: this.metricsGuardrails
+            })
+        };
+    }
+}
+//# sourceMappingURL=stable-buffer.js.map

package/dist/core/stable-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-buffer.js","sourceRoot":"","sources":["../../src/core/stable-buffer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,OAAO,YAAY;IACf,KAAK,CAAoB;IACzB,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,iBAAiB,GAAG,CAAC,CAAC;IACtB,WAAW,GAAG,CAAC,CAAC;IAChB,mBAAmB,GAAG,CAAC,CAAC;IACxB,UAAU,CAAkD;IAC5D,iBAAiB,CAAiC;IAClD,oBAAoB,CAAU;IAC9B,cAAc,CAAiC;IAEvD,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5C,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACnD,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,SAA4B;QACnC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,EAAgD,EAAE,UAA0C,EAAE;QACzG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;YACpD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;YAChC,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,YAAgC,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpC,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC/C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACxB,MAAM,QAAQ,GAAG;wBACf,GAAG,OAAO;wBACV,aAAa;wBACb,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;wBAC1C,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;wBAC1C,UAAU,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;wBAC9C,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;wBAC7C,WAAW;wBACX,OAAO;wBACP,YAAY;wBACZ,WAAW;wBACX,UAAU;qBACX,CAAC;oBACF,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;oBACtC,CAAC;oBAAC,MAAM,CAAC;wBACP,wDAAwD;oBAC1D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAChC,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QAEF,OAAO,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC;IAEO,KAAK,CAAC,eAAe,CAAI,OAAmB,EAAE,SAAkB;QACtE,IAAI,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,SAAoD,CAAC;QAEzD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAClD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,4CAA4C,SAAS,IAAI,CAAC,CAAC,CAAC;YAC/E,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC1D,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA2D,EAAE,OAAwC;QAChH,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC7B,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAI,EAAgD,EAAE,OAAwC;QAC7G,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAC9B,OAAO,iBAAiB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACnE,CAAC;IAED,UAAU;QACR,MAAM,OAAO,GAAwB;YACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,kBAAkB,EAAE,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;SAC/F,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,gBAAgB,CAAC,2BAA2B,CAAC,OAAO,EAAE;gBAChE,YAAY,EAAE,IAAI,CAAC,iBAAiB;aACrC,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/core/stable-function.d.ts

@@ -0,0 +1,11 @@
+import { STABLE_FUNCTION, STABLE_FUNCTION_RESULT } from '../types/index.js';
+export declare function stableFunction<TArgs extends any[] = any[], TReturn = any>(options: STABLE_FUNCTION<TArgs, TReturn> & {
+    returnResult: true;
+}): Promise<STABLE_FUNCTION_RESULT<TReturn, true>>;
+export declare function stableFunction<TArgs extends any[] = any[], TReturn = any>(options: STABLE_FUNCTION<TArgs, TReturn> & {
+    returnResult?: false | undefined;
+}): Promise<STABLE_FUNCTION_RESULT<TReturn, false>>;
+export declare function stableFunction<TArgs extends any[] = any[], TReturn = any>(options: STABLE_FUNCTION<TArgs, TReturn> & {
+    returnResult?: boolean;
+}): Promise<STABLE_FUNCTION_RESULT<TReturn>>;
+//# sourceMappingURL=stable-function.d.ts.map

package/dist/core/stable-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-function.d.ts","sourceRoot":"","sources":["../../src/core/stable-function.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,eAAe,EACf,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAqB3B,wBAAsB,cAAc,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EAC7E,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG;IAAE,YAAY,EAAE,IAAI,CAAA;CAAE,GAChE,OAAO,CAAC,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AAClD,wBAAsB,cAAc,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EAC7E,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,GAC9E,OAAO,CAAC,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AACnD,wBAAsB,cAAc,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EAC7E,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACpE,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC"}