Store, Device & Config

store: Store

Information about the current store, such as its domain, currency, and language.

Property	Type	Always present	Description
id	number	Yes	Unique identifier for the store.
name	string	Yes	Name of the store.
domain	string	Yes	Domain name associated with the store.
currency	string	Yes	Deprecated. Currency code. Use currency_details.code instead.
currency_details	CurrencyDetails	Yes	Currency used by the store, including its formatting rules.
language	"es" or "pt" or "en"	Yes	Language code of the store.
theme	string	Yes	Active theme name of the store.

CurrencyDetails (store.currency_details):

Property	Type	Always present	Description
code	string	Yes	Currency code (e.g. "USD", "EUR", "BRL").
cents_separator	string	Yes	Character used to separate the decimal part (e.g. ",").
thousands_separator	string	Yes	Character used to separate thousands (e.g. ".").
display_long	string	Yes	Long form of the currency symbol (e.g. "R$").
display_short	string	Yes	Short form of the currency symbol (e.g. "R$").

Example

import type { NubeSDK } from "@tiendanube/nube-sdk-types";

export function App(nube: NubeSDK) {
  nube.on("cart:update", ({ store }) => {
    const { currency_details } = store;

    console.log(`code: ${currency_details.code}`);
    console.log(`display_short: ${currency_details.display_short}`);
    console.log(`display_long: ${currency_details.display_long}`);
    console.log(`thousands_separator: ${currency_details.thousands_separator}`);
    console.log(`cents_separator: ${currency_details.cents_separator}`);
  });
}

For the exact TypeScript definitions, use Store and CurrencyDetails from @tiendanube/nube-sdk-types.

device: Device

Information about the device being used to access the application, including screen dimensions and device type.

Property	Type	Always present	Description
screen	DeviceScreen	Yes	Screen dimensions, orientation, pixel ratio.
type	"mobile" or "desktop"	Yes	The type of device.

DeviceScreen (device.screen):

Property	Type	Always present	Description
width	number	Yes	Width of the screen in pixels.
height	number	Yes	Height of the screen in pixels.
orientation	"portrait" or "landscape"	Yes	Orientation of the screen.
pixelRatio	number	Yes	Pixel ratio of the screen.
innerWidth	number	Yes	Width of the inner window in pixels.
innerHeight	number	Yes	Height of the inner window in pixels.

For the exact TypeScript definitions, use the types from @tiendanube/nube-sdk-types (e.g. Device, DeviceScreen).

config: AppConfig

Application-wide configuration settings, including cart validation rules.

Property	Type	Always present	Description
has_cart_validation	boolean	Yes	Determines whether cart validation is enabled.
disable_shipping_more_options	boolean	Yes	Determines whether the user can select a shipping option.

For the exact TypeScript definition, use AppConfig from @tiendanube/nube-sdk-types.