housekeeping 2024

[kukeiko]

What

Do various small things that don't really fit into an existing issue and don't warrant the creation of a new one

Todo

change

• [x] change AllCriterionShape to accept any type of criterion
  • currently, it only accepts exactly an AllCriterion
  • instead, I want it to be used for "catch-all" endpoints, i.e. if an issued Queries' criteria don't match any more specific endpoints, use the "All" endpoint instead (if the user defined one)
• [x] allow for more EntityCriteria subtraction cases (see commit message for details)
• [ ] make a decision on how key index is treated. when i call "getIndexes()" - is it included or not?

fix

• [x] 🐞 EntityHydrator does not add loaded packets into cache

feature

• [x] add fluid style to EntityQueryTracing.enableConsole()
• [x] improve Id validation when resolving a Blueprint to an EntitySchema
• [x] add some useful "findX()" methods to EntityQueryBuilder
• [x] set default value when joining entities
• [x] improve UX & type safety when declaring EntityBlueprint properties

chore

• [x] pin rxjs to 7.8.1
• [x] change tsc output from commonjs to ES2022
• [x] upgrade to typescript 5.3.3 & jest 29.7.0

test

• [x] add some high-level system tests
• [x] rework EntityWorkspace tests to be InMemoryEntityDatabase tests
• [x] add simple failure test for interceptors
• [x] add system tests for auto & custom hydrator

health

• [x] spruce up EntityStore(Unique|Common)Index a bit
• [x] rename InMemoryEntityDatabase to EntityCache
• [x] remove unused EntityCache methods & remove "sync" suffix
• [x] reduce amount of "new XXXTools()" calls
• [x] spruce up ComplexKeyMap a bit
• [ ] move EntityQueryBuilder out of entity-workspace.mts
• [x] small simplfication of IEntityHydrator.accept() arguments / move query execution related classes into separate files

refactor

• [x] move joinEntities() to EntityMapper
• [x] add toDestructurable() to all the "Tool" classes and remove inherent destructurability
• [x] move EntityMapper into EntityTools, and move entity related functions into EntityTools
• [x] make EntitySource logic more readable
• [x] rename EntityQueryBuilder to EntityQueryExecutor, clean it up, and use it in tests
• [x] move ComplexKeyMap to utils
• [ ] clean up tools: move logic into function files
• [ ] move query/selection/criterion math into function files
• [ ] ???