@fgv/ts-utils 5.0.0-2 → 5.0.0-21

package/src/packlets/validation/validator.ts

@@ -0,0 +1,157 @@
+/*
+ * Copyright (c) 2021 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Brand, Failure, Result } from '../base';
+import { ConstraintTrait, ValidatorTraits } from './traits';
+
+/**
+ * Type for a validation function, which validates that a supplied `unknown`
+ * value is a valid value of type `<T>`, possibly as influenced by
+ * an optionally-supplied validation context of type `<TC>`.
+ * @public
+ */
+export type ValidatorFunc<T, TC> = (
+  from: unknown,
+  context?: TC,
+  self?: Validator<T, TC>
+) => boolean | Failure<T>;
+
+/**
+ * Options that apply to any {@link Validation.Validator | Validator}.
+ * @public
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export interface ValidatorOptions<TC> {
+  defaultContext?: TC;
+}
+
+/**
+ * A {@link Validation.Constraint | Constraint<T>} function returns
+ * `true` if the supplied value meets the constraint. Can return
+ * {@link Failure} with an error message or simply return `false`
+ * for a default message.
+ * @public
+ */
+export type Constraint<T> = (val: T) => boolean | Failure<T>;
+
+/**
+ * Formats an incoming error message and value that failed validation.
+ * @param val - The value that failed validation.
+ * @param message - The default error message, if any.
+ * @param context - Optional validation context.
+ * @returns The formatted error message.
+ * @public
+ */
+export type ValidationErrorFormatter<TC = unknown> = (val: unknown, message?: string, context?: TC) => string;
+
+/**
+ * In-place validation that a supplied unknown matches some
+ * required characteristics (type, values, etc).
+ * @public
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export interface Validator<T, TC = unknown> {
+  /**
+   * {@link Validation.ValidatorTraits | Traits} describing this validation.
+   */
+  readonly traits: ValidatorTraits;
+
+  /**
+   * Indicates whether this element is explicitly optional.
+   */
+  readonly isOptional: boolean;
+
+  /**
+   * The brand for a branded type.
+   */
+  readonly brand: string | undefined;
+
+  /**
+   * Tests to see if a supplied `unknown` value matches this validation.  All
+   * validate calls are guaranteed to return the entity passed in on Success.
+   * @param from - The `unknown` value to be tested.
+   * @param context - Optional validation context.
+   * @returns {@link Success} with the typed, validated value,
+   * or {@link Failure} with an error message if validation fails.
+   */
+  validate(from: unknown, context?: TC): Result<T>;
+
+  /**
+   * Tests to see if a supplied 'unknown' value matches this validation.  In
+   * contrast to {@link Validator.validate | validate}, makes no guarantees
+   * about the identity of the returned value.
+   * @param from - The `unknown` value to be tested.
+   * @param context - Optional validation context.
+   * @returns {@link Success} with the typed, conversion value,
+   * or {@link Failure} with an error message if conversion fails.
+   */
+  convert(from: unknown, context?: TC): Result<T>;
+
+  /**
+   * Tests to see if a supplied `unknown` value matches this
+   * validation.  Accepts `undefined`.
+   * @param from - The `unknown` value to be tested.
+   * @param context - Optional validation context.
+   * @returns {@link Success} with the typed, validated value,
+   * or {@link Failure} with an error message if validation fails.
+   */
+  validateOptional(from: unknown, context?: TC): Result<T | undefined>;
+
+  /**
+   * Non-throwing type guard
+   * @param from - The value to be tested.
+   * @param context - Optional validation context.
+   */
+  guard(from: unknown, context?: TC): from is T;
+
+  /**
+   * Creates an {@link Validation.Validator | in-place validator}
+   * which is derived from this one but which also matches `undefined`.
+   */
+  optional(): Validator<T | undefined, TC>;
+
+  /**
+   * Creates an {@link Validation.Validator | in-place validator}
+   * which is derived from this one but which applies additional constraints.
+   * @param constraint - the constraint to be applied
+   * @param trait - As optional {@link Validation.ConstraintTrait | ConstraintTrait}
+   * to be applied to the resulting {@link Validation.Validator | Validator}.
+   * @returns A new {@link Validation.Validator | Validator}.
+   */
+  withConstraint(constraint: Constraint<T>, trait?: ConstraintTrait): Validator<T, TC>;
+
+  /**
+   * Creates a new {@link Validation.Validator | in-place validator} which
+   * is derived from this one but which matches a branded result.
+   * @param brand - The brand to be applied.
+   */
+  withBrand<B extends string>(brand: B): Validator<Brand<T, B>, TC>;
+
+  /**
+   * Creates a new {@link Validation.Validator | in-place validator} which
+   * is derived from this one but which returns an error message supplied
+   * by the provided formatter if an error occurs.
+   * @param formatter - The error message formatter to be applied.
+   * @returns A new {@link Validation.Validator | Validator}.
+   */
+  withFormattedError(formatter: ValidationErrorFormatter<TC>): Validator<T, TC>;
+}

