@commercelayer/sdk 5.0.0-alpha.2 → 5.0.0-alpha.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -33
- package/lib/api.d.ts +1 -103
- package/lib/client.d.ts +1 -31
- package/lib/client.js +1 -1
- package/lib/commercelayer.d.ts +1 -122
- package/lib/commercelayer.js +1 -1
- package/lib/common.d.ts +1 -4
- package/lib/config.d.ts +1 -11
- package/lib/debug.d.ts +1 -3
- package/lib/debug.js +1 -1
- package/lib/error.d.ts +1 -26
- package/lib/error.js +1 -1
- package/lib/index.d.ts +1 -7
- package/lib/interceptor.d.ts +1 -19
- package/lib/jsonapi.d.ts +1 -5
- package/lib/jsonapi.js +1 -1
- package/lib/model.d.ts +1 -101
- package/lib/query.d.ts +1 -23
- package/lib/query.js +1 -1
- package/lib/resource.d.ts +1 -76
- package/lib/resource.js +1 -1
- package/lib/resources/addresses.d.ts +1 -88
- package/lib/resources/addresses.js +1 -1
- package/lib/resources/adjustments.d.ts +1 -35
- package/lib/resources/adjustments.js +1 -1
- package/lib/resources/adyen_gateways.d.ts +1 -47
- package/lib/resources/adyen_gateways.js +1 -1
- package/lib/resources/adyen_payments.d.ts +1 -44
- package/lib/resources/adyen_payments.js +1 -1
- package/lib/resources/application.d.ts +1 -21
- package/lib/resources/application.js +1 -1
- package/lib/resources/attachments.d.ts +1 -156
- package/lib/resources/attachments.js +1 -1
- package/lib/resources/authorizations.d.ts +1 -57
- package/lib/resources/authorizations.js +1 -1
- package/lib/resources/avalara_accounts.d.ts +1 -52
- package/lib/resources/avalara_accounts.js +1 -1
- package/lib/resources/billing_info_validation_rules.d.ts +1 -32
- package/lib/resources/billing_info_validation_rules.js +1 -1
- package/lib/resources/bing_geocoders.d.ts +1 -35
- package/lib/resources/bing_geocoders.js +1 -1
- package/lib/resources/braintree_gateways.d.ts +1 -56
- package/lib/resources/braintree_gateways.js +1 -1
- package/lib/resources/braintree_payments.d.ts +1 -47
- package/lib/resources/braintree_payments.js +1 -1
- package/lib/resources/bundles.d.ts +1 -74
- package/lib/resources/bundles.js +1 -1
- package/lib/resources/captures.d.ts +1 -48
- package/lib/resources/captures.js +1 -1
- package/lib/resources/carrier_accounts.d.ts +1 -26
- package/lib/resources/carrier_accounts.js +1 -1
- package/lib/resources/checkout_com_gateways.d.ts +1 -45
- package/lib/resources/checkout_com_gateways.js +1 -1
- package/lib/resources/checkout_com_payments.d.ts +1 -50
- package/lib/resources/checkout_com_payments.js +1 -1
- package/lib/resources/coupon_codes_promotion_rules.d.ts +1 -59
- package/lib/resources/coupon_codes_promotion_rules.js +1 -1
- package/lib/resources/coupon_recipients.d.ts +1 -44
- package/lib/resources/coupon_recipients.js +1 -1
- package/lib/resources/coupons.d.ts +1 -45
- package/lib/resources/coupons.js +1 -1
- package/lib/resources/customer_addresses.d.ts +1 -41
- package/lib/resources/customer_addresses.js +1 -1
- package/lib/resources/customer_groups.d.ts +1 -36
- package/lib/resources/customer_groups.js +1 -1
- package/lib/resources/customer_password_resets.d.ts +1 -33
- package/lib/resources/customer_password_resets.js +1 -1
- package/lib/resources/customer_payment_sources.d.ts +1 -70
- package/lib/resources/customer_payment_sources.js +1 -1
- package/lib/resources/customer_subscriptions.d.ts +1 -28
- package/lib/resources/customer_subscriptions.js +1 -1
- package/lib/resources/customers.d.ts +1 -60
- package/lib/resources/customers.js +1 -1
- package/lib/resources/delivery_lead_times.d.ts +1 -51
- package/lib/resources/delivery_lead_times.js +1 -1
- package/lib/resources/event_callbacks.d.ts +1 -24
- package/lib/resources/event_callbacks.js +1 -1
- package/lib/resources/external_gateways.d.ts +1 -49
- package/lib/resources/external_gateways.js +1 -1
- package/lib/resources/external_payments.d.ts +1 -43
- package/lib/resources/external_payments.js +1 -1
- package/lib/resources/external_promotions.d.ts +1 -86
- package/lib/resources/external_promotions.js +1 -1
- package/lib/resources/external_tax_calculators.d.ts +1 -44
- package/lib/resources/external_tax_calculators.js +1 -1
- package/lib/resources/fixed_amount_promotions.d.ts +1 -88
- package/lib/resources/fixed_amount_promotions.js +1 -1
- package/lib/resources/fixed_price_promotions.d.ts +1 -99
- package/lib/resources/fixed_price_promotions.js +1 -1
- package/lib/resources/free_gift_promotions.d.ts +1 -97
- package/lib/resources/free_gift_promotions.js +1 -1
- package/lib/resources/free_shipping_promotions.d.ts +1 -83
- package/lib/resources/free_shipping_promotions.js +1 -1
- package/lib/resources/geocoders.d.ts +1 -24
- package/lib/resources/geocoders.js +1 -1
- package/lib/resources/gift_card_recipients.d.ts +1 -44
- package/lib/resources/gift_card_recipients.js +1 -1
- package/lib/resources/gift_cards.d.ts +1 -82
- package/lib/resources/gift_cards.js +1 -1
- package/lib/resources/google_geocoders.d.ts +1 -35
- package/lib/resources/google_geocoders.js +1 -1
- package/lib/resources/imports.d.ts +1 -40
- package/lib/resources/imports.js +1 -1
- package/lib/resources/in_stock_subscriptions.d.ts +1 -59
- package/lib/resources/in_stock_subscriptions.js +1 -1
- package/lib/resources/inventory_models.d.ts +1 -42
- package/lib/resources/inventory_models.js +1 -1
- package/lib/resources/inventory_return_locations.d.ts +1 -43
- package/lib/resources/inventory_return_locations.js +1 -1
- package/lib/resources/inventory_stock_locations.d.ts +1 -46
- package/lib/resources/inventory_stock_locations.js +1 -1
- package/lib/resources/klarna_gateways.d.ts +1 -44
- package/lib/resources/klarna_gateways.js +1 -1
- package/lib/resources/klarna_payments.d.ts +1 -41
- package/lib/resources/klarna_payments.js +1 -1
- package/lib/resources/line_item_options.d.ts +1 -57
- package/lib/resources/line_item_options.js +1 -1
- package/lib/resources/line_items.d.ts +1 -125
- package/lib/resources/line_items.js +1 -1
- package/lib/resources/manual_gateways.d.ts +1 -33
- package/lib/resources/manual_gateways.js +1 -1
- package/lib/resources/manual_tax_calculators.d.ts +1 -49
- package/lib/resources/manual_tax_calculators.js +1 -1
- package/lib/resources/markets.d.ts +1 -81
- package/lib/resources/markets.js +1 -1
- package/lib/resources/merchants.d.ts +1 -38
- package/lib/resources/merchants.js +1 -1
- package/lib/resources/order_amount_promotion_rules.d.ts +1 -56
- package/lib/resources/order_amount_promotion_rules.js +1 -1
- package/lib/resources/order_copies.d.ts +1 -45
- package/lib/resources/order_copies.js +1 -1
- package/lib/resources/order_subscriptions.d.ts +1 -67
- package/lib/resources/order_subscriptions.js +1 -1
- package/lib/resources/order_validation_rules.d.ts +1 -20
- package/lib/resources/order_validation_rules.js +1 -1
- package/lib/resources/orders.d.ts +1 -271
- package/lib/resources/orders.js +1 -1
- package/lib/resources/organization.d.ts +1 -32
- package/lib/resources/organization.js +1 -1
- package/lib/resources/packages.d.ts +1 -56
- package/lib/resources/packages.js +1 -1
- package/lib/resources/parcel_line_items.d.ts +1 -49
- package/lib/resources/parcel_line_items.js +1 -1
- package/lib/resources/parcels.d.ts +1 -108
- package/lib/resources/parcels.js +1 -1
- package/lib/resources/payment_gateways.d.ts +1 -21
- package/lib/resources/payment_gateways.js +1 -1
- package/lib/resources/payment_methods.d.ts +1 -59
- package/lib/resources/payment_methods.js +1 -1
- package/lib/resources/paypal_gateways.d.ts +1 -39
- package/lib/resources/paypal_gateways.js +1 -1
- package/lib/resources/paypal_payments.d.ts +1 -47
- package/lib/resources/paypal_payments.js +1 -1
- package/lib/resources/percentage_discount_promotions.d.ts +1 -97
- package/lib/resources/percentage_discount_promotions.js +1 -1
- package/lib/resources/price_lists.d.ts +1 -39
- package/lib/resources/price_lists.js +1 -1
- package/lib/resources/prices.d.ts +1 -57
- package/lib/resources/prices.js +1 -1
- package/lib/resources/promotion_rules.d.ts +1 -24
- package/lib/resources/promotion_rules.js +1 -1
- package/lib/resources/promotions.d.ts +1 -41
- package/lib/resources/promotions.js +1 -1
- package/lib/resources/refunds.d.ts +1 -34
- package/lib/resources/refunds.js +1 -1
- package/lib/resources/return_line_items.d.ts +1 -49
- package/lib/resources/return_line_items.js +1 -1
- package/lib/resources/returns.d.ts +1 -72
- package/lib/resources/returns.js +1 -1
- package/lib/resources/shipments.d.ts +1 -89
- package/lib/resources/shipments.js +1 -1
- package/lib/resources/shipping_categories.d.ts +1 -33
- package/lib/resources/shipping_categories.js +1 -1
- package/lib/resources/shipping_methods.d.ts +1 -74
- package/lib/resources/shipping_methods.js +1 -1
- package/lib/resources/shipping_zones.d.ts +1 -48
- package/lib/resources/shipping_zones.js +1 -1
- package/lib/resources/sku_list_items.d.ts +1 -47
- package/lib/resources/sku_list_items.js +1 -1
- package/lib/resources/sku_list_promotion_rules.d.ts +1 -68
- package/lib/resources/sku_list_promotion_rules.js +1 -1
- package/lib/resources/sku_lists.d.ts +1 -49
- package/lib/resources/sku_lists.js +1 -1
- package/lib/resources/sku_options.d.ts +1 -56
- package/lib/resources/sku_options.js +1 -1
- package/lib/resources/skus.d.ts +1 -78
- package/lib/resources/skus.js +1 -1
- package/lib/resources/stock_items.d.ts +1 -49
- package/lib/resources/stock_items.js +1 -1
- package/lib/resources/stock_line_items.d.ts +1 -29
- package/lib/resources/stock_line_items.js +1 -1
- package/lib/resources/stock_locations.d.ts +1 -57
- package/lib/resources/stock_locations.js +1 -1
- package/lib/resources/stock_transfers.d.ts +1 -71
- package/lib/resources/stock_transfers.js +1 -1
- package/lib/resources/stripe_gateways.d.ts +1 -38
- package/lib/resources/stripe_gateways.js +1 -1
- package/lib/resources/stripe_payments.d.ts +1 -42
- package/lib/resources/stripe_payments.js +1 -1
- package/lib/resources/tax_calculators.d.ts +1 -27
- package/lib/resources/tax_calculators.js +1 -1
- package/lib/resources/tax_categories.d.ts +1 -59
- package/lib/resources/tax_categories.js +1 -1
- package/lib/resources/tax_rules.d.ts +1 -69
- package/lib/resources/tax_rules.js +1 -1
- package/lib/resources/taxjar_accounts.d.ts +1 -43
- package/lib/resources/taxjar_accounts.js +1 -1
- package/lib/resources/transactions.d.ts +1 -31
- package/lib/resources/transactions.js +1 -1
- package/lib/resources/voids.d.ts +1 -34
- package/lib/resources/voids.js +1 -1
- package/lib/resources/webhooks.d.ts +1 -42
- package/lib/resources/webhooks.js +1 -1
- package/lib/resources/wire_transfers.d.ts +1 -32
- package/lib/resources/wire_transfers.js +1 -1
- package/lib/static.d.ts +1 -6
- package/lib/static.js +1 -1
- package/lib/util.d.ts +1 -2
- package/package.json +25 -28
package/README.md
CHANGED
@@ -1,8 +1,13 @@
|
|
1
1
|
# Commerce Layer JS SDK
|
2
2
|
|
3
|
+
[](https://npmjs.org/package/@commercelayer/sdk)
|
4
|
+
[](https://npmjs.org/package/@commercelayer/sdk)
|
5
|
+
[](https://github.com/commercelayer/commercelayer-sdk/blob/master/package.json)
|
3
6
|
[](https://github.com/semantic-release/semantic-release)
|
7
|
+
[](https://github.com/commercelayer/commercelayer-sdk/actions/workflows/semantic-release.yml)
|
8
|
+
[](https://github.com/commercelayer/commercelayer-cli/actions/workflows/codeql-analysis.yml)
|
4
9
|
|
5
|
-
A JavaScript Library wrapper that makes it quick and easy to interact with the [Commerce Layer API](https://docs.commercelayer.io/
|
10
|
+
A JavaScript Library wrapper that makes it quick and easy to interact with the [Commerce Layer API](https://docs.commercelayer.io/developers/).
|
6
11
|
|
7
12
|
### What is Commerce Layer?
|
8
13
|
|
@@ -20,7 +25,7 @@ To get started with Commerce Layer JS SDK you need to install it and then get th
|
|
20
25
|
|
21
26
|
Commerce Layer JS SDK is available as an [npm package](https://www.npmjs.com/package/@commercelayer/sdk):
|
22
27
|
|
23
|
-
```
|
28
|
+
```shell
|
24
29
|
// npm
|
25
30
|
npm install @commercelayer/sdk
|
26
31
|
|
@@ -30,7 +35,9 @@ yarn add @commercelayer/sdk
|
|
30
35
|
|
31
36
|
## Authentication
|
32
37
|
|
33
|
-
All requests to Commerce Layer API must be authenticated with an [OAuth2](https://oauth.net/2/) bearer token.
|
38
|
+
All requests to Commerce Layer API must be authenticated with an [OAuth2](https://oauth.net/2/) bearer token.
|
39
|
+
Hence, before starting to use this SDK you need to get a valid access token.
|
40
|
+
Check [our documentation](https://docs.commercelayer.io/developers/authentication) for more information about the available authorization flows.
|
34
41
|
|
35
42
|
> Feel free to use [Commerce Layer JS Auth](https://github.com/commercelayer/commercelayer-js-auth), a JavaScript library that helps you wrap our authentication API.
|
36
43
|
|
@@ -38,7 +45,7 @@ All requests to Commerce Layer API must be authenticated with an [OAuth2](https:
|
|
38
45
|
|
39
46
|
You can use the ES6 default import with the SDK as follow:
|
40
47
|
|
41
|
-
```
|
48
|
+
```typescript
|
42
49
|
import CommerceLayer from '@commercelayer/sdk'
|
43
50
|
|
44
51
|
const cl = CommerceLayer({
|
@@ -47,49 +54,59 @@ const cl = CommerceLayer({
|
|
47
54
|
})
|
48
55
|
```
|
49
56
|
|
50
|
-
> In the following examples, we will use only the the specific resources we're going to access (SKUs and shipping categories).
|
57
|
+
> In the following examples, we will use only the the specific resources we're going to access (SKUs and shipping categories).
|
58
|
+
Check our [API reference](https://docs.commercelayer.io/developers/v/api-reference/) for the complete list of available
|
59
|
+
resources and their attributes.
|
51
60
|
|
52
61
|
# Usage
|
53
62
|
|
54
63
|
The code snippets below show how to use the Commerce Layer JS SDK when performing the standard CRUD operations provided by our REST API on the SKU resource.
|
55
64
|
|
56
65
|
- ### Create
|
66
|
+
|
57
67
|
- [How to create an SKU](#how-to-create-an-sku)
|
58
|
-
|
68
|
+
|
69
|
+
- ### Retrieve / List
|
70
|
+
|
59
71
|
- [How to fetch a single SKU](#how-to-fetch-a-single-sku)
|
60
72
|
- [How to fetch a collection of SKUs](#how-to-fetch-a-collection-of-skus)
|
61
73
|
- [How to paginate a collection of SKUs](#how-to-paginate-a-collection-of-skus)
|
62
74
|
- [How to iterate through a collection of SKUs](#how-to-iterate-through-a-collection-of-skus)
|
63
|
-
- [How to build complex queries](#how-to-build-complex-queries)
|
75
|
+
<!-- - [How to build complex queries](#how-to-build-complex-queries) -->
|
76
|
+
- [How to fetch resource relationships](#how-to-fetch-resource-relationships)
|
77
|
+
|
64
78
|
- ### Update
|
79
|
+
|
65
80
|
- [How to update an existing SKU](#how-to-update-an-existing-sku)
|
81
|
+
|
66
82
|
- ### Delete
|
83
|
+
|
67
84
|
- [How to delete an existing SKU](#how-to-delete-an-existing-sku)
|
68
85
|
|
69
86
|
## Create
|
70
87
|
|
71
88
|
### How to create an SKU
|
72
89
|
|
73
|
-
```
|
90
|
+
```typescript
|
74
91
|
// selects the shipping category (it's a required relationship for the SKU resource)
|
75
92
|
const shippingCategories = await cl.shipping_categories.list({ filters: { name_eq: 'Merchandising' } })
|
76
93
|
|
77
94
|
const attributes = {
|
78
|
-
|
79
|
-
|
80
|
-
|
95
|
+
code: 'TSHIRTMM000000FFFFFFXL',
|
96
|
+
name: 'Black Men T-shirt with White Logo (XL)',
|
97
|
+
shipping_category: cl.shipping_categories.relationship(shippingCategories[0].id), // assigns the relationship
|
81
98
|
}
|
82
99
|
|
83
100
|
const newSku = await cl.skus.create(attributes)
|
84
101
|
```
|
85
102
|
|
86
|
-
Check our API reference for more information on how to [create an SKU](https://docs.commercelayer.io/api/
|
103
|
+
Check our API reference for more information on how to [create an SKU](https://docs.commercelayer.io/developers/v/api-reference/skus/create).
|
87
104
|
|
88
|
-
## Retrieve
|
105
|
+
## Retrieve / List
|
89
106
|
|
90
107
|
### How to fetch a single SKU
|
91
108
|
|
92
|
-
```
|
109
|
+
```typescript
|
93
110
|
// Fetches the SKU by ID
|
94
111
|
const sku = await cl.skus.retrieve('BxAkSVqKEn')
|
95
112
|
|
@@ -103,11 +120,11 @@ Check our API reference for more information on how to [create an SKU](https://d
|
|
103
120
|
const sku = (await cl.skus.list()).last()
|
104
121
|
```
|
105
122
|
|
106
|
-
Check our API reference for more information on how to [retrieve an SKU](https://docs.commercelayer.io/api/
|
123
|
+
Check our API reference for more information on how to [retrieve an SKU](https://docs.commercelayer.io/developers/v/api-reference/skus/retrieve).
|
107
124
|
|
108
125
|
### How to fetch a collection of SKUs
|
109
126
|
|
110
|
-
```
|
127
|
+
```typescript
|
111
128
|
// LISTING RESULTS
|
112
129
|
|
113
130
|
// Fetches all the SKUs
|
@@ -146,29 +163,32 @@ Check our API reference for more information on how to [retrieve an SKU](https:/
|
|
146
163
|
const skus = await cl.skus.list({ filters: { name_cont: 'White Logo' } })
|
147
164
|
|
148
165
|
// Filters all the SKUs fetching only the ones created between two specific dates
|
149
|
-
|
166
|
+
// (filters combined according to an AND logic)
|
167
|
+
const skus = await cl.skus.list({ filters: { created_at_gt: '2018-01-01', created_at_lt: '2018-01-31'} })
|
150
168
|
|
151
169
|
// Filters all the SKUs fetching only the ones created or updated after a specific date
|
152
|
-
|
170
|
+
// (attributes combined according to an OR logic)
|
171
|
+
const skus = await cl.skus.list({ filters: { updated_at_or_created_at_gt: '2019-10-10' } })
|
153
172
|
|
154
|
-
// Filters all the SKUs fetching only the ones whose name contains the string "Black" and whose shipping category
|
173
|
+
// Filters all the SKUs fetching only the ones whose name contains the string "Black" and whose shipping category
|
174
|
+
// name starts with the string "MERCH"
|
155
175
|
const skus = await cl.skus.list({ filters: { name_cont: 'Black', shipping_category_name_start: 'MERCH'} })
|
156
176
|
```
|
157
177
|
|
158
178
|
When fetching a collection of resources you can leverage the `meta` attribute to get its `meta` information:
|
159
179
|
|
160
|
-
```
|
180
|
+
```typescript
|
161
181
|
const skus = await cl.skus.list()
|
162
182
|
const meta = skus.meta
|
163
183
|
```
|
164
184
|
|
165
|
-
Check our API reference for more information on how to [list all SKUs](https://docs.commercelayer.io/api/
|
185
|
+
Check our API reference for more information on how to [list all SKUs](https://docs.commercelayer.io/developers/v/api-reference/skus/list), [sort the results](https://docs.commercelayer.io/developers/sorting-results), use [sparse fieldsets](https://docs.commercelayer.io/developers/sparse-fieldsets), [include associations](https://docs.commercelayer.io/developers/including-associations), and [filter data](https://docs.commercelayer.io/developers/filtering-data).
|
166
186
|
|
167
187
|
### How to paginate a collection of SKUs
|
168
188
|
|
169
189
|
When you fetch a collection of resources, you get paginated results:
|
170
190
|
|
171
|
-
```
|
191
|
+
```typescript
|
172
192
|
// Fetches the SKUs, setting the page number to 3 and the page size to 5
|
173
193
|
const skus = await cl.skus.list({ pageNumber: 3, pageSize: 5 })
|
174
194
|
|
@@ -181,23 +201,36 @@ When you fetch a collection of resources, you get paginated results:
|
|
181
201
|
|
182
202
|
> The default page number is **1**. The default page size is **10**. The maximum page size allowed is **25**.
|
183
203
|
|
184
|
-
Check our API reference for more information on how [pagination](https://docs.commercelayer.io/
|
204
|
+
Check our API reference for more information on how [pagination](https://docs.commercelayer.io/developers/pagination) works.
|
185
205
|
|
186
206
|
### How to iterate through a collection of SKUs
|
187
207
|
|
188
208
|
To execute a function for every item of a collection, use the `map()` method:
|
189
209
|
|
190
|
-
```
|
191
|
-
// Fetches the whole list of SKUs and prints their names and codes to console
|
210
|
+
```typescript
|
211
|
+
// Fetches the whole list of SKUs (1st page) and prints their names and codes to console
|
192
212
|
const skus = await cl.skus.list()
|
193
213
|
skus.map(p => console.log('Product: ' + p.name + ' - Code: ' + p.code))
|
194
214
|
```
|
195
215
|
|
216
|
+
### How to fetch resource relationships
|
217
|
+
|
218
|
+
Many resources have relationships with other resources and instead of including these associations as seen above, you can fetch them directly.
|
219
|
+
In this way, in case of 1-to-N relationship, you can filter or sort the resulting collection as for standard resources.
|
220
|
+
|
221
|
+
```typescript
|
222
|
+
// Fetches 1-to-1 related resource: billing address of an order
|
223
|
+
const billingAddress = cl.orders.billing_address('xYZkjABcde')
|
224
|
+
|
225
|
+
// Fetches 1-to-N related resources: orders associated to a customer
|
226
|
+
const orders = cl.customers.orders('XyzKjAbCDe', { fields: ['status', 'number'] })
|
227
|
+
```
|
228
|
+
|
196
229
|
## Update
|
197
230
|
|
198
231
|
### How to update an existing SKU
|
199
232
|
|
200
|
-
```
|
233
|
+
```typescript
|
201
234
|
const sku = {
|
202
235
|
id: 'xYZkjABcde',
|
203
236
|
description: 'Updated description.',
|
@@ -207,23 +240,24 @@ To execute a function for every item of a collection, use the `map()` method:
|
|
207
240
|
cl.skus.update(sku) // updates the SKU on the server
|
208
241
|
```
|
209
242
|
|
210
|
-
Check our API reference for more information on how to [update an SKU](https://docs.commercelayer.io/api/
|
243
|
+
Check our API reference for more information on how to [update an SKU](https://docs.commercelayer.io/developers/v/api-reference/skus/update).
|
211
244
|
|
212
245
|
## Delete
|
213
246
|
|
214
247
|
### How to delete an existing SKU
|
215
248
|
|
216
|
-
```
|
249
|
+
```typescript
|
217
250
|
cl.skus.delete('xYZkjABcde') // persisted deletion
|
218
251
|
```
|
219
252
|
|
220
|
-
Check our API reference for more information on how to [delete an SKU](https://docs.commercelayer.io/api/
|
253
|
+
Check our API reference for more information on how to [delete an SKU](https://docs.commercelayer.io/developers/v/api-reference/skus/delete).
|
221
254
|
|
222
255
|
# Overriding credentials
|
223
256
|
|
224
|
-
If needed, Commerce Layer JS SDK lets you change the client configuration set it at a request level.
|
257
|
+
If needed, Commerce Layer JS SDK lets you change the client configuration set it at a request level.
|
258
|
+
To do that, just use the `config()` method or pass the `options` parameter and authenticate the API call with the desired credentials:
|
225
259
|
|
226
|
-
```
|
260
|
+
```typescript
|
227
261
|
// Permanently change configuration at client level
|
228
262
|
cl.config({ organization: 'you-organization-slug', accessToken: 'your-access-token' })
|
229
263
|
const skus = await cl.skus.list()
|
@@ -238,7 +272,7 @@ If needed, Commerce Layer JS SDK lets you change the client configuration set it
|
|
238
272
|
|
239
273
|
Commerce Layer API returns specific errors (with extra information) on each attribute of a single resource. You can inspect them to properly handle validation errors (if any). To do that, use the `errors` attribute of the catched error:
|
240
274
|
|
241
|
-
```
|
275
|
+
```typescript
|
242
276
|
// logs error messages to console:
|
243
277
|
|
244
278
|
const attributes = { code: 'TSHIRTMM000000FFFFFFXL', name: '' }
|
@@ -276,7 +310,7 @@ Commerce Layer API returns specific errors (with extra information) on each attr
|
|
276
310
|
|
277
311
|
```
|
278
312
|
|
279
|
-
Check our API reference for more information about the [errors](https://docs.commercelayer.io/
|
313
|
+
Check our API reference for more information about the [errors](https://docs.commercelayer.io/developers/handling-errors) returned by the API.
|
280
314
|
|
281
315
|
---
|
282
316
|
|
package/lib/api.d.ts
CHANGED
@@ -1,103 +1 @@
|
|
1
|
-
/**
|
2
|
-
* ©2022 Commerce Layer Inc.
|
3
|
-
* OpenAPI schema, version 2.8.1
|
4
|
-
**/
|
5
|
-
export { default as Addresses } from './resources/addresses';
|
6
|
-
export { default as Adjustments } from './resources/adjustments';
|
7
|
-
export { default as AdyenGateways } from './resources/adyen_gateways';
|
8
|
-
export { default as AdyenPayments } from './resources/adyen_payments';
|
9
|
-
export { default as Applications } from './resources/application';
|
10
|
-
export { default as Attachments } from './resources/attachments';
|
11
|
-
export { default as Authorizations } from './resources/authorizations';
|
12
|
-
export { default as AvalaraAccounts } from './resources/avalara_accounts';
|
13
|
-
export { default as BillingInfoValidationRules } from './resources/billing_info_validation_rules';
|
14
|
-
export { default as BingGeocoders } from './resources/bing_geocoders';
|
15
|
-
export { default as BraintreeGateways } from './resources/braintree_gateways';
|
16
|
-
export { default as BraintreePayments } from './resources/braintree_payments';
|
17
|
-
export { default as Bundles } from './resources/bundles';
|
18
|
-
export { default as Captures } from './resources/captures';
|
19
|
-
export { default as CarrierAccounts } from './resources/carrier_accounts';
|
20
|
-
export { default as CheckoutComGateways } from './resources/checkout_com_gateways';
|
21
|
-
export { default as CheckoutComPayments } from './resources/checkout_com_payments';
|
22
|
-
export { default as CouponCodesPromotionRules } from './resources/coupon_codes_promotion_rules';
|
23
|
-
export { default as CouponRecipients } from './resources/coupon_recipients';
|
24
|
-
export { default as Coupons } from './resources/coupons';
|
25
|
-
export { default as CustomerAddresses } from './resources/customer_addresses';
|
26
|
-
export { default as CustomerGroups } from './resources/customer_groups';
|
27
|
-
export { default as CustomerPasswordResets } from './resources/customer_password_resets';
|
28
|
-
export { default as CustomerPaymentSources } from './resources/customer_payment_sources';
|
29
|
-
export { default as CustomerSubscriptions } from './resources/customer_subscriptions';
|
30
|
-
export { default as Customers } from './resources/customers';
|
31
|
-
export { default as DeliveryLeadTimes } from './resources/delivery_lead_times';
|
32
|
-
export { default as EventCallbacks } from './resources/event_callbacks';
|
33
|
-
export { default as ExternalGateways } from './resources/external_gateways';
|
34
|
-
export { default as ExternalPayments } from './resources/external_payments';
|
35
|
-
export { default as ExternalPromotions } from './resources/external_promotions';
|
36
|
-
export { default as ExternalTaxCalculators } from './resources/external_tax_calculators';
|
37
|
-
export { default as FixedAmountPromotions } from './resources/fixed_amount_promotions';
|
38
|
-
export { default as FixedPricePromotions } from './resources/fixed_price_promotions';
|
39
|
-
export { default as FreeGiftPromotions } from './resources/free_gift_promotions';
|
40
|
-
export { default as FreeShippingPromotions } from './resources/free_shipping_promotions';
|
41
|
-
export { default as Geocoders } from './resources/geocoders';
|
42
|
-
export { default as GiftCardRecipients } from './resources/gift_card_recipients';
|
43
|
-
export { default as GiftCards } from './resources/gift_cards';
|
44
|
-
export { default as GoogleGeocoders } from './resources/google_geocoders';
|
45
|
-
export { default as Imports } from './resources/imports';
|
46
|
-
export { default as InStockSubscriptions } from './resources/in_stock_subscriptions';
|
47
|
-
export { default as InventoryModels } from './resources/inventory_models';
|
48
|
-
export { default as InventoryReturnLocations } from './resources/inventory_return_locations';
|
49
|
-
export { default as InventoryStockLocations } from './resources/inventory_stock_locations';
|
50
|
-
export { default as KlarnaGateways } from './resources/klarna_gateways';
|
51
|
-
export { default as KlarnaPayments } from './resources/klarna_payments';
|
52
|
-
export { default as LineItemOptions } from './resources/line_item_options';
|
53
|
-
export { default as LineItems } from './resources/line_items';
|
54
|
-
export { default as ManualGateways } from './resources/manual_gateways';
|
55
|
-
export { default as ManualTaxCalculators } from './resources/manual_tax_calculators';
|
56
|
-
export { default as Markets } from './resources/markets';
|
57
|
-
export { default as Merchants } from './resources/merchants';
|
58
|
-
export { default as OrderAmountPromotionRules } from './resources/order_amount_promotion_rules';
|
59
|
-
export { default as OrderCopies } from './resources/order_copies';
|
60
|
-
export { default as OrderSubscriptions } from './resources/order_subscriptions';
|
61
|
-
export { default as OrderValidationRules } from './resources/order_validation_rules';
|
62
|
-
export { default as Orders } from './resources/orders';
|
63
|
-
export { default as Organizations } from './resources/organization';
|
64
|
-
export { default as Packages } from './resources/packages';
|
65
|
-
export { default as ParcelLineItems } from './resources/parcel_line_items';
|
66
|
-
export { default as Parcels } from './resources/parcels';
|
67
|
-
export { default as PaymentGateways } from './resources/payment_gateways';
|
68
|
-
export { default as PaymentMethods } from './resources/payment_methods';
|
69
|
-
export { default as PaypalGateways } from './resources/paypal_gateways';
|
70
|
-
export { default as PaypalPayments } from './resources/paypal_payments';
|
71
|
-
export { default as PercentageDiscountPromotions } from './resources/percentage_discount_promotions';
|
72
|
-
export { default as PriceLists } from './resources/price_lists';
|
73
|
-
export { default as Prices } from './resources/prices';
|
74
|
-
export { default as PromotionRules } from './resources/promotion_rules';
|
75
|
-
export { default as Promotions } from './resources/promotions';
|
76
|
-
export { default as Refunds } from './resources/refunds';
|
77
|
-
export { default as ReturnLineItems } from './resources/return_line_items';
|
78
|
-
export { default as Returns } from './resources/returns';
|
79
|
-
export { default as Shipments } from './resources/shipments';
|
80
|
-
export { default as ShippingCategories } from './resources/shipping_categories';
|
81
|
-
export { default as ShippingMethods } from './resources/shipping_methods';
|
82
|
-
export { default as ShippingZones } from './resources/shipping_zones';
|
83
|
-
export { default as SkuListItems } from './resources/sku_list_items';
|
84
|
-
export { default as SkuListPromotionRules } from './resources/sku_list_promotion_rules';
|
85
|
-
export { default as SkuLists } from './resources/sku_lists';
|
86
|
-
export { default as SkuOptions } from './resources/sku_options';
|
87
|
-
export { default as Skus } from './resources/skus';
|
88
|
-
export { default as StockItems } from './resources/stock_items';
|
89
|
-
export { default as StockLineItems } from './resources/stock_line_items';
|
90
|
-
export { default as StockLocations } from './resources/stock_locations';
|
91
|
-
export { default as StockTransfers } from './resources/stock_transfers';
|
92
|
-
export { default as StripeGateways } from './resources/stripe_gateways';
|
93
|
-
export { default as StripePayments } from './resources/stripe_payments';
|
94
|
-
export { default as TaxCalculators } from './resources/tax_calculators';
|
95
|
-
export { default as TaxCategories } from './resources/tax_categories';
|
96
|
-
export { default as TaxRules } from './resources/tax_rules';
|
97
|
-
export { default as TaxjarAccounts } from './resources/taxjar_accounts';
|
98
|
-
export { default as Transactions } from './resources/transactions';
|
99
|
-
export { default as Voids } from './resources/voids';
|
100
|
-
export { default as Webhooks } from './resources/webhooks';
|
101
|
-
export { default as WireTransfers } from './resources/wire_transfers';
|
102
|
-
export declare type ResourceTypeLock = 'addresses' | 'adjustments' | 'adyen_gateways' | 'adyen_payments' | 'application' | 'attachments' | 'authorizations' | 'avalara_accounts' | 'billing_info_validation_rules' | 'bing_geocoders' | 'braintree_gateways' | 'braintree_payments' | 'bundles' | 'captures' | 'carrier_accounts' | 'checkout_com_gateways' | 'checkout_com_payments' | 'coupon_codes_promotion_rules' | 'coupon_recipients' | 'coupons' | 'customer_addresses' | 'customer_groups' | 'customer_password_resets' | 'customer_payment_sources' | 'customer_subscriptions' | 'customers' | 'delivery_lead_times' | 'event_callbacks' | 'external_gateways' | 'external_payments' | 'external_promotions' | 'external_tax_calculators' | 'fixed_amount_promotions' | 'fixed_price_promotions' | 'free_gift_promotions' | 'free_shipping_promotions' | 'geocoders' | 'gift_card_recipients' | 'gift_cards' | 'google_geocoders' | 'imports' | 'in_stock_subscriptions' | 'inventory_models' | 'inventory_return_locations' | 'inventory_stock_locations' | 'klarna_gateways' | 'klarna_payments' | 'line_item_options' | 'line_items' | 'manual_gateways' | 'manual_tax_calculators' | 'markets' | 'merchants' | 'order_amount_promotion_rules' | 'order_copies' | 'order_subscriptions' | 'order_validation_rules' | 'orders' | 'organization' | 'packages' | 'parcel_line_items' | 'parcels' | 'payment_gateways' | 'payment_methods' | 'paypal_gateways' | 'paypal_payments' | 'percentage_discount_promotions' | 'price_lists' | 'prices' | 'promotion_rules' | 'promotions' | 'refunds' | 'return_line_items' | 'returns' | 'shipments' | 'shipping_categories' | 'shipping_methods' | 'shipping_zones' | 'sku_list_items' | 'sku_list_promotion_rules' | 'sku_lists' | 'sku_options' | 'skus' | 'stock_items' | 'stock_line_items' | 'stock_locations' | 'stock_transfers' | 'stripe_gateways' | 'stripe_payments' | 'tax_calculators' | 'tax_categories' | 'tax_rules' | 'taxjar_accounts' | 'transactions' | 'voids' | 'webhooks' | 'wire_transfers';
|
103
|
-
export declare const resourceList: readonly ["addresses", "adjustments", "adyen_gateways", "adyen_payments", "application", "attachments", "authorizations", "avalara_accounts", "billing_info_validation_rules", "bing_geocoders", "braintree_gateways", "braintree_payments", "bundles", "captures", "carrier_accounts", "checkout_com_gateways", "checkout_com_payments", "coupon_codes_promotion_rules", "coupon_recipients", "coupons", "customer_addresses", "customer_groups", "customer_password_resets", "customer_payment_sources", "customer_subscriptions", "customers", "delivery_lead_times", "event_callbacks", "external_gateways", "external_payments", "external_promotions", "external_tax_calculators", "fixed_amount_promotions", "fixed_price_promotions", "free_gift_promotions", "free_shipping_promotions", "geocoders", "gift_card_recipients", "gift_cards", "google_geocoders", "imports", "in_stock_subscriptions", "inventory_models", "inventory_return_locations", "inventory_stock_locations", "klarna_gateways", "klarna_payments", "line_item_options", "line_items", "manual_gateways", "manual_tax_calculators", "markets", "merchants", "order_amount_promotion_rules", "order_copies", "order_subscriptions", "order_validation_rules", "orders", "organization", "packages", "parcel_line_items", "parcels", "payment_gateways", "payment_methods", "paypal_gateways", "paypal_payments", "percentage_discount_promotions", "price_lists", "prices", "promotion_rules", "promotions", "refunds", "return_line_items", "returns", "shipments", "shipping_categories", "shipping_methods", "shipping_zones", "sku_list_items", "sku_list_promotion_rules", "sku_lists", "sku_options", "skus", "stock_items", "stock_line_items", "stock_locations", "stock_transfers", "stripe_gateways", "stripe_payments", "tax_calculators", "tax_categories", "tax_rules", "taxjar_accounts", "transactions", "voids", "webhooks", "wire_transfers"];
|
1
|
+
export{default as Addresses}from'./resources/addresses';export{default as Adjustments}from'./resources/adjustments';export{default as AdyenGateways}from'./resources/adyen_gateways';export{default as AdyenPayments}from'./resources/adyen_payments';export{default as Applications}from'./resources/application';export{default as Attachments}from'./resources/attachments';export{default as Authorizations}from'./resources/authorizations';export{default as AvalaraAccounts}from'./resources/avalara_accounts';export{default as BillingInfoValidationRules}from'./resources/billing_info_validation_rules';export{default as BingGeocoders}from'./resources/bing_geocoders';export{default as BraintreeGateways}from'./resources/braintree_gateways';export{default as BraintreePayments}from'./resources/braintree_payments';export{default as Bundles}from'./resources/bundles';export{default as Captures}from'./resources/captures';export{default as CarrierAccounts}from'./resources/carrier_accounts';export{default as CheckoutComGateways}from'./resources/checkout_com_gateways';export{default as CheckoutComPayments}from'./resources/checkout_com_payments';export{default as CouponCodesPromotionRules}from'./resources/coupon_codes_promotion_rules';export{default as CouponRecipients}from'./resources/coupon_recipients';export{default as Coupons}from'./resources/coupons';export{default as CustomerAddresses}from'./resources/customer_addresses';export{default as CustomerGroups}from'./resources/customer_groups';export{default as CustomerPasswordResets}from'./resources/customer_password_resets';export{default as CustomerPaymentSources}from'./resources/customer_payment_sources';export{default as CustomerSubscriptions}from'./resources/customer_subscriptions';export{default as Customers}from'./resources/customers';export{default as DeliveryLeadTimes}from'./resources/delivery_lead_times';export{default as EventCallbacks}from'./resources/event_callbacks';export{default as ExternalGateways}from'./resources/external_gateways';export{default as ExternalPayments}from'./resources/external_payments';export{default as ExternalPromotions}from'./resources/external_promotions';export{default as ExternalTaxCalculators}from'./resources/external_tax_calculators';export{default as FixedAmountPromotions}from'./resources/fixed_amount_promotions';export{default as FixedPricePromotions}from'./resources/fixed_price_promotions';export{default as FreeGiftPromotions}from'./resources/free_gift_promotions';export{default as FreeShippingPromotions}from'./resources/free_shipping_promotions';export{default as Geocoders}from'./resources/geocoders';export{default as GiftCardRecipients}from'./resources/gift_card_recipients';export{default as GiftCards}from'./resources/gift_cards';export{default as GoogleGeocoders}from'./resources/google_geocoders';export{default as Imports}from'./resources/imports';export{default as InStockSubscriptions}from'./resources/in_stock_subscriptions';export{default as InventoryModels}from'./resources/inventory_models';export{default as InventoryReturnLocations}from'./resources/inventory_return_locations';export{default as InventoryStockLocations}from'./resources/inventory_stock_locations';export{default as KlarnaGateways}from'./resources/klarna_gateways';export{default as KlarnaPayments}from'./resources/klarna_payments';export{default as LineItemOptions}from'./resources/line_item_options';export{default as LineItems}from'./resources/line_items';export{default as ManualGateways}from'./resources/manual_gateways';export{default as ManualTaxCalculators}from'./resources/manual_tax_calculators';export{default as Markets}from'./resources/markets';export{default as Merchants}from'./resources/merchants';export{default as OrderAmountPromotionRules}from'./resources/order_amount_promotion_rules';export{default as OrderCopies}from'./resources/order_copies';export{default as OrderSubscriptions}from'./resources/order_subscriptions';export{default as OrderValidationRules}from'./resources/order_validation_rules';export{default as Orders}from'./resources/orders';export{default as Organizations}from'./resources/organization';export{default as Packages}from'./resources/packages';export{default as ParcelLineItems}from'./resources/parcel_line_items';export{default as Parcels}from'./resources/parcels';export{default as PaymentGateways}from'./resources/payment_gateways';export{default as PaymentMethods}from'./resources/payment_methods';export{default as PaypalGateways}from'./resources/paypal_gateways';export{default as PaypalPayments}from'./resources/paypal_payments';export{default as PercentageDiscountPromotions}from'./resources/percentage_discount_promotions';export{default as PriceLists}from'./resources/price_lists';export{default as Prices}from'./resources/prices';export{default as PromotionRules}from'./resources/promotion_rules';export{default as Promotions}from'./resources/promotions';export{default as Refunds}from'./resources/refunds';export{default as ReturnLineItems}from'./resources/return_line_items';export{default as Returns}from'./resources/returns';export{default as Shipments}from'./resources/shipments';export{default as ShippingCategories}from'./resources/shipping_categories';export{default as ShippingMethods}from'./resources/shipping_methods';export{default as ShippingZones}from'./resources/shipping_zones';export{default as SkuListItems}from'./resources/sku_list_items';export{default as SkuListPromotionRules}from'./resources/sku_list_promotion_rules';export{default as SkuLists}from'./resources/sku_lists';export{default as SkuOptions}from'./resources/sku_options';export{default as Skus}from'./resources/skus';export{default as StockItems}from'./resources/stock_items';export{default as StockLineItems}from'./resources/stock_line_items';export{default as StockLocations}from'./resources/stock_locations';export{default as StockTransfers}from'./resources/stock_transfers';export{default as StripeGateways}from'./resources/stripe_gateways';export{default as StripePayments}from'./resources/stripe_payments';export{default as TaxCalculators}from'./resources/tax_calculators';export{default as TaxCategories}from'./resources/tax_categories';export{default as TaxRules}from'./resources/tax_rules';export{default as TaxjarAccounts}from'./resources/taxjar_accounts';export{default as Transactions}from'./resources/transactions';export{default as Voids}from'./resources/voids';export{default as Webhooks}from'./resources/webhooks';export{default as WireTransfers}from'./resources/wire_transfers';export declare type ResourceTypeLock='addresses'|'adjustments'|'adyen_gateways'|'adyen_payments'|'application'|'attachments'|'authorizations'|'avalara_accounts'|'billing_info_validation_rules'|'bing_geocoders'|'braintree_gateways'|'braintree_payments'|'bundles'|'captures'|'carrier_accounts'|'checkout_com_gateways'|'checkout_com_payments'|'coupon_codes_promotion_rules'|'coupon_recipients'|'coupons'|'customer_addresses'|'customer_groups'|'customer_password_resets'|'customer_payment_sources'|'customer_subscriptions'|'customers'|'delivery_lead_times'|'event_callbacks'|'external_gateways'|'external_payments'|'external_promotions'|'external_tax_calculators'|'fixed_amount_promotions'|'fixed_price_promotions'|'free_gift_promotions'|'free_shipping_promotions'|'geocoders'|'gift_card_recipients'|'gift_cards'|'google_geocoders'|'imports'|'in_stock_subscriptions'|'inventory_models'|'inventory_return_locations'|'inventory_stock_locations'|'klarna_gateways'|'klarna_payments'|'line_item_options'|'line_items'|'manual_gateways'|'manual_tax_calculators'|'markets'|'merchants'|'order_amount_promotion_rules'|'order_copies'|'order_subscriptions'|'order_validation_rules'|'orders'|'organization'|'packages'|'parcel_line_items'|'parcels'|'payment_gateways'|'payment_methods'|'paypal_gateways'|'paypal_payments'|'percentage_discount_promotions'|'price_lists'|'prices'|'promotion_rules'|'promotions'|'refunds'|'return_line_items'|'returns'|'shipments'|'shipping_categories'|'shipping_methods'|'shipping_zones'|'sku_list_items'|'sku_list_promotion_rules'|'sku_lists'|'sku_options'|'skus'|'stock_items'|'stock_line_items'|'stock_locations'|'stock_transfers'|'stripe_gateways'|'stripe_payments'|'tax_calculators'|'tax_categories'|'tax_rules'|'taxjar_accounts'|'transactions'|'voids'|'webhooks'|'wire_transfers';export declare const resourceList:readonly["addresses","adjustments","adyen_gateways","adyen_payments","application","attachments","authorizations","avalara_accounts","billing_info_validation_rules","bing_geocoders","braintree_gateways","braintree_payments","bundles","captures","carrier_accounts","checkout_com_gateways","checkout_com_payments","coupon_codes_promotion_rules","coupon_recipients","coupons","customer_addresses","customer_groups","customer_password_resets","customer_payment_sources","customer_subscriptions","customers","delivery_lead_times","event_callbacks","external_gateways","external_payments","external_promotions","external_tax_calculators","fixed_amount_promotions","fixed_price_promotions","free_gift_promotions","free_shipping_promotions","geocoders","gift_card_recipients","gift_cards","google_geocoders","imports","in_stock_subscriptions","inventory_models","inventory_return_locations","inventory_stock_locations","klarna_gateways","klarna_payments","line_item_options","line_items","manual_gateways","manual_tax_calculators","markets","merchants","order_amount_promotion_rules","order_copies","order_subscriptions","order_validation_rules","orders","organization","packages","parcel_line_items","parcels","payment_gateways","payment_methods","paypal_gateways","paypal_payments","percentage_discount_promotions","price_lists","prices","promotion_rules","promotions","refunds","return_line_items","returns","shipments","shipping_categories","shipping_methods","shipping_zones","sku_list_items","sku_list_promotion_rules","sku_lists","sku_options","skus","stock_items","stock_line_items","stock_locations","stock_transfers","stripe_gateways","stripe_payments","tax_calculators","tax_categories","tax_rules","taxjar_accounts","transactions","voids","webhooks","wire_transfers"];
|
package/lib/client.d.ts
CHANGED
@@ -1,32 +1,2 @@
|
|
1
1
|
/// <reference types="node" />
|
2
|
-
import
|
3
|
-
import type { InterceptorManager } from './interceptor';
|
4
|
-
import type { Agent as HttpAgent } from 'http';
|
5
|
-
import type { Agent as HttpsAgent } from 'https';
|
6
|
-
declare type ProxyConfig = AxiosProxyConfig | false;
|
7
|
-
declare type RequestConfig = {
|
8
|
-
timeout?: number;
|
9
|
-
params?: {
|
10
|
-
[key: string]: string | number | boolean;
|
11
|
-
};
|
12
|
-
httpAgent?: HttpAgent;
|
13
|
-
httpsAgent?: HttpsAgent;
|
14
|
-
proxy?: ProxyConfig;
|
15
|
-
};
|
16
|
-
declare type ApiClientInitConfig = {
|
17
|
-
organization: string;
|
18
|
-
domain?: string;
|
19
|
-
accessToken: string;
|
20
|
-
} & RequestConfig;
|
21
|
-
declare type ApiClientConfig = Partial<ApiClientInitConfig>;
|
22
|
-
declare class ApiClient {
|
23
|
-
#private;
|
24
|
-
static create(options: ApiClientInitConfig): ApiClient;
|
25
|
-
baseUrl: string;
|
26
|
-
interceptors: InterceptorManager;
|
27
|
-
private constructor();
|
28
|
-
config(config: ApiClientConfig): void;
|
29
|
-
request(method: Method, path: string, body?: any, options?: ApiClientConfig): Promise<any>;
|
30
|
-
}
|
31
|
-
export default ApiClient;
|
32
|
-
export { ApiClientInitConfig, ApiClientConfig, RequestConfig };
|
2
|
+
import{AxiosProxyConfig,Method}from'axios';import type{InterceptorManager}from'./interceptor';import type{Agent as HttpAgent}from'http';import type{Agent as HttpsAgent}from'https';declare type ProxyConfig=AxiosProxyConfig|false;declare type RequestConfig={timeout?:number;params?:{[key:string]:string|number|boolean;};httpAgent?:HttpAgent;httpsAgent?:HttpsAgent;proxy?:ProxyConfig;};declare type ApiClientInitConfig={organization:string;domain?:string;accessToken:string;}&RequestConfig;declare type ApiClientConfig=Partial<ApiClientInitConfig>;declare class ApiClient{#private;static create(options:ApiClientInitConfig):ApiClient;baseUrl:string;interceptors:InterceptorManager;private constructor();config(config:ApiClientConfig):void;request(method:Method,path:string,body?:any,options?:ApiClientConfig):Promise<any>;}export default ApiClient;export{ApiClientInitConfig,ApiClientConfig,RequestConfig};
|
package/lib/client.js
CHANGED
@@ -1 +1 @@
|
|
1
|
-
|
1
|
+
import p from"axios";import{SdkError as E,ApiError as y,ErrorType as i}from"./error";import c from"./config";import w from"./debug";const n=w("client"),h=(r,e)=>`https://${r.toLowerCase()}.${e||c.default.domain}/api`,T=r=>{let e=new E({message:r.message,type:i.GENERIC});if(p.isAxiosError(r))if(r.response){const t=new y(e);t.type=i.RESPONSE,t.status=r.response.status,t.code=String(t.status),t.errors=r.response.data.errors,e=t}else r.request?(e.type=i.REQUEST,e.request=r.request):e.type=i.CLIENT;else p.isCancel(r)?e.type=i.CANCEL:e.source=r;throw e};class m{static create(e){if(!e?.organization)throw new Error("Undefined 'organization' parameter");if(!e?.accessToken)throw new Error("Undefined 'accessToken' parameter");return new m(e)}baseUrl;#e;#t;interceptors;constructor(e){n("new client instance %O",e),this.baseUrl=h(e.organization,e.domain),this.#e=e.accessToken;const t={timeout:e.timeout||c.client.timeout,proxy:e.proxy,httpAgent:e.httpAgent,httpsAgent:e.httpsAgent},s={baseURL:this.baseUrl,timeout:c.client.timeout,headers:{Accept:"application/vnd.api+json","Content-Type":"application/vnd.api+json",Authorization:"Bearer "+this.#e},...t};n("axios options: %O",s),this.#t=p.create(s),this.interceptors=this.#t.interceptors}config(e){n("config %o",e);const t=this.#t.defaults;e.timeout&&(t.timeout=e.timeout),e.proxy&&(t.proxy=e.proxy),e.httpAgent&&(t.httpAgent=e.httpAgent),e.httpsAgent&&(t.httpsAgent=e.httpsAgent),e.organization&&(this.baseUrl=h(e.organization,e.domain)),e.accessToken&&(this.#e=e.accessToken,t.headers.common.Authorization="Bearer "+this.#e)}async request(e,t,s,o){n("request %s %s, %O, %O",e,t,s||{},o||{});const g=s?{data:s}:void 0,l=t,A=o?.organization?h(o.organization,o.domain):void 0,u=o?.accessToken||this.#e,f=u?{Authorization:"Bearer "+u}:void 0,d={method:e,baseURL:A,url:l,data:g,headers:f,...o};return n("request params: %O",d),this.#t.request(d).then(a=>a.data).catch(a=>T(a))}}export default m;
|
package/lib/commercelayer.d.ts
CHANGED
@@ -1,122 +1 @@
|
|
1
|
-
import
|
2
|
-
import { ApiError } from './error';
|
3
|
-
import type { ErrorInterceptor, InterceptorType, RawResponseReader, RequestInterceptor, ResponseInterceptor } from './interceptor';
|
4
|
-
import { ResourcesInitConfig } from './resource';
|
5
|
-
declare type SdkConfig = {};
|
6
|
-
declare type CommerceLayerInitConfig = SdkConfig & ResourcesInitConfig;
|
7
|
-
declare type CommerceLayerConfig = Partial<CommerceLayerInitConfig>;
|
8
|
-
declare class CommerceLayerClient {
|
9
|
-
#private;
|
10
|
-
static get openApiSchemaVersion(): string;
|
11
|
-
addresses: api.Addresses;
|
12
|
-
adjustments: api.Adjustments;
|
13
|
-
adyen_gateways: api.AdyenGateways;
|
14
|
-
adyen_payments: api.AdyenPayments;
|
15
|
-
application: api.Applications;
|
16
|
-
attachments: api.Attachments;
|
17
|
-
authorizations: api.Authorizations;
|
18
|
-
avalara_accounts: api.AvalaraAccounts;
|
19
|
-
billing_info_validation_rules: api.BillingInfoValidationRules;
|
20
|
-
bing_geocoders: api.BingGeocoders;
|
21
|
-
braintree_gateways: api.BraintreeGateways;
|
22
|
-
braintree_payments: api.BraintreePayments;
|
23
|
-
bundles: api.Bundles;
|
24
|
-
captures: api.Captures;
|
25
|
-
carrier_accounts: api.CarrierAccounts;
|
26
|
-
checkout_com_gateways: api.CheckoutComGateways;
|
27
|
-
checkout_com_payments: api.CheckoutComPayments;
|
28
|
-
coupon_codes_promotion_rules: api.CouponCodesPromotionRules;
|
29
|
-
coupon_recipients: api.CouponRecipients;
|
30
|
-
coupons: api.Coupons;
|
31
|
-
customer_addresses: api.CustomerAddresses;
|
32
|
-
customer_groups: api.CustomerGroups;
|
33
|
-
customer_password_resets: api.CustomerPasswordResets;
|
34
|
-
customer_payment_sources: api.CustomerPaymentSources;
|
35
|
-
customer_subscriptions: api.CustomerSubscriptions;
|
36
|
-
customers: api.Customers;
|
37
|
-
delivery_lead_times: api.DeliveryLeadTimes;
|
38
|
-
event_callbacks: api.EventCallbacks;
|
39
|
-
external_gateways: api.ExternalGateways;
|
40
|
-
external_payments: api.ExternalPayments;
|
41
|
-
external_promotions: api.ExternalPromotions;
|
42
|
-
external_tax_calculators: api.ExternalTaxCalculators;
|
43
|
-
fixed_amount_promotions: api.FixedAmountPromotions;
|
44
|
-
fixed_price_promotions: api.FixedPricePromotions;
|
45
|
-
free_gift_promotions: api.FreeGiftPromotions;
|
46
|
-
free_shipping_promotions: api.FreeShippingPromotions;
|
47
|
-
geocoders: api.Geocoders;
|
48
|
-
gift_card_recipients: api.GiftCardRecipients;
|
49
|
-
gift_cards: api.GiftCards;
|
50
|
-
google_geocoders: api.GoogleGeocoders;
|
51
|
-
imports: api.Imports;
|
52
|
-
in_stock_subscriptions: api.InStockSubscriptions;
|
53
|
-
inventory_models: api.InventoryModels;
|
54
|
-
inventory_return_locations: api.InventoryReturnLocations;
|
55
|
-
inventory_stock_locations: api.InventoryStockLocations;
|
56
|
-
klarna_gateways: api.KlarnaGateways;
|
57
|
-
klarna_payments: api.KlarnaPayments;
|
58
|
-
line_item_options: api.LineItemOptions;
|
59
|
-
line_items: api.LineItems;
|
60
|
-
manual_gateways: api.ManualGateways;
|
61
|
-
manual_tax_calculators: api.ManualTaxCalculators;
|
62
|
-
markets: api.Markets;
|
63
|
-
merchants: api.Merchants;
|
64
|
-
order_amount_promotion_rules: api.OrderAmountPromotionRules;
|
65
|
-
order_copies: api.OrderCopies;
|
66
|
-
order_subscriptions: api.OrderSubscriptions;
|
67
|
-
order_validation_rules: api.OrderValidationRules;
|
68
|
-
orders: api.Orders;
|
69
|
-
organization: api.Organizations;
|
70
|
-
packages: api.Packages;
|
71
|
-
parcel_line_items: api.ParcelLineItems;
|
72
|
-
parcels: api.Parcels;
|
73
|
-
payment_gateways: api.PaymentGateways;
|
74
|
-
payment_methods: api.PaymentMethods;
|
75
|
-
paypal_gateways: api.PaypalGateways;
|
76
|
-
paypal_payments: api.PaypalPayments;
|
77
|
-
percentage_discount_promotions: api.PercentageDiscountPromotions;
|
78
|
-
price_lists: api.PriceLists;
|
79
|
-
prices: api.Prices;
|
80
|
-
promotion_rules: api.PromotionRules;
|
81
|
-
promotions: api.Promotions;
|
82
|
-
refunds: api.Refunds;
|
83
|
-
return_line_items: api.ReturnLineItems;
|
84
|
-
returns: api.Returns;
|
85
|
-
shipments: api.Shipments;
|
86
|
-
shipping_categories: api.ShippingCategories;
|
87
|
-
shipping_methods: api.ShippingMethods;
|
88
|
-
shipping_zones: api.ShippingZones;
|
89
|
-
sku_list_items: api.SkuListItems;
|
90
|
-
sku_list_promotion_rules: api.SkuListPromotionRules;
|
91
|
-
sku_lists: api.SkuLists;
|
92
|
-
sku_options: api.SkuOptions;
|
93
|
-
skus: api.Skus;
|
94
|
-
stock_items: api.StockItems;
|
95
|
-
stock_line_items: api.StockLineItems;
|
96
|
-
stock_locations: api.StockLocations;
|
97
|
-
stock_transfers: api.StockTransfers;
|
98
|
-
stripe_gateways: api.StripeGateways;
|
99
|
-
stripe_payments: api.StripePayments;
|
100
|
-
tax_calculators: api.TaxCalculators;
|
101
|
-
tax_categories: api.TaxCategories;
|
102
|
-
tax_rules: api.TaxRules;
|
103
|
-
taxjar_accounts: api.TaxjarAccounts;
|
104
|
-
transactions: api.Transactions;
|
105
|
-
voids: api.Voids;
|
106
|
-
webhooks: api.Webhooks;
|
107
|
-
wire_transfers: api.WireTransfers;
|
108
|
-
constructor(config: CommerceLayerInitConfig);
|
109
|
-
get currentOrganization(): string;
|
110
|
-
private localConfig;
|
111
|
-
config(config: CommerceLayerConfig): void;
|
112
|
-
resources(): readonly string[];
|
113
|
-
isApiError(error: any): error is ApiError;
|
114
|
-
addRequestInterceptor(onFulfilled?: RequestInterceptor, onRejected?: ErrorInterceptor): number;
|
115
|
-
addResponseInterceptor(onFulfilled?: ResponseInterceptor, onRejected?: ErrorInterceptor): number;
|
116
|
-
removeInterceptor(type: InterceptorType, id: number): void;
|
117
|
-
addRawResponseReader(): RawResponseReader;
|
118
|
-
removeRawResponseReader(reader: number | RawResponseReader): void;
|
119
|
-
}
|
120
|
-
declare const CommerceLayer: (config: CommerceLayerInitConfig) => CommerceLayerClient;
|
121
|
-
export default CommerceLayer;
|
122
|
-
export type { CommerceLayerClient, CommerceLayerConfig, CommerceLayerInitConfig };
|
1
|
+
import*as api from'./api';import{ApiError}from'./error';import type{ErrorInterceptor,InterceptorType,RawResponseReader,RequestInterceptor,ResponseInterceptor}from'./interceptor';import{ResourcesInitConfig}from'./resource';declare type SdkConfig={};declare type CommerceLayerInitConfig=SdkConfig&ResourcesInitConfig;declare type CommerceLayerConfig=Partial<CommerceLayerInitConfig>;declare class CommerceLayerClient{#private;static get openApiSchemaVersion():string;addresses:api.Addresses;adjustments:api.Adjustments;adyen_gateways:api.AdyenGateways;adyen_payments:api.AdyenPayments;application:api.Applications;attachments:api.Attachments;authorizations:api.Authorizations;avalara_accounts:api.AvalaraAccounts;billing_info_validation_rules:api.BillingInfoValidationRules;bing_geocoders:api.BingGeocoders;braintree_gateways:api.BraintreeGateways;braintree_payments:api.BraintreePayments;bundles:api.Bundles;captures:api.Captures;carrier_accounts:api.CarrierAccounts;checkout_com_gateways:api.CheckoutComGateways;checkout_com_payments:api.CheckoutComPayments;coupon_codes_promotion_rules:api.CouponCodesPromotionRules;coupon_recipients:api.CouponRecipients;coupons:api.Coupons;customer_addresses:api.CustomerAddresses;customer_groups:api.CustomerGroups;customer_password_resets:api.CustomerPasswordResets;customer_payment_sources:api.CustomerPaymentSources;customer_subscriptions:api.CustomerSubscriptions;customers:api.Customers;delivery_lead_times:api.DeliveryLeadTimes;event_callbacks:api.EventCallbacks;external_gateways:api.ExternalGateways;external_payments:api.ExternalPayments;external_promotions:api.ExternalPromotions;external_tax_calculators:api.ExternalTaxCalculators;fixed_amount_promotions:api.FixedAmountPromotions;fixed_price_promotions:api.FixedPricePromotions;free_gift_promotions:api.FreeGiftPromotions;free_shipping_promotions:api.FreeShippingPromotions;geocoders:api.Geocoders;gift_card_recipients:api.GiftCardRecipients;gift_cards:api.GiftCards;google_geocoders:api.GoogleGeocoders;imports:api.Imports;in_stock_subscriptions:api.InStockSubscriptions;inventory_models:api.InventoryModels;inventory_return_locations:api.InventoryReturnLocations;inventory_stock_locations:api.InventoryStockLocations;klarna_gateways:api.KlarnaGateways;klarna_payments:api.KlarnaPayments;line_item_options:api.LineItemOptions;line_items:api.LineItems;manual_gateways:api.ManualGateways;manual_tax_calculators:api.ManualTaxCalculators;markets:api.Markets;merchants:api.Merchants;order_amount_promotion_rules:api.OrderAmountPromotionRules;order_copies:api.OrderCopies;order_subscriptions:api.OrderSubscriptions;order_validation_rules:api.OrderValidationRules;orders:api.Orders;organization:api.Organizations;packages:api.Packages;parcel_line_items:api.ParcelLineItems;parcels:api.Parcels;payment_gateways:api.PaymentGateways;payment_methods:api.PaymentMethods;paypal_gateways:api.PaypalGateways;paypal_payments:api.PaypalPayments;percentage_discount_promotions:api.PercentageDiscountPromotions;price_lists:api.PriceLists;prices:api.Prices;promotion_rules:api.PromotionRules;promotions:api.Promotions;refunds:api.Refunds;return_line_items:api.ReturnLineItems;returns:api.Returns;shipments:api.Shipments;shipping_categories:api.ShippingCategories;shipping_methods:api.ShippingMethods;shipping_zones:api.ShippingZones;sku_list_items:api.SkuListItems;sku_list_promotion_rules:api.SkuListPromotionRules;sku_lists:api.SkuLists;sku_options:api.SkuOptions;skus:api.Skus;stock_items:api.StockItems;stock_line_items:api.StockLineItems;stock_locations:api.StockLocations;stock_transfers:api.StockTransfers;stripe_gateways:api.StripeGateways;stripe_payments:api.StripePayments;tax_calculators:api.TaxCalculators;tax_categories:api.TaxCategories;tax_rules:api.TaxRules;taxjar_accounts:api.TaxjarAccounts;transactions:api.Transactions;voids:api.Voids;webhooks:api.Webhooks;wire_transfers:api.WireTransfers;constructor(config:CommerceLayerInitConfig);get currentOrganization():string;private localConfig;config(config:CommerceLayerConfig):void;resources():readonly string[];isApiError(error:any):error is ApiError;addRequestInterceptor(onFulfilled?:RequestInterceptor,onRejected?:ErrorInterceptor):number;addResponseInterceptor(onFulfilled?:ResponseInterceptor,onRejected?:ErrorInterceptor):number;removeInterceptor(type:InterceptorType,id:number):void;addRawResponseReader():RawResponseReader;removeRawResponseReader(reader:number|RawResponseReader):void;}declare const CommerceLayer:(config:CommerceLayerInitConfig)=>CommerceLayerClient;export default CommerceLayer;export type{CommerceLayerClient,CommerceLayerConfig,CommerceLayerInitConfig};
|