@fgv/ts-utils 1.2.1 → 1.3.0

package/result.d.ts

@@ -1,132 +1,486 @@
+/**
+ * Represents the {@link IResult | result} of some operation or sequence of operations.
+ * @remarks
+ * {@link Success | Success<T>} and {@link Failure | Failure<T>} share the common
+ * contract {@link IResult}, enabling comingled discriminated usage.
+ * @public
+ */
 export declare type Result<T> = Success<T> | Failure<T>;
+/**
+ * Continuation callback to be called in the event that an
+ * {@link Result} is successful.
+ * @public
+ */
 export declare type SuccessContinuation<T, TN> = (value: T) => Result<TN>;
+/**
+ * Continuation callback to be called in the event that an
+ * {@link Result} fails.
+ * @public
+ */
 export declare type FailureContinuation<T> = (message: string) => Result<T>;
+/**
+ * Type inference to determine the result type of an {@link Result}.
+ * @beta
+ */
 export declare type ResultValueType<T> = T extends Result<infer TV> ? TV : never;
+/**
+ * Simple logger interface used by {@link IResult.getValueOrThrow}.
+ * @public
+ */
 export interface IResultLogger {
+    /**
+     * Log an error message.
+     * @param message - The message to be logged.
+     */
     error(message: string): void;
 }
+/**
+ * Represents the result of some operation of sequence of operations.
+ * @remarks
+ * This common contract enables comingled discriminated usage of {@link Success | Success<T>}
+ * and {@link Failure | Failure<T>}.
+ * @public
+ */
 export interface IResult<T> {
+    /**
+     * Indicates whether the operation was successful.
+     */
+    readonly success: boolean;
+    /**
+     * Indicates whether this operation was successful.  Functions
+     * as a type guard for {@link Success | Success<T>}.
+     */
     isSuccess(): this is Success<T>;
+    /**
+     * Indicates whether this operation failed.  Functions
+     * as a type guard for {@link Failure | Failure<T>}.
+     */
     isFailure(): this is Failure<T>;
+    /**
+     * Gets the value associated with a successful {@link IResult | result},
+     * or throws the error message if the corresponding operation failed.
+     * @param logger - An optional {@link IResultLogger | logger} to which the
+     * error will also be reported.
+     * @returns The return value, if the operation was successful.
+     * @throws The error message if the operation failed.
+     */
     getValueOrThrow(logger?: IResultLogger): T;
+    /**
+     * Gets the value associated with a successful {@link IResult | result},
+     * or a default value if the corresponding operation failed.
+     * @param dflt - The value to be returned if the operation failed (default is
+     * `undefined`).
+     * @returns The return value, if the operation was successful.  Returns
+     * the supplied default value or `undefined` if no default is supplied.
+     */
     getValueOrDefault(dflt?: T): T | undefined;
+    /**
+     * Calls a supplied {@link SuccessContinuation | success continuation} if
+     * the operation was a success.
+     * @remarks
+     * The {@link SuccessContinuation | success continuation} might return a
+     * different result type than {@link IResult} on which it is invoked. This
+     * enables chaining of operations with heterogenous return types.
+     *
+     * @param cb - The {@link SuccessContinuation | success continuation} to
+     * be called in the event of success.
+     * @returns If this operation was successful, returns the value returned
+     * by the {@link SuccessContinuation | success continuation}.  If this result
+     * failed, propagates the error message from this failure.
+     */
     onSuccess<TN>(cb: SuccessContinuation<T, TN>): Result<TN>;
+    /**
+     * Calls a supplied {@link FailureContinuation | failed continuation} if
+     * the operation failed.
+     * @param cb - The {@link FailureContinuation | failure continuation} to
+     * be called in the event of failure.
+     * @returns If this operation failed, returns the value returned by the
+     * {@link FailureContinuation | failure continuation}.  If this result
+     * was successful, propagates the result value from the successful event.
+     */
     onFailure(cb: FailureContinuation<T>): Result<T>;
+    /**
+     * Converts a {@link IResult | IResult<T>} to a {@link DetailedResult | DetailedResult<T, TD>},
+     * adding a supplied detail if the operation failed.
+     * @param detail - The detail to be added if this operation failed.
+     * @returns A new {@link DetailedResult | DetailedResult<T, TD>} with either
+     * the success result or the error message from this {@link IResult}, with
+     * the supplied detail (if this event failed) or detail `undefined` (if
+     * this result succeeded).
+     */
     withFailureDetail<TD>(detail: TD): DetailedResult<T, TD>;
+    /**
+     * Converts a {@link IResult | IResult<T>} to a {@link DetailedResult | DetailedResult<T, TD>},
+     * adding supplied details.
+     * @param detail - The default detail to be added to the new {@link DetailedResult}.
+     * @param successDetail - An optional detail to be added if this result was successful.
+     * @returns A new {@link DetailedResult | DetailedResult<T, TD>} with either
+     * the success result or the error message from this {@link IResult} and the
+     * appopriate added detail.
+     */
     withDetail<TD>(detail: TD, successDetail?: TD): DetailedResult<T, TD>;
 }
