refactor(login): add comments

src/services/LoginMethodStrategy/NostrLoginStrategy.ts

@@ -3,6 +3,12 @@ import { SignedEvent } from '../../types'
 import { LoginMethodStrategy } from './loginMethodStrategy'
 import { WindowNostr } from 'nostr-tools/nip07'
 
+/**
+ * Login Method Strategy when using nostr-login package.
+ *
+ * This class extends {@link LoginMethodStrategy base strategy} and implements all login method operations
+ * @see {@link LoginMethodStrategy}
+ */
 export class NostrLoginStrategy extends LoginMethodStrategy {
   private nostr: WindowNostr
 

src/services/LoginMethodStrategy/PrivateKeyStrategy.ts

@@ -12,6 +12,12 @@ import { AuthState, LoginMethod } from '../../store/auth/types'
 import { LoginMethodStrategy } from './loginMethodStrategy'
 import { verifySignedEvent } from '../../utils/nostr'
 
+/**
+ * Login Method Strategy when using dev private key login.
+ *
+ * This class extends {@link LoginMethodStrategy base strategy} and implements all login method operations
+ * @see {@link LoginMethodStrategy}
+ */
 export class PrivateKeyStrategy extends LoginMethodStrategy {
   async nip04Encrypt(receiver: string, content: string): Promise<string> {
     const keys = (store.getState().auth as AuthState).keyPair

src/services/LoginMethodStrategy/loginMethodContext.ts

@@ -8,6 +8,13 @@ import { LoginMethod } from '../../store/auth/types'
 import { NostrLoginStrategy } from './NostrLoginStrategy'
 import { PrivateKeyStrategy } from './PrivateKeyStrategy'
 
+/**
+ * This class is a context provider and helper class. This MUST be instantiated and used as an entry point for any of the {@link LoginMethodOperations LoginMethodOperations}
+ * @constructor Takes {@link LoginMethod LoginMethod} as an argument and sets the correct strategy
+ *
+ * @see {@link LoginMethod}
+ * @see {@link LoginMethodOperations}
+ */
 export class LoginMethodContext implements LoginMethodOperations {
   private strategy: LoginMethodStrategy
 

src/services/LoginMethodStrategy/loginMethodStrategy.ts

@@ -2,6 +2,9 @@
 import { EventTemplate, UnsignedEvent } from 'nostr-tools'
 import { SignedEvent } from '../../types/nostr'
 
+/**
+ * This interface holds all operations that are dependant on the login method and is used as the basis for the login strategies.
+ */
 export interface LoginMethodOperations {
   nip04Encrypt(receiver: string, content: string): Promise<string>
   nip04Decrypt(sender: string, content: string): Promise<string>
@@ -10,6 +13,10 @@ export interface LoginMethodOperations {
   signEvent(event: UnsignedEvent | EventTemplate): Promise<SignedEvent>
 }
 
+/**
+ * This is the fallback class that provides base implementation for the {@link LoginMethodOperations login method operations} . Only used to throw errors in case when the LoginMethod is missing (login context not set).
+ * @see {@link LoginMethodOperations}
+ */
 export class LoginMethodStrategy implements LoginMethodOperations {
   async nip04Encrypt(_receiver: string, _content: string): Promise<string> {
     throw new Error('Login method strategy is undefined')