npm - @fgv/ts-utils - Versions diffs - 5.1.0-4 → 5.1.0-40 - Mend

@fgv/ts-utils 5.1.0-4 → 5.1.0-40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (303) hide show

package/dist/packlets/base/result.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/packlets/base/result.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 */\n\nimport { _findShouldNotFailFrame, _formatShouldNotFailMessage } from './shouldNotFail';\n\n/**\n * Represents the {@link IResult | result} of some operation or sequence of operations.\n * @remarks\n * {@link Success | Success<T>} and {@link Failure | Failure<T>} share the common\n * contract {@link IResult}, enabling commingled discriminated usage.\n * @public\n */\nexport type Result<T> = Success<T> | Failure<T>;\n\n/**\n * Represents a deferred result that will be evaluated if needed.\n * @public\n */\nexport type DeferredResult<T> = () => Result<T>;\n\n/**\n * Checks if a result is a deferred result.\n * @param result - The result to check.\n * @returns `true` if the result is a deferred result, `false` otherwise.\n * @public\n */\nexport function isDeferredResult<T>(result: Result<T> | DeferredResult<T>): result is DeferredResult<T> {\n return typeof result === 'function';\n}\n\n/**\n * Continuation callback to be called in the event that an\n * {@link Result} is successful.\n * @public\n */\nexport type SuccessContinuation<T, TN> = (value: T) => Result<TN>;\n\n/**\n * Continuation callback to be called in the event that an\n * {@link Result} fails.\n * @public\n */\nexport type FailureContinuation<T> = (message: string) => Result<T>;\n\n/**\n * Type inference to determine the result type of an {@link Result}.\n * @beta\n */\nexport type ResultValueType<T> = T extends Result<infer TV> ? TV : never;\n\n/**\n * Type inference to determine the result type of an {@link IResult}.\n * @beta\n */\nexport type IResultValueType<T> = T extends IResult<infer TV> ? TV : never;\n\n/**\n * Type inference to determine the value type returned from a result-map style\n * `get` method.\n * @remarks\n * Useful for extracting collection entry types from maps whose `get` method\n * returns an {@link IResult}.\n * @beta\n */\nexport type ResultMapValueType<TCollection extends { get: (...args: readonly unknown[]) => unknown }> =\n Exclude<IResultValueType<ReturnType<TCollection['get']>>, undefined>;\n\n/**\n * Formats an error message.\n * @param message - The error message to be formatted.\n * @param detail - An optional detail to be included in the formatted message.\n * @public\n */\nexport type ErrorFormatter<TD = unknown> = (message: string, detail?: TD) => string;\n\n/**\n * Simple logger interface used by {@link IResult.orThrow | orThrow(logger)} and {@link IResult.orThrow | orThrow(formatter)}.\n * @public\n */\nexport interface IResultLogger<TD = unknown> {\n /**\n * Log an error message.\n * @param message - The message to be logged.\n */\n error(message: string, detail?: TD): void;\n}\n\n/**\n * The severity level at which a message should be logged.\n * @public\n */\nexport type MessageLogLevel = 'quiet' | 'detail' | 'info' | 'warning' | 'error';\n\n// Untyped (literal-tuple-inferred) source of truth for allMessageLogLevels, kept separate from the\n// widened public export below so the exhaustiveness check actually inspects the literal values instead\n// of being widened away to `MessageLogLevel` before the check runs.\nconst messageLogLevelValues = ['quiet', 'detail', 'info', 'warning', 'error'] as const;\n\n/**\n * Compile-time exhaustiveness guard ensuring {@link messageLogLevelValues} exactly matches every member of\n * {@link MessageLogLevel}. Adding or removing a union member without updating the array fails the build.\n * Deliberately not exported - this exists only to force the compiler to evaluate the check below.\n */\ntype _MessageLogLevelExhaustivenessCheck = [\n Exclude<MessageLogLevel, (typeof messageLogLevelValues)[number]>,\n Exclude<(typeof messageLogLevelValues)[number], MessageLogLevel>\n] extends [never, never]\n ? true\n : never;\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst _messageLogLevelExhaustivenessCheck: _MessageLogLevelExhaustivenessCheck = true;\n\n/**\n * Exhaustive list of all {@link MessageLogLevel} values.\n * @public\n */\nexport const allMessageLogLevels: readonly MessageLogLevel[] = messageLogLevelValues;\n\n/**\n * Details for reporting a message.\n * @public\n */\nexport interface IMessageReportDetail<TD = unknown> {\n level?: MessageLogLevel;\n message?: ErrorFormatter<TD>;\n detail?: TD;\n}\n\n/**\n * Options for reporting a result.\n * @public\n */\nexport interface IResultReportOptions<TD = unknown> {\n /**\n * The level of reporting to be used for failure results. Default is 'error'.\n */\n failure?: MessageLogLevel | IMessageReportDetail<TD>;\n\n /**\n * The level of reporting to be used for success results. Default is 'quiet'.\n */\n success?: MessageLogLevel | IMessageReportDetail<TD>;\n}\n\n/**\n * Interface for reporting a result.\n * @public\n */\nexport interface IResultReporter<T, TD = unknown> {\n /** Reports a successful result at the specified log level. */\n reportSuccess(level: MessageLogLevel, value: T, detail?: TD, message?: ErrorFormatter<TD>): void;\n /** Reports a failed result at the specified log level. */\n reportFailure(level: MessageLogLevel, message: string, detail?: TD): void;\n}\n\n/**\n * Simple error aggregator to simplify collecting all errors in\n * a flow.\n * @public\n */\nexport interface IMessageAggregator {\n /**\n * Indicates whether any messages have been aggregated.\n */\n readonly hasMessages: boolean;\n\n /**\n * The number of messages aggregated.\n */\n readonly numMessages: number;\n\n /**\n * The aggregated messages.\n */\n readonly messages: ReadonlyArray<string>;\n\n /**\n * Adds a message to the aggregator, if defined.\n * @param message - The message to add - pass `undefined`\n * or the empty string to continue without adding a message.\n */\n addMessage(message: string | undefined): this;\n\n /**\n * Adds multiple messages to the aggregator.\n * @param messages - the messages to add.\n */\n addMessages(messages: string[] | undefined): this;\n\n /**\n * Returns all messages as a single string joined\n * using the optionally-supplied `separator`, or\n * newline if no separator is specified.\n * @param separator - The optional separator used\n * to join strings.\n */\n toString(separator?: string): string;\n}\n\n/**\n * Represents the result of some operation of sequence of operations.\n * @remarks\n * This common contract enables commingled discriminated usage of {@link Success | Success<T>}\n * and {@link Failure | Failure<T>}.\n * @public\n */\nexport interface IResult<T> {\n /**\n * Indicates whether the operation was successful.\n */\n readonly success: boolean;\n\n /**\n * Value returned by a successful operation, undefined\n * for a failed operation.\n */\n readonly value: T | undefined;\n\n /**\n * Error message returned by a failed operation, undefined\n * for a successful operation.\n */\n readonly message: string | undefined;\n\n /**\n * Indicates whether this operation was successful. Functions\n * as a type guard for {@link Success | Success<T>}.\n */\n isSuccess(): this is Success<T>;\n\n /**\n * Indicates whether this operation failed. Functions\n * as a type guard for {@link Failure | Failure<T>}.\n */\n isFailure(): this is Failure<T>;\n\n /**\n * Gets the value associated with a successful {@link IResult | result},\n * or throws the error message if the corresponding operation failed.\n *\n * Note that `getValueOrThrow` is being superseded by `orThrow` and\n * will eventually be deprecated. Please use orDefault instead.\n *\n * @param logger - An optional {@link IResultLogger | logger} to which the\n * error will also be reported.\n * @returns The return value, if the operation was successful.\n * @throws The error message if the operation failed.\n * @deprecated Use {@link IResult.orThrow | orThrow(logger)} or {@link IResult.orThrow | orThrow(formatter)} instead.\n */\n getValueOrThrow(logger?: IResultLogger): T;\n\n /**\n * Gets the value associated with a successful {@link IResult | result},\n * or a default value if the corresponding operation failed.\n * @param dflt - The value to be returned if the operation failed (default is\n * `undefined`).\n *\n * Note that `getValueOrDefault` is being superseded by `orDefault` and\n * will eventually be deprecated. Please use orDefault instead.\n *\n * @returns The return value, if the operation was successful. Returns\n * the supplied default value or `undefined` if no default is supplied.\n * @deprecated Use {@link IResult.orDefault | orDefault(T)} or {@link IResult.orDefault | orDefault()} instead.\n */\n getValueOrDefault(dflt?: T): T | undefined;\n\n /**\n * Gets the value associated with a successful {@link IResult | result},\n * or throws the error message if the corresponding operation failed.\n * @param logger - An optional {@link IResultLogger | logger} to which the\n * error will also be reported.\n * @returns The return value, if the operation was successful.\n * @throws The error message if the operation failed.\n * {@label logger}\n */\n orThrow(logger?: IResultLogger): T;\n\n /**\n * Gets the value associated with a successful {@link IResult | result},\n * or throws the error message if the corresponding operation failed.\n * @param cb - The {@link ErrorFormatter | error formatter} to be called in the event of failure.\n * @returns The return value, if the operation was successful.\n * @throws The error message if the operation failed.\n * {@label formatter}\n */\n orThrow(cb: ErrorFormatter): T;\n\n /**\n * Asserts at the call site that this {@link IResult | result} MUST be a success.\n * Returns the value on success; on failure, throws an `Error` whose message\n * is composed from the original failure message and the captured call-site\n * location (file, line, and where useful function name).\n *\n * @remarks\n * Use for declaration-time / setup-time invariants — module-level `const`\n * initializers, static class properties, static initialization blocks, and\n * test fixtures — where a failure indicates a coding bug that should\n * surface at the call site rather than propagate as a `Result`. For chains\n * where the throw is intentional control flow, prefer `orThrow`.\n *\n * On V8 (Node + Chromium) `Error.captureStackTrace` is used to elide\n * `shouldNotFail` itself from the captured stack so the parsed frame is\n * the user's call site directly. On WebKit (where `captureStackTrace` is\n * unavailable) the stack is parsed manually and frames whose **parsed\n * function name** contains `shouldNotFail` are filtered out — the raw\n * stack-line text (including the file path) is deliberately NOT inspected,\n * so consumer files named after `shouldNotFail` are not collateral damage.\n * Function names and exact line numbers depend on source-map availability\n * in the runtime. When no caller frame is recoverable (e.g. `frameDepth`\n * out of range, or `frameDepth: 0`) the message falls back to the\n * label-only form (or the bare original message when no label is given).\n *\n * Error message format (depending on whether a label and a usable function\n * name are available):\n * - both: `<label> (at <fn> in <file>:<line>): <original>`\n * - label only: `<label> (at <file>:<line>): <original>`\n * - fn only: `<fn> at <file>:<line>: <original>`\n * - neither: `<file>:<line>: <original>`\n *\n * @param label - Optional human-meaningful identifier (e.g. the constant\n * name) prefixed to the error message.\n * @param frameDepth - Optional 1-indexed depth into the caller stack.\n * Default `1` (immediate caller). Library authors wrapping `shouldNotFail`\n * inside their own helper pass `2` to attribute to their caller.\n * @returns The result value, if the operation was successful.\n * @throws `Error` if the result was a failure.\n */\n shouldNotFail(label?: string, frameDepth?: number): T;\n\n /**\n * Gets the value associated with a successful {@link IResult | result},\n * or a default value if the corresponding operation failed.\n * @param dflt - The value to be returned if the operation failed.\n * @returns The return value, if the operation was successful. Returns\n * the supplied default if an error occurred.\n * {@label SUPPLIED}\n */\n orDefault(dflt: T): T;\n\n /**\n * Gets the value associated with a successful {@link IResult | result},\n * or a default value if the corresponding operation failed.\n * @returns The return value, if the operation was successful, or\n * `undefined` if an error occurs.\n * {@label MISSING}\n */\n orDefault(): T | undefined;\n\n /**\n * Calls a supplied {@link SuccessContinuation | success continuation} if\n * the operation was a success.\n * @remarks\n * The {@link SuccessContinuation | success continuation} might return a\n * different result type than {@link IResult} on which it is invoked. This\n * enables chaining of operations with heterogenous return types.\n *\n * @param cb - The {@link SuccessContinuation | success continuation} to\n * be called in the event of success.\n * @returns If this operation was successful, returns the value returned\n * by the {@link SuccessContinuation | success continuation}. If this result\n * failed, propagates the error message from this failure.\n */\n onSuccess<TN>(cb: SuccessContinuation<T, TN>): Result<TN>;\n\n /**\n * Calls a supplied {@link FailureContinuation | failed continuation} if\n * the operation failed.\n * @param cb - The {@link FailureContinuation | failure continuation} to\n * be called in the event of failure.\n * @returns If this operation failed, returns the value returned by the\n * {@link FailureContinuation | failure continuation}. If this result\n * was successful, propagates the result value from the successful event.\n */\n onFailure(cb: FailureContinuation<T>): Result<T>;\n\n /**\n * Calls a supplied {@link AsyncSuccessContinuation | async success continuation} if\n * the operation was a success, bridging into an {@link AsyncResult} chain.\n * @remarks\n * If the async callback rejects, the rejection is caught and converted\n * to a {@link Failure}.\n * @param cb - The {@link AsyncSuccessContinuation | async success continuation} to\n * be called in the event of success.\n * @returns An {@link AsyncResult} wrapping the async continuation result, or\n * propagating the error message from this failure.\n */\n thenOnSuccess<TN>(cb: AsyncSuccessContinuation<T, TN>): AsyncResult<TN>;\n\n /**\n * Calls a supplied {@link AsyncFailureContinuation | async failure continuation} if\n * the operation failed, bridging into an {@link AsyncResult} chain.\n * @remarks\n * If the async callback rejects, the rejection is caught and converted\n * to a {@link Failure}.\n * @param cb - The {@link AsyncFailureContinuation | async failure continuation} to\n * be called in the event of failure.\n * @returns An {@link AsyncResult} wrapping the async continuation result, or\n * propagating the success value from this result.\n */\n thenOnFailure(cb: AsyncFailureContinuation<T>): AsyncResult<T>;\n\n /**\n * Calls a supplied {@link ErrorFormatter | error formatter} if\n * the operation failed.\n * @param cb - The {@link ErrorFormatter | error formatter} to\n * be called in the event of failure.\n * @returns If this operation failed, returns the returns {@link Failure | Failure}\n * with the message returned by the formatter. If this result\n * was successful, propagates the result value from the successful event.\n */\n withErrorFormat(cb: ErrorFormatter): Result<T>;\n\n /**\n * Converts a {@link IResult | IResult<T>} to a {@link DetailedResult | DetailedResult<T, TD>},\n * adding a supplied detail if the operation failed.\n * @param detail - The detail to be added if this operation failed.\n * @returns A new {@link DetailedResult | DetailedResult<T, TD>} with either\n * the success result or the error message from this {@link IResult}, with\n * the supplied detail (if this event failed) or detail `undefined` (if\n * this result succeeded).\n */\n withFailureDetail<TD>(detail: TD): DetailedResult<T, TD>;\n\n /**\n * Converts a {@link IResult | IResult<T>} to a {@link DetailedResult | DetailedResult<T, TD>},\n * adding supplied details.\n * @param detail - The default detail to be added to the new {@link DetailedResult}.\n * @param successDetail - An optional detail to be added if this result was successful.\n * @returns A new {@link DetailedResult | DetailedResult<T, TD>} with either\n * the success result or the error message from this {@link IResult} and the\n * appropriate added detail.\n */\n withDetail<TD>(detail: TD, successDetail?: TD): DetailedResult<T, TD>;\n\n /**\n * Propagates interior result, appending any error message to the\n * supplied errors array.\n * @param errors - {@link IMessageAggregator | Error aggregator} in which\n * errors will be aggregated.\n * @param formatter - An optional {@link ErrorFormatter | error formatter} to be used to format the error message.\n */\n aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter): this;\n\n /**\n * Reports the result to the supplied reporter\n * @param reporter - The {@link IResultReporter | reporter} to which the result will be reported.\n * @param options - The {@link IResultReportOptions | options} for reporting the result.\n */\n report(reporter?: IResultReporter<T>, options?: IResultReportOptions<unknown>): Result<T>;\n}\n\n/**\n * Reports a successful {@link IResult | result} from some operation and the\n * corresponding value.\n * @public\n */\nexport class Success<out T> implements IResult<T> {\n /**\n * {@inheritDoc IResult.success}\n */\n public readonly success: true = true;\n\n /**\n * For a successful operation, the error message is always `undefined`.\n */\n public readonly message: undefined = undefined;\n\n /**\n * @internal\n */\n protected readonly _value: T;\n\n /**\n * Constructs a {@link Success} with the supplied value.\n * @param value - The value to be returned.\n */\n public constructor(value: T) {\n this._value = value;\n }\n\n /**\n * The result value returned by the successful operation.\n */\n public get value(): T {\n return this._value;\n }\n\n /**\n * {@inheritDoc IResult.isSuccess}\n */\n public isSuccess(): this is Success<T> {\n return true;\n }\n\n /**\n * {@inheritDoc IResult.isFailure}\n */\n public isFailure(): this is Failure<T> {\n return false;\n }\n\n /**\n * {@inheritDoc IResult.orThrow}\n */\n public orThrow(logger?: IResultLogger): T;\n\n /**\n * {@inheritDoc IResult.orThrow}\n */\n public orThrow(cb: ErrorFormatter): T;\n public orThrow(__logger?: IResultLogger | ErrorFormatter): T {\n return this._value;\n }\n\n /**\n * {@inheritDoc IResult.shouldNotFail}\n */\n public shouldNotFail(__label?: string, __frameDepth?: number): T {\n return this._value;\n }\n\n /**\n * {@inheritDoc IResult.orDefault}\n */\n public orDefault(dflt: T): T;\n /**\n * {@inheritDoc IResult.orDefault}\n */\n public orDefault(): T | undefined;\n public orDefault(dflt?: T): T | undefined {\n return this._value ?? dflt;\n }\n\n /**\n * {@inheritDoc IResult.getValueOrThrow}\n * @deprecated Use {@link Success.orThrow | orThrow(logger)} or {@link Success.orThrow | orThrow(formatter)} instead.\n */\n public getValueOrThrow(__logger?: IResultLogger): T {\n return this._value;\n }\n\n /**\n * {@inheritDoc IResult.getValueOrDefault}\n * @deprecated Use {@link Success.orDefault | orDefault(T)} or {@link Success.orDefault | orDefault()} instead.\n */\n public getValueOrDefault(dflt?: T): T | undefined {\n return this._value ?? dflt;\n }\n\n /**\n * {@inheritDoc IResult.onSuccess}\n */\n public onSuccess<TN>(cb: SuccessContinuation<T, TN>): Result<TN> {\n return cb(this._value);\n }\n\n /**\n * {@inheritDoc IResult.onFailure}\n */\n public onFailure(__: FailureContinuation<T>): Result<T> {\n return this;\n }\n\n /**\n * {@inheritDoc IResult.thenOnSuccess}\n */\n public thenOnSuccess<TN>(cb: AsyncSuccessContinuation<T, TN>): AsyncResult<TN> {\n try {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return new AsyncResult(cb(this._value));\n } catch (err: unknown) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return AsyncResult.from(fail<TN>(_errorMessage(err)));\n }\n }\n\n /**\n * {@inheritDoc IResult.thenOnFailure}\n */\n public thenOnFailure(__: AsyncFailureContinuation<T>): AsyncResult<T> {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return AsyncResult.from(this);\n }\n\n /**\n * {@inheritDoc IResult.withErrorFormat}\n */\n public withErrorFormat(__cb: ErrorFormatter): Result<T> {\n return this;\n }\n\n /**\n * {@inheritDoc IResult.withFailureDetail}\n */\n public withFailureDetail<TD>(__detail: TD): DetailedResult<T, TD> {\n return succeedWithDetail(this._value);\n }\n\n /**\n * {@inheritDoc IResult.withDetail}\n */\n public withDetail<TD>(detail: TD, successDetail?: TD): DetailedResult<T, TD> {\n return succeedWithDetail(this._value, successDetail ?? detail);\n }\n\n /**\n * {@inheritDoc IResult.aggregateError}\n */\n public aggregateError(__errors: IMessageAggregator, __formatter?: ErrorFormatter): this {\n return this;\n }\n\n /**\n * {@inheritDoc IResult.report}\n */\n public report(reporter?: IResultReporter<T>, options?: IResultReportOptions<unknown>): Success<T> {\n const successOptions =\n typeof options?.success === 'object' ? options.success : { level: options?.success };\n const level = successOptions.level ?? 'quiet';\n reporter?.reportSuccess(level, this._value, undefined, successOptions.message);\n return this;\n }\n\n /**\n * Creates a {@link Success | Success<T>} with the supplied value.\n * @param value - The value to be returned.\n * @returns The resulting {@link Success | Success<T>} with the supplied value.\n * @public\n */\n public static with<T>(value: T): Success<T> {\n return new Success<T>(value);\n }\n}\n\n/**\n * Reports a failed {@link IResult | result} from some operation, with an error message.\n * @public\n */\nexport class Failure<out T> implements IResult<T> {\n /**\n * {@inheritDoc IResult.success}\n */\n public readonly success: false = false;\n /**\n * Failed operation always returns undefined for value.\n */\n public readonly value: undefined = undefined;\n\n /**\n * @internal\n */\n protected readonly _message: string;\n\n /**\n * Constructs a {@link Failure} with the supplied message.\n * @param message - Error message to be reported.\n */\n public constructor(message: string) {\n this._message = message;\n }\n\n /**\n * Gets the error message associated with this error.\n */\n public get message(): string {\n return this._message;\n }\n\n /**\n * {@inheritDoc IResult.isSuccess}\n */\n public isSuccess(): this is Success<T> {\n return false;\n }\n\n /**\n * {@inheritDoc IResult.isFailure}\n */\n public isFailure(): this is Failure<T> {\n return true;\n }\n\n /**\n * {@inheritDoc IResult.orThrow}\n */\n public orThrow(logger?: IResultLogger): never;\n\n /**\n * {@inheritDoc IResult.orThrow}\n */\n public orThrow(cb: ErrorFormatter): never;\n public orThrow(logOrFormat?: IResultLogger | ErrorFormatter): never {\n if (logOrFormat !== undefined) {\n if (typeof logOrFormat === 'function') {\n throw new Error(logOrFormat(this._message));\n } else {\n logOrFormat.error(this._message);\n }\n }\n throw new Error(this._message);\n }\n\n /**\n * {@inheritDoc IResult.shouldNotFail}\n */\n public shouldNotFail(label?: string, frameDepth: number = 1): never {\n // Parse a probe Error's stack to identify the caller frame for message\n // composition. We must NOT reuse this probe as the thrown Error: in V8,\n // `.stack` is materialized lazily on first access (which happens below in\n // `_findShouldNotFailFrame`), and once materialized the cached stack\n // header carries whatever message was set at that moment. Mutating\n // `.message` afterwards does not refresh the cached `.stack` header.\n const probe = new Error();\n if (typeof Error.captureStackTrace === 'function') {\n Error.captureStackTrace(probe, this.shouldNotFail);\n }\n const frame = _findShouldNotFailFrame(probe.stack, frameDepth);\n const message = _formatShouldNotFailMessage(this._message, label, frame);\n // Build the final Error with the formatted message and re-elide\n // `shouldNotFail` from its stack, so the thrown error's `.stack` shows\n // both the formatted message in its header and the caller as its top\n // frame.\n const err = new Error(message);\n if (typeof Error.captureStackTrace === 'function') {\n Error.captureStackTrace(err, this.shouldNotFail);\n }\n throw err;\n }\n\n /**\n * {@inheritDoc IResult.orDefault}\n */\n public orDefault(dflt: T): T;\n /**\n * {@inheritDoc IResult.orDefault}\n */\n public orDefault(): T | undefined;\n public orDefault(dflt?: T): T | undefined {\n return dflt;\n }\n\n /**\n * {@inheritDoc IResult.getValueOrThrow}\n * @deprecated Use {@link Failure.orThrow | orThrow(logger)} or {@link Failure.orThrow | orThrow(formatter)} instead.\n */\n public getValueOrThrow(logger?: IResultLogger): never {\n if (logger !== undefined) {\n logger.error(this._message);\n }\n throw new Error(this._message);\n }\n\n /**\n * {@inheritDoc IResult.getValueOrDefault}\n * @deprecated Use {@link Failure.orDefault | orDefault(T)} or {@link Failure.orDefault | orDefault()} instead.\n */\n public getValueOrDefault(dflt?: T): T | undefined {\n return dflt;\n }\n\n /**\n * {@inheritDoc IResult.onSuccess}\n */\n public onSuccess<TN>(__: SuccessContinuation<T, TN>): Result<TN> {\n return new Failure(this._message);\n }\n\n /**\n * {@inheritDoc IResult.onFailure}\n */\n public onFailure(cb: FailureContinuation<T>): Result<T> {\n return cb(this._message);\n }\n\n /**\n * {@inheritDoc IResult.thenOnSuccess}\n */\n public thenOnSuccess<TN>(__: AsyncSuccessContinuation<T, TN>): AsyncResult<TN> {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return AsyncResult.from(fail<TN>(this._message));\n }\n\n /**\n * {@inheritDoc IResult.thenOnFailure}\n */\n public thenOnFailure(cb: AsyncFailureContinuation<T>): AsyncResult<T> {\n try {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return new AsyncResult(cb(this._message));\n } catch (err: unknown) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return AsyncResult.from(fail<T>(_errorMessage(err)));\n }\n }\n\n /**\n * {@inheritDoc IResult.withErrorFormat}\n */\n public withErrorFormat(cb: ErrorFormatter): Result<T> {\n return fail(cb(this._message));\n }\n\n /**\n * {@inheritDoc IResult.withFailureDetail}\n */\n public withFailureDetail<TD>(detail: TD): DetailedResult<T, TD> {\n return failWithDetail(this._message, detail);\n }\n\n /**\n * {@inheritDoc IResult.withDetail}\n */\n public withDetail<TD>(detail: TD, __successDetail?: TD): DetailedResult<T, TD> {\n return failWithDetail(this._message, detail);\n }\n\n /**\n * {@inheritDoc IResult.aggregateError}\n */\n public aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter): this {\n const message = formatter ? formatter(this._message) : this._message;\n errors.addMessage(message);\n return this;\n }\n\n /**\n * {@inheritDoc IResult.report}\n */\n public report(reporter?: IResultReporter<T>, options?: IResultReportOptions<unknown>): Failure<T> {\n const failureOptions =\n typeof options?.failure === 'object' ? options.failure : { level: options?.failure };\n const level = failureOptions.level ?? 'error';\n const message = failureOptions.message?.(this._message) ?? this._message;\n reporter?.reportFailure(level, message);\n return this;\n }\n\n /**\n * Re-types this {@link Failure | Failure<T>} as {@link Failure | Failure} for\n * propagation under a different success type.\n * @remarks\n * Supports the canonical Result early-return-after-`isFailure()` pattern when the\n * outer function's success type differs from the inner Result's success type:\n *\n * ```ts\n * const storeResult = await PromptStoreFixture.build(seed);\n * if (storeResult.isFailure()) {\n * return storeResult.withType<PromptLibrary>();\n * }\n * return PromptLibrary.create({ store: storeResult.value, ... });\n * ```\n *\n * Without this helper, TypeScript rejects `return storeResult` because\n * `Failure<IPromptStore>` is invariant in `T` and not assignable to\n * `Result<PromptLibrary>`. The workaround `return fail(r.message)` is\n * semantically equivalent but allocates a new {@link Failure} instance;\n * `withType` returns `this` and only retypes statically.\n *\n * This method is sound because a {@link Failure} variant carries no `T`-shaped\n * data — only an error message — so re-typing it as `Failure` cannot\n * misrepresent any value. The same operation is NOT exposed on {@link Success}\n * because `Success<T>` carries `T`-shaped data and re-typing would be a lie.\n *\n * For `DetailedResult` propagation that preserves a typed `detail`, consider\n * propagating the {@link DetailedFailure} directly through `onSuccess` (which\n * already re-types the success arm) rather than reaching for `withType`.\n *\n * @returns This same {@link Failure} instance, statically retyped as\n * {@link Failure | Failure}.\n * @public\n */\n public withType(): Failure {\n // Safe by construction: Failure carries no T-shaped data, only a message.\n // Re-typing the static T parameter cannot misrepresent any value.\n return this as unknown as Failure;\n }\n\n /**\n * Get a 'friendly' string representation of this object.\n * @remarks\n * The string representation of a {@link Failure} value is the error message.\n * @returns A string representing this object.\n */\n public toString(): string {\n return this._message;\n }\n\n /**\n * Creates a {@link Failure | Failure<T>} with the supplied error message.\n * @param message - The error message to be returned.\n * @returns The resulting {@link Failure | Failure<T>} with the supplied error message.\n */\n public static with<T>(message: string): Failure<T> {\n return new Failure<T>(message);\n }\n}\n\n/**\n * Returns {@link Success | Success<T>} with the supplied result value.\n * @param value - The successful result value to be returned\n * @remarks\n * A `succeeds` alias was added in release 5.0 for\n * naming consistency with {@link fails | fails}, which was added\n * to avoid conflicts with test frameworks and libraries.\n * @public\n */\nexport function succeed<T>(value: T): Success<T> {\n return new Success<T>(value);\n}\n\n/**\n * {@inheritDoc succeed}\n * @public\n */\nexport function succeeds<T>(value: T): Success<T> {\n return new Success<T>(value);\n}\n\n/**\n * Returns {@link Failure | Failure<T>} with the supplied error message.\n * @param message - Error message to be returned.\n * @remarks\n * A `fails` alias was added in release 5.0 due to\n * issues with the name `fail` being used test frameworks and libraries.\n * @public\n */\nexport function fail<T>(message: string): Failure<T> {\n return new Failure<T>(message);\n}\n\n/**\n * {@inheritDoc fail}\n * @public\n */\nexport function fails<T>(message: string): Failure<T> {\n return new Failure<T>(message);\n}\n\n/**\n * Uses a value or calls a supplied initializer if the supplied value is undefined.\n * @param value - the value\n * @param initializer - a function that initializes the value if it is undefined\n * @returns `Success` with the value if it is defined, or the result of calling the initializer function.\n * @public\n */\nexport function useOrInitialize<T>(value: T | undefined, initializer: () => Result<T>): Result<T> {\n return value !== undefined ? succeed(value) : initializer();\n}\n\n/**\n * Callback to be called when a {@link DetailedResult | DetailedResult} encounters success.\n * @remarks\n * A success callback can return a different result type than it receives, allowing\n * success results to chain through intermediate result types.\n * @public\n */\nexport type DetailedSuccessContinuation<T, TD, TN> = (value: T, detail?: TD) => DetailedResult<TN, TD>;\n\n/**\n * Callback to be called when a {@link DetailedResult | DetailedResult} encounters a failure.\n * @remarks\n * A failure callback can change {@link DetailedFailure | DetailedFailure<T, TD>} to\n * {@link DetailedSuccess | DetailedSuccess<T, TD>} (e.g. by returning a default value)\n * or it can change or embellish the error message, but it cannot change the success return type.\n * @public\n */\nexport type DetailedFailureContinuation<T, TD> = (message: string, detail?: TD) => DetailedResult<T, TD>;\n\n/**\n * A {@link DetailedSuccess | DetailedSuccess} extends {@link Success | Success} to report optional success\n * details in addition to the error message.\n * @public\n */\nexport class DetailedSuccess<out T, out TD> extends Success<T> {\n /**\n * @internal\n */\n protected _detail?: TD;\n\n /**\n * Constructs a new {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied\n * value and detail.\n * @param value - The value to be returned.\n * @param detail - An optional successful detail to be returned. If omitted, detail\n * will be `undefined`.\n */\n public constructor(value: T, detail?: TD) {\n super(value);\n this._detail = detail;\n }\n\n /**\n * The success detail associated with this {@link DetailedSuccess}, or `undefined` if\n * no detail was supplied.\n */\n public get detail(): TD | undefined {\n return this._detail;\n }\n\n /**\n * Reports that this {@link DetailedSuccess} is a success.\n * @remarks\n * Always true for {@link DetailedSuccess} but can be used as type guard\n * to discriminate {@link DetailedSuccess} from {@link DetailedFailure} in\n * a {@link DetailedResult}.\n * @returns `true`\n */\n public isSuccess(): this is DetailedSuccess<T, TD> {\n return true;\n }\n\n /**\n * Invokes the supplied {@link DetailedSuccessContinuation | success callback} and propagates\n * its returned {@link DetailedResult | DetailedResult<TN, TD>}.\n * @remarks\n * The success callback mutates the return type from `<T>` to `<TN>`.\n * @param cb - The {@link DetailedSuccessContinuation | success callback} to be invoked.\n * @returns The {@link DetailedResult | DetailedResult<T, TD>} returned by the success callback.\n */\n public onSuccess<TN>(cb: DetailedSuccessContinuation<T, TD, TN>): DetailedResult<TN, TD> {\n return cb(this._value, this._detail);\n }\n\n /**\n * Propagates this {@link DetailedSuccess}.\n * @remarks\n * Failure does not mutate return type so we can return this event directly.\n * @param __cb - {@link DetailedFailureContinuation | Failure callback} to be called\n * on a {@link DetailedResult} in case of failure (ignored).\n * @returns `this`\n */\n public onFailure(__cb: DetailedFailureContinuation<T, TD>): DetailedResult<T, TD> {\n return this;\n }\n\n /**\n * {@inheritDoc Success.withErrorFormat}\n */\n public withErrorFormat(cb: ErrorFormatter): DetailedResult<T, TD> {\n return this;\n }\n\n /**\n * {@inheritDoc IResult.report}\n */\n public report(\n reporter?: IResultReporter<T, unknown>,\n options?: IResultReportOptions<unknown>\n ): DetailedSuccess<T, TD> {\n const successOptions =\n typeof options?.success === 'object' ? options.success : { level: options?.success };\n const level = successOptions.level ?? 'quiet';\n // Cast reporter to preserve detail type when calling reportSuccess\n const detailedReporter = reporter as IResultReporter<T, TD> | undefined;\n detailedReporter?.reportSuccess(level, this._value, this._detail, successOptions.message);\n return this;\n }\n\n /**\n * Creates a {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied value and\n * optional detail.\n */\n public static with<T, TD>(value: T, detail?: TD): DetailedSuccess<T, TD> {\n return new DetailedSuccess<T, TD>(value, detail);\n }\n\n /**\n * Returns this {@link DetailedSuccess} as a {@link Result}.\n */\n public get asResult(): Result<T> {\n return this;\n }\n}\n\n/**\n * A {@link DetailedFailure | DetailedFailure<T, TD>} extends {@link Failure | Failure<T>} to report optional\n * failure details in addition to the error message.\n * @public\n */\nexport class DetailedFailure<out T, out TD> extends Failure<T> {\n /**\n * @internal\n */\n protected _detail?: TD;\n\n /**\n * Constructs a new {@link DetailedFailure | DetailedFailure<T, TD>} with the supplied\n * message and detail.\n * @param message - The message to be returned.\n * @param detail - The error detail to be returned.\n */\n public constructor(message: string, detail?: TD) {\n super(message);\n this._detail = detail;\n }\n\n /**\n * The error detail associated with this {@link DetailedFailure}.\n */\n public get detail(): TD | undefined {\n return this._detail;\n }\n\n /**\n * Reports that this {@link DetailedFailure} is a failure.\n * @remarks\n * Always true for {@link DetailedFailure} but can be used as type guard\n * to discriminate {@link DetailedSuccess} from {@link DetailedFailure} in\n * a {@link DetailedResult}.\n * @returns `true`\n */\n public isFailure(): this is DetailedFailure<T, TD> {\n return true;\n }\n\n /**\n * Propagates the error message and detail from this result.\n * @remarks\n * Mutates the success type as the success callback would have, but does not\n * call the success callback.\n * @param __cb - {@link DetailedSuccessContinuation | Success callback} to be called\n * on a {@link DetailedResult} in case of success (ignored).\n * @returns A new {@link DetailedFailure | DetailedFailure<TN, TD>} which contains\n * the error message and detail from this one.\n */\n public onSuccess<TN>(__cb: DetailedSuccessContinuation<T, TD, TN>): DetailedResult<TN, TD> {\n return new DetailedFailure<TN, TD>(this._message, this._detail);\n }\n\n /**\n * Invokes the supplied {@link DetailedFailureContinuation | failure callback} and propagates\n * its returned {@link DetailedResult | DetailedResult<T, TD>}.\n * @param cb - The {@link DetailedFailureContinuation | failure callback} to be invoked.\n * @returns The {@link DetailedResult | DetailedResult<T, TD>} returned by the failure callback.\n */\n public onFailure(cb: DetailedFailureContinuation<T, TD>): DetailedResult<T, TD> {\n return cb(this._message, this._detail);\n }\n\n /**\n * {@inheritDoc IResult.withErrorFormat}\n */\n public withErrorFormat(cb: ErrorFormatter<TD>): DetailedResult<T, TD> {\n return failWithDetail(cb(this._message, this._detail), this._detail);\n }\n\n /**\n * {@inheritDoc IResult.aggregateError}\n */\n public aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter<TD>): this {\n const message = formatter ? formatter(this._message, this._detail) : this._message;\n errors.addMessage(message);\n return this;\n }\n\n /**\n * {@inheritDoc IResult.report}\n */\n public report(\n reporter?: IResultReporter<T, unknown>,\n options?: IResultReportOptions<unknown>\n ): DetailedFailure<T, TD> {\n const failureOptions =\n typeof options?.failure === 'object' ? options.failure : { level: options?.failure };\n const level = failureOptions.level ?? 'error';\n // Cast formatter to handle detail type properly\n const formatter = failureOptions.message as ErrorFormatter<TD> | undefined;\n const message = formatter?.(this._message, this._detail) ?? this._message;\n // Cast reporter to preserve detail type when calling reportFailure\n const detailedReporter = reporter as IResultReporter<T, TD> | undefined;\n detailedReporter?.reportFailure(level, message, this._detail);\n return this;\n }\n\n public orThrow(logOrFormat?: IResultLogger<TD> | ErrorFormatter<TD>): never;\n public orThrow(cb: ErrorFormatter): never;\n public orThrow(logOrFormat?: IResultLogger<TD> | ErrorFormatter<TD>): never {\n if (logOrFormat !== undefined) {\n if (typeof logOrFormat === 'function') {\n throw new Error(logOrFormat(this._message, this._detail));\n } else {\n logOrFormat.error(this._message, this._detail);\n }\n }\n throw new Error(this._message);\n }\n\n /**\n * Returns this {@link DetailedFailure} as a {@link Result}.\n */\n public get asResult(): Result<T> {\n return this;\n }\n\n /**\n * Creates a {@link DetailedFailure | DetailedFailure<T, TD>} with the supplied error message\n * and optional detail.\n * @param message - The error message to be returned.\n * @param detail - The error detail to be returned.\n * @returns The resulting {@link DetailedFailure | DetailedFailure<T, TD>} with the supplied\n * error message and detail.\n * @public\n */\n public static with<T, TD>(message: string, detail?: TD): DetailedFailure<T, TD> {\n return new DetailedFailure<T, TD>(message, detail);\n }\n}\n\n/**\n * Represents a result with additional detail.\n * @beta\n */\nexport type DetailedResult<T, TD> = DetailedSuccess<T, TD> | DetailedFailure<T, TD>;\n\n/**\n * Type inference to determine the result type `T` of a {@link DetailedResult | DetailedResult<T, TD>}.\n * @beta\n */\nexport type DetailedResultValueType<T> = T extends DetailedResult<infer TV, unknown> ? TV : never;\n\n/**\n * Type inference to determine the detail type `TD` of a {@link DetailedResult | DetailedResult<T, TD>}.\n * @beta\n */\nexport type ResultDetailType<T> = T extends DetailedResult<unknown, infer TD> ? TD : never;\n\n/**\n * Returns {@link DetailedSuccess | DetailedSuccess<T, TD>} with a supplied value and optional\n * detail.\n * @param value - The value of type `<T>` to be returned.\n * @param detail - An optional detail of type `<TD>` to be returned.\n * @returns A {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied value\n * and detail, if supplied.\n * @remarks\n * The `succeedsWithDetail` alias was added in release 5.0 for\n * naming consistency with {@link fails | fails}, which was added to avoid conflicts\n * with test frameworks and libraries.\n * @public\n */\nexport function succeedWithDetail<T, TD>(value: T, detail?: TD): DetailedSuccess<T, TD> {\n return new DetailedSuccess<T, TD>(value, detail);\n}\n\n/**\n * {@inheritDoc succeedWithDetail}\n * @public\n */\nexport function succeedsWithDetail<T, TD>(value: T, detail?: TD): DetailedSuccess<T, TD> {\n return new DetailedSuccess<T, TD>(value, detail);\n}\n\n/**\n * Returns {@link DetailedFailure | DetailedFailure<T, TD>} with a supplied error message and detail.\n * @param message - The error message to be returned.\n * @param detail - The event detail to be returned.\n * @returns An {@link DetailedFailure | DetailedFailure<T, TD>} with the supplied error\n * message and detail.\n * @remarks\n * The `failsWithDetail` alias was added in release 5.0 for naming consistency\n * with {@link fails | fails}, which was added to avoid conflicts with test frameworks and libraries.\n * @public\n */\nexport function failWithDetail<T, TD>(message: string, detail?: TD): DetailedFailure<T, TD> {\n return new DetailedFailure<T, TD>(message, detail);\n}\n\n/**\n * {@inheritDoc failWithDetail}\n * @public\n */\nexport function failsWithDetail<T, TD>(message: string, detail?: TD): DetailedFailure<T, TD> {\n return new DetailedFailure<T, TD>(message, detail);\n}\n\n/**\n * Propagates a {@link Success} or {@link Failure} {@link Result}, adding supplied\n * event details as appropriate.\n * @param result - The {@link Result} to be propagated.\n * @param detail - The event detail (type `<TD>`) to be added to the {@link Result | result}.\n * @param successDetail - An optional distinct event detail to be added to {@link Success} results. If `successDetail`\n * is omitted or `undefined`, then `detail` will be applied to {@link Success} results.\n * @returns A new {@link DetailedResult | DetailedResult<T, TD>} with the success value or error\n * message from the original `result` but with the specified detail added.\n * @public\n */\nexport function propagateWithDetail<T, TD>(\n result: Result<T>,\n detail: TD,\n successDetail?: TD\n): DetailedResult<T, TD> {\n return result.isSuccess()\n ? succeedWithDetail(result.value, successDetail ?? detail)\n : failWithDetail(result.message, detail);\n}\n\n/**\n * Extracts a message string from an unknown thrown/rejected value.\n * @param err - The caught error value.\n * @returns The error message string.\n * @internal\n */\nexport function _errorMessage(err: unknown): string {\n if (err instanceof Error) {\n return err.message;\n }\n return String(err);\n}\n\n/**\n * Wraps a function which might throw to convert exception results\n * to {@link Failure}.\n * @param func - The function to be captured.\n * @returns Returns {@link Success} with a value of type `<T>` on\n * success , or {@link Failure} with the thrown error message if\n * `func` throws an `Error` or string.\n * @public\n */\nexport function captureResult<T>(func: () => T): Result<T> {\n try {\n return succeed(func());\n } catch (err) {\n return fail(_errorMessage(err));\n }\n}\n\n/**\n * Async continuation callback to be called in the event that a\n * {@link Result} is successful, returning a `PromiseLike` of a new\n * {@link Result}.\n * @remarks\n * Typed as `PromiseLike<Result<TN>>` rather than `Promise<Result<TN>>` so\n * callers can return the result of {@link captureAsyncResult} (which is an\n * {@link AsyncResult}, itself a `PromiseLike<Result<TN>>`) directly from a\n * `thenOnSuccess` callback without an `async` wrapper to coerce the\n * contextual return type back through `Awaited<>`. The continuation result\n * is always wrapped into an {@link AsyncResult}, so chaining is unaffected.\n * @public\n */\nexport type AsyncSuccessContinuation<T, TN> = (value: T) => PromiseLike<Result<TN>>;\n\n/**\n * Async continuation callback to be called in the event that a\n * {@link Result} fails, returning a `PromiseLike` of a new {@link Result}.\n * @remarks\n * See {@link AsyncSuccessContinuation} for the rationale behind accepting\n * any `PromiseLike<Result<T>>` rather than only a `Promise<Result<T>>`.\n * @public\n */\nexport type AsyncFailureContinuation<T> = (message: string) => PromiseLike<Result<T>>;\n\n/**\n * Wraps a `Promise` of a {@link Result} to enable fluent chaining of both\n * synchronous and asynchronous operations.\n *\n * @remarks\n * `AsyncResult<T>` implements `PromiseLike` so it can be directly `await`ed.\n * Use the `thenOnSuccess` and `thenOnFailure` methods on {@link Result} to bridge\n * from synchronous to asynchronous result chains.\n *\n * @example\n * ```typescript\n * const result: Result<Final> = await parseInput(input)\n * .thenOnSuccess(async (parsed) => fetchData(parsed))\n * .onSuccess((data) => transform(data))\n * .thenOnSuccess(async (transformed) => saveData(transformed))\n * .withErrorFormat((msg) => `pipeline failed: ${msg}`);\n * ```\n *\n * @public\n */\nexport class AsyncResult<T> implements PromiseLike<Result<T>> {\n private readonly _promise: Promise<Result<T>>;\n\n /**\n * Constructs an {@link AsyncResult} wrapping the supplied promise (or any\n * `PromiseLike` that resolves to a {@link Result}, such as another\n * {@link AsyncResult}).\n * @remarks\n * If the supplied promise rejects, the rejection is caught and converted\n * to a {@link Failure}, ensuring that awaiting an {@link AsyncResult} always\n * yields a {@link Result}.\n * @param promise - A `Promise` (or `PromiseLike`) that resolves to a\n * {@link Result}.\n */\n public constructor(promise: PromiseLike<Result<T>>) {\n this._promise = Promise.resolve(promise).catch((err: unknown) => fail<T>(_errorMessage(err)));\n }\n\n /**\n * Calls a supplied {@link SuccessContinuation | success continuation} if\n * the wrapped result is successful.\n * @param cb - The synchronous {@link SuccessContinuation | success continuation}\n * to be called in the event of success.\n * @returns A new {@link AsyncResult} wrapping the continuation result.\n */\n public onSuccess<TN>(cb: SuccessContinuation<T, TN>): AsyncResult<TN> {\n return new AsyncResult(this._promise.then((r) => r.onSuccess(cb)));\n }\n\n /**\n * Calls a supplied {@link AsyncSuccessContinuation | async success continuation} if\n * the wrapped result is successful.\n * @remarks\n * Both synchronous throws and async rejections from the callback are caught\n * and converted to a {@link Failure}.\n * @param cb - The {@link AsyncSuccessContinuation | async success continuation}\n * to be called in the event of success.\n * @returns A new {@link AsyncResult} wrapping the async continuation result.\n */\n public thenOnSuccess<TN>(cb: AsyncSuccessContinuation<T, TN>): AsyncResult<TN> {\n return new AsyncResult(\n this._promise.then(async (r) => {\n if (r.isFailure()) {\n return fail<TN>(r.message);\n }\n try {\n return await cb(r.value);\n } catch (err: unknown) {\n return fail<TN>(_errorMessage(err));\n }\n })\n );\n }\n\n /**\n * Calls a supplied {@link FailureContinuation | failure continuation} if\n * the wrapped result is a failure.\n * @param cb - The synchronous {@link FailureContinuation | failure continuation}\n * to be called in the event of failure.\n * @returns A new {@link AsyncResult} wrapping the continuation result.\n */\n public onFailure(cb: FailureContinuation<T>): AsyncResult<T> {\n return new AsyncResult(this._promise.then((r) => r.onFailure(cb)));\n }\n\n /**\n * Calls a supplied {@link AsyncFailureContinuation | async failure continuation} if\n * the wrapped result is a failure.\n * @remarks\n * Both synchronous throws and async rejections from the callback are caught\n * and converted to a {@link Failure}.\n * @param cb - The {@link AsyncFailureContinuation | async failure continuation}\n * to be called in the event of failure.\n * @returns A new {@link AsyncResult} wrapping the async continuation result.\n */\n public thenOnFailure(cb: AsyncFailureContinuation<T>): AsyncResult<T> {\n return new AsyncResult(\n this._promise.then(async (r) => {\n if (r.isSuccess()) {\n return r;\n }\n try {\n return await cb(r.message);\n } catch (err: unknown) {\n return fail<T>(_errorMessage(err));\n }\n })\n );\n }\n\n /**\n * Calls a supplied {@link ErrorFormatter | error formatter} if\n * the wrapped result is a failure.\n * @param cb - The {@link ErrorFormatter | error formatter} to\n * be called in the event of failure.\n * @returns A new {@link AsyncResult} with the formatted error message,\n * or the original success result.\n */\n public withErrorFormat(cb: ErrorFormatter): AsyncResult<T> {\n return new AsyncResult(this._promise.then((r) => r.withErrorFormat(cb)));\n }\n\n /**\n * Propagates the wrapped result, appending any error message to the\n * supplied errors aggregator.\n * @param errors - {@link IMessageAggregator | Error aggregator} in which\n * errors will be aggregated.\n * @param formatter - An optional {@link ErrorFormatter | error formatter}\n * to be used to format the error message.\n * @returns A new {@link AsyncResult} wrapping the result after aggregation.\n */\n public aggregateError(errors: IMessageAggregator, formatter?: ErrorFormatter): AsyncResult<T> {\n return new AsyncResult(\n this._promise.then((r) => {\n r.aggregateError(errors, formatter);\n return r;\n })\n );\n }\n\n /**\n * Reports the wrapped result to the supplied reporter.\n * @param reporter - The {@link IResultReporter | reporter} to which the result\n * will be reported.\n * @param options - The {@link IResultReportOptions | options} for reporting the result.\n * @returns A new {@link AsyncResult} wrapping the result after reporting.\n */\n public report(reporter?: IResultReporter<T>, options?: IResultReportOptions<unknown>): AsyncResult<T> {\n return new AsyncResult(\n this._promise.then((r) => {\n r.report(reporter, options);\n return r;\n })\n );\n }\n\n /**\n * Implementation of `PromiseLike.then` enabling `await` on {@link AsyncResult}.\n * @param onfulfilled - Callback invoked when the promise resolves.\n * @param onrejected - Callback invoked when the promise rejects.\n * @returns A `Promise` resolving to the callback result.\n */\n /* eslint-disable @rushstack/no-new-null */\n public then<TResult1 = Result<T>, TResult2 = never>(\n onfulfilled?: ((value: Result<T>) => TResult1 | PromiseLike<TResult1>) | null,\n onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n ): Promise<TResult1 | TResult2> {\n /* eslint-enable @rushstack/no-new-null */\n return this._promise.then(onfulfilled, onrejected);\n }\n\n /**\n * Creates an {@link AsyncResult} from a {@link Result}.\n * @param result - The {@link Result} to wrap.\n * @returns A new {@link AsyncResult} wrapping the supplied result.\n */\n public static from<T>(result: Result<T>): AsyncResult<T> {\n return new AsyncResult(Promise.resolve(result));\n }\n}\n\n/**\n * Wraps an async function which might throw to convert exception results\n * to {@link Failure}.\n * @remarks\n * Returns an {@link AsyncResult} so callers can fluently chain\n * (`.onSuccess` / `.thenOnSuccess` / `.withErrorFormat`) directly off the\n * captured result. Because {@link AsyncResult} implements\n * `PromiseLike<Result<T>>`, existing `await captureAsyncResult(...)` call\n * sites continue to work unchanged and yield the same {@link Result}.\n *\n * Synchronous throws from `func` (before it returns its `Promise`), promise\n * rejections, and successful resolutions are all funneled through the\n * returned {@link AsyncResult}, which resolves to a {@link Failure} for the\n * throw/reject cases and a {@link Success} wrapping the resolved value\n * otherwise.\n * @param func - The async function to be captured.\n * @returns An {@link AsyncResult} resolving to {@link Success} with a value\n * of type `<T>` on success, or {@link Failure} with the thrown error message\n * if `func` throws or rejects.\n * @public\n */\nexport function captureAsyncResult<T>(func: () => Promise<T>): AsyncResult<T> {\n try {\n return new AsyncResult(func().then((value) => succeed(value)));\n } catch (err: unknown) {\n return AsyncResult.from(fail<T>(_errorMessage(err)));\n }\n}\n"]}

