Files
medusa-store/packages/medusa-js
Adrien de Peretti 2be00007b2 Feat(medusa, medusa-js, medusa-react): order edit confirmation (#2264)
**what**

Support confirm of an order edit:

Upon confirmation, the items of the original order are detached and the items from the order edit are attached to the order.
The order total is recomputed with the correct total which can defer from the paid_total and refundable_amount (based on the paid_total)


**Tests**

- Unit tests medusa-js and medusa-react as well as the core
- Integration test of the confirmation flow which check that the order edit is properly confirmed and can be confirmed idempotently. Also validate the totals and that the order items correspond to the order edit items. Also validate the order totals.

FIXES CORE-498
2022-09-29 08:00:48 +00:00
..
2022-09-14 11:36:53 +02:00
2022-09-14 11:36:53 +02:00

Medusa JS Client

Version

The Medusa JS Client provides easy access to the Medusa API from a client written in Typescript.

Documentation

You can learn more about this client and how to use it our documentation.

To learn more about the API endpoints that this client allows you to access check out our API reference.

Installation

Install the package with:

npm install @medusajs/medusa-js
# or
yarn add @medusajs/medusa-js

Usage

Import Medusa as a default import and initiate it:

import Medusa from "@medusajs/medusa-js"

const medusa = new Medusa()

const { cart } = await medusa.carts.create({})

Authentication

Authentication can be achieved in two ways using the medusa-js client, either by utilizing API keys or by using cookie based authentication, each with their own unique use case.

Using API keys

API keys can only be used for admin functionality in Medusa because only users of the admin system have api keys. To use API keys for authentication the key should be used when medusa-js is initialized with a config object as described below.

Using cookies

Authentication using cookies is done automatically by Axios when authenticating using the auth endpoints. After authentication all subsequent calls will be authenticated.

note: Cookie based authentication cannot be used in plain node.js applications due to the limitations of axios and useCredentials not setting the Cookie request header when set-cookie is present in the response headers. For pure node.js applications use authentication with api keys(see above)

Configuration

Initialize with config object

The package can be initialized with several options:

const medusa = new Medusa({
  maxRetries: 3,
  baseUrl: "https://api.example.com",
})
Option Default Description
maxRetries 0 The amount of times a request is retried.
baseUrl 'http://localhost:9000' The url to which requests are made to.
apiKey '' Optional api key used for authenticating admin requests .