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<

packages/vue/src/api.ts

@@ -333,10 +333,10 @@ export function createCollectionApi<
     return createQuery<TCollection, TCollectionDefaults, TSchema, any, WrappedItem<TCollection, TCollectionDefaults, TSchema> | null | Array<WrappedItem<TCollection, TCollectionDefaults, TSchema>>>({
       store,
       fetchMethod: (options, meta) => toValue(type) === 'first'
-        ? findFirst({ store, collection, findOptions: options!, meta }).then(r => r.result)
+        ? (options ? findFirst({ store, collection, findOptions: options, meta }).then(r => r.result) : Promise.resolve(null))
         : findMany({ store, collection, findOptions: options, meta }).then(r => r.result),
       cacheMethod: (options, meta) => toValue(type) === 'first'
-        ? peekFirst({ store, collection, findOptions: options!, meta, force: true }).result
+        ? (options ? peekFirst({ store, collection, findOptions: options, meta, force: true }).result : null)
         : peekMany({ store, collection, findOptions: options, meta, force: true }).result,
       defaultValue: () => toValue(type) === 'first' ? null : [],
       options: boundOptionsGetter,