@fgv/ts-bcp47 0.9.6 → 2.0.1-alpha.0

package/lib/packlets/unsd/csv/model.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=model.js.map

package/lib/packlets/unsd/csv/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/packlets/unsd/csv/model.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Iana from '../../iana';\n\n/**\n * @internal\n */\nexport interface IM49CsvRow {\n  globalCode: Iana.Model.UnM49RegionCode;\n  globalName: string;\n  regionCode?: Iana.Model.UnM49RegionCode;\n  regionName?: string;\n  subRegionCode?: Iana.Model.UnM49RegionCode;\n  subRegionName?: string;\n  intermediateRegionCode?: Iana.Model.UnM49RegionCode;\n  intermediateRegionName?: string;\n  countryOrArea: string;\n  m49Code: Iana.Model.UnM49RegionCode;\n  isoAlpha2RegionCode?: Iana.Model.IsoAlpha2RegionCode;\n  isoAlpha3RegionCode?: Iana.Model.IsoAlpha3RegionCode;\n  leastDevelopedCountry: boolean;\n  landLockedDevelopingCountry: boolean;\n  smallIslandDevelopingState: boolean;\n}\n"]}

package/lib/packlets/unsd/defaultRegistries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRegistries.d.ts","sourceRoot":"","sources":["../../../src/packlets/unsd/defaultRegistries.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,WAAW,CAAa;IAExD,WAAkB,WAAW,IAAI,WAAW,CAK3C;CACF"}

package/lib/packlets/unsd/defaultRegistries.js

@@ -0,0 +1,42 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultRegistries = void 0;
+const regionCodes_1 = require("./regionCodes");
+/**
+ * @public
+ */
+class DefaultRegistries {
+    static get regionCodes() {
+        if (!this._regionCodes) {
+            this._regionCodes = regionCodes_1.RegionCodes.loadDefault().orThrow();
+        }
+        return this._regionCodes;
+    }
+}
+exports.DefaultRegistries = DefaultRegistries;
+/**
+ * @internal
+ */
+DefaultRegistries._regionCodes = undefined;
+//# sourceMappingURL=defaultRegistries.js.map

package/lib/packlets/unsd/defaultRegistries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRegistries.js","sourceRoot":"","sources":["../../../src/packlets/unsd/defaultRegistries.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,+CAA4C;AAE5C;;GAEG;AACH,MAAa,iBAAiB;IAMrB,MAAM,KAAK,WAAW;QAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACtB,IAAI,CAAC,YAAY,GAAG,yBAAW,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;SACzD;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;;AAXH,8CAYC;AAXC;;GAEG;AACc,8BAAY,GAAiB,SAAS,CAAC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { RegionCodes } from './regionCodes';\n\n/**\n * @public\n */\nexport class DefaultRegistries {\n  /**\n   * @internal\n   */\n  protected static _regionCodes?: RegionCodes = undefined;\n\n  public static get regionCodes(): RegionCodes {\n    if (!this._regionCodes) {\n      this._regionCodes = RegionCodes.loadDefault().orThrow();\n    }\n    return this._regionCodes;\n  }\n}\n"]}

package/{unsd → lib/packlets/unsd}/index.d.ts

@@ -1,4 +1,6 @@
+import * as Csv from './csv';
 export * from './common';
 export { DefaultRegistries } from './defaultRegistries';
 export { RegionCodes } from './regionCodes';
+export { Csv };
 //# sourceMappingURL=index.d.ts.map

package/lib/packlets/unsd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/unsd/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/lib/packlets/unsd/index.js

@@ -0,0 +1,58 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Csv = exports.RegionCodes = exports.DefaultRegistries = void 0;
+const Csv = __importStar(require("./csv"));
+exports.Csv = Csv;
+__exportStar(require("./common"), exports);
+var defaultRegistries_1 = require("./defaultRegistries");
+Object.defineProperty(exports, "DefaultRegistries", { enumerable: true, get: function () { return defaultRegistries_1.DefaultRegistries; } });
+var regionCodes_1 = require("./regionCodes");
+Object.defineProperty(exports, "RegionCodes", { enumerable: true, get: function () { return regionCodes_1.RegionCodes; } });
+//# sourceMappingURL=index.js.map