package/src/packlets/validation/validatorBase.ts

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2021 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { GenericValidator, GenericValidatorConstructorParams } from './genericValidator';
+
+import { Failure } from '../base';
+
+/**
+ * @internal
+ */
+export type ValidatorBaseConstructorParams<T, TC> = Omit<
+  GenericValidatorConstructorParams<T, TC>,
+  'validator'
+>;
+
+/**
+ * Abstract base helper class for specific validator implementations
+ * @internal
+ */
+export abstract class ValidatorBase<T, TC = unknown> extends GenericValidator<T, TC> {
+  /**
+   * Inner constructor
+   * @param params - Initialization params.
+   * @internal
+   */
+  protected constructor(params: Partial<ValidatorBaseConstructorParams<T, TC>>) {
+    super({
+      validator: (from, context, self) => this._validate(from, context, self),
+      ...params
+    });
+  }
+
+  /**
+   * Abstract validation method to me implemented by derived classes.
+   * @param from - Value to be converted.
+   * @param context - Optional validation context.
+   * @param self - Optional self-reference for recursive validation.
+   * @returns `true` if `from` is valid, {@link Failure | Failure<T>}
+   * with an error message if `from` is invalid.
+   * @internal
+   */
+  protected abstract _validate(
+    from: unknown,
+    context?: TC,
+    self?: import('./validator').Validator<T, TC>
+  ): boolean | Failure<T>;
+}

package/src/packlets/validation/validators.ts

