@cratis/fundamentals 4.3.0 → 5.0.0

package/DerivedType.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Constructor } from './Constructor';
+
+export class DerivedType {
+    static set(target: Constructor, identifier: string) {
+        Reflect.defineMetadata('derivedType', identifier, target);
+    }
+
+    static get(target: Constructor): string {
+        return Reflect.getOwnMetadata('derivedType', target);
+    }
+}

package/Field.ts

@@ -0,0 +1,12 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Constructor } from './Constructor';
+
+/**
+ * Represents a field on a type.
+ */
+ export class Field {
+    constructor(readonly name: string, readonly type: Constructor, readonly enumerable: boolean, readonly derivatives: Constructor[]) {
+    }
+}

package/Fields.ts

@@ -0,0 +1,32 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import 'reflect-metadata';
+import { Constructor } from './Constructor';
+import { Field } from './Field';
+
+/**
+ * Represents a system working with fields on types.
+ */
+export class Fields {
+    static addFieldToType(target: Constructor, field: string, fieldType: Constructor, enumerable: boolean, derivatives: Constructor[]) {
+        let fields: Map<string, Field> = new Map<string, Field>();
+        if (Reflect.hasOwnMetadata('fields', target)) {
+            fields = Reflect.getOwnMetadata('fields', target);
+        }
+        fields.set(field, new Field(field, fieldType, enumerable, derivatives));
+        Reflect.defineMetadata('fields', fields, target);
+    }
+
+    static getFieldsForType(target: Constructor): Field[] {
+        const fields: Field[] = [];
+        if (Reflect.hasOwnMetadata('fields', target)) {
+            const fieldsMap = Reflect.getOwnMetadata('fields', target) as Map<string, Field>;
+            for (const field of fieldsMap.entries()) {
+                fields.push(field[1]);
+            }
+        }
+
+        return fields;
+    }
+}

package/JsonSerializer.ts

@@ -0,0 +1,110 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Constructor } from './Constructor';
+import { Field } from './Field';
+import { Fields } from './Fields';
+import { DerivedType } from './DerivedType';
+
+type typeSerializer = (value: any) => any;
+
+const typeSerializers: Map<Constructor, typeSerializer> = new Map<Constructor, typeSerializer>([
+    [Number, (value: any) => value],
+    [String, (value: any) => value],
+    [Boolean, (value: any) => value],
+    [Date, (value: any) => new Date(value)]
+]);
+
+const deserializeValue = (field: Field, value: any) => {
+    if (typeSerializers.has(field.type)) {
+        return typeSerializers.get(field.type)!(value);
+    } else {
+        let type = field.type;
+        if (field.derivatives.length > 0 && value[JsonSerializer.DerivedTypeIdProperty]) {
+            const derivedTypeId = value[JsonSerializer.DerivedTypeIdProperty];
+            type = field.derivatives.find(_ => DerivedType.get(_) == derivedTypeId) || type;
+        }
+
+        return JsonSerializer.deserialize(type, JSON.stringify(value));
+    }
+};
+
+/**
+ * Represents a serializer for JSON.
+ */
+export class JsonSerializer {
+    static readonly DerivedTypeIdProperty: string = "_derivedTypeId";
+
+    /**
+     * Deserialize a JSON string to the specific type.
+     * @param {Constructor} targetType Type to deserialize to.
+     * @param {string} json Actual JSON to deserialize.
+     * @returns An instance of the target type.
+     */
+    static deserialize<TResult extends {}>(targetType: Constructor<TResult>, json: string): TResult {
+        const parsed = JSON.parse(json);
+        return this.deserializeFromInstance<TResult>(targetType, parsed);
+    }
+
+    /**
+     * Deserialize a array JSON string to an array of the specific instance type.
+     * @param {Constructor} targetType Type to deserialize to.
+     * @param {string} json Actual JSON to deserialize.
+     * @returns An array of instances of the target type.
+     */
+    static deserializeArray<TResult extends {}>(targetType: Constructor<TResult>, json: string): TResult[] {
+        const parsed = JSON.parse(json);
+        return this.deserializeArrayFromInstance(targetType, parsed);
+    }
+
+    /**
+     * Deserialize an any instance to a specific instance type.
+     * @param {Constructor} targetType Type to deserialize to.
+     * @param {*} instance Actual instance to deserialize.
+     * @returns An instance of the target type.
+     */
+    static deserializeFromInstance<TResult extends {}>(targetType: Constructor<TResult>, instance: any): TResult {
+        const fields = Fields.getFieldsForType(targetType as Constructor);
+        const deserialized = new targetType();
+        for (const field of fields) {
+            let value = instance[field.name];
+            if (value) {
+                if (field.enumerable) {
+                    value = value.map(_ => deserializeValue(field, _));
+                } else {
+                    value = deserializeValue(field, value);
+                }
+            }
+
+            deserialized[field.name] = value;
+        }
+
+        if ((targetType as Constructor) == Object) {
+            const objectFields = Object.keys(instance).filter((value, index, arr) => {
+                return !fields.some(_ => _.name == value);
+            });
+
+            for (const field of objectFields) {
+                deserialized[field] = instance[field];
+            }
+        }
+
+        return deserialized;
+    }
+
+    /**
+     * Deserialize an array of any instances to an array of specific instance types.
+     * @param {Constructor} targetType Type to deserialize to.
+     * @param {instances} instances Actual instances to deserialize.
+     * @returns An array of instances of the target type.
+     */
+    static deserializeArrayFromInstance<TResult extends {}>(targetType: Constructor<TResult>, instances: any): TResult[] {
+        const deserialized: TResult[] = [];
+
+        for (const instance of instances) {
+            deserialized.push(this.deserializeFromInstance<TResult>(targetType, instance));
+        }
+
+        return deserialized;
+    }
+}

