Skip to content

Releases: briebug/ngrx-auto-entity

0.8.1 Beta (2022-05-05)

05 May 19:53
Compare
Choose a tag to compare

Added two new loading related selectors: hasBeenLoaded and loadWasAttempted. These selectors allow
end developers to determine if a load has ever been attempted before, which is sometimes necessary
to display the correct information in a UI component. Until a load has at least been attempted, it
would generally be inappropriate to display to the user that there are no Entities X, however as
the current state of each entity currently stands, there is no way to determine that particular
state of an entity. You can determine if an entity is loading or not, which is useful for displaying
a spinner, but other messaging requires more information.

Features

  • selectors: Added selectHasBeenLoaded to selector map (#218)
  • selectors: Added selectLoadWasAttempted to selector map (#218)

0.8.0-beta.1 Beta (2022-04-05)

05 May 19:59
Compare
Choose a tag to compare

Updated state builders to build all state functionality "on-demand" to limit memory footprint when
lots of entities are used. This aligns selectors, facades, etc. with the way actions were implemented
when they were introduced to the state builder. Selectors for any given entity are only created
if they are accessed (i.e. destructured from the object returned by buildState), and the same goes
for facades.

Performed a major internal refactor of the auto-entity reducer in order to break down the single monolithic
reducer into a more modular design. Each set of related actions, such as loadAll, create, editing, selections,
etc. have their own corresponding reducer. Actions are now mapped to the appropriate reducer through a
centralized mapping for action-to-reducer routing.

These changes are internal, and should not present any breaking changes to the public API. That said,
the changes are fairly extensive, and care should be used until 0.8 is officially released.

Internal

  • util: Renamed internal functional pipe function to compose
  • reducer: Refactored monolithic reducer into modular design
  • state: Modified internal state structure to use nested objects (#111)
  • selectors: Adjusted selectors to utilize more nested state structure (#111)
  • selectors: Updated selector builder to create selectors on-demand (#162)
  • facades: Updated facade builder to create new facade on-demand (#162)

0.7.2 Beta (2022-01-24)

05 May 19:57
Compare
Choose a tag to compare

Resolved a discrepancy in optional loading, where if the entity were a part of feature state,
and its state properties were nested underneath a feature state property on root state, the
correct entity state property could not be found.

Bug Fixes

  • operators: Update getEntityState function to check if entity has feature affinity, and access from the appropriate feature if necessary.
  • factories: Updated optional loading factories to support optional props where possible
  • actions: Updated optional loading actions to support optional props where possible

Internal

  • operators: Moved operator support utilities to their own code file

0.7.1 Beta (2021-11-05)

05 May 19:57
Compare
Choose a tag to compare

Resolve license field issues in package.json. Update packages based on security alerts. No other
or breaking changes in this release.

0.7.0 Beta (2021-08-02)

03 Aug 16:24
Compare
Choose a tag to compare

This release officially adds support for Angular 12 and NgRx 12! With the advent of Ivy, and its
continued progress towards replacing View Engine, supporting Angular 12 required a bit more active
work to support. Currently, the library is built with enableIvy set to false, which allows the
library to be built with support for View Engine versions of Angular.

Research and planning has begun on supporting Angular 13, however this will be a
more challenging task than supporting Angular 12 due to the fact that View Engine will be dropped
entirely from Ng 13, which will affect our ability to build a library that supports older versions
of Angular. We hope to have a plan in place for this scenario soon.

This release also updates some internal usage of NgRx to drop use of legacy or fully deprecated
features, such as the @Entity decorator.

Internal

  • effects: All effects have dropped use of the legacy @Effect() decorator, and are now using
    the current and recommended createEffect() function. This is to ensure support with NgRx 12+.
  • actions: Action factories have been updated with more explicit typing. Increased type strictness
    that comes with Ng 12 revealed cases where types were not specified, or insufficiently specified. These
    types have been strengthened to be more accurate and clear. These changes should not impact
    normal use of action factories.

Breaking Changes !!

  • library: Support for Angular 8 has been dropped! While the library may still work with Angular
    8 applications, due to changes in Angular 12 build tools, as well as changes in NgRx 8, there are
    no guarantees that Auto-Entity will continue to work in Angular 8 applications.
  • build: Library is now being built with TypeScript 4. While we are not yet explicitly using
    any TypeScript 4.x features, and thus should still support TypeScript 3.x, this change in underlying
    build tools for the library may have impacts on builds for dependent projects.

0.6.1 Beta (2021-06-24)

03 Aug 16:23
Compare
Choose a tag to compare

Auto-Entity version 0.6.1 is a patch release to fix a couple bugs.

Bug Fixes

  • facade: Fix error when calling the deselectAll() method on a facade (#174)
  • actions: Fix type error when using DeleteByKeyFailure or DeleteByKeySuccess (#183)

0.6.0 Beta (2021-04-02)

06 Apr 00:16
Compare
Choose a tag to compare

Auto-Entity version 0.6 introduces NgRx 8+ compatible action factory functions. Similar to the
kind of actions (technically factory functions that create actions!) you get when using the
createAction factory function from NgRx itself. This change is NON-Breaking, as all legacy
actions remain in place and fully usable, allowing migration to the new actions to be done
progressively if necessary.

New actions may be destructured from the object returend by calling buildState and buildFeatureState,
as with all other auto-entity state functionality. Simply destructure the new actions property:

export const {
  actions: {
    loadAll: loadAllCustomers,
    create: createCustomer,
    update: updateCustomer,
    delete: deleteCustomer,
    select: selectCustomer,
    deselect: deselectCustomer,
    // ... many more!
  }
} = buildState(Customer);

Actions introduce a new mechanism for building auto-entity state. Only the actions that are actually
used (i.e. destructured) are actually created for the specified entity. This should limit the amount
of memory used for auto-entity related functionality. This mechanism will be expanded
to the rest of the state related functionality that can be generated by the build state calls
in the future.

The breaking changes this release should be minimally breaking, and mostly backwards compatible except
in fringe cases covering more unusual use cases. Conversion of selection properties from read only getters
to simple fields should improve the unit testability of facades by allowing simpler mocks, stubs, and fakes,
easier spying, etc. This may also improve support for more custom use cases and extensions in concrete
facade classes.

Features

  • actions: Add NgRx 8+ style action factory functions (#76)
  • util: Add support for NgRx 8+ style action factory generation (#76)
  • actions: Add "bare edit" support with EditNew action (#161)
  • facades: Add "bare edit" support with editNew activity method (#161)
  • selectors: Add new selectHasEntities and selectHasNoEntities selectors (#149)
  • facades: Add new hasEntities$ and hasNoEntities$ selections to facades (#149)

Bug Fix

  • reducer: Fix issue with meta reducer not calling next reducer with next state (#170)
  • decorators: Fix @key decorator to only try to attach NAE_KEYS internal property if it has not yet been set
  • reducer: Add missing updatedAt and replacedAt timestamps in state for each entity

Breaking Changes !!

  • facades: Convert getter properties to fields to improve unit testability/mocking/spying (#150)

0.5.0 Beta (2020-10-16)

03 Nov 06:55
Compare
Choose a tag to compare

Auto-Entity version 0.5 introduces several major enhancements over version 0.4. These features include
the addition of several new actions, including support for Upsert-style changes & optional loading.
Result actions (success/failure) have been enhanced with additional data, providing all original params
and criteria passed to their corresponding initiating actions.

Optional loading, or "if necessary" actions, have been added to support more efficient loading of entities
by skipping the actual load, if the data has already been loaded and is in state. These actions require
access to entity state, which necessitated the addition of a new configuration provider injection token,
NGRX_AUTO_ENTITY_APP_STORE, that must be configured by the app to allow auto-entity to check state in
*IfNecessary effects. Without proper configuration of the app store injection token, the *IfNecessary
effects will fail to function properly. Graceful fallback to descriptive errors will occur if the
necessary config has not been performed by the developer.

A range of new utility functions have been added to support the developer's utilization of entity meta-
data that is configured via the @Entity and @Key directives. This includes functions to retrieve the
various entity names, comparers, transformers, and other metadata.

Several enhancements to the internal reducer have been made to improve reliability, enhance performance, and
provide richer error messaging to the developer. When the reducer cannot perform its job due to mis-configuration
of any automatic entity, additional errors will be reported to the browser console. These enhancements extend
to additional error reporting by the buildState functions as well, in an attempt to identify mis-configuration
as early as possible. Any misconfiguration that can be detected will now be reported to the browser console,
along with instructions to fix (with example code) whenever possible.

Internal code cleanup and restructuring has been performed to achieve better organization and support long-term
maintenance of the project as well. Internal re-org breaks previously very large code files into much smaller
files, such as actions, operators, decorators and support code, utility functions, etc.

NOTE: Internal restructuring may potentially be breaking to consumers of NgRx Auto-Entity if they are by
chance importing anything from internal (non public-api) paths in the library!

NgRx Auto-Entity has been verified to work with Angular 8 and 9. Angular 10 may work, depending on the use
cases and exact configuration of Angular. Further testing will be performed for Angular 10 support, and
updates may be forthcoming to add deeper support for Angular 10.

NgRx Auto-Entity is now properly licensed under the MIT Open Source License!

Features

  • actions: Add Upsert/UpsertMany actions to support upsert style changes (#109)
  • service: Add upsert/upsertMany handlers to entity service (#109)
  • reducer: Add support for upsert style changes (#109)
  • facades: Add support for upsert/upsertMany (#109)
  • actions: Add optional key params for load actions (#99)
  • facades: Add optional key params for load methods on facades (#99)
  • facades: Correlation Id passed to/created by facade methods now returned (#124)
  • decorators: Add utility functions for retrieving metadata configured by @Entity decorator (#107)
  • decorators: Add utility functions for retrieving entity key directly from properly prototyped entity object (#140)
  • service: Add utility functions for applying entity transformations by developer (#95)
  • decorators: Add support for named comparers for custom sorting (#138)
  • selectors: Add parameterized selectors for custom sorted entities (#138)
  • facades: Add parameterized selection for custom sorted entities (#138)
  • util: Add makeEntity utility function for converting POJOs to prototyped entity objects (#139)
  • actions: Add EditByKey action to support initiating edits by entity key, if entity is in state (#145)
  • facades: Add editByKey method to support initiating editd by entity key (#145)
  • actions: Add new actions to support loading (of all kinds), only "if necessary" (#144)
  • decorators: Add defaultMaxAge to @Entity decorator for "if necessary" support (#144)
  • decorators: Add EntityAge enum with set of predefined common ages for use with "if necessary" ages (#144)
  • decorators: Add support for "simplified" @Entity decorator usage of passing model name as string only (#141)

Enhancements

  • service: Will now pass criteria as optional parameter to all data transformers (#93)
  • selectors: Clarified return types on selectors where null was a possibility for stronger typing
  • reducer: Refactored reductions to use local (non-observable) mutations for significant performance improvements (#94)
  • actions: Success & Failure actions now include all relevant original params & criteria passed to initiation actions (#115, #129)

Internal

  • all: Clean up internal imports to avoid ../.. reference
  • selectors: Extracted all selector projection mappers to discrete functions
  • actions: Break out all actions into discrete files for each set of initiating/result actions
  • actions: Break out action support types and operators into their own files
  • decorators: Break out decorators into discrete files
  • decorators: Break out support types, utils, etc. for decorators into their own files

Bug Fix

  • state: Convert all timestamps in state to unix times (number) to resolve serialization issues (#98)
  • reducer: Resolved issues where reducer attempted to modify immutable entity and ids (#94)
  • selectors: Update selectors to convert unix times to Date to maintain public API (#98)
  • selectors: Resolved issues with "Invalid Date" errors from timestamp selectors (#112)
  • selectors: Refactored all and sorted selectors to be based off other selectors to avoid unnecessary re-emissions (#113)
  • util: Updated key retrieval functions to log console errors if keys cannot be retrieved due to config issues (#134)
  • reducer: Updated reducer to log console errors and NOT update state if keys may not be retrieved safely (#134)
  • util: Updated buildState functions to log console errors and throw if entities are mis-configured
  • reducer: Updated Edit reduction to preserve prior state if entity key matches existing edit (#143)
  • actions: Resolve issue where some result actions were not properly correlating to their initiating actions (#153)

Breaking Changes !!

  • all: Major internal code restructuring may break consumers that import from anywhere other than public api

0.4.1 Beta (2020-02-09)

10 Feb 17:00
Compare
Choose a tag to compare

Introduces the ability to delete entities just by their key, or many entities by their keys. This allows
the deletion of entities without actually having the entity objects on hand.

Also resolves an issue with clearing state, which would also clear custom developer-defined extra state
included alongside auto-entity managed state.

Features

  • actions:** Add DeleteByKey, DeleteManyByKeys and related result actions (#85)
  • service: Add support for deleteByKey and deleteManyByKeys methods in entity services (#85)
  • reducer: Handles new delete by keys result actions to rmeove deleted entities and update deleting flags/timestamps (#85)
  • decorators: Add support for new delete by keys actions in effect exclusion of @Entity decorator (#85)
  • facades: Add deleteByKey and deleteManyByKeys methods to generated facades (#85)
  • effects: Add operators and effects to handle delete by keys actions (#85)

Bug Fix

  • reducer: No longer removes custom state when clearing auto-entity managed state with Clear action (#86)
  • util: Fix buildState and buildFeatureState and related types to support custom properties in extra state under TS 3.x (#88)

0.4.0 Beta (2020-01-13)

13 Jan 18:50
Compare
Choose a tag to compare

Introducing the @Entity decorator for model classes. This decorator provides custom naming capabilities,
the ability to filter which auto-entity pre-fab effects handle each model, as well as define a default
comparer for sorting entities retrieved with a new .sorted$ stream on pre-fab facades.

Features

  • decorators: Add @Entity decorator for models with modelName, pluralName, uriName properties (#70)
  • decorators: Add excludeEffects functionality to @Entity decorator for filtering which effects handle entity
  • decorators: Add comparer property to @Entity decorator to support selecting sorted entities (#58)
  • selectors: Add selectAllSorted selector that uses entity comparer to sort on selection (#58)
  • facades: Add sorted$ stream to return all entities in sorted order from selectAllSorted selector (#58)

Internal

  • decorators: Moved all decorators into internal /lib/decorators directory (will break direct imports, use public api!)

Bug Fix

  • selectors: Added additional falsy checks to all selectors to limit frequency of hard failures (#81)
  • decorators: Added modelName to @Entity decorator to allow explicit definition of model name immune to mangling by code minifiers (#81)