feat: customer group customers client endpoints (#1221)

* feat: add `listCustomers` (by group) to `medusa-js`

* feat: add `useAdminCustomerGroupCustomers` hook

* fix: remove log

* fix: import/export

* fix: change query keys

* wip: sublist query keys

* fix: revert query factory changes

* fix: add query as a param when building the "detail" key

* fix: revert keys logic, use special case

* fix: query path, change batch keys

* change admin customer groups cache key generation

* spread query params

Co-authored-by: fPolic <frane@medusajs.com>

packages/medusa-react/src/hooks/admin/customer-groups/mutations.ts

@@ -112,7 +112,10 @@ export const useAdminAddCustomersToCustomerGroup = (
       client.admin.customerGroups.addCustomers(id, payload),
     buildOptions(
       queryClient,
-      [adminCustomerGroupKeys.lists(), adminCustomerGroupKeys.detail(id)],
+      [
+        adminCustomerGroupKeys.lists(),
+        adminCustomerGroupKeys.detailCustomer(id),
+      ],
       options
     )
   )
@@ -140,7 +143,10 @@ export const useAdminRemoveCustomersFromCustomerGroup = (
       client.admin.customerGroups.removeCustomers(id, payload),
     buildOptions(
       queryClient,
-      [adminCustomerGroupKeys.lists(), adminCustomerGroupKeys.detail(id)],
+      [
+        adminCustomerGroupKeys.lists(),
+        adminCustomerGroupKeys.detailCustomer(id),
+      ],
       options
     )
   )

packages/medusa-react/src/hooks/admin/customer-groups/queries.ts

@@ -1,8 +1,10 @@
 import {
   AdminCustomerGroupsListRes,
   AdminCustomerGroupsRes,
+  AdminCustomersListRes,
   AdminGetCustomerGroupsGroupParams,
   AdminGetCustomerGroupsParams,
+  AdminGetCustomersParams,
 } from "@medusajs/medusa"
 import { Response } from "@medusajs/medusa-js"
 import { useQuery } from "react-query"
@@ -13,9 +15,12 @@ import { queryKeysFactory } from "../../utils"
 
 const ADMIN_CUSTOMER_GROUPS_QUERY_KEY = `admin_customer_groups` as const
 
-export const adminCustomerGroupKeys = queryKeysFactory(
-  ADMIN_CUSTOMER_GROUPS_QUERY_KEY
-)
+export const adminCustomerGroupKeys = {
+  ...queryKeysFactory(ADMIN_CUSTOMER_GROUPS_QUERY_KEY),
+  detailCustomer(id: string, query?: AdminGetCustomersParams) {
+    return [...this.detail(id), "customers", { ...(query || {}) }]
+  },
+}
 
 type CustomerGroupQueryKeys = typeof adminCustomerGroupKeys
 
@@ -66,3 +71,28 @@ export const useAdminCustomerGroups = (
   )
   return { ...data, ...rest } as const
 }
+
+/**
+ * Hook retrieves a list of customers that belong to provided groups.
+ *
+ * @param id - customer group id
+ * @param query - pagination/filtering params
+ * @param options
+ */
+export const useAdminCustomerGroupCustomers = (
+  id: string,
+  query?: AdminGetCustomersParams,
+  options?: UseQueryOptionsWrapper<
+    Response<AdminCustomersListRes>,
+    Error,
+    ReturnType<CustomerGroupQueryKeys["detailCustomer"]>
+  >
+) => {
+  const { client } = useMedusa()
+  const { data, ...rest } = useQuery(
+    adminCustomerGroupKeys.detailCustomer(id, query),
+    () => client.admin.customerGroups.listCustomers(id, query),
+    options
+  )
+  return { ...data, ...rest } as const
+}

packages/medusa-react/src/hooks/admin/customers/mutations.ts

@@ -1,9 +1,11 @@
-import { adminCustomerKeys } from "./queries"
+import { useMutation, UseMutationOptions, useQueryClient } from "react-query"
+
 import { AdminCustomersRes, AdminPostCustomersReq } from "@medusajs/medusa"
 import { Response } from "@medusajs/medusa-js"
-import { useMutation, UseMutationOptions, useQueryClient } from "react-query"
-import { useMedusa } from "../../../contexts/medusa"
+
+import { useMedusa } from "../../../contexts"
 import { buildOptions } from "../../utils/buildOptions"
+import { adminCustomerKeys } from "./queries"
 
 export const useAdminCreateCustomer = (
   options?: UseMutationOptions<

packages/medusa-react/src/hooks/admin/customers/queries.ts

@@ -7,7 +7,7 @@ import { Response } from "@medusajs/medusa-js"
 import { useQuery } from "react-query"
 import { useMedusa } from "../../../contexts"
 import { UseQueryOptionsWrapper } from "../../../types"
-import { queryKeysFactory } from "../../utils/index"
+import { queryKeysFactory } from "../../utils"
 
 const ADMIN_CUSTOMERS_QUERY_KEY = `admin_customers` as const