@ottimizza/mercury
v2.0.1
Published
<p align="center"> <img src="../../assets/logo.png" width="180" alt="Mercúrio"> </p>
Downloads
162
Readme
Mercúrio
Esta é uma biblioteca Angular-first para compartilhamento de dados entre diversos contadores da mesma contabilidade de forma descentralizada (P2P), simples e segura.
Para garantir a segurança do usuário, só é possível contectar-se com máquinas da mesma rede e o link de conexão dura somente um dia (porém como um link novo é criado toda vez que o usuário acessa a aplicação, isso não afeta a usabilidade).
Instalando
Basta instalar com npm npm install @ottimizza/mercury
e pronto :)
Utilização
Para utilizar a bibilioteca, simplesmente injete o MercuryService
em seu componente/serviço e utilize os seguintes métodos:
start()
Inicia o sistema compartilhamento de dados. Retorna o token
de conexão que deve ser enviado para o api-mercury-server
(autenticado no OAuth) que em então retornará todos os tokens que você tem acesso;
whenReady()
Também retorna o token
, mas somente se o serviço já tiver iniciado. Caso o serviço ainda não tenha iniciado, irá aguardar até iniciar;
connectTo(tokens: string[])
Se conecta aos tokens recebidos da api-mercury-server
;
get(url: string)
É aqui que a mágica acontece, basta informar a URL dos dados desejados e deixar que o Mercúrio obtenha-os para você da maneira mais rápida possível (seja ela de dados cacheados localmente, cacheados em outra máquina da rede ou, em último caso, do servidor);