package/dist/packlets/base/shouldNotFail.js ADDED Viewed

@@ -0,0 +1,123 @@
+/*
+ * Copyright (c) 2026 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.
+ */
+/**
+ * Parses a single stack-trace line in either V8 or WebKit format.
+ *
+ * V8: `    at <fn> (<file>:<line>:<col>)` or `    at <file>:<line>:<col>`
+ * WebKit: `<fn>@<file>:<line>:<col>` or `@<file>:<line>:<col>`
+ * @internal
+ */
+export function _parseStackFrame(line) {
+    const trimmed = line.trim();
+    const v8WithFn = /^at\s+(.+?)\s+\((.+):(\d+):\d+\)$/.exec(trimmed);
+    if (v8WithFn) {
+        return { fn: v8WithFn[1], file: v8WithFn[2], line: Number(v8WithFn[3]) };
+    }
+    const v8NoFn = /^at\s+(.+):(\d+):\d+$/.exec(trimmed);
+    if (v8NoFn) {
+        return { file: v8NoFn[1], line: Number(v8NoFn[2]) };
+    }
+    const webkit = /^(.*?)@(.+):(\d+):\d+$/.exec(trimmed);
+    if (webkit) {
+        return { fn: webkit[1] === '' ? undefined : webkit[1], file: webkit[2], line: Number(webkit[3]) };
+    }
+    return {};
+}
+/**
+ * Finds the caller frame at the supplied depth in a stack string.
+ *
+ * Filters out frames whose **parsed function name** contains `shouldNotFail`
+ * (the file path is deliberately NOT inspected — consumer test files may
+ * themselves be named after `shouldNotFail` and their frames must not be
+ * filtered out). Covers both the V8 path — where `Error.captureStackTrace`
+ * should have done this already but the extra filter is harmless — and the
+ * WebKit fallback path where `captureStackTrace` is unavailable. `frameDepth`
+ * is 1-indexed: `1` selects the immediate caller.
+ * @internal
+ */
+export function _findShouldNotFailFrame(stack, frameDepth) {
+    var _a;
+    if (!stack) {
+        return {};
+    }
+    const userFrames = [];
+    for (const line of stack.split('\n')) {
+        if (!/^\s*at\s|@/.test(line)) {
+            continue;
+        }
+        const parsed = _parseStackFrame(line);
+        if (parsed.file === undefined && parsed.fn === undefined) {
+            continue;
+        }
+        // Filter by parsed function name only — never by raw line text, since the
+        // file path may itself contain 'shouldNotFail' (e.g. consumer test files).
+        if (parsed.fn !== undefined && parsed.fn.includes('shouldNotFail')) {
+            continue;
+        }
+        userFrames.push(parsed);
+    }
+    return (_a = userFrames[frameDepth - 1]) !== null && _a !== void 0 ? _a : {};
+}
+/**
+ * Normalizes a function name from a stack frame, returning `undefined` when
+ * the name is empty or one of the well-known anonymous-IIFE noise patterns
+ * (typically emitted by V8 for module-top-level code).
+ * @internal
+ */
+export function _normalizeShouldNotFailFnName(fn) {
+    if (fn === undefined || fn === '' || fn === '<anonymous>' || fn === 'Object.<anonymous>') {
+        return undefined;
+    }
+    return fn;
+}
+/**
+ * Composes the error message thrown by `Result<T>.shouldNotFail` from the
+ * captured frame and optional label.
+ * @internal
+ */
+export function _formatShouldNotFailMessage(originalMessage, label, frame) {
+    const fn = _normalizeShouldNotFailFnName(frame.fn);
+    const fileLoc = frame.file !== undefined && frame.line !== undefined ? `${frame.file}:${frame.line}` : undefined;
+    if (label !== undefined) {
+        if (fn !== undefined && fileLoc !== undefined) {
+            return `${label} (at ${fn} in ${fileLoc}): ${originalMessage}`;
+        }
+        if (fileLoc !== undefined) {
+            return `${label} (at ${fileLoc}): ${originalMessage}`;
+        }
+        if (fn !== undefined) {
+            return `${label} (at ${fn}): ${originalMessage}`;
+        }
+        return `${label}: ${originalMessage}`;
+    }
+    if (fn !== undefined && fileLoc !== undefined) {
+        return `${fn} at ${fileLoc}: ${originalMessage}`;
+    }
+    if (fileLoc !== undefined) {
+        return `${fileLoc}: ${originalMessage}`;
+    }
+    if (fn !== undefined) {
+        return `${fn}: ${originalMessage}`;
+    }
+    return originalMessage;
+}
+//# sourceMappingURL=shouldNotFail.js.map