package/lib/packlets/unsd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/unsd/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,2CAA6B;AAKpB,kBAAG;AAHZ,2CAAyB;AACzB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Csv from './csv';\n\nexport * from './common';\nexport { DefaultRegistries } from './defaultRegistries';\nexport { RegionCodes } from './regionCodes';\nexport { Csv };\n"]}

package/{unsd → lib/packlets/unsd}/regionCodes.d.ts

@@ -1,9 +1,9 @@
+import * as Iana from '../iana';
 import * as Model from './csv/model';
-import { CountryOrArea, Region } from './common';
 import { Result } from '@fgv/ts-utils';
+import { ICountryOrArea, Region } from './common';
 import { Areas } from './areas';
 import { Regions } from './regions';
-import { UnM49RegionCode } from '../iana/model';
 /**
  * @public
  */
@@ -14,12 +14,12 @@ export declare class RegionCodes {
      * @internal
      */
     protected constructor();
-    static create(rows: Model.M49CsvRow[]): Result<RegionCodes>;
+    static create(rows: Model.IM49CsvRow[]): Result<RegionCodes>;
     static createFromJson(from: unknown): Result<RegionCodes>;
     static loadDefault(): Result<RegionCodes>;
     static loadCsv(path: string): Result<RegionCodes>;
-    tryGetRegionOrArea(code: UnM49RegionCode): Region | CountryOrArea | undefined;
-    getIsContained(container: Region, contained: CountryOrArea | Region): boolean;
+    tryGetRegionOrArea(code: Iana.Model.UnM49RegionCode): Region | ICountryOrArea | undefined;
+    getIsContained(container: Region, contained: ICountryOrArea | Region): boolean;
     /**
      * Imports a single parsed row of UN M.49 region code data
      * @param row - The parsed row to be imported.
@@ -27,7 +27,7 @@ export declare class RegionCodes {
      * imported, or `Failure` with details if an error occurs.
      * @internal
      */
-    protected _importRow(row: Model.M49CsvRow): Result<true>;
+    protected _importRow(row: Model.IM49CsvRow): Result<true>;
     /**
      * Imports multiple parsed rows from UN M.49 region code data
      * @param rows - The parsed rows to be imported.
@@ -35,6 +35,6 @@ export declare class RegionCodes {
      * imported, or `Failure` with details if an error occurs.
      * @internal
      */
-    protected _importRows(rows: Model.M49CsvRow[]): Result<true>;
+    protected _importRows(rows: Model.IM49CsvRow[]): Result<true>;
 }
 //# sourceMappingURL=regionCodes.d.ts.map

package/lib/packlets/unsd/regionCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regionCodes.d.ts","sourceRoot":"","sources":["../../../src/packlets/unsd/regionCodes.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,MAAM,EAAuB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,KAAK,EAAE,KAAK,CAAC;IAE7B;;OAEG;IACH,SAAS;WAKK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;WAOrD,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;WAIlD,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;WAIlC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;IAMjD,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS;IAKzF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,OAAO;IAWrF;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAqCzD;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;CAM9D"}

package/lib/packlets/unsd/regionCodes.js

