@dipscope/type-manager 4.0.4 → 5.0.0-beta.0

package/inject.d.ts

@@ -1,5 +1,5 @@
-import { InjectOptions } from './core/inject-options';
-import { TypeFn } from './core/type-fn';
+import { InjectOptions } from './inject-options';
+import { TypeFn } from './type-fn';
 /**
  * Inject decorator.
  *

package/injector.d.ts

@@ -1,11 +1,16 @@
-import { Injector } from './core/injector';
+import { TypeMetadata } from './type-metadata';
 /**
- * Injector decorator.
+ * Injector used to resolve dependent types.
  *
- * Used to define custom injector for a type.
- *
- * @param {Injector} injector Injector.
- *
- * @returns {ClassDecorator} Class decorator.
+ * @type {Injector}
  */
-export declare function Injector(injector: Injector): ClassDecorator;
+export interface Injector {
+    /**
+     * Method to get instance described by type metadata.
+     *
+     * @param {TypeMetadata<TType>} typeMetadata Type metadata.
+     *
+     * @returns {TType|undefined} Instance of type described by type metadata or undefined.
+     */
+    get<TType>(typeMetadata: TypeMetadata<TType>): TType | undefined;
+}

package/injectors/singleton-injector.d.ts

@@ -1,5 +1,5 @@
-import { Injector } from '../core/injector';
-import { TypeMetadata } from '../core/type-metadata';
+import { Injector } from '../injector';
+import { TypeMetadata } from '../type-metadata';
 /**
  * Singleton injector.
  *

package/{core/log.d.ts → log.d.ts}

@@ -1,6 +1,6 @@
 import { LogLevel } from './log-level';
 /**
- * Main logger class.
+ * Main logger class used by serializers for displaying messages.
  *
  * @type {Log}
  */
