@baklavabg/common-ts 1.0.2

package/README.md

@@ -0,0 +1,41 @@
+# TypeScript Library With Example Javascript and Typescript Consumer Projects
+
+There are three separate projects in this repo.
+`common-ts` is a common library with typescript functions and types.
+`project-js` and `project-ts` are examples how to use the library in a Javascript and Typescript project.
+All three projects contain tests using `vitest`.
+
+# Usage
+
+## 1. Setup the Library
+  `cd common-ts`
+  `npm install`
+  `npm run build`
+  `npm link`
+
+-or-
+  `npm run relink`
+  `npm start`
+
+
+## 2. Run JavaScript Consumer
+  `cd project-js`
+  `npm link @baklavabg/common-ts`
+  `npm start`
+
+-or-
+  `npm run relink`
+  `npm start`
+
+## 3. Run TypeScript Consumer
+  `cd project-ts`
+  `npm install`
+  `npm link @baklavabg/common-ts`
+  `npm start`
+
+-or-
+  `npm run relink`
+  `npm start`
+
+## 4. Testing
+Testing is implemented using vitest. For all three projects: `npm test`

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { User1, User2 } from "./types/index.js";
+export { formatUserName } from "./utils/user.utils.js";
+export { print } from "./utils/log.utils.js";
+export { safe } from "./utils/tryCatchSafe.js";
+export { loadFile } from "./utils/file.utils.js";
+export { tryCatch } from "./utils/tryCatchDecorator.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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,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"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { formatUserName } from "./utils/user.utils.js";
+export { print } from "./utils/log.utils.js";
+export { safe } from "./utils/tryCatchSafe.js";
+export { loadFile } from "./utils/file.utils.js";
+export { tryCatch } from "./utils/tryCatchDecorator.js";
+export { equals, greaterThan, isEmpty, isEven, isNegative, isNotEmpty, isNull, isNullOrUndefined, isOdd, isPositive, isUndefined, isZero, lessThan, notEquals, } from "./safeExit/conditionHelpers.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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,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/safeExit/conditionHelpers.d.ts

@@ -0,0 +1,15 @@
+export declare const isNull: <T>(value: T | null) => value is null;
+export declare const isUndefined: <T>(value: T | undefined) => value is undefined;
+export declare const isNullOrUndefined: <T>(value: T | null | undefined) => value is null | undefined;
+export declare const isEmpty: (value: string | any[]) => boolean;
+export declare const isNotEmpty: (value: string | any[]) => boolean;
+export declare const isEven: (value: number) => boolean;
+export declare const isOdd: (value: number) => boolean;
+export declare const isPositive: (value: number) => boolean;
+export declare const isNegative: (value: number) => boolean;
+export declare const isZero: (value: number) => boolean;
+export declare const greaterThan: (threshold: number) => (value: number) => boolean;
+export declare const lessThan: (threshold: number) => (value: number) => boolean;
+export declare const equals: <T>(expected: T) => (value: T) => boolean;
+export declare const notEquals: <T>(expected: T) => (value: T) => boolean;
+//# sourceMappingURL=conditionHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditionHelpers.d.ts","sourceRoot":"","sources":["../../src/safeExit/conditionHelpers.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,KAAG,KAAK,IAAI,IAAsB,CAAA;AAC3E,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,KAAG,KAAK,IAAI,SAAgC,CAAA;AAC/F,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,KAAK,IAAI,IAAI,GAAG,SAAkD,CAAA;AACrI,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,GAAG,GAAG,EAAE,KAAG,OAA6B,CAAA;AAC7E,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,GAAG,GAAG,EAAE,KAAG,OAA2B,CAAA;AAC9E,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,KAAG,OAA0B,CAAA;AACjE,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,OAA0B,CAAA;AAChE,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,OAAoB,CAAA;AAC/D,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,OAAoB,CAAA;AAC/D,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,KAAG,OAAsB,CAAA;AAC7D,eAAO,MAAM,WAAW,GACnB,WAAW,MAAM,MACjB,OAAO,MAAM,KAAG,OACI,CAAA;AACzB,eAAO,MAAM,QAAQ,GAChB,WAAW,MAAM,MACjB,OAAO,MAAM,KAAG,OACI,CAAA;AACzB,eAAO,MAAM,MAAM,GACd,CAAC,EAAE,UAAU,CAAC,MACd,OAAO,CAAC,KAAG,OACU,CAAA;AAC1B,eAAO,MAAM,SAAS,GACjB,CAAC,EAAE,UAAU,CAAC,MACd,OAAO,CAAC,KAAG,OACU,CAAA"}

package/dist/safeExit/conditionHelpers.js

