@cratis/fundamentals 7.15.0 → 7.15.2

package/json/GuidJsonConverter.ts

@@ -0,0 +1,28 @@
+// 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 { Guid } from '../Guid';
+import { JsonConverter } from './JsonConverter';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * JSON converter for Guid type.
+ */
+export class GuidJsonConverter extends JsonConverter<Guid> {
+    /** @inheritdoc */
+    get type(): Constructor<Guid> {
+        return Guid;
+    }
+
+    /** @inheritdoc */
+    read(value: any): Guid {
+        return Guid.parse(value.toString());
+    }
+
+    /** @inheritdoc */
+    write(value: any): any {
+        return value?.toString() ?? '';
+    }
+}

package/json/JsonConverter.ts

@@ -0,0 +1,40 @@
+// 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';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * Base class for JSON converters that handle serialization and deserialization of specific types.
+ * Similar to System.Text.Json.Serialization.JsonConverter<T>.
+ */
+export abstract class JsonConverter<T = any> {
+    /**
+     * Gets the type that this converter handles.
+     */
+    abstract get type(): Constructor<T>;
+
+    /**
+     * Determines whether the converter can convert the specified type.
+     * @param {Constructor} typeToConvert - The type to check.
+     * @returns {boolean} True if the converter can convert the type; otherwise, false.
+     */
+    canConvert(typeToConvert: Constructor): boolean {
+        return typeToConvert === this.type;
+    }
+
+    /**
+     * Reads and converts the JSON to the target type.
+     * @param {any} value - The value to deserialize.
+     * @returns {T} The deserialized value.
+     */
+    abstract read(value: any): T;
+
+    /**
+     * Writes the value as JSON.
+     * @param {T} value - The value to serialize.
+     * @returns {any} The serialized value.
+     */
+    abstract write(value: T): any;
+}

package/json/LineStringJsonConverter.ts

@@ -0,0 +1,35 @@
+// 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 { Point, LineString } from '../geospatial';
+import { JsonConverter } from './JsonConverter';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * JSON converter for LineString type (GeoJSON format).
+ */
+export class LineStringJsonConverter extends JsonConverter<LineString> {
+    /** @inheritdoc */
+    get type(): Constructor<LineString> {
+        return LineString;
+    }
+
+    /** @inheritdoc */
+    read(value: any): LineString {
+        if (value === null || value === undefined) {
+            throw new Error('Cannot deserialize null or undefined to LineString');
+        }
+        if (value.type !== 'LineString' || !value.coordinates || value.coordinates.length < 2) {
+            throw new Error('Cannot deserialize LineString: invalid GeoJSON format');
+        }
+        const points = value.coordinates.map((coord: number[]) => new Point(coord[0], coord[1]));
+        return new LineString(points);
+    }
+
+    /** @inheritdoc */
+    write(value: any): any {
+        return value?.toJSON() ?? null;
+    }
+}

package/json/PointJsonConverter.ts

@@ -0,0 +1,37 @@
+// 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 { Point } from '../geospatial';
+import { JsonConverter } from './JsonConverter';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * JSON converter for Point type (GeoJSON format).
+ */
+export class PointJsonConverter extends JsonConverter<Point> {
+    /** @inheritdoc */
+    get type(): Constructor<Point> {
+        return Point;
+    }
+
+    /** @inheritdoc */
+    read(value: any): Point {
+        if (value === null || value === undefined) {
+            throw new Error('Cannot deserialize null or undefined to Point');
+        }
+        if (value.type === 'Point' && value.coordinates && value.coordinates.length === 2) {
+            return new Point(value.coordinates[0], value.coordinates[1]);
+        }
+        if (typeof value.longitude === 'number' && typeof value.latitude === 'number') {
+            return new Point(value.longitude, value.latitude);
+        }
+        throw new Error('Cannot deserialize Point: expected GeoJSON format { type, coordinates } or { longitude, latitude }');
+    }
+
+    /** @inheritdoc */
+    write(value: any): any {
+        return value?.toJSON() ?? null;
+    }
+}