@@ -0,0 +1,254 @@
+/*
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Failure, fail, isKeyOf, MessageAggregator } from '../base';
+import { ArrayValidator, ArrayValidatorConstructorParams } from './array';
+import { FieldValidators, ObjectValidator, ObjectValidatorConstructorParams } from './object';
+import { TypeGuardValidator, TypeGuardValidatorConstructorParams } from './typeGuard';
+
+import { BooleanValidator } from './boolean';
+import { TypeGuardWithContext } from './common';
+import { GenericValidator } from './genericValidator';
+import { NumberValidator } from './number';
+import { OneOfValidator, OneOfValidatorConstructorParams } from './oneOf';
+import { StringValidator } from './string';
+import { Validator, ValidatorFunc } from './validator';
+
+/**
+ * A {@link Validation.Classes.StringValidator | StringValidator} which validates a string in place.
+ * @public
+ */
+export const string: Validator<string> = new StringValidator();
+
+/**
+ * A {@link Validation.Classes.NumberValidator | NumberValidator} which validates a number in place.
+ * @public
+ */
+export const number: Validator<number> = new NumberValidator();
+
+/**
+ * A {@link Validation.Classes.BooleanValidator | BooleanValidator} which validates a boolean in place.
+ * @public
+ */
+export const boolean: Validator<boolean> = new BooleanValidator();
+
+/**
+ * Helper function to create a {@link Validation.Classes.ObjectValidator | ObjectValidator} which validates
+ * an object in place.
+ * @param fields - A {@link Validation.Classes.FieldValidators | field validator definition}
+ * describing the validations to be applied.
+ * @param params - Optional {@link Validation.Classes.ObjectValidatorConstructorParams | parameters}
+ * to refine the behavior of the resulting {@link Validation.Validator | validator}.
+ * @returns A new {@link Validation.Validator | Validator} which validates the desired
+ * object in place.
+ * @public
+ */
+export function object<T, TC = unknown>(
+  fields: FieldValidators<T, TC>,
+  params?: Omit<ObjectValidatorConstructorParams<T, TC>, 'fields'>
+): ObjectValidator<T, TC> {
+  return new ObjectValidator({ fields, ...(params ?? {}) });
+}
+
+/**
+ * Helper function to create a {@link Validation.Classes.ArrayValidator | ArrayValidator} which
+ * validates an array in place.
+ * @param validateElement - A {@link Validation.Validator | validator} which validates each element.
+ * @returns A new {@link Validation.Classes.ArrayValidator | ArrayValidator } which validates the desired
+ * array in place.
+ * @public
+ */
+export function arrayOf<T, TC>(
+  validateElement: Validator<T, TC>,
+  params?: Omit<ArrayValidatorConstructorParams<T, TC>, 'validateElement'>
+): ArrayValidator<T, TC> {
+  return new ArrayValidator({ validateElement, ...(params ?? {}) });
+}
+
+/**
+ * Options for {@link Validators.recordOf} helper function.
+ * @public
+ */
+export interface IRecordOfValidatorOptions<TK extends string = string, TC = unknown> {
+  /**
+   * If `onError` is `'fail'` (default), then the entire validation fails if any key or element
+   * cannot be validated. If `onError` is `'ignore'`, failing elements are silently ignored.
+   */
+  onError?: 'fail' | 'ignore';
+  /**
+   * If present, `keyValidator` is used to validate the source object property names.
+   * @remarks
+   * Can be used to validate key names to supported values and/or strong types.
+   */
+  keyValidator?: Validator<TK, TC>;
+}
+
+/**
+ * A helper function to create a {@link Validation.Validator | Validator} which validates the `string`-keyed properties
+ * using a supplied {@link Validation.Validator | Validator<T, TC>} to produce a `Record<TK, T>`.
+ * @remarks
+ * If present, the supplied {@link Validators.IRecordOfValidatorOptions | options} can provide a strongly-typed
+ * validator for keys and/or control the handling of elements that fail validation.
+ * @param validator - {@link Validation.Validator | Validator} used for each item in the source object.
+ * @param options - Optional {@link Validators.IRecordOfValidatorOptions | IRecordOfValidatorOptions<TK, TC>} which
+ * supplies a key validator and/or error-handling options.
+ * @returns A {@link Validation.Validator | Validator} which validates `Record<TK, T>`.
+ * @public
+ */
+export function recordOf<T, TC = unknown, TK extends string = string>(
+  validator: Validator<T, TC>,
+  options?: IRecordOfValidatorOptions<TK, TC>
+): Validator<Record<TK, T>, TC> {
+  const opts: IRecordOfValidatorOptions<TK, TC> = { onError: 'fail', ...options };
+
+  return new GenericValidator({
+    validator: (
+      from: unknown,
+      context?: TC,
+      self?: Validator<Record<TK, T>, TC>
+    ): boolean | Failure<Record<TK, T>> => {
+      if (typeof from !== 'object' || from === null || Array.isArray(from)) {
+        return fail(`Not a string-keyed object: ${JSON.stringify(from)}`);
+      }
+
+      const errors = new MessageAggregator();
+
+      for (const key in from) {
+        if (isKeyOf(key, from)) {
+          // Validate key if keyValidator is provided
+          if (opts.keyValidator) {
+            const keyResult = opts.keyValidator.validate(key, context);
+            if (!keyResult.isSuccess()) {
+              if (opts.onError === 'ignore') {
+                continue;
+              }
+              errors.addMessage(`Key "${key}": ${keyResult.message}`);
+              if (opts.onError === 'fail') {
+                return fail(keyResult.message);
+              }
+            }
+          }
+
+          // Validate value
+          const valueResult = validator.validate(from[key] as unknown, context);
+          if (!valueResult.isSuccess()) {
+            if (opts.onError === 'ignore') {
+              continue;
+            }
+            errors.addMessage(`Property "${key}": ${valueResult.message}`);
+            if (opts.onError === 'fail') {
+              return fail(valueResult.message);
+            }
+          }
+        }
+      }
+
+      /* c8 ignore next 1 - defense in depth */
+      return errors.hasMessages ? fail(errors.toString()) : true;
+    }
+  });
+}
+
+/**
+ * Helper function to create a {@link Validation.Validator} which validates an enumerated
+ * value in place.
+ * @public
+ */
+export function enumeratedValue<T extends string>(values: ReadonlyArray<T>): Validator<T, ReadonlyArray<T>> {
+  return new GenericValidator({
+    validator: (
+      from: unknown,
+      context?: ReadonlyArray<T>,
+      self?: Validator<T, ReadonlyArray<T>>
+    ): boolean | Failure<T> => {
+      if (typeof from === 'string') {
+        const v = context ?? values;
+        const index = v.indexOf(from as T);
+        return index >= 0 ? true : fail(`Invalid enumerated value "${from}"  - expected: (${v.join(', ')})`);
+      }
+      return fail(`Not a string: "${JSON.stringify(from, undefined, 2)}`);
+    }
+  });
+}
+
+/**
+ * Helper function to create a {@link Validation.Validator} which validates a literal value.
+ * @param value - the literal value to be validated
+ * @public
+ */
+export function literal<T extends string | number | boolean | symbol | null | undefined>(
+  value: T
+): Validator<T> {
+  return new GenericValidator({
+    validator: (from: unknown, context?: unknown, self?: Validator<T>): boolean | Failure<T> => {
+      return from === value
+        ? true
+        : fail(`Expected literal ${String(value)}, found "${JSON.stringify(from, undefined, 2)}`);
+    }
+  });
+}
+
+/**
+ * Helper function to create a {@link Validation.Validator | Validator} which validates one
+ * of several possible validated values.
+ * @param validators - the {@link Validation.Validator | validators} to be considered.
+ * @param params - Optional {@link Validation.Classes.OneOfValidatorConstructorParams | params} used to construct the validator.
+ * @returns A new {@link Validator | Validator} which validates values that match any of
+ * the supplied validators.
+ * @public
+ */
+export function oneOf<T, TC = unknown>(
+  validators: Array<Validator<T, TC>>,
+  params?: Omit<OneOfValidatorConstructorParams<T, TC>, 'validators'>
+): OneOfValidator<T, TC> {
+  return new OneOfValidator<T, TC>({ ...(params ?? {}), validators });
+}
+
+/**
+ * Helper function to create a {@link Validation.Classes.TypeGuardValidator | TypeGuardValidator} which
+ * validates a value or object in place.
+ * @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 Validation.Classes.TypeGuardValidator | TypeGuardValidator } which validates
+ * the values using the supplied type guard.
+ * @public
+ */
+export function isA<T, TC = unknown>(
+  description: string,
+  guard: TypeGuardWithContext<T, TC>,
+  params?: Omit<TypeGuardValidatorConstructorParams<T, TC>, 'description' | 'guard'>
+): TypeGuardValidator<T, TC> {
+  return new TypeGuardValidator({ description, guard, ...(params ?? {}) });
+}
+
+/**
+ * Helper function to create a {@link Validation.Validator | Validator} using a
+ * supplied {@link Validation.ValidatorFunc | validator function}.
+ * @param validator - A {@link Validation.ValidatorFunc | validator function} that a
+ * supplied unknown value matches some condition.
+ * @returns A new {@link Validation.Validator | Validator} which validates the desired
+ * value using the supplied function.
+ * @public
+ */
+export function generic<T, TC = unknown>(validator: ValidatorFunc<T, TC>): Validator<T, TC> {
+  return new GenericValidator({ validator });
+}

