@baklavabg/common-ts 1.0.10 → 1.0.11

package/dist/utils/file.utils.d.ts

@@ -1,4 +1,6 @@
+import { ConditionalResult } from "../safeExit/types.js";
 export declare function loadFile(fullPath: string): string | null;
+export declare function saveFile(fullPath: string, content: string): ConditionalResult<boolean>;
 export declare function loadJson(fullPath: string): any;
 export declare function saveJson(fullPath: string, json: object): string | null;
 export declare function createFolder(fullPath: string): string;

package/dist/utils/file.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.utils.d.ts","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,iBAOxC;AACD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAO9C;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMrD"}
+{"version":3,"file":"file.utils.d.ts","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,iBAOxC;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAItF;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAO9C;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMrD"}

package/dist/utils/file.utils.js

@@ -1,5 +1,6 @@
 import fs from "fs";
 import path from "path";
+import { ConditionalResult } from "../safeExit/types.js";
 export function loadFile(fullPath) {
     try {
         const buffer = fs.readFileSync(fullPath);
@@ -9,6 +10,12 @@ export function loadFile(fullPath) {
         return null;
     }
 }
+export function saveFile(fullPath, content) {
+    if (!content)
+        return new ConditionalResult(false, "No content to save");
+    fs.writeFileSync(fullPath, content);
+    return new ConditionalResult(true, `File saved to: ${fullPath}`);
+}
 export function loadJson(fullPath) {
     try {
         const buffer = fs.readFileSync(fullPath);

package/dist/utils/file.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.utils.js","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACxC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACxC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,SAAS,CAAA;IACjB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,IAAY;IACtD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC7C,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACnC,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC"}
+{"version":3,"file":"file.utils.js","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACrC,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,OAAe;IACtD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,iBAAiB,CAAU,KAAK,EAAE,oBAAoB,CAAC,CAAC;IACjF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,iBAAiB,CAAU,IAAI,EAAE,kBAAkB,QAAQ,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACrC,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,IAAY;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/package.json

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

package/dist/safeExit/reurnIf_prev.d.ts

@@ -1,32 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,87 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}