package/json/PolygonJsonConverter.ts

@@ -0,0 +1,38 @@
+// 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 { Point, LinearRing, Polygon } from '../geospatial';
+import { JsonConverter } from './JsonConverter';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * JSON converter for Polygon type (GeoJSON format).
+ */
+export class PolygonJsonConverter extends JsonConverter<Polygon> {
+    /** @inheritdoc */
+    get type(): Constructor<Polygon> {
+        return Polygon;
+    }
+
+    /** @inheritdoc */
+    read(value: any): Polygon {
+        if (value === null || value === undefined) {
+            throw new Error('Cannot deserialize null or undefined to Polygon');
+        }
+        if (value.type !== 'Polygon' || !value.coordinates || value.coordinates.length === 0) {
+            throw new Error('Cannot deserialize Polygon: invalid GeoJSON format');
+        }
+        const shell = new LinearRing(value.coordinates[0].map((coord: number[]) => new Point(coord[0], coord[1])));
+        const holes = value.coordinates.slice(1).map((ring: number[][]) => 
+            new LinearRing(ring.map((coord: number[]) => new Point(coord[0], coord[1])))
+        );
+        return new Polygon(shell, holes);
+    }
+
+    /** @inheritdoc */
+    write(value: any): any {
+        return value?.toJSON() ?? null;
+    }
+}

package/json/TimeSpanJsonConverter.ts

@@ -0,0 +1,28 @@
+// 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 { TimeSpan } from '../TimeSpan';
+import { JsonConverter } from './JsonConverter';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * JSON converter for TimeSpan type.
+ */
+export class TimeSpanJsonConverter extends JsonConverter<TimeSpan> {
+    /** @inheritdoc */
+    get type(): Constructor<TimeSpan> {
+        return TimeSpan;
+    }
+
+    /** @inheritdoc */
+    read(value: any): TimeSpan {
+        return TimeSpan.parse(value.toString());
+    }
+
+    /** @inheritdoc */
+    write(value: any): any {
+        return value?.toString() ?? '';
+    }
+}

package/json/ValueMapJsonConverter.ts

@@ -0,0 +1,57 @@
+// 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 { ValueMap } from '../ValueMap';
+import { JsonConverter } from './JsonConverter';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/no-unused-vars */
+
+/**
+ * JSON converter for ValueMap type.
+ * 
+ * Note: ValueMap deserialization is handled separately by JsonSerializer.deserializeValueMapFromField
+ * based on field metadata to properly deserialize keys and values according to their types.
+ * The read() method is not used directly during normal deserialization.
+ */
+export class ValueMapJsonConverter extends JsonConverter<ValueMap<any, any>> {
+    // Circular dependency workaround - these will be injected by JsonSerializer
+    private static serializeMapKey: ((key: any) => string) | null = null;
+    private static convertTypesOnInstance: ((instance: any) => any) | null = null;
+
+    /**
+     * Sets the required helper functions from JsonSerializer to avoid circular dependencies.
+     */
+    static setHelpers(serializeMapKey: (key: any) => string, convertTypesOnInstance: (instance: any) => any): void {
+        ValueMapJsonConverter.serializeMapKey = serializeMapKey;
+        ValueMapJsonConverter.convertTypesOnInstance = convertTypesOnInstance;
+    }
+
+    /** @inheritdoc */
+    get type(): Constructor<ValueMap<any, any>> {
+        return ValueMap;
+    }
+
+    /** @inheritdoc */
+    read(_value: any): ValueMap<any, any> {
+        // ValueMap deserialization is handled separately by JsonSerializer.deserializeValueMapFromField
+        // based on field metadata to properly deserialize keys and values according to their types.
+        // This method should not be called directly during normal deserialization.
+        const valueMap = new ValueMap<any, any>();
+        return valueMap;
+    }
+
+    /** @inheritdoc */
+    write(value: ValueMap<any, any>): any {
+        if (!ValueMapJsonConverter.serializeMapKey || !ValueMapJsonConverter.convertTypesOnInstance) {
+            throw new Error('ValueMapJsonConverter helpers not initialized. Call setHelpers() first.');
+        }
+
+        const converted: any = {};
+        for (const [key, mapValue] of value.entries()) {
+            converted[ValueMapJsonConverter.serializeMapKey(key)] = ValueMapJsonConverter.convertTypesOnInstance(mapValue);
+        }
+        return converted;
+    }
+}

