docs: Admin APIs (#1192)

* docs: backend Admin API

* fix(backend): rollback String -> ID

* fix(backend): graphql generate

* docs: auth admin api

* docs: add suggestions

* fix: wording

* chore(auth): capitalize grant states

packages/auth/src/grant/model.ts

@@ -17,10 +17,10 @@ export enum FinishMethod {
 }
 
 export enum GrantState {
-  Pending = 'pending',
-  Granted = 'granted',
-  Revoked = 'revoked',
-  Rejected = 'rejected'
+  Pending = 'PENDING',
+  Granted = 'GRANTED',
+  Revoked = 'REVOKED',
+  Rejected = 'REJECTED'
 }
 
 export class Grant extends BaseModel {

packages/auth/src/graphql/schema.graphql

@@ -50,17 +50,26 @@ interface Model {
 }
 
 type Grant implements Model {
+  "Grant id"
   id: ID!
+  "Payment pointer of the resource owner's account"
   identifier: String!
+  "Payment pointer of the grantee's account"
   client: String!
+  "Access details"
   access: [Access!]!
-  state: String!
+  "State of the grant"
+  state: GrantState!
+  "Date-time of creation"
   createdAt: String!
 }
 
 type Access implements Model {
+  "Access id"
   id: ID!
+  "Payment pointer of a sub-resource (incoming payment, outgoing payment, or quote)"
   identifier: String
+  "Date-time of creation"
   createdAt: String!
 }
 
@@ -75,3 +84,14 @@ interface MutationResponse {
   success: Boolean!
   message: String!
 }
+
+enum GrantState {
+  "grant request was created but grant was not approved yet"
+  PENDING
+  "grant was approved"
+  GRANTED
+  "grant was revoked"
+  REVOKED
+  "grant was rejected"
+  REJECTED
+}