topkat-utils 1.3.20 → 1.3.22

package/README.md

@@ -183,6 +183,16 @@ recursiveGenericFunctionSync(
     }
 )
 ```
+- `safeWhile`: A safer version of while loop that prevents infinite loops by limiting the maximum number of iterations
+```typescript
+// Count up to 10
+let i = 0;
+safeWhile(
+  () => i < 10,
+  () => i++,
+  { nbRecursionMax: 100 } // Optional: maximum iterations before exiting
+);
+```
 
 ### Date Operations
 - `getDateAsInt(date)`: Convert date to integer format (20290101)
@@ -233,7 +243,7 @@ urlPathJoin('https://api.example.com//v1', '/users/', 'userId') // => 'https://a
 - `upperCase(str)`: `upperCase('HelloWorld' as const) // type: 'HELLOWORLD'` (Equivalent of type `UpperCase<MyString>`)
 - `objEntries(obj)`: In JS object entries are not correctly typed (`Object.entries({ a: 1, b: true }) // type: [string, number | boolean]`). With this function we are typed like `objEntries({ a: 1, b: true }) // ["a", number] | ["b", boolean]`
 - `objKeys`: In JS object keys are not correctly typed (`Object.keys({ a: 1, b: 2 }) // type: string`). With this function we are typed like `objKeys({ a: 1, b: 2 }) // type: 'a' | 'b'`
-- `includes(str)`: Fix this always happening ts error when using includes and your search string is not typed as an array element (which is very dumb IMO)
+- `includes(array, item)`: Fix this always happening ts error when using includes and your search string is not typed as an array element (which is very dumb IMO)
 
 ## Configuration
 

package/dist/src/loop-utils.d.ts

@@ -104,6 +104,22 @@ export declare function recursiveGenericFunctionSync(item: ObjectGeneric | any[]
  *   () => i++
  * );
  */
-export declare function safeWhile(conditionFn: () => boolean, callback: () => any, { nbRecursionMax }?: {
+export declare function safeWhile(conditionFn: (i: number) => boolean, callback: (i: number) => any, { nbRecursionMax }?: {
     nbRecursionMax?: number | undefined;
 }): void;
+/** A safer version of while loop that prevents infinite loops
+ * @param {Function} conditionFn Function that returns a boolean to determine if loop should continue
+ * @param {Function} callback Function to execute on each iteration
+ * @param {Object} options Configuration object
+ * @param {number} [options.nbRecursionMax=100] Maximum number of iterations before exiting to prevent infinite loops
+ * @example
+ * // Count up to 10
+ * let i = 0;
+ * safeWhile(
+ *   () => i < 10,
+ *   () => i++
+ * );
+ */
+export declare function safeWhileAsync(conditionFn: (i: number) => boolean, callback: (i: number) => Promise<any>, { nbRecursionMax }?: {
+    nbRecursionMax?: number | undefined;
+}): Promise<void>;

package/dist/src/loop-utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeWhile = exports.recursiveGenericFunctionSync = exports.recursiveGenericFunction = exports.forIasync = exports.forI = void 0;
+exports.safeWhileAsync = exports.safeWhile = exports.recursiveGenericFunctionSync = exports.recursiveGenericFunction = exports.forIasync = exports.forI = void 0;
 const error_utils_1 = require("./error-utils");
 const is_object_1 = require("./is-object");
 /**
@@ -156,12 +156,35 @@ exports.recursiveGenericFunctionSync = recursiveGenericFunctionSync;
  */
 function safeWhile(conditionFn, callback, { nbRecursionMax = 100 } = {}) {
     let nbRecursion = 0;
-    while (conditionFn() && nbRecursion++ < nbRecursionMax) {
-        callback();
+    while (conditionFn(nbRecursion) && nbRecursion++ < nbRecursionMax) {
+        callback(nbRecursion);
         // eslint-disable-next-line no-console
         if (nbRecursion === nbRecursionMax - 1)
             console.warn(`Too much recursion for while loop, exiting...`);
     }
 }
 exports.safeWhile = safeWhile;
+/** A safer version of while loop that prevents infinite loops
+ * @param {Function} conditionFn Function that returns a boolean to determine if loop should continue
+ * @param {Function} callback Function to execute on each iteration
+ * @param {Object} options Configuration object
+ * @param {number} [options.nbRecursionMax=100] Maximum number of iterations before exiting to prevent infinite loops
+ * @example
+ * // Count up to 10
+ * let i = 0;
+ * safeWhile(
+ *   () => i < 10,
+ *   () => i++
+ * );
+ */
+async function safeWhileAsync(conditionFn, callback, { nbRecursionMax = 100 } = {}) {
+    let nbRecursion = 0;
+    while (await conditionFn(nbRecursion) && nbRecursion++ < nbRecursionMax) {
+        await callback(nbRecursion);
+        // eslint-disable-next-line no-console
+        if (nbRecursion === nbRecursionMax - 1)
+            console.warn(`Too much recursion for while loop, exiting...`);
+    }
+}
+exports.safeWhileAsync = safeWhileAsync;
 //# sourceMappingURL=loop-utils.js.map

package/dist/src/loop-utils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topkat-utils",
-  "version": "1.3.20",
+  "version": "1.3.22",
   "type": "commonjs",
   "types": "index.ts",
   "main": "dist",
@@ -55,7 +55,7 @@
     "bump:minor": "yarn test:ci && yarn build && bump --minor",
     "bump:patch": "yarn test:ci && yarn build && bump --patch",
     "test": "jest --watchAll",
-    "test:ci": "jest --ci --runInBand --maxConcurrency=1 --silent"
+    "test:ci": "jest --ci --runInBand --maxConcurrency=1 --silent --no-watchman"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",

package/src/loop-utils.ts

@@ -175,10 +175,35 @@ export function recursiveGenericFunctionSync(item: ObjectGeneric | any[], callba
  *   () => i++
  * );
  */
-export function safeWhile(conditionFn: () => boolean, callback: () => any, { nbRecursionMax = 100 } = {}) {
+export function safeWhile(conditionFn: (i: number) => boolean, callback: (i: number) => any, { nbRecursionMax = 100 } = {}) {
     let nbRecursion = 0
-    while (conditionFn() && nbRecursion++ < nbRecursionMax) {
-        callback()
+    while (conditionFn(nbRecursion) && nbRecursion++ < nbRecursionMax) {
+        callback(nbRecursion)
+        // eslint-disable-next-line no-console
+        if (nbRecursion === nbRecursionMax - 1) console.warn(`Too much recursion for while loop, exiting...`)
+    }
+}
+
+
+
+
+/** A safer version of while loop that prevents infinite loops
+ * @param {Function} conditionFn Function that returns a boolean to determine if loop should continue
+ * @param {Function} callback Function to execute on each iteration
+ * @param {Object} options Configuration object
+ * @param {number} [options.nbRecursionMax=100] Maximum number of iterations before exiting to prevent infinite loops
+ * @example
+ * // Count up to 10
+ * let i = 0;
+ * safeWhile(
+ *   () => i < 10,
+ *   () => i++
+ * );
+ */
+export async function safeWhileAsync(conditionFn: (i: number) => boolean, callback: (i: number) => Promise<any>, { nbRecursionMax = 100 } = {}) {
+    let nbRecursion = 0
+    while (await conditionFn(nbRecursion) && nbRecursion++ < nbRecursionMax) {
+        await callback(nbRecursion)
         // eslint-disable-next-line no-console
         if (nbRecursion === nbRecursionMax - 1) console.warn(`Too much recursion for while loop, exiting...`)
     }