ts-workflow-engine-lite 2.1.0

package/dist/src/utils/AuditLogger.d.ts

@@ -0,0 +1,36 @@
+export type AuditAction = "workflow.register" | "workflow.start" | "workflow.complete" | "workflow.fail" | "workflow.cancel" | "workflow.pause" | "workflow.resume" | "instance.create" | "instance.update" | "instance.delete" | "event.trigger" | "event.process" | "api.request" | "auth.success" | "auth.failure" | "config.change";
+export interface AuditEntry {
+    timestamp: string;
+    action: AuditAction;
+    actor?: string;
+    resource?: string;
+    resourceId?: string;
+    details?: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+    traceId?: string;
+    success: boolean;
+    errorMessage?: string;
+}
+declare function sanitizeValue(key: string, value: any): any;
+declare function sanitizeObject(obj: any, depth?: number): any;
+export declare class AuditLogger {
+    private static entries;
+    private static maxEntries;
+    private static enabled;
+    private constructor();
+    static log(entry: Omit<AuditEntry, "timestamp">): void;
+    static logWorkflow(action: AuditAction, workflowId: string, instanceId?: string, details?: Record<string, unknown>, success?: boolean, errorMessage?: string): void;
+    static logApiRequest(method: string, path: string, statusCode: number, actor?: string, ip?: string, userAgent?: string, traceId?: string, details?: Record<string, unknown>): void;
+    static logAuth(success: boolean, actor?: string, ip?: string, errorMessage?: string): void;
+    static getEntries(options?: {
+        action?: AuditAction;
+        resource?: string;
+        startTime?: Date;
+        endTime?: Date;
+        limit?: number;
+    }): AuditEntry[];
+    static clear(): void;
+    static export(): string;
+}
+export { sanitizeObject, sanitizeValue };

package/dist/src/utils/AuditLogger.js

