speckle-server/packages/frontend-2/lib/common/composables/async.ts

/* eslint-disable @typescript-eslint/no-explicit-any */
import { MaybeAsync } from '@speckle/shared'
import { AsyncComputedOptions, computedAsync } from '@vueuse/core'

export interface AsyncWritableComputedOptions<T> {
  get: (...args: any[]) => MaybeAsync<T>
  set: (value: T) => MaybeAsync<void>
  initialState: T
  readOptions?: AsyncComputedOptions
  asyncRead?: boolean
  debugging?: Partial<{
    log: {
      name: string
      writesOnly?: boolean
      readsOnly?: boolean
    }
  }>
}

export type AsyncWritableComputedRef<T> = ComputedRef<T> & {
  update: AsyncWritableComputedOptions<T>['set']
}

/**
 * Allows async read/write from/to computed. Use `res.value` to read and `res.update` to write. If you only need
 * the computed to be read-only then use vueuse's `computedAsync`. If you only need async writes you can
 * disable async reads through the `asyncRead` param.
 * @param params
 */
export function writableAsyncComputed<T>(
  params: AsyncWritableComputedOptions<T>
): AsyncWritableComputedRef<T> {
  const { get, initialState, readOptions, set, asyncRead = true, debugging } = params
  const logSettings = debugging?.log
  const getTrace = () => (new Error('Trace:').stack || '').substring(7)

  const finalGet: typeof get =
    logSettings && !logSettings.writesOnly
      ? () => {
          const res = get()
          console.debug(`debugging: '${logSettings.name}' read`, res, getTrace())
          return res
        }
      : get

  const finalSet: typeof set =
    logSettings && !logSettings.readsOnly
      ? (newVal) => {
          console.debug(
            `debugging: '${logSettings.name}' written to`,
            newVal,
            getTrace()
          )
          return set(newVal)
        }
      : set

  const readValue = asyncRead
    ? computedAsync(finalGet, initialState, readOptions)
    : computed(finalGet)

  const getter = computed(() => readValue.value) as AsyncWritableComputedRef<T>
  getter.update = finalSet

  return getter
}