@fgv/ts-utils 1.9.4 → 2.0.1-alpha.0

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.34.4"
+    }
+  ]
+}

package/lib/index.d.ts

@@ -0,0 +1,12 @@
+import * as Conversion from './packlets/conversion';
+import * as Csv from './packlets/csv';
+import * as Experimental from './packlets/experimental';
+import * as Hash from './packlets/hash';
+import * as RecordJar from './packlets/record-jar';
+import * as Validation from './packlets/validation';
+import { Converter, Converters } from './packlets/conversion';
+import { Validator, Validators } from './packlets/validation';
+export * from './packlets/base';
+export { Converter, Converters, Validator, Validators };
+export { Conversion, Experimental, Csv, Hash, RecordJar, Validation };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE9D,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC"}

package/lib/index.js

@@ -0,0 +1,68 @@
+"use strict";
+/*
+ * Copyright (c) 2020 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;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validation = exports.RecordJar = exports.Hash = exports.Csv = exports.Experimental = exports.Conversion = exports.Validators = exports.Converters = void 0;
+const Conversion = __importStar(require("./packlets/conversion"));
+exports.Conversion = Conversion;
+const Csv = __importStar(require("./packlets/csv"));
+exports.Csv = Csv;
+const Experimental = __importStar(require("./packlets/experimental"));
+exports.Experimental = Experimental;
+const Hash = __importStar(require("./packlets/hash"));
+exports.Hash = Hash;
+const RecordJar = __importStar(require("./packlets/record-jar"));
+exports.RecordJar = RecordJar;
+const Validation = __importStar(require("./packlets/validation"));
+exports.Validation = Validation;
+const conversion_1 = require("./packlets/conversion");
+Object.defineProperty(exports, "Converters", { enumerable: true, get: function () { return conversion_1.Converters; } });
+const validation_1 = require("./packlets/validation");
+Object.defineProperty(exports, "Validators", { enumerable: true, get: function () { return validation_1.Validators; } });
+__exportStar(require("./packlets/base"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kEAAoD;AAY3C,gCAAU;AAXnB,oDAAsC;AAWH,kBAAG;AAVtC,sEAAwD;AAUnC,oCAAY;AATjC,sDAAwC;AASA,oBAAI;AAR5C,iEAAmD;AAQL,8BAAS;AAPvD,kEAAoD;AAOK,gCAAU;AALnE,sDAA8D;AAI1C,2FAJA,uBAAU,OAIA;AAH9B,sDAA8D;AAGnB,2FAHvB,uBAAU,OAGuB;AADrD,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 Conversion from './packlets/conversion';\nimport * as Csv from './packlets/csv';\nimport * as Experimental from './packlets/experimental';\nimport * as Hash from './packlets/hash';\nimport * as RecordJar from './packlets/record-jar';\nimport * as Validation from './packlets/validation';\n\nimport { Converter, Converters } from './packlets/conversion';\nimport { Validator, Validators } from './packlets/validation';\n\nexport * from './packlets/base';\nexport { Converter, Converters, Validator, Validators };\nexport { Conversion, Experimental, Csv, Hash, RecordJar, Validation };\n"]}

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,24 @@
+"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 });
+//# sourceMappingURL=brand.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,7 @@
+import * as Logging from './logger';
+export * from './brand';
+export { Normalizer } from './normalize';
+export * from './result';
+export * from './utils';
+export { Logging };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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,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

@@ -0,0 +1,58 @@
+"use strict";
+/*
+ * Copyright (c) 2020 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;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logging = exports.Normalizer = void 0;
+const Logging = __importStar(require("./logger"));
+exports.Logging = Logging;
+__exportStar(require("./brand"), exports);
+var normalize_1 = require("./normalize");
+Object.defineProperty(exports, "Normalizer", { enumerable: true, get: function () { return normalize_1.Normalizer; } });
+__exportStar(require("./result"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAoC;AAM3B,0BAAO;AAJhB,0CAAwB;AACxB,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 { Normalizer } from './normalize';\nexport * from './result';\nexport * from './utils';\nexport { Logging };\n"]}

package/{logger.d.ts → lib/packlets/base/logger.d.ts}

@@ -1,5 +1,11 @@
 import { Failure, Success } from './result';
+/**
+ * @public
+ */
 export type LogLevel = 'detail' | 'info' | 'warning' | 'error' | 'silent';
