@michaelroling/ts-library 1.0.2 → 1.0.3

package/dist/index.js

@@ -1,2 +1,5 @@
 import "./prototype/array";
-export { helloWorld } from "./lib/test";
+import "./prototype/string";
+import "./prototype/number";
+export { toJsonString, toJSON } from "./json";
+export { deepCopy, isFalsy, isDefined, isTruthy, isString } from "./lib";

package/dist/json/index.js

@@ -0,0 +1,9 @@
+export const toJsonString = (val) => JSON.stringify(val, null, 2);
+export function toJSON(val) {
+    try {
+        return val ? { json: JSON.parse(val), isValidJson: true } : { json: null, isValidJson: false, error: "Value is null" };
+    }
+    catch (e) {
+        return { json: null, isValidJson: false, error: e };
+    }
+}

package/dist/lib/index.js

@@ -0,0 +1,17 @@
+export const isTruthy = (value) => isDefined(value) && ["1", 1, true, "true"].includes(value);
+export const isFalsy = (value) => ["0", 0, false, "false", undefined, null].includes(value);
+export const isDefined = (value) => value !== undefined && value !== null;
+export const deepCopy = (value, errorHandler) => {
+    try {
+        return !isDefined(value) ? undefined : JSON.parse(JSON.stringify(value));
+    }
+    catch (err) {
+        if (errorHandler) {
+            errorHandler(err);
+            return;
+        }
+        // eslint-disable-next-line no-console
+        console.error(err);
+    }
+};
+export const isString = (value) => typeof value === "string";

package/dist/prototype/array.js

