Specifically emit expired event for resumption failures

.changeset/loud-apes-listen.md

@@ -0,0 +1,7 @@
+---
+'@atproto/api': patch
+---
+
+Add additional `AtpSessionEvent` event, `unknown`, and implements it within
+`resumeSession`. This is used for unknown exceptions, such as network
+connectivity issues.

packages/api/src/agent.ts

@@ -166,16 +166,18 @@ export class AtpAgent {
       this.session.handle = res.data.handle
       this.session.emailConfirmed = res.data.emailConfirmed
       this._updateApiEndpoint(res.data.didDoc)
+      this._persistSession?.('create', this.session)
       return res
-    } catch (e) {
+    } catch (e: any) {
       this.session = undefined
-      throw e
-    } finally {
-      if (this.session) {
-        this._persistSession?.('create', this.session)
-      } else {
+
+      if (e.message.includes('Invalid session')) {
         this._persistSession?.('create-failed', undefined)
+      } else {
+        this._persistSession?.('unknown', undefined)
       }
+
+      throw e
     }
   }
 

packages/api/src/types.ts

@@ -3,7 +3,7 @@ import { LabelPreference } from './moderation/types'
 /**
  * Used by the PersistSessionHandler to indicate what change occurred
  */
-export type AtpSessionEvent = 'create' | 'create-failed' | 'update' | 'expired'
+export type AtpSessionEvent = 'create' | 'create-failed' | 'update' | 'expired' | 'unknown'
 
 /**
  * Used by AtpAgent to store active sessions