@leyyo/common 1.0.12 → 1.2.1

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

@@ -1,16 +1,16 @@
-import type { LanguageCode, LocaleCode } from "../system";
+export type HttpStatus = number;
 export type BasicType = 'undefined' | 'string' | 'object' | 'number' | 'boolean' | 'function' | 'symbol' | 'bigint';
+export type ExtendedType = BasicType | 'array' | 'class' | 'null' | 'empty' | 'nan' | 'integer' | 'date' | 'enum';
+export type KeyValue = string | number;
+export type AnyKey = string | number | symbol;
+export type Obj = Object & {};
 export type Dict<T = unknown> = Record<KeyValue, T>;
 export type Arr<T = unknown> = Array<T>;
-export type KeyValue = string | number;
 export type Id = string | number;
-export type Unknown = unknown;
 export type Integer = number;
 export type Float = number;
-export type Boolean = boolean;
-export type Enum = string;
 export type Alpha = string;
-export type String = string;
+export type Text = string;
 export type Digit = string;
 export type Title = string;
 export type Description = string;
@@ -24,75 +24,66 @@ export type Timestamp = number;
 export type IsoDatetime = string;
 export type IsoDate = string;
 export type IsoTime = string;
-interface _BaseFunc {
-    readonly name?: string;
-    readonly length?: number;
-    bind(thisArg: unknown, ...args: Array<unknown>): unknown;
-    apply(thisArg: unknown, args: Array<unknown>): unknown;
-    call(thisArg: unknown, ...args: Array<unknown>): unknown;
-}
-interface _SyncFnc<R> extends _BaseFunc {
-    (...args: Array<unknown>): R;
+export type Fnc<R = unknown> = ((...args: Arr) => R) & Function;
+export type Async<R = unknown> = ((...args: Arr) => Promise<R>) & AsyncGeneratorFunction;
+export interface Abstract<T = {}> extends Function {
+    prototype: T;
+    readonly name: string;
+    readonly length: number;
+    bind(thisArg: unknown, ...args: Arr): unknown;
+    apply(thisArg: unknown, args: Arr): unknown;
+    call(thisArg: unknown, ...args: Arr): unknown;
 }
-interface _AsyncFnc<R> extends _BaseFunc {
-    (...args: Array<unknown>): Promise<R>;
+export interface ClassLike<T = {}> extends Abstract<T> {
+    new (...args: Arr): T;
 }
-export type Fnc<R = unknown> = _SyncFnc<R> & Function;
-export type Async<R = unknown> = _AsyncFnc<R> & AsyncGeneratorFunction;
-export type AnyFnc<R = unknown> = Fnc<R> | Async<R>;
-export type _Type<T> = {
-    new (...args: Array<unknown>): T;
-    prototype?: unknown;
-};
-export type ClassLike<T = {}> = (_BaseFunc & _Type<T>) | _SyncFnc<T>;
 export type TypeOf<C = ClassLike> = C extends ClassLike<infer T> ? T : C;
+export declare namespace Express {
+    interface Request {
+        custom?: Dict;
+    }
+    interface Response {
+        custom?: Dict;
+    }
+}
 export interface Describable {
     description: string;
 }
 export interface Nameable {
     name: string;
 }
-export type ClassOrName = ClassLike | string;
-export type FuncOrName = Function | string;
-export type ClassOrFuncOrName = ClassLike | Function | string;
-/**
- * Referenced from Object
- * */
-export type Obj = Object & {};
-export interface Abstract<T> extends Function {
-    prototype: T;
-}
-export interface Entity<I extends Id = Uuid> {
-    id?: I;
-}
-export interface Pair<I extends Id = Uuid> extends Entity<I> {
-    name?: string;
+export interface HasId {
+    id?: string | number;
 }
 export type TypeOfMethod<T, M extends keyof T> = T[M] extends Function ? T[M] : never;
+export type TypeOfFnc<F extends Fnc> = F extends (...args: Arr) => infer R ? R : never;
+export type TypeOfAsync<F extends Async> = TypeOfPromise<TypeOfFnc<F>>;
+export type TypeOfPromise<P> = P extends Promise<infer R> ? R : P;
+/**
+ * String keys of a interface
+ * - Note: keyof keywords returns string|number|symbol, but it's ignore nuöber and symbol keys
+ * */
+export type StrKey<T> = Extract<keyof T, string>;
+/**
+ * Serialized version of another type
+ */
+export type Serialized<T> = {
+    [P in keyof T]: T[P];
+};
+/**
+ * Makes mutable an interface
+ *
+ * @see Readonly
+ * */
+export type Mutable<A> = {
+    -readonly [K in keyof A]: A[K];
+};
 export type KeyOf<T> = keyof T;
 export type Keys<T> = Array<keyof T>;
 export type ValueOf<T> = T[KeyOf<T>];
 export type Values<T> = Array<T[KeyOf<T>]>;
-export type MaximumOneOf<T, K extends keyof T = keyof T> = K extends keyof T ? {
-    [P in K]: T[K];
-} & Partial<Record<Exclude<keyof T, K>, never>> : never;
-export type OneOf<Obj> = ValueOf<OneOfByKey<Obj>>;
-export type Xor<A, B> = XorIn<A & {
-    [K in keyof B]?: undefined;
-}> | XorIn<B & {
-    [K in keyof A]?: undefined;
-}>;
 export type OneOrMore<T> = T | Array<T>;
-export type ValueOrCallback<T> = T | ValueCallback<T> | ValueCallbackAsync<T>;
-export type ValueCallback<T> = () => T;
-export type ValueCallbackAsync<T> = () => Promise<T>;
-type OneOnly<T, K extends keyof T> = Omit<T, Exclude<keyof T, K>> | Pick<T, K>;
-type OneOfByKey<T> = {
-    [key in keyof T]: OneOnly<T, key>;
-};
-type XorIn<T> = {
-    [K in keyof T]: T[K];
-} & unknown;
+export type SetOrMore<T> = T | Set<T>;
 /**
  * An interface which contains secure mode members and provides to shift to main mode
  * */
@@ -133,42 +124,11 @@ export interface InitLike {
      * */
     $init(...args: Arr): void;
 }
-/**
- * JSON Object
- */
-export type JsonObject = {
-    [K in string]?: JsonValue;
+export type EnumMap<E extends KeyValue = KeyValue> = {
+    [K in E]: KeyValue;
 };
-/**
- * JSON Array
- */
-export type JsonArray = Array<JsonValue>;
-/**
- * JSON Primitives
- */
-export type JsonPrimitive = string | number | boolean | null;
-/**
- * JSON Values
- */
-export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
-/**
- * Primitive language key
- *
- * It can be language (xx), local (xx-xx) or string (not preferred)
- * */
-export type I18nKey = LanguageCode | LocaleCode | string;
-/**
- * Language map
- *
- * @example
- * const name = {en: "Apple", tr: "Elma"};
- *
- * */
-export type I18nRaw<V = unknown> = Dict<V>;
-export type I18nAny<V = unknown> = I18nRaw<V> | V;
-export type EnumMap<E extends KeyValue = KeyValue> = Dict<E>;
 export type EnumAlt<E extends KeyValue = KeyValue> = Dict<E>;
-export type EnumLiteral<E extends KeyValue = KeyValue> = Array<E> | unknown;
+export type EnumLiteral<E extends KeyValue = KeyValue> = Array<E> | ReadonlyArray<E>;
 export type IgnoreFieldsByType<T, I> = {
     [K in keyof T]: T[K] extends I ? K : never;
 }[keyof T];
@@ -178,13 +138,31 @@ export type ReplaceType<T, O, N> = {
 export type SameType<A, T> = {
     [K in keyof A]: T;
 };
-/**
- * Serialized version of another type
- */
-export type Serialized<T> = {
-    [P in keyof T]: T[P];
+export type PickByType<T, I> = {
+    [K in keyof T]: T[K] extends I ? K : never;
 };
-export type Mutable<A> = {
-    -readonly [K in keyof A]: A[K];
+export type PickKeyByType<T, I> = PickByType<T, I>[keyof T];
+export type OmitByType<T, I> = {
+    [K in keyof T]: T[K] extends I ? never : K;
+};
+export type OmitKeysByType<T, I> = OmitByType<T, I>[keyof T];
+export type ValueOrCallback<T> = T | ValueCallback<T> | ValueCallbackAsync<T>;
+export type ValueCallback<T> = () => T;
+export type ValueCallbackAsync<T> = () => Promise<T>;
+export type MaximumOneOf<T, K extends keyof T = keyof T> = K extends keyof T ? {
+    [P in K]: T[K];
+} & Partial<Record<Exclude<keyof T, K>, never>> : never;
+export type OneOf<Obj> = ValueOf<OneOfByKey<Obj>>;
+export type Xor<A, B> = XorIn<A & {
+    [K in keyof B]?: undefined;
+}> | XorIn<B & {
+    [K in keyof A]?: undefined;
+}>;
+type OneOnly<T, K extends keyof T> = Omit<T, Exclude<keyof T, K>> | Pick<T, K>;
+type OneOfByKey<T> = {
+    [key in keyof T]: OneOnly<T, key>;
 };
+type XorIn<T> = {
+    [K in keyof T]: T[K];
+} & unknown;
 export {};

package/dist/shared/index.types.js

@@ -2,4 +2,35 @@
 // noinspection JSUnusedGlobalSymbols
 Object.defineProperty(exports, "__esModule", { value: true });
 // endregion
+/*
+
+// export type StrObject<T> = {
+//     [K in keyof T ]: K extends string ? K : never;
+// };
+// export type StrKey<T> = keyof StrObject<T>;
+
+interface _BaseFunc {
+    readonly name?: string;
+    readonly length?: number;
+    bind(thisArg: unknown, ...args: Array<unknown>): unknown;
+
+    apply(thisArg: unknown, args: Array<unknown>): unknown;
+
+    call(thisArg: unknown, ...args: Array<unknown>): unknown;
+}
+
+interface _SyncFnc<R> extends _BaseFunc {
+    (...args: Array<unknown>): R;
+}
+interface _AsyncFnc<R> extends _BaseFunc {
+    (...args: Array<unknown>): Promise<R>;
+}
+
+// export type ClassOrName = ClassLike | string;
+// export type FuncOrName = Function | string;
+// export type ClassOrFuncOrName = ClassLike | Function | string;
+// export type ClassLike<T = {}> = (_BaseFunc & _Type<T>) | _SyncFnc<T>;
+// export type AnyFnc<R = unknown> = Fnc<R> | Async<R>;
+
+*/
 //# sourceMappingURL=index.types.js.map

package/dist/shared/index.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.types.js","sourceRoot":"","sources":["../../src/shared/index.types.ts"],"names":[],"mappings":";AAAA,qCAAqC;;AAsPrC,YAAY"}
+{"version":3,"file":"index.types.js","sourceRoot":"","sources":["../../src/shared/index.types.ts"],"names":[],"mappings":";AAAA,qCAAqC;;AAsNrC,YAAY;AAGZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BE"}

package/dist/util/delay.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Delay or sleep n msec
+ *
+ * @param {number} waiting - waiting as milliseconds
+ * @param {any} response - response value
+ * @return {any}
+ * @async
+ * */
+export declare function delay<R = undefined>(waiting?: number, response?: R): Promise<R>;

package/dist/util/delay.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delay = delay;
+/**
+ * Delay or sleep n msec
+ *
+ * @param {number} waiting - waiting as milliseconds
+ * @param {any} response - response value
+ * @return {any}
+ * @async
+ * */
+function delay(waiting, response) {
+    if (typeof waiting !== "number" || waiting < 10) {
+        waiting = Math.round(Math.random() * 1000);
+    }
+    else if (!Number.isSafeInteger(waiting)) {
+        waiting = Math.round(waiting);
+    }
+    return new Promise(() => setTimeout(() => response, waiting));
+}
+//# sourceMappingURL=delay.js.map

package/dist/util/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/util/delay.ts"],"names":[],"mappings":";;AAQA,sBAQC;AAhBD;;;;;;;KAOK;AACL,SAAgB,KAAK,CAAgB,OAAgB,EAAE,QAAY;IAC/D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QAC9C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAK,CAAC,CAAC;IAChD,CAAC;SACI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,OAAO,CAAI,GAAG,EAAE,CAAC,UAAU,CAAC,GAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/util/empty.fn.d.ts

@@ -0,0 +1,8 @@
+import type { Arr } from "../shared";
+/**
+ * Empty function, it can be more useful sometimes
+ *
+ * @param {Arr} args - insignificant parameters
+ * @return {any}
+ * */
+export declare function emptyFn<R = unknown>(...args: Arr): R | void;

package/dist/util/empty.fn.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyFn = emptyFn;
+/**
+ * Empty function, it can be more useful sometimes
+ *
+ * @param {Arr} args - insignificant parameters
+ * @return {any}
+ * */
+function emptyFn(...args) { }
+//# sourceMappingURL=empty.fn.js.map

package/dist/util/empty.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.fn.js","sourceRoot":"","sources":["../../src/util/empty.fn.ts"],"names":[],"mappings":";;AAQA,0BAA6D;AAN7D;;;;;KAKK;AACL,SAAgB,OAAO,CAAc,GAAG,IAAS,IAAW,CAAC"}

package/dist/util/index.d.ts

@@ -0,0 +1,5 @@
+export * from './delay';
+export * from './empty.fn';
+export * from './one-or-more';
+export * from './secure-json';
+export * from './secure-clone';

package/dist/{developer → util}/index.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./index.types"), exports);
-__exportStar(require("./index.errors"), exports);
+__exportStar(require("./delay"), exports);
+__exportStar(require("./empty.fn"), exports);
+__exportStar(require("./one-or-more"), exports);
+__exportStar(require("./secure-json"), exports);
+__exportStar(require("./secure-clone"), exports);
 //# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,gDAA8B;AAC9B,gDAA8B;AAC9B,iDAA+B"}

package/dist/util/one-or-more.d.ts

@@ -0,0 +1,8 @@
+import type { OneOrMore } from "../shared";
+/**
+ * Return array value from one or more type
+ *
+ * @param {OneOrMore} value - it can be one value or array value
+ * @return {Array}
+ * */
+export declare function oneOrMore<T = unknown>(value: OneOrMore<T>): Array<T> | undefined;

package/dist/util/one-or-more.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneOrMore = oneOrMore;
+/**
+ * Return array value from one or more type
+ *
+ * @param {OneOrMore} value - it can be one value or array value
+ * @return {Array}
+ * */
+function oneOrMore(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    return [value];
+}
+//# sourceMappingURL=one-or-more.js.map

package/dist/util/one-or-more.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-or-more.js","sourceRoot":"","sources":["../../src/util/one-or-more.ts"],"names":[],"mappings":";;AAQA,8BAQC;AAdD;;;;;KAKK;AACL,SAAgB,SAAS,CAAc,KAAmB;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAiB,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,KAAK,CAAa,CAAC;AAC/B,CAAC"}

package/dist/util/secure-clone.d.ts

@@ -0,0 +1,3 @@
+import type { Obj } from "../shared";
+export declare function _secureClone<T>(value: T, weakSet: WeakSet<Obj>): T;
+export declare function secureClone<T>(value: T): T;

package/dist/util/secure-clone.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._secureClone = _secureClone;
+exports.secureClone = secureClone;
+function _secureClone(value, weakSet) {
+    if (value === undefined || value === null) {
+        return value;
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    if (weakSet.has(weakSet)) {
+        return value;
+    }
+    weakSet.add(value);
+    if (Array.isArray(value)) {
+        return value.map(item => secureClone(item));
+    }
+    if (value instanceof Set) {
+        return new Set(Array.from(value.values()).map(item => secureClone(item)));
+    }
+    if (value instanceof Map) {
+        const newMap = new Map();
+        for (const [k, v] of value.entries()) {
+            newMap.set(k, secureClone(v));
+        }
+        return newMap;
+    }
+    const newObj = {};
+    for (const [k, v] of Object.entries(value)) {
+        newObj[k] = secureClone(v);
+    }
+    return newObj;
+}
+function secureClone(value) {
+    return _secureClone(value, new WeakSet());
+}
+//# sourceMappingURL=secure-clone.js.map

package/dist/util/secure-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-clone.js","sourceRoot":"","sources":["../../src/util/secure-clone.ts"],"names":[],"mappings":";;AAEA,oCA6BC;AAED,kCAEC;AAjCD,SAAgB,YAAY,CAAI,KAAQ,EAAE,OAAqB;IAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAM,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACvB,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAM,CAAC;IACnF,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAW,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAW,CAAC;AACvB,CAAC;AAED,SAAgB,WAAW,CAAI,KAAQ;IACnC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/util/secure-json.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Converts an object to secure object
+ *
+ * - `secure` means:
+ * - removes `circular` relations
+ * - cuts after max depths, default: `10`
+ * - converts `Set` to `array`
+ * - converts `Map` to `object`
+ * - cuts `methods` of an object
+ * - cuts `symbol` properties of an object
+ * - cuts `non-string keys` of an object
+ * - cuts `undefined` properties of an object
+ *
+ * @param {any} value
+ * @return {any}
+ * */
+export declare function secureObject<E>(value: E): E;
+/**
+ * Converts an object to secure string
+ *
+ * - `secure` means:
+ * - removes `circular` relations
+ * - cuts after max depths, default: `10`
+ * - converts `Set` to `array`
+ * - converts `Map` to `object`
+ * - cuts `methods` of an object
+ * - cuts `symbol` properties of an object
+ * - cuts `non-string keys` of an object
+ * - cuts `undefined` properties of an object
+ *
+ * Note:
+ * `JSON.stringify` can fail if there is a `dependency
+ *
+ * @param {any} value
+ * @return {string}
+ * */
+export declare function secureJson(value: unknown): string;

package/dist/util/secure-json.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secureObject = secureObject;
+exports.secureJson = secureJson;
+/**
+ * Inner secure json function, it will be used after creating weak set
+ *
+ * @param {any} value
+ * @param {number} depth
+ * @param {WeakSet} set
+ * */
+function _secureObject(value, depth, set) {
+    var _a, _b, _c;
+    if ([null, undefined].includes(value)) {
+        return value;
+    }
+    switch (typeof value) {
+        case 'object':
+            if (set.has(value)) {
+                return `#circular <${(_a = value === null || value === void 0 ? void 0 : value.constructor) === null || _a === void 0 ? void 0 : _a.name}>`;
+            }
+            if (depth >= 10) {
+                return `#depth <${(_b = value === null || value === void 0 ? void 0 : value.constructor) === null || _b === void 0 ? void 0 : _b.name}>`;
+            }
+            set.add(value);
+            if (Array.isArray(value)) {
+                return value.map(item => _secureObject(item, depth + 1, set));
+            }
+            if (value instanceof Set) {
+                return Array.from(value).map(item => _secureObject(item, depth + 1, set));
+            }
+            const obj = {};
+            if (value instanceof Map) {
+                for (const [k, v] of value.entries()) {
+                    if (typeof k === 'string') {
+                        obj[k] = _secureObject(v, depth + 1, set);
+                    }
+                }
+            }
+            else if ((value === null || value === void 0 ? void 0 : value.constructor) === Object) {
+                for (const [k, v] of Object.entries(value)) {
+                    if (typeof k === 'string') {
+                        obj[k] = _secureObject(v, depth + 1, set);
+                    }
+                }
+            }
+            else {
+                let exists;
+                for (const [k, v] of Object.entries(value)) {
+                    if (typeof k === 'string' && !['function', 'symbol', 'undefined'].includes(typeof value)) {
+                        exists = true;
+                        obj[k] = _secureObject(v, depth + 1, set);
+                    }
+                }
+                if (!exists) {
+                    try {
+                        return JSON.parse(JSON.stringify(value));
+                    }
+                    catch (e) {
+                        return `#parse <${(_c = value === null || value === void 0 ? void 0 : value.constructor) === null || _c === void 0 ? void 0 : _c.name}>`;
+                    }
+                }
+            }
+            return obj;
+        case 'function':
+            return `#function <${value.name}> (length: ${value.length})`;
+        case 'symbol':
+            return `#symbol <${value.description}>`;
+    }
+    return value;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Converts an object to secure object
+ *
+ * - `secure` means:
+ * - removes `circular` relations
+ * - cuts after max depths, default: `10`
+ * - converts `Set` to `array`
+ * - converts `Map` to `object`
+ * - cuts `methods` of an object
+ * - cuts `symbol` properties of an object
+ * - cuts `non-string keys` of an object
+ * - cuts `undefined` properties of an object
+ *
+ * @param {any} value
+ * @return {any}
+ * */
+function secureObject(value) {
+    try {
+        return _secureObject(value, 0, new WeakSet());
+    }
+    catch (e) {
+        return `#error <${e.name}> (message: ${e.message})`;
+    }
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Converts an object to secure string
+ *
+ * - `secure` means:
+ * - removes `circular` relations
+ * - cuts after max depths, default: `10`
+ * - converts `Set` to `array`
+ * - converts `Map` to `object`
+ * - cuts `methods` of an object
+ * - cuts `symbol` properties of an object
+ * - cuts `non-string keys` of an object
+ * - cuts `undefined` properties of an object
+ *
+ * Note:
+ * `JSON.stringify` can fail if there is a `dependency
+ *
+ * @param {any} value
+ * @return {string}
+ * */
+function secureJson(value) {
+    try {
+        const json = _secureObject(value, 0, new WeakSet());
+        return (typeof json === 'string') ? json : JSON.stringify(json);
+    }
+    catch (e) {
+        return `#error <${e.name}> (message: ${e.message})`;
+    }
+}
+//# sourceMappingURL=secure-json.js.map

package/dist/util/secure-json.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leyyo/common",
-  "version": "1.0.12",
+  "version": "1.2.1",
   "description": "Common library",
   "keywords": [
     "common"
@@ -49,6 +49,6 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "yaml": "^2.8.0"
+    "stacktrace-parser": "^0.1.11"
   }
 }