@fgv/ts-utils 1.9.4 → 2.0.0

package/lib/packlets/record-jar/recordJarHelpers.js

@@ -0,0 +1,263 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRecordJarFileSync = exports.parseRecordJarLines = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const base_1 = require("../base");
+class RecordParser {
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    constructor(options) {
+        this.records = [];
+        this._fields = {};
+        this._name = undefined;
+        this._body = undefined;
+        this.options = options !== null && options !== void 0 ? options : {};
+    }
+    static parse(lines, options) {
+        return new RecordParser(options)._parse(lines);
+    }
+    static _parseRecordBody(body) {
+        const isContinuation = body.endsWith('\\');
+        if (isContinuation) {
+            body = body.slice(0, body.length - 1);
+        }
+        if (this._hasEscapes(body)) {
+            const result = this._replaceEscapes(body);
+            if (result.isFailure()) {
+                return (0, base_1.fail)(result.message);
+            }
+            body = result.value;
+        }
+        return (0, base_1.succeed)({ body, isContinuation });
+    }
+    static _hasEscapes(from) {
+        return from.includes('\\') || from.includes('&');
+    }
+    static _replaceEscapes(body) {
+        const invalid = [];
+        const escaped = body.replace(/(\\.)|(&#x[a-fA-F0-9]{2,6};)/g, (match) => {
+            switch (match) {
+                case '\\\\':
+                    return '\\';
+                case '\\&':
+                    return '&';
+                case '\\r':
+                    return '\r';
+                case '\\n':
+                    return '\n';
+                case '\\t':
+                    return '\t';
+            }
+            if (match.startsWith('&')) {
+                const hexCode = `0x${match.slice(3, match.length - 1)}`;
+                const charCode = Number.parseInt(hexCode, 16);
+                return String.fromCharCode(charCode);
+            }
+            invalid.push(match);
+            return '\\';
+        });
+        if (invalid.length > 0) {
+            return (0, base_1.fail)(`unrecognized escape "${invalid.join(', ')}" in record-jar body`);
+        }
+        return (0, base_1.succeed)(escaped);
+    }
+    static _applyOptions(record, options) {
+        if (options.arrayFields) {
+            record = Object.assign({}, record); // don't edit incoming values
+            const arrayFields = Array.isArray(options.arrayFields)
+                ? options.arrayFields
+                : options.arrayFields(record);
+            for (const field of arrayFields) {
+                if ((0, base_1.isKeyOf)(field, record) && typeof record[field] === 'string') {
+                    const current = record[field];
+                    record[field] = [current];
+                }
+            }
+        }
+        return record;
+    }
+    _parse(lines) {
+        var _a, _b;
+        for (let n = 0; n < lines.length; n++) {
+            const line = lines[n];
+            if (line.startsWith('%%') && !((_a = this._body) === null || _a === void 0 ? void 0 : _a.isContinuation)) {
+                const result = this._writePendingRecord();
+                if (result.isFailure()) {
+                    return (0, base_1.fail)(`${n}: ${result.message}`);
+                }
+            }
+            else if (/^\s*$/.test(line)) {
+                // ignore blank lines but cancel continuation
+                if (this._body) {
+                    this._body.isContinuation = false;
+                }
+                continue;
+            }
+            else if (((_b = this._body) === null || _b === void 0 ? void 0 : _b.isContinuation) || /^\s+/.test(line)) {
+                // explicit continuation on previous line or implicit starts with whitespace
+                if (this._body === undefined) {
+                    return (0, base_1.fail)(`${n}: continuation ("${line}") without prior value.`);
+                }
+                const result = this._parseContinuation(line);
+                if (result.isFailure()) {
+                    return (0, base_1.fail)(`${n}: ${result.message}`);
+                }
+                this._body = result.value;
+            }
+            else {
+                const result = this._parseField(line);
+                if (result.isFailure()) {
+                    return (0, base_1.fail)(`${n}: ${result.message}`);
+                }
+            }
+        }
+        const result = this._writePendingRecord();
+        if (result.isFailure()) {
+            return (0, base_1.fail)(`${lines.length}: ${result.message}`);
+        }
+        return (0, base_1.succeed)(this.records);
+    }
+    _parseField(line) {
+        const separatorIndex = line.indexOf(':');
+        if (separatorIndex < 1) {
+            return (0, base_1.fail)(`malformed line ("${line}") in record-jar.`);
+        }
+        const parts = [line.slice(0, separatorIndex), line.slice(separatorIndex + 1)];
+        return this._writePendingField().onSuccess(() => {
+            this._name = parts[0].trimEnd();
+            return RecordParser._parseRecordBody(parts[1].trim()).onSuccess((body) => {
+                this._body = body;
+                return (0, base_1.succeed)(true);
+            });
+        });
+    }
+    _parseContinuation(line) {
+        var _a, _b;
+        let trimmed = line.trim();
+        if (!this._body.isContinuation) {
+            // istanbul ignore next
+            const fixedSize = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.fixedContinuationSize) !== null && _b !== void 0 ? _b : 0;
+            if (fixedSize > 0) {
+                if (trimmed.length < line.length - fixedSize) {
+                    // oops, took too much
+                    trimmed = line.slice(fixedSize);
+                }
+            }
+        }
+        return RecordParser._parseRecordBody(trimmed).onSuccess((newBody) => {
+            return (0, base_1.succeed)({
+                body: `${this._body.body}${newBody.body}`,
+                isContinuation: newBody.isContinuation
+            });
+        });
+    }
+    _havePendingRecord() {
+        return Object.keys(this._fields).length > 0;
+    }
+    _writePendingRecord() {
+        return this._writePendingField().onSuccess(() => {
+            let record = this._havePendingRecord() ? this._fields : undefined;
+            if (record !== undefined) {
+                record = RecordParser._applyOptions(record, this.options);
+                this.records.push(record);
+                this._fields = {};
+            }
+            return (0, base_1.succeed)(undefined);
+        });
+    }
+    _writePendingField() {
+        if (this._name !== undefined) {
+            if (this._body.body.length < 1) {
+                return (0, base_1.fail)('empty body value not allowed');
+            }
+            if (!(0, base_1.isKeyOf)(this._name, this._fields)) {
+                this._fields[this._name] = this._body.body;
+            }
+            else if (typeof this._fields[this._name] === 'string') {
+                const current = this._fields[this._name];
+                this._fields[this._name] = [current, this._body.body];
+            }
+            else {
+                const current = this._fields[this._name];
+                current.push(this._body.body);
+            }
+            this._name = undefined;
+            this._body = undefined;
+        }
+        return (0, base_1.succeed)(true);
+    }
+}
+/**
+ * Reads a record-jar from an array of strings, each of which represents one
+ * line in the source file.
+ * @param lines - the array of strings to be parsed
+ * @param options - Optional parser configuration
+ * @returns a corresponding array of `Record<string, string>`
+ * @public
+ */
+function parseRecordJarLines(lines, options) {
+    return RecordParser.parse(lines, options);
+}
+exports.parseRecordJarLines = parseRecordJarLines;
+/**
+ * Reads a record-jar file from a supplied path.
+ * @param srcPath - Source path from which the file is read.
+ * @param options - Optional parser configuration
+ * @returns The contents of the file as an array of `Record<string, string>`
+ * @see https://datatracker.ietf.org/doc/html/draft-phillips-record-jar-01
+ * @public
+ */
+function readRecordJarFileSync(srcPath, options) {
+    return (0, base_1.captureResult)(() => {
+        const fullPath = path.resolve(srcPath);
+        return fs.readFileSync(fullPath, 'utf8').toString().split(/\r?\n/);
+    }).onSuccess((lines) => {
+        return parseRecordJarLines(lines, options);
+    });
+}
+exports.readRecordJarFileSync = readRecordJarFileSync;
+//# sourceMappingURL=recordJarHelpers.js.map

