@pixotope/query 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -31,80 +31,34 @@ type UseQueryResult<TData = unknown, TError = unknown, TParams = void, TSelectDa
 } & (Stateless extends true ? {} : WithData$1<TSelectData>);
 declare const useQuery: <TData = unknown, TError = unknown, TParams = void, TSelected = TData, Stateless extends true | undefined = undefined>({ queryFn, ...options }: QueryOptions<TData, TError, TParams, TSelected, Stateless>) => UseQueryResult<TSelected, TError, TParams, TSelected, Stateless>;
 
-type MutationFunction<TData = unknown, TParams = unknown> = (params: TParams, overrideTargetMachine?: string) => Promise<TData>;
-interface MutationOptions<TData = unknown, TError = unknown, TParams = void> {
-    mutationFn: MutationFunction<TData, TParams>;
+type MutationFunction<TData = unknown, TParams = unknown, TMetadata = unknown> = (params: TParams, meta?: TMetadata) => Promise<TData>;
+interface MutationOptions<TData = unknown, TError = unknown, TParams = void, TMetadata = unknown> {
+    mutationFn: MutationFunction<TData, TParams, TMetadata>;
     params?: TParams;
-    onSuccess?: (data: TData, variables: TParams) => Promise<unknown> | unknown;
-    onError?: (error: TMutationError<TError>, variables: TParams) => Promise<unknown> | unknown;
-    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams) => Promise<unknown> | unknown;
+    onSuccess?: (data: TData, variables: TParams, meta?: TMetadata) => Promise<unknown> | unknown;
+    onError?: (error: TMutationError<TError>, variables: TParams, meta?: TMetadata) => Promise<unknown> | unknown;
+    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams, meta?: TMetadata) => Promise<unknown> | unknown;
     compareOrThrow?: (result: TData | TError) => boolean;
     timeout?: number;
-    prepareParams?: (variables: TParams, defaults?: TParams) => TParams;
+    prepareParams?: (variables: TParams, defaults?: TParams, meta?: TMetadata) => TParams;
 }
 type TMutationError<TError> = TError | Error | null;
-interface MutateOptions<TData = unknown, TError = unknown, TParams = void> {
-    onSuccess?: (data: TData, variables: TParams) => void;
-    onError?: (error: TMutationError<TError>, variables: TParams) => void;
-    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams) => void;
+interface MutateOptions<TData = unknown, TError = unknown, TParams = void, TMetadata = unknown> {
+    onSuccess?: (data: TData, variables: TParams, meta?: TMetadata) => void;
+    onError?: (error: TMutationError<TError>, variables: TParams, meta?: TMetadata) => void;
+    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams, meta?: TMetadata) => void;
 }
 type MutationStatus = "idle" | "loading" | "success" | "error";
 declare class ComparisonFailError<TPayload = unknown> extends Error {
     readonly payload: TPayload;
     constructor(message: string, payload: TPayload);
 }
