@flutchai/flutch-sdk 0.1.0

package/dist/callbacks/callback-patch.service.js

@@ -0,0 +1,51 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var CallbackPatchService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackPatchService = void 0;
+const common_1 = require("@nestjs/common");
+const telegram_patch_handler_1 = require("./telegram-patch.handler");
+const web_patch_handler_1 = require("./web-patch.handler");
+let CallbackPatchService = CallbackPatchService_1 = class CallbackPatchService {
+    constructor(telegram, web) {
+        this.telegram = telegram;
+        this.web = web;
+        this.logger = new common_1.Logger(CallbackPatchService_1.name);
+    }
+    async apply(record, patch, context) {
+        var _a;
+        if (!patch)
+            return;
+        const platform = (_a = record.metadata) === null || _a === void 0 ? void 0 : _a.platform;
+        try {
+            switch (platform) {
+                case "telegram":
+                    await this.telegram.apply(patch, context);
+                    break;
+                case "web":
+                    await this.web.apply(patch, context);
+                    break;
+                default:
+                    this.logger.warn(`Unsupported patch platform: ${platform}`);
+            }
+        }
+        catch (err) {
+            this.logger.error(`Failed to apply patch for ${record.graphType}::${record.handler}`, err instanceof Error ? err.stack : undefined);
+        }
+    }
+};
+exports.CallbackPatchService = CallbackPatchService;
+exports.CallbackPatchService = CallbackPatchService = CallbackPatchService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [telegram_patch_handler_1.TelegramPatchHandler,
+        web_patch_handler_1.WebPatchHandler])
+], CallbackPatchService);
+//# sourceMappingURL=callback-patch.service.js.map

package/dist/callbacks/callback-patch.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-patch.service.js","sourceRoot":"","sources":["../../src/callbacks/callback-patch.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AAKpD,qEAAgE;AAChE,2DAAsD;AAO/C,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAE/B,YACmB,QAA8B,EAC9B,GAAoB;QADpB,aAAQ,GAAR,QAAQ,CAAsB;QAC9B,QAAG,GAAH,GAAG,CAAiB;QAHtB,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAI7D,CAAC;IAEJ,KAAK,CAAC,KAAK,CACT,MAAsB,EACtB,KAAoB,EACpB,OAAa;;QAEb,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,QAAQ,GAAG,MAAA,MAAM,CAAC,QAAQ,0CAAE,QAAQ,CAAC;QAC3C,IAAI,CAAC;YACH,QAAQ,QAAQ,EAAE,CAAC;gBACjB,KAAK,UAAU;oBACb,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAC1C,MAAM;gBACR,KAAK,KAAK;oBACR,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBACrC,MAAM;gBACR;oBACE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,6BAA6B,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,OAAO,EAAE,EAClE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AAhCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAIkB,6CAAoB;QACzB,mCAAe;GAJ5B,oBAAoB,CAgChC"}

package/dist/callbacks/callback-rate-limiter.d.ts

@@ -0,0 +1,27 @@
+import type Redis from "ioredis";
+export interface RateLimitConfig {
+    windowMs: number;
+    maxRequests: number;
+    keyPrefix?: string;
+    skipFailedRequests?: boolean;
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+    resetAt: number;
+    retryAfter?: number;
+}
+export declare class CallbackRateLimiter {
+    private readonly redis;
+    private readonly logger;
+    private readonly defaultConfig;
+    constructor(redis: Redis);
+    checkLimit(identifier: string, config?: Partial<RateLimitConfig>): Promise<RateLimitResult>;
+    checkUserLimit(userId: string, config?: Partial<RateLimitConfig>): Promise<RateLimitResult>;
+    checkIpLimit(ip: string, config?: Partial<RateLimitConfig>): Promise<RateLimitResult>;
+    checkTokenLimit(identifier: string, config?: Partial<RateLimitConfig>): Promise<RateLimitResult>;
+    reset(identifier: string, keyPrefix?: string): Promise<void>;
+    getStatus(identifier: string, config?: Partial<RateLimitConfig>): Promise<RateLimitResult>;
+    createHeaders(result: RateLimitResult): Record<string, string>;
+}

