@fgv/ts-utils 3.0.0 → 3.0.1-alpha.1

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

@@ -1,12 +1,13 @@
 import { TypeGuardWithContext, Validator } from '../validation';
-import { Converter } from './converter';
+import { Converter, OnError } from './converter';
 import { FieldConverters, ObjectConverter, ObjectConverterOptions } from './objectConverter';
 import { StringConverter } from './stringConverter';
 /**
- * Action to take on conversion failures.
+ * Action to take on conversion failures (deprecated - use Conversion.OnError)
  * @public
+ * @deprecated use Conversion.OnError.
  */
-export type OnError = 'failOnError' | 'ignoreErrors';
+export { OnError };
 /**
  * A converter to convert unknown to string. Values of type
  * string succeed.  Anything else fails.
@@ -20,23 +21,23 @@ export declare const string: StringConverter;
  * @remarks
  * Template conversions are applied using `mustache` syntax.
  * @param defaultContext - Optional default context to use for template values.
- * @returns A new {@link Converter} returning `string`.
+ * @returns A new {@link Converter | Converter} returning `string`.
  * @public
  */
 export declare function templateString(defaultContext?: unknown): StringConverter<string, unknown>;
 /**
- * Helper function to create a {@link Converter} which converts `unknown` to one of a set of supplied
+ * Helper function to create a {@link Converter | Converter} which converts `unknown` to one of a set of supplied
  * enumerated values. Anything else fails.
  *
  * @remarks
  * Allowed enumerated values can also be supplied as context at conversion time.
  * @param values - Array of allowed values.
- * @returns A new {@link Converter} returning `<T>`.
+ * @returns A new {@link Converter | Converter} returning `<T>`.
  * @public
  */
 export declare function enumeratedValue<T>(values: T[]): Converter<T, T[]>;
 /**
- * Helper function to create a {@link Converter} which converts `unknown` to one of a set of supplied enumerated
+ * 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.
  * @remarks
  * Enables mapping of multiple input values to a consistent internal representation (so e.g. `'y'`, `'yes'`,
@@ -45,15 +46,15 @@ export declare function enumeratedValue<T>(values: T[]): Converter<T, T[]>;
  * value, the second is the set of values that map to the result.  Tuples are evaluated in the order
  * supplied and are not checked for duplicates.
  * @param message - An optional error message.
- * @returns A {@link Converter} which applies the mapping and yields `<T>` on success.
+ * @returns A {@link Converter | Converter} which applies the mapping and yields `<T>` on success.
  * @public
  */
 export declare function mappedEnumeratedValue<T>(map: [T, unknown[]][], message?: string): Converter<T, undefined>;
 /**
- * Helper function to create a {@link Converter} which converts `unknown` to some supplied literal value. Succeeds with
+ * Helper function to create a {@link Converter | Converter} which converts `unknown` to some supplied literal value. Succeeds with
  * the supplied value if an identity comparison succeeds, fails otherwise.
  * @param value - The value to be compared.
- * @returns A {@link Converter} which returns the supplied value on success.
+ * @returns A {@link Converter | Converter} which returns the supplied value on success.
  * @public
  */
 export declare function literal<T>(value: T): Converter<T, unknown>;