package/json/for_DateJsonConverter/when_reading_date_with_date_converter.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 { DateJsonConverter } from '../DateJsonConverter';
+
+describe('when reading date with date converter', () => {
+    const converter = new DateJsonConverter();
+    const result = converter.read('2024-01-15T10:30:00.000Z');
+
+    it('should return Date instance', () => result.should.be.instanceof(Date));
+    it('should have correct time', () => result.getTime().should.equal(new Date('2024-01-15T10:30:00.000Z').getTime()));
+});

package/json/for_DateJsonConverter/when_writing_date_with_date_converter.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 { DateJsonConverter } from '../DateJsonConverter';
+
+describe('when writing date with date converter', () => {
+    const converter = new DateJsonConverter();
+    const date = new Date('2024-01-15T10:30:00.000Z');
+    const result = converter.write(date);
+
+    it('should return ISO string', () => result.should.equal('2024-01-15T10:30:00.000Z'));
+});

package/json/for_GuidJsonConverter/when_reading_guid_with_guid_converter.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Guid } from '../../Guid';
+import { GuidJsonConverter } from '../GuidJsonConverter';
+
+describe('when reading guid with guid converter', () => {
+    const converter = new GuidJsonConverter();
+    const result = converter.read('f47ac10b-58cc-4372-a567-0e02b2c3d479');
+
+    it('should return Guid instance', () => result.should.be.instanceof(Guid));
+    it('should have correct value', () => result.toString().should.equal('f47ac10b-58cc-4372-a567-0e02b2c3d479'));
+});

package/json/for_GuidJsonConverter/when_writing_guid_with_guid_converter.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Guid } from '../../Guid';
+import { GuidJsonConverter } from '../GuidJsonConverter';
+
+describe('when writing guid with guid converter', () => {
+    const converter = new GuidJsonConverter();
+    const guid = Guid.parse('f47ac10b-58cc-4372-a567-0e02b2c3d479');
+    const result = converter.write(guid);
+
+    it('should return guid string', () => result.should.equal('f47ac10b-58cc-4372-a567-0e02b2c3d479'));
+});

package/json/for_LineStringJsonConverter/when_deserializing_linestring.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { LineString } from '../../geospatial/LineString';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when deserializing linestring', () => {
+    const json = '{"type":"LineString","coordinates":[[10.5,20.3],[30.1,40.2],[50.7,60.8]]}';
+    const result = JsonSerializer.deserialize(LineString, json);
+
+    it('should be a LineString', () => result.should.be.instanceof(LineString));
+    it('should have three points', () => result.coordinates.length.should.equal(3));
+    it('should have correct first point longitude', () => result.coordinates[0].longitude.should.equal(10.5));
+    it('should have correct first point latitude', () => result.coordinates[0].latitude.should.equal(20.3));
+    it('should have correct second point longitude', () => result.coordinates[1].longitude.should.equal(30.1));
+    it('should have correct second point latitude', () => result.coordinates[1].latitude.should.equal(40.2));
+    it('should have correct third point longitude', () => result.coordinates[2].longitude.should.equal(50.7));
+    it('should have correct third point latitude', () => result.coordinates[2].latitude.should.equal(60.8));
+});

package/json/for_LineStringJsonConverter/when_reading_linestring_with_linestring_converter.ts