package/lib/packlets/record-jar/recordJarHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordJarHelpers.js","sourceRoot":"","sources":["../../../src/packlets/record-jar/recordJarHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nimport { Result, captureResult, fail, isKeyOf, succeed } from '../base';\n\ninterface IRecordBody {\n  body: string;\n  isContinuation: boolean;\n}\n\n/**\n * Represents a single record in a JAR file\n * @public\n */\nexport type JarRecord = Record<string, string | string[]>;\n\n/**\n * @public\n */\nexport type JarFieldPicker<T extends JarRecord = JarRecord> = (record: T) => (keyof T)[];\n\n/**\n * Options for a JAR record parser.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface JarRecordParserOptions {\n  readonly arrayFields?: string[] | JarFieldPicker;\n  readonly fixedContinuationSize?: number;\n}\n\nclass RecordParser {\n  public readonly records: JarRecord[] = [];\n  public readonly options: JarRecordParserOptions;\n\n  protected _fields: JarRecord = {};\n  protected _name: string | undefined = undefined;\n  protected _body: IRecordBody | undefined = undefined;\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  private constructor(options?: JarRecordParserOptions) {\n    this.options = options ?? {};\n  }\n\n  public static parse(lines: string[], options?: JarRecordParserOptions): Result<JarRecord[]> {\n    return new RecordParser(options)._parse(lines);\n  }\n\n  protected static _parseRecordBody(body: string): Result<IRecordBody> {\n    const isContinuation = body.endsWith('\\\\');\n    if (isContinuation) {\n      body = body.slice(0, body.length - 1);\n    }\n    if (this._hasEscapes(body)) {\n      const result = this._replaceEscapes(body);\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      body = result.value;\n    }\n    return succeed({ body, isContinuation });\n  }\n\n  protected static _hasEscapes(from: string): boolean {\n    return from.includes('\\\\') || from.includes('&');\n  }\n\n  protected static _replaceEscapes(body: string): Result<string> {\n    const invalid: string[] = [];\n    const escaped = body.replace(/(\\\\.)|(&#x[a-fA-F0-9]{2,6};)/g, (match) => {\n      switch (match) {\n        case '\\\\\\\\':\n          return '\\\\';\n        case '\\\\&':\n          return '&';\n        case '\\\\r':\n          return '\\r';\n        case '\\\\n':\n          return '\\n';\n        case '\\\\t':\n          return '\\t';\n      }\n      if (match.startsWith('&')) {\n        const hexCode = `0x${match.slice(3, match.length - 1)}`;\n        const charCode = Number.parseInt(hexCode, 16);\n        return String.fromCharCode(charCode);\n      }\n      invalid.push(match);\n      return '\\\\';\n    });\n    if (invalid.length > 0) {\n      return fail(`unrecognized escape \"${invalid.join(', ')}\" in record-jar body`);\n    }\n    return succeed(escaped);\n  }\n\n  protected static _applyOptions(record: JarRecord, options: JarRecordParserOptions): JarRecord {\n    if (options.arrayFields) {\n      record = { ...record }; // don't edit incoming values\n      const arrayFields = Array.isArray(options.arrayFields)\n        ? options.arrayFields\n        : options.arrayFields(record);\n\n      for (const field of arrayFields) {\n        if (isKeyOf(field, record) && typeof record[field] === 'string') {\n          const current = record[field] as string;\n          record[field] = [current];\n        }\n      }\n    }\n    return record;\n  }\n\n  protected _parse(lines: string[]): Result<JarRecord[]> {\n    for (let n = 0; n < lines.length; n++) {\n      const line = lines[n];\n      if (line.startsWith('%%') && !this._body?.isContinuation) {\n        const result = this._writePendingRecord();\n        if (result.isFailure()) {\n          return fail(`${n}: ${result.message}`);\n        }\n      } else if (/^\\s*$/.test(line)) {\n        // ignore blank lines but cancel continuation\n        if (this._body) {\n          this._body.isContinuation = false;\n        }\n        continue;\n      } else if (this._body?.isContinuation || /^\\s+/.test(line)) {\n        // explicit continuation on previous line or implicit starts with whitespace\n        if (this._body === undefined) {\n          return fail(`${n}: continuation (\"${line}\") without prior value.`);\n        }\n        const result = this._parseContinuation(line);\n        if (result.isFailure()) {\n          return fail(`${n}: ${result.message}`);\n        }\n        this._body = result.value;\n      } else {\n        const result = this._parseField(line);\n        if (result.isFailure()) {\n          return fail(`${n}: ${result.message}`);\n        }\n      }\n    }\n\n    const result = this._writePendingRecord();\n    if (result.isFailure()) {\n      return fail(`${lines.length}: ${result.message}`);\n    }\n    return succeed(this.records);\n  }\n\n  protected _parseField(line: string): Result<boolean> {\n    const separatorIndex = line.indexOf(':');\n    if (separatorIndex < 1) {\n      return fail(`malformed line (\"${line}\") in record-jar.`);\n    }\n    const parts = [line.slice(0, separatorIndex), line.slice(separatorIndex + 1)];\n\n    return this._writePendingField().onSuccess(() => {\n      this._name = parts[0].trimEnd();\n      return RecordParser._parseRecordBody(parts[1].trim()).onSuccess((body) => {\n        this._body = body;\n        return succeed(true);\n      });\n    });\n  }\n\n  protected _parseContinuation(line: string): Result<IRecordBody> {\n    let trimmed = line.trim();\n    if (!this._body!.isContinuation) {\n      // istanbul ignore next\n      const fixedSize = this.options?.fixedContinuationSize ?? 0;\n      if (fixedSize > 0) {\n        if (trimmed.length < line.length - fixedSize) {\n          // oops, took too much\n          trimmed = line.slice(fixedSize);\n        }\n      }\n    }\n    return RecordParser._parseRecordBody(trimmed).onSuccess((newBody) => {\n      return succeed({\n        body: `${this._body!.body}${newBody.body}`,\n        isContinuation: newBody.isContinuation\n      });\n    });\n  }\n\n  protected _havePendingRecord(): boolean {\n    return Object.keys(this._fields).length > 0;\n  }\n\n  protected _writePendingRecord(): Result<JarRecord | undefined> {\n    return this._writePendingField().onSuccess(() => {\n      let record = this._havePendingRecord() ? this._fields : undefined;\n      if (record !== undefined) {\n        record = RecordParser._applyOptions(record, this.options);\n        this.records.push(record);\n        this._fields = {};\n      }\n      return succeed(undefined);\n    });\n  }\n\n  protected _writePendingField(): Result<boolean> {\n    if (this._name !== undefined) {\n      if (this._body!.body.length < 1) {\n        return fail('empty body value not allowed');\n      }\n      if (!isKeyOf(this._name, this._fields)) {\n        this._fields[this._name] = this._body!.body;\n      } else if (typeof this._fields[this._name] === 'string') {\n        const current = this._fields[this._name] as string;\n        this._fields[this._name] = [current, this._body!.body];\n      } else {\n        const current = this._fields[this._name] as string[];\n        current.push(this._body!.body);\n      }\n      this._name = undefined;\n      this._body = undefined;\n    }\n    return succeed(true);\n  }\n}\n\n/**\n * Reads a record-jar from an array of strings, each of which represents one\n * line in the source file.\n * @param lines - the array of strings to be parsed\n * @param options - Optional parser configuration\n * @returns a corresponding array of `Record<string, string>`\n * @public\n */\nexport function parseRecordJarLines(lines: string[], options?: JarRecordParserOptions): Result<JarRecord[]> {\n  return RecordParser.parse(lines, options);\n}\n\n/**\n * Reads a record-jar file from a supplied path.\n * @param srcPath - Source path from which the file is read.\n * @param options - Optional parser configuration\n * @returns The contents of the file as an array of `Record<string, string>`\n * @see https://datatracker.ietf.org/doc/html/draft-phillips-record-jar-01\n * @public\n */\nexport function readRecordJarFileSync(\n  srcPath: string,\n  options?: JarRecordParserOptions\n): Result<JarRecord[]> {\n  return captureResult(() => {\n    const fullPath = path.resolve(srcPath);\n    return fs.readFileSync(fullPath, 'utf8').toString().split(/\\r?\\n/);\n  }).onSuccess((lines) => {\n    return parseRecordJarLines(lines, options);\n  });\n}\n"]}

