feat: use storage and invalidation

[simone-sanfratello]

proposal for use of an external storage, with optional invalidation

---

TODO

• test on storage/s
• 100% coverage (and significant cases)
• use an empty logger on storage
• fix CI, add a redis instance
• restore expiration logic on memory storage / do not use Date.now
• expose explicit "invalidation" function
• improve redis storage (pipeline etc)
• storage gc function
• memory storage with sync deletes
• redis storage with sync deletes
• optional invalidation
• benchmarks
• redis references TTL
• redis gc
• "stale-on-error" > next
• solve TODOs
• check redis pipeline
• memory references: use a btree? a set? arrays are good enough
• example
  • basic
  • mjs
• update documentation

[simone-sanfratello]

still have to write test on storage and reach 100% coverage

[mcollina]

great work!

[simone-sanfratello]

I'm collecting on top all the points
still have to work a lot on redis :)
and on gc

[simone-sanfratello]

@mcollina wait to review, still a wip

[mcollina]

looks good!

[mcollina]

Good work!

[mcollina]

This needs lots of docs, specifically how to use references

[simone-sanfratello]

This needs lots of docs, specifically how to use references

I'm thinking of doing am extended use case in mercurius/cache and link there for documentation, for 2 reason: it's hard to explain references talking with abstractions, and the result of documentation here would be very close to the mercurius/cache one

wdyt?

[mcollina]

Just do one and copy it over/adapt here. I think this deserves some docs anyway.

[simone-sanfratello]

@mcollina apart of documentation, the code is done
there are some points in the code marked with TODO, we can probably check them later
I'm writing doc for mercurius-cache for references and invalidation, then I'll port here

[mcollina]

Could you create a "Maintainers" Section on the README and add both yourself and myself there? This module is as much yours as it is mine now.

Also add yourself to the package.json too.

[simone-sanfratello]

@mcollina done!

[mcollina]

lgtm