Value and State Reference

This page consolidates important enum-like values and state concepts used across the product and platform.

Role and scope matrix

Concept	Values seen in code	Meaning
user role	`member`, `manager`, `admin`	broad product responsibility inside company scope
elevated identity	`superadmin`, `systemadmin` group	platform-wide or system-facing access
superadmin scope	`global`, `company`	whether a superadmin currently acts across companies or in one active company

Value	Where it appears	Meaning
`all`	`VisibilityMode.ALL`	user may see the whole allowed company scope
`tagged`	`VisibilityMode.TAGGED`	user only sees tagged subset of the company scope

Value	Meaning	Typical operator reading
`INVITED`	user exists but has not completed normal activation	waiting for onboarding
`ACTIVE`	account is in normal operating state	usable without special follow-up
`EXPIRED`	access or invitation validity no longer holds	review whether reactivation is needed
`DISABLED`	account was deliberately disabled	treat as inactive until re-enabled

Value	Meaning	Typical impact
`active`	object is available in normal state	visible and operational
`pending`	deletion is prepared or requested	cleanup may be imminent
`deleting`	deletion is actively in progress	intermediate state, avoid conflicting assumptions
`deleted`	object or file is no longer available in active form	metadata may remain, content may not

Value	Why it exists	What it usually changes
`payloads`	protect message body and downloadable payload content	body visibility and payload download can be blocked
`custom_headers`	protect potentially sensitive header values	header values can be masked even when the message remains visible

Signal	Meaning
`force_focused_ui = true`	user should remain in the narrower focused UI
tag keys present	user has tag-limited scope even without explicit focused-UI forcing
`hasFocusedScope()`	frontend resolves the effective narrower experience

These values are not abstract metadata. They shape:

which routes become visible
which tenant or company data is reachable
whether a user sees full content or masked content
whether AI or LLM-backed features can operate on sensitive message details safely