@baklavabg/common-ts 1.0.8 → 1.0.10

package/dist/index.d.ts

@@ -6,7 +6,6 @@ export { loadFile } from "./utils/file.utils.js";
 export { tryCatch } from "./utils/tryCatchDecorator.js";
 export { TryCatch } from "./utils/tryCatchSafeDecorator.js";
 export { equals, greaterThan, isEmpty, isEven, isNegative, isNotEmpty, isNull, isNullOrUndefined, isOdd, isPositive, isUndefined, isZero, lessThan, notEquals, } from "./safeExit/conditionHelpers.js";
-export type { ConditionalResult } from "./safeExit/types.js";
 export { createFolder } from "./utils/file.utils.js";
 export { formatDate, capitalize, randomString } from "./utils/tmp.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,OAAO,EACH,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,OAAO,EACH,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { loadFile } from "./utils/file.utils.js";
 export { tryCatch } from "./utils/tryCatchDecorator.js";
 export { TryCatch } from "./utils/tryCatchSafeDecorator.js";
 export { equals, greaterThan, isEmpty, isEven, isNegative, isNotEmpty, isNull, isNullOrUndefined, isOdd, isPositive, isUndefined, isZero, lessThan, notEquals, } from "./safeExit/conditionHelpers.js";
+// export type { ConditionalResult } from "./safeExit/types.js";
 export { createFolder } from "./utils/file.utils.js";
 export { formatDate, capitalize, randomString } from "./utils/tmp.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,OAAO,EACH,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,OAAO,EACH,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,MAAM,gCAAgC,CAAC;AACxC,gEAAgE;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/safeExit/index.d.ts

@@ -1,3 +1,4 @@
 export { returnIf, returnResultIf } from "./reurnIf.js";
 export { safe } from "./safe.js";
+export { ConditionalResult } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safeExit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safeExit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/safeExit/index.js

@@ -1,3 +1,4 @@
 export { returnIf, returnResultIf } from "./reurnIf.js";
 export { safe } from "./safe.js";
+export { ConditionalResult } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/safeExit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safeExit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safeExit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/safeExit/reurnIf.d.ts

@@ -1,32 +1,16 @@
-import { type ConditionalResult } from "./types.js";
+import { ConditionalResult } from "./types.js";
 /**
- * Returns early from a function if the condition passes
- * @param condition Function that tests the value
- * @param value Value to test
- * @param logMessage Optional message to log if condition passes
- * @param returnValue Value to return if condition passes (default: null)
- */
-export declare function returnIf<T, R = null>(condition: (value: T) => boolean, value: T, logMessage?: string, returnValue?: R): void;
-/**
- * Returns early from a function if the condition expression is true
- * @param condition Boolean expression to evaluate
+ * Returns early from a function if the condition is true
+ * @param condition Boolean or function that returns boolean
  * @param logMessage Optional message to log if condition is true
- * @param returnValue Value to return if condition is true (default: null)
- */
-export declare function returnIf<R = null>(condition: boolean, logMessage?: string, returnValue?: R): void;
-/**
- * Returns a result object if the condition passes
- * @param condition Function that tests the value
- * @param value Value to test
- * @param returnValue Value to include in result if condition passes
- * @param logMessage Optional message to log and include in result if condition passes
+ * @param returnValue Value to return if condition is true
  */
-export declare function returnResultIf<T, R = any>(condition: (value: T) => boolean, value: T, returnValue?: R, logMessage?: string): ConditionalResult<R>;
+export declare function returnIf(condition: boolean | (() => boolean), logMessage?: string, returnValue?: any): void;
 /**
- * Returns a result object if the condition expression is true
- * @param condition Boolean expression to evaluate
+ * Returns a result object if the condition is true
+ * @param condition Boolean or function that returns boolean
  * @param returnValue Value to include in result if condition is true
  * @param logMessage Optional message to log and include in result if condition is true
  */
