Skip to main content

Pocket Id

@jamesakeech/pocket-idv2026.08.08.1· 14d agoMODELS
01README

Observability for a Pocket ID instance — the passkey-based OIDC provider. health is a cheap, admin-free probe that separates an unreachable host from a wrong API key from a key whose owner is not an admin, and reports version drift; it writes its result as data rather than throwing, so a failed run still leaves a truthful record. sync fans out one resource per user, OIDC client, group and API key, joins each user against their passkeys and their sign-ins and each client against its authorizations, then scores the whole instance into instance.findings: accounts with no passkey that therefore cannot sign in, public clients with PKCE disabled, clients nobody has authorized, empty groups, and the API key whose expiry will silently stop the sync. syncActivity reads a bounded window of the audit log on its own — Pocket ID has no date filter, so the window is applied by walking newest-first and stopping early, which makes a short window genuinely cheap. Read-only throughout.

02Models1
@jamesakeech/pocket-idv2026.08.08.1pocket_id.ts
fn health()
Probe the instance without admin rights: /healthz, which account
fn syncActivity()
Read a bounded window of the audit log and write the `activity`
fn sync()
Read the whole instance and write one resource per user, OIDC

Resources

health(infinite)— Is the instance up, which account the API key belongs to, is that
instance(infinite)— Instance-wide rollup: user, client, group and API key counts, plus
user(infinite)— One user: identity, group membership, custom claim keys, registered
client(infinite)— One OIDC client: callback URLs, PKCE and consent settings, token
group(infinite)— One user group: its claim name, member count, and whether LDAP owns
apiKey(infinite)— One API key belonging to the account this model authenticates as —
activity(infinite)— Audit-log rollup over the window: counts per event type, a gap-free
auditEvent(infinite)— One audit-log entry: event type, user, client, IP, resolved city and
03Stats
A
100 / 100
Downloads
0
Archive size
57.2 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
04Platforms
05Labels