Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
48 changes: 30 additions & 18 deletions .agents/skills/hooks-admin/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
name: hooks-admin
description: React Query hooks for the admin API — provides typed query and mutation hooks for 30 tables and 12 custom operations
description: React Query hooks for the admin API — provides typed query and mutation hooks for 42 tables and 12 custom operations
---

# hooks-admin

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

React Query hooks for the admin API — provides typed query and mutation hooks for 30 tables and 12 custom operations
React Query hooks for the admin API — provides typed query and mutation hooks for 42 tables and 12 custom operations

## Usage

Expand Down Expand Up @@ -39,18 +39,28 @@ const { data, isLoading } = useAppAdminGrantsQuery({
See the `references/` directory for detailed per-entity API documentation:

- [app-admin-grant](references/app-admin-grant.md)
- [app-capability](references/app-capability.md)
- [app-capability-default-capability](references/app-capability-default-capability.md)
- [app-capability-default](references/app-capability-default.md)
- [app-capability-default-grant](references/app-capability-default-grant.md)
- [app-claimed-invite](references/app-claimed-invite.md)
- [app-grant](references/app-grant.md)
- [app-invite](references/app-invite.md)
- [app-membership](references/app-membership.md)
- [app-membership-default](references/app-membership-default.md)
- [app-membership-profile](references/app-membership-profile.md)
- [app-owner-grant](references/app-owner-grant.md)
- [app-permission](references/app-permission.md)
- [app-permission-default](references/app-permission-default.md)
- [app-permission-default-grant](references/app-permission-default-grant.md)
- [app-permission-default-permission](references/app-permission-default-permission.md)
- [app-profile-capability](references/app-profile-capability.md)
- [app-profile](references/app-profile.md)
- [app-profile-definition-grant](references/app-profile-definition-grant.md)
- [app-profile-grant](references/app-profile-grant.md)
- [app-profile-template](references/app-profile-template.md)
- [membership-type](references/membership-type.md)
- [org-admin-grant](references/org-admin-grant.md)
- [org-capability](references/org-capability.md)
- [org-capability-default-capability](references/org-capability-default-capability.md)
- [org-capability-default](references/org-capability-default.md)
- [org-capability-default-grant](references/org-capability-default-grant.md)
- [org-chart-edge](references/org-chart-edge.md)
- [org-chart-edge-grant](references/org-chart-edge-grant.md)
- [org-claimed-invite](references/org-claimed-invite.md)
Expand All @@ -62,21 +72,23 @@ See the `references/` directory for detailed per-entity API documentation:
- [org-member-profile](references/org-member-profile.md)
- [org-membership](references/org-membership.md)
- [org-membership-default](references/org-membership-default.md)
- [org-membership-profile](references/org-membership-profile.md)
- [org-membership-setting](references/org-membership-setting.md)
- [org-owner-grant](references/org-owner-grant.md)
- [org-permission](references/org-permission.md)
- [org-permission-default](references/org-permission-default.md)
- [org-permission-default-grant](references/org-permission-default-grant.md)
- [org-permission-default-permission](references/org-permission-default-permission.md)
- [app-permissions-get-by-mask](references/app-permissions-get-by-mask.md)
- [app-permissions-get-mask](references/app-permissions-get-mask.md)
- [app-permissions-get-mask-by-names](references/app-permissions-get-mask-by-names.md)
- [app-permissions-get-padded-mask](references/app-permissions-get-padded-mask.md)
- [org-profile-capability](references/org-profile-capability.md)
- [org-profile](references/org-profile.md)
- [org-profile-definition-grant](references/org-profile-definition-grant.md)
- [org-profile-grant](references/org-profile-grant.md)
- [org-profile-template](references/org-profile-template.md)
- [app-capabilities-get-by-mask](references/app-capabilities-get-by-mask.md)
- [app-capabilities-get-mask](references/app-capabilities-get-mask.md)
- [app-capabilities-get-mask-by-names](references/app-capabilities-get-mask-by-names.md)
- [app-capabilities-get-padded-mask](references/app-capabilities-get-padded-mask.md)
- [org-capabilities-get-by-mask](references/org-capabilities-get-by-mask.md)
- [org-capabilities-get-mask](references/org-capabilities-get-mask.md)
- [org-capabilities-get-mask-by-names](references/org-capabilities-get-mask-by-names.md)
- [org-capabilities-get-padded-mask](references/org-capabilities-get-padded-mask.md)
- [org-is-manager-of](references/org-is-manager-of.md)
- [org-permissions-get-by-mask](references/org-permissions-get-by-mask.md)
- [org-permissions-get-mask](references/org-permissions-get-mask.md)
- [org-permissions-get-mask-by-names](references/org-permissions-get-mask-by-names.md)
- [org-permissions-get-padded-mask](references/org-permissions-get-padded-mask.md)
- [provision-bucket](references/provision-bucket.md)
- [submit-app-invite-code](references/submit-app-invite-code.md)
- [submit-org-invite-code](references/submit-org-invite-code.md)
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# appCapabilitiesGetByMask

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Reads and enables pagination through a set of `AppCapability`.

## Usage

```typescript
useAppCapabilitiesGetByMaskQuery({ after: '<Cursor>', first: '<Int>', mask: '<BitString>', offset: '<Int>' })
```

## Examples

### Use useAppCapabilitiesGetByMaskQuery

```typescript
const { data, isLoading } = useAppCapabilitiesGetByMaskQuery({ after: '<Cursor>', first: '<Int>', mask: '<BitString>', offset: '<Int>' });
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# appCapabilitiesGetMaskByNames

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

React Query query hook for appCapabilitiesGetMaskByNames

## Usage

```typescript
useAppCapabilitiesGetMaskByNamesQuery({ names: '<String>' })
```

## Examples

### Use useAppCapabilitiesGetMaskByNamesQuery

```typescript
const { data, isLoading } = useAppCapabilitiesGetMaskByNamesQuery({ names: '<String>' });
```
19 changes: 19 additions & 0 deletions .agents/skills/hooks-admin/references/app-capabilities-get-mask.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# appCapabilitiesGetMask

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

React Query query hook for appCapabilitiesGetMask

## Usage

```typescript
useAppCapabilitiesGetMaskQuery({ ids: '<UUID>' })
```

## Examples

### Use useAppCapabilitiesGetMaskQuery

```typescript
const { data, isLoading } = useAppCapabilitiesGetMaskQuery({ ids: '<UUID>' });
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# appCapabilitiesGetPaddedMask

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

React Query query hook for appCapabilitiesGetPaddedMask

## Usage

```typescript
useAppCapabilitiesGetPaddedMaskQuery({ mask: '<BitString>' })
```

## Examples

### Use useAppCapabilitiesGetPaddedMaskQuery

```typescript
const { data, isLoading } = useAppCapabilitiesGetPaddedMaskQuery({ mask: '<BitString>' });
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# appCapabilityDefaultCapability

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Join table linking capability defaults to individual capabilities; recompute trigger rebuilds the defaults bitmask

## Usage

```typescript
useAppCapabilityDefaultCapabilitiesQuery({ selection: { fields: { capabilityId: true, createdAt: true, id: true, updatedAt: true } } })
useAppCapabilityDefaultCapabilityQuery({ id: '<UUID>', selection: { fields: { capabilityId: true, createdAt: true, id: true, updatedAt: true } } })
useCreateAppCapabilityDefaultCapabilityMutation({ selection: { fields: { id: true } } })
useUpdateAppCapabilityDefaultCapabilityMutation({ selection: { fields: { id: true } } })
useDeleteAppCapabilityDefaultCapabilityMutation({})
```

## Examples

### List all appCapabilityDefaultCapabilities

```typescript
const { data, isLoading } = useAppCapabilityDefaultCapabilitiesQuery({
selection: { fields: { capabilityId: true, createdAt: true, id: true, updatedAt: true } },
});
```

### Create a appCapabilityDefaultCapability

```typescript
const { mutate } = useCreateAppCapabilityDefaultCapabilityMutation({
selection: { fields: { id: true } },
});
mutate({ capabilityId: '<UUID>' });
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# appCapabilityDefaultGrant

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Audit log of capability additions and removals from the defaults bitmask

## Usage

```typescript
useAppCapabilityDefaultGrantsQuery({ selection: { fields: { capabilityId: true, createdAt: true, grantorId: true, id: true, isGrant: true, updatedAt: true } } })
useAppCapabilityDefaultGrantQuery({ id: '<UUID>', selection: { fields: { capabilityId: true, createdAt: true, grantorId: true, id: true, isGrant: true, updatedAt: true } } })
useCreateAppCapabilityDefaultGrantMutation({ selection: { fields: { id: true } } })
useUpdateAppCapabilityDefaultGrantMutation({ selection: { fields: { id: true } } })
useDeleteAppCapabilityDefaultGrantMutation({})
```

## Examples

### List all appCapabilityDefaultGrants

```typescript
const { data, isLoading } = useAppCapabilityDefaultGrantsQuery({
selection: { fields: { capabilityId: true, createdAt: true, grantorId: true, id: true, isGrant: true, updatedAt: true } },
});
```

### Create a appCapabilityDefaultGrant

```typescript
const { mutate } = useCreateAppCapabilityDefaultGrantMutation({
selection: { fields: { id: true } },
});
mutate({ capabilityId: '<UUID>', grantorId: '<UUID>', isGrant: '<Boolean>' });
```
34 changes: 34 additions & 0 deletions .agents/skills/hooks-admin/references/app-capability-default.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# appCapabilityDefault

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Stores the default capability bitmask assigned to new members upon joining

## Usage

```typescript
useAppCapabilityDefaultsQuery({ selection: { fields: { capabilities: true, id: true } } })
useAppCapabilityDefaultQuery({ id: '<UUID>', selection: { fields: { capabilities: true, id: true } } })
useCreateAppCapabilityDefaultMutation({ selection: { fields: { id: true } } })
useUpdateAppCapabilityDefaultMutation({ selection: { fields: { id: true } } })
useDeleteAppCapabilityDefaultMutation({})
```

## Examples

### List all appCapabilityDefaults

```typescript
const { data, isLoading } = useAppCapabilityDefaultsQuery({
selection: { fields: { capabilities: true, id: true } },
});
```

### Create a appCapabilityDefault

```typescript
const { mutate } = useCreateAppCapabilityDefaultMutation({
selection: { fields: { id: true } },
});
mutate({ capabilities: '<BitString>' });
```
34 changes: 34 additions & 0 deletions .agents/skills/hooks-admin/references/app-capability.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# appCapability

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Defines available capabilities as named bits within a bitmask, used by the RBAC system for access control

## Usage

```typescript
useAppCapabilitiesQuery({ selection: { fields: { bitnum: true, bitstr: true, description: true, id: true, kind: true, name: true } } })
useAppCapabilityQuery({ id: '<UUID>', selection: { fields: { bitnum: true, bitstr: true, description: true, id: true, kind: true, name: true } } })
useCreateAppCapabilityMutation({ selection: { fields: { id: true } } })
useUpdateAppCapabilityMutation({ selection: { fields: { id: true } } })
useDeleteAppCapabilityMutation({})
```

## Examples

### List all appCapabilities

```typescript
const { data, isLoading } = useAppCapabilitiesQuery({
selection: { fields: { bitnum: true, bitstr: true, description: true, id: true, kind: true, name: true } },
});
```

### Create a appCapability

```typescript
const { mutate } = useCreateAppCapabilityMutation({
selection: { fields: { id: true } },
});
mutate({ bitnum: '<Int>', bitstr: '<BitString>', description: '<String>', kind: '<String>', name: '<String>' });
```
10 changes: 5 additions & 5 deletions .agents/skills/hooks-admin/references/app-grant.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Records of individual permission grants and revocations for members via bitmask
Records of individual capability grants and revocations for members via bitmask

## Usage

```typescript
useAppGrantsQuery({ selection: { fields: { actorId: true, createdAt: true, grantorId: true, id: true, isGrant: true, permissions: true, updatedAt: true } } })
useAppGrantQuery({ id: '<UUID>', selection: { fields: { actorId: true, createdAt: true, grantorId: true, id: true, isGrant: true, permissions: true, updatedAt: true } } })
useAppGrantsQuery({ selection: { fields: { actorId: true, capabilities: true, createdAt: true, grantorId: true, id: true, isGrant: true, updatedAt: true } } })
useAppGrantQuery({ id: '<UUID>', selection: { fields: { actorId: true, capabilities: true, createdAt: true, grantorId: true, id: true, isGrant: true, updatedAt: true } } })
useCreateAppGrantMutation({ selection: { fields: { id: true } } })
useUpdateAppGrantMutation({ selection: { fields: { id: true } } })
useDeleteAppGrantMutation({})
Expand All @@ -20,7 +20,7 @@ useDeleteAppGrantMutation({})

```typescript
const { data, isLoading } = useAppGrantsQuery({
selection: { fields: { actorId: true, createdAt: true, grantorId: true, id: true, isGrant: true, permissions: true, updatedAt: true } },
selection: { fields: { actorId: true, capabilities: true, createdAt: true, grantorId: true, id: true, isGrant: true, updatedAt: true } },
});
```

Expand All @@ -30,5 +30,5 @@ const { data, isLoading } = useAppGrantsQuery({
const { mutate } = useCreateAppGrantMutation({
selection: { fields: { id: true } },
});
mutate({ actorId: '<UUID>', grantorId: '<UUID>', isGrant: '<Boolean>', permissions: '<BitString>' });
mutate({ actorId: '<UUID>', capabilities: '<BitString>', grantorId: '<UUID>', isGrant: '<Boolean>' });
```
34 changes: 34 additions & 0 deletions .agents/skills/hooks-admin/references/app-membership-profile.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# appMembershipProfile

<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->

Every profile a membership holds; memberships.profile_id points at one of them

## Usage

```typescript
useAppMembershipProfilesQuery({ selection: { fields: { actorId: true, createdAt: true, id: true, membershipId: true, profileId: true, updatedAt: true } } })
useAppMembershipProfileQuery({ id: '<UUID>', selection: { fields: { actorId: true, createdAt: true, id: true, membershipId: true, profileId: true, updatedAt: true } } })
useCreateAppMembershipProfileMutation({ selection: { fields: { id: true } } })
useUpdateAppMembershipProfileMutation({ selection: { fields: { id: true } } })
useDeleteAppMembershipProfileMutation({})
```

## Examples

### List all appMembershipProfiles

```typescript
const { data, isLoading } = useAppMembershipProfilesQuery({
selection: { fields: { actorId: true, createdAt: true, id: true, membershipId: true, profileId: true, updatedAt: true } },
});
```

### Create a appMembershipProfile

```typescript
const { mutate } = useCreateAppMembershipProfileMutation({
selection: { fields: { id: true } },
});
mutate({ actorId: '<UUID>', membershipId: '<UUID>', profileId: '<UUID>' });
```
Loading
Loading