+/**
+ * @public
+ */
 export interface Logger {
     log(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
     detail(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
@@ -8,6 +14,9 @@ export interface Logger {
     warnAndFail<T>(message?: unknown, ...parameters: unknown[]): Failure<T>;
     error<T>(message?: unknown, ...parameters: unknown[]): Failure<T>;
 }
+/**
+ * @public
+ */
 export declare abstract class LoggerBase {
     logLevel: LogLevel;
     constructor(logLevel?: LogLevel);
@@ -18,9 +27,12 @@ export declare abstract class LoggerBase {
     error<T>(message?: unknown, ...parameters: unknown[]): Failure<T>;
     log(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
     protected _format(message?: unknown, ...parameters: unknown[]): string;
-    protected _innerSilent(_message: string): Success<string | undefined>;
+    protected _innerSilent(__message: string): Success<string | undefined>;
     protected abstract _innerLog(message: string): Success<string | undefined>;
 }
+/**
+ * @public
+ */
 export declare class InMemoryLogger extends LoggerBase {
     protected _messages: string[];
     protected _silent: string[];
@@ -31,6 +43,9 @@ export declare class InMemoryLogger extends LoggerBase {
     protected _innerLog(message: string): Success<string | undefined>;
     protected _innerSilent(message: string): Success<string | undefined>;
 }
+/**
+ * @public
+ */
 export declare class NoOpLogger extends LoggerBase {
     protected _innerLog(message: string): Success<string | undefined>;
 }

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOpLogger = exports.InMemoryLogger = exports.LoggerBase = void 0;
+/*
+ * Copyright (c) 2020 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.
+ */
+const result_1 = require("./result");
+/**
+ * @public
+ */
+class LoggerBase {
+    constructor(logLevel) {
+        this.logLevel = 'info';
+        this.logLevel = logLevel !== null && logLevel !== void 0 ? logLevel : 'info';
+    }
+    detail(message, ...parameters) {
+        if (this.logLevel === 'detail') {
+            return this.log(message, parameters);
+        }
+        return (0, result_1.succeed)(undefined);
+    }
+    info(message, ...parameters) {
+        if (this.logLevel === 'detail' || this.logLevel === 'info') {
+            return this.log(message, parameters);
+        }
+        return (0, result_1.succeed)(undefined);
+    }
+    warn(message, ...parameters) {
+        if (this.logLevel !== 'error' && this.logLevel !== 'silent') {
+            return this.log(message, parameters);
+        }
+        return (0, result_1.succeed)(undefined);
+    }
+    warnAndFail(message, ...parameters) {
+        var _a;
+        const formatted = this._format(message, ...parameters);
+        if (this.logLevel !== 'error' && this.logLevel !== 'silent') {
+            const result = this.log(formatted);
+            return (0, result_1.fail)((_a = result.value) !== null && _a !== void 0 ? _a : formatted);
+        }
+        return (0, result_1.fail)(formatted);
+    }
+    error(message, ...parameters) {
+        var _a;
+        const formatted = this._format(message, ...parameters);
+        if (this.logLevel !== 'silent') {
+            const result = this.log(formatted);
+            return (0, result_1.fail)((_a = result.value) !== null && _a !== void 0 ? _a : formatted);
+        }
+        return (0, result_1.fail)(formatted);
+    }
+    log(message, ...parameters) {
+        const messageString = this._format(message, ...parameters);
+        if (this.logLevel === 'silent') {
+            return this._innerSilent(messageString);
+        }
+        return this._innerLog(messageString);
+    }
+    _format(message, ...parameters) {
+        const raw = [message, ...parameters];
+        const filtered = raw.filter((m) => m !== undefined);
+        const strings = filtered.map((m) => m.toString());
+        const joined = strings.join('');
+        return joined;
+    }
+    _innerSilent(__message) {
+        return (0, result_1.succeed)(undefined);
+    }
+}
+exports.LoggerBase = LoggerBase;
+/**
+ * @public
+ */
+class InMemoryLogger extends LoggerBase {
+    constructor(logLevel) {
+        super(logLevel);
+        this._messages = [];
+        this._silent = [];
+    }
+    get messages() {
+        return this._messages;
+    }
+    get silent() {
+        return this._silent;
+    }
+    clear() {
+        this._messages = [];
+        this._silent = [];
+    }
+    _innerLog(message) {
+        this._messages.push(message);
+        return (0, result_1.succeed)(message);
+    }
+    _innerSilent(message) {
+        this._silent.push(message);
+        return (0, result_1.succeed)(undefined);
+    }
+}
+exports.InMemoryLogger = InMemoryLogger;
+/**
+ * @public
+ */
+class NoOpLogger extends LoggerBase {
+    _innerLog(message) {
+        // no-op
+        return (0, result_1.succeed)(message);
+    }
+}
+exports.NoOpLogger = NoOpLogger;
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"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"]}

package/{normalize.d.ts → lib/packlets/base/normalize.d.ts}

@@ -1,5 +1,11 @@
 import { Result } from './result';
+/**
+ * @internal
+ */
 export type Entry<T> = [string | number | symbol, T];
+/**
+ * @internal
+ */
 export type ResultEntry<T> = [string | number | symbol, Result<T>];
 /**
  * Normalizes an arbitrary JSON object

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/normalize.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAA6B,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACI,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IA4BvC;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM;IAexD;;;;;;;OAOG;IACH,SAAS,CAAC,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;IAQjF,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAI7D;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;CAyBnD"}

package/lib/packlets/base/normalize.js

@@ -0,0 +1,139 @@
+"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.Normalizer = void 0;
+const result_1 = require("./result");
+/**
+ * Normalizes an arbitrary JSON object
+ * @public
+ */
+class Normalizer {
+    /**
+     * Normalizes the supplied value
+     *
+     * @param from - The value to be normalized
+     * @returns A normalized version of the value
+     */
+    normalize(from) {
+        switch (typeof from) {
+            case 'string':
+            case 'bigint':
+            case 'boolean':
+            case 'number':
+            case 'symbol':
+            case 'undefined':
+                return this._normalizeLiteral(from);
+            case 'object':
+                if (from === null || from instanceof Date || from instanceof RegExp) {
+                    return this._normalizeLiteral(from);
+                }
+                else if (Array.isArray(from)) {
+                    return this._normalizeArray(from);
+                }
+                else if (from instanceof Map) {
+                    return (0, result_1.succeed)(new Map(this._normalizeEntries(from.entries())));
+                }
+                else if (from instanceof Set) {
+                    return (0, result_1.succeed)(new Set(this._normalizeEntries(from.entries())));
+                }
+                const obj = {};
+                for (const e of this._normalizeEntries(Object.entries(from))) {
+                    obj[e[0]] = e[1];
+                }
+                return (0, result_1.succeed)(obj);
+        }
+        return (0, result_1.fail)(`normalize: Unexpected type - cannot normalize '${typeof from}'`);
+    }
+    /**
+     * Compares two property names from some object being normalized.
+     * @param k1 - First key to be compared.
+     * @param k2 - Second key to be compared.
+     * @returns `1` if `k1` is greater, `-1` if `k2` is greater and
+     * `0` if they are equal.
+     * @internal
+     */
+    _compareKeys(k1, k2) {
+        const cs1 = String(k1);
+        const cs2 = String(k2);
+        if (cs1 > cs2) {
+            return 1;
+        }
+        // istanbul ignore else
+        if (cs2 > cs1) {
+            return -1;
+        }
+        // istanbul ignore next
+        return 0;
+    }
+    /**
+     * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).
+     * @remarks
+     * Converts property names (entry key) to string and then sorts as string.
+     * @param entries - The entries to be normalized.
+     * @returns A normalized sorted array of entries.
+     * @internal
+     */
+    _normalizeEntries(entries) {
+        return Array.from(entries)
+            .sort((e1, e2) => this._compareKeys(e1[0], e2[0]))
+            .map((e) => [e[0], this.normalize(e[1])])
+            .filter((e) => e[1].isSuccess())
+            .map((e) => [e[0], e[1].orThrow()]);
+    }
+    _normalizeArray(from) {
+        return (0, result_1.mapResults)(from.map((v) => this.normalize(v)));
+    }
+    /**
+     * Normalizes the supplied literal value
+     * @param from - The literal value to be normalized.
+     * @returns A normalized value for the literal.
+     * @internal
+     */
+    _normalizeLiteral(from) {
+        // TODO: Apply configurable normalization rules
+        switch (typeof from) {
+            case 'string':
+                return (0, result_1.succeed)(from);
+            case 'bigint':
+            case 'boolean':
+            case 'number':
+            case 'symbol':
+            case 'undefined':
+                return (0, result_1.succeed)(from);
+        }
+        if (from === null) {
+            return (0, result_1.succeed)(from);
+        }
+        if (from instanceof Date) {
+            return (0, result_1.succeed)(from);
+        }
+        // istanbul ignore else
+        if (from instanceof RegExp) {
+            return (0, result_1.succeed)(from);
+        }
+        // istanbul ignore next
+        return (0, result_1.fail)(`cannot normalize ${JSON.stringify(from)}`);
+    }
+}
+exports.Normalizer = Normalizer;
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/packlets/base/normalize.ts"],"names":[],"mappings":"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","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 { Result, fail, mapResults, succeed } from './result';\n\n/**\n * @internal\n */\nexport type Entry<T> = [string | number | symbol, T];\n\n/**\n * @internal\n */\nexport type ResultEntry<T> = [string | number | symbol, Result<T>];\n\n/**\n * Normalizes an arbitrary JSON object\n * @public\n */\nexport class Normalizer {\n  /**\n   * Normalizes the supplied value\n   *\n   * @param from - The value to be normalized\n   * @returns A normalized version of the value\n   */\n  public normalize<T>(from: T): Result<T> {\n    switch (typeof from) {\n      case 'string':\n      case 'bigint':\n      case 'boolean':\n      case 'number':\n      case 'symbol':\n      case 'undefined':\n        return this._normalizeLiteral(from);\n      case 'object':\n        if (from === null || from instanceof Date || from instanceof RegExp) {\n          return this._normalizeLiteral(from);\n        } else if (Array.isArray(from)) {\n          return this._normalizeArray(from) as unknown as Result<T>;\n        } else if (from instanceof Map) {\n          return succeed(new Map(this._normalizeEntries(from.entries())) as unknown as T);\n        } else if (from instanceof Set) {\n          return succeed(new Set(this._normalizeEntries(from.entries())) as unknown as T);\n        }\n        const obj: { [key in number | string | symbol]: unknown } = {};\n        for (const e of this._normalizeEntries(Object.entries(from as unknown as object))) {\n          obj[e[0]] = e[1];\n        }\n        return succeed(obj as T);\n    }\n    return fail(`normalize: Unexpected type - cannot normalize '${typeof from}'`);\n  }\n\n  /**\n   * Compares two property names from some object being normalized.\n   * @param k1 - First key to be compared.\n   * @param k2 - Second key to be compared.\n   * @returns `1` if `k1` is greater, `-1` if `k2` is greater and\n   * `0` if they are equal.\n   * @internal\n   */\n  protected _compareKeys(k1: unknown, k2: unknown): number {\n    const cs1 = String(k1);\n    const cs2 = String(k2);\n    if (cs1 > cs2) {\n      return 1;\n    }\n    // istanbul ignore else\n    if (cs2 > cs1) {\n      return -1;\n    }\n\n    // istanbul ignore next\n    return 0;\n  }\n\n  /**\n   * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).\n   * @remarks\n   * Converts property names (entry key) to string and then sorts as string.\n   * @param entries - The entries to be normalized.\n   * @returns A normalized sorted array of entries.\n   * @internal\n   */\n  protected _normalizeEntries<T = unknown>(entries: Iterable<Entry<T>>): Entry<T>[] {\n    return Array.from(entries)\n      .sort((e1, e2) => this._compareKeys(e1[0], e2[0]))\n      .map((e) => [e[0], this.normalize(e[1])] as ResultEntry<T>)\n      .filter((e) => e[1].isSuccess())\n      .map((e) => [e[0], e[1].orThrow()]);\n  }\n\n  protected _normalizeArray(from: unknown[]): Result<unknown[]> {\n    return mapResults(from.map((v) => this.normalize(v)));\n  }\n\n  /**\n   * Normalizes the supplied literal value\n   * @param from - The literal value to be normalized.\n   * @returns A normalized value for the literal.\n   * @internal\n   */\n  protected _normalizeLiteral<T>(from: T): Result<T> {\n    // TODO: Apply configurable normalization rules\n    switch (typeof from) {\n      case 'string':\n        return succeed(from);\n      case 'bigint':\n      case 'boolean':\n      case 'number':\n      case 'symbol':\n      case 'undefined':\n        return succeed(from);\n    }\n    if (from === null) {\n      return succeed(from);\n    }\n    if (from instanceof Date) {\n      return succeed(from);\n    }\n    // istanbul ignore else\n    if (from instanceof RegExp) {\n      return succeed(from);\n    }\n    // istanbul ignore next\n    return fail(`cannot normalize ${JSON.stringify(from)}`);\n  }\n}\n"]}