@@ -65,14 +66,14 @@ export declare function literal<T>(value: T): Converter<T, unknown>;
  */
 export declare const value: typeof literal;
 /**
- * A {@link Converter} which converts `unknown` to a `number`.
+ * A {@link Converter | Converter} which converts `unknown` to a `number`.
  * @remarks
  * Numbers and strings with a numeric format succeed. Anything else fails.
  * @public
  */
 export declare const number: Converter<number, undefined>;
 /**
- * A {@link Converter} which converts `unknown` to `boolean`.
+ * A {@link Converter | Converter} which converts `unknown` to `boolean`.
  * @remarks
  * Boolean values or the case-insensitive strings `'true'` and `'false'` succeed.
  * Anything else fails.
@@ -80,93 +81,96 @@ export declare const number: Converter<number, undefined>;
  */
 export declare const boolean: Converter<boolean, undefined>;
 /**
- * A {@link Converter} which converts an optional `string` value. Values of type
- * `string` are returned.  Anything else returns {@link Success} with value `undefined`.
+ * A {@link Converter | Converter} which converts an optional `string` value. Values of type
+ * `string` are returned.  Anything else returns {@link Success | Success} with value `undefined`.
  * @public
  */
 export declare const optionalString: Converter<string | undefined, unknown>;
 /**
- * Helper function to create a {@link Converter} which converts any `string` into an
+ * Helper function to create a {@link Converter | Converter} which converts any `string` into an
  * array of `string`, by separating at a supplied delimiter.
  * @remarks
  * Delimiter may also be supplied as context at conversion time.
  * @param delimiter - The delimiter at which to split.
- * @returns A new {@link Converter} returning `string[]`.
+ * @returns A new {@link Converter | Converter} returning `string[]`.
  * @public
  */
 export declare function delimitedString(delimiter: string, options?: 'filtered' | 'all'): Converter<string[], string>;
 /**
- * A {@link Converter} which converts an iso formatted string, a number or a `Date` object to
+ * A {@link Converter | Converter} which converts an iso formatted string, a number or a `Date` object to
  * a `Date` object.
  * @public
  */
 export declare const isoDate: Converter<Date, unknown>;
 /**
- * Helper function to create a {@link Converter} from any {@link Validation.Validator}
+ * Helper function to create a {@link Converter | Converter} from any {@link Validation.Validator}
  * @param validator - the validator to be wrapped
- * @returns A {@link Converter} which uses the supplied validator.
+ * @returns A {@link Converter | Converter} which uses the supplied validator.
  * @public
  */
 export declare function validated<T, TC = unknown>(validator: Validator<T, TC>): Converter<T, TC>;
 /**
- * Helper function to create a {@link Converter} from a supplied type guard function.
+ * Helper function to create a {@link Converter | Converter} from a supplied type guard function.
  * @param description - a description of the thing to be validated for use in error messages
  * @param guard - a {@link Validation.TypeGuardWithContext} which performs the validation.
- * @returns A new {@link Converter} which validates the values using the supplied type guard
+ * @returns A new {@link Converter | Converter} which validates the values using the supplied type guard
  * and returns them in place.
  * @public
  */
 export declare function isA<T, TC = unknown>(description: string, guard: TypeGuardWithContext<T, TC>): Converter<T, TC>;
 /**
- * A {@link Converter} which converts an optional `number` value.
+ * A {@link Converter | Converter} which converts an optional `number` value.
  * @remarks
  * Values of type `number` or numeric strings are converted and returned.
- * Anything else returns {@link Success} with value `undefined`.
+ * Anything else returns {@link Success | Success} with value `undefined`.
  * @public
  */
 export declare const optionalNumber: Converter<number | undefined>;
 /**
- * A {@link Converter} to convert an optional `boolean` value.
+ * A {@link Converter | Converter} to convert an optional `boolean` value.
  * @remarks
  * Values of type `boolean` or strings that match (case-insensitive) `'true'`
- * or `'false'` are converted and returned.  Anything else returns {@link Success}
+ * or `'false'` are converted and returned.  Anything else returns {@link Success | Success}
  * with value `undefined`.
  * @public
  */
 export declare const optionalBoolean: Converter<boolean | undefined>;
 /**
- * A helper function to create a {@link Converter} for polymorphic values.  Returns a
- * converter which Invokes the wrapped converters in sequence, returning the first successful
- * result.  Returns an error if none of the supplied converters can convert the value.
+ * A helper function to create a {@link Converter | Converter} for polymorphic values.
+ * Returns a converter which invokes the wrapped converters in sequence, returning the
+ * first successful result.  Returns an error if none of the supplied converters can
+ * convert the value.
  * @remarks
  * If `onError` is `ignoreErrors` (default), then errors from any of the
  * converters are ignored provided that some converter succeeds.  If
  * onError is `failOnError`, then an error from any converter fails the entire
  * conversion.
  *
- * @param converters - An ordered list of {@link Converter | converters} to be considered.
+ * @param converters - An ordered list of {@link Converter | converters} or {@link Validator | validators}
+ * to be considered.
  * @param onError - Specifies treatment of unconvertible elements.
- * @returns A new {@link Converter} which yields a value from the union of the types returned
+ * @returns A new {@link Converter | Converter} which yields a value from the union of the types returned
  * by the wrapped converters.
  * @public
  */
