Librelinkup-api NPM

LibreLinkUp API

Unofficial library to integrate with the LibreLinkUp API and programmatically retrieve glucose data. This library allows authentication, connection listing, and glucose data retrieval for specific devices.

🚀 Features

Authentication: Logs into the LibreLinkUp API using email and password credentials.
Retrieve Connections: Lists all connections associated with the user’s account.
Glucose Query: Returns glucose data for a specific device, providing detailed and real-time information.

📦 Installation

npm install librelinkup-api

🔧 Environment Setup

Create a .env file in the project root and fill it with your LibreLinkUp credentials:

LIBRE_EMAIL=your-email@example.com  
LIBRE_PASSWORD=your-secure-password

Make sure your .env file is listed in .gitignore to avoid leaking sensitive information.

Quick Start

const { LibreLinkUpAPI } = require('librelinkup-api');

// Create instance with direct credentials
const api = new LibreLinkUpAPI('email@example.com', 'password');

// Or use environment variables (LIBRE_EMAIL and LIBRE_PASSWORD)
const { getConnections, getGlucoseData } = new LibreLinkUpAPI();

// Get all connections
const connections = await getConnections();
console.log('Connections:', connections);

// Get glucose data for a specific patient
const glucoseData = await getGlucoseData(connections[0].patientId);
console.log('Glucose Data:', glucoseData);

API Reference

`new LibreLinkUpAPI([email], [password])`

Creates a new instance of the LibreLinkUp API client.

Parameters:
- email (optional): Your LibreLinkUp account email. Falls back to LIBRE_EMAIL environment variable.
- password (optional): Your LibreLinkUp account password. Falls back to LIBRE_PASSWORD environment variable.
Throws: LibreLinkUpError if credentials are missing or invalid

`async getConnections()`

Retrieves all connections associated with the account.

Returns: Promise<Array> - List of connections with their details

{
  id: string;
  patientId: string;
  country: string;
  status: number;
  firstName: string;
  lastName: string;
  targetLow: number;
  targetHigh: number;
  glucoseMeasurement: {
    FactoryTimestamp: string;
    Timestamp: string;
    type: number;
    ValueInMgPerDl: number;
    Value: number;
    isHigh: boolean;
    isLow: boolean;
  };
}[]

`async getGlucoseData(patientId)`

Retrieves glucose data for a specific patient.

Parameters:
- patientId: String - The patient ID to fetch data for

Returns: Promise<Object> - Detailed glucose data

{
  connection: {
    // Connection details
  };
  activeSensors: Array;
  graphData: [{
    FactoryTimestamp: string;
    Timestamp: string;
    type: number;
    ValueInMgPerDl: number;
    Value: number;
    isHigh: boolean;
    isLow: boolean;
  }];
}

Error Handling

The library uses a custom LibreLinkUpError class that includes:

Error message
Error code
Original error (if applicable)

Common error codes:

{
  MISSING_CREDENTIALS: "Email and password are required",
  AUTH_FAILED: "Authentication failed",
  AUTH_ERROR: "Error during authentication",
  MISSING_PATIENT_ID: "Patient ID is required",
  FETCH_CONNECTIONS_FAILED: "Failed to fetch connections",
  FETCH_GLUCOSE_FAILED: "Failed to fetch glucose data"
}

Example error handling:

try {
  const connections = await getConnections();
} catch (error) {
  if (error.code === 'AUTH_FAILED') {
    console.error('Authentication failed:', error.message);
  } else {
    console.error('Error:', error.message);
  }
}

🧪 Testing

Run automated tests with:

npm test

Ensure that the .env file is correctly configured before running tests.

🛠️ Technologies Used

Node.js: JavaScript runtime environment.
Axios: HTTP client to make API requests.
dotenv: Secure credential management.
Jest: Automated testing framework.

🤝 Contributing

Contributions are welcome! Feel free to open Issues and Pull Requests.

Fork the project.
Create a new branch for your feature (git checkout -b feature/new-feature).
Commit your changes (git commit -m 'Add new feature').
Push your changes (git push origin feature/new-feature).
Open a Pull Request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

⚠️ Disclaimer

This project is an unofficial integration with LibreLinkUp and should be used only for educational and development purposes. Improper use may violate Abbott’s terms of service and pose security and privacy risks.

Biblioteca não oficial para integrar com a API do LibreLinkUp e obter dados de glicemia de forma programática. Esta biblioteca permite autenticação, listagem de conexões e obtenção de dados de glicemia para dispositivos específicos.

🚀 Funcionalidades

Autenticação: Realiza o login na API do LibreLinkUp usando credenciais de e-mail e senha.
Obtenção de Conexões: Lista todas as conexões associadas à conta do usuário.
Consulta de Glicemia: Retorna os dados de glicemia para um dispositivo específico, fornecendo informações detalhadas e em tempo real.