@@ -0,0 +1,16 @@
+// Helper condition functions
+export const isNull = (value) => value === null;
+export const isUndefined = (value) => value === undefined;
+export const isNullOrUndefined = (value) => value === null || value === undefined;
+export const isEmpty = (value) => value.length === 0;
+export const isNotEmpty = (value) => value.length > 0;
+export const isEven = (value) => value % 2 === 0;
+export const isOdd = (value) => value % 2 !== 0;
+export const isPositive = (value) => value > 0;
+export const isNegative = (value) => value < 0;
+export const isZero = (value) => value === 0;
+export const greaterThan = (threshold) => (value) => value > threshold;
+export const lessThan = (threshold) => (value) => value < threshold;
+export const equals = (expected) => (value) => value === expected;
+export const notEquals = (expected) => (value) => value !== expected;
+//# sourceMappingURL=conditionHelpers.js.map

package/dist/safeExit/conditionHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionHelpers.js","sourceRoot":"","sources":["../../src/safeExit/conditionHelpers.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,KAAe,EAAiB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAA;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,KAAoB,EAAsB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAA;AAC/F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,KAA2B,EAA6B,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAA;AACrI,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAqB,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAqB,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;AAC9E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAA;AACjE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAA;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,GAAG,CAAC,CAAA;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,GAAG,CAAC,CAAA;AAC/D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,KAAK,CAAC,CAAA;AAC7D,MAAM,CAAC,MAAM,WAAW,GACpB,CAAC,SAAiB,EAAE,EAAE,CACtB,CAAC,KAAa,EAAW,EAAE,CACvB,KAAK,GAAG,SAAS,CAAA;AACzB,MAAM,CAAC,MAAM,QAAQ,GACjB,CAAC,SAAiB,EAAE,EAAE,CACtB,CAAC,KAAa,EAAW,EAAE,CACvB,KAAK,GAAG,SAAS,CAAA;AACzB,MAAM,CAAC,MAAM,MAAM,GACf,CAAI,QAAW,EAAE,EAAE,CACnB,CAAC,KAAQ,EAAW,EAAE,CAClB,KAAK,KAAK,QAAQ,CAAA;AAC1B,MAAM,CAAC,MAAM,SAAS,GAClB,CAAI,QAAW,EAAE,EAAE,CACnB,CAAC,KAAQ,EAAW,EAAE,CAClB,KAAK,KAAK,QAAQ,CAAA"}

package/dist/safeExit/reurnIf.d.ts

@@ -0,0 +1,32 @@
+import { type 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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reurnIf.d.ts","sourceRoot":"","sources":["../../src/safeExit/reurnIf.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAErE;;;;;;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,CAAA;AAC7H;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAA;AA0BlG;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAA;AAClJ;;;;;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,CAAA"}

package/dist/safeExit/reurnIf.js

@@ -0,0 +1,56 @@
+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;
+    }
+    if (shouldReturn) {
+        if (actualLogMessage) {
+            print.yellow(actualLogMessage);
+        }
+        throw new EarlyReturnError(actualReturnValue, actualLogMessage);
+    }
+}
+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;
+    }
+    if (shouldReturn) {
+        if (actualLogMessage) {
+            print.yellow(actualLogMessage);
+        }
+        return {
+            value: actualReturnValue ?? null,
+            message: actualLogMessage ?? null,
+        };
+    }
+    return {
+        value: null,
+        message: null,
+    };
+}
+//# sourceMappingURL=reurnIf.js.map

package/dist/safeExit/reurnIf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reurnIf.js","sourceRoot":"","sources":["../../src/safeExit/reurnIf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAA;AAiBrE,MAAM,UAAU,QAAQ,CAAc,gBAAmD,EAAE,iBAA8B,EAAE,uBAAoC,EAAE,WAAe;IAC5K,IAAI,YAAqB,CAAA;IACzB,IAAI,iBAA2B,CAAA;IAC/B,IAAI,gBAAoC,CAAA;IAExC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,oCAAoC;QACpC,YAAY,GAAG,gBAAgB,CAAA;QAC/B,gBAAgB,GAAG,iBAA2B,CAAA;QAC9C,iBAAiB,GAAI,uBAA6B,IAAI,IAAI,CAAA;IAC9D,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,YAAY,GAAG,gBAAgB,CAAC,iBAAsB,CAAC,CAAA;QACvD,gBAAgB,GAAG,uBAAiC,CAAA;QACpD,iBAAiB,GAAG,WAAW,IAAI,IAAI,CAAA;IAC3C,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAClC,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;IACnE,CAAC;AACL,CAAC;AAiBD,MAAM,UAAU,cAAc,CAAa,gBAAmD,EAAE,kBAA0B,EAAE,uBAAoC,EAAE,UAAmB;IACjL,IAAI,YAAqB,CAAA;IACzB,IAAI,iBAAgC,CAAA;IACpC,IAAI,gBAAoC,CAAA;IAExC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,oCAAoC;QACpC,YAAY,GAAG,gBAAgB,CAAA;QAC/B,iBAAiB,GAAG,kBAAuB,CAAA;QAC3C,gBAAgB,GAAG,uBAAiC,CAAA;IACxD,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,YAAY,GAAG,gBAAgB,CAAC,kBAAuB,CAAC,CAAA;QACxD,iBAAiB,GAAG,uBAA4B,CAAA;QAChD,gBAAgB,GAAG,UAAU,CAAA;IACjC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAClC,CAAC;QACD,OAAO;YACH,KAAK,EAAE,iBAAiB,IAAI,IAAI;YAChC,OAAO,EAAE,gBAAgB,IAAI,IAAI;SACpC,CAAA;IACL,CAAC;IAED,OAAO;QACH,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KAChB,CAAA;AACL,CAAC"}