package/dist/packlets/base/shouldNotFail.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"shouldNotFail.js","sourceRoot":"","sources":["../../../src/packlets/base/shouldNotFail.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 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 * Internal helpers for `Result<T>.shouldNotFail()`. Parsing and message\n * composition live here so the `Result` class file stays focused on the\n * Result hierarchy itself; the helpers are exported with the `_` prefix\n * convention and `@internal` tag so unit tests can cover them directly\n * without adding test-only public exports.\n */\n\n/**\n * Parsed stack-frame information used by `Result<T>.shouldNotFail`.\n * All fields are optional — runtimes that don't expose stack traces produce\n * an empty frame and the call site is omitted from the message.\n * @internal\n */\nexport interface _IShouldNotFailFrame {\n fn?: string;\n file?: string;\n line?: number;\n}\n\n/**\n * Parses a single stack-trace line in either V8 or WebKit format.\n *\n * V8: ` at <fn> (<file>:<line>:<col>)` or ` at <file>:<line>:<col>`\n * WebKit: `<fn>@<file>:<line>:<col>` or `@<file>:<line>:<col>`\n * @internal\n */\nexport function _parseStackFrame(line: string): _IShouldNotFailFrame {\n const trimmed = line.trim();\n const v8WithFn = /^at\\s+(.+?)\\s+\$(.+):(\\d+):\\d+\$$/.exec(trimmed);\n if (v8WithFn) {\n return { fn: v8WithFn[1], file: v8WithFn[2], line: Number(v8WithFn[3]) };\n }\n const v8NoFn = /^at\\s+(.+):(\\d+):\\d+$/.exec(trimmed);\n if (v8NoFn) {\n return { file: v8NoFn[1], line: Number(v8NoFn[2]) };\n }\n const webkit = /^(.*?)@(.+):(\\d+):\\d+$/.exec(trimmed);\n if (webkit) {\n return { fn: webkit[1] === '' ? undefined : webkit[1], file: webkit[2], line: Number(webkit[3]) };\n }\n return {};\n}\n\n/**\n * Finds the caller frame at the supplied depth in a stack string.\n *\n * Filters out frames whose **parsed function name** contains `shouldNotFail`\n * (the file path is deliberately NOT inspected — consumer test files may\n * themselves be named after `shouldNotFail` and their frames must not be\n * filtered out). Covers both the V8 path — where `Error.captureStackTrace`\n * should have done this already but the extra filter is harmless — and the\n * WebKit fallback path where `captureStackTrace` is unavailable. `frameDepth`\n * is 1-indexed: `1` selects the immediate caller.\n * @internal\n */\nexport function _findShouldNotFailFrame(stack: string | undefined, frameDepth: number): _IShouldNotFailFrame {\n if (!stack) {\n return {};\n }\n const userFrames: _IShouldNotFailFrame[] = [];\n for (const line of stack.split('\\n')) {\n if (!/^\\s*at\\s|@/.test(line)) {\n continue;\n }\n const parsed = _parseStackFrame(line);\n if (parsed.file === undefined && parsed.fn === undefined) {\n continue;\n }\n // Filter by parsed function name only — never by raw line text, since the\n // file path may itself contain 'shouldNotFail' (e.g. consumer test files).\n if (parsed.fn !== undefined && parsed.fn.includes('shouldNotFail')) {\n continue;\n }\n userFrames.push(parsed);\n }\n return userFrames[frameDepth - 1] ?? {};\n}\n\n/**\n * Normalizes a function name from a stack frame, returning `undefined` when\n * the name is empty or one of the well-known anonymous-IIFE noise patterns\n * (typically emitted by V8 for module-top-level code).\n * @internal\n */\nexport function _normalizeShouldNotFailFnName(fn: string | undefined): string | undefined {\n if (fn === undefined || fn === '' || fn === '<anonymous>' || fn === 'Object.<anonymous>') {\n return undefined;\n }\n return fn;\n}\n\n/**\n * Composes the error message thrown by `Result<T>.shouldNotFail` from the\n * captured frame and optional label.\n * @internal\n */\nexport function _formatShouldNotFailMessage(\n originalMessage: string,\n label: string | undefined,\n frame: _IShouldNotFailFrame\n): string {\n const fn = _normalizeShouldNotFailFnName(frame.fn);\n const fileLoc =\n frame.file !== undefined && frame.line !== undefined ? `${frame.file}:${frame.line}` : undefined;\n\n if (label !== undefined) {\n if (fn !== undefined && fileLoc !== undefined) {\n return `${label} (at ${fn} in ${fileLoc}): ${originalMessage}`;\n }\n if (fileLoc !== undefined) {\n return `${label} (at ${fileLoc}): ${originalMessage}`;\n }\n if (fn !== undefined) {\n return `${label} (at ${fn}): ${originalMessage}`;\n }\n return `${label}: ${originalMessage}`;\n }\n if (fn !== undefined && fileLoc !== undefined) {\n return `${fn} at ${fileLoc}: ${originalMessage}`;\n }\n if (fileLoc !== undefined) {\n return `${fileLoc}: ${originalMessage}`;\n }\n if (fn !== undefined) {\n return `${fn}: ${originalMessage}`;\n }\n return originalMessage;\n}\n"]}

