import { createInjector } from '../factories/createInjector'
import { InjectorDescriptor, prefix, Static } from '../utils/index'
import {
AnyAtomInstance,
AnyAtomTemplate,
AtomInstanceType,
AtomParamsType,
InjectAtomInstanceConfig,
ParamlessTemplate,
PartialAtomInstance,
} from '../types/index'
const defaultOperation = 'injectAtomInstance'
/**
* injectAtomInstance
*
* Creates an atom instance for the passed atom based on the passed params. If
* an instance has already been created for the passed params, reuses the
* existing instance.
*
* Registers a static graph dependency on the atom instance. This means atoms
* that use this injector will *not* reevaluate when this atom instance's state
* changes.
*
* Pass false as the 4th param to prevent this graph dependency from being
* registered. Useful when you need to control the graph dependency manually.
* `injectAtomSelector` does this internally.
*
* @param atom The atom to instantiate or reuse an instantiation of.
* @param params The params for generating the instance's key.
* @param operation The operation name (e.g. name of the injector function)
* that's triggering this graph dependency. If you're using this injector
* directly in an atom, it's fine to omit this parameter.
* @returns An atom instance, keyed based on the passed params.
*/
export const injectAtomInstance: {
(
template: A,
params: AtomParamsType,
config?: InjectAtomInstanceConfig
): AtomInstanceType
>(template: A): AtomInstanceType
(
template: ParamlessTemplate
): AtomInstanceType
(
instance: I,
params?: [],
config?: InjectAtomInstanceConfig
): I
} = createInjector(
defaultOperation,
(
instance: PartialAtomInstance,
atom: A | AnyAtomInstance,
params?: AtomParamsType,
config?: InjectAtomInstanceConfig
) => {
const injectedInstance =
instance.ecosystem._evaluationStack.atomGetters.getInstance(
atom as A,
params as AtomParamsType,
[config?.subscribe ? 0 : Static, config?.operation || defaultOperation]
)
return {
result: injectedInstance as AtomInstanceType,
type: `${prefix}/atom`,
} as InjectorDescriptor>
},
(
prevDescriptor: InjectorDescriptor>,
instance: PartialAtomInstance,
atom: A | AnyAtomInstance,
params?: AtomParamsType,
config?: InjectAtomInstanceConfig
) => {
// make sure the dependency gets registered for this evaluation
const injectedInstance =
instance.ecosystem._evaluationStack.atomGetters.getInstance(
atom as A,
params as AtomParamsType,
[config?.subscribe ? 0 : Static, config?.operation || defaultOperation]
)
prevDescriptor.result = injectedInstance as AtomInstanceType
return prevDescriptor
}
)