@@ -0,0 +1,148 @@
+import { Logger } from "./Logger.js";
+const SENSITIVE_FIELDS = [
+    "password",
+    "token",
+    "secret",
+    "apiKey",
+    "api_key",
+    "authorization",
+    "credential",
+    "private",
+    "ssn",
+    "creditCard",
+    "credit_card",
+    "cardNumber",
+    "card_number",
+    "cvv",
+    "pin",
+];
+function sanitizeValue(key, value) {
+    const lowerKey = key.toLowerCase();
+    for (const sensitive of SENSITIVE_FIELDS) {
+        if (lowerKey.includes(sensitive.toLowerCase())) {
+            if (typeof value === "string") {
+                if (value.length <= 4) {
+                    return "****";
+                }
+                return `${value.substring(0, 2)}****${value.substring(value.length - 2)}`;
+            }
+            return "****";
+        }
+    }
+    return value;
+}
+function sanitizeObject(obj, depth = 0) {
+    if (depth > 10)
+        return "[max depth]";
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (typeof obj !== "object") {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => sanitizeObject(item, depth + 1));
+    }
+    const sanitized = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === "object" && value !== null) {
+            sanitized[key] = sanitizeObject(value, depth + 1);
+        }
+        else {
+            sanitized[key] = sanitizeValue(key, value);
+        }
+    }
+    return sanitized;
+}
+export class AuditLogger {
+    static entries = [];
+    static maxEntries = 10000;
+    static enabled = process.env.AUDIT_LOG_ENABLED !== "false";
+    constructor() { }
+    static log(entry) {
+        if (!AuditLogger.enabled)
+            return;
+        const sanitizedDetails = entry.details
+            ? sanitizeObject(entry.details)
+            : undefined;
+        const auditEntry = {
+            ...entry,
+            details: sanitizedDetails,
+            timestamp: new Date().toISOString(),
+        };
+        AuditLogger.entries.push(auditEntry);
+        if (AuditLogger.entries.length > AuditLogger.maxEntries) {
+            AuditLogger.entries = AuditLogger.entries.slice(-AuditLogger.maxEntries / 2);
+        }
+        const logLevel = entry.success ? "info" : "warn";
+        Logger[logLevel]("audit", entry.action, JSON.stringify(auditEntry));
+    }
+    static logWorkflow(action, workflowId, instanceId, details, success = true, errorMessage) {
+        AuditLogger.log({
+            action,
+            resource: "workflow",
+            resourceId: workflowId,
+            details: {
+                instanceId,
+                ...details,
+            },
+            success,
+            errorMessage,
+        });
+    }
+    static logApiRequest(method, path, statusCode, actor, ip, userAgent, traceId, details) {
+        AuditLogger.log({
+            action: "api.request",
+            actor,
+            resource: "api",
+            resourceId: `${method} ${path}`,
+            ip,
+            userAgent,
+            traceId,
+            details: {
+                statusCode,
+                ...details,
+            },
+            success: statusCode < 400,
+            errorMessage: statusCode >= 400 ? `HTTP ${statusCode}` : undefined,
+        });
+    }
+    static logAuth(success, actor, ip, errorMessage) {
+        AuditLogger.log({
+            action: success ? "auth.success" : "auth.failure",
+            actor,
+            ip,
+            success,
+            errorMessage,
+        });
+    }
+    static getEntries(options) {
+        let filtered = [...AuditLogger.entries];
+        if (options?.action) {
+            filtered = filtered.filter((e) => e.action === options.action);
+        }
+        if (options?.resource) {
+            filtered = filtered.filter((e) => e.resource === options.resource);
+        }
+        if (options?.startTime) {
+            const start = options.startTime;
+            filtered = filtered.filter((e) => new Date(e.timestamp) >= start);
+        }
+        if (options?.endTime) {
+            const end = options.endTime;
+            filtered = filtered.filter((e) => new Date(e.timestamp) <= end);
+        }
+        if (options?.limit) {
+            filtered = filtered.slice(-options.limit);
+        }
+        return filtered;
+    }
+    static clear() {
+        AuditLogger.entries = [];
+    }
+    static export() {
+        return JSON.stringify(AuditLogger.entries, null, 2);
+    }
+}
+export { sanitizeObject, sanitizeValue };
+//# sourceMappingURL=AuditLogger.js.map

package/dist/src/utils/AuditLogger.js.map

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

package/dist/src/utils/BoundedMap.d.ts

@@ -0,0 +1,34 @@
+export interface BoundedMapOptions<K, V> {
+    maxSize?: number;
+    ttlMs?: number;
+    cleanupIntervalMs?: number;
+    onEvict?: (key: K, value: V, reason: "ttl" | "capacity") => void;
+}
+export declare class BoundedMap<K, V> implements Map<K, V> {
+    private readonly store;
+    private readonly maxSize;
+    private readonly ttlMs;
+    private readonly onEvict?;
+    private cleanupTimer;
+    constructor(options?: BoundedMapOptions<K, V>);
+    get [Symbol.toStringTag](): string;
+    get size(): number;
+    get(key: K): V | undefined;
+    set(key: K, value: V): this;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    forEach(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: unknown): void;
+    entries(): IterableIterator<[K, V]>;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+    [Symbol.iterator](): IterableIterator<[K, V]>;
+    dispose(): void;
+    evictExpired(): number;
+    stats(): {
+        size: number;
+        maxSize: number;
+        ttlMs: number;
+    };
+    private evictOldest;
+}

package/dist/src/utils/BoundedMap.js

