@fgv/ts-utils 5.0.0-8 → 5.0.1-0

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

@@ -1,11 +1,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, Hash, ICollectible, IReadOnlyResultMap, Logging, ObjectConverter, ResultMap, StringConverter, ValidatingCollector, ValidatingConvertingCollector, ValidatingResultMap, Validation, Validator, Validators };
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -57,15 +57,15 @@ 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.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"));
 exports.Conversion = Conversion;
 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/mapResults.d.ts

@@ -1,4 +1,4 @@
-import { DetailedResult, IMessageAggregator, Result } from './result';
+import { DeferredResult, DetailedResult, IMessageAggregator, Result } from './result';
 /**
  * Aggregates successful result values from a collection of {@link Result | Result<T>}.
  * @param results - The collection of {@link Result | Result<T>} to be mapped.
@@ -60,6 +60,13 @@ export declare function mapFailures<T>(results: Iterable<Result<T>>, aggregatedE
  * @public
  */
 export declare function allSucceed<T>(results: Iterable<Result<unknown>>, successValue: T, aggregatedErrors?: IMessageAggregator): Result<T>;
+/**
+ * Returns the first successful result from a collection of {@link Result | Result<T>} or {@link DeferredResult | DeferredResult<T>}.
+ * @param results - The collection of {@link Result | Result<T>} or {@link DeferredResult | DeferredResult<T>} to be tested.
+ * @returns The first successful result, or {@link Failure} with a concatenated summary of all error messages.
+ * @public
+ */
+export declare function firstSuccess<T>(results: Iterable<Result<T> | DeferredResult<T>>): Result<T>;
 /**
  * String-keyed record of initialization functions to be passed to {@link (populateObject:1)}
  * or {@link (populateObject:2)}.

package/lib/packlets/base/mapResults.js

@@ -26,7 +26,9 @@ exports.mapDetailedResults = mapDetailedResults;
 exports.mapSuccess = mapSuccess;
 exports.mapFailures = mapFailures;
 exports.allSucceed = allSucceed;
+exports.firstSuccess = firstSuccess;
 exports.populateObject = populateObject;
+const messageAggregator_1 = require("./messageAggregator");
 const result_1 = require("./result");
 /**
  * Aggregates successful result values from a collection of {@link Result | Result<T>}.
@@ -160,6 +162,23 @@ function allSucceed(results, successValue, aggregatedErrors) {
     }
     return (0, result_1.succeed)(successValue);
 }
+/**
+ * Returns the first successful result from a collection of {@link Result | Result<T>} or {@link DeferredResult | DeferredResult<T>}.
+ * @param results - The collection of {@link Result | Result<T>} or {@link DeferredResult | DeferredResult<T>} to be tested.
+ * @returns The first successful result, or {@link Failure} with a concatenated summary of all error messages.
+ * @public
+ */
+function firstSuccess(results) {
+    const errors = new messageAggregator_1.MessageAggregator();
+    for (const r of results) {
+        const result = (0, result_1.isDeferredResult)(r) ? r() : r;
+        if (result.isSuccess()) {
+            return result;
+        }
+        errors.addMessage(result.message);
+    }
+    return errors.returnOrReport((0, result_1.fail)('no results found'));
+}
 function populateObject(initializers, optionsOrOrder, aggregatedErrors) {
     var _a;
     const options = optionsOrOrder

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

@@ -6,6 +6,18 @@
  * @public
  */
 export type Result<T> = Success<T> | Failure<T>;
+/**
+ * Represents a deferred result that will be evaluated if needed.
+ * @public
+ */
+export type DeferredResult<T> = () => Result<T>;
+/**
+ * Checks if a result is a deferred result.
+ * @param result - The result to check.
+ * @returns `true` if the result is a deferred result, `false` otherwise.
+ * @public
+ */
+export declare function isDeferredResult<T>(result: Result<T> | DeferredResult<T>): result is DeferredResult<T>;
 /**
  * Continuation callback to be called in the event that an
  * {@link Result} is successful.
@@ -41,6 +53,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.
@@ -235,8 +278,15 @@ export interface IResult<T> {
      * supplied errors array.
      * @param errors - {@link IMessageAggregator | Error aggregator} in which
      * errors will be aggregated.
+     * @param formatter - An optional {@link ErrorFormatter | error formatter} to be used to format the error message.
+     */
+    aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter): 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.
      */
