// Copyright 2017-2020 @polkadot/react-hooks authors & contributors // This software may be modified and distributed under the terms // of the Apache-2.0 license. See the LICENSE file for details. import { Codec } from '@polkadot/types/types'; import { CallOptions, CallParam, CallParams } from './types'; import { useEffect, useRef, useState } from 'react'; import { isNull, isUndefined } from '@polkadot/util'; import useIsMountedRef, { MountedRef } from './useIsMountedRef'; type TrackFnResult = Promise<() => void>; interface TrackFn { (...params: CallParam[]): TrackFnResult; meta?: { type: { isDoubleMap: boolean; }; }; } interface Tracker { isActive: boolean; count: number; serialized: string | null; subscriber: TrackFnResult | null; } interface TrackerRef { current: Tracker; } // the default transform, just returns what we have function transformIdentity (value: unknown): T { return value as T; } // extract the serialized and mapped params, all ready for use in our call function extractParams (fn: unknown, params: unknown[], paramMap: (params: unknown[]) => CallParams): [string, CallParams | null] { return [ JSON.stringify({ f: (fn as { name: string })?.name, p: params }), params.length === 0 || !params.some((param) => isNull(param) || isUndefined(param)) ? paramMap(params) : null ]; } // unsubscribe and remove from the tracker function unsubscribe (tracker: TrackerRef): void { tracker.current.isActive = false; if (tracker.current.subscriber) { tracker.current.subscriber.then((unsubFn) => unsubFn()).catch(console.error); tracker.current.subscriber = null; } } // subscribe, trying to play nice with the browser threads function subscribe (mountedRef: MountedRef, tracker: TrackerRef, fn: TrackFn | undefined, params: CallParams, setValue: (value: T) => void, { isSingle, transform = transformIdentity, withParams }: CallOptions): void { const validParams = params.filter((p): boolean => !isUndefined(p)); unsubscribe(tracker); setTimeout((): void => { if (mountedRef.current) { if (fn && (!fn.meta || !fn.meta.type?.isDoubleMap || validParams.length === 2)) { // swap to acive mode and reset our count tracker.current.isActive = true; tracker.current.count = 0; tracker.current.subscriber = (fn as (...params: unknown[]) => Promise<() => void>)(...params, (value: Codec): void => { // when we don't have an active sub, or single-shot, ignore (we use the isActive flag here // since .subscriber may not be set on immeditae callback) if (mountedRef.current && tracker.current.isActive && (!isSingle || !tracker.current.count)) { tracker.current.count++; mountedRef.current && tracker.current.isActive && setValue( withParams ? [params, transform(value)] as any : transform(value) ); } }); } else { tracker.current.subscriber = null; } } }, 0); } // tracks a stream, typically an api.* call (derive, rpc, query) that // - returns a promise with an unsubscribe function // - has a callback to set the value // FIXME The typings here need some serious TLC export default function useCall (fn: TrackFn | undefined | null | false, params: CallParams = [], options: CallOptions = {}): T | undefined { const mountedRef = useIsMountedRef(); const tracker = useRef({ count: 0, isActive: false, serialized: null, subscriber: null }); const [value, setValue] = useState(options.defaultValue); // initial effect, we need an un-subscription useEffect((): () => void => { return (): void => unsubscribe(tracker); }, []); // on changes, re-subscribe useEffect((): void => { // check if we have a function & that we are mounted if (mountedRef.current && fn) { const [serialized, mappedParams] = extractParams(fn, params, options.paramMap || transformIdentity); if (mappedParams && serialized !== tracker.current.serialized) { tracker.current.serialized = serialized; subscribe(mountedRef, tracker, fn, mappedParams, setValue, options); } } }, [fn, options, mountedRef, params]); return value; }