advanced-js-kit/dist/universal/sleep/index.cjs.map

Modern TypeScript utility library with tree-shaking support - Array, String, Number, Network, Sleep, and JWT utilities for JavaScript and TypeScript projects

{"version":3,"sources":["../../../src/universal/sleep/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["type TSleepParams ={\r\n    milliseconds?: number;\r\n    seconds?: number;\r\n    minutes?: number;\r\n    until?: {\r\n        unixTimestamp?: number;\r\n    };\r\n    random?:{\r\n        milliseconds?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n        seconds?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n        minutes?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n    }\r\n}\r\n\r\ntype TSleepReturn = Promise<void>;\r\n\r\n/**\r\n * Sleep function that supports various delay options\r\n * @param params - Sleep parameters including fixed delays, random delays, or until timestamp\r\n * @returns Promise that resolves after the specified delay\r\n * @throws Error if invalid parameters are provided\r\n */\r\nexport const sleep = (params: TSleepParams): TSleepReturn => {\r\n    return new Promise((resolve, reject) => {\r\n        let delayMs = 0;\r\n\r\n        try {\r\n            // Validate input parameters\r\n            if (!params || Object.keys(params).length === 0) {\r\n                throw new Error('Sleep parameters cannot be empty');\r\n            }\r\n\r\n            // Handle sleeping until a specific timestamp\r\n            if (params.until?.unixTimestamp) {\r\n                const now = Date.now();\r\n                const targetTime = params.until.unixTimestamp * 1000; // Convert to milliseconds\r\n                delayMs = Math.max(0, targetTime - now);\r\n                \r\n                // If the timestamp is in the past, resolve immediately\r\n                if (delayMs === 0) {\r\n                    resolve();\r\n                    return;\r\n                }\r\n            }\r\n            // Handle random delays\r\n            else if (params.random) {\r\n                if (params.random.milliseconds) {\r\n                    const { min, max } = params.random.milliseconds;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random milliseconds range');\r\n                    }\r\n                    delayMs = Math.random() * (max - min) + min;\r\n                } else if (params.random.seconds) {\r\n                    const { min, max } = params.random.seconds;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random seconds range');\r\n                    }\r\n                    delayMs = (Math.random() * (max - min) + min) * 1000;\r\n                } else if (params.random.minutes) {\r\n                    const { min, max } = params.random.minutes;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random minutes range');\r\n                    }\r\n                    delayMs = (Math.random() * (max - min) + min) * 60 * 1000;\r\n                } else {\r\n                    throw new Error('Random delay type must be specified (milliseconds, seconds, or minutes)');\r\n                }\r\n            }\r\n            // Handle fixed delays\r\n            else {\r\n                if (params.milliseconds !== undefined) {\r\n                    if (params.milliseconds < 0) {\r\n                        throw new Error('Milliseconds cannot be negative');\r\n                    }\r\n                    delayMs += params.milliseconds;\r\n                }\r\n                if (params.seconds !== undefined) {\r\n                    if (params.seconds < 0) {\r\n                        throw new Error('Seconds cannot be negative');\r\n                    }\r\n                    delayMs += params.seconds * 1000;\r\n                }\r\n                if (params.minutes !== undefined) {\r\n                    if (params.minutes < 0) {\r\n                        throw new Error('Minutes cannot be negative');\r\n                    }\r\n                    delayMs += params.minutes * 60 * 1000;\r\n                }\r\n\r\n                // If no valid delay was specified\r\n                if (delayMs === 0 && !params.milliseconds && !params.seconds && !params.minutes) {\r\n                    throw new Error('At least one delay parameter must be specified');\r\n                }\r\n            }\r\n\r\n            // Ensure delay is not too large (prevent potential issues)\r\n            const MAX_DELAY = 2147483647; // Maximum value for setTimeout\r\n            if (delayMs > MAX_DELAY) {\r\n                throw new Error(`Delay too large. Maximum delay is ${MAX_DELAY}ms`);\r\n            }\r\n\r\n            setTimeout(resolve, Math.floor(delayMs));\r\n        } catch (error) {\r\n            reject(error);\r\n        }\r\n    });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of milliseconds\r\n * @param ms - Number of milliseconds to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepMs = (ms: number): TSleepReturn => {\r\n    return sleep({ milliseconds: ms });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of seconds\r\n * @param seconds - Number of seconds to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepSeconds = (seconds: number): TSleepReturn => {\r\n    return sleep({ seconds });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of minutes\r\n * @param minutes - Number of minutes to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepMinutes = (minutes: number): TSleepReturn => {\r\n    return sleep({ minutes });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep until a specific Unix timestamp\r\n * @param unixTimestamp - Unix timestamp (in seconds) to sleep until\r\n * @returns Promise that resolves at the specified timestamp\r\n */\r\nexport const sleepUntil = (unixTimestamp: number): TSleepReturn => {\r\n    return sleep({ until: { unixTimestamp } });\r\n};\r\n\r\n// Export the type definitions for consumers\r\nexport type { TSleepParams, TSleepReturn };"]}