@fgv/ts-utils 5.0.0-3 → 5.0.0-30

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.49.1"
+      "packageVersion": "7.52.12"
     }
   ]
 }

package/eslint.config.js

@@ -0,0 +1,37 @@
+// ESLint 9 flat config for ts-utils
+const nodeProfile = require('@rushstack/eslint-config/flat/profile/node');
+const packletsPlugin = require('@rushstack/eslint-config/flat/mixins/packlets');
+const tsdocPlugin = require('@rushstack/eslint-config/flat/mixins/tsdoc');
+
+module.exports = [
+  ...nodeProfile,
+  packletsPlugin,
+  ...tsdocPlugin,
+  {
+    // Override specific rules if needed
+    rules: {
+      '@rushstack/packlets/mechanics': 'warn',
+
+      // Tighten naming conventions for interface properties
+      '@typescript-eslint/naming-convention': [
+        'warn',
+        // Keep all the base rules from rushstack but add stricter property rules
+        {
+          selector: 'property',
+          format: ['camelCase', 'UPPER_CASE'],
+          leadingUnderscore: 'allow',
+          filter: {
+            // Only allow quoted identifiers that truly need special chars (not just hyphens)
+            regex: '^__',
+            match: false
+          }
+        },
+        {
+          selector: 'method',
+          format: ['camelCase', 'PascalCase'],
+          leadingUnderscore: 'allow'
+        }
+      ]
+    }
+  }
+];

package/lib/index.d.ts

@@ -2,10 +2,11 @@ import * as Collections from './packlets/collections';
 import * as Conversion from './packlets/conversion';
 import * as Hash from './packlets/hash';
 import * as FileTree from './packlets/file-tree';
+import * as Logging from './packlets/logging';
 import * as Validation from './packlets/validation';
 import { Collector, ICollectible, ConvertingCollector, IReadOnlyResultMap, ResultMap, ValidatingCollector, ValidatingConvertingCollector, ValidatingResultMap } from './packlets/collections';
 import { Converter, Converters, ObjectConverter, StringConverter } from './packlets/conversion';
 import { Validator, Validators } from './packlets/validation';
 export * from './packlets/base';
-export { Collections, Collector, ConvertingCollector, Conversion, Converter, Converters, FileTree, Hash, ICollectible, IReadOnlyResultMap, ObjectConverter, ResultMap, StringConverter, ValidatingCollector, ValidatingConvertingCollector, ValidatingResultMap, Validation, Validator, Validators };
+export { Collections, Collector, ConvertingCollector, Conversion, Converter, Converters, FileTree, Hash, ICollectible, IReadOnlyResultMap, Logging, ObjectConverter, ResultMap, StringConverter, ValidatingCollector, ValidatingConvertingCollector, ValidatingResultMap, Validation, Validator, Validators };
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -57,7 +57,7 @@ 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.Validators = exports.Validation = exports.ValidatingResultMap = exports.ValidatingConvertingCollector = exports.ValidatingCollector = exports.StringConverter = exports.ResultMap = exports.ObjectConverter = exports.Hash = exports.FileTree = exports.Converters = exports.Conversion = exports.ConvertingCollector = exports.Collector = exports.Collections = void 0;
+exports.Validators = exports.Validation = exports.ValidatingResultMap = exports.ValidatingConvertingCollector = exports.ValidatingCollector = exports.StringConverter = exports.ResultMap = exports.ObjectConverter = exports.Logging = exports.Hash = exports.FileTree = exports.Converters = exports.Conversion = exports.ConvertingCollector = exports.Collector = exports.Collections = void 0;
 const Collections = __importStar(require("./packlets/collections"));
 exports.Collections = Collections;
 const Conversion = __importStar(require("./packlets/conversion"));
@@ -66,6 +66,8 @@ const Hash = __importStar(require("./packlets/hash"));
 exports.Hash = Hash;
 const FileTree = __importStar(require("./packlets/file-tree"));
 exports.FileTree = FileTree;
+const Logging = __importStar(require("./packlets/logging"));
+exports.Logging = Logging;
 const Validation = __importStar(require("./packlets/validation"));
 exports.Validation = Validation;
 const collections_1 = require("./packlets/collections");

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

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

package/lib/packlets/base/index.js

