@elderbyte/ngx-starter 14.12.0-beta6 → 14.12.1

package/src/lib/common/data/datasource/data-source.ts

@@ -1,87 +0,0 @@
-import {Observable} from 'rxjs';
-import {Sort} from '../sort';
-import {Filter} from '../filters/filter';
-import {Page, Pageable} from '../page';
-import {TokenChunkRequest} from '../token-chunk-request';
-import {ContinuableListing} from '../continuable-listing';
-
-/***************************************************************************
- *                                                                         *
- * Data Fetcher APIs                                                       *
- *                                                                         *
- **************************************************************************/
-
-export interface IListFetcher<T> {
-  findAllFiltered(filters?: Filter[], sorts?: Sort[]): Observable<Array<T>>;
-}
-
-export interface IPageFetcher<T> {
-  findAllPaged(pageable: Pageable, filters?: Filter[]): Observable<Page<T>>;
-}
-
-export interface IContinuationFetcher<T> {
-  findAllContinuable(tokenChunkRequest: TokenChunkRequest): Observable<ContinuableListing<T>>;
-}
-
-/***************************************************************************
- *                                                                         *
- * Data Accessor APIs                                                      *
- *                                                                         *
- **************************************************************************/
-
-export interface IDataSource<T> {
-
-  /**
-   * Notifies that this data source has modified elements.
-   */
-  readonly dataChanged: Observable<any>;
-
-  /**
-   * Return the entity with the given Id.
-   */
-  findById(id: any): Observable<T>;
-
-  /**
-   * Return the entity with the given Id.
-   */
-  findByIds(ids: any[]): Observable<T[]>;
-
-  /**
-   * Get the Id value of the given entity
-   */
-  getId(entity: T): any;
-
-}
-
-export interface IListDataSource<T> extends IListFetcher<T>, IDataSource<T> {}
-
-export interface IPagedDataSource<T> extends IPageFetcher<T>, IDataSource<T> {}
-
-export interface IContinuableDataSource<T> extends IContinuationFetcher<T>, IDataSource<T> {}
-
-/***************************************************************************
- *                                                                         *
- * Type Predicates                                                         *
- *                                                                         *
- **************************************************************************/
-
-export function isDataSource(object: any): object is IDataSource<any> {
-
-  if (!object) { return false; }
-
-  return (object as IDataSource<any>).dataChanged !== undefined
-    && (object as IDataSource<any>).findById !== undefined
-    && (object as IDataSource<any>).getId !== undefined;
-}
-
-export function isListDataSource(object: IDataSource<any>): object is IListDataSource<any> {
-  return (object as IListDataSource<any>).findAllFiltered !== undefined;
-}
-
-export function isPagedDataSource(object: IDataSource<any>): object is IPagedDataSource<any> {
-  return (object as IPagedDataSource<any>).findAllPaged !== undefined;
-}
-
-export function isContinuableDataSource(object: IDataSource<any>): object is IContinuableDataSource<any> {
-  return (object as IContinuableDataSource<any>).findAllContinuable !== undefined;
-}

package/src/lib/common/data/datasource/entity-id-util.ts

@@ -1,11 +0,0 @@
-
-export class EntityIdUtil {
-  public static getId<T>(entity: T, idProperty: string): any {
-    if (entity && idProperty) {
-      if (typeof(entity) === 'object') {
-        return (<any>entity)?.[idProperty];
-      }
-    }
-    return entity;
-  }
-}

package/src/lib/common/data/datasource/fetcher/delegate-data-source.ts