@@ -0,0 +1,24 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { LineString } from '../../geospatial/LineString';
+import { LineStringJsonConverter } from '../LineStringJsonConverter';
+
+describe('when reading linestring with linestring converter', () => {
+    const converter = new LineStringJsonConverter();
+    const result = converter.read({
+        type: 'LineString',
+        coordinates: [[10.5, 20.3], [11.2, 21.1]]
+    });
+
+    it('should return LineString instance', () => result.should.be.instanceof(LineString));
+    it('should have two points', () => result.coordinates.length.should.equal(2));
+    it('should have first point with correct coordinates', () => {
+        result.coordinates[0].longitude.should.equal(10.5);
+        result.coordinates[0].latitude.should.equal(20.3);
+    });
+    it('should have second point with correct coordinates', () => {
+        result.coordinates[1].longitude.should.equal(11.2);
+        result.coordinates[1].latitude.should.equal(21.1);
+    });
+});

package/json/for_LineStringJsonConverter/when_serializing_linestring.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { LineString } from '../../geospatial/LineString';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when serializing linestring', () => {
+    const point1 = new Point(10.5, 20.3);
+    const point2 = new Point(30.1, 40.2);
+    const point3 = new Point(50.7, 60.8);
+    const lineString = new LineString([point1, point2, point3]);
+    const result = JsonSerializer.serialize(lineString);
+    const deserialized = JSON.parse(result);
+
+    it('should have type of LineString', () => deserialized.type.should.equal('LineString'));
+    it('should have coordinates array', () => deserialized.coordinates.should.be.an('array'));
+    it('should have three coordinate pairs', () => deserialized.coordinates.length.should.equal(3));
+    it('should have correct first point longitude', () => deserialized.coordinates[0][0].should.equal(10.5));
+    it('should have correct first point latitude', () => deserialized.coordinates[0][1].should.equal(20.3));
+    it('should have correct second point longitude', () => deserialized.coordinates[1][0].should.equal(30.1));
+    it('should have correct second point latitude', () => deserialized.coordinates[1][1].should.equal(40.2));
+    it('should have correct third point longitude', () => deserialized.coordinates[2][0].should.equal(50.7));
+    it('should have correct third point latitude', () => deserialized.coordinates[2][1].should.equal(60.8));
+});

package/json/for_LineStringJsonConverter/when_writing_linestring_with_linestring_converter.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { LineString } from '../../geospatial/LineString';
+import { LineStringJsonConverter } from '../LineStringJsonConverter';
+
+describe('when writing linestring with linestring converter', () => {
+    const converter = new LineStringJsonConverter();
+    const lineString = new LineString([
+        new Point(10.5, 20.3),
+        new Point(11.2, 21.1)
+    ]);
+    const result = converter.write(lineString);
+
+    it('should have type property', () => result.type.should.equal('LineString'));
+    it('should have coordinates array', () => result.coordinates.should.be.instanceof(Array));
+    it('should have two points', () => result.coordinates.length.should.equal(2));
+    it('should have first point coordinates', () => {
+        result.coordinates[0][0].should.equal(10.5);
+        result.coordinates[0][1].should.equal(20.3);
+    });
+    it('should have second point coordinates', () => {
+        result.coordinates[1][0].should.equal(11.2);
+        result.coordinates[1][1].should.equal(21.1);
+    });
+});

package/json/for_PointJsonConverter/when_deserializing_point.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 { Point } from '../../geospatial/Point';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when deserializing point', () => {
+    const json = '{"type":"Point","coordinates":[10.5,20.3]}';
+    const result = JsonSerializer.deserialize(Point, json);
+
+    it('should be a Point', () => result.should.be.instanceof(Point));
+    it('should have correct longitude', () => result.longitude.should.equal(10.5));
+    it('should have correct latitude', () => result.latitude.should.equal(20.3));
+});

