lin3s-sylius-shop-api-client v0.9.4

SyliusShopApiClient

JavaScript client on top of SyliusShopApiPlugin to build integrations with ease.

Installation

Download the package:

• Using npm

$ npm install lin3s-sylius-shop-api-client

• Using yarn

$ yarn add lin3s-sylius-shop-api-client

Import the client:

• Using import:

import createSyliusApiClient from 'lin3s-sylius-shop-api-client';

• Using require():

const createSyliusApiClient = require('lin3s-sylius-shop-api-client');

Initialize the client

const api = createSyliusApiClient({
    baseUrl: 'localhost',
    channel: 'default',
    cookieDomain: '.myapp.com',
    locale: 'en_US',
    cartCookieExpiration: 604800000,
    userCookieExpiration: 2592000000,
    cartTokenCookie: 'cart-token',
})

Usage

For example to use the productsByTaxonSlug using the parameters as described in the API docs bellow ({slug} = an object containing slug property and its value):

const products = api.taxon.productsByTaxonSlug({slug: 'some-slug'});

Adding custom endpoints

In case a new endpoint is created in shop-api you can still use the configuration of the client. Your custom function will receive the config via parameters and it must return a function. This function has to be passed in the constructor. An example:

import axios from 'axios';
// You can make use of requestConfig helpers and session values
import createSyliusShopApiClient, {requestConfig} from 'lin3s-sylius-shop-api-client';

const myCustomEndpoint = config => () => new Promise(resolve => {
  axios.get(`${config.baseUrl}/shop-api/my-custom-endpoint`)
    .then(response => resolve(response.data));
});

const api = createSyliusApiClient({
  baseUrl: 'localhost',
  channel: 'default',
  locale: 'en_US',
  customEndpoints: {
    myCustomEndpoint
  }
});

// Usage
const response = api.custom.myCustomEndpoint();
api.Session.Cart.remove();

API

Cart api.cart

Checkout api.checkout

Product api.product

Taxon api.taxon

User api.user