@@ -1,230 +0,0 @@
-import {IContinuableDataSource, IDataSource, IListDataSource, IPagedDataSource} from '../data-source';
-import {EMPTY, forkJoin, Observable, throwError} from 'rxjs';
-import {Filter} from '../../filters/filter';
-import {Sort} from '../../sort';
-import {Page, Pageable} from '../../page';
-import {TokenChunkRequest} from '../../token-chunk-request';
-import {ContinuableListing} from '../../continuable-listing';
-import {EntityIdUtil} from '../entity-id-util';
-
-
-export abstract class DelegateDataSource<T> implements IDataSource<T> {
-
-  /***************************************************************************
-   *                                                                         *
-   * Static Builder                                                          *
-   *                                                                         *
-   **************************************************************************/
-
-  public static emptyListFetcher<T>(): IDataSource<T> {
-    const empty = () => EMPTY; // AOT Ignore
-    return DelegateDataSource.listFetcher(
-      empty,
-      'id',
-      empty,
-      empty
-    );
-  }
-
-  public static listFetcher<T>(
-    listFetcher: (sorts: Sort[], filters?: Filter[]) => Observable<Array<T>>,
-    idProperty: string = 'id',
-    findByIdFn?: (id: any) => Observable<T>,
-    findAllByIdFn?: (ids: any[]) => Observable<T[]>
-  ): IDataSource<T> {
-    return new DelegateListDataSource(
-      listFetcher,
-      idProperty,
-      findByIdFn,
-      findAllByIdFn
-    );
-  }
-
-  public static emptyPageFetcher<T>(): IDataSource<T> {
-    const empty = () => EMPTY; // AOT Ignore
-    return DelegateDataSource.pageFetcher(
-      empty,
-      'id',
-      empty
-    );
-  }
-
-  public static pageFetcher<T>(
-    pageFetcher: (pageable: Pageable, filters?: Filter[]) => Observable<Page<T>>,
-    idProperty: string = 'id',
-    findByIdFn?: (id: any) => Observable<T>,
-    findAllByIdFn?: (ids: any[]) => Observable<T[]>
-  ): IDataSource<T> {
-    return new DelegatePagedDataSource(
-      pageFetcher,
-      idProperty,
-      findByIdFn,
-      findAllByIdFn
-    );
-  }
-
-
-  public static emptyContinuableFetcher<T>(): IDataSource<T> {
-    const empty = () => EMPTY; // AOT Ignore
-    return DelegateDataSource.continuableFetcher(
-      empty,
-      'id',
-      empty
-    );
-  }
-
-  public static continuableFetcher<T>(
-    chunkFetcher: (tokenChunkRequest: TokenChunkRequest) => Observable<ContinuableListing<T>>,
-    idProperty: string = 'id',
-    findByIdFn?: (id: any) => Observable<T>,
-    findAllByIdFn?: (ids: any[]) => Observable<T[]>
-  ): IDataSource<T> {
-    return new DelegateContinuableDataSource(
-      chunkFetcher,
-      idProperty,
-      findByIdFn,
-      findAllByIdFn
-    );
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Constructor                                                             *
-   *                                                                         *
-   **************************************************************************/
-
-  protected constructor(
-    private readonly idProperty: string,
-    private readonly findByIdFn: (id: any) => Observable<T>,
-    private readonly findAllByIdFn: (ids: any[]) => Observable<T[]>,
-  ) {
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Public API                                                              *
-   *                                                                         *
-   **************************************************************************/
-
-  public get dataChanged(): Observable<any> {
-    return EMPTY;
-  }
-
-  public findById(id: any): Observable<T> {
-    if (this.findByIdFn) {
-      return this.findByIdFn(id);
-    }
-    return throwError('This DelegateDataSource does not implement findById!');
-  }
-
-  public findByIds(ids: any[]): Observable<T[]> {
-    if (this.findAllByIdFn) {
-      return this.findAllByIdFn(ids);
-    }
-    if (this.findByIdFn) {
-      return forkJoin(ids.map(id => this.findById(id)));
-    }
-    return throwError('This DelegateDataSource does not implement findByIds or findById!');
-  }
-
-  public getId(entity: T): any {
-    return EntityIdUtil.getId(entity, this.idProperty);
-  }
-
-}
-
-
-export class DelegateListDataSource<T> extends DelegateDataSource<T> implements IListDataSource<T> {
-
-  /***************************************************************************
-   *                                                                         *
-   * Constructor                                                             *
-   *                                                                         *
-   **************************************************************************/
-
-  constructor(
-    private readonly listFetcherFn: (sorts: Sort[], filters?: Filter[]) => Observable<Array<T>>,
-    idProperty: string,
-    findByIdFn: (id: any) => Observable<T>,
-    findAllByIdFn: (ids: any[]) => Observable<T[]>,
-  ) {
-    super(idProperty, findByIdFn, findAllByIdFn);
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Public API                                                              *
-   *                                                                         *
-   **************************************************************************/
-
-  public findAllFiltered(filters?: Filter[], sorts?: Sort[]): Observable<Array<T>> {
-    return this.listFetcherFn(sorts, filters);
-  }
-
-}
-
-export class DelegatePagedDataSource<T> extends DelegateDataSource<T> implements IPagedDataSource<T> {
-
-  /***************************************************************************
-   *                                                                         *
-   * Constructor                                                             *
-   *                                                                         *
-   **************************************************************************/
-
-  constructor(
-    private readonly pageFetcherFn: (pageable: Pageable, filters?: Filter[]) => Observable<Page<T>>,
-    idProperty: string,
-    findByIdFn: (id: any) => Observable<T>,
-    findAllByIdFn: (ids: any[]) => Observable<T[]>,
-  ) {
-    super(idProperty, findByIdFn, findAllByIdFn);
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Public API                                                              *
-   *                                                                         *
-   **************************************************************************/
-
-  public findAllPaged(pageable: Pageable, filters?: Filter[]): Observable<Page<T>> {
-    return this.pageFetcherFn(pageable, filters);
-  }
-
-  public process(
-    pageSize: number,
-    processFn: (dataChunk: T[]) => void,
-    filters?: Filter[]
-  ): void {
-    throw new Error('Not yet implemented');
-  }
-
-}
-
-export class DelegateContinuableDataSource<T> extends DelegateDataSource<T> implements IContinuableDataSource<T> {
-
-  /***************************************************************************
-   *                                                                         *
-   * Constructor                                                             *
-   *                                                                         *
-   **************************************************************************/
-
-  constructor(
-    private readonly chunkFetcherFn: (tokenChunkRequest: TokenChunkRequest) => Observable<ContinuableListing<T>>,
-    idProperty: string,
-    findByIdFn: (id: any) => Observable<T>,
-    findAllByIdFn: (ids: any[]) => Observable<T[]>,
-  ) {
-    super(idProperty, findByIdFn, findAllByIdFn);
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Public API                                                              *
-   *                                                                         *
-   **************************************************************************/
-
-  public findAllContinuable(tokenChunkRequest: TokenChunkRequest): Observable<ContinuableListing<T>> {
-    return this.chunkFetcherFn(tokenChunkRequest);
-  }
-
-}

package/src/lib/common/data/datasource/local/local-list-data-source.ts

@@ -1,161 +0,0 @@
-import {Filter} from '../../filters/filter';
-import {Sort} from '../../sort';
-import {BehaviorSubject, EMPTY, forkJoin, Observable, of, Subject} from 'rxjs';
-import {map} from 'rxjs/operators';
-import {IListDataSource} from '../data-source';
-import {Logger, LoggerFactory} from '@elderbyte/ts-logger';
-import {EntityIdUtil} from '../entity-id-util';
-
-
-export class LocalListDataSource<T> implements IListDataSource<T> {
-
-  /***************************************************************************
-   *                                                                         *
-   * Fields                                                                  *
-   *                                                                         *
-   **************************************************************************/
-
-  private readonly logger: Logger = LoggerFactory.getLogger(this.constructor.name);
-
-  private readonly data$ = new BehaviorSubject<T[]>([]);
-  private readonly dataChange$ = new Subject();
-
-  private readonly localSort: ((data: T[], sorts: Sort[]) => T[]);
-  private readonly localFilter: ((data: T[], filters: Filter[]) => T[]);
-
-  private readonly idProperty: string | null;
-
-  /***************************************************************************
-   *                                                                         *
-   * Static Builder                                                          *
-   *                                                                         *
-   **************************************************************************/
-
-  /**
-   * Creates an empty local list data-source.
-   * You can set / modify data by using the data property.
-   * @param idProperty
-   * @param localSort
-   * @param localFilter
-   */
-  public static empty<T>(
-    idProperty: string | null,
-    localSort?: ((data: T[], sorts: Sort[]) => T[]),
-    localFilter?: ((data: T[], filters: Filter[]) => T[])
-  ): LocalListDataSource<T> {
-    return LocalListDataSource.from(
-      [],
-      idProperty,
-      localSort,
-      localFilter
-    );
-  }
-
-  public static from<T>(
-    localData: T[],
-    idProperty: string | null,
-    localSort?: ((data: T[], sorts: Sort[]) => T[]),
-    localFilter?: ((data: T[], filters: Filter[]) => T[])
-  ): LocalListDataSource<T> {
-
-    return new LocalListDataSource(
-      localData,
-      localSort,
-      localFilter,
-      idProperty
-    );
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Constructor                                                             *
-   *                                                                         *
-   **************************************************************************/
-
-  constructor(
-    localData: T[],
-    localSort: ((data: T[], sorts: Sort[]) => T[]),
-    localFilter: ((data: T[], filters: Filter[]) => T[]),
-    idProperty: string | null
-  ) {
-    if (!localData) { throw new Error('localData must not be null!'); }
-    this.localSort = localSort || ((data, sort) => data);
-    this.localFilter = localFilter || ((data, sort) => data);
-    this.idProperty = idProperty || this.guessIdProperty(localData);
-    this.data = localData;
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * IDataSource API                                                         *
-   *                                                                         *
-   **************************************************************************/
-
-  public get dataChanged(): Observable<any> {
-    return this.dataChange$.asObservable();
-  }
-
-  public findById(id: any): Observable<T> {
-    return of(
-      this.data.find(d => this.getId(d) === id)
-    );
-  }
-
-  public findByIds(ids: any[]): Observable<T[]> {
-    return forkJoin(
-      ids.map(id => this.findById(id))
-    );
-  }
-
-  public findAllFiltered(filters?: Filter[], sorts?: Sort[]): Observable<T[]> {
-    return of(this.data).pipe(
-      map(data => this.localFilter(data, filters)),
-      map(data => this.localSort(data, sorts))
-    );
-  }
-
-  public getId(entity: T): any {
-    return EntityIdUtil.getId(entity, this.idProperty);
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Public API                                                              *
-   *                                                                         *
-   **************************************************************************/
-
-  public set data(data: T[]) {
-    this.data$.next(data);
-    this.onLocalDataChanges(data);
-  }
-
-  public get data(): T[] {
-    return this.data$.getValue();
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Private methods                                                         *
-   *                                                                         *
-   **************************************************************************/
-
-  protected onLocalDataChanges(data: T[]): void {
-    this.dataChange$.next(data);
-  }
-
-  private guessIdProperty(localData: T[]): string | null {
-    if (localData && localData.length > 0) {
-      const sample = localData[0];
-      if (typeof sample === 'object') {
-        if (sample.hasOwnProperty('id')) {
-          this.logger.warn('DataSource without defined id-property => autodetected property id-property as "id"');
-          return 'id';  // Use id
-        } else {
-          this.logger.warn('Local DataSource created without defined id-property and objects. Using object equality!');
-        }
-      }
-    }
-    return null; // Use value as id if scalar
-  }
-
-}

package/src/lib/common/data/datasource/local/local-paged-data-source.ts

@@ -1,129 +0,0 @@
-import {Page, Pageable} from '../../page';
-import {Filter} from '../../filters/filter';
-import {Observable} from 'rxjs';
-import {LocalListDataSource} from './local-list-data-source';
-import {map} from 'rxjs/operators';
-import {Sort} from '../../sort';
-import {IPagedDataSource} from '../data-source';
-
-export class LocalPagedDataSource<T> implements IPagedDataSource<T>  {
-
-  /***************************************************************************
-   *                                                                         *
-   * Fields                                                                  *
-   *                                                                         *
-   **************************************************************************/
-
-  private readonly localListFetcher: LocalListDataSource<T>;
-
-  /***************************************************************************
-   *                                                                         *
-   * Static Builder                                                          *
-   *                                                                         *
-   **************************************************************************/
-
-  /**
-   * Creates an empty local list data-source.
-   * You can set / modify data by using the data property.
-   * @param idProperty
-   * @param localSort
-   * @param localFilter
-   */
-  public static empty<T>(
-    idProperty: string | null,
-    localSort?: ((data: T[], sorts: Sort[]) => T[]),
-    localFilter?: ((data: T[], filters: Filter[]) => T[])
-  ): LocalPagedDataSource<T> {
-    return LocalPagedDataSource.from(
-      [],
-      idProperty,
-      localSort,
-      localFilter
-    );
-  }
-
-  public static from<T>(
-    localData: T[],
-    idProperty: string | null,
-    localSort?: ((data: T[], sorts: Sort[]) => T[]),
-    localFilter?: ((data: T[], filters: Filter[]) => T[])
-  ): LocalPagedDataSource<T> {
-    return new LocalPagedDataSource(
-      localData,
-      idProperty,
-      localSort,
-      localFilter
-    );
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Constructor                                                             *
-   *                                                                         *
-   **************************************************************************/
-
-  constructor(
-    localData: T[],
-    idProperty: string | null,
-    localSort: ((data: T[], sorts: Sort[]) => T[]),
-    localFilter: ((data: T[], filters: Filter[]) => T[])
-  ) {
-
-    if (!localData) { throw new Error('localData must not be null!'); }
-
-    this.localListFetcher = new LocalListDataSource(
-      localData,
-      localSort,
-      localFilter,
-      idProperty
-    );
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Public API                                                              *
-   *                                                                         *
-   **************************************************************************/
-
-  public get dataChanged(): Observable<any> {
-    return this.localListFetcher.dataChanged;
-  }
-
-  public findById(id: any): Observable<T> {
-    return this.localListFetcher.findById(id);
-  }
-
-  public findByIds(ids: any[]): Observable<T[]> {
-    return this.localListFetcher.findByIds(ids);
-  }
-
-  public findAllPaged(pageable: Pageable, filters?: Filter[]): Observable<Page<T>> {
-    return this.localListFetcher.findAllFiltered(filters, pageable.sorts).pipe(
-      map(data => this.pageSlice(pageable, data))
-    );
-  }
-
-  public getId(entity: T): string {
-    return this.localListFetcher.getId(entity);
-  }
-
-  /***************************************************************************
-   *                                                                         *
-   * Private methods                                                         *
-   *                                                                         *
-   **************************************************************************/
-
-  private pageSlice(pageable: Pageable, data: T[]): Page<T> {
-    let page: Page<T>;
-
-    if (data) {
-        const start = pageable.page * pageable.size;
-        const end = start + pageable.size;
-        const slice = data.slice(start, end);
-        page = Page.fromPage(slice, data.length, pageable);
-    } else {
-      page = Page.from([]);
-    }
-    return page;
-  }
-}

package/src/lib/common/data/datasource/public_api.ts

@@ -1,14 +0,0 @@
-
-export * from './data-source';
-export * from './data-source-adapter';
-export * from './data-source-processor';
-
-export * from './rest/public_api';
-
-export * from './local/local-list-data-source';
-export * from './local/local-paged-data-source';
-
-export * from './fetcher/delegate-data-source';
-
-
-

package/src/lib/common/data/datasource/rest/public_api.ts

@@ -1,2 +0,0 @@
-
-export * from './rest-client';