@tsed/core 6.88.1 → 6.89.0

package/lib/types/utils/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./catchError";
+export * from "./proxyDelegation";
+export * from "./uniq";
+export * from "./imports/importPackage";
+export * from "./decorators/decorateMethodsOf";
+export * from "./decorators/decoratorArgs";
+export * from "./decorators/decoratorTypeOf";
+export * from "./objects/descriptorOf";
+export * from "./decorators/inheritedDescriptorOf";
+export * from "./decorators/useDecorators";
+export * from "./decorators/useMethodDecorators";
+export * from "./objects";

package/lib/types/utils/objects/ancestorOf.d.ts

@@ -0,0 +1,2 @@
+export declare function ancestorOf(target: any): any;
+export declare function getInheritedClass(target: any): any;

package/lib/types/utils/objects/ancestorsOf.d.ts

@@ -0,0 +1,6 @@
+/**
+ *
+ * @param target
+ * @returns {Array}
+ */
+export declare function ancestorsOf(target: any): any[];

package/lib/types/utils/objects/classOf.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get the provide constructor if target is an instance.
+ * @param target
+ * @returns {*}
+ */
+export declare function getClass(target: any): any;
+/**
+ * Get the provide constructor if target is an instance.
+ * @param target
+ * @returns {*}
+ * @alias getClass
+ */
+export declare function classOf(target: any): any;

package/lib/types/utils/objects/cleanObject.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Remove undefined value
+ * @param obj
+ * @param ignore
+ */
+export declare function cleanObject(obj: any, ignore?: string[]): any;

package/lib/types/utils/objects/constructorOf.d.ts

@@ -0,0 +1,11 @@
+import type { Type } from "../../domain/Type";
+/**
+ * Get the class constructor
+ * @param target
+ */
+export declare function getConstructor(target: any): Type<any>;
+/**
+ * Get the class constructor
+ * @param target
+ */
+export declare function constructorOf(target: any): Type<any>;

package/lib/types/utils/objects/createInstance.d.ts

@@ -0,0 +1 @@
+export declare function createInstance(obj: any): any;

package/lib/types/utils/objects/deepClone.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Return a cloned value
+ * @param source
+ * @param stack
+ */
+export declare function deepClone(source: any, stack?: WeakMap<object, any>): any;

package/lib/types/utils/objects/deepExtends.d.ts

@@ -0,0 +1,10 @@
+export declare type DeepExtendsReducers = Record<string, (collection: any[], value: any) => any>;
+/**
+ * Deep extends a model with another one.
+ * @param out
+ * @param obj
+ * @param reducers
+ * @returns {any}
+ * @deprecated Since 2021-07-16. Use deepMerge instead of
+ */
+export declare function deepExtends(out: any, obj: any, reducers?: DeepExtendsReducers): any;

package/lib/types/utils/objects/deepMerge.d.ts

@@ -0,0 +1,9 @@
+export declare type DeepMergeReducerCB = (collection: any[], value: any, options?: DeepMergeOptions) => any;
+export declare type DeepMergeComparatorCB = (item: any, ref: any) => boolean;
+export interface DeepMergeOptions {
+    reducers?: Record<string, DeepMergeReducerCB>;
+    parentKey?: string;
+    cleanUndefinedProps?: boolean;
+}
+export declare function mergeReducerBuilder(cb: DeepMergeComparatorCB): (collection: any[], value: any, options: DeepMergeOptions) => any[];
+export declare function deepMerge<T extends any = any, C extends any = any>(source: T & any, obj: C & any, options?: DeepMergeOptions): (T & C) | undefined | null;

package/lib/types/utils/objects/descriptorOf.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return the descriptor for a given class and propertyKey
+ * @param target
+ * @param {string} propertyKey
+ * @returns {PropertyDescriptor}
+ */
+export declare function descriptorOf(target: any, propertyKey: string | symbol): PropertyDescriptor;
+export declare function isMethodDescriptor(target: any, propertyKey: string | symbol): any;

package/lib/types/utils/objects/getClassOrSymbol.d.ts

