@openapi-qraft/react 1.11.0-beta.0 → 1.11.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/cjs/index.cjs +2 -0
  3. package/dist/cjs/index.cjs.map +1 -1
  4. package/dist/esm/index.js +1 -0
  5. package/dist/types/QraftContext.d.ts +20 -0
  6. package/dist/types/QraftContext.d.ts.map +1 -0
  7. package/dist/types/ServiceOperation.d.ts +44 -0
  8. package/dist/types/ServiceOperation.d.ts.map +1 -0
  9. package/dist/types/Unstable_QraftSecureRequestFn.d.ts +81 -0
  10. package/dist/types/Unstable_QraftSecureRequestFn.d.ts.map +1 -0
  11. package/dist/types/callbacks/cancelQueries.d.ts +5 -0
  12. package/dist/types/callbacks/cancelQueries.d.ts.map +1 -0
  13. package/dist/types/callbacks/fetchInfiniteQuery.d.ts +7 -0
  14. package/dist/types/callbacks/fetchInfiniteQuery.d.ts.map +1 -0
  15. package/dist/types/callbacks/fetchQuery.d.ts +7 -0
  16. package/dist/types/callbacks/fetchQuery.d.ts.map +1 -0
  17. package/dist/types/callbacks/getInfiniteQueryData.d.ts +6 -0
  18. package/dist/types/callbacks/getInfiniteQueryData.d.ts.map +1 -0
  19. package/dist/types/callbacks/getInfiniteQueryKey.d.ts +5 -0
  20. package/dist/types/callbacks/getInfiniteQueryKey.d.ts.map +1 -0
  21. package/dist/types/callbacks/getInfiniteQueryState.d.ts +5 -0
  22. package/dist/types/callbacks/getInfiniteQueryState.d.ts.map +1 -0
  23. package/dist/types/callbacks/getMutationKey.d.ts +5 -0
  24. package/dist/types/callbacks/getMutationKey.d.ts.map +1 -0
  25. package/dist/types/callbacks/getQueriesData.d.ts +5 -0
  26. package/dist/types/callbacks/getQueriesData.d.ts.map +1 -0
  27. package/dist/types/callbacks/getQueryData.d.ts +5 -0
  28. package/dist/types/callbacks/getQueryData.d.ts.map +1 -0
  29. package/dist/types/callbacks/getQueryKey.d.ts +5 -0
  30. package/dist/types/callbacks/getQueryKey.d.ts.map +1 -0
  31. package/dist/types/callbacks/getQueryState.d.ts +5 -0
  32. package/dist/types/callbacks/getQueryState.d.ts.map +1 -0
  33. package/dist/types/callbacks/index.d.ts +36 -0
  34. package/dist/types/callbacks/index.d.ts.map +1 -0
  35. package/dist/types/callbacks/invalidateQueries.d.ts +5 -0
  36. package/dist/types/callbacks/invalidateQueries.d.ts.map +1 -0
  37. package/dist/types/callbacks/isFetching.d.ts +5 -0
  38. package/dist/types/callbacks/isFetching.d.ts.map +1 -0
  39. package/dist/types/callbacks/isMutating.d.ts +5 -0
  40. package/dist/types/callbacks/isMutating.d.ts.map +1 -0
  41. package/dist/types/callbacks/mutationFn.d.ts +4 -0
  42. package/dist/types/callbacks/mutationFn.d.ts.map +1 -0
  43. package/dist/types/callbacks/operationInvokeFn.d.ts +9 -0
  44. package/dist/types/callbacks/operationInvokeFn.d.ts.map +1 -0
  45. package/dist/types/callbacks/prefetchInfiniteQuery.d.ts +7 -0
  46. package/dist/types/callbacks/prefetchInfiniteQuery.d.ts.map +1 -0
  47. package/dist/types/callbacks/prefetchQuery.d.ts +7 -0
  48. package/dist/types/callbacks/prefetchQuery.d.ts.map +1 -0
  49. package/dist/types/callbacks/queryFn.d.ts +7 -0
  50. package/dist/types/callbacks/queryFn.d.ts.map +1 -0
  51. package/dist/types/callbacks/refetchQueries.d.ts +5 -0
  52. package/dist/types/callbacks/refetchQueries.d.ts.map +1 -0
  53. package/dist/types/callbacks/removeQueries.d.ts +5 -0
  54. package/dist/types/callbacks/removeQueries.d.ts.map +1 -0
  55. package/dist/types/callbacks/resetQueries.d.ts +5 -0
  56. package/dist/types/callbacks/resetQueries.d.ts.map +1 -0
  57. package/dist/types/callbacks/setInfiniteQueryData.d.ts +6 -0
  58. package/dist/types/callbacks/setInfiniteQueryData.d.ts.map +1 -0
  59. package/dist/types/callbacks/setQueriesData.d.ts +5 -0
  60. package/dist/types/callbacks/setQueriesData.d.ts.map +1 -0
  61. package/dist/types/callbacks/setQueryData.d.ts +5 -0
  62. package/dist/types/callbacks/setQueryData.d.ts.map +1 -0
  63. package/dist/types/callbacks/useInfiniteQuery.d.ts +7 -0
  64. package/dist/types/callbacks/useInfiniteQuery.d.ts.map +1 -0
  65. package/dist/types/callbacks/useIsFetching.d.ts +5 -0
  66. package/dist/types/callbacks/useIsFetching.d.ts.map +1 -0
  67. package/dist/types/callbacks/useIsMutating.d.ts +7 -0
  68. package/dist/types/callbacks/useIsMutating.d.ts.map +1 -0
  69. package/dist/types/callbacks/useMutation.d.ts +7 -0
  70. package/dist/types/callbacks/useMutation.d.ts.map +1 -0
  71. package/dist/types/callbacks/useMutationState.d.ts +7 -0
  72. package/dist/types/callbacks/useMutationState.d.ts.map +1 -0
  73. package/dist/types/callbacks/useQueries.d.ts +6 -0
  74. package/dist/types/callbacks/useQueries.d.ts.map +1 -0
  75. package/dist/types/callbacks/useQuery.d.ts +7 -0
  76. package/dist/types/callbacks/useQuery.d.ts.map +1 -0
  77. package/dist/types/callbacks/useSuspenseInfiniteQuery.d.ts +7 -0
  78. package/dist/types/callbacks/useSuspenseInfiniteQuery.d.ts.map +1 -0
  79. package/dist/types/callbacks/useSuspenseQueries.d.ts +6 -0
  80. package/dist/types/callbacks/useSuspenseQueries.d.ts.map +1 -0
  81. package/dist/types/callbacks/useSuspenseQuery.d.ts +7 -0
  82. package/dist/types/callbacks/useSuspenseQuery.d.ts.map +1 -0
  83. package/dist/types/index.d.ts +7 -0
  84. package/dist/types/index.d.ts.map +1 -0
  85. package/dist/types/lib/PartialParameters.type.d.ts +13 -0
  86. package/dist/types/lib/PartialParameters.type.d.ts.map +1 -0
  87. package/dist/types/lib/callQueryClientFetchMethod.d.ts +20 -0
  88. package/dist/types/lib/callQueryClientFetchMethod.d.ts.map +1 -0
  89. package/dist/types/lib/callQueryClientMethodWithMutationFilters.d.ts +11 -0
  90. package/dist/types/lib/callQueryClientMethodWithMutationFilters.d.ts.map +1 -0
  91. package/dist/types/lib/callQueryClientMethodWithQueryFilters.d.ts +11 -0
  92. package/dist/types/lib/callQueryClientMethodWithQueryFilters.d.ts.map +1 -0
  93. package/dist/types/lib/callQueryClientMethodWithQueryKey.d.ts +11 -0
  94. package/dist/types/lib/callQueryClientMethodWithQueryKey.d.ts.map +1 -0
  95. package/dist/types/lib/composeBaseQueryKey.d.ts +6 -0
  96. package/dist/types/lib/composeBaseQueryKey.d.ts.map +1 -0
  97. package/dist/types/lib/composeInfiniteQueryKey.d.ts +4 -0
  98. package/dist/types/lib/composeInfiniteQueryKey.d.ts.map +1 -0
  99. package/dist/types/lib/composeMutationFilters.d.ts +11 -0
  100. package/dist/types/lib/composeMutationFilters.d.ts.map +1 -0
  101. package/dist/types/lib/composeMutationKey.d.ts +10 -0
  102. package/dist/types/lib/composeMutationKey.d.ts.map +1 -0
  103. package/dist/types/lib/composeQueryFilters.d.ts +14 -0
  104. package/dist/types/lib/composeQueryFilters.d.ts.map +1 -0
  105. package/dist/types/lib/composeQueryKey.d.ts +4 -0
  106. package/dist/types/lib/composeQueryKey.d.ts.map +1 -0
  107. package/dist/types/lib/createRecursiveProxy.d.ts +15 -0
  108. package/dist/types/lib/createRecursiveProxy.d.ts.map +1 -0
  109. package/dist/types/lib/jwt-decode/index.d.ts +29 -0
  110. package/dist/types/lib/jwt-decode/index.d.ts.map +1 -0
  111. package/dist/types/lib/jwt-decode/index.test.d.ts +2 -0
  112. package/dist/types/lib/jwt-decode/index.test.d.ts.map +1 -0
  113. package/dist/types/lib/requestFn.d.ts +100 -0
  114. package/dist/types/lib/requestFn.d.ts.map +1 -0
  115. package/dist/types/lib/shelfMerge.d.ts +7 -0
  116. package/dist/types/lib/shelfMerge.d.ts.map +1 -0
  117. package/dist/types/lib/useComposeUseQueryOptions.d.ts +16 -0
  118. package/dist/types/lib/useComposeUseQueryOptions.d.ts.map +1 -0
  119. package/dist/types/lib/useQueryClient.d.ts +9 -0
  120. package/dist/types/lib/useQueryClient.d.ts.map +1 -0
  121. package/dist/types/qraftAPIClient.d.ts +24 -0
  122. package/dist/types/qraftAPIClient.d.ts.map +1 -0
  123. package/dist/types/service-operation/OperationInfiniteData.d.ts +4 -0
  124. package/dist/types/service-operation/OperationInfiniteData.d.ts.map +1 -0
  125. package/dist/types/service-operation/QueryFilters.d.ts +123 -0
  126. package/dist/types/service-operation/QueryFilters.d.ts.map +1 -0
  127. package/dist/types/service-operation/ServiceOperation.d.ts +53 -0
  128. package/dist/types/service-operation/ServiceOperation.d.ts.map +1 -0
  129. package/dist/types/service-operation/ServiceOperationCancelQueries.d.ts +20 -0
  130. package/dist/types/service-operation/ServiceOperationCancelQueries.d.ts.map +1 -0
  131. package/dist/types/service-operation/ServiceOperationFetchInfiniteQuery.d.ts +58 -0
  132. package/dist/types/service-operation/ServiceOperationFetchInfiniteQuery.d.ts.map +1 -0
  133. package/dist/types/service-operation/ServiceOperationFetchQuery.d.ts +49 -0
  134. package/dist/types/service-operation/ServiceOperationFetchQuery.d.ts.map +1 -0
  135. package/dist/types/service-operation/ServiceOperationGetInfiniteQueryData.d.ts +10 -0
  136. package/dist/types/service-operation/ServiceOperationGetInfiniteQueryData.d.ts.map +1 -0
  137. package/dist/types/service-operation/ServiceOperationGetQueriesData.d.ts +18 -0
  138. package/dist/types/service-operation/ServiceOperationGetQueriesData.d.ts.map +1 -0
  139. package/dist/types/service-operation/ServiceOperationGetQueryData.d.ts +9 -0
  140. package/dist/types/service-operation/ServiceOperationGetQueryData.d.ts.map +1 -0
  141. package/dist/types/service-operation/ServiceOperationGetQueryState.d.ts +11 -0
  142. package/dist/types/service-operation/ServiceOperationGetQueryState.d.ts.map +1 -0
  143. package/dist/types/service-operation/ServiceOperationInvalidateQueries.d.ts +26 -0
  144. package/dist/types/service-operation/ServiceOperationInvalidateQueries.d.ts.map +1 -0
  145. package/dist/types/service-operation/ServiceOperationIsFetchingQueries.d.ts +19 -0
  146. package/dist/types/service-operation/ServiceOperationIsFetchingQueries.d.ts.map +1 -0
  147. package/dist/types/service-operation/ServiceOperationIsMutatingQueries.d.ts +19 -0
  148. package/dist/types/service-operation/ServiceOperationIsMutatingQueries.d.ts.map +1 -0
  149. package/dist/types/service-operation/ServiceOperationKey.d.ts +16 -0
  150. package/dist/types/service-operation/ServiceOperationKey.d.ts.map +1 -0
  151. package/dist/types/service-operation/ServiceOperationMutationFn.d.ts +47 -0
  152. package/dist/types/service-operation/ServiceOperationMutationFn.d.ts.map +1 -0
  153. package/dist/types/service-operation/ServiceOperationQueryFn.d.ts +79 -0
  154. package/dist/types/service-operation/ServiceOperationQueryFn.d.ts.map +1 -0
  155. package/dist/types/service-operation/ServiceOperationRefetchQueries.d.ts +30 -0
  156. package/dist/types/service-operation/ServiceOperationRefetchQueries.d.ts.map +1 -0
  157. package/dist/types/service-operation/ServiceOperationRemoveQueries.d.ts +19 -0
  158. package/dist/types/service-operation/ServiceOperationRemoveQueries.d.ts.map +1 -0
  159. package/dist/types/service-operation/ServiceOperationResetQueries.d.ts +20 -0
  160. package/dist/types/service-operation/ServiceOperationResetQueries.d.ts.map +1 -0
  161. package/dist/types/service-operation/ServiceOperationSetInfiniteQueryData.d.ts +10 -0
  162. package/dist/types/service-operation/ServiceOperationSetInfiniteQueryData.d.ts.map +1 -0
  163. package/dist/types/service-operation/ServiceOperationSetQueriesData.d.ts +20 -0
  164. package/dist/types/service-operation/ServiceOperationSetQueriesData.d.ts.map +1 -0
  165. package/dist/types/service-operation/ServiceOperationSetQueryData.d.ts +19 -0
  166. package/dist/types/service-operation/ServiceOperationSetQueryData.d.ts.map +1 -0
  167. package/dist/types/service-operation/ServiceOperationUseInfiniteQuery.d.ts +14 -0
  168. package/dist/types/service-operation/ServiceOperationUseInfiniteQuery.d.ts.map +1 -0
  169. package/dist/types/service-operation/ServiceOperationUseIsFetchingQueries.d.ts +9 -0
  170. package/dist/types/service-operation/ServiceOperationUseIsFetchingQueries.d.ts.map +1 -0
  171. package/dist/types/service-operation/ServiceOperationUseIsMutating.d.ts +9 -0
  172. package/dist/types/service-operation/ServiceOperationUseIsMutating.d.ts.map +1 -0
  173. package/dist/types/service-operation/ServiceOperationUseMutation.d.ts +17 -0
  174. package/dist/types/service-operation/ServiceOperationUseMutation.d.ts.map +1 -0
  175. package/dist/types/service-operation/ServiceOperationUseMutationState.d.ts +46 -0
  176. package/dist/types/service-operation/ServiceOperationUseMutationState.d.ts.map +1 -0
  177. package/dist/types/service-operation/ServiceOperationUseQueries.d.ts +20 -0
  178. package/dist/types/service-operation/ServiceOperationUseQueries.d.ts.map +1 -0
  179. package/dist/types/service-operation/ServiceOperationUseQuery.d.ts +12 -0
  180. package/dist/types/service-operation/ServiceOperationUseQuery.d.ts.map +1 -0
  181. package/dist/types/service-operation/ServiceOperationUseSuspenseInfiniteQuery.d.ts +12 -0
  182. package/dist/types/service-operation/ServiceOperationUseSuspenseInfiniteQuery.d.ts.map +1 -0
  183. package/dist/types/service-operation/ServiceOperationUseSuspenseQueries.d.ts +18 -0
  184. package/dist/types/service-operation/ServiceOperationUseSuspenseQueries.d.ts.map +1 -0
  185. package/dist/types/service-operation/ServiceOperationUseSuspenseQueryQuery.d.ts +10 -0
  186. package/dist/types/service-operation/ServiceOperationUseSuspenseQueryQuery.d.ts.map +1 -0
  187. package/dist/types/service-operation/index.d.ts +2 -0
  188. package/dist/types/service-operation/index.d.ts.map +1 -0
  189. package/package.json +8 -8
  190. package/src/index.ts +2 -0
  191. package/dist/cjs/index.d.cts +0 -1034
  192. package/dist/esm/index.d.ts +0 -1034