-export declare function oneOf<T, TC = unknown>(converters: Array<Converter<T, TC>>, onError?: OnError): Converter<T, TC>;
+export declare function oneOf<T, TC = unknown>(converters: Array<Converter<T, TC> | Validator<T, TC>>, onError?: OnError): Converter<T, TC>;
 /**
- * A helper function to create a {@link Converter} which converts `unknown` to an array of `<T>`.
+ * A helper function to create a {@link Converter | Converter} which converts `unknown` to an array of `<T>`.
  * @remarks
  * If `onError` is `'failOnError'` (default), then the entire conversion fails if any element cannot
  * be converted.  If `onError` is `'ignoreErrors'`, then failing elements are silently ignored.
- * @param converter - {@link Converter} used to convert each item in the array.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} used to convert each
+ * item in the array.
  * @param ignoreErrors - Specifies treatment of unconvertible elements.
- * @returns A {@link Converter} which returns an array of `<T>`.
+ * @returns A {@link Converter | Converter} which returns an array of `<T>`.
  * @public
  */
-export declare function arrayOf<T, TC = undefined>(converter: Converter<T, TC>, onError?: OnError): Converter<T[], TC>;
+export declare function arrayOf<T, TC = undefined>(converter: Converter<T, TC> | Validator<T, TC>, onError?: OnError): Converter<T[], TC>;
 /**
- * {@link Converter} to convert an `unknown` to an array of `string`.
+ * {@link Converter | Converter} to convert an `unknown` to an array of `string`.
  * @remarks
- * Returns {@link Success} with the the supplied value if it as an array
- * of strings, returns {@link Failure} with an error message otherwise.
+ * Returns {@link Success | Success} with the the supplied value if it as an array
+ * of strings, returns {@link Failure | Failure} with an error message otherwise.
  * @public
  */
 export declare const stringArray: Converter<string[]>;
@@ -196,90 +200,99 @@ export interface KeyedConverterOptions<T extends string = string, TC = undefined
      * @remarks
      * Can be used to coerce key names to supported values and/or strong types.
      */
-    keyConverter?: Converter<T, TC>;
+    keyConverter?: Converter<T, TC> | Validator<T, TC>;
 }
 /**
- * A helper function to create a {@link Converter} which converts the `string`-keyed properties
- * using a supplied {@link Converter | Converter<T>} to produce a `Record<string, T>`.
+ * A helper function to create a {@link Converter | Converter} which converts the `string`-keyed
+ * properties using a supplied {@link Converter | Converter<T>} or {@link Validator | Validator<T>} to
+ * produce a `Record<string, T>`.
  * @remarks
  * The resulting converter fails conversion if any element cannot be converted.
- * @param converter - {@link Converter} used to convert each item in the source object.
- * @returns A {@link Converter} which returns `Record<string, T>`.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} used for each
+ * item in the source object.
+ * @returns A {@link Converter | Converter} which returns `Record<string, T>`.
  * {@label WITH_DEFAULT}
  * @public
  */
-export declare function recordOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC>): Converter<Record<TK, T>, TC>;
+export declare function recordOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC> | Validator<T, TC>): Converter<Record<TK, T>, TC>;
 /**
- * A helper function to create a {@link Converter} which converts the `string`-keyed properties
- * using a supplied {@link Converter | Converter<T>} to produce a `Record<string, T>` and optionally
- * specified handling of elements that cannot be converted.
+ * A helper function to create a {@link Converter | Converter} which converts the `string`-keyed properties
+ * using a supplied {@link Converter | Converter<T>} or {@link Validator | Validator<T>} to produce a
+ * `Record<string, T>` and optionally specified handling of elements that cannot be converted.
  * @remarks
  * if `onError` is `'fail'` (default), then the entire conversion fails if any key or element
  * cannot be converted.  If `onError` is `'ignore'`, failing elements are silently ignored.
- * @param converter - {@link Converter} used to convert each item in the source object.
- * @returns A {@link Converter} which returns `Record<string, T>`.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} for each item in
+ * the source object.
+ * @returns A {@link Converter | Converter} which returns `Record<string, T>`.
  * {@label WITH_ON_ERROR}
  * @public
  */