package/{validation → lib/packlets/validation}/array.d.ts

@@ -1,4 +1,4 @@
-import { Failure } from '../result';
+import { Failure } from '../base';
 import { Validator, ValidatorOptions } from './validator';
 import { ValidatorBase, ValidatorBaseConstructorParams } from './validatorBase';
 /**
@@ -9,7 +9,7 @@ export interface ArrayValidatorConstructorParams<T, TC = unknown> extends Valida
     validateElement: Validator<T, TC>;
 }
 /**
- * An in-place {@link Validation.Validator | Validator} for arrays of validated
+ * An in-place {@link Validator | Validator} for arrays of validated
  * values or objects.
  * @public
  */

package/lib/packlets/validation/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/packlets/validation/array.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,OAAO,EAAQ,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAEhF;;;GAGG;AAEH,MAAM,WAAW,+BAA+B,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAC9D,SAAQ,8BAA8B,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IAC/C,eAAe,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,cAAc,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IACzE;;;OAGG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAE9C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD;;;;OAIG;gBACgB,MAAM,EAAE,+BAA+B,CAAC,CAAC,EAAE,EAAE,CAAC;IAMjE;;;;;;;;OAQG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAY1E"}

package/lib/packlets/validation/array.js

@@ -0,0 +1,67 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayValidator = void 0;
+const base_1 = require("../base");
+const validatorBase_1 = require("./validatorBase");
+/**
+ * An in-place {@link Validator | Validator} for arrays of validated
+ * values or objects.
+ * @public
+ */
+class ArrayValidator extends validatorBase_1.ValidatorBase {
+    /**
+     * Constructs a new {@link Validation.Classes.ArrayValidator | ArrayValidator}.
+     * @param params - Optional {@link Validation.Classes.ArrayValidatorConstructorParams | init params} for the
+     * new {@link Validation.Classes.ArrayValidator | ArrayValidator}.
+     */
+    constructor(params) {
+        var _a;
+        super(params);
+        this._validateElement = params.validateElement;
+        this.options = (_a = params.options) !== null && _a !== void 0 ? _a : {};
+    }
+    /**
+     * Static method which validates that a supplied `unknown` value is a `array`
+     * and that every element of the array can be validated by the supplied array
+     * validator.
+     * @param from - The `unknown` value to be tested.
+     * @param context - Optional validation context will be propagated to element validator.
+     * @returns Returns `true` if `from` is an `array` of valid elements, or
+     * {@link Failure} with an error message if not.
+     */
+    _validate(from, context) {
+        if (Array.isArray(from)) {
+            for (const elem of from) {
+                const result = this._validateElement.validate(elem, context);
+                if (!result.isSuccess()) {
+                    return (0, base_1.fail)(result.message);
+                }
+            }
+            return true;
+        }
+        return (0, base_1.fail)(`"${from}": not an array`);
+    }
+}
+exports.ArrayValidator = ArrayValidator;
+//# sourceMappingURL=array.js.map