@@ -0,0 +1 @@
+export declare function getClassOrSymbol(target: any): any;

package/lib/types/utils/objects/getConstructorArgNames.d.ts

@@ -0,0 +1 @@
+export declare function getConstructorArgNames(target: any): string[];

package/lib/types/utils/objects/getEnumerableKeys.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Return all enumerable keys of the given object
+ * @param obj
+ */
+export declare function getEnumerableKeys(obj: any): string[];

package/lib/types/utils/objects/getValue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Get value from scope
+ * @param {string} expression
+ * @param scope
+ * @returns {any}
+ */
+export declare function getValue<T = any>(scope: any, expression: string | undefined): T | undefined;
+/**
+ * Get value from scope
+ * @param {string} expression
+ * @param scope
+ * @param defaultValue
+ * @param separator
+ * @returns {any}
+ */
+export declare function getValue<T = any>(scope: any, expression: string | undefined, defaultValue: T, separator?: string): T;
+/**
+ * Get value from scope
+ * @param {string} expression
+ * @param scope
+ * @returns {any}
+ */
+export declare function getValue<T = any>(expression: string | undefined, scope: any): T | undefined;
+/**
+ * Get value from scope
+ * @param {string} expression
+ * @param scope
+ * @param defaultValue
+ * @param separator
+ * @returns {any}
+ */
+export declare function getValue<T = any>(expression: string | undefined, scope: any, defaultValue: T, separator?: string): T;

package/lib/types/utils/objects/index.d.ts

@@ -0,0 +1,43 @@
+export * from "./ancestorOf";
+export * from "./ancestorsOf";
+export * from "./classOf";
+export * from "./cleanObject";
+export * from "./constructorOf";
+export * from "./deepClone";
+export * from "./deepExtends";
+export * from "./deepMerge";
+export * from "./getClassOrSymbol";
+export * from "./getConstructorArgNames";
+export * from "./getEnumerableKeys";
+export * from "./ancestorOf";
+export * from "./getValue";
+export * from "./isArray";
+export * from "./isArrowFn";
+export * from "./isBoolean";
+export * from "./isClass";
+export * from "./isCollection";
+export * from "./isDate";
+export * from "./isEmpty";
+export * from "./isEnumerable";
+export * from "./isFunction";
+export * from "./isInheritedFrom";
+export * from "./isNil";
+export * from "./isNumber";
+export * from "./isObject";
+export * from "./isObservable";
+export * from "./isPlainObject";
+export * from "./isPrimitive";
+export * from "./isPromise";
+export * from "./isProtectedKey";
+export * from "./isStream";
+export * from "./isString";
+export * from "./isSymbol";
+export * from "./isSerializable";
+export * from "./methodsOf";
+export * from "./nameOf";
+export * from "./objectKeys";
+export * from "./primitiveOf";
+export * from "./prototypeOf";
+export * from "./setValue";
+export * from "./toMap";
+export * from "./toStringConstructor";

package/lib/types/utils/objects/isArray.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return true if value is an array
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isArray<T = any>(target: unknown): target is T[];
+/**
+ * Return true if the clazz is an array.
+ * @param target
+ * @returns {boolean}
+ * @ignore
+ */
+export declare function isArrayOrArrayClass<T = any>(target: unknown): target is T[];

package/lib/types/utils/objects/isArrowFn.d.ts

@@ -0,0 +1 @@
+export declare function isArrowFn(target: any): target is Function;

package/lib/types/utils/objects/isBoolean.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isBoolean(target: any): target is boolean;
+export declare function isBooleanOrBooleanClass(target: any): target is boolean;

package/lib/types/utils/objects/isClass.d.ts

@@ -0,0 +1 @@
+export declare function isClass(target: any): boolean;

package/lib/types/utils/objects/isCollection.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Return true if the target.
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isCollection(target: any): boolean;

package/lib/types/utils/objects/isDate.d.ts