-export declare function recordOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC>, onError: 'fail' | 'ignore'): Converter<Record<TK, T>, TC>;
+export declare function recordOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC> | Validator<T, TC>, onError: 'fail' | 'ignore'): Converter<Record<TK, T>, TC>;
 /**
- * A helper function to create a {@link Converter} which converts the `string`-keyed properties
- * using a supplied {@link Converter | Converter<T>} to produce a `Record<TK, T>`.
+ * A helper function to create a {@link Converter | Converter} or which converts the `string`-keyed properties
+ * using a supplied {@link Converter | Converter<T>} or {@link Validator | Validator<T>} to produce a
+ * `Record<TK, T>`.
  * @remarks
  * If present, the supplied {@link Converters.KeyedConverterOptions | options} can provide a strongly-typed
  * converter for keys and/or control the handling of elements that fail conversion.
- * @param converter - {@link Converter} used to convert each item in the source object.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} used for each item in the source object.
  * @param options - Optional {@link Converters.KeyedConverterOptions | KeyedConverterOptions<TK, TC>} which
  * supplies a key converter and/or error-handling options.
- * @returns A {@link Converter} which returns `Record<TK, T>`.
+ * @returns A {@link Converter | Converter} which returns `Record<TK, T>`.
  * {@label WITH_OPTIONS}
  * @public
  */
-export declare function recordOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC>, options: KeyedConverterOptions<TK, TC>): Converter<Record<TK, T>, TC>;
+export declare function recordOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC> | Validator<T, TC>, options: KeyedConverterOptions<TK, TC>): Converter<Record<TK, T>, TC>;
 /**
- * A helper function to create a {@link Converter} which converts the `string`-keyed properties
- * using a supplied {@link Converter | Converter<T>} to produce a `Map<string, T>`.
+ * A helper function to create a {@link Converter | Converter} which converts the `string`-keyed properties
+ * using a supplied {@link Converter | Converter<T>} or {@link Validator | Validator<T>} to produce a
+ * `Map<string, T>`.
  * @remarks
  * The resulting converter fails conversion if any element cannot be converted.
- * @param converter - {@link Converter} used to convert each item in the source object.
- * @returns A {@link Converter} which returns `Map<string, T>`.
+ * @param converter - {@link Converter | Converter} | {@link Validator | Validator} used for each item in
+ * the source object.
+ * @returns A {@link Converter | Converter} which returns `Map<string, T>`.
  * {@label WITH_DEFAULT}
  * @public
  */
-export declare function mapOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC>): Converter<Map<TK, T>, TC>;
+export declare function mapOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC> | Validator<T, TC>): Converter<Map<TK, T>, TC>;
 /**
- * A helper function to create a {@link Converter} which converts the `string`-keyed properties
- * using a supplied {@link Converter | Converter<T>} to produce a `Map<string, T>` and optionally
- * specified handling of elements that cannot be converted.
+ * A helper function to create a {@link Converter | Converter} which converts the `string`-keyed properties
+ * using a supplied {@link Converter | Converter<T>} or {@link Validator | Validator<T>} to produce a
+ * `Map<string, T>` and specified handling of elements that cannot be converted.
  * @remarks
  * if `onError` is `'fail'` (default), then the entire conversion fails if any key or element
  * cannot be converted.  If `onError` is `'ignore'`, failing elements are silently ignored.
- * @param converter - {@link Converter} used to convert each item in the source object.
- * @returns A {@link Converter} which returns `Map<string, T>`.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} used for
+ * each item in the source object.
+ * @returns A {@link Converter | Converter} which returns `Map<string, T>`.
  * {@label WITH_ON_ERROR}
  * @public
  */
-export declare function mapOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC>, onError: 'fail' | 'ignore'): Converter<Map<TK, T>, TC>;
+export declare function mapOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC> | Validator<T, TC>, onError: 'fail' | 'ignore'): Converter<Map<TK, T>, TC>;
 /**
- * A helper function to create a {@link Converter} which converts the `string`-keyed properties
- * using a supplied {@link Converter | Converter<T>} to produce a `Map<TK, T>`.
+ * A helper function to create a {@link Converter | Converter} which converts the `string`-keyed properties
+ * using a supplied {@link Converter | Converter<T>} or {@link Validator | Validator<T>} to produce
+ * a `Map<TK,T>`.
  * @remarks
  * If present, the supplied {@link Converters.KeyedConverterOptions | options} can provide a strongly-typed
  * converter for keys and/or control the handling of elements that fail conversion.
- * @param converter - {@link Converter} used to convert each item in the source object.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} used for each item
+ * in the source object.
  * @param options - Optional {@link Converters.KeyedConverterOptions | KeyedConverterOptions<TK, TC>} which
  * supplies a key converter and/or error-handling options.
- * @returns A {@link Converter} which returns `Map<TK, T>`.
+ * @returns A {@link Converter | Converter} which returns `Map<TK,T>`.
  * {@label WITH_OPTIONS}
  * @public
  */