package/dist/callbacks/callback-rate-limiter.js

@@ -0,0 +1,129 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var CallbackRateLimiter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackRateLimiter = void 0;
+const common_1 = require("@nestjs/common");
+let CallbackRateLimiter = CallbackRateLimiter_1 = class CallbackRateLimiter {
+    constructor(redis) {
+        this.redis = redis;
+        this.logger = new common_1.Logger(CallbackRateLimiter_1.name);
+        this.defaultConfig = {
+            windowMs: 60000,
+            maxRequests: 10,
+            keyPrefix: "ratelimit:callback",
+            skipFailedRequests: false,
+        };
+    }
+    async checkLimit(identifier, config) {
+        const cfg = Object.assign(Object.assign({}, this.defaultConfig), config);
+        const key = `${cfg.keyPrefix}:${identifier}`;
+        const now = Date.now();
+        const windowStart = now - cfg.windowMs;
+        const script = `
+      local key = KEYS[1]
+      local now = tonumber(ARGV[1])
+      local window_start = tonumber(ARGV[2])
+      local max_requests = tonumber(ARGV[3])
+      local window_ms = tonumber(ARGV[4])
+      
+      -- Remove old entries outside the window
+      redis.call('ZREMRANGEBYSCORE', key, 0, window_start)
+      
+      -- Count requests in current window
+      local current_requests = redis.call('ZCARD', key)
+      
+      if current_requests < max_requests then
+        -- Add current request
+        redis.call('ZADD', key, now, now)
+        -- Set expiry
+        redis.call('EXPIRE', key, math.ceil(window_ms / 1000))
+        
+        return {1, max_requests, max_requests - current_requests - 1, 0}
+      else
+        -- Get oldest request in window to calculate retry time
+        local oldest = redis.call('ZRANGE', key, 0, 0, 'WITHSCORES')
+        local reset_at = oldest[2] and (tonumber(oldest[2]) + window_ms) or (now + window_ms)
+        
+        return {0, max_requests, 0, reset_at}
+      end
+    `;
+        const result = (await this.redis.eval(script, 1, key, now, windowStart, cfg.maxRequests, cfg.windowMs));
+        const [allowed, limit, remaining, resetAt] = result;
+        const rateLimitResult = {
+            allowed: allowed === 1,
+            limit,
+            remaining: Math.max(0, remaining),
+            resetAt,
+        };
+        if (!rateLimitResult.allowed) {
+            rateLimitResult.retryAfter = Math.ceil((resetAt - now) / 1000);
+            this.logger.warn(`Rate limit exceeded for ${identifier}. Retry after ${rateLimitResult.retryAfter}s`);
+        }
+        return rateLimitResult;
+    }
+    async checkUserLimit(userId, config) {
+        return this.checkLimit(`user:${userId}`, Object.assign({ windowMs: 60000, maxRequests: 20 }, config));
+    }
+    async checkIpLimit(ip, config) {
+        return this.checkLimit(`ip:${ip}`, Object.assign({ windowMs: 60000, maxRequests: 30 }, config));
+    }
+    async checkTokenLimit(identifier, config) {
+        return this.checkLimit(`token:${identifier}`, Object.assign({ windowMs: 300000, maxRequests: 5 }, config));
+    }
+    async reset(identifier, keyPrefix) {
+        const prefix = keyPrefix || this.defaultConfig.keyPrefix;
+        const key = `${prefix}:${identifier}`;
+        await this.redis.del(key);
+        this.logger.debug(`Rate limit reset for ${identifier}`);
+    }
+    async getStatus(identifier, config) {
+        const cfg = Object.assign(Object.assign({}, this.defaultConfig), config);
+        const key = `${cfg.keyPrefix}:${identifier}`;
+        const now = Date.now();
+        const windowStart = now - cfg.windowMs;
+        await this.redis.zremrangebyscore(key, 0, windowStart);
+        const currentRequests = await this.redis.zcard(key);
+        const remaining = Math.max(0, cfg.maxRequests - currentRequests);
+        const allowed = currentRequests < cfg.maxRequests;
+        let resetAt = now + cfg.windowMs;
+        if (!allowed) {
+            const oldest = await this.redis.zrange(key, 0, 0, "WITHSCORES");
+            if (oldest.length >= 2) {
+                resetAt = parseInt(oldest[1]) + cfg.windowMs;
+            }
+        }
+        return {
+            allowed,
+            limit: cfg.maxRequests,
+            remaining,
+            resetAt,
+            retryAfter: allowed ? undefined : Math.ceil((resetAt - now) / 1000),
+        };
+    }
+    createHeaders(result) {
+        const headers = {
+            "X-RateLimit-Limit": result.limit.toString(),
+            "X-RateLimit-Remaining": result.remaining.toString(),
+            "X-RateLimit-Reset": new Date(result.resetAt).toISOString(),
+        };
+        if (result.retryAfter) {
+            headers["Retry-After"] = result.retryAfter.toString();
+        }
+        return headers;
+    }
+};
+exports.CallbackRateLimiter = CallbackRateLimiter;
+exports.CallbackRateLimiter = CallbackRateLimiter = CallbackRateLimiter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Function])
+], CallbackRateLimiter);
+//# sourceMappingURL=callback-rate-limiter.js.map

