n8n-nodes-zalo-loma-funnel 1.0.0

package/dist/services/error-handler.service.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorHandler = exports.ErrorCategory = void 0;
+exports.createDefaultErrorHandler = createDefaultErrorHandler;
+/**
+ * Error categories for classification
+ */
+var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["AUTH"] = "auth";
+    ErrorCategory["RATE_LIMIT"] = "rate_limit";
+    ErrorCategory["NETWORK"] = "network";
+    ErrorCategory["VALIDATION"] = "validation";
+    ErrorCategory["NOT_FOUND"] = "not_found";
+    ErrorCategory["PERMISSION"] = "permission";
+    ErrorCategory["SERVER"] = "server";
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (exports.ErrorCategory = ErrorCategory = {}));
+/**
+ * Error handler with classification and retry logic
+ */
+class ErrorHandler {
+    constructor(config) {
+        this.config = {
+            maxRetries: 3,
+            baseDelayMs: 1000,
+            maxDelayMs: 30000,
+            retryableErrors: ['NETWORK', 'RATE_LIMIT', 'SERVER', 'ETIMEDOUT', 'ECONNRESET', 'ECONNREFUSED'],
+            ...config,
+        };
+    }
+    /**
+     * Classify an error into category
+     */
+    classify(error) {
+        const message = error.message?.toLowerCase() || '';
+        const name = error.name?.toLowerCase() || '';
+        // Authentication errors
+        if (message.includes('unauthorized') ||
+            message.includes('invalid cookie') ||
+            message.includes('session expired') ||
+            message.includes('login required') ||
+            message.includes('auth')) {
+            return {
+                original: error,
+                category: ErrorCategory.AUTH,
+                message: 'Authentication failed. Please check credentials.',
+                retryable: false,
+            };
+        }
+        // Rate limit errors
+        if (message.includes('rate limit') ||
+            message.includes('too many requests') ||
+            message.includes('429') ||
+            message.includes('spam')) {
+            return {
+                original: error,
+                category: ErrorCategory.RATE_LIMIT,
+                message: 'Rate limited. Will retry after delay.',
+                retryable: true,
+                retryAfterMs: this.config.maxDelayMs,
+            };
+        }
+        // Network errors
+        if (message.includes('network') ||
+            message.includes('timeout') ||
+            message.includes('etimedout') ||
+            message.includes('econnreset') ||
+            message.includes('econnrefused') ||
+            message.includes('socket') ||
+            name.includes('fetch')) {
+            return {
+                original: error,
+                category: ErrorCategory.NETWORK,
+                message: 'Network error. Will retry.',
+                retryable: true,
+                retryAfterMs: this.config.baseDelayMs,
+            };
+        }
+        // Validation errors
+        if (message.includes('invalid') ||
+            message.includes('validation') ||
+            message.includes('required') ||
+            message.includes('missing')) {
+            return {
+                original: error,
+                category: ErrorCategory.VALIDATION,
+                message: `Validation error: ${error.message}`,
+                retryable: false,
+            };
+        }
+        // Not found errors
+        if (message.includes('not found') ||
+            message.includes('404') ||
+            message.includes('does not exist')) {
+            return {
+                original: error,
+                category: ErrorCategory.NOT_FOUND,
+                message: 'Resource not found.',
+                retryable: false,
+            };
+        }
+        // Permission errors
+        if (message.includes('permission') ||
+            message.includes('forbidden') ||
+            message.includes('403') ||
+            message.includes('access denied')) {
+            return {
+                original: error,
+                category: ErrorCategory.PERMISSION,
+                message: 'Permission denied.',
+                retryable: false,
+            };
+        }
+        // Server errors
+        if (message.includes('500') || message.includes('server error') || message.includes('503')) {
+            return {
+                original: error,
+                category: ErrorCategory.SERVER,
+                message: 'Server error. Will retry.',
+                retryable: true,
+                retryAfterMs: this.config.baseDelayMs * 2,
+            };
+        }
+        // Unknown errors
+        return {
+            original: error,
+            category: ErrorCategory.UNKNOWN,
+            message: error.message || 'Unknown error occurred.',
+            retryable: false,
+        };
+    }
+    /**
+     * Execute with retry logic
+     */
+    async withRetry(fn, options) {
+        const maxRetries = options?.maxRetries ?? this.config.maxRetries;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = this.classify(error);
+                if (!lastError.retryable || attempt > maxRetries) {
+                    throw this.toNodeError(lastError);
+                }
+                options?.onRetry?.(lastError, attempt);
+                const delay = this.calculateDelay(attempt, lastError.retryAfterMs);
+                await this.sleep(delay);
+            }
+        }
+        throw this.toNodeError(lastError);
+    }
+    /**
+     * Calculate exponential backoff delay
+     */
+    calculateDelay(attempt, baseDelay) {
+        const base = baseDelay || this.config.baseDelayMs;
+        const exponentialDelay = base * Math.pow(2, attempt - 1);
+        const jitter = Math.random() * 1000;
+        return Math.min(exponentialDelay + jitter, this.config.maxDelayMs);
+    }
+    /**
+     * Convert to n8n-friendly error
+     */
+    toNodeError(classified) {
+        const error = new Error(classified.message);
+        error.name = `Zalo${classified.category.charAt(0).toUpperCase() + classified.category.slice(1)}Error`;
+        error.cause = classified.original;
+        return error;
+    }
+    /**
+     * Sleep helper
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(error) {
+        const classified = this.classify(error);
+        return classified.retryable;
+    }
+    /**
+     * Get suggested wait time for error
+     */
+    getSuggestedWait(error) {
+        const classified = this.classify(error);
+        return classified.retryAfterMs || this.config.baseDelayMs;
+    }
+}
+exports.ErrorHandler = ErrorHandler;
+/**
+ * Create default error handler
+ */
+function createDefaultErrorHandler() {
+    return new ErrorHandler();
+}
+//# sourceMappingURL=error-handler.service.js.map