@@ -0,0 +1,6 @@
+/**
+ *
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isDate(target: any): target is Date;

package/lib/types/utils/objects/isEmpty.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Return true if the value is an empty string, null or undefined.
+ * @param value
+ * @returns {boolean}
+ */
+export declare function isEmpty(value: any): boolean;

package/lib/types/utils/objects/isEnumerable.d.ts

@@ -0,0 +1,6 @@
+/**
+ *
+ * @param obj
+ * @param key
+ */
+export declare function isEnumerable(obj: any, key: string): any;

package/lib/types/utils/objects/isFunction.d.ts

@@ -0,0 +1 @@
+export declare function isFunction(target: any): target is Function;

package/lib/types/utils/objects/isInheritedFrom.d.ts

@@ -0,0 +1 @@
+export declare function isInheritedFrom(target: any, from: any, deep?: number): boolean;

package/lib/types/utils/objects/isNil.d.ts

@@ -0,0 +1 @@
+export declare function isNil(value: any): boolean;

package/lib/types/utils/objects/isNumber.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isNumber(target: any): target is number;
+export declare function isNumberOrNumberClass(target: any): target is number;

package/lib/types/utils/objects/isObject.d.ts

@@ -0,0 +1 @@
+export declare function isObject(target: any): target is object;

package/lib/types/utils/objects/isObservable.d.ts

@@ -0,0 +1 @@
+export declare function isObservable<T>(obj: any): boolean;

package/lib/types/utils/objects/isPlainObject.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isClassObject(target: any): target is Object;
+export declare function isPlainObject(target: any): boolean;

package/lib/types/utils/objects/isPrimitive.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return true if the given obj is a primitive.
+ * @param target
+ * @returns {boolean}
+ * @ignore
+ */
+export declare function isPrimitiveOrPrimitiveClass(target: any): boolean;
+/**
+ * Return true if the given obj is a primitive.
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isPrimitive(target: any): boolean;
+export declare function isPrimitiveClass(target: any): boolean;

package/lib/types/utils/objects/isPromise.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests to see if the object is an ES2015 (ES6) Promise
+ * @see {@link https://www.ecma-international.org/ecma-262/6.0/#sec-promise-objects}
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isPromise<T = any>(target: any): target is Promise<T>;

package/lib/types/utils/objects/isProtectedKey.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Prevent prototype pollution vulnerability
+ * @param key
+ */
+export declare function isProtectedKey(key: string): boolean;

package/lib/types/utils/objects/isSerializable.d.ts

@@ -0,0 +1 @@
+export declare function isSerializable(data: any): boolean;

package/lib/types/utils/objects/isStream.d.ts

@@ -0,0 +1 @@
+export declare function isStream(obj: any): boolean;

package/lib/types/utils/objects/isString.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param target
+ * @returns {boolean}
+ */
+export declare function isString(target: any): target is string;
+export declare function isStringOrStringClass(target: any): target is string;

package/lib/types/utils/objects/isSymbol.d.ts

@@ -0,0 +1,6 @@
+/**
+ *
+ * @param target
+ */
+export declare function isSymbol(target: any): target is symbol;
+export declare function isSymbolOrSymbolClass(target: any): target is symbol;

package/lib/types/utils/objects/methodsOf.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Return all methods for a given class.
+ * @param target
+ */
+export declare function methodsOf(target: any): any[];

package/lib/types/utils/objects/nameOf.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Get the provide name.
+ * @param targetClass
+ */
+export declare function nameOfClass(targetClass: any): string;
+/**
+ * Get symbol name.
+ * @param sym
+ */
+export declare const nameOfSymbol: (sym: symbol) => string;
+/**
+ * Get object name
+ */
+export declare function nameOf(obj: any): string;

package/lib/types/utils/objects/objectKeys.d.ts

@@ -0,0 +1 @@
+export declare function objectKeys(obj: any): string[];

package/lib/types/utils/objects/primitiveOf.d.ts

@@ -0,0 +1 @@
+export declare function primitiveOf(target: any): "string" | "number" | "boolean" | "any";