package/lib/packlets/validation/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../src/packlets/validation/array.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kCAAwC;AAExC,mDAAgF;AAYhF;;;;GAIG;AACH,MAAa,cAAgC,SAAQ,6BAAsB;IASzE;;;;OAIG;IACH,YAAmB,MAA8C;;QAC/D,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAA,MAAM,CAAC,OAAO,mCAAI,EAAE,CAAC;IACtC,CAAC;IAED;;;;;;;;OAQG;IACO,SAAS,CAAI,IAAa,EAAE,OAAY;QAChD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACvB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE;gBACvB,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE;oBACvB,OAAO,IAAA,WAAI,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;iBAC7B;aACF;YACD,OAAO,IAAI,CAAC;SACb;QACD,OAAO,IAAA,WAAI,EAAI,IAAI,IAAI,iBAAiB,CAAC,CAAC;IAC5C,CAAC;CACF;AAzCD,wCAyCC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Failure, fail } from '../base';\nimport { Validator, ValidatorOptions } from './validator';\nimport { ValidatorBase, ValidatorBaseConstructorParams } from './validatorBase';\n\n/**\n * Parameters used to construct a {@link Validation.Classes.ArrayValidator | ArrayValidator}.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface ArrayValidatorConstructorParams<T, TC = unknown>\n  extends ValidatorBaseConstructorParams<T[], TC> {\n  validateElement: Validator<T, TC>;\n}\n\n/**\n * An in-place {@link Validator | Validator} for arrays of validated\n * values or objects.\n * @public\n */\nexport class ArrayValidator<T, TC = unknown> extends ValidatorBase<T[], TC> {\n  /**\n   * {@link Validation.ValidatorOptions | Options} which apply to this\n   * validator.\n   */\n  public readonly options: ValidatorOptions<TC>;\n\n  protected readonly _validateElement: Validator<T, TC>;\n\n  /**\n   * Constructs a new {@link Validation.Classes.ArrayValidator | ArrayValidator}.\n   * @param params - Optional {@link Validation.Classes.ArrayValidatorConstructorParams | init params} for the\n   * new {@link Validation.Classes.ArrayValidator | ArrayValidator}.\n   */\n  public constructor(params: ArrayValidatorConstructorParams<T, TC>) {\n    super(params);\n    this._validateElement = params.validateElement;\n    this.options = params.options ?? {};\n  }\n\n  /**\n   * Static method which validates that a supplied `unknown` value is a `array`\n   * and that every element of the array can be validated by the supplied array\n   * validator.\n   * @param from - The `unknown` value to be tested.\n   * @param context - Optional validation context will be propagated to element validator.\n   * @returns Returns `true` if `from` is an `array` of valid elements, or\n   * {@link Failure} with an error message if not.\n   */\n  protected _validate<T>(from: unknown, context?: TC): boolean | Failure<T> {\n    if (Array.isArray(from)) {\n      for (const elem of from) {\n        const result = this._validateElement.validate(elem, context);\n        if (!result.isSuccess()) {\n          return fail(result.message);\n        }\n      }\n      return true;\n    }\n    return fail<T>(`\"${from}\": not an array`);\n  }\n}\n"]}

