unwrapped 0.1.2 → 0.1.4

package/dist/core/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/error.ts","../../src/core/result.ts","../../src/core/asyncResult.ts","../../src/core/cache.ts"],"sourcesContent":["export class ErrorBase {\n  code: string;\n  message?: string | undefined;\n  thrownError?: any;\n\n  constructor(code: string, message?: string, thrownError?: any, log: boolean = true) {\n    this.code = code;\n    this.message = message;\n    this.thrownError = thrownError;\n\n    if (log) {\n      this.logError();\n    }\n  }\n\n  toString(): string {\n    return `Error ${this.code}: ${this.message ?? ''}`;\n  }\n\n  logError(): void {\n    console.error(this.toString(), this.thrownError);\n  }\n}","import { ErrorBase } from \"./error\";\n\nexport type ResultState<T, E = ErrorBase> =\n  | { status: 'success'; value: T }\n  | { status: 'error'; error: E };\n\n\nexport class Result<T, E = ErrorBase> {\n  private _state: ResultState<T, E>;\n\n  constructor(state: ResultState<T, E>) {\n    this._state = state;\n  }\n\n  get state() {\n    return this._state;\n  }\n\n  static ok<T, E = ErrorBase>(value: T): Result<T, E> {\n    return new Result({ status: 'success', value });\n  }\n\n  static err<E>(error: E): Result<never, E> {\n    return new Result({ status: 'error', error });\n  }\n\n  static errTag(code: string, message?: string): Result<never, ErrorBase> {\n    return Result.err(new ErrorBase(code, message));\n  }\n\n  unwrapOrNull(): T | null {\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    return null;\n  }\n\n  unwrapOrThrow(): T {\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    throw new Error('Tried to unwrap a Result that is not successful');\n  }\n\n  unwrapOr<O>(defaultValue: O): T | O {\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    return defaultValue;\n  }\n\n  isSuccess(): boolean {\n    return this._state.status === 'success';\n  }\n\n  isError(): boolean {\n    return this._state.status === 'error';\n  }\n\n  static tryPromise<T, E>(promise: Promise<T>, errorMapper: (error: unknown) => E): Promise<Result<T, E>> {\n    return promise\n      .then((value) => Result.ok<T, E>(value))\n      .catch((error) => Result.err(errorMapper(error)));\n  }\n\n  static tryFunction<T, E extends ErrorBase = ErrorBase>(fn: () => Promise<T>, errorMapper: (error: unknown) => E): Promise<Result<T, E>> {\n    return Result.tryPromise(fn(), errorMapper);\n  }\n\n  chain<O, E2>(fn: (input: T) => ResultState<O, E | E2>): Result<O, E | E2> {\n    if (this._state.status === 'success') {\n      return new Result<O, E | E2>(fn(this._state.value));\n    }\n    return Result.err<E>(this._state.error);\n  }\n\n  *[Symbol.iterator](): Generator<Result<T, E>, T, any> {\n    yield this;\n\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    return undefined as T;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static run<T, E>(generator: () => Generator<Result<any, E>, T, any>): Result<T, E> {\n    const iterator = generator();\n    let result = iterator.next();\n\n    while (!result.done) {\n      const yielded = result.value;\n      if (yielded._state.status === 'error') {\n        return Result.err(yielded._state.error);\n      }\n      result = iterator.next(yielded._state.value);\n    }\n\n    return Result.ok(result.value);\n  }\n}\n","import type { ErrorBase } from \"./error\";\nimport { Result, type ResultState } from \"./result\";\n\nexport type AsyncResultState<T, E> =\n  | { status: 'idle' }\n  | { status: 'loading'; promise: Promise<Result<T, E>> }\n  | ResultState<T, E>;\n\nexport type ChainFunction<I, O, E> = (input: I) => Result<O, E> | Promise<Result<O, E>>;\nexport type FlatChainFunction<I, O, E> = (input: I) => AsyncResult<O, E>;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AsyncResultListener<T, E> = (result: AsyncResult<T, E>) => any;\n\nexport class AsyncResult<T, E = ErrorBase> {\n  private _state: AsyncResultState<T, E>;\n  private _listeners: Set<AsyncResultListener<T, E>> = new Set();\n\n  constructor(state?: AsyncResultState<T, E>) {\n    this._state = state || { status: 'idle' };\n  }\n\n  get state() {\n    return this._state;\n  }\n\n  private set state(newState: AsyncResultState<T, E>) {\n    this._state = newState;\n    this._listeners.forEach((listener) => listener(this));\n  }\n\n  static ok<T>(value: T): AsyncResult<T, never> {\n    return new AsyncResult<T, never>({ status: 'success', value });\n  }\n\n  static err<E>(error: E): AsyncResult<never, E> {\n    return new AsyncResult<never, E>({ status: 'error', error });\n  }\n\n  isSuccess() {\n    return this._state.status === 'success';\n  }\n\n  isError() {\n    return this._state.status === 'error';\n  }\n\n  isLoading() {\n    return this._state.status === 'loading';\n  }\n\n  listen(listener: AsyncResultListener<T, E>, immediate = true) {\n    this._listeners.add(listener);\n    if (immediate) {\n      listener(this);\n    }\n\n    return () => {\n      this._listeners.delete(listener);\n    };\n  }\n\n  listenUntilSettled(listener: AsyncResultListener<T, E>, immediate = true) {\n    const unsub = this.listen((result) => {\n      listener(result);\n      if (result.state.status === 'success' || result.state.status === 'error') {\n        unsub();\n      }\n    }, immediate);\n\n    return unsub;\n  }\n\n  setState(newState: AsyncResultState<T, E>) {\n    this.state = newState;\n  }\n\n  copyOnceSettled(other: AsyncResult<T, E>) {\n    this.updateFromResultPromise(other.toResultPromise());\n  }\n\n  update(newState: AsyncResultState<T, E>) {\n    this.state = newState;\n  }\n\n  updateToValue(value: T) {\n    this.state = { status: 'success', value };\n  }\n\n  updateToError(error: E) {\n    this.state = { status: 'error', error };\n  }\n\n  updateFromResultPromise(promise: Promise<Result<T, E>>) {\n    this.state = { status: 'loading', promise };\n    promise\n      .then((res) => {\n        this.state = res.state;\n      })\n      .catch((error) => {\n        this.state = { status: 'error', error };\n      });\n  }\n\n  static fromResultPromise<T, E>(promise: Promise<Result<T, E>>): AsyncResult<T, E> {\n    const result = new AsyncResult<T, E>();\n    result.updateFromResultPromise(promise);\n    return result;\n  }\n\n  updateFromValuePromise(promise: Promise<T>) {\n    const resultStatePromise = async (): Promise<Result<T, E>> => {\n      try {\n        const value = await promise;\n        return Result.ok(value);\n      } catch (error) {\n        return Result.err(error as E);\n      }\n    };\n    this.updateFromResultPromise(resultStatePromise());\n  }\n\n  static fromValuePromise<T, E>(promise: Promise<T>): AsyncResult<T, E> {\n    const result = new AsyncResult<T, E>();\n    result.updateFromValuePromise(promise);\n    return result;\n  }\n\n  async waitForSettled(): Promise<AsyncResult<T, E>> {\n    if (this._state.status === 'loading') {\n      try {\n        const value = await this._state.promise;\n        this._state = value.state;\n      } catch (error) {\n        this._state = { status: 'error', error: error as E };\n      }\n    }\n    return this;\n  }\n\n  async waitForSettledResult(): Promise<Result<T, E>> {\n    const settled = await this.waitForSettled();\n    if (settled.state.status === 'idle' || settled.state.status === 'loading') {\n      throw new Error('Cannot convert idle or loading AsyncResult to ResultState');\n    }\n    if (settled.state.status === 'error') {\n      return Result.err(settled.state.error);\n    }\n    return Result.ok(settled.state.value);\n  }\n\n  async toResultPromise(): Promise<Result<T, E>> {\n    if (this._state.status === 'idle') {\n      throw new Error('Cannot convert idle AsyncResult to ResultState');\n    }\n    if (this._state.status === 'loading') {\n      try {\n        const value = await this._state.promise;\n        this._state = value.state;\n      } catch (error) {\n        this._state = { status: 'error', error: error as E };\n      }\n    }\n    return new Result(this._state);\n  }\n\n  async toValuePromiseThrow(): Promise<T> {\n    const settled = await this.waitForSettled();\n    return settled.unwrapOrThrow();\n  }\n\n  async toValueOrNullPromise(): Promise<T | null> {\n    const settled = await this.waitForSettled();\n    return settled.unwrapOrNull();\n  }\n\n  unwrapOrNull(): T | null {\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    return null;\n  }\n\n  async unwrapOrNullOnceSettled(): Promise<T | null> {\n    return (await this.waitForSettled()).unwrapOrNull();\n  }\n\n  unwrapOrThrow(): T {\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    throw new Error('Tried to unwrap an AsyncResult that is not successful');\n  }\n\n  async unwrapOrThrowOnceSettled(): Promise<T> {\n    return (await this.waitForSettled()).unwrapOrThrow();\n  }\n\n  chain<O, E2>(fn: ChainFunction<T, O, E | E2>): AsyncResult<O, E | E2> {\n    const newResultBuilder = async (): Promise<Result<O, E | E2>> => {\n      const settled = await this.waitForSettled();\n      if (settled.state.status === 'loading' || settled.state.status === 'idle') {\n        throw new Error('Unexpected state after waitForSettled'); // TODO handle this case properly\n      }\n      if (settled.state.status === 'error') {\n        return Result.err(settled.state.error);\n      }\n\n      return fn(settled.state.value);\n    };\n\n    return AsyncResult.fromResultPromise<O, E | E2>(newResultBuilder());\n  }\n\n  flatChain<O, E2>(fn: FlatChainFunction<T, O, E | E2>): AsyncResult<O, E | E2> {\n    const newResultBuilder = async (): Promise<Result<O, E | E2>> => {\n      const settled = await this.waitForSettledResult();\n      if (settled.state.status === 'error') {\n        return Result.err(settled.state.error);\n      }\n\n      const nextAsyncResult = fn(settled.state.value);\n      const nextSettled = await nextAsyncResult.waitForSettledResult();\n      return nextSettled;\n    }\n\n    return AsyncResult.fromResultPromise<O, E | E2>(newResultBuilder());\n  }\n\n  // pipeParallel PipeFunction[] -> AsyncResult<T, E>[]\n  // pipeParallelAndCollapse PipeFunction[] -> AsyncResult<T[], E>\n\n  mirror(other: AsyncResult<T, E>) {\n    return other.listen((newState) => {\n      this.setState(newState.state);\n    }, true);\n  }\n\n  mirrorUntilSettled(other: AsyncResult<T, E>) {\n    return other.listenUntilSettled((newState) => {\n      this.setState(newState.state);\n    }, true);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static ensureAvailable<R extends readonly AsyncResult<any, any>[]>(results: R): AsyncResult<{ [K in keyof R]: R[K] extends AsyncResult<infer T, any> ? T : never }, R[number] extends AsyncResult<any, infer E> ? E : never> {\n    if (results.length === 0) {\n      // empty case — TS infers void tuple, so handle gracefully\n      return AsyncResult.ok(undefined as never);\n    }\n\n    const promise = Promise.all(results.map((r) => r.waitForSettled())).then(\n      (settledResults) => {\n        for (const res of settledResults) {\n          if (res.state.status === 'error') {\n            return Result.err(res.state.error);\n          }\n        }\n\n        const values = settledResults.map((r) => r.unwrapOrNull()!) as {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          [K in keyof R]: R[K] extends AsyncResult<infer T, any>\n          ? T\n          : never;\n        };\n\n        return Result.ok(values);\n      }\n    );\n\n    return AsyncResult.fromResultPromise(promise);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  *[Symbol.iterator](): Generator<AsyncResult<T, E>, T, any> {\n    yield this;\n\n    if (this._state.status === 'success') {\n      return this._state.value;\n    }\n    return undefined as T;\n  }\n\n  private static _runGeneratorProcessor<T, E>(iterator: Generator<AsyncResult<any, any>, T, any>): () => Promise<Result<T, E>> {\n    return async (): Promise<Result<T, E>> => {\n      let result = iterator.next();\n\n      while (!result.done) {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const yielded = result.value as AsyncResult<any, E>;\n        const settled = await yielded.waitForSettledResult();\n        if (settled.state.status === 'error') {\n          return Result.err(settled.state.error);\n        }\n        result = iterator.next(settled.state.value);\n      }\n\n      return Result.ok(result.value);\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static run<T, E = ErrorBase>(generatorFunc: () => Generator<AsyncResult<any, any>, T, any>): AsyncResult<T, E> {\n    const iterator = generatorFunc();\n    return AsyncResult.fromResultPromise<T, E>(AsyncResult._runGeneratorProcessor<T, E>(iterator)());\n  }\n\n  runInPlace(generatorFunc: () => Generator<AsyncResult<any, any>, T, any>) {\n    const iterator = generatorFunc();\n    this.updateFromResultPromise(AsyncResult._runGeneratorProcessor<T, E>(iterator)());\n  }\n}\n","import { AsyncResult, type AsyncResultState, type ChainFunction } from \"./asyncResult\";\nimport type { ErrorBase } from \"./error\";\n\ntype KeyedAsyncCacheRefetchOptions = {\n    policy: 'refetch' | 'if-error' | 'no-refetch';\n};\n\ntype CacheItem<P, V, E> = {\n    result: AsyncResult<V, E>;\n    fetcherParams: P;\n};\n\nconst _defaultRefetchOptions: KeyedAsyncCacheRefetchOptions = { policy: 'no-refetch' };\n\nfunction defaultParamsToKey<P>(params: P): string {\n  if (typeof params === 'object') {\n    return JSON.stringify(params);\n  }\n  return String(params);\n}\n\nexport class KeyedAsyncCache<P, V, E = ErrorBase> {\n  private _cache: Map<string, CacheItem<P, V, E>> = new Map();\n  private _fetcher: ChainFunction<P, V, E>;\n  private _paramsToKey: (params: P) => string;\n\n  constructor(fetcher: ChainFunction<P, V, E>, paramsToKey: (params: P) => string = defaultParamsToKey) {\n    this._fetcher = fetcher;\n    this._paramsToKey = paramsToKey;\n  }\n\n  private makeCacheItem(result: AsyncResult<V, E>, fetcherParams: P): CacheItem<P, V, E> {\n    return { result, fetcherParams };\n  }\n\n  private shouldRefetch(existingResult: CacheItem<P, V, E>, refetch: KeyedAsyncCacheRefetchOptions): boolean {\n    if (refetch.policy === 'refetch') {\n      return true;\n    }\n    if (refetch.policy === 'if-error') {\n      return existingResult.result.state.status === 'error';\n    }\n    return false;\n  }\n\n  get(params: P, refetch: KeyedAsyncCacheRefetchOptions = _defaultRefetchOptions): AsyncResult<V, E> {\n    const key = this._paramsToKey(params);\n    if (this._cache.has(key)) {\n      const cacheItem = this._cache.get(key)!;\n      if (!this.shouldRefetch(cacheItem, refetch)) {\n        return cacheItem.result;\n      } else {\n        cacheItem.result.updateFromResultPromise(Promise.resolve(this._fetcher(cacheItem.fetcherParams)));\n        return cacheItem.result;\n      }\n    }\n\n    const asyncResult = AsyncResult.fromResultPromise(Promise.resolve(this._fetcher(params)));\n    this._cache.set(key, this.makeCacheItem(asyncResult, params));\n    return asyncResult;\n  }\n\n  async getSettledState(params: P, refetch: KeyedAsyncCacheRefetchOptions = _defaultRefetchOptions): Promise<AsyncResultState<V, E>> {\n    const asyncResult = this.get(params, refetch);\n    await asyncResult.waitForSettled();\n    return asyncResult.state;\n  }\n\n  anyLoading(): boolean {\n    for (const cacheItem of this._cache.values()) {\n      if (cacheItem.result.isLoading()) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  clear() {\n    this._cache.clear();\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/core/error.ts","../../src/core/result.ts","../../src/core/asyncResult.ts","../../src/core/cache.ts"],"sourcesContent":["/**\n * Base class for error handling, providing structured error information and logging.\n * @class ErrorBase\n * @property {string} code - The error code.\n * @property {string | undefined} message - The error message (optional).\n * @property {unknown} thrownError - The original error object, if any (optional).\n * \n * @constructor\n * @param {string} code - The error code.\n * @param {string} [message] - The error message.\n * @param {unknown} [thrownError] - The original error object, if any.\n * @param {boolean} [log=true] - Whether to log the error upon creation.\n */\nexport class ErrorBase {\n    code: string;\n    message?: string | undefined;\n    thrownError?: unknown;\n\n    constructor(code: string, message?: string, thrownError?: unknown, log: boolean = true) {\n        this.code = code;\n        this.message = message;\n        this.thrownError = thrownError;\n\n        if (log) {\n            this.logError();\n        }\n    }\n\n    /**\n     * Converts the error to a string representation, on the format \"Error {code}: {message}\".\n     * @returns a string representation of the error\n     */\n    toString(): string {\n        return `Error ${this.code}: ${this.message ?? ''}`;\n    }\n\n    /**\n     * Logs the error to the console, uses console.error and ErrorBase.toString() internally.\n     * Logs thrownError if it was provided on creation.\n     */\n    logError(): void {\n        if (this.thrownError) {\n            console.error(this.toString(), this.thrownError);\n        } else {\n            console.error(this.toString());\n        }\n    }\n}\n","import { ErrorBase } from \"./error\";\n\n/**\n * Type representing the state of a Result, either success with a value of type T,\n * or error with an error of type E (defaulting to ErrorBase).\n */\nexport type ResultState<T, E extends ErrorBase = ErrorBase> =\n    | { status: 'success'; value: T }\n    | { status: 'error'; error: E };\n\n/**\n * Class representing the result of an operation that can either succeed with a value of type T,\n * or fail with an error of type E (defaulting to ErrorBase).\n * Provides methods for unwrapping the result, chaining operations, and handling errors.\n * @class Result\n * @template T - The type of the successful result value.\n * @template E - The type of the error, extending ErrorBase (default is ErrorBase).\n */\nexport class Result<T, E extends ErrorBase = ErrorBase> {\n    private _state: ResultState<T, E>;\n\n    /**\n     * Creates a new Result instance with the given state.\n     * @param state the state of the created Result\n     */\n    constructor(state: ResultState<T, E>) {\n        this._state = state;\n    }\n\n    /** Returns the internal state of the Result. */\n    get state() {\n        return this._state;\n    }\n\n    /**\n     * Checks if the Result is successful.\n     * @returns whether or not the result is successful\n     */\n    isSuccess(): boolean {\n        return this._state.status === 'success';\n    }\n\n    /**\n     * Checks if the Result is an error.\n     * @returns whether or not the result is an error\n     */\n    isError(): boolean {\n        return this._state.status === 'error';\n    }\n\n    /**\n     * Creates a successful Result with the given value.\n     * @param value the result of the successful operation\n     * @returns a successful Result\n     */\n    static ok<T, E extends ErrorBase = ErrorBase>(value: T): Result<T, E> {\n        return new Result({ status: 'success', value });\n    }\n\n    /**\n     * Creates an error Result with the given error.\n     * @param error the error of the failed operation\n     * @returns an error Result\n     */\n    static err<E extends ErrorBase = ErrorBase>(error: E): Result<never, E> {\n        return new Result({ status: 'error', error });\n    }\n\n    /**\n     * Creates an error Result (containing an ErrorBase) with the given error code and optional message.\n     * @param code the error code\n     * @param message an optional error message\n     * @returns an error Result\n     */\n    static errTag(code: string, message?: string, thrownError?: unknown): Result<never, ErrorBase> {\n        return Result.err(new ErrorBase(code, message, thrownError));\n    }\n\n    /**\n     * Returns the successful value (if the Result is successful) or null (if it is an error).\n     * @returns either the successful value or null\n     */\n    unwrapOrNull(): T | null {\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        return null;\n    }\n\n    /**\n     * Returns the successful value (if the Result is successful) or throws an error (if it is an error).\n     * @returns the successful value\n     * @throws an normal JS Error if the result is not successful\n     */\n    unwrapOrThrow(): T {\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        throw new Error('Tried to unwrap a Result that is not successful');\n    }\n\n    /**\n     * Returns the successful value (if the Result is successful) or a default value (if it is an error).\n     * @param defaultValue the default value to return if the Result is an error\n     * @returns either the successful value or the default value\n     */\n    unwrapOr<O>(defaultValue: O): T | O {\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        return defaultValue;\n    }\n\n    /**\n     * Transforms a Promise of a successful value into a Promise of a Result,\n     * catching any thrown errors and mapping them using the provided errorMapper function.\n     * @param promise the promise to execute\n     * @param errorMapper a function that maps a thrown error to a Result error\n     * @returns a Promise resolving to a Result containing either the successful value or the mapped error\n     */\n    static tryPromise<T, E extends ErrorBase = ErrorBase>(promise: Promise<T>, errorMapper: (error: unknown) => E): Promise<Result<T, E>> {\n        return promise\n            .then((value) => Result.ok<T, E>(value))\n            .catch((error) => Result.err(errorMapper(error)));\n    }\n\n    /**\n     * Executes an asynchronous function and transforms its result into a Result,\n     * catching any thrown errors and mapping them using the provided errorMapper function.\n     * Same as Result.tryPromise(fn(), errorMapper).\n     * @param fn the asynchronous function to execute\n     * @param errorMapper a function that maps a thrown error to a Result error\n     * @returns a Promise resolving to a Result containing either the successful value or the mapped error\n     */\n    static tryFunction<T, E extends ErrorBase = ErrorBase>(fn: () => Promise<T>, errorMapper: (error: unknown) => E): Promise<Result<T, E>> {\n        return Result.tryPromise(fn(), errorMapper);\n    }\n\n    /**\n     * Chains the current Result with another operation that returns a ResultState.\n     * If the current Result is successful, applies the provided function to its value.\n     * Otherwise, returns the current error.\n     * Useful to describe a sequence of operations that can each fail, and short-circuit on the first failure.\n     * @param fn a function taking as input the successful value of the result, and returning a ResultState describing the result of its own operation\n     * @returns a new Result that has either the successful value of the operation, or either the error of the current result or the error returned by fn\n     */\n    chain<O, E2 extends ErrorBase = ErrorBase>(fn: (input: T) => ResultState<O, E | E2>): Result<O, E | E2> {\n        if (this._state.status === 'success') {\n            return new Result<O, E | E2>(fn(this._state.value));\n        }\n        return Result.err<E>(this._state.error);\n    }\n\n    /**\n     * Chains the current Result with another operation that returns a Result.\n     * If the current Result is successful, applies the provided function to its value.\n     * Otherwise, returns the current error.\n     * Useful to describe a sequence of operations that can each fail, and short-circuit on the first failure.\n     * Same as chain, but the function returns a Result directly instead of a ResultState.\n     * @param fn a function taking as input the successful value of the result, and returning a Result describing the result of its own operation\n     * @returns a new Result that has either the successful value of the operation, or either the error of the current result or the error returned by fn\n     */\n    flatChain<O, E2 extends ErrorBase = ErrorBase>(fn: (input: T) => Result<O, E | E2>): Result<O, E | E2> {\n        if (this._state.status === 'success') {\n            return fn(this._state.value);\n        }\n        return Result.err<E>(this._state.error);\n    }\n\n    /**\n     * @yields the current Result, and if it is successful, returns its value.\n     * This allows using Result instances in generator functions to simplify error handling and propagation.\n     * @example\n     * function* example(): Generator<Result<number>, number, any> {\n     *     const result1 = yield* Result.ok(5);\n     *     const result2 = yield* Result.ok(10);\n     *     return result1 + result2;\n     * }\n     */\n    *[Symbol.iterator](): Generator<Result<T, E>, T, any> {\n        yield this;\n\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        return undefined as T;\n    }\n\n    /**\n     * Runs a generator function that yields Result instances, propagating errors automatically.\n     * If any yielded Result is an error, the execution stops and the error is returned.\n     * If all yielded Results are successful, returns a successful Result with the final returned value.\n     * \n     * This serves the same purpose as chain/flatChain, but allows for a more linear and readable style of coding.\n     * Think of it as \"async/await\" but for Result handling in generator functions.\n     * \n     * @param generator a generator function that yields Result instances\n     * @returns a Result containing either the final successful value or the first encountered error\n     * \n     * @example\n     * const result = Result.run(function* () {\n     *     const value1 = yield* Result.ok(5);\n     *     const value2 = yield* Result.ok(10);\n     *     return value1 + value2;\n     * });\n     */\n    static run<T, E extends ErrorBase = ErrorBase>(generator: () => Generator<Result<any, E>, T, any>): Result<T, E> {\n        const iterator = generator();\n        let result = iterator.next();\n\n        while (!result.done) {\n            const yielded = result.value;\n            if (yielded._state.status === 'error') {\n                return Result.err(yielded._state.error);\n            }\n            result = iterator.next(yielded._state.value);\n        }\n\n        return Result.ok(result.value);\n    }\n}\n","import { ErrorBase } from \"./error\";\nimport { Result, type ResultState } from \"./result\";\n\n/**\n * Type representing the state of an AsyncResult.\n * It can be 'idle', 'loading' with a promise, or a settled ResultState (success or error).\n */\nexport type AsyncResultState<T, E extends ErrorBase = ErrorBase> =\n    | { status: 'idle' }\n    | { status: 'loading'; promise: Promise<Result<T, E>> }\n    | ResultState<T, E>;\n\n\n/**\n * An Action is a function returning a Promise of a Result.\n */\nexport type Action<T,E extends ErrorBase = ErrorBase> = () => Promise<Result<T, E>>;\n\n/**\n * A LazyAction is an object containing a trigger function to start the action, and the AsyncResult representing the action's state.\n */\nexport type LazyAction<T, E extends ErrorBase = ErrorBase> = {\n    trigger: () => void;\n    result: AsyncResult<T, E>;\n};\n\n/**\n * A ChainStep is a function that takes an arbitrary input and returns a Result or a Promise of a Result.\n * It takes an input of type I and returns either a Result<O, E> or a Promise<Result<O, E>>.\n * \n * Used for chaining operations on AsyncResult.\n */\nexport type ChainStep<I, O, E extends ErrorBase = ErrorBase> = (input: I) => Result<O, E> | Promise<Result<O, E>>;\n\n/**\n * A FlatChainStep is a function that takes an arbitrary input and returns an AsyncResult.\n * It takes an input of type I and returns an AsyncResult<O, E>.\n * \n * Used for flat-chaining operations on AsyncResult.\n */\nexport type FlatChainStep<I, O, E extends ErrorBase = ErrorBase> = (input: I) => AsyncResult<O, E>;\n\n/**\n * Type representing a generator function that yields AsyncResult instances and returns a final value of type T.\n * \n * Used for running generators with AsyncResult.run().\n */\nexport type AsyncResultGenerator<T> = Generator<AsyncResult<any, any>, T, any>;\n\n/**\n * Type representing a listener function for AsyncResult state changes.\n */\nexport type AsyncResultListener<T, E extends ErrorBase = ErrorBase> = (result: AsyncResult<T, E>) => any;\n\n/**\n * Class representing the asynchronous result of an operation that can be idle, loading, successful, or failed.\n * Provides methods for listening to state changes, updating state, chaining operations, and converting to and from promises.\n * @class AsyncResult\n * @template T - The type of the successful result value.\n * @template E - The type of the error, extending ErrorBase (default is ErrorBase).\n */\nexport class AsyncResult<T, E extends ErrorBase = ErrorBase> {\n    private _state: AsyncResultState<T, E>;\n    private _listeners: Set<AsyncResultListener<T, E>> = new Set();\n\n    constructor(state?: AsyncResultState<T, E>) {\n        this._state = state || { status: 'idle' };\n    }\n\n\n\n    // === Getting current state ===\n\n    /**\n     * Returns the internal state of the AsyncResult.\n     */\n    get state() {\n        return this._state;\n    }\n\n    /**\n     * Checks if the AsyncResult is successful.\n     * @returns whether or not the result is successful\n     */\n    isSuccess() {\n        return this._state.status === 'success';\n    }\n\n    /**\n     * Checks if the AsyncResult is an error.\n     * @returns whether or not the result is an error\n     */\n    isError() {\n        return this._state.status === 'error';\n    }\n\n    /**\n     * Checks if the AsyncResult is idle.\n     * @returns whether or not the result is idle\n     */\n    isIdle() {\n        return this._state.status === 'idle';\n    }\n\n    /**\n     * Checks if the AsyncResult is loading.\n     * @returns whether or not the result is loading\n     */\n    isLoading() {\n        return this._state.status === 'loading';\n    }\n\n\n\n    // === Unwrapping values ===\n\n    /**\n     * Returns the successful value if the AsyncResult is in a success state, otherwise returns null.\n     * @returns the successful value or null\n     */\n    unwrapOrNull(): T | null {\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        return null;\n    }\n\n    /**\n     * Returns the successful value if the AsyncResult is in a success state, otherwise throws an error.\n     * @returns the successful value\n     * @throws an normal JS Error if the result is not successful\n     */\n    unwrapOrThrow(): T {\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        throw new Error('Tried to unwrap an AsyncResult that is not successful');\n    }\n\n\n\n    // === Creating/updating from settled values ===\n\n    private set state(newState: AsyncResultState<T, E>) {\n        this._state = newState;\n        this._listeners.forEach((listener) => listener(this));\n    }\n\n    private setState(newState: AsyncResultState<T, E>) {\n        this.state = newState;\n    }\n\n    /**\n     * Creates a successful AsyncResult with the given value.\n     * @param value the result of the successful operation\n     * @returns a successful AsyncResult\n     */\n    static ok<T>(value: T): AsyncResult<T, never> {\n        return new AsyncResult<T, never>({ status: 'success', value });\n    }\n\n    /**\n     * Creates an error AsyncResult with the given error.\n     * @param error the error of the failed operation\n     * @returns an error AsyncResult\n     */\n    static err<E extends ErrorBase = ErrorBase>(error: E): AsyncResult<never, E> {\n        return new AsyncResult<never, E>({ status: 'error', error });\n    }\n\n    /**\n     * Creates an error AsyncResult with a new ErrorBase constructed from the given parameters.\n     * @param code the error code\n     * @param message the error message (optional)\n     * @param thrownError the original error object, if any (optional)\n     * @param log whether to log the error upon creation (default is true)\n     * @returns an error AsyncResult\n     */\n    static errTag(code: string, message?: string, thrownError?: unknown, log: boolean = true): AsyncResult<never, ErrorBase> {\n        const error = new ErrorBase(code, message, thrownError, log);\n        return AsyncResult.err(error);\n    }\n\n    /**\n     * Updates the AsyncResult to a successful state with the given value.\n     * Like AsyncResult.ok, but in place.\n     * @param value the successful value\n     */\n    updateFromValue(value: T) {\n        this.state = { status: 'success', value };\n        return this;\n    }\n\n    /**\n     * Updates the AsyncResult to an error state with the given error.\n     * Like AsyncResult.err, but in place.\n     * @param error the error\n     */\n    updateFromError(error: E) {\n        this.state = { status: 'error', error };\n        return this;\n    }\n\n\n\n    // === Creating/updating from promises ===\n\n    /**\n     * Creates an AsyncResult from a promise that resolves to a value.\n     * The AsyncResult is initially in a loading state, and updates to a successful state once the promise resolves.\n     * If the promise rejects, the AsyncResult is updated to an error state with the caught error.\n     * \n     * Like AsyncResult.fromResultPromise, but for promise that only resolves to a successful value and not a Result.\n     * \n     * @param promise the promise that resolves to a value\n     * @returns an AsyncResult representing the state of the promise\n     */\n    static fromValuePromise<T, E extends ErrorBase = ErrorBase>(promise: Promise<T>): AsyncResult<T, E> {\n        const result = new AsyncResult<T, E>();\n        result.updateFromValuePromise(promise);\n        return result;\n    }\n\n    /**\n     * Updates the AsyncResult to a loading state with the given promise.\n     * The AsyncResult is initially in a loading state, and updates to a successful state once the promise resolves.\n     * If the promise rejects, the AsyncResult is updated to an error state with the caught error.\n     * \n     * Like AsyncResult.fromValuePromise, but in place.\n     * \n     * @param promise the promise that resolves to a value\n     */\n    updateFromValuePromise(promise: Promise<T>) {\n        const resultStatePromise = async (): Promise<Result<T, E>> => {\n            try {\n                const value = await promise;\n                return Result.ok(value);\n            } catch (error) {\n                return Result.err(error as E);\n            }\n        };\n        return this.updateFromResultPromise(resultStatePromise());\n    }\n\n\n    // === Waiting for settled state and get result ===\n\n    /**\n     * Waits for the AsyncResult to settle (either success or error) if it is currently loading.\n     * @returns itself once settled\n     */\n    async waitForSettled(): Promise<AsyncResult<T, E>> {\n        if (this._state.status === 'loading') {\n            try {\n                const value = await this._state.promise;\n                this._state = value.state;\n            } catch (error) {\n                this._state = { status: 'error', error: error as E };\n            }\n        }\n        return this;\n    }\n\n    /**\n     * Waits for the AsyncResult to settle (either success or error) if it is currently loading, and returns a Result representing the settled state.\n     * @returns a Result representing the settled state\n     */\n    async toResultPromise(): Promise<Result<T, E>> {\n        const settled = await this.waitForSettled();\n        if (settled.state.status === 'idle' || settled.state.status === 'loading') {\n            throw new Error('Cannot convert idle or loading AsyncResult to ResultState');\n        }\n        if (settled.state.status === 'error') {\n            return Result.err(settled.state.error);\n        }\n        return Result.ok(settled.state.value);\n    }\n\n    /**\n     * Waits for the AsyncResult to settle (either success or error) if it is currently loading, and returns the successful value or throws an error.\n     * @returns the successful value\n     * @throws an normal JS Error if the result is not successful\n     */\n    async toValueOrThrowPromise(): Promise<T> {\n        const settled = await this.waitForSettled();\n        return settled.unwrapOrThrow();\n    }\n\n    /**\n     * Waits for the AsyncResult to settle (either success or error) if it is currently loading, and returns the successful value or null.\n     * @returns either the successful value or null\n     */\n    async toValueOrNullPromise(): Promise<T | null> {\n        const settled = await this.waitForSettled();\n        return settled.unwrapOrNull();\n    }\n\n    /**\n     * Creates an AsyncResult from a promise that resolves to a Result.\n     * The AsyncResult is initially in a loading state, and updates to the settled state once the promise resolves.\n     * If the promise rejects, the AsyncResult is updated to an error state with a default ErrorBase.\n     * \n     * @param promise the promise that resolves to a Result\n     * @returns an AsyncResult representing the state of the promise\n     */\n    static fromResultPromise<T, E extends ErrorBase = ErrorBase>(promise: Promise<Result<T, E>>): AsyncResult<T, E> {\n        const result = new AsyncResult<T, E>();\n        result.updateFromResultPromise(promise);\n        return result;\n    }\n\n    /**\n     * Updates the AsyncResult to a loading state with the given promise.\n     * The promise must produce a Result once settled (meaning it should return the error in the result when possible).\n     * If the promise rejects, the AsyncResult is updated to an error state with a default ErrorBase.\n     * \n     * Like AsyncResult.fromResultPromise, but in place.\n     * \n     * @param promise the promise that resolves to a Result\n     */\n    updateFromResultPromise(promise: Promise<Result<T, E>>) {\n        this.state = { status: 'loading', promise };\n        promise\n            .then((res) => {\n                this.state = res.state;\n            })\n            .catch((error) => {\n                this.updateFromError(new ErrorBase('defect_on_updateFromResultPromise', 'The promise provided to AsyncResult rejected', error) as E);\n            });\n        return this;\n    }\n\n\n    // === Listeners ===\n\n    /**\n     * Adds a listener that is called whenever the AsyncResult state changes.\n     * @param listener the listener function to add\n     * @param immediate whether to call the listener immediately with the current state (default is true)\n     * @returns a function to remove the listener\n     */\n    listen(listener: AsyncResultListener<T, E>, immediate = true) {\n        this._listeners.add(listener);\n        if (immediate) {\n            listener(this);\n        }\n\n        return () => {\n            this._listeners.delete(listener);\n        };\n    }\n\n    /**\n     * Adds a listener that is called whenever the AsyncResult state changes, and automatically unsubscribes once it is settled (success or error).\n     * @param listener the listener function to add\n     * @param immediate whether to call the listener immediately with the current state (default is true)\n     * @returns a function to remove the listener\n     */\n    listenUntilSettled(listener: AsyncResultListener<T, E>, immediate = true) {\n        const unsub = this.listen((result) => {\n            listener(result);\n            if (result.state.status === 'success' || result.state.status === 'error') {\n                unsub();\n            }\n        }, immediate);\n\n        return unsub;\n    }\n\n    // === Mirroring ===\n\n    /**\n     * Mirrors the state of another AsyncResult into this one.\n     * Whenever the other AsyncResult changes state, this AsyncResult is updated to match.\n     * @param other the AsyncResult to mirror\n     * @returns a function to stop mirroring\n     */\n    mirror(other: AsyncResult<T, E>) {\n        return other.listen((newState) => {\n            this.setState(newState.state);\n        }, true);\n    }\n\n    /**\n     * Mirrors the state of another AsyncResult into this one, until the other AsyncResult is settled (success or error).\n     * Whenever the other AsyncResult changes state, this AsyncResult is updated to match, until the other AsyncResult is settled.\n     * @param other the AsyncResult to mirror\n     * @returns a function to stop mirroring\n     */\n    mirrorUntilSettled(other: AsyncResult<T, E>) {\n        return other.listenUntilSettled((newState) => {\n            this.setState(newState.state);\n        }, true);\n    }\n\n\n    // === Actions ===\n\n    /**\n     * Creates a LazyAction that can be triggered to run the given Action.\n     * @param action the Action to run when triggered\n     * @returns an object containing the trigger function and the associated AsyncResult\n     */\n    static makeLazyAction<T, E extends ErrorBase = ErrorBase>(action: Action<T, E>): LazyAction<T, E> {\n        const result = new AsyncResult<T, E>();\n        const trigger = () => {\n            result.updateFromResultPromise(action());\n        };\n\n        return { trigger, result };\n    }\n\n    // === Chaining ===\n\n    /**\n     * Chains the current AsyncResult with another operation that returns a Result or a Promise of a Result.\n     * \n     * If the current AsyncResult is loading, waits for it to settle first, then applies the provided function to its value.\n     * If the current AsyncResult is successful, applies the provided function to its value.\n     * Otherwise, returns the current error.\n     * \n     * Useful to describe a sequence of operations that can each fail, and short-circuit on the first failure.\n     * \n     * @param fn a function taking as input the successful value of the result, and returning a Result or a Promise of a Result describing the result of its own operation\n     * @returns a new AsyncResult that has either the successful value of the operation, or either the error of the current result or the error returned by fn\n     */\n    chain<O, E2 extends ErrorBase = ErrorBase>(fn: ChainStep<T, O, E | E2>): AsyncResult<O, E | E2> {\n        const newResultBuilder = async (): Promise<Result<O, E | E2>> => {\n            const settled = await this.waitForSettled();\n            if (settled.state.status === 'loading' || settled.state.status === 'idle') {\n                throw new Error('Unexpected state after waitForSettled'); // TODO handle this case properly\n            }\n            if (settled.state.status === 'error') {\n                return Result.err(settled.state.error);\n            }\n\n            return fn(settled.state.value);\n        };\n\n        return AsyncResult.fromResultPromise<O, E | E2>(newResultBuilder());\n    }\n\n    /**\n     * Chains the current AsyncResult with another operation that returns an AsyncResult.\n     * \n     * If the current AsyncResult is loading, waits for it to settle first, then applies the provided function to its value.\n     * If the current AsyncResult is successful, applies the provided function to its value.\n     * Otherwise, returns the current error.\n     * \n     * Useful to describe a sequence of operations that can each fail, and short-circuit on the first failure.\n     * \n     * Like chain, but for functions returning AsyncResult instead of Result.\n     * \n     * @param fn a function taking as input the successful value of the result, and returning an AsyncResult describing the result of its own operation\n     * @returns a new AsyncResult that has either the successful value of the operation, or either the error of the current result or the error returned by fn\n     */\n    flatChain<O, E2 extends ErrorBase = ErrorBase>(fn: FlatChainStep<T, O, E | E2>): AsyncResult<O, E | E2> {\n        const newResultBuilder = async (): Promise<Result<O, E | E2>> => {\n            const settled = await this.toResultPromise();\n            if (settled.state.status === 'error') {\n                return Result.err(settled.state.error);\n            }\n\n            const nextAsyncResult = fn(settled.state.value);\n            const nextSettled = await nextAsyncResult.toResultPromise();\n            return nextSettled;\n        }\n\n        return AsyncResult.fromResultPromise<O, E | E2>(newResultBuilder());\n    }\n\n    // pipeParallel PipeFunction[] -> AsyncResult<T, E>[]\n    // pipeParallelAndCollapse PipeFunction[] -> AsyncResult<T[], E>\n\n    /**\n     * Ensures that all provided AsyncResults are successful.\n     * If all are successful, returns an AsyncResult containing an array of their values.\n     * If any AsyncResult is an error, returns an AsyncResult with the first encountered error.\n     * @param results an array of AsyncResults to check\n     * @returns an AsyncResult containing either an array of successful values or the first encountered error\n     */\n    static ensureAvailable<R extends readonly AsyncResult<any, any>[]>(results: R): AsyncResult<{ [K in keyof R]: R[K] extends AsyncResult<infer T, any> ? T : never }, R[number] extends AsyncResult<any, infer E> ? E : never> {\n        if (results.length === 0) {\n            // empty case — TS infers void tuple, so handle gracefully\n            return AsyncResult.ok(undefined as never);\n        }\n\n        const promise = Promise.all(results.map((r) => r.waitForSettled())).then(\n            (settledResults) => {\n                for (const res of settledResults) {\n                    if (res.state.status === 'error') {\n                        return Result.err(res.state.error);\n                    }\n                }\n\n                const values = settledResults.map((r) => r.unwrapOrNull()!) as {\n                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                    [K in keyof R]: R[K] extends AsyncResult<infer T, any>\n                    ? T\n                    : never;\n                };\n\n                return Result.ok(values);\n            }\n        );\n\n        return AsyncResult.fromResultPromise(promise);\n    }\n\n    // === Generator support ===\n\n    /**\n     * Yields the current AsyncResult, and if it is successful, returns its value.\n     * This allows using AsyncResult instances in generator functions to simplify error handling and propagation.\n     * @example\n     * function* example(): Generator<AsyncResult<number>, number, any> {\n     *     const result1 = yield* AsyncResult.ok(5);\n     *     const result2 = yield* AsyncResult.ok(10);\n     *     return result1 + result2;\n     * }\n     */\n    *[Symbol.iterator](): Generator<AsyncResult<T, E>, T, any> {\n        yield this;\n\n        if (this._state.status === 'success') {\n            return this._state.value;\n        }\n        return undefined as T;\n    }\n\n    private static _runGeneratorProcessor<T, E extends ErrorBase>(iterator: AsyncResultGenerator<T>): () => Promise<Result<T, E>> {\n        return async (): Promise<Result<T, E>> => {\n            let result = iterator.next();\n\n            while (!result.done) {\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                const yielded = result.value as AsyncResult<any, E>;\n                const settled = await yielded.toResultPromise();\n                if (settled.state.status === 'error') {\n                    return Result.err(settled.state.error);\n                }\n                result = iterator.next(settled.state.value);\n            }\n\n            return Result.ok(result.value);\n        }\n    }\n\n    /**\n     * Runs a generator function that yields AsyncResult instances, propagating errors automatically.\n     * If any yielded AsyncResult is an error, the execution stops and the error is returned.\n     * If all yielded AsyncResults are successful, returns a successful AsyncResult with the final returned value.\n     * \n     * This serves the same purpose as chain/flatChain, but allows for a more linear and readable style of coding.\n     * Think of it as \"async/await\" but for AsyncResult handling in generator functions.\n     * \n     * @param generatorFunc a generator function that yields AsyncResult instances\n     * @returns a AsyncResult containing either the final successful value or the first encountered error\n     * \n     * @example\n     * const result = AsyncResult.run(function* () {\n     *     const value1 = yield* AsyncResult.ok(5);\n     *     const value2 = yield* AsyncResult.ok(10);\n     *     return value1 + value2;\n     * }\n     */\n    static run<T, E extends ErrorBase = ErrorBase>(generatorFunc: () => AsyncResultGenerator<T>): AsyncResult<T, E> {\n        const iterator = generatorFunc();\n        return AsyncResult.fromResultPromise<T, E>(AsyncResult._runGeneratorProcessor<T, E>(iterator)());\n    }\n\n\n    /**\n     * Runs a generator function that yields AsyncResult instances, propagating errors automatically, and updates this AsyncResult in place.\n     * If any yielded AsyncResult is an error, the execution stops and this AsyncResult is updated to that error.\n     * If all yielded AsyncResults are successful, this AsyncResult is updated to a successful state with the final returned value.\n     * \n     * This serves the same purpose as chain/flatChain, but allows for a more linear and readable style of coding.\n     * Think of it as \"async/await\" but for AsyncResult handling in generator functions.\n     * \n     * @param generatorFunc a generator function that yields AsyncResult instances\n     */\n    runInPlace(generatorFunc: () => AsyncResultGenerator<T>) {\n        const iterator = generatorFunc();\n        return this.updateFromResultPromise(AsyncResult._runGeneratorProcessor<T, E>(iterator)());\n    }\n\n\n    // === Debuging ===\n\n\n    log(name?: string) {\n        const time = (new Date()).toTimeString().slice(0, 7);\n        console.log(`${name ?? \"<Anonymous AsyncResult>\"} ; State at ${time} :`, this.state);\n    }\n\n    debug(name?: string) {\n        return this.listen((r) => r.log(name));\n    }\n}\n","import { AsyncResult, type AsyncResultState, type ChainStep } from \"./asyncResult\";\nimport type { ErrorBase } from \"./error\";\n\ntype KeyedAsyncCacheRefetchOptions = {\n    policy: 'refetch' | 'if-error' | 'no-refetch';\n};\n\ntype CacheItem<P, V, E extends ErrorBase = ErrorBase> = {\n    result: AsyncResult<V, E>;\n    fetcherParams: P;\n    valid: boolean;\n    lastFetched?: number;\n    ttl?: number;\n};\n\nconst _defaultRefetchOptions: KeyedAsyncCacheRefetchOptions = { policy: 'no-refetch' };\n\nfunction defaultParamsToKey<P>(params: P): string {\n    if (typeof params === 'object') {\n        return JSON.stringify(params);\n    }\n    return String(params);\n}\n\n/**\n * A cache for asynchronous operations that maps parameter sets to their corresponding AsyncResult.\n * Supports automatic refetching based on specified policies.\n * \n * @template P - The type of the parameters used to fetch values.\n * @template V - The type of the values being fetched.\n * @template E - The type of the error, extending ErrorBase (default is ErrorBase).\n */\nexport class KeyedAsyncCache<P, V, E extends ErrorBase = ErrorBase> {\n    private _cache: Map<string, CacheItem<P, V, E>> = new Map();\n    private _fetcher: ChainStep<P, V, E>;\n    private _paramsToKey: (params: P) => string;\n    private _cacheTTL?: number;\n\n    /**\n     * Creates a new KeyedAsyncCache instance.\n     * @param fetcher the function used to fetch values based on parameters\n     * @param paramsToKey a function that converts parameters to a unique string key (default uses JSON.stringify for objects)\n     * @param cacheTTL optional time-to-live for cache entries in milliseconds\n     */\n    constructor(fetcher: ChainStep<P, V, E>, paramsToKey: (params: P) => string = defaultParamsToKey, cacheTTL: number = Infinity) {\n        this._fetcher = fetcher;\n        this._paramsToKey = paramsToKey;\n        this._cacheTTL = cacheTTL;\n    }\n\n    private makeCacheItem(result: AsyncResult<V, E>, fetcherParams: P, ttl?: number | undefined): CacheItem<P, V, E> {\n        return {\n            result,\n            fetcherParams,\n            ttl: ttl ?? this._cacheTTL,\n            valid: true,\n        };\n    }\n\n    private shouldRefetch(existingResult: CacheItem<P, V, E>, refetch: KeyedAsyncCacheRefetchOptions): boolean {\n        if (!existingResult.valid) {\n            return true;\n        }\n        if (refetch.policy === 'refetch') {\n            return true;\n        }\n        if (refetch.policy === 'if-error') {\n            return existingResult.result.state.status === 'error';\n        }\n        if (existingResult.ttl !== undefined && existingResult.lastFetched !== undefined) {\n            const now = Date.now();\n            if (now - existingResult.lastFetched > existingResult.ttl) {\n                return true;\n            }\n        }\n        return false;\n    }\n\n    private updateOrCreateCacheItemFromParams(params: P, cacheItem?: CacheItem<P, V, E>) {\n        const promise = Promise.resolve(this._fetcher(params));\n        let result = cacheItem?.result.updateFromResultPromise(promise) ?? AsyncResult.fromResultPromise(promise);\n        cacheItem = cacheItem ?? this.makeCacheItem(result, params);\n        \n        promise.then(() => {\n            cacheItem.lastFetched = Date.now();\n        });\n\n        return cacheItem;\n    }\n\n    /**\n     * Gets the AsyncResult for the given parameters, fetching it if not cached or if refetching is required.\n     * @param params the parameters to fetch the value\n     * @param refetch options determining whether to refetch the value\n     * @returns the AsyncResult corresponding to the given parameters\n     */\n    get(params: P, refetch: KeyedAsyncCacheRefetchOptions = _defaultRefetchOptions): AsyncResult<V, E> {\n        const key = this._paramsToKey(params);\n        if (this._cache.has(key)) {\n            const cacheItem = this._cache.get(key)!;\n            if (!this.shouldRefetch(cacheItem, refetch)) {\n                return cacheItem.result;\n            } else {\n                this.updateOrCreateCacheItemFromParams(params, cacheItem);\n                return cacheItem.result;\n            }\n        }\n        \n        const cacheItem = this.updateOrCreateCacheItemFromParams(params);\n        this._cache.set(key, cacheItem);\n        return cacheItem.result;\n    }\n\n    /**\n     * Gets the settled state of the AsyncResult for the given parameters, fetching it if not cached or if refetching is required.\n     * Waits for the AsyncResult to settle before returning its state.\n     * @param params the parameters to fetch the value\n     * @param refetch options determining whether to refetch the value\n     * @returns a promise resolving to the settled state of the AsyncResult\n     */\n    async getSettledState(params: P, refetch: KeyedAsyncCacheRefetchOptions = _defaultRefetchOptions): Promise<AsyncResultState<V, E>> {\n        const asyncResult = this.get(params, refetch);\n        await asyncResult.waitForSettled();\n        return asyncResult.state;\n    }\n\n    /**\n     * Checks if any cached AsyncResult is currently loading.\n     * @returns whether any cached AsyncResult is loading\n     */\n    anyLoading(): boolean {\n        for (const cacheItem of this._cache.values()) {\n            if (cacheItem.result.isLoading()) {\n                return true;\n            }\n        }\n        return false;\n    }\n\n    /**\n     * Clears the entire cache.\n     */\n    clear() {\n        this._cache.clear();\n    }\n\n    /**\n     * Invalidates the cache entry for the given key.\n     * @param key the key of the cache entry to invalidate\n     */\n    invalidateKey(key: string) {\n        if (this._cache.has(key)) {\n            const cacheItem = this._cache.get(key)!;\n            cacheItem.valid = false;\n        }\n    }\n\n    /**\n     * Invalidates the cache entry for the given parameters.\n     * @param params the parameters of the cache entry to invalidate\n     */\n    invalidateParams(params: P) {\n        const key = this._paramsToKey(params);\n        this.invalidateKey(key);\n    }\n\n    /**\n     * Invalidates all cache entries.\n     */\n    invalidateAll() {\n        for (const cacheItem of this._cache.values()) {\n            cacheItem.valid = false;\n        }\n    }\n}\n"],"mappings":"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","names":["cacheItem"]}