package/dist/packlets/base/utils.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/packlets/base/utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\r\n * Copyright (c) 2020 Erik Fortune\r\n *\r\n * Permission is hereby granted, free of charge, to any person obtaining a copy\r\n * of this software and associated documentation files (the \"Software\"), to deal\r\n * in the Software without restriction, including without limitation the rights\r\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n * copies of the Software, and to permit persons to whom the Software is\r\n * furnished to do so, subject to the following conditions:\r\n *\r\n * The above copyright notice and this permission notice shall be included in all\r\n * copies or substantial portions of the Software.\r\n *\r\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n * SOFTWARE.\r\n */\r\n\r\nimport { Result, fail, succeed } from './result';\r\n\r\n/**\r\n * Union of all values in an array/tuple type, preserving literal types if possible.\r\n * If T is not an array/tuple, results in `never`.\r\n * @public\r\n */\r\nexport type OneOf<T> = T extends readonly unknown[] ? T[number] : never;\r\n\r\n/**\r\n * Union of all string values in an array/tuple type, preserving literal types if possible.\r\n * If T is not an array/tuple, results in `never`.\r\n * @public\r\n */\r\nexport type StringOneOf<T> = Extract<OneOf<T>, string>;\r\n\r\n/**\r\n * Helper type-guard function to report whether a specified key is present in\r\n * a supplied object.\r\n * @param key - The key to be tested.\r\n * @param item - The object to be tested.\r\n * @returns Returns `true` if the key is present, `false` otherwise.\r\n * @public\r\n */\r\nexport function isKeyOf<T extends object>(key: string | number | symbol, item: T): key is keyof T {\r\n return item.hasOwnProperty(key);\r\n}\r\n\r\n/**\r\n * Simple implicit pick function, which picks a set of properties from a supplied\r\n * object. Ignores picked properties that do not exist regardless of type signature.\r\n * @param from - The object from which keys are to be picked.\r\n * @param include - The keys of the properties to be picked from `from`.\r\n * @returns A new object containing the requested properties from `from`, where present.\r\n * @public\r\n */\r\nexport function pick<T extends object, K extends keyof T>(from: T, include: K[]): Pick<T, K> {\r\n const rtrn: Partial<Pick<T, K>> = {};\r\n for (const key of include) {\r\n if (key in from) {\r\n rtrn[key] = from[key];\r\n }\r\n }\r\n return rtrn as Pick<T, K>;\r\n}\r\n\r\n/**\r\n * Simple implicit omit function, which picks all of the properties from a supplied\r\n * object except those specified for exclusion.\r\n * @param from - The object from which keys are to be picked.\r\n * @param exclude - The keys of the properties to be excluded from the returned object.\r\n * @returns A new object containing all of the properties from `from` that were not\r\n * explicitly excluded.\r\n * @public\r\n */\r\nexport function omit<T extends object, K extends keyof T>(from: T, exclude: K[]): Omit<T, K> {\r\n const rtrn: Partial<Omit<T, K>> = {};\r\n for (const entry of Object.entries(from).filter((e) => !exclude.includes(e[0] as keyof T as K))) {\r\n rtrn[entry[0] as unknown as keyof Omit<T, K>] = entry[1];\r\n }\r\n\r\n return rtrn as Omit<T, K>;\r\n}\r\n\r\n/**\r\n * Type-safe(ish) key extractor for typed records.\r\n * @param obj - The record from which keys are to be extracted.\r\n * @returns The keys of the record as an array.\r\n * @public\r\n */\r\nexport function keysForRecord<TK extends string>(obj: Record<TK, unknown>): TK[] {\r\n return Object.keys(obj) as TK[];\r\n}\r\n\r\n/**\r\n * Type-safe(ish) value extractor for typed records.\r\n * @param obj - The record from which values are to be extracted.\r\n * @returns The values of the record as an array.\r\n * @public\r\n */\r\nexport function valuesForRecord<TK extends string, TV>(obj: Record<TK, TV>): TV[] {\r\n return Object.values(obj) as TV[];\r\n}\r\n\r\n/**\r\n * Type-safe(ish) entries extractor for typed records.\r\n * @param obj - The record from which entries are to be extracted.\r\n * @returns The entries of the record as an array of `[key, value]` tuples.\r\n * @public\r\n */\r\nexport function entriesForRecord<TK extends string, TV>(obj: Record<TK, TV>): Array<[TK, TV]> {\r\n return Object.entries(obj) as Array<[TK, TV]>;\r\n}\r\n\r\n/**\r\n * Type-safe(ish) record constructor from an iterable of `[key, value]` tuples.\r\n * @param entries - The iterable of `[key, value]` tuples from which to construct the record.\r\n * @returns A record constructed from the supplied entries.\r\n * @public\r\n */\r\nexport function recordFromEntries<TK extends string, TV>(entries: Iterable<[TK, TV]>): Record<TK, TV> {\r\n return Object.fromEntries(entries) as Record<TK, TV>;\r\n}\r\n\r\n/**\r\n * Helper type to extract the element type and preserve readonly status.\r\n * @public\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\r\nexport type EnsureArrayResult<T> = T extends readonly (infer _U)[] ? T : T[];\r\n\r\n/**\r\n * Ensures the input is an array. If already an array, returns it as-is.\r\n * If a single item, wraps it in an array.\r\n * Preserves readonly status of input arrays.\r\n * @param items - A single item or an array of items.\r\n * @returns The input array unchanged, or a new array containing the single item.\r\n * @public\r\n */\r\nexport function ensureArray<T>(items: T): EnsureArrayResult<T> {\r\n return (Array.isArray(items) ? items : [items]) as EnsureArrayResult<T>;\r\n}\r\n\r\n/**\r\n * Gets the value of a property specified by key from an arbitrary object,\r\n * or a default value if the property does not exist.\r\n * @param key - The key specifying the property to be retrieved.\r\n * @param item - The object from which the property is to be retrieved.\r\n * @param defaultValue - An optional default value to be returned if the property\r\n * is not present (default `undefined`).\r\n * @returns The value of the requested property, or the default value if the\r\n * requested property does not exist.\r\n * @public\r\n */\r\nexport function getValueOfPropertyOrDefault<T extends object>(\r\n key: string | number | symbol,\r\n item: T,\r\n defaultValue?: unknown\r\n): unknown | undefined {\r\n return isKeyOf(key, item) ? item[key] : defaultValue;\r\n}\r\n\r\n/**\r\n * Gets the type of a property specified by key from an arbitrary object.\r\n * @param key - The key specifying the property to be tested.\r\n * @param item - The object from which the property is to be tested.\r\n * @returns The type of the requested property, or `undefined` if the\r\n * property does not exist.\r\n * @example\r\n * Returns `'undefined'` (a string) if the property exists but has the value\r\n * undefined but `undefined` (the literal) if the property does not exist.\r\n * @public\r\n */\r\nexport function getTypeOfProperty<T extends object>(\r\n key: string | number | symbol,\r\n item: T\r\n):\r\n | 'string'\r\n | 'number'\r\n | 'bigint'\r\n | 'boolean'\r\n | 'symbol'\r\n | 'undefined'\r\n | 'undefined'\r\n | 'object'\r\n | 'function'\r\n | undefined {\r\n return isKeyOf(key, item) ? typeof item[key] : undefined;\r\n}\r\n\r\n/**\r\n * Type for factory methods which convert a key-value pair to a new unique value.\r\n * @public\r\n */\r\ntype KeyedThingFactory<TS, TD, TK extends string = string> = (key: TK, thing: TS) => Result<TD>;\r\n\r\n/**\r\n * Applies a factory method to convert a `Record<TK, TS>` into a `Map<TK, TD>`.\r\n * @param src - The `Record` to be converted.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting map on success, or {@link Failure} with a\r\n * message if an error occurs.\r\n * @public\r\n */\r\nexport function recordToMap<TS, TD, TK extends string = string>(\r\n src: Record<TK, TS>,\r\n factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Map<TK, TD>> {\r\n const map = new Map<TK, TD>();\r\n for (const key in src) {\r\n if (src[key] !== undefined) {\r\n const itemResult = factory(key, src[key]);\r\n if (itemResult.isSuccess()) {\r\n map.set(key, itemResult.value);\r\n } else {\r\n return fail(`${key}: ${itemResult.message}`);\r\n }\r\n }\r\n }\r\n return succeed(map);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `Record<TK, TS>` into a `Map<TK, TD>`, or `undefined`.\r\n * @param src - The `Record` to be converted, or undefined.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting map if conversion succeeds, or {@link Success} with `undefined`\r\n * if `src` is `undefined`. Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalRecordToMap<TS, TD, TK extends string = string>(\r\n src: Record<TK, TS> | undefined,\r\n factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Map<TK, TD> | undefined> {\r\n return src === undefined ? succeed(undefined) : recordToMap(src, factory);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `Record<TK, TS>` into a `Map<TK, TD>`\r\n * @param src - The `Record` to be converted, or `undefined`.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting map (empty if `src` is `undefined`) if conversion succeeds.\r\n * Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalRecordToPossiblyEmptyMap<TS, TD, TK extends string = string>(\r\n src: Record<TK, TS> | undefined,\r\n factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Map<TK, TD>> {\r\n return src === undefined ? succeed(new Map<TK, TD>()) : recordToMap(src, factory);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert a `ReadonlyMap<TK, TS>` into a `Record<TK, TD>`.\r\n * @param src - The `Map` object to be converted.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting `Record<TK, TD>` if conversion succeeds, or\r\n * {@link Failure} with an error message if an error occurs.\r\n * @public\r\n */\r\nexport function mapToRecord<TS, TD, TK extends string = string>(\r\n src: ReadonlyMap<TK, TS>,\r\n factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Record<TK, TD>> {\r\n const record: Record<TK, TD> = {} as Record<TK, TD>;\r\n for (const kvp of src) {\r\n if (kvp[1] !== undefined) {\r\n const itemResult = factory(kvp[0], kvp[1]);\r\n if (itemResult.isSuccess()) {\r\n record[kvp[0]] = itemResult.value;\r\n } else {\r\n return fail(`${kvp[0]}: ${itemResult.message}`);\r\n }\r\n }\r\n }\r\n return succeed(record);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `ReadonlyMap<string, TS>` into a `Record<string, TD>` or `undefined`.\r\n * @param src - The `Map` object to be converted, or `undefined`.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting record if conversion succeeds, or {@link Success} with `undefined` if\r\n * `src` is `undefined`. Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalMapToRecord<TS, TD, TK extends string = string>(\r\n src: ReadonlyMap<TK, TS> | undefined,\r\n factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Record<TK, TD> | undefined> {\r\n return src === undefined ? succeed(undefined) : mapToRecord(src, factory);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `ReadonlyMap<string, TS>` into a `Record<string, TD>`\r\n * @param src - The `ReadonlyMap` object to be converted, or `undefined`.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting record (empty if `src` is `undefined`) if conversion succeeds.\r\n * Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalMapToPossiblyEmptyRecord<TS, TD, TK extends string = string>(\r\n src: ReadonlyMap<TK, TS> | undefined,\r\n factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Record<TK, TD>> {\r\n return src === undefined ? succeed({} as Record<TK, TD>) : mapToRecord(src, factory);\r\n}\r\n"]}

