@leancodepl/login-manager 8.5.0 → 8.5.1

package/src/lib/localTokenStorage.d.ts

@@ -0,0 +1,29 @@
+import { SyncTokenStorage, Token } from "./tokenStorage";
+/**
+ * Stores OAuth2 tokens in browser localStorage.
+ *
+ * Provides persistent token storage that survives browser sessions.
+ * Implements SyncTokenStorage interface for synchronous operations.
+ *
+ * @param tokenKey - localStorage key for access token (default: "token")
+ * @param refreshKey - localStorage key for refresh token (default: "refresh_token")
+ * @param expiryKey - localStorage key for expiry date (default: "expiration_date")
+ * @example
+ * ```typescript
+ * const storage = new LocalTokenStorage();
+ * const loginManager = new SyncLoginManager(storage, endpoint, secret, clientId, scopes);
+ * ```
+ */
+export declare class LocalTokenStorage implements SyncTokenStorage {
+    private tokenKey;
+    private refreshKey;
+    private expiryKey;
+    constructor(tokenKey?: string, refreshKey?: string, expiryKey?: string);
+    getToken(): Token | null;
+    storeToken(token: Token): void;
+    resetToken(): void;
+    private hasValue;
+    private getValue;
+    private setValue;
+    private remove;
+}

package/src/lib/memoryTokenStorage.d.ts

@@ -0,0 +1,19 @@
+import { SyncTokenStorage, Token } from "./tokenStorage";
+/**
+ * Stores OAuth2 tokens in memory.
+ *
+ * Provides temporary token storage that clears when the page is refreshed.
+ * Implements SyncTokenStorage interface for synchronous operations.
+ *
+ * @example
+ * ```typescript
+ * const storage = new MemoryTokenStorage();
+ * const loginManager = new SyncLoginManager(storage, endpoint, secret, clientId, scopes);
+ * ```
+ */
+export declare class MemoryTokenStorage implements SyncTokenStorage {
+    private token;
+    getToken(): Token | null;
+    storeToken(token: Token): Promise<void>;
+    resetToken(): Promise<void>;
+}

package/src/lib/sessionTokenStorage.d.ts

@@ -0,0 +1,29 @@
+import { SyncTokenStorage, Token } from "./tokenStorage";
+/**
+ * Stores OAuth2 tokens in browser sessionStorage.
+ *
+ * Provides session-based token storage that clears when the browser tab is closed.
+ * Implements SyncTokenStorage interface for synchronous operations.
+ *
+ * @param tokenKey - sessionStorage key for access token (default: "token")
+ * @param refreshKey - sessionStorage key for refresh token (default: "refresh_token")
+ * @param expiryKey - sessionStorage key for expiry date (default: "expiration_date")
+ * @example
+ * ```typescript
+ * const storage = new SessionTokenStorage();
+ * const loginManager = new SyncLoginManager(storage, endpoint, secret, clientId, scopes);
+ * ```
+ */
+export declare class SessionTokenStorage implements SyncTokenStorage {
+    private tokenKey;
+    private refreshKey;
+    private expiryKey;
+    constructor(tokenKey?: string, refreshKey?: string, expiryKey?: string);
+    getToken(): Token | null;
+    storeToken(token: Token): void;
+    resetToken(): void;
+    private hasValue;
+    private getValue;
+    private setValue;
+    private remove;
+}

package/src/lib/syncLoginManager.d.ts

@@ -0,0 +1,31 @@
+import { BaseLoginManager, LoginManager } from "./baseLoginManager";
+import { SyncTokenStorage } from "./tokenStorage";
+/**
+ * Manages OAuth2 authentication with synchronous token storage.
+ *
+ * Extends BaseLoginManager to work with sync storage implementations like localStorage or sessionStorage.
+ * Handles token refresh, expiration, and authentication state management.
+ *
+ * @param storage - Token storage implementation
+ * @param endpoint - OAuth2 server endpoint
+ * @param clientSecret - Client secret for authentication
+ * @param clientId - OAuth2 client identifier
+ * @param scopes - Space-separated OAuth2 scopes
+ * @param additionalParams - Additional OAuth2 parameters
+ * @example
+ * ```typescript
+ * const tokenStorage = new LocalTokenStorage();
+ * const loginManager = new SyncLoginManager(
+ *   tokenStorage,
+ *   'https://api.example.com',
+ *   'client_secret',
+ *   'client_id',
+ *   'openid profile'
+ * );
+ * ```
+ */
+export declare class SyncLoginManager extends BaseLoginManager<SyncTokenStorage> implements LoginManager {
+    signOut(): void;
+    isSigned(): boolean;
+    getToken(): Promise<string | null>;
+}

package/src/lib/tokenStorage.d.ts

@@ -0,0 +1,17 @@
+export interface Token {
+    token: string;
+    refreshToken: string;
+    expirationDate: Date;
+    abc?: string;
+}
+export type TokenStorage = AsyncTokenStorage | SyncTokenStorage;
+export interface SyncTokenStorage {
+    getToken(): Token | null;
+    storeToken(token: Token): void;
+    resetToken(): void;
+}
+export interface AsyncTokenStorage {
+    getToken(): Promise<Token | null>;
+    storeToken(token: Token): Promise<void>;
+    resetToken(): Promise<void>;
+}