+/**
+ * Reports a successful {@link IResult | result} from some operation and the
+ * corresponding value.
+ * @public
+ */
 export declare class Success<T> implements IResult<T> {
+    /**
+     * {@inheritdoc IResult.success}
+     */
+    readonly success = true;
+    /**
+     * @internal
+     */
     private readonly _value;
+    /**
+     * Constructs a {@link Success} with the supplied value.
+     * @param value - The value to be returned.
+     */
     constructor(value: T);
+    /**
+     * The result value returned by the successful operation.
+     */
+    get value(): T;
+    /**
+     * {@inheritdoc IResult.isSuccess}
+     */
     isSuccess(): this is Success<T>;
+    /**
+     * {@inheritdoc IResult.isFailure}
+     */
     isFailure(): this is Failure<T>;
-    get value(): T;
+    /**
+     * {@inheritdoc IResult.getValueOrThrow}
+     */
     getValueOrThrow(_logger?: IResultLogger): T;
+    /**
+     * {@inheritdoc IResult.getValueOrDefault}
+     */
     getValueOrDefault(dflt?: T): T | undefined;
+    /**
+     * {@inheritdoc IResult.onSuccess}
+     */
     onSuccess<TN>(cb: SuccessContinuation<T, TN>): Result<TN>;
+    /**
+     * {@inheritdoc IResult.onFailure}
+     */
     onFailure(_: FailureContinuation<T>): Result<T>;
+    /**
+     * {@inheritdoc IResult.withFailureDetail}
+     */
     withFailureDetail<TD>(_detail: TD): DetailedResult<T, TD>;
+    /**
+     * {@inheritdoc IResult.withDetail}
+     */
     withDetail<TD>(detail: TD, successDetail?: TD): DetailedResult<T, TD>;
 }
+/**
+ * Reports a failed {@link IResult | result} from some operation, with an error message.
+ * @public
+ */
 export declare class Failure<T> implements IResult<T> {
+    /**
+     * {@inheritdoc IResult.success}
+     */
+    readonly success = false;
+    /**
+     * @internal
+     */
     private readonly _message;
+    /**
+     * Constructs a {@link Failure} with the supplied message.
+     * @param message - Error message to be reported.
+     */
     constructor(message: string);
+    /**
+     * Gets the error message associated with this error.
+     */
+    get message(): string;
+    /**
+     * {@inheritdoc IResult.isSuccess}
+     */
     isSuccess(): this is Success<T>;
+    /**
+     * {@inheritdoc IResult.isFailure}
+     */
     isFailure(): this is Failure<T>;
-    get message(): string;
+    /**
+     * {@inheritdoc IResult.getValueOrThrow}
+     */
     getValueOrThrow(logger?: IResultLogger): never;
+    /**
+     * {@inheritdoc IResult.getValueOrDefault}
+     */
     getValueOrDefault(dflt?: T): T | undefined;
+    /**
+     * {@inheritdoc IResult.onSuccess}
+     */
     onSuccess<TN>(_: SuccessContinuation<T, TN>): Result<TN>;
+    /**
+     * {@inheritdoc IResult.onFailure}
+     */
     onFailure(cb: FailureContinuation<T>): Result<T>;
+    /**
+     * {@inheritdoc IResult.withFailureDetail}
+     */
     withFailureDetail<TD>(detail: TD): DetailedResult<T, TD>;
+    /**
+     * {@inheritdoc IResult.withDetail}
+     */
     withDetail<TD>(detail: TD, _successDetail?: TD): DetailedResult<T, TD>;
+    /**
+     * Get a 'friendly' string representation of this object.
+     * @remarks
+     * The string representation of a {@link Failure} value is the error message.
+     * @returns A string representing this object.
+     */
     toString(): string;
 }
 /**
- * Helper function for successful return
- * @param val The value to be returned
+ * Returns {@link Success | Success<T>} with the supplied result value.
+ * @param value - The successful result value to be returned
+ * @public
  */