package/dist/safeExit/safe.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Enhanced safe function that handles both regular errors and early returns
+ * @param fn - The function to wrap
+ * @param printError - Whether to print regular errors (default: true)
+ * @param printStack - Whether to print stack trace for regular errors (default: true)
+ * @param defaultReturnValue - Default return value for regular errors (default: undefined)
+ * @param defaultErrorMsg - Default message for regular errors
+ * @param cbk - Optional callback for regular errors
+ */
+export declare function safe<T extends (...args: any[]) => any>(fn: T, printError?: boolean, printStack?: boolean, defaultReturnValue?: any, defaultErrorMsg?: string, cbk?: (error: unknown) => void): (...args: Parameters<T>) => ReturnType<T> | typeof defaultReturnValue;
+//# sourceMappingURL=safe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../src/safeExit/safe.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACrD,EAAE,EAAE,CAAC,EACL,UAAU,GAAE,OAAc,EAC1B,UAAU,GAAE,OAAc,EAC1B,kBAAkB,CAAC,EAAE,GAAG,EACxB,eAAe,CAAC,EAAE,MAAM,EACxB,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC5B,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,kBAAkB,CA+DvE"}

package/dist/safeExit/safe.js

@@ -0,0 +1,71 @@
+import { print } from "../utils/log.utils.js";
+import { EarlyReturnError } from "./types.js";
+// @mii use this instead of the other function `safe`
+/**
+ * Enhanced safe function that handles both regular errors and early returns
+ * @param fn - The function to wrap
+ * @param printError - Whether to print regular errors (default: true)
+ * @param printStack - Whether to print stack trace for regular errors (default: true)
+ * @param defaultReturnValue - Default return value for regular errors (default: undefined)
+ * @param defaultErrorMsg - Default message for regular errors
+ * @param cbk - Optional callback for regular errors
+ */
+export function safe(fn, printError = true, printStack = true, defaultReturnValue, defaultErrorMsg, cbk) {
+    const getFileInfoFromStack = (stackTrace, functionName) => {
+        const lines = stackTrace.split("\n").map((line) => line.trim());
+        const fnLine = lines.find((line) => line.startsWith(`at ${functionName}`)) ||
+            lines.find((line) => /at .*:\d+:\d+/.test(line)) ||
+            lines[1] ||
+            "";
+        const regex = /at (?:\S+ \()?(.+):(\d+):(\d+)\)?$/;
+        const match = fnLine.match(regex);
+        if (match) {
+            const [, path, line, col] = match;
+            return `${path}:${line}:${col}`;
+        }
+        return "";
+    };
+    const handleRegularError = (e) => {
+        if (printError) {
+            let fileInfo = "";
+            if (e instanceof Error && e.stack) {
+                fileInfo = getFileInfoFromStack(e.stack, fn.name);
+            }
+            const errorMsg = defaultErrorMsg || `Exception in ${fn.name}()${fileInfo ? ` at ${fileInfo}` : ""}:`;
+            if (printStack && e instanceof Error) {
+                print.red(`${errorMsg}\n${e.stack}`);
+            }
+            else {
+                print.red(`${errorMsg} ${e}`);
+            }
+        }
+        if (cbk) {
+            cbk(e);
+        }
+        return defaultReturnValue;
+    };
+    const handleEarlyReturn = (e) => {
+        return e.returnValue;
+    };
+    return (...args) => {
+        try {
+            const result = fn(...args);
+            if (result && typeof result === "object" && "then" in result && typeof result.then === "function") {
+                return result.catch((e) => {
+                    if (e instanceof EarlyReturnError) {
+                        return handleEarlyReturn(e);
+                    }
+                    return handleRegularError(e);
+                });
+            }
+            return result;
+        }
+        catch (e) {
+            if (e instanceof EarlyReturnError) {
+                return handleEarlyReturn(e);
+            }
+            return handleRegularError(e);
+        }
+    };
+}
+//# sourceMappingURL=safe.js.map

