createBranch + getBranchDetails to follow project conventions (#7403)

Author: bilalabbad

frontend/app/src/entities/branches/api/create-branch-from-api.ts

@@ -0,0 +1,37 @@
+import { gql } from "@apollo/client";
+
+import type {
+  Branch_CreateMutation,
+  Branch_CreateMutationVariables,
+} from "@/shared/api/graphql/generated/graphql";
+import graphqlClient from "@/shared/api/graphql/graphqlClientApollo";
+
+export const BRANCH_CREATE = gql`
+  mutation BRANCH_CREATE($name: String!, $description: String, $sync_with_git: Boolean) {
+    BranchCreate(data: { name: $name, description: $description, sync_with_git: $sync_with_git }) {
+      object {
+        id
+        name
+        description
+        origin_branch
+        branched_from
+        created_at
+        sync_with_git
+        is_default
+      }
+    }
+  }
+`;
+
+export interface CreateBranchFromApiParams {
+  name: string;
+  description?: string | null;
+  sync_with_git?: boolean;
+}
+
+export function createBranchFromApi(params: CreateBranchFromApiParams) {
+  return graphqlClient.mutate<Branch_CreateMutation, Branch_CreateMutationVariables>({
+    mutation: BRANCH_CREATE,
+    variables: params,
+  });
+}

frontend/app/src/entities/branches/api/createBranch.ts

@@ -0,0 +1,32 @@
+import { gql } from "@apollo/client";
+
+import type {
+  Get_Branch_DetailsQuery,
+  Get_Branch_DetailsQueryVariables,
+} from "@/shared/api/graphql/generated/graphql";
+import graphqlClient from "@/shared/api/graphql/graphqlClientApollo";
+import type { BranchContextParams } from "@/shared/api/types";
+
+export const getBranchDetailsQuery = gql`
+  query GET_BRANCH_DETAILS($branchName: String!) {
+    Branch(name: $branchName) {
+      id
+      name
+      description
+      origin_branch
+      branched_from
+      created_at
+      sync_with_git
+      is_default
+    }
+  }
+`;
+
+export interface GetBranchDetailsFromApiParams extends BranchContextParams {}
+
+export function getBranchDetailsFromApi({ branchName }: GetBranchDetailsFromApiParams) {
+  return graphqlClient.query<Get_Branch_DetailsQuery, Get_Branch_DetailsQueryVariables>({
+    query: getBranchDetailsQuery,
+    variables: { branchName },
+  });
+}

frontend/app/src/entities/branches/api/get-branch-details-from-api.ts

@@ -0,0 +1,4 @@
+export const branchesQueryKeys = {
+  all: ["branches"] as const,
+  details: ({ branchName }: { branchName: string }) => [...branchesQueryKeys.all, branchName],
+} as const;

frontend/app/src/entities/branches/api/getBranchDetails.ts

@@ -0,0 +1,19 @@
+import { useMutation } from "@tanstack/react-query";
+
+import { queryClient } from "@/shared/api/rest/client";
+
+import { createBranch } from "@/entities/branches/domain/create-branch";
+import { getBranchesQueryOptions } from "@/entities/branches/domain/get-branches.query";
+
+export function useCreateBranchMutation() {
+  return useMutation({
+    mutationFn: createBranch,
+    onSuccess: async (branchCreated) => {
+      if (!branchCreated) return;
+
+      const { queryKey } = getBranchesQueryOptions();
+      queryClient.setQueryData(queryKey, (oldBranches) => [...(oldBranches ?? []), branchCreated]);
+      queryClient.invalidateQueries({ queryKey });
+    },
+  });
+}

frontend/app/src/entities/branches/domain/branch.query-keys.ts

@@ -0,0 +1,19 @@
+import type { Branch } from "@/shared/api/graphql/generated/graphql";
+
+import {
+  type CreateBranchFromApiParams,
+  createBranchFromApi,
+} from "@/entities/branches/api/create-branch-from-api";
+
+export type CreateBranchParams = CreateBranchFromApiParams;
+export type CreateBranch = (params: CreateBranchParams) => Promise<Branch | null>;
+
+export const createBranch: CreateBranch = async (params) => {
+  const { data, errors } = await createBranchFromApi(params);
+
+  if (errors) {
+    throw new Error(errors.map((e) => e.message).join("; "));
+  }
+
+  return data?.BranchCreate?.object ?? null;
+};

frontend/app/src/entities/branches/domain/create-branch.mutation.ts

@@ -0,0 +1,18 @@
+import { queryOptions, useQuery } from "@tanstack/react-query";
+
+import { branchesQueryKeys } from "@/entities/branches/domain/branch.query-keys";
+import {
+  type GetBranchDetailsParams,
+  getBranchDetails,
+} from "@/entities/branches/domain/get-branch-details";
+
+export function getBranchDetailsQueryOptions(params: GetBranchDetailsParams) {
+  return queryOptions({
+    queryKey: branchesQueryKeys.details(params),
+    queryFn: () => getBranchDetails(params),
+  });
+}
+
+export function useGetBranchDetails(params: GetBranchDetailsParams) {
+  return useQuery(getBranchDetailsQueryOptions(params));
+}

frontend/app/src/entities/branches/domain/create-branch.ts

@@ -0,0 +1,24 @@
+import type { Branch } from "@/shared/api/graphql/generated/graphql";
+
+import {
+  type GetBranchDetailsFromApiParams,
+  getBranchDetailsFromApi,
+} from "@/entities/branches/api/get-branch-details-from-api";
+
+export type GetBranchDetailsParams = GetBranchDetailsFromApiParams;
+
+export type GetBranchDetails = (params: GetBranchDetailsParams) => Promise<Branch>;
+
+export const getBranchDetails: GetBranchDetails = async (params) => {
+  const { data, errors } = await getBranchDetailsFromApi(params);
+
+  if (errors) {
+    throw new Error(errors.map((e) => e.message).join("; "));
+  }
+
+  const branch = data?.Branch?.[0];
+
+  if (!branch) throw new Error(`Branch ${params.branchName} not found`);
+
+  return branch;
+};

frontend/app/src/entities/branches/domain/get-branch-details.query.ts

@@ -1,10 +1,12 @@
 import { queryOptions, useQuery } from "@tanstack/react-query";
 
+import { branchesQueryKeys } from "@/entities/branches/domain/branch.query-keys";
+
 import { getBranches } from "./get-branches";
 
 export function getBranchesQueryOptions() {
   return queryOptions({
-    queryKey: ["branches"],
+    queryKey: branchesQueryKeys.all,
     queryFn: getBranches,
   });
 }