-export declare function succeed<T>(val: T): Success<T>;
+export declare function succeed<T>(value: T): Success<T>;
 /**
- * Helper function for error return
- * @param message Error message to be returned
+ * Returns {@link Failure | Failure<T>} with the supplied error message.
+ * @param message - Error message to be returned.
+ * @public
  */
 export declare function fail<T>(message: string): Failure<T>;
+/**
+ * Callback to be called when a {@link DetailedResult} encounters success.
+ * @remarks
+ * A success callback can return a different result type than it receives, allowing
+ * success results to chain through intermediate result types.
+ * @public
+ */
 export declare type DetailedSuccessContinuation<T, TD, TN> = (value: T, detail?: TD) => DetailedResult<TN, TD>;
+/**
+ * Callback to be called when a {@link DetailedResult} encounters a failure.
+ * @remarks
+ * A failure callback can change {@link Failure} to {@link Success} (e.g. by returning a default value)
+ * or it can change or embellish the error message, but it cannot change the success return type.
+ * @public
+ */
 export declare type DetailedFailureContinuation<T, TD> = (message: string, detail: TD) => DetailedResult<T, TD>;
+/**
+ * A {@link DetailedSuccess} extends {@link Success} to report optional success details in
+ * addition to the error message.
+ * @public
+ */
 export declare class DetailedSuccess<T, TD> extends Success<T> {
+    /**
+     * @internal
+     */
     protected _detail?: TD;
+    /**
+     * Constructs a new {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied
+     * value and detail.
+     * @param value - The value to be returned.
+     * @param detail - An optional successful detail to be returned.  If omitted, detail
+     * will be `undefined`.
+     */
     constructor(value: T, detail?: TD);
+    /**
+     * The success detail associated with this {@link DetailedSuccess}, or `undefined` if
+     * no detail was supplied.
+     */
     get detail(): TD | undefined;
+    /**
+     * Reports that this {@link DetailedSuccess} is a success.
+     * @remarks
+     * Always true for {@link DetailedSuccess} but can be used as type guard
+     * to discriminate {@link DetailedSuccess} from {@link DetailedFailure} in
+     * a {@link DetailedResult}.
+     * @returns `true`
+     */
     isSuccess(): this is DetailedSuccess<T, TD>;
+    /**
+     * Invokes the supplied {@link DetailedSuccessContinuation | success callback} and propagates
+     * its returned {@link DetailedResult | DetailedResult<TN, TD>}.
+     * @remarks
+     * The success callback mutates the return type from `<T>` to `<TN>`.
+     * @param cb - The {@link DetailedSuccessContinuation | success callback} to be invoked.
+     * @returns The {@link DetailedResult | DetailedResult<T, TD>} returned by the success callback.
+     */
     onSuccess<TN>(cb: DetailedSuccessContinuation<T, TD, TN>): DetailedResult<TN, TD>;
+    /**
+     * Propagates this {@link DetailedSuccess}.
+     * @remarks
+     * Failure does not mutate return type so we can return this event directly.
+     * @param _cb - {@link DetailedFailureContinuation | Failure callback} to be called
+     * on a {@link DetailedResult} in case of failure (ignored).
+     * @returns `this`
+     */
     onFailure(_cb: DetailedFailureContinuation<T, TD>): DetailedResult<T, TD>;
 }
 /**
- * A DetailedFailure reports optional failure details in addition
- * to the standard failure message.
+ * A {@link DetailedFailure} extends {@link Failure} to report optional failure details in
+ * addition to the error message.
+ * @public
  */
 export declare class DetailedFailure<T, TD> extends Failure<T> {
+    /**
+     * @internal
+     */
     protected _detail: TD;
+    /**
+     * Constructs a new {@link DetailedFailure | DetailedFailure<T, TD>} with the supplied
+     * message and detail.
+     * @param message - The message to be returned.
+     * @param detail - The error detail to be returned.
+     */
     constructor(message: string, detail: TD);
+    /**
+     * The error detail associated with this {@link DetailedFailure}.
+     */
     get detail(): TD;
+    /**
+     * Reports that this {@link DetailedFailure} is a failure.
+     * @remarks
+     * Always true for {@link DetailedFailure} but can be used as type guard
+     * to discriminate {@link DetailedSuccess} from {@link DetailedFailure} in
+     * a {@link DetailedResult}.
+     * @returns `true`
+     */
     isFailure(): this is DetailedFailure<T, TD>;
+    /**
+     * Propagates the error message and detail from this result.
+     * @remarks
+     * Mutates the success type as the success callback would have, but does not
+     * call the success callback.
+     * @param _cb - {@link DetailedSuccessContinuation | Success callback} to be called
+     * on a {@link DetailedResult} in case of success (ignored).
+     * @returns A new {@link DetailedFailure | DetailedFailure<TN, TD>} which contains
+     * the error message and detail from this one.
+     */
     onSuccess<TN>(_cb: DetailedSuccessContinuation<T, TD, TN>): DetailedResult<TN, TD>;
+    /**
+     * Invokes the supplied {@link DetailedFailureContinuation | failure callback} and propagates
+     * its returned {@link DetailedResult | DetailedResult<T, TD>}.
+     * @param cb - The {@link DetailedFailureContinuation | failure callback} to be invoked.
+     * @returns The {@link DetailedResult | DetailedResult<T, TD>} returned by the failure callback.
+     */
     onFailure(cb: DetailedFailureContinuation<T, TD>): DetailedResult<T, TD>;
 }