@@ -31,35 +31,11 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     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 () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __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;
+exports.Normalizer = void 0;
 __exportStar(require("./brand"), exports);
 __exportStar(require("./mapResults"), exports);
 __exportStar(require("./messageAggregator"), exports);

package/lib/packlets/base/result.d.ts

@@ -41,6 +41,37 @@ export interface IResultLogger<TD = unknown> {
      */
     error(message: string, detail?: TD): void;
 }
+/**
+ * The severity level at which a message should be logged.
+ * @public
+ */
+export type MessageLogLevel = 'quiet' | 'detail' | 'info' | 'warning' | 'error';
+/**
+ * Options for reporting a result.
+ * @public
+ */
+export interface IResultReportOptions<TD = unknown> {
+    /**
+     * The level of reporting to be used for failure results.  Default is 'error'.
+     */
+    failure?: MessageLogLevel;
+    /**
+     * The level of reporting to be used for success results.  Default is 'quiet'.
+     */
+    success?: MessageLogLevel;
+    /**
+     * The error formatter to be used for reporting an error result.
+     */
+    message?: ErrorFormatter<TD>;
+}
+/**
+ * Interface for reporting a result.
+ * @public
+ */
+export interface IResultReporter<T, TD = unknown> {
+    reportSuccess(level: MessageLogLevel, value: T, detail?: TD): void;
+    reportFailure(level: MessageLogLevel, message: string, detail?: TD): void;
+}
 /**
  * Simple error aggregator to simplify collecting all errors in
  * a flow.
@@ -237,6 +268,12 @@ export interface IResult<T> {
      * errors will be aggregated.
      */
     aggregateError(errors: IMessageAggregator): this;
+    /**
+     * Reports the result to the supplied reporter
+     * @param reporter - The {@link IResultReporter | reporter} to which the result will be reported.
+     * @param options - The {@link IResultReportOptions | options} for reporting the result.
+     */
+    report(reporter?: IResultReporter<T>, options?: IResultReportOptions): this;
 }
 /**
  * Reports a successful {@link IResult | result} from some operation and the
@@ -323,6 +360,10 @@ export declare class Success<T> implements IResult<T> {
      * {@inheritdoc IResult.aggregateError}
      */
     aggregateError(__errors: IMessageAggregator): this;
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter?: IResultReporter<T>, options?: IResultReportOptions): this;
     /**
      * Creates a {@link Success | Success<T>} with the supplied value.
      * @param value - The value to be returned.
@@ -415,6 +456,10 @@ export declare class Failure<T> implements IResult<T> {
      * {@inheritdoc IResult.aggregateError}
      */
     aggregateError(errors: IMessageAggregator): this;
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter?: IResultReporter<T>, options?: IResultReportOptions): this;
     /**
      * Get a 'friendly' string representation of this object.
      * @remarks
@@ -458,6 +503,14 @@ export declare function fail<T>(message: string): Failure<T>;
  * @public
  */
 export declare function fails<T>(message: string): Failure<T>;