package/dist/packlets/base/uuid.js ADDED Viewed

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2026 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.
+ */
+/**
+ * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version
+ * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the
+ * start of the fourth group. Matches what `crypto.randomUUID()` returns.
+ */
+const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/**
+ * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+ * @param value - The string to test.
+ * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+ * @public
+ */
+export function isValidUuid(value) {
+    return uuidRegex.test(value);
+}
+/**
+ * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+ * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+ * browsers without per-call runtime checks.
+ * @returns A new {@link Uuid}.
+ * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+ * This indicates an unsupported platform, not a per-call failure mode, so it is
+ * surfaced as a thrown error rather than a `Result`.
+ * @public
+ */
+export function generateUuid() {
+    const cryptoObj = globalThis.crypto;
+    /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */
+    if (typeof (cryptoObj === null || cryptoObj === void 0 ? void 0 : cryptoObj.randomUUID) !== 'function') {
+        throw new Error('generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser');
+    }
+    return cryptoObj.randomUUID();
+}
+//# sourceMappingURL=uuid.js.map

package/dist/packlets/base/uuid.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/packlets/base/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAYH;;;;GAIG;AACH,MAAM,SAAS,GAAW,uEAAuE,CAAC;AAElG;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,iHAAiH;IACjH,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,EAAU,CAAC;AACxC,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 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 { Brand } from './brand';\n\n/**\n * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version\n * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}\n * and validated by {@link isValidUuid}.\n * @public\n */\nexport type Uuid = Brand<string, 'Uuid'>;\n\n/**\n * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version\n * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the\n * start of the fourth group. Matches what `crypto.randomUUID()` returns.\n */\nconst uuidRegex: RegExp = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/**\n * Type guard that returns `true` when the input is a canonical UUIDv4 string.\n * @param value - The string to test.\n * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.\n * @public\n */\nexport function isValidUuid(value: string): value is Uuid {\n return uuidRegex.test(value);\n}\n\n/**\n * Generates a cryptographically random UUIDv4 using the platform's Web Crypto\n * API (`globalThis.crypto.randomUUID`). Works in Node.js \\>= 18 and modern\n * browsers without per-call runtime checks.\n * @returns A new {@link Uuid}.\n * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.\n * This indicates an unsupported platform, not a per-call failure mode, so it is\n * surfaced as a thrown error rather than a `Result`.\n * @public\n */\nexport function generateUuid(): Uuid {\n const cryptoObj = globalThis.crypto;\n /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */\n if (typeof cryptoObj?.randomUUID !== 'function') {\n throw new Error(\n 'generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser'\n );\n }\n return cryptoObj.randomUUID() as Uuid;\n}\n"]}