-export declare function mapOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC>, options: KeyedConverterOptions<TK, TC>): Converter<Map<TK, T>, TC>;
+export declare function mapOf<T, TC = undefined, TK extends string = string>(converter: Converter<T, TC> | Validator<T, TC>, options: KeyedConverterOptions<TK, TC>): Converter<Map<TK, T>, TC>;
 /**
- * Helper function to create  a {@link Converter} which validates that a supplied value is
+ * Helper function to create  a {@link Converter | Converter} which validates that a supplied value is
  * of a type validated by a supplied validator function and returns it.
  * @remarks
- * If `validator` succeeds, this {@link Converter} returns {@link Success} with the supplied
- * value of `from` coerced to type `<T>`.  Returns a {@link Failure} with additional
+ * If `validator` succeeds, this {@link Converter | Converter} returns {@link Success | Success} with the supplied
+ * value of `from` coerced to type `<T>`.  Returns a {@link Failure | Failure} with additional
  * information otherwise.
  * @param validator - A validator function to determine if the converted value is valid.
  * @param description - A description of the validated type for use in error messages.
@@ -288,62 +301,63 @@ export declare function mapOf<T, TC = undefined, TK extends string = string>(con
  */
 export declare function validateWith<T, TC = undefined>(validator: (from: unknown) => from is T, description?: string): Converter<T, TC>;
 /**
- * A helper function to create a {@link Converter} which extracts and converts an element from an array.
+ * A helper function to create a {@link Converter | Converter} which extracts and converts an element from an array.
  * @remarks
- * The returned {@link Converter} returns {@link Success} with the converted value if the element exists
- * in the supplied array and can be converted. Returns {@link Failure} with an error message otherwise.
+ * The returned {@link Converter | Converter} returns {@link Success | Success} with the converted value if the element exists
+ * in the supplied array and can be converted. Returns {@link Failure | Failure} with an error message otherwise.
  * @param index - The index of the element to be extracted.
- * @param converter - A {@link Converter} used to convert the extracted element.
+ * @param converter - A {@link Converter | Converter} or {@link Validator | Validator} for the extracted element.
  * @returns A {@link Converter | Converter<T>} which extracts the specified element from an array.
  * @public
  */
-export declare function element<T, TC = undefined>(index: number, converter: Converter<T, TC>): Converter<T, TC>;
+export declare function element<T, TC = undefined>(index: number, converter: Converter<T, TC> | Validator<T, TC>): Converter<T, TC>;
 /**
- * A helper function to create a {@link Converter} which extracts and converts an optional element from an array.
+ * A helper function to create a {@link Converter | Converter} which extracts and converts an optional element from an array.
  * @remarks
- * The resulting {@link Converter} returns {@link Success} with the converted value if the element exists
- * in the supplied array and can be converted. Returns {@link Success} with value `undefined` if the parameter
- * is an array but the index is out of range. Returns {@link Failure} with a message if the supplied parameter
+ * The resulting {@link Converter | Converter} returns {@link Success | Success} with the converted value if the element exists
+ * in the supplied array and can be converted. Returns {@link Success | Success} with value `undefined` if the parameter
+ * is an array but the index is out of range. Returns {@link Failure | Failure} with a message if the supplied parameter
  * is not an array, if the requested index is negative, or if the element cannot be converted.
  * @param index - The index of the element to be extracted.
- * @param converter - A {@link Converter} used to convert the extracted element.
+ * @param converter - A {@link Converter | Converter} or {@link Validator | Validator} used for the extracted element.
  * @returns A {@link Converter | Converter<T>} which extracts the specified element from an array.
  * @public
  */