+/**
+ * Uses a value or calls a supplied initializer if the supplied value is undefined.
+ * @param value - the value
+ * @param initializer - a function that initializes the value if it is undefined
+ * @returns `Success` with the value if it is defined, or the result of calling the initializer function.
+ * @public
+ */
+export declare function useOrInitialize<T>(value: T | undefined, initializer: () => Result<T>): Result<T>;
 /**
  * Callback to be called when a {@link DetailedResult | DetailedResult} encounters success.
  * @remarks
@@ -529,6 +582,10 @@ export declare class DetailedSuccess<T, TD> extends Success<T> {
      * {@inheritdoc Success.withErrorFormat}
      */
     withErrorFormat(cb: ErrorFormatter): DetailedResult<T, TD>;
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter?: IResultReporter<T, TD>, options?: IResultReportOptions<TD>): this;
     /**
      * Creates a {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied value and
      * optional detail.
@@ -591,6 +648,10 @@ export declare class DetailedFailure<T, TD> extends Failure<T> {
      * {@inheritdoc IResult.withErrorFormat}
      */
     withErrorFormat(cb: ErrorFormatter<TD>): DetailedResult<T, TD>;
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter?: IResultReporter<T, TD>, options?: IResultReportOptions<TD>): this;
     orThrow(logOrFormat?: IResultLogger<TD> | ErrorFormatter<TD>): never;
     orThrow(cb: ErrorFormatter): never;
     /**

package/lib/packlets/base/result.js

@@ -26,6 +26,7 @@ exports.succeed = succeed;
 exports.succeeds = succeeds;
 exports.fail = fail;
 exports.fails = fails;
+exports.useOrInitialize = useOrInitialize;
 exports.succeedWithDetail = succeedWithDetail;
 exports.succeedsWithDetail = succeedsWithDetail;
 exports.failWithDetail = failWithDetail;
@@ -129,6 +130,15 @@ class Success {
     aggregateError(__errors) {
         return this;
     }
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter, options) {
+        var _a;
+        const level = (_a = options === null || options === void 0 ? void 0 : options.success) !== null && _a !== void 0 ? _a : 'quiet';
+        reporter === null || reporter === void 0 ? void 0 : reporter.reportSuccess(level, this._value);
+        return this;
+    }
     /**
      * Creates a {@link Success | Success<T>} with the supplied value.
      * @param value - The value to be returned.
@@ -246,6 +256,16 @@ class Failure {
         errors.addMessage(this._message);
         return this;
     }
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter, options) {
+        var _a, _b, _c;
+        const level = (_a = options === null || options === void 0 ? void 0 : options.failure) !== null && _a !== void 0 ? _a : 'error';
+        const message = (_c = (_b = options === null || options === void 0 ? void 0 : options.message) === null || _b === void 0 ? void 0 : _b.call(options, this._message)) !== null && _c !== void 0 ? _c : this._message;
+        reporter === null || reporter === void 0 ? void 0 : reporter.reportFailure(level, message);
+        return this;
+    }
     /**
      * Get a 'friendly' string representation of this object.
      * @remarks
@@ -302,6 +322,16 @@ function fail(message) {
 function fails(message) {
     return new Failure(message);
 }
+/**
+ * Uses a value or calls a supplied initializer if the supplied value is undefined.
+ * @param value - the value
+ * @param initializer - a function that initializes the value if it is undefined
+ * @returns `Success` with the value if it is defined, or the result of calling the initializer function.
+ * @public
+ */
+function useOrInitialize(value, initializer) {
+    return value !== undefined ? succeed(value) : initializer();
+}
 /**
  * A {@link DetailedSuccess | DetailedSuccess} extends {@link Success | Success} to report optional success
  * details in addition to the error message.
@@ -365,6 +395,15 @@ class DetailedSuccess extends Success {
     withErrorFormat(cb) {
         return this;
     }
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter, options) {
+        var _a;
+        const level = (_a = options === null || options === void 0 ? void 0 : options.success) !== null && _a !== void 0 ? _a : 'quiet';
+        reporter === null || reporter === void 0 ? void 0 : reporter.reportSuccess(level, this._value, this._detail);
+        return this;
+    }
     /**
      * Creates a {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied value and
      * optional detail.
@@ -441,6 +480,16 @@ class DetailedFailure extends Failure {
     withErrorFormat(cb) {
         return failWithDetail(cb(this._message, this._detail), this._detail);
     }
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter, options) {
+        var _a, _b, _c;
+        const level = (_a = options === null || options === void 0 ? void 0 : options.failure) !== null && _a !== void 0 ? _a : 'error';
+        const message = (_c = (_b = options === null || options === void 0 ? void 0 : options.message) === null || _b === void 0 ? void 0 : _b.call(options, this._message, this._detail)) !== null && _c !== void 0 ? _c : this._message;
+        reporter === null || reporter === void 0 ? void 0 : reporter.reportFailure(level, message, this._detail);
+        return this;
+    }
     orThrow(logOrFormat) {
         if (logOrFormat !== undefined) {
             if (typeof logOrFormat === 'function') {

package/lib/packlets/collections/collector.d.ts

@@ -19,6 +19,11 @@ export interface IReadOnlyCollector<TITEM extends ICollectible<any, any>> extend
      * with an error if the index is out of range.
      */
     getAt(index: number): Result<TITEM>;