package/CHANGELOG.md

@@ -1,135 +0,0 @@
-# Change Log - @fgv/ts-utils
-
-This log was last generated on Thu, 17 Jul 2025 00:13:24 GMT and should not be manually modified.
-
-## 5.0.0
-Thu, 17 Jul 2025 00:13:24 GMT
-
-### Updates
-
-- add result helpers, clean up object converter
-- object converter partial/required helpers
-- add Result.withErrorFormat
-- bump version
-
-## 4.6.0
-Wed, 02 Jul 2025 05:48:16 GMT
-
-_Version update only_
-
-## 4.5.1
-Wed, 02 Jul 2025 05:47:11 GMT
-
-### Updates
-
-- use IterableIterator instead of MapIterator
-- update rushstack
-
-## 4.5.0
-Tue, 01 Jul 2025 03:26:11 GMT
-
-### Minor changes
-
-- add recordOf validator for validating Record<string, T> objects
-
-### Updates
-
-- update collectors
-- rework collections for better usability
-
-## 4.4.0
-Sat, 01 Feb 2025 17:13:10 GMT
-
-_Version update only_
-
-## 4.3.0
-Thu, 30 Jan 2025 00:35:17 GMT
-
-### Updates
-
-- add collector, convertingResultMap, convertingCollector
-
-## 4.2.2
-Thu, 23 Jan 2025 06:19:32 GMT
-
-### Updates
-
-- QoL improvements to Success/Failure
-
-## 4.2.1
-Tue, 21 Jan 2025 04:19:21 GMT
-
-### Updates
-
-- allow factories in getOrAdd
-
-## 4.2.0
-Mon, 20 Jan 2025 09:46:53 GMT
-
-### Updates
-
-- add collections packlet and ResultMap class
-- add withFormattedError on validator and converter
-- clean up type inconsistencies, relax some constraints
-
-## 4.1.0
-Thu, 09 Jan 2025 05:33:39 GMT
-
-### Updates
-
-- update dependencies
-
-## 4.0.2
-Tue, 14 May 2024 14:45:53 GMT
-
-_Version update only_
-
-## 4.0.1
-Tue, 14 May 2024 05:02:20 GMT
-
-### Updates
-
-- publish
-- import TextEncoder to avoid globals race
-
-## 4.0.0
-Tue, 14 May 2024 03:09:27 GMT
-
-### Updates
-
-- rework validation/converter compatibility a bit
-- QoL improvement to simplify error aggregation
-- factor optional converters out to ts-extras package to eliminate large dependencies
-- update generated api docs
-- add convalidate helper
-- add defaulting converter
-- extend conversion to accept validators
-- export StringConverter at top level
-
-## 3.0.0
-Mon, 22 Jan 2024 07:00:18 GMT
-
-### Updates
-
-- gitignore tweaks
-- refactor hash implementation
-- bump versions
-- refactor and cleanup
-- build changes
-- Factor out extras, enable shaking
-- bump dependencies
-- version upgrades
-- relax mapToRecord from Map to ReadonlyMap
-- bump version
-- add oneOf validator
-
-## 2.0.0
-Mon, 10 Apr 2023 03:33:11 GMT
-
-### Breaking changes
-
-- refactor and cleanup
-- reorganization and cleanup
-- more refactoring
-- refactor
-

