Skip to content

v0.1.0

Choose a tag to compare

@fvarrui fvarrui released this 09 Oct 20:24
· 32 commits to main since this release

First release. Stable aliases for people, for programs that send data about them to a language model.

Library

  • remember(person | people): a stable alias per person and service (A- + 6 Crockford base32 characters), from an HMAC of their strongest identifier under a local key. Kept in an encrypted local directory, so a person keeps their first alias when an identifier changes; per-service by default, one alias across services with link: true.
  • resolve(alias, { service }): the service's user id back, for write tools.
  • redact(text, { service }): the directory's people replaced by their aliases, and emails, Spanish phones, DNI, NIE and ES IBANs (with check digits) by placeholders. Addresses, birth dates and people outside the directory are not detected.
  • keyFingerprint() and PseudonymError.

CLI, for the person in charge only: whois, alias, aliases, link, forget, prune, key fingerprint | export | import.

No runtime dependencies; Node.js 20 or later. It's pseudonymization, not anonymization: see the README for what it doesn't protect against and how to keep agents away from the key.