Grants
A grant attaches a permission pattern to a subject with a boolean value:
true is an allow, false is an explicit deny.
interface PermissionGrant { permission: string; value: boolean; subjectId: string; workspaceId: string;}Allowing and denying
Section titled “Allowing and denying”setPermission upserts a grant; unsetPermission removes it:
await vperms.setPermission("user", "posts.read", true); // allowawait vperms.setPermission("user", "posts.delete", false); // denyawait vperms.unsetPermission("user", "posts.read"); // removesetPermission is an upsert: calling it again with the same permission
replaces the value. Within a workspace, there is at most one grant per
(subject, permission) pair. Permission paths are normalized to lowercase, so
Posts.READ and posts.read update the same grant.
Deny wins ties
Section titled “Deny wins ties”When two grants match a requested permission with the same specificity, depth and layer, an explicit deny wins over an allow. This makes it safe to add a deny that cancels an inherited allow without removing it.
Reading grants
Section titled “Reading grants”For advanced persistence access, the adapter exposes the raw grants of a subject. Pass the facade’s workspace ID explicitly:
import { createVPerms, SubjectType, VeguiPermsMemoryAdapter } from "vperms";
const adapter = new VeguiPermsMemoryAdapter();const vperms = createVPerms({ adapter });await vperms.saveSubject({ id: "user", type: SubjectType.User, parents: [] });await vperms.setPermission("user", "posts.read", true);await adapter.findSubjectGrants(vperms.workspaceId, "user");// [{ workspaceId: "root", subjectId: "user", permission: "posts.read", value: true }]Grants returned by an adapter are plain data. All validation, matching, inheritance and precedence happen in the service and the core engine — never in the adapter.
Inheritance source
Section titled “Inheritance source”Grants are attached to a subject but can be reached by its descendants. A
subject inherits the grants of every id listed in its parents (plus virtual
default parents). Continue with
Inheritance to see how the engine walks them.