package/dist/callbacks/callback-rate-limiter.js.map

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

package/dist/callbacks/callback-registry.d.ts

@@ -0,0 +1,7 @@
+import { CallbackHandler } from "../interfaces/callback.interface";
+export declare class CallbackRegistry {
+    private handlers;
+    register(handler: string, callback: CallbackHandler, graphType?: string): void;
+    get(handler: string, graphType?: string): CallbackHandler | undefined;
+    listHandlers(): string[];
+}

package/dist/callbacks/callback-registry.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackRegistry = void 0;
+class CallbackRegistry {
+    constructor() {
+        this.handlers = new Map();
+    }
+    register(handler, callback, graphType) {
+        const key = graphType ? `${graphType}::${handler}` : handler;
+        this.handlers.set(key, callback);
+        if (graphType) {
+            this.handlers.set(handler, callback);
+        }
+    }
+    get(handler, graphType) {
+        if (graphType) {
+            const versionedHandler = this.handlers.get(`${graphType}::${handler}`);
+            if (versionedHandler) {
+                return versionedHandler;
+            }
+        }
+        return this.handlers.get(handler);
+    }
+    listHandlers() {
+        return Array.from(this.handlers.keys());
+    }
+}
+exports.CallbackRegistry = CallbackRegistry;
+//# sourceMappingURL=callback-registry.js.map

package/dist/callbacks/callback-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-registry.js","sourceRoot":"","sources":["../../src/callbacks/callback-registry.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IAA7B;QACU,aAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IA+CxD,CAAC;IAvCC,QAAQ,CACN,OAAe,EACf,QAAyB,EACzB,SAAkB;QAGlB,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAGjC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAOD,GAAG,CAAC,OAAe,EAAE,SAAkB;QAErC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;YACvE,IAAI,gBAAgB,EAAE,CAAC;gBACrB,OAAO,gBAAgB,CAAC;YAC1B,CAAC;QACH,CAAC;QAGD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAKD,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAhDD,4CAgDC"}

package/dist/callbacks/callback-store.d.ts

@@ -0,0 +1,19 @@
+import type Redis from "ioredis";
+import { CallbackEntry, CallbackRecord } from "../interfaces/callback.interface";
+export declare class CallbackStore {
+    private readonly redis;
+    private readonly isProduction;
+    constructor(redis: Redis);
+    private generateToken;
+    issue(entry: CallbackEntry): Promise<string>;
+    getAndLock(token: string): Promise<CallbackRecord | null>;
+    private getAndLockAtomic;
+    private getAndLockSimple;
+    finalize(token: string): Promise<void>;
+    fail(token: string, error: string): Promise<CallbackRecord | null>;
+    private failAtomic;
+    private failSimple;
+    retry(token: string): Promise<CallbackRecord | null>;
+    private retryAtomic;
+    private retrySimple;
+}

