feat(medusa): adds collection endpoints to storefront (#711)

Adds:
- `/store/collections/:id`
- `/store/collections`

packages/medusa/src/api/routes/admin/collections/__tests__/list-collections.js

@@ -22,7 +22,7 @@ describe("GET /admin/collections", () => {
     })
 
     it("calls product collection service list", () => {
-      expect(ProductCollectionServiceMock.list).toHaveBeenCalledTimes(1)
+      expect(ProductCollectionServiceMock.listAndCount).toHaveBeenCalledTimes(1)
     })
   })
 })

packages/medusa/src/api/routes/admin/collections/list-collections.js

@@ -18,30 +18,24 @@ import { defaultFields, defaultRelations } from "."
  *              $ref: "#/components/schemas/product_collection"
  */
 export default async (req, res) => {
-  try {
-    const selector = {}
+  const selector = {}
 
-    const limit = parseInt(req.query.limit) || 10
-    const offset = parseInt(req.query.offset) || 0
+  const limit = parseInt(req.query.limit) || 10
+  const offset = parseInt(req.query.offset) || 0
 
-    const productCollectionService = req.scope.resolve(
-      "productCollectionService"
-    )
+  const productCollectionService = req.scope.resolve("productCollectionService")
 
-    const listConfig = {
-      select: defaultFields,
-      relations: defaultRelations,
-      skip: offset,
-      take: limit,
-    }
-
-    const collections = await productCollectionService.list(
-      selector,
-      listConfig
-    )
-
-    res.status(200).json({ collections })
-  } catch (err) {
-    throw err
+  const listConfig = {
+    select: defaultFields,
+    relations: defaultRelations,
+    skip: offset,
+    take: limit,
   }
+
+  const [collections, count] = await productCollectionService.listAndCount(
+    selector,
+    listConfig
+  )
+
+  res.status(200).json({ collections, count })
 }

packages/medusa/src/api/routes/store/collections/__tests__/get-collection.js

@@ -0,0 +1,27 @@
+import { IdMap } from "medusa-test-utils"
+import { request } from "../../../../../helpers/test-request"
+import { ProductCollectionServiceMock } from "../../../../../services/__mocks__/product-collection"
+
+describe("GET /store/categories/:id", () => {
+  describe("get collection by id successfully", () => {
+    let subject
+    beforeAll(async () => {
+      subject = await request("GET", `/store/collections/${IdMap.getId("col")}`)
+    })
+
+    afterAll(() => {
+      jest.clearAllMocks()
+    })
+
+    it("calls retrieve from product collection service", () => {
+      expect(ProductCollectionServiceMock.retrieve).toHaveBeenCalledTimes(1)
+      expect(ProductCollectionServiceMock.retrieve).toHaveBeenCalledWith(
+        IdMap.getId("col")
+      )
+    })
+
+    it("returns variant decorated", () => {
+      expect(subject.body.collection.id).toEqual(IdMap.getId("col"))
+    })
+  })
+})

packages/medusa/src/api/routes/store/collections/__tests__/list-collections.js

@@ -0,0 +1,21 @@
+import { request } from "../../../../../helpers/test-request"
+import { ProductCollectionServiceMock } from "../../../../../services/__mocks__/product-collection"
+
+describe("GET /store/collections", () => {
+  describe("successful retrieval", () => {
+    let subject
+
+    beforeAll(async () => {
+      jest.clearAllMocks()
+      subject = await request("GET", `/store/collections`)
+    })
+
+    it("returns 200", () => {
+      expect(subject.status).toEqual(200)
+    })
+
+    it("calls product collection service list", () => {
+      expect(ProductCollectionServiceMock.listAndCount).toHaveBeenCalledTimes(1)
+    })
+  })
+})

packages/medusa/src/api/routes/store/collections/get-collection.js

@@ -0,0 +1,33 @@
+/**
+ * @oas [get] /collections/{id}
+ * operationId: "GetCollectionsCollection"
+ * summary: "Retrieve a Product Collection"
+ * description: "Retrieves a Product Collection."
+ * parameters:
+ *   - (path) id=* {string} The id of the Product Collection
+ * tags:
+ *   - Collection
+ * responses:
+ *  "200":
+ *    description: OK
+ *    content:
+ *      application/json:
+ *        schema:
+ *          properties:
+ *            collection:
+ *              $ref: "#/components/schemas/product_collection"
+ */
+
+export default async (req, res) => {
+  const { id } = req.params
+  try {
+    const productCollectionService = req.scope.resolve(
+      "productCollectionService"
+    )
+
+    const collection = await productCollectionService.retrieve(id)
+    res.status(200).json({ collection })
+  } catch (err) {
+    throw err
+  }
+}

packages/medusa/src/api/routes/store/collections/index.js

@@ -0,0 +1,16 @@
+import { Router } from "express"
+import middlewares from "../../../middlewares"
+
+const route = Router()
+
+export default (app) => {
+  app.use("/collections", route)
+
+  route.get("/", middlewares.wrap(require("./list-collections").default))
+  route.get("/:id", middlewares.wrap(require("./get-collection").default))
+
+  return app
+}
+
+export const defaultFields = ["id", "title", "handle"]
+export const defaultRelations = ["products"]

packages/medusa/src/api/routes/store/collections/list-collections.js

@@ -0,0 +1,37 @@
+/**
+ * @oas [get] /collections
+ * operationId: "GetCollections"
+ * summary: "List Product Collections"
+ * description: "Retrieve a list of Product Collection."
+ * tags:
+ *   - Collection
+ * responses:
+ *  "200":
+ *    description: OK
+ *    content:
+ *      application/json:
+ *        schema:
+ *          properties:
+ *            collection:
+ *              $ref: "#/components/schemas/product_collection"
+ */
+export default async (req, res) => {
+  const selector = {}
+
+  const limit = parseInt(req.query.limit) || 10
+  const offset = parseInt(req.query.offset) || 0
+
+  const productCollectionService = req.scope.resolve("productCollectionService")
+
+  const listConfig = {
+    skip: offset,
+    take: limit,
+  }
+
+  const [collections, count] = await productCollectionService.listAndCount(
+    selector,
+    listConfig
+  )
+
+  res.status(200).json({ collections, count })
+}

packages/medusa/src/api/routes/store/index.js

@@ -14,6 +14,7 @@ import returnRoutes from "./returns"
 import returnReasonRoutes from "./return-reasons"
 import swapRoutes from "./swaps"
 import variantRoutes from "./variants"
+import collectionRoutes from "./collections"
 import giftCardRoutes from "./gift-cards"
 
 const route = Router()
@@ -32,6 +33,7 @@ export default (app, container, config) => {
   route.use(middlewares.authenticateCustomer())
 
   authRoutes(route)
+  collectionRoutes(route)
   customerRoutes(route, container)
   productRoutes(route)
   orderRoutes(route)