-    aggregateError(errors: IMessageAggregator): this;
+    report(reporter?: IResultReporter<T>, options?: IResultReportOptions): this;
 }
 /**
  * Reports a successful {@link IResult | result} from some operation and the
@@ -322,7 +372,11 @@ export declare class Success<T> implements IResult<T> {
     /**
      * {@inheritdoc IResult.aggregateError}
      */
-    aggregateError(__errors: IMessageAggregator): this;
+    aggregateError(__errors: IMessageAggregator, __formatter?: ErrorFormatter): 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.
@@ -414,7 +468,11 @@ export declare class Failure<T> implements IResult<T> {
     /**
      * {@inheritdoc IResult.aggregateError}
      */
-    aggregateError(errors: IMessageAggregator): this;
+    aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter): this;
+    /**
+     * {@inheritdoc IResult.report}
+     */
+    report(reporter?: IResultReporter<T>, options?: IResultReportOptions): this;
     /**
      * Get a 'friendly' string representation of this object.
      * @remarks
@@ -458,6 +516,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 +595,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 +661,14 @@ export declare class DetailedFailure<T, TD> extends Failure<T> {
      * {@inheritdoc IResult.withErrorFormat}
      */
     withErrorFormat(cb: ErrorFormatter<TD>): DetailedResult<T, TD>;
+    /**
+     * {@inheritdoc IResult.aggregateError}
+     */
+    aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter<TD>): this;
+    /**
+     * {@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

@@ -22,16 +22,27 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DetailedFailure = exports.DetailedSuccess = exports.Failure = exports.Success = void 0;
+exports.isDeferredResult = isDeferredResult;
 exports.succeed = succeed;
 exports.succeeds = succeeds;
 exports.fail = fail;
 exports.fails = fails;
+exports.useOrInitialize = useOrInitialize;
 exports.succeedWithDetail = succeedWithDetail;
 exports.succeedsWithDetail = succeedsWithDetail;
 exports.failWithDetail = failWithDetail;
 exports.failsWithDetail = failsWithDetail;
 exports.propagateWithDetail = propagateWithDetail;
 exports.captureResult = captureResult;
+/**
+ * Checks if a result is a deferred result.
+ * @param result - The result to check.
+ * @returns `true` if the result is a deferred result, `false` otherwise.
+ * @public
+ */
+function isDeferredResult(result) {
+    return typeof result === 'function';
+}
 /**
  * Reports a successful {@link IResult | result} from some operation and the
  * corresponding value.
@@ -126,7 +137,16 @@ class Success {
     /**
      * {@inheritdoc IResult.aggregateError}
      */
-    aggregateError(__errors) {
+    aggregateError(__errors, __formatter) {
+        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;
     }
     /**
@@ -242,8 +262,19 @@ class Failure {
     /**
      * {@inheritdoc IResult.aggregateError}
      */
-    aggregateError(errors) {
-        errors.addMessage(this._message);
+    aggregateError(errors, formatter) {
+        const message = formatter ? formatter(this._message) : this._message;
+        errors.addMessage(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;
     }
     /**
@@ -302,6 +333,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 +406,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 +491,24 @@ class DetailedFailure extends Failure {
     withErrorFormat(cb) {
         return failWithDetail(cb(this._message, this._detail), this._detail);
     }
+    /**
+     * {@inheritdoc IResult.aggregateError}
+     */
+    aggregateError(errors, formatter) {
+        const message = formatter ? formatter(this._message, this._detail) : this._message;
+        errors.addMessage(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, 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

@@ -114,8 +114,17 @@ class Collector {
      * {@inheritdoc Collections.IReadOnlyCollector.getAt}
      */
     getAt(index) {
+        if (typeof index !== 'number') {
+            // Handle Symbol conversion safely
+            const indexStr = typeof index === 'symbol' ? index.toString() : String(index);
+            return (0, base_1.fail)(`${indexStr}: collector index must be a number.`);
+        }
+        // Check that the number is a finite integer (handles NaN, Infinity, and non-integers)
+        if (!Number.isFinite(index) || !Number.isInteger(index)) {
+            return (0, base_1.fail)(`${index}: collector index must be a finite integer.`);
+        }
         if (index < 0 || index >= this._byIndex.length) {
-            return (0, base_1.fail)(`${index}: out of range.`);
+            return (0, base_1.fail)(`${index}: collector index out of range.`);
         }
         return (0, base_1.succeed)(this._byIndex[index]);
     }
@@ -157,6 +166,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/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/{file-tree/in-memory → logging}/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright (c) 2025 Erik Fortune
+ * 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
@@ -35,5 +35,6 @@ 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("./inMemoryTree"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./logReporter"), exports);
 //# sourceMappingURL=index.js.map