@acmekit/orchestration 2.13.36 → 2.13.37

package/dist/transaction/circuit-breaker.js

@@ -1,59 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryCircuitBreaker = void 0;
-/**
- * Default in-memory circuit breaker. Suitable for single-process deployments,
- * development, and testing.
- */
-class InMemoryCircuitBreaker {
-    constructor() {
-        this.circuits_ = new Map();
-    }
-    getOrCreate(key) {
-        let entry = this.circuits_.get(key);
-        if (!entry) {
-            entry = { state: "closed", failures: 0, lastFailureAt: null };
-            this.circuits_.set(key, entry);
-        }
-        return entry;
-    }
-    getState(key) {
-        const entry = this.getOrCreate(key);
-        if (entry.state === "open" && entry.lastFailureAt) {
-            // This is checked externally via config.resetAfterMs
-            // Here we just return the raw state; the orchestrator handles transition
-        }
-        return entry.state;
-    }
-    /**
-     * Transition from open to half-open if enough time has passed.
-     */
-    maybeTransition(key, config) {
-        const entry = this.getOrCreate(key);
-        if (entry.state === "open" &&
-            entry.lastFailureAt &&
-            Date.now() - entry.lastFailureAt >= config.resetAfterMs) {
-            entry.state = "half_open";
-        }
-        return entry.state;
-    }
-    recordSuccess(key) {
-        const entry = this.getOrCreate(key);
-        entry.state = "closed";
-        entry.failures = 0;
-        entry.lastFailureAt = null;
-    }
-    recordFailure(key, config) {
-        const entry = this.getOrCreate(key);
-        entry.failures++;
-        entry.lastFailureAt = Date.now();
-        if (entry.failures >= config.threshold) {
-            entry.state = "open";
-        }
-    }
-    clear() {
-        this.circuits_.clear();
-    }
-}
-exports.InMemoryCircuitBreaker = InMemoryCircuitBreaker;
-//# sourceMappingURL=circuit-breaker.js.map

package/dist/transaction/circuit-breaker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/transaction/circuit-breaker.ts"],"names":[],"mappings":";;;AA2CA;;;GAGG;AACH,MAAa,sBAAsB;IAAnC;QACU,cAAS,GAA8B,IAAI,GAAG,EAAE,CAAA;IAsD1D,CAAC;IApDS,WAAW,CAAC,GAAW;QAC7B,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAA;YAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YAClD,qDAAqD;YACrD,yEAAyE;QAC3E,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,GAAW,EAAE,MAA4B;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACnC,IACE,KAAK,CAAC,KAAK,KAAK,MAAM;YACtB,KAAK,CAAC,aAAa;YACnB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,YAAY,EACvD,CAAC;YACD,KAAK,CAAC,KAAK,GAAG,WAAW,CAAA;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAA;IACpB,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACnC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAA;QACtB,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAA;QAClB,KAAK,CAAC,aAAa,GAAG,IAAI,CAAA;IAC5B,CAAC;IAED,aAAa,CAAC,GAAW,EAAE,MAA4B;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACnC,KAAK,CAAC,QAAQ,EAAE,CAAA;QAChB,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAChC,IAAI,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAA;QACtB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACF;AAvDD,wDAuDC"}

package/dist/transaction/metrics.d.ts

@@ -1,71 +0,0 @@
-/**
- * Metrics for an individual step execution.
- */
-export type StepMetrics = {
-    workflowId: string;
-    transactionId: string;
-    stepId: string;
-    action: string;
-    type: "invoke" | "compensate";
-    status: "success" | "failure" | "skipped" | "timeout";
-    attempt: number;
-    startedAt: number;
-    completedAt: number;
-    durationMs: number;
-};
-/**
- * Aggregated metrics for a complete workflow execution.
- */
-export type WorkflowMetrics = {
-    workflowId: string;
-    transactionId: string;
-    status: "done" | "reverted" | "failed";
-    startedAt: number;
-    completedAt: number;
-    totalDurationMs: number;
-    stepCount: number;
-    compensationCount: number;
-    retryTotal: number;
-    steps: StepMetrics[];
-};
-/**
- * Interface for collecting workflow and step metrics.
- * Implement this interface to integrate with Prometheus, Datadog, or any monitoring system.
- *
- * @example
- * ```ts
- * class PrometheusMetricsCollector implements IMetricsCollector {
- *   recordStepMetrics(metrics: StepMetrics) {
- *     stepDurationHistogram.observe(
- *       { workflow: metrics.workflowId, step: metrics.action, status: metrics.status },
- *       metrics.durationMs / 1000
- *     )
- *   }
- *   recordWorkflowMetrics(metrics: WorkflowMetrics) {
- *     workflowDurationHistogram.observe(
- *       { workflow: metrics.workflowId, status: metrics.status },
- *       metrics.totalDurationMs / 1000
- *     )
- *   }
- * }
- * ```
- */
-export interface IMetricsCollector {
-    recordStepMetrics(metrics: StepMetrics): void;
-    recordWorkflowMetrics(metrics: WorkflowMetrics): void;
-}
-/**
- * Default in-memory metrics collector. Stores metrics in memory for inspection.
- * Useful for development, testing, and lightweight deployments.
- */
-export declare class InMemoryMetricsCollector implements IMetricsCollector {
-    private stepMetrics_;
-    private workflowMetrics_;
-    recordStepMetrics(metrics: StepMetrics): void;
-    recordWorkflowMetrics(metrics: WorkflowMetrics): void;
-    getStepMetrics(transactionId?: string): StepMetrics[];
-    getWorkflowMetrics(transactionId: string): WorkflowMetrics | undefined;
-    getAllWorkflowMetrics(): WorkflowMetrics[];
-    clear(): void;
-}
-//# sourceMappingURL=metrics.d.ts.map