@@ -0,0 +1,122 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegionCodes = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const converters_1 = require("./csv/converters");
+// eslint-disable-next-line @rushstack/packlets/mechanics
+const m49_json_1 = __importDefault(require("../../data/unsd/m49.json"));
+const areas_1 = require("./areas");
+const regions_1 = require("./regions");
+/**
+ * @public
+ */
+class RegionCodes {
+    /**
+     * @internal
+     */
+    constructor() {
+        this.regions = new regions_1.Regions();
+        this.areas = new areas_1.Areas();
+    }
+    static create(rows) {
+        const codes = new RegionCodes();
+        return codes._importRows(rows).onSuccess(() => {
+            return (0, ts_utils_1.succeed)(codes);
+        });
+    }
+    static createFromJson(from) {
+        return converters_1.m49CsvFile.convert(from).onSuccess(RegionCodes.create);
+    }
+    static loadDefault() {
+        return this.createFromJson(m49_json_1.default);
+    }
+    static loadCsv(path) {
+        return (0, converters_1.loadM49csvFileSync)(path).onSuccess((rows) => {
+            return this.create(rows);
+        });
+    }
+    tryGetRegionOrArea(code) {
+        var _a;
+        /* c8 ignore next - numeric area not allowed in bcp-47 so right side of ?? shouldn't be hit. */
+        return (_a = this.regions.tryGetRegion(code)) !== null && _a !== void 0 ? _a : this.areas.tryGetArea(code);
+    }
+    getIsContained(container, contained) {
+        let next = contained;
+        while (next) {
+            if (next === container) {
+                return true;
+            }
+            next = next.tier !== 'global' ? next.parent : undefined;
+        }
+        return false;
+    }
+    /**
+     * Imports a single parsed row of UN M.49 region code data
+     * @param row - The parsed row to be imported.
+     * @returns `Success` with `true` if the row was successfully
+     * imported, or `Failure` with details if an error occurs.
+     * @internal
+     */
+    _importRow(row) {
+        return this.regions
+            .getOrAddRegionChildRegion('region', this.regions.global, row.regionCode, row.regionName)
+            .onSuccess((region) => {
+            return this.regions.getOrAddRegionChildRegion('subRegion', region, row.subRegionCode, row.subRegionName);
+        })
+            .onSuccess((region) => {
+            return this.regions.getOrAddRegionChildRegion('intermediateRegion', region, row.intermediateRegionCode, row.intermediateRegionName);
+        })
+            .onSuccess((region) => {
+            return this.areas.addArea({
+                name: row.countryOrArea,
+                code: row.m49Code,
+                tier: 'area',
+                parent: region,
+                isoAlpha2: row.isoAlpha2RegionCode,
+                isoAlpha3: row.isoAlpha3RegionCode,
+                leastDevelopedCountry: row.leastDevelopedCountry,
+                landlockedDevelopingCountry: row.landLockedDevelopingCountry,
+                smallIslandDevelopingState: row.smallIslandDevelopingState
+            });
+        })
+            .onSuccess(() => {
+            return (0, ts_utils_1.succeed)(true);
+        });
+    }
+    /**
+     * Imports multiple parsed rows from UN M.49 region code data
+     * @param rows - The parsed rows to be imported.
+     * @returns `Success` with `true` if the rows were successfully
+     * imported, or `Failure` with details if an error occurs.
+     * @internal
+     */
+    _importRows(rows) {
+        return (0, ts_utils_1.allSucceed)(rows.map((row) => this._importRow(row)), true);
+    }
+}
+exports.RegionCodes = RegionCodes;
+//# sourceMappingURL=regionCodes.js.map