package/json/for_PointJsonConverter/when_reading_point_with_point_converter.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 { Point } from '../../geospatial/Point';
+import { PointJsonConverter } from '../PointJsonConverter';
+
+describe('when reading point with point converter', () => {
+    const converter = new PointJsonConverter();
+    const result = converter.read({ type: 'Point', coordinates: [10.5, 20.3] });
+
+    it('should return Point instance', () => result.should.be.instanceof(Point));
+    it('should have correct longitude', () => result.longitude.should.equal(10.5));
+    it('should have correct latitude', () => result.latitude.should.equal(20.3));
+});

package/json/for_PointJsonConverter/when_serializing_point.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when serializing point', () => {
+    const point = new Point(10.5, 20.3);
+    const result = JsonSerializer.serialize(point);
+    const deserialized = JSON.parse(result);
+
+    it('should have type of Point', () => deserialized.type.should.equal('Point'));
+    it('should have coordinates array', () => deserialized.coordinates.should.be.an('array'));
+    it('should have two coordinates', () => deserialized.coordinates.length.should.equal(2));
+    it('should have correct longitude', () => deserialized.coordinates[0].should.equal(10.5));
+    it('should have correct latitude', () => deserialized.coordinates[1].should.equal(20.3));
+});

package/json/for_PointJsonConverter/when_writing_point_with_point_converter.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { PointJsonConverter } from '../PointJsonConverter';
+
+describe('when writing point with point converter', () => {
+    const converter = new PointJsonConverter();
+    const point = new Point(10.5, 20.3);
+    const result = converter.write(point);
+
+    it('should have type property', () => result.type.should.equal('Point'));
+    it('should have coordinates array', () => result.coordinates.should.be.instanceof(Array));
+    it('should have longitude as first coordinate', () => result.coordinates[0].should.equal(10.5));
+    it('should have latitude as second coordinate', () => result.coordinates[1].should.equal(20.3));
+});

package/json/for_PolygonJsonConverter/when_deserializing_polygon_with_holes.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Polygon } from '../../geospatial/Polygon';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when deserializing polygon with holes', () => {
+    const json = '{"type":"Polygon","coordinates":[[[0,0],[20,0],[20,20],[0,20],[0,0]],[[2,2],[8,2],[8,8],[2,8],[2,2]],[[12,12],[18,12],[18,18],[12,18],[12,12]]]}';
+    const result = JsonSerializer.deserialize(Polygon, json);
+
+    it('should be a Polygon', () => result.should.be.instanceof(Polygon));
+    it('should have shell with five points', () => result.shell.coordinates.length.should.equal(5));
+    it('should have two holes', () => result.holes.length.should.equal(2));
+    it('should have five points in first hole', () => result.holes[0].coordinates.length.should.equal(5));
+    it('should have five points in second hole', () => result.holes[1].coordinates.length.should.equal(5));
+    it('should have correct first point in shell', () => {
+        result.shell.coordinates[0].longitude.should.equal(0);
+        result.shell.coordinates[0].latitude.should.equal(0);
+    });
+    it('should have correct first point in first hole', () => {
+        result.holes[0].coordinates[0].longitude.should.equal(2);
+        result.holes[0].coordinates[0].latitude.should.equal(2);
+    });
+    it('should have correct first point in second hole', () => {
+        result.holes[1].coordinates[0].longitude.should.equal(12);
+        result.holes[1].coordinates[0].latitude.should.equal(12);
+    });
+});

package/json/for_PolygonJsonConverter/when_deserializing_polygon_with_no_holes.ts

