feat: allow passing meta to find options

Author: Akryum

packages/core/src/query/findFirst.ts

@@ -63,6 +63,11 @@ async function _findFirst<
         key: keyOrOptions,
       }
     : keyOrOptions
+
+  if (findOptions.meta) {
+    Object.assign(meta, findOptions.meta)
+  }
+
   const fetchPolicy = store.$getFetchPolicy(findOptions?.fetchPolicy)
 
   let result: any

packages/core/src/query/findMany.ts

@@ -59,6 +59,10 @@ async function _findMany<
   meta ??= {}
   findOptions ??= {}
 
+  if (findOptions.meta) {
+    Object.assign(meta, findOptions.meta)
+  }
+
   const fetchPolicy = store.$getFetchPolicy(findOptions.fetchPolicy)
 
   let result: any[] | undefined

packages/core/src/query/peekFirst.ts

@@ -35,7 +35,13 @@ export function peekFirst<
         key: keyOrOptions,
       }
     : keyOrOptions
+
   const key = findOptions?.key
+
+  if (findOptions.meta) {
+    Object.assign(meta, findOptions.meta)
+  }
+
   const fetchPolicy = store.$getFetchPolicy(findOptions?.fetchPolicy)
 
   if (force || shouldReadCacheFromFetchPolicy(fetchPolicy)) {

packages/core/src/query/peekMany.ts

@@ -30,6 +30,10 @@ export function peekMany<
 }: PeekManyOptions<TCollection, TCollectionDefaults, TSchema>): QueryResult<Array<WrappedItem<TCollection, TCollectionDefaults, TSchema>>> {
   meta ??= {}
 
+  if (findOptions?.meta) {
+    Object.assign(meta, findOptions.meta)
+  }
+
   const fetchPolicy = store.$getFetchPolicy(findOptions?.fetchPolicy)
   if (force || shouldReadCacheFromFetchPolicy(fetchPolicy)) {
     let marker = defaultMarker(collection, findOptions)

packages/shared/src/types/query.ts

@@ -1,6 +1,7 @@
 /* eslint-disable unused-imports/no-unused-vars */
 
 import type { Collection, CollectionByName, CollectionDefaults, CollectionRelation, RelationsByName, ResolvedCollectionItem, StoreSchema } from './collection'
+import type { CustomHookMeta } from './hooks'
 
 export interface CustomParams<
   TCollection extends Collection,
@@ -131,6 +132,8 @@ export interface FindOptionsBase<
    * Experimental: Enable garbage collection for items that are not referenced by any query or other item.
    */
   experimentalGarbageCollection?: boolean
+
+  meta?: CustomHookMeta
 }
 
 export type FindFirstOptions<