package/lib/packlets/unsd/regionCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regionCodes.js","sourceRoot":"","sources":["../../../src/packlets/unsd/regionCodes.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Iana from '../iana';\nimport * as Model from './csv/model';\n\nimport { Result, allSucceed, succeed } from '@fgv/ts-utils';\nimport { ICountryOrArea, Region } from './common';\nimport { loadM49csvFileSync, m49CsvFile } from './csv/converters';\n\n// eslint-disable-next-line @rushstack/packlets/mechanics\nimport defaultRegions from '../../data/unsd/m49.json';\nimport { Areas } from './areas';\nimport { Regions } from './regions';\n\n/**\n * @public\n */\nexport class RegionCodes {\n  public readonly regions: Regions;\n  public readonly areas: Areas;\n\n  /**\n   * @internal\n   */\n  protected constructor() {\n    this.regions = new Regions();\n    this.areas = new Areas();\n  }\n\n  public static create(rows: Model.IM49CsvRow[]): Result<RegionCodes> {\n    const codes = new RegionCodes();\n    return codes._importRows(rows).onSuccess(() => {\n      return succeed(codes);\n    });\n  }\n\n  public static createFromJson(from: unknown): Result<RegionCodes> {\n    return m49CsvFile.convert(from).onSuccess(RegionCodes.create);\n  }\n\n  public static loadDefault(): Result<RegionCodes> {\n    return this.createFromJson(defaultRegions);\n  }\n\n  public static loadCsv(path: string): Result<RegionCodes> {\n    return loadM49csvFileSync(path).onSuccess((rows) => {\n      return this.create(rows);\n    });\n  }\n\n  public tryGetRegionOrArea(code: Iana.Model.UnM49RegionCode): Region | ICountryOrArea | undefined {\n    /* c8 ignore next - numeric area not allowed in bcp-47 so right side of ?? shouldn't be hit. */\n    return this.regions.tryGetRegion(code) ?? this.areas.tryGetArea(code);\n  }\n\n  public getIsContained(container: Region, contained: ICountryOrArea | Region): boolean {\n    let next: Region | ICountryOrArea | undefined = contained;\n    while (next) {\n      if (next === container) {\n        return true;\n      }\n      next = next.tier !== 'global' ? next.parent : undefined;\n    }\n    return false;\n  }\n\n  /**\n   * Imports a single parsed row of UN M.49 region code data\n   * @param row - The parsed row to be imported.\n   * @returns `Success` with `true` if the row was successfully\n   * imported, or `Failure` with details if an error occurs.\n   * @internal\n   */\n  protected _importRow(row: Model.IM49CsvRow): Result<true> {\n    return this.regions\n      .getOrAddRegionChildRegion('region', this.regions.global, row.regionCode, row.regionName)\n      .onSuccess((region) => {\n        return this.regions.getOrAddRegionChildRegion(\n          'subRegion',\n          region,\n          row.subRegionCode,\n          row.subRegionName\n        );\n      })\n      .onSuccess((region) => {\n        return this.regions.getOrAddRegionChildRegion(\n          'intermediateRegion',\n          region,\n          row.intermediateRegionCode,\n          row.intermediateRegionName\n        );\n      })\n      .onSuccess((region) => {\n        return this.areas.addArea({\n          name: row.countryOrArea,\n          code: row.m49Code,\n          tier: 'area',\n          parent: region,\n          isoAlpha2: row.isoAlpha2RegionCode,\n          isoAlpha3: row.isoAlpha3RegionCode,\n          leastDevelopedCountry: row.leastDevelopedCountry,\n          landlockedDevelopingCountry: row.landLockedDevelopingCountry,\n          smallIslandDevelopingState: row.smallIslandDevelopingState\n        });\n      })\n      .onSuccess(() => {\n        return succeed(true);\n      });\n  }\n\n  /**\n   * Imports multiple parsed rows from UN M.49 region code data\n   * @param rows - The parsed rows to be imported.\n   * @returns `Success` with `true` if the rows were successfully\n   * imported, or `Failure` with details if an error occurs.\n   * @internal\n   */\n  protected _importRows(rows: Model.IM49CsvRow[]): Result<true> {\n    return allSucceed(\n      rows.map((row) => this._importRow(row)),\n      true\n    );\n  }\n}\n"]}

package/lib/packlets/unsd/regions.d.ts

@@ -0,0 +1,21 @@
+import { Result } from '@fgv/ts-utils';
+import * as Iana from '../iana';
+import { IGlobalRegion, IntermediateRegionTier, Region } from './common';
+export declare const GlobalRegionName: string;
+export declare const GlobalRegionCode: Iana.Model.UnM49RegionCode;
+/**
+ * @public
+ */
+export declare class Regions {
+    readonly global: IGlobalRegion;
+    /**
+     * @internal
+     */
+    protected readonly _regions: Map<Iana.Model.UnM49RegionCode, Region>;
+    constructor();
+    tryGetRegion(from: Iana.Model.UnM49RegionCode): Region | undefined;
+    getRegion(from: Iana.Model.UnM49RegionCode): Result<Region>;
+    getOrAddRegionChildRegion(tier: IntermediateRegionTier, parent: Region, code: Iana.Model.UnM49RegionCode | undefined, name: string | undefined): Result<Region>;
+    getAll(): Region[];
+}
+//# sourceMappingURL=regions.d.ts.map

