mcias

kyle/mcias

Files

Kyle Isom 8f09e0e81a Rename Go client package from mciasgoclient to mcias

- Update package declaration in client.go
- Update error message strings to reference new package name
- Update test package and imports to use new name
- Update README.md documentation and examples with new package name
- All tests pass

2026-03-14 19:01:07 -07:00

Rename Go client package from mciasgoclient to mcias

2026-03-14 19:01:07 -07:00

lisp

Implement Phase 9: client libraries (Go, Rust, Lisp, Python)

2026-03-11 16:38:32 -07:00

python

Fix SEC-01: require password for TOTP enroll

2026-03-13 00:48:31 -07:00

rust

Fix SEC-01: require password for TOTP enroll

2026-03-13 00:48:31 -07:00

testdata

Implement Phase 9: client libraries (Go, Rust, Lisp, Python)

2026-03-11 16:38:32 -07:00

README.md

Implement Phase 9: client libraries (Go, Rust, Lisp, Python)

2026-03-11 16:38:32 -07:00

README.md

This directory contains client libraries for the MCIAS REST API. All language implementations expose this API:

Client(server_url, [ca_cert_path], [token])
login(username, password, [totp_code]) → (token, expires_at)
logout() → void
renew_token() → (token, expires_at)
validate_token(token) → {valid, sub, roles, expires_at}
get_public_key() → {kty, crv, x}
health() → void  # raises/errors on 5xx
create_account(username, account_type, [password]) → account
list_accounts() → [account]
get_account(id) → account
update_account(id, [status]) → account
delete_account(id) → void
get_roles(account_id) → [role]
set_roles(account_id, roles) → void
issue_service_token(account_id) → (token, expires_at)
revoke_token(jti) → void
get_pg_creds(account_id) → pg_creds
set_pg_creds(account_id, host, port, database, username, password) → void

Name	HTTP Status	Meaning
`MciasAuthError`	401	Token missing, invalid, or expired
`MciasForbiddenError`	403	Insufficient role
`MciasNotFoundError`	404	Resource does not exist
`MciasInputError`	400	Malformed request
`MciasConflictError`	409	Conflict (e.g. duplicate username)
`MciasServerError`	5xx	Unexpected server error
`testdata/` contains canonical JSON response fixtures shared across language tests.

go/ — Go module git.wntrmute.dev/kyle/mcias/clients/go
rust/ — Rust crate mcias-client
lisp/ — ASDF system mcias-client
python/ — Python package mcias_client