Fix item.read hook not firing for readByQuery

[MoltenCoffee]

As reported by @lluishi93 in #6622 the current implementation of the item.read hook is flawed, as it doesn't get called with certain read actions.

I've moved the calling of the hook to the readByQuery method (which gets called by readOne and readMany), but there is still a problem. Normally, the hook gets called as follows:

emitAsyncSafe(`${this.eventScope}.eventType`, {
  event: `${this.eventScope}.eventType`,
  accountability: this.accountability,
  collection: this.collection,
  item: keys, // notice this
  action: 'eventType',
  payload: records,
  schema: this.schema,
  database: getDatabase(),
});

In readByQuery, however, the keys array is not available, as it consumes a query, already with the keys implemented.

I see several options:

1. Make an exception and don't return item here

2. Pass keys as an additional parameter to readByQuery; The significant drawback here is that readByQuery is called from a lot of places in the codebase, and I feel like this would provide some 'code smell'

3. Retrieve from the query as follows:

   const primaryKeyField = this.schema.collections[this.collection].primary;
   
   const keys = query.filter?.[primaryKeyField]?._eq || query.filter?.[primaryKeyField]?._in || null;

   To be fair, this feels like a hack to me.

4. Return to state before Add support for read hooks on items #6341, as there's no proper fix at the moment.

Would love to hear your opinions.

Fixes #6622

[MoltenCoffee]

As discussed in #6622 this hook is now placed in readByQuery, and the items key is replaced with query. The documentation has been updated with this information as well.

[benhaynes]

Thank you, @MoltenCoffee !!! ❤️

[rijkvanzanten]

Liked it so much, approved it twice ✅✅