package/lib/packlets/unsd/regions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../../../src/packlets/unsd/regions.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGzE,eAAO,MAAM,gBAAgB,EAAE,MAAgB,CAAC;AAChD,eAAO,MAAM,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,eAAqD,CAAC;AAGhG;;GAEG;AACH,qBAAa,OAAO;IAClB,SAAgB,MAAM,EAAE,aAAa,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;;IAO9D,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,GAAG,SAAS;IAIlE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAK3D,yBAAyB,CAC9B,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,SAAS,EAC5C,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAAC,MAAM,CAAC;IA+BV,MAAM,IAAI,MAAM,EAAE;CAG1B"}

package/lib/packlets/unsd/regions.js

@@ -0,0 +1,77 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Regions = exports.GlobalRegionCode = exports.GlobalRegionName = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+/* eslint-disable @typescript-eslint/naming-convention */
+exports.GlobalRegionName = 'World';
+exports.GlobalRegionCode = '001';
+/* eslint-enable @typescript-eslint/naming-convention */
+/**
+ * @public
+ */
+class Regions {
+    constructor() {
+        this.global = { name: exports.GlobalRegionName, code: exports.GlobalRegionCode, tier: 'global', regions: [], areas: [] };
+        this._regions = new Map();
+    }
+    tryGetRegion(from) {
+        return this._regions.get(from);
+    }
+    getRegion(from) {
+        const got = this._regions.get(from);
+        return got ? (0, ts_utils_1.succeed)(got) : (0, ts_utils_1.fail)(`${from}: region not found`);
+    }
+    getOrAddRegionChildRegion(tier, parent, code, name) {
+        if (!code && !name) {
+            return (0, ts_utils_1.succeed)(parent);
+        }
+        else if (!code || !name) {
+            return (0, ts_utils_1.fail)(`${code}(${name}): code and name must both be present`);
+        }
+        const existing = this._regions.get(code);
+        if (existing) {
+            if (existing.name !== name) {
+                return (0, ts_utils_1.fail)(`${code}: cannot add ${name} - already exists as ${existing.name}`);
+            }
+            if (existing.tier !== tier) {
+                return (0, ts_utils_1.fail)(`${code}: cannot add ${name} as tier ${tier} - already exists as tier ${existing.tier}`);
+            }
+            if (existing.parent !== parent) {
+                const haveParent = `${existing.parent.code}/${existing.parent.name}`;
+                const wantParent = `${parent.code}/${parent.name}`;
+                return (0, ts_utils_1.fail)(`${code}: cannot add ${name} with parent ${wantParent} - already exists with parent ${haveParent}`);
+            }
+            return (0, ts_utils_1.succeed)(existing);
+        }
+        const added = { name, code, tier, parent, regions: [], areas: [] };
+        this._regions.set(code, added);
+        parent.regions.push(added);
+        return (0, ts_utils_1.succeed)(added);
+    }
+    getAll() {
+        return Array.from(this._regions.values());
+    }
+}
+exports.Regions = Regions;
+//# sourceMappingURL=regions.js.map