-export declare function optionalElement<T, TC = undefined>(index: number, converter: Converter<T, TC>): Converter<T | undefined, TC>;
+export declare function optionalElement<T, TC = undefined>(index: number, converter: Converter<T, TC> | Validator<T, TC>): Converter<T | undefined, TC>;
 /**
- * A helper function to create a {@link Converter} which extracts and convert a property specified
+ * A helper function to create a {@link Converter | Converter} which extracts and convert a property specified
  * by name from an object.
  * @remarks
- * The resulting {@link Converter} returns {@link Success} with the converted value of the corresponding
- * object property if the field exists and can be converted. Returns {@link Failure} with an error message
+ * The resulting {@link Converter | Converter} returns {@link Success | Success} with the converted value of the corresponding
+ * object property if the field exists and can be converted. Returns {@link Failure | Failure} with an error message
  * otherwise.
  * @param name - The name of the field to be extracted.
- * @param converter - {@link Converter} used to convert the extracted field.
+ * @param converter - {@link Converter | Converter}  or {@link Validator | Validator} to use for the extracted
+ * field.
  * @public
  */
-export declare function field<T, TC = undefined>(name: string, converter: Converter<T, TC>): Converter<T, TC>;
+export declare function field<T, TC = undefined>(name: string, converter: Converter<T, TC> | Validator<T, TC>): Converter<T, TC>;
 /**
- * A helper function to create a {@link Converter} which extracts and convert a property specified
+ * A helper function to create a {@link Converter | Converter} which extracts and convert a property specified
  * by name from an object.
  * @remarks
- * The resulting {@link Converter} returns {@link Success} with the converted value of the corresponding
- * object property if the field exists and can be converted. Returns {@link Success} with value `undefined`
- * if the supplied parameter is an object but the named field is not present.  Returns {@link Failure} with
- * an error message otherwise.
+ * The resulting {@link Converter | Converter} returns {@link Success | Success} with the converted value of
+ * the corresponding object property if the field exists and can be converted. Returns {@link Success | Success}
+ * with `undefined` if the supplied parameter is an object but the named field is not present.
+ * Returns {@link Failure | Failure} with an error message otherwise.
  * @param name - The name of the field to be extracted.
- * @param converter - {@link Converter} used to convert the extracted field.
+ * @param converter - {@link Converter | Converter} or {@link Validator | Validator} to use for the extracted field.
  * @public
  */
-export declare function optionalField<T, TC = undefined>(name: string, converter: Converter<T, TC>): Converter<T | undefined, TC>;
+export declare function optionalField<T, TC = undefined>(name: string, converter: Converter<T, TC> | Validator<T, TC>): Converter<T | undefined, TC>;
 /**
  * Helper function to create a {@link Conversion.ObjectConverter | ObjectConverter<T>} which converts an object
  * without changing shape, given a {@link Conversion.FieldConverters | FieldConverters<T>} and an optional
  * {@link Conversion.ObjectConverterOptions | ObjectConverterOptions<T>} to further refine conversion behavior.
  * @remarks
- * By default, if all of the requested fields exist and can be converted, returns {@link Success}
+ * By default, if all of the requested fields exist and can be converted, returns {@link Success | Success}
  * with a new object that contains the converted values under the original key names.  If any required properties
- * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure} with additional
+ * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure | Failure} with additional
  * error information.
  *
  * Fields that succeed but convert to undefined are omitted from the result object but do not
@@ -362,9 +376,9 @@ export declare function object<T>(properties: FieldConverters<T>, options?: Obje
  * without changing shape, given a {@link Conversion.FieldConverters | FieldConverters<T>} and a set of
  * optional properties.
  * @remarks
- * By default, if all of the requested fields exist and can be converted, returns {@link Success}
+ * By default, if all of the requested fields exist and can be converted, returns {@link Success | Success}
  * with a new object that contains the converted values under the original key names.  If any required properties
- * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure} with additional
+ * do not exist or cannot be converted, the entire conversion fails, returning {@link Failure | Failure} with additional
  * error information.
  *
  * Fields that succeed but convert to undefined are omitted from the result object but do not
@@ -423,36 +437,36 @@ export declare function strictObject<T>(properties: FieldConverters<T>, options?
  */
 export declare function strictObject<T>(properties: FieldConverters<T>, optional: (keyof T)[]): ObjectConverter<T>;
 /**
- * A string-keyed `Record<string, Converter>` which maps specific {@link Converter | converters} to the
- * value of a discriminator property.
+ * A string-keyed `Record<string, Converter>` which maps specific {@link Converter | converters} or
+ * {@link Validator | Validators} to the value of a discriminator property.
  * @public
  */