package/lib/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EACL,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE9D,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,UAAU,EACX,CAAC"}

package/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,oEAAsD;AAqBpD,kCAAW;AApBb,kEAAoD;AAuBlD,gCAAU;AAtBZ,sDAAwC;AA0BtC,oBAAI;AAzBN,+DAAiD;AAwB/C,4BAAQ;AAvBV,kEAAoD;AAiClD,gCAAU;AA/BZ,wDASgC;AAO9B,0FAfA,uBAAS,OAeA;AACT,oGAdA,iCAAmB,OAcA;AASnB,0FArBA,uBAAS,OAqBA;AAET,oGAtBA,iCAAmB,OAsBA;AACnB,8GAtBA,2CAA6B,OAsBA;AAC7B,oGAtBA,iCAAmB,OAsBA;AApBrB,sDAAgG;AAU9F,2FAVkB,uBAAU,OAUlB;AAKV,gGAf8B,4BAAe,OAe9B;AAEf,gGAjB+C,4BAAe,OAiB/C;AAhBjB,sDAA8D;AAsB5D,2FAtBkB,uBAAU,OAsBlB;AApBZ,kDAAgC","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 * as Collections from './packlets/collections';\nimport * as Conversion from './packlets/conversion';\nimport * as Hash from './packlets/hash';\nimport * as FileTree from './packlets/file-tree';\nimport * as Validation from './packlets/validation';\n\nimport {\n  Collector,\n  ICollectible,\n  ConvertingCollector,\n  IReadOnlyResultMap,\n  ResultMap,\n  ValidatingCollector,\n  ValidatingConvertingCollector,\n  ValidatingResultMap\n} from './packlets/collections';\nimport { Converter, Converters, ObjectConverter, StringConverter } from './packlets/conversion';\nimport { Validator, Validators } from './packlets/validation';\n\nexport * from './packlets/base';\nexport {\n  Collections,\n  Collector,\n  ConvertingCollector,\n  Conversion,\n  Converter,\n  Converters,\n  FileTree,\n  Hash,\n  ICollectible,\n  IReadOnlyResultMap,\n  ObjectConverter,\n  ResultMap,\n  StringConverter,\n  ValidatingCollector,\n  ValidatingConvertingCollector,\n  ValidatingResultMap,\n  Validation,\n  Validator,\n  Validators\n};\n"]}

package/lib/packlets/base/brand.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/brand.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC"}

