@virtualstate/app-history/src/util/deferred.ts

Native JavaScript [app-history](https://github.com/WICG/app-history) implementation

export interface Deferred<T = void> {
  resolve(value: T): void;
  reject(reason: unknown): void;
  promise: Promise<T>;
}

/**
 * @param handleCatch rejected promises automatically to allow free usage
 */
export function deferred<T = void>(handleCatch?: (() => T | Promise<T>)): Deferred<T> {
  let resolve: Deferred<T>["resolve"] | undefined = undefined,
    reject: Deferred<T>["reject"] | undefined = undefined;
  const promise = new Promise<T>(
    (resolveFn, rejectFn) => {
      resolve = resolveFn;
      reject = rejectFn;
    }
  );
  ok(resolve);
  ok(reject);
  return {
    resolve,
    reject,
    promise: handleCatch ? (
        promise.catch(handleCatch)
    ) : promise
  };
}

function ok(value: unknown): asserts value {
  if (!value) {
    throw new Error("Value not provided");
  }
}