package/README.md

@@ -1,10 +1,67 @@
-# cratis
+# Fundamentals
 
-[![C# Build](https://github.com/Cratis/cratis/actions/workflows/dotnet-build.yml/badge.svg)](https://github.com/Cratis/cratis/actions/workflows/dotnet-build.yml)
-[![TS Build](https://github.com/Cratis/cratis/actions/workflows/node-build.yml/badge.svg)](https://github.com/Cratis/cratis/actions/workflows/node-build.yml)
-[![Nuget](https://img.shields.io/nuget/v/cratis)](http://nuget.org/packages/cratis)
+## Packages / Deployables
 
+[![Nuget](https://img.shields.io/nuget/v/Cratis.Fundamentals?logo=nuget)](http://nuget.org/packages/cratis.fundamentals)
+[![NPM](https://img.shields.io/npm/v/@cratis/fundamentals?label=@cratis/fundamentals&logo=npm)](https://www.npmjs.com/package/@cratis/fundamentals)
 
-## Build notes
+## Builds
 
-- Orleans CodeGenerator - if it takes a long time on every build, perform a `dotnet clean` from the project you're working on and then `dotnet build` - subsequent builds should then be fast.
+[![.NET Build](https://github.com/cratis/Fundamentals/actions/workflows/dotnet-build.yml/badge.svg)](https://github.com/cratis/Fundamentals/actions/workflows/dotnet-build.yml)
+[![JavaScript Build](https://github.com/cratis/Fundamentals/actions/workflows/javascript-build.yml/badge.svg)](https://github.com/cratis/Fundamentals/actions/workflows/javascript-build.yml)
+
+## Description
+
+The Cratis fundamentals holds generic reusable helpers, utilities and tools that aims at solving common problems and help developers be more productive.
+Fundamentals offers functionality for .NET and JavaScript environments. It is not a goal to have parity, as the different environments offer different
+building blocks.
+
+You should look at it as a convenience layer on top of the existing base environment you're running in.
+
+Read more about how to use it in our documentation.
+
+## Contributing
+
+If you want to jump into building this repository and possibly contributing, please refer to [contributing](./Documentation/contributing/index.md).
+
+### Prerequisites
+
+The following are prerequisites to work with this repository.
+
+* [.NET 6+](https://dotnet.microsoft.com/en-us/).
+* [Node 16+](https://nodejs.org/en)
+* [Yarn](https://yarnpkg.com)
+
+### Central Package Management
+
+This repository leverages [Central Package Management](https://learn.microsoft.com/en-us/nuget/consume-packages/Central-Package-Management), which
+means that all package versions are managed from a file at the root level called [Directory.Packages.props](./Directory.Packages.props).
+
+In addition there are also [Directory.Build.props](https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets) files for
+setting up common settings that are applied cross cuttingly.
+
+### Root package.json
+
+The `package.json` found at the root level defines all the workspaces. It is assumed
+
+All developer dependencies are defined in the top level `package.json`. The reason for this is to be able to provide global scripts
+for every package to use for easier maintenance.
+
+The `package.json` found at the top level contains scripts that can then be used in a child project for this to work properly.
+
+In a package, all you need to do is to define the scripts to use the global scripts in the `package.json´ of that project:
+
+```json
+{
+    "scripts": {
+        "prepublish": "yarn g:build",
+        "clean": "yarn g:clean",
+        "build": "yarn g:build",
+        "lint": "yarn g:lint",
+        "lint:ci": "yarn g:lint:ci",
+        "test": "yarn g:test",
+        "ci": "yarn g:ci",
+        "up": "yarn g:up"
+    }
+}
+```

package/d.yarnist/cjs/Constructor.d.ts

@@ -0,0 +1,2 @@
+export type Constructor<T extends {} = {}> = new (...args: any[]) => T;
+//# sourceMappingURL=Constructor.d.ts.map

package/d.yarnist/cjs/DerivedType.d.ts

@@ -0,0 +1,6 @@
+import { Constructor } from './Constructor';
+export declare class DerivedType {
+    static set(target: Constructor, identifier: string): void;
+    static get(target: Constructor): string;
+}
+//# sourceMappingURL=DerivedType.d.ts.map

package/d.yarnist/cjs/Field.d.ts

@@ -0,0 +1,9 @@
+import { Constructor } from './Constructor';
+export declare class Field {
+    readonly name: string;
+    readonly type: Constructor;
+    readonly enumerable: boolean;
+    readonly derivatives: Constructor[];
+    constructor(name: string, type: Constructor, enumerable: boolean, derivatives: Constructor[]);
+}
+//# sourceMappingURL=Field.d.ts.map

package/d.yarnist/cjs/Fields.d.ts

@@ -0,0 +1,8 @@
+import 'reflect-metadata';
+import { Constructor } from './Constructor';
+import { Field } from './Field';
+export declare class Fields {
+    static addFieldToType(target: Constructor, field: string, fieldType: Constructor, enumerable: boolean, derivatives: Constructor[]): void;
+    static getFieldsForType(target: Constructor): Field[];
+}
+//# sourceMappingURL=Fields.d.ts.map

package/d.yarnist/cjs/JsonSerializer.d.ts

@@ -0,0 +1,9 @@
+import { Constructor } from './Constructor';
+export declare class JsonSerializer {
+    static readonly DerivedTypeIdProperty: string;
+    static deserialize<TResult extends {}>(targetType: Constructor<TResult>, json: string): TResult;
+    static deserializeArray<TResult extends {}>(targetType: Constructor<TResult>, json: string): TResult[];
+    static deserializeFromInstance<TResult extends {}>(targetType: Constructor<TResult>, instance: any): TResult;
+    static deserializeArrayFromInstance<TResult extends {}>(targetType: Constructor<TResult>, instances: any): TResult[];
+}
+//# sourceMappingURL=JsonSerializer.d.ts.map

package/d.yarnist/cjs/PropertyAccessor.d.ts

@@ -0,0 +1,2 @@
+export type PropertyAccessor<T = any> = (instance: T) => any;
+//# sourceMappingURL=PropertyAccessor.d.ts.map

package/d.yarnist/cjs/derivedTypeDecorator.d.ts

@@ -0,0 +1,3 @@
+import 'reflect-metadata';
+export declare function derivedType(identifier: string): (target: any) => void;
+//# sourceMappingURL=derivedTypeDecorator.d.ts.map

package/d.yarnist/cjs/fieldDecorator.d.ts

@@ -0,0 +1,3 @@
+import { Constructor } from './Constructor';
+export declare function field(targetType: Constructor, enumerable?: boolean, derivatives?: Constructor[]): (target: any, propertyKey: string) => void;
+//# sourceMappingURL=fieldDecorator.d.ts.map

package/d.yarnist/cjs/index.d.ts

@@ -0,0 +1,13 @@
+export * from './Constructor';
+export * from './Field';
+export * from './Fields';
+export * from './Guid';
+export * from './IEquatable';
+export * from './PropertyAccessor';
+export * from './PropertyAccessorDescriptor';
+export * from './PropertyPathResolverProxyHandler';
+export * from './fieldDecorator';
+export * from './derivedTypeDecorator';
+export * from './JsonSerializer';
+export * from './DerivedType';
+//# sourceMappingURL=index.d.ts.map

package/d.yarnist/cjs/index.js

@@ -0,0 +1,24 @@
+'use strict';
+
+var Field = require('./Field.js');
+var Fields = require('./Fields.js');
+var Guid = require('./Guid.js');
+var PropertyAccessorDescriptor = require('./PropertyAccessorDescriptor.js');
+var PropertyPathResolverProxyHandler = require('./PropertyPathResolverProxyHandler.js');
+var fieldDecorator = require('./fieldDecorator.js');
+var derivedTypeDecorator = require('./derivedTypeDecorator.js');
+var JsonSerializer = require('./JsonSerializer.js');
+var DerivedType = require('./DerivedType.js');
+
+
+
+exports.Field = Field.Field;
+exports.Fields = Fields.Fields;
+exports.Guid = Guid.Guid;
+exports.PropertyAccessorDescriptor = PropertyAccessorDescriptor.PropertyAccessorDescriptor;
+exports.PropertyPathResolverProxyHandler = PropertyPathResolverProxyHandler.PropertyPathResolverProxyHandler;
+exports.field = fieldDecorator.field;
+exports.derivedType = derivedTypeDecorator.derivedType;
+exports.JsonSerializer = JsonSerializer.JsonSerializer;
+exports.DerivedType = DerivedType.DerivedType;
+//# sourceMappingURL=index.js.map

package/derivedTypeDecorator.ts

@@ -0,0 +1,11 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import 'reflect-metadata';
+import { DerivedType } from './DerivedType';
+
+export function derivedType(identifier: string) {
+    return function (target: any) {
+        DerivedType.set(target, identifier);
+    };
+}

package/dist/esm/Constructor.d.ts

@@ -0,0 +1,2 @@
+export type Constructor<T extends {} = {}> = new (...args: any[]) => T;
+//# sourceMappingURL=Constructor.d.ts.map

package/dist/esm/Constructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constructor.d.ts","sourceRoot":"","sources":["../../Constructor.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC"}

package/dist/esm/DerivedType.d.ts

@@ -0,0 +1,6 @@
+import { Constructor } from './Constructor';
+export declare class DerivedType {
+    static set(target: Constructor, identifier: string): void;
+    static get(target: Constructor): string;
+}
+//# sourceMappingURL=DerivedType.d.ts.map

package/dist/esm/DerivedType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DerivedType.d.ts","sourceRoot":"","sources":["../../DerivedType.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,WAAW;IACpB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM;IAIlD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;CAG1C"}

package/dist/esm/DerivedType.js

@@ -0,0 +1,11 @@
+class DerivedType {
+    static set(target, identifier) {
+        Reflect.defineMetadata('derivedType', identifier, target);
+    }
+    static get(target) {
+        return Reflect.getOwnMetadata('derivedType', target);
+    }
+}
+
+export { DerivedType };
+//# sourceMappingURL=DerivedType.js.map

package/dist/esm/DerivedType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DerivedType.js","sources":["../../DerivedType.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from './Constructor';\n\nexport class DerivedType {\n    static set(target: Constructor, identifier: string) {\n        Reflect.defineMetadata('derivedType', identifier, target);\n    }\n\n    static get(target: Constructor): string {\n        return Reflect.getOwnMetadata('derivedType', target);\n    }\n}\n"],"names":[],"mappings":"MAKa,WAAW,CAAA;AACpB,IAAA,OAAO,GAAG,CAAC,MAAmB,EAAE,UAAkB,EAAA;QAC9C,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;KAC7D;IAED,OAAO,GAAG,CAAC,MAAmB,EAAA;QAC1B,OAAO,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;KACxD;AACJ;;;;"}

package/dist/esm/Field.d.ts

@@ -0,0 +1,9 @@
+import { Constructor } from './Constructor';
+export declare class Field {
+    readonly name: string;
+    readonly type: Constructor;
+    readonly enumerable: boolean;
+    readonly derivatives: Constructor[];
+    constructor(name: string, type: Constructor, enumerable: boolean, derivatives: Constructor[]);
+}
+//# sourceMappingURL=Field.d.ts.map

package/dist/esm/Field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../Field.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK3C,qBAAa,KAAK;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAAE,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE;gBAA3G,IAAI,EAAE,MAAM,EAAW,IAAI,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAAW,WAAW,EAAE,WAAW,EAAE;CAEnI"}

package/dist/esm/Field.js

@@ -0,0 +1,11 @@
+class Field {
+    constructor(name, type, enumerable, derivatives) {
+        this.name = name;
+        this.type = type;
+        this.enumerable = enumerable;
+        this.derivatives = derivatives;
+    }
+}
+
+export { Field };
+//# sourceMappingURL=Field.js.map

package/dist/esm/Field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.js","sources":["../../Field.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from './Constructor';\n\n/**\n * Represents a field on a type.\n */\n export class Field {\n    constructor(readonly name: string, readonly type: Constructor, readonly enumerable: boolean, readonly derivatives: Constructor[]) {\n    }\n}\n"],"names":[],"mappings":"MAQc,KAAK,CAAA;AACf,IAAA,WAAA,CAAqB,IAAY,EAAW,IAAiB,EAAW,UAAmB,EAAW,WAA0B,EAAA;QAA3G,IAAI,CAAA,IAAA,GAAJ,IAAI,CAAQ;QAAW,IAAI,CAAA,IAAA,GAAJ,IAAI,CAAa;QAAW,IAAU,CAAA,UAAA,GAAV,UAAU,CAAS;QAAW,IAAW,CAAA,WAAA,GAAX,WAAW,CAAe;KAC/H;AACJ;;;;"}

package/dist/esm/Fields.d.ts

@@ -0,0 +1,8 @@
+import 'reflect-metadata';
+import { Constructor } from './Constructor';
+import { Field } from './Field';
+export declare class Fields {
+    static addFieldToType(target: Constructor, field: string, fieldType: Constructor, enumerable: boolean, derivatives: Constructor[]): void;
+    static getFieldsForType(target: Constructor): Field[];
+}
+//# sourceMappingURL=Fields.d.ts.map

package/dist/esm/Fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fields.d.ts","sourceRoot":"","sources":["../../Fields.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAKhC,qBAAa,MAAM;IACf,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE;IASjI,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE;CAWxD"}

package/dist/esm/Fields.js

@@ -0,0 +1,26 @@
+import 'reflect-metadata';
+import { Field } from './Field.js';
+
+class Fields {
+    static addFieldToType(target, field, fieldType, enumerable, derivatives) {
+        let fields = new Map();
+        if (Reflect.hasOwnMetadata('fields', target)) {
+            fields = Reflect.getOwnMetadata('fields', target);
+        }
+        fields.set(field, new Field(field, fieldType, enumerable, derivatives));
+        Reflect.defineMetadata('fields', fields, target);
+    }
+    static getFieldsForType(target) {
+        const fields = [];
+        if (Reflect.hasOwnMetadata('fields', target)) {
+            const fieldsMap = Reflect.getOwnMetadata('fields', target);
+            for (const field of fieldsMap.entries()) {
+                fields.push(field[1]);
+            }
+        }
+        return fields;
+    }
+}
+
+export { Fields };
+//# sourceMappingURL=Fields.js.map

package/dist/esm/Fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fields.js","sources":["../../Fields.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport 'reflect-metadata';\nimport { Constructor } from './Constructor';\nimport { Field } from './Field';\n\n/**\n * Represents a system working with fields on types.\n */\nexport class Fields {\n    static addFieldToType(target: Constructor, field: string, fieldType: Constructor, enumerable: boolean, derivatives: Constructor[]) {\n        let fields: Map<string, Field> = new Map<string, Field>();\n        if (Reflect.hasOwnMetadata('fields', target)) {\n            fields = Reflect.getOwnMetadata('fields', target);\n        }\n        fields.set(field, new Field(field, fieldType, enumerable, derivatives));\n        Reflect.defineMetadata('fields', fields, target);\n    }\n\n    static getFieldsForType(target: Constructor): Field[] {\n        const fields: Field[] = [];\n        if (Reflect.hasOwnMetadata('fields', target)) {\n            const fieldsMap = Reflect.getOwnMetadata('fields', target) as Map<string, Field>;\n            for (const field of fieldsMap.entries()) {\n                fields.push(field[1]);\n            }\n        }\n\n        return fields;\n    }\n}\n"],"names":[],"mappings":";;;MAUa,MAAM,CAAA;IACf,OAAO,cAAc,CAAC,MAAmB,EAAE,KAAa,EAAE,SAAsB,EAAE,UAAmB,EAAE,WAA0B,EAAA;AAC7H,QAAA,IAAI,MAAM,GAAuB,IAAI,GAAG,EAAiB,CAAC;QAC1D,IAAI,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YAC1C,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACrD,SAAA;AACD,QAAA,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACpD;IAED,OAAO,gBAAgB,CAAC,MAAmB,EAAA;QACvC,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAuB,CAAC;AACjF,YAAA,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE;gBACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzB,aAAA;AACJ,SAAA;AAED,QAAA,OAAO,MAAM,CAAC;KACjB;AACJ;;;;"}

package/dist/esm/Guid.d.ts

@@ -0,0 +1,13 @@
+import { IEquatable } from './IEquatable';
+export declare class Guid implements IEquatable {
+    readonly bytes: number[] | Uint8Array;
+    static readonly empty: Guid;
+    private _stringVersion;
+    constructor(bytes: number[] | Uint8Array);
+    static create(): Guid;
+    static parse(guid: string): Guid;
+    static as<T extends Guid = Guid>(input: string | T): T;
+    equals(other: any): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=Guid.d.ts.map

package/dist/esm/Guid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Guid.d.ts","sourceRoot":"","sources":["../../Guid.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB1C,qBAAa,IAAK,YAAW,UAAU;IAcvB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU;IATjD,MAAM,CAAC,QAAQ,CAAC,KAAK,OAA8D;IAEnF,OAAO,CAAC,cAAc,CAAM;gBAOP,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU;IAiBjD,MAAM,CAAC,MAAM,IAAI,IAAI;IAgCrB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBhC,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC;IAUtD,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAQ3B,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/{Guid.js → esm/Guid.js}

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Guid = void 0;
 const lookUpTable = [];
 (() => {
     for (let i = 0; i < 256; i += 1) {
@@ -72,6 +69,7 @@ class Guid {
         return this._stringVersion;
     }
 }
-exports.Guid = Guid;
 Guid.empty = new Guid([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);
-//# sourceMappingURL=Guid.js.map
+
+export { Guid };
+//# sourceMappingURL=Guid.js.map

package/dist/esm/Guid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Guid.js","sources":["../../Guid.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IEquatable } from './IEquatable';\n\nconst lookUpTable: string[] = [];\n(() => {\n    for (let i = 0; i < 256; i += 1) {\n        lookUpTable[i] = (i < 16 ? '0' : '') + (i).toString(16);\n    }\n})();\n\nconst getString = (num: number) => {\n    return num.toString(16).padStart(2, '0');\n};\n\n/**\n * Represents a Guid according to the http://www.ietf.org/rfc/rfc4122.txt\n *\n * @export\n * @class Guid\n */\nexport class Guid implements IEquatable {\n\n    /**\n     * Gets an empty {Guid}\n     */\n    static readonly empty = new Guid([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);\n\n    private _stringVersion = '';\n\n\n    /**\n     * Initializes a new instance of the {Guid} class.\n     * @param {number[]|Uint8Array} bytes - The 16 bytes that represents a {Guid}.\n     */\n    constructor(readonly bytes: number[] | Uint8Array) {\n        this._stringVersion = '' +\n            getString(bytes[3]) + getString(bytes[2]) + getString(bytes[1]) + getString(bytes[0]) +\n            '-' +\n            getString(bytes[5]) + getString(bytes[4]) +\n            '-' +\n            getString(bytes[7]) + getString(bytes[6]) +\n            '-' +\n            getString(bytes[8]) + getString(bytes[9]) +\n            '-' +\n            getString(bytes[10]) + getString(bytes[11]) + getString(bytes[12]) + getString(bytes[13]) + getString(bytes[14]) + getString(bytes[15]);\n    }\n\n    /**\n     * Create a new {Guid}\n     * @returns {Guid}\n     */\n    static create(): Guid {\n        const d0 = Math.random() * 0xFFFFFFFF | 0;\n        const d1 = Math.random() * 0xFFFFFFFF | 0;\n        const d2 = Math.random() * 0xFFFFFFFF | 0;\n        const d3 = Math.random() * 0xFFFFFFFF | 0;\n\n        const bytes = [\n            lookUpTable[d0 & 0xFF],\n            lookUpTable[d0 >> 8 & 0xFF],\n            lookUpTable[d0 >> 16 & 0xFF],\n            lookUpTable[d0 >> 24 & 0xFF],\n            lookUpTable[d1 & 0xFF],\n            lookUpTable[d1 >> 8 & 0xFF],\n            lookUpTable[d1 >> 16 & 0x0F | 0x40],\n            lookUpTable[d1 >> 24 & 0xFF],\n            lookUpTable[d2 & 0x3F | 0x80],\n            lookUpTable[d2 >> 8 & 0xFF],\n            lookUpTable[d2 >> 16 & 0xFF],\n            lookUpTable[d2 >> 24 & 0xFF],\n            lookUpTable[d3 & 0xFF],\n            lookUpTable[d3 >> 8 & 0xFF],\n            lookUpTable[d3 >> 16 & 0xFF],\n            lookUpTable[d3 >> 24 & 0xFF]\n        ];\n\n        return new Guid(bytes.map(_ => parseInt(`0x${_}`, 16)));\n    }\n\n    /**\n     * Parses a string and turns it into a {Guid}.\n     * @param {string} guid String representation of guid.\n     */\n    static parse(guid: string): Guid {\n        const bytes: number[] = [];\n        guid.split('-').map((number, index) => {\n            const bytesInChar = index < 3 ? number.match(/.{1,2}/g)?.reverse() : number.match(/.{1,2}/g);\n            bytesInChar?.map((byte) => { bytes.push(parseInt(byte, 16)); });\n        });\n\n        return new Guid(bytes);\n    }\n\n    /**\n     * Parses if the type is a string parse, otherwise pass through the input as desired output type.\n     * @template T Type to handle for\n     * @param {string|T} input String or the generic type.\n     * @returns identifier Parsed or passed through\n     */\n    static as<T extends Guid = Guid>(input: string | T): T {\n        if (typeof input === 'string') {\n            return Guid.parse(input) as T;\n        }\n        return input as T;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    equals(other: any): boolean {\n        return Guid.as(other).toString() === this.toString();\n    }\n\n    /**\n     * Return a string representation of the {Guid} in the format: 00000000-0000-0000-0000-000000000000\n     * @returns {string}\n     */\n    toString(): string {\n        return this._stringVersion;\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/IEquatable.d.ts

@@ -0,0 +1,4 @@
+export interface IEquatable {
+    equals(other: any): boolean;
+}
+//# sourceMappingURL=IEquatable.d.ts.map

package/dist/esm/IEquatable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEquatable.d.ts","sourceRoot":"","sources":["../../IEquatable.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IAOvB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAA;CAC9B"}

package/dist/esm/JsonSerializer.d.ts

@@ -0,0 +1,9 @@
+import { Constructor } from './Constructor';
+export declare class JsonSerializer {
+    static readonly DerivedTypeIdProperty: string;
+    static deserialize<TResult extends {}>(targetType: Constructor<TResult>, json: string): TResult;
+    static deserializeArray<TResult extends {}>(targetType: Constructor<TResult>, json: string): TResult[];
+    static deserializeFromInstance<TResult extends {}>(targetType: Constructor<TResult>, instance: any): TResult;
+    static deserializeArrayFromInstance<TResult extends {}>(targetType: Constructor<TResult>, instances: any): TResult[];
+}
+//# sourceMappingURL=JsonSerializer.d.ts.map

package/dist/esm/JsonSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSerializer.d.ts","sourceRoot":"","sources":["../../JsonSerializer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA+B5C,qBAAa,cAAc;IACvB,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAoB;IAQjE,MAAM,CAAC,WAAW,CAAC,OAAO,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAW/F,MAAM,CAAC,gBAAgB,CAAC,OAAO,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAWtG,MAAM,CAAC,uBAAuB,CAAC,OAAO,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO;IAmC5G,MAAM,CAAC,4BAA4B,CAAC,OAAO,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,EAAE;CASvH"}

package/dist/esm/JsonSerializer.js

@@ -0,0 +1,68 @@
+import { Fields } from './Fields.js';
+import { DerivedType } from './DerivedType.js';
+
+const typeSerializers = new Map([
+    [Number, (value) => value],
+    [String, (value) => value],
+    [Boolean, (value) => value],
+    [Date, (value) => new Date(value)]
+]);
+const deserializeValue = (field, value) => {
+    if (typeSerializers.has(field.type)) {
+        return typeSerializers.get(field.type)(value);
+    }
+    else {
+        let type = field.type;
+        if (field.derivatives.length > 0 && value[JsonSerializer.DerivedTypeIdProperty]) {
+            const derivedTypeId = value[JsonSerializer.DerivedTypeIdProperty];
+            type = field.derivatives.find(_ => DerivedType.get(_) == derivedTypeId) || type;
+        }
+        return JsonSerializer.deserialize(type, JSON.stringify(value));
+    }
+};
+class JsonSerializer {
+    static deserialize(targetType, json) {
+        const parsed = JSON.parse(json);
+        return this.deserializeFromInstance(targetType, parsed);
+    }
+    static deserializeArray(targetType, json) {
+        const parsed = JSON.parse(json);
+        return this.deserializeArrayFromInstance(targetType, parsed);
+    }
+    static deserializeFromInstance(targetType, instance) {
+        const fields = Fields.getFieldsForType(targetType);
+        const deserialized = new targetType();
+        for (const field of fields) {
+            let value = instance[field.name];
+            if (value) {
+                if (field.enumerable) {
+                    value = value.map(_ => deserializeValue(field, _));
+                }
+                else {
+                    value = deserializeValue(field, value);
+                }
+            }
+            deserialized[field.name] = value;
+        }
+        if (targetType == Object) {
+            const objectFields = Object.keys(instance).filter((value, index, arr) => {
+                return !fields.some(_ => _.name == value);
+            });
+            for (const field of objectFields) {
+                deserialized[field] = instance[field];
+            }
+        }
+        return deserialized;
+    }
+    static deserializeArrayFromInstance(targetType, instances) {
+        const deserialized = [];
+        for (const instance of instances) {
+            deserialized.push(this.deserializeFromInstance(targetType, instance));
+        }
+        return deserialized;
+    }
+}
+JsonSerializer.DerivedTypeIdProperty = "_derivedTypeId";
+
+export { JsonSerializer };
+//# sourceMappingURL=JsonSerializer.js.map