@fgv/ts-utils 5.1.0-36 → 5.1.0-39

package/lib/packlets/collections/readOnlyConvertingResultMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readOnlyConvertingResultMap.d.ts","sourceRoot":"","sources":["../../../src/packlets/collections/readOnlyConvertingResultMap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"readOnlyConvertingResultMap.d.ts","sourceRoot":"","sources":["../../../src/packlets/collections/readOnlyConvertingResultMap.ts"],"names":[],"mappings":"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"}

package/lib/packlets/collections/readOnlyConvertingResultMap.js

@@ -21,8 +21,26 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReadOnlyConvertingResultMap = void 0;
+exports.ReadOnlyConvertingResultMap = exports.conversionErrorHandling = exports.allConversionErrorHandling = void 0;
 const base_1 = require("../base");
+const conversion_1 = require("../conversion");
+// Untyped (literal-tuple-inferred) source of truth for allConversionErrorHandling, kept separate from
+// the widened public export below so the exhaustiveness check actually inspects the literal values
+// instead of being widened away to {@link Collections.ConversionErrorHandling | ConversionErrorHandling} before the check runs.
+const conversionErrorHandlingValues = ['ignore', 'warn', 'fail'];
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const _conversionErrorHandlingExhaustivenessCheck = true;
+/**
+ * Exhaustive list of all {@link Collections.ConversionErrorHandling | ConversionErrorHandling} values.
+ * @public
+ */
+exports.allConversionErrorHandling = conversionErrorHandlingValues;
+/**
+ * A ready-made {@link Converter | Converter} for
+ * {@link Collections.ConversionErrorHandling | ConversionErrorHandling} values.
+ * @public
+ */
+exports.conversionErrorHandling = conversion_1.Converters.enumeratedValue(exports.allConversionErrorHandling);
 /**
  * A read-only result map that wraps an inner {@link Collections.IReadOnlyResultMap | IReadOnlyResultMap}
  * of source type and returns lazily-converted, cached values of a target type.

package/lib/packlets/collections/readOnlyConvertingResultMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"readOnlyConvertingResultMap.js","sourceRoot":"","sources":["../../../src/packlets/collections/readOnlyConvertingResultMap.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 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 { captureResult, DetailedResult, failWithDetail, Result, succeedWithDetail } from '../base';\nimport { ILogger } from '../logging-interface';\nimport { KeyValueEntry } from './common';\nimport { IReadOnlyResultMap, ResultMapForEachCb, ResultMapResultDetail } from './readonlyResultMap';\n\n/**\n * A function that converts a source value to a target value.\n * @public\n */\nexport type ConvertingResultMapValueConverter<TK extends string, TSRC, TTARGET> = (\n  src: TSRC,\n  key: TK\n) => Result<TTARGET>;\n\n/**\n * Error handling behavior for conversion failures during iteration.\n * - `'ignore'`: Silently skip failed conversions (default behavior)\n * - `'warn'`: Log warning and skip failed conversions\n * - `'fail'`: Throw error on first conversion failure\n * @public\n */\nexport type ConversionErrorHandling = 'ignore' | 'warn' | 'fail';\n\n/**\n * Parameters for constructing a {@link Collections.ReadOnlyConvertingResultMap | ReadOnlyConvertingResultMap}.\n * @public\n */\nexport interface IReadOnlyConvertingResultMapConstructorParams<TK extends string, TSRC, TTARGET> {\n  /**\n   * The inner map containing source values.\n   */\n  inner: IReadOnlyResultMap<TK, TSRC>;\n\n  /**\n   * The converter function to transform source values to target values.\n   */\n  converter: ConvertingResultMapValueConverter<TK, TSRC, TTARGET>;\n\n  /**\n   * Error handling behavior for conversion failures during iteration.\n   * Defaults to `'ignore'` (silently skip failed conversions).\n   */\n  onConversionError?: ConversionErrorHandling;\n\n  /**\n   * Optional logger for warnings when `onConversionError` is `'warn'`.\n   */\n  logger?: ILogger;\n}\n\n/**\n * A read-only result map that wraps an inner {@link Collections.IReadOnlyResultMap | IReadOnlyResultMap}\n * of source type and returns lazily-converted, cached values of a target type.\n * @public\n */\nexport class ReadOnlyConvertingResultMap<TK extends string, TSRC, TTARGET>\n  implements IReadOnlyResultMap<TK, TTARGET>\n{\n  /**\n   * The inner map containing source values.\n   */\n  protected readonly _inner: IReadOnlyResultMap<TK, TSRC>;\n\n  /**\n   * The converter function to transform source values to target values.\n   */\n  protected readonly _converter: ConvertingResultMapValueConverter<TK, TSRC, TTARGET>;\n\n  /**\n   * Cache of converted target values.\n   */\n  protected readonly _cache: Map<TK, TTARGET>;\n\n  /**\n   * Error handling behavior for conversion failures during iteration.\n   */\n  protected readonly _onConversionError: ConversionErrorHandling;\n\n  /**\n   * Optional logger for warnings.\n   */\n  protected readonly _logger?: ILogger;\n\n  /**\n   * Constructs a new {@link Collections.ReadOnlyConvertingResultMap | ReadOnlyConvertingResultMap}.\n   * @param params - Parameters for constructing the map.\n   */\n  public constructor(params: IReadOnlyConvertingResultMapConstructorParams<TK, TSRC, TTARGET>) {\n    this._inner = params.inner;\n    this._converter = params.converter;\n    this._cache = new Map<TK, TTARGET>();\n    this._onConversionError = params.onConversionError ?? 'ignore';\n    this._logger = params.logger;\n  }\n\n  /**\n   * Creates a new {@link Collections.ReadOnlyConvertingResultMap | ReadOnlyConvertingResultMap}.\n   * @param params - Parameters for constructing the map.\n   * @returns `Success` with the new map, or `Failure` with error details if an error occurred.\n   */\n  public static create<TK extends string, TSRC, TTARGET>(\n    params: IReadOnlyConvertingResultMapConstructorParams<TK, TSRC, TTARGET>\n  ): Result<ReadOnlyConvertingResultMap<TK, TSRC, TTARGET>> {\n    return captureResult(() => new ReadOnlyConvertingResultMap(params));\n  }\n\n  /**\n   * The number of entries in the map.\n   */\n  public get size(): number {\n    return this._inner.size;\n  }\n\n  /**\n   * Gets a converted value from the map by key.\n   * @param key - The key to retrieve.\n   * @returns `Success` with the converted value and detail `exists` if the key was found,\n   * `Failure` with detail `not-found` if the key was not found, or `Failure` with\n   * detail `invalid-value` if conversion failed.\n   */\n  public get(key: TK): DetailedResult<TTARGET, ResultMapResultDetail> {\n    const cached = this._cache.get(key);\n    if (cached !== undefined) {\n      return succeedWithDetail(cached, 'exists');\n    }\n\n    return this._inner.get(key).onSuccess((src) => {\n      return this._convertAndCache(key, src);\n    });\n  }\n\n  /**\n   * Checks if the map contains a key.\n   * @param key - The key to check.\n   * @returns `true` if the key exists, `false` otherwise.\n   */\n  public has(key: TK): boolean {\n    return this._inner.has(key);\n  }\n\n  /**\n   * Returns an iterator over the map entries with converted values.\n   * @returns An iterator over the map entries.\n   */\n  public *entries(): IterableIterator<KeyValueEntry<TK, TTARGET>> {\n    for (const [key, src] of this._inner.entries()) {\n      const target = this._getOrConvert(key, src);\n      if (target !== undefined) {\n        yield [key, target];\n      }\n    }\n  }\n\n  /**\n   * Returns an iterator over the map keys.\n   * @returns An iterator over the map keys.\n   */\n  public keys(): IterableIterator<TK> {\n    return this._inner.keys();\n  }\n\n  /**\n   * Returns an iterator over the converted map values.\n   * @returns An iterator over the map values.\n   */\n  public *values(): IterableIterator<TTARGET> {\n    for (const [key, src] of this._inner.entries()) {\n      const target = this._getOrConvert(key, src);\n      if (target !== undefined) {\n        yield target;\n      }\n    }\n  }\n\n  /**\n   * Calls a callback for each entry in the map with converted values.\n   * @param cb - The callback to call for each entry.\n   * @param thisArg - Optional `this` argument for the callback.\n   */\n  public forEach(cb: ResultMapForEachCb<TK, TTARGET>, thisArg?: unknown): void {\n    for (const [key, src] of this._inner.entries()) {\n      const target = this._getOrConvert(key, src);\n      if (target !== undefined) {\n        cb.call(thisArg, target, key, this);\n      }\n    }\n  }\n\n  /**\n   * Gets an iterator over the map entries.\n   * @returns An iterator over the map entries.\n   */\n  public [Symbol.iterator](): IterableIterator<KeyValueEntry<TK, TTARGET>> {\n    return this.entries();\n  }\n\n  /**\n   * Gets a read-only version of this map.\n   * @returns A read-only version of this map.\n   */\n  public toReadOnly(): IReadOnlyResultMap<TK, TTARGET> {\n    return this;\n  }\n\n  /**\n   * Converts a source value to a target value and caches the result.\n   * @param key - The key of the value.\n   * @param src - The source value to convert.\n   * @returns `Success` with the converted value if successful, `Failure` otherwise.\n   */\n  protected _convertAndCache(key: TK, src: TSRC): DetailedResult<TTARGET, ResultMapResultDetail> {\n    const result = this._converter(src, key);\n    if (result.isFailure()) {\n      return failWithDetail(result.message, 'invalid-value');\n    }\n    this._cache.set(key, result.value);\n    return succeedWithDetail(result.value, 'exists');\n  }\n\n  /**\n   * Gets a cached value or converts and caches a source value.\n   * Used by iterators. Handles conversion failures according to `_onConversionError`.\n   * @param key - The key of the value.\n   * @param src - The source value to convert if not cached.\n   * @returns The converted value, or `undefined` if conversion failed.\n   * @throws Error if `_onConversionError` is `'fail'` and conversion fails.\n   */\n  protected _getOrConvert(key: TK, src: TSRC): TTARGET | undefined {\n    const cached = this._cache.get(key);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const result = this._converter(src, key);\n    if (result.isSuccess()) {\n      this._cache.set(key, result.value);\n      return result.value;\n    }\n\n    switch (this._onConversionError) {\n      case 'fail':\n        throw new Error(`Conversion failed for key '${key}': ${result.message}`);\n      case 'warn':\n        this._logger?.log('warning', `Conversion failed for key '${key}': ${result.message}`);\n        break;\n    }\n    return undefined;\n  }\n\n  /**\n   * Clears a single entry from the cache.\n   * @param key - The key to clear from the cache.\n   */\n  protected _clearCacheEntry(key: TK): void {\n    this._cache.delete(key);\n  }\n\n  /**\n   * Clears all entries from the cache.\n   */\n  protected _clearCache(): void {\n    this._cache.clear();\n  }\n}\n"]}
+{"version":3,"file":"readOnlyConvertingResultMap.js","sourceRoot":"","sources":["../../../src/packlets/collections/readOnlyConvertingResultMap.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 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 { captureResult, DetailedResult, failWithDetail, Result, succeedWithDetail } from '../base';\nimport { Converter, Converters } from '../conversion';\nimport { ILogger } from '../logging-interface';\nimport { KeyValueEntry } from './common';\nimport { IReadOnlyResultMap, ResultMapForEachCb, ResultMapResultDetail } from './readonlyResultMap';\n\n/**\n * A function that converts a source value to a target value.\n * @public\n */\nexport type ConvertingResultMapValueConverter<TK extends string, TSRC, TTARGET> = (\n  src: TSRC,\n  key: TK\n) => Result<TTARGET>;\n\n/**\n * Error handling behavior for conversion failures during iteration.\n * - `'ignore'`: Silently skip failed conversions (default behavior)\n * - `'warn'`: Log warning and skip failed conversions\n * - `'fail'`: Throw error on first conversion failure\n * @public\n */\nexport type ConversionErrorHandling = 'ignore' | 'warn' | 'fail';\n\n// Untyped (literal-tuple-inferred) source of truth for allConversionErrorHandling, kept separate from\n// the widened public export below so the exhaustiveness check actually inspects the literal values\n// instead of being widened away to {@link Collections.ConversionErrorHandling | ConversionErrorHandling} before the check runs.\nconst conversionErrorHandlingValues = ['ignore', 'warn', 'fail'] as const;\n\n/**\n * Compile-time exhaustiveness guard ensuring {@link conversionErrorHandlingValues} exactly matches every\n * member of {@link Collections.ConversionErrorHandling | ConversionErrorHandling}. Adding or removing a\n * union member without updating the array fails the build.\n * Deliberately not exported - this exists only to force the compiler to evaluate the check below.\n */\ntype _ConversionErrorHandlingExhaustivenessCheck = [\n  Exclude<ConversionErrorHandling, (typeof conversionErrorHandlingValues)[number]>,\n  Exclude<(typeof conversionErrorHandlingValues)[number], ConversionErrorHandling>\n] extends [never, never]\n  ? true\n  : never;\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst _conversionErrorHandlingExhaustivenessCheck: _ConversionErrorHandlingExhaustivenessCheck = true;\n\n/**\n * Exhaustive list of all {@link Collections.ConversionErrorHandling | ConversionErrorHandling} values.\n * @public\n */\nexport const allConversionErrorHandling: readonly ConversionErrorHandling[] = conversionErrorHandlingValues;\n\n/**\n * A ready-made {@link Converter | Converter} for\n * {@link Collections.ConversionErrorHandling | ConversionErrorHandling} values.\n * @public\n */\nexport const conversionErrorHandling: Converter<\n  ConversionErrorHandling,\n  ReadonlyArray<ConversionErrorHandling>\n> = Converters.enumeratedValue<ConversionErrorHandling>(allConversionErrorHandling);\n\n/**\n * Parameters for constructing a {@link Collections.ReadOnlyConvertingResultMap | ReadOnlyConvertingResultMap}.\n * @public\n */\nexport interface IReadOnlyConvertingResultMapConstructorParams<TK extends string, TSRC, TTARGET> {\n  /**\n   * The inner map containing source values.\n   */\n  inner: IReadOnlyResultMap<TK, TSRC>;\n\n  /**\n   * The converter function to transform source values to target values.\n   */\n  converter: ConvertingResultMapValueConverter<TK, TSRC, TTARGET>;\n\n  /**\n   * Error handling behavior for conversion failures during iteration.\n   * Defaults to `'ignore'` (silently skip failed conversions).\n   */\n  onConversionError?: ConversionErrorHandling;\n\n  /**\n   * Optional logger for warnings when `onConversionError` is `'warn'`.\n   */\n  logger?: ILogger;\n}\n\n/**\n * A read-only result map that wraps an inner {@link Collections.IReadOnlyResultMap | IReadOnlyResultMap}\n * of source type and returns lazily-converted, cached values of a target type.\n * @public\n */\nexport class ReadOnlyConvertingResultMap<TK extends string, TSRC, TTARGET>\n  implements IReadOnlyResultMap<TK, TTARGET>\n{\n  /**\n   * The inner map containing source values.\n   */\n  protected readonly _inner: IReadOnlyResultMap<TK, TSRC>;\n\n  /**\n   * The converter function to transform source values to target values.\n   */\n  protected readonly _converter: ConvertingResultMapValueConverter<TK, TSRC, TTARGET>;\n\n  /**\n   * Cache of converted target values.\n   */\n  protected readonly _cache: Map<TK, TTARGET>;\n\n  /**\n   * Error handling behavior for conversion failures during iteration.\n   */\n  protected readonly _onConversionError: ConversionErrorHandling;\n\n  /**\n   * Optional logger for warnings.\n   */\n  protected readonly _logger?: ILogger;\n\n  /**\n   * Constructs a new {@link Collections.ReadOnlyConvertingResultMap | ReadOnlyConvertingResultMap}.\n   * @param params - Parameters for constructing the map.\n   */\n  public constructor(params: IReadOnlyConvertingResultMapConstructorParams<TK, TSRC, TTARGET>) {\n    this._inner = params.inner;\n    this._converter = params.converter;\n    this._cache = new Map<TK, TTARGET>();\n    this._onConversionError = params.onConversionError ?? 'ignore';\n    this._logger = params.logger;\n  }\n\n  /**\n   * Creates a new {@link Collections.ReadOnlyConvertingResultMap | ReadOnlyConvertingResultMap}.\n   * @param params - Parameters for constructing the map.\n   * @returns `Success` with the new map, or `Failure` with error details if an error occurred.\n   */\n  public static create<TK extends string, TSRC, TTARGET>(\n    params: IReadOnlyConvertingResultMapConstructorParams<TK, TSRC, TTARGET>\n  ): Result<ReadOnlyConvertingResultMap<TK, TSRC, TTARGET>> {\n    return captureResult(() => new ReadOnlyConvertingResultMap(params));\n  }\n\n  /**\n   * The number of entries in the map.\n   */\n  public get size(): number {\n    return this._inner.size;\n  }\n\n  /**\n   * Gets a converted value from the map by key.\n   * @param key - The key to retrieve.\n   * @returns `Success` with the converted value and detail `exists` if the key was found,\n   * `Failure` with detail `not-found` if the key was not found, or `Failure` with\n   * detail `invalid-value` if conversion failed.\n   */\n  public get(key: TK): DetailedResult<TTARGET, ResultMapResultDetail> {\n    const cached = this._cache.get(key);\n    if (cached !== undefined) {\n      return succeedWithDetail(cached, 'exists');\n    }\n\n    return this._inner.get(key).onSuccess((src) => {\n      return this._convertAndCache(key, src);\n    });\n  }\n\n  /**\n   * Checks if the map contains a key.\n   * @param key - The key to check.\n   * @returns `true` if the key exists, `false` otherwise.\n   */\n  public has(key: TK): boolean {\n    return this._inner.has(key);\n  }\n\n  /**\n   * Returns an iterator over the map entries with converted values.\n   * @returns An iterator over the map entries.\n   */\n  public *entries(): IterableIterator<KeyValueEntry<TK, TTARGET>> {\n    for (const [key, src] of this._inner.entries()) {\n      const target = this._getOrConvert(key, src);\n      if (target !== undefined) {\n        yield [key, target];\n      }\n    }\n  }\n\n  /**\n   * Returns an iterator over the map keys.\n   * @returns An iterator over the map keys.\n   */\n  public keys(): IterableIterator<TK> {\n    return this._inner.keys();\n  }\n\n  /**\n   * Returns an iterator over the converted map values.\n   * @returns An iterator over the map values.\n   */\n  public *values(): IterableIterator<TTARGET> {\n    for (const [key, src] of this._inner.entries()) {\n      const target = this._getOrConvert(key, src);\n      if (target !== undefined) {\n        yield target;\n      }\n    }\n  }\n\n  /**\n   * Calls a callback for each entry in the map with converted values.\n   * @param cb - The callback to call for each entry.\n   * @param thisArg - Optional `this` argument for the callback.\n   */\n  public forEach(cb: ResultMapForEachCb<TK, TTARGET>, thisArg?: unknown): void {\n    for (const [key, src] of this._inner.entries()) {\n      const target = this._getOrConvert(key, src);\n      if (target !== undefined) {\n        cb.call(thisArg, target, key, this);\n      }\n    }\n  }\n\n  /**\n   * Gets an iterator over the map entries.\n   * @returns An iterator over the map entries.\n   */\n  public [Symbol.iterator](): IterableIterator<KeyValueEntry<TK, TTARGET>> {\n    return this.entries();\n  }\n\n  /**\n   * Gets a read-only version of this map.\n   * @returns A read-only version of this map.\n   */\n  public toReadOnly(): IReadOnlyResultMap<TK, TTARGET> {\n    return this;\n  }\n\n  /**\n   * Converts a source value to a target value and caches the result.\n   * @param key - The key of the value.\n   * @param src - The source value to convert.\n   * @returns `Success` with the converted value if successful, `Failure` otherwise.\n   */\n  protected _convertAndCache(key: TK, src: TSRC): DetailedResult<TTARGET, ResultMapResultDetail> {\n    const result = this._converter(src, key);\n    if (result.isFailure()) {\n      return failWithDetail(result.message, 'invalid-value');\n    }\n    this._cache.set(key, result.value);\n    return succeedWithDetail(result.value, 'exists');\n  }\n\n  /**\n   * Gets a cached value or converts and caches a source value.\n   * Used by iterators. Handles conversion failures according to `_onConversionError`.\n   * @param key - The key of the value.\n   * @param src - The source value to convert if not cached.\n   * @returns The converted value, or `undefined` if conversion failed.\n   * @throws Error if `_onConversionError` is `'fail'` and conversion fails.\n   */\n  protected _getOrConvert(key: TK, src: TSRC): TTARGET | undefined {\n    const cached = this._cache.get(key);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const result = this._converter(src, key);\n    if (result.isSuccess()) {\n      this._cache.set(key, result.value);\n      return result.value;\n    }\n\n    switch (this._onConversionError) {\n      case 'fail':\n        throw new Error(`Conversion failed for key '${key}': ${result.message}`);\n      case 'warn':\n        this._logger?.log('warning', `Conversion failed for key '${key}': ${result.message}`);\n        break;\n    }\n    return undefined;\n  }\n\n  /**\n   * Clears a single entry from the cache.\n   * @param key - The key to clear from the cache.\n   */\n  protected _clearCacheEntry(key: TK): void {\n    this._cache.delete(key);\n  }\n\n  /**\n   * Clears all entries from the cache.\n   */\n  protected _clearCache(): void {\n    this._cache.clear();\n  }\n}\n"]}