package/{validation → lib/packlets/validation}/boolean.d.ts

@@ -1,4 +1,4 @@
-import { Failure } from '../result';
+import { Failure } from '../base';
 import { GenericValidator, GenericValidatorConstructorParams } from './genericValidator';
 /**
  * Parameters used to construct a {@link Validation.Classes.BooleanValidator | BooleanValidator}.

package/lib/packlets/validation/boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.d.ts","sourceRoot":"","sources":["../../../src/packlets/validation/boolean.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,OAAO,EAAQ,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,iCAAiC,CAAC,EAAE,GAAG,OAAO,IAAI,iCAAiC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAE7G;;;GAGG;AACH,qBAAa,gBAAgB,CAAC,EAAE,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;IAC/E;;;;OAIG;gBACgB,MAAM,CAAC,EAAE,iCAAiC,CAAC,EAAE,CAAC;IASjE;;;;;OAKG;WACW,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAMzE"}

package/lib/packlets/validation/boolean.js

@@ -0,0 +1,56 @@
+"use strict";
+/*
+ * Copyright (c) 2021 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BooleanValidator = void 0;
+const base_1 = require("../base");
+const genericValidator_1 = require("./genericValidator");
+/**
+ * An in-place {@link Validation.Validator | Validator} for `boolean` values.
+ * @public
+ */
+class BooleanValidator extends genericValidator_1.GenericValidator {
+    /**
+     * Constructs a new {@link Validation.Classes.BooleanValidator | BooleanValidator}.
+     * @param params - Optional {@link Validation.Classes.BooleanValidatorConstructorParams | init params} for the
+     * new {@link Validation.Classes.BooleanValidator | BooleanValidator}.
+     */
+    constructor(params) {
+        // istanbul ignore next
+        params = params !== null && params !== void 0 ? params : {};
+        super(Object.assign({ validator: BooleanValidator.validateBoolean }, params));
+    }
+    /**
+     * Static method which validates that a supplied `unknown` value is a `boolean`.
+     * @param from - The `unknown` value to be tested.
+     * @returns Returns `true` if `from` is a `boolean`, or {@link Failure} with an error
+     * message if not.
+     */
+    static validateBoolean(from) {
+        if (typeof from === 'boolean') {
+            return true;
+        }
+        return (0, base_1.fail)(`"${from}": not a boolean`);
+    }
+}
+exports.BooleanValidator = BooleanValidator;
+//# sourceMappingURL=boolean.js.map

