Introduce *IfNecessary Load Actions

.prettierignore

@@ -0,0 +1 @@
+projects/ngrx-auto-entity/src/lib/index.ts

package.json

@@ -23,6 +23,7 @@
     "test:coverage": "jest --coverage",
     "test:ci": "jest --ci --runInBand --testResultsProcessor='jest-junit'",
     "lint": "ng lint",
+    "lint:fix": "ng lint --fix",
     "json-server": "json-server --watch data/db.json --routes data/routes.json",
     "link": "ng build ngrx-auto-entity && npm link dist/ngrx-auto-entity",
     "link:ci": "ng build ngrx-auto-entity && sudo npm link dist/ngrx-auto-entity",

projects/ngrx-auto-entity/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0-beta.2",
+  "version": "0.5.0-beta.3",
   "name": "@briebug/ngrx-auto-entity",
   "description": "Automatic Entity State and Facades for NgRx. Simplifying reactive state!",
   "keywords": [

projects/ngrx-auto-entity/src/index.ts

@@ -2,6 +2,22 @@
  * Public API Surface of ngrx-auto-entity
  */
 
+/*
+ * Modules
+ */
+export {
+  NgrxAutoEntityModule,
+  NgRxAutoEntityRootModuleWithEffects,
+  NgRxAutoEntityRootModuleNoEntityEffects,
+  NgRxAutoEntityRootModuleNoEffects,
+  NgRxAutoEntityFeatureModule,
+  NgRxAutoEntityModuleConfig,
+  getNgRxAutoEntityMetaReducer
+} from './lib/module';
+
+/*
+ * Common models and types referenced throughout Auto-Entity
+ */
 export {
   IPage,
   Page,
@@ -13,15 +29,22 @@ export {
   RangeValue,
   IPageInfo
 } from './lib/models';
-
-export { IEntityDictionary, IEntityState, EntityIdentity } from './lib/util/entity-state';
+export { EntityIdentity } from './lib/types/entity-identity';
+export { IEntityDictionary, IEntityState } from './lib/util/entity-state';
 export { IModelState, IModelClass } from './lib/util/model-state';
 export { IEntityFacade } from './lib/util/facade';
 export { ISelectorMap } from './lib/util/selector-map';
+
+/*
+ * Builders
+ */
 export { buildFacade } from './lib/util/facade-builder';
 export { buildSelectorMap } from './lib/util/selector-map-builder';
 export { buildFeatureState, buildState } from './lib/util/state-builder';
 
+/*
+ * Action Support
+ */
 export { EntityActionTypes } from './lib/actions/action-types';
 export { IEntityInfo } from './lib/actions/entity-info';
 export { EntityAction } from './lib/actions/entity-action';
@@ -30,109 +53,97 @@ export { fromEntityActions } from './lib/actions/action-operators';
 export { ofEntityType } from './lib/actions/action-operators';
 export { ofEntityAction } from './lib/actions/action-operators';
 export { isEntityActionInstance, EntityActions } from './lib/actions/entity-actions-union';
+
+/*
+ * Actions
+ */
+export { Load, LoadIfNecessary, LoadFailure, LoadSuccess } from './lib/actions/load-actions';
+export { LoadMany, LoadManyIfNecessary, LoadManyFailure, LoadManySuccess } from './lib/actions/load-many-actions';
+export { LoadAll, LoadAllIfNecessary, LoadAllFailure, LoadAllSuccess } from './lib/actions/load-all-actions';
+export { LoadPage, LoadPageIfNecessary, LoadPageFailure, LoadPageSuccess } from './lib/actions/load-page-actions';
+export { LoadRange, LoadRangeIfNecessary, LoadRangeFailure, LoadRangeSuccess } from './lib/actions/load-range-actions';
+
+export { CreateMany, CreateManyFailure, CreateManySuccess } from './lib/actions/create-actions';
+export { Create, CreateFailure, CreateSuccess } from './lib/actions/create-actions';
+export { UpdateMany, UpdateManyFailure, UpdateManySuccess } from './lib/actions/update-actions';
+export { Update, UpdateFailure, UpdateSuccess } from './lib/actions/update-actions';
+export { UpsertMany, UpsertManyFailure, UpsertManySuccess } from './lib/actions/upsert-actions';
+export { Upsert, UpsertFailure, UpsertSuccess } from './lib/actions/upsert-actions';
+export { ReplaceMany, ReplaceManyFailure, ReplaceManySuccess } from './lib/actions/replace-actions';
+export { Replace, ReplaceFailure, ReplaceSuccess } from './lib/actions/replace-actions';
+export { DeleteMany, DeleteManyFailure, DeleteManySuccess } from './lib/actions/delete-actions';
+export { Delete, DeleteFailure, DeleteSuccess } from './lib/actions/delete-actions';
 export {
-  Load,
-  LoadFailure,
-  LoadSuccess,
-  LoadAll,
-  LoadAllFailure,
-  LoadAllSuccess,
-  LoadMany,
-  LoadManyFailure,
-  LoadManySuccess,
-  LoadPage,
-  LoadPageFailure,
-  LoadPageSuccess,
-  LoadRange,
-  LoadRangeFailure,
-  LoadRangeSuccess,
-  CreateFailure,
-  CreateSuccess,
-  Create,
-  CreateMany,
-  CreateManyFailure,
-  CreateManySuccess,
-  Update,
-  UpdateSuccess,
-  UpdateFailure,
-  UpdateMany,
-  UpdateManySuccess,
-  UpdateManyFailure,
-  Upsert,
-  UpsertSuccess,
-  UpsertFailure,
-  UpsertMany,
-  UpsertManySuccess,
-  UpsertManyFailure,
-  Replace,
-  ReplaceFailure,
-  ReplaceSuccess,
-  ReplaceMany,
-  ReplaceManyFailure,
-  ReplaceManySuccess,
-  Delete,
-  DeleteFailure,
-  DeleteSuccess,
-  DeleteByKey,
-  DeleteByKeyFailure,
-  DeleteByKeySuccess,
-  DeleteMany,
-  DeleteManyFailure,
-  DeleteManySuccess,
   DeleteManyByKeys,
   DeleteManyByKeysFailure,
   DeleteManyByKeysSuccess,
+  DeleteByKeyFailure,
+  DeleteByKeySuccess,
+  DeleteByKey
+} from './lib/actions/delete-by-key-actions';
+
+export {
   Select,
   SelectByKey,
-  SelectMany,
-  SelectMore,
-  SelectManyByKeys,
-  SelectMoreByKeys,
   Selected,
   SelectedMany,
-  Deselect,
-  DeselectMany,
-  DeselectManyByKeys,
-  DeselectAll,
-  Deselected,
-  Edit,
-  EditByKey,
-  Edited,
-  EditedByKey,
-  Change,
-  Changed,
-  EndEdit,
-  EditEnded,
-  Clear
-} from './lib/actions/actions';
+  SelectMany,
+  SelectManyByKeys,
+  SelectMore,
+  SelectMoreByKeys
+} from './lib/actions/selection-actions';
+export { Deselected, DeselectAll, DeselectManyByKeys, DeselectMany, Deselect } from './lib/actions/deselection-actions';
+export { EditEnded, EndEdit, Changed, Change, EditedByKey, Edited, EditByKey, Edit } from './lib/actions/edit-actions';
+export { Clear } from './lib/actions/actions';
+
+/*
+ * Decorators
+ */
+export { Entity } from './lib/decorators/entity-decorator';
+export { Key } from './lib/decorators/key-decorator';
 
+/*
+ * Entity Metadata and Management
+ */
 export { ENTITY_OPTS_PROP } from './lib/decorators/entity-tokens';
-export { IEffectExcept, IEntityOptions, IEntityTransformer, Entity } from './lib/decorators/entity';
+export { IEffectExcept, IEntityOptions, IEntityTransformer, EntityAge } from './lib/decorators/entity-options';
 export { IEffectExclusions } from './lib/decorators/effect-exclusions';
 export { curd, loads, extra, all, matching, except } from './lib/decorators/effect-exclusion-utils';
+
+/*
+ * Entity Metadata Utilities
+ */
 export { makeEntity } from './lib/util/make-entity';
 export {
   nameOfEntity,
   pluralNameOfEntity,
   uriNameOfEntity,
+  stateNameOfEntity,
   entityComparer,
-  entityTransforms
+  entityTransforms,
+  entityMaxAge
 } from './lib/decorators/entity-util';
 export {
-  Key,
   getKey,
   getKeyFromModel,
   getKeyFromEntity,
   getKeyNames,
   getKeyNamesFromModel,
   getKeyNamesFromEntity,
   checkKeyName
-} from './lib/decorators/key';
-
-export { EntityOperators } from './lib/effects/operators';
+} from './lib/decorators/key-util';
 
