npm - @fgv/ts-utils - Versions diffs - 3.0.1-alpha.5 → 4.0.0 - Mend

@fgv/ts-utils 3.0.1-alpha.5 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/CHANGELOG.json +33 -0
package/CHANGELOG.md +15 -1
package/README.md +0 -21
package/dist/ts-utils.d.ts +0 -21
package/dist/tsdoc-metadata.json +1 -1
package/lib/packlets/conversion/converters.d.ts +0 -17
package/lib/packlets/conversion/converters.d.ts.map +1 -1
package/lib/packlets/conversion/converters.js +1 -46
package/lib/packlets/conversion/converters.js.map +1 -1
package/lib/packlets/hash/crcNormalizer.d.ts.map +1 -1
package/lib/packlets/hash/crcNormalizer.js +36 -2
package/lib/packlets/hash/crcNormalizer.js.map +1 -1
package/package.json +13 -18

package/CHANGELOG.json CHANGED Viewed

@@ -1,6 +1,39 @@
 {
   "name": "@fgv/ts-utils",
   "entries": [
+    {
+      "version": "4.0.0",
+      "tag": "@fgv/ts-utils_v4.0.0",
+      "date": "Tue, 14 May 2024 03:09:27 GMT",
+      "comments": {
+        "none": [
+          {
+            "comment": "rework validation/converter compatibility a bit"
+          },
+          {
+            "comment": "QoL improvement to simplify error aggregation"
+          },
+          {
+            "comment": "factor optional converters out to ts-extras package to eliminate large dependencies"
+          },
+          {
+            "comment": "update generated api docs"
+          },
+          {
+            "comment": "add convalidate helper"
+          },
+          {
+            "comment": "add defaulting converter"
+          },
+          {
+            "comment": "extend conversion to accept validators"
+          },
+          {
+            "comment": "export StringConverter at top level"
+          }
+        ]
+      }
+    },
     {
       "version": "3.0.0",
       "tag": "@fgv/ts-utils_v3.0.0",

package/CHANGELOG.md CHANGED Viewed

@@ -1,6 +1,20 @@
 # Change Log - @fgv/ts-utils
-This log was last generated on Mon, 22 Jan 2024 07:00:18 GMT and should not be manually modified.
+This log was last generated on Tue, 14 May 2024 03:09:27 GMT and should not be manually modified.
+## 4.0.0
+Tue, 14 May 2024 03:09:27 GMT
+### Updates
+- rework validation/converter compatibility a bit
+- QoL improvement to simplify error aggregation
+- factor optional converters out to ts-extras package to eliminate large dependencies
+- update generated api docs
+- add convalidate helper
+- add defaulting converter
+- extend conversion to accept validators
+- export StringConverter at top level
 ## 3.0.0
 Mon, 22 Jan 2024 07:00:18 GMT

package/README.md CHANGED Viewed

@@ -11,12 +11,6 @@ Assorted typescript utilities that I'm tired of copying from project to project.
 * Result\<T\> - Easily combine inline and exception-based error handling
 * Converter\<T\> - Conversion framework especially useful for type-safe processing of JSON
-Also includes a few other much less-developed odds-and-ends borrowed from one project or another - much less polished and more likely change or disappear:
-* ExtendedArray\<T\> - adds a few useful operations to the built-in Array
-* Formattable\<T\> - simple helpers to create mustache wrappers for objects and make them easily printable
-* Logger - A very basic logger suitable for hobby projects
-* RangeOf\<T\> - Generic open or closed ranges of orderable items (numbers, dates, etc)
 ---
 - [Summary](#summary)
@@ -28,11 +22,6 @@ Also includes a few other much less-developed odds-and-ends borrowed from one pr
 - [API](#api)
   - [Result\<T\>](#resultt)
   - [Converter\<T\>](#convertert)
-- [Additional APIs](#additional-apis)
-  - [ExtendedArray\<T\>](#extendedarrayt)
-  - [Formattable\<T\>](#formattablet)
-  - [Logger](#logger)
-  - [RangeOf\<T\>](#rangeoft)
 ## Installation
@@ -139,15 +128,5 @@ Other helpers and methods enable optional values or fields, chaining of results
 ### Result\<T\>
 ### Converter\<T\>
-## Additional APIs
-### ExtendedArray\<T\>
-### Formattable\<T\>
-### Logger
-### RangeOf\<T\>

package/dist/ts-utils.d.ts CHANGED Viewed

@@ -469,7 +469,6 @@ export declare interface Converter<T, TC = undefined> extends ConverterTraits {
 declare namespace Converters {
     export {
-        templateString,
         enumeratedValue,
         mappedEnumeratedValue,
         literal,
@@ -496,7 +495,6 @@ declare namespace Converters {
         number,
         boolean,
         optionalString,
-        isoDate,
         optionalNumber,
         optionalBoolean,
         stringArray,
@@ -1385,13 +1383,6 @@ declare function isA_2<T, TC>(description: string, guard: TypeGuardWithContext<T
  */
 export declare function isKeyOf<T extends object>(key: string | number | symbol, item: T): key is keyof T;
-/**
- * A {@link Converter | Converter} which converts an iso formatted string, a number or a `Date` object to
- * a `Date` object.
- * @public
- */
-declare const isoDate: Converter<Date, unknown>;
 /**
  * Options for {@link Converters.(recordOf:3) | Converters.recordOf} and
  * {@link Converters.(mapOf:3) | Converters.mapOf}
@@ -2604,18 +2595,6 @@ declare type LogLevel = 'detail' | 'info' | 'warning' | 'error' | 'silent';
                     */
                    export declare type SuccessContinuation<T, TN> = (value: T) => Result<TN>;
-                   /**
-                    * Helper function to create a {@link Conversion.StringConverter | StringConverter} which converts
-                    * `unknown` to `string`, applying template conversions supplied at construction time or at
-                    * runtime as context.
-                    * @remarks
-                    * Template conversions are applied using `mustache` syntax.
-                    * @param defaultContext - Optional default context to use for template values.
-                    * @returns A new {@link Converter | Converter} returning `string`.
-                    * @public
-                    */
-                   declare function templateString(defaultContext?: unknown): StringConverter<string, unknown>;
                    /**
                     * Helper to create a {@link Converter | Converter} which converts a source object to a new object with a
                     * different shape.

package/dist/tsdoc-metadata.json CHANGED Viewed

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.39.4"
+      "packageVersion": "7.43.4"
     }
   ]
 }

package/lib/packlets/conversion/converters.d.ts CHANGED Viewed

@@ -14,17 +14,6 @@ export { OnError };
  * @public
  */
 export declare const string: StringConverter;
-/**
- * Helper function to create a {@link Conversion.StringConverter | StringConverter} which converts
- * `unknown` to `string`, applying template conversions supplied at construction time or at
- * runtime as context.
- * @remarks
- * Template conversions are applied using `mustache` syntax.
- * @param defaultContext - Optional default context to use for template values.
- * @returns A new {@link Converter | Converter} returning `string`.
- * @public
- */
-export declare function templateString(defaultContext?: unknown): StringConverter<string, unknown>;
 /**
  * Helper function to create a {@link Converter | Converter} which converts `unknown` to one of a set of supplied
  * enumerated values. Anything else fails.
@@ -96,12 +85,6 @@ export declare const optionalString: Converter<string | undefined, unknown>;
  * @public
  */
 export declare function delimitedString(delimiter: string, options?: 'filtered' | 'all'): Converter<string[], string>;
-/**
- * A {@link Converter | Converter} which converts an iso formatted string, a number or a `Date` object to
- * a `Date` object.
- * @public
- */
-export declare const isoDate: Converter<Date, unknown>;
 /**
  * Helper function to create a {@link Converter | Converter} from any {@link Validation.Validator}
  * @param validator - the validator to be wrapped

package/lib/packlets/conversion/converters.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/converters.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;~~AAKpD~~;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,eAAuC,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,~~cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,~~eAAe,CAAC,~~MAAM,EAAE,OAAO,~~CAAC,~~CAWzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,~~EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAMjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAazG;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAQ1D;AAED;;;;;GAKG;AAEH,eAAO,MAAM,KAAK,gBAAU,CAAC;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAM9C,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAYhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,OAAO,CAAqB,CAAC;AAExF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,UAAU,GAAG,KAAkB,GACvC,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAc7B;AAED~~;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAa3C,CAAC;AAEH~~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"}
1	+ {"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/converters.ts"],"names":[],"mappings":"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"}

package/lib/packlets/conversion/converters.js CHANGED Viewed

@@ -20,42 +20,18 @@
  * 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.transformObject = exports.transform = exports.discriminatedObject = exports.strictObject = exports.object = exports.optionalField = exports.field = exports.optionalElement = exports.element = exports.validateWith = exports.mapOf = exports.recordOf = exports.numberArray = exports.stringArray = exports.arrayOf = exports.oneOf = exports.optionalBoolean = exports.optionalNumber = exports.isA = exports.validated = exports.isoDate = exports.delimitedString = exports.optionalString = exports.boolean = exports.number = exports.value = exports.literal = exports.mappedEnumeratedValue = exports.enumeratedValue = exports.templateString = exports.string = void 0;
+exports.transformObject = exports.transform = exports.discriminatedObject = exports.strictObject = exports.object = exports.optionalField = exports.field = exports.optionalElement = exports.element = exports.validateWith = exports.mapOf = exports.recordOf = exports.numberArray = exports.stringArray = exports.arrayOf = exports.oneOf = exports.optionalBoolean = exports.optionalNumber = exports.isA = exports.validated = exports.delimitedString = exports.optionalString = exports.boolean = exports.number = exports.value = exports.literal = exports.mappedEnumeratedValue = exports.enumeratedValue = exports.string = void 0;
 const base_1 = require("../base");
 const baseConverter_1 = require("./baseConverter");
 const objectConverter_1 = require("./objectConverter");
 const stringConverter_1 = require("./stringConverter");
-const luxon_1 = require("luxon");
-const mustache_1 = __importDefault(require("mustache"));
 /**
  * A converter to convert unknown to string. Values of type
  * string succeed.  Anything else fails.
  * @public
  */
 exports.string = new stringConverter_1.StringConverter();
-/**
- * Helper function to create a {@link Conversion.StringConverter | StringConverter} which converts
- * `unknown` to `string`, applying template conversions supplied at construction time or at
- * runtime as context.
- * @remarks
- * Template conversions are applied using `mustache` syntax.
- * @param defaultContext - Optional default context to use for template values.
- * @returns A new {@link Converter | Converter} returning `string`.
- * @public
- */
-function templateString(defaultContext) {
-    return new stringConverter_1.StringConverter(defaultContext, undefined, (from, __self, context) => {
-        if (typeof from !== 'string') {
-            return (0, base_1.fail)(`Not a string: ${JSON.stringify(from)}`);
-        }
-        return (0, base_1.captureResult)(() => mustache_1.default.render(from, context));
-    });
-}
-exports.templateString = templateString;
 /**
  * Helper function to create a {@link Converter | Converter} which converts `unknown` to one of a set of supplied
  * enumerated values. Anything else fails.
@@ -186,27 +162,6 @@ function delimitedString(delimiter, options = 'filtered') {
     });
 }
 exports.delimitedString = delimitedString;
-/**
- * A {@link Converter | Converter} which converts an iso formatted string, a number or a `Date` object to
- * a `Date` object.
- * @public
- */
-exports.isoDate = new baseConverter_1.BaseConverter((from) => {
-    if (typeof from === 'string') {
-        const dt = luxon_1.DateTime.fromISO(from);
-        if (dt.isValid) {
-            return (0, base_1.succeed)(dt.toJSDate());
-        }
-        return (0, base_1.fail)(`Invalid date: ${dt.invalidExplanation}`);
-    }
-    else if (typeof from === 'number') {
-        return (0, base_1.succeed)(new Date(from));
-    }
-    else if (from instanceof Date) {
-        return (0, base_1.succeed)(from);
-    }
-    return (0, base_1.fail)(`Cannot convert ${JSON.stringify(from)} to Date`);
-});
 /**
  * Helper function to create a {@link Converter | Converter} from any {@link Validation.Validator}
  * @param validator - the validator to be wrapped

package/lib/packlets/conversion/converters.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"converters.js","sourceRoot":"","sources":["../../../src/packlets/conversion/converters.ts"],"names":[],"mappings":"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","sourcesContent":["/\n Copyright (c) 2020 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, captureResult, fail, isKeyOf, succeed } from '../base';\nimport { TypeGuardWithContext, Validator } from '../validation';\nimport { BaseConverter } from './baseConverter';\nimport { Converter, OnError } from './converter';\nimport { FieldConverters, ObjectConverter, ObjectConverterOptions } from './objectConverter';\nimport { StringConverter } from './stringConverter';\n\nimport { DateTime } from 'luxon';\nimport Mustache from 'mustache';\n\n/\n Action to take on conversion failures (deprecated - use Conversion.OnError)\n * @public\n * @deprecated use Conversion.OnError.\n /\nexport { OnError };\n\n/\n A converter to convert unknown to string. Values of type\n * string succeed. Anything else fails.\n * @public\n /\nexport const string: StringConverter = new StringConverter();\n\n/\n Helper function to create a {@link Conversion.StringConverter \| StringConverter} which converts\n * `unknown` to `string`, applying template conversions supplied at construction time or at\n * runtime as context.\n * @remarks\n * Template conversions are applied using `mustache` syntax.\n * @param defaultContext - Optional default context to use for template values.\n * @returns A new {@link Converter \| Converter} returning `string`.\n * @public\n /\nexport function templateString(defaultContext?: unknown): StringConverter<string, unknown> {\n return new StringConverter<string, unknown>(\n defaultContext,\n undefined,\n (from: unknown, __self: Converter<string, unknown>, context?: unknown) => {\n if (typeof from !== 'string') {\n return fail(`Not a string: ${JSON.stringify(from)}`);\n }\n return captureResult(() => Mustache.render(from, context));\n }\n );\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which converts `unknown` to one of a set of supplied\n * enumerated values. Anything else fails.\n \n @remarks\n * Allowed enumerated values can also be supplied as context at conversion time.\n * @param values - Array of allowed values.\n * @returns A new {@link Converter \| Converter} returning `<T>`.\n * @public\n /\nexport function enumeratedValue<T>(values: T[]): Converter<T, T[]> {\n return new BaseConverter((from: unknown, __self: Converter<T, T[]>, context?: T[]): Result<T> => {\n const v = context ?? values;\n const index = v.indexOf(from as T);\n return index >= 0 ? succeed(v[index]) : fail(`Invalid enumerated value ${JSON.stringify(from)}`);\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which converts `unknown` to one of a set of supplied enumerated\n * values, mapping any of multiple supplied values to the enumeration.\n * @remarks\n * Enables mapping of multiple input values to a consistent internal representation (so e.g. `'y'`, `'yes'`,\n * `'true'`, `1` and `true` can all map to boolean `true`)\n * @param map - An array of tuples describing the mapping. The first element of each tuple is the result\n * value, the second is the set of values that map to the result. Tuples are evaluated in the order\n * supplied and are not checked for duplicates.\n * @param message - An optional error message.\n * @returns A {@link Converter \| Converter} which applies the mapping and yields `<T>` on success.\n * @public\n /\nexport function mappedEnumeratedValue<T>(map: [T, unknown[]][], message?: string): Converter<T, undefined> {\n return new BaseConverter((from: unknown, __self: Converter<T, undefined>, __context?: unknown) => {\n for (const item of map) {\n if (item[1].includes(from)) {\n return succeed(item[0]);\n }\n }\n return fail(\n message\n ? `${JSON.stringify(from)}: ${message}`\n : `Cannot map '${JSON.stringify(from)}' to a supported value`\n );\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which converts `unknown` to some supplied literal value. Succeeds with\n * the supplied value if an identity comparison succeeds, fails otherwise.\n * @param value - The value to be compared.\n * @returns A {@link Converter \| Converter} which returns the supplied value on success.\n * @public\n /\nexport function literal<T>(value: T): Converter<T, unknown> {\n return new BaseConverter<T, unknown>(\n (from: unknown, __self: Converter<T, unknown>, __context?: unknown): Result<T> => {\n return from === value\n ? succeed(value)\n : fail(`${JSON.stringify(from)}: does not match ${JSON.stringify(value)}`);\n }\n );\n}\n\n/\n Deprecated alias for @see literal\n * @param value - The value to be compared.\n * @deprecated Use {@link Converters.literal} instead.\n * @internal\n /\n// eslint-disable-next-line @rushstack/typedef-var\nexport const value = literal;\n\n/\n A {@link Converter \| Converter} which converts `unknown` to a `number`.\n * @remarks\n * Numbers and strings with a numeric format succeed. Anything else fails.\n * @public\n /\nexport const number: Converter<number, undefined> = new BaseConverter<number>((from: unknown) => {\n if (typeof from !== 'number') {\n const num: number = typeof from === 'string' ? Number(from) : NaN;\n return isNaN(num) ? fail(`Not a number: ${JSON.stringify(from)}`) : succeed(num);\n }\n return succeed(from);\n});\n\n/\n A {@link Converter \| Converter} which converts `unknown` to `boolean`.\n * @remarks\n * Boolean values or the case-insensitive strings `'true'` and `'false'` succeed.\n * Anything else fails.\n * @public\n /\nexport const boolean: Converter<boolean, undefined> = new BaseConverter<boolean>((from: unknown) => {\n if (typeof from === 'boolean') {\n return succeed(from as boolean);\n } else if (typeof from === 'string') {\n switch (from.toLowerCase()) {\n case 'true':\n return succeed(true);\n case 'false':\n return succeed(false);\n }\n }\n return fail(`Not a boolean: ${JSON.stringify(from)}`);\n});\n\n/\n A {@link Converter \| Converter} which converts an optional `string` value. Values of type\n * `string` are returned. Anything else returns {@link Success \| Success} with value `undefined`.\n * @public\n /\nexport const optionalString: Converter<string \| undefined, unknown> = string.optional();\n\n/\n Helper function to create a {@link Converter \| Converter} which converts any `string` into an\n * array of `string`, by separating at a supplied delimiter.\n * @remarks\n * Delimiter may also be supplied as context at conversion time.\n * @param delimiter - The delimiter at which to split.\n * @returns A new {@link Converter \| Converter} returning `string[]`.\n * @public\n /\nexport function delimitedString(\n delimiter: string,\n options: 'filtered' \| 'all' = 'filtered'\n): Converter<string[], string> {\n return new BaseConverter<string[], string>(\n (from: unknown, __self: Converter<string[], string>, context?: string) => {\n const result = string.convert(from);\n if (result.isSuccess()) {\n let strings = result.value.split(context ?? delimiter);\n if (options !== 'all') {\n strings = strings.filter((s) => s.trim().length > 0);\n }\n return succeed(strings);\n }\n return fail(result.message);\n }\n );\n}\n\n/\n A {@link Converter \| Converter} which converts an iso formatted string, a number or a `Date` object to\n * a `Date` object.\n * @public\n /\nexport const isoDate: Converter<Date, unknown> = new BaseConverter<Date>((from: unknown) => {\n if (typeof from === 'string') {\n const dt = DateTime.fromISO(from);\n if (dt.isValid) {\n return succeed(dt.toJSDate());\n }\n return fail(`Invalid date: ${dt.invalidExplanation}`);\n } else if (typeof from === 'number') {\n return succeed(new Date(from));\n } else if (from instanceof Date) {\n return succeed(from);\n }\n return fail(`Cannot convert ${JSON.stringify(from)} to Date`);\n});\n\n/\n Helper function to create a {@link Converter \| Converter} from any {@link Validation.Validator}\n * @param validator - the validator to be wrapped\n * @returns A {@link Converter \| Converter} which uses the supplied validator.\n * @public\n /\nexport function validated<T, TC = unknown>(validator: Validator<T, TC>): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self?: Converter<T, TC>, context?: TC) => {\n return validator.validate(from, context);\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} from a supplied type guard function.\n * @param description - a description of the thing to be validated for use in error messages\n * @param guard - a {@link Validation.TypeGuardWithContext} which performs the validation.\n * @returns A new {@link Converter \| Converter} which validates the values using the supplied type guard\n * and returns them in place.\n * @public\n /\nexport function isA<T, TC = unknown>(\n description: string,\n guard: TypeGuardWithContext<T, TC>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self?: Converter<T, TC>, context?: TC) => {\n if (guard(from, context)) {\n return succeed(from);\n }\n return fail(`invalid ${description} (${JSON.stringify(from)})`);\n });\n}\n\n/\n A {@link Converter \| Converter} which converts an optional `number` value.\n * @remarks\n * Values of type `number` or numeric strings are converted and returned.\n * Anything else returns {@link Success \| Success} with value `undefined`.\n * @public\n /\nexport const optionalNumber: Converter<number \| undefined> = number.optional();\n\n/\n A {@link Converter \| Converter} to convert an optional `boolean` value.\n * @remarks\n * Values of type `boolean` or strings that match (case-insensitive) `'true'`\n * or `'false'` are converted and returned. Anything else returns {@link Success \| Success}\n * with value `undefined`.\n * @public\n /\nexport const optionalBoolean: Converter<boolean \| undefined> = boolean.optional();\n\n/\n A helper function to create a {@link Converter \| Converter} for polymorphic values.\n * Returns a converter which invokes the wrapped converters in sequence, returning the\n * first successful result. Returns an error if none of the supplied converters can\n * convert the value.\n * @remarks\n * If `onError` is `ignoreErrors` (default), then errors from any of the\n * converters are ignored provided that some converter succeeds. If\n * onError is `failOnError`, then an error from any converter fails the entire\n * conversion.\n \n @param converters - An ordered list of {@link Converter \| converters} or {@link Validator \| validators}\n * to be considered.\n * @param onError - Specifies treatment of unconvertible elements.\n * @returns A new {@link Converter \| Converter} which yields a value from the union of the types returned\n * by the wrapped converters.\n * @public\n /\nexport function oneOf<T, TC = unknown>(\n converters: Array<Converter<T, TC> \| Validator<T, TC>>,\n onError: OnError = 'ignoreErrors'\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self, context?: TC) => {\n const errors: string[] = [];\n for (const converter of converters) {\n const result = converter.convert(from, context);\n if (result.isSuccess() && result.value !== undefined) {\n return result;\n }\n\n if (result.isFailure()) {\n if (onError === 'failOnError') {\n return result;\n }\n errors.push(result.message);\n }\n }\n return fail(`No matching converter for ${JSON.stringify(from)}: ${errors.join('\\n')}`);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which converts `unknown` to an array of `<T>`.\n * @remarks\n * If `onError` is `'failOnError'` (default), then the entire conversion fails if any element cannot\n * be converted. If `onError` is `'ignoreErrors'`, then failing elements are silently ignored.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used to convert each\n * item in the array.\n * @param ignoreErrors - Specifies treatment of unconvertible elements.\n * @returns A {@link Converter \| Converter} which returns an array of `<T>`.\n * @public\n /\nexport function arrayOf<T, TC = undefined>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n onError: OnError = 'failOnError'\n): Converter<T[], TC> {\n return new BaseConverter((from: unknown, __self: Converter<T[], TC>, context?: TC) => {\n if (!Array.isArray(from)) {\n return fail(`Not an array: ${JSON.stringify(from)}`);\n }\n\n const successes: T[] = [];\n const errors: string[] = [];\n for (const item of from) {\n const result = converter.convert(item, context);\n if (result.isSuccess() && result.value !== undefined) {\n successes.push(result.value);\n } else if (result.isFailure()) {\n errors.push(result.message);\n }\n }\n\n return errors.length === 0 \|\| onError === 'ignoreErrors' ? succeed(successes) : fail(errors.join('\\n'));\n });\n}\n\n/\n {@link Converter \| Converter} to convert an `unknown` to an array of `string`.\n * @remarks\n * Returns {@link Success \| Success} with the the supplied value if it as an array\n * of strings, returns {@link Failure \| Failure} with an error message otherwise.\n * @public\n /\nexport const stringArray: Converter<string[]> = arrayOf(string);\n\n/\n {@link Converter \| Converter} to convert an `unknown` to an array of `number`.\n * @remarks\n * Returns {@link Success \| Success} with the the supplied value if it as an array\n * of numbers, returns {@link Failure \| Failure} with an error message otherwise.\n * @public\n /\nexport const numberArray: Converter<number[]> = arrayOf(number);\n\n/\n Options for {@link Converters.(recordOf:3) \| Converters.recordOf} and\n * {@link Converters.(mapOf:3) \| Converters.mapOf}\n * helper functions.\n * @public\n /\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface KeyedConverterOptions<T extends string = string, TC = undefined> {\n /\n if `onError` is `'fail'` (default), then the entire conversion fails if any key or element\n * cannot be converted. If `onError` is `'ignore'`, failing elements are silently ignored.\n /\n onError?: 'fail' \| 'ignore';\n /\n If present, `keyConverter` is used to convert the source object property names to\n * keys in the resulting map or record.\n * @remarks\n * Can be used to coerce key names to supported values and/or strong types.\n /\n keyConverter?: Converter<T, TC> \| Validator<T, TC>;\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed\n * properties using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to\n * produce a `Record<string, T>`.\n * @remarks\n * The resulting converter fails conversion if any element cannot be converted.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for each\n * item in the source object.\n * @returns A {@link Converter \| Converter} which returns `Record<string, T>`.\n * {@label WITH_DEFAULT}\n * @public\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<Record<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Record<string, T>` and optionally specified handling of elements that cannot be converted.\n * @remarks\n * if `onError` is `'fail'` (default), then the entire conversion fails if any key or element\n * cannot be converted. If `onError` is `'ignore'`, failing elements are silently ignored.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} for each item in\n * the source object.\n * @returns A {@link Converter \| Converter} which returns `Record<string, T>`.\n * {@label WITH_ON_ERROR}\n * @public\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n onError: 'fail' \| 'ignore'\n): Converter<Record<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} or which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Record<TK, T>`.\n * @remarks\n * If present, the supplied {@link Converters.KeyedConverterOptions \| options} can provide a strongly-typed\n * converter for keys and/or control the handling of elements that fail conversion.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for each item in the source object.\n * @param options - Optional {@link Converters.KeyedConverterOptions \| KeyedConverterOptions<TK, TC>} which\n * supplies a key converter and/or error-handling options.\n * @returns A {@link Converter \| Converter} which returns `Record<TK, T>`.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n options: KeyedConverterOptions<TK, TC>\n): Converter<Record<TK, T>, TC>;\n\n/\n Concrete implementation of {@link Converters.(recordOf:1) \| Converters.recordOf(Converter<T>)},\n * {@link Converters.(recordOf:2) \| Converters.recordOf(Converter<T>, 'fail' or 'ignore')}, and\n * {@link Converters.(recordOf:3) \| Converters.recordOf(Converter<T>, KeyedConverterOptions)}.\n * @internal\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n option: 'fail' \| 'ignore' \| KeyedConverterOptions<TK, TC> = 'fail'\n): Converter<Record<TK, T>, TC> {\n const options: KeyedConverterOptions<TK, TC> =\n typeof option === 'string' ? { onError: option } : { onError: 'fail', ...option };\n return new BaseConverter((from: unknown, __self: Converter<Record<TK, T>, TC>, context?: TC) => {\n if (typeof from !== 'object' \|\| from === null \|\| Array.isArray(from)) {\n return fail(`Not a string-keyed object: ${JSON.stringify(from)}`);\n }\n\n const record: Record<string, T> = {};\n const errors: string[] = [];\n\n for (const key in from) {\n if (isKeyOf(key, from)) {\n const writeKeyResult = options.keyConverter?.convert(key, context) ?? succeed(key);\n\n writeKeyResult\n .onSuccess((writeKey) => {\n return converter.convert(from[key] as unknown, context).onSuccess((value) => {\n record[writeKey] = value;\n return succeed(true);\n });\n })\n .onFailure((message) => {\n errors.push(message);\n return fail(message);\n });\n }\n }\n\n return errors.length === 0 \|\| options.onError === 'ignore' ? succeed(record) : fail(errors.join('\\n'));\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Map<string, T>`.\n * @remarks\n * The resulting converter fails conversion if any element cannot be converted.\n * @param converter - {@link Converter \| Converter} \| {@link Validator \| Validator} used for each item in\n * the source object.\n * @returns A {@link Converter \| Converter} which returns `Map<string, T>`.\n * {@label WITH_DEFAULT}\n * @public\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<Map<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Map<string, T>` and specified handling of elements that cannot be converted.\n * @remarks\n * if `onError` is `'fail'` (default), then the entire conversion fails if any key or element\n * cannot be converted. If `onError` is `'ignore'`, failing elements are silently ignored.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for\n * each item in the source object.\n * @returns A {@link Converter \| Converter} which returns `Map<string, T>`.\n * {@label WITH_ON_ERROR}\n * @public\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n onError: 'fail' \| 'ignore'\n): Converter<Map<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce\n * a `Map<TK,T>`.\n * @remarks\n * If present, the supplied {@link Converters.KeyedConverterOptions \| options} can provide a strongly-typed\n * converter for keys and/or control the handling of elements that fail conversion.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for each item\n * in the source object.\n * @param options - Optional {@link Converters.KeyedConverterOptions \| KeyedConverterOptions<TK, TC>} which\n * supplies a key converter and/or error-handling options.\n * @returns A {@link Converter \| Converter} which returns `Map<TK,T>`.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n options: KeyedConverterOptions<TK, TC>\n): Converter<Map<TK, T>, TC>;\n\n/\n Concrete implementation of {@link Converters.(mapOf:1) \| Converters.mapOf(Converter<T>)},\n * {@link Converters.(mapOf:2) \| Converters.mapOf(Converter<T>, 'fail' or 'ignore')}, and\n * {@link Converters.(mapOf:3) \| Converters.mapOf(Converter<T>, KeyedConverterOptions)}.\n * @internal\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n option: 'fail' \| 'ignore' \| KeyedConverterOptions<TK, TC> = 'fail'\n): Converter<Map<TK, T>, TC> {\n const options = typeof option === 'string' ? { onError: option } : { onError: 'fail', ...option };\n return new BaseConverter((from: unknown, __self: Converter<Map<TK, T>, TC>, context?: TC) => {\n if (typeof from !== 'object' \|\| from === null \|\| Array.isArray(from)) {\n return fail(`Not a string-keyed object: ${JSON.stringify(from)}`);\n }\n\n const map = new Map<TK, T>();\n const errors: string[] = [];\n\n for (const key in from) {\n if (isKeyOf(key, from)) {\n const writeKeyResult = options.keyConverter?.convert(key, context) ?? succeed(key);\n\n writeKeyResult\n .onSuccess((writeKey) => {\n return converter.convert(from[key] as unknown, context).onSuccess((value) => {\n map.set(writeKey, value);\n return succeed(true);\n });\n })\n .onFailure((message) => {\n errors.push(message);\n return fail(message);\n });\n }\n }\n\n return errors.length === 0 \|\| options.onError === 'ignore' ? succeed(map) : fail(errors.join('\\n'));\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which validates that a supplied value is\n * of a type validated by a supplied validator function and returns it.\n * @remarks\n * If `validator` succeeds, this {@link Converter \| Converter} returns {@link Success \| Success} with the supplied\n * value of `from` coerced to type `<T>`. Returns a {@link Failure \| Failure} with additional\n * information otherwise.\n * @param validator - A validator function to determine if the converted value is valid.\n * @param description - A description of the validated type for use in error messages.\n * @returns A new {@link Converter \| Converter<T>} which applies the supplied validation.\n * @public\n /\nexport function validateWith<T, TC = undefined>(\n validator: (from: unknown) => from is T,\n description?: string\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T, TC>, __context?: TC) => {\n if (validator(from)) {\n return succeed(from);\n }\n return fail(`${JSON.stringify(from)}: invalid ${description ?? 'value'}`);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and converts an element from an array.\n * @remarks\n * The returned {@link Converter \| Converter} returns {@link Success \| Success} with the converted value if the element exists\n * in the supplied array and can be converted. Returns {@link Failure \| Failure} with an error message otherwise.\n * @param index - The index of the element to be extracted.\n * @param converter - A {@link Converter \| Converter} or {@link Validator \| Validator} for the extracted element.\n * @returns A {@link Converter \| Converter<T>} which extracts the specified element from an array.\n * @public\n /\nexport function element<T, TC = undefined>(\n index: number,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T, TC>, context?: TC) => {\n if (index < 0) {\n return fail(`${index}: cannot convert for a negative element index`);\n } else if (!Array.isArray(from)) {\n return fail('element converter: source is not an array');\n } else if (index >= from.length) {\n return fail(`${index}: element converter index out of range (0..${from.length - 1})`);\n }\n return converter.convert(from[index], context);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and converts an optional element from an array.\n * @remarks\n * The resulting {@link Converter \| Converter} returns {@link Success \| Success} with the converted value if the element exists\n * in the supplied array and can be converted. Returns {@link Success \| Success} with value `undefined` if the parameter\n * is an array but the index is out of range. Returns {@link Failure \| Failure} with a message if the supplied parameter\n * is not an array, if the requested index is negative, or if the element cannot be converted.\n * @param index - The index of the element to be extracted.\n * @param converter - A {@link Converter \| Converter} or {@link Validator \| Validator} used for the extracted element.\n * @returns A {@link Converter \| Converter<T>} which extracts the specified element from an array.\n * @public\n /\nexport function optionalElement<T, TC = undefined>(\n index: number,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T \| undefined, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T \| undefined, TC>, context?: TC) => {\n if (index < 0) {\n return fail(`${index}: cannot convert for a negative element index`);\n } else if (!Array.isArray(from)) {\n return fail('element converter: source is not an array');\n } else if (index >= from.length) {\n return succeed(undefined);\n }\n return converter.convert(from[index], context);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and convert a property specified\n * by name from an object.\n * @remarks\n * The resulting {@link Converter \| Converter} returns {@link Success \| Success} with the converted value of the corresponding\n * object property if the field exists and can be converted. Returns {@link Failure \| Failure} with an error message\n * otherwise.\n * @param name - The name of the field to be extracted.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} to use for the extracted\n * field.\n * @public\n /\nexport function field<T, TC = undefined>(\n name: string,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T, TC>, context?: TC) => {\n if (typeof from === 'object' && !Array.isArray(from) && from !== null) {\n if (isKeyOf(name, from)) {\n return converter.convert(from[name], context).onFailure((message) => {\n return fail(`Field ${name}: ${message}`);\n });\n }\n return fail(`Field ${name} not found in: ${JSON.stringify(from)}`);\n }\n return fail(`Cannot convert field \"${name}\" from non-object ${JSON.stringify(from)}`);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and convert a property specified\n * by name from an object.\n * @remarks\n * The resulting {@link Converter \| Converter} returns {@link Success \| Success} with the converted value of\n * the corresponding object property if the field exists and can be converted. Returns {@link Success \| Success}\n * with `undefined` if the supplied parameter is an object but the named field is not present.\n * Returns {@link Failure \| Failure} with an error message otherwise.\n * @param name - The name of the field to be extracted.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} to use for the extracted field.\n * @public\n /\nexport function optionalField<T, TC = undefined>(\n name: string,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T \| undefined, TC> {\n return new BaseConverter(\n (from: unknown, __self: Converter<T \| undefined, TC>, context?: TC) => {\n if (typeof from === 'object' && !Array.isArray(from) && from !== null) {\n if (isKeyOf(name, from)) {\n const result = converter.convert(from[name], context).onFailure((message) => {\n return fail(`${name}: ${message}`);\n });\n\n // if conversion was successful or input was undefined we\n // succeed with 'undefined', but we propagate actual\n // failures.\n if (result.isSuccess() \|\| from[name] !== undefined) {\n return result;\n }\n }\n return succeed(undefined);\n }\n return fail(`Cannot convert field \"${name}\" from non-object ${JSON.stringify(from)}`);\n },\n undefined,\n { isOptional: true }\n );\n}\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter<T>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters \| FieldConverters<T>} and an optional\n * {@link Conversion.ObjectConverterOptions \| ObjectConverterOptions<T>} to further refine conversion behavior.\n * @remarks\n * By default, if all of the requested fields exist and can be converted, returns {@link Success \| Success}\n * with a new object that contains the converted values under the original key names. If any required properties\n * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure \| Failure} with additional\n * error information.\n \n Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n * @param properties - An {@link Conversion.FieldConverters \| FieldConverters<T>} defining the shape of the\n * source object and {@link Converter \| converters} to be applied to each properties.\n * @param options - An {@link Conversion.ObjectConverterOptions \| ObjectConverterOptions<T>} containing options\n * for the object converter.\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function object<T>(\n properties: FieldConverters<T>,\n options?: ObjectConverterOptions<T>\n): ObjectConverter<T>;\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter<T>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters \| FieldConverters<T>} and a set of\n * optional properties.\n * @remarks\n * By default, if all of the requested fields exist and can be converted, returns {@link Success \| Success}\n * with a new object that contains the converted values under the original key names. If any required properties\n * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure \| Failure} with additional\n * error information.\n \n Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n * @param properties - An {@link Conversion.FieldConverters \| FieldConverters<T>} defining the shape of the\n * source object and {@link Converter \| converters} to be applied to each properties.\n * @param optional - An array of `(keyof T)` listing the keys to be considered optional.\n * {@label WITH_KEYS}\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * @public\n * @deprecated Use {@link Converters.(object:1) \| Converters.object(fields, options)} instead.\n /\n\nexport function object<T>(properties: FieldConverters<T>, optional: (keyof T)[]): ObjectConverter<T>;\n/\n Concrete implementation of {@link Converters.(object:1) \| Converters.object(fields, options)}\n * and {@link Converters.(object:2) \| Converters.objects(fields, optionalKeys)}.\n * @internal\n /\nexport function object<T>(\n properties: FieldConverters<T>,\n options?: (keyof T)[] \| ObjectConverterOptions<T>\n): ObjectConverter<T> {\n return new ObjectConverter(properties, options as ObjectConverterOptions<T>);\n}\n\n/\n Options for the {@link Converters.(strictObject:1)} helper function.\n * @public\n /\nexport type StrictObjectConverterOptions<T> = Omit<ObjectConverterOptions<T>, 'strict'>;\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter} which converts an object\n * without changing shape, a {@link Conversion.FieldConverters \| FieldConverters<T>} and an optional\n * {@link Converters.StrictObjectConverterOptions \| StrictObjectConverterOptions<T>} to further refine\n * conversion behavior.\n \n @remarks\n * Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n \n The conversion fails if any unexpected fields are encountered.\n \n @param properties - An object containing defining the shape and converters to be applied.\n * @param options - An optional @see StrictObjectConverterOptions<T> containing options for the object converter.\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function strictObject<T>(\n properties: FieldConverters<T>,\n options?: StrictObjectConverterOptions<T>\n): ObjectConverter<T>;\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter} which converts an object\n * without changing shape, a {@link Conversion.FieldConverters \| FieldConverters<T>} and an optional\n * {@link Converters.StrictObjectConverterOptions \| StrictObjectConverterOptions<T>} to further refine\n * conversion behavior.\n \n @remarks\n * Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n \n The conversion fails if any unexpected fields are encountered.\n \n @param properties - An object containing defining the shape and converters to be applied.\n * @param optional - An array of `keyof T` containing keys to be considered optional.\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * {@label WITH_KEYS}\n * @deprecated Use {@link Converters.(strictObject:1) \| Converters.strictObject(options)} instead.\n * @public\n /\nexport function strictObject<T>(properties: FieldConverters<T>, optional: (keyof T)[]): ObjectConverter<T>;\n\n/\n Concrete implementation for {@link Converters.(strictObject:1) \| Converters.strictObject(fields, options)}\n * and {@link Converters.strictObject \| Converters.strictObject(fields, optional)}.\n * @internal\n /\nexport function strictObject<T>(\n properties: FieldConverters<T>,\n opt?: (keyof T)[] \| StrictObjectConverterOptions<T>\n): ObjectConverter<T> {\n const options: ObjectConverterOptions<T> =\n opt && Array.isArray(opt) ? { strict: true, optionalFields: opt } : { ...(opt ?? {}), strict: true };\n return new ObjectConverter(properties, options);\n}\n\n/\n A string-keyed `Record<string, Converter>` which maps specific {@link Converter \| converters} or\n * {@link Validator \| Validators} to the value of a discriminator property.\n * @public\n /\nexport type DiscriminatedObjectConverters<T, TD extends string = string, TC = unknown> = Record<\n TD,\n Converter<T, TC> \| Validator<T, TC>\n>;\n\n/\n Helper to create a {@link Converter \| Converter} which converts a discriminated object without changing shape.\n * @remarks\n * Takes the name of the discriminator property and a\n * {@link Converters.DiscriminatedObjectConverters \| string-keyed Record of converters and validators}. During conversion,\n * the resulting {@link Converter \| Converter} invokes the converter from `converters` that corresponds to the value of\n * the discriminator property in the source object.\n \n If the source is not an object, the discriminator property is missing, or the discriminator has\n * a value not present in the converters, conversion fails and returns {@link Failure \| Failure} with more information.\n * @param discriminatorProp - Name of the property used to discriminate types.\n * @param converters - {@link Converters.DiscriminatedObjectConverters \| String-keyed record of converters and validators}\n * to invoke, where each key corresponds to a value of the discriminator property.\n * @returns A {@link Converter \| Converter} which converts the corresponding discriminated object.\n * @public\n /\nexport function discriminatedObject<T, TD extends string = string, TC = unknown>(\n discriminatorProp: string,\n converters: DiscriminatedObjectConverters<T, TD>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown) => {\n if (typeof from !== 'object' \|\| Array.isArray(from) \|\| from === null) {\n return fail(`Not a discriminated object: \"${JSON.stringify(from)}\"`);\n }\n if (!isKeyOf(discriminatorProp, from) \|\| !from[discriminatorProp]) {\n return fail(`Discriminator property ${discriminatorProp} not present in \"${JSON.stringify(from)}\"`);\n }\n\n const discriminatorValue = from[discriminatorProp] as TD;\n const converter = converters[discriminatorValue];\n if (converter === undefined) {\n return fail(`No converter for discriminator ${discriminatorProp}=\"${discriminatorValue}\"`);\n }\n return converter.convert(from);\n });\n}\n\n/\n Helper to create a {@link Converter \| Converter} which converts a source object to a new object with a\n * different shape.\n \n @remarks\n * On successful conversion, the resulting {@link Converter \| Converter} returns {@link Success \| Success} with a new\n * object, which contains the converted values under the key names specified at initialization time.\n * It returns {@link Failure \| Failure} with an error message if any fields to be extracted do not exist\n * or cannot be converted.\n \n Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n \n @param properties - An object with key names that correspond to the target object and an\n * appropriate {@link Conversion.FieldConverters \| FieldConverter} which extracts and converts\n * a single filed from the source object.\n * @returns A {@link Converter \| Converter} with the specified conversion behavior.\n * @public\n /\nexport function transform<T, TC = unknown>(properties: FieldConverters<T, TC>): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self, context?: TC) => {\n // eslint bug thinks key is used before defined\n // eslint-disable-next-line no-use-before-define\n const converted = {} as { [key in keyof T]: T[key] };\n const errors: string[] = [];\n\n for (const key in properties) {\n if (properties[key]) {\n const result = properties[key].convert(from, context);\n if (result.isSuccess() && result.value !== undefined) {\n converted[key] = result.value;\n } else if (result.isFailure()) {\n errors.push(result.message);\n }\n }\n }\n\n return errors.length === 0 ? succeed(converted) : fail(errors.join('\\n'));\n });\n}\n\n/\n Per-property converters and configuration for each field in the destination object of\n * a {@link Converters.transformObject} call.\n * @public\n /\nexport type FieldTransformers<TSRC, TDEST, TC = unknown> = {\n [key in keyof TDEST]: {\n /\n The name of the property in the source object to be converted.\n /\n from: keyof TSRC;\n /\n The converter or validator used to convert the property.\n /\n converter: Converter<TDEST[key], TC> \| Validator<TDEST[key], TC>;\n /\n If `true` then a missing source property is ignored. If `false` or omitted\n * then a missing source property causes an error.\n /\n optional?: boolean;\n };\n};\n\n/\n Options for a {@link Converters.transformObject} call.\n * @public\n /\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface TransformObjectOptions<TSRC> {\n /\n If `strict` is `true` then unused properties in the source object cause\n * an error, otherwise they are ignored.\n /\n strict: true;\n\n /\n An optional list of source properties to be ignored when strict mode\n * is enabled.\n /\n ignore?: (keyof TSRC)[];\n\n /\n An optional description of this transform to be used for error messages.\n /\n description?: string;\n}\n\n/\n Helper to create a strongly-typed {@link Converter \| Converter} which converts a source object to a\n * new object with a different shape.\n \n @remarks\n * On successful conversion, the resulting {@link Converter \| Converter} returns {@link Success \| Success} with a new\n * object, which contains the converted values under the key names specified at initialization time.\n \n It returns {@link Failure \| Failure} with an error message if any fields to be extracted do not exist\n * or cannot be converted.\n \n @param destinationFields - An object with key names that correspond to the target object and an\n * appropriate {@link Converters.FieldTransformers \| FieldTransformers} which specifies the name\n * of the corresponding property in the source object, the converter or validator used for each source\n * property and any other configuration to guide the conversion.\n * @param options - Options which affect the transformation.\n \n @returns A {@link Converter \| Converter} with the specified conversion behavior.\n * @public\n */\nexport function transformObject<TSRC, TDEST, TC = unknown>(\n destinationFields: FieldTransformers<TSRC, TDEST, TC>,\n options?: TransformObjectOptions<TSRC>\n): Converter<TDEST, TC> {\n return new BaseConverter((from: unknown, __self, context?: TC) => {\n // eslint bug thinks key is used before defined\n // eslint-disable-next-line no-use-before-define\n const converted = {} as { [key in keyof TDEST]: TDEST[key] };\n const errors: string[] = [];\n const used: Set<keyof TSRC> = new Set(options?.ignore);\n\n if (typeof from === 'object' && !Array.isArray(from) && from !== null) {\n for (const destinationKey in destinationFields) {\n if (destinationFields[destinationKey]) {\n const srcKey = destinationFields[destinationKey].from;\n const converter = destinationFields[destinationKey].converter;\n\n if (isKeyOf(srcKey, from)) {\n const result = converter.convert(from[srcKey], context);\n if (result.isSuccess() && result.value !== undefined) {\n converted[destinationKey] = result.value;\n } else if (result.isFailure()) {\n errors.push(`${srcKey}->${destinationKey}: ${result.message}`);\n }\n used.add(srcKey);\n } else if (destinationFields[destinationKey].optional !== true) {\n errors.push(`${String(srcKey)}: required property missing in source object.`);\n }\n }\n }\n\n if (options?.strict === true) {\n for (const key in from) {\n if (isKeyOf(key, from) && !used.has(key as keyof TSRC)) {\n errors.push(`${key}: unexpected property in source object`);\n }\n }\n }\n } else {\n errors.push('source is not an object');\n }\n\n return errors.length === 0\n ? succeed(converted)\n : fail(options?.description ? `${options.description}:\\n ${errors.join('\\n ')}` : errors.join('\\n'));\n });\n}\n"]}
1	+ {"version":3,"file":"converters.js","sourceRoot":"","sources":["../../../src/packlets/conversion/converters.ts"],"names":[],"mappings":"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","sourcesContent":["/\n Copyright (c) 2020 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, isKeyOf, succeed } from '../base';\nimport { TypeGuardWithContext, Validator } from '../validation';\nimport { BaseConverter } from './baseConverter';\nimport { Converter, OnError } from './converter';\nimport { FieldConverters, ObjectConverter, ObjectConverterOptions } from './objectConverter';\nimport { StringConverter } from './stringConverter';\n\n/\n Action to take on conversion failures (deprecated - use Conversion.OnError)\n * @public\n * @deprecated use Conversion.OnError.\n /\nexport { OnError };\n\n/\n A converter to convert unknown to string. Values of type\n * string succeed. Anything else fails.\n * @public\n /\nexport const string: StringConverter = new StringConverter();\n\n/\n Helper function to create a {@link Converter \| Converter} which converts `unknown` to one of a set of supplied\n * enumerated values. Anything else fails.\n \n @remarks\n * Allowed enumerated values can also be supplied as context at conversion time.\n * @param values - Array of allowed values.\n * @returns A new {@link Converter \| Converter} returning `<T>`.\n * @public\n /\nexport function enumeratedValue<T>(values: T[]): Converter<T, T[]> {\n return new BaseConverter((from: unknown, __self: Converter<T, T[]>, context?: T[]): Result<T> => {\n const v = context ?? values;\n const index = v.indexOf(from as T);\n return index >= 0 ? succeed(v[index]) : fail(`Invalid enumerated value ${JSON.stringify(from)}`);\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which converts `unknown` to one of a set of supplied enumerated\n * values, mapping any of multiple supplied values to the enumeration.\n * @remarks\n * Enables mapping of multiple input values to a consistent internal representation (so e.g. `'y'`, `'yes'`,\n * `'true'`, `1` and `true` can all map to boolean `true`)\n * @param map - An array of tuples describing the mapping. The first element of each tuple is the result\n * value, the second is the set of values that map to the result. Tuples are evaluated in the order\n * supplied and are not checked for duplicates.\n * @param message - An optional error message.\n * @returns A {@link Converter \| Converter} which applies the mapping and yields `<T>` on success.\n * @public\n /\nexport function mappedEnumeratedValue<T>(map: [T, unknown[]][], message?: string): Converter<T, undefined> {\n return new BaseConverter((from: unknown, __self: Converter<T, undefined>, __context?: unknown) => {\n for (const item of map) {\n if (item[1].includes(from)) {\n return succeed(item[0]);\n }\n }\n return fail(\n message\n ? `${JSON.stringify(from)}: ${message}`\n : `Cannot map '${JSON.stringify(from)}' to a supported value`\n );\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which converts `unknown` to some supplied literal value. Succeeds with\n * the supplied value if an identity comparison succeeds, fails otherwise.\n * @param value - The value to be compared.\n * @returns A {@link Converter \| Converter} which returns the supplied value on success.\n * @public\n /\nexport function literal<T>(value: T): Converter<T, unknown> {\n return new BaseConverter<T, unknown>(\n (from: unknown, __self: Converter<T, unknown>, __context?: unknown): Result<T> => {\n return from === value\n ? succeed(value)\n : fail(`${JSON.stringify(from)}: does not match ${JSON.stringify(value)}`);\n }\n );\n}\n\n/\n Deprecated alias for @see literal\n * @param value - The value to be compared.\n * @deprecated Use {@link Converters.literal} instead.\n * @internal\n /\n// eslint-disable-next-line @rushstack/typedef-var\nexport const value = literal;\n\n/\n A {@link Converter \| Converter} which converts `unknown` to a `number`.\n * @remarks\n * Numbers and strings with a numeric format succeed. Anything else fails.\n * @public\n /\nexport const number: Converter<number, undefined> = new BaseConverter<number>((from: unknown) => {\n if (typeof from !== 'number') {\n const num: number = typeof from === 'string' ? Number(from) : NaN;\n return isNaN(num) ? fail(`Not a number: ${JSON.stringify(from)}`) : succeed(num);\n }\n return succeed(from);\n});\n\n/\n A {@link Converter \| Converter} which converts `unknown` to `boolean`.\n * @remarks\n * Boolean values or the case-insensitive strings `'true'` and `'false'` succeed.\n * Anything else fails.\n * @public\n /\nexport const boolean: Converter<boolean, undefined> = new BaseConverter<boolean>((from: unknown) => {\n if (typeof from === 'boolean') {\n return succeed(from as boolean);\n } else if (typeof from === 'string') {\n switch (from.toLowerCase()) {\n case 'true':\n return succeed(true);\n case 'false':\n return succeed(false);\n }\n }\n return fail(`Not a boolean: ${JSON.stringify(from)}`);\n});\n\n/\n A {@link Converter \| Converter} which converts an optional `string` value. Values of type\n * `string` are returned. Anything else returns {@link Success \| Success} with value `undefined`.\n * @public\n /\nexport const optionalString: Converter<string \| undefined, unknown> = string.optional();\n\n/\n Helper function to create a {@link Converter \| Converter} which converts any `string` into an\n * array of `string`, by separating at a supplied delimiter.\n * @remarks\n * Delimiter may also be supplied as context at conversion time.\n * @param delimiter - The delimiter at which to split.\n * @returns A new {@link Converter \| Converter} returning `string[]`.\n * @public\n /\nexport function delimitedString(\n delimiter: string,\n options: 'filtered' \| 'all' = 'filtered'\n): Converter<string[], string> {\n return new BaseConverter<string[], string>(\n (from: unknown, __self: Converter<string[], string>, context?: string) => {\n const result = string.convert(from);\n if (result.isSuccess()) {\n let strings = result.value.split(context ?? delimiter);\n if (options !== 'all') {\n strings = strings.filter((s) => s.trim().length > 0);\n }\n return succeed(strings);\n }\n return fail(result.message);\n }\n );\n}\n\n/\n Helper function to create a {@link Converter \| Converter} from any {@link Validation.Validator}\n * @param validator - the validator to be wrapped\n * @returns A {@link Converter \| Converter} which uses the supplied validator.\n * @public\n /\nexport function validated<T, TC = unknown>(validator: Validator<T, TC>): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self?: Converter<T, TC>, context?: TC) => {\n return validator.validate(from, context);\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} from a supplied type guard function.\n * @param description - a description of the thing to be validated for use in error messages\n * @param guard - a {@link Validation.TypeGuardWithContext} which performs the validation.\n * @returns A new {@link Converter \| Converter} which validates the values using the supplied type guard\n * and returns them in place.\n * @public\n /\nexport function isA<T, TC = unknown>(\n description: string,\n guard: TypeGuardWithContext<T, TC>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self?: Converter<T, TC>, context?: TC) => {\n if (guard(from, context)) {\n return succeed(from);\n }\n return fail(`invalid ${description} (${JSON.stringify(from)})`);\n });\n}\n\n/\n A {@link Converter \| Converter} which converts an optional `number` value.\n * @remarks\n * Values of type `number` or numeric strings are converted and returned.\n * Anything else returns {@link Success \| Success} with value `undefined`.\n * @public\n /\nexport const optionalNumber: Converter<number \| undefined> = number.optional();\n\n/\n A {@link Converter \| Converter} to convert an optional `boolean` value.\n * @remarks\n * Values of type `boolean` or strings that match (case-insensitive) `'true'`\n * or `'false'` are converted and returned. Anything else returns {@link Success \| Success}\n * with value `undefined`.\n * @public\n /\nexport const optionalBoolean: Converter<boolean \| undefined> = boolean.optional();\n\n/\n A helper function to create a {@link Converter \| Converter} for polymorphic values.\n * Returns a converter which invokes the wrapped converters in sequence, returning the\n * first successful result. Returns an error if none of the supplied converters can\n * convert the value.\n * @remarks\n * If `onError` is `ignoreErrors` (default), then errors from any of the\n * converters are ignored provided that some converter succeeds. If\n * onError is `failOnError`, then an error from any converter fails the entire\n * conversion.\n \n @param converters - An ordered list of {@link Converter \| converters} or {@link Validator \| validators}\n * to be considered.\n * @param onError - Specifies treatment of unconvertible elements.\n * @returns A new {@link Converter \| Converter} which yields a value from the union of the types returned\n * by the wrapped converters.\n * @public\n /\nexport function oneOf<T, TC = unknown>(\n converters: Array<Converter<T, TC> \| Validator<T, TC>>,\n onError: OnError = 'ignoreErrors'\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self, context?: TC) => {\n const errors: string[] = [];\n for (const converter of converters) {\n const result = converter.convert(from, context);\n if (result.isSuccess() && result.value !== undefined) {\n return result;\n }\n\n if (result.isFailure()) {\n if (onError === 'failOnError') {\n return result;\n }\n errors.push(result.message);\n }\n }\n return fail(`No matching converter for ${JSON.stringify(from)}: ${errors.join('\\n')}`);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which converts `unknown` to an array of `<T>`.\n * @remarks\n * If `onError` is `'failOnError'` (default), then the entire conversion fails if any element cannot\n * be converted. If `onError` is `'ignoreErrors'`, then failing elements are silently ignored.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used to convert each\n * item in the array.\n * @param ignoreErrors - Specifies treatment of unconvertible elements.\n * @returns A {@link Converter \| Converter} which returns an array of `<T>`.\n * @public\n /\nexport function arrayOf<T, TC = undefined>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n onError: OnError = 'failOnError'\n): Converter<T[], TC> {\n return new BaseConverter((from: unknown, __self: Converter<T[], TC>, context?: TC) => {\n if (!Array.isArray(from)) {\n return fail(`Not an array: ${JSON.stringify(from)}`);\n }\n\n const successes: T[] = [];\n const errors: string[] = [];\n for (const item of from) {\n const result = converter.convert(item, context);\n if (result.isSuccess() && result.value !== undefined) {\n successes.push(result.value);\n } else if (result.isFailure()) {\n errors.push(result.message);\n }\n }\n\n return errors.length === 0 \|\| onError === 'ignoreErrors' ? succeed(successes) : fail(errors.join('\\n'));\n });\n}\n\n/\n {@link Converter \| Converter} to convert an `unknown` to an array of `string`.\n * @remarks\n * Returns {@link Success \| Success} with the the supplied value if it as an array\n * of strings, returns {@link Failure \| Failure} with an error message otherwise.\n * @public\n /\nexport const stringArray: Converter<string[]> = arrayOf(string);\n\n/\n {@link Converter \| Converter} to convert an `unknown` to an array of `number`.\n * @remarks\n * Returns {@link Success \| Success} with the the supplied value if it as an array\n * of numbers, returns {@link Failure \| Failure} with an error message otherwise.\n * @public\n /\nexport const numberArray: Converter<number[]> = arrayOf(number);\n\n/\n Options for {@link Converters.(recordOf:3) \| Converters.recordOf} and\n * {@link Converters.(mapOf:3) \| Converters.mapOf}\n * helper functions.\n * @public\n /\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface KeyedConverterOptions<T extends string = string, TC = undefined> {\n /\n if `onError` is `'fail'` (default), then the entire conversion fails if any key or element\n * cannot be converted. If `onError` is `'ignore'`, failing elements are silently ignored.\n /\n onError?: 'fail' \| 'ignore';\n /\n If present, `keyConverter` is used to convert the source object property names to\n * keys in the resulting map or record.\n * @remarks\n * Can be used to coerce key names to supported values and/or strong types.\n /\n keyConverter?: Converter<T, TC> \| Validator<T, TC>;\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed\n * properties using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to\n * produce a `Record<string, T>`.\n * @remarks\n * The resulting converter fails conversion if any element cannot be converted.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for each\n * item in the source object.\n * @returns A {@link Converter \| Converter} which returns `Record<string, T>`.\n * {@label WITH_DEFAULT}\n * @public\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<Record<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Record<string, T>` and optionally specified handling of elements that cannot be converted.\n * @remarks\n * if `onError` is `'fail'` (default), then the entire conversion fails if any key or element\n * cannot be converted. If `onError` is `'ignore'`, failing elements are silently ignored.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} for each item in\n * the source object.\n * @returns A {@link Converter \| Converter} which returns `Record<string, T>`.\n * {@label WITH_ON_ERROR}\n * @public\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n onError: 'fail' \| 'ignore'\n): Converter<Record<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} or which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Record<TK, T>`.\n * @remarks\n * If present, the supplied {@link Converters.KeyedConverterOptions \| options} can provide a strongly-typed\n * converter for keys and/or control the handling of elements that fail conversion.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for each item in the source object.\n * @param options - Optional {@link Converters.KeyedConverterOptions \| KeyedConverterOptions<TK, TC>} which\n * supplies a key converter and/or error-handling options.\n * @returns A {@link Converter \| Converter} which returns `Record<TK, T>`.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n options: KeyedConverterOptions<TK, TC>\n): Converter<Record<TK, T>, TC>;\n\n/\n Concrete implementation of {@link Converters.(recordOf:1) \| Converters.recordOf(Converter<T>)},\n * {@link Converters.(recordOf:2) \| Converters.recordOf(Converter<T>, 'fail' or 'ignore')}, and\n * {@link Converters.(recordOf:3) \| Converters.recordOf(Converter<T>, KeyedConverterOptions)}.\n * @internal\n /\nexport function recordOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n option: 'fail' \| 'ignore' \| KeyedConverterOptions<TK, TC> = 'fail'\n): Converter<Record<TK, T>, TC> {\n const options: KeyedConverterOptions<TK, TC> =\n typeof option === 'string' ? { onError: option } : { onError: 'fail', ...option };\n return new BaseConverter((from: unknown, __self: Converter<Record<TK, T>, TC>, context?: TC) => {\n if (typeof from !== 'object' \|\| from === null \|\| Array.isArray(from)) {\n return fail(`Not a string-keyed object: ${JSON.stringify(from)}`);\n }\n\n const record: Record<string, T> = {};\n const errors: string[] = [];\n\n for (const key in from) {\n if (isKeyOf(key, from)) {\n const writeKeyResult = options.keyConverter?.convert(key, context) ?? succeed(key);\n\n writeKeyResult\n .onSuccess((writeKey) => {\n return converter.convert(from[key] as unknown, context).onSuccess((value) => {\n record[writeKey] = value;\n return succeed(true);\n });\n })\n .onFailure((message) => {\n errors.push(message);\n return fail(message);\n });\n }\n }\n\n return errors.length === 0 \|\| options.onError === 'ignore' ? succeed(record) : fail(errors.join('\\n'));\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Map<string, T>`.\n * @remarks\n * The resulting converter fails conversion if any element cannot be converted.\n * @param converter - {@link Converter \| Converter} \| {@link Validator \| Validator} used for each item in\n * the source object.\n * @returns A {@link Converter \| Converter} which returns `Map<string, T>`.\n * {@label WITH_DEFAULT}\n * @public\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<Map<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce a\n * `Map<string, T>` and specified handling of elements that cannot be converted.\n * @remarks\n * if `onError` is `'fail'` (default), then the entire conversion fails if any key or element\n * cannot be converted. If `onError` is `'ignore'`, failing elements are silently ignored.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for\n * each item in the source object.\n * @returns A {@link Converter \| Converter} which returns `Map<string, T>`.\n * {@label WITH_ON_ERROR}\n * @public\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n onError: 'fail' \| 'ignore'\n): Converter<Map<TK, T>, TC>;\n\n/\n A helper function to create a {@link Converter \| Converter} which converts the `string`-keyed properties\n * using a supplied {@link Converter \| Converter<T>} or {@link Validator \| Validator<T>} to produce\n * a `Map<TK,T>`.\n * @remarks\n * If present, the supplied {@link Converters.KeyedConverterOptions \| options} can provide a strongly-typed\n * converter for keys and/or control the handling of elements that fail conversion.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} used for each item\n * in the source object.\n * @param options - Optional {@link Converters.KeyedConverterOptions \| KeyedConverterOptions<TK, TC>} which\n * supplies a key converter and/or error-handling options.\n * @returns A {@link Converter \| Converter} which returns `Map<TK,T>`.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n options: KeyedConverterOptions<TK, TC>\n): Converter<Map<TK, T>, TC>;\n\n/\n Concrete implementation of {@link Converters.(mapOf:1) \| Converters.mapOf(Converter<T>)},\n * {@link Converters.(mapOf:2) \| Converters.mapOf(Converter<T>, 'fail' or 'ignore')}, and\n * {@link Converters.(mapOf:3) \| Converters.mapOf(Converter<T>, KeyedConverterOptions)}.\n * @internal\n /\nexport function mapOf<T, TC = undefined, TK extends string = string>(\n converter: Converter<T, TC> \| Validator<T, TC>,\n option: 'fail' \| 'ignore' \| KeyedConverterOptions<TK, TC> = 'fail'\n): Converter<Map<TK, T>, TC> {\n const options = typeof option === 'string' ? { onError: option } : { onError: 'fail', ...option };\n return new BaseConverter((from: unknown, __self: Converter<Map<TK, T>, TC>, context?: TC) => {\n if (typeof from !== 'object' \|\| from === null \|\| Array.isArray(from)) {\n return fail(`Not a string-keyed object: ${JSON.stringify(from)}`);\n }\n\n const map = new Map<TK, T>();\n const errors: string[] = [];\n\n for (const key in from) {\n if (isKeyOf(key, from)) {\n const writeKeyResult = options.keyConverter?.convert(key, context) ?? succeed(key);\n\n writeKeyResult\n .onSuccess((writeKey) => {\n return converter.convert(from[key] as unknown, context).onSuccess((value) => {\n map.set(writeKey, value);\n return succeed(true);\n });\n })\n .onFailure((message) => {\n errors.push(message);\n return fail(message);\n });\n }\n }\n\n return errors.length === 0 \|\| options.onError === 'ignore' ? succeed(map) : fail(errors.join('\\n'));\n });\n}\n\n/\n Helper function to create a {@link Converter \| Converter} which validates that a supplied value is\n * of a type validated by a supplied validator function and returns it.\n * @remarks\n * If `validator` succeeds, this {@link Converter \| Converter} returns {@link Success \| Success} with the supplied\n * value of `from` coerced to type `<T>`. Returns a {@link Failure \| Failure} with additional\n * information otherwise.\n * @param validator - A validator function to determine if the converted value is valid.\n * @param description - A description of the validated type for use in error messages.\n * @returns A new {@link Converter \| Converter<T>} which applies the supplied validation.\n * @public\n /\nexport function validateWith<T, TC = undefined>(\n validator: (from: unknown) => from is T,\n description?: string\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T, TC>, __context?: TC) => {\n if (validator(from)) {\n return succeed(from);\n }\n return fail(`${JSON.stringify(from)}: invalid ${description ?? 'value'}`);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and converts an element from an array.\n * @remarks\n * The returned {@link Converter \| Converter} returns {@link Success \| Success} with the converted value if the element exists\n * in the supplied array and can be converted. Returns {@link Failure \| Failure} with an error message otherwise.\n * @param index - The index of the element to be extracted.\n * @param converter - A {@link Converter \| Converter} or {@link Validator \| Validator} for the extracted element.\n * @returns A {@link Converter \| Converter<T>} which extracts the specified element from an array.\n * @public\n /\nexport function element<T, TC = undefined>(\n index: number,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T, TC>, context?: TC) => {\n if (index < 0) {\n return fail(`${index}: cannot convert for a negative element index`);\n } else if (!Array.isArray(from)) {\n return fail('element converter: source is not an array');\n } else if (index >= from.length) {\n return fail(`${index}: element converter index out of range (0..${from.length - 1})`);\n }\n return converter.convert(from[index], context);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and converts an optional element from an array.\n * @remarks\n * The resulting {@link Converter \| Converter} returns {@link Success \| Success} with the converted value if the element exists\n * in the supplied array and can be converted. Returns {@link Success \| Success} with value `undefined` if the parameter\n * is an array but the index is out of range. Returns {@link Failure \| Failure} with a message if the supplied parameter\n * is not an array, if the requested index is negative, or if the element cannot be converted.\n * @param index - The index of the element to be extracted.\n * @param converter - A {@link Converter \| Converter} or {@link Validator \| Validator} used for the extracted element.\n * @returns A {@link Converter \| Converter<T>} which extracts the specified element from an array.\n * @public\n /\nexport function optionalElement<T, TC = undefined>(\n index: number,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T \| undefined, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T \| undefined, TC>, context?: TC) => {\n if (index < 0) {\n return fail(`${index}: cannot convert for a negative element index`);\n } else if (!Array.isArray(from)) {\n return fail('element converter: source is not an array');\n } else if (index >= from.length) {\n return succeed(undefined);\n }\n return converter.convert(from[index], context);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and convert a property specified\n * by name from an object.\n * @remarks\n * The resulting {@link Converter \| Converter} returns {@link Success \| Success} with the converted value of the corresponding\n * object property if the field exists and can be converted. Returns {@link Failure \| Failure} with an error message\n * otherwise.\n * @param name - The name of the field to be extracted.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} to use for the extracted\n * field.\n * @public\n /\nexport function field<T, TC = undefined>(\n name: string,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self: Converter<T, TC>, context?: TC) => {\n if (typeof from === 'object' && !Array.isArray(from) && from !== null) {\n if (isKeyOf(name, from)) {\n return converter.convert(from[name], context).onFailure((message) => {\n return fail(`Field ${name}: ${message}`);\n });\n }\n return fail(`Field ${name} not found in: ${JSON.stringify(from)}`);\n }\n return fail(`Cannot convert field \"${name}\" from non-object ${JSON.stringify(from)}`);\n });\n}\n\n/\n A helper function to create a {@link Converter \| Converter} which extracts and convert a property specified\n * by name from an object.\n * @remarks\n * The resulting {@link Converter \| Converter} returns {@link Success \| Success} with the converted value of\n * the corresponding object property if the field exists and can be converted. Returns {@link Success \| Success}\n * with `undefined` if the supplied parameter is an object but the named field is not present.\n * Returns {@link Failure \| Failure} with an error message otherwise.\n * @param name - The name of the field to be extracted.\n * @param converter - {@link Converter \| Converter} or {@link Validator \| Validator} to use for the extracted field.\n * @public\n /\nexport function optionalField<T, TC = undefined>(\n name: string,\n converter: Converter<T, TC> \| Validator<T, TC>\n): Converter<T \| undefined, TC> {\n return new BaseConverter(\n (from: unknown, __self: Converter<T \| undefined, TC>, context?: TC) => {\n if (typeof from === 'object' && !Array.isArray(from) && from !== null) {\n if (isKeyOf(name, from)) {\n const result = converter.convert(from[name], context).onFailure((message) => {\n return fail(`${name}: ${message}`);\n });\n\n // if conversion was successful or input was undefined we\n // succeed with 'undefined', but we propagate actual\n // failures.\n if (result.isSuccess() \|\| from[name] !== undefined) {\n return result;\n }\n }\n return succeed(undefined);\n }\n return fail(`Cannot convert field \"${name}\" from non-object ${JSON.stringify(from)}`);\n },\n undefined,\n { isOptional: true }\n );\n}\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter<T>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters \| FieldConverters<T>} and an optional\n * {@link Conversion.ObjectConverterOptions \| ObjectConverterOptions<T>} to further refine conversion behavior.\n * @remarks\n * By default, if all of the requested fields exist and can be converted, returns {@link Success \| Success}\n * with a new object that contains the converted values under the original key names. If any required properties\n * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure \| Failure} with additional\n * error information.\n \n Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n * @param properties - An {@link Conversion.FieldConverters \| FieldConverters<T>} defining the shape of the\n * source object and {@link Converter \| converters} to be applied to each properties.\n * @param options - An {@link Conversion.ObjectConverterOptions \| ObjectConverterOptions<T>} containing options\n * for the object converter.\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function object<T>(\n properties: FieldConverters<T>,\n options?: ObjectConverterOptions<T>\n): ObjectConverter<T>;\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter<T>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters \| FieldConverters<T>} and a set of\n * optional properties.\n * @remarks\n * By default, if all of the requested fields exist and can be converted, returns {@link Success \| Success}\n * with a new object that contains the converted values under the original key names. If any required properties\n * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure \| Failure} with additional\n * error information.\n \n Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n * @param properties - An {@link Conversion.FieldConverters \| FieldConverters<T>} defining the shape of the\n * source object and {@link Converter \| converters} to be applied to each properties.\n * @param optional - An array of `(keyof T)` listing the keys to be considered optional.\n * {@label WITH_KEYS}\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * @public\n * @deprecated Use {@link Converters.(object:1) \| Converters.object(fields, options)} instead.\n /\n\nexport function object<T>(properties: FieldConverters<T>, optional: (keyof T)[]): ObjectConverter<T>;\n/\n Concrete implementation of {@link Converters.(object:1) \| Converters.object(fields, options)}\n * and {@link Converters.(object:2) \| Converters.objects(fields, optionalKeys)}.\n * @internal\n /\nexport function object<T>(\n properties: FieldConverters<T>,\n options?: (keyof T)[] \| ObjectConverterOptions<T>\n): ObjectConverter<T> {\n return new ObjectConverter(properties, options as ObjectConverterOptions<T>);\n}\n\n/\n Options for the {@link Converters.(strictObject:1)} helper function.\n * @public\n /\nexport type StrictObjectConverterOptions<T> = Omit<ObjectConverterOptions<T>, 'strict'>;\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter} which converts an object\n * without changing shape, a {@link Conversion.FieldConverters \| FieldConverters<T>} and an optional\n * {@link Converters.StrictObjectConverterOptions \| StrictObjectConverterOptions<T>} to further refine\n * conversion behavior.\n \n @remarks\n * Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n \n The conversion fails if any unexpected fields are encountered.\n \n @param properties - An object containing defining the shape and converters to be applied.\n * @param options - An optional @see StrictObjectConverterOptions<T> containing options for the object converter.\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * {@label WITH_OPTIONS}\n * @public\n /\nexport function strictObject<T>(\n properties: FieldConverters<T>,\n options?: StrictObjectConverterOptions<T>\n): ObjectConverter<T>;\n\n/\n Helper function to create a {@link Conversion.ObjectConverter \| ObjectConverter} which converts an object\n * without changing shape, a {@link Conversion.FieldConverters \| FieldConverters<T>} and an optional\n * {@link Converters.StrictObjectConverterOptions \| StrictObjectConverterOptions<T>} to further refine\n * conversion behavior.\n \n @remarks\n * Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n \n The conversion fails if any unexpected fields are encountered.\n \n @param properties - An object containing defining the shape and converters to be applied.\n * @param optional - An array of `keyof T` containing keys to be considered optional.\n * @returns A new {@link Conversion.ObjectConverter \| ObjectConverter} which applies the specified conversions.\n * {@label WITH_KEYS}\n * @deprecated Use {@link Converters.(strictObject:1) \| Converters.strictObject(options)} instead.\n * @public\n /\nexport function strictObject<T>(properties: FieldConverters<T>, optional: (keyof T)[]): ObjectConverter<T>;\n\n/\n Concrete implementation for {@link Converters.(strictObject:1) \| Converters.strictObject(fields, options)}\n * and {@link Converters.strictObject \| Converters.strictObject(fields, optional)}.\n * @internal\n /\nexport function strictObject<T>(\n properties: FieldConverters<T>,\n opt?: (keyof T)[] \| StrictObjectConverterOptions<T>\n): ObjectConverter<T> {\n const options: ObjectConverterOptions<T> =\n opt && Array.isArray(opt) ? { strict: true, optionalFields: opt } : { ...(opt ?? {}), strict: true };\n return new ObjectConverter(properties, options);\n}\n\n/\n A string-keyed `Record<string, Converter>` which maps specific {@link Converter \| converters} or\n * {@link Validator \| Validators} to the value of a discriminator property.\n * @public\n /\nexport type DiscriminatedObjectConverters<T, TD extends string = string, TC = unknown> = Record<\n TD,\n Converter<T, TC> \| Validator<T, TC>\n>;\n\n/\n Helper to create a {@link Converter \| Converter} which converts a discriminated object without changing shape.\n * @remarks\n * Takes the name of the discriminator property and a\n * {@link Converters.DiscriminatedObjectConverters \| string-keyed Record of converters and validators}. During conversion,\n * the resulting {@link Converter \| Converter} invokes the converter from `converters` that corresponds to the value of\n * the discriminator property in the source object.\n \n If the source is not an object, the discriminator property is missing, or the discriminator has\n * a value not present in the converters, conversion fails and returns {@link Failure \| Failure} with more information.\n * @param discriminatorProp - Name of the property used to discriminate types.\n * @param converters - {@link Converters.DiscriminatedObjectConverters \| String-keyed record of converters and validators}\n * to invoke, where each key corresponds to a value of the discriminator property.\n * @returns A {@link Converter \| Converter} which converts the corresponding discriminated object.\n * @public\n /\nexport function discriminatedObject<T, TD extends string = string, TC = unknown>(\n discriminatorProp: string,\n converters: DiscriminatedObjectConverters<T, TD>\n): Converter<T, TC> {\n return new BaseConverter((from: unknown) => {\n if (typeof from !== 'object' \|\| Array.isArray(from) \|\| from === null) {\n return fail(`Not a discriminated object: \"${JSON.stringify(from)}\"`);\n }\n if (!isKeyOf(discriminatorProp, from) \|\| !from[discriminatorProp]) {\n return fail(`Discriminator property ${discriminatorProp} not present in \"${JSON.stringify(from)}\"`);\n }\n\n const discriminatorValue = from[discriminatorProp] as TD;\n const converter = converters[discriminatorValue];\n if (converter === undefined) {\n return fail(`No converter for discriminator ${discriminatorProp}=\"${discriminatorValue}\"`);\n }\n return converter.convert(from);\n });\n}\n\n/\n Helper to create a {@link Converter \| Converter} which converts a source object to a new object with a\n * different shape.\n \n @remarks\n * On successful conversion, the resulting {@link Converter \| Converter} returns {@link Success \| Success} with a new\n * object, which contains the converted values under the key names specified at initialization time.\n * It returns {@link Failure \| Failure} with an error message if any fields to be extracted do not exist\n * or cannot be converted.\n \n Fields that succeed but convert to undefined are omitted from the result object but do not\n * fail the conversion.\n \n @param properties - An object with key names that correspond to the target object and an\n * appropriate {@link Conversion.FieldConverters \| FieldConverter} which extracts and converts\n * a single filed from the source object.\n * @returns A {@link Converter \| Converter} with the specified conversion behavior.\n * @public\n /\nexport function transform<T, TC = unknown>(properties: FieldConverters<T, TC>): Converter<T, TC> {\n return new BaseConverter((from: unknown, __self, context?: TC) => {\n // eslint bug thinks key is used before defined\n // eslint-disable-next-line no-use-before-define\n const converted = {} as { [key in keyof T]: T[key] };\n const errors: string[] = [];\n\n for (const key in properties) {\n if (properties[key]) {\n const result = properties[key].convert(from, context);\n if (result.isSuccess() && result.value !== undefined) {\n converted[key] = result.value;\n } else if (result.isFailure()) {\n errors.push(result.message);\n }\n }\n }\n\n return errors.length === 0 ? succeed(converted) : fail(errors.join('\\n'));\n });\n}\n\n/\n Per-property converters and configuration for each field in the destination object of\n * a {@link Converters.transformObject} call.\n * @public\n /\nexport type FieldTransformers<TSRC, TDEST, TC = unknown> = {\n [key in keyof TDEST]: {\n /\n The name of the property in the source object to be converted.\n /\n from: keyof TSRC;\n /\n The converter or validator used to convert the property.\n /\n converter: Converter<TDEST[key], TC> \| Validator<TDEST[key], TC>;\n /\n If `true` then a missing source property is ignored. If `false` or omitted\n * then a missing source property causes an error.\n /\n optional?: boolean;\n };\n};\n\n/\n Options for a {@link Converters.transformObject} call.\n * @public\n /\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface TransformObjectOptions<TSRC> {\n /\n If `strict` is `true` then unused properties in the source object cause\n * an error, otherwise they are ignored.\n /\n strict: true;\n\n /\n An optional list of source properties to be ignored when strict mode\n * is enabled.\n /\n ignore?: (keyof TSRC)[];\n\n /\n An optional description of this transform to be used for error messages.\n /\n description?: string;\n}\n\n/\n Helper to create a strongly-typed {@link Converter \| Converter} which converts a source object to a\n * new object with a different shape.\n \n @remarks\n * On successful conversion, the resulting {@link Converter \| Converter} returns {@link Success \| Success} with a new\n * object, which contains the converted values under the key names specified at initialization time.\n \n It returns {@link Failure \| Failure} with an error message if any fields to be extracted do not exist\n * or cannot be converted.\n \n @param destinationFields - An object with key names that correspond to the target object and an\n * appropriate {@link Converters.FieldTransformers \| FieldTransformers} which specifies the name\n * of the corresponding property in the source object, the converter or validator used for each source\n * property and any other configuration to guide the conversion.\n * @param options - Options which affect the transformation.\n \n @returns A {@link Converter \| Converter} with the specified conversion behavior.\n * @public\n */\nexport function transformObject<TSRC, TDEST, TC = unknown>(\n destinationFields: FieldTransformers<TSRC, TDEST, TC>,\n options?: TransformObjectOptions<TSRC>\n): Converter<TDEST, TC> {\n return new BaseConverter((from: unknown, __self, context?: TC) => {\n // eslint bug thinks key is used before defined\n // eslint-disable-next-line no-use-before-define\n const converted = {} as { [key in keyof TDEST]: TDEST[key] };\n const errors: string[] = [];\n const used: Set<keyof TSRC> = new Set(options?.ignore);\n\n if (typeof from === 'object' && !Array.isArray(from) && from !== null) {\n for (const destinationKey in destinationFields) {\n if (destinationFields[destinationKey]) {\n const srcKey = destinationFields[destinationKey].from;\n const converter = destinationFields[destinationKey].converter;\n\n if (isKeyOf(srcKey, from)) {\n const result = converter.convert(from[srcKey], context);\n if (result.isSuccess() && result.value !== undefined) {\n converted[destinationKey] = result.value;\n } else if (result.isFailure()) {\n errors.push(`${srcKey}->${destinationKey}: ${result.message}`);\n }\n used.add(srcKey);\n } else if (destinationFields[destinationKey].optional !== true) {\n errors.push(`${String(srcKey)}: required property missing in source object.`);\n }\n }\n }\n\n if (options?.strict === true) {\n for (const key in from) {\n if (isKeyOf(key, from) && !used.has(key as keyof TSRC)) {\n errors.push(`${key}: unexpected property in source object`);\n }\n }\n }\n } else {\n errors.push('source is not an object');\n }\n\n return errors.length === 0\n ? succeed(converted)\n : fail(options?.description ? `${options.description}:\\n ${errors.join('\\n ')}` : errors.join('\\n'));\n });\n}\n"]}

package/lib/packlets/hash/crcNormalizer.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"crcNormalizer.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/crcNormalizer.ts"],"names":[],"mappings":"~~AAuBA~~,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;~~AAExD~~;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;;WAKtC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CAGjD"}
1	+ {"version":3,"file":"crcNormalizer.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/crcNormalizer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAyCxD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;;WAKtC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CAGjD"}

package/lib/packlets/hash/crcNormalizer.js CHANGED Viewed

@@ -22,8 +22,42 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Crc32Normalizer = void 0;
-const crc_1 = require("crc");
 const hashingNormalizer_1 = require("./hashingNormalizer");
+const POLYNOMIAL = 0xedb88320;
+const crc32Table = [];
+function crc32(bytes, crc = 0xffffffff) {
+    if (crc32Table.length === 0) {
+        buildCrc32Table();
+    }
+    for (let i = 0; i < bytes.length; ++i) {
+        // eslint-disable-next-line no-bitwise
+        crc = crc32Table[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ -1) >>> 0;
+}
+const toUInt32 = (n) => {
+    if (n >= 0) {
+        return n;
+    }
+    return 0xffffffff - n * -1 + 1;
+};
+function buildCrc32Table() {
+    if (crc32Table.length === 0) {
+        for (let n = 0; n < 256; n++) {
+            let r = n;
+            for (let i = 0; i < 8; i++) {
+                // eslint-disable-next-line no-bitwise
+                if (r & 1) {
+                    r = (r >>> 1) ^ POLYNOMIAL;
+                }
+                else {
+                    r = r >>> 1;
+                }
+            }
+            crc32Table.push(toUInt32(r));
+        }
+    }
+}
 /**
  * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object
  * hash using the CRC32 algorithm.
@@ -34,7 +68,7 @@ class Crc32Normalizer extends hashingNormalizer_1.HashingNormalizer {
         super(Crc32Normalizer.crc32Hash);
     }
     static crc32Hash(parts) {
-        return String((0, crc_1.crc32)(parts.join('|')));
+        return String(crc32(new TextEncoder().encode(parts.join('|'))));
     }
 }
 exports.Crc32Normalizer = Crc32Normalizer;

package/lib/packlets/hash/crcNormalizer.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"crcNormalizer.js","sourceRoot":"","sources":["../../../src/packlets/hash/crcNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,~~6BAA4B~~;~~AAC5B~~,~~2DAAwD~~;~~AAExD~~;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,qCAAiB;IACpD;QACE,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,KAAe;QACrC,OAAO,MAAM,CAAC,~~IAAA~~,~~WAAK~~,~~EAAC~~,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;~~IACxC~~,CAAC;CACF;AARD,0CAQC","sourcesContent":["/\n Copyright (c) 2023 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 { ~~crc32~~ } from '~~crc~~';\~~nimport~~ { ~~HashingNormalizer~~ } ~~from~~ ~~'./hashingNormalizer'~~;\n\n/\n A {@link Hash.HashingNormalizer \| hashing normalizer} which computes object\n * hash using the CRC32 algorithm.\n * @public\n */\nexport class Crc32Normalizer extends HashingNormalizer {\n public constructor() {\n super(Crc32Normalizer.crc32Hash);\n }\n\n public static crc32Hash(parts: string[]): string {\n return String(crc32(parts.join('\|')));\n }\n}\n"]}
1	+ {"version":3,"file":"crcNormalizer.js","sourceRoot":"","sources":["../../../src/packlets/hash/crcNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,2DAAwD;AAExD,MAAM,UAAU,GAAW,UAAU,CAAC;AAEtC,MAAM,UAAU,GAAa,EAAE,CAAC;AAEhC,SAAS,KAAK,CAAC,KAAiB,EAAE,MAAc,UAAU;IACxD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,eAAe,EAAE,CAAC;IACpB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACtC,sCAAsC;QACtC,GAAG,GAAG,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE;IACrC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,SAAS,eAAe;IACtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,sCAAsC;gBACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACV,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACd,CAAC;YACH,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,qCAAiB;IACpD;QACE,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,KAAe;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;CACF;AARD,0CAQC","sourcesContent":["/\n Copyright (c) 2023 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 { HashingNormalizer } from './hashingNormalizer';\n\nconst POLYNOMIAL: number = 0xedb88320;\n\nconst crc32Table: number[] = [];\n\nfunction crc32(bytes: Uint8Array, crc: number = 0xffffffff): number {\n if (crc32Table.length === 0) {\n buildCrc32Table();\n }\n for (let i = 0; i < bytes.length; ++i) {\n // eslint-disable-next-line no-bitwise\n crc = crc32Table[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);\n }\n return (crc ^ -1) >>> 0;\n}\n\nconst toUInt32 = (n: number): number => {\n if (n >= 0) {\n return n;\n }\n return 0xffffffff - n -1 + 1;\n};\n\nfunction buildCrc32Table(): void {\n if (crc32Table.length === 0) {\n for (let n = 0; n < 256; n++) {\n let r = n;\n for (let i = 0; i < 8; i++) {\n // eslint-disable-next-line no-bitwise\n if (r & 1) {\n r = (r >>> 1) ^ POLYNOMIAL;\n } else {\n r = r >>> 1;\n }\n }\n crc32Table.push(toUInt32(r));\n }\n }\n}\n\n/*\n A {@link Hash.HashingNormalizer \| hashing normalizer} which computes object\n * hash using the CRC32 algorithm.\n * @public\n */\nexport class Crc32Normalizer extends HashingNormalizer {\n public constructor() {\n super(Crc32Normalizer.crc32Hash);\n }\n\n public static crc32Hash(parts: string[]): string {\n return String(crc32(new TextEncoder().encode(parts.join('\|'))));\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-utils",
-  "version": "3.0.1-alpha.5",
+  "version": "4.0.0",
   "description": "Assorted Typescript Utilities",
   "main": "lib/index.js",
   "types": "dist/ts-utils.d.ts",
@@ -29,15 +29,15 @@
   "homepage": "https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils#readme",
   "devDependencies": {
     "@jest/expect-utils": "^29.7.0",
-    "@microsoft/api-documenter": "^7.23.20",
-    "@microsoft/api-extractor": "^7.39.4",
+    "@microsoft/api-documenter": "^7.24.5",
+    "@microsoft/api-extractor": "^7.43.4",
     "@types/jest": "^29.5.12",
     "@types/luxon": "^3.4.2",
     "@types/mustache": "^4.2.5",
-    "@types/node": "^20.11.16",
-    "@typescript-eslint/eslint-plugin": "^6.20.0",
-    "@typescript-eslint/parser": "^6.20.0",
-    "eslint": "^8.56.0",
+    "@types/node": "^20.12.11",
+    "@typescript-eslint/eslint-plugin": "^7.9.0",
+    "@typescript-eslint/parser": "^7.9.0",
+    "eslint": "^8.57.0",
     "eslint-config-standard": "^17.1.0",
     "eslint-plugin-import": "^2.29.1",
     "eslint-plugin-node": "^11.1.0",
@@ -45,22 +45,17 @@
     "jest": "^29.7.0",
     "jest-extended": "^4.0.2",
     "jest-matcher-utils": "^29.7.0",
-    "rimraf": "^5.0.5",
+    "rimraf": "^5.0.7",
     "ts-jest": "^29.1.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.3.3",
+    "typescript": "^5.4.5",
     "eslint-plugin-n": "^16.6.2",
     "jest-snapshot": "~29.7.0",
-    "@rushstack/heft": "~0.64.3",
-    "@rushstack/heft-node-rig": "~2.4.5",
-    "@rushstack/eslint-config": "~3.6.2",
+    "@rushstack/heft": "~0.66.6",
+    "@rushstack/heft-node-rig": "~2.6.3",
+    "@rushstack/eslint-config": "~3.6.9",
     "@types/heft-jest": "1.0.6",
-    "@rushstack/heft-jest-plugin": "~0.11.3",
+    "@rushstack/heft-jest-plugin": "~0.11.27",
     "eslint-plugin-tsdoc": "~0.2.17"
-  },
-  "dependencies": {
-    "luxon": "^3.4.4",
-    "mustache": "^4.2.0",
-    "crc": "~4.3.2"
   }
 }