-/**
- * `useMutation` is a hook that allows you to perform a mutation/push updates to the services while
- * providing extensive API to tap into the status and results of the mutation.
- * @param mutationFn The mutation function to be called when the `mutate` function is called.
- * `useMutation` does not care about what the function does, all it needs it a function that returns
- * a promise.
- * @param options Options to configure the mutation.
- * @returns An object with the following properties:
- * - `mutateAsync`: A function that takes in the variables and returns a promise that resolves to the
- * result of the mutation. This function can be awaited to get the result of the mutation. Callbacks can
- * be passed to this function to be called when the mutation is successful or when it fails. It's good idea
- * to wrap this function in a try/catch block.
- * - `mutate`: A function that takes in the variables and returns nothing. This function does not
- * return a promise. Callbacks can be passed to this function to be called when the mutation is
- * successful or when it fails.
- * - `status`: The status of the mutation. Can be one of `idle`, `loading`, `success` or `error`.
- * - `result`: The result of the mutation. This is undefined until the mutation is successful.
- * - `reset`: A function that resets the mutation to the initial state.
- * - `error`: The error object if the mutation has failed.
- * @example
- * ```typescript
- * const mutationRes = useMutation({
- *    mutationFn: (variables) => {
- *      return ZMQHelper.callSomethingAsync(variables)
- *    },
- *    onSuccess: (data) => {
- *      // do something with the result
- *    },
- *    onError: (error) => {
- *      // do something with the error
- *    },
- *    onSettled: (data, error) => {
- *      // do something when the mutation is done
- *   }});
- *
- * // call the mutation
- * const res = await mutationRes.mutateAsync({ foo: "bar" });
- * // OR
- * mutationRes.mutate({ foo: "bar" }, {
- *  onSuccess: (data) => {
- *    // do something with the result
- *    // for example show a toast message
- *    // stop local loading state
- * });
- * ```
- */
-declare const useMutation: <TData = unknown, TError = unknown, TParams = void>(options: MutationOptions<TData, TError, TParams>) => {
-    mutateAsync: (params: TParams, overrideTargetMachine?: string) => Promise<TData>;
+declare const useMutation: <TData = unknown, TError = unknown, TParams = void, TMetadata = unknown>(options: MutationOptions<TData, TError, TParams, TMetadata>) => {
+    mutateAsync: (params: TParams, meta?: TMetadata) => Promise<TData>;
     status: MutationStatus;
     result: TData | undefined;
-    mutate: (variables: TParams, options?: MutateOptions<TData, TError, TParams> & {
-        overrideTargetMachine?: string;
+    mutate: (variables: TParams, options?: MutateOptions<TData, TError, TParams, TMetadata> & {
+        meta?: TMetadata;
     }) => void;
     reset: () => void;
     error: TMutationError<TError>;
@@ -116,36 +70,38 @@ type MutationInfo<TData, TError, TParams> = {
     params: TParams;
 };
 type FnToParamsBase = Record<string, MutationInfo<unknown, unknown, unknown>>;
-type TPromiseFunction<TResponse, TParams> = (args: Omit<ZMQClient.Call<TResponse, {
+type TPromiseFunction<TResponse, TParams, TExtraParams> = (args: Omit<ZMQClient.Call<TResponse, {
     functionName: string;
     parameters: TParams;
     options?: Omit<TSocketServerCallOptions, "toCallIfNoResponse">;
-}>, "id">) => Promise<TResponse>;
-declare const useCallMutationBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown>(promiseFunc: TPromiseFunction<TData, TParams>, functionName: keyof TFnToParams, service: string, options?: Omit<MutationOptions<TData, TError, TParams>, "mutationFn">) => {
-    mutateAsync: (params: TParams, overrideTargetMachine?: string) => Promise<TData>;
+}>, "id"> & {
+    meta?: TExtraParams;
+}) => Promise<TResponse>;
+declare const useCallMutationBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown, TMetadata = unknown>(promiseFunc: TPromiseFunction<TData, TParams, TMetadata>, functionName: keyof TFnToParams, service: (meta?: TMetadata) => string, options?: Omit<MutationOptions<TData, TError, TParams, TMetadata>, "mutationFn">) => {
+    mutateAsync: (params: TParams, meta?: TMetadata | undefined) => Promise<TData>;
     status: "idle" | "loading" | "success" | "error";
     result: TData | undefined;
-    mutate: (variables: TParams, options?: (MutateOptions<TData, TError, TParams> & {
-        overrideTargetMachine?: string;
+    mutate: (variables: TParams, options?: (MutateOptions<TData, TError, TParams, TMetadata> & {
+        meta?: TMetadata | undefined;
     }) | undefined) => void;
     reset: () => void;
     error: Error | TError | null;
 };
-declare function buildMutationHook<TFnToParams extends FnToParamsBase>(promiseFunc: TPromiseFunction<unknown, unknown>, genTargetService: (machine: string | undefined) => string): <TFn extends keyof TFnToParams>(func: TFn, options?: Parameters<typeof useCallMutationBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"]>>[3] & {
-    machine?: string;
-}) => {
-    mutateAsync: (params: TFnToParams[TFn]["params"], overrideTargetMachine?: string) => Promise<TFnToParams[TFn]["data"]>;
+declare function buildMutationHook<TFnToParams extends FnToParamsBase, TMetadata = unknown>(promiseFunc: TPromiseFunction<unknown, unknown, unknown>, genTargetService: (meta?: TMetadata) => string): <TFn extends keyof TFnToParams>(func: TFn, options?: Parameters<typeof useCallMutationBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TMetadata>>[3]) => {
+    mutateAsync: (params: TFnToParams[TFn]["params"], meta?: TMetadata | undefined) => Promise<TFnToParams[TFn]["data"]>;
     status: "idle" | "loading" | "success" | "error";
     result: TFnToParams[TFn]["data"] | undefined;
-    mutate: (variables: TFnToParams[TFn]["params"], options?: (MutateOptions<TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"]> & {
-        overrideTargetMachine?: string;
+    mutate: (variables: TFnToParams[TFn]["params"], options?: (MutateOptions<TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TMetadata> & {
+        meta?: TMetadata | undefined;
     }) | undefined) => void;
     reset: () => void;
     error: Error | TFnToParams[TFn]["error"] | null;
 };
-declare const useCallQueryBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown, TSelect = TData>(promiseFunction: TPromiseFunction<TData, TParams>, functionName: keyof TFnToParams, params: TParams, service: string, options?: Omit<QueryOptions<TData, TError, TParams, TSelect>, "queryFn">) => UseQueryResult<TSelect, TError, TParams, TSelect, undefined>;
-declare function buildQueryHook<TFnToParams extends FnToParamsBase>(promiseFunction: TPromiseFunction<unknown, unknown>, getTargetService: (machine: string | undefined) => string): <TFn extends keyof TFnToParams, TSelect = TFnToParams[TFn]["data"]>(func: TFn, params: TFnToParams[TFn]["params"], options?: Parameters<typeof useCallQueryBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TSelect>>[4] & {
-    machine?: string;
+declare const useCallQueryBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown, TSelect = TData, TMetadata = unknown>(promiseFunction: TPromiseFunction<TData, TParams, TMetadata>, functionName: keyof TFnToParams, params: TParams, service: (meta?: TMetadata) => string, options?: Omit<QueryOptions<TData, TError, TParams, TSelect>, "queryFn"> & {
+    meta?: TMetadata;
+}) => UseQueryResult<TSelect, TError, TParams, TSelect, undefined>;
+declare function buildQueryHook<TFnToParams extends FnToParamsBase, TMetadata = unknown>(promiseFunction: TPromiseFunction<unknown, unknown, unknown>, getTargetService: (meta?: TMetadata) => string): <TFn extends keyof TFnToParams, TSelect = TFnToParams[TFn]["data"]>(func: TFn, params: TFnToParams[TFn]["params"], options?: Parameters<typeof useCallQueryBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TSelect, TMetadata>>[4] & {
+    meta?: TMetadata;
 }) => UseQueryResult<TSelect, TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TSelect, undefined>;
 
 /**
@@ -256,6 +212,8 @@ declare function bindPromiseFunction(clientSocketProxy: ZMQProxyWSClient): (args
     functionName: string;
     parameters: unknown;
     options?: Omit<_pixotope_zmq_client.TSocketServerCallOptions, "toCallIfNoResponse">;
-}>, "id">) => Promise<unknown>;
+}>, "id"> & {
+    meta?: unknown;
+}) => Promise<unknown>;
 
 export { ComparisonFailError, type Connection, type MessageHandler, type MutateOptions, type MutationFunction, type MutationInfo, type MutationOptions, type QueryOptions, type SubscriptionCoreOptions, type SubscriptionCoreReturnType, type SubscriptionOptions, type TPromiseFunction, type TSubscriptionHandlerFunction, type UseQueryResult, bindClientSocketProxy, bindPromiseFunction, buildMutationHook, buildQueryHook, buildServiceSubscriptionHook, useMutation, useQuery, useSubscription, useSubscriptionCore };

package/dist/index.d.ts

@@ -31,80 +31,34 @@ type UseQueryResult<TData = unknown, TError = unknown, TParams = void, TSelectDa
 } & (Stateless extends true ? {} : WithData$1<TSelectData>);
 declare const useQuery: <TData = unknown, TError = unknown, TParams = void, TSelected = TData, Stateless extends true | undefined = undefined>({ queryFn, ...options }: QueryOptions<TData, TError, TParams, TSelected, Stateless>) => UseQueryResult<TSelected, TError, TParams, TSelected, Stateless>;
 
-type MutationFunction<TData = unknown, TParams = unknown> = (params: TParams, overrideTargetMachine?: string) => Promise<TData>;
-interface MutationOptions<TData = unknown, TError = unknown, TParams = void> {
-    mutationFn: MutationFunction<TData, TParams>;
+type MutationFunction<TData = unknown, TParams = unknown, TMetadata = unknown> = (params: TParams, meta?: TMetadata) => Promise<TData>;
+interface MutationOptions<TData = unknown, TError = unknown, TParams = void, TMetadata = unknown> {
+    mutationFn: MutationFunction<TData, TParams, TMetadata>;
     params?: TParams;
-    onSuccess?: (data: TData, variables: TParams) => Promise<unknown> | unknown;
-    onError?: (error: TMutationError<TError>, variables: TParams) => Promise<unknown> | unknown;
-    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams) => Promise<unknown> | unknown;
+    onSuccess?: (data: TData, variables: TParams, meta?: TMetadata) => Promise<unknown> | unknown;
+    onError?: (error: TMutationError<TError>, variables: TParams, meta?: TMetadata) => Promise<unknown> | unknown;
+    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams, meta?: TMetadata) => Promise<unknown> | unknown;
     compareOrThrow?: (result: TData | TError) => boolean;
     timeout?: number;
-    prepareParams?: (variables: TParams, defaults?: TParams) => TParams;
+    prepareParams?: (variables: TParams, defaults?: TParams, meta?: TMetadata) => TParams;
 }
 type TMutationError<TError> = TError | Error | null;
-interface MutateOptions<TData = unknown, TError = unknown, TParams = void> {
-    onSuccess?: (data: TData, variables: TParams) => void;
-    onError?: (error: TMutationError<TError>, variables: TParams) => void;
-    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams) => void;
+interface MutateOptions<TData = unknown, TError = unknown, TParams = void, TMetadata = unknown> {
+    onSuccess?: (data: TData, variables: TParams, meta?: TMetadata) => void;
+    onError?: (error: TMutationError<TError>, variables: TParams, meta?: TMetadata) => void;
+    onSettled?: (data: TData | undefined, error: TMutationError<TError> | null, variables: TParams, meta?: TMetadata) => void;
 }
 type MutationStatus = "idle" | "loading" | "success" | "error";
 declare class ComparisonFailError<TPayload = unknown> extends Error {
     readonly payload: TPayload;
     constructor(message: string, payload: TPayload);
 }
-/**
- * `useMutation` is a hook that allows you to perform a mutation/push updates to the services while
- * providing extensive API to tap into the status and results of the mutation.
- * @param mutationFn The mutation function to be called when the `mutate` function is called.
- * `useMutation` does not care about what the function does, all it needs it a function that returns
- * a promise.
- * @param options Options to configure the mutation.
- * @returns An object with the following properties:
- * - `mutateAsync`: A function that takes in the variables and returns a promise that resolves to the
- * result of the mutation. This function can be awaited to get the result of the mutation. Callbacks can
- * be passed to this function to be called when the mutation is successful or when it fails. It's good idea
- * to wrap this function in a try/catch block.
- * - `mutate`: A function that takes in the variables and returns nothing. This function does not
- * return a promise. Callbacks can be passed to this function to be called when the mutation is
- * successful or when it fails.
- * - `status`: The status of the mutation. Can be one of `idle`, `loading`, `success` or `error`.
- * - `result`: The result of the mutation. This is undefined until the mutation is successful.
- * - `reset`: A function that resets the mutation to the initial state.
- * - `error`: The error object if the mutation has failed.
- * @example
- * ```typescript
- * const mutationRes = useMutation({
- *    mutationFn: (variables) => {
- *      return ZMQHelper.callSomethingAsync(variables)
- *    },
- *    onSuccess: (data) => {
- *      // do something with the result
- *    },
- *    onError: (error) => {
- *      // do something with the error
- *    },
- *    onSettled: (data, error) => {
- *      // do something when the mutation is done
- *   }});
- *
- * // call the mutation
- * const res = await mutationRes.mutateAsync({ foo: "bar" });
- * // OR
- * mutationRes.mutate({ foo: "bar" }, {
- *  onSuccess: (data) => {
- *    // do something with the result
- *    // for example show a toast message
- *    // stop local loading state
- * });
- * ```
- */
-declare const useMutation: <TData = unknown, TError = unknown, TParams = void>(options: MutationOptions<TData, TError, TParams>) => {
-    mutateAsync: (params: TParams, overrideTargetMachine?: string) => Promise<TData>;
+declare const useMutation: <TData = unknown, TError = unknown, TParams = void, TMetadata = unknown>(options: MutationOptions<TData, TError, TParams, TMetadata>) => {
+    mutateAsync: (params: TParams, meta?: TMetadata) => Promise<TData>;
     status: MutationStatus;
     result: TData | undefined;
-    mutate: (variables: TParams, options?: MutateOptions<TData, TError, TParams> & {
-        overrideTargetMachine?: string;
+    mutate: (variables: TParams, options?: MutateOptions<TData, TError, TParams, TMetadata> & {
+        meta?: TMetadata;
     }) => void;
     reset: () => void;
     error: TMutationError<TError>;
@@ -116,36 +70,38 @@ type MutationInfo<TData, TError, TParams> = {
     params: TParams;
 };
 type FnToParamsBase = Record<string, MutationInfo<unknown, unknown, unknown>>;
-type TPromiseFunction<TResponse, TParams> = (args: Omit<ZMQClient.Call<TResponse, {
+type TPromiseFunction<TResponse, TParams, TExtraParams> = (args: Omit<ZMQClient.Call<TResponse, {
     functionName: string;
     parameters: TParams;
     options?: Omit<TSocketServerCallOptions, "toCallIfNoResponse">;
-}>, "id">) => Promise<TResponse>;
-declare const useCallMutationBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown>(promiseFunc: TPromiseFunction<TData, TParams>, functionName: keyof TFnToParams, service: string, options?: Omit<MutationOptions<TData, TError, TParams>, "mutationFn">) => {
-    mutateAsync: (params: TParams, overrideTargetMachine?: string) => Promise<TData>;
+}>, "id"> & {
+    meta?: TExtraParams;
+}) => Promise<TResponse>;
+declare const useCallMutationBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown, TMetadata = unknown>(promiseFunc: TPromiseFunction<TData, TParams, TMetadata>, functionName: keyof TFnToParams, service: (meta?: TMetadata) => string, options?: Omit<MutationOptions<TData, TError, TParams, TMetadata>, "mutationFn">) => {
+    mutateAsync: (params: TParams, meta?: TMetadata | undefined) => Promise<TData>;
     status: "idle" | "loading" | "success" | "error";
     result: TData | undefined;
-    mutate: (variables: TParams, options?: (MutateOptions<TData, TError, TParams> & {
-        overrideTargetMachine?: string;
+    mutate: (variables: TParams, options?: (MutateOptions<TData, TError, TParams, TMetadata> & {
+        meta?: TMetadata | undefined;
     }) | undefined) => void;
     reset: () => void;
     error: Error | TError | null;
 };
-declare function buildMutationHook<TFnToParams extends FnToParamsBase>(promiseFunc: TPromiseFunction<unknown, unknown>, genTargetService: (machine: string | undefined) => string): <TFn extends keyof TFnToParams>(func: TFn, options?: Parameters<typeof useCallMutationBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"]>>[3] & {
-    machine?: string;
-}) => {
-    mutateAsync: (params: TFnToParams[TFn]["params"], overrideTargetMachine?: string) => Promise<TFnToParams[TFn]["data"]>;
+declare function buildMutationHook<TFnToParams extends FnToParamsBase, TMetadata = unknown>(promiseFunc: TPromiseFunction<unknown, unknown, unknown>, genTargetService: (meta?: TMetadata) => string): <TFn extends keyof TFnToParams>(func: TFn, options?: Parameters<typeof useCallMutationBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TMetadata>>[3]) => {
+    mutateAsync: (params: TFnToParams[TFn]["params"], meta?: TMetadata | undefined) => Promise<TFnToParams[TFn]["data"]>;
     status: "idle" | "loading" | "success" | "error";
     result: TFnToParams[TFn]["data"] | undefined;
-    mutate: (variables: TFnToParams[TFn]["params"], options?: (MutateOptions<TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"]> & {
-        overrideTargetMachine?: string;
+    mutate: (variables: TFnToParams[TFn]["params"], options?: (MutateOptions<TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TMetadata> & {
+        meta?: TMetadata | undefined;
     }) | undefined) => void;
     reset: () => void;
     error: Error | TFnToParams[TFn]["error"] | null;
 };
-declare const useCallQueryBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown, TSelect = TData>(promiseFunction: TPromiseFunction<TData, TParams>, functionName: keyof TFnToParams, params: TParams, service: string, options?: Omit<QueryOptions<TData, TError, TParams, TSelect>, "queryFn">) => UseQueryResult<TSelect, TError, TParams, TSelect, undefined>;
-declare function buildQueryHook<TFnToParams extends FnToParamsBase>(promiseFunction: TPromiseFunction<unknown, unknown>, getTargetService: (machine: string | undefined) => string): <TFn extends keyof TFnToParams, TSelect = TFnToParams[TFn]["data"]>(func: TFn, params: TFnToParams[TFn]["params"], options?: Parameters<typeof useCallQueryBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TSelect>>[4] & {
-    machine?: string;
+declare const useCallQueryBase: <TFnToParams extends FnToParamsBase, TData = unknown, TError = unknown, TParams = unknown, TSelect = TData, TMetadata = unknown>(promiseFunction: TPromiseFunction<TData, TParams, TMetadata>, functionName: keyof TFnToParams, params: TParams, service: (meta?: TMetadata) => string, options?: Omit<QueryOptions<TData, TError, TParams, TSelect>, "queryFn"> & {
+    meta?: TMetadata;
+}) => UseQueryResult<TSelect, TError, TParams, TSelect, undefined>;
+declare function buildQueryHook<TFnToParams extends FnToParamsBase, TMetadata = unknown>(promiseFunction: TPromiseFunction<unknown, unknown, unknown>, getTargetService: (meta?: TMetadata) => string): <TFn extends keyof TFnToParams, TSelect = TFnToParams[TFn]["data"]>(func: TFn, params: TFnToParams[TFn]["params"], options?: Parameters<typeof useCallQueryBase<TFnToParams, TFnToParams[TFn]["data"], TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TSelect, TMetadata>>[4] & {
+    meta?: TMetadata;
 }) => UseQueryResult<TSelect, TFnToParams[TFn]["error"], TFnToParams[TFn]["params"], TSelect, undefined>;
 
 /**
@@ -256,6 +212,8 @@ declare function bindPromiseFunction(clientSocketProxy: ZMQProxyWSClient): (args
     functionName: string;
     parameters: unknown;
     options?: Omit<_pixotope_zmq_client.TSocketServerCallOptions, "toCallIfNoResponse">;
-}>, "id">) => Promise<unknown>;
+}>, "id"> & {
+    meta?: unknown;
+}) => Promise<unknown>;
 
 export { ComparisonFailError, type Connection, type MessageHandler, type MutateOptions, type MutationFunction, type MutationInfo, type MutationOptions, type QueryOptions, type SubscriptionCoreOptions, type SubscriptionCoreReturnType, type SubscriptionOptions, type TPromiseFunction, type TSubscriptionHandlerFunction, type UseQueryResult, bindClientSocketProxy, bindPromiseFunction, buildMutationHook, buildQueryHook, buildServiceSubscriptionHook, useMutation, useQuery, useSubscription, useSubscriptionCore };

package/dist/index.js

@@ -183,63 +183,61 @@ var useMutation = (options) => {
   };
   const internalCallbackRef = useRef(internalCallbackRefistry);
   internalCallbackRef.current = internalCallbackRefistry;
-  const mutateAsync = useCallback(
-    (params2, overrideTargetMachine) => __async(null, null, function* () {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-      setStatus("loading");
-      setError(null);
-      try {
-        const promises = [
-          mutationFnRef.current(
-            internalCallbackRef.current.prepareParams ? internalCallbackRef.current.prepareParams(
-              params2,
-              internalOptionsRef.current.params
-            ) : params2,
-            overrideTargetMachine
-          ),
-          ...internalOptionsRef.current.timeout ? [
-            new Promise(
-              (resolve) => setTimeout(
-                () => resolve("timeout"),
-                internalOptionsRef.current.timeout
-              )
+  const mutateAsync = useCallback((params2, meta) => __async(null, null, function* () {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    setStatus("loading");
+    setError(null);
+    try {
+      const promises = [
+        mutationFnRef.current(
+          internalCallbackRef.current.prepareParams ? internalCallbackRef.current.prepareParams(
+            params2,
+            internalOptionsRef.current.params,
+            meta
+          ) : params2,
+          meta
+        ),
+        ...internalOptionsRef.current.timeout ? [
+          new Promise(
+            (resolve) => setTimeout(
+              () => resolve("timeout"),
+              internalOptionsRef.current.timeout
             )
-          ] : []
-        ];
-        const res = yield Promise.race(promises);
-        if (res === "timeout") {
-          throw new Error("timeout");
-        }
-        if ((_b = (_a = internalCallbackRef.current).compareOrThrow) == null ? void 0 : _b.call(_a, res)) {
-          throw new ComparisonFailError(JSON.stringify(res), res);
-        }
-        setResult(res);
-        setStatus("success");
-        (_d = (_c = internalCallbackRef.current).onSuccess) == null ? void 0 : _d.call(_c, res, params2);
-        (_f = (_e = internalCallbackRef.current).onSettled) == null ? void 0 : _f.call(_e, res, null, params2);
-        return res;
-      } catch (error2) {
-        setError(error2);
-        setStatus("error");
-        (_h = (_g = internalCallbackRef.current).onError) == null ? void 0 : _h.call(_g, error2, params2);
-        (_j = (_i = internalCallbackRef.current).onSettled) == null ? void 0 : _j.call(_i, void 0, error2, params2);
-        throw error2;
+          )
+        ] : []
+      ];
+      const res = yield Promise.race(promises);
+      if (res === "timeout") {
+        throw new Error("timeout");
       }
-    }),
-    []
-  );
+      if ((_b = (_a = internalCallbackRef.current).compareOrThrow) == null ? void 0 : _b.call(_a, res)) {
+        throw new ComparisonFailError(JSON.stringify(res), res);
+      }
+      setResult(res);
+      setStatus("success");
+      (_d = (_c = internalCallbackRef.current).onSuccess) == null ? void 0 : _d.call(_c, res, params2, meta);
+      (_f = (_e = internalCallbackRef.current).onSettled) == null ? void 0 : _f.call(_e, res, null, params2, meta);
+      return res;
+    } catch (error2) {
+      setError(error2);
+      setStatus("error");
+      (_h = (_g = internalCallbackRef.current).onError) == null ? void 0 : _h.call(_g, error2, params2, meta);
+      (_j = (_i = internalCallbackRef.current).onSettled) == null ? void 0 : _j.call(_i, void 0, error2, params2, meta);
+      throw error2;
+    }
+  }), []);
   const mutate = useCallback(
     (variables, options2) => {
-      mutateAsync(variables, options2 == null ? void 0 : options2.overrideTargetMachine).then(
+      mutateAsync(variables, options2 == null ? void 0 : options2.meta).then(
         (data) => {
           var _a, _b;
-          (_a = options2 == null ? void 0 : options2.onSuccess) == null ? void 0 : _a.call(options2, data, variables);
-          (_b = options2 == null ? void 0 : options2.onSettled) == null ? void 0 : _b.call(options2, data, null, variables);
+          (_a = options2 == null ? void 0 : options2.onSuccess) == null ? void 0 : _a.call(options2, data, variables, options2 == null ? void 0 : options2.meta);
+          (_b = options2 == null ? void 0 : options2.onSettled) == null ? void 0 : _b.call(options2, data, null, variables, options2 == null ? void 0 : options2.meta);
         },
         (error2) => {
           var _a, _b;
-          (_a = options2 == null ? void 0 : options2.onError) == null ? void 0 : _a.call(options2, error2, variables);
-          (_b = options2 == null ? void 0 : options2.onSettled) == null ? void 0 : _b.call(options2, void 0, error2, variables);
+          (_a = options2 == null ? void 0 : options2.onError) == null ? void 0 : _a.call(options2, error2, variables, options2 == null ? void 0 : options2.meta);
+          (_b = options2 == null ? void 0 : options2.onSettled) == null ? void 0 : _b.call(options2, void 0, error2, variables, options2 == null ? void 0 : options2.meta);
         }
       );
     },
@@ -408,14 +406,11 @@ var useQuery = (_a) => {
       });
     }
     if (refetchInterval > 0) {
-      const interval = setInterval(
-        () => {
-          if (shouldRefetch()) {
-            refetch();
-          }
-        },
-        Math.max(refetchInterval, 1e3)
-      );
+      const interval = setInterval(() => {
+        if (shouldRefetch()) {
+          refetch();
+        }
+      }, refetchInterval);
       cleanups.push(() => {
         clearInterval(interval);
       });
@@ -449,16 +444,17 @@ var useCallMutationBase = (promiseFunc, functionName, service, options) => {
   const timeout = options == null ? void 0 : options.timeout;
   const rest = __objRest(useMemo(() => options != null ? options : {}, [options]), []);
   const mutationFn = useCallback3(
-    (parameters) => __async(null, null, function* () {
+    (parameters, meta) => __async(null, null, function* () {
       try {
         return yield promiseFunc({
-          service,
+          service: service(meta),
           functionName: functionName.toString(),
           parameters,
           options: {
             avoidTimeout: !timeout,
             customTimeout: timeout
-          }
+          },
+          meta
         });
       } catch (e) {
         if (e instanceof Error) {
@@ -475,24 +471,24 @@ var useCallMutationBase = (promiseFunc, functionName, service, options) => {
 };
 function buildMutationHook(promiseFunc, genTargetService) {
   return function useCallMutationBuilder(func, options) {
-    const targetService = genTargetService(options == null ? void 0 : options.machine);
-    return useCallMutationBase(promiseFunc, func, targetService, options);
+    return useCallMutationBase(promiseFunc, func, genTargetService, options);
   };
 }
 var useCallQueryBase = (promiseFunction, functionName, params, service, options) => {
   const timeout = options == null ? void 0 : options.timeout;
   const rest = __objRest(useMemo(() => options != null ? options : {}, [options]), []);
   const queryFn = useCallback3(
-    (refetchParams, overrideTargetMachine) => __async(null, null, function* () {
+    (refetchParams) => __async(null, null, function* () {
       try {
         return yield promiseFunction({
-          service: overrideTargetMachine != null ? overrideTargetMachine : service,
+          service: service(options == null ? void 0 : options.meta),
           functionName: functionName.toString(),
           parameters: refetchParams != null ? refetchParams : params,
           options: {
             avoidTimeout: !timeout,
             customTimeout: timeout
-          }
+          },
+          meta: options == null ? void 0 : options.meta
         });
       } catch (e) {
         if (e instanceof Error) {
@@ -509,8 +505,7 @@ var useCallQueryBase = (promiseFunction, functionName, params, service, options)
 };
 function buildQueryHook(promiseFunction, getTargetService) {
   return function useCallQueryBuilder(func, params, options) {
-    const targetService = getTargetService(options == null ? void 0 : options.machine);
-    return useCallQueryBase(promiseFunction, func, params, targetService, options);
+    return useCallQueryBase(promiseFunction, func, params, getTargetService, options);
   };
 }