+/**
+ * Type inference to determine the result type `T` of a {@link DetailedResult | DetailedResult<T, TD>}.
+ * @beta
+ */
 export declare type DetailedResult<T, TD> = DetailedSuccess<T, TD> | DetailedFailure<T, TD>;
+/**
+ * Type inference to determine the detail type `TD` of a {@link DetailedResult | DetailedResult<T, TD>}.
+ * @beta
+ */
 export declare type ResultDetailType<T> = T extends DetailedResult<unknown, infer TD> ? TD : never;
+/**
+ * Returns {@link DetailedSuccess | DetailedSuccess<T, TD>} with a supplied value and optional
+ * detail.
+ * @param value - The value of type `<T>` to be returned.
+ * @param detail - An optional detail of type `<TD>` to be returned.
+ * @returns A {@link DetailedSuccess | DetailedSuccess<T, TD>} with the supplied value
+ * and detail, if supplied.
+ * @public
+ */
 export declare function succeedWithDetail<T, TD>(value: T, detail?: TD): DetailedSuccess<T, TD>;
+/**
+ * Returns {@link DetailedFailure | DetailedFailure<T, TD>} with a supplied error message and detail.
+ * @param message - The error message to be returned.
+ * @param detail - The event detail to be returned.
+ * @returns An {@link DetailedFailure | DetailedFailure<T, TD>} with the supplied error
+ * message and detail.
+ * @public
+ */
 export declare function failWithDetail<T, TD>(message: string, detail: TD): DetailedFailure<T, TD>;
+/**
+ * Propagates a {@link Success} or {@link Failure} {@link Result}, adding supplied
+ * event details as appropriate.
+ * @param result - The {@link Result} to be propagated.
+ * @param detail - The event detail (type `<TD>`) to be added to the {@link Result | result}.
+ * @param successDetail - An optional distinct event detail to be added to {@link Success} results.  If `successDetail`
+ * is omitted or `undefined`, then `detail` will be applied to {@link Success} results.
+ * @returns A new {@link DetailedResult | DetailedResult<T, TD>} with the success value or error
+ * message from the original `result` but with the specified detail added.
+ * @public
+ */
 export declare function propagateWithDetail<T, TD>(result: Result<T>, detail: TD, successDetail?: TD): DetailedResult<T, TD>;
 /**
- * Wraps a function which returns a value of type <T> or throws
- * to produce Success<T> or Failure<T>
- * @param func The method to be captured
+ * Wraps a function which might throw to convert exception results
+ * to {@link Failure}.
+ * @param func - The function to be captured.
+ * @returns Returns {@link Success} with a value of type `<T>` on
+ * success , or {@link Failure} with the thrown error message if
+ * `func` throws an `Error`.
+ * @public
  */
 export declare function captureResult<T>(func: () => T): Result<T>;
 /**
- * Maps an array of Result<T> to an array of <T>, if all results are
- * successful.  If any results fail, returns failure with a concatenated
- * summary of all failure messages.
- * @param resultsIn The results to be mapped.
+ * Aggregates sucessful result values from a collection of {@link Result | Result<T>}.
+ * @param results - The collection of {@link Result | Result<T>} to be mapped.
+ * @returns  If all {@link Result | results} are successful, returns {@link Success} with an
+ * array containing all returned values.  If any {@link Result | results} failed, returns
+ * {@link Failure} with a concatenated summary of all error messages.
+ * @public
  */