package/dist/callbacks/callback-store.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackStore = void 0;
+const crypto_1 = require("crypto");
+class CallbackStore {
+    constructor(redis) {
+        this.redis = redis;
+        this.isProduction = process.env.NODE_ENV === "production";
+    }
+    generateToken(graphType) {
+        return `cb::${graphType}::${(0, crypto_1.randomBytes)(8).toString("base64url")}`;
+    }
+    async issue(entry) {
+        var _a, _b;
+        const token = this.generateToken(entry.graphType);
+        const record = Object.assign(Object.assign({}, entry), { token, status: "pending", createdAt: Date.now(), retries: 0 });
+        const ttl = (_b = (_a = entry.metadata) === null || _a === void 0 ? void 0 : _a.ttlSec) !== null && _b !== void 0 ? _b : 600;
+        await this.redis.setex(`callback:${token}`, ttl, JSON.stringify(record));
+        return token;
+    }
+    async getAndLock(token) {
+        if (this.isProduction) {
+            return this.getAndLockAtomic(token);
+        }
+        else {
+            return this.getAndLockSimple(token);
+        }
+    }
+    async getAndLockAtomic(token) {
+        const script = `
+      local data = redis.call('GET', KEYS[1])
+      if not data then return nil end
+      local record = cjson.decode(data)
+      if record.status ~= 'pending' then return nil end
+      record.status = 'processing'
+      redis.call('SET', KEYS[1], cjson.encode(record))
+      return cjson.encode(record)
+    `;
+        const result = await this.redis.eval(script, 1, `callback:${token}`);
+        return result ? JSON.parse(result) : null;
+    }
+    async getAndLockSimple(token) {
+        const key = `callback:${token}`;
+        const data = await this.redis.get(key);
+        if (!data) {
+            return null;
+        }
+        try {
+            const record = JSON.parse(data);
+            if (record.status !== "pending") {
+                return null;
+            }
+            record.status = "processing";
+            await this.redis.set(key, JSON.stringify(record));
+            return record;
+        }
+        catch (error) {
+            console.error("Failed to parse callback record:", error);
+            return null;
+        }
+    }
+    async finalize(token) {
+        await this.redis.del(`callback:${token}`);
+    }
+    async fail(token, error) {
+        if (this.isProduction) {
+            return this.failAtomic(token, error);
+        }
+        else {
+            return this.failSimple(token, error);
+        }
+    }
+    async failAtomic(token, error) {
+        const script = `
+      local data = redis.call('GET', KEYS[1])
+      if not data then return nil end
+      local record = cjson.decode(data)
+      record.status = 'failed'
+      record.retries = (record.retries or 0) + 1
+      record.lastError = ARGV[1]
+      redis.call('SET', KEYS[1], cjson.encode(record))
+      return cjson.encode(record)
+    `;
+        const result = await this.redis.eval(script, 1, `callback:${token}`, error);
+        return result ? JSON.parse(result) : null;
+    }
+    async failSimple(token, error) {
+        const key = `callback:${token}`;
+        const data = await this.redis.get(key);
+        if (!data) {
+            return null;
+        }
+        try {
+            const record = JSON.parse(data);
+            record.status = "failed";
+            record.retries = (record.retries || 0) + 1;
+            record.lastError = error;
+            await this.redis.set(key, JSON.stringify(record));
+            return record;
+        }
+        catch (parseError) {
+            console.error("Failed to parse callback record:", parseError);
+            return null;
+        }
+    }
+    async retry(token) {
+        if (this.isProduction) {
+            return this.retryAtomic(token);
+        }
+        else {
+            return this.retrySimple(token);
+        }
+    }
+    async retryAtomic(token) {
+        const script = `
+      local data = redis.call('GET', KEYS[1])
+      if not data then return nil end
+      local record = cjson.decode(data)
+      record.status = 'pending'
+      redis.call('SET', KEYS[1], cjson.encode(record))
+      return cjson.encode(record)
+    `;
+        const result = await this.redis.eval(script, 1, `callback:${token}`);
+        return result ? JSON.parse(result) : null;
+    }
+    async retrySimple(token) {
+        const key = `callback:${token}`;
+        const data = await this.redis.get(key);
+        if (!data) {
+            return null;
+        }
+        try {
+            const record = JSON.parse(data);
+            record.status = "pending";
+            await this.redis.set(key, JSON.stringify(record));
+            return record;
+        }
+        catch (parseError) {
+            console.error("Failed to parse callback record:", parseError);
+            return null;
+        }
+    }
+}
+exports.CallbackStore = CallbackStore;
+//# sourceMappingURL=callback-store.js.map