package/dist/vue/index.d.mts

@@ -1,34 +1,107 @@
 import * as vue from 'vue';
 import { Ref, WatchSource, VNode } from 'vue';
-import { AsyncResult, FlatChainFunction, Result } from 'unwrapped/core';
+import { ErrorBase, AsyncResult, Result, FlatChainStep, Action, AsyncResultGenerator } from 'unwrapped/core';
 
-declare function useAsyncResultRef<T, E>(asyncResult: AsyncResult<T, E>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
-declare function useReactiveResult<T, E, Inputs>(source: WatchSource<Inputs>, pipe: FlatChainFunction<Inputs, T, E>, options?: {
+interface ReactiveProcessOptions {
     immediate: boolean;
-}): Ref<AsyncResult<T, E>>;
-declare function useAsyncResultRefFromPromise<T, E>(promise: Promise<Result<T, E>>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
-type Action<T, E> = () => Promise<Result<T, E>>;
-declare function useImmediateAction<T, E>(action: Action<T, E>): Ref<AsyncResult<T, E>>;
-interface LazyActionReturn<T, E> {
+}
+/**
+ * Makes a ref to the given AsyncResult. Whenever the state of the AsyncResult changes,
+ * the ref gets retriggered, making those changes visible to Vue's reactivity system.
+ *
+ * @param asyncResult the result to make reactive
+ * @returns the ref to the result
+ */
+declare function useAsyncResultRef<T, E extends ErrorBase = ErrorBase>(asyncResult: AsyncResult<T, E>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
+/**
+ * Creates an AsyncResult ref from a promise returning a Result.
+ * @param promise the promise returning a Result
+ * @returns the ref to the AsyncResult
+ */
+declare function useAsyncResultRefFromPromise<T, E extends ErrorBase = ErrorBase>(promise: Promise<Result<T, E>>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
+/**
+ * Watches a source, gives it as inputs to the function provided, and updates the result contained in the ref accordingly.
+ *
+ * @param source the inputs to react to
+ * @param pipe the function to run when the inputs change
+ * @param options optional settings
+ * @returns ref to the result
+ */
+declare function useReactiveChain<Inputs, T, E extends ErrorBase = ErrorBase>(source: WatchSource<Inputs>, pipe: FlatChainStep<Inputs, T, E>, options?: ReactiveProcessOptions): Ref<AsyncResult<T, E>>;
+/**
+ * The return type of useLazyAction.
+ */
+interface LazyActionRef<T, E extends ErrorBase = ErrorBase> {
     resultRef: Ref<AsyncResult<T, E>>;
     trigger: () => void;
 }
-declare function useLazyAction<T, E>(action: Action<T, E>): LazyActionReturn<T, E>;
-declare function useReactiveAction<I, O, E>(input: I | Ref<I> | (() => I), pipe: FlatChainFunction<I, O, E>, options?: {
-    immediate: boolean;
-}): Ref<AsyncResult<O, E>>;
-declare function useGenerator<T>(generatorFunc: () => Generator<AsyncResult<any, any>, T, any>): Ref<AsyncResult<T, any>>;
-declare function useLazyGenerator<T>(generatorFunc: () => Generator<AsyncResult<any, any>, T, any>): {
+/**
+ * Executes an action immediately and returns a ref to the AsyncResult representing the action's state.
+ *
+ * Same as useAsyncResultRefFromPromise(action()).
+ *
+ * @param action the action to execute immediately
+ * @returns a ref to the AsyncResult representing the action's state
+ */
+declare function useAction<T, E extends ErrorBase = ErrorBase>(action: Action<T, E>): Ref<AsyncResult<T, E>>;
+/**
+ * Creates a lazy action that can be triggered manually.
+ *
+ * Same as AsyncResult.makeLazyAction(action), but the AsyncResult is wrapped in a ref for Vue reactivity.
+ *
+ * @param action the action to execute when triggered
+ * @returns an object containing a ref to the AsyncResult and a trigger function
+ */
+declare function useLazyAction<T, E extends ErrorBase = ErrorBase>(action: Action<T, E>): LazyActionRef<T, E>;
+/**
+ * Runs a generator function immediately and returns a ref to the AsyncResult representing the generator's state.
+ * @param generatorFunc the generator function to run immediately
+ * @returns a ref to the AsyncResult representing the generator's state
+ */
+declare function useGenerator<T>(generatorFunc: () => AsyncResultGenerator<T>): Ref<AsyncResult<T, any>>;
+/**
+ * Creates a lazy generator that can be triggered manually.
+ *
+ * @param generatorFunc the generator function to run when triggered
+ * @returns an object containing a ref to the AsyncResult and a trigger function
+ */
+declare function useLazyGenerator<T>(generatorFunc: () => AsyncResultGenerator<T>): {
     resultRef: Ref<AsyncResult<T, any>>;
     trigger: () => void;
 };
-declare function useReactiveGenerator<T, E, Inputs>(source: WatchSource<Inputs>, generatorFunc: (args: Inputs) => Generator<AsyncResult<any, any>, T, any>, options?: {
-    immediate: boolean;
-}): Ref<AsyncResult<T, E>>;
+/**
+ * Watches a source, gives it as inputs to the generator function provided, and updates the result contained in the ref accordingly.
+ *
+ * @param source the inputs to react to
+ * @param generatorFunc the generator function to run when the inputs change
+ * @param options optional settings
+ * @returns ref to the result
+ */
+declare function useReactiveGenerator<Inputs, T, E extends ErrorBase = ErrorBase>(source: WatchSource<Inputs>, generatorFunc: (args: Inputs) => AsyncResultGenerator<T>, options?: ReactiveProcessOptions): Ref<AsyncResult<T, E>>;
 
+/**
+ * A Vue component that displays different content based on the state of an AsyncResult.
+ * It supports slots for 'loading', 'error', 'success' (default), and 'idle' states.
+ *
+ * @example
+ * <AsyncResultLoader :result="myAsyncResult">
+ *   <template #loading>
+ *     <div>Loading data...</div>
+ *   </template>
+ *   <template #error="{ error }">
+ *     <div>Error occurred: {{ error.message }}</div>
+ *   </template>
+ *   <template #default="{ value }">
+ *     <div>Data loaded: {{ value }}</div>
+ *   </template>
+ *   <template #idle>
+ *     <div>Waiting to start...</div>
+ *   </template>
+ * </AsyncResultLoader>
+ */
 declare const AsyncResultLoader: vue.DefineComponent<vue.ExtractPropTypes<{
     result: {
-        type: () => AsyncResult<unknown, unknown>;
+        type: () => AsyncResult<unknown>;
         required: true;
     };
 }>, () => VNode<vue.RendererNode, vue.RendererElement, {
@@ -37,17 +110,25 @@ declare const AsyncResultLoader: vue.DefineComponent<vue.ExtractPropTypes<{
     [key: string]: any;
 }>[] | null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     result: {
-        type: () => AsyncResult<unknown, unknown>;
+        type: () => AsyncResult<unknown>;
         required: true;
     };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
-interface CustomSlots<E> {
+interface CustomSlots<E extends ErrorBase = ErrorBase> {
     loading?: () => VNode;
     error?: (props: {
         error: E;
     }) => VNode;
 }
-declare function buildCustomAsyncResultLoader<T, E>(slots: CustomSlots<E>): vue.DefineComponent<vue.ExtractPropTypes<{
+/**
+ * Builds a custom AsyncResultLoader component with predefined slots for loading and error states.
+ *
+ * Useful for creating reusable components with consistent loading and error handling UI (eg. framework-specific spinners, etc...).
+ *
+ * @param slots the custom slots for loading and error states
+ * @returns a Vue component that uses the provided slots
+ */
+declare function buildCustomAsyncResultLoader<T, E extends ErrorBase = ErrorBase>(slots: CustomSlots<E>): vue.DefineComponent<vue.ExtractPropTypes<{
     result: {
         type: () => AsyncResult<T, E>;
         required: true;
@@ -61,4 +142,4 @@ declare function buildCustomAsyncResultLoader<T, E>(slots: CustomSlots<E>): vue.
     };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
-export { type Action, AsyncResultLoader, type LazyActionReturn, buildCustomAsyncResultLoader, useAsyncResultRef, useAsyncResultRefFromPromise, useGenerator, useImmediateAction, useLazyAction, useLazyGenerator, useReactiveAction, useReactiveGenerator, useReactiveResult };
+export { AsyncResultLoader, type LazyActionRef, buildCustomAsyncResultLoader, useAction, useAsyncResultRef, useAsyncResultRefFromPromise, useGenerator, useLazyAction, useLazyGenerator, useReactiveChain, useReactiveGenerator };

package/dist/vue/index.d.ts

@@ -1,34 +1,107 @@
 import * as vue from 'vue';
 import { Ref, WatchSource, VNode } from 'vue';
-import { AsyncResult, FlatChainFunction, Result } from 'unwrapped/core';
+import { ErrorBase, AsyncResult, Result, FlatChainStep, Action, AsyncResultGenerator } from 'unwrapped/core';
 
-declare function useAsyncResultRef<T, E>(asyncResult: AsyncResult<T, E>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
-declare function useReactiveResult<T, E, Inputs>(source: WatchSource<Inputs>, pipe: FlatChainFunction<Inputs, T, E>, options?: {
+interface ReactiveProcessOptions {
     immediate: boolean;
-}): Ref<AsyncResult<T, E>>;
-declare function useAsyncResultRefFromPromise<T, E>(promise: Promise<Result<T, E>>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
-type Action<T, E> = () => Promise<Result<T, E>>;
-declare function useImmediateAction<T, E>(action: Action<T, E>): Ref<AsyncResult<T, E>>;
-interface LazyActionReturn<T, E> {
+}
+/**
+ * Makes a ref to the given AsyncResult. Whenever the state of the AsyncResult changes,
+ * the ref gets retriggered, making those changes visible to Vue's reactivity system.
+ *
+ * @param asyncResult the result to make reactive
+ * @returns the ref to the result
+ */
+declare function useAsyncResultRef<T, E extends ErrorBase = ErrorBase>(asyncResult: AsyncResult<T, E>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
+/**
+ * Creates an AsyncResult ref from a promise returning a Result.
+ * @param promise the promise returning a Result
+ * @returns the ref to the AsyncResult
+ */
+declare function useAsyncResultRefFromPromise<T, E extends ErrorBase = ErrorBase>(promise: Promise<Result<T, E>>): Ref<AsyncResult<T, E>, AsyncResult<T, E>>;
+/**
+ * Watches a source, gives it as inputs to the function provided, and updates the result contained in the ref accordingly.
+ *
+ * @param source the inputs to react to
+ * @param pipe the function to run when the inputs change
+ * @param options optional settings
+ * @returns ref to the result
+ */
+declare function useReactiveChain<Inputs, T, E extends ErrorBase = ErrorBase>(source: WatchSource<Inputs>, pipe: FlatChainStep<Inputs, T, E>, options?: ReactiveProcessOptions): Ref<AsyncResult<T, E>>;
+/**
+ * The return type of useLazyAction.
+ */
+interface LazyActionRef<T, E extends ErrorBase = ErrorBase> {
     resultRef: Ref<AsyncResult<T, E>>;
     trigger: () => void;
 }
-declare function useLazyAction<T, E>(action: Action<T, E>): LazyActionReturn<T, E>;
-declare function useReactiveAction<I, O, E>(input: I | Ref<I> | (() => I), pipe: FlatChainFunction<I, O, E>, options?: {
-    immediate: boolean;
-}): Ref<AsyncResult<O, E>>;
-declare function useGenerator<T>(generatorFunc: () => Generator<AsyncResult<any, any>, T, any>): Ref<AsyncResult<T, any>>;
-declare function useLazyGenerator<T>(generatorFunc: () => Generator<AsyncResult<any, any>, T, any>): {
+/**
+ * Executes an action immediately and returns a ref to the AsyncResult representing the action's state.
+ *
+ * Same as useAsyncResultRefFromPromise(action()).
+ *
+ * @param action the action to execute immediately
+ * @returns a ref to the AsyncResult representing the action's state
+ */
+declare function useAction<T, E extends ErrorBase = ErrorBase>(action: Action<T, E>): Ref<AsyncResult<T, E>>;
+/**
+ * Creates a lazy action that can be triggered manually.
+ *
+ * Same as AsyncResult.makeLazyAction(action), but the AsyncResult is wrapped in a ref for Vue reactivity.
+ *
+ * @param action the action to execute when triggered
+ * @returns an object containing a ref to the AsyncResult and a trigger function
+ */
+declare function useLazyAction<T, E extends ErrorBase = ErrorBase>(action: Action<T, E>): LazyActionRef<T, E>;
+/**
+ * Runs a generator function immediately and returns a ref to the AsyncResult representing the generator's state.
+ * @param generatorFunc the generator function to run immediately
+ * @returns a ref to the AsyncResult representing the generator's state
+ */
+declare function useGenerator<T>(generatorFunc: () => AsyncResultGenerator<T>): Ref<AsyncResult<T, any>>;
+/**
+ * Creates a lazy generator that can be triggered manually.
+ *
+ * @param generatorFunc the generator function to run when triggered
+ * @returns an object containing a ref to the AsyncResult and a trigger function
+ */
+declare function useLazyGenerator<T>(generatorFunc: () => AsyncResultGenerator<T>): {
     resultRef: Ref<AsyncResult<T, any>>;
     trigger: () => void;
 };
-declare function useReactiveGenerator<T, E, Inputs>(source: WatchSource<Inputs>, generatorFunc: (args: Inputs) => Generator<AsyncResult<any, any>, T, any>, options?: {
-    immediate: boolean;
-}): Ref<AsyncResult<T, E>>;
+/**
+ * Watches a source, gives it as inputs to the generator function provided, and updates the result contained in the ref accordingly.
+ *
+ * @param source the inputs to react to
+ * @param generatorFunc the generator function to run when the inputs change
+ * @param options optional settings
+ * @returns ref to the result
+ */
+declare function useReactiveGenerator<Inputs, T, E extends ErrorBase = ErrorBase>(source: WatchSource<Inputs>, generatorFunc: (args: Inputs) => AsyncResultGenerator<T>, options?: ReactiveProcessOptions): Ref<AsyncResult<T, E>>;
 
+/**
+ * A Vue component that displays different content based on the state of an AsyncResult.
+ * It supports slots for 'loading', 'error', 'success' (default), and 'idle' states.
+ *
+ * @example
+ * <AsyncResultLoader :result="myAsyncResult">
+ *   <template #loading>
+ *     <div>Loading data...</div>
+ *   </template>
+ *   <template #error="{ error }">
+ *     <div>Error occurred: {{ error.message }}</div>
+ *   </template>
+ *   <template #default="{ value }">
+ *     <div>Data loaded: {{ value }}</div>
+ *   </template>
+ *   <template #idle>
+ *     <div>Waiting to start...</div>
+ *   </template>
+ * </AsyncResultLoader>
+ */
 declare const AsyncResultLoader: vue.DefineComponent<vue.ExtractPropTypes<{
     result: {
-        type: () => AsyncResult<unknown, unknown>;
+        type: () => AsyncResult<unknown>;
         required: true;
     };
 }>, () => VNode<vue.RendererNode, vue.RendererElement, {
@@ -37,17 +110,25 @@ declare const AsyncResultLoader: vue.DefineComponent<vue.ExtractPropTypes<{
     [key: string]: any;
 }>[] | null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     result: {
-        type: () => AsyncResult<unknown, unknown>;
+        type: () => AsyncResult<unknown>;
         required: true;
     };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
-interface CustomSlots<E> {
+interface CustomSlots<E extends ErrorBase = ErrorBase> {
     loading?: () => VNode;
     error?: (props: {
         error: E;
     }) => VNode;
 }
-declare function buildCustomAsyncResultLoader<T, E>(slots: CustomSlots<E>): vue.DefineComponent<vue.ExtractPropTypes<{
+/**
+ * Builds a custom AsyncResultLoader component with predefined slots for loading and error states.
+ *
+ * Useful for creating reusable components with consistent loading and error handling UI (eg. framework-specific spinners, etc...).
+ *
+ * @param slots the custom slots for loading and error states
+ * @returns a Vue component that uses the provided slots
+ */
+declare function buildCustomAsyncResultLoader<T, E extends ErrorBase = ErrorBase>(slots: CustomSlots<E>): vue.DefineComponent<vue.ExtractPropTypes<{
     result: {
         type: () => AsyncResult<T, E>;
         required: true;
@@ -61,4 +142,4 @@ declare function buildCustomAsyncResultLoader<T, E>(slots: CustomSlots<E>): vue.
     };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
-export { type Action, AsyncResultLoader, type LazyActionReturn, buildCustomAsyncResultLoader, useAsyncResultRef, useAsyncResultRefFromPromise, useGenerator, useImmediateAction, useLazyAction, useLazyGenerator, useReactiveAction, useReactiveGenerator, useReactiveResult };
+export { AsyncResultLoader, type LazyActionRef, buildCustomAsyncResultLoader, useAction, useAsyncResultRef, useAsyncResultRefFromPromise, useGenerator, useLazyAction, useLazyGenerator, useReactiveChain, useReactiveGenerator };

package/dist/vue/index.js

@@ -22,15 +22,14 @@ var index_exports = {};
 __export(index_exports, {
   AsyncResultLoader: () => AsyncResultLoader,
   buildCustomAsyncResultLoader: () => buildCustomAsyncResultLoader,
+  useAction: () => useAction,
   useAsyncResultRef: () => useAsyncResultRef,
   useAsyncResultRefFromPromise: () => useAsyncResultRefFromPromise,
   useGenerator: () => useGenerator,
-  useImmediateAction: () => useImmediateAction,
   useLazyAction: () => useLazyAction,
   useLazyGenerator: () => useLazyGenerator,
-  useReactiveAction: () => useReactiveAction,
-  useReactiveGenerator: () => useReactiveGenerator,
-  useReactiveResult: () => useReactiveResult
+  useReactiveChain: () => useReactiveChain,
+  useReactiveGenerator: () => useReactiveGenerator
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -47,7 +46,10 @@ function useAsyncResultRef(asyncResult) {
   });
   return state;
 }
-function useReactiveResult(source, pipe, options = { immediate: true }) {
+function useAsyncResultRefFromPromise(promise) {
+  return useAsyncResultRef(import_core.AsyncResult.fromResultPromise(promise));
+}
+function useReactiveChain(source, pipe, options = { immediate: true }) {
   const result = new import_core.AsyncResult();
   const resultRef = useAsyncResultRef(result);
   let unsub = null;
@@ -60,36 +62,13 @@ function useReactiveResult(source, pipe, options = { immediate: true }) {
   });
   return resultRef;
 }
-function useAsyncResultRefFromPromise(promise) {
-  return useAsyncResultRef(import_core.AsyncResult.fromResultPromise(promise));
-}
-function useImmediateAction(action) {
+function useAction(action) {
   return useAsyncResultRefFromPromise(action());
 }
 function useLazyAction(action) {
-  const result = new import_core.AsyncResult();
-  const resultRef = useAsyncResultRef(result);
-  const trigger = () => {
-    result.updateFromResultPromise(action());
-  };
-  return { resultRef, trigger };
-}
-function useReactiveAction(input, pipe, options = { immediate: true }) {
-  const source = typeof input === "function" ? (0, import_vue.computed)(input) : (0, import_vue.toRef)(input);
-  const outputRef = (0, import_vue.ref)(new import_core.AsyncResult());
-  let unsub = null;
-  (0, import_vue.watch)(source, () => {
-    unsub?.();
-    const newOutput = pipe(source.value);
-    unsub = newOutput.listen((newState) => {
-      outputRef.value.setState(newState.state);
-      (0, import_vue.triggerRef)(outputRef);
-    });
-  }, { immediate: options.immediate });
-  (0, import_vue.onUnmounted)(() => {
-    unsub?.();
-  });
-  return outputRef;
+  const lazyAction = import_core.AsyncResult.makeLazyAction(action);
+  const resultRef = useAsyncResultRef(lazyAction.result);
+  return { resultRef, trigger: lazyAction.trigger };
 }
 function useGenerator(generatorFunc) {
   const resultRef = useAsyncResultRef(import_core.AsyncResult.run(generatorFunc));
@@ -122,24 +101,17 @@ var AsyncResultLoader = (0, import_vue2.defineComponent)({
     }
   },
   setup(props, { slots }) {
-    const state = (0, import_vue2.ref)(props.result.state);
-    let unlisten = null;
-    (0, import_vue2.onUnmounted)(() => {
-      if (unlisten) unlisten();
-    });
+    let resultRef = useAsyncResultRef(props.result);
     (0, import_vue2.watch)(
       () => props.result,
-      (newResult) => {
-        if (unlisten) unlisten();
-        state.value = newResult.state;
-        unlisten = newResult.listen((res) => {
-          state.value = res.state;
-        });
+      (newResult, oldResult) => {
+        if (newResult === oldResult) return;
+        resultRef = useAsyncResultRef(newResult);
       },
       { immediate: true }
     );
     return () => {
-      const s = state.value;
+      const s = resultRef.value.state;
       switch (s.status) {
         case "loading":
           return slots.loading ? slots.loading() : (0, import_vue2.h)("div", { class: "loading" }, "Loading\u2026");