@@ -10,31 +10,61 @@ export declare class Log {
      *
      * @type {LogLevel}
      */
-    logLevel: LogLevel;
+    readonly logLevel: LogLevel;
     /**
-     * Constructor.
+     * Info enabled?
      *
-     * @param {LogLevel} logLevel Log level.
+     * @type {boolean}
      */
-    constructor(logLevel: LogLevel);
+    readonly infoEnabled: boolean;
+    /**
+     * Warn enabled?
+     *
+     * @type {boolean}
+     */
+    readonly warnEnabled: boolean;
+    /**
+     * Error enabled?
+     *
+     * @type {boolean}
+     */
+    readonly errorEnabled: boolean;
+    /**
+     * Supports console?
+     *
+     * @type {boolean}
+     */
+    readonly supportsConsole: boolean;
+    /**
+     * Supports console log?
+     *
+     * @type {boolean}
+     */
+    readonly supportsConsoleLog: boolean;
     /**
-     * Info log level is enabled?
+     * Supports console info?
      *
      * @type {boolean}
      */
-    get infoEnabled(): boolean;
+    readonly supportsConsoleInfo: boolean;
     /**
-     * Warn log level is enabled?
+     * Supports console warn?
      *
      * @type {boolean}
      */
-    get warnEnabled(): boolean;
+    readonly supportsConsoleWarn: boolean;
     /**
-     * Error log level is enabled?
+     * Supports console error?
      *
      * @type {boolean}
      */
-    get errorEnabled(): boolean;
+    readonly supportsConsoleError: boolean;
+    /**
+     * Constructor.
+     *
+     * @param {LogLevel} logLevel Log level.
+     */
+    constructor(logLevel: LogLevel);
     /**
      * Displays info message.
      *

package/naming-convention.d.ts

@@ -1,11 +1,15 @@
-import { NamingConvention } from './core/naming-convention';
 /**
- * Naming convention decorator.
+ * Represents naming convention.
  *
- * Used to define custom naming convention for type and property.
- *
- * @param {NamingConvention} namingConvention Naming convention.
- *
- * @returns {ClassDecorator&PropertyDecorator} Class and property decorator.
+ * @type {NamingConvention}
  */
-export declare function NamingConvention(namingConvention: NamingConvention): ClassDecorator & PropertyDecorator;
+export interface NamingConvention {
+    /**
+     * Converts name from provided to target one.
+     *
+     * @param {string} name Name.
+     *
+     * @returns {string} Converted name.
+     */
+    convert(name: string): string;
+}

package/naming-conventions/camel-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Camel case naming convention.
  *

package/naming-conventions/flat-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Flat case naming convention.
  *

package/naming-conventions/flat-upper-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Flat upper case naming convention.
  *

package/naming-conventions/kebab-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Kebab case naming convention.
  *

package/naming-conventions/kebab-upper-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Kebab upper naming case.
  *

package/naming-conventions/pascal-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Pascal case naming convention.
  *

package/naming-conventions/snake-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Snake case naming convention.
  *

package/naming-conventions/snake-upper-case-naming-convention.d.ts

@@ -1,4 +1,4 @@
-import { NamingConvention } from '../core/naming-convention';
+import { NamingConvention } from '../naming-convention';
 /**
  * Snake upper case naming convention.
  *

package/package.json

@@ -1,8 +1,11 @@
 {
   "author": "DipScope authors and contributors",
-  "dependencies": {},
+  "dependencies": {
+    "lodash": "^4.17.21"
+  },
   "description": "A package which will help you to transform your JSON strings or plain objects into JS object instances.",
   "devDependencies": {
+    "@types/lodash": "^4.14.182",
     "@types/jasmine": "^3.6.3",
     "@typescript-eslint/eslint-plugin": "^4.14.2",
     "@typescript-eslint/parser": "^4.14.2",
@@ -39,10 +42,10 @@
   "scripts": {
     "build": "npm run clean && npx webpack --config=webpack.config.js && npm run copy",
     "clean": "shx rm -rf dist",
-    "copy": "shx cp CHANGELOG.md dist && shx cp LICENSE.txt dist && shx cp package.json dist && shx cp README.md dist",
+    "copy": "shx cp CHANGELOG.md dist && shx cp LICENSE.md dist && shx cp package.json dist && shx cp README.md dist",
     "test": "jasmine-ts --config=jasmine.json",
     "lint": "eslint . --ext .ts"
   },
   "types": "index.d.ts",
-  "version": "4.0.4"
+  "version": "5.0.0-beta.0"
 }

package/{core/property-metadata.d.ts → property-metadata.d.ts}

@@ -64,23 +64,35 @@ export declare class PropertyMetadata<TDeclaringType, TType> extends Metadata {
      */
     get customData(): CustomData;
     /**
-     * Gets default value.
+     * Gets serialized default value.
      *
-     * @returns {any|undefined} Resolved default value or undefined.
+     * @returns {any|undefined} Resolved serialized default value or undefined.
      */
-    get defaultValue(): any | undefined;
+    get serializedDefaultValue(): any | undefined;
     /**
-     * Gets deserializable value.
+     * Gets deserialized default value.
      *
-     * @returns {boolean|undefined} Deserializable indicator or undefined.
+     * @returns {any|undefined} Resolved deserialized default value or undefined.
      */
-    get deserializable(): boolean | undefined;
+    get deserializedDefaultValue(): any | undefined;
+    /**
+     * Gets serialized property name.
+     *
+     * @returns {string} Serialized property name.
+     */
+    get serializedPropertyName(): string;
     /**
      * Gets deserialized property name.
      *
      * @returns {string} Deserialized property name.
      */
     get deserializedPropertyName(): string;
+    /**
+     * Gets deserializable value.
+     *
+     * @returns {boolean|undefined} Deserializable indicator or undefined.
+     */
+    get deserializable(): boolean | undefined;
     /**
      * Gets generic arguments.
      *
@@ -111,12 +123,6 @@ export declare class PropertyMetadata<TDeclaringType, TType> extends Metadata {
      * @returns {boolean|undefined} Serializable indicator or undefined.
      */
     get serializable(): boolean | undefined;
-    /**
-     * Gets serialized property name.
-     *
-     * @returns {string} Serialized property name.
-     */
-    get serializedPropertyName(): string;
     /**
      * Checks if serialization configured.
      *

package/{core/property-options.d.ts → property-options.d.ts}

@@ -1,5 +1,6 @@
 import { Alias } from './alias';
 import { CustomData } from './custom-data';
+import { DefaultValue } from './default-value';
 import { GenericArgument } from './generic-argument';
 import { NamingConvention } from './naming-convention';
 import { ReferenceHandler } from './reference-handler';
@@ -28,12 +29,28 @@ export interface PropertyOptions<TType> {
     /**
      * Default value for undefined ones.
      *
-     * Can be a lazy function which returns a value. Assigned only when
-     * use default value option is true.
+     * Used to set both serialized and deserialized default values and
+     * only when use default value option is true.
      *
-     * @type {any}
+     * @type {DefaultValue}
      */
-    defaultValue?: any;
+    defaultValue?: DefaultValue;
+    /**
+     * Serialized default value for undefined ones.
+     *
+     * Used only when use default value option is true.
+     *
+     * @type {DefaultValue}
+     */
+    serializedDefaultValue?: DefaultValue;
+    /**
+     * Deserialized default value for undefined ones.
+     *
+     * Used only when use default value option is true.
+     *
+     * @type {DefaultValue}
+     */
+    deserializedDefaultValue?: DefaultValue;
     /**
      * Deserializable from object?
      *

package/property.d.ts

@@ -1,5 +1,6 @@
-import { GenericArgument, TypeArgument } from './core';
-import { PropertyOptions } from './core/property-options';
+import { GenericArgument } from './generic-argument';
+import { PropertyOptions } from './property-options';
+import { TypeArgument } from './type-argument';
 /**
  * Property decorator.
  *

package/reference-handler.d.ts

@@ -1,11 +1,32 @@
-import { ReferenceHandler } from './core/reference-handler';
+import { ReferenceKey } from './reference-key';
+import { ReferenceValue } from './reference-value';
+import { ReferenceValueInitializer } from './reference-value-initializer';
+import { ReferenceValueResolver } from './reference-value-resolver';
+import { SerializerContext } from './serializer-context';
 /**
- * Reference handler decorator.
+ * Reference handler to resolve object references.
  *
- * Used to define custom reference handler for type and property.
- *
- * @param {ReferenceHandler} referenceHandler Reference handler.
- *
- * @returns {ClassDecorator&PropertyDecorator} Class and property decorator.
+ * @type {ReferenceHandler}
  */
-export declare function ReferenceHandler(referenceHandler: ReferenceHandler): ClassDecorator & PropertyDecorator;
+export interface ReferenceHandler {
+    /**
+     * Defines reference. Called during serialization.
+     *
+     * @param {SerializerContext<any>} serializerContext Serializer context.
+     * @param {ReferenceKey} referenceKey Reference which acts as a key. This is basically a serializing object.
+     * @param {ReferenceValueInitializer} referenceValueInitializer Function to initialize a reference value when one is not yet present for a key.
+     *
+     * @returns {ReferenceValue|ReferenceValueResolver} Resolved reference value or reference resolver when circular dependency is detected.
+     */
+    define(serializerContext: SerializerContext<any>, referenceKey: ReferenceKey, referenceValueInitializer: ReferenceValueInitializer): ReferenceValue | ReferenceValueResolver;
+    /**
+     * Restores reference. Called during deserialization.
+     *
+     * @param {SerializerContext<any>} serializerContext Serializer context.
+     * @param {ReferenceKey} referenceKey Reference which acts as a key. This is basically a deserializing object.
+     * @param {ReferenceValueInitializer} referenceValueInitializer Function to initialize a reference value when one is not yet present for a key.
+     *
+     * @returns {ReferenceValue|ReferenceValueResolver} Resolved reference value or reference resolver when circular dependency is detected.
+     */
+    restore(serializerContext: SerializerContext<any>, referenceKey: ReferenceKey, referenceValueInitializer: ReferenceValueInitializer): ReferenceValue | ReferenceValueResolver;
+}

package/reference-handlers/direct-reference-handler.d.ts

@@ -1,9 +1,9 @@
-import { ReferenceHandler } from '../core/reference-handler';
-import { ReferenceKey } from '../core/reference-key';
-import { ReferenceValue } from '../core/reference-value';
-import { ReferenceValueInitializer } from '../core/reference-value-initializer';
-import { ReferenceValueResolver } from '../core/reference-value-resolver';
-import { SerializerContext } from '../core/serializer-context';
+import { ReferenceHandler } from '../reference-handler';
+import { ReferenceKey } from '../reference-key';
+import { ReferenceValue } from '../reference-value';
+import { ReferenceValueInitializer } from '../reference-value-initializer';
+import { ReferenceValueResolver } from '../reference-value-resolver';
+import { SerializerContext } from '../serializer-context';
 /**
  * Direct reference handler which preserves references as is.
  *

package/reference-handlers/lead-reference-handler.d.ts

@@ -1,9 +1,9 @@
-import { ReferenceHandler } from '../core/reference-handler';
-import { ReferenceKey } from '../core/reference-key';
-import { ReferenceValue } from '../core/reference-value';
-import { ReferenceValueInitializer } from '../core/reference-value-initializer';
-import { ReferenceValueResolver } from '../core/reference-value-resolver';
-import { SerializerContext } from '../core/serializer-context';
+import { ReferenceHandler } from '../reference-handler';
+import { ReferenceKey } from '../reference-key';
+import { ReferenceValue } from '../reference-value';
+import { ReferenceValueInitializer } from '../reference-value-initializer';
+import { ReferenceValueResolver } from '../reference-value-resolver';
+import { SerializerContext } from '../serializer-context';
 /**
  * Lead reference handler preserves references except circular. If circular reference is detected the it will
  * be setted to undefined so only first occurance is handled.

package/reference-handlers/path-reference-handler.d.ts

@@ -1,9 +1,9 @@
-import { ReferenceHandler } from '../core/reference-handler';
-import { ReferenceKey } from '../core/reference-key';
-import { ReferenceValue } from '../core/reference-value';
-import { ReferenceValueInitializer } from '../core/reference-value-initializer';
-import { ReferenceValueResolver } from '../core/reference-value-resolver';
-import { SerializerContext } from '../core/serializer-context';
+import { ReferenceHandler } from '../reference-handler';
+import { ReferenceKey } from '../reference-key';
+import { ReferenceValue } from '../reference-value';
+import { ReferenceValueInitializer } from '../reference-value-initializer';
+import { ReferenceValueResolver } from '../reference-value-resolver';
+import { SerializerContext } from '../serializer-context';
 /**
  * Path reference handler preserves references using JSONPath.
  *

package/{core/serializer-context.d.ts → serializer-context.d.ts}

@@ -51,11 +51,17 @@ export declare class SerializerContext<TType> extends Metadata {
      */
     get customData(): CustomData;
     /**
-     * Gets default value.
+     * Gets serialized default value.
      *
-     * @returns {any|undefined} Resolved default value or undefined.
+     * @returns {any|undefined} Resolved serialized default value or undefined.
      */
-    get defaultValue(): any | undefined;
+    get serializedDefaultValue(): any | undefined;
+    /**
+     * Gets deserialized default value.
+     *
+     * @returns {any|undefined} Resolved deserialized default value or undefined.
+     */
+    get deserializedDefaultValue(): any | undefined;
     /**
      * Gets discriminant.
      *

package/serializer.d.ts

@@ -1,11 +1,27 @@
-import { Serializer } from './core/serializer';
+import { SerializerContext } from './serializer-context';
+import { TypeLike } from './type-like';
 /**
- * Serializer decorator.
+ * Serializer.
  *
- * Used to define custom serializer for type and property.
- *
- * @param {Serializer<TType>} serializer Serializer.
- *
- * @returns {ClassDecorator&PropertyDecorator} Class and property decorator.
+ * @type {Serializer<TType>}
  */
-export declare function Serializer<TType>(serializer: Serializer<TType>): ClassDecorator & PropertyDecorator;
+export interface Serializer<TType> {
+    /**
+     * Serializes provided value.
+     *
+     * @param {TypeLike<TType>} x Some value.
+     * @param {SerializerContext<TType>} serializerContext Serializer context.
+     *
+     * @returns {TypeLike<any>} Serialized value.
+     */
+    serialize(x: TypeLike<TType>, serializerContext: SerializerContext<TType>): TypeLike<any>;
+    /**
+     * Deserializes provided value.
+     *
+     * @param {TypeLike<any>} x Some value.
+     * @param {SerializerContext<TType>} serializerContext Serializer context.
+     *
+     * @returns {TypeLike<TType>} Deserialized value.
+     */
+    deserialize(x: TypeLike<any>, serializerContext: SerializerContext<TType>): TypeLike<TType>;
+}

package/serializers/array-buffer-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Array buffer serializer.
  *

package/serializers/array-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Array serializer.
  *

package/serializers/boolean-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Boolean serializer.
  *

package/serializers/data-view-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Data view serializer.
  *

package/serializers/date-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Date serializer.
  *

package/serializers/float-32-array-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Float 32 array serializer.
  *

package/serializers/float-64-array-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Float 64 array serializer.
  *

package/serializers/int-16-array-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Int 16 array serializer.
  *

package/serializers/int-32-array-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Int 32 array serializer.
  *

package/serializers/int-8-array-serializer.d.ts

@@ -1,6 +1,6 @@
-import { Serializer } from '../core/serializer';
-import { SerializerContext } from '../core/serializer-context';
-import { TypeLike } from '../core/type-like';
+import { Serializer } from '../serializer';
+import { SerializerContext } from '../serializer-context';
+import { TypeLike } from '../type-like';
 /**
  * Int 8 array serializer.
  *