package/dist/transaction/metrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/transaction/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAA;IAC7B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7C,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;CACtD;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,gBAAgB,CAA0C;IAElE,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI7C,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIrD,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAOrD,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAItE,qBAAqB,IAAI,eAAe,EAAE;IAI1C,KAAK,IAAI,IAAI;CAId"}

package/dist/transaction/metrics.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryMetricsCollector = void 0;
-/**
- * Default in-memory metrics collector. Stores metrics in memory for inspection.
- * Useful for development, testing, and lightweight deployments.
- */
-class InMemoryMetricsCollector {
-    constructor() {
-        this.stepMetrics_ = [];
-        this.workflowMetrics_ = new Map();
-    }
-    recordStepMetrics(metrics) {
-        this.stepMetrics_.push(metrics);
-    }
-    recordWorkflowMetrics(metrics) {
-        this.workflowMetrics_.set(metrics.transactionId, metrics);
-    }
-    getStepMetrics(transactionId) {
-        if (transactionId) {
-            return this.stepMetrics_.filter((m) => m.transactionId === transactionId);
-        }
-        return [...this.stepMetrics_];
-    }
-    getWorkflowMetrics(transactionId) {
-        return this.workflowMetrics_.get(transactionId);
-    }
-    getAllWorkflowMetrics() {
-        return [...this.workflowMetrics_.values()];
-    }
-    clear() {
-        this.stepMetrics_ = [];
-        this.workflowMetrics_.clear();
-    }
-}
-exports.InMemoryMetricsCollector = InMemoryMetricsCollector;
-//# sourceMappingURL=metrics.js.map

package/dist/transaction/metrics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/transaction/metrics.ts"],"names":[],"mappings":";;;AA2DA;;;GAGG;AACH,MAAa,wBAAwB;IAArC;QACU,iBAAY,GAAkB,EAAE,CAAA;QAChC,qBAAgB,GAAiC,IAAI,GAAG,EAAE,CAAA;IA6BpE,CAAC;IA3BC,iBAAiB,CAAC,OAAoB;QACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAED,qBAAqB,CAAC,OAAwB;QAC5C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAC3D,CAAC;IAED,cAAc,CAAC,aAAsB;QACnC,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,CAAA;QAC3E,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAA;IAC/B,CAAC;IAED,kBAAkB,CAAC,aAAqB;QACtC,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACjD,CAAC;IAED,qBAAqB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAA;IAC/B,CAAC;CACF;AA/BD,4DA+BC"}

package/dist/transaction/rate-limiter.d.ts

@@ -1,40 +0,0 @@
-/**
- * Configuration for workflow-level rate limiting.
- */
-export type RateLimitConfig = {
-    /** Maximum number of executions allowed in the window. */
-    maxExecutions: number;
-    /** Rolling window duration in milliseconds. */
-    windowMs: number;
-};
-/**
- * Interface for a rate limiter. Implement this to back rate limiting
- * with Redis (sliding window), a database, or any shared state.
- *
- * @example
- * ```ts
- * class RedisRateLimiter implements IRateLimiter {
- *   async acquire(key: string, config: RateLimitConfig) {
- *     // Use ZRANGEBYSCORE + ZADD for sliding window
- *     return allowed
- *   }
- * }
- * ```
- */
-export interface IRateLimiter {
-    /**
-     * Attempt to acquire a rate limit slot.
-     * Returns `true` if the execution is allowed, `false` if rate-limited.
-     */
-    acquire(key: string, config: RateLimitConfig): boolean | Promise<boolean>;
-}
-/**
- * Default in-memory rate limiter using a sliding window of timestamps.
- * Suitable for single-process deployments, development, and testing.
- */
-export declare class InMemoryRateLimiter implements IRateLimiter {
-    private windows_;
-    acquire(key: string, config: RateLimitConfig): boolean;
-    clear(): void;
-}
-//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/transaction/rate-limiter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/transaction/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CACL,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,GACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9B;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAmC;IAEnD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO;IAkBtD,KAAK,IAAI,IAAI;CAGd"}

package/dist/transaction/rate-limiter.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryRateLimiter = void 0;
-/**
- * Default in-memory rate limiter using a sliding window of timestamps.
- * Suitable for single-process deployments, development, and testing.
- */
-class InMemoryRateLimiter {
-    constructor() {
-        this.windows_ = new Map();
-    }
-    acquire(key, config) {
-        const now = Date.now();
-        const cutoff = now - config.windowMs;
-        let timestamps = this.windows_.get(key) ?? [];
-        // Remove expired entries
-        timestamps = timestamps.filter((t) => t > cutoff);
-        if (timestamps.length >= config.maxExecutions) {
-            this.windows_.set(key, timestamps);
-            return false;
-        }
-        timestamps.push(now);
-        this.windows_.set(key, timestamps);
-        return true;
-    }
-    clear() {
-        this.windows_.clear();
-    }
-}
-exports.InMemoryRateLimiter = InMemoryRateLimiter;
-//# sourceMappingURL=rate-limiter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/transaction/rate-limiter.ts"],"names":[],"mappings":";;;AAmCA;;;GAGG;AACH,MAAa,mBAAmB;IAAhC;QACU,aAAQ,GAA0B,IAAI,GAAG,EAAE,CAAA;IAuBrD,CAAC;IArBC,OAAO,CAAC,GAAW,EAAE,MAAuB;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAA;QAEpC,IAAI,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7C,yBAAyB;QACzB,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;QAEjD,IAAI,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;YAClC,OAAO,KAAK,CAAA;QACd,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;CACF;AAxBD,kDAwBC"}