@@ -0,0 +1,22 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Polygon } from '../../geospatial/Polygon';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when deserializing polygon with no holes', () => {
+    const json = '{"type":"Polygon","coordinates":[[[0,0],[10,0],[10,10],[0,10],[0,0]]]}';
+    const result = JsonSerializer.deserialize(Polygon, json);
+
+    it('should be a Polygon', () => result.should.be.instanceof(Polygon));
+    it('should have shell with five points', () => result.shell.coordinates.length.should.equal(5));
+    it('should have no holes', () => result.holes.length.should.equal(0));
+    it('should have correct first point in shell', () => {
+        result.shell.coordinates[0].longitude.should.equal(0);
+        result.shell.coordinates[0].latitude.should.equal(0);
+    });
+    it('should have correct last point in shell (closed ring)', () => {
+        result.shell.coordinates[4].longitude.should.equal(0);
+        result.shell.coordinates[4].latitude.should.equal(0);
+    });
+});

package/json/for_PolygonJsonConverter/when_reading_polygon_with_polygon_converter.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Polygon } from '../../geospatial/Polygon';
+import { PolygonJsonConverter } from '../PolygonJsonConverter';
+
+describe('when reading polygon with polygon converter', () => {
+    const converter = new PolygonJsonConverter();
+    const result = converter.read({
+        type: 'Polygon',
+        coordinates: [
+            [[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]
+        ]
+    });
+
+    it('should return Polygon instance', () => result.should.be.instanceof(Polygon));
+    it('should have shell ring with five points', () => result.shell.coordinates.length.should.equal(5));
+    it('should have first point with correct coordinates', () => {
+        result.shell.coordinates[0].longitude.should.equal(0);
+        result.shell.coordinates[0].latitude.should.equal(0);
+    });
+    it('should have closed ring', () => {
+        result.shell.coordinates[0].longitude.should.equal(result.shell.coordinates[4].longitude);
+        result.shell.coordinates[0].latitude.should.equal(result.shell.coordinates[4].latitude);
+    });
+    it('should have no holes', () => result.holes.length.should.equal(0));
+});

package/json/for_PolygonJsonConverter/when_serializing_polygon_with_holes.ts

@@ -0,0 +1,53 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { LinearRing } from '../../geospatial/LinearRing';
+import { Polygon } from '../../geospatial/Polygon';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when serializing polygon with holes', () => {
+    const shell = new LinearRing([
+        new Point(0, 0),
+        new Point(20, 0),
+        new Point(20, 20),
+        new Point(0, 20),
+        new Point(0, 0)
+    ]);
+    const hole1 = new LinearRing([
+        new Point(2, 2),
+        new Point(8, 2),
+        new Point(8, 8),
+        new Point(2, 8),
+        new Point(2, 2)
+    ]);
+    const hole2 = new LinearRing([
+        new Point(12, 12),
+        new Point(18, 12),
+        new Point(18, 18),
+        new Point(12, 18),
+        new Point(12, 12)
+    ]);
+    const polygon = new Polygon(shell, [hole1, hole2]);
+    const result = JsonSerializer.serialize(polygon);
+    const deserialized = JSON.parse(result);
+
+    it('should have type of Polygon', () => deserialized.type.should.equal('Polygon'));
+    it('should have coordinates array', () => deserialized.coordinates.should.be.an('array'));
+    it('should have three rings (shell + 2 holes)', () => deserialized.coordinates.length.should.equal(3));
+    it('should have five points in shell', () => deserialized.coordinates[0].length.should.equal(5));
+    it('should have five points in first hole', () => deserialized.coordinates[1].length.should.equal(5));
+    it('should have five points in second hole', () => deserialized.coordinates[2].length.should.equal(5));
+    it('should have correct first point in shell', () => {
+        deserialized.coordinates[0][0][0].should.equal(0);
+        deserialized.coordinates[0][0][1].should.equal(0);
+    });
+    it('should have correct first point in first hole', () => {
+        deserialized.coordinates[1][0][0].should.equal(2);
+        deserialized.coordinates[1][0][1].should.equal(2);
+    });
+    it('should have correct first point in second hole', () => {
+        deserialized.coordinates[2][0][0].should.equal(12);
+        deserialized.coordinates[2][0][1].should.equal(12);
+    });
+});