feat: Categories retrieve + list API (#7009)

packages/types/src/dal/repository-service.ts

@@ -2,9 +2,9 @@ import { RepositoryTransformOptions } from "../common"
 import { Context } from "../shared-context"
 import {
   BaseFilterable,
-  FilterQuery as InternalFilterQuery,
   FilterQuery,
   FindOptions,
+  FilterQuery as InternalFilterQuery,
   UpsertWithReplaceConfig,
 } from "./index"
 

packages/types/src/http/index.ts

@@ -5,3 +5,4 @@ export * from "./pricing"
 export * from "./sales-channel"
 export * from "./stock-locations"
 export * from "./tax"
+export * from "./product-category"

packages/types/src/http/product-category/admin/index.ts

@@ -0,0 +1 @@
+export * from "./product-category"

packages/types/src/http/product-category/admin/product-category.ts

@@ -0,0 +1,34 @@
+import { PaginatedResponse } from "../../../common"
+
+/**
+ * @experimental
+ */
+interface ProductCategoryResponse {
+  id: string
+  name: string
+  description: string | null
+  handle: string | null
+  is_active: boolean
+  is_internal: boolean
+  rank: number | null
+  parent_category_id: string | null
+  created_at: string | Date
+  updated_at: string | Date
+
+  parent_category: ProductCategoryResponse
+  category_children: ProductCategoryResponse[]
+}
+
+/**
+ * @experimental
+ */
+export interface AdminProductCategoryResponse {
+  product_category: ProductCategoryResponse
+}
+
+/**
+ * @experimental
+ */
+export interface AdminProductCategoryListResponse extends PaginatedResponse {
+  product_categories: ProductCategoryResponse[]
+}

packages/types/src/http/product-category/index.ts

@@ -0,0 +1 @@
+export * from "./admin"

packages/types/src/product/common.ts

@@ -900,6 +900,10 @@ export interface FilterableProductCategoryProps
    * Whether to include parents of retrieved product categories.
    */
   include_ancestors_tree?: boolean
+  /**
+   * Filter product categories based on searchable fields
+   */
+  q?: string
 }
 
 /**