@navios/react-query 0.5.2 → 0.6.0
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.
- package/CHANGELOG.md +51 -10
- package/README.md +405 -273
- package/dist/src/client/declare-client.d.mts +13 -4
- package/dist/src/client/declare-client.d.mts.map +1 -1
- package/dist/src/mutation/make-hook.d.mts +2 -2
- package/dist/src/mutation/make-hook.d.mts.map +1 -1
- package/dist/src/mutation/types.d.mts +12 -4
- package/dist/src/mutation/types.d.mts.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/lib/_tsup-dts-rollup.d.mts +26 -8
- package/lib/_tsup-dts-rollup.d.ts +26 -8
- package/lib/index.js +51 -27
- package/lib/index.js.map +1 -1
- package/lib/index.mjs +52 -28
- package/lib/index.mjs.map +1 -1
- package/package.json +1 -1
- package/src/__tests__/declare-client.spec.mts +24 -5
- package/src/__tests__/make-mutation.spec.mts +150 -8
- package/src/client/declare-client.mts +33 -8
- package/src/mutation/make-hook.mts +96 -42
- package/src/mutation/types.mts +28 -6
package/lib/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/query/key-creator.mts","../src/query/make-options.mts","../src/query/make-infinite-options.mts","../src/mutation/key-creator.mts","../src/mutation/make-hook.mts","../src/client/declare-client.mts"],"names":["result","queryOptions","infiniteQueryOptions","useMutation"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AnyEndpointConfig, UrlHasParams } from '@navios/builder'\nimport type { DataTag, InfiniteData } from '@tanstack/react-query'\n\nimport { bindUrlParams } from '@navios/builder'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryKeyCreatorResult, QueryParams } from './types.mjs'\n\n/**\n * Creates a query key generator for a given endpoint configuration.\n *\n * The returned object provides methods to generate query keys that can be used\n * with TanStack Query for caching, invalidation, and data tagging.\n *\n * @param config - The endpoint configuration\n * @param options - Query parameters including processResponse and key prefix/suffix\n * @param isInfinite - Whether this is for an infinite query\n * @returns An object with methods to generate query keys\n */\nexport function createQueryKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n IsInfinite extends boolean,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options,\n _isInfinite: IsInfinite,\n): QueryKeyCreatorResult<\n Config['querySchema'],\n Url,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? Result\n : never,\n IsInfinite,\n HasParams\n> {\n const url = config.url as Url\n const urlParts = url.split('/').filter(Boolean) as Split<Url, '/'>\n return {\n template: urlParts,\n // @ts-expect-error We have correct types in return type\n dataTag: (params) => {\n const queryParams =\n params && 'querySchema' in config && 'params' in params\n ? config.querySchema?.parse(params.params)\n : []\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n queryParams ?? [],\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n // @ts-expect-error We have correct types in return type\n filterKey: (params) => {\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n\n bindToUrl: (params) => {\n return bindUrlParams<Url>(url, params ?? ({} as never))\n },\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createQueryKey instead */\nexport const queryKeyCreator = createQueryKey\n","import type { AbstractEndpoint, AnyEndpointConfig } from '@navios/builder'\nimport type {\n DataTag,\n QueryClient,\n UseQueryOptions,\n UseSuspenseQueryOptions,\n} from '@tanstack/react-query'\n\nimport { queryOptions, useQuery, useSuspenseQuery } from '@tanstack/react-query'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryArgs, QueryParams } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create query options for\n * @param options - Query configuration including processResponse\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates query options with attached helpers\n */\nexport function makeQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n BaseQuery extends Omit<\n UseQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'enabled'\n | 'throwOnError'\n | 'placeholderData'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, false)\n const processResponse = options.processResponse\n\n const result = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T ? T : Result,\n DataTag<Split<Config['url'], '/'>, Result, Error>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return queryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n ...params,\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n ...baseQuery,\n })\n }\n result.queryKey = queryKey\n result.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useQuery(result(params))\n }\n\n result.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseQuery(result(params))\n }\n\n result.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.dataTag(params),\n })\n }\n\n result.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n UrlParams,\n} from '@navios/builder'\nimport type {\n InfiniteData,\n QueryClient,\n UseInfiniteQueryOptions,\n UseSuspenseInfiniteQueryOptions,\n} from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n infiniteQueryOptions,\n useInfiniteQuery,\n useSuspenseInfiniteQuery,\n} from '@tanstack/react-query'\n\nimport type { InfiniteQueryOptions, QueryArgs } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates infinite query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query infinite options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create infinite query options for\n * @param options - Infinite query configuration including processResponse and pagination params\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates infinite query options with attached helpers\n */\nexport function makeInfiniteQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends InfiniteQueryOptions<Config>,\n BaseQuery extends Omit<\n UseInfiniteQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'placeholderData'\n | 'throwOnError'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, true)\n\n const processResponse = options.processResponse\n const res = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseInfiniteQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T\n ? T\n : InfiniteData<Result>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return infiniteQueryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal, pageParam }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n // @ts-expect-error TS2345 We bind the url params only if the url has params\n urlParams: params.urlParams as z.infer<UrlParams<Config['url']>>,\n params: {\n ...('params' in params ? params.params : {}),\n ...(pageParam as z.infer<Config['querySchema']>),\n },\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options.getPreviousPageParam,\n initialPageParam:\n options.initialPageParam ??\n config.querySchema.parse('params' in params ? params.params : {}),\n ...baseQuery,\n })\n }\n res.queryKey = queryKey\n\n res.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useInfiniteQuery(res(params))\n }\n\n res.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseInfiniteQuery(res(params))\n }\n\n res.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.dataTag(params),\n })\n }\n\n res.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return res\n}\n","import type {\n AnyEndpointConfig,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { DataTag } from '@tanstack/react-query'\n\nimport type { QueryParams } from '../query/types.mjs'\n\nimport { createQueryKey } from '../query/key-creator.mjs'\n\n/**\n * Creates a mutation key generator for a given endpoint configuration.\n *\n * @param config - The endpoint configuration\n * @param options - Optional query parameters with a default `processResponse` function\n * @returns A function that generates mutation keys\n *\n * @example Basic usage:\n * ```typescript\n * const createMutationKey = createMutationKey(endpoint.config);\n * const mutationKey = createMutationKey({ urlParams: { id: 123 } });\n * ```\n *\n * @example Advanced usage with processResponse:\n * ```ts\n * const createMutationKey = createMutationKey(endpoint.config, {\n * processResponse: (data) => {\n * if (!data.success) {\n * throw new Error(data.message);\n * }\n * return data.data;\n * },\n * });\n * // We create a mutation that will be shared across the project for all passed userId\n * const mutationKey = createMutationKey({ urlParams: { projectId: 123, userId: 'wildcard' } });\n * ```\n */\nexport function createMutationKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options = {\n processResponse: (data) => data,\n } as Options,\n): (\n params: HasParams extends true ? { urlParams: UrlParams<Url> } : {},\n) => Options['processResponse'] extends (...args: unknown[]) => infer Result\n ? DataTag<[Config['url']], Result, Error>\n : never {\n const queryKey = createQueryKey(config, options, false)\n\n // @ts-expect-error We have correct types in return type\n return (params) => {\n return queryKey.filterKey(params)\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createMutationKey instead */\nexport const mutationKeyCreator = createMutationKey\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n NaviosZodRequest,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { UseMutationResult } from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n useIsMutating,\n useMutation,\n useQueryClient,\n} from '@tanstack/react-query'\n\nimport type { MutationParams } from './types.mjs'\n\nimport { createMutationKey } from './key-creator.mjs'\n\n/**\n * Creates a mutation hook for a given endpoint.\n *\n * Returns a function that when called returns a TanStack Query mutation result.\n * The returned function also has helper methods attached (mutationKey, useIsMutating).\n *\n * @param endpoint - The navios endpoint to create a mutation hook for\n * @param options - Mutation configuration including processResponse and callbacks\n * @returns A hook function that returns mutation result with attached helpers\n */\nexport function makeMutation<\n Config extends AnyEndpointConfig,\n TData = unknown,\n TVariables extends NaviosZodRequest<Config> = NaviosZodRequest<Config>,\n TResponse = z.output<Config['responseSchema']>,\n TContext = unknown,\n UseKey extends boolean = false,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: MutationParams<\n Config,\n TData,\n TVariables,\n TResponse,\n TContext,\n UseKey\n >,\n) {\n const config = endpoint.config\n\n const mutationKey = createMutationKey(config, {\n ...options,\n processResponse: options.processResponse ?? ((data) => data),\n })\n const result = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): UseMutationResult<TData, Error, NaviosZodRequest<Config>> => {\n const queryClient = useQueryClient()\n const {\n useKey,\n useContext,\n onError,\n onSuccess,\n keyPrefix: _keyPrefix,\n keySuffix: _keySuffix,\n processResponse,\n ...rest\n } = options\n\n const context = useContext?.() as TContext\n\n // @ts-expect-error The types match\n return useMutation(\n {\n ...rest,\n mutationKey: useKey\n ? mutationKey({\n urlParams: keyParams,\n })\n : undefined,\n scope: useKey\n ? {\n id: JSON.stringify(\n mutationKey({\n urlParams: keyParams,\n }),\n ),\n }\n : undefined,\n async mutationFn(params: TVariables) {\n const response = await endpoint(params)\n\n return (processResponse ? processResponse(response) : response) as TData\n },\n onSuccess: onSuccess\n ? (data: TData, variables: TVariables) => {\n return onSuccess?.(queryClient, data, variables, context)\n }\n : undefined,\n onError: onError\n ? (err: Error, variables: TVariables) => {\n return onError?.(queryClient, err, variables, context)\n }\n : undefined,\n },\n queryClient,\n )\n }\n result.useIsMutating = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): boolean => {\n if (!options.useKey) {\n throw new Error(\n 'useIsMutating can only be used when useKey is set to true',\n )\n }\n const isMutating = useIsMutating({\n mutationKey: mutationKey({\n urlParams: keyParams,\n }),\n })\n return isMutating > 0\n }\n result.mutationKey = mutationKey\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AbstractStream,\n AnyEndpointConfig,\n AnyStreamConfig,\n HttpMethod,\n} from '@navios/builder'\nimport type { InfiniteData, QueryClient } from '@tanstack/react-query'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport type { ClientOptions, ProcessResponseFunction } from '../common/types.mjs'\nimport type { MutationArgs } from '../mutation/types.mjs'\nimport type { ClientInstance } from './types.mjs'\n\nimport { makeMutation } from '../mutation/make-hook.mjs'\nimport { makeInfiniteQueryOptions } from '../query/make-infinite-options.mjs'\nimport { makeQueryOptions } from '../query/make-options.mjs'\n\n/**\n * Configuration for declaring a query endpoint.\n */\nexport interface QueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema = ZodObject,\n Response extends ZodType = ZodType,\n Result = z.output<Response>,\n RequestSchema = unknown,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => Result\n}\n\n/**\n * Configuration for declaring an infinite query endpoint.\n */\nexport type InfiniteQueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema extends ZodObject = ZodObject,\n Response extends ZodType = ZodType,\n PageResult = z.output<Response>,\n Result = InfiniteData<PageResult>,\n RequestSchema = unknown,\n> = {\n method: Method\n url: Url\n querySchema: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => PageResult\n select?: (data: InfiniteData<PageResult>) => Result\n getNextPageParam: (\n lastPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema> | undefined\n getPreviousPageParam?: (\n firstPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema>\n initialPageParam?: z.input<QuerySchema>\n}\n\n/**\n * Configuration for declaring a mutation endpoint.\n */\nexport interface MutationConfig<\n Method extends 'POST' | 'PUT' | 'PATCH' | 'DELETE' =\n | 'POST'\n | 'PUT'\n | 'PATCH'\n | 'DELETE',\n Url extends string = string,\n RequestSchema = Method extends 'DELETE' ? never : ZodObject,\n QuerySchema = unknown,\n Response extends ZodType = ZodType,\n ReqResult = z.output<Response>,\n Result = unknown,\n Context = unknown,\n UseKey extends boolean = false,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse: ProcessResponseFunction<Result, ReqResult>\n useContext?: () => Context\n onSuccess?: (\n queryClient: QueryClient,\n data: NoInfer<Result>,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context,\n ) => void | Promise<void>\n useKey?: UseKey\n}\n\n/**\n * Creates a client instance for making type-safe queries and mutations.\n *\n * @param options - Client configuration including the API builder and defaults\n * @returns A client instance with query, infiniteQuery, and mutation methods\n *\n * @example\n * ```typescript\n * const api = createBuilder({ baseUrl: '/api' });\n * const client = declareClient({ api });\n *\n * const getUser = client.query({\n * method: 'GET',\n * url: '/users/$id',\n * responseSchema: UserSchema,\n * });\n *\n * // In a component\n * const { data } = useSuspenseQuery(getUser({ urlParams: { id: '123' } }));\n * ```\n */\nexport function declareClient<Options extends ClientOptions>({\n api,\n defaults = {},\n}: Options): ClientInstance {\n function query(config: QueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const queryOptions = makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n })\n // @ts-expect-error We attach the endpoint to the queryOptions\n queryOptions.endpoint = endpoint\n return queryOptions\n }\n\n function queryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options?: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n },\n ) {\n return makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n })\n }\n\n function infiniteQuery(config: InfiniteQueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n const infiniteQueryOptions = makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n getNextPageParam: config.getNextPageParam,\n getPreviousPageParam: config.getPreviousPageParam,\n initialPageParam: config.initialPageParam,\n })\n\n // @ts-expect-error We attach the endpoint to the infiniteQueryOptions\n infiniteQueryOptions.endpoint = endpoint\n return infiniteQueryOptions\n }\n\n function infiniteQueryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n getNextPageParam: (\n lastPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']> | undefined\n getPreviousPageParam?: (\n firstPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']>\n initialPageParam?: z.input<AnyEndpointConfig['querySchema']>\n },\n ) {\n return makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options?.getPreviousPageParam,\n initialPageParam: options?.initialPageParam,\n })\n }\n\n function mutation(config: MutationConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n function mutationFromEndpoint(\n endpoint:\n | AbstractEndpoint<AnyEndpointConfig>\n | AbstractStream<AnyStreamConfig>,\n options?: {\n processResponse?: ProcessResponseFunction\n useContext?: () => unknown\n onSuccess?: (\n queryClient: QueryClient,\n data: unknown,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n },\n ) {\n // @ts-expect-error endpoint types are compatible at runtime\n return makeMutation(endpoint, {\n processResponse: options?.processResponse,\n useContext: options?.useContext,\n onSuccess: options?.onSuccess,\n onError: options?.onError,\n ...defaults,\n })\n }\n\n function multipartMutation(config: MutationConfig) {\n const endpoint = api.declareMultipart({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n return {\n // @ts-expect-error We simplified types here\n query,\n // @ts-expect-error We simplified types here\n queryFromEndpoint,\n // @ts-expect-error We simplified types here\n infiniteQuery,\n // @ts-expect-error We simplified types here\n infiniteQueryFromEndpoint,\n // @ts-expect-error We simplified types here\n mutation,\n // @ts-expect-error We simplified types here\n mutationFromEndpoint,\n // @ts-expect-error We simplified types here\n multipartMutation,\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/query/key-creator.mts","../src/query/make-options.mts","../src/query/make-infinite-options.mts","../src/mutation/key-creator.mts","../src/mutation/make-hook.mts","../src/client/declare-client.mts"],"names":["result","queryOptions","infiniteQueryOptions","useMutation"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AnyEndpointConfig, UrlHasParams } from '@navios/builder'\nimport type { DataTag, InfiniteData } from '@tanstack/react-query'\n\nimport { bindUrlParams } from '@navios/builder'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryKeyCreatorResult, QueryParams } from './types.mjs'\n\n/**\n * Creates a query key generator for a given endpoint configuration.\n *\n * The returned object provides methods to generate query keys that can be used\n * with TanStack Query for caching, invalidation, and data tagging.\n *\n * @param config - The endpoint configuration\n * @param options - Query parameters including processResponse and key prefix/suffix\n * @param isInfinite - Whether this is for an infinite query\n * @returns An object with methods to generate query keys\n */\nexport function createQueryKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n IsInfinite extends boolean,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options,\n _isInfinite: IsInfinite,\n): QueryKeyCreatorResult<\n Config['querySchema'],\n Url,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? Result\n : never,\n IsInfinite,\n HasParams\n> {\n const url = config.url as Url\n const urlParts = url.split('/').filter(Boolean) as Split<Url, '/'>\n return {\n template: urlParts,\n // @ts-expect-error We have correct types in return type\n dataTag: (params) => {\n const queryParams =\n params && 'querySchema' in config && 'params' in params\n ? config.querySchema?.parse(params.params)\n : []\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n queryParams ?? [],\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n // @ts-expect-error We have correct types in return type\n filterKey: (params) => {\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n\n bindToUrl: (params) => {\n return bindUrlParams<Url>(url, params ?? ({} as never))\n },\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createQueryKey instead */\nexport const queryKeyCreator = createQueryKey\n","import type { AbstractEndpoint, AnyEndpointConfig } from '@navios/builder'\nimport type {\n DataTag,\n QueryClient,\n UseQueryOptions,\n UseSuspenseQueryOptions,\n} from '@tanstack/react-query'\n\nimport { queryOptions, useQuery, useSuspenseQuery } from '@tanstack/react-query'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryArgs, QueryParams } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create query options for\n * @param options - Query configuration including processResponse\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates query options with attached helpers\n */\nexport function makeQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n BaseQuery extends Omit<\n UseQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'enabled'\n | 'throwOnError'\n | 'placeholderData'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, false)\n const processResponse = options.processResponse\n\n const result = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T ? T : Result,\n DataTag<Split<Config['url'], '/'>, Result, Error>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return queryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n ...params,\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n ...baseQuery,\n })\n }\n result.queryKey = queryKey\n result.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useQuery(result(params))\n }\n\n result.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseQuery(result(params))\n }\n\n result.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.dataTag(params),\n })\n }\n\n result.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n UrlParams,\n} from '@navios/builder'\nimport type {\n InfiniteData,\n QueryClient,\n UseInfiniteQueryOptions,\n UseSuspenseInfiniteQueryOptions,\n} from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n infiniteQueryOptions,\n useInfiniteQuery,\n useSuspenseInfiniteQuery,\n} from '@tanstack/react-query'\n\nimport type { InfiniteQueryOptions, QueryArgs } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates infinite query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query infinite options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create infinite query options for\n * @param options - Infinite query configuration including processResponse and pagination params\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates infinite query options with attached helpers\n */\nexport function makeInfiniteQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends InfiniteQueryOptions<Config>,\n BaseQuery extends Omit<\n UseInfiniteQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'placeholderData'\n | 'throwOnError'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, true)\n\n const processResponse = options.processResponse\n const res = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseInfiniteQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T\n ? T\n : InfiniteData<Result>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return infiniteQueryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal, pageParam }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n // @ts-expect-error TS2345 We bind the url params only if the url has params\n urlParams: params.urlParams as z.infer<UrlParams<Config['url']>>,\n params: {\n ...('params' in params ? params.params : {}),\n ...(pageParam as z.infer<Config['querySchema']>),\n },\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options.getPreviousPageParam,\n initialPageParam:\n options.initialPageParam ??\n config.querySchema.parse('params' in params ? params.params : {}),\n ...baseQuery,\n })\n }\n res.queryKey = queryKey\n\n res.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useInfiniteQuery(res(params))\n }\n\n res.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseInfiniteQuery(res(params))\n }\n\n res.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.dataTag(params),\n })\n }\n\n res.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return res\n}\n","import type {\n AnyEndpointConfig,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { DataTag } from '@tanstack/react-query'\n\nimport type { QueryParams } from '../query/types.mjs'\n\nimport { createQueryKey } from '../query/key-creator.mjs'\n\n/**\n * Creates a mutation key generator for a given endpoint configuration.\n *\n * @param config - The endpoint configuration\n * @param options - Optional query parameters with a default `processResponse` function\n * @returns A function that generates mutation keys\n *\n * @example Basic usage:\n * ```typescript\n * const createMutationKey = createMutationKey(endpoint.config);\n * const mutationKey = createMutationKey({ urlParams: { id: 123 } });\n * ```\n *\n * @example Advanced usage with processResponse:\n * ```ts\n * const createMutationKey = createMutationKey(endpoint.config, {\n * processResponse: (data) => {\n * if (!data.success) {\n * throw new Error(data.message);\n * }\n * return data.data;\n * },\n * });\n * // We create a mutation that will be shared across the project for all passed userId\n * const mutationKey = createMutationKey({ urlParams: { projectId: 123, userId: 'wildcard' } });\n * ```\n */\nexport function createMutationKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options = {\n processResponse: (data) => data,\n } as Options,\n): (\n params: HasParams extends true ? { urlParams: UrlParams<Url> } : {},\n) => Options['processResponse'] extends (...args: unknown[]) => infer Result\n ? DataTag<[Config['url']], Result, Error>\n : never {\n const queryKey = createQueryKey(config, options, false)\n\n // @ts-expect-error We have correct types in return type\n return (params) => {\n return queryKey.filterKey(params)\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createMutationKey instead */\nexport const mutationKeyCreator = createMutationKey\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n NaviosZodRequest,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type {\n MutationFunctionContext,\n UseMutationResult,\n} from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport { useIsMutating, useMutation } from '@tanstack/react-query'\n\nimport type { MutationParams } from './types.mjs'\n\nimport { createMutationKey } from './key-creator.mjs'\n\n/**\n * Creates a mutation hook for a given endpoint.\n *\n * Returns a function that when called returns a TanStack Query mutation result.\n * The returned function also has helper methods attached (mutationKey, useIsMutating).\n *\n * @param endpoint - The navios endpoint to create a mutation hook for\n * @param options - Mutation configuration including processResponse and callbacks\n * @returns A hook function that returns mutation result with attached helpers\n */\nexport function makeMutation<\n Config extends AnyEndpointConfig,\n TData = unknown,\n TVariables extends NaviosZodRequest<Config> = NaviosZodRequest<Config>,\n TResponse = z.output<Config['responseSchema']>,\n TOnMutateResult = unknown,\n TContext = unknown,\n UseKey extends boolean = false,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: MutationParams<\n Config,\n TData,\n TVariables,\n TResponse,\n TOnMutateResult,\n TContext,\n UseKey\n >,\n) {\n const config = endpoint.config\n\n const mutationKey = createMutationKey(config, {\n ...options,\n processResponse: options.processResponse ?? ((data) => data),\n })\n const result = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): UseMutationResult<\n TData,\n Error,\n NaviosZodRequest<Config>,\n TOnMutateResult\n > => {\n const {\n useKey,\n useContext,\n onMutate,\n onError,\n onSuccess,\n onSettled,\n keyPrefix: _keyPrefix,\n keySuffix: _keySuffix,\n processResponse,\n ...rest\n } = options\n\n const ownContext = (useContext?.() as TContext) ?? {}\n\n // @ts-expect-error The types match\n return useMutation({\n ...rest,\n mutationKey: useKey\n ? mutationKey({\n urlParams: keyParams,\n })\n : undefined,\n scope: useKey\n ? {\n id: JSON.stringify(\n mutationKey({\n urlParams: keyParams,\n }),\n ),\n }\n : undefined,\n async mutationFn(params: TVariables) {\n const response = await endpoint(params)\n\n return (processResponse ? processResponse(response) : response) as TData\n },\n onSuccess: onSuccess\n ? (\n data: TData,\n variables: TVariables,\n onMutateResult: TOnMutateResult | undefined,\n context: MutationFunctionContext,\n ) => {\n return onSuccess?.(data, variables, {\n ...ownContext,\n ...context,\n onMutateResult,\n } as TContext &\n MutationFunctionContext & {\n onMutateResult: TOnMutateResult | undefined\n })\n }\n : undefined,\n onError: onError\n ? (\n err: Error,\n variables: TVariables,\n onMutateResult: TOnMutateResult | undefined,\n context: MutationFunctionContext,\n ) => {\n return onError?.(err, variables, {\n onMutateResult,\n ...ownContext,\n ...context,\n } as TContext &\n MutationFunctionContext & {\n onMutateResult: TOnMutateResult | undefined\n })\n }\n : undefined,\n onMutate: onMutate\n ? (variables: TVariables, context: MutationFunctionContext) => {\n return onMutate(variables, {\n ...ownContext,\n ...context,\n } as TContext & MutationFunctionContext)\n }\n : undefined,\n onSettled: onSettled\n ? (\n data: TData | undefined,\n error: Error | null,\n variables: TVariables,\n onMutateResult: TOnMutateResult | undefined,\n context: MutationFunctionContext,\n ) => {\n return onSettled(data, error, variables, {\n ...ownContext,\n ...context,\n onMutateResult,\n } as TContext &\n MutationFunctionContext & {\n onMutateResult: TOnMutateResult | undefined\n })\n }\n : undefined,\n })\n }\n result.useIsMutating = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): boolean => {\n if (!options.useKey) {\n throw new Error(\n 'useIsMutating can only be used when useKey is set to true',\n )\n }\n const isMutating = useIsMutating({\n mutationKey: mutationKey({\n urlParams: keyParams,\n }),\n })\n return isMutating > 0\n }\n result.mutationKey = mutationKey\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AbstractStream,\n AnyEndpointConfig,\n AnyStreamConfig,\n HttpMethod,\n} from '@navios/builder'\nimport type {\n InfiniteData,\n MutationFunctionContext,\n QueryClient,\n} from '@tanstack/react-query'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport type {\n ClientOptions,\n ProcessResponseFunction,\n} from '../common/types.mjs'\nimport type { MutationArgs } from '../mutation/types.mjs'\nimport type { ClientInstance } from './types.mjs'\n\nimport { makeMutation } from '../mutation/make-hook.mjs'\nimport { makeInfiniteQueryOptions } from '../query/make-infinite-options.mjs'\nimport { makeQueryOptions } from '../query/make-options.mjs'\n\n/**\n * Configuration for declaring a query endpoint.\n */\nexport interface QueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema = ZodObject,\n Response extends ZodType = ZodType,\n Result = z.output<Response>,\n RequestSchema = unknown,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => Result\n}\n\n/**\n * Configuration for declaring an infinite query endpoint.\n */\nexport type InfiniteQueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema extends ZodObject = ZodObject,\n Response extends ZodType = ZodType,\n PageResult = z.output<Response>,\n Result = InfiniteData<PageResult>,\n RequestSchema = unknown,\n> = {\n method: Method\n url: Url\n querySchema: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => PageResult\n select?: (data: InfiniteData<PageResult>) => Result\n getNextPageParam: (\n lastPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema> | undefined\n getPreviousPageParam?: (\n firstPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema>\n initialPageParam?: z.input<QuerySchema>\n}\n\n/**\n * Configuration for declaring a mutation endpoint.\n */\nexport interface MutationConfig<\n Method extends 'POST' | 'PUT' | 'PATCH' | 'DELETE' =\n | 'POST'\n | 'PUT'\n | 'PATCH'\n | 'DELETE',\n Url extends string = string,\n RequestSchema = Method extends 'DELETE' ? never : ZodObject,\n QuerySchema = unknown,\n Response extends ZodType = ZodType,\n ReqResult = z.output<Response>,\n Result = unknown,\n TOnMutateResult = unknown,\n Context = unknown,\n UseKey extends boolean = false,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse: ProcessResponseFunction<Result, ReqResult>\n useContext?: () => Context\n onSuccess?: (\n data: Result,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context &\n MutationFunctionContext & { onMutateResult: TOnMutateResult | undefined },\n ) => void | Promise<void>\n onError?: (\n err: unknown,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context &\n MutationFunctionContext & { onMutateResult: TOnMutateResult | undefined },\n ) => void | Promise<void>\n onMutate?: (\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context & MutationFunctionContext,\n ) => TOnMutateResult | Promise<TOnMutateResult>\n onSettled?: (\n data: Result | undefined,\n error: Error | null,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context &\n MutationFunctionContext & { onMutateResult: TOnMutateResult | undefined },\n ) => void | Promise<void>\n useKey?: UseKey\n meta?: Record<string, unknown>\n}\n\n/**\n * Creates a client instance for making type-safe queries and mutations.\n *\n * @param options - Client configuration including the API builder and defaults\n * @returns A client instance with query, infiniteQuery, and mutation methods\n *\n * @example\n * ```typescript\n * const api = createBuilder({ baseUrl: '/api' });\n * const client = declareClient({ api });\n *\n * const getUser = client.query({\n * method: 'GET',\n * url: '/users/$id',\n * responseSchema: UserSchema,\n * });\n *\n * // In a component\n * const { data } = useSuspenseQuery(getUser({ urlParams: { id: '123' } }));\n * ```\n */\nexport function declareClient<Options extends ClientOptions>({\n api,\n defaults = {},\n}: Options): ClientInstance {\n function query(config: QueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const queryOptions = makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n })\n // @ts-expect-error We attach the endpoint to the queryOptions\n queryOptions.endpoint = endpoint\n return queryOptions\n }\n\n function queryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options?: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n },\n ) {\n return makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n })\n }\n\n function infiniteQuery(config: InfiniteQueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n const infiniteQueryOptions = makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n getNextPageParam: config.getNextPageParam,\n getPreviousPageParam: config.getPreviousPageParam,\n initialPageParam: config.initialPageParam,\n })\n\n // @ts-expect-error We attach the endpoint to the infiniteQueryOptions\n infiniteQueryOptions.endpoint = endpoint\n return infiniteQueryOptions\n }\n\n function infiniteQueryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n getNextPageParam: (\n lastPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']> | undefined\n getPreviousPageParam?: (\n firstPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']>\n initialPageParam?: z.input<AnyEndpointConfig['querySchema']>\n },\n ) {\n return makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options?.getPreviousPageParam,\n initialPageParam: options?.initialPageParam,\n })\n }\n\n function mutation(config: MutationConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n meta: config.meta,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n function mutationFromEndpoint(\n endpoint:\n | AbstractEndpoint<AnyEndpointConfig>\n | AbstractStream<AnyStreamConfig>,\n options?: {\n processResponse?: ProcessResponseFunction\n useContext?: () => unknown\n onSuccess?: (\n queryClient: QueryClient,\n data: unknown,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n },\n ) {\n // @ts-expect-error endpoint types are compatible at runtime\n return makeMutation(endpoint, {\n processResponse: options?.processResponse,\n useContext: options?.useContext,\n onSuccess: options?.onSuccess,\n onError: options?.onError,\n ...defaults,\n })\n }\n\n function multipartMutation(config: MutationConfig) {\n const endpoint = api.declareMultipart({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onMutate: config.onMutate,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSettled: config.onSettled,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n return {\n // @ts-expect-error We simplified types here\n query,\n // @ts-expect-error We simplified types here\n queryFromEndpoint,\n // @ts-expect-error We simplified types here\n infiniteQuery,\n // @ts-expect-error We simplified types here\n infiniteQueryFromEndpoint,\n // @ts-expect-error We simplified types here\n mutation,\n // @ts-expect-error We simplified types here\n mutationFromEndpoint,\n // @ts-expect-error We simplified types here\n multipartMutation,\n }\n}\n"]}
|
package/package.json
CHANGED
|
@@ -10,6 +10,7 @@ import { declareClient } from '../client/declare-client.mjs'
|
|
|
10
10
|
|
|
11
11
|
vi.mock('@tanstack/react-query', async (importReal) => {
|
|
12
12
|
const actual = await importReal<typeof import('@tanstack/react-query')>()
|
|
13
|
+
const mockMutationContext = { mutationId: 1, meta: undefined }
|
|
13
14
|
return {
|
|
14
15
|
...actual,
|
|
15
16
|
useQueryClient: () => ({
|
|
@@ -22,11 +23,27 @@ vi.mock('@tanstack/react-query', async (importReal) => {
|
|
|
22
23
|
...req,
|
|
23
24
|
mutateAsync: async (data: unknown) => {
|
|
24
25
|
try {
|
|
26
|
+
const onMutateResult = await req.onMutate?.(data, mockMutationContext)
|
|
25
27
|
const res = await req.mutationFn(data)
|
|
26
|
-
await req.onSuccess?.(res, data)
|
|
28
|
+
await req.onSuccess?.(res, data, onMutateResult, mockMutationContext)
|
|
29
|
+
await req.onSettled?.(
|
|
30
|
+
res,
|
|
31
|
+
null,
|
|
32
|
+
data,
|
|
33
|
+
onMutateResult,
|
|
34
|
+
mockMutationContext,
|
|
35
|
+
)
|
|
27
36
|
return res
|
|
28
37
|
} catch (err) {
|
|
29
|
-
|
|
38
|
+
const onMutateResult = undefined
|
|
39
|
+
await req.onError?.(err, data, onMutateResult, mockMutationContext)
|
|
40
|
+
await req.onSettled?.(
|
|
41
|
+
undefined,
|
|
42
|
+
err,
|
|
43
|
+
data,
|
|
44
|
+
onMutateResult,
|
|
45
|
+
mockMutationContext,
|
|
46
|
+
)
|
|
30
47
|
throw err
|
|
31
48
|
}
|
|
32
49
|
},
|
|
@@ -147,7 +164,7 @@ describe('declareClient', () => {
|
|
|
147
164
|
}
|
|
148
165
|
return data
|
|
149
166
|
},
|
|
150
|
-
onSuccess(
|
|
167
|
+
onSuccess(data, variables, context) {
|
|
151
168
|
expect(data).toMatchObject({
|
|
152
169
|
success: true,
|
|
153
170
|
test: 'test',
|
|
@@ -161,9 +178,11 @@ describe('declareClient', () => {
|
|
|
161
178
|
testId: 'test',
|
|
162
179
|
},
|
|
163
180
|
})
|
|
181
|
+
expect(context).toHaveProperty('mutationId')
|
|
182
|
+
expect(context).toHaveProperty('onMutateResult')
|
|
164
183
|
},
|
|
165
|
-
onError: (err) => {
|
|
166
|
-
console.log('onError', err)
|
|
184
|
+
onError: (err, _variables, context) => {
|
|
185
|
+
console.log('onError', err, context)
|
|
167
186
|
},
|
|
168
187
|
})
|
|
169
188
|
|
|
@@ -10,6 +10,7 @@ import { makeMutation } from '../mutation/make-hook.mjs'
|
|
|
10
10
|
|
|
11
11
|
vi.mock('@tanstack/react-query', async (importReal) => {
|
|
12
12
|
const actual = await importReal<typeof import('@tanstack/react-query')>()
|
|
13
|
+
const mockMutationContext = { mutationId: 1, meta: undefined }
|
|
13
14
|
return {
|
|
14
15
|
...actual,
|
|
15
16
|
useQueryClient: () => ({
|
|
@@ -22,11 +23,27 @@ vi.mock('@tanstack/react-query', async (importReal) => {
|
|
|
22
23
|
...req,
|
|
23
24
|
mutateAsync: async (data: unknown) => {
|
|
24
25
|
try {
|
|
26
|
+
const onMutateResult = await req.onMutate?.(data, mockMutationContext)
|
|
25
27
|
const res = await req.mutationFn(data)
|
|
26
|
-
await req.onSuccess?.(res, data)
|
|
28
|
+
await req.onSuccess?.(res, data, onMutateResult, mockMutationContext)
|
|
29
|
+
await req.onSettled?.(
|
|
30
|
+
res,
|
|
31
|
+
null,
|
|
32
|
+
data,
|
|
33
|
+
onMutateResult,
|
|
34
|
+
mockMutationContext,
|
|
35
|
+
)
|
|
27
36
|
return res
|
|
28
37
|
} catch (err) {
|
|
29
|
-
|
|
38
|
+
const onMutateResult = undefined
|
|
39
|
+
await req.onError?.(err, data, onMutateResult, mockMutationContext)
|
|
40
|
+
await req.onSettled?.(
|
|
41
|
+
undefined,
|
|
42
|
+
err,
|
|
43
|
+
data,
|
|
44
|
+
onMutateResult,
|
|
45
|
+
mockMutationContext,
|
|
46
|
+
)
|
|
30
47
|
throw err
|
|
31
48
|
}
|
|
32
49
|
},
|
|
@@ -77,7 +94,7 @@ describe('makeMutation', () => {
|
|
|
77
94
|
}
|
|
78
95
|
return data
|
|
79
96
|
},
|
|
80
|
-
onSuccess: (
|
|
97
|
+
onSuccess: (data, variables, context) => {
|
|
81
98
|
expect(data).toMatchObject({
|
|
82
99
|
success: true,
|
|
83
100
|
test: 'test',
|
|
@@ -95,10 +112,12 @@ describe('makeMutation', () => {
|
|
|
95
112
|
foo: 'bar',
|
|
96
113
|
},
|
|
97
114
|
})
|
|
115
|
+
expect(context).toHaveProperty('mutationId')
|
|
116
|
+
expect(context).toHaveProperty('onMutateResult')
|
|
98
117
|
},
|
|
99
118
|
|
|
100
|
-
onError: (err) => {
|
|
101
|
-
console.log('onError', err)
|
|
119
|
+
onError: (err, _variables, context) => {
|
|
120
|
+
console.log('onError', err, context)
|
|
102
121
|
},
|
|
103
122
|
})
|
|
104
123
|
// @ts-expect-error internal type
|
|
@@ -184,7 +203,7 @@ describe('makeMutation', () => {
|
|
|
184
203
|
expect(result).toContain('blob:')
|
|
185
204
|
})
|
|
186
205
|
|
|
187
|
-
it('should call onSuccess with Blob data', async () => {
|
|
206
|
+
it('should call onSuccess with Blob data and context', async () => {
|
|
188
207
|
const onSuccess = vi.fn()
|
|
189
208
|
// @ts-expect-error stream endpoint type differs from regular endpoint
|
|
190
209
|
const mutation = makeMutation(streamEndpoint, {
|
|
@@ -198,10 +217,133 @@ describe('makeMutation', () => {
|
|
|
198
217
|
})
|
|
199
218
|
|
|
200
219
|
expect(onSuccess).toHaveBeenCalledTimes(1)
|
|
201
|
-
expect(onSuccess.mock.calls[0][
|
|
202
|
-
expect(onSuccess.mock.calls[0][
|
|
220
|
+
expect(onSuccess.mock.calls[0][0]).toBeInstanceOf(Blob)
|
|
221
|
+
expect(onSuccess.mock.calls[0][1]).toMatchObject({
|
|
203
222
|
urlParams: { fileId: '123' },
|
|
204
223
|
})
|
|
224
|
+
// Third argument should be context with onMutateResult and mutationId
|
|
225
|
+
expect(onSuccess.mock.calls[0][2]).toHaveProperty('onMutateResult')
|
|
226
|
+
expect(onSuccess.mock.calls[0][2]).toHaveProperty('mutationId')
|
|
227
|
+
})
|
|
228
|
+
})
|
|
229
|
+
|
|
230
|
+
describe('mutation callbacks', () => {
|
|
231
|
+
it('should call onMutate before mutation and pass result to other callbacks', async () => {
|
|
232
|
+
const callOrder: string[] = []
|
|
233
|
+
const onMutate = vi.fn((_variables, _context) => {
|
|
234
|
+
callOrder.push('onMutate')
|
|
235
|
+
return { optimisticId: 'temp-123' }
|
|
236
|
+
})
|
|
237
|
+
const onSuccess = vi.fn((_data, _variables, context) => {
|
|
238
|
+
callOrder.push('onSuccess')
|
|
239
|
+
expect(context.onMutateResult).toEqual({ optimisticId: 'temp-123' })
|
|
240
|
+
})
|
|
241
|
+
const onSettled = vi.fn((_data, _error, _variables, context) => {
|
|
242
|
+
callOrder.push('onSettled')
|
|
243
|
+
expect(context.onMutateResult).toEqual({ optimisticId: 'temp-123' })
|
|
244
|
+
})
|
|
245
|
+
|
|
246
|
+
const mutation = makeMutation(endpoint, {
|
|
247
|
+
processResponse: (data) => {
|
|
248
|
+
if (!data.success) throw new Error(data.message)
|
|
249
|
+
return data
|
|
250
|
+
},
|
|
251
|
+
onMutate,
|
|
252
|
+
onSuccess,
|
|
253
|
+
onSettled,
|
|
254
|
+
})
|
|
255
|
+
|
|
256
|
+
// @ts-expect-error internal type
|
|
257
|
+
const mutationResult = mutation()
|
|
258
|
+
await mutationResult.mutateAsync({
|
|
259
|
+
urlParams: { testId: '1', fooId: '2' },
|
|
260
|
+
data: { testId: '1', fooId: '2' },
|
|
261
|
+
params: { foo: 'bar' },
|
|
262
|
+
})
|
|
263
|
+
|
|
264
|
+
expect(callOrder).toEqual(['onMutate', 'onSuccess', 'onSettled'])
|
|
265
|
+
expect(onMutate).toHaveBeenCalledTimes(1)
|
|
266
|
+
expect(onSuccess).toHaveBeenCalledTimes(1)
|
|
267
|
+
expect(onSettled).toHaveBeenCalledTimes(1)
|
|
268
|
+
})
|
|
269
|
+
|
|
270
|
+
it('should call onError and onSettled on failure', async () => {
|
|
271
|
+
adapter.mock('/test/1/foo/2', 'POST', () => {
|
|
272
|
+
return new Response(
|
|
273
|
+
JSON.stringify({ success: false, message: 'Test error' }),
|
|
274
|
+
{ status: 200, headers: { 'content-type': 'application/json' } },
|
|
275
|
+
)
|
|
276
|
+
})
|
|
277
|
+
|
|
278
|
+
const onError = vi.fn()
|
|
279
|
+
const onSettled = vi.fn()
|
|
280
|
+
|
|
281
|
+
const mutation = makeMutation(endpoint, {
|
|
282
|
+
processResponse: (data) => {
|
|
283
|
+
if (!data.success) throw new Error(data.message)
|
|
284
|
+
return data
|
|
285
|
+
},
|
|
286
|
+
onError,
|
|
287
|
+
onSettled,
|
|
288
|
+
})
|
|
289
|
+
|
|
290
|
+
// @ts-expect-error internal type
|
|
291
|
+
const mutationResult = mutation()
|
|
292
|
+
|
|
293
|
+
await expect(
|
|
294
|
+
mutationResult.mutateAsync({
|
|
295
|
+
urlParams: { testId: '1', fooId: '2' },
|
|
296
|
+
data: { testId: '1', fooId: '2' },
|
|
297
|
+
params: { foo: 'bar' },
|
|
298
|
+
}),
|
|
299
|
+
).rejects.toThrow('Test error')
|
|
300
|
+
|
|
301
|
+
expect(onError).toHaveBeenCalledTimes(1)
|
|
302
|
+
expect(onError.mock.calls[0][0]).toBeInstanceOf(Error)
|
|
303
|
+
expect(onError.mock.calls[0][0].message).toBe('Test error')
|
|
304
|
+
expect(onSettled).toHaveBeenCalledTimes(1)
|
|
305
|
+
expect(onSettled.mock.calls[0][1]).toBeInstanceOf(Error)
|
|
306
|
+
|
|
307
|
+
// Restore the mock
|
|
308
|
+
adapter.mock('/test/1/foo/2', 'POST', () => {
|
|
309
|
+
return new Response(
|
|
310
|
+
JSON.stringify({ success: true, test: 'test' }),
|
|
311
|
+
{ status: 200, headers: { 'content-type': 'application/json' } },
|
|
312
|
+
)
|
|
313
|
+
})
|
|
314
|
+
})
|
|
315
|
+
|
|
316
|
+
it('should merge useContext result with MutationFunctionContext', async () => {
|
|
317
|
+
const useContext = () => ({
|
|
318
|
+
queryClient: { invalidate: vi.fn() },
|
|
319
|
+
customValue: 'test',
|
|
320
|
+
})
|
|
321
|
+
|
|
322
|
+
const onSuccess = vi.fn()
|
|
323
|
+
|
|
324
|
+
const mutation = makeMutation(endpoint, {
|
|
325
|
+
processResponse: (data) => {
|
|
326
|
+
if (!data.success) throw new Error(data.message)
|
|
327
|
+
return data
|
|
328
|
+
},
|
|
329
|
+
useContext,
|
|
330
|
+
onSuccess,
|
|
331
|
+
})
|
|
332
|
+
|
|
333
|
+
// @ts-expect-error internal type
|
|
334
|
+
const mutationResult = mutation()
|
|
335
|
+
await mutationResult.mutateAsync({
|
|
336
|
+
urlParams: { testId: '1', fooId: '2' },
|
|
337
|
+
data: { testId: '1', fooId: '2' },
|
|
338
|
+
params: { foo: 'bar' },
|
|
339
|
+
})
|
|
340
|
+
|
|
341
|
+
expect(onSuccess).toHaveBeenCalledTimes(1)
|
|
342
|
+
const context = onSuccess.mock.calls[0][2]
|
|
343
|
+
expect(context).toHaveProperty('queryClient')
|
|
344
|
+
expect(context).toHaveProperty('customValue', 'test')
|
|
345
|
+
expect(context).toHaveProperty('mutationId')
|
|
346
|
+
expect(context).toHaveProperty('onMutateResult')
|
|
205
347
|
})
|
|
206
348
|
})
|
|
207
349
|
})
|
|
@@ -5,10 +5,17 @@ import type {
|
|
|
5
5
|
AnyStreamConfig,
|
|
6
6
|
HttpMethod,
|
|
7
7
|
} from '@navios/builder'
|
|
8
|
-
import type {
|
|
8
|
+
import type {
|
|
9
|
+
InfiniteData,
|
|
10
|
+
MutationFunctionContext,
|
|
11
|
+
QueryClient,
|
|
12
|
+
} from '@tanstack/react-query'
|
|
9
13
|
import type { z, ZodObject, ZodType } from 'zod/v4'
|
|
10
14
|
|
|
11
|
-
import type {
|
|
15
|
+
import type {
|
|
16
|
+
ClientOptions,
|
|
17
|
+
ProcessResponseFunction,
|
|
18
|
+
} from '../common/types.mjs'
|
|
12
19
|
import type { MutationArgs } from '../mutation/types.mjs'
|
|
13
20
|
import type { ClientInstance } from './types.mjs'
|
|
14
21
|
|
|
@@ -84,6 +91,7 @@ export interface MutationConfig<
|
|
|
84
91
|
Response extends ZodType = ZodType,
|
|
85
92
|
ReqResult = z.output<Response>,
|
|
86
93
|
Result = unknown,
|
|
94
|
+
TOnMutateResult = unknown,
|
|
87
95
|
Context = unknown,
|
|
88
96
|
UseKey extends boolean = false,
|
|
89
97
|
> {
|
|
@@ -95,18 +103,30 @@ export interface MutationConfig<
|
|
|
95
103
|
processResponse: ProcessResponseFunction<Result, ReqResult>
|
|
96
104
|
useContext?: () => Context
|
|
97
105
|
onSuccess?: (
|
|
98
|
-
|
|
99
|
-
data: NoInfer<Result>,
|
|
106
|
+
data: Result,
|
|
100
107
|
variables: MutationArgs<Url, RequestSchema, QuerySchema>,
|
|
101
|
-
context: Context
|
|
108
|
+
context: Context &
|
|
109
|
+
MutationFunctionContext & { onMutateResult: TOnMutateResult | undefined },
|
|
102
110
|
) => void | Promise<void>
|
|
103
111
|
onError?: (
|
|
104
|
-
|
|
105
|
-
error: Error,
|
|
112
|
+
err: unknown,
|
|
106
113
|
variables: MutationArgs<Url, RequestSchema, QuerySchema>,
|
|
107
|
-
context: Context
|
|
114
|
+
context: Context &
|
|
115
|
+
MutationFunctionContext & { onMutateResult: TOnMutateResult | undefined },
|
|
116
|
+
) => void | Promise<void>
|
|
117
|
+
onMutate?: (
|
|
118
|
+
variables: MutationArgs<Url, RequestSchema, QuerySchema>,
|
|
119
|
+
context: Context & MutationFunctionContext,
|
|
120
|
+
) => TOnMutateResult | Promise<TOnMutateResult>
|
|
121
|
+
onSettled?: (
|
|
122
|
+
data: Result | undefined,
|
|
123
|
+
error: Error | null,
|
|
124
|
+
variables: MutationArgs<Url, RequestSchema, QuerySchema>,
|
|
125
|
+
context: Context &
|
|
126
|
+
MutationFunctionContext & { onMutateResult: TOnMutateResult | undefined },
|
|
108
127
|
) => void | Promise<void>
|
|
109
128
|
useKey?: UseKey
|
|
129
|
+
meta?: Record<string, unknown>
|
|
110
130
|
}
|
|
111
131
|
|
|
112
132
|
/**
|
|
@@ -237,6 +257,7 @@ export function declareClient<Options extends ClientOptions>({
|
|
|
237
257
|
// @ts-expect-error We forgot about the DELETE method in original makeMutation
|
|
238
258
|
onError: config.onError,
|
|
239
259
|
useKey: config.useKey,
|
|
260
|
+
meta: config.meta,
|
|
240
261
|
...defaults,
|
|
241
262
|
})
|
|
242
263
|
|
|
@@ -293,6 +314,10 @@ export function declareClient<Options extends ClientOptions>({
|
|
|
293
314
|
onSuccess: config.onSuccess,
|
|
294
315
|
// @ts-expect-error We forgot about the DELETE method in original makeMutation
|
|
295
316
|
onError: config.onError,
|
|
317
|
+
// @ts-expect-error We forgot about the DELETE method in original makeMutation
|
|
318
|
+
onMutate: config.onMutate,
|
|
319
|
+
// @ts-expect-error We forgot about the DELETE method in original makeMutation
|
|
320
|
+
onSettled: config.onSettled,
|
|
296
321
|
useKey: config.useKey,
|
|
297
322
|
...defaults,
|
|
298
323
|
})
|