@@ -0,0 +1,125 @@
+export class BoundedMap {
+    store = new Map();
+    maxSize;
+    ttlMs;
+    onEvict;
+    cleanupTimer = null;
+    constructor(options = {}) {
+        this.maxSize = options.maxSize ?? 1000;
+        this.ttlMs = options.ttlMs ?? 60_000;
+        this.onEvict = options.onEvict;
+        const cleanupMs = options.cleanupIntervalMs ?? this.ttlMs / 2;
+        if (cleanupMs > 0 && this.ttlMs > 0) {
+            this.cleanupTimer = setInterval(() => this.evictExpired(), cleanupMs);
+            if (this.cleanupTimer.unref) {
+                this.cleanupTimer.unref();
+            }
+        }
+    }
+    get [Symbol.toStringTag]() {
+        return "BoundedMap";
+    }
+    get size() {
+        return this.store.size;
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt <= Date.now()) {
+            this.store.delete(key);
+            this.onEvict?.(key, entry.value, "ttl");
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, value) {
+        if (!this.store.has(key) && this.store.size >= this.maxSize) {
+            this.evictOldest();
+        }
+        this.store.set(key, {
+            value,
+            expiresAt: Date.now() + this.ttlMs,
+        });
+        return this;
+    }
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    delete(key) {
+        return this.store.delete(key);
+    }
+    clear() {
+        this.store.clear();
+    }
+    forEach(callbackfn, thisArg) {
+        for (const [key] of this.store) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                callbackfn.call(thisArg, value, key, this);
+            }
+        }
+    }
+    *entries() {
+        for (const [key] of this.store) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                yield [key, value];
+            }
+        }
+    }
+    *keys() {
+        for (const key of this.store.keys()) {
+            if (this.has(key)) {
+                yield key;
+            }
+        }
+    }
+    *values() {
+        for (const [key] of this.store) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                yield value;
+            }
+        }
+    }
+    [Symbol.iterator]() {
+        return this.entries();
+    }
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    evictExpired() {
+        const now = Date.now();
+        let evicted = 0;
+        for (const [key, entry] of this.store) {
+            if (entry.expiresAt <= now) {
+                this.store.delete(key);
+                this.onEvict?.(key, entry.value, "ttl");
+                evicted++;
+            }
+        }
+        return evicted;
+    }
+    stats() {
+        return {
+            size: this.store.size,
+            maxSize: this.maxSize,
+            ttlMs: this.ttlMs,
+        };
+    }
+    evictOldest() {
+        const firstKey = this.store.keys().next().value;
+        if (firstKey !== undefined) {
+            const entry = this.store.get(firstKey);
+            this.store.delete(firstKey);
+            if (entry) {
+                this.onEvict?.(firstKey, entry.value, "capacity");
+            }
+        }
+    }
+}
+//# sourceMappingURL=BoundedMap.js.map

package/dist/src/utils/BoundedMap.js.map

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

package/dist/src/utils/LeaseStore.d.ts

@@ -0,0 +1,7 @@
+export interface LeaseStore {
+    acquire(key: string, holderId: string, ttlMs: number): Promise<boolean>;
+    renew(key: string, holderId: string, ttlMs: number): Promise<boolean>;
+    release(key: string, holderId: string): Promise<boolean>;
+    startAutoRenewal(key: string, holderId: string, ttlMs: number, renewIntervalMs?: number): () => void;
+}
+export declare function createLeaseStore(): LeaseStore;

package/dist/src/utils/LeaseStore.js