@@ -1,10 +1,47 @@
-"use strict";
-Array.prototype.mrFirst = function () {
-    return this?.[0];
+import "../types/array.d.ts";
+const mrFirst = function () {
+    return this[0];
 };
-Array.prototype.mrLast = function () {
-    return this?.[this.length - 1];
+const mrLast = function () {
+    return this[this.length - 1];
 };
-Array.prototype.mrNth = function (n) {
-    return this?.[n];
+const mrNth = function (n) {
+    return this[n];
 };
+const mrRemoveDuplicates = function () {
+    return this.filter((item, index) => this.indexOf(item) === index);
+};
+const mrTrimItems = function () {
+    return this.map((item) => (typeof item === "string" ? item.trim() : item));
+};
+const mrSum = function () {
+    return this.reduce((acc, val) => acc + val, 0);
+};
+const mrAverage = function () {
+    if (this.length === 0) {
+        return 0;
+    }
+    return this.mrSum() / this.length;
+};
+const mrMin = function () {
+    return this.reduce((acc, val) => (val < acc ? val : acc), this[0]);
+};
+const mrMax = function () {
+    return this.reduce((acc, val) => (val > acc ? val : acc), this[0]);
+};
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+const arrayPrototypeMethods = [
+    ["mrFirst", mrFirst],
+    ["mrLast", mrLast],
+    ["mrNth", mrNth],
+    ["mrRemoveDuplicates", mrRemoveDuplicates],
+    ["mrTrimItems", mrTrimItems],
+    ["mrSum", mrSum],
+    ["mrAverage", mrAverage],
+    ["mrMin", mrMin],
+    ["mrMax", mrMax],
+];
+for (const [name, fn] of arrayPrototypeMethods) {
+    // @ts-expect-error: Prototype-Erweiterung
+    Array.prototype[name] = fn;
+}

package/dist/prototype/number.js

@@ -0,0 +1,14 @@
+import "../types/number.d.ts";
+const mrPad = function (length = 2) {
+    if (this < 0) {
+        return `-${(this * -1).toString().padStart(length - 1, "0")}`;
+    }
+    return this.toString().padStart(length, "0");
+};
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+const numberPrototypeMethods = [["mrPad", mrPad]];
+for (const [name, fn] of numberPrototypeMethods) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-expect-error
+    Number.prototype[name] = fn;
+}

package/dist/prototype/string.js

@@ -0,0 +1,48 @@
+import "../types/string.d.ts";
+const mrReplaceAll = function (searched, replacement) {
+    const escapedSearchValue = searched.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return this.replace(new RegExp(escapedSearchValue, "g"), replacement);
+};
+const mrIsEmptyString = function () {
+    return this.trim() === "";
+};
+const mrIsBooleanString = function () {
+    return this === "true" || this === "false";
+};
+const mrDecomposeText = function (first, second) {
+    const startIndex = this.indexOf(first);
+    const endIndex = this.indexOf(second, startIndex);
+    const substring = this.substring(startIndex, endIndex + second.length);
+    const substringExcludeSearch = substring.mrStringReplacer([
+        { val: first, newValue: "" },
+        { val: second, newValue: "" },
+    ]);
+    const textExcludeSubstring = this.replace(substring, "").trim();
+    return {
+        startIndex,
+        endIndex,
+        substring,
+        textExcludeSubstring,
+        substringExcludeSearch,
+    };
+};
+const mrStringReplacer = function (valueToReplace) {
+    return valueToReplace.reduce((acc, { val, newValue }) => acc.replace(val, newValue ?? ""), this);
+};
+const mrFirstLetterToUpperCase = function () {
+    return this.slice(0, 1).toUpperCase() + this.slice(1);
+};
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+const stringPrototypeMethods = [
+    ["mrReplaceAll", mrReplaceAll],
+    ["mrIsEmptyString", mrIsEmptyString],
+    ["mrIsBooleanString", mrIsBooleanString],
+    ["mrDecomposeText", mrDecomposeText],
+    ["mrStringReplacer", mrStringReplacer],
+    ["mrFirstLetterToUpperCase", mrFirstLetterToUpperCase],
+];
+for (const [name, fn] of stringPrototypeMethods) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-expect-error
+    String.prototype[name] = fn;
+}

package/dist/types/array.d.ts

@@ -1,8 +1,35 @@
-interface Array<T> {
-  /** Gets the first element of the array. */
-  mrFirst(): T | undefined;
-  /** Gets the last element of the array. */
-  mrLast(): T | undefined;
-  /** Gets the nth element of the array. */
-  mrNth(n: number): T | undefined;
+declare global {
+  interface Array {
+    /** Gets the first element of the array. */
+    mrFirst: MrFirst;
+    /** Gets the last element of the array. */
+    mrLast: MrLast;
+    /** Gets the nth element of the array. */
+    mrNth: MrNth;
+    /** Removes duplicate primitive values from the array. */
+    mrRemoveDuplicates: MrRemoveDuplicates;
+    /** Trims whitespace from string elements in the array. */
+    mrTrimItems: MrTrimItems;
+    /** Sums up the numeric elements in the array. */
+    mrSum: MrSum;
+    /** Calculates the average of the numeric elements in the array. */
+    mrAverage: MrAverage;
+    /** Finds the minimum numeric value in the array. */
+    mrMin: MrMin;
+    /** Finds the maximum numeric value in the array. */
+    mrMax: MrMax;
+  }
 }
+
+export type MrFirst = <T>(this: T[]) => T | undefined;
+export type MrLast = <T>(this: T[]) => T | undefined;
+export type MrNth = <T>(this: T[], n: number) => T | undefined;
+export type MrRemoveDuplicates = (this: Primitive[]) => Primitive[];
+export type MrTrimItems = (this: Primitive[]) => Primitive[];
+export type MrSum = (this: number[]) => number;
+export type MrAverage = (this: number[]) => number;
+export type MrMin = (this: number[]) => number | undefined;
+export type MrMax = (this: number[]) => number | undefined;
+
+export type Primitive = string | number | boolean;
+export {};

package/dist/types/index.d.ts

@@ -1,2 +1,4 @@
-import "./array";
-export declare function helloWorld(): string;
+import "./array";
+import "./json";
+import "./lib";
+import "./string";

package/dist/types/json.d.ts

@@ -0,0 +1,8 @@
+export declare function toJSON<T>(val: string | null): JsonResponse<T>;
+export declare function toJsonString(val: string | number | boolean | object): string;
+
+export interface JsonResponse<T> {
+  json: T | null;
+  isValidJson: boolean;
+  error?: unknown;
+}

package/dist/types/lib.d.ts

@@ -0,0 +1,4 @@
+export declare function isTruthy  (value: any): boolean;
+export declare function isFalsy  (value: any): boolean;
+export declare function isDefined  <T>(value: T | undefined | null): value is T 
+export declare function deepCopy <T>(obj: T, errorHandler?:(e:any)=>void): T | undefined  

package/dist/types/number.d.ts

@@ -0,0 +1,12 @@
+declare global {
+  interface Number {
+    /** Pads a number with leading zeros to reach a specified length.
+     * @param length The desired total length of the resulting string. Default is 2.
+     */
+    mrPad: MrPad;
+  }
+}
+
+export type MrPad = (ThisType: number, length?: number) => string;
+
+export {};

package/dist/types/string.d.ts

@@ -0,0 +1,37 @@
+declare global {
+  interface String {
+    /**  Replaces all occurrences of a substring with a new string. */
+    mrReplaceAll: MrReplaceAll;
+    /**  Checks if the string is empty or contains only whitespace characters. */
+    mrIsEmptyString: MrIsEmptyString;
+    /**  Checks if the string represents a boolean value ('true' or 'false'). */
+    mrIsBooleanString: MrIsBooleanString;
+    /** Decomposes the string into parts based on two search strings. */
+    mrDecomposeText: MrDecomposeText;
+    /** Replaces multiple specified substrings with their corresponding new values. */
+    mrStringReplacer: MrStringReplacer;
+    /** Converts the first letter of the string to uppercase. */
+    mrFirstLetterToUpperCase: MrFirstLetterToUpperCase;
+  }
+}
+
+export type MrReplaceAll = (this: string, searched: string, replacement: string) => string;
+export type MrIsEmptyString = (this: string) => boolean;
+export type MrIsBooleanString = (this: string) => boolean;
+export type MrDecomposeText = (this: string, first: string, second: string) => DecomposeTextReturnType;
+export type MrStringReplacer = (this: string, valueToReplace: StringReplacerObj[]) => string;
+export type MrFirstLetterToUpperCase = (this: string) => string;
+
+export interface DecomposeTextReturnType {
+  startIndex: number;
+  endIndex: number;
+  substring: string;
+  textExcludeSubstring: string;
+  substringExcludeSearch: string;
+}
+
+export interface StringReplacerObj {
+  val: string;
+  newValue?: string;
+}
+export {};

package/package.json

@@ -1,51 +1,53 @@
-{
-  "name": "@michaelroling/ts-library",
-  "version": "1.0.2",
-  "description": "",
-  "main": "dist/index.js",
-  "types": "dist/types/index.d.ts",
-  "module": "dist/index.js",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "chai": "^6.2.2",
-    "esbuild": "^0.27.2",
-    "prettier": "3.8.0",
-    "rollup": "^4.55.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.17"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@vitest/coverage-v8": "4.0.17",
-    "cpx2": "^8.0.0",
-    "eslint": "^9.39.2",
-    "globals": "^17.0.0",
-    "jiti": "^2.6.1",
-    "jsdom": "^27.4.0",
-    "typescript-eslint": "^8.53.0"
-  },
-  "scripts": {
-    "test": "vitest",
-    "coverage": "vitest run --coverage",
-    "lint": "eslint --ext .ts src --fix",
-    "build": "tsc -p tsconfig.json && npx cpx2 \"src/types/**/*.d.ts\" dist/types",
-    "prepublishOnly": "yarn build"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MiRo1310/ts-library.git"
-  },
-  "author": "Michael Roling",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/MiRo1310/ts-library/issues"
-  },
-  "homepage": "https://github.com/MiRo1310/ts-library#readme"
-}
+{
+  "name": "@michaelroling/ts-library",
+  "version": "1.0.3",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/types/index.d.ts",
+  "module": "dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "chai": "^6.2.2",
+    "esbuild": "^0.27.2",
+    "prettier": "3.8.0",
+    "rollup": "^4.55.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@vitest/coverage-v8": "4.0.17",
+    "cpx2": "^8.0.0",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "jiti": "^2.6.1",
+    "jsdom": "^27.4.0",
+    "typescript-eslint": "^8.53.0"
+  },
+  "scripts": {
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage --coverage.threshold=100",
+    "coverage": "vitest run --coverage",
+    "lint": "eslint --ext .ts src --fix",
+    "build": "tsc -p tsconfig.json && npx cpx2 \"src/types/**/*.d.ts\" dist/types",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "yarn build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MiRo1310/ts-library.git"
+  },
+  "author": "Michael Roling",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/MiRo1310/ts-library/issues"
+  },
+  "homepage": "https://github.com/MiRo1310/ts-library#readme"
+}