package/lib/types/utils/objects/prototypeOf.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Return the prototype of the given class.
+ * @param target
+ * @returns {any}
+ */
+export declare function prototypeOf(target: any): any;

package/lib/types/utils/objects/setValue.d.ts

@@ -0,0 +1 @@
+export declare function setValue(scope: any, expression: string, value: any, separator?: string): void;

package/lib/types/utils/objects/toMap.d.ts

@@ -0,0 +1,3 @@
+export declare type ToMapIdentityCB<V> = (item: V, index: string | number) => string | string[];
+export declare type ToMapIdentity<V> = string | ToMapIdentityCB<V>;
+export declare function toMap<K extends keyof any = any, V = any>(input: Record<K, V> | V[], keyOrFn?: ToMapIdentity<V>): Map<K, V>;

package/lib/types/utils/objects/toStringConstructor.d.ts

@@ -0,0 +1 @@
+export declare function toStringConstructor(target: any): string;

package/lib/types/utils/proxyDelegation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @ignore
+ */
+export declare type ProxyDelegationGetter<T = any> = (target: T, property: PropertyKey) => any | undefined;
+/**
+ * @ignore
+ */
+export declare type ProxyDelegationRemove<T = any> = (target: T, property: PropertyKey) => any;
+/**
+ * @ignore
+ */
+export declare type ProxyDelegationSetter<T = any> = (target: T, property: PropertyKey, value: any, receiver: any) => any;
+/**
+ * @ignore
+ */
+export declare type ProxyDelegationOwnKeys<T = any> = (target: T) => (string | symbol)[];
+/**
+ * @ignore
+ */
+export interface ProxyDelegation<T extends object> {
+    handlers?: ProxyHandler<T>;
+    getter?: ProxyDelegationGetter<T>;
+    setter?: ProxyDelegationSetter<T>;
+    remove?: ProxyDelegationRemove<T>;
+    ownKeys?: ProxyDelegationOwnKeys<T>;
+}
+/**
+ * Create a complete and iterable trap.
+ * @param self
+ * @param options
+ * @ignore
+ */
+export declare function proxyDelegation<T extends object = any>(self: any, options?: ProxyDelegation<T>): T;

package/lib/types/utils/uniq.d.ts

@@ -0,0 +1,2 @@
+export declare function uniq<T = any>(list: T[]): T[];
+export declare function uniqBy<T = any>(list: T[], key?: string): T[];

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@tsed/core",
-  "version": "6.88.1",
+  "version": "6.89.0",
   "description": "Core module for Ts.ED Framework",
   "private": false,
   "source": "./src/index.ts",
-  "main": "./lib/index.js",
-  "typings": "./lib/index.d.ts",
+  "main": "./lib/cjs/index.js",
+  "typings": "./lib/types/index.d.ts",
   "exports": {
-    "require": "./lib/index.js",
-    "default": "./lib/index.modern.js"
+    "types": "./lib/types/index.d.ts",
+    "import": "./lib/esm/index.js",
+    "require": "./lib/cjs/index.js",
+    "default": "./lib/esm/index.js"
   },
   "scripts": {
-    "build": "microbundle --target node --no-compress --format modern,cjs --tsconfig ./tsconfig.compile.json"
+    "build": "yarn run build:esm && yarn run build:cjs",
+    "build:cjs": "tsc --build tsconfig.compile.json",
+    "build:esm": "tsc --build tsconfig.compile.esm.json"
   },
   "dependencies": {
     "reflect-metadata": "^0.1.13",

package/tsconfig.compile.esm.json

@@ -0,0 +1,23 @@
+{
+  "extends": "./tsconfig.compile.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "module": "ES2020",
+    "rootDir": "src",
+    "outDir": "./lib/esm",
+    "declaration": true,
+    "declarationDir": "./lib/types"
+  },
+  "exclude": [
+    "node_modules",
+    "test",
+    "lib",
+    "benchmark",
+    "coverage",
+    "spec",
+    "**/*.benchmark.ts",
+    "**/*.spec.ts",
+    "keys",
+    "jest.config.js"
+  ]
+}