📦 Instalação

npm install librelinkup-api

🔧 Configuração do Ambiente

Crie um arquivo .env na raiz do projeto e preencha com suas credenciais do LibreLinkUp:

LIBRE_EMAIL=seu-email@example.com  
LIBRE_PASSWORD=sua-senha-segura

Certifique-se de que o arquivo .env está listado no .gitignore para evitar o vazamento de informações sensíveis.

Início Rápido

const { LibreLinkUpAPI } = require('librelinkup-api');

// Criar instância com credenciais diretas
const api = new LibreLinkUpAPI('email@example.com', 'senha');

// Ou usar variáveis de ambiente (LIBRE_EMAIL e LIBRE_PASSWORD)
const { getConnections, getGlucoseData } = new LibreLinkUpAPI();

// Obter todas as conexões
const connections = await getConnections();
console.log('Conexões:', connections);

// Obter dados de glicose para um paciente específico
const glucoseData = await getGlucoseData(connections[0].patientId);
console.log('Dados de Glicose:', glucoseData);

Referência da API

`new LibreLinkUpAPI([email], [senha])`

Cria uma nova instância do cliente da API LibreLinkUp.

Parâmetros:
- email (opcional): Seu email da conta LibreLinkUp. Usa LIBRE_EMAIL do ambiente se não fornecido.
- senha (opcional): Sua senha da conta LibreLinkUp. Usa LIBRE_PASSWORD do ambiente se não fornecida.
Lança: LibreLinkUpError se as credenciais estiverem faltando ou inválidas

`async getConnections()`

Recupera todas as conexões associadas à conta.

Retorna: Promise<Array> - Lista de conexões com seus detalhes

{
  id: string;
  patientId: string;
  country: string;
  status: number;
  firstName: string;
  lastName: string;
  targetLow: number;
  targetHigh: number;
  glucoseMeasurement: {
    FactoryTimestamp: string;
    Timestamp: string;
    type: number;
    ValueInMgPerDl: number;
    Value: number;
    isHigh: boolean;
    isLow: boolean;
  };
}[]

`async getGlucoseData(patientId)`

Recupera dados de glicose para um paciente específico.

Parâmetros:
- patientId: String - O ID do paciente para buscar os dados

Retorna: Promise<Object> - Dados detalhados de glicose

{
  connection: {
    // Detalhes da conexão
  };
  activeSensors: Array;
  graphData: [{
    FactoryTimestamp: string;
    Timestamp: string;
    type: number;
    ValueInMgPerDl: number;
    Value: number;
    isHigh: boolean;
    isLow: boolean;
  }];
}

Tratamento de Erros

A biblioteca usa uma classe personalizada LibreLinkUpError que inclui:

Mensagem de erro
Código do erro
Erro original (se aplicável)

Códigos de erro comuns:

{
  MISSING_CREDENTIALS: "Email e senha são obrigatórios",
  AUTH_FAILED: "Autenticação falhou",
  AUTH_ERROR: "Erro durante a autenticação",
  MISSING_PATIENT_ID: "ID do paciente é obrigatório",
  FETCH_CONNECTIONS_FAILED: "Falha ao buscar conexões",
  FETCH_GLUCOSE_FAILED: "Falha ao buscar dados de glicose"
}

Exemplo de tratamento de erro:

try {
  const connections = await getConnections();
} catch (error) {
  if (error.code === 'AUTH_FAILED') {
    console.error('Falha na autenticação:', error.message);
  } else {
    console.error('Erro:', error.message);
  }
}

🧪 Testes

Execute os testes automatizados com o comando:

npm test

Certifique-se de ter configurado corretamente o arquivo .env antes de rodar os testes.

🛠️ Tecnologias Utilizadas

Node.js: Ambiente de execução JavaScript.
Axios: Cliente HTTP para fazer as requisições à API.
dotenv: Para gerenciamento seguro de credenciais.
Jest: Para testes automatizados.

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir Issues e Pull Requests.

Faça um fork do projeto.
Crie uma branch para sua feature (git checkout -b feature/nova-feature).
Faça o commit (git commit -m 'Adiciona nova feature').
Envie as alterações (git push origin feature/nova-feature).
Abra um Pull Request.

📄 Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

⚠️ Aviso Legal

Este projeto é uma integração não oficial com o LibreLinkUp e deve ser usado apenas para fins educacionais e de desenvolvimento. O uso indevido pode violar os termos de serviço da Abbott e trazer riscos de segurança e privacidade.

librelinkup glucose diabetes api health

5 months ago

5 months ago

5 months ago