package/dist/callbacks/callback-store.js.map

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

package/dist/callbacks/example.callback.d.ts

@@ -0,0 +1,2 @@
+import { CallbackRegistry } from "./callback-registry";
+export declare function registerFinanceExampleCallback(registry: CallbackRegistry): void;

package/dist/callbacks/example.callback.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFinanceExampleCallback = registerFinanceExampleCallback;
+function registerFinanceExampleCallback(registry) {
+    registry.register("example", async () => ({
+        success: true,
+        message: "Finance callback executed",
+    }), "finance::1.0.0");
+}
+//# sourceMappingURL=example.callback.js.map

package/dist/callbacks/example.callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.callback.js","sourceRoot":"","sources":["../../src/callbacks/example.callback.ts"],"names":[],"mappings":";;AAOA,wEASC;AATD,SAAgB,8BAA8B,CAAC,QAA0B;IACvE,QAAQ,CAAC,QAAQ,CACf,SAAS,EACT,KAAK,IAA6B,EAAE,CAAC,CAAC;QACpC,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,2BAA2B;KACrC,CAAC,EACF,gBAAgB,CACjB,CAAC;AACJ,CAAC"}

package/dist/callbacks/idempotency-manager.d.ts

@@ -0,0 +1,54 @@
+import type Redis from "ioredis";
+import { CallbackResult } from "../interfaces/callback.interface";
+export interface IdempotencyConfig {
+    ttlSeconds: number;
+    keyPrefix: string;
+    hashPayload: boolean;
+    includeUserId: boolean;
+}
+export interface IdempotencyEntry {
+    key: string;
+    result: CallbackResult;
+    createdAt: number;
+    executedAt: number;
+    expiresAt: number;
+    requestHash: string;
+    attempts: number;
+}
+export declare enum IdempotencyStatus {
+    NEW = "NEW",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED"
+}
+export declare class IdempotencyManager {
+    private readonly redis;
+    private readonly logger;
+    private readonly defaultConfig;
+    constructor(redis: Redis);
+    checkAndLock(idempotencyKey: string | undefined, requestData: {
+        userId?: string;
+        graphType: string;
+        handler: string;
+        params: Record<string, any>;
+    }, config?: Partial<IdempotencyConfig>): Promise<{
+        status: IdempotencyStatus;
+        result?: CallbackResult;
+        key: string;
+    }>;
+    storeResult(key: string, result: CallbackResult, config?: Partial<IdempotencyConfig>): Promise<void>;
+    markFailed(key: string, error: string, config?: Partial<IdempotencyConfig>): Promise<void>;
+    releaseLock(key: string, config?: Partial<IdempotencyConfig>): Promise<void>;
+    private generateKey;
+    private acquireLock;
+    private deterministicStringify;
+    private sortObject;
+    cleanup(): Promise<number>;
+    getStatistics(): Promise<{
+        totalEntries: number;
+        completedEntries: number;
+        inProgressEntries: number;
+        failedEntries: number;
+        cacheHitRate: number;
+    }>;
+}