package/lib/packlets/base/brand.js.map

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AAEpC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAoC;AAQ3B,0BAAO;AANhB,0CAAwB;AACxB,+CAA6B;AAC7B,sDAAoC;AACpC,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AACnB,2CAAyB;AACzB,0CAAwB","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 * as Logging from './logger';\n\nexport * from './brand';\nexport * from './mapResults';\nexport * from './messageAggregator';\nexport { Normalizer } from './normalize';\nexport * from './result';\nexport * from './utils';\nexport { Logging };\n"]}

package/lib/packlets/base/logger.d.ts.map

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

package/lib/packlets/base/logger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/packlets/base/logger.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 */\nimport { Failure, Success, fail, succeed } from './result';\n\n/**\n * @public\n */\nexport type LogLevel = 'detail' | 'info' | 'warning' | 'error' | 'silent';\n\n/**\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface Logger {\n  log(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;\n  detail(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;\n  info(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;\n  warn(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;\n  warnAndFail<T>(message?: unknown, ...parameters: unknown[]): Failure<T>;\n  error<T>(message?: unknown, ...parameters: unknown[]): Failure<T>;\n}\n\n/**\n * @public\n */\nexport abstract class LoggerBase {\n  public logLevel: LogLevel = 'info';\n\n  public constructor(logLevel?: LogLevel) {\n    this.logLevel = logLevel ?? 'info';\n  }\n\n  public detail(message?: unknown, ...parameters: unknown[]): Success<string | undefined> {\n    if (this.logLevel === 'detail') {\n      return this.log(message, parameters);\n    }\n    return succeed(undefined);\n  }\n\n  public info(message?: unknown, ...parameters: unknown[]): Success<string | undefined> {\n    if (this.logLevel === 'detail' || this.logLevel === 'info') {\n      return this.log(message, parameters);\n    }\n    return succeed(undefined);\n  }\n\n  public warn(message?: unknown, ...parameters: unknown[]): Success<string | undefined> {\n    if (this.logLevel !== 'error' && this.logLevel !== 'silent') {\n      return this.log(message, parameters);\n    }\n    return succeed(undefined);\n  }\n\n  public warnAndFail<T>(message?: unknown, ...parameters: unknown[]): Failure<T> {\n    const formatted = this._format(message, ...parameters);\n    if (this.logLevel !== 'error' && this.logLevel !== 'silent') {\n      const result = this.log(formatted);\n      return fail(result.value ?? formatted);\n    }\n    return fail(formatted);\n  }\n\n  public error<T>(message?: unknown, ...parameters: unknown[]): Failure<T> {\n    const formatted = this._format(message, ...parameters);\n    if (this.logLevel !== 'silent') {\n      const result = this.log(formatted);\n      return fail(result.value ?? formatted);\n    }\n    return fail(formatted);\n  }\n\n  public log(message?: unknown, ...parameters: unknown[]): Success<string | undefined> {\n    const messageString = this._format(message, ...parameters);\n    if (this.logLevel === 'silent') {\n      return this._innerSilent(messageString);\n    }\n    return this._innerLog(messageString);\n  }\n\n  protected _format(message?: unknown, ...parameters: unknown[]): string {\n    const raw = [message, ...parameters];\n    const filtered = raw.filter((m): m is string => m !== undefined);\n    const strings = filtered.map((m) => m.toString());\n    const joined = strings.join('');\n    return joined;\n  }\n\n  protected _innerSilent(__message: string): Success<string | undefined> {\n    return succeed(undefined);\n  }\n\n  protected abstract _innerLog(message: string): Success<string | undefined>;\n}\n\n/**\n * @public\n */\nexport class InMemoryLogger extends LoggerBase {\n  protected _messages: string[] = [];\n  protected _silent: string[] = [];\n\n  public constructor(logLevel?: LogLevel) {\n    super(logLevel);\n  }\n\n  public get messages(): string[] {\n    return this._messages;\n  }\n  public get silent(): string[] {\n    return this._silent;\n  }\n\n  public clear(): void {\n    this._messages = [];\n    this._silent = [];\n  }\n\n  protected _innerLog(message: string): Success<string | undefined> {\n    this._messages.push(message);\n    return succeed(message);\n  }\n\n  protected _innerSilent(message: string): Success<string | undefined> {\n    this._silent.push(message);\n    return succeed(undefined);\n  }\n}\n\n/**\n * @public\n */\nexport class NoOpLogger extends LoggerBase {\n  protected _innerLog(message: string): Success<string | undefined> {\n    // no-op\n    return succeed(message);\n  }\n}\n"]}