package/lib/packlets/conversion/basicConverters.d.ts

@@ -1,3 +1,4 @@
+import { MessageLogLevel } from '../base';
 import { TypeGuardWithContext, Validator } from '../validation';
 import { ConverterFunc } from './baseConverter';
 import { Converter, OnError } from './converter';
@@ -26,6 +27,16 @@ export declare const string: StringConverter;
  * @public
  */
 export declare function enumeratedValue<T>(values: ReadonlyArray<T>): Converter<T, ReadonlyArray<T>>;
+/**
+ * A ready-made {@link Converter | Converter} for {@link MessageLogLevel} values.
+ * @public
+ */
+export declare const messageLogLevel: Converter<MessageLogLevel, ReadonlyArray<MessageLogLevel>>;
+/**
+ * A ready-made {@link Converter | Converter} for {@link Conversion.OnError | OnError} values.
+ * @public
+ */
+export declare const onError: Converter<OnError, ReadonlyArray<OnError>>;
 /**
  * Helper function to create a {@link Converter | Converter} which converts `unknown` to one of a set of supplied enumerated
  * values, mapping any of multiple supplied values to the enumeration.

package/lib/packlets/conversion/basicConverters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basicConverters.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/basicConverters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"basicConverters.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/basicConverters.ts"],"names":[],"mappings":"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"}

package/lib/packlets/conversion/basicConverters.js

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.numberArray = exports.stringArray = exports.optionalBoolean = exports.optionalNumber = exports.optionalString = exports.boolean = exports.number = exports.value = exports.string = void 0;
+exports.numberArray = exports.stringArray = exports.optionalBoolean = exports.optionalNumber = exports.optionalString = exports.boolean = exports.number = exports.value = exports.onError = exports.messageLogLevel = exports.string = void 0;
 exports.enumeratedValue = enumeratedValue;
 exports.mappedEnumeratedValue = mappedEnumeratedValue;
 exports.literal = literal;
@@ -46,6 +46,7 @@ exports.discriminatedObject = discriminatedObject;
 const base_1 = require("../base");
 const validation_1 = require("../validation");
 const baseConverter_1 = require("./baseConverter");
+const converter_1 = require("./converter");
 const objectConverter_1 = require("./objectConverter");
 const stringConverter_1 = require("./stringConverter");
 /**
@@ -71,6 +72,16 @@ function enumeratedValue(values) {
         return index >= 0 ? (0, base_1.succeed)(v[index]) : (0, base_1.fail)(`Invalid enumerated value ${JSON.stringify(from)}`);
     });
 }
+/**
+ * A ready-made {@link Converter | Converter} for {@link MessageLogLevel} values.
+ * @public
+ */
+exports.messageLogLevel = enumeratedValue(base_1.allMessageLogLevels);
+/**
+ * A ready-made {@link Converter | Converter} for {@link Conversion.OnError | OnError} values.
+ * @public
+ */
+exports.onError = enumeratedValue(converter_1.allOnError);
 /**
  * Helper function to create a {@link Converter | Converter} which converts `unknown` to one of a set of supplied enumerated
  * values, mapping any of multiple supplied values to the enumeration.

package/lib/packlets/conversion/basicConverters.js.map

@@ -1 +1 @@
-{"version":3,"file":"basicConverters.js","sourceRoot":"","sources":["../../../src/packlets/conversion/basicConverters.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 { Failure, Result, fail, isKeyOf, succeed } from '../base';\nimport { TypeGuardWithContext, Validator, Base as ValidationBase } from '../validation';\nimport { BaseConverter, ConverterFunc } 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: ReadonlyArray<T>): Converter<T, ReadonlyArray<T>> {\n  return new BaseConverter(\n    (from: unknown, __self: Converter<T, ReadonlyArray<T>>, context?: ReadonlyArray<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/**\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, TC = unknown>(\n  map: ReadonlyArray<[T, ReadonlyArray<TC>]>,\n  message?: string\n): Converter<T, ReadonlyArray<TC>> {\n  return new BaseConverter(\n    (from: unknown, __self: Converter<T, ReadonlyArray<TC>>, __context?: ReadonlyArray<TC>) => {\n      for (const item of map) {\n        if (item[1].includes(from as TC)) {\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/**\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, TC = unknown>(value: T): Converter<T, TC> {\n  return new BaseConverter<T, TC>(\n    (from: unknown, __self: Converter<T, TC>, __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, unknown> = new BaseConverter<number, unknown>((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\nconst booleanConverter: Converter<boolean, unknown> = new BaseConverter<boolean, unknown>((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 `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, unknown> = booleanConverter;\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 * Determines if a supplied {@link Conversion.Converter | Converter} or {@link Validation.Validator | Validator} is\n * a {@link Validation.Validator | Validator}.\n * @param converterOrValidator - The {@link Conversion.Converter | Converter} or {@link Validation.Validator | Validator} to be tested.\n * @returns `true` if `converterOrValidator` is a {@link Validation.Validator | Validator}, `false` otherwise.\n * @public\n */\nexport function isValidator<T, TC>(\n  converterOrValidator: Converter<T, TC> | Validator<T, TC>\n): converterOrValidator is Validator<T, TC> {\n  return 'validate' in converterOrValidator;\n}\n\n/**\n * Helper function to create a {@link Converter | Converter} from any {@link Validation.Validator}\n * @param converterOrValidator - the {@link Validation.Validator} to be wrapped or {@link Converter | Converter}\n * to be used directly.\n * @returns A {@link Converter | Converter} which uses the supplied validator.\n * @public\n */\nexport function validated<T, TC = unknown>(\n  converterOrValidator: Validator<T, TC> | Converter<T, TC>\n): Converter<T, TC> {\n  if (!isValidator(converterOrValidator)) {\n    return converterOrValidator;\n  }\n  return new BaseConverter((from: unknown, __self?: Converter<T, TC>, context?: TC) => {\n    return converterOrValidator.validate(from, context);\n  });\n}\n\n/**\n * Helper function to create a {@link Validation.Validator | Validator} from any {@link Conversion.Converter | Converter}\n * or {@link Validation.Validator | Validator}.\n * @param converterOrValidator - the {@link Conversion.Converter | Converter} to be wrappped or {@link Validation.Validator | Validator} to be used directly.\n * @returns A {@link Validation.Validator | Validator} which uses the supplied converter or validator.\n * @public\n */\nexport function asValidator<T, TC = unknown>(\n  converterOrValidator: Converter<T, TC> | Validator<T, TC>\n): Validator<T, TC> {\n  if (isValidator(converterOrValidator)) {\n    return converterOrValidator;\n  }\n  return new ValidationBase.GenericValidator<T, TC>({\n    validator: (from: unknown, context?: TC): boolean | Failure<T> => {\n      const result = converterOrValidator.convert(from, context);\n      return result.isSuccess() ? true : fail(result.message);\n    }\n  });\n}\n\n/**\n * Helper function to create a {@link Converter | Converter} from a supplied {@link Conversion.ConverterFunc | ConverterFunc}.\n * @param convert - the function to be wrapped\n * @returns A {@link Converter | Converter} which uses the supplied function.\n * @public\n */\nexport function generic<T, TC = unknown>(convert: ConverterFunc<T, TC>): Converter<T, TC> {\n  return new BaseConverter(convert);\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, unknown> = 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, unknown> = booleanConverter.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 onError - 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 = unknown>(\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[], unknown> = 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[], unknown> = arrayOf(number);\n\n/**\n * Options for {@link recordOf} and\n * {@link mapOf}\n * helper functions.\n * @public\n */\n\nexport interface KeyedConverterOptions<T extends string = string, TC = unknown> {\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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>)},\n * {@link Converters.(recordOf:2) | Converters.recordOf(Converter<T, TC>, 'fail' or 'ignore')}, and\n * {@link Converters.recordOf | Converters.recordOf(Converter<T, TC>, KeyedConverterOptions)}.\n * @internal\n */\nexport function recordOf<T, TC = unknown, 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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>)},\n * {@link Converters.(mapOf:2) | Converters.mapOf(Converter<T, TC>, 'fail' or 'ignore')}, and\n * {@link Converters.mapOf | Converters.mapOf(Converter<T, TC>, KeyedConverterOptions)}.\n * @internal\n */\nexport function mapOf<T, TC = unknown, 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, TC>} which applies the supplied validation.\n * @public\n */\nexport function validateWith<T, TC = unknown>(\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, TC>} which extracts the specified element from an array.\n * @public\n */\nexport function element<T, TC = unknown>(\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, TC>} which extracts the specified element from an array.\n * @public\n */\nexport function optionalElement<T, TC = unknown>(\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 = unknown>(\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 = unknown>(\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, TC>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters | FieldConverters<T, TC>} 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, TC>} 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, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  options?: ObjectConverterOptions<T>\n): ObjectConverter<T, TC>;\n\n/**\n * Helper function to create a {@link Conversion.ObjectConverter | ObjectConverter<T, TC>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters | FieldConverters<T, TC>} 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, TC>} 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, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  optional: (keyof T)[]\n): ObjectConverter<T, TC>;\n\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, TC>(\n  properties: FieldConverters<T, TC>,\n  options?: (keyof T)[] | ObjectConverterOptions<T>\n): ObjectConverter<T, TC> {\n  return new ObjectConverter(properties, options as ObjectConverterOptions<T>);\n}\n\n/**\n * Options for the {@link strictObject} 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, TC>} 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, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  options?: StrictObjectConverterOptions<T>\n): ObjectConverter<T, TC>;\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, TC>} 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 | Converters.strictObject(options)} instead.\n * @public\n */\nexport function strictObject<T, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  optional: (keyof T)[]\n): ObjectConverter<T, TC>;\n\n/**\n * Concrete implementation for {@link Converters.strictObject | Converters.strictObject(fields, options)}\n * and {@link Converters.strictObject | Converters.strictObject(fields, optional)}.\n * @internal\n */\nexport function strictObject<T, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  opt?: (keyof T)[] | StrictObjectConverterOptions<T>\n): ObjectConverter<T, TC> {\n  /* c8 ignore next 2 */\n  const options: ObjectConverterOptions<T> =\n    opt && Array.isArray(opt) ? { strict: true, optionalFields: opt } : { ...(opt ?? {}), strict: true };\n  return new ObjectConverter<T, TC>(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 *\n * The `self` reference of the outer converter is threaded through to per-arm converter invocations,\n * enabling recursive discriminated-union parsers where arms recurse via `self`.\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<T, TC>((from: unknown, self: Converter<T, TC>, context?: TC) => {\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 arm = converters[discriminatorValue];\n    if (arm === undefined) {\n      return fail(`No converter for discriminator ${discriminatorProp}=\"${discriminatorValue}\"`);\n    }\n    // Thread the outer self and context through to the arm so that recursive\n    // discriminated-union parsers can reach the outer dispatcher via self.\n    if (isValidator(arm)) {\n      return arm.convert(from, context);\n    }\n    return arm.convert(from, context, self);\n  });\n}\n"]}
+{"version":3,"file":"basicConverters.js","sourceRoot":"","sources":["../../../src/packlets/conversion/basicConverters.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 { Failure, MessageLogLevel, Result, allMessageLogLevels, fail, isKeyOf, succeed } from '../base';\nimport { TypeGuardWithContext, Validator, Base as ValidationBase } from '../validation';\nimport { BaseConverter, ConverterFunc } from './baseConverter';\nimport { Converter, OnError, allOnError } 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: ReadonlyArray<T>): Converter<T, ReadonlyArray<T>> {\n  return new BaseConverter(\n    (from: unknown, __self: Converter<T, ReadonlyArray<T>>, context?: ReadonlyArray<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/**\n * A ready-made {@link Converter | Converter} for {@link MessageLogLevel} values.\n * @public\n */\nexport const messageLogLevel: Converter<\n  MessageLogLevel,\n  ReadonlyArray<MessageLogLevel>\n> = enumeratedValue<MessageLogLevel>(allMessageLogLevels);\n\n/**\n * A ready-made {@link Converter | Converter} for {@link Conversion.OnError | OnError} values.\n * @public\n */\nexport const onError: Converter<OnError, ReadonlyArray<OnError>> = enumeratedValue<OnError>(allOnError);\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, TC = unknown>(\n  map: ReadonlyArray<[T, ReadonlyArray<TC>]>,\n  message?: string\n): Converter<T, ReadonlyArray<TC>> {\n  return new BaseConverter(\n    (from: unknown, __self: Converter<T, ReadonlyArray<TC>>, __context?: ReadonlyArray<TC>) => {\n      for (const item of map) {\n        if (item[1].includes(from as TC)) {\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/**\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, TC = unknown>(value: T): Converter<T, TC> {\n  return new BaseConverter<T, TC>(\n    (from: unknown, __self: Converter<T, TC>, __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, unknown> = new BaseConverter<number, unknown>((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\nconst booleanConverter: Converter<boolean, unknown> = new BaseConverter<boolean, unknown>((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 `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, unknown> = booleanConverter;\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 * Determines if a supplied {@link Conversion.Converter | Converter} or {@link Validation.Validator | Validator} is\n * a {@link Validation.Validator | Validator}.\n * @param converterOrValidator - The {@link Conversion.Converter | Converter} or {@link Validation.Validator | Validator} to be tested.\n * @returns `true` if `converterOrValidator` is a {@link Validation.Validator | Validator}, `false` otherwise.\n * @public\n */\nexport function isValidator<T, TC>(\n  converterOrValidator: Converter<T, TC> | Validator<T, TC>\n): converterOrValidator is Validator<T, TC> {\n  return 'validate' in converterOrValidator;\n}\n\n/**\n * Helper function to create a {@link Converter | Converter} from any {@link Validation.Validator}\n * @param converterOrValidator - the {@link Validation.Validator} to be wrapped or {@link Converter | Converter}\n * to be used directly.\n * @returns A {@link Converter | Converter} which uses the supplied validator.\n * @public\n */\nexport function validated<T, TC = unknown>(\n  converterOrValidator: Validator<T, TC> | Converter<T, TC>\n): Converter<T, TC> {\n  if (!isValidator(converterOrValidator)) {\n    return converterOrValidator;\n  }\n  return new BaseConverter((from: unknown, __self?: Converter<T, TC>, context?: TC) => {\n    return converterOrValidator.validate(from, context);\n  });\n}\n\n/**\n * Helper function to create a {@link Validation.Validator | Validator} from any {@link Conversion.Converter | Converter}\n * or {@link Validation.Validator | Validator}.\n * @param converterOrValidator - the {@link Conversion.Converter | Converter} to be wrappped or {@link Validation.Validator | Validator} to be used directly.\n * @returns A {@link Validation.Validator | Validator} which uses the supplied converter or validator.\n * @public\n */\nexport function asValidator<T, TC = unknown>(\n  converterOrValidator: Converter<T, TC> | Validator<T, TC>\n): Validator<T, TC> {\n  if (isValidator(converterOrValidator)) {\n    return converterOrValidator;\n  }\n  return new ValidationBase.GenericValidator<T, TC>({\n    validator: (from: unknown, context?: TC): boolean | Failure<T> => {\n      const result = converterOrValidator.convert(from, context);\n      return result.isSuccess() ? true : fail(result.message);\n    }\n  });\n}\n\n/**\n * Helper function to create a {@link Converter | Converter} from a supplied {@link Conversion.ConverterFunc | ConverterFunc}.\n * @param convert - the function to be wrapped\n * @returns A {@link Converter | Converter} which uses the supplied function.\n * @public\n */\nexport function generic<T, TC = unknown>(convert: ConverterFunc<T, TC>): Converter<T, TC> {\n  return new BaseConverter(convert);\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, unknown> = 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, unknown> = booleanConverter.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 onError - 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 = unknown>(\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[], unknown> = 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[], unknown> = arrayOf(number);\n\n/**\n * Options for {@link recordOf} and\n * {@link mapOf}\n * helper functions.\n * @public\n */\n\nexport interface KeyedConverterOptions<T extends string = string, TC = unknown> {\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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>)},\n * {@link Converters.(recordOf:2) | Converters.recordOf(Converter<T, TC>, 'fail' or 'ignore')}, and\n * {@link Converters.recordOf | Converters.recordOf(Converter<T, TC>, KeyedConverterOptions)}.\n * @internal\n */\nexport function recordOf<T, TC = unknown, 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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>} 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 = unknown, 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, TC>)},\n * {@link Converters.(mapOf:2) | Converters.mapOf(Converter<T, TC>, 'fail' or 'ignore')}, and\n * {@link Converters.mapOf | Converters.mapOf(Converter<T, TC>, KeyedConverterOptions)}.\n * @internal\n */\nexport function mapOf<T, TC = unknown, 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, TC>} which applies the supplied validation.\n * @public\n */\nexport function validateWith<T, TC = unknown>(\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, TC>} which extracts the specified element from an array.\n * @public\n */\nexport function element<T, TC = unknown>(\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, TC>} which extracts the specified element from an array.\n * @public\n */\nexport function optionalElement<T, TC = unknown>(\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 = unknown>(\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 = unknown>(\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, TC>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters | FieldConverters<T, TC>} 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, TC>} 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, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  options?: ObjectConverterOptions<T>\n): ObjectConverter<T, TC>;\n\n/**\n * Helper function to create a {@link Conversion.ObjectConverter | ObjectConverter<T, TC>} which converts an object\n * without changing shape, given a {@link Conversion.FieldConverters | FieldConverters<T, TC>} 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, TC>} 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, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  optional: (keyof T)[]\n): ObjectConverter<T, TC>;\n\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, TC>(\n  properties: FieldConverters<T, TC>,\n  options?: (keyof T)[] | ObjectConverterOptions<T>\n): ObjectConverter<T, TC> {\n  return new ObjectConverter(properties, options as ObjectConverterOptions<T>);\n}\n\n/**\n * Options for the {@link strictObject} 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, TC>} 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, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  options?: StrictObjectConverterOptions<T>\n): ObjectConverter<T, TC>;\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, TC>} 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 | Converters.strictObject(options)} instead.\n * @public\n */\nexport function strictObject<T, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  optional: (keyof T)[]\n): ObjectConverter<T, TC>;\n\n/**\n * Concrete implementation for {@link Converters.strictObject | Converters.strictObject(fields, options)}\n * and {@link Converters.strictObject | Converters.strictObject(fields, optional)}.\n * @internal\n */\nexport function strictObject<T, TC = unknown>(\n  properties: FieldConverters<T, TC>,\n  opt?: (keyof T)[] | StrictObjectConverterOptions<T>\n): ObjectConverter<T, TC> {\n  /* c8 ignore next 2 */\n  const options: ObjectConverterOptions<T> =\n    opt && Array.isArray(opt) ? { strict: true, optionalFields: opt } : { ...(opt ?? {}), strict: true };\n  return new ObjectConverter<T, TC>(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 *\n * The `self` reference of the outer converter is threaded through to per-arm converter invocations,\n * enabling recursive discriminated-union parsers where arms recurse via `self`.\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<T, TC>((from: unknown, self: Converter<T, TC>, context?: TC) => {\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 arm = converters[discriminatorValue];\n    if (arm === undefined) {\n      return fail(`No converter for discriminator ${discriminatorProp}=\"${discriminatorValue}\"`);\n    }\n    // Thread the outer self and context through to the arm so that recursive\n    // discriminated-union parsers can reach the outer dispatcher via self.\n    if (isValidator(arm)) {\n      return arm.convert(from, context);\n    }\n    return arm.convert(from, context, self);\n  });\n}\n"]}

package/lib/packlets/conversion/converter.d.ts

@@ -4,6 +4,11 @@ import { Brand, Result, Success } from '../base';
  * @public
  */
 export type OnError = 'failOnError' | 'ignoreErrors';
+/**
+ * Exhaustive list of all {@link Conversion.OnError | OnError} values.
+ * @public
+ */
+export declare const allOnError: readonly OnError[];
 /**
  * Converter traits.
  * @public

package/lib/packlets/conversion/converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/converter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/converter.ts"],"names":[],"mappings":"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"}

package/lib/packlets/conversion/converter.js

@@ -1,3 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.allOnError = void 0;
+// Untyped (literal-tuple-inferred) source of truth for allOnError, kept separate from the widened
+// public export below so the exhaustiveness check actually inspects the literal values instead of
+// being widened away to {@link Conversion.OnError | OnError} before the check runs.
+const onErrorValues = ['failOnError', 'ignoreErrors'];
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const _onErrorExhaustivenessCheck = true;
+/**
+ * Exhaustive list of all {@link Conversion.OnError | OnError} values.
+ * @public
+ */
+exports.allOnError = onErrorValues;
 //# sourceMappingURL=converter.js.map

package/lib/packlets/conversion/converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../../src/packlets/conversion/converter.ts"],"names":[],"mappings":"","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 */\nimport { Brand, Result, Success } from '../base';\n\n/**\n * Action to take on conversion failures.\n * @public\n */\nexport type OnError = 'failOnError' | 'ignoreErrors';\n\n/**\n * Converter traits.\n * @public\n */\n\nexport interface ConverterTraits {\n  readonly isOptional: boolean;\n  readonly brand?: string;\n}\n\n/**\n * Formats an incoming error message and value that failed validation.\n * @param val - The value that failed validation.\n * @param message - The default error message, if any.\n * @param context - Optional validation context.\n * @returns The formatted error message.\n * @public\n */\nexport type ConversionErrorFormatter<TC = unknown> = (val: unknown, message?: string, context?: TC) => string;\n\n/**\n * Options for {@link Converter.withConstraint}.\n * @public\n */\n\nexport interface ConstraintOptions {\n  /**\n   * Optional description for error messages when constraint\n   * function returns false.\n   */\n  readonly description: string;\n}\n\n/**\n * Generic converter to convert unknown to a templated type `<T>`, using\n * intrinsic rules or as modified by an optional conversion context\n * of optional templated type `<TC>` (default `undefined`).\n * @public\n */\n\nexport interface Converter<T, TC = unknown> extends ConverterTraits {\n  /**\n   *\n   * Indicates whether this element is explicitly optional.\n   */\n  readonly isOptional: boolean;\n\n  /**\n   * Returns the brand for a branded type.\n   */\n  readonly brand?: string;\n\n  /**\n   * Converts from `unknown` to `<T>`.  For objects and arrays, is guaranteed\n   * to return a new entity, with any unrecognized properties removed.\n   * @param from - The `unknown` to be converted\n   * @param context - An optional conversion context of type `<TC>` to be used in\n   * the conversion.\n   * @param selfOverride - An optional override for the `self` reference passed to the\n   * converter function, enabling outer converters (e.g. discriminated-object) to thread\n   * themselves through to per-arm converters for recursive parsing.\n   * @returns A {@link Result} with a {@link Success} and a value on success or an\n   * {@link Failure} with a a message on failure.\n   */\n  convert(from: unknown, context?: TC, selfOverride?: Converter<T, TC>): Result<T>;\n\n  /**\n   * Converts from `unknown` to `<T>` or `undefined`, as appropriate.\n   *\n   * @remarks\n   * If `onError` is `failOnError`, the converter succeeds for\n   * `undefined` or any convertible value, but reports an error\n   * if it encounters a value that cannot be converted.\n   *\n   * If `onError` is `ignoreErrors` (default) then values that\n   * cannot be converted result in a successful return of `undefined`.\n   * @param from - The `unknown` to be converted\n   * @param context - An optional conversion context of type `<TC>` to be used in\n   * the conversion.\n   * @param onError - Specifies handling of values that cannot be converted (default `ignoreErrors`).\n   * @returns A {@link Result} with a {@link Success} and a value on success or an\n   * {@link Failure} with a a message on failure.\n   */\n  convertOptional(from: unknown, context?: TC, onError?: OnError): Result<T | undefined>;\n\n  /**\n   * Creates a {@link Converter} for an optional value.\n   *\n   * @remarks\n   * If `onError` is `failOnError`, the resulting converter will accept `undefined`\n   * or a convertible value, but report an error if it encounters a value that cannot be\n   * converted.\n   *\n   * If `onError` is `ignoreErrors` (default) then values that cannot be converted will\n   * result in a successful return of `undefined`.\n   *\n   * @param onError - Specifies handling of values that cannot be converted (default `ignoreErrors`).\n   * @returns A new {@link Converter} returning `<T|undefined>`.\n   * */\n  optional(onError?: OnError): Converter<T | undefined, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies a (possibly) mapping conversion to\n   * the converted value of this {@link Converter}.\n   * @param mapper - A function which maps from the the result type `<T>` of this\n   * converter to a new result type `<T2>`.\n   * @returns A new {@link Converter} returning `<T2>`.\n   */\n  map<T2>(mapper: (from: T, context?: TC) => Result<T2>): Converter<T2, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies an additional supplied\n   * converter to the result of this converter.\n   *\n   * @param mapConverter - The {@link Converter} to be applied to the\n   * converted result from this {@link Converter}.\n   * @returns A new {@link Converter} returning `<T2>`.\n   */\n  mapConvert<T2>(mapConverter: Converter<T2, unknown>): Converter<T2, TC>;\n\n  /**\n   * Creates a {@link Converter} which maps the individual items of a collection\n   * resulting from this {@link Converter} using the supplied map function.\n   *\n   * @remarks\n   * Fails if `from` is not an array.\n   *\n   * @param mapper - The map function to be applied to each element of the\n   * result of this {@link Converter}.\n   * @returns A new {@link Converter} returning `<TI[]>`.\n   */\n  mapItems<TI>(mapper: (from: unknown, context?: TC) => Result<TI>): Converter<TI[], TC>;\n\n  /**\n   * Creates a {@link Converter} which maps the individual items of a collection\n   * resulting from this {@link Converter} using the supplied {@link Converter}.\n   *\n   * @remarks\n   * Fails if `from` is not an array.\n   *\n   * @param mapConverter - The {@link Converter} to be applied to each element of the\n   * result of this {@link Converter}.\n   * @returns A new {@link Converter} returning `<TI[]>`.\n   */\n  mapConvertItems<TI>(mapConverter: Converter<TI, unknown>): Converter<TI[], TC>;\n\n  /**\n   * Creates a {@link Converter | Converter} which applies a supplied action after\n   * conversion.  The supplied action is always called regardless of success or failure\n   * of the base conversion and is allowed to mutate the return type.\n   * @param action - The action to be applied.\n   */\n  withAction<T2>(action: (result: Result<T>, context?: TC) => Result<T2>): Converter<T2, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies a supplied type guard to the conversion\n   * result.\n   * @param guard - The type guard function to apply.\n   * @param message - Optional message to be reported if the type guard fails.\n   * @returns A new {@link Converter} returning `<TI>`.\n   */\n  withTypeGuard<TI>(guard: (from: unknown, context?: TC) => from is TI, message?: string): Converter<TI, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies a supplied type guard to each member of\n   * the conversion result from this converter.\n   *\n   * @remarks\n   * Fails if the conversion result is not an array or if any member fails the\n   * type guard.\n   * @param guard - The type guard function to apply to each element.\n   * @param message - Optional message to be reported if the type guard fails.\n   * @returns A new {@link Converter} returning `<TI>`.\n   */\n  withItemTypeGuard<TI>(\n    guard: (from: unknown, context?: TC) => from is TI,\n    message?: string\n  ): Converter<TI[], TC>;\n\n  /**\n   * Creates a {@link Converter} which applies an optional constraint to the result\n   * of this conversion.  If this {@link Converter} (the base converter) succeeds, the new\n   * converter calls a supplied constraint evaluation function with the conversion, which\n   * fails the entire conversion if the constraint function returns either `false` or\n   * {@link Failure | Failure<T>}.\n   *\n   * @param constraint - Constraint evaluation function.\n   * @param options - {@link Conversion.ConstraintOptions | Options} for constraint evaluation.\n   * @returns A new {@link Converter} returning `<T>`.\n   */\n  withConstraint(\n    constraint: (val: T, context?: TC) => boolean | Result<T>,\n    options?: ConstraintOptions\n  ): Converter<T, TC>;\n\n  /**\n   * Creates a new {@link Converter} which is derived from this one but which returns an\n   * error message formatted by the supplied formatter if the conversion fails.\n   * @param formatter - The formatter to be applied.\n   * @returns A new {@link Converter} returning `<T>`.\n   */\n  withFormattedError(formatter: ConversionErrorFormatter<TC>): Converter<T, TC>;\n\n  /**\n   * returns a converter which adds a brand to the type to prevent mismatched usage\n   * of simple types.\n   * @param brand - The brand to be applied to the result value.\n   * @returns A {@link Converter} returning `Brand<T, B>`.\n   */\n  withBrand<B extends string>(brand: B): Converter<Brand<T, B>, TC>;\n\n  /**\n   * Returns a Converter which always succeeds with a default value rather than failing.\n   */\n  withDefault<TD = T>(dflt: TD): DefaultingConverter<T, TD, TC>;\n\n  /**\n   * Chains this converter with another of the same type, to be attempted if this\n   * converter fails.\n   * @param other -\n   */\n  or(other: Converter<T, TC>): Converter<T, TC>;\n}\n\n/**\n * @public\n */\n\nexport interface DefaultingConverter<T, TD = T, TC = unknown> extends Converter<T | TD, TC> {\n  /**\n   * Default value to use if the conversion fails.\n   */\n  readonly defaultValue: TD;\n\n  /**\n   * Convert the supplied `unknown` to `Success<T>` or to the `Success` with the default value\n   * if conversion is not possible.\n   * @param from - the value to be converted.\n   * @param ctx - optional context for the conversion.\n   */\n  convert(from: unknown, ctx?: TC): Success<T | TD>;\n}\n"]}
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../../src/packlets/conversion/converter.ts"],"names":[],"mappings":";;;AA6BA,kGAAkG;AAClG,kGAAkG;AAClG,oFAAoF;AACpF,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,cAAc,CAAU,CAAC;AAc/D,6DAA6D;AAC7D,MAAM,2BAA2B,GAAgC,IAAI,CAAC;AAEtE;;;GAGG;AACU,QAAA,UAAU,GAAuB,aAAa,CAAC","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 */\nimport { Brand, Result, Success } from '../base';\n\n/**\n * Action to take on conversion failures.\n * @public\n */\nexport type OnError = 'failOnError' | 'ignoreErrors';\n\n// Untyped (literal-tuple-inferred) source of truth for allOnError, kept separate from the widened\n// public export below so the exhaustiveness check actually inspects the literal values instead of\n// being widened away to {@link Conversion.OnError | OnError} before the check runs.\nconst onErrorValues = ['failOnError', 'ignoreErrors'] as const;\n\n/**\n * Compile-time exhaustiveness guard ensuring {@link onErrorValues} exactly matches every member of\n * {@link Conversion.OnError | OnError}. Adding or removing a union member without updating the array fails the build.\n * Deliberately not exported - this exists only to force the compiler to evaluate the check below.\n */\ntype _OnErrorExhaustivenessCheck = [\n  Exclude<OnError, (typeof onErrorValues)[number]>,\n  Exclude<(typeof onErrorValues)[number], OnError>\n] extends [never, never]\n  ? true\n  : never;\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst _onErrorExhaustivenessCheck: _OnErrorExhaustivenessCheck = true;\n\n/**\n * Exhaustive list of all {@link Conversion.OnError | OnError} values.\n * @public\n */\nexport const allOnError: readonly OnError[] = onErrorValues;\n\n/**\n * Converter traits.\n * @public\n */\n\nexport interface ConverterTraits {\n  readonly isOptional: boolean;\n  readonly brand?: string;\n}\n\n/**\n * Formats an incoming error message and value that failed validation.\n * @param val - The value that failed validation.\n * @param message - The default error message, if any.\n * @param context - Optional validation context.\n * @returns The formatted error message.\n * @public\n */\nexport type ConversionErrorFormatter<TC = unknown> = (val: unknown, message?: string, context?: TC) => string;\n\n/**\n * Options for {@link Converter.withConstraint}.\n * @public\n */\n\nexport interface ConstraintOptions {\n  /**\n   * Optional description for error messages when constraint\n   * function returns false.\n   */\n  readonly description: string;\n}\n\n/**\n * Generic converter to convert unknown to a templated type `<T>`, using\n * intrinsic rules or as modified by an optional conversion context\n * of optional templated type `<TC>` (default `undefined`).\n * @public\n */\n\nexport interface Converter<T, TC = unknown> extends ConverterTraits {\n  /**\n   *\n   * Indicates whether this element is explicitly optional.\n   */\n  readonly isOptional: boolean;\n\n  /**\n   * Returns the brand for a branded type.\n   */\n  readonly brand?: string;\n\n  /**\n   * Converts from `unknown` to `<T>`.  For objects and arrays, is guaranteed\n   * to return a new entity, with any unrecognized properties removed.\n   * @param from - The `unknown` to be converted\n   * @param context - An optional conversion context of type `<TC>` to be used in\n   * the conversion.\n   * @param selfOverride - An optional override for the `self` reference passed to the\n   * converter function, enabling outer converters (e.g. discriminated-object) to thread\n   * themselves through to per-arm converters for recursive parsing.\n   * @returns A {@link Result} with a {@link Success} and a value on success or an\n   * {@link Failure} with a a message on failure.\n   */\n  convert(from: unknown, context?: TC, selfOverride?: Converter<T, TC>): Result<T>;\n\n  /**\n   * Converts from `unknown` to `<T>` or `undefined`, as appropriate.\n   *\n   * @remarks\n   * If `onError` is `failOnError`, the converter succeeds for\n   * `undefined` or any convertible value, but reports an error\n   * if it encounters a value that cannot be converted.\n   *\n   * If `onError` is `ignoreErrors` (default) then values that\n   * cannot be converted result in a successful return of `undefined`.\n   * @param from - The `unknown` to be converted\n   * @param context - An optional conversion context of type `<TC>` to be used in\n   * the conversion.\n   * @param onError - Specifies handling of values that cannot be converted (default `ignoreErrors`).\n   * @returns A {@link Result} with a {@link Success} and a value on success or an\n   * {@link Failure} with a a message on failure.\n   */\n  convertOptional(from: unknown, context?: TC, onError?: OnError): Result<T | undefined>;\n\n  /**\n   * Creates a {@link Converter} for an optional value.\n   *\n   * @remarks\n   * If `onError` is `failOnError`, the resulting converter will accept `undefined`\n   * or a convertible value, but report an error if it encounters a value that cannot be\n   * converted.\n   *\n   * If `onError` is `ignoreErrors` (default) then values that cannot be converted will\n   * result in a successful return of `undefined`.\n   *\n   * @param onError - Specifies handling of values that cannot be converted (default `ignoreErrors`).\n   * @returns A new {@link Converter} returning `<T|undefined>`.\n   * */\n  optional(onError?: OnError): Converter<T | undefined, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies a (possibly) mapping conversion to\n   * the converted value of this {@link Converter}.\n   * @param mapper - A function which maps from the the result type `<T>` of this\n   * converter to a new result type `<T2>`.\n   * @returns A new {@link Converter} returning `<T2>`.\n   */\n  map<T2>(mapper: (from: T, context?: TC) => Result<T2>): Converter<T2, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies an additional supplied\n   * converter to the result of this converter.\n   *\n   * @param mapConverter - The {@link Converter} to be applied to the\n   * converted result from this {@link Converter}.\n   * @returns A new {@link Converter} returning `<T2>`.\n   */\n  mapConvert<T2>(mapConverter: Converter<T2, unknown>): Converter<T2, TC>;\n\n  /**\n   * Creates a {@link Converter} which maps the individual items of a collection\n   * resulting from this {@link Converter} using the supplied map function.\n   *\n   * @remarks\n   * Fails if `from` is not an array.\n   *\n   * @param mapper - The map function to be applied to each element of the\n   * result of this {@link Converter}.\n   * @returns A new {@link Converter} returning `<TI[]>`.\n   */\n  mapItems<TI>(mapper: (from: unknown, context?: TC) => Result<TI>): Converter<TI[], TC>;\n\n  /**\n   * Creates a {@link Converter} which maps the individual items of a collection\n   * resulting from this {@link Converter} using the supplied {@link Converter}.\n   *\n   * @remarks\n   * Fails if `from` is not an array.\n   *\n   * @param mapConverter - The {@link Converter} to be applied to each element of the\n   * result of this {@link Converter}.\n   * @returns A new {@link Converter} returning `<TI[]>`.\n   */\n  mapConvertItems<TI>(mapConverter: Converter<TI, unknown>): Converter<TI[], TC>;\n\n  /**\n   * Creates a {@link Converter | Converter} which applies a supplied action after\n   * conversion.  The supplied action is always called regardless of success or failure\n   * of the base conversion and is allowed to mutate the return type.\n   * @param action - The action to be applied.\n   */\n  withAction<T2>(action: (result: Result<T>, context?: TC) => Result<T2>): Converter<T2, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies a supplied type guard to the conversion\n   * result.\n   * @param guard - The type guard function to apply.\n   * @param message - Optional message to be reported if the type guard fails.\n   * @returns A new {@link Converter} returning `<TI>`.\n   */\n  withTypeGuard<TI>(guard: (from: unknown, context?: TC) => from is TI, message?: string): Converter<TI, TC>;\n\n  /**\n   * Creates a {@link Converter} which applies a supplied type guard to each member of\n   * the conversion result from this converter.\n   *\n   * @remarks\n   * Fails if the conversion result is not an array or if any member fails the\n   * type guard.\n   * @param guard - The type guard function to apply to each element.\n   * @param message - Optional message to be reported if the type guard fails.\n   * @returns A new {@link Converter} returning `<TI>`.\n   */\n  withItemTypeGuard<TI>(\n    guard: (from: unknown, context?: TC) => from is TI,\n    message?: string\n  ): Converter<TI[], TC>;\n\n  /**\n   * Creates a {@link Converter} which applies an optional constraint to the result\n   * of this conversion.  If this {@link Converter} (the base converter) succeeds, the new\n   * converter calls a supplied constraint evaluation function with the conversion, which\n   * fails the entire conversion if the constraint function returns either `false` or\n   * {@link Failure | Failure<T>}.\n   *\n   * @param constraint - Constraint evaluation function.\n   * @param options - {@link Conversion.ConstraintOptions | Options} for constraint evaluation.\n   * @returns A new {@link Converter} returning `<T>`.\n   */\n  withConstraint(\n    constraint: (val: T, context?: TC) => boolean | Result<T>,\n    options?: ConstraintOptions\n  ): Converter<T, TC>;\n\n  /**\n   * Creates a new {@link Converter} which is derived from this one but which returns an\n   * error message formatted by the supplied formatter if the conversion fails.\n   * @param formatter - The formatter to be applied.\n   * @returns A new {@link Converter} returning `<T>`.\n   */\n  withFormattedError(formatter: ConversionErrorFormatter<TC>): Converter<T, TC>;\n\n  /**\n   * returns a converter which adds a brand to the type to prevent mismatched usage\n   * of simple types.\n   * @param brand - The brand to be applied to the result value.\n   * @returns A {@link Converter} returning `Brand<T, B>`.\n   */\n  withBrand<B extends string>(brand: B): Converter<Brand<T, B>, TC>;\n\n  /**\n   * Returns a Converter which always succeeds with a default value rather than failing.\n   */\n  withDefault<TD = T>(dflt: TD): DefaultingConverter<T, TD, TC>;\n\n  /**\n   * Chains this converter with another of the same type, to be attempted if this\n   * converter fails.\n   * @param other -\n   */\n  or(other: Converter<T, TC>): Converter<T, TC>;\n}\n\n/**\n * @public\n */\n\nexport interface DefaultingConverter<T, TD = T, TC = unknown> extends Converter<T | TD, TC> {\n  /**\n   * Default value to use if the conversion fails.\n   */\n  readonly defaultValue: TD;\n\n  /**\n   * Convert the supplied `unknown` to `Success<T>` or to the `Success` with the default value\n   * if conversion is not possible.\n   * @param from - the value to be converted.\n   * @param ctx - optional context for the conversion.\n   */\n  convert(from: unknown, ctx?: TC): Success<T | TD>;\n}\n"]}