feat: add start() method

Author: js2me

README.md

@@ -93,6 +93,10 @@ const query = new MobxQuery({
 });
 ```  
 
+#### method `start(params)`   
+
+Enable query if it is disabled then fetch the query.    
+
 #### method `update()`   
 
 Update options for query (Uses [QueryObserver](https://tanstack.com/query/latest/docs/reference/QueriesObserver).setOptions)  

src/mobx-query.test.ts

@@ -9,7 +9,7 @@ import {
 } from '@tanstack/query-core';
 import { LinkedAbortController } from 'linked-abort-controller';
 import { observable, reaction, runInAction, when } from 'mobx';
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, test, vi } from 'vitest';
 import { waitAsync } from 'yammies/async';
 
 import { MobxQuery } from './mobx-query';
@@ -536,6 +536,26 @@ describe('MobxQuery', () => {
     });
   });
 
+  describe('"start" method', () => {
+    test('should call once queryFn', async () => {
+      const querySpyFn = vi.fn();
+      const mobxQuery = new MobxQueryMock({
+        queryKey: ['test'],
+        queryFn: querySpyFn,
+        enabled: false,
+      });
+
+      await mobxQuery.start();
+
+      await when(() => !mobxQuery._rawResult.isLoading);
+
+      expect(mobxQuery.result.isFetched).toBeTruthy();
+      expect(querySpyFn).toBeCalledTimes(1);
+
+      mobxQuery.dispose();
+    });
+  });
+
   describe('scenarios', () => {
     it('query with refetchInterval(number) should be stopped after inner abort', async () => {
       const query = new MobxQueryMock({

src/mobx-query.ts

@@ -25,6 +25,7 @@ import {
   MobxQueryInvalidateParams,
   MobxQueryOptions,
   MobxQueryResetParams,
+  MobxQueryStartParams,
   MobxQueryUpdateOptions,
 } from './mobx-query.types';
 
@@ -313,6 +314,15 @@ export class MobxQuery<
     this.abortController.abort();
   }
 
+  async start(params?: MobxQueryStartParams<TData, TError, TQueryKey>) {
+    const options: MobxQueryUpdateOptions<TData, TError, TQueryKey> = {
+      enabled: true,
+      ...params,
+    };
+    this.update(options);
+    return await this.refetch();
+  }
+
   /**
    * @deprecated use `destroy`
    */

src/mobx-query.types.ts

@@ -120,6 +120,14 @@ export interface MobxQueryConfig<
   ) => MobxQueryDynamicOptions<TData, TError, TQueryKey>;
 }
 
+export interface MobxQueryStartParams<
+  TData,
+  TError = DefaultError,
+  TQueryKey extends QueryKey = QueryKey,
+> extends Partial<
+    Omit<MobxQueryUpdateOptions<TData, TError, TQueryKey>, 'enabled'>
+  > {}
+
 export type InferQuery<
   T extends MobxQueryConfig<any, any, any> | MobxQuery<any, any, any>,
   TInferValue extends 'data' | 'key' | 'error' | 'query' | 'config',