import { isUndefined, isObject, isNumber, isFunction } from '../../internal/base' import { curry } from '../../functional' import { isAtomLike, isData, isMutation, Subscription, DEFAULT_SUBSCRIBE_OPTIONS } from '../atoms' import { DataMediator, MutationMediator } from './base.mediators' import type { Datar, Mutator } from '../particles' import type { SubscribeOptions, AtomLike, DataLike, MutationLike, AtomLikeOfOutput, ValueConsumer, DatarConsumer, DataConsumer, DataSubscription, TransformationConsumer, MutatorConsumer, MutationConsumer, MutationSubscription } from '../atoms' import type { MediatorTypeMaker, MediatorType } from './base.mediators' /****************************************************************************************************** * * ReplayMediator Predicatess * ******************************************************************************************************/ /** * @param tar anything * @return { boolean } whether the target is a ReplayMediator instance */ export const isReplayMediator = (tar: any): tar is ReplayMediatorUnion => isObject(tar) && tar.isReplayMediator /****************************************************************************************************** * * ReplayMediator Classes * ******************************************************************************************************/ /** * */ export const ReplayMediatorType = '[mediator Replay]' as MediatorTypeMaker<'[mediator Replay]'> export interface ReplayMediatorOptions { replayTime?: number autoTrigger?: boolean } export const DEFAULT_REPLAY_MEDIATOR_OPTIONS: Required = { replayTime: 1, autoTrigger: true } export type ReplayMediatorUnion = ReplayDataMediator | ReplayMutationMediator /****************************************************************************************************** * * ReplayDataMediator * ******************************************************************************************************/ /** * */ export class ReplayDataMediator extends DataMediator { private _history: Array> private readonly _consumers: Set> private readonly _subscription: Subscription private _options: Required constructor ( atom: DataLike, options: ReplayMediatorOptions = DEFAULT_REPLAY_MEDIATOR_OPTIONS ) { super(atom) this._options = { ...DEFAULT_REPLAY_MEDIATOR_OPTIONS, ...options } this._history = [] this._consumers = new Set() const { replayTime } = this._options this.setReplayTime(replayTime) this._subscription = atom.subscribe((val) => { this._history.push(val) this._setHistory() }) } get type (): MediatorType { return ReplayMediatorType } get mediatorType (): MediatorType { return ReplayMediatorType } get isReplayMediator (): true { return true } static of (atom: DataLike, options?: ReplayMediatorOptions): ReplayDataMediator static of(atom: I, options?: ReplayMediatorOptions): I static of | ReplayMediatorUnion> ( atom: I, options: ReplayMediatorOptions = DEFAULT_REPLAY_MEDIATOR_OPTIONS ): ReplayMediatorUnion { if (!isAtomLike(atom)) { throw (new TypeError('"atom" is expected to be a general Atom or a ReplayMediatorUnion.')) } if (isReplayMediator(atom)) { return atom } const _options = { ...DEFAULT_REPLAY_MEDIATOR_OPTIONS, ...options } const { autoTrigger } = _options const mediator = new ReplayDataMediator(atom, _options) if (autoTrigger) { atom.trigger() } return mediator } /** * If the history is longer than the replayTime, the history will be trimmed. */ private _setHistory (): void { const delta = this._history.length - this._options.replayTime if (delta > 0) { this._history = this._history.slice(delta) } } setReplayTime (replayTime: number): void { if (!isNumber(replayTime)) { throw (new TypeError('"replayTime" is expected to be a Number.')) } this._options.replayTime = Math.floor(Math.abs(replayTime)) this._setHistory() } replayTo (consumer: DatarConsumer): void { this._history.forEach(val => { consumer(val, this._atom) }) } replay (): void { this._consumers.forEach((consumer) => { this.replayTo(consumer) }) } subscribe (consumer: DatarConsumer): DataSubscription subscribe (consumer: DatarConsumer, options: SubscribeOptions & { isExtracted: false }): DataSubscription subscribe (consumer: ValueConsumer, options: SubscribeOptions & { isExtracted: true }): DataSubscription // NOTE: catch all overload subscribe (consumer: DataConsumer, options?: SubscribeOptions): DataSubscription subscribe ( consumer: DataConsumer, options: SubscribeOptions = DEFAULT_SUBSCRIBE_OPTIONS ): DataSubscription { const subscription = this._atom.subscribe(consumer, options) const { proxyConsumer } = subscription this._consumers.add(proxyConsumer) this.replayTo(proxyConsumer) return subscription } subscribeValue ( consumer: ValueConsumer, options: SubscribeOptions = DEFAULT_SUBSCRIBE_OPTIONS ): DataSubscription { const subscription = this._atom.subscribeValue(consumer, options) const { proxyConsumer } = subscription this._consumers.add(proxyConsumer) this.replayTo(proxyConsumer) return subscription } unsubscribe (target: DataConsumer | DataSubscription | AtomLike): boolean { const subscription = (isFunction(target) || isAtomLike(target)) ? this._atom.getSubscription(target) : target let unsubscribed = false if (!isUndefined(subscription)) { unsubscribed = this._consumers.delete(subscription.proxyConsumer) && this._atom.unsubscribe(subscription) } return unsubscribed } unsubscribeAll (): boolean { this._consumers.clear() return this._atom.unsubscribeAll() } // !!! important beObservedBy (mutation: MutationLike): DataSubscription { return mutation.observe(this) } release (): void { this._subscription.unsubscribe() super.release() } } /****************************************************************************************************** * * ReplayMutationMediator * ******************************************************************************************************/ /** * */ export class ReplayMutationMediator

extends MutationMediator { private _history: Array> private readonly _consumers: Set> private readonly _subscription: Subscription private _options: Required constructor ( atom: MutationLike, options: ReplayMediatorOptions = DEFAULT_REPLAY_MEDIATOR_OPTIONS ) { super(atom) this._options = { ...DEFAULT_REPLAY_MEDIATOR_OPTIONS, ...options } this._history = [] this._consumers = new Set() const { replayTime } = this._options this.setReplayTime(replayTime) this._subscription = atom.subscribe((trans) => { this._history.push(trans) this._setHistory() }) } get type (): MediatorType { return ReplayMediatorType } get mediatorType (): MediatorType { return ReplayMediatorType } get isReplayMediator (): true { return true } static of(atom: MutationLike, options?: ReplayMediatorOptions): ReplayMutationMediator static of(atom: I, options?: ReplayMediatorOptions): I static of | ReplayMediatorUnion> ( atom: I, options: ReplayMediatorOptions = DEFAULT_REPLAY_MEDIATOR_OPTIONS ): ReplayMediatorUnion { if (!isAtomLike(atom)) { throw (new TypeError('"atom" is expected to be a general Atom or a ReplayMediatorUnion.')) } if (isReplayMediator(atom)) { return atom } const _options = { ...DEFAULT_REPLAY_MEDIATOR_OPTIONS, ...options } const { autoTrigger } = _options const mediator = new ReplayMutationMediator(atom, _options) if (autoTrigger) { atom.trigger() } return mediator } /** * If the history is longer than the replayTime, the history will be trimmed. */ private _setHistory (): void { const delta = this._history.length - this._options.replayTime if (delta > 0) { this._history = this._history.slice(delta) } } setReplayTime (replayTime: number): void { if (!isNumber(replayTime)) { throw (new TypeError('"replayTime" is expected to be a Number.')) } this._options.replayTime = Math.floor(Math.abs(replayTime)) this._setHistory() } replayTo (consumer: MutatorConsumer): void { this._history.forEach((val) => { consumer(val, this._atom) }) } replay (): void { this._consumers.forEach((consumer) => { this.replayTo(consumer) }) } subscribe (consumer: MutatorConsumer): MutationSubscription subscribe (consumer: MutatorConsumer, options: SubscribeOptions & { isExtracted: false }): MutationSubscription subscribe (consumer: TransformationConsumer, options: SubscribeOptions & { isExtracted: true }): MutationSubscription // NOTE: catch all overload subscribe (consumer: MutationConsumer, options?: SubscribeOptions): MutationSubscription subscribe ( consumer: MutationConsumer, options: SubscribeOptions = DEFAULT_SUBSCRIBE_OPTIONS ): MutationSubscription { const subscription = this._atom.subscribe(consumer, options) const { proxyConsumer } = subscription this._consumers.add(proxyConsumer) this.replayTo(proxyConsumer) return subscription } subscribeTransformation ( consumer: TransformationConsumer, options: SubscribeOptions = DEFAULT_SUBSCRIBE_OPTIONS ): MutationSubscription { const subscription = this._atom.subscribeTransformation(consumer, options) const { proxyConsumer } = subscription this._consumers.add(proxyConsumer) this.replayTo(proxyConsumer) return subscription } unsubscribe (target: MutationConsumer | MutationSubscription | AtomLike): boolean { const subscription = (isFunction(target) || isAtomLike(target)) ? this._atom.getSubscription(target) : target let unsubscribed = false if (!isUndefined(subscription)) { unsubscribed = this._consumers.delete(subscription.proxyConsumer) && this._atom.unsubscribe(subscription) } return unsubscribed } unsubscribeAll (): boolean { this._consumers.clear() return this._atom.unsubscribeAll() } // !!! important beObservedBy (data: DataLike): MutationSubscription { return data.observe(this) } release (): void { this._subscription.unsubscribe() super.release() } } /****************************************************************************************************** * * ReplayMediator * ******************************************************************************************************/ /** * */ export class ReplayMediator { constructor () { throw (new TypeError('"ReplayMediator" is not meant to be instantiated.')) } get type (): MediatorType { return ReplayMediatorType } get mediatorType (): MediatorType { return ReplayMediatorType } get isReplayMediator (): true { return true } static of (atom: DataLike, options?: ReplayMediatorOptions): ReplayDataMediator static of (atom: MutationLike, options?: ReplayMediatorOptions): ReplayMutationMediator static of (atom: I, options?: ReplayMediatorOptions): I static of | MutationLike | ReplayMediatorUnion> ( atom: I, options: ReplayMediatorOptions = DEFAULT_REPLAY_MEDIATOR_OPTIONS ): ReplayMediatorUnion { if (!isAtomLike(atom)) { throw (new TypeError('"atom" is expected to be a general Atom or a ReplayMediatorUnion.')) } if (isReplayMediator(atom)) { return atom } const _options = { ...DEFAULT_REPLAY_MEDIATOR_OPTIONS, ...options } if (isData(atom)) { return ReplayDataMediator.of(atom, _options) } else if (isMutation(atom)) { return ReplayMutationMediator.of(atom, _options) } else { throw (new TypeError('Invalid atom type!')) } } } interface IReplayLatestPartial { (atom: DataLike): ReplayDataMediator

(atom: MutationLike): ReplayMutationMediator (atom: I): I // catch all overload, used in `pipe` or `compose` or likewise situations. (atom: AtomLikeOfOutput): AtomLikeOfOutput } interface IReplayLatest { (replayTime: number): IReplayLatestPartial (replayTime: number, atom: DataLike): ReplayDataMediator

(replayTime: number, atom: MutationLike): ReplayMutationMediator (replayTime: number, atom: I): I // catch all overload, used in `pipe` or `compose` or likewise situations. (replayTime: number, atom: AtomLikeOfOutput): AtomLikeOfOutput } /** * Make a replay mediator with specified replayTime but without autoTrigger. * * @param replayTime * @param atom */ export const replayWithoutLatest: IReplayLatest = curry((replayTime, atom) => { return ReplayMediator.of(atom, { replayTime, autoTrigger: false }) }) /** * Make a replay mediator with specified replay time and auto trigger. * * @param replayTime * @param atom */ export const replayWithLatest: IReplayLatest = curry((replayTime, atom) => { return ReplayMediator.of(atom, { replayTime, autoTrigger: true }) })