-export type DiscriminatedObjectConverters<T, TD extends string = string, TC = unknown> = Record<TD, Converter<T, TC>>;
+export type DiscriminatedObjectConverters<T, TD extends string = string, TC = unknown> = Record<TD, Converter<T, TC> | Validator<T, TC>>;
 /**
- * Helper to create a {@link Converter} which converts a discriminated object without changing shape.
+ * Helper to create a {@link Converter | Converter} which converts a discriminated object without changing shape.
  * @remarks
  * Takes the name of the discriminator property and a
- * {@link Converters.DiscriminatedObjectConverters | string-keyed Record of converters}. During conversion,
- * the resulting {@link Converter} invokes the converter from `converters` that corresponds to the value of
+ * {@link Converters.DiscriminatedObjectConverters | string-keyed Record of converters and validators}. During conversion,
+ * the resulting {@link Converter | Converter} invokes the converter from `converters` that corresponds to the value of
  * the discriminator property in the source object.
  *
  * If the source is not an object, the discriminator property is missing, or the discriminator has
- * a value not present in the converters, conversion fails and returns {@link Failure} with more information.
+ * a value not present in the converters, conversion fails and returns {@link Failure | Failure} with more information.
  * @param discriminatorProp - Name of the property used to discriminate types.
- * @param converters - {@link Converters.DiscriminatedObjectConverters | String-keyed record of converters} to
- * invoke, where each key corresponds to a value of the discriminator property.
- * @returns A {@link Converter} which converts the corresponding discriminated object.
+ * @param converters - {@link Converters.DiscriminatedObjectConverters | String-keyed record of converters and validators}
+ * to invoke, where each key corresponds to a value of the discriminator property.
+ * @returns A {@link Converter | Converter} which converts the corresponding discriminated object.
  * @public
  */
 export declare function discriminatedObject<T, TD extends string = string, TC = unknown>(discriminatorProp: string, converters: DiscriminatedObjectConverters<T, TD>): Converter<T, TC>;
 /**
- * Helper to create a {@link Converter} which converts a source object to a new object with a
+ * Helper to create a {@link Converter | Converter} which converts a source object to a new object with a
  * different shape.
  *
  * @remarks
- * On successful conversion, the resulting {@link Converter} returns {@link Success} with a new
+ * On successful conversion, the resulting {@link Converter | Converter} returns {@link Success | Success} with a new
  * object, which contains the converted values under the key names specified at initialization time.
- * It returns {@link Failure} with an error message if any fields to be extracted do not exist
+ * It returns {@link Failure | Failure} with an error message if any fields to be extracted do not exist
  * or cannot be converted.
  *
  * Fields that succeed but convert to undefined are omitted from the result object but do not
@@ -461,7 +475,7 @@ export declare function discriminatedObject<T, TD extends string = string, TC =
  * @param properties - An object with key names that correspond to the target object and an
  * appropriate {@link Conversion.FieldConverters | FieldConverter} which extracts and converts
  * a single filed from the source object.
- * @returns A {@link Converter} with the specified conversion behavior.
+ * @returns A {@link Converter | Converter} with the specified conversion behavior.
  * @public
  */
 export declare function transform<T, TC = unknown>(properties: FieldConverters<T, TC>): Converter<T, TC>;