@@ -0,0 +1,102 @@
+import { Logger } from "./Logger.js";
+const LEASE_SWEEP_INTERVAL_MS = 60_000;
+class InMemoryLeaseStore {
+    leases = new Map();
+    renewalTimers = new Map();
+    sweepTimer = null;
+    constructor() {
+        this.sweepTimer = setInterval(() => this.evictExpired(), LEASE_SWEEP_INTERVAL_MS);
+        this.sweepTimer.unref?.();
+    }
+    evictExpired() {
+        const now = Date.now();
+        let evicted = 0;
+        for (const [key, lease] of this.leases) {
+            if (lease.expiresAt <= now && !this.renewalTimers.has(key)) {
+                this.leases.delete(key);
+                evicted++;
+            }
+        }
+        return evicted;
+    }
+    get size() {
+        return this.leases.size;
+    }
+    dispose() {
+        if (this.sweepTimer) {
+            clearInterval(this.sweepTimer);
+            this.sweepTimer = null;
+        }
+        for (const timer of this.renewalTimers.values()) {
+            clearInterval(timer);
+        }
+        this.renewalTimers.clear();
+        this.leases.clear();
+    }
+    async acquire(key, holderId, ttlMs) {
+        const now = Date.now();
+        const existing = this.leases.get(key);
+        if (existing &&
+            existing.expiresAt > now &&
+            existing.holderId !== holderId) {
+            return false;
+        }
+        if (existing && existing.expiresAt <= now) {
+            this.leases.delete(key);
+        }
+        this.leases.set(key, { holderId, expiresAt: now + ttlMs });
+        return true;
+    }
+    async renew(key, holderId, ttlMs) {
+        const now = Date.now();
+        const existing = this.leases.get(key);
+        if (!existing || existing.expiresAt <= now) {
+            return false;
+        }
+        if (existing.holderId !== holderId) {
+            return false;
+        }
+        existing.expiresAt = now + ttlMs;
+        this.leases.set(key, existing);
+        return true;
+    }
+    async release(key, holderId) {
+        const existing = this.leases.get(key);
+        if (!existing)
+            return true;
+        if (existing.holderId !== holderId)
+            return false;
+        this.leases.delete(key);
+        const timer = this.renewalTimers.get(key);
+        if (timer) {
+            clearInterval(timer);
+            this.renewalTimers.delete(key);
+        }
+        return true;
+    }
+    startAutoRenewal(key, holderId, ttlMs, renewIntervalMs = Math.max(ttlMs * 0.5, 1000)) {
+        const existingTimer = this.renewalTimers.get(key);
+        if (existingTimer) {
+            clearInterval(existingTimer);
+        }
+        const timer = setInterval(async () => {
+            const success = await this.renew(key, holderId, ttlMs);
+            if (!success) {
+                Logger.warn(holderId, "lease", `Failed to renew lease ${key}, lease may have been lost`);
+                clearInterval(timer);
+                this.renewalTimers.delete(key);
+            }
+        }, renewIntervalMs);
+        timer.unref?.();
+        this.renewalTimers.set(key, timer);
+        return () => {
+            clearInterval(timer);
+            this.renewalTimers.delete(key);
+        };
+    }
+}
+export function createLeaseStore() {
+    Logger.debug("system", "lease", "Using in-memory lease store");
+    return new InMemoryLeaseStore();
+}
+//# sourceMappingURL=LeaseStore.js.map

package/dist/src/utils/LeaseStore.js.map

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

package/dist/src/utils/Logger.d.ts

@@ -0,0 +1,26 @@
+type NodeType = "action" | "engine" | "system" | "event" | "workflow";
+export type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";
+export declare function setLogLevel(level: LogLevel | string): void;
+export declare function getLogLevel(): LogLevel;
+interface LogData {
+    [key: string]: unknown;
+}
+export declare function flush(): Promise<void>;
+export declare function log(context1: string, context2: string, message: string, data?: LogData, nodeType?: NodeType): void;
+export declare function debug(context1: string, context2: string, message: string, data?: LogData, nodeType?: NodeType): void;
+export declare function info(context1: string, context2: string, message: string, data?: LogData, nodeType?: NodeType): void;
+export declare function warn(context1: string, context2: string, message: string, data?: LogData, nodeType?: NodeType): void;
+export declare function error(context1: string, context2: string, errorMsg: string, stack?: string, nodeType?: NodeType): void;
+export declare const Logger: {
+    log: typeof log;
+    debug: typeof debug;
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    setLevel: typeof setLogLevel;
+    getLevel: typeof getLogLevel;
+    flush: typeof flush;
+};
+export declare function errorMessage(err: unknown): string;
+export declare function errorStack(err: unknown): string | undefined;
+export {};