-export declare function returnResultIf<R = any>(condition: boolean, returnValue?: R, logMessage?: string): ConditionalResult<R>;
+export declare function returnResultIf(condition: boolean | (() => boolean), returnValue?: any, logMessage?: string): ConditionalResult<any>;
 //# sourceMappingURL=reurnIf.d.ts.map

package/dist/safeExit/reurnIf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reurnIf.d.ts","sourceRoot":"","sources":["../../src/safeExit/reurnIf.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AAC9H;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AA+BnG;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EACrC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,KAAK,EAAE,CAAC,EACR,WAAW,CAAC,EAAE,CAAC,EACf,UAAU,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACxB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"reurnIf.d.ts","sourceRoot":"","sources":["../../src/safeExit/reurnIf.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,IAAI,CAS3G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,SAAS,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EACpC,WAAW,CAAC,EAAE,GAAG,EACjB,UAAU,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,GAAG,CAAC,CAWxB"}

package/dist/safeExit/reurnIf.js

@@ -2,92 +2,65 @@
  * Purpose:
  *   This file provides utility functions to help you exit early from a function or return a result object if a certain condition is met.
  *
- * Overloads:
- *   Both `returnIf` and `returnResultIf` are overloaded functions. This means you can call them in two different ways:
- *   1. With a function as the condition and a value to test.
- *   2. With a simple boolean condition.
- *
  * Functions:
  *   - `returnIf`: Throws a special error to exit the current function early if a condition is true, optionally logging a message and returning a value.
  *   - `returnResultIf`: Returns a result object with a value and message if a condition is true, otherwise returns an object with nulls.
  *
- * Example usages for each overload:
+ * Example usages:
  *