package/dist/safeExit/safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.js","sourceRoot":"","sources":["../../src/safeExit/safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,qDAAqD;AACrD;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CACnB,EAAK,EACL,aAAsB,IAAI,EAC1B,aAAsB,IAAI,EAC1B,kBAAwB,EACxB,eAAwB,EACxB,GAA8B;IAE9B,MAAM,oBAAoB,GAAG,CAAC,UAAkB,EAAE,YAAoB,EAAE,EAAE;QACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAC/D,MAAM,MAAM,GACX,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,YAAY,EAAE,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,KAAK,CAAC,CAAC,CAAC;YACR,EAAE,CAAA;QACH,MAAM,KAAK,GAAG,oCAAoC,CAAA;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;YACjC,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,GAAG,EAAE,CAAA;QAChC,CAAC;QACD,OAAO,EAAE,CAAA;IACV,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,CAAC,CAAU,EAAE,EAAE;QACzC,IAAI,UAAU,EAAE,CAAC;YAChB,IAAI,QAAQ,GAAG,EAAE,CAAA;YACjB,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACnC,QAAQ,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;YAClD,CAAC;YACD,MAAM,QAAQ,GAAG,eAAe,IAAI,gBAAgB,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAA;YAEpG,IAAI,UAAU,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;gBACtC,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;YACrC,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9B,CAAC;QACF,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,CAAC,CAAC,CAAA;QACP,CAAC;QACD,OAAO,kBAAkB,CAAA;IAC1B,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,CAAC,CAAmB,EAAE,EAAE;QACjD,OAAO,CAAC,CAAC,WAAW,CAAA;IACrB,CAAC,CAAA;IAED,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE;QAClB,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAkB,CAAA;YAE3C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACnG,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;oBAClC,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC;wBACnC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAA;oBAC5B,CAAC;oBACD,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAA;gBAC7B,CAAC,CAAkB,CAAA;YACpB,CAAC;YAED,OAAO,MAAM,CAAA;QACd,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACrB,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC;gBACnC,OAAO,iBAAiB,CAAC,CAAC,CAAkB,CAAA;YAC7C,CAAC;YACD,OAAO,kBAAkB,CAAC,CAAC,CAAkB,CAAA;QAC9C,CAAC;IACF,CAAC,CAAA;AACF,CAAC"}

package/dist/safeExit/types.d.ts