+/*
+ * Reducer
+ */
 export { autoEntityReducer, autoEntityMetaReducer, stateNameFromAction } from './lib/reducer/reducer';
 
+/*
+ * Entity Service
+ */
+export { NgrxAutoEntityService } from './lib/service/service';
+export { IAutoEntityService } from './lib/service/interface';
+
 export {
   IEntityRangeRef,
   IEntityPageRef,
@@ -141,13 +152,34 @@ export {
   IEntityIdentitiesRef
 } from './lib/service/refs';
 export { IEntityWithRangeInfo, IEntityWithPageInfo, IEntityError } from './lib/service/wrapper-models';
-export { IAutoEntityService } from './lib/service/interface';
-export { NgrxAutoEntityService } from './lib/service/service';
 
+/*
+ * Transformation utilities
+ */
+export {
+  transformEntityFromServer,
+  transformEntitiesFromServer,
+  transformEntityToServer,
+  transformEntitiesToServer
+} from './lib/service/transformation';
+
+/*
+ * Operators
+ */
+export { EntityOperators } from './lib/effects/operators';
+
+/*
+ * Effect Groups
+ */
 export { EntityEffects } from './lib/effects/effects-all';
 export { LoadEffects } from './lib/effects/effects-loads';
+export { LoadIfNecessaryEffects } from './lib/effects/if-necessary-loads';
 export { CUDEffects } from './lib/effects/effects-cud';
 export { ExtraEffects } from './lib/effects/effects-extra';
+
+/*
+ * Effects
+ */
 export {
   LoadEffect,
   LoadAllEffect,
@@ -169,20 +201,3 @@ export {
   UpsertEffect,
   UpsertManyEffect
 } from './lib/effects/effects-cud-discrete';
-
-export {
-  NgrxAutoEntityModule,
-  NgRxAutoEntityRootModuleWithEffects,
-  NgRxAutoEntityRootModuleNoEntityEffects,
-  NgRxAutoEntityRootModuleNoEffects,
-  NgRxAutoEntityFeatureModule,
-  NgRxAutoEntityModuleConfig,
-  getNgRxAutoEntityMetaReducer
-} from './lib/module';
-
-export {
-  transformEntityFromServer,
-  transformEntitiesFromServer,
-  transformEntityToServer,
-  transformEntitiesToServer
-} from './lib/service/transformation';

projects/ngrx-auto-entity/src/lib/actions/action-types.ts

@@ -1,21 +1,26 @@
 export enum EntityActionTypes {
   Load = '[Entity] (Generic) Load',
+  LoadIfNecessary = '[Entity] (Generic) Load (If Necessary)',
   LoadSuccess = '[Entity] (Generic) Load: Success',
   LoadFailure = '[Entity] (Generic) Load: Failure',
 
   LoadMany = '[Entity] (Generic) Load Many',
+  LoadManyIfNecessary = '[Entity] (Generic) Load Many (If Necessary)',
   LoadManySuccess = '[Entity] (Generic) Load Many: Success',
   LoadManyFailure = '[Entity] (Generic) Load Many: Failure',
 
   LoadAll = '[Entity] (Generic) Load All',
+  LoadAllIfNecessary = '[Entity] (Generic) Load All (If Necessary)',
   LoadAllSuccess = '[Entity] (Generic) Load All: Success',
   LoadAllFailure = '[Entity] (Generic) Load All: Failure',
 
   LoadPage = '[Entity] (Generic) Load Page',
+  LoadPageIfNecessary = '[Entity] (Generic) Load Page (If Necessary)',
   LoadPageSuccess = '[Entity] (Generic) Load Page: Success',
   LoadPageFailure = '[Entity] (Generic) Load Page: Failure',
 
   LoadRange = '[Entity] (Generic) Load Range',
+  LoadRangeIfNecessary = '[Entity] (Generic) Load Range (If Necessary)',
   LoadRangeSuccess = '[Entity] (Generic) Load Range: Success',
   LoadRangeFailure = '[Entity] (Generic) Load Range: Failure',