package/lib/packlets/unsd/regions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.js","sourceRoot":"","sources":["../../../src/packlets/unsd/regions.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, fail, succeed } from '@fgv/ts-utils';\nimport * as Iana from '../iana';\nimport { IGlobalRegion, IntermediateRegionTier, Region } from './common';\n\n/* eslint-disable @typescript-eslint/naming-convention */\nexport const GlobalRegionName: string = 'World';\nexport const GlobalRegionCode: Iana.Model.UnM49RegionCode = '001' as Iana.Model.UnM49RegionCode;\n/* eslint-enable @typescript-eslint/naming-convention */\n\n/**\n * @public\n */\nexport class Regions {\n  public readonly global: IGlobalRegion;\n  /**\n   * @internal\n   */\n  protected readonly _regions: Map<Iana.Model.UnM49RegionCode, Region>;\n\n  public constructor() {\n    this.global = { name: GlobalRegionName, code: GlobalRegionCode, tier: 'global', regions: [], areas: [] };\n    this._regions = new Map();\n  }\n\n  public tryGetRegion(from: Iana.Model.UnM49RegionCode): Region | undefined {\n    return this._regions.get(from);\n  }\n\n  public getRegion(from: Iana.Model.UnM49RegionCode): Result<Region> {\n    const got = this._regions.get(from);\n    return got ? succeed(got) : fail(`${from}: region not found`);\n  }\n\n  public getOrAddRegionChildRegion(\n    tier: IntermediateRegionTier,\n    parent: Region,\n    code: Iana.Model.UnM49RegionCode | undefined,\n    name: string | undefined\n  ): Result<Region> {\n    if (!code && !name) {\n      return succeed(parent);\n    } else if (!code || !name) {\n      return fail(`${code}(${name}): code and name must both be present`);\n    }\n\n    const existing = this._regions.get(code);\n    if (existing) {\n      if (existing.name !== name) {\n        return fail(`${code}: cannot add ${name} - already exists as ${existing.name}`);\n      }\n      if (existing.tier !== tier) {\n        return fail(`${code}: cannot add ${name} as tier ${tier} - already exists as tier ${existing.tier}`);\n      }\n      if (existing.parent !== parent) {\n        const haveParent = `${existing.parent.code}/${existing.parent.name}`;\n        const wantParent = `${parent.code}/${parent.name}`;\n        return fail(\n          `${code}: cannot add ${name} with parent ${wantParent} - already exists with parent ${haveParent}`\n        );\n      }\n      return succeed(existing);\n    }\n\n    const added = { name, code, tier, parent, regions: [], areas: [] };\n    this._regions.set(code, added);\n    parent.regions.push(added);\n    return succeed(added);\n  }\n\n  public getAll(): Region[] {\n    return Array.from(this._regions.values());\n  }\n}\n"]}

package/lib/packlets/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/utils/index.ts"],"names":[],"mappings":"AAsBA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}

package/{utils → lib/packlets/utils}/index.js

