# System

## Descrição

Este módulo da API Nativa é responsável por expor métodos que fornecem informações sobre o estado da máquina, como: tipo de conexão, informações da bateria, tempo passado desde de inicialização do sistema e outros mais.

## Interface

```ts
interface System {
  beep: (tone: Tones, duration: number) => void
  hasEthernet: () => boolean
  hasWifi: () => boolean
  hasGprs: () => boolean
  isBatteryPresent: () => boolean
  getCurrentConnectionType: () => string
  getPowerSupply: () => PowerSupply
  getTimeFromBoot: () => number
  getSerialNumber: () => string
  getBatteryStatus: () => BatteryStatus
  getBatteryLevel: () => number
  getVersion: () => string
  changeAdapter: (desiredAdapter: string) => boolean
  Tones: Tones
  PowerSupply: PowerSupply
  BatteryStatus: BatteryStatus
}

enum Tones {
  TONE1,
  TONE2,
  TONE3,
  TONE4,
  TONE5,
  TONE6,
  TONE7,
}

enum PowerSupply {
  ADAPTER,
  BATTERY,
  USB,
}

enum BatteryStatus {
  CHECK_NOT_SUPPORTED,
  IN_CHARGE,
  CHARGE_COMPLETE,
  DISCHARGE,
  ABSENT,
}
```

### beep(tone, duration)

Emite um beep sonoro pelo POS, em que o tempo (milessegundos) e a frequência sonora podem ser especificados na entrada do método. No caso da frequência, ela deve ser um dos 7 TONES `(TONE1, TONE2, ..., TONE7)`e, caso esteja em ambiente de desenvolvimento, um aviso será emitido no console. Se não forem especificados o tempo de beep e a frequência, serão utilizados valores padrões `(System.Tones.TONE1, 300)`.

```js
import System from '@mamba/pos/api/system.js'

/** Default beep */
System.beep(); // Beep: tone = 1700, duration = 300
System.beep(System.Tones.TONE3, 500) // Beep: tone = 2000, duration = 500
System.beep(System.Tones.TONE7, 800) // Beep: tone = 2800, duration = 800
```

### activateStonecode()

Permite ativar algum Stonecode dentro de Apps (por ex: usá-lo em operações Split)

```js
import System from '@mamba/pos/api/system.js'


System.activateStonecode();
```

### hasEthernet()

Informa se o POS tem Conexão via Ethernet. Caso esteja em ambiente de desenvolvimento, retorna true.

```js
import System from '@mamba/pos/api/system.js'

/** With ethernet */
System.hasEthernet(); // true

/** Without ethernet */
System.hasEthernet(); // false
```

### hasWifi()

Informa se o POS tem Conexão via Wifi. Caso esteja em ambiente de desenvolvimento, retorna true.

```js
import System from '@mamba/pos/api/system.js'

/** With wifi */
System.hasWifi(); // true

/** Without wifi */
System.hasWifi(); // false
```

### hasGprs()

Informa se o POS tem Conexão via GPRS. Caso esteja em ambiente de desenvolvimento, retorna false.

```js
import System from '@mamba/pos/api/system.js'

/** With GPRS */
System.hasGprs(); // true

/** Without GPRS */
System.hasGprs(); // false
```

### isBatteryPresent()

Informa se a bateria está conectada.

```js
import System from '@mamba/pos/api/system.js'

/** With battery */
System.isBatteryPresent(); // true

/** Without battery */
System.isBatteryPresent(); // false
```

### getCurrentConnectionType()

Informa em qual adaptador de rede o POS está conectado.


```js
import System from '@mamba/pos/api/system.js'

/** With wifi */
System.getCurrentConnectionType(); // wifi

/** With Mobile broadband, depends on the POS model. */
System.getCurrentConnectionType(); // Can be 4G, 3G, 2G, USSD, and unknow( empty string "")
```

### getTimeFromBoot()

Retorna em milissegundos o tempo desde a inicialização do sistema. Em ambiente de desenvolvimento retorna `0`.

```js
import System from '@mamba/pos/api/system.js'

const timeUp = System.getTimeFromBoot() / 3600;
console.log(`O Sistema está ligado à: ${timeUp} minutos.`) // O Sistema está ligado à $timeUp minutos
```

### getSerialNumber()

Retorna uma string com o número de serial da máquina. No ambiente de desenvolvimento retorna `'00000'`.

```js
import System from '@mamba/pos/api/system.js'

System.getSerialNumber(); // '12745'
```

### getBatteryStatus()

Retorna um `JSON` com o estado atual da bateria.

```js
import System from '@mamba/pos/api/system.js'

/** When the battery is being used without its power supply  */
System.getBatteryStatus(); // {present: true, level: 50, status: DISCHARGE} -- padrão retornado em ambiente de desenvolvimento

/** When the battery state is not found */
System.getBatteryStatus(); // {present: false, level: 0, status: CHECK_NOT_SUPPORTED}

/** When the battery is charging */
System.getBatteryStatus(); // {present: true, level: 25, status: IN_CHARGE}

/** When the battery is fully charged */
System.getBatteryStatus(); // {present: true, level: 100, status: CHARGE_COMPLETE}

/** Without battery */
System.getBatteryStatus(); // {present: false, level: 100, status: ABSENT}
```

### getBatteryLevel()

Retorna a porcentagem da carga da bateria do dispositivo.

```js
import System from '@mamba/pos/api/system.js'

System.getBatteryLevel(); // 50
```

### getPowerSupply()

Retorna o tipo de fonte de energia na qual o POS está conectado no momento. Podendo ser:
`ADAPTER`, `BATTERY`, `USB`. Em ambiente de desenvolvimento retorna `USB`.

```js
import System from '@mamba/pos/api/system.js'

/** When connected to a power-supply */
System.getPowerSupply(); // 'ADAPTER'

/** When using only the POS battery */
System.getPowerSupply(); // 'BATTERY'

/** When connected through an USB port */
System.getPowerSupply(); // 'USB'
```

### getBatteryStatus()

Retorna o status da energia do POS. Podendo ser:
`CHECK_NOT_SUPPORTED`, `IN_CHARGE`, `CHARGE_COMPLETE`,  `CHARGE_COMPLETE`, `DISCHARGE`, `ABSENT`. Em ambiente de desenvolvimento retorna `DISCHARGE`.

```js
import System from '@mamba/pos/api/system.js'

/** When it is not possible to check */
System.getBatteryStatus(); // 'CHECK_NOT_SUPPORTED'

/** When battery is charging */
System.getBatteryStatus(); // 'IN_CHARGE'

/** When battery full */
System.getBatteryStatus(); // 'CHARGE_COMPLETE'

/** When battery is discharged */
System.getBatteryStatus(); // 'DISCHARGE'

/** When the battery is not connected */
System.getBatteryStatus(); // 'ABSENT'
```


### getVersion()

Retorna a porcentagem da carga da bateria do dispositivo.

```js
import System from '@mamba/pos/api/system.js'

System.getVersion(); // '3.0.0'
```

### changeAdapter: (desiredAdapter: string)

Faz a mudança do adapatador de rede do POS, 3G e WIFI. Mundando de adaptador corretamente é retornado `true` e `false` em caso de falha.

```js
import System from '@mamba/pos/api/system.js'

/** Change to 3g */
System.changeAdapter('3g');

/** Change to wifi */
System.changeAdapter('wifi');

```