@@ -1,1034 +0,0 @@
1
- import * as react from 'react';
2
- import { Context, ReactNode } from 'react';
3
- import { QueryClient, UseMutationOptions, UseMutationResult, UndefinedInitialDataInfiniteOptions, UseInfiniteQueryResult, DefinedInitialDataInfiniteOptions, DefinedUseInfiniteQueryResult, UseQueryResult, UseQueryOptions, UndefinedInitialDataOptions, DefinedInitialDataOptions, DefinedUseQueryResult, UseSuspenseInfiniteQueryOptions, UseSuspenseInfiniteQueryResult, UseSuspenseQueryResult, UseSuspenseQueryOptions, QueriesResults, SuspenseQueriesResults } from '@tanstack/react-query';
4
- import { InfiniteData, DefaultError, FetchStatus, Query, CancelOptions, QueryClient as QueryClient$1, QueryFunction, FetchQueryOptions, InitialPageParam, GetNextPageParamFunction, NoInfer, QueryState, InvalidateOptions, MutationState, Mutation, MutationStatus, ResetOptions, RefetchOptions, Updater, SetDataOptions, InfiniteQueryPageParamsOptions, QueriesPlaceholderDataFunction } from '@tanstack/query-core';
5
-
6
- /**
7
- * This function is used to make a request to a specified endpoint.
8
- *
9
- * @template T The expected return type of the request.
10
- *
11
- * @param schema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.
12
- * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.
13
- * @param [options] Optional. Additional options for the request. It includes custom urlSerializer, bodySerializer, and fetch function.
14
- *
15
- * @returns {Promise<T>} Returns a promise that resolves with the response of the request.
16
- *
17
- * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.
18
- */
19
- declare function requestFn<T>(schema: OperationSchema, requestInfo: RequestFnInfo, options?: RequestFnOptions): Promise<T>;
20
- /**
21
- * This function is used to make a request to a specified endpoint.
22
- * It's needed to create a custom `requestFn` with a custom `urlSerializer`
23
- * and `bodySerializer`, with the tree-shaking of the default `requestFn`
24
- * and its serializers.
25
- *
26
- * @template T The expected return type of the request.
27
- *
28
- * @param requestSchema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.
29
- * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.
30
- * @param options The options for the request. It includes urlSerializer, bodySerializer, and fetch function. The 'urlSerializer' and 'bodySerializer' are required.
31
- *
32
- * @returns {Promise<T>} Returns a promise that resolves with the response of the request.
33
- *
34
- * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.
35
- */
36
- declare function baseRequestFn<T>(requestSchema: OperationSchema, requestInfo: RequestFnInfo, options: WithRequired<RequestFnOptions, 'urlSerializer' | 'bodySerializer'>): Promise<T>;
37
- declare function urlSerializer(schema: OperationSchema, info: RequestFnPayload): string;
38
- declare function bodySerializer(schema: OperationSchema, info: RequestFnPayload): string | Blob | FormData | undefined;
39
- type HeadersOptions = HeadersInit | Record<string, string | number | boolean | null | undefined>;
40
- interface OperationSchema {
41
- /**
42
- * Operation path
43
- * @example /user/{id}
44
- */
45
- readonly url: string;
46
- /**
47
- * Operation method
48
- */
49
- readonly method: 'get' | 'put' | 'post' | 'patch' | 'delete' | 'options' | 'head' | 'trace';
50
- /**
51
- * Media type of the request body
52
- * @example application/json
53
- */
54
- readonly mediaType?: string;
55
- readonly security?: string[];
56
- }
57
- interface RequestFnPayload {
58
- /**
59
- * Base URL to use for the request
60
- * @example 'https://api.example.com'
61
- */
62
- baseUrl: string | undefined;
63
- /**
64
- * OpenAPI parameters
65
- * @example
66
- * ```ts
67
- * { path: {id: 1}, query: {search: 'hello'} }
68
- * ```
69
- */
70
- readonly parameters?: {
71
- readonly path?: Record<string, any>;
72
- readonly header?: Record<string, any>;
73
- readonly query?: Record<string, any>;
74
- };
75
- /**
76
- * Request body
77
- * @example { name: 'John' }
78
- */
79
- readonly body?: BodyInit | Record<string, unknown> | null;
80
- /**
81
- * Tanstack Query Meta
82
- */
83
- meta?: Record<string, unknown>;
84
- /** An AbortSignal to set request's signal. */
85
- signal?: AbortSignal | null;
86
- }
87
- interface RequestFnInfo extends RequestFnPayload, Omit<RequestInit, 'headers' | 'method' | 'body' | 'signal'> {
88
- /**
89
- * Request headers
90
- * @example { 'X-Auth': '123' }
91
- */
92
- readonly headers?: HeadersOptions;
93
- }
94
- interface RequestFnOptions {
95
- urlSerializer?: typeof urlSerializer;
96
- bodySerializer?: typeof bodySerializer;
97
- fetch?: typeof fetch;
98
- }
99
- type RequestFn$1<T> = typeof requestFn<T>;
100
- type WithRequired<T, K extends keyof T> = T & {
101
- [_ in K]: {};
102
- };
103
-
104
- interface QraftContextValueBase {
105
- /**
106
- * Base URL to use for the request
107
- * @example 'https://api.example.com'
108
- */
109
- baseUrl?: string;
110
- /**
111
- * The `requestFn` will be invoked with every request.
112
- */
113
- requestFn<T>(requestSchema: OperationSchema, requestInfo: RequestFnPayload): Promise<T>;
114
- /** The QueryClient to use in Hooks */
115
- queryClient?: QueryClient;
116
- }
117
- type QraftContextValue = QraftContextValueBase | undefined;
118
- declare const QraftContext: react.Context<QraftContextValue>;
119
-
120
- interface QraftClientOptions {
121
- context?: Context<QraftContextValue>;
122
- }
123
- declare const qraftAPIClient: <Services extends ServicesBaseDeclaration<Services>, Callbacks extends ServicesCallbacks>(services: ServicesDeclaration<Services>, callbacks: Callbacks, options?: QraftClientOptions) => Services;
124
- type ServicesBaseDeclaration<Services> = {
125
- [service in keyof Services]: {
126
- [method in keyof Services[service]]: {
127
- schema: OperationSchema;
128
- };
129
- };
130
- };
131
- type ServicesDeclaration<Services extends ServicesBaseDeclaration<Services>> = {
132
- [service in keyof Services]: {
133
- [method in keyof Services[service]]: {
134
- schema: Services[service][method]['schema'];
135
- };
136
- };
137
- };
138
- type ServicesCallbacks = Record<string, (...rest: any[]) => unknown>;
139
-
140
- /**
141
- * Shallow partial 'parameters'.
142
- * @example
143
- * ```ts
144
- * {query?: {page: number, nested: {still: 'not_partial'}}}
145
- * // =>
146
- * {query?: {page?: number, nested?: {still: 'not_partial'}}}
147
- * ```
148
- */
149
- type PartialParameters<T> = T extends object ? {
150
- [K in keyof T]?: T[K] extends object ? Partial<T[K]> : T[K];
151
- } : T;
152
-
153
- type OperationInfiniteData<TData, TParams> = InfiniteData<TData, PartialParameters<TParams>>;
154
-
155
- type ServiceOperationBaseQueryKey<S extends {
156
- url: string;
157
- method: string;
158
- }, Infinite extends boolean, T> = [S & {
159
- infinite: Infinite;
160
- }, T];
161
- type ServiceOperationQueryKey<S extends {
162
- url: string;
163
- method: string;
164
- }, T> = ServiceOperationBaseQueryKey<S, false, T>;
165
- type ServiceOperationInfiniteQueryKey<S extends {
166
- url: string;
167
- method: string;
168
- }, T> = ServiceOperationBaseQueryKey<S, true, T>;
169
- type ServiceOperationMutationKey<S extends Record<'url' | 'method', string>, T> = NonNullable<T> extends never ? [S] : [S, T];
170
-
171
- type QueryTypeFilter = 'all' | 'active' | 'inactive';
172
- interface QueryFiltersBase<TSchema extends {
173
- url: string;
174
- method: string;
175
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> {
176
- /**
177
- * Include queries matching this predicate function
178
- */
179
- predicate?: TInfinite extends true ? QueryFilterInfinitePredicate<TSchema, TData, TParams, TError> : TInfinite extends false ? QueryFilterRegularPredicate<TSchema, TData, TParams, TError> : (query: string) => boolean;
180
- /**
181
- * Filter to active queries, inactive queries or all queries
182
- */
183
- type?: QueryTypeFilter;
184
- /**
185
- * Include or exclude stale queries
186
- */
187
- stale?: boolean;
188
- /**
189
- * Include queries matching their fetchStatus
190
- */
191
- fetchStatus?: FetchStatus;
192
- }
193
- interface QueryFiltersByQueryKeyBase<TSchema extends {
194
- url: string;
195
- method: string;
196
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> extends QueryFiltersBase<TSchema, TData, TInfinite, TParams, TError> {
197
- infinite?: never;
198
- parameters?: never;
199
- }
200
- interface QueryFiltersByExactQueryKey<TSchema extends {
201
- url: string;
202
- method: string;
203
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> extends QueryFiltersByQueryKeyBase<TSchema, TData, TInfinite, TParams, TError> {
204
- /**
205
- * Include queries matching this query key
206
- */
207
- queryKey: ServiceOperationBaseQueryKey<TSchema, TInfinite, TParams>;
208
- /**
209
- * Match query key exactly
210
- */
211
- exact: true;
212
- }
213
- interface QueryFiltersWeakExactQueryKey<TSchema extends {
214
- url: string;
215
- method: string;
216
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> extends QueryFiltersByQueryKeyBase<TSchema, TData, TInfinite, TParams, TError> {
217
- /**
218
- * Include queries matching this query key
219
- */
220
- queryKey?: ServiceOperationBaseQueryKey<TSchema, TInfinite, PartialParameters<TParams>>;
221
- /**
222
- * Match query key exactly
223
- */
224
- exact?: false;
225
- }
226
- type QueryFiltersByQueryKey<TSchema extends {
227
- url: string;
228
- method: string;
229
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> = QueryFiltersByExactQueryKey<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersWeakExactQueryKey<TSchema, TData, TInfinite, TParams, TError>;
230
- interface QueryFiltersByParametersBase<TSchema extends {
231
- url: string;
232
- method: string;
233
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> extends QueryFiltersBase<TSchema, TData, TInfinite, TParams, TError> {
234
- /**
235
- * Is the query infinite
236
- */
237
- infinite?: TInfinite;
238
- queryKey?: never;
239
- }
240
- interface QueryFiltersByExactParameters<TSchema extends {
241
- url: string;
242
- method: string;
243
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> extends QueryFiltersByParametersBase<TSchema, TData, TInfinite, TParams, TError> {
244
- /**
245
- * Match query key exactly
246
- */
247
- exact: true;
248
- /**
249
- * Include queries matching parameters
250
- */
251
- parameters: TParams;
252
- }
253
- interface QueryFiltersByWeakParameters<TSchema extends {
254
- url: string;
255
- method: string;
256
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> extends QueryFiltersByParametersBase<TSchema, TData, TInfinite, TParams, TError> {
257
- /**
258
- * Match query key exactly
259
- */
260
- exact?: false;
261
- /**
262
- * Include queries matching parameters
263
- */
264
- parameters?: PartialParameters<TParams>;
265
- }
266
- type QueryFiltersByParameters<TSchema extends {
267
- url: string;
268
- method: string;
269
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> = QueryFiltersByExactParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByWeakParameters<TSchema, TData, TInfinite, TParams, TError>;
270
- interface QueryFilterInfinitePredicate<TSchema extends {
271
- url: string;
272
- method: string;
273
- }, TData, TParams = {}, TError = DefaultError> {
274
- /**
275
- * Include queries matching this predicate function
276
- */
277
- (query: Query<OperationInfiniteData<TData, TParams>, TError, OperationInfiniteData<TData, TParams>, ServiceOperationInfiniteQueryKey<TSchema, TParams>>): boolean;
278
- }
279
- interface QueryFilterRegularPredicate<TSchema extends {
280
- url: string;
281
- method: string;
282
- }, TData, TParams = {}, TError = DefaultError> {
283
- /**
284
- * Include queries matching this predicate function
285
- */
286
- (query: Query<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>): boolean;
287
- }
288
-
289
- interface ServiceOperationCancelQueries<TSchema extends {
290
- url: string;
291
- method: string;
292
- }, TData, TParams = {}, TError = DefaultError> {
293
- cancelQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, options: CancelOptions, queryClient: QueryClient$1): Promise<void>;
294
- cancelQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): Promise<void>;
295
- cancelQueries(queryClient: QueryClient$1): Promise<void>;
296
- }
297
- /**
298
- * @internal
299
- */
300
- interface ServiceOperationCancelQueriesCallback<TSchema extends {
301
- url: string;
302
- method: string;
303
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationCancelQueries<TSchema, TData, TParams, TError> {
304
- cancelQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError> | QueryClient$1, options?: CancelOptions | QueryClient$1, queryClient?: QueryClient$1): Promise<void>;
305
- }
306
-
307
- interface ServiceOperationFetchInfiniteQuery<TSchema extends {
308
- url: string;
309
- method: string;
310
- }, TData, TParams = {}, TError = DefaultError> {
311
- fetchInfiniteQuery<TPageParam extends TParams>(options: (FetchInfiniteQueryOptionsByQueryKey<TSchema, TData, TParams, TPageParam, TError> & FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>) | (FetchInfiniteQueryOptionsByParameters<TSchema, TData, TParams, TPageParam, TError> & FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>), queryClient: QueryClient$1): Promise<OperationInfiniteData<TData, TParams>>;
312
- prefetchInfiniteQuery<TPageParam extends TParams>(options: (FetchInfiniteQueryOptionsByQueryKey<TSchema, TData, TParams, TPageParam, TError> & FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>) | (FetchInfiniteQueryOptionsByParameters<TSchema, TData, TParams, TPageParam, TError> & FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>), queryClient: QueryClient$1): Promise<void>;
313
- }
314
- type FetchInfiniteQueryPages<TData = unknown, TPageParam = unknown> = {
315
- pages?: never;
316
- } | {
317
- pages: number;
318
- getNextPageParam: GetNextPageParamFunction<PartialParameters<TPageParam>, TData>;
319
- };
320
- type FetchInfiniteQueryOptionsBase<TSchema extends {
321
- url: string;
322
- method: string;
323
- }, TData, TParams = {}, TPageParam = unknown, TError = DefaultError> = Omit<FetchQueryOptions<TData, TError, OperationInfiniteData<TData, TParams>, ServiceOperationQueryKey<TSchema, TParams>, TPageParam>, 'queryKey'> & InitialPageParam<PartialParameters<TPageParam>> & FetchInfiniteQueryPages<TData, TPageParam>;
324
- type FetchInfiniteQueryOptionsByQueryKey<TSchema extends {
325
- url: string;
326
- method: string;
327
- }, TData, TParams = {}, TPageParam = {}, TError = DefaultError> = FetchInfiniteQueryOptionsBase<TSchema, TData, TParams, TPageParam, TError> & {
328
- /**
329
- * Fetch Queries by query key
330
- */
331
- queryKey?: ServiceOperationInfiniteQueryKey<TSchema, TParams>;
332
- parameters?: never;
333
- };
334
- type FetchInfiniteQueryOptionsByParameters<TSchema extends {
335
- url: string;
336
- method: string;
337
- }, TData, TParams = {}, TPageParam = {}, TError = DefaultError> = FetchInfiniteQueryOptionsBase<TSchema, TData, TParams, TPageParam, TError> & {
338
- /**
339
- * Fetch Queries by parameters
340
- */
341
- parameters?: TParams;
342
- queryKey?: never;
343
- };
344
- type FetchInfiniteQueryOptionsQueryFn<TSchema extends {
345
- url: string;
346
- method: string;
347
- }, TData, TParams = {}> = {
348
- queryFn?: QueryFunction<TData, ServiceOperationInfiniteQueryKey<TSchema, TParams>>;
349
- } | {
350
- requestFn: RequestFn$1<TData>;
351
- /**
352
- * Base URL to use for the request (used in the `queryFn`)
353
- * @example 'https://api.example.com'
354
- */
355
- baseUrl: string | undefined;
356
- queryFn?: never;
357
- };
358
-
359
- interface ServiceOperationFetchQuery<TSchema extends {
360
- url: string;
361
- method: string;
362
- }, TData, TParams = {}, TError = DefaultError> {
363
- fetchQuery(options: (FetchQueryOptionsByQueryKey<TSchema, TData, TParams, TError> & FetchQueryOptionsQueryFn<TSchema, TData, TParams>) | (FetchQueryOptionsByParameters<TSchema, TData, TParams, TError> & FetchQueryOptionsQueryFn<TSchema, TData, TParams>), queryClient: QueryClient$1): Promise<TData>;
364
- prefetchQuery(options: (FetchQueryOptionsByQueryKey<TSchema, TData, TParams, TError> & FetchQueryOptionsQueryFn<TSchema, TData, TParams>) | (FetchQueryOptionsByParameters<TSchema, TData, TParams, TError> & FetchQueryOptionsQueryFn<TSchema, TData, TParams>), queryClient: QueryClient$1): Promise<void>;
365
- }
366
- type FetchQueryOptionsBase<TSchema extends {
367
- url: string;
368
- method: string;
369
- }, TData, TParams = {}, TError = DefaultError> = Omit<FetchQueryOptions<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>, 'queryKey' | 'queryFn'>;
370
- interface FetchQueryOptionsByQueryKey<TSchema extends {
371
- url: string;
372
- method: string;
373
- }, TData, TParams = {}, TError = DefaultError> extends FetchQueryOptionsBase<TSchema, TData, TParams, TError> {
374
- /**
375
- * Fetch Queries by query key
376
- */
377
- queryKey?: ServiceOperationQueryKey<TSchema, TParams>;
378
- }
379
- interface FetchQueryOptionsByParameters<TSchema extends {
380
- url: string;
381
- method: string;
382
- }, TData, TParams = {}, TError = DefaultError> extends FetchQueryOptionsBase<TSchema, TData, TParams, TError> {
383
- /**
384
- * Fetch Queries by parameters
385
- */
386
- parameters?: TParams;
387
- queryKey?: never;
388
- }
389
- type FetchQueryOptionsQueryFn<TSchema extends {
390
- url: string;
391
- method: string;
392
- }, TData, TParams = {}> = {
393
- queryFn?: QueryFunction<TData, ServiceOperationQueryKey<TSchema, TParams>>;
394
- } | {
395
- requestFn: RequestFn$1<TData>;
396
- /**
397
- * Base URL to use for the request (used in the `queryFn`)
398
- * @example 'https://api.example.com'
399
- */
400
- baseUrl: string | undefined;
401
- queryFn?: never;
402
- };
403
-
404
- interface ServiceOperationGetInfiniteQueryData<TSchema extends {
405
- url: string;
406
- method: string;
407
- }, TData, TParams = {}> {
408
- getInfiniteQueryData(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>, queryClient: QueryClient$1): OperationInfiniteData<TData, TParams> | undefined;
409
- }
410
-
411
- interface ServiceOperationGetQueriesData<TSchema extends {
412
- url: string;
413
- method: string;
414
- }, TData, TParams = {}, // todo::try to replace `TParams = {}` with `TParams = undefined`
415
- TError = DefaultError> {
416
- getQueriesData<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): TInfinite extends true ? Array<[
417
- queryKey: ServiceOperationInfiniteQueryKey<TSchema, TParams>,
418
- data: NoInfer<OperationInfiniteData<TData, TParams>> | undefined
419
- ]> : Array<[
420
- queryKey: ServiceOperationQueryKey<TSchema, TParams>,
421
- data: TData | undefined
422
- ]>;
423
- }
424
-
425
- interface ServiceOperationGetQueryData<TSchema extends {
426
- url: string;
427
- method: string;
428
- }, TData, TParams = {}> {
429
- getQueryData(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, queryClient: QueryClient$1): TData | undefined;
430
- }
431
-
432
- interface ServiceOperationGetQueryState<TSchema extends {
433
- url: string;
434
- method: string;
435
- }, TData, TParams = {}, TError = DefaultError> {
436
- getQueryState(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, queryClient: QueryClient$1): QueryState<TData, TError> | undefined;
437
- getInfiniteQueryState(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>, queryClient: QueryClient$1): QueryState<OperationInfiniteData<TData, TParams>, TError> | undefined;
438
- }
439
-
440
- type InvalidateQueryFilters<TSchema extends {
441
- url: string;
442
- method: string;
443
- }, TData, TInfinite extends boolean, TParams = {}, TError = DefaultError> = (QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>) & {
444
- refetchType?: QueryTypeFilter | 'none';
445
- };
446
- interface ServiceOperationInvalidateQueries<TSchema extends {
447
- url: string;
448
- method: string;
449
- }, TData, TParams = {}, TError = DefaultError> {
450
- invalidateQueries<TInfinite extends boolean>(filters: InvalidateQueryFilters<TSchema, TData, TInfinite, TParams, TError>, options: InvalidateOptions, queryClient: QueryClient$1): Promise<void>;
451
- invalidateQueries<TInfinite extends boolean>(filters: InvalidateQueryFilters<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): Promise<void>;
452
- invalidateQueries(queryClient: QueryClient$1): Promise<void>;
453
- }
454
- /**
455
- * @internal
456
- */
457
- interface ServiceOperationInvalidateQueriesCallback<TSchema extends {
458
- url: string;
459
- method: string;
460
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationInvalidateQueries<TSchema, TData, TParams, TError> {
461
- invalidateQueries<TInfinite extends boolean>(filters: InvalidateQueryFilters<TSchema, TData, TInfinite, TParams, TError> | QueryClient$1, options?: InvalidateOptions | QueryClient$1, queryClient?: QueryClient$1): Promise<void>;
462
- }
463
-
464
- interface ServiceOperationIsFetchingQueries<TSchema extends {
465
- url: string;
466
- method: string;
467
- }, TData, TParams = {}, TError = DefaultError> {
468
- isFetching<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): number;
469
- isFetching(queryClient: QueryClient$1): number;
470
- }
471
- /**
472
- * @internal
473
- */
474
- interface ServiceOperationIsFetchingQueriesCallback<TSchema extends {
475
- url: string;
476
- method: string;
477
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationIsFetchingQueries<TSchema, TData, TParams, TError> {
478
- refetchQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError> | QueryClient$1, queryClient?: QueryClient$1): number;
479
- }
480
-
481
- interface ServiceOperationUseMutation<TSchema extends {
482
- url: string;
483
- method: string;
484
- }, TBody, TData, TParams, TError = DefaultError> {
485
- getMutationKey<TMutationKeyParams extends TParams | undefined = undefined>(parameters?: TMutationKeyParams): ServiceOperationMutationKey<TSchema, TMutationKeyParams>;
486
- useMutation<TVariables extends MutationVariables<TBody, TParams>, TContext = unknown>(parameters?: undefined, options?: Omit<UseMutationOptions<TData, TError, TVariables, TContext>, 'mutationKey'> & {
487
- mutationKey?: ServiceOperationMutationKey<TSchema, TParams>;
488
- }, queryClient?: QueryClient$1): UseMutationResult<TData, TError | Error, TVariables, TContext>;
489
- useMutation<TVariables extends TBody, TContext = unknown>(parameters: TParams, options?: Omit<UseMutationOptions<TData, TError, TVariables, TContext>, 'mutationKey'>, queryClient?: QueryClient$1): UseMutationResult<TData, TError | Error, TVariables, TContext>;
490
- }
491
- type MutationVariables<TBody, TParams> = {
492
- body: TBody;
493
- } & (NonNullable<TParams> extends never ? {} : TParams);
494
-
495
- interface UseMutationStateFiltersBase<TBody, TData, TParams, TError = DefaultError, TContext = unknown> {
496
- /**
497
- * Match mutation key exactly
498
- */
499
- exact?: boolean;
500
- /**
501
- * Include mutations matching this predicate function
502
- */
503
- predicate?: (mutation: Mutation<TData, TError, MutationVariables<TBody, TParams>, TContext>) => boolean;
504
- /**
505
- * Filter by mutation status
506
- */
507
- status?: MutationStatus;
508
- }
509
- interface MutationFiltersByParameters<TBody, TData, TParams, TError = DefaultError, TContext = unknown> extends UseMutationStateFiltersBase<TBody, TData, TParams, TError, TContext> {
510
- /**
511
- * Include mutations matching these parameters
512
- */
513
- parameters?: PartialParameters<TParams>;
514
- mutationKey?: never;
515
- }
516
- interface MutationFiltersByMutationKey<TSchema extends {
517
- url: string;
518
- method: string;
519
- }, TBody, TData, TParams, TError = DefaultError, TContext = unknown> extends UseMutationStateFiltersBase<TBody, TData, TParams, TError, TContext> {
520
- /**
521
- * Include mutations matching this mutation key
522
- */
523
- mutationKey?: ServiceOperationMutationKey<TSchema, PartialParameters<TParams>>;
524
- parameters?: never;
525
- }
526
- interface ServiceOperationUseMutationState<TSchema extends {
527
- url: string;
528
- method: string;
529
- }, TBody, TData, TParams, TError = DefaultError> {
530
- useMutationState<TContext = unknown, TResult = MutationState<TData, TError, MutationVariables<TBody, TParams>, TContext>>(options?: {
531
- filters?: MutationFiltersByParameters<TBody, TData, TParams, TError, TContext> | MutationFiltersByMutationKey<TSchema, TBody, TData, TParams, TError, TContext>;
532
- select?: (mutation: Mutation<TData, TError, MutationVariables<TBody, TParams>, TContext>) => TResult;
533
- }, queryClient?: QueryClient$1): Array<TResult>;
534
- }
535
-
536
- interface ServiceOperationIsMutatingQueries<TSchema extends {
537
- url: string;
538
- method: string;
539
- }, TBody, TData, TParams = {}, TError = DefaultError> {
540
- isMutating<TContext>(filters: MutationFiltersByParameters<TBody, TData, TParams, TError, TContext> | MutationFiltersByMutationKey<TSchema, TBody, TData, TParams, TError, TContext>, queryClient: QueryClient$1): number;
541
- isMutating(queryClient: QueryClient$1): number;
542
- }
543
- /**
544
- * @internal
545
- */
546
- interface ServiceOperationIsMutatingQueriesCallback<TSchema extends {
547
- url: string;
548
- method: string;
549
- }, TBody, TData, TParams = {}, TError = DefaultError> extends ServiceOperationIsMutatingQueries<TSchema, TBody, TData, TParams, TError> {
550
- isMutating<TContext>(filters: MutationFiltersByParameters<TBody, TData, TParams, TError, TContext> | MutationFiltersByMutationKey<TSchema, TBody, TData, TParams, TError, TContext> | QueryClient$1, queryClient?: QueryClient$1): number;
551
- }
552
-
553
- interface QueryFnBaseUrlOptions$1 {
554
- /**
555
- * Base URL to use for the request
556
- * @example 'https://api.example.com'
557
- */
558
- baseUrl: string;
559
- }
560
- interface ServiceOperationMutationFnOptionsBase<TBody, TParams> {
561
- parameters: TParams;
562
- body: TBody;
563
- }
564
- interface ServiceOperationMutationFnOptions<TBody, TParams> extends ServiceOperationMutationFnOptionsBase<TBody, TParams> {
565
- baseUrl?: never;
566
- }
567
- interface ServiceOperationMutationFnOptionsWithBaseUrl<TBody, TParams> extends ServiceOperationMutationFnOptionsBase<TBody, TParams>, QueryFnBaseUrlOptions$1 {
568
- }
569
- interface ServiceOperationMutationFn<TSchema extends {
570
- url: string;
571
- method: string;
572
- }, TBody, TData, TParams> {
573
- /**
574
- * @deprecated Use `<service>.<operation>(...)` instead.
575
- */
576
- mutationFn(client: (schema: TSchema, options: {
577
- parameters: TParams;
578
- body: TBody;
579
- }) => TData, options: {
580
- parameters: TParams;
581
- body: TBody;
582
- }): TData;
583
- /**
584
- * @deprecated Use `<service>.<operation>(...)` instead.
585
- */
586
- mutationFn(client: (schema: TSchema, options: {
587
- parameters: TParams;
588
- body: TBody;
589
- }) => Promise<TData>, options: {
590
- parameters: TParams;
591
- body: TBody;
592
- }): Promise<TData>;
593
- <TOptions extends ServiceOperationMutationFnOptions<TBody, TParams>>(options: TOptions, client: (schema: TSchema, options: TOptions) => TData): TData;
594
- <TOptions extends ServiceOperationMutationFnOptionsWithBaseUrl<TBody, TParams>>(options: TOptions, client: (schema: TSchema, options: TOptions) => TData): TData;
595
- <TOptions extends ServiceOperationMutationFnOptions<TBody, TParams>>(options: TOptions, client: (schema: TSchema, options: TOptions) => Promise<TData>): Promise<TData>;
596
- <TOptions extends ServiceOperationMutationFnOptionsWithBaseUrl<TBody, TParams>>(options: TOptions, client: (schema: TSchema, options: TOptions) => Promise<TData>): Promise<TData>;
597
- }
598
-
599
- interface QueryFnOptionsBase<TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal> {
600
- signal?: TSignal;
601
- meta?: TMeta;
602
- }
603
- interface QueryFnOptionsByParameters<TParams, TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal> extends QueryFnOptionsBase<TMeta, TSignal> {
604
- parameters: TParams;
605
- queryKey?: never;
606
- baseUrl?: never;
607
- }
608
- interface QueryFnOptionsByParametersWithBaseUrl<TParams, TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal> extends QueryFnOptionsBase<TMeta, TSignal>, QueryFnBaseUrlOptions {
609
- parameters: TParams;
610
- queryKey?: never;
611
- }
612
- interface QueryFnOptionsByQueryKey<TSchema extends {
613
- url: string;
614
- method: string;
615
- }, TParams, TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal> extends QueryFnOptionsBase<TMeta, TSignal> {
616
- queryKey: ServiceOperationQueryKey<TSchema, TParams>;
617
- parameters?: never;
618
- baseUrl?: never;
619
- }
620
- interface QueryFnOptionsByQueryKeyWithBaseUrl<TSchema extends {
621
- url: string;
622
- method: string;
623
- }, TParams, TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal> extends QueryFnOptionsBase<TMeta, TSignal>, QueryFnBaseUrlOptions {
624
- queryKey: ServiceOperationQueryKey<TSchema, TParams>;
625
- parameters?: never;
626
- }
627
- interface QueryFnBaseUrlOptions {
628
- /**
629
- * Base URL to use for the request
630
- * @example 'https://api.example.com'
631
- */
632
- baseUrl: string;
633
- }
634
- interface ServiceOperationQueryFn<TSchema extends {
635
- url: string;
636
- method: string;
637
- }, TData, TParams> {
638
- /**
639
- * @deprecated Use `<service>.<operation>(...)` instead.
640
- */
641
- queryFn<TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal>(options: QueryFnOptionsByParameters<TParams, TMeta, TSignal> | QueryFnOptionsByQueryKey<TSchema, TParams, TMeta, TSignal>, client: (schema: TSchema, options: {
642
- parameters: TParams;
643
- signal?: TSignal;
644
- meta?: TMeta;
645
- }) => TData): TData;
646
- /**
647
- * @deprecated Use `<service>.<operation>(...)` instead.
648
- */
649
- queryFn<TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal>(options: QueryFnOptionsByParameters<TParams, TMeta, TSignal> | QueryFnOptionsByQueryKey<TSchema, TParams, TMeta, TSignal>, client: (schema: TSchema, options: {
650
- parameters: TParams;
651
- signal?: TSignal;
652
- meta?: TMeta;
653
- }) => Promise<TData>): Promise<TData>;
654
- <TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal>(options: QueryFnOptionsByParameters<TParams, TMeta, TSignal> | QueryFnOptionsByQueryKey<TSchema, TParams, TMeta, TSignal>, client: (schema: TSchema, options: {
655
- parameters: TParams;
656
- signal?: TSignal;
657
- meta?: TMeta;
658
- }) => TData): TData;
659
- <TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal>(options: QueryFnOptionsByParametersWithBaseUrl<TParams, TMeta, TSignal> | QueryFnOptionsByQueryKeyWithBaseUrl<TSchema, TParams, TMeta, TSignal>, client: (schema: TSchema, options: {
660
- parameters: TParams;
661
- signal?: TSignal;
662
- meta?: TMeta;
663
- } & QueryFnBaseUrlOptions) => TData): TData;
664
- <TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal>(options: QueryFnOptionsByParameters<TParams, TMeta, TSignal> | QueryFnOptionsByQueryKey<TSchema, TParams, TMeta, TSignal>, client: (schema: TSchema, options: {
665
- parameters: TParams;
666
- signal?: TSignal;
667
- meta?: TMeta;
668
- }) => Promise<TData>): Promise<TData>;
669
- <TMeta extends Record<string, any>, TSignal extends AbortSignal = AbortSignal>(options: QueryFnOptionsByParametersWithBaseUrl<TParams, TMeta, TSignal> | QueryFnOptionsByQueryKeyWithBaseUrl<TSchema, TParams, TMeta, TSignal>, client: (schema: TSchema, options: {
670
- parameters: TParams;
671
- signal?: TSignal;
672
- meta?: TMeta;
673
- } & QueryFnBaseUrlOptions) => Promise<TData>): Promise<TData>;
674
- }
675
-
676
- interface ServiceOperationResetQueries<TSchema extends {
677
- url: string;
678
- method: string;
679
- }, TData, TParams = {}, TError = DefaultError> {
680
- resetQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, options: ResetOptions, queryClient: QueryClient$1): Promise<void>;
681
- resetQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): Promise<void>;
682
- resetQueries(queryClient: QueryClient$1): Promise<void>;
683
- }
684
- /**
685
- * @internal
686
- */
687
- interface ServiceOperationResetQueriesCallback<TSchema extends {
688
- url: string;
689
- method: string;
690
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationResetQueries<TSchema, TData, TParams, TError> {
691
- resetQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError> | QueryClient$1, options?: ResetOptions | QueryClient$1, queryClient?: QueryClient$1): Promise<void>;
692
- }
693
-
694
- interface ServiceOperationRefetchQueries<TSchema extends {
695
- url: string;
696
- method: string;
697
- }, TData, TParams = {}, TError = DefaultError> {
698
- refetchQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, options: RefetchOptions, queryClient: QueryClient$1): Promise<void>;
699
- refetchQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): Promise<void>;
700
- refetchQueries(queryClient: QueryClient$1): Promise<void>;
701
- }
702
- /**
703
- * @internal
704
- */
705
- interface ServiceOperationRefetchQueriesCallback<TSchema extends {
706
- url: string;
707
- method: string;
708
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationRefetchQueries<TSchema, TData, TParams, TError> {
709
- refetchQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError> | QueryClient$1, options?: RefetchOptions | QueryClient$1, queryClient?: QueryClient$1): Promise<void>;
710
- }
711
-
712
- interface ServiceOperationRemoveQueries<TSchema extends {
713
- url: string;
714
- method: string;
715
- }, TData, TParams = {}, TError = DefaultError> {
716
- removeQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient: QueryClient$1): void;
717
- removeQueries(queryClient: QueryClient$1): void;
718
- }
719
- /**
720
- * @internal
721
- */
722
- interface ServiceOperationRemoveQueriesCallback<TSchema extends {
723
- url: string;
724
- method: string;
725
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationRemoveQueries<TSchema, TData, TParams, TError> {
726
- removeQueries<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError> | QueryClient$1, queryClient?: QueryClient$1): void;
727
- }
728
-
729
- interface ServiceOperationSetInfiniteQueryData<TSchema extends {
730
- url: string;
731
- method: string;
732
- }, TData, TParams = {}> {
733
- setInfiniteQueryData(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>, updater: Updater<NoInfer<OperationInfiniteData<TData, TParams>> | undefined, NoInfer<OperationInfiniteData<TData, TParams>> | undefined>, queryClient: QueryClient$1, options?: SetDataOptions): OperationInfiniteData<TData, TParams> | undefined;
734
- }
735
-
736
- interface ServiceOperationSetQueriesData<TSchema extends {
737
- url: string;
738
- method: string;
739
- }, TData, TParams = {}, // todo::try to replace `TParams = {}` with `TParams = undefined`
740
- TError = DefaultError> {
741
- setQueriesData<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>, options: SetDataOptions, queryClient: QueryClient$1): Array<TData | undefined>;
742
- setQueriesData<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>, queryClient: QueryClient$1): Array<TData | undefined>;
743
- }
744
- /**
745
- * @internal
746
- */
747
- interface ServiceOperationSetQueriesDataCallback<TSchema extends {
748
- url: string;
749
- method: string;
750
- }, TData, TParams = {}, TError = DefaultError> extends ServiceOperationSetQueriesData<TSchema, TData, TParams, TError> {
751
- setQueriesData<TInfinite extends boolean>(filters: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>, options: SetDataOptions | QueryClient$1, queryClient?: QueryClient$1): Array<TData | undefined>;
752
- }
753
-
754
- interface ServiceOperationSetQueryData<TSchema extends {
755
- url: string;
756
- method: string;
757
- }, TData, TParams = {}> {
758
- setQueryData(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>, options: SetDataOptions, queryClient: QueryClient$1): TData | undefined;
759
- setQueryData(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>, queryClient: QueryClient$1): TData | undefined;
760
- }
761
- /**
762
- * @internal
763
- */
764
- interface ServiceOperationSetQueryDataCallback<TSchema extends {
765
- url: string;
766
- method: string;
767
- }, TData, TParams = {}> extends ServiceOperationSetQueryData<TSchema, TData, TParams> {
768
- setQueryData(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>, options: SetDataOptions | QueryClient$1, queryClient?: QueryClient$1): TData | undefined;
769
- }
770
-
771
- interface ServiceOperationUseInfiniteQuery<TSchema extends {
772
- url: string;
773
- method: string;
774
- }, TData, TParams = {}, TError = DefaultError> {
775
- getInfiniteQueryKey<TQueryKeyParams extends TParams>(parameters: TQueryKeyParams): ServiceOperationInfiniteQueryKey<TSchema, TQueryKeyParams>;
776
- useInfiniteQuery<TPageParam extends TParams>(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>, options: Omit<UndefinedInitialDataInfiniteOptions<TData, TError, OperationInfiniteData<TData, TParams>, ServiceOperationInfiniteQueryKey<TSchema, TParams>, PartialParameters<TPageParam>>, 'queryKey' | 'getPreviousPageParam' | 'getNextPageParam' | 'initialPageParam'> & InfiniteQueryPageParamsOptions<TData, PartialParameters<TPageParam>>, queryClient?: QueryClient$1): UseInfiniteQueryResult<OperationInfiniteData<TData, TParams>, TError | Error>;
777
- useInfiniteQuery<TPageParam extends TParams>(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>, options: Omit<DefinedInitialDataInfiniteOptions<TData, TError, OperationInfiniteData<TData, TParams>, ServiceOperationInfiniteQueryKey<TSchema, TParams>, PartialParameters<TPageParam>>, 'queryKey' | 'getPreviousPageParam' | 'getNextPageParam' | 'initialPageParam'> & InfiniteQueryPageParamsOptions<TData, PartialParameters<TPageParam>>, queryClient?: QueryClient$1): DefinedUseInfiniteQueryResult<OperationInfiniteData<TData, TParams>, TError | Error>;
778
- }
779
-
780
- interface ServiceOperationUseIsFetchingQueries<TSchema extends {
781
- url: string;
782
- method: string;
783
- }, TData, TParams = {}, TError = DefaultError> {
784
- useIsFetching<TInfinite extends boolean>(filters?: QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError> | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>, queryClient?: QueryClient$1): number;
785
- }
786
-
787
- interface ServiceOperationUseIsMutating<TSchema extends {
788
- url: string;
789
- method: string;
790
- }, TBody, TData, TParams, TError = DefaultError> {
791
- useIsMutating<TContext = unknown>(filters?: MutationFiltersByParameters<TBody, TData, TParams, TError, TContext> | MutationFiltersByMutationKey<TSchema, TBody, TData, TParams, TError, TContext>, queryClient?: QueryClient$1): number;
792
- }
793
-
794
- interface ServiceOperationUseQueries<TSchema extends {
795
- url: string;
796
- method: string;
797
- }, TData, TParams = {}, TError = DefaultError> {
798
- useQueries<TCombinedResult = Array<UseQueryResult<TData, TError>>>(options: {
799
- queries: ReadonlyArray<Omit<UseQueryOptions<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>, 'placeholderData' | 'suspense' | 'queryKey'> & {
800
- placeholderData?: TData | QueriesPlaceholderDataFunction<TData>;
801
- } & ({
802
- parameters: TParams;
803
- queryKey?: never;
804
- } | {
805
- queryKey: ServiceOperationQueryKey<TSchema, TParams>;
806
- })>;
807
- combine?: (results: Array<UseQueryResult<TData, TError>>) => TCombinedResult;
808
- }, queryClient?: QueryClient$1): TCombinedResult;
809
- }
810
-
811
- interface ServiceOperationUseQuery<TSchema extends {
812
- url: string;
813
- method: string;
814
- }, TData, TParams = {}, TError = DefaultError> {
815
- getQueryKey<QueryKeyParams extends TParams | undefined = undefined>(parameters?: QueryKeyParams): ServiceOperationQueryKey<TSchema, QueryKeyParams>;
816
- useQuery(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, options?: Omit<UndefinedInitialDataOptions<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>, 'queryKey'>, queryClient?: QueryClient$1): UseQueryResult<TData, TError | Error>;
817
- useQuery(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, options: Omit<DefinedInitialDataOptions<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>, 'queryKey'>, queryClient?: QueryClient$1): DefinedUseQueryResult<TData, TError | Error>;
818
- }
819
-
820
- interface ServiceOperationUseSuspenseInfiniteQuery<TSchema extends {
821
- url: string;
822
- method: string;
823
- }, TData, TParams = {}, TError = DefaultError> {
824
- useSuspenseInfiniteQuery<TPageParam extends TParams>(parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>, options: Omit<UseSuspenseInfiniteQueryOptions<TData, TError, OperationInfiniteData<TData, TParams>, TData, ServiceOperationInfiniteQueryKey<TSchema, TParams>, PartialParameters<TPageParam>>, 'queryKey' | 'getPreviousPageParam' | 'getNextPageParam' | 'initialPageParam'> & InfiniteQueryPageParamsOptions<TData, PartialParameters<TPageParam>>, queryClient?: QueryClient$1): UseSuspenseInfiniteQueryResult<OperationInfiniteData<TData, TParams>, TError | Error>;
825
- }
826
-
827
- interface ServiceOperationUseSuspenseQueries<TSchema extends {
828
- url: string;
829
- method: string;
830
- }, TData, TParams = {}, TError = DefaultError> {
831
- useSuspenseQueries<TCombinedResult = Array<UseSuspenseQueryResult<TData, TError>>>(options: {
832
- queries: ReadonlyArray<Omit<UseSuspenseQueryOptions<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>, 'queryKey'> & ({
833
- parameters: TParams;
834
- queryKey?: never;
835
- } | {
836
- queryKey: ServiceOperationQueryKey<TSchema, TParams>;
837
- })>;
838
- combine?: (results: Array<UseSuspenseQueryResult<TData, TError>>) => TCombinedResult;
839
- }, queryClient?: QueryClient$1): TCombinedResult;
840
- }
841
-
842
- interface ServiceOperationUseSuspenseQueryQuery<TSchema extends {
843
- url: string;
844
- method: string;
845
- }, TData, TParams = {}, TError = DefaultError> {
846
- useSuspenseQuery(parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>, options?: Omit<UseSuspenseQueryOptions<TData, TError, TData, ServiceOperationQueryKey<TSchema, TParams>>, 'queryKey'>, queryClient?: QueryClient$1): UseSuspenseQueryResult<TData, TError | Error>;
847
- }
848
-
849
- interface ServiceOperationQuery<TSchema extends {
850
- url: string;
851
- method: string;
852
- }, TData, TParams, TError = DefaultError> extends ServiceOperationUseQuery<TSchema, TData, TParams, TError>, ServiceOperationUseQueries<TSchema, TData, TParams, TError>, ServiceOperationUseSuspenseQueries<TSchema, TData, TParams, TError>, ServiceOperationUseInfiniteQuery<TSchema, TData, TParams, TError>, ServiceOperationUseSuspenseQueryQuery<TSchema, TData, TParams, TError>, ServiceOperationUseSuspenseInfiniteQuery<TSchema, TData, TParams, TError>, ServiceOperationUseIsFetchingQueries<TSchema, TData, TParams, TError>, ServiceOperationQueryFn<TSchema, TData, TParams>, ServiceOperationFetchQuery<TSchema, TData, TParams, TError>, ServiceOperationFetchInfiniteQuery<TSchema, TData, TParams, TError>, ServiceOperationGetQueryData<TSchema, TData, TParams>, ServiceOperationGetQueryState<TSchema, TData, TParams, TError>, ServiceOperationGetQueriesData<TSchema, TData, TParams, TError>, ServiceOperationGetInfiniteQueryData<TSchema, TData, TParams>, ServiceOperationSetQueryData<TSchema, TData, TParams>, ServiceOperationSetQueriesData<TSchema, TData, TParams, TError>, ServiceOperationSetInfiniteQueryData<TSchema, TData, TParams>, ServiceOperationInvalidateQueries<TSchema, TData, TParams, TError>, ServiceOperationCancelQueries<TSchema, TData, TParams, TError>, ServiceOperationRemoveQueries<TSchema, TData, TParams, TError>, ServiceOperationResetQueries<TSchema, TData, TParams, TError>, ServiceOperationRefetchQueries<TSchema, TData, TParams, TError>, ServiceOperationIsFetchingQueries<TSchema, TData, TParams, TError> {
853
- schema: TSchema;
854
- types: {
855
- parameters: TParams;
856
- data: TData;
857
- error: TError;
858
- };
859
- }
860
- interface ServiceOperationMutation<TSchema extends {
861
- url: string;
862
- method: string;
863
- }, TBody, TData, TParams, TError = DefaultError> extends ServiceOperationUseMutation<TSchema, TBody, TData, TParams, TError>, ServiceOperationUseIsMutating<TSchema, TBody, TData, TParams, TError>, ServiceOperationUseMutationState<TSchema, TBody, TData, TParams, TError>, ServiceOperationIsMutatingQueries<TSchema, TBody, TData, TParams, TError>, ServiceOperationMutationFn<TSchema, TBody, TData, TParams> {
864
- schema: TSchema;
865
- types: {
866
- parameters: TParams;
867
- data: TData;
868
- error: TError;
869
- body: TBody;
870
- };
871
- }
872
-
873
- declare function getInfiniteQueryData<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, TData>['getInfiniteQueryData']>): InfiniteData<TData> | undefined;
874
-
875
- declare const getInfiniteQueryKey: (qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['getInfiniteQueryKey']>) => ServiceOperationInfiniteQueryKey<OperationSchema, unknown>;
876
-
877
- declare const getMutationKey: (qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationMutation<OperationSchema, unknown, unknown, unknown>['getMutationKey']>) => [OperationSchema, unknown];
878
-
879
- declare function getQueryData<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, TData>['getQueryData']>): TData | undefined;
880
-
881
- declare function getQueriesData<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, TData>['getQueriesData']>): TData | undefined;
882
-
883
- declare const getQueryKey: (qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['getQueryKey']>) => ServiceOperationQueryKey<OperationSchema, unknown>;
884
-
885
- declare const mutationFn: (qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: unknown) => Promise<unknown>;
886
-
887
- declare const queryFn: <TSchema extends {
888
- url: string;
889
- method: 'get' | 'head' | 'options';
890
- }, TData, TParams>(qraftOptions: QraftClientOptions | undefined, schema: TSchema, args: Parameters<ServiceOperationQuery<TSchema, TData, TParams>['queryFn']>) => Promise<TData>;
891
-
892
- declare function setInfiniteQueryData<TData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, TData>['setInfiniteQueryData']>): InfiniteData<TData> | undefined;
893
-
894
- declare function setQueryData<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationSetQueryDataCallback<OperationSchema, unknown, TData>['setQueryData']>): TData | undefined;
895
-
896
- declare function setQueriesData<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationSetQueriesDataCallback<OperationSchema, unknown, TData>['setQueriesData']>): TData | undefined;
897
-
898
- declare const useInfiniteQuery: <TQueryFnData, TError = DefaultError, TData = InfiniteData<TQueryFnData>>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['useInfiniteQuery']>) => UseInfiniteQueryResult<TData, TError>;
899
-
900
- declare const useMutation: <TData = unknown, TError = DefaultError, TVariables = void, TContext = unknown>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationMutation<OperationSchema, object | undefined, TVariables, TData>['useMutation']>) => UseMutationResult<TData, TError, TVariables, TContext>;
901
-
902
- declare const useQuery: <TData = unknown, TError = DefaultError>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['useQuery']>) => UseQueryResult<TData, TError>;
903
-
904
- declare const useSuspenseQuery: <TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['useSuspenseQuery']>) => UseQueryResult<TData, TError>;
905
-
906
- declare const useSuspenseInfiniteQuery: <TQueryFnData, TError = DefaultError, TData = InfiniteData<TQueryFnData>>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['useSuspenseInfiniteQuery']>) => UseSuspenseInfiniteQueryResult<TData, TError>;
907
-
908
- declare const useMutationState: <TData = unknown, TError = DefaultError, TVariables = unknown, TContext = unknown>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationMutation<OperationSchema, object | undefined, TVariables, TData>['useMutationState']>) => UseMutationResult<TData, TError, TVariables, TContext>;
909
-
910
- declare const useIsMutating: <TData = unknown, TError = DefaultError, TVariables = unknown, TContext = unknown>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationMutation<OperationSchema, object | undefined, TVariables, TData>['useIsMutating']>) => UseMutationResult<TData, TError, TVariables, TContext>;
911
-
912
- declare const useQueries: (qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['useQueries']>) => QueriesResults<never>;
913
-
914
- declare const useSuspenseQueries: (qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, unknown>['useSuspenseQueries']>) => SuspenseQueriesResults<never>;
915
-
916
- declare function invalidateQueries<TData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationInvalidateQueriesCallback<OperationSchema, unknown, TData>['invalidateQueries']>): Promise<void>;
917
-
918
- declare function cancelQueries<TData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationCancelQueriesCallback<OperationSchema, unknown, TData>['cancelQueries']>): Promise<void>;
919
-
920
- declare function resetQueries<TData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationResetQueriesCallback<OperationSchema, unknown, TData>['resetQueries']>): Promise<void>;
921
-
922
- declare function removeQueries<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationRemoveQueriesCallback<OperationSchema, unknown, TData>['removeQueries']>): Promise<void>;
923
-
924
- declare function refetchQueries<TData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationRefetchQueriesCallback<OperationSchema, unknown, TData>['refetchQueries']>): Promise<void>;
925
-
926
- declare function isFetching<TData>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationIsFetchingQueriesCallback<OperationSchema, unknown, TData>['isFetching']>): Promise<void>;
927
-
928
- declare function isMutating<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationIsMutatingQueriesCallback<OperationSchema, unknown, TData>['isMutating']>): Promise<void>;
929
-
930
- declare const useIsFetching: <TVariables = unknown>(qraftOptions: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, object | undefined, TVariables, unknown>['useIsFetching']>) => number;
931
-
932
- declare const fetchQuery: <TSchema extends {
933
- url: string;
934
- method: 'get' | 'head' | 'options';
935
- }, TData, TParams>(_: QraftClientOptions | undefined, schema: TSchema, args: Parameters<ServiceOperationQuery<TSchema, TData, TParams>['fetchQuery']>) => Promise<TData>;
936
-
937
- declare const prefetchQuery: <TSchema extends {
938
- url: string;
939
- method: 'get' | 'head' | 'options';
940
- }, TData, TParams>(_: QraftClientOptions | undefined, schema: TSchema, args: Parameters<ServiceOperationQuery<TSchema, TData, TParams>['prefetchQuery']>) => Promise<TData>;
941
-
942
- declare const fetchInfiniteQuery: <TSchema extends {
943
- url: string;
944
- method: 'get' | 'head' | 'options';
945
- }, TData, TParams>(_: QraftClientOptions | undefined, schema: TSchema, args: Parameters<ServiceOperationQuery<TSchema, TData, TParams>['fetchInfiniteQuery']>) => Promise<TData>;
946
-
947
- declare const prefetchInfiniteQuery: <TSchema extends {
948
- url: string;
949
- method: 'get' | 'head' | 'options';
950
- }, TData, TParams>(_: QraftClientOptions | undefined, schema: TSchema, args: Parameters<ServiceOperationQuery<TSchema, TData, TParams>['prefetchInfiniteQuery']>) => Promise<TData>;
951
-
952
- declare function getQueryState<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, TData>['getQueryState']>): TData | undefined;
953
-
954
- declare function getInfiniteQueryState<TData>(_: QraftClientOptions | undefined, schema: OperationSchema, args: Parameters<ServiceOperationQuery<OperationSchema, unknown, TData>['getInfiniteQueryState']>): TData | undefined;
955
-
956
- /**
957
- * Called when <service>.<operation>(...) is invoked.
958
- */
959
- declare const operationInvokeFn: <TSchema extends OperationSchema, TBody, TData, TParams>(qraftOptions: QraftClientOptions | undefined, schema: TSchema, args: Parameters<ServiceOperationQueryFn<TSchema, TData, TParams>> | Parameters<ServiceOperationMutationFn<TSchema, TBody, TData, TParams>>) => Promise<TData>;
960
-
961
- interface QraftSecureRequestFnBaseProps {
962
- requestFn<T>(schema: OperationSchema, requestInfo: RequestFnInfo, options?: RequestFnOptions): Promise<T>;
963
- securitySchemes: SecuritySchemeHandlers<string>;
964
- }
965
- type RequestFn = QraftSecureRequestFnBaseProps['requestFn'];
966
- interface QraftSecureRequestFnProps extends QraftSecureRequestFnBaseProps {
967
- children(secureRequestFn: QraftSecureRequestFnBaseProps['requestFn']): ReactNode;
968
- queryClient?: QueryClient;
969
- }
970
- declare function QraftSecureRequestFn({ children, requestFn, securitySchemes, queryClient: inQueryClient, }: QraftSecureRequestFnProps): react.FunctionComponentElement<{
971
- children?: ReactNode;
972
- }>;
973
- declare const useSecuritySchemeAuth: ({ securitySchemes, requestFn, queryClient, }: QraftSecureRequestFnBaseProps & {
974
- queryClient: QueryClient;
975
- }) => RequestFn;
976
- /**
977
- * Create a secure `requestFn` that manages security schemes.
978
- * It will automatically fetch and refresh tokens when needed
979
- * using QueryClient and the provided security schemes.
980
- *
981
- * @param securitySchemes OpenAPI security schemes.
982
- * @param requestFn Qraft `requestFn`
983
- * @param queryClient QueryClient instance.
984
- */
985
- declare function createSecureRequestFn(securitySchemes: SecuritySchemeHandlers<string>, requestFn: RequestFn, queryClient: QueryClient): RequestFn;
986
- type SecurityScheme = SecuritySchemeBearer | SecuritySchemeBasic | SecuritySchemeAPIKey | SecuritySchemeCookie;
987
- type SecuritySchemeBearer = string /** JWT Bearer token. **/ | {
988
- /** Refresh interval in milliseconds. */
989
- refreshInterval: number;
990
- /** Token to be used for authentication. */
991
- token: string;
992
- };
993
- interface SecuritySchemeBasic {
994
- /** Credentials to be used for authentication. */
995
- credentials: string;
996
- /** Refresh interval in milliseconds. */
997
- refreshInterval: number;
998
- }
999
- type SecuritySchemeAPIKey = {
1000
- /** Where the secret should be placed. */
1001
- in: 'header' | 'query';
1002
- /** Name of the secret key. */
1003
- name: string;
1004
- /** Secret to be used for authentication. */
1005
- value: string;
1006
- /** Refresh interval in milliseconds. */
1007
- refreshInterval?: number;
1008
- };
1009
- type SecuritySchemeCookie = {
1010
- /** Where the secret should be placed. */
1011
- in: 'cookie';
1012
- /** Refresh interval in milliseconds. */
1013
- refreshInterval?: number;
1014
- };
1015
- /**
1016
- * Type definition for a handler function that manages security schemes.
1017
- * This function is invoked when a token needs to be fetched or refreshed.
1018
- *
1019
- * @param props - The properties for the handler function.
1020
- * @param props.isRefreshing - A boolean indicating the state of the token.
1021
- * It's `false` on the initial "fetch token" request, and `true` if the token is stale or updating using `refreshInterval`.
1022
- * @param props.signal - An AbortSignal that can be used to abort the request.
1023
- *
1024
- * @returns A SecurityScheme, which contains the necessary data for authentication.
1025
- */
1026
- type SecuritySchemeHandler = (props: {
1027
- isRefreshing: boolean;
1028
- signal: AbortSignal;
1029
- }) => SecurityScheme | Promise<SecurityScheme>;
1030
- type SecuritySchemeHandlers<SecuritySchemeName extends string> = {
1031
- [key in SecuritySchemeName]: SecuritySchemeHandler;
1032
- };
1033
-
1034
- export { type HeadersOptions, type OperationSchema, type QraftClientOptions, QraftContext, type QraftContextValue, type QraftSecureRequestFnProps, type RequestFnOptions, type RequestFnPayload, type SecuritySchemeAPIKey, type SecuritySchemeBasic, type SecuritySchemeBearer, type SecuritySchemeCookie, type SecuritySchemeHandlers, type ServiceOperationMutation, type ServiceOperationQuery, QraftSecureRequestFn as Unstable_QraftSecureRequestFn, baseRequestFn, bodySerializer, cancelQueries, createSecureRequestFn, fetchInfiniteQuery, fetchQuery, getInfiniteQueryData, getInfiniteQueryKey, getInfiniteQueryState, getMutationKey, getQueriesData, getQueryData, getQueryKey, getQueryState, invalidateQueries, isFetching, isMutating, mutationFn, operationInvokeFn, prefetchInfiniteQuery, prefetchQuery, qraftAPIClient, queryFn, refetchQueries, removeQueries, requestFn, resetQueries, setInfiniteQueryData, setQueriesData, setQueryData, urlSerializer, useInfiniteQuery, useIsFetching, useIsMutating, useMutation, useMutationState, useQueries, useQuery, useSecuritySchemeAuth, useSuspenseInfiniteQuery, useSuspenseQueries, useSuspenseQuery };