+    /**
+     * Gets all items in the collection, ordered by index.
+     * @returns An array of items in the collection, ordered by index.
+     */
+    valuesByIndex(): ReadonlyArray<TITEM>;
 }
 /**
  * Parameters for constructing a {@link Collections.Collector | ICollector}.
@@ -115,6 +120,10 @@ export declare class Collector<TITEM extends ICollectible<any, any>> implements
      * {@inheritdoc Collections.ResultMap.values}
      */
     values(): IterableIterator<TITEM>;
+    /**
+     * {@inheritdoc Collections.IReadOnlyCollector.valuesByIndex}
+     */
+    valuesByIndex(): ReadonlyArray<TITEM>;
     /**
      * Gets a read-only version of this collector.
      */

package/lib/packlets/collections/collector.js

@@ -157,6 +157,12 @@ class Collector {
     values() {
         return this._byKey.values();
     }
+    /**
+     * {@inheritdoc Collections.IReadOnlyCollector.valuesByIndex}
+     */
+    valuesByIndex() {
+        return this._byIndex;
+    }
     /**
      * Gets a read-only version of this collector.
      */

package/lib/packlets/collections/validatingCollector.d.ts

@@ -18,7 +18,11 @@ export interface IReadOnlyValidatingCollector<TITEM extends ICollectible<any, an
     /**
      * {@inheritdoc Collections.IReadOnlyValidatingCollector.getAt}
      */
-    readonly getAt: (index: number) => Result<TITEM>;
+    getAt(index: number): Result<TITEM>;
+    /**
+     * {@inheritdoc Collections.IReadOnlyCollector.valuesByIndex}
+     */
+    valuesByIndex(): ReadonlyArray<TITEM>;
 }
 /**
  * Parameters for constructing a {@link Collections.ValidatingCollector | ValidatingCollector}.

package/lib/packlets/conversion/baseConverter.js

@@ -106,7 +106,6 @@ class BaseConverter {
                 return mapConverter.convert(innerResult.value, this._context(context));
             }
             return (0, base_1.fail)(innerResult.message);
-            // eslint-disable-next-line no-return-assign
         })._with(this._traits());
     }
     /**

package/lib/packlets/conversion/converters.js

@@ -580,7 +580,6 @@ function discriminatedObject(discriminatorProp, converters) {
 function transform(properties) {
     return new baseConverter_1.BaseConverter((from, __self, context) => {
         // eslint bug thinks key is used before defined
-        // eslint-disable-next-line no-use-before-define
         const converted = {};
         const errors = [];
         for (const key in properties) {
@@ -620,7 +619,6 @@ function transform(properties) {
 function transformObject(destinationFields, options) {
     return new baseConverter_1.BaseConverter((from, __self, context) => {
         // eslint bug thinks key is used before defined
-        // eslint-disable-next-line no-use-before-define
         const converted = {};
         const errors = [];
         const used = new Set(options === null || options === void 0 ? void 0 : options.ignore);

package/lib/packlets/conversion/objectConverter.js

@@ -104,9 +104,8 @@ class ObjectConverter extends baseConverter_1.BaseConverter {
         return new ObjectConverter(this.fields, options)._with(this._traits());
     }
     static _convert(from, context, fields, options) {
-        var _a;
         // eslint bug thinks key is used before defined
-        // eslint-disable-next-line no-use-before-define
+        var _a;
         const converted = {};
         const errors = [];
         for (const key in fields) {

package/lib/packlets/hash/crcNormalizer.js

@@ -69,7 +69,9 @@ class Crc32Normalizer extends hashingNormalizer_1.HashingNormalizer {
         super(Crc32Normalizer.crc32Hash);
     }
     static crc32Hash(parts) {
-        return crc32(textEncoder.encode(parts.join('|'))).toString(16);
+        return crc32(textEncoder.encode(parts.join('|')))
+            .toString(16)
+            .padStart(8, '0');
     }
 }
 exports.Crc32Normalizer = Crc32Normalizer;

package/lib/packlets/hash/hashingNormalizer.js

@@ -51,13 +51,14 @@ class HashingNormalizer extends base_1.Normalizer {
                 }
                 else if (Array.isArray(from)) {
                     return (0, base_1.mapResults)(from.map((e) => this.computeHash(e))).onSuccess((a) => {
-                        return (0, base_1.captureResult)(() => this._hash(a));
+                        return (0, base_1.captureResult)(() => this._hash(['array', ...a]));
                     });
                 }
                 else if (from instanceof Map || from instanceof Set) {
-                    return this.computeHash(this.normalizeEntries(from.entries()));
+                    const type = from instanceof Map ? 'map' : 'set';
+                    return this.computeHash([type, ...this.normalizeEntries(from.entries())]);
                 }
-                return this.computeHash(this.normalizeEntries(Object.entries(from)));
+                return this.computeHash(['object', ...this.normalizeEntries(Object.entries(from))]);
         }
         return (0, base_1.fail)(`computeHash: Unexpected type - cannot hash '${typeof from}'`);
     }

package/lib/packlets/logging/index.d.ts

@@ -0,0 +1,3 @@
+export * from './logger';
+export * from './logReporter';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/logging/index.js

@@ -0,0 +1,40 @@
+"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 __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 });
+__exportStar(require("./logger"), exports);
+__exportStar(require("./logReporter"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/logging/logReporter.d.ts

@@ -0,0 +1,88 @@
+import { ILogger, ReporterLogLevel } from './logger';
+import { IResultReporter, MessageLogLevel, Success } from '../base';
+/**
+ * A function that formats a value for logging.
+ * @public
+ */
+export type LogValueFormatter<T, TD = unknown> = (value: T, detail?: TD) => string;
+/**
+ * A function that formats a message for logging.
+ * @public
+ */
+export type LogMessageFormatter<TD = unknown> = (message: string, detail?: TD) => string;
+/**
+ * Parameters for creating a {@link Logging.LogReporter | LogReporter}.
+ * @public
+ */
+export interface ILogReporterCreateParams<T, TD = unknown> {
+    logger?: ILogger;
+    valueFormatter?: LogValueFormatter<T, TD>;
+    messageFormatter?: LogMessageFormatter<TD>;
+}
+/**
+ * Abstract base class which wraps an existing {@link Logging.ILogger | ILogger} to implement
+ * both {@link Logging.ILogger | ILogger} and {@link IResultReporter | IResultReporter}.
+ * @public
+ */
+export declare class LogReporter<T, TD = unknown> implements ILogger, IResultReporter<T, TD> {
+    /**
+     * The logger to wrap.
+     * @internal
+     */
+    protected readonly _logger: ILogger;
+    /**
+     * The formatter to use for values.
+     * @internal
+     */
+    protected readonly _valueFormatter: LogValueFormatter<T, TD>;
+    /**
+     * The formatter to use for messages.
+     * @internal
+     */
+    protected readonly _messageFormatter: LogMessageFormatter<TD>;
+    /**
+     * Creates a new {@link Logging.LogReporter | LogReporter}.
+     * @param params - The parameters for creating the {@link Logging.LogReporter | LogReporter}.
+     */
+    constructor(params?: ILogReporterCreateParams<T, TD>);
+    /**
+     * {@inheritDoc Logging.ILogger.logLevel}
+     */
+    get logLevel(): ReporterLogLevel;
+    /**
+     * {@inheritDoc Logging.ILogger.detail}
+     */
+    detail(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
+    /**
+     * {@inheritDoc Logging.ILogger.info}
+     */
+    info(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
+    /**
+     * {@inheritDoc Logging.ILogger.warn}
+     */
+    warn(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
+    /**
+     * {@inheritDoc Logging.ILogger.error}
+     */
+    error(message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
+    /**
+     * {@inheritDoc Logging.ILogger.log}
+     */
+    log(level: MessageLogLevel, message?: unknown, ...parameters: unknown[]): Success<string | undefined>;
+    /**
+     * {@inheritDoc IResultReporter.reportSuccess}
+     */
+    reportSuccess(level: MessageLogLevel, value: T, detail?: TD): void;
+    /**
+     * {@inheritDoc IResultReporter.reportFailure}
+     */
+    reportFailure(level: MessageLogLevel, message: string, detail?: TD): void;
+    /**
+     * Generic method to try to format an object for logging.
+     * @param value - The value to format.
+     * @param detail - The detail to format.
+     * @returns
+     */
+    static tryFormatObject<T = unknown, TD = unknown>(value: T, detail?: TD): string;
+}
+//# sourceMappingURL=logReporter.d.ts.map