-export declare function mapResults<T>(resultsIn: Iterable<Result<T>>): Result<T[]>;
+export declare function mapResults<T>(results: Iterable<Result<T>>): Result<T[]>;
 /**
- * Maps an array of DetailedResult<T, TD> to an array of <T>, if all results are
- * successful or yield ignorable errors.  If any results fail with an error that
- * cannot be ignored, returns failure with a concatenated summary of all failure messages.
- * @param resultsIn The results to be mapped.
- * @param ignore Error detail values that should be ignored
+ * Aggregates sucessful results from a collection of {@link DetailedResult | DetailedResult<T, TD>},
+ * optionally ignoring certain error details.
+ * @param results - The collection of {@link DetailedResult | DetailedResult<T, TD>} to be mapped.
+ * @param ignore - An array of error detail values (of type `<TD>`) that should be ignored.
+ * @returns {@link Success} with an array containing all successful results if all results either
+ * suceeded or returned error details listed in `ignore`.  If any results failed with details
+ * that cannot be ignored, returns {@link Failure} with an concatenated summary of all non-ignorable
+ * error mesasges.
+ * @public
  */
-export declare function mapDetailedResults<T, TD>(resultsIn: Iterable<DetailedResult<T, TD>>, ignore: TD[]): Result<T[]>;
+export declare function mapDetailedResults<T, TD>(results: Iterable<DetailedResult<T, TD>>, ignore: TD[]): Result<T[]>;
 /**
- * Maps an array of Result<T> to an array of <T>, omitting any error
- * results.  If no results were successful, returns failure with a
- * concatenated summary of all failure messages.
+ * Aggregates successful results from a a collection of {@link Result | Result<T>}.
+ * @param results - An `Iterable` of {@link Result | Result<T>} from which success
+ * results are to be aggregated.
+ * @returns {@link Success} with an array of `<T>` if any results were successful. If
+ * all {@link Result | results} failed, returns {@link Failure} with a concatenated
+ * summary of all error messages.
+ * @public
  */
-export declare function mapSuccess<T>(resultsIn: Iterable<Result<T>>): Result<T[]>;
+export declare function mapSuccess<T>(results: Iterable<Result<T>>): Result<T[]>;
 /**
- * Maps an array of Result<T> to an array of strings consisting of all
- * error messages returned by results in the source array. Ignores
- * success results and returns an empty array if there were no errors.
- * @param resultsIn results to be reported
+ * Aggregates error messages from a collection of {@link Result | Result<T>}.
+ * @param results - An interable collection of {@link Result | Result<T>} for which
+ * error messages are aggregated.
+ * @returns An array of strings consisting of all error messages returned by
+ * {@link Result | results} in the source collection. Ignores {@link Success}
+ * results and returns an empty array if there were no errors.
+ * @public
  */
-export declare function mapFailures<T>(resultsIn: Iterable<Result<T>>): string[];
+export declare function mapFailures<T>(results: Iterable<Result<T>>): string[];
 /**
- * Returns success with true if all results are successful.  If any are unsuccessful,
- * returns failure with a concatenated summary of all failure messages.
- * @param results The results to be tested.
+ * Determines if an iterable collection of {@link Result | Result<T>} were all successful.
+ * @param results - The collection of {@link Result | Result<T>} to be tested.
+ * @returns Returns {@link Success} with `true` if all {@link Result | results} are successful.
+ * If any are unsuccessful, returns {@link Failure} with a concatenated summary the error
+ * messages from all failed elements.
+ * @public
  */
 export declare function allSucceed<T>(results: Iterable<Result<unknown>>, successValue: T): Result<T>;
+/**
+ * String-keyed record of initialization functions to be passed to {@link populateObject}.
+ * @public
+ */
 export declare type FieldInitializers<T> = {
     [key in keyof T]: (state: Partial<T>) => Result<T[key]>;
 };
 /**
- * Populates an an object based on a prototype full of field initializers that return Result<T[key]>.
- * Returns success with the populated object if all initializers succeed, or failure with a
- * concatenated list of all failure messages.
- * @param initializers An object with the shape of the target but with initializer functions for
+ * Populates an an object based on a prototype full of field initializers that return {@link Result | Result<T[key]>}.
+ * Returns {@link Success} with the populated object if all initializers succeed, or {@link Failure} with a
+ * concatenated list of all error messages.
+ * @param initializers - An object with the shape of the target but with initializer functions for
  * each property.
+ * @public
  */
 export declare function populateObject<T>(initializers: FieldInitializers<T>, order?: (keyof T)[]): Result<T>;
+//# sourceMappingURL=result.d.ts.map

package/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"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"}