@@ -0,0 +1,9 @@
+export interface ConditionalResult<T = any> {
+    value: T | null;
+    message: string | null;
+}
+export declare class EarlyReturnError extends Error {
+    returnValue: any;
+    constructor(returnValue: any, message?: string);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/safeExit/types.js

@@ -0,0 +1,10 @@
+// Custom error class for early returns
+export class EarlyReturnError extends Error {
+    returnValue;
+    constructor(returnValue, message) {
+        super(message || "Early return");
+        this.returnValue = returnValue;
+        this.name = "EarlyReturnError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/safeExit/types.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+export interface User1 {
+    id: number;
+    name: string;
+    email: string;
+    age?: number;
+}
+export interface User2 {
+    id: number;
+    name: string;
+    email: string;
+    age?: number;
+    additionalInfo: string;
+}
+export interface TryCatchOptions {
+    returnVal?: any;
+    logError?: boolean;
+    logStack?: boolean;
+    cbk?: (error?: Error) => any;
+    rethrow?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,EAAE,MAAM,CAAA;CACzB;AAGD,MAAM,WAAW,eAAe;IAC5B,SAAS,CAAC,EAAE,GAAG,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,GAAG,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// Simple custom types for the POC
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,kCAAkC"}

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

@@ -0,0 +1,5 @@
+export declare function loadFile(fullPath: string): string | null;
+export declare function loadJson(fullPath: string): any;
+export declare function saveJson(fullPath: string, json: object): string | null;
+export declare function createFolder(fullPath: string): string;
+//# sourceMappingURL=file.utils.d.ts.map

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

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

package/dist/utils/file.utils.js

@@ -0,0 +1,35 @@
+import fs from "fs";
+import path from "path";
+export function loadFile(fullPath) {
+    try {
+        const buffer = fs.readFileSync(fullPath);
+        return buffer.toString();
+    }
+    catch (error) {
+        return null;
+    }
+}
+export function loadJson(fullPath) {
+    try {
+        const buffer = fs.readFileSync(fullPath);
+        return JSON.parse(buffer.toString());
+    }
+    catch (error) {
+        return undefined;
+    }
+}
+export function saveJson(fullPath, json) {
+    if (!json)
+        return null;
+    const jsonStr = JSON.stringify(json, null, 4);
+    fs.writeFileSync(fullPath, jsonStr);
+    return fullPath;
+}
+export function createFolder(fullPath) {
+    const dir = path.dirname(fullPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return fullPath;
+}
+//# sourceMappingURL=file.utils.js.map

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

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

package/dist/utils/log.utils.d.ts

@@ -0,0 +1,12 @@
+export declare function printJson(json: object): void;
+export declare function dumpJson(json: object): string | null;
+export declare const print: {
+    red: (msg: string) => void;
+    green: (msg: string) => void;
+    yellow: (msg: string) => void;
+    blue: (msg: string) => void;
+    magenta: (msg: string) => void;
+    cyan: (msg: string) => void;
+    white: (msg: string) => void;
+};
+//# sourceMappingURL=log.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.utils.d.ts","sourceRoot":"","sources":["../../src/utils/log.utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,QAErC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,iBAGpC;AAED,eAAO,MAAM,KAAK;eACN,MAAM;iBACJ,MAAM;kBACL,MAAM;gBACR,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;CACnB,CAAA"}

package/dist/utils/log.utils.js

@@ -0,0 +1,19 @@
+import { blue, cyan, green, magenta, red, white, yellow } from "console-log-colors";
+export function printJson(json) {
+    console.log(JSON.stringify(json, null, 2));
+}
+export function dumpJson(json) {
+    if (!json)
+        return null;
+    return JSON.stringify(json, null, 2);
+}
+export const print = {
+    red: (msg) => console.log(red(msg)),
+    green: (msg) => console.log(green(msg)),
+    yellow: (msg) => console.log(yellow(msg)),
+    blue: (msg) => console.log(blue(msg)),
+    magenta: (msg) => console.log(magenta(msg)),
+    cyan: (msg) => console.log(cyan(msg)),
+    white: (msg) => console.log(white(msg)),
+};
+//# sourceMappingURL=log.utils.js.map

package/dist/utils/log.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.utils.js","sourceRoot":"","sources":["../../src/utils/log.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEnF,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACpB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAC/C,CAAA"}

package/dist/utils/searchAndFilter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Filters an array of strings based on the presence of a substring.
+ * @param {string[]} arr - The array of strings to filter.
+ * @param {string} substring - The substring to search for.
+ * @param {boolean} [isCaseSensitive=true] - Determines if the search is case-sensitive. Default is true.
+ * @returns {string[]} - An array of strings that contain the substring. */
+export declare function searchArray(arr: string[], substring: string, isCaseSensitive?: boolean): any;
+export declare function filterArray(arr: any[]): any;
+//# sourceMappingURL=searchAndFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchAndFilter.d.ts","sourceRoot":"","sources":["../../src/utils/searchAndFilter.ts"],"names":[],"mappings":"AAAA;;;;;2EAK2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,UAAO,GAAG,GAAG,CAMzF;AAGD,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAI3C"}

package/dist/utils/searchAndFilter.js

@@ -0,0 +1,20 @@
+/**
+ * Filters an array of strings based on the presence of a substring.
+ * @param {string[]} arr - The array of strings to filter.
+ * @param {string} substring - The substring to search for.
+ * @param {boolean} [isCaseSensitive=true] - Determines if the search is case-sensitive. Default is true.
+ * @returns {string[]} - An array of strings that contain the substring. */
+export function searchArray(arr, substring, isCaseSensitive = true) {
+    return arr.filter((element) => {
+        if (isCaseSensitive)
+            return element.includes(substring);
+        return element.toLowerCase().includes(substring.toLowerCase());
+    });
+}
+/* Filters an array by removing null, undefined, and empty arrays. */
+export function filterArray(arr) {
+    return arr.filter((item) => {
+        return item !== null && item !== undefined && Array.isArray(item) ? item.length > 0 : true;
+    });
+}
+//# sourceMappingURL=searchAndFilter.js.map

package/dist/utils/searchAndFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchAndFilter.js","sourceRoot":"","sources":["../../src/utils/searchAndFilter.ts"],"names":[],"mappings":"AAAA;;;;;2EAK2E;AAC3E,MAAM,UAAU,WAAW,CAAC,GAAa,EAAE,SAAiB,EAAE,eAAe,GAAG,IAAI;IACnF,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,eAAe;YAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QAEvD,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,GAAU;IACrC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3F,CAAC,CAAC,CAAA;AACH,CAAC"}

package/dist/utils/tmp.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Formats a date to YYYY-MM-DD format
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Capitalizes the first letter of a string
+ */
+export declare function capitalize(text: string): string;
+/**
+ * Generates a random string of specified length
+ */
+export declare function randomString(length?: number): string;
+declare const _default: {
+    formatDate: typeof formatDate;
+    capitalize: typeof capitalize;
+    randomString: typeof randomString;
+};
+export default _default;
+//# sourceMappingURL=tmp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tmp.d.ts","sourceRoot":"","sources":["../../src/utils/tmp.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM,CAOvD;;;;;;AAGD,wBAIE"}

package/dist/utils/tmp.js

@@ -0,0 +1,36 @@
+// src/index.ts
+/**
+ * Formats a date to YYYY-MM-DD format
+ */
+export function formatDate(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Capitalizes the first letter of a string
+ */
+export function capitalize(text) {
+    if (!text)
+        return text;
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+/**
+ * Generates a random string of specified length
+ */
+export function randomString(length = 8) {
+    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+// Export everything as a namespace as well
+export default {
+    formatDate,
+    capitalize,
+    randomString,
+};
+//# sourceMappingURL=tmp.js.map

package/dist/utils/tmp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmp.js","sourceRoot":"","sources":["../../src/utils/tmp.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,CAAC;IAC3C,MAAM,KAAK,GAAG,gEAAgE,CAAC;IAC/E,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,2CAA2C;AAC3C,eAAe;IACX,UAAU;IACV,UAAU;IACV,YAAY;CACf,CAAC"}

package/dist/utils/tryCatchDecorator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * This try/catch decorator automatically wraps your methods in try-catch blocks so you don't have to!
+ * Works with both sync and async functions automatically!
+ * Works only on methods, not on class constructors, static methods or standalone functions.
+ *
+ * Basic Usage (just catch errors and return null):
+ *   @tryCatch()
+ *   getUserData(id: string) { ... }
+ *
+ * Return something else when errors happen:
+ *   @tryCatch({ returnVal: [] })
+ *
+ * Custom error handling:
+ *   @tryCatch({ cbk: (error) => ({ success: false, error: error.message }) })
+ *
+ * Async function with async custom handler
+    @tryCatch({
+        cbk: async (_) => {
+            await new Promise((resolve) => setTimeout(resolve, 50))
+            return []
+        },
+    })
+    async getAllUsersAsync() { }
+ */
+import type { TryCatchOptions } from "../types/index.js";
+export declare function tryCatch(options?: TryCatchOptions): (target: any, propertyName: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=tryCatchDecorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tryCatchDecorator.d.ts","sourceRoot":"","sources":["../../src/utils/tryCatchDecorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGxD,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,IACpC,QAAQ,GAAG,EAAE,cAAc,MAAM,EAAE,YAAY,kBAAkB,wBAwClF"}

package/dist/utils/tryCatchDecorator.js

@@ -0,0 +1,63 @@
+/**
+ * This try/catch decorator automatically wraps your methods in try-catch blocks so you don't have to!
+ * Works with both sync and async functions automatically!
+ * Works only on methods, not on class constructors, static methods or standalone functions.
+ *
+ * Basic Usage (just catch errors and return null):
+ *   @tryCatch()
+ *   getUserData(id: string) { ... }
+ *
+ * Return something else when errors happen:
+ *   @tryCatch({ returnVal: [] })
+ *
+ * Custom error handling:
+ *   @tryCatch({ cbk: (error) => ({ success: false, error: error.message }) })
+ *
+ * Async function with async custom handler
+    @tryCatch({
+        cbk: async (_) => {
+            await new Promise((resolve) => setTimeout(resolve, 50))
+            return []
+        },
+    })
+    async getAllUsersAsync() { }
+ */
+// The main decorator factory
+export function tryCatch(options = {}) {
+    return function (target, propertyName, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            try {
+                const result = originalMethod.apply(this, args);
+                // Handle both synchronous and asynchronous functions
+                if (result instanceof Promise) {
+                    return await result;
+                }
+                return result;
+            }
+            catch (error) {
+                // Log the error unless explicitly disabled
+                if (options.logError !== false) {
+                    console.error(`❌ Error in ${target.constructor.name}.${propertyName}:`, error.message);
+                    if (options.logStack === true && error.stack) {
+                        console.error(error.stack);
+                    }
+                }
+                // Use custom handler if provided
+                if (options.cbk) {
+                    const handlerResult = options.cbk(error);
+                    // Handle async custom handlers too
+                    return handlerResult instanceof Promise ? await handlerResult : handlerResult;
+                }
+                // Rethrow after logging (useful for debugging while still propagating errors)
+                if (options.rethrow) {
+                    throw error;
+                }
+                // Return fallback value or null
+                return options.returnVal ?? null;
+            }
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=tryCatchDecorator.js.map

package/dist/utils/tryCatchDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryCatchDecorator.js","sourceRoot":"","sources":["../../src/utils/tryCatchDecorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,6BAA6B;AAC7B,MAAM,UAAU,QAAQ,CAAC,UAA2B,EAAE;IACrD,OAAO,UAAU,MAAW,EAAE,YAAoB,EAAE,UAA8B;QACjF,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAA;QAEvC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAW;YAChD,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;gBAE/C,qDAAqD;gBACrD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC/B,OAAO,MAAM,MAAM,CAAA;gBACpB,CAAC;gBACD,OAAO,MAAM,CAAA;YACd,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACrB,2CAA2C;gBAC3C,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;oBAChC,OAAO,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,YAAY,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;oBACtF,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBAC9C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;oBAC3B,CAAC;gBACF,CAAC;gBAED,iCAAiC;gBACjC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;oBACjB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;oBACxC,mCAAmC;oBACnC,OAAO,aAAa,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,aAAa,CAAA;gBAC9E,CAAC;gBAED,8EAA8E;gBAC9E,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAA;gBACZ,CAAC;gBAED,gCAAgC;gBAChC,OAAO,OAAO,CAAC,SAAS,IAAI,IAAI,CAAA;YACjC,CAAC;QACF,CAAC,CAAA;QAED,OAAO,UAAU,CAAA;IAClB,CAAC,CAAA;AACF,CAAC"}

package/dist/utils/tryCatchSafe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wraps a function to catch errors and return undefined instead of throwing.
+ * Optionally logs the error message and stack trace.
+ *
+ * function risky() { throw new Error("fail"); }
+
+ * const safeRisky = safe(risky);                 // prints error and stack
+ * const silentRisky = safe(risky, false);        // no error printed
+ * const noStackRisky = safe(risky, true, false); // prints error, no stack
+ */
+export declare function safe<T extends (...args: any[]) => any, C = null>(fn: T, printError?: boolean, printStack?: boolean, customReturn?: C): (...args: Parameters<T>) => ReturnType<T> | C;
+//# sourceMappingURL=tryCatchSafe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tryCatchSafe.d.ts","sourceRoot":"","sources":["../../src/utils/tryCatchSafe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC,GAAG,IAAI,EAC/D,EAAE,EAAE,CAAC,EACL,UAAU,GAAE,OAAc,EAC1B,UAAU,GAAE,OAAc,EAC1B,YAAY,GAAE,CAAa,GACzB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAoC/C"}

package/dist/utils/tryCatchSafe.js

@@ -0,0 +1,49 @@
+/**
+ * Wraps a function to catch errors and return undefined instead of throwing.
+ * Optionally logs the error message and stack trace.
+ *
+ * function risky() { throw new Error("fail"); }
+
+ * const safeRisky = safe(risky);                 // prints error and stack
+ * const silentRisky = safe(risky, false);        // no error printed
+ * const noStackRisky = safe(risky, true, false); // prints error, no stack
+ */
+import { print } from "./log.utils.js";
+export function safe(fn, printError = true, printStack = true, customReturn = null) {
+    const getFileInfoFromStack = (stackTrace, functionName) => {
+        const lines = stackTrace.split("\n").map((line) => line.trim());
+        const fnLine = lines.find((line) => line.startsWith(`at ${functionName}`)) ||
+            lines.find((line) => /at .*:\d+:\d+/.test(line)) ||
+            lines[1] ||
+            "";
+        const regex = /at (?:\S+ \()?(.+):(\d+):(\d+)\)?$/; // captures the path:line:column after "at "
+        const match = fnLine.match(regex);
+        if (match) {
+            const [, path, line, col] = match;
+            return `${path}:${line}:${col}`;
+        }
+        return "";
+    };
+    return (...args) => {
+        try {
+            return fn(...args);
+        }
+        catch (e) {
+            if (printError) {
+                let fileInfo = "";
+                if (e instanceof Error && e.stack) {
+                    fileInfo = getFileInfoFromStack(e.stack, fn.name);
+                }
+                const header = `Exception in ${fn.name}()${fileInfo ? ` at ${fileInfo}` : ""}:`;
+                if (printStack && e instanceof Error) {
+                    print.red(`${header}\n${e.stack}`);
+                }
+                else {
+                    print.red(`${header} ${e}`);
+                }
+            }
+            return customReturn;
+        }
+    };
+}
+//# sourceMappingURL=tryCatchSafe.js.map

package/dist/utils/tryCatchSafe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryCatchSafe.js","sourceRoot":"","sources":["../../src/utils/tryCatchSafe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEtC,MAAM,UAAU,IAAI,CACnB,EAAK,EACL,aAAsB,IAAI,EAC1B,aAAsB,IAAI,EAC1B,eAAkB,IAAS;IAE3B,MAAM,oBAAoB,GAAG,CAAC,UAAkB,EAAE,YAAoB,EAAE,EAAE;QACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAC/D,MAAM,MAAM,GACX,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,YAAY,EAAE,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,KAAK,CAAC,CAAC,CAAC;YACR,EAAE,CAAA;QACH,MAAM,KAAK,GAAG,oCAAoC,CAAA,CAAC,4CAA4C;QAC/F,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;YACjC,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,GAAG,EAAE,CAAA;QAChC,CAAC;QACD,OAAO,EAAE,CAAA;IACV,CAAC,CAAA;IAED,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE;QAClB,IAAI,CAAC;YACJ,OAAO,EAAE,CAAC,GAAG,IAAI,CAAkB,CAAA;QACpC,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACrB,IAAI,UAAU,EAAE,CAAC;gBAChB,IAAI,QAAQ,GAAG,EAAE,CAAA;gBACjB,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;oBACnC,QAAQ,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;gBAClD,CAAC;gBACD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAA;gBAC/E,IAAI,UAAU,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;oBACtC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;gBACnC,CAAC;qBAAM,CAAC;oBACP,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC5B,CAAC;YACF,CAAC;YACD,OAAO,YAAY,CAAA;QACpB,CAAC;IACF,CAAC,CAAA;AACF,CAAC"}

package/dist/utils/typeChecks.d.ts

@@ -0,0 +1,8 @@
+export declare function isNullish(arg: any): boolean;
+export declare function isString(arg: any): arg is string;
+export declare function isNum(arg: any): arg is number;
+export declare function isEmptyArray(arr: any): boolean;
+export declare function isNonEmptyArray(arr: any): boolean;
+export declare function isEmptyObject(obj: any): boolean;
+export declare function objectsDeepEqual(obj1: any, obj2: any): boolean;
+//# sourceMappingURL=typeChecks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typeChecks.d.ts","sourceRoot":"","sources":["../../src/utils/typeChecks.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,WAEjC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,iBAEhC;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,iBAE7B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,WAEpC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,WAEvC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,WAMrC;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,WAsBpD"}

package/dist/utils/typeChecks.js

@@ -0,0 +1,43 @@
+export function isNullish(arg) {
+    return arg === null || arg === undefined;
+}
+export function isString(arg) {
+    return typeof arg === "string";
+}
+export function isNum(arg) {
+    return typeof arg === "number";
+}
+export function isEmptyArray(arr) {
+    return Array.isArray(arr) && arr.length === 0;
+}
+export function isNonEmptyArray(arr) {
+    return Array.isArray(arr) && arr.length > 0;
+}
+export function isEmptyObject(obj) {
+    if (typeof obj !== "object" || obj === null) {
+        return false;
+    }
+    return Object.keys(obj).length === 0;
+}
+/* Checks if two objects are deeply equal */
+export function objectsDeepEqual(obj1, obj2) {
+    if (obj1 === obj2)
+        return true;
+    if (isEmptyObject(obj1) && isEmptyObject(obj2))
+        return true;
+    if (typeof obj1 !== "object" || obj1 === null || typeof obj2 !== "object" || obj2 === null) {
+        return false;
+    }
+    const keys1 = Object.keys(obj1);
+    const keys2 = Object.keys(obj2);
+    if (keys1.length !== keys2.length) {
+        return false;
+    }
+    for (const key of keys1) {
+        if (!keys2.includes(key) || !objectsDeepEqual(obj1[key], obj2[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=typeChecks.js.map

package/dist/utils/typeChecks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeChecks.js","sourceRoot":"","sources":["../../src/utils/typeChecks.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,GAAQ;IACjC,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAQ;IAChC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAQ;IAC7B,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAQ;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAQ;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAQ;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAA;IACb,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACrC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,gBAAgB,CAAC,IAAS,EAAE,IAAS;IACpD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9B,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAE3D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC5F,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,KAAK,CAAA;IACb,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/dist/utils/user.utils.d.ts

@@ -0,0 +1,3 @@
+import type { User1, User2 } from "../types/index.js";
+export declare function formatUserName(user: User1): User2;
+//# sourceMappingURL=user.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user.utils.d.ts","sourceRoot":"","sources":["../../src/utils/user.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAErD,wBAAgB,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAUjD"}

package/dist/utils/user.utils.js

@@ -0,0 +1,11 @@
+export function formatUserName(user) {
+    const formatted = {
+        id: user.id,
+        name: user.name.toUpperCase(),
+        email: user.email.toLowerCase(),
+        age: user.age ?? 0,
+        additionalInfo: "No additional info provided",
+    };
+    return formatted;
+}
+//# sourceMappingURL=user.utils.js.map

package/dist/utils/user.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.utils.js","sourceRoot":"","sources":["../../src/utils/user.utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,IAAW;IACzC,MAAM,SAAS,GAAU;QACxB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;QAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;QAClB,cAAc,EAAE,6BAA6B;KAC7C,CAAA;IAED,OAAO,SAAS,CAAA;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+    "name": "@baklavabg/common-ts",
+    "version": "1.0.2",
+    "type": "module",
+    "description": "A comprehensive TypeScript library with common utility functions and custom types",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "npm run clean && tsc",
+        "clean": "rm -rf ./dist",
+        "dev": "tsc --watch",
+        "relink": "npm run build && npm link",
+        "prepublishOnly": "npm run build",
+        "cleanall": "npm run clean && rm -rf node_modules && rm package-lock.json",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "project:commit": "powershell -Command \"git add -A; git commit --all -m \\\"$((Get-Item (Get-Location)).Parent.Name)/$((Get-Item (Get-Location)).Name):$(Get-Date -Format 'yyyy-MM-dd_HH:mm:ss')\\\"; git push \"",
+        "project:commit:wsl": "git add -A && git commit -m \"$(basename $(dirname $(pwd)))/$(basename $(pwd)):$(date '+%Y-%m-%d_%H:%M:%S')\" && git push"
+    },
+    "author": "Your Name",
+    "license": "MIT",
+    "devDependencies": {
+        "@types/node": "^24.2.0",
+        "@vitest/coverage-v8": "^3.2.4",
+        "typescript": "^5.6.0",
+        "vitest": "^3.2.4"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "local"
+    },
+    "dependencies": {
+        "console-log-colors": "^0.5.0"
+    },
+    "peerDependencies": {
+        "typescript": ">=5.0.0"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js"
+        },
+        "./types": {
+            "types": "./dist/types/index.d.ts",
+            "import": "./dist/types/index.js",
+            "require": "./dist/types/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ]
+}