auth-strategy-manager 1.0.7

package/README.md

@@ -0,0 +1,301 @@
+# Auth Strategy Manager
+
+[![npm version](https://badge.fury.io/js/auth-strategy-manager.svg)](https://badge.fury.io/js/auth-strategy-manager)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+
+A flexible library for managing authentication with support for multiple strategies. Allows easy integration of various authentication methods (Keycloak, REST API, custom) into a unified interface.
+
+## 🌍 Documentation in Other Languages
+
+- [🇷🇺 Русский (Russian)](README_RU.md)
+- [🇺🇸 English (Current)](README.md)
+
+## 📦 Packages
+
+This repository contains the following packages:
+
+- **[@auth-strategy-manager/core](https://www.npmjs.com/package/@auth-strategy-manager/core)** - Core authentication strategy manager: provides the main classes and interfaces for managing authentication strategies, including `AuthStrategyManager`, `Strategy`, `StrategyHelper`, error classes, and constants.
+- **[@auth-strategy-manager/keycloak](https://www.npmjs.com/package/@auth-strategy-manager/keycloak)** - Keycloak strategy
+- **[@auth-strategy-manager/rest](https://www.npmjs.com/package/@auth-strategy-manager/rest)** - REST API strategy
+
+## 🚀 Quick Start
+
+### Install Core Package
+
+```bash
+npm install @auth-strategy-manager/core
+```
+
+### Install with Keycloak Strategy
+
+```bash
+npm install @auth-strategy-manager/core @auth-strategy-manager/keycloak keycloak-js
+```
+
+### Install with REST Strategy
+
+```bash
+npm install @auth-strategy-manager/core @auth-strategy-manager/rest axios
+```
+
+### Install All Packages
+
+```bash
+npm install @auth-strategy-manager/core @auth-strategy-manager/keycloak @auth-strategy-manager/rest keycloak-js axios
+```
+
+## 🔧 Usage
+
+### Basic Usage with Core Only
+
+```typescript
+import { AuthStrategyManager, Strategy } from '@auth-strategy-manager/core';
+
+// Create custom strategy
+class CustomStrategy implements Strategy {
+  readonly name = 'custom';
+  
+  public checkAuth = async (): Promise<boolean> => {
+    // Your authentication sign-ic
+    return true;
+  };
+  
+  public signIn = async <T = unknown, D = undefined>(config?: D): Promise<T> => {
+    // Your sign in sign-ic
+    return {} as T;
+  };
+  
+  public signUp = async <T = unknown, D = undefined>(config?: D): Promise<T> => {
+    // Your sign up sign-ic
+    return {} as T;
+  };
+  
+  public signOut = async (): Promise<void> => {
+    // Your sign out sign-ic
+    this.clearStorage();
+  };
+  
+  public refreshToken = async <T>(args?: T): Promise<void> => {
+    // Your token refresh sign-ic
+  };
+
+  public clear = (): void => {
+    // Your clear logic
+  };
+}
+
+// Use with strategy manager
+const authManager = new AuthStrategyManager([new CustomStrategy()]);
+```
+
+### AuthStrategyManager API
+
+Main class for managing authentication strategies.
+
+#### Constructor
+
+```typescript
+constructor(strategies: Strategy[])
+```
+
+Creates a new AuthStrategyManager instance with the provided strategies.
+
+#### Properties
+
+- `strategiesCount: number` - Total number of registered strategies
+- `strategy: Strategy` - Currently active strategy
+- `startUrl: string | undefined` - URL to redirect after authentication
+
+#### Methods
+
+- `checkAuth(): Promise<boolean>` - Check authentication status across all strategies. Returns true if any strategy is authenticated.
+- `setStrategies(strategies: Strategy[]): Promise<void>` - Replace all strategies with new ones
+- `use(strategyName: string): void` - Set the active strategy by name
+- `clear(): void` - Clear authentication state and reset all strategies
+
+#### Usage Examples
+
+```typescript
+// Create manager with strategies
+const authManager = new AuthStrategyManager([strategy1, strategy2]);
+
+// Check if user is authenticated
+const isAuthenticated = await authManager.checkAuth();
+
+// Switch to specific strategy
+authManager.use('keycloak');
+
+// Get current active strategy
+const currentStrategy = authManager.strategy;
+
+// Clear all authentication data
+authManager.clear();
+```
+
+### Using Keycloak Strategy
+
+```typescript
+import { AuthStrategyManager } from '@auth-strategy-manager/core';
+import { KeycloakStrategy } from '@auth-strategy-manager/keycloak';
+
+const keycloakStrategy = new KeycloakStrategy({
+  keycloak: {
+    realm: 'my-realm',
+    url: 'https://keycloak.example.com',
+    clientId: 'my-client'
+  }
+});
+
+const authManager = new AuthStrategyManager([keycloakStrategy]);
+```
+
+### Using REST Strategy
+
+```typescript
+import { AuthStrategyManager } from '@auth-strategy-manager/core';
+import { RestStrategy } from '@auth-strategy-manager/rest';
+
+const restStrategy = new RestStrategy({
+  checkAuth: { url: '/api/auth/check-auth', method: 'GET' },
+  signIn: { url: '/api/auth/sign-in', method: 'POST' },
+  signUp: { url: '/api/auth/sign-up', method: 'POST' },
+  signOut: { url: '/api/auth/sign-out', method: 'POST' },
+  refresh: { url: '/api/auth/refresh', method: 'POST' }
+});
+
+const authManager = new AuthStrategyManager([restStrategy]);
+
+// Check authentication
+const isAuthenticated = await restStrategy.checkAuth();
+
+// Sign out
+await restStrategy.signOut();
+
+// Clear state
+restStrategy.clear();
+```
+
+### Using Multiple Strategies
+
+```typescript
+import { AuthStrategyManager } from '@auth-strategy-manager/core';
+import { KeycloakStrategy } from '@auth-strategy-manager/keycloak';
+import { RestStrategy } from '@auth-strategy-manager/rest';
+
+const keycloakStrategy = new KeycloakStrategy({
+  keycloak: {
+    realm: 'my-realm',
+    url: 'https://keycloak.example.com',
+    clientId: 'my-client'
+  }
+});
+
+const restStrategy = new RestStrategy({
+  check: { url: '/api/auth/check-auth', method: 'GET' },
+  signIn: { url: '/api/auth/sign-in', method: 'POST' },
+  signUp: { url: '/api/auth/sign-up', method: 'POST' },
+  signOut: { url: '/api/auth/sign-out', method: 'POST' },
+  refresh: { url: '/api/auth/refresh', method: 'POST' }
+});
+
+const authManager = new AuthStrategyManager([keycloakStrategy, restStrategy]);
+
+// Check authentication (will try both strategies)
+const isAuthenticated = await authManager.check();
+```
+
+## 🏗️ Architecture
+
+### Core Package (@auth-strategy-manager/core)
+
+Contains the main classes and interfaces:
+
+- `AuthStrategyManager` - Main manager class
+- `Strategy` - Interface for all strategies
+- `StrategyHelper` - Helper class for state management
+- Error classes and constants
+
+### Keycloak Package (@auth-strategy-manager/keycloak)
+
+Provides Keycloak integration:
+
+- `KeycloakStrategy` - Keycloak authentication strategy
+- Keycloak-specific configuration types
+
+### REST Package (@auth-strategy-manager/rest)
+
+Provides REST API integration:
+
+- `RestStrategy` - REST API authentication strategy
+- REST-specific configuration types
+
+## 📖 Documentation
+
+- [Core Package Documentation](https://www.npmjs.com/package/@auth-strategy-manager/core)
+- [Keycloak Strategy Documentation](https://www.npmjs.com/package/@auth-strategy-manager/keycloak)
+- [REST Strategy Documentation](https://www.npmjs.com/package/@auth-strategy-manager/rest)
+
+## 🧪 Development
+
+### Setup
+
+```bash
+# Install dependencies
+npm install
+
+# Build all packages
+npm run build
+
+# Build specific package
+npm run build --workspace=@auth-strategy-manager/core
+```
+
+### Publishing
+
+```bash
+# Publish all packages
+npm run publish:all
+
+# Publish specific package
+npm run publish:core
+npm run publish:keycloak
+npm run publish:rest
+```
+
+## 📝 License
+
+ISC License
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📞 Support
+
+If you have questions or issues, create an issue in the GitHub repository.
+
+---
+
+**Auth Strategy Manager** - make authentication simple and flexible! 🔐 
+
+### Strategy Interface
+
+```typescript
+interface Strategy {
+  name: string;
+  token?: string;
+  isAuthenticated?: boolean;
+  startUrl?: string;
+  signInUrl?: string;
+  
+  checkAuth(): Promise<boolean>;
+  signIn<T = unknown, D = undefined>(config?: D): Promise<T>;
+  signUp<T = unknown, D = undefined>(config?: D): Promise<T>;
+  signOut(): Promise<void>;
+  refreshToken<T>(args?: T): Promise<void>;
+}
+``` 

package/README_RU.md

@@ -0,0 +1,299 @@
+# Auth Strategy Manager
+
+[![npm version](https://badge.fury.io/js/auth-strategy-manager.svg)](https://badge.fury.io/js/auth-strategy-manager)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+
+Гибкая библиотека для управления аутентификацией с поддержкой множественных стратегий. Позволяет легко интегрировать различные методы аутентификации (Keycloak, REST API, кастомные) в единый интерфейс.
+
+## 🌍 Документация на других языках
+
+- [🇺🇸 English (Английский)](README.md)
+- [🇷🇺 Русский (Текущий)](README_RU.md)
+
+## 📦 Пакеты
+
+Этот репозиторий содержит следующие пакеты:
+
+- **[@auth-strategy-manager/core](https://www.npmjs.com/package/@auth-strategy-manager/core)**  — основной менеджер стратегий аутентификации: содержит главные классы и интерфейсы для управления стратегиями аутентификации, включая `AuthStrategyManager`, `Strategy`, `StrategyHelper`, классы ошибок и константы.
+- **[@auth-strategy-manager/keycloak](https://www.npmjs.com/package/@auth-strategy-manager/keycloak)**  — стратегия Keycloak
+- **[@auth-strategy-manager/rest](https://www.npmjs.com/package/@auth-strategy-manager/rest)**  — стратегия REST API
+
+## 🚀 Быстрый старт
+
+### Установка основного пакета
+
+```bash
+npm install @auth-strategy-manager/core
+```
+
+### Установка с Keycloak стратегией
+
+```bash
+npm install @auth-strategy-manager/core @auth-strategy-manager/keycloak keycloak-js
+```
+
+### Установка с REST стратегией
+
+```bash
+npm install @auth-strategy-manager/core @auth-strategy-manager/rest axios
+```
+
+### Установка всех пакетов
+
+```bash
+npm install @auth-strategy-manager/core @auth-strategy-manager/keycloak @auth-strategy-manager/rest keycloak-js axios
+```
+
+## 🔧 Использование
+
+### Базовое использование только с core
+
+```typescript
+import { AuthStrategyManager, Strategy } from '@auth-strategy-manager/core';
+
+// Создание кастомной стратегии
+class CustomStrategy implements Strategy {
+  readonly name = 'custom';
+  
+  public checkAuth = async (): Promise<boolean> => {
+    // Ваша логика аутентификации
+    return true;
+  };
+  
+  public signIn = async <T = unknown, D = undefined>(config?: D): Promise<T> => {
+    // Ваша логика входа
+    return {} as T;
+  };
+  
+  public signUp = async <T = unknown, D = undefined>(config?: D): Promise<T> => {
+    // Ваша логика регистрации
+    return {} as T;
+  };
+  
+  public signOut = async (): Promise<void> => {
+    // Ваша логика выхода
+    this.clearStorage();
+  };
+  
+  public refreshToken = async <T>(args?: T): Promise<void> => {
+    // Ваша логика обновления токена
+  };
+
+  public clear = (): void => {
+    // Ваша логика очистки
+  };
+}
+
+// Использование с менеджером стратегий
+const authManager = new AuthStrategyManager([new CustomStrategy()]);
+```
+
+### AuthStrategyManager API
+
+Главный класс для управления стратегиями аутентификации.
+
+#### Конструктор
+
+```typescript
+constructor(strategies: Strategy[])
+```
+
+Создает новый экземпляр AuthStrategyManager с предоставленными стратегиями.
+
+#### Свойства
+
+- `strategiesCount: number` - Общее количество зарегистрированных стратегий
+- `strategy: Strategy` - Текущая активная стратегия
+- `startUrl: string | undefined` - URL для перенаправления после аутентификации
+
+#### Методы
+
+- `checkAuth(): Promise<boolean>` - Проверяет статус аутентификации по всем стратегиям. Возвращает true, если любая стратегия аутентифицирована.
+- `setStrategies(strategies: Strategy[]): Promise<void>` - Заменяет все стратегии новыми
+- `use(strategyName: string): void` - Устанавливает активную стратегию по имени
+- `clear(): void` - Очищает состояние аутентификации и сбрасывает все стратегии
+
+#### Примеры использования
+
+```typescript
+// Создание менеджера со стратегиями
+const authManager = new AuthStrategyManager([strategy1, strategy2]);
+
+// Проверка аутентификации пользователя
+const isAuthenticated = await authManager.checkAuth();
+
+// Переключение на конкретную стратегию
+authManager.use('keycloak');
+
+// Получение текущей активной стратегии
+const currentStrategy = authManager.strategy;
+
+// Очистка всех данных аутентификации
+authManager.clear();
+```
+
+### Strategy Interface
+
+```typescript
+interface Strategy {
+  name: string;
+  token?: string;
+  isAuthenticated?: boolean;
+  startUrl?: string;
+  signInUrl?: string;
+  
+  checkAuth(): Promise<boolean>;
+  signIn<T = unknown, D = undefined>(config?: D): Promise<T>;
+  signUp<T = unknown, D = undefined>(config?: D): Promise<T>;
+  signOut(): Promise<void>;
+  refreshToken<T>(args?: T): Promise<void>;
+}
+```
+
+### Использование Keycloak стратегии
+
+```typescript
+import { AuthStrategyManager } from '@auth-strategy-manager/core';
+import { KeycloakStrategy } from '@auth-strategy-manager/keycloak';
+
+const keycloakStrategy = new KeycloakStrategy({
+  keycloak: {
+    realm: 'my-realm',
+    url: 'https://keycloak.example.com',
+    clientId: 'my-client'
+  }
+});
+
+const authManager = new AuthStrategyManager([keycloakStrategy]);
+```
+
+### Использование REST стратегии
+
+```typescript
+import { AuthStrategyManager } from '@auth-strategy-manager/core';
+import { RestStrategy } from '@auth-strategy-manager/rest';
+
+const restStrategy = new RestStrategy({
+  checkAuth: { url: '/api/auth/checkAuth', method: 'GET' },
+  signIn: { url: '/api/auth/sign-in', method: 'POST' },
+  signOut: { url: '/api/auth/sign-out', method: 'POST' },
+  refresh: { url: '/api/auth/refresh', method: 'POST' }
+});
+
+const authManager = new AuthStrategyManager([restStrategy]);
+
+// Проверка аутентификации
+const isAuthenticated = await restStrategy.checkAuth();
+
+// Выход из системы
+await restStrategy.signOut();
+
+// Очистка состояния
+restStrategy.clear();
+```
+
+### Использование множественных стратегий
+
+```typescript
+import { AuthStrategyManager } from '@auth-strategy-manager/core';
+import { KeycloakStrategy } from '@auth-strategy-manager/keycloak';
+import { RestStrategy } from '@auth-strategy-manager/rest';
+
+const keycloakStrategy = new KeycloakStrategy({
+  keycloak: {
+    realm: 'my-realm',
+    url: 'https://keycloak.example.com',
+    clientId: 'my-client'
+  }
+});
+
+const restStrategy = new RestStrategy({
+  checkAuth: { url: '/api/auth/check-auth', method: 'GET' },
+  signIn: { url: '/api/auth/sign-in', method: 'POST' },
+  signOut: { url: '/api/auth/sign-out', method: 'POST' },
+  refresh: { url: '/api/auth/refresh', method: 'POST' }
+});
+
+const authManager = new AuthStrategyManager([keycloakStrategy, restStrategy]);
+
+// Проверка аутентификации (попробует обе стратегии)
+const isAuthenticated = await authManager.checkAuth();
+```
+
+## 🏗️ Архитектура
+
+### Основной пакет (@auth-strategy-manager/core)
+
+Содержит основные классы и интерфейсы:
+
+- `AuthStrategyManager` — главный класс менеджера
+- `Strategy` — интерфейс для всех стратегий
+- `StrategyHelper` — вспомогательный класс для управления состоянием
+- Классы ошибок и константы
+
+### Пакет Keycloak (@auth-strategy-manager/keycloak)
+
+Предоставляет интеграцию с Keycloak:
+
+- `KeycloakStrategy` — стратегия аутентификации Keycloak
+- Типы конфигурации для Keycloak
+
+### Пакет REST (@auth-strategy-manager/rest)
+
+Предоставляет интеграцию с REST API:
+
+- `RestStrategy` — стратегия аутентификации REST API
+- Типы конфигурации для REST
+
+## 📖 Документация
+
+- [Документация основного пакета](https://www.npmjs.com/package/@auth-strategy-manager/core)
+- [Документация Keycloak стратегии](https://www.npmjs.com/package/@auth-strategy-manager/keycloak)
+- [Документация REST стратегии](https://www.npmjs.com/package/@auth-strategy-manager/rest)
+
+## 🧪 Разработка
+
+### Настройка
+
+```bash
+# Установка зависимостей
+npm install
+
+# Сборка всех пакетов
+npm run build
+
+# Сборка конкретного пакета
+npm run build --workspace=@auth-strategy-manager/core
+```
+
+### Публикация
+
+```bash
+# Публикация всех пакетов
+npm run publish:all
+
+# Публикация конкретного пакета
+npm run publish:core
+npm run publish:keycloak
+npm run publish:rest
+```
+
+## 📝 Лицензия
+
+ISC License
+
+## 🤝 Вклад в проект
+
+1. Форкните репозиторий
+2. Создайте ветку для новой функции (`git checkAuthout -b feature/amazing-feature`)
+3. Зафиксируйте изменения (`git commit -m 'Add amazing feature'`)
+4. Отправьте в ветку (`git push origin feature/amazing-feature`)
+5. Откройте Pull Request
+
+## 📞 Поддержка
+
+Если у вас есть вопросы или проблемы, создайте issue в GitHub репозитории.
+
+---
+
+**Auth Strategy Manager** - сделайте аутентификацию простой и гибкой! 🔐 

package/index.d.ts

@@ -0,0 +1 @@
+export * from '@auth-strategy-manager/core';

package/index.js

@@ -0,0 +1 @@
+module.exports = require('@auth-strategy-manager/core');

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "auth-strategy-manager",
+  "version": "1.0.7",
+  "description": "Meta package for auth-strategy-manager. Installs core by default.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "keywords": [
+    "authentication",
+    "authorization",
+    "strategy",
+    "auth",
+    "core"
+  ],
+  "author": "azarov-serge <s.a.azarov@gmail.com>",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/azarov-serge/auth-strategy-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/azarov-serge/auth-strategy-manager/issues"
+  },
+  "homepage": "https://github.com/azarov-serge/auth-strategy-manager#readme",
+  "dependencies": {
+    "@auth-strategy-manager/core": "^1.0.5"
+  },
+  "scripts": {
+    "prepublishOnly": "cp ../README.md ./README.md && cp ../README_RU.md ./README_RU.md"
+  }
+}