Merge pull request #971 from ellemouton/sql13Sessions5

[sql-13] sessions: set up for atomic session creation

Author: ellemouton

app/src/types/generated/lit-sessions_pb.d.ts

@@ -662,7 +662,8 @@
         "STATE_CREATED",
         "STATE_IN_USE",
         "STATE_REVOKED",
-        "STATE_EXPIRED"
+        "STATE_EXPIRED",
+        "STATE_RESERVED"
       ],
       "default": "STATE_CREATED"
     },

app/src/types/generated/lit-sessions_pb.js

@@ -97,6 +97,7 @@ enum SessionState {
     STATE_IN_USE = 1;
     STATE_REVOKED = 2;
     STATE_EXPIRED = 3;
+    STATE_RESERVED = 4;
 }
 
 message AddSessionResponse {

litrpc/lit-autopilot.swagger.json

@@ -521,7 +521,8 @@
         "STATE_CREATED",
         "STATE_IN_USE",
         "STATE_REVOKED",
-        "STATE_EXPIRED"
+        "STATE_EXPIRED",
+        "STATE_RESERVED"
       ],
       "default": "STATE_CREATED"
     },

litrpc/lit-sessions.pb.go

@@ -97,6 +97,7 @@ enum SessionState {
     STATE_IN_USE = 1;
     STATE_REVOKED = 2;
     STATE_EXPIRED = 3;
+    STATE_RESERVED = 4;
 }
 
 message AddSessionResponse {

litrpc/lit-sessions.proto

@@ -26,11 +26,37 @@ const (
 // State represents the state of a session.
 type State uint8
 
+/*
+		/---> StateExpired
+StateCreated ---
+       		\---> StateRevoked
+*/
+
 const (
+	// StateCreated is the state of a session once it has been fully
+	// committed to the Store and is ready to be used. This is the first
+	// state of a session.
 	StateCreated State = 0
-	StateInUse   State = 1
+
+	// StateInUse is the state of a session that is currently being used.
+	//
+	// NOTE: this state is not currently used, but we keep it around for now
+	// since old sessions might still have this state persisted.
+	StateInUse State = 1
+
+	// StateRevoked is the state of a session that has been revoked before
+	// its expiry date.
 	StateRevoked State = 2
+
+	// StateExpired is the state of a session that has passed its expiry
+	// date.
 	StateExpired State = 3
+
+	// StateReserved is a temporary initial state of a session. On start-up,
+	// any sessions in this state should be cleaned up.
+	//
+	// NOTE: this isn't used yet.
+	StateReserved State = 4
 )
 
 // MacaroonRecipe defines the permissions and caveats that should be used
@@ -195,5 +221,9 @@ type Store interface {
 	CheckSessionGroupPredicate(groupID ID,
 		fn func(s *Session) bool) (bool, error)
 
+	// DeleteReservedSessions deletes all sessions that are in the
+	// StateReserved state.
+	DeleteReservedSessions() error
+
 	IDToGroupIndex
 }