@openapi-qraft/react 2.0.0-next.0 → 2.0.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @openapi-qraft/react
 
+## 2.0.0-next.2
+
+### Patch Changes
+
+- 56191e1: Updated the `getQueryState(...)` function to support being invoked without parameters if they are not required. This enhancement simplifies the usage in scenarios where the parameters are optional, providing a more flexible API.
+- bbcac65: Refined all types related to value in the `qraftPredefinedParametersRequestFn(...)` function.
+
+## 2.0.0-next.1
+
+### Minor Changes
+
+- 76634bf: ### Changeset: `createPredefinedParametersRequestFn`
+
+  Introduced `createPredefinedParametersRequestFn`, generated by the `@openapi-qraft/cli` using
+  the `--operation-predefined-parameters` option.
+  This function allows for the automatic application of predefined
+  parameters to selected API operations by wrapping the base `requestFn`. It simplifies managing parameters, reducing
+  boilerplate code, and supports both static and dynamic values, enhancing flexibility in API request handling.
+
 ## 2.0.0-next.0
 
 ### Major Changes

package/README.md

@@ -23,7 +23,7 @@ Read the full documentation at [openapi-qraft.github.io/openapi-qraft](https://o
 First, install the core package for your project:
 
 ```bash
-npm install @openapi-qraft/react
+npm install @openapi-qraft/react@next
 ```
 
 If your project doesn't already include `@tanstack/react-query`, you'll also need to install it. This package is
@@ -47,7 +47,7 @@ and schemas from your OpenAPI Document.
 To generate both TypeScript definitions and services using `openapi-qraft`, run the following command in the root directory of your project:
 
 ```bash
-npx @openapi-qraft/cli --plugin tanstack-query-react --plugin openapi-typescript https://api.dev.monite.com/openapi.json?version=2023-09-01 --output-dir src/api
+npx @openapi-qraft/cli@next --plugin tanstack-query-react --plugin openapi-typescript https://api.dev.monite.com/openapi.json?version=2023-09-01 --output-dir src/api
 ```
 
 By completing this step, you will generate `src/api/schema.d.ts`, which serves as a TypeScript representation of the specified OpenAPI,
@@ -75,11 +75,9 @@ Finally, provide the request client to the `QraftContext` to enable the generate
 Every request will be handled by `request` function, which can be customized to fit your project's needs.
 
 ```tsx
-import { useMemo } from 'react';
-
 import { QraftContext, requestFn } from '@openapi-qraft/react';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-
+import { useMemo } from 'react';
 // where `./api` is the '--output-dir' path to the services you generated with `@openapi-qraft/cli`
 import { createAPIClient } from './api';
 
@@ -599,7 +597,6 @@ using a custom `fetchToken` async function.
 
 ```tsx
 import { QraftContext, requestFn } from '@openapi-qraft/react';
-
 import { fetchToken } from './auth';
 
 function QraftProvider({ children }: { children: React.ReactNode }) {

package/dist/types/Unstable_QraftSecureRequestFn.d.ts

@@ -11,7 +11,7 @@ export interface QraftSecureRequestFnProps extends QraftSecureRequestFnBaseProps
     queryClient?: QueryClient;
 }
 export declare function QraftSecureRequestFn({ children, requestFn, securitySchemes, queryClient: inQueryClient, }: QraftSecureRequestFnProps): import("react").FunctionComponentElement<{
-    children?: ReactNode;
+    children?: ReactNode | undefined;
 }>;
 export declare const useSecuritySchemeAuth: ({ securitySchemes, requestFn, queryClient, }: QraftSecureRequestFnBaseProps & {
     queryClient: QueryClient;

package/dist/types/Unstable_QraftSecureRequestFn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Unstable_QraftSecureRequestFn.d.ts","sourceRoot":"","sources":["../../src/Unstable_QraftSecureRequestFn.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAc,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAA2B,SAAS,EAAsB,MAAM,OAAO,CAAC;AAG/E,UAAU,6BAA6B;IACrC,SAAS,CAAC,KAAK,EAAE,MAAM,EACrB,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,aAAa,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,eAAe,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,KAAK,SAAS,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;AAE5D,MAAM,WAAW,yBACf,SAAQ,6BAA6B;IACrC,QAAQ,CACN,eAAe,EAAE,6BAA6B,CAAC,WAAW,CAAC,GAC1D,SAAS,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,SAAS,EACT,eAAe,EACf,WAAW,EAAE,aAAa,GAC3B,EAAE,yBAAyB;;GAkC3B;AAED,eAAO,MAAM,qBAAqB;iBAKnB,WAAW;MACtB,SAwBH,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAC/C,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,GACvB,SAAS,CA+BX;AA6HD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,WAmBlD;AAED,KAAK,cAAc,GACf,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAC5B,MAAM,CAAC,yBAAyB,GAChC;IACE,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,yCAAyC;IACzC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,yCAAyC;IACzC,EAAE,EAAE,QAAQ,CAAC;IACb,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;CACrB,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE/C,MAAM,MAAM,sBAAsB,CAAC,kBAAkB,SAAS,MAAM,IAAI;KACrE,GAAG,IAAI,kBAAkB,GAAG,qBAAqB;CACnD,CAAC"}
+{"version":3,"file":"Unstable_QraftSecureRequestFn.d.ts","sourceRoot":"","sources":["../../src/Unstable_QraftSecureRequestFn.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAc,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAA2B,SAAS,EAAsB,MAAM,OAAO,CAAC;AAG/E,UAAU,6BAA6B;IACrC,SAAS,CAAC,KAAK,EAAE,MAAM,EACrB,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,aAAa,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,eAAe,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,KAAK,SAAS,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;AAE5D,MAAM,WAAW,yBACf,SAAQ,6BAA6B;IACrC,QAAQ,CACN,eAAe,EAAE,6BAA6B,CAAC,WAAW,CAAC,GAC1D,SAAS,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,SAAS,EACT,eAAe,EACf,WAAW,EAAE,aAAa,GAC3B,EAAE,yBAAyB;;GAkC3B;AAED,eAAO,MAAM,qBAAqB,iDAI/B,6BAA6B,GAAG;IACjC,WAAW,EAAE,WAAW,CAAC;CAC1B,KAAG,SAwBH,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAC/C,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,GACvB,SAAS,CA+BX;AA6HD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,WAmBlD;AAED,KAAK,cAAc,GACf,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAC5B,MAAM,CAAC,yBAAyB,GAChC;IACE,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,yCAAyC;IACzC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,yCAAyC;IACzC,EAAE,EAAE,QAAQ,CAAC;IACb,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;CACrB,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE/C,MAAM,MAAM,sBAAsB,CAAC,kBAAkB,SAAS,MAAM,IAAI;KACrE,GAAG,IAAI,kBAAkB,GAAG,qBAAqB;CACnD,CAAC"}

package/dist/types/callbacks/getInfiniteQueryKey.d.ts

@@ -1,5 +1,5 @@
 import type { OperationSchema } from '../lib/requestFn.js';
 import { CreateAPIBasicClientOptions } from '../qraftAPIClient.js';
 import { ServiceOperationQuery } from '../service-operation/ServiceOperation.js';
-export declare const getInfiniteQueryKey: (_qraftOptions: CreateAPIBasicClientOptions, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['getInfiniteQueryKey']>) => import("../service-operation/ServiceOperationKey.js").ServiceOperationInfiniteQueryKey<OperationSchema, unknown>;
+export declare const getInfiniteQueryKey: (_qraftOptions: CreateAPIBasicClientOptions, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>["getInfiniteQueryKey"]>) => import("../service-operation/ServiceOperationKey.js").ServiceOperationInfiniteQueryKey<OperationSchema, unknown>;
 //# sourceMappingURL=getInfiniteQueryKey.d.ts.map

package/dist/types/callbacks/getInfiniteQueryKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getInfiniteQueryKey.d.ts","sourceRoot":"","sources":["../../../src/callbacks/getInfiniteQueryKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,eAAO,MAAM,mBAAmB,kBACf,2BAA2B,UAClC,eAAe,QACjB,WACJ,sBACE,eAAe,EACf,OAAO,EACP,OAAO,CACR,CAAC,qBAAqB,CAAC,CACzB,qHAGF,CAAC"}
+{"version":3,"file":"getInfiniteQueryKey.d.ts","sourceRoot":"","sources":["../../../src/callbacks/getInfiniteQueryKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,eAAO,MAAM,mBAAmB,kBACf,2BAA2B,UAClC,eAAe,QACjB,UAAU,CACd,qBAAqB,CACnB,eAAe,EACf,OAAO,EACP,OAAO,CACR,CAAC,qBAAqB,CAAC,CACzB,qHAGF,CAAC"}

package/dist/types/callbacks/getMutationKey.d.ts

@@ -1,5 +1,5 @@
 import type { OperationSchema } from '../lib/requestFn.js';
 import type { CreateAPIBasicClientOptions } from '../qraftAPIClient.js';
 import type { ServiceOperationMutation } from '../service-operation/ServiceOperation.js';
-export declare const getMutationKey: (_qraftOptions: CreateAPIBasicClientOptions, schema: OperationSchema, args: Parameters<ServiceOperationMutation<OperationSchema, unknown, unknown, unknown>['getMutationKey']>) => [OperationSchema, unknown];
+export declare const getMutationKey: (_qraftOptions: CreateAPIBasicClientOptions, schema: OperationSchema, args: Parameters<ServiceOperationMutation<OperationSchema, unknown, unknown, unknown>["getMutationKey"]>) => [OperationSchema, unknown];
 //# sourceMappingURL=getMutationKey.d.ts.map

package/dist/types/callbacks/getMutationKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMutationKey.d.ts","sourceRoot":"","sources":["../../../src/callbacks/getMutationKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGzF,eAAO,MAAM,cAAc,kBACV,2BAA2B,UAClC,eAAe,QACjB,WACJ,yBACE,eAAe,EACf,OAAO,EACP,OAAO,EACP,OAAO,CACR,CAAC,gBAAgB,CAAC,CACpB,+BAGF,CAAC"}
+{"version":3,"file":"getMutationKey.d.ts","sourceRoot":"","sources":["../../../src/callbacks/getMutationKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGzF,eAAO,MAAM,cAAc,kBACV,2BAA2B,UAClC,eAAe,QACjB,UAAU,CACd,wBAAwB,CACtB,eAAe,EACf,OAAO,EACP,OAAO,EACP,OAAO,CACR,CAAC,gBAAgB,CAAC,CACpB,+BAGF,CAAC"}

package/dist/types/callbacks/getQueryKey.d.ts

@@ -1,5 +1,5 @@
 import type { OperationSchema } from '../lib/requestFn.js';
 import type { CreateAPIBasicClientOptions } from '../qraftAPIClient.js';
 import type { ServiceOperationQuery } from '../service-operation/ServiceOperation.js';
-export declare const getQueryKey: (_qraftOptions: CreateAPIBasicClientOptions, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['getQueryKey']>) => import("../service-operation/ServiceOperationKey.js").ServiceOperationQueryKey<OperationSchema, unknown>;
+export declare const getQueryKey: (_qraftOptions: CreateAPIBasicClientOptions, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>["getQueryKey"]>) => import("../service-operation/ServiceOperationKey.js").ServiceOperationQueryKey<OperationSchema, unknown>;
 //# sourceMappingURL=getQueryKey.d.ts.map

package/dist/types/callbacks/getQueryKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getQueryKey.d.ts","sourceRoot":"","sources":["../../../src/callbacks/getQueryKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGtF,eAAO,MAAM,WAAW,kBACP,2BAA2B,UAClC,eAAe,QACjB,WACJ,sBAAsB,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,CACxE,6GAGF,CAAC"}
+{"version":3,"file":"getQueryKey.d.ts","sourceRoot":"","sources":["../../../src/callbacks/getQueryKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGtF,eAAO,MAAM,WAAW,kBACP,2BAA2B,UAClC,eAAe,QACjB,UAAU,CACd,qBAAqB,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,CACxE,6GAGF,CAAC"}

package/dist/types/migrate-to-v2-codemod.d.ts

@@ -0,0 +1,3 @@
+import { API, FileInfo, Options } from 'jscodeshift';
+export default function transformer(file: FileInfo, api: API, options: Options): string;
+//# sourceMappingURL=migrate-to-v2-codemod.d.ts.map

package/dist/types/migrate-to-v2-codemod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-to-v2-codemod.d.ts","sourceRoot":"","sources":["../../src/migrate-to-v2-codemod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EAGH,QAAQ,EAER,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,OAAO,UA2EjB"}

package/dist/types/qraftPredefinedParametersRequestFn.d.ts

@@ -0,0 +1,19 @@
+import type { RequestFn } from './lib/requestFn.js';
+export type QraftPredefinedParameterValue<TValue> = TValue | (() => Promise<TValue | undefined>) | undefined;
+export type InputPredefinedParametersItem<TValue> = {
+    requestPattern: string;
+    parameters: Array<{
+        in: 'header' | 'query' | 'cookie';
+        name: string;
+        value: QraftPredefinedParameterValue<TValue>;
+    }>;
+};
+type TargetPredefinedParametersMethods = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'options' | 'head' | 'trace';
+export type TargetPredefinedParametersItem = {
+    requestPattern: string;
+    methods: Array<TargetPredefinedParametersMethods> | ReadonlyArray<Readonly<TargetPredefinedParametersMethods>>;
+    paths: Array<string> | ReadonlyArray<Readonly<string>>;
+};
+export declare function qraftPredefinedParametersRequestFn<TInputPredefinedParametersItem extends InputPredefinedParametersItem<any>, TData, TError>(inputPredefinedParameters: Array<TInputPredefinedParametersItem> | ReadonlyArray<Readonly<TInputPredefinedParametersItem>>, targetPredefinedParameters: Array<TargetPredefinedParametersItem> | ReadonlyArray<Readonly<TargetPredefinedParametersItem>>, requestFn: RequestFn<TData, TError>): RequestFn<TData, TError>;
+export {};
+//# sourceMappingURL=qraftPredefinedParametersRequestFn.d.ts.map

package/dist/types/qraftPredefinedParametersRequestFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qraftPredefinedParametersRequestFn.d.ts","sourceRoot":"","sources":["../../src/qraftPredefinedParametersRequestFn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAIV,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,6BAA6B,CAAC,MAAM,IAC5C,MAAM,GACN,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,GACnC,SAAS,CAAC;AAEd,MAAM,MAAM,6BAA6B,CAAC,MAAM,IAAI;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC;KAC9C,CAAC,CAAC;CACJ,CAAC;AAEF,KAAK,iCAAiC,GAClC,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,8BAA8B,GAAG;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EACH,KAAK,CAAC,iCAAiC,CAAC,GACxC,aAAa,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAC/D,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF,wBAAgB,kCAAkC,CAChD,8BAA8B,SAAS,6BAA6B,CAAC,GAAG,CAAC,EACzE,KAAK,EACL,MAAM,EAEN,yBAAyB,EACrB,KAAK,CAAC,8BAA8B,CAAC,GACrC,aAAa,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,EAC3D,0BAA0B,EACtB,KAAK,CAAC,8BAA8B,CAAC,GACrC,aAAa,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,EAC3D,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,GAClC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CA6C1B"}

package/dist/types/service-operation/ServiceOperationGetQueryState.d.ts

@@ -1,11 +1,12 @@
 import type { DefaultError, QueryState } from '@tanstack/query-core';
 import type { OperationInfiniteData } from './OperationInfiniteData.js';
 import type { ServiceOperationInfiniteQueryKey, ServiceOperationQueryKey } from './ServiceOperationKey.js';
+import { AreAllOptional } from '../lib/AreAllOptional.js';
 export interface ServiceOperationGetQueryState<TSchema extends {
     url: string;
     method: string;
-}, TData, TParams = {}, TError = DefaultError> {
-    getQueryState(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>): QueryState<TData, TError> | undefined;
-    getInfiniteQueryState(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>): QueryState<OperationInfiniteData<TData, TParams>, TError> | undefined;
+}, TData, TParams, TError = DefaultError> {
+    getQueryState(parameters: AreAllOptional<TParams> extends true ? TParams | ServiceOperationQueryKey<TSchema, TParams> | void : TParams | ServiceOperationQueryKey<TSchema, TParams>): QueryState<TData, TError> | undefined;
+    getInfiniteQueryState(parameters: AreAllOptional<TParams> extends true ? TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams> | void : TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>): QueryState<OperationInfiniteData<TData, TParams>, TError> | undefined;
 }
 //# sourceMappingURL=ServiceOperationGetQueryState.d.ts.map

package/dist/types/service-operation/ServiceOperationGetQueryState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceOperationGetQueryState.d.ts","sourceRoot":"","sources":["../../../src/service-operation/ServiceOperationGetQueryState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACV,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,6BAA6B,CAC5C,OAAO,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC/C,KAAK,EACL,OAAO,GAAG,EAAE,EACZ,MAAM,GAAG,YAAY;IAErB,aAAa,CACX,UAAU,EAAE,OAAO,GAAG,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,GAC/D,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAEzC,qBAAqB,CACnB,UAAU,EAAE,OAAO,GAAG,gCAAgC,CAAC,OAAO,EAAE,OAAO,CAAC,GACvE,UAAU,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1E"}
+{"version":3,"file":"ServiceOperationGetQueryState.d.ts","sourceRoot":"","sources":["../../../src/service-operation/ServiceOperationGetQueryState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACV,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,6BAA6B,CAC5C,OAAO,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC/C,KAAK,EACL,OAAO,EACP,MAAM,GAAG,YAAY;IAErB,aAAa,CACX,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS,IAAI,GAC5C,OAAO,GAAG,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,GAC3D,OAAO,GAAG,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,GACvD,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAEzC,qBAAqB,CACnB,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS,IAAI,GAC5C,OAAO,GAAG,gCAAgC,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,GACnE,OAAO,GAAG,gCAAgC,CAAC,OAAO,EAAE,OAAO,CAAC,GAC/D,UAAU,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openapi-qraft/react",
-  "version": "2.0.0-next.0",
+  "version": "2.0.0-next.2",
   "description": "API client for React, providing type-safe requests and dynamic Tanstack Query React Hooks via a modular, Proxy-based architecture.",
   "scripts": {
     "build": "NODE_ENV=production rollup --config rollup.config.mjs && tsc --project tsconfig.build.json --emitDeclarationOnly",
@@ -15,20 +15,22 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@openapi-qraft/cli": "2.0.0-next.0",
+    "@openapi-qraft/cli": "2.0.0-next.2",
     "@openapi-qraft/eslint-config": "1.0.0",
-    "@openapi-qraft/openapi-typescript-plugin": "^1.1.1-next.0",
-    "@openapi-qraft/rollup-config": "1.0.0",
+    "@openapi-qraft/openapi-typescript-plugin": "^1.2.0-next.2",
+    "@openapi-qraft/rollup-config": "1.1.0-next.0",
     "@openapi-qraft/test-fixtures": "1.0.0",
     "@tanstack/react-query": "^5.17.3",
     "@testing-library/jest-dom": "^5.17.0",
     "@testing-library/react": "^13.4.0",
     "@testing-library/user-event": "^14.5.2",
+    "@types/jscodeshift": "^0.11.11",
     "@types/react": "^18.2.47",
     "@vitejs/plugin-react": "latest",
     "@vitest/coverage-v8": "^1.1.3",
     "eslint": "^9.0.0",
     "globals": "^15.0.0",
+    "jscodeshift": "^17.0.0",
     "jsdom": "latest",
     "msw": "^2.0.12",
     "prettier": "^3.3.3",
@@ -66,6 +68,11 @@
       "require": "./dist/cjs/Unstable_QraftSecureRequestFn.cjs",
       "types": "./dist/types/Unstable_QraftSecureRequestFn.d.ts"
     },
+    "./qraftPredefinedParametersRequestFn": {
+      "import": "./dist/esm/qraftPredefinedParametersRequestFn.js",
+      "require": "./dist/cjs/qraftPredefinedParametersRequestFn.cjs",
+      "types": "./dist/types/qraftPredefinedParametersRequestFn.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {

package/src/migrate-to-v2-codemod.ts

@@ -0,0 +1,118 @@
+import {
+  API,
+  ASTPath,
+  CallExpression,
+  FileInfo,
+  MemberExpression,
+  Options,
+} from 'jscodeshift';
+
+export default function transformer(
+  file: FileInfo,
+  api: API,
+  options: Options
+) {
+  const j = api.jscodeshift;
+  const root = j(file.source);
+
+  const methodNames = [
+    'fetchQuery',
+    'fetchInfiniteQuery',
+    'prefetchQuery',
+    'prefetchInfiniteQuery',
+    'getQueryData',
+    'getQueriesData',
+    'setQueryData',
+    'getQueryState',
+    'setQueriesData',
+    'invalidateQueries',
+    'refetchQueries',
+    'cancelQueries',
+    'removeQueries',
+    'resetQueries',
+    'isFetching',
+    'isMutating',
+    'setInfiniteQueryData',
+    'getInfiniteQueryData',
+    'getInfiniteQueryState',
+  ];
+
+  const hooksWithTwoArgs = [
+    'useSuspenseQueries',
+    'useIsFetching',
+    'useMutationState',
+    'useIsMutating',
+  ];
+
+  const hooksWithThreeArgs = [
+    'useQuery',
+    'useMutation',
+    'useInfiniteQuery',
+    'useQueries',
+    'useSuspenseQuery',
+    'useSuspenseInfiniteQuery',
+  ];
+
+  const apiClientVariableNames = getAPIClientVariableNames(options);
+
+  return root
+    .find(j.CallExpression)
+    .forEach((path: ASTPath<CallExpression>) => {
+      const callee = path.node.callee;
+      if (callee.type === 'MemberExpression') {
+        const apiClientCallMethodName = getAPIClientCallMethodName(
+          callee,
+          apiClientVariableNames
+        );
+        if (apiClientCallMethodName) {
+          if (methodNames.includes(apiClientCallMethodName)) {
+            // Remove the last argument `queryClient`
+            path.node.arguments = path.node.arguments.slice(0, -1);
+          } else if (
+            hooksWithTwoArgs.includes(apiClientCallMethodName) &&
+            path.node.arguments.length === 2
+          ) {
+            // Remove the second argument for specific hooks if there are exactly two arguments
+            path.node.arguments = path.node.arguments.slice(0, 1);
+          } else if (
+            hooksWithThreeArgs.includes(apiClientCallMethodName) &&
+            path.node.arguments.length === 3
+          ) {
+            // Remove the third argument for specific hooks if there are exactly three arguments
+            path.node.arguments = path.node.arguments.slice(0, 2);
+          }
+        }
+      }
+    })
+    .toSource();
+}
+
+function getAPIClientCallMethodName(
+  node: MemberExpression,
+  apiClientNames: string[]
+): string | undefined {
+  if (
+    node.object.type === 'MemberExpression' &&
+    node.object.object.type === 'MemberExpression' &&
+    node.object.object.object.type === 'Identifier' &&
+    node.object.object.property.type === 'Identifier' &&
+    node.object.property.type === 'Identifier' &&
+    node.property.type === 'Identifier'
+  ) {
+    const apiClientVariableName = node.object.object.object.name;
+
+    if (apiClientNames.includes(apiClientVariableName))
+      return node.property.name;
+  }
+}
+
+function getAPIClientVariableNames(options: Options) {
+  const apiClientVariableNameOption = options['api-client-variable-name'];
+
+  if (!apiClientVariableNameOption) return ['api', 'qraft'];
+
+  return String(apiClientVariableNameOption)
+    .split(',')
+    .map((name) => name.trim())
+    .filter(Boolean);
+}

package/src/qraftPredefinedParametersRequestFn.ts

@@ -0,0 +1,149 @@
+import type {
+  OperationSchema,
+  RequestFn,
+  RequestFnInfo,
+  RequestFnOptions,
+  RequestFnResponse,
+} from './lib/requestFn.js';
+import { shelfMerge } from './lib/shelfMerge.js';
+
+export type QraftPredefinedParameterValue<TValue> =
+  | TValue
+  | (() => Promise<TValue | undefined>)
+  | undefined;
+
+export type InputPredefinedParametersItem<TValue> = {
+  requestPattern: string;
+  parameters: Array<{
+    in: 'header' | 'query' | 'cookie';
+    name: string;
+    value: QraftPredefinedParameterValue<TValue>;
+  }>;
+};
+
+type TargetPredefinedParametersMethods =
+  | 'get'
+  | 'post'
+  | 'put'
+  | 'patch'
+  | 'delete'
+  | 'options'
+  | 'head'
+  | 'trace';
+
+export type TargetPredefinedParametersItem = {
+  requestPattern: string;
+  methods:
+    | Array<TargetPredefinedParametersMethods>
+    | ReadonlyArray<Readonly<TargetPredefinedParametersMethods>>;
+  paths: Array<string> | ReadonlyArray<Readonly<string>>;
+};
+
+export function qraftPredefinedParametersRequestFn<
+  TInputPredefinedParametersItem extends InputPredefinedParametersItem<any>,
+  TData,
+  TError,
+>(
+  inputPredefinedParameters:
+    | Array<TInputPredefinedParametersItem>
+    | ReadonlyArray<Readonly<TInputPredefinedParametersItem>>,
+  targetPredefinedParameters:
+    | Array<TargetPredefinedParametersItem>
+    | ReadonlyArray<Readonly<TargetPredefinedParametersItem>>,
+  requestFn: RequestFn<TData, TError>
+): RequestFn<TData, TError> {
+  return function predefinedParametersRequestFn(
+    schema: OperationSchema,
+    requestInfo: RequestFnInfo,
+    options?: RequestFnOptions
+  ): Promise<RequestFnResponse<TData, TError>> {
+    const matchingInputPredefinedParameters =
+      targetPredefinedParameters.flatMap((targetParameter) =>
+        targetParameter.paths.includes(schema.url) &&
+        (!targetParameter.methods.length ||
+          targetParameter.methods.includes(schema.method))
+          ? inputPredefinedParameters.filter(
+              (predefinedParameter) =>
+                predefinedParameter.requestPattern ===
+                targetParameter.requestPattern
+            )
+          : []
+      );
+
+    if (!matchingInputPredefinedParameters?.length)
+      return requestFn(schema, requestInfo, options);
+
+    return Promise.all(
+      matchingInputPredefinedParameters.map((item) =>
+        resolveQraftPredefinedParameters(item.parameters)
+      )
+    ).then((resolvedPredefinedParameters) => {
+      const mergedParameters = resolvedPredefinedParameters.reduce(
+        (acc, item) => {
+          acc = shelfMerge(2, acc, item);
+          return acc;
+        },
+        {}
+      );
+
+      return requestFn(
+        schema,
+        {
+          ...requestInfo,
+          parameters: shelfMerge(2, mergedParameters, requestInfo.parameters),
+        },
+        options
+      );
+    });
+  };
+}
+
+async function resolveQraftPredefinedParameters<T>(
+  predefinedParameters: InputPredefinedParametersItem<T>['parameters']
+) {
+  return Promise.all(
+    predefinedParameters.map(async (predefinedParameter) => {
+      return {
+        ...predefinedParameter,
+        value: await resolveQraftPredefinedParameterValue(
+          predefinedParameter.value
+        ),
+      };
+    })
+  ).then((resolvedPredefinedParameters) =>
+    resolvedPredefinedParameters
+      .filter(
+        (resolvedPredefinedParameter) =>
+          resolvedPredefinedParameter.value !== undefined
+      )
+      .reduce(
+        (acc, resolvedPredefinedParameter) => {
+          acc[resolvedPredefinedParameter.in] =
+            acc[resolvedPredefinedParameter.in] ?? {};
+
+          acc[resolvedPredefinedParameter.in][
+            resolvedPredefinedParameter.name
+          ] = resolvedPredefinedParameter.value;
+
+          return acc;
+        },
+        {} as Record<string, Record<string, unknown>>
+      )
+  );
+}
+
+type QraftPredefinedParameterResolvedValue<TData> = TData extends () => Promise<
+  infer TAsyncData
+>
+  ? TAsyncData
+  : TData;
+
+async function resolveQraftPredefinedParameterValue<TData>(
+  value: QraftPredefinedParameterValue<TData>
+): Promise<QraftPredefinedParameterResolvedValue<TData>> {
+  if (value && typeof value === 'function')
+    return (await (
+      value as () => Promise<TData | undefined>
+    )()) as QraftPredefinedParameterResolvedValue<TData>;
+  return value as QraftPredefinedParameterResolvedValue<TData>;
+}

package/src/service-operation/ServiceOperationGetQueryState.ts

@@ -4,18 +4,23 @@ import type {
   ServiceOperationInfiniteQueryKey,
   ServiceOperationQueryKey,
 } from './ServiceOperationKey.js';
+import { AreAllOptional } from '../lib/AreAllOptional.js';
 
 export interface ServiceOperationGetQueryState<
   TSchema extends { url: string; method: string },
   TData,
-  TParams = {},
+  TParams,
   TError = DefaultError,
 > {
   getQueryState(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>
+    parameters: AreAllOptional<TParams> extends true
+      ? TParams | ServiceOperationQueryKey<TSchema, TParams> | void
+      : TParams | ServiceOperationQueryKey<TSchema, TParams>
   ): QueryState<TData, TError> | undefined;
 
   getInfiniteQueryState(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>
+    parameters: AreAllOptional<TParams> extends true
+      ? TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams> | void
+      : TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>
   ): QueryState<OperationInfiniteData<TData, TParams>, TError> | undefined;
 }