package/lib/packlets/validation/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../src/packlets/validation/boolean.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kCAAwC;AACxC,yDAAyF;AAQzF;;;GAGG;AACH,MAAa,gBAA+B,SAAQ,mCAA6B;IAC/E;;;;OAIG;IACH,YAAmB,MAA8C;QAC/D,uBAAuB;QACvB,MAAM,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;QACtB,KAAK,iBACH,SAAS,EAAE,gBAAgB,CAAC,eAAe,IACxC,MAAM,EACT,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,eAAe,CAAC,IAAa;QACzC,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE;YAC7B,OAAO,IAAI,CAAC;SACb;QACD,OAAO,IAAA,WAAI,EAAC,IAAI,IAAI,kBAAkB,CAAC,CAAC;IAC1C,CAAC;CACF;AA3BD,4CA2BC","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\nimport { Failure, fail } from '../base';\nimport { GenericValidator, GenericValidatorConstructorParams } from './genericValidator';\n\n/**\n * Parameters used to construct a {@link Validation.Classes.BooleanValidator | BooleanValidator}.\n * @public\n */\nexport type BooleanValidatorConstructorParams<TC = unknown> = GenericValidatorConstructorParams<boolean, TC>;\n\n/**\n * An in-place {@link Validation.Validator | Validator} for `boolean` values.\n * @public\n */\nexport class BooleanValidator<TC = unknown> extends GenericValidator<boolean, TC> {\n  /**\n   * Constructs a new {@link Validation.Classes.BooleanValidator | BooleanValidator}.\n   * @param params - Optional {@link Validation.Classes.BooleanValidatorConstructorParams | init params} for the\n   * new {@link Validation.Classes.BooleanValidator | BooleanValidator}.\n   */\n  public constructor(params?: BooleanValidatorConstructorParams<TC>) {\n    // istanbul ignore next\n    params = params ?? {};\n    super({\n      validator: BooleanValidator.validateBoolean,\n      ...params\n    });\n  }\n\n  /**\n   * Static method which validates that a supplied `unknown` value is a `boolean`.\n   * @param from - The `unknown` value to be tested.\n   * @returns Returns `true` if `from` is a `boolean`, or {@link Failure} with an error\n   * message if not.\n   */\n  public static validateBoolean(from: unknown): boolean | Failure<boolean> {\n    if (typeof from === 'boolean') {\n      return true;\n    }\n    return fail(`\"${from}\": not a boolean`);\n  }\n}\n"]}

package/lib/packlets/validation/classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.d.ts","sourceRoot":"","sources":["../../../src/packlets/validation/classes.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,cAAc,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,iCAAiC,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EACL,eAAe,EACf,eAAe,EACf,gCAAgC,EAChC,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC"}

package/lib/packlets/validation/classes.js

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

package/lib/packlets/validation/classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.js","sourceRoot":"","sources":["../../../src/packlets/validation/classes.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,0BAA0B;AAE1B,iCAA0E;AAAjE,uGAAA,cAAc,OAAA;AACvB,mCAA6E;AAApE,yGAAA,eAAe,OAAA;AACxB,qCAAgF;AAAvE,2GAAA,gBAAgB,OAAA;AACzB,mCAA6E;AAApE,yGAAA,eAAe,OAAA;AACxB,mCAKkB;AAHhB,yGAAA,eAAe,OAAA;AAIjB,yCAAsF;AAA7E,+GAAA,kBAAkB,OAAA","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/* istanbul ignore file */\n\nexport { ArrayValidator, ArrayValidatorConstructorParams } from './array';\nexport { StringValidator, StringValidatorConstructorParams } from './string';\nexport { BooleanValidator, BooleanValidatorConstructorParams } from './boolean';\nexport { NumberValidator, NumberValidatorConstructorParams } from './number';\nexport {\n  FieldValidators,\n  ObjectValidator,\n  ObjectValidatorConstructorParams,\n  ObjectValidatorOptions\n} from './object';\nexport { TypeGuardValidator, TypeGuardValidatorConstructorParams } from './typeGuard';\n"]}

package/lib/packlets/validation/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/validation/common.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC"}

package/lib/packlets/validation/common.js

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

package/lib/packlets/validation/common.js.map

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

package/{validation → lib/packlets/validation}/field.d.ts

@@ -1,4 +1,4 @@
-import { Failure } from '../result';
+import { Failure } from '../base';
 import { Validator, ValidatorOptions } from './validator';
 import { ValidatorBase } from './validatorBase';
 /**

package/lib/packlets/validation/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../src/packlets/validation/field.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,OAAO,EAAiB,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AAEH,MAAM,WAAW,qBAAqB,CAAC,EAAE,CAAE,SAAQ,gBAAgB,CAAC,EAAE,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,cAAc,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC;IACzE;;OAEG;IACH,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,SAAgB,cAAc,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAE5D;;;;;;;OAOG;gBAED,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAChC,OAAO,CAAC,EAAE,qBAAqB,CAAC,EAAE,CAAC;IASrC;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAqBvE"}