@ngrx/entity/types/ngrx-entity.d.ts

Common utilities for entity reducers

import { MemoizedSelector } from '@ngrx/store';

type Comparer<T> = (a: T, b: T) => number;
type IdSelectorStr<T> = (model: T) => string;
type IdSelectorNum<T> = (model: T) => number;
type IdSelector<T> = IdSelectorStr<T> | IdSelectorNum<T>;
interface DictionaryNum<T> {
    [id: number]: T | undefined;
}
declare abstract class Dictionary<T> implements DictionaryNum<T> {
    [id: string]: T | undefined;
}
interface UpdateStr<T> {
    id: string;
    changes: Partial<T>;
}
interface UpdateNum<T> {
    id: number;
    changes: Partial<T>;
}
type Update<T> = UpdateStr<T> | UpdateNum<T>;
type Predicate<T> = (entity: T) => boolean;
type EntityMap<T> = (entity: T) => T;
interface EntityMapOneNum<T> {
    id: number;
    map: EntityMap<T>;
}
interface EntityMapOneStr<T> {
    id: string;
    map: EntityMap<T>;
}
type EntityMapOne<T> = EntityMapOneNum<T> | EntityMapOneStr<T>;
interface EntityState<T> {
    ids: string[] | number[];
    entities: Dictionary<T>;
}
interface EntityStateAdapter<T> {
    addOne<S extends EntityState<T>>(entity: T, state: S): S;
    addMany<S extends EntityState<T>>(entities: T[], state: S): S;
    setAll<S extends EntityState<T>>(entities: T[], state: S): S;
    setOne<S extends EntityState<T>>(entity: T, state: S): S;
    setMany<S extends EntityState<T>>(entities: T[], state: S): S;
    removeOne<S extends EntityState<T>>(key: string, state: S): S;
    removeOne<S extends EntityState<T>>(key: number, state: S): S;
    removeMany<S extends EntityState<T>>(keys: string[], state: S): S;
    removeMany<S extends EntityState<T>>(keys: number[], state: S): S;
    removeMany<S extends EntityState<T>>(predicate: Predicate<T>, state: S): S;
    removeAll<S extends EntityState<T>>(state: S): S;
    updateOne<S extends EntityState<T>>(update: Update<T>, state: S): S;
    updateMany<S extends EntityState<T>>(updates: Update<T>[], state: S): S;
    upsertOne<S extends EntityState<T>>(entity: T, state: S): S;
    upsertMany<S extends EntityState<T>>(entities: T[], state: S): S;
    mapOne<S extends EntityState<T>>(map: EntityMapOne<T>, state: S): S;
    map<S extends EntityState<T>>(map: EntityMap<T>, state: S): S;
}
type EntitySelectors<T, V> = {
    selectIds: (state: V) => string[] | number[];
    selectEntities: (state: V) => Dictionary<T>;
    selectAll: (state: V) => T[];
    selectTotal: (state: V) => number;
};
type MemoizedEntitySelectors<T, V> = {
    selectIds: MemoizedSelector<V, string[] | number[], (entityState: EntityState<T>) => string[] | number[]>;
    selectEntities: MemoizedSelector<V, Dictionary<T>, (entityState: EntityState<T>) => Dictionary<T>>;
    selectAll: MemoizedSelector<V, T[], (entityState: EntityState<T>) => T[]>;
    selectTotal: MemoizedSelector<V, number, (entityState: EntityState<T>) => number>;
};
interface EntityAdapter<T> extends EntityStateAdapter<T> {
    selectId: IdSelector<T>;
    sortComparer: false | Comparer<T>;
    getInitialState(): EntityState<T>;
    getInitialState<S extends EntityState<T>>(state: Omit<S, keyof EntityState<T>>): S;
    getSelectors(): EntitySelectors<T, EntityState<T>>;
    getSelectors<V>(selectState: (state: V) => EntityState<T>): MemoizedEntitySelectors<T, V>;
}

declare function createEntityAdapter<T>(options?: {
    selectId?: IdSelector<T>;
    sortComparer?: false | Comparer<T>;
}): EntityAdapter<T>;

export { Dictionary, createEntityAdapter };
export type { Comparer, DictionaryNum, EntityAdapter, EntityMap, EntityMapOne, EntityState, IdSelector, Predicate, Update };