api-ref: custom API reference (#4770)

* initialized next.js project

* finished markdown sections

* added operation schema component

* change page metadata

* eslint fixes

* fixes related to deployment

* added response schema

* resolve max stack issue

* support for different property types

* added support for property types

* added loading for components

* added more loading

* type fixes

* added oneOf type

* removed console

* fix replace with push

* refactored everything

* use static content for description

* fixes and improvements

* added code examples section

* fix path name

* optimizations

* fixed tag navigation

* add support for admin and store references

* general enhancements

* optimizations and fixes

* fixes and enhancements

* added search bar

* loading enhancements

* added loading

* added code blocks

* added margin top

* add empty response text

* fixed oneOf parameters

* added path and query parameters

* general fixes

* added base path env variable

* small fix for arrays

* enhancements

* design enhancements

* general enhancements

* fix isRequired

* added enum values

* enhancements

* general fixes

* general fixes

* changed oas generation script

* additions to the introduction section

* added copy button for code + other enhancements

* fix response code block

* fix metadata

* formatted store introduction

* move sidebar logic to Tags component

* added test env variables

* fix code block bug

* added loading animation

* added expand param + loading

* enhance operation loading

* made responsive + improvements

* added loading provider

* fixed loading

* adjustments for small devices

* added sidebar label for endpoints

* added feedback component

* fixed analytics

* general fixes

* listen to scroll for other headings

* added sample env file

* update api ref files + support new fields

* fix for external docs link

* added new sections

* fix last item in sidebar not showing

* move docs content to www/docs

* change redirect url

* revert change

* resolve build errors

* configure rewrites

* changed to environment variable url

* revert changing environment variable name

* add environment variable for API path

* fix links

* fix tailwind settings

* remove vercel file

* reconfigured api route

* move api page under api

* fix page metadata

* fix external link in navigation bar

* update api spec

* updated api specs

* fixed google lint error

* add max-height on request samples

* add padding before loading

* fix for one of name

* fix undefined types

* general fixes

* remove response schema example

* redesigned navigation bar

* redesigned sidebar

* fixed up paddings

* added feedback component + report issue

* fixed up typography, padding, and general styling

* redesigned code blocks

* optimization

* added error timeout

* fixes

* added indexing with algolia + fixes

* fix errors with algolia script

* redesign operation sections

* fix heading scroll

* design fixes

* fix padding

* fix padding + scroll issues

* fix scroll issues

* improve scroll performance

* fixes for safari

* optimization and fixes

* fixes to docs + details animation

* padding fixes for code block

* added tab animation

* fixed incorrect link

* added selection styling

* fix lint errors

* redesigned details component

* added detailed feedback form

* api reference fixes

* fix tabs

* upgrade + fixes

* updated documentation links

* optimizations to sidebar items

* fix spacing in sidebar item

* optimizations and fixes

* fix endpoint path styling

* remove margin

* final fixes

* change margin on small devices

* generated OAS

* fixes for mobile

* added feedback modal

* optimize dark mode button

* fixed color mode useeffect

* minimize dom size

* use new style system

* radius and spacing design system

* design fixes

* fix eslint errors

* added meta files

* change cron schedule

* fix docusaurus configurations

* added operating system to feedback data

* change content directory name

* fixes to contribution guidelines

* revert renaming content

* added api-reference to documentation workflow

* fixes for search

* added dark mode + fixes

* oas fixes

* handle bugs

* added code examples for clients

* changed tooltip text

* change authentication to card

* change page title based on selected section

* redesigned mobile navbar

* fix icon colors

* fix key colors

* fix medusa-js installation command

* change external regex in algolia

* change changeset

* fix padding on mobile

* fix hydration error

* update depedencies

www/api-reference/specs/store/code_samples/JavaScript/store_auth/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.auth.getSession()
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_auth/post.js

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.auth.authenticate({
+  email: "user@example.com",
+  password: "user@example.com"
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_auth_{email}/get.js

@@ -0,0 +1,3 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.auth.exists("user@example.com")

www/api-reference/specs/store/code_samples/JavaScript/store_carts/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.create()
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.retrieve(cartId)
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}/post.js

@@ -0,0 +1,8 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.update(cartId, {
+  email: "user@example.com"
+})
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_complete/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.complete(cartId)
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_discounts_{code}/delete.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.deleteDiscount(cartId, code)
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_line-items/post.js

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.lineItems.create(cart_id, {
+  variant_id,
+  quantity: 1
+})
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_line-items_{line_id}/delete.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.lineItems.delete(cartId, lineId)
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_line-items_{line_id}/post.js

@@ -0,0 +1,8 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.lineItems.update(cartId, lineId, {
+  quantity: 1
+})
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_payment-session/post.js

@@ -0,0 +1,8 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.setPaymentSession(cartId, {
+  provider_id: "manual"
+})
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_payment-sessions/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.createPaymentSessions(cartId)
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_payment-sessions_{provider_id}/delete.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.deletePaymentSession(cartId, "manual")
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_payment-sessions_{provider_id}/post.js

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.updatePaymentSession(cartId, "manual", {
+  data: {
+
+  }
+})
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_payment-sessions_{provider_id}_refresh/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.refreshPaymentSession(cartId, "manual")
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_carts_{id}_shipping-methods/post.js

@@ -0,0 +1,8 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.carts.addShippingMethod(cartId, {
+  option_id
+})
+.then(({ cart }) => {
+  console.log(cart.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_collections/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.collections.list()
+.then(({ collections, limit, offset, count }) => {
+  console.log(collections.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_collections_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.collections.retrieve(collectionId)
+.then(({ collection }) => {
+  console.log(collection.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers/post.js

@@ -0,0 +1,11 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.customers.create({
+  first_name: "Alec",
+  last_name: "Reynolds",
+  email: "user@example.com",
+  password: "supersecret"
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.retrieve()
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me/post.js

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.update({
+  first_name: "Laury"
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me_addresses/post.js

@@ -0,0 +1,19 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.addresses.addAddress({
+  address: {
+    first_name: "Celia",
+    last_name: "Schumm",
+    address_1: "225 Bednar Curve",
+    city: "Danielville",
+    country_code: "US",
+    postal_code: "85137",
+    phone: "981-596-6748 x90188",
+    company: "Wyman LLC",
+    province: "Georgia",
+  }
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me_addresses_{address_id}/delete.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.addresses.deleteAddress(addressId)
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me_addresses_{address_id}/post.js

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.addresses.updateAddress(addressId, {
+  first_name: "Gina"
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me_orders/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.listOrders()
+.then(({ orders, limit, offset, count }) => {
+  console.log(orders);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_me_payment-methods/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged
+medusa.customers.paymentMethods.list()
+.then(({ payment_methods }) => {
+  console.log(payment_methods.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_password-reset/post.js

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.customers.resetPassword({
+  email: "user@example.com",
+  password: "supersecret",
+  token: "supersecrettoken"
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_customers_password-token/post.js

@@ -0,0 +1,11 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.customers.generatePasswordToken({
+  email: "user@example.com"
+})
+.then(() => {
+  // successful
+})
+.catch(() => {
+  // failed
+})

www/api-reference/specs/store/code_samples/JavaScript/store_gift-cards_{code}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.giftCards.retrieve(code)
+.then(({ gift_card }) => {
+  console.log(gift_card.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_order-edits_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.orderEdits.retrieve(orderEditId)
+.then(({ order_edit }) => {
+  console.log(order_edit.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_order-edits_{id}_complete/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.orderEdits.complete(orderEditId)
+  .then(({ order_edit }) => {
+    console.log(order_edit.id)
+  })

www/api-reference/specs/store/code_samples/JavaScript/store_order-edits_{id}_decline/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.orderEdits.decline(orderEditId)
+  .then(({ order_edit }) => {
+    console.log(order_edit.id);
+  })

www/api-reference/specs/store/code_samples/JavaScript/store_orders/get.js

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.orders.lookupOrder({
+  display_id: 1,
+  email: "user@example.com"
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_orders_batch_customer_token/post.js

@@ -0,0 +1,12 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.orders.requestCustomerOrders({
+  order_ids,
+})
+.then(() => {
+  // successful
+})
+.catch(() => {
+  // an error occurred
+});

www/api-reference/specs/store/code_samples/JavaScript/store_orders_cart_{cart_id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.orders.retrieveByCartId(cartId)
+.then(({ order }) => {
+  console.log(order.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_orders_customer_confirm/post.js

@@ -0,0 +1,12 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.orders.confirmRequest(
+  token,
+)
+.then(() => {
+  // successful
+})
+.catch(() => {
+  // an error occurred
+});

www/api-reference/specs/store/code_samples/JavaScript/store_orders_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.orders.retrieve(orderId)
+.then(({ order }) => {
+  console.log(order.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_payment-collections_{id}/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.paymentCollections.retrieve(paymentCollectionId)
+  .then(({ payment_collection }) => {
+    console.log(payment_collection.id)
+  })

www/api-reference/specs/store/code_samples/JavaScript/store_payment-collections_{id}_sessions/post.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.paymentCollections.managePaymentSession(payment_id, { provider_id: "stripe" })
+.then(({ payment_collection }) => {
+  console.log(payment_collection.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_payment-collections_{id}_sessions_batch/post.js

@@ -0,0 +1,36 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+
+// Total amount = 10000
+
+// Example 1: Adding two new sessions
+medusa.paymentCollections.managePaymentSessionsBatch(paymentId, {
+  sessions: [
+    {
+      provider_id: "stripe",
+      amount: 5000,
+    },
+    {
+      provider_id: "manual",
+      amount: 5000,
+    },
+  ]
+})
+.then(({ payment_collection }) => {
+  console.log(payment_collection.id);
+});
+
+// Example 2: Updating one session and removing the other
+medusa.paymentCollections.managePaymentSessionsBatch(paymentId, {
+  sessions: [
+    {
+      provider_id: "stripe",
+      amount: 10000,
+      session_id: "ps_123456"
+    },
+  ]
+})
+.then(({ payment_collection }) => {
+  console.log(payment_collection.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_payment-collections_{id}_sessions_batch_authorize/post.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.paymentCollections.authorize(paymentId)
+.then(({ payment_collection }) => {
+  console.log(payment_collection.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_payment-collections_{id}_sessions_{session_id}/post.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.paymentCollections.refreshPaymentSession(paymentCollectionId, sessionId)
+.then(({ payment_session }) => {
+  console.log(payment_session.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_payment-collections_{id}_sessions_{session_id}_authorize/post.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.paymentCollections.authorize(paymentId, sessionId)
+.then(({ payment_collection }) => {
+  console.log(payment_collection.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_product-categories/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.productCategories.list()
+.then(({ product_categories, limit, offset, count }) => {
+  console.log(product_categories.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_product-categories_{id}/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.productCategories.retrieve(productCategoryId)
+  .then(({ product_category }) => {
+    console.log(product_category.id);
+  });

www/api-reference/specs/store/code_samples/JavaScript/store_product-tags/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.productTags.list()
+.then(({ product_tags }) => {
+  console.log(product_tags.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_product-types/get.js

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.productTypes.list()
+.then(({ product_types }) => {
+  console.log(product_types.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_products/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.products.list()
+.then(({ products, limit, offset, count }) => {
+  console.log(products.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_products_search/post.js

@@ -0,0 +1,8 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.products.search({
+  q: "Shirt"
+})
+.then(({ hits }) => {
+  console.log(hits.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_products_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.products.retrieve(productId)
+.then(({ product }) => {
+  console.log(product.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_regions/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.regions.list()
+.then(({ regions }) => {
+  console.log(regions.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_regions_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.regions.retrieve(regionId)
+.then(({ region }) => {
+  console.log(region.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_return-reasons/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.returnReasons.list()
+.then(({ return_reasons }) => {
+  console.log(return_reasons.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_return-reasons_{id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.returnReasons.retrieve(reasonId)
+.then(({ return_reason }) => {
+  console.log(return_reason.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_returns/post.js

@@ -0,0 +1,14 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.returns.create({
+  order_id,
+  items: [
+    {
+      item_id,
+      quantity: 1
+    }
+  ]
+})
+.then((data) => {
+  console.log(data.return.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_shipping-options/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.shippingOptions.list()
+.then(({ shipping_options }) => {
+  console.log(shipping_options.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_shipping-options_{cart_id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.shippingOptions.listCartOptions(cartId)
+.then(({ shipping_options }) => {
+  console.log(shipping_options.length);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_swaps/post.js

@@ -0,0 +1,20 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.swaps.create({
+  order_id,
+  return_items: [
+    {
+      item_id,
+      quantity: 1
+    }
+  ],
+  additional_items: [
+    {
+      variant_id,
+      quantity: 1
+    }
+  ]
+})
+.then(({ swap }) => {
+  console.log(swap.id);
+});

www/api-reference/specs/store/code_samples/JavaScript/store_swaps_{cart_id}/get.js

@@ -0,0 +1,6 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.swaps.retrieveByCartId(cartId)
+.then(({ swap }) => {
+  console.log(swap.id);
+});