package/dist/packlets/collections/aggregatedResultMap.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"aggregatedResultMap.js","sourceRoot":"","sources":["../../../src/packlets/collections/aggregatedResultMap.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 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 {\n captureResult,\n DetailedResult,\n Result,\n fail,\n failWithDetail,\n succeed,\n succeedWithDetail,\n Success\n} from '../base';\nimport { Converter, Converters } from '../conversion';\nimport { Validator, Validators } from '../validation';\nimport { KeyValueEntry } from './common';\nimport { KeyValueConverters } from './keyValueConverters';\nimport { IReadOnlyResultMapValidator } from './resultMapValidator';\nimport { IReadOnlyResultMap, ResultMapForEachCb, ResultMapResultDetail } from './readonlyResultMap';\nimport { IResultMap, ResultMapValueFactory } from './resultMap';\nimport { IReadOnlyValidatingResultMap, ValidatingResultMap } from './validatingResultMap';\n\n/**\n * A read-only collection entry in an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport interface IReadonlyAggregatedResultMapEntry<\n TCOLLECTIONID extends string = string,\n TITEMID extends string = string,\n TITEM = unknown,\n TMETADATA = unknown\n> {\n readonly isMutable: false;\n readonly id: TCOLLECTIONID;\n readonly items: IReadOnlyValidatingResultMap<TITEMID, TITEM>;\n readonly metadata?: TMETADATA;\n}\n\n/**\n * A mutable collection entry in an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport interface IMutableAggregatedResultMapEntry<\n TCOLLECTIONID extends string = string,\n TITEMID extends string = string,\n TITEM = unknown,\n TMETADATA = unknown\n> {\n readonly isMutable: true;\n readonly id: TCOLLECTIONID;\n readonly items: ValidatingResultMap<TITEMID, TITEM>;\n metadata?: TMETADATA;\n}\n\n/**\n * A collection entry in an {@link AggregatedResultMap | aggregated result map}, either mutable or read-only.\n * @public\n */\nexport type AggregatedResultMapEntry<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n> =\n | IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n | IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>;\n\n/**\n * JSON format for an {@link AggregatedResultMap | aggregated result map} collection entry using an entries array.\n * @public\n */\nexport interface IAggregatedResultMapJsonEntryWithEntries<TCOLLECTIONID extends string = string> {\n readonly isMutable: boolean;\n readonly id: TCOLLECTIONID;\n readonly entries: ReadonlyArray<KeyValueEntry<string, unknown>>;\n readonly metadata?: unknown;\n}\n\n/**\n * JSON format for an {@link AggregatedResultMap | aggregated result map} collection entry using a string-keyed items object.\n * @public\n */\nexport interface IAggregatedResultMapJsonEntryWithItems<TCOLLECTIONID extends string = string> {\n readonly isMutable: boolean;\n readonly id: TCOLLECTIONID;\n readonly items: Record<string, unknown>;\n readonly metadata?: unknown;\n}\n\n/**\n * JSON format for an {@link AggregatedResultMap | aggregated result map} collection entry - supports both entries array and items object.\n * @public\n */\nexport type AggregatedResultMapJsonEntry<TCOLLECTIONID extends string = string> =\n | IAggregatedResultMapJsonEntryWithEntries<TCOLLECTIONID>\n | IAggregatedResultMapJsonEntryWithItems<TCOLLECTIONID>;\n\n/**\n * Any valid input format for an {@link AggregatedResultMap | aggregated result map} collection entry.\n * @public\n */\nexport type AggregatedResultMapEntryInit<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n> =\n | AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n | AggregatedResultMapJsonEntry<TCOLLECTIONID>;\n\n/**\n * Options for {@link Collections.AggregatedResultMapBase.addCollectionWithItems | addCollectionWithItems}.\n * @public\n */\nexport interface IAddCollectionWithItemsOptions<TMETADATA = unknown> {\n /**\n * If true, the collection will be immutable (read-only).\n * Defaults to false (mutable).\n */\n readonly isImmutable?: boolean;\n\n /**\n * Optional metadata to attach to the collection.\n */\n readonly metadata?: TMETADATA;\n}\n\n/**\n * Parameters for constructing an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport interface IAggregatedResultMapConstructorParams<\n TCOMPOSITEID extends string,\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n> {\n /**\n * Validator for composite IDs.\n */\n readonly compositeIdValidator?: Validator<TCOMPOSITEID, unknown>;\n /**\n * Converter or validator for collection IDs.\n */\n readonly collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>;\n /**\n * Converter or validator for item IDs.\n */\n readonly itemIdConverter: Converter<TITEMID, unknown> | Validator<TITEMID, unknown>;\n /**\n * Converter or validator for individual items in each collection.\n */\n readonly itemConverter: Converter<TITEM, unknown> | Validator<TITEM, unknown>;\n /**\n * Optional converter or validator for collection metadata. If not provided, a metadata field\n * in the input will cause a validation failure.\n */\n readonly metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>;\n\n /**\n * Optional separator string for composite IDs. Defaults to `.`.\n */\n readonly separator?: string;\n\n /**\n * Initial collections to populate the map.\n * @remarks Each entry may be mutable or read-only.\n */\n readonly collections?: ReadonlyArray<\n AggregatedResultMapEntryInit<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n >;\n}\n\n/**\n * A validator for weakly-typed access to an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport class AggregatedResultMapValidator<\n TCOMPOSITEID extends string,\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n> implements IReadOnlyResultMapValidator<TCOMPOSITEID, TITEM>\n{\n private readonly _map: AggregatedResultMap<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>;\n\n /**\n * The key-value converters used for validating weakly-typed access.\n */\n public readonly converters: KeyValueConverters<TCOMPOSITEID, TITEM>;\n\n /**\n * Constructs a new {@link AggregatedResultMapValidator | aggregated result map validator}.\n * @param map - The {@link AggregatedResultMap | aggregated result map} being validated.\n * @param converters - The key-value converters for weakly-typed access.\n */\n public constructor(\n map: AggregatedResultMap<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n converters: KeyValueConverters<TCOMPOSITEID, TITEM>\n ) {\n this._map = map;\n this.converters = converters;\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.map} */\n public get map(): IReadOnlyValidatingResultMap<TCOMPOSITEID, TITEM> {\n return this._map;\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.get} */\n public get(key: string): DetailedResult<TITEM, ResultMapResultDetail> {\n return this.converters.convertKey(key).onSuccess((k) => {\n return this._map.get(k);\n });\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.has} */\n public has(key: string): boolean {\n const result = this.converters.convertKey(key);\n if (result.isFailure()) {\n return false;\n }\n return this._map.has(result.value);\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.add} */\n public add(key: string, value: unknown): DetailedResult<TITEM, ResultMapResultDetail> {\n return this.converters.convertEntry([key, value]).onSuccess(([vk, vv]) => {\n return this._map.add(vk, vv);\n });\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.set} */\n public set(key: string, value: unknown): DetailedResult<TITEM, ResultMapResultDetail> {\n return this.converters.convertEntry([key, value]).onSuccess(([vk, vv]) => {\n return this._map.set(vk, vv);\n });\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.update} */\n public update(key: string, value: unknown): DetailedResult<TITEM, ResultMapResultDetail> {\n return this.converters.convertEntry([key, value]).onSuccess(([vk, vv]) => {\n return this._map.update(vk, vv);\n });\n }\n\n /** {@inheritDoc Collections.ResultMapValidator.delete} */\n public delete(key: string): DetailedResult<TITEM, ResultMapResultDetail> {\n return this.converters.convertKey(key).onSuccess((k) => {\n return this._map.delete(k);\n });\n }\n}\n\n/**\n * Type guard to check if an {@link AggregatedResultMapEntry | aggregated result map entry} is mutable.\n */\nfunction isMutableEntry<TCOLLECTIONID extends string, TITEMID extends string, TITEM, TMETADATA>(\n entry: AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n): entry is IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> {\n return entry.isMutable === true;\n}\n\n/**\n * Base class for an aggregated result map that wraps a collection of {@link ValidatingResultMap} instances,\n * keyed by collection ID. Items are accessed via composite IDs that combine the collection ID\n * and item ID with a delimiter.\n * @remarks Consumers should inherit from this class or use {@link AggregatedResultMap | AggregatedResultMap}\n * for fully generic.\n * @public\n */\nexport class AggregatedResultMapBase<\n TCOMPOSITEID extends string,\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n> implements IResultMap<TCOMPOSITEID, TITEM>, IReadOnlyValidatingResultMap<TCOMPOSITEID, TITEM>\n{\n private readonly _childKvConverters: KeyValueConverters<TITEMID, TITEM>;\n private readonly _collections: ValidatingResultMap<\n TCOLLECTIONID,\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n >;\n private readonly _collectionKvConverters: KeyValueConverters<\n TCOLLECTIONID,\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n >;\n private readonly _compositeIdValidator: Validator<TCOMPOSITEID, unknown>;\n private readonly _collectionIdConverter:\n | Converter<TCOLLECTIONID, unknown>\n | Validator<TCOLLECTIONID, unknown>;\n private readonly _itemIdConverter: Converter<TITEMID, unknown> | Validator<TITEMID, unknown>;\n private readonly _itemConverter: Converter<TITEM, unknown> | Validator<TITEM, unknown>;\n private readonly _metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>;\n private readonly _delimiter: string;\n private readonly _compositeIdConverter: Converter<Converters.ICompositeId<TCOLLECTIONID, TITEMID>, unknown>;\n private readonly _kvConverters: KeyValueConverters<TCOMPOSITEID, TITEM>;\n private readonly _validating: AggregatedResultMapValidator<\n TCOMPOSITEID,\n TCOLLECTIONID,\n TITEMID,\n TITEM,\n TMETADATA\n >;\n\n /**\n * Protected constructor for derived classes.\n * Use the {@link AggregatedResultMap.create | create static method} for safe construction with error handling.\n * @param params - {@link IAggregatedResultMapConstructorParams | Parameters} for constructing the map.\n * @throws If initialization fails (e.g., invalid collections).\n * @public\n */\n protected constructor(\n params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n ) {\n this._compositeIdValidator =\n params.compositeIdValidator ?? AggregatedResultMapBase._compositeIdValidator(params);\n this._collectionIdConverter = params.collectionIdConverter;\n this._itemIdConverter = params.itemIdConverter;\n this._itemConverter = params.itemConverter;\n this._metadataConverter = params.metadataConverter;\n this._delimiter = params.separator ?? '.';\n\n // Build child key-value converters for item ID/value pairs\n this._childKvConverters = new KeyValueConverters<TITEMID, TITEM>({\n key: params.itemIdConverter,\n value: params.itemConverter\n });\n\n // Build composite ID converter for parsing composite IDs\n this._compositeIdConverter = Converters.compositeId(\n params.collectionIdConverter,\n this._delimiter,\n params.itemIdConverter\n );\n\n // Build key-value converters for composite ID/item pairs\n this._kvConverters = new KeyValueConverters<TCOMPOSITEID, TITEM>({\n key: this._compositeIdValidator,\n value: params.itemConverter\n });\n\n // Build entry converter for collection entries\n const entryConverter = AggregatedResultMapBase._entryConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n params.collectionIdConverter,\n this._childKvConverters,\n params.metadataConverter\n );\n\n // Build key-value converters for the collections map\n this._collectionKvConverters = new KeyValueConverters<\n TCOLLECTIONID,\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n >({\n key: params.collectionIdConverter,\n value: entryConverter\n });\n\n // Convert all input collections to [id, entry] pairs for ValidatingResultMap\n const initCollections = params.collections ?? [];\n const initEntries: KeyValueEntry<string, unknown>[] = initCollections.map((entry) => {\n return [entry.id, entry];\n });\n\n // Build the inner ValidatingResultMap - throws on error\n this._collections = new ValidatingResultMap<\n TCOLLECTIONID,\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n >({\n converters: this._collectionKvConverters,\n entries: initEntries\n });\n\n // Build the validator\n this._validating = new AggregatedResultMapValidator<\n TCOMPOSITEID,\n TCOLLECTIONID,\n TITEMID,\n TITEM,\n TMETADATA\n >(this, this._kvConverters);\n }\n\n // ==================== IReadOnlyValidatingResultMap implementation ====================\n\n /**\n * A validator for weakly-typed access to the map.\n */\n public get validating(): IReadOnlyResultMapValidator<TCOMPOSITEID, TITEM> {\n return this._validating;\n }\n\n /**\n * The total number of items across all collections.\n */\n public get size(): number {\n let total = 0;\n for (const entry of Array.from(this._collections.values())) {\n total += entry.items.size;\n }\n return total;\n }\n\n /**\n * Gets an item by its composite ID.\n * @param key - The composite ID of the item.\n * @returns `Success` with the item if found, `Failure` otherwise.\n */\n public get(key: TCOMPOSITEID): DetailedResult<TITEM, ResultMapResultDetail> {\n return this._splitAndLookup(key).onSuccess(({ entry, itemId }) => {\n return entry.items.get(itemId);\n });\n }\n\n /**\n * Checks if an item exists by its composite ID.\n * @param key - The composite ID of the item.\n * @returns `true` if the item exists, `false` otherwise.\n */\n public has(key: TCOMPOSITEID): boolean {\n const result = this._splitAndLookup(key);\n if (result.isFailure()) {\n return false;\n }\n return result.value.entry.items.has(result.value.itemId);\n }\n\n /**\n * Iterates over all entries in all collections.\n */\n public *entries(): IterableIterator<KeyValueEntry<TCOMPOSITEID, TITEM>> {\n for (const collectionEntry of Array.from(this._collections.values())) {\n for (const [itemId, item] of Array.from(collectionEntry.items.entries())) {\n // Validate the composite ID through the converter\n const compositeId = this._compositeIdValidator\n .convert(`${collectionEntry.id}${this._delimiter}${itemId}`)\n .orThrow();\n yield [compositeId, item];\n }\n }\n }\n\n /**\n * Iterates over all composite keys.\n */\n public *keys(): IterableIterator<TCOMPOSITEID> {\n for (const [key] of Array.from(this.entries())) {\n yield key;\n }\n }\n\n /**\n * Iterates over all values.\n */\n public *values(): IterableIterator<TITEM> {\n for (const collectionEntry of Array.from(this._collections.values())) {\n for (const value of Array.from(collectionEntry.items.values())) {\n yield value;\n }\n }\n }\n\n /**\n * Calls a callback for each entry.\n * @param cb - The callback to call.\n * @param thisArg - Optional `this` argument for the callback.\n */\n public forEach(cb: ResultMapForEachCb<TCOMPOSITEID, TITEM>, thisArg?: unknown): void {\n for (const [key, value] of Array.from(this.entries())) {\n cb.call(thisArg, value, key, this);\n }\n }\n\n /**\n * Gets an iterator over the map entries.\n */\n public [Symbol.iterator](): IterableIterator<KeyValueEntry<TCOMPOSITEID, TITEM>> {\n return this.entries();\n }\n\n // ==================== Mutating methods ====================\n\n /**\n * Sets an item by its composite ID. Creates the collection if it doesn't exist and is mutable.\n * @param key - The composite ID of the item.\n * @param value - The value to set.\n * @returns `Success` with the value if set, `Failure` otherwise.\n */\n public set(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail> {\n return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n return collection.set(itemId, value);\n });\n });\n }\n\n /**\n * Adds an item by its composite ID. Fails if the item already exists.\n * @param key - The composite ID of the item.\n * @param value - The value to add.\n * @returns `Success` with the value if added, `Failure` otherwise.\n */\n public add(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail> {\n return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n return collection.add(itemId, value);\n });\n });\n }\n\n /**\n * Updates an existing item by its composite ID. Fails if the item doesn't exist.\n * @param key - The composite ID of the item.\n * @param value - The new value.\n * @returns `Success` with the value if updated, `Failure` otherwise.\n */\n public update(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail> {\n return this._splitAndLookupMutable(key).onSuccess(({ entry, itemId }) => {\n return entry.items.update(itemId, value);\n });\n }\n\n /**\n * Deletes an item by its composite ID.\n * @param key - The composite ID of the item.\n * @returns `Success` with the deleted value, `Failure` otherwise.\n */\n public delete(key: TCOMPOSITEID): DetailedResult<TITEM, ResultMapResultDetail> {\n return this._splitAndLookupMutable(key).onSuccess(({ entry, itemId }) => {\n return entry.items.delete(itemId);\n });\n }\n\n /**\n * Gets an existing item or adds a new one.\n * @param key - The composite ID of the item.\n * @param value - The value to add if not found.\n * @returns `Success` with the existing or new value.\n */\n public getOrAdd(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail>;\n\n /**\n * Gets an existing item or adds a new one using a factory.\n * @param key - The composite ID of the item.\n * @param factory - A factory function to create the value if not found. Receives the composite ID.\n * @returns `Success` with the existing or new value.\n */\n public getOrAdd(\n key: TCOMPOSITEID,\n factory: ResultMapValueFactory<TCOMPOSITEID, TITEM>\n ): DetailedResult<TITEM, ResultMapResultDetail>;\n\n public getOrAdd(\n key: TCOMPOSITEID,\n valueOrFactory: TITEM | ResultMapValueFactory<TCOMPOSITEID, TITEM>\n ): DetailedResult<TITEM, ResultMapResultDetail> {\n return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n // Use type guard to check if valueOrFactory is a factory function\n if (this._isFactory(valueOrFactory)) {\n return collection.getOrAdd(itemId, () => valueOrFactory(key));\n }\n return collection.getOrAdd(itemId, valueOrFactory);\n });\n });\n }\n\n /**\n * Clears all items from all mutable collections.\n * Immutable collections are not affected.\n */\n public clear(): void {\n for (const entry of Array.from(this._collections.values())) {\n if (isMutableEntry(entry)) {\n entry.items.clear();\n }\n }\n }\n\n /**\n * Returns a read-only view of this map.\n */\n public toReadOnly(): IReadOnlyResultMap<TCOMPOSITEID, TITEM> {\n return this;\n }\n\n // ==================== Convenience methods for split IDs ====================\n\n /**\n * Composes a collection ID and item ID into a composite ID.\n * @param collectionId - The collection ID.\n * @param itemId - The item ID.\n * @returns `Success` with the composite ID if valid, `Failure` otherwise.\n */\n public composeId(collectionId: TCOLLECTIONID, itemId: TITEMID): Result<TCOMPOSITEID> {\n const rawId = `${collectionId}${this._delimiter}${itemId}`;\n return this._compositeIdValidator.convert(rawId);\n }\n\n /**\n * Adds an item using separate collection and item IDs.\n * @param collectionId - The collection ID.\n * @param itemId - The item ID.\n * @param value - The value to add.\n * @returns `Success` with the composite ID if added, `Failure` otherwise.\n */\n public addToCollection(\n collectionId: TCOLLECTIONID,\n itemId: TITEMID,\n value: TITEM\n ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n return collection.add(itemId, value).onSuccess(() => {\n return this.composeId(collectionId, itemId).withDetail('invalid-key', 'added');\n });\n });\n }\n\n /**\n * Sets an item using separate collection and item IDs.\n * @param collectionId - The collection ID.\n * @param itemId - The item ID.\n * @param value - The value to set.\n * @returns `Success` with the composite ID if set, `Failure` otherwise.\n */\n public setInCollection(\n collectionId: TCOLLECTIONID,\n itemId: TITEMID,\n value: TITEM\n ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n return collection.set(itemId, value).onSuccess((_, detail) => {\n return this.composeId(collectionId, itemId).withDetail('invalid-key', detail);\n });\n });\n }\n\n /**\n * Updates an item using separate collection and item IDs.\n * @param collectionId - The collection ID.\n * @param itemId - The item ID.\n * @param value - The new value.\n * @returns `Success` with the composite ID if updated, `Failure` otherwise.\n */\n public updateInCollection(\n collectionId: TCOLLECTIONID,\n itemId: TITEMID,\n value: TITEM\n ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n return this._getMutableCollection(collectionId).onSuccess((collection) => {\n return collection.update(itemId, value).onSuccess(() => {\n return this.composeId(collectionId, itemId).withDetail('invalid-key', 'updated');\n });\n });\n }\n\n /**\n * Deletes an item using separate collection and item IDs.\n * @param collectionId - The collection ID.\n * @param itemId - The item ID.\n * @returns `Success` with the composite ID if deleted, `Failure` otherwise.\n */\n public deleteFromCollection(\n collectionId: TCOLLECTIONID,\n itemId: TITEMID\n ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n return this._getMutableCollection(collectionId).onSuccess((collection) => {\n return collection.delete(itemId).onSuccess(() => {\n return this.composeId(collectionId, itemId).withDetail('invalid-key', 'deleted');\n });\n });\n }\n\n // ==================== Collection-level methods ====================\n\n /**\n * Provides read-only access to the underlying collections map.\n * Use `collections.has(id)` and `collections.get(id)` to check existence and retrieve collections.\n */\n public get collections(): IReadOnlyValidatingResultMap<\n TCOLLECTIONID,\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n > {\n return this._collections;\n }\n\n /**\n * The number of collections.\n */\n public get collectionCount(): number {\n return this._collections.size;\n }\n\n /**\n * Gets the metadata for a specific collection.\n * @param collectionId - The collection ID.\n * @returns `Success` with the metadata if found, `Failure` otherwise.\n */\n public getCollectionMetadata(collectionId: TCOLLECTIONID): Result<TMETADATA | undefined> {\n return this._collections.get(collectionId).asResult.onSuccess((entry) => {\n return succeed(entry.metadata);\n });\n }\n\n /**\n * Sets the metadata for a mutable collection.\n * @param collectionId - The collection ID.\n * @param metadata - The metadata to set.\n * @returns `Success` if set, `Failure` otherwise.\n */\n public setCollectionMetadata(collectionId: TCOLLECTIONID, metadata: TMETADATA): Result<TMETADATA> {\n return this._collections.get(collectionId).asResult.onSuccess((entry) => {\n if (!isMutableEntry(entry)) {\n return fail(`Cannot modify metadata of immutable collection '${collectionId}'`);\n }\n entry.metadata = metadata;\n return succeed(metadata);\n });\n }\n\n /**\n * Adds a new collection from a pre-built entry object.\n * @param entry - The collection entry to add (JSON with items/entries, or pre-instantiated).\n * @returns `Success` with the entry if added, `Failure` otherwise.\n */\n public addCollectionEntry(\n entry: AggregatedResultMapEntryInit<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n ): DetailedResult<\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n ResultMapResultDetail\n > {\n return AggregatedResultMapBase._entryConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n this._collectionIdConverter,\n this._childKvConverters,\n this._metadataConverter\n )\n .convert(entry)\n .withFailureDetail<ResultMapResultDetail>('invalid-value')\n .onSuccess((c) => this._collections.add(c.id, c));\n }\n\n /**\n * Adds a new collection with the specified ID and optional initial entries.\n * @param collectionId - The collection ID as a string (will be validated).\n * @param items - Optional initial entries for the collection.\n * @param options - Optional settings (isImmutable defaults to false).\n * @returns `Success` with the validated collection ID if added, `Failure` otherwise.\n */\n public addCollectionWithItems(\n collectionId: string,\n items?: Iterable<KeyValueEntry<string, unknown>>,\n options?: IAddCollectionWithItemsOptions<TMETADATA>\n ): Result<TCOLLECTIONID> {\n const isMutable = options?.isImmutable !== true;\n const entries = items ? Array.from(items) : [];\n return this._collectionIdConverter\n .convert(collectionId)\n .onSuccess((id) =>\n this.addCollectionEntry({ isMutable, id, entries, metadata: options?.metadata }).asResult.onSuccess(\n () => Success.with(id)\n )\n );\n }\n\n // ==================== Protected helpers ====================\n\n /**\n * Deletes a collection from the internal collections map.\n * This is a protected method for use by derived classes that need to implement\n * collection deletion functionality.\n *\n * @param collectionId - The collection ID to delete.\n * @returns `Success` with the deleted entry if found, `Failure` otherwise.\n * @remarks\n * - Does NOT check if the collection is mutable - callers should validate this first.\n * - Use `collections.get(id)` to check if a collection exists and its mutability before calling.\n */\n protected _deleteCollection(\n collectionId: TCOLLECTIONID\n ): DetailedResult<\n AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n ResultMapResultDetail\n > {\n // ValidatingResultMap extends ResultMap which has delete method\n return this._collections.delete(collectionId);\n }\n\n // ==================== Private helpers ====================\n\n /**\n * Type guard to check if a value is a factory function.\n */\n private _isFactory(\n valueOrFactory: TITEM | ResultMapValueFactory<TCOMPOSITEID, TITEM>\n ): valueOrFactory is ResultMapValueFactory<TCOMPOSITEID, TITEM> {\n return typeof valueOrFactory === 'function';\n }\n\n private _splitCompositeId(\n key: TCOMPOSITEID\n ): DetailedResult<Converters.ICompositeId<TCOLLECTIONID, TITEMID>, ResultMapResultDetail> {\n return this._compositeIdConverter.convert(key).withDetail('invalid-key', 'success');\n }\n\n private _splitAndLookup(\n key: TCOMPOSITEID\n ): DetailedResult<\n { entry: AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>; itemId: TITEMID },\n ResultMapResultDetail\n > {\n return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n return this._collections.get(collectionId).onSuccess((entry) => {\n return succeedWithDetail({ entry, itemId }, 'success');\n });\n });\n }\n\n private _splitAndLookupMutable(\n key: TCOMPOSITEID\n ): DetailedResult<\n { entry: IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>; itemId: TITEMID },\n ResultMapResultDetail\n > {\n return this._splitAndLookup(key).onSuccess(({ entry, itemId }) => {\n if (!isMutableEntry(entry)) {\n return failWithDetail(`Cannot modify immutable collection '${entry.id}'`, 'failure');\n }\n return succeedWithDetail({ entry, itemId }, 'success');\n });\n }\n\n /**\n * Gets an existing mutable collection by ID.\n * Returns failure if the collection doesn't exist or is immutable.\n */\n private _getMutableCollection(\n collectionId: TCOLLECTIONID\n ): DetailedResult<ValidatingResultMap<TITEMID, TITEM>, ResultMapResultDetail> {\n return this._collections.get(collectionId).onSuccess((entry) => {\n if (!isMutableEntry(entry)) {\n return failWithDetail(`Cannot modify immutable collection '${collectionId}'`, 'failure');\n }\n return succeedWithDetail(entry.items, 'exists');\n });\n }\n\n /**\n * Gets an existing mutable collection or creates a new one.\n */\n private _getOrCreateMutableCollection(\n collectionId: TCOLLECTIONID\n ): DetailedResult<ValidatingResultMap<TITEMID, TITEM>, ResultMapResultDetail> {\n const existing = this._collections.get(collectionId);\n if (existing.isSuccess()) {\n if (!isMutableEntry(existing.value)) {\n return failWithDetail(`Cannot modify immutable collection '${collectionId}'`, 'failure');\n }\n return succeedWithDetail(existing.value.items, 'exists');\n }\n\n // Create a new mutable collection\n const newItems = new ValidatingResultMap<TITEMID, TITEM>({\n converters: this._childKvConverters\n });\n const newEntry: IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> = {\n isMutable: true,\n id: collectionId,\n items: newItems\n };\n return this._collections.add(collectionId, newEntry).onSuccess(() => {\n return succeedWithDetail(newItems, 'added');\n });\n }\n\n // ==================== Static converter factories ====================\n\n /**\n * Constructs a composite id validator using other converters/validators and separator supplied in params.\n * @param params - Constructor params.\n * @returns The composite ID validator.\n */\n private static _compositeIdValidator<\n TCOMPOSITEID extends string,\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n ): Validator<TCOMPOSITEID, unknown> {\n return Validators.compositeId<TCOMPOSITEID, TCOLLECTIONID, TITEMID>({\n collectionId: Converters.asValidator(params.collectionIdConverter),\n separator: params.separator ?? '.',\n itemId: Converters.asValidator(params.itemIdConverter)\n });\n }\n\n /**\n * Converts metadata from source, failing fast if metadata is present but no converter is configured.\n * @param sourceMetadata - The metadata from the source (may be undefined).\n * @param metadataConverter - Optional converter for metadata.\n * @returns Success with converted metadata (or undefined), or Failure if metadata is present but disallowed.\n */\n private static _convertMetadata<TMETADATA>(\n sourceMetadata: unknown,\n metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n ): Result<TMETADATA | undefined> {\n if (sourceMetadata === undefined) {\n return succeed(undefined);\n }\n if (!metadataConverter) {\n return fail('metadata is not allowed when no metadataConverter is configured');\n }\n return metadataConverter.convert(sourceMetadata);\n }\n\n /**\n * Extracts metadata from a source object if present.\n */\n private static _extractSourceMetadata(from: unknown): unknown {\n return typeof from === 'object' && from !== null && 'metadata' in from ? from.metadata : undefined;\n }\n\n /**\n * Creates a converter for pre-instantiated mutable entries.\n * These are entries that already have a ValidatingResultMap as their items property.\n */\n private static _instantiatedMutableConverter<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n ): Converter<IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n const baseConverter = Converters.strictObject<{\n isMutable: true;\n id: TCOLLECTIONID;\n items: ValidatingResultMap<TITEMID, TITEM>;\n }>({\n isMutable: Converters.literal(true),\n id: collectionIdConverter,\n items: Converters.isA<ValidatingResultMap<TITEMID, TITEM>>(\n 'ValidatingResultMap',\n (t) => t instanceof ValidatingResultMap\n )\n });\n\n return Converters.generic<\n IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n unknown\n >((from) => {\n return baseConverter.convert(from).onSuccess((base) => {\n const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n (metadata) => {\n const entry: IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> = {\n isMutable: true,\n id: base.id,\n items: base.items,\n metadata\n };\n return succeed(entry);\n }\n );\n });\n });\n }\n\n /**\n * Creates a converter for pre-instantiated read-only entries.\n * These are entries that already have an IReadOnlyValidatingResultMap as their items property.\n */\n private static _instantiatedReadonlyConverter<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n ): Converter<IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n const baseConverter = Converters.strictObject<{\n isMutable: false;\n id: TCOLLECTIONID;\n items: IReadOnlyValidatingResultMap<TITEMID, TITEM>;\n }>({\n isMutable: Converters.literal(false),\n id: collectionIdConverter,\n items: Converters.isA<IReadOnlyValidatingResultMap<TITEMID, TITEM>>(\n 'IReadOnlyValidatingResultMap',\n (t) => t instanceof ValidatingResultMap\n )\n });\n\n return Converters.generic<\n IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n unknown\n >((from) => {\n return baseConverter.convert(from).onSuccess((base) => {\n const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n (metadata) => {\n const entry: IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> = {\n isMutable: false,\n id: base.id,\n items: base.items,\n metadata\n };\n return succeed(entry);\n }\n );\n });\n });\n }\n\n /**\n * Creates a converter for JSON entries with an entries array.\n * Converts the entries array to a ValidatingResultMap.\n */\n private static _jsonWithEntriesConverter<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n childKvConverters: KeyValueConverters<TITEMID, TITEM>,\n metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n ): Converter<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n const entriesArrayConverter = Converters.isA<KeyValueEntry<string, unknown>[]>(\n 'entries array',\n (t): t is KeyValueEntry<string, unknown>[] =>\n Array.isArray(t) && t.every((item) => Array.isArray(item) && item.length === 2)\n );\n\n const baseConverter = Converters.object<{\n isMutable: boolean;\n id: TCOLLECTIONID;\n entries: KeyValueEntry<string, unknown>[];\n }>({\n isMutable: Converters.boolean,\n id: collectionIdConverter,\n entries: entriesArrayConverter\n });\n\n return Converters.generic<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>((from) => {\n return baseConverter.convert(from).onSuccess((json) => {\n const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n\n return childKvConverters.convertEntries(json.entries).onSuccess((convertedEntries) => {\n const items = new ValidatingResultMap<TITEMID, TITEM>({\n converters: childKvConverters,\n entries: convertedEntries\n });\n return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n (metadata) => {\n if (json.isMutable) {\n return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n isMutable: true,\n id: json.id,\n items,\n metadata\n });\n }\n return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n isMutable: false,\n id: json.id,\n items: items.toReadOnly(),\n metadata\n });\n }\n );\n });\n });\n });\n }\n\n /**\n * Creates a converter for JSON entries with an items object.\n * Converts the items object to a ValidatingResultMap.\n */\n private static _jsonWithItemsConverter<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n childKvConverters: KeyValueConverters<TITEMID, TITEM>,\n metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n ): Converter<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n const baseConverter = Converters.object<{\n isMutable: boolean;\n id: TCOLLECTIONID;\n items: Record<string, unknown>;\n }>({\n isMutable: Converters.boolean,\n id: collectionIdConverter,\n items: Converters.generic<Record<string, unknown>>((from) => {\n if (typeof from === 'object' && from !== null && !Array.isArray(from)) {\n return succeed(from as Record<string, unknown>);\n }\n return fail('expected an object');\n })\n });\n\n return Converters.generic<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>((from) => {\n return baseConverter.convert(from).onSuccess((json) => {\n const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n const entries = Object.entries(json.items) as KeyValueEntry<string, unknown>[];\n\n return childKvConverters.convertEntries(entries).onSuccess((convertedEntries) => {\n const items = new ValidatingResultMap<TITEMID, TITEM>({\n converters: childKvConverters,\n entries: convertedEntries\n });\n return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n (metadata) => {\n if (json.isMutable) {\n return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n isMutable: true,\n id: json.id,\n items,\n metadata\n });\n }\n return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n isMutable: false,\n id: json.id,\n items: items.toReadOnly(),\n metadata\n });\n }\n );\n });\n });\n });\n }\n\n /**\n * Creates a unified entry converter that handles all entry formats.\n * Tries each format in order: instantiated mutable, instantiated readonly,\n * JSON with entries array, JSON with items object.\n */\n private static _entryConverter<\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n childKvConverters: KeyValueConverters<TITEMID, TITEM>,\n metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n ): Converter<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n return Converters.oneOf<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown>([\n AggregatedResultMapBase._instantiatedMutableConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n collectionIdConverter,\n metadataConverter\n ),\n AggregatedResultMapBase._instantiatedReadonlyConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n collectionIdConverter,\n metadataConverter\n ),\n AggregatedResultMapBase._jsonWithEntriesConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n collectionIdConverter,\n childKvConverters,\n metadataConverter\n ),\n AggregatedResultMapBase._jsonWithItemsConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n collectionIdConverter,\n childKvConverters,\n metadataConverter\n )\n ]);\n }\n}\n\n/**\n * An aggregated result map that wraps a collection of {@link ValidatingResultMap | ValidatingResultMap} instances,\n * keyed by collection ID. Items are accessed via composite IDs that combine the collection ID\n * and item ID with a delimiter.\n * @public\n */\nexport class AggregatedResultMap<\n TCOMPOSITEID extends string,\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n> extends AggregatedResultMapBase<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA> {\n /**\n * Constructs a new {@link AggregatedResultMap | AggregatedResultMap}.\n * @param params -\n */\n public constructor(\n params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n ) {\n super(params);\n }\n\n /**\n * Creates a new {@link AggregatedResultMap | AggregatedResultMap}.\n * @param params - Parameters for constructing the map.\n * @returns `Success` with the new map if successful, `Failure` otherwise.\n */\n public static create<\n TCOMPOSITEID extends string,\n TCOLLECTIONID extends string,\n TITEMID extends string,\n TITEM,\n TMETADATA = unknown\n >(\n params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n ): Result<AggregatedResultMap<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>> {\n return captureResult(() => new AggregatedResultMap(params));\n }\n}\n"]}