@@ -473,13 +487,13 @@ export declare function transform<T, TC = unknown>(properties: FieldConverters<T
 export type FieldTransformers<TSRC, TDEST, TC = unknown> = {
     [key in keyof TDEST]: {
         /**
-         * The name of the property in the source object to be converter.
+         * The name of the property in the source object to be converted.
          */
         from: keyof TSRC;
         /**
-         * The converter used to convert the property.
+         * The converter or validator used to convert the property.
          */
-        converter: Converter<TDEST[key], TC>;
+        converter: Converter<TDEST[key], TC> | Validator<TDEST[key], TC>;
         /**
          * If `true` then a missing source property is ignored.  If `false` or omitted
          * then a missing source property causes an error.
@@ -508,23 +522,23 @@ export interface TransformObjectOptions<TSRC> {
     description?: string;
 }
 /**
- * Helper to create a strongly-typed {@link Converter} which converts a source object to a
+ * Helper to create a strongly-typed {@link Converter | Converter} which converts a source object to a
  * new object with a different shape.
  *
  * @remarks
- * On successful conversion, the resulting {@link Converter} returns {@link Success} with a new
+ * On successful conversion, the resulting {@link Converter | Converter} returns {@link Success | Success} with a new
  * object, which contains the converted values under the key names specified at initialization time.
  *
- * It returns {@link Failure} with an error message if any fields to be extracted do not exist
+ * It returns {@link Failure | Failure} with an error message if any fields to be extracted do not exist
  * or cannot be converted.
  *
  * @param destinationFields - An object with key names that correspond to the target object and an
  * appropriate {@link Converters.FieldTransformers | FieldTransformers} which specifies the name
- * of the corresponding property in the source object, the converter used to convert the source
- * property and any configuration to guide the conversion.
+ * of the corresponding property in the source object, the converter or validator used for each source
+ * property and any other configuration to guide the conversion.
  * @param options - Options which affect the transformation.
  *
- * @returns A {@link Converter} with the specified conversion behavior.
+ * @returns A {@link Converter | Converter} with the specified conversion behavior.
  * @public
  */
 export declare function transformObject<TSRC, TDEST, TC = unknown>(destinationFields: FieldTransformers<TSRC, TDEST, TC>, options?: TransformObjectOptions<TSRC>): Converter<TDEST, TC>;

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

@@ -1 +1 @@
-{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/converters.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAiB,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKpD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,cAAc,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,eAAuC,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAMjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAazG;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAQ1D;AAED;;;;;GAKG;AAEH,eAAO,MAAM,KAAK,gBAAU,CAAC;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAM9C,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAYhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,OAAO,CAAqB,CAAC;AAExF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,UAAU,GAAG,KAAkB,GACvC,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAc7B;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAa3C,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAIxF;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,GACjC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAOlB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAqB,CAAC;AAE/E;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAsB,CAAC;AAElF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EACnC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EACnC,OAAO,GAAE,OAAwB,GAChC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAkBlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EACvC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3B,OAAO,GAAE,OAAuB,GAC/B,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAmBpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,CAAmB,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,CAAmB,CAAC;AAEhE;;;;;GAKG;AAEH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,SAAS;IAC9E;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EACpE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAC1B,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EACpE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3B,OAAO,EAAE,MAAM,GAAG,QAAQ,GACzB,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EACpE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3B,OAAO,EAAE,qBAAqB,CAAC,EAAE,EAAE,EAAE,CAAC,GACrC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AA4ChC;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EACjE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAC1B,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EACjE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3B,OAAO,EAAE,MAAM,GAAG,QAAQ,GACzB,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EACjE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAC3B,OAAO,EAAE,qBAAqB,CAAC,EAAE,EAAE,EAAE,CAAC,GACrC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AA2C7B;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,EACvC,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAOlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAWvG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAC/C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAC1B,SAAS,CAAC,CAAC,GAAG,SAAS,EAAE,EAAE,CAAC,CAW9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAYpG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAC7C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAC1B,SAAS,CAAC,CAAC,GAAG,SAAS,EAAE,EAAE,CAAC,CAuB9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,eAAe,CAAC,CAAC,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAarG;;;GAGG;AACH,MAAM,MAAM,4BAA4B,CAAC,CAAC,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAExF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACxC,eAAe,CAAC,CAAC,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAgB3G;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,CAAC,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,OAAO,IAAI,MAAM,CAC7F,EAAE,EACF,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,OAAO,EAC7E,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,6BAA6B,CAAC,CAAC,EAAE,EAAE,CAAC,GAC/C,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAgBlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAoB/F;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,IAAI;KACxD,GAAG,IAAI,MAAM,KAAK,GAAG;QACpB;;WAEG;QACH,IAAI,EAAE,MAAM,IAAI,CAAC;QACjB;;WAEG;QACH,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;CACF,CAAC;AAEF;;;GAGG;AAEH,MAAM,WAAW,sBAAsB,CAAC,IAAI;IAC1C;;;OAGG;IACH,MAAM,EAAE,IAAI,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EACvD,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,EACrD,OAAO,CAAC,EAAE,sBAAsB,CAAC,IAAI,CAAC,GACrC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CA2CtB"}
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/converters.ts"],"names":[],"mappings":"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"}