@@ -37,4 +37,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./jsonHelpers"), exports);
 __exportStar(require("./validationHelpers"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW9CRzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILGdEQUE4QjtBQUM5QixzREFBb0MiLCJzb3VyY2VzQ29udGVudCI6WyIvKlxuICogQ29weXJpZ2h0IChjKSAyMDIxIEVyaWsgRm9ydHVuZVxuICpcbiAqIFBlcm1pc3Npb24gaXMgaGVyZWJ5IGdyYW50ZWQsIGZyZWUgb2YgY2hhcmdlLCB0byBhbnkgcGVyc29uIG9idGFpbmluZyBhIGNvcHlcbiAqIG9mIHRoaXMgc29mdHdhcmUgYW5kIGFzc29jaWF0ZWQgZG9jdW1lbnRhdGlvbiBmaWxlcyAodGhlIFwiU29mdHdhcmVcIiksIHRvIGRlYWxcbiAqIGluIHRoZSBTb2Z0d2FyZSB3aXRob3V0IHJlc3RyaWN0aW9uLCBpbmNsdWRpbmcgd2l0aG91dCBsaW1pdGF0aW9uIHRoZSByaWdodHNcbiAqIHRvIHVzZSwgY29weSwgbW9kaWZ5LCBtZXJnZSwgcHVibGlzaCwgZGlzdHJpYnV0ZSwgc3VibGljZW5zZSwgYW5kL29yIHNlbGxcbiAqIGNvcGllcyBvZiB0aGUgU29mdHdhcmUsIGFuZCB0byBwZXJtaXQgcGVyc29ucyB0byB3aG9tIHRoZSBTb2Z0d2FyZSBpc1xuICogZnVybmlzaGVkIHRvIGRvIHNvLCBzdWJqZWN0IHRvIHRoZSBmb2xsb3dpbmcgY29uZGl0aW9uczpcbiAqXG4gKiBUaGUgYWJvdmUgY29weXJpZ2h0IG5vdGljZSBhbmQgdGhpcyBwZXJtaXNzaW9uIG5vdGljZSBzaGFsbCBiZSBpbmNsdWRlZCBpbiBhbGxcbiAqIGNvcGllcyBvciBzdWJzdGFudGlhbCBwb3J0aW9ucyBvZiB0aGUgU29mdHdhcmUuXG4gKlxuICogVEhFIFNPRlRXQVJFIElTIFBST1ZJREVEIFwiQVMgSVNcIiwgV0lUSE9VVCBXQVJSQU5UWSBPRiBBTlkgS0lORCwgRVhQUkVTUyBPUlxuICogSU1QTElFRCwgSU5DTFVESU5HIEJVVCBOT1QgTElNSVRFRCBUTyBUSEUgV0FSUkFOVElFUyBPRiBNRVJDSEFOVEFCSUxJVFksXG4gKiBGSVRORVNTIEZPUiBBIFBBUlRJQ1VMQVIgUFVSUE9TRSBBTkQgTk9OSU5GUklOR0VNRU5ULiBJTiBOTyBFVkVOVCBTSEFMTCBUSEVcbiAqIEFVVEhPUlMgT1IgQ09QWVJJR0hUIEhPTERFUlMgQkUgTElBQkxFIEZPUiBBTlkgQ0xBSU0sIERBTUFHRVMgT1IgT1RIRVJcbiAqIExJQUJJTElUWSwgV0hFVEhFUiBJTiBBTiBBQ1RJT04gT0YgQ09OVFJBQ1QsIFRPUlQgT1IgT1RIRVJXSVNFLCBBUklTSU5HIEZST00sXG4gKiBPVVQgT0YgT1IgSU4gQ09OTkVDVElPTiBXSVRIIFRIRSBTT0ZUV0FSRSBPUiBUSEUgVVNFIE9SIE9USEVSIERFQUxJTkdTIElOIFRIRVxuICogU09GVFdBUkUuXG4gKi9cblxuZXhwb3J0ICogZnJvbSAnLi9qc29uSGVscGVycyc7XG5leHBvcnQgKiBmcm9tICcuL3ZhbGlkYXRpb25IZWxwZXJzJztcbiJdfQ==
+//# sourceMappingURL=index.js.map

package/lib/packlets/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,sDAAoC","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './jsonHelpers';\nexport * from './validationHelpers';\n"]}

package/lib/packlets/utils/jsonHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/utils/jsonHelpers.ts"],"names":[],"mappings":"AAsBA,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAE1C"}

package/lib/packlets/utils/jsonHelpers.js

@@ -0,0 +1,29 @@
+"use strict";
+/*
+ * Copyright (c) 2021 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeJson = void 0;
+function sanitizeJson(from) {
+    return JSON.parse(JSON.stringify(from));
+}
+exports.sanitizeJson = sanitizeJson;
+//# sourceMappingURL=jsonHelpers.js.map

package/lib/packlets/utils/jsonHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonHelpers.js","sourceRoot":"","sources":["../../../src/packlets/utils/jsonHelpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,SAAgB,YAAY,CAAI,IAAO;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAM,CAAC;AAC/C,CAAC;AAFD,oCAEC","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport function sanitizeJson<T>(from: T): T {\n  return JSON.parse(JSON.stringify(from)) as T;\n}\n"]}

package/lib/packlets/utils/public.d.ts

@@ -0,0 +1,2 @@
+export { Normalizer, ValidationHelpers, IValidationHelpersConstructorParams as ValidationHelpersConstructorParams } from './validationHelpers';
+//# sourceMappingURL=public.d.ts.map

package/lib/packlets/utils/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/packlets/utils/public.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,mCAAmC,IAAI,kCAAkC,EAC1E,MAAM,qBAAqB,CAAC"}

package/lib/packlets/utils/public.js

@@ -0,0 +1,28 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+// istanbul ignore file
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationHelpers = void 0;
+var validationHelpers_1 = require("./validationHelpers");
+Object.defineProperty(exports, "ValidationHelpers", { enumerable: true, get: function () { return validationHelpers_1.ValidationHelpers; } });
+//# sourceMappingURL=public.js.map

package/lib/packlets/utils/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/packlets/utils/public.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uBAAuB;;;AAEvB,yDAI6B;AAF3B,sHAAA,iBAAiB,OAAA","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n// istanbul ignore file\n\nexport {\n  Normalizer,\n  ValidationHelpers,\n  IValidationHelpersConstructorParams as ValidationHelpersConstructorParams\n} from './validationHelpers';\n"]}