package/dist/services/error-handler.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.service.js","sourceRoot":"","sources":["../../src/services/error-handler.service.ts"],"names":[],"mappings":";;;AAkPA,8DAEC;AAlPD;;GAEG;AACH,IAAY,aASX;AATD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,0CAAyB,CAAA;IACzB,oCAAmB,CAAA;IACnB,0CAAyB,CAAA;IACzB,wCAAuB,CAAA;IACvB,0CAAyB,CAAA;IACzB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;AACrB,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB;AAaD;;GAEG;AACH,MAAa,YAAY;IAGvB,YAAY,MAAqC;QAC/C,IAAI,CAAC,MAAM,GAAG;YACZ,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC;YAC/F,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAY;QACnB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAE7C,wBAAwB;QACxB,IACE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EACxB,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,IAAI;gBAC5B,OAAO,EAAE,kDAAkD;gBAC3D,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IACE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EACxB,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,UAAU;gBAClC,OAAO,EAAE,uCAAuC;gBAChD,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;aACrC,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,IACE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EACtB,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,OAAO;gBAC/B,OAAO,EAAE,4BAA4B;gBACrC,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;aACtC,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IACE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAC3B,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,UAAU;gBAClC,OAAO,EAAE,qBAAqB,KAAK,CAAC,OAAO,EAAE;gBAC7C,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,IACE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAClC,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,SAAS;gBACjC,OAAO,EAAE,qBAAqB;gBAC9B,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IACE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EACjC,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,UAAU;gBAClC,OAAO,EAAE,oBAAoB;gBAC7B,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3F,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,aAAa,CAAC,MAAM;gBAC9B,OAAO,EAAE,2BAA2B;gBACpC,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC;aAC1C,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,aAAa,CAAC,OAAO;YAC/B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,yBAAyB;YACnD,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,EAAoB,EACpB,OAA8F;QAE9F,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACjE,IAAI,SAAS,GAA2B,IAAI,CAAC;QAE7C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAC;gBAE1C,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;oBACjD,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBACpC,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;gBACnE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,WAAW,CAAC,SAAU,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAe,EAAE,SAAkB;QACxD,MAAM,IAAI,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QAClD,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,UAA2B;QAC7C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,GAAG,OAAO,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QACrG,KAAmC,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAY;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAY;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IAC5D,CAAC;CACF;AA/MD,oCA+MC;AAED;;GAEG;AACH,SAAgB,yBAAyB;IACvC,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export { ZaloConnectionManager } from './zalo-connection-manager.service';
+export { RateLimiter, createDefaultRateLimiter } from './rate-limiter.service';
+export { ErrorHandler, ErrorCategory, createDefaultErrorHandler, type ClassifiedError, } from './error-handler.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EACL,YAAY,EACZ,aAAa,EACb,yBAAyB,EACzB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultErrorHandler = exports.ErrorCategory = exports.ErrorHandler = exports.createDefaultRateLimiter = exports.RateLimiter = exports.ZaloConnectionManager = void 0;
+var zalo_connection_manager_service_1 = require("./zalo-connection-manager.service");
+Object.defineProperty(exports, "ZaloConnectionManager", { enumerable: true, get: function () { return zalo_connection_manager_service_1.ZaloConnectionManager; } });
+var rate_limiter_service_1 = require("./rate-limiter.service");
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return rate_limiter_service_1.RateLimiter; } });
+Object.defineProperty(exports, "createDefaultRateLimiter", { enumerable: true, get: function () { return rate_limiter_service_1.createDefaultRateLimiter; } });
+var error_handler_service_1 = require("./error-handler.service");
+Object.defineProperty(exports, "ErrorHandler", { enumerable: true, get: function () { return error_handler_service_1.ErrorHandler; } });
+Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return error_handler_service_1.ErrorCategory; } });
+Object.defineProperty(exports, "createDefaultErrorHandler", { enumerable: true, get: function () { return error_handler_service_1.createDefaultErrorHandler; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;AAAA,qFAA0E;AAAjE,wIAAA,qBAAqB,OAAA;AAC9B,+DAA+E;AAAtE,mHAAA,WAAW,OAAA;AAAE,gIAAA,wBAAwB,OAAA;AAC9C,iEAKiC;AAJ/B,qHAAA,YAAY,OAAA;AACZ,sHAAA,aAAa,OAAA;AACb,kIAAA,yBAAyB,OAAA"}

package/dist/services/rate-limiter.service.d.ts

@@ -0,0 +1,68 @@
+import { IRateLimitConfig } from '../interfaces/config.interface';
+/**
+ * Rate limiter with configurable random delay
+ * Supports in-memory and Redis modes for distributed rate limiting
+ */
+export declare class RateLimiter {
+    private mode;
+    private minDelayMs;
+    private maxDelayMs;
+    private redis?;
+    private lastSendTime;
+    private prefix;
+    constructor(config: IRateLimitConfig);
+    /**
+     * Wait for rate limit and acquire send slot
+     * Returns the delay that was applied
+     */
+    acquire(accountId: string): Promise<number>;
+    /**
+     * Check if can send immediately (without waiting)
+     */
+    canSend(accountId: string): Promise<boolean>;
+    /**
+     * Get time until next send is allowed
+     */
+    getWaitTime(accountId: string): Promise<number>;
+    /**
+     * Reset rate limit for account
+     */
+    reset(accountId: string): Promise<void>;
+    /**
+     * Reset all rate limits
+     */
+    resetAll(): Promise<void>;
+    /**
+     * Close Redis connection if used
+     */
+    close(): Promise<void>;
+    /**
+     * Get random delay between min and max
+     */
+    private getRandomDelay;
+    /**
+     * Get last send time for account
+     */
+    private getLastSendTime;
+    /**
+     * Set last send time for account
+     */
+    private setLastSendTime;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Get current config
+     */
+    getConfig(): {
+        mode: string;
+        minDelayMs: number;
+        maxDelayMs: number;
+    };
+}
+/**
+ * Create rate limiter with default config (1-5s random delay)
+ */
+export declare function createDefaultRateLimiter(redisUrl?: string): RateLimiter;
+//# sourceMappingURL=rate-limiter.service.d.ts.map

package/dist/services/rate-limiter.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.service.d.ts","sourceRoot":"","sources":["../../src/services/rate-limiter.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,gBAAgB;IAUpC;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBjD;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMlD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;YACW,eAAe;IAQ7B;;OAEG;YACW,eAAe;IAS7B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAOtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAOvE"}

package/dist/services/rate-limiter.service.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+exports.createDefaultRateLimiter = createDefaultRateLimiter;
+const ioredis_1 = __importDefault(require("ioredis"));
+/**
+ * Rate limiter with configurable random delay
+ * Supports in-memory and Redis modes for distributed rate limiting
+ */
+class RateLimiter {
+    constructor(config) {
+        this.lastSendTime = new Map();
+        this.prefix = 'zalo:ratelimit:';
+        this.mode = config.mode;
+        this.minDelayMs = config.minDelayMs;
+        this.maxDelayMs = config.maxDelayMs;
+        if (config.mode === 'redis' && config.redisUrl) {
+            this.redis = new ioredis_1.default(config.redisUrl);
+        }
+    }
+    /**
+     * Wait for rate limit and acquire send slot
+     * Returns the delay that was applied
+     */
+    async acquire(accountId) {
+        const now = Date.now();
+        const lastSend = await this.getLastSendTime(accountId);
+        const elapsed = now - lastSend;
+        // Calculate random delay between min and max
+        const targetDelay = this.getRandomDelay();
+        // Calculate remaining wait time
+        const remainingWait = Math.max(0, targetDelay - elapsed);
+        if (remainingWait > 0) {
+            await this.sleep(remainingWait);
+        }
+        // Update last send time
+        await this.setLastSendTime(accountId, Date.now());
+        return remainingWait;
+    }
+    /**
+     * Check if can send immediately (without waiting)
+     */
+    async canSend(accountId) {
+        const lastSend = await this.getLastSendTime(accountId);
+        const elapsed = Date.now() - lastSend;
+        return elapsed >= this.minDelayMs;
+    }
+    /**
+     * Get time until next send is allowed
+     */
+    async getWaitTime(accountId) {
+        const lastSend = await this.getLastSendTime(accountId);
+        const elapsed = Date.now() - lastSend;
+        return Math.max(0, this.minDelayMs - elapsed);
+    }
+    /**
+     * Reset rate limit for account
+     */
+    async reset(accountId) {
+        if (this.mode === 'redis' && this.redis) {
+            await this.redis.del(`${this.prefix}${accountId}`);
+        }
+        else {
+            this.lastSendTime.delete(accountId);
+        }
+    }
+    /**
+     * Reset all rate limits
+     */
+    async resetAll() {
+        if (this.mode === 'redis' && this.redis) {
+            const keys = await this.redis.keys(`${this.prefix}*`);
+            if (keys.length > 0) {
+                await this.redis.del(...keys);
+            }
+        }
+        else {
+            this.lastSendTime.clear();
+        }
+    }
+    /**
+     * Close Redis connection if used
+     */
+    async close() {
+        if (this.redis) {
+            await this.redis.quit();
+        }
+    }
+    /**
+     * Get random delay between min and max
+     */
+    getRandomDelay() {
+        return Math.floor(Math.random() * (this.maxDelayMs - this.minDelayMs + 1)) + this.minDelayMs;
+    }
+    /**
+     * Get last send time for account
+     */
+    async getLastSendTime(accountId) {
+        if (this.mode === 'redis' && this.redis) {
+            const value = await this.redis.get(`${this.prefix}${accountId}`);
+            return value ? parseInt(value, 10) : 0;
+        }
+        return this.lastSendTime.get(accountId) || 0;
+    }
+    /**
+     * Set last send time for account
+     */
+    async setLastSendTime(accountId, time) {
+        if (this.mode === 'redis' && this.redis) {
+            // Store with 1 hour TTL
+            await this.redis.set(`${this.prefix}${accountId}`, time.toString(), 'EX', 3600);
+        }
+        else {
+            this.lastSendTime.set(accountId, time);
+        }
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get current config
+     */
+    getConfig() {
+        return {
+            mode: this.mode,
+            minDelayMs: this.minDelayMs,
+            maxDelayMs: this.maxDelayMs,
+        };
+    }
+}
+exports.RateLimiter = RateLimiter;
+/**
+ * Create rate limiter with default config (1-5s random delay)
+ */
+function createDefaultRateLimiter(redisUrl) {
+    return new RateLimiter({
+        mode: redisUrl ? 'redis' : 'memory',
+        minDelayMs: 1000,
+        maxDelayMs: 5000,
+        redisUrl,
+    });
+}
+//# sourceMappingURL=rate-limiter.service.js.map

package/dist/services/rate-limiter.service.js.map

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

package/dist/services/zalo-connection-manager.service.d.ts

@@ -0,0 +1,85 @@
+import { API } from 'zca-js';
+import { IZaloApiAuth } from '../interfaces/auth.interface';
+import { IConnectionConfig } from '../interfaces/config.interface';
+/**
+ * Singleton manager for multi-account Zalo connections
+ * Handles connection lifecycle, health checks, and auto-reconnect
+ */
+export declare class ZaloConnectionManager {
+    private static instance;
+    private connections;
+    private config;
+    private healthCheckInterval?;
+    private constructor();
+    static getInstance(config?: Partial<IConnectionConfig>): ZaloConnectionManager;
+    /**
+     * Connect to Zalo account using credentials
+     */
+    connect(auth: IZaloApiAuth): Promise<API>;
+    /**
+     * Parse auth to zca-js Credentials format
+     */
+    private parseCredentials;
+    /**
+     * Parse cookie string (from browser) to Cookie array
+     */
+    private parseCookieString;
+    /**
+     * Get existing connection by account ID
+     */
+    getConnection(accountId: string): API | null;
+    /**
+     * Get connection by auth credentials
+     */
+    getConnectionByAuth(auth: IZaloApiAuth): API | null;
+    /**
+     * Disconnect specific account
+     */
+    disconnect(accountId: string): Promise<void>;
+    /**
+     * Disconnect all accounts
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Check if account is connected
+     */
+    isConnected(accountId: string): boolean;
+    /**
+     * Get all connected account IDs
+     */
+    getConnectedAccounts(): string[];
+    /**
+     * Get account ID from auth credentials
+     * Uses accountId if provided, otherwise generates from cookie hash
+     */
+    private getAccountId;
+    /**
+     * Start periodic health checks
+     */
+    private startHealthCheck;
+    /**
+     * Stop health checks
+     */
+    private stopHealthCheck;
+    /**
+     * Check all connections and reconnect if needed
+     */
+    private checkConnections;
+    /**
+     * Attempt to reconnect an account
+     */
+    reconnect(auth: IZaloApiAuth): Promise<API | null>;
+    /**
+     * Get connection stats
+     */
+    getStats(): {
+        totalConnections: number;
+        activeConnections: number;
+        accounts: {
+            id: string;
+            isConnected: boolean;
+            lastActivity: number;
+        }[];
+    };
+}
+//# sourceMappingURL=zalo-connection-manager.service.d.ts.map

package/dist/services/zalo-connection-manager.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zalo-connection-manager.service.d.ts","sourceRoot":"","sources":["../../src/services/zalo-connection-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,GAAG,EAAiC,MAAM,QAAQ,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAWnE;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwB;IAC/C,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAE7C,OAAO;IAUP,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,qBAAqB;IAO9E;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAgC/C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAS5C;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,GAAG,IAAI;IAInD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAMhC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;YACW,gBAAgB;IAa9B;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAoBxD;;OAEG;IACH,QAAQ,IAAI;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACxE;CAaF"}