0.2.0 • Published 9 months ago

@binsky/passman-client-ts v0.2.0

Weekly downloads
-
License
MIT
Repository
-
Last release
9 months ago

Passman Client TS

A TypeScript based Passman client library

This is currently under development, do not use in productive! Things should break :D


Notes about PassmanClient initialization workflow and caching

  • Create a PassmanClient instance as data and api (connection) manager to the Passman server part.
    • providing a PersistenceInterface instance like an overwritten instance of DefaultPersistenceService, allows you to configure PassmanClient internal data reconstruction based on the persistence service (configuration)
  • Preload the available vaults using passmanClient.preloadVaults() and use them to create a vault list and to authenticate the users vault password against.
    • preloaded vaults only contain some metadata without modification options or credentials
  • Call preloadedVault.testVaultKey('myPassword123') for one of the preloaded vaults in passmanClient.preloadedVaults
  • If the vault key got validated, you can load the full vault including its credentials, calling Vault.fetchFullVaultFromServer(...)

Vault cache reconstruction is currently solved by specialized request caching. This also contains the owned, encrypted credential data.

Credential decrypted data will be cached by providing a custom DecryptedDataCachingHandlerInterface implementation.