Setup

Starts Subbly.js with your Storefront API key and resolves with the SDK instance. Every other method in this reference is a method of that instance.

init always loads the shop first, so subbly.shop is filled in by the time the promise resolves. It then checks the stored access token, and, when you pass loadCart, loads or creates a cart and copies the cart currency onto the instance. A failed shop load rejects the promise.

Call init once per page. The SDK builds one shared HTTP client and keeps it, so a second call with a different apiKey, apiUrl or lang quietly reuses the first one.

Sets the currency for the prices in later product, bundle and survey responses. The SDK sends it as the x-currency header.

It only fans the code out to subbly.products.setCurrency, subbly.bundles.setCurrency and subbly.surveys.setCurrency, which each store it for their own requests; an x-currency header you pass on a single call still wins.

This does not change the cart currency. Use subbly.cart.update({ currencyCode }) for that. When init loads a cart, it calls setCurrency with the cart currency itself.

Sets the accept-language header the SDK sends with every later request.

A read-only property with the version of the @subbly/sdk package the page loaded. Useful in a bug report.

The three client values init received, exactly as you passed them. It leaves out cartId, loadCart and accessToken, and it does not follow a later setLanguage call.

subbly.config is not the configuration in use. The SDK applies its defaults deeper in, when it builds the HTTP client, so a value you left out stays undefined here.