mtmsdk 0.0.50 → 0.0.52

package/src/supabase/use-sb-query/use-rpc-mutation.ts

@@ -1,83 +1,83 @@
-/**
- * Supabase RPC Mutation Hook
- * 简化 RPC 写操作（upsert, delete 等）的调用
- *
- * 使用示例:
- * ```tsx
- * const updateProject = useRpcMutation("audit_project_upsert");
- *
- * // 调用
- * await updateProject.mutateAsync({
- *   p_id: projectId,
- *   p_name: "New Name"
- * });
- * ```
- */
-
-import type { PostgrestError } from "@supabase/supabase-js";
-import { useMutation, type UseMutationOptions, type UseMutationResult } from "@tanstack/react-query";
-import { useSupabaseBrowser } from "../context";
-import type { RPCFunctionArgs, RPCFunctionName, RPCFunctionReturns } from "./use-rpc-query";
-
-/**
- * RPC Mutation 的返回类型
- */
-export interface RpcMutationResult<TData> {
-  data: TData | null;
-  error: PostgrestError | null;
-}
-
-/**
- * 基于 RPC 函数名进行 Mutation 操作的 Hook
- *
- * @template TFunc RPC 函数名类型
- * @template TData 返回数据类型
- * @param functionName RPC 函数名
- * @param options React Query Mutation 配置选项
- * @returns Mutation 结果
- *
- * @example
- * ```tsx
- * // 示例1: 基础使用
- * const updateProject = useRpcMutation("audit_project_upsert");
- *
- * // 在表单提交中使用
- * const handleSubmit = async (values) => {
- *   const { data, error } = await updateProject.mutateAsync({
- *     p_id: project.id,
- *     p_name: values.name,
- *     p_target: values.target
- *   });
- *
- *   if (error) {
- *     toast.error(error.message);
- *   } else {
- *     toast.success("Updated successfully");
- *   }
- * };
- *
- * // 示例2: 带类型推断
- * type ProjectResult = { id: string; name: string };
- * const updateProject = useRpcMutation<"audit_project_upsert", ProjectResult>("audit_project_upsert");
- * ```
- */
-export function useRpcMutation<
-  TFunc extends RPCFunctionName,
-  TData = RPCFunctionReturns<TFunc>,
-  TError = PostgrestError,
-  TContext = unknown,
->(
-  functionName: TFunc,
-  options?: Omit<UseMutationOptions<RpcMutationResult<TData>, TError, RPCFunctionArgs<TFunc>, TContext>, "mutationFn">,
-): UseMutationResult<RpcMutationResult<TData>, TError, RPCFunctionArgs<TFunc>, TContext> {
-  const sb = useSupabaseBrowser();
-
-  return useMutation<RpcMutationResult<TData>, TError, RPCFunctionArgs<TFunc>, TContext>({
-    mutationFn: async (args) => {
-      // biome-ignore lint/suspicious/noExplicitAny: 绕过 Supabase 内部类型系统
-      const result = await sb.rpc(functionName, args as any);
-      return result as RpcMutationResult<TData>;
-    },
-    ...options,
-  });
-}
+/**
+ * Supabase RPC Mutation Hook
+ * 简化 RPC 写操作（upsert, delete 等）的调用
+ *
+ * 使用示例:
+ * ```tsx
+ * const updateProject = useRpcMutation("audit_project_upsert");
+ *
+ * // 调用
+ * await updateProject.mutateAsync({
+ *   p_id: projectId,
+ *   p_name: "New Name"
+ * });
+ * ```
+ */
+
+import type { PostgrestError } from "@supabase/supabase-js";
+import { useMutation, type UseMutationOptions, type UseMutationResult } from "@tanstack/react-query";
+import { useSupabaseBrowser } from "../context";
+import type { RPCFunctionArgs, RPCFunctionName, RPCFunctionReturns } from "./use-rpc-query";
+
+/**
+ * RPC Mutation 的返回类型
+ */
+export interface RpcMutationResult<TData> {
+  data: TData | null;
+  error: PostgrestError | null;
+}
+
+/**
+ * 基于 RPC 函数名进行 Mutation 操作的 Hook
+ *
+ * @template TFunc RPC 函数名类型
+ * @template TData 返回数据类型
+ * @param functionName RPC 函数名
+ * @param options React Query Mutation 配置选项
+ * @returns Mutation 结果
+ *
+ * @example
+ * ```tsx
+ * // 示例1: 基础使用
+ * const updateProject = useRpcMutation("audit_project_upsert");
+ *
+ * // 在表单提交中使用
+ * const handleSubmit = async (values) => {
+ *   const { data, error } = await updateProject.mutateAsync({
+ *     p_id: project.id,
+ *     p_name: values.name,
+ *     p_target: values.target
+ *   });
+ *
+ *   if (error) {
+ *     toast.error(error.message);
+ *   } else {
+ *     toast.success("Updated successfully");
+ *   }
+ * };
+ *
+ * // 示例2: 带类型推断
+ * type ProjectResult = { id: string; name: string };
+ * const updateProject = useRpcMutation<"audit_project_upsert", ProjectResult>("audit_project_upsert");
+ * ```
+ */
+export function useRpcMutation<
+  TFunc extends RPCFunctionName,
+  TData = RPCFunctionReturns<TFunc>,
+  TError = PostgrestError,
+  TContext = unknown,
+>(
+  functionName: TFunc,
+  options?: Omit<UseMutationOptions<RpcMutationResult<TData>, TError, RPCFunctionArgs<TFunc>, TContext>, "mutationFn">,
+): UseMutationResult<RpcMutationResult<TData>, TError, RPCFunctionArgs<TFunc>, TContext> {
+  const sb = useSupabaseBrowser();
+
+  return useMutation<RpcMutationResult<TData>, TError, RPCFunctionArgs<TFunc>, TContext>({
+    mutationFn: async (args) => {
+      // biome-ignore lint/suspicious/noExplicitAny: 绕过 Supabase 内部类型系统
+      const result = await sb.rpc(functionName, args as any);
+      return result as RpcMutationResult<TData>;
+    },
+    ...options,
+  });
+}