- * // --- returnIf overloads ---
- * // 1. Using a function as the condition
- * function processNumber(n: number) {
- *   returnIf((x) => x < 0, n, "Negative number not allowed", "NEGATIVE");
+ * // --- returnIf examples ---
+ * // Using a boolean condition
+ * function doSomething(flag: boolean) {
+ *   returnIf(flag, "Flag was true, exiting early", 123);
  *   // ...rest of function
  * }
  *
- * // 2. Using a boolean as the condition
- * function doSomething(flag: boolean) {
- *   returnIf(flag, "Flag was true, exiting early", 123);
+ * // Using a function condition (now combined with value)
+ * function processNumber(n: number) {
+ *   returnIf(() => n < 0, "Negative number not allowed", "NEGATIVE");
  *   // ...rest of function
  * }
  *
- * // --- returnResultIf overloads ---
- * // 1. Using a function as the condition
- * const result = returnResultIf((s) => s === "", "", "EMPTY", "String is empty");
- * // result: { value: "EMPTY", message: "String is empty" }
+ * // --- returnResultIf examples ---
+ * // Using a boolean condition
+ * const result1 = returnResultIf(false, "OK", "All good");
+ * // result1: { value: null, message: null }
  *
- * // 2. Using a boolean as the condition
- * const result2 = returnResultIf(false, "OK", "All good");
- * // result2: { value: null, message: null }
+ * // Using a function condition
+ * const result2 = returnResultIf(() => "" === "", "EMPTY", "String is empty");
+ * // result2: { value: "EMPTY", message: "String is empty" }
  */
 import { print } from "../utils/log.utils.js";
-import { EarlyReturnError } from "./types.js";
-export function returnIf(conditionOrValue, valueOrLogMessage, logMessageOrReturnValue, returnValue) {
-    let shouldReturn;
-    let actualReturnValue;
-    let actualLogMessage;
-    if (typeof conditionOrValue === "boolean") {
-        // Simple boolean condition overload
-        shouldReturn = conditionOrValue;
-        actualLogMessage = valueOrLogMessage;
-        actualReturnValue = logMessageOrReturnValue ?? null;
-    }
-    else {
-        // Function condition overload
-        shouldReturn = conditionOrValue(valueOrLogMessage);
-        actualLogMessage = logMessageOrReturnValue;
-        actualReturnValue = returnValue ?? null;
-    }
+import { ConditionalResult, EarlyReturnError } from "./types.js";
+/**
+ * Returns early from a function if the condition is true
+ * @param condition Boolean or function that returns boolean
+ * @param logMessage Optional message to log if condition is true
+ * @param returnValue Value to return if condition is true
+ */
+export function returnIf(condition, logMessage, returnValue) {
+    const shouldReturn = typeof condition === "boolean" ? condition : condition();
     if (shouldReturn) {
-        if (actualLogMessage) {
-            print.yellow(actualLogMessage);
+        if (logMessage) {
+            print.yellow(logMessage);
         }
-        throw new EarlyReturnError(actualReturnValue, actualLogMessage);
+        throw new EarlyReturnError(returnValue ?? null, logMessage);
     }
 }
-export function returnResultIf(conditionOrValue, valueOrReturnValue, returnValueOrLogMessage, logMessage) {
-    let shouldReturn;
-    let actualReturnValue;
-    let actualLogMessage;
-    if (typeof conditionOrValue === "boolean") {
-        // Simple boolean condition overload
-        shouldReturn = conditionOrValue;
-        actualReturnValue = valueOrReturnValue;
-        actualLogMessage = returnValueOrLogMessage;
-    }
-    else {
-        // Function condition overload
-        shouldReturn = conditionOrValue(valueOrReturnValue);
-        actualReturnValue = returnValueOrLogMessage;
-        actualLogMessage = logMessage;
-    }
+/**
+ * Returns a result object if the condition is true
+ * @param condition Boolean or function that returns boolean
+ * @param returnValue Value to include in result if condition is true
+ * @param logMessage Optional message to log and include in result if condition is true
+ */
+export function returnResultIf(condition, returnValue, logMessage) {
+    const shouldReturn = typeof condition === "boolean" ? condition : condition();
     if (shouldReturn) {
-        if (actualLogMessage) {
-            print.yellow(actualLogMessage);
+        if (logMessage) {
+            print.yellow(logMessage);
         }
-        return {
-            value: actualReturnValue ?? null,
-            message: actualLogMessage ?? null,
-        };
+        return new ConditionalResult(returnValue ?? null, logMessage ?? null);
     }
-    return {
-        value: null,
-        message: null,
-    };
+    return new ConditionalResult(null, null);
 }
 //# sourceMappingURL=reurnIf.js.map

package/dist/safeExit/reurnIf.js.map

@@ -1 +1 @@
-{"version":3,"file":"reurnIf.js","sourceRoot":"","sources":["../../src/safeExit/reurnIf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AAiBtE,MAAM,UAAU,QAAQ,CACpB,gBAAmD,EACnD,iBAA8B,EAC9B,uBAAoC,EACpC,WAAe;IAEf,IAAI,YAAqB,CAAC;IAC1B,IAAI,iBAA2B,CAAC;IAChC,IAAI,gBAAoC,CAAC;IAEzC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,oCAAoC;QACpC,YAAY,GAAG,gBAAgB,CAAC;QAChC,gBAAgB,GAAG,iBAA2B,CAAC;QAC/C,iBAAiB,GAAI,uBAA6B,IAAI,IAAI,CAAC;IAC/D,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,YAAY,GAAG,gBAAgB,CAAC,iBAAsB,CAAC,CAAC;QACxD,gBAAgB,GAAG,uBAAiC,CAAC;QACrD,iBAAiB,GAAG,WAAW,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACpE,CAAC;AACL,CAAC;AAsBD,MAAM,UAAU,cAAc,CAC1B,gBAAmD,EACnD,kBAA0B,EAC1B,uBAAoC,EACpC,UAAmB;IAEnB,IAAI,YAAqB,CAAC;IAC1B,IAAI,iBAAgC,CAAC;IACrC,IAAI,gBAAoC,CAAC;IAEzC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,oCAAoC;QACpC,YAAY,GAAG,gBAAgB,CAAC;QAChC,iBAAiB,GAAG,kBAAuB,CAAC;QAC5C,gBAAgB,GAAG,uBAAiC,CAAC;IACzD,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,YAAY,GAAG,gBAAgB,CAAC,kBAAuB,CAAC,CAAC;QACzD,iBAAiB,GAAG,uBAA4B,CAAC;QACjD,gBAAgB,GAAG,UAAU,CAAC;IAClC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnC,CAAC;QACD,OAAO;YACH,KAAK,EAAE,iBAAiB,IAAI,IAAI;YAChC,OAAO,EAAE,gBAAgB,IAAI,IAAI;SACpC,CAAC;IACN,CAAC;IAED,OAAO;QACH,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KAChB,CAAC;AACN,CAAC"}
+{"version":3,"file":"reurnIf.js","sourceRoot":"","sources":["../../src/safeExit/reurnIf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAoC,EAAE,UAAmB,EAAE,WAAiB;IACjG,MAAM,YAAY,GAAG,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAE9E,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,UAAU,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,WAAW,IAAI,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC1B,SAAoC,EACpC,WAAiB,EACjB,UAAmB;IAEnB,MAAM,YAAY,GAAG,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAE9E,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,UAAU,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,iBAAiB,CAAC,WAAW,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/safeExit/reurnIf_prev.d.ts

@@ -0,0 +1,32 @@
+import { ConditionalResult } from "./types.js";
+/**
+ * Returns early from a function if the condition passes
+ * @param condition Function that tests the value
+ * @param value Value to test
+ * @param logMessage Optional message to log if condition passes
+ * @param returnValue Value to return if condition passes (default: null)
+ */
+export declare function returnIf<T, R = null>(condition: (value: T) => boolean, value: T, logMessage?: string, returnValue?: R): void;
+/**
+ * Returns early from a function if the condition expression is true
+ * @param condition Boolean expression to evaluate
+ * @param logMessage Optional message to log if condition is true
+ * @param returnValue Value to return if condition is true (default: null)
+ */
+export declare function returnIf<R = null>(condition: boolean, logMessage?: string, returnValue?: R): void;
+/**
+ * Returns a result object if the condition passes
+ * @param condition Function that tests the value
+ * @param value Value to test
+ * @param returnValue Value to include in result if condition passes
+ * @param logMessage Optional message to log and include in result if condition passes
+ */
+export declare function returnResultIf<T, R = any>(condition: (value: T) => boolean, value: T, returnValue?: R, logMessage?: string): ConditionalResult<R>;
+/**
+ * Returns a result object if the condition expression is true
+ * @param condition Boolean expression to evaluate
+ * @param returnValue Value to include in result if condition is true
+ * @param logMessage Optional message to log and include in result if condition is true
+ */
+export declare function returnResultIf<R = any>(condition: boolean, returnValue?: R, logMessage?: string): ConditionalResult<R>;
+//# sourceMappingURL=reurnIf_prev.d.ts.map

package/dist/safeExit/reurnIf_prev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reurnIf_prev.d.ts","sourceRoot":"","sources":["../../src/safeExit/reurnIf_prev.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AAC9H;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AA+BnG;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EACrC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,KAAK,EAAE,CAAC,EACR,WAAW,CAAC,EAAE,CAAC,EACf,UAAU,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACxB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC"}

package/dist/safeExit/reurnIf_prev.js

@@ -0,0 +1,87 @@
+/**
+ * Purpose:
+ *   This file provides utility functions to help you exit early from a function or return a result object if a certain condition is met.
+ *
+ * Overloads:
+ *   Both `returnIf` and `returnResultIf` are overloaded functions. This means you can call them in two different ways:
+ *   1. With a function as the condition and a value to test.
+ *   2. With a simple boolean condition.
+ *
+ * Functions:
+ *   - `returnIf`: Throws a special error to exit the current function early if a condition is true, optionally logging a message and returning a value.
+ *   - `returnResultIf`: Returns a result object with a value and message if a condition is true, otherwise returns an object with nulls.
+ *
+ * Example usages for each overload:
+ *
+ * // --- returnIf overloads ---
+ * // 1. Using a function as the condition
+ * function processNumber(n: number) {
+ *   returnIf((x) => x < 0, n, "Negative number not allowed", "NEGATIVE");
+ *   // ...rest of function
+ * }
+ *
+ * // 2. Using a boolean as the condition
+ * function doSomething(flag: boolean) {
+ *   returnIf(flag, "Flag was true, exiting early", 123);
+ *   // ...rest of function
+ * }
+ *
+ * // --- returnResultIf overloads ---
+ * // 1. Using a function as the condition
+ * const result = returnResultIf((s) => s === "", "", "EMPTY", "String is empty");
+ * // result: { value: "EMPTY", message: "String is empty" }
+ *
+ * // 2. Using a boolean as the condition
+ * const result2 = returnResultIf(false, "OK", "All good");
+ * // result2: { value: null, message: null }
+ */
+import { print } from "../utils/log.utils.js";
+import { ConditionalResult, EarlyReturnError } from "./types.js";
+export function returnIf(conditionOrValue, valueOrLogMessage, logMessageOrReturnValue, returnValue) {
+    let shouldReturn;
+    let actualReturnValue;
+    let actualLogMessage;
+    if (typeof conditionOrValue === "boolean") {
+        // Simple boolean condition overload
+        shouldReturn = conditionOrValue;
+        actualLogMessage = valueOrLogMessage;
+        actualReturnValue = logMessageOrReturnValue ?? null;
+    }
+    else {
+        // Function condition overload
+        shouldReturn = conditionOrValue(valueOrLogMessage);
+        actualLogMessage = logMessageOrReturnValue;
+        actualReturnValue = returnValue ?? null;
+    }
+    if (shouldReturn) {
+        if (actualLogMessage) {
+            print.yellow(actualLogMessage);
+        }
+        throw new EarlyReturnError(actualReturnValue, actualLogMessage);
+    }
+}
+export function returnResultIf(conditionOrValue, valueOrReturnValue, returnValueOrLogMessage, logMessage) {
+    let shouldReturn;
+    let finalReturnValue;
+    let finalLogMessage;
+    if (typeof conditionOrValue === "boolean") {
+        // Simple boolean condition overload
+        shouldReturn = conditionOrValue;
+        finalReturnValue = valueOrReturnValue;
+        finalLogMessage = returnValueOrLogMessage;
+    }
+    else {
+        // Function condition overload
+        shouldReturn = conditionOrValue(valueOrReturnValue);
+        finalReturnValue = returnValueOrLogMessage;
+        finalLogMessage = logMessage;
+    }
+    if (shouldReturn) {
+        if (finalLogMessage) {
+            print.yellow(finalLogMessage);
+        }
+        return new ConditionalResult(finalReturnValue ?? null, finalLogMessage ?? null);
+    }
+    return new ConditionalResult(null, null);
+}
+//# sourceMappingURL=reurnIf_prev.js.map

package/dist/safeExit/reurnIf_prev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reurnIf_prev.js","sourceRoot":"","sources":["../../src/safeExit/reurnIf_prev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiBjE,MAAM,UAAU,QAAQ,CACpB,gBAAmD,EACnD,iBAA8B,EAC9B,uBAAoC,EACpC,WAAe;IAEf,IAAI,YAAqB,CAAC;IAC1B,IAAI,iBAA2B,CAAC;IAChC,IAAI,gBAAoC,CAAC;IAEzC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,oCAAoC;QACpC,YAAY,GAAG,gBAAgB,CAAC;QAChC,gBAAgB,GAAG,iBAA2B,CAAC;QAC/C,iBAAiB,GAAI,uBAA6B,IAAI,IAAI,CAAC;IAC/D,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,YAAY,GAAG,gBAAgB,CAAC,iBAAsB,CAAC,CAAC;QACxD,gBAAgB,GAAG,uBAAiC,CAAC;QACrD,iBAAiB,GAAG,WAAW,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACpE,CAAC;AACL,CAAC;AAsBD,MAAM,UAAU,cAAc,CAC1B,gBAAmD,EACnD,kBAA0B,EAC1B,uBAAoC,EACpC,UAAmB;IAEnB,IAAI,YAAqB,CAAC;IAC1B,IAAI,gBAA+B,CAAC;IACpC,IAAI,eAAmC,CAAC;IAExC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,oCAAoC;QACpC,YAAY,GAAG,gBAAgB,CAAC;QAChC,gBAAgB,GAAG,kBAAuB,CAAC;QAC3C,eAAe,GAAG,uBAAiC,CAAC;IACxD,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,YAAY,GAAG,gBAAgB,CAAC,kBAAuB,CAAC,CAAC;QACzD,gBAAgB,GAAG,uBAA4B,CAAC;QAChD,eAAe,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,eAAe,EAAE,CAAC;YAClB,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,iBAAiB,CAAC,gBAAgB,IAAI,IAAI,EAAE,eAAe,IAAI,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/safeExit/types.d.ts

@@ -1,6 +1,11 @@
-export interface ConditionalResult<T = any> {
-    value: T | null;
-    message: string | null;
+export declare class ConditionalResult<T = any> {
+    private _value;
+    private _message;
+    constructor(value: T | null, message: string | null);
+    get value(): T | null;
+    get message(): string | null;
+    log(): T | null;
+    logAppend(externalLog: string[]): T | null;
 }
 export declare class EarlyReturnError extends Error {
     returnValue: any;

package/dist/safeExit/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/safeExit/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACtC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAGD,qBAAa,gBAAiB,SAAQ,KAAK;IACpB,WAAW,EAAE,GAAG;gBAAhB,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM;CAIxD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/safeExit/types.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAiB,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnD,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,CAEpB;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,GAAG,IAAI,CAAC,GAAG,IAAI;IAOf,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAM7C;AAGD,qBAAa,gBAAiB,SAAQ,KAAK;IAE5B,WAAW,EAAE,GAAG;gBAAhB,WAAW,EAAE,GAAG,EACvB,OAAO,CAAC,EAAE,MAAM;CAKvB"}

package/dist/safeExit/types.js

@@ -1,3 +1,29 @@
+export class ConditionalResult {
+    _value;
+    _message;
+    constructor(value, message) {
+        this._value = value;
+        this._message = message;
+    }
+    get value() {
+        return this._value;
+    }
+    get message() {
+        return this._message;
+    }
+    log() {
+        if (this._message) {
+            console.log(this._message);
+        }
+        return this._value;
+    }
+    logAppend(externalLog) {
+        if (this.message) {
+            externalLog.push(this.message);
+        }
+        return this._value;
+    }
+}
 // Custom error class for early returns
 export class EarlyReturnError extends Error {
     returnValue;

package/dist/safeExit/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/safeExit/types.ts"],"names":[],"mappings":"AAKA,uCAAuC;AACvC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACpB;IAAnB,YAAmB,WAAgB,EAAE,OAAgB;QACjD,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,CAAA;QADjB,gBAAW,GAAX,WAAW,CAAK;QAE/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAClC,CAAC;CACJ"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/safeExit/types.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAiB;IAClB,MAAM,CAAW;IACjB,QAAQ,CAAgB;IAEhC,YAAY,KAAe,EAAE,OAAsB;QAC/C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,GAAG;QACC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,WAAqB;QAC3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ;AAED,uCAAuC;AACvC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAE5B;IADX,YACW,WAAgB,EACvB,OAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;QAH1B,gBAAW,GAAX,WAAW,CAAK;QAIvB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@baklavabg/common-ts",
-    "version": "1.0.8",
+    "version": "1.0.10",
     "type": "module",
     "description": "A comprehensive TypeScript library with common utility functions and custom types",
     "main": "./dist/index.js",