@ts-core/oauth 3.1.16 → 3.1.18

package/README.md

@@ -1 +1,445 @@
-Библиотека предназначена для реализации процесса авторизации пользователей через различные OAuth-сервисы, включая популярные платформы, такие как Google, VK, Яндекс и т.д. Библиотека облегчает интеграцию OAuth аутентификации в веб-приложениях, предоставляя общедоступный интерфейс для работы с различными провайдерами. Она настраиваемая и предоставляет пользователям обширный функционал для работы с различными провайдерами аутентификации, что делает её универсальным инструментом для разработчиков.
+# @ts-core/oauth
+
+[![npm version](https://badge.fury.io/js/%40ts-core%2Foauth.svg)](https://www.npmjs.com/package/@ts-core/oauth)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
+[![License: ISC](https://img.shields.io/badge/License-ISC-green.svg)](https://opensource.org/licenses/ISC)
+
+TypeScript-библиотека для OAuth-аутентификации через различные провайдеры. Поддерживает браузеры, Cordova и Telegram Web Apps.
+
+## Возможности
+
+- **6 провайдеров**: Google, VK, Яндекс, Mail.ru, Keycloak, Telegram
+- **3 платформы**: Browser (pop-up), Cordova (плагины), Telegram Web App
+- **Унифицированный API**: единый интерфейс для всех провайдеров
+- **TypeScript**: полная типизация, дженерики, интерфейсы
+- **Минимум зависимостей**: только `@ts-core/common`
+
+---
+
+## Установка
+
+```bash
+npm install @ts-core/oauth
+```
+
+---
+
+## Быстрый старт
+
+### Google OAuth
+
+```typescript
+import { GoAuth, GoUser } from '@ts-core/oauth';
+import { NullLogger } from '@ts-core/common';
+
+const auth = new GoAuth(new NullLogger(), 'YOUR_CLIENT_ID');
+
+// Получение токена через pop-up
+const { codeOrToken } = await auth.getToken();
+
+// Получение профиля пользователя
+const user: GoUser = await auth.getProfile(codeOrToken);
+console.log(user.name, user.email, user.picture);
+
+// Не забудьте освободить ресурсы
+auth.destroy();
+```
+
+### VK OAuth
+
+```typescript
+import { VkAuth, VkUser } from '@ts-core/oauth';
+import { NullLogger } from '@ts-core/common';
+
+const auth = new VkAuth(new NullLogger(), 'YOUR_APP_ID');
+
+// Получение кода авторизации
+const { codeOrToken, redirectUri } = await auth.getCode();
+
+// Обмен кода на токен (на сервере)
+const token = await auth.getTokenByCode({ codeOrToken, redirectUri }, 'YOUR_SECRET');
+
+// Получение профиля
+const user: VkUser = await auth.getProfile(token.accessToken);
+console.log(user.name, user.email, user.city);
+```
+
+### Яндекс OAuth
+
+```typescript
+import { YaAuth, YaUser } from '@ts-core/oauth';
+import { NullLogger } from '@ts-core/common';
+
+const auth = new YaAuth(new NullLogger(), 'YOUR_CLIENT_ID');
+const { codeOrToken } = await auth.getToken();
+const user: YaUser = await auth.getProfile(codeOrToken);
+```
+
+### Mail.ru OAuth
+
+```typescript
+import { MaAuth, MaUser } from '@ts-core/oauth';
+import { NullLogger } from '@ts-core/common';
+
+const auth = new MaAuth(new NullLogger(), 'YOUR_CLIENT_ID');
+const { codeOrToken } = await auth.getToken();
+const user: MaUser = await auth.getProfile(codeOrToken);
+```
+
+### Keycloak OAuth
+
+```typescript
+import { KeycloakAuth, KeycloakUser, IKeycloakAuthSettings } from '@ts-core/oauth';
+import { NullLogger } from '@ts-core/common';
+
+const settings: IKeycloakAuthSettings = {
+    url: 'https://keycloak.example.com',
+    realm: 'my-realm',
+    clientId: 'my-client'
+};
+
+const auth = new KeycloakAuth(new NullLogger(), settings);
+const { codeOrToken, redirectUri } = await auth.getCode();
+const token = await auth.getTokenByCode({ codeOrToken, redirectUri }, 'YOUR_SECRET');
+const user: KeycloakUser = await auth.getProfile(token.accessToken);
+
+// Logout через pop-up окно
+await auth.logout();
+```
+
+> **Logout**: метод `logout()` открывает pop-up с Keycloak logout endpoint. Keycloak завершает SSO-сессию и перенаправляет на redirect URI. Когда redirect-страница вызывает `window.close()`, промис резолвится.
+
+### Telegram Web App
+
+```typescript
+import { TgAuth, TgUser } from '@ts-core/oauth';
+
+// Для Telegram Web Apps — данные из URL hash
+const user: TgUser = TgAuth.getUser(window.location.hash);
+console.log(user.id, user.name);
+
+// Получение raw данных для верификации на сервере
+const initData: string = TgAuth.getInitData(window.location.hash);
+```
+
+### Telegram Login Widget
+
+```typescript
+import { TgAuth, TgApiLoader } from '@ts-core/oauth';
+import { NullLogger } from '@ts-core/common';
+
+const api = new TgApiLoader(new NullLogger());
+const auth = new TgAuth(new NullLogger(), { api, botId: YOUR_BOT_ID });
+
+const user = await auth.getUser();
+console.log(user.name, user.telegram);
+```
+
+---
+
+## Архитектура
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      PopUpBase<U>                           │
+│  • Управление pop-up окном                                  │
+│  • Обработка событий postMessage                            │
+│  • RxJS Observable для lifecycle событий                    │
+└─────────────────────────────────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    OAuthBase<T>                             │
+│  • OAuth flow: getCode(), getToken()                        │
+│  • Абстрактные методы: getProfile(), getTokenByCode()       │
+│  • HTTP клиент, state management                            │
+└─────────────────────────────────────────────────────────────┘
+                            │
+        ┌───────────────────┼───────────────────┐
+        ▼                   ▼                   ▼
+   ┌─────────┐        ┌─────────┐        ┌───────────┐
+   │ GoAuth  │        │ VkAuth  │        │KeycloakAuth│
+   └─────────┘        └─────────┘        └───────────┘
+        │                   │                   │
+        ▼                   ▼                   ▼
+   ┌─────────┐        ┌─────────┐        ┌───────────┐
+   │ GoUser  │        │ VkUser  │        │KeycloakUser│
+   └─────────┘        └─────────┘        └───────────┘
+```
+
+### Провайдеры
+
+| Провайдер | Auth класс | User класс | Особенности |
+|-----------|------------|------------|-------------|
+| Google | `GoAuth` | `GoUser` | People API для расширенных данных |
+| VK | `VkAuth` | `VkUser` | Email из токена |
+| Яндекс | `YaAuth` | `YaUser` | Стандартный OAuth 2.0 |
+| Mail.ru | `MaAuth` | `MaUser` | Стандартный OAuth 2.0 |
+| Keycloak | `KeycloakAuth` | `KeycloakUser` | Настраиваемый realm/URL, logout через pop-up |
+| Telegram | `TgAuth` | `TgUser` | Web App + Login Widget |
+
+---
+
+## API Reference
+
+### OAuthBase<T>
+
+Базовый класс для всех OAuth провайдеров.
+
+```typescript
+class OAuthBase<T> extends PopUpBase<IOAuthDto> {
+    constructor(logger: ILogger, applicationId: string, window?: Window);
+
+    // Основные методы
+    getCode(): Promise<IOAuthDto>;           // OAuth flow с response_type=code
+    getToken(): Promise<IOAuthDto>;          // OAuth flow с response_type=token
+
+    // Абстрактные методы (реализуются в провайдерах)
+    abstract getProfile(token: string): Promise<T>;
+    abstract getTokenByCode(dto: IOAuthDto, secret: string): Promise<IOAuthToken>;
+    abstract popUpUrl(): string;
+
+    // Настройки
+    redirectUri: string;                     // Кастомный redirect URI
+    popUpOpener: IPopUpOpener;               // Функция открытия pop-up (browser/cordova)
+
+    // Свойства
+    readonly state: string;                  // Случайный state для CSRF защиты
+    readonly http: TransportHttp;            // HTTP клиент
+
+    destroy(): void;                         // Освобождение ресурсов
+}
+
+// Тип функции открытия pop-up (поддерживает опциональный url для logout и др.)
+type IPopUpOpener = <T extends PopUpBase<U>, U>(popUp: T, window: Window, url?: string) => Window;
+
+```
+
+### OAuthUser
+
+Базовый класс пользователя с унифицированными полями.
+
+```typescript
+abstract class OAuthUser {
+    raw: any;                    // Оригинальный ответ API
+
+    id: string;                  // Уникальный ID пользователя
+    name: string;                // Полное имя
+    email?: string;              // Email
+    phone?: string;              // Телефон
+    picture?: string;            // URL аватара
+    nickname?: string;           // Никнейм/username
+
+    isMale?: boolean;            // Пол
+    birthday?: Date;             // Дата рождения
+
+    city?: string;               // Город
+    country?: string;            // Страна
+    locale?: string;             // Локаль
+
+    status?: string;             // Статус
+    description?: string;        // Описание/bio
+
+    // Социальные сети
+    vk?: string;
+    facebook?: string;
+    telegram?: string;
+    instagram?: string;
+
+    // Геттеры
+    readonly location: string;   // "Country, City"
+}
+```
+
+### KeycloakAuth
+
+```typescript
+class KeycloakAuth<T extends KeycloakUser> extends OAuthBase<T> {
+    constructor(logger: ILogger, settings: IKeycloakAuthSettings, window?: Window);
+
+    // Logout через pop-up окно
+    // Открывает Keycloak OIDC logout endpoint, ждёт закрытия окна
+    logout(): Promise<void>;
+
+    // Реализация OAuthBase
+    getProfile(token: string): Promise<T>;
+    getTokenByCode(dto: IOAuthDto, secret: string): Promise<IOAuthToken>;
+
+    readonly settings: IKeycloakAuthSettings;
+}
+```
+
+### Интерфейсы
+
+```typescript
+// Результат OAuth flow
+interface IOAuthDto {
+    codeOrToken: string;         // Код или токен
+    redirectUri: string;         // Использованный redirect URI
+}
+
+// Токен авторизации
+interface IOAuthToken {
+    accessToken: string;
+    expiresIn: number;
+
+    state?: string;
+    scope?: string;
+    userId?: number;
+    idToken?: string;
+    tokenType?: string;
+    refreshToken?: string;
+    refreshExpiresIn?: string;
+}
+
+// Настройки Keycloak
+interface IKeycloakAuthSettings {
+    url: string;                 // URL сервера Keycloak
+    realm: string;               // Название realm
+    clientId: string;            // ID клиента
+}
+
+// Настройки Telegram
+interface ITgAuthSettings {
+    api: ITgApiLoader;           // Загрузчик Telegram API
+    botId: number;               // ID бота
+}
+```
+
+---
+
+## Платформы
+
+### Browser (по умолчанию)
+
+Работает из коробки. Использует `window.open()` для pop-up и `postMessage` для коммуникации.
+
+**Требования к redirect странице:**
+
+```html
+<!-- /oauth.html — обрабатывает и login callback, и logout redirect -->
+<script>
+    const params = new URLSearchParams(window.location.search + window.location.hash.replace('#', '&'));
+    const code = params.get('code') || params.get('access_token');
+    if (code || params.get('error')) {
+        // Login callback — отправляем данные родительскому окну
+        window.opener.postMessage({
+            oAuthCodeOrToken: code,
+            oAuthError: params.get('error'),
+            oAuthErrorDescription: params.get('error_description')
+        }, '*');
+    }
+    // Закрываем pop-up (работает и для login, и для logout redirect)
+    window.close();
+</script>
+```
+
+### Cordova OAuth Plugin
+
+```typescript
+import { CordovaOAuthPluginPropertiesSet } from '@ts-core/oauth';
+
+const auth = new GoAuth(logger, 'CLIENT_ID');
+CordovaOAuthPluginPropertiesSet(auth);
+```
+
+### Cordova InAppBrowser
+
+```typescript
+import { CordovaInAppBrowserPluginPropertiesSet } from '@ts-core/oauth';
+
+const auth = new GoAuth(logger, 'CLIENT_ID');
+CordovaInAppBrowserPluginPropertiesSet(auth, async (url) => {
+    // Ваша логика получения токена по URL
+    return { codeOrToken: 'token', redirectUri: 'uri' };
+});
+```
+
+---
+
+## Расширенные возможности
+
+### Google People API
+
+```typescript
+const auth = new GoAuth(logger, 'CLIENT_ID');
+auth.personFields = 'genders,birthdays';  // Запросить дополнительные поля
+
+const user = await auth.getProfile(token);
+console.log(user.isMale, user.birthday);
+```
+
+### Кастомные scopes
+
+```typescript
+const auth = new VkAuth(logger, 'APP_ID');
+// Изменить scopes через params
+auth.params.set('scope', 'friends,photos,email');
+```
+
+### Кастомный redirect URI
+
+```typescript
+const auth = new GoAuth(logger, 'CLIENT_ID');
+auth.redirectUri = 'https://myapp.com/callback';
+```
+
+### События lifecycle
+
+```typescript
+import { PopUpBaseEvent } from '@ts-core/oauth';
+
+auth.events.subscribe(event => {
+    if (event.type === PopUpBaseEvent.OPENED) {
+        console.log('Pop-up opened');
+    }
+    if (event.type === PopUpBaseEvent.CLOSED) {
+        console.log('Pop-up closed');
+    }
+});
+```
+
+---
+
+## Структура проекта
+
+```
+src/
+├── OAuthBase.ts          # Базовый класс OAuth
+├── OAuthUser.ts          # Базовый класс пользователя
+├── OAuthParser.ts        # Парсер URL параметров
+├── PopUpBase.ts          # Управление pop-up окнами
+├── public-api.ts         # Единая точка экспорта
+├── external/             # Платформенные интеграции
+│   ├── browser.ts
+│   ├── cordovaOAuthPlugin.ts
+│   └── cordovaInAppBrowserPlugin.ts
+├── go/                   # Google
+├── vk/                   # VK
+├── ya/                   # Яндекс
+├── ma/                   # Mail.ru
+├── keycloak/             # Keycloak
+└── tg/                   # Telegram
+```
+
+---
+
+## Зависимости
+
+| Пакет | Версия | Назначение |
+|-------|--------|------------|
+| `@ts-core/common` | ~3.0.43 | Logger, HTTP, утилиты |
+
+---
+
+## Лицензия
+
+ISC License
+
+---
+
+## Автор
+
+**Renat Gubaev** — [renat.gubaev@gmail.com](mailto:renat.gubaev@gmail.com)
+
+GitHub: [ManhattanDoctor/ts-core-oauth](https://github.com/ManhattanDoctor/ts-core-oauth)

package/cjs/OAuthBase.d.ts

@@ -8,8 +8,8 @@ export declare abstract class OAuthBase<T = any> extends PopUpBase<IOAuthDto> {
     constructor(logger: ILogger, applicationId: string, window?: Window);
     protected getRedirectUri(): string;
     protected getParams(): URLSearchParams;
-    protected parseMessageData(item: any): IOAuthDto;
-    protected isMessageError(item: any): boolean;
+    protected parseMessageData(item: IOAuthPopUpDto): IOAuthDto;
+    protected isMessageError(item: IOAuthPopUpDto): boolean;
     protected parseMessageError(item: any): ExtendedError;
     abstract getProfile(token: string, ...params: any[]): Promise<T>;
     abstract getTokenByCode(dto: IOAuthDto, secret: string): Promise<IOAuthToken>;
@@ -24,6 +24,8 @@ export interface IOAuthDto {
     codeOrToken: string;
     redirectUri: string;
 }
+export interface IOAuthLogoutDto {
+}
 export interface IOAuthPopUpDto {
     oAuthError?: string;
     oAuthCodeOrToken?: string;

package/cjs/PopUpBase.d.ts

@@ -38,8 +38,8 @@ export declare abstract class PopUpBase<U> extends LoggerWrapper {
     get closed(): Observable<Window>;
     get opened(): Observable<Window>;
 }
-export declare function popUpOpener<T extends PopUpBase<U>, U>(popUp: T, window: Window): Window;
-export type IPopUpOpener = <T extends PopUpBase<U>, U>(popUp: T, window: Window) => Window;
+export declare function popUpOpener<T extends PopUpBase<U>, U>(popUp: T, window: Window, url?: string): Window;
+export type IPopUpOpener = <T extends PopUpBase<U>, U>(popUp: T, window: Window, url?: string) => Window;
 export type IPopUpMessageEventParser = (event: MessageEvent) => any;
 export declare enum PopUpEvent {
     OPENED = "OPENED",

package/cjs/PopUpBase.js

@@ -140,10 +140,13 @@ class PopUpBase extends common_1.LoggerWrapper {
 }
 exports.PopUpBase = PopUpBase;
 PopUpBase.ERROR_WINDOW_CLOSED = 'WINDOW_CLOSED';
-function popUpOpener(popUp, window) {
+function popUpOpener(popUp, window, url) {
+    if (_.isNil(url)) {
+        url = popUp.popUpUrl();
+    }
     let top = (window.screen.height - popUp.popUpHeight) / 2;
     let left = (window.screen.width - popUp.popUpWidth) / 2;
-    return window.open(popUp.popUpUrl(), popUp.popUpTarget, `scrollbars=yes,width=${popUp.popUpWidth},height=${popUp.popUpHeight},top=${top},left=${left}`);
+    return window.open(url, popUp.popUpTarget, `scrollbars=yes,width=${popUp.popUpWidth},height=${popUp.popUpHeight},top=${top},left=${left}`);
 }
 exports.popUpOpener = popUpOpener;
 var PopUpEvent;

package/cjs/external/cordovaInAppBrowserTgPlugin.d.ts

@@ -0,0 +1,8 @@
+import type { TgAuth } from '../tg/TgAuth';
+export declare const TgAuthCordovaInAppBrowserPluginPropertiesSet: (item: TgAuth, options: ITgAuthCordovaInAppBrowserOptions) => void;
+export interface ITgAuthCordovaInAppBrowserOptions {
+    origin: string;
+    returnUrl: string;
+    requestAccess?: 'write';
+    inAppBrowserOptions?: string;
+}

package/cjs/external/cordovaInAppBrowserTgPlugin.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TgAuthCordovaInAppBrowserPluginPropertiesSet = void 0;
+const common_1 = require("@ts-core/common");
+const PopUpBase_1 = require("../PopUpBase");
+const TgUser_1 = require("../tg/TgUser");
+const _ = require("lodash");
+const TgAuthCordovaInAppBrowserPluginPropertiesSet = (item, options) => {
+    let returnUrl = options.returnUrl;
+    let origin = options.origin;
+    let requestAccess = options.requestAccess;
+    let inAppBrowserOptions = !_.isNil(options.inAppBrowserOptions) ? options.inAppBrowserOptions : 'location=no,clearcache=yes,clearsessioncache=yes';
+    item.userProvider = (botId) => new Promise((resolve, reject) => {
+        let cordova = window['cordova'];
+        if (_.isNil(cordova) || _.isNil(cordova.InAppBrowser)) {
+            reject(new common_1.ExtendedError(`Cordova InAppBrowser undefined, please check installed plugins`));
+            return;
+        }
+        let url = `https://oauth.telegram.org/auth?bot_id=${botId}`
+            + `&origin=${encodeURIComponent(origin)}`
+            + `&return_to=${encodeURIComponent(returnUrl)}`;
+        if (!_.isNil(requestAccess)) {
+            url += `&request_access=${requestAccess}`;
+        }
+        let popUp = cordova.InAppBrowser.open(url, '_blank', inAppBrowserOptions);
+        let isSettled = false;
+        let cleanup = () => {
+            popUp.removeEventListener('loadstart', onLoad);
+            popUp.removeEventListener('loadstop', onLoad);
+            popUp.removeEventListener('exit', onExit);
+        };
+        let onLoad = (event) => {
+            if (isSettled || _.isNil(event) || _.isNil(event.url) || event.url.indexOf(returnUrl) !== 0) {
+                return;
+            }
+            let user = parseTgAuthResult(event.url);
+            if (_.isNil(user)) {
+                return;
+            }
+            isSettled = true;
+            cleanup();
+            popUp.close();
+            resolve(user);
+        };
+        let onExit = () => {
+            cleanup();
+            if (!isSettled) {
+                reject(new common_1.ExtendedError(PopUpBase_1.PopUpBase.ERROR_WINDOW_CLOSED, PopUpBase_1.PopUpBase.ERROR_WINDOW_CLOSED));
+            }
+        };
+        popUp.addEventListener('loadstart', onLoad, false);
+        popUp.addEventListener('loadstop', onLoad, false);
+        popUp.addEventListener('exit', onExit, false);
+    });
+};
+exports.TgAuthCordovaInAppBrowserPluginPropertiesSet = TgAuthCordovaInAppBrowserPluginPropertiesSet;
+function parseTgAuthResult(url) {
+    let raw = null;
+    let hashIndex = url.indexOf('#');
+    if (hashIndex >= 0) {
+        let value = new URLSearchParams(url.substring(hashIndex + 1)).get('tgAuthResult');
+        if (!_.isEmpty(value)) {
+            try {
+                raw = base64UrlDecode(value);
+            }
+            catch (error) { }
+        }
+    }
+    let data = null;
+    if (!_.isNil(raw)) {
+        try {
+            data = JSON.parse(raw);
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    else {
+        let qIndex = url.indexOf('?');
+        if (qIndex < 0) {
+            return null;
+        }
+        let query = new URLSearchParams(url.substring(qIndex + 1, hashIndex >= 0 ? hashIndex : undefined));
+        if (_.isEmpty(query.get('hash'))) {
+            return null;
+        }
+        data = {};
+        query.forEach((v, k) => data[k] = v);
+    }
+    if (_.isNil(data) || _.isNil(data.hash)) {
+        return null;
+    }
+    let user = new TgUser_1.TgUser();
+    user.parse(data);
+    return user;
+}
+function base64UrlDecode(value) {
+    let normalized = value.replace(/-/g, '+').replace(/_/g, '/');
+    let pad = normalized.length % 4;
+    if (pad !== 0) {
+        normalized += '='.repeat(4 - pad);
+    }
+    let binary = atob(normalized);
+    let bytes = Uint8Array.from(binary, c => c.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+}

package/cjs/external/index.d.ts

@@ -1,3 +1,4 @@
 export * from './browser';
 export * from './cordovaOAuthPlugin';
 export * from './cordovaInAppBrowserPlugin';
+export * from './cordovaInAppBrowserTgPlugin';

package/cjs/external/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./browser"), exports);
 __exportStar(require("./cordovaOAuthPlugin"), exports);
 __exportStar(require("./cordovaInAppBrowserPlugin"), exports);
+__exportStar(require("./cordovaInAppBrowserTgPlugin"), exports);

package/cjs/keycloak/KeycloakAuth.d.ts

@@ -5,9 +5,11 @@ export declare class KeycloakAuth<T extends KeycloakUser = KeycloakUser> extends
     protected _settings: IKeycloakAuthSettings;
     constructor(logger: ILogger, settings: IKeycloakAuthSettings, window?: Window);
     protected getBaseUrl(): string;
+    protected getLogoutRedirectUri(): string;
     popUpUrl(): string;
     getProfile(token: string): Promise<T>;
     getTokenByCode(dto: IOAuthDto, secret: string): Promise<IOAuthToken>;
+    logout(): Promise<void>;
     destroy(): void;
     get settings(): IKeycloakAuthSettings;
 }

package/cjs/keycloak/KeycloakAuth.js

@@ -25,6 +25,9 @@ class KeycloakAuth extends OAuthBase_1.OAuthBase {
     getBaseUrl() {
         return `${this.settings.url}/realms/${this.settings.realm}/protocol/openid-connect`;
     }
+    getLogoutRedirectUri() {
+        return this.getRedirectUri();
+    }
     popUpUrl() {
         return `${this.getBaseUrl()}/auth?${this.getParams().toString()}`;
     }
@@ -62,6 +65,23 @@ class KeycloakAuth extends OAuthBase_1.OAuthBase {
             };
         });
     }
+    logout() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let params = new URLSearchParams();
+            params.append('client_id', this.applicationId);
+            params.append('post_logout_redirect_uri', this.getLogoutRedirectUri());
+            let url = `${this.getBaseUrl()}/logout?${params.toString()}`;
+            let popUp = this.popUpOpener(this, this.window, url);
+            return new Promise(resolve => {
+                let timer = setInterval(() => {
+                    if (_.isNil(popUp) || popUp.closed) {
+                        clearInterval(timer);
+                        resolve();
+                    }
+                }, common_1.DateUtil.MILLISECONDS_SECOND / 5);
+            });
+        });
+    }
     destroy() {
         if (this.isDestroyed) {
             return;

package/cjs/public-api.d.ts

@@ -18,3 +18,4 @@ export * from './keycloak/KeycloakUser';
 export * from './external/browser';
 export * from './external/cordovaOAuthPlugin';
 export * from './external/cordovaInAppBrowserPlugin';
+export * from './external/cordovaInAppBrowserTgPlugin';

package/cjs/public-api.js

@@ -34,3 +34,4 @@ __exportStar(require("./keycloak/KeycloakUser"), exports);
 __exportStar(require("./external/browser"), exports);
 __exportStar(require("./external/cordovaOAuthPlugin"), exports);
 __exportStar(require("./external/cordovaInAppBrowserPlugin"), exports);
+__exportStar(require("./external/cordovaInAppBrowserTgPlugin"), exports);

package/cjs/tg/TgAuth.d.ts

@@ -8,6 +8,7 @@ export declare class TgAuth extends LoggerWrapper {
     private static urlParseHashParams;
     private static urlParseQueryString;
     private static urlSafeDecode;
+    userProvider: ITgUserProvider;
     protected promise: PromiseHandler<TgUser, ExtendedError>;
     protected settings: ITgAuthSettings;
     constructor(logger: ILogger, settings: ITgAuthSettings);
@@ -18,3 +19,4 @@ export interface ITgAuthSettings {
     api: ITgApiLoader;
     botId: number;
 }
+export type ITgUserProvider = (botId: number) => Promise<TgUser>;

package/cjs/tg/TgAuth.js

@@ -85,6 +85,18 @@ class TgAuth extends common_1.LoggerWrapper {
                 return this.promise.promise;
             }
             this.promise = common_1.PromiseHandler.create();
+            if (!_.isNil(this.userProvider)) {
+                this.userProvider(this.settings.botId)
+                    .then(user => {
+                    this.promise.resolve(user);
+                })
+                    .catch(error => {
+                    this.promise.reject(error instanceof common_1.ExtendedError ? error : new common_1.ExtendedError(error.message));
+                }).finally(() => {
+                    this.promise = null;
+                });
+                return this.promise.promise;
+            }
             this.settings.api.getApi()
                 .then(item => {
                 item.Login.auth({ bot_id: this.settings.botId }, item => {

package/cjs/vk/VkAuth.js

@@ -21,7 +21,7 @@ class VkAuth extends OAuthBase_1.OAuthBase {
         this.params.set('scope', 'status,email');
     }
     popUpUrl() {
-        return `https://oauth.vk.com/authorize?${this.getParams().toString()}`;
+        return `https://id.vk.ru/authorize?${this.getParams().toString()}`;
     }
     getProfile(token, fields) {
         return __awaiter(this, void 0, void 0, function* () {

package/esm/OAuthBase.d.ts

@@ -8,8 +8,8 @@ export declare abstract class OAuthBase<T = any> extends PopUpBase<IOAuthDto> {
     constructor(logger: ILogger, applicationId: string, window?: Window);
     protected getRedirectUri(): string;
     protected getParams(): URLSearchParams;
-    protected parseMessageData(item: any): IOAuthDto;
-    protected isMessageError(item: any): boolean;
+    protected parseMessageData(item: IOAuthPopUpDto): IOAuthDto;
+    protected isMessageError(item: IOAuthPopUpDto): boolean;
     protected parseMessageError(item: any): ExtendedError;
     abstract getProfile(token: string, ...params: any[]): Promise<T>;
     abstract getTokenByCode(dto: IOAuthDto, secret: string): Promise<IOAuthToken>;
@@ -24,6 +24,8 @@ export interface IOAuthDto {
     codeOrToken: string;
     redirectUri: string;
 }
+export interface IOAuthLogoutDto {
+}
 export interface IOAuthPopUpDto {
     oAuthError?: string;
     oAuthCodeOrToken?: string;

package/esm/PopUpBase.d.ts

@@ -38,8 +38,8 @@ export declare abstract class PopUpBase<U> extends LoggerWrapper {
     get closed(): Observable<Window>;
     get opened(): Observable<Window>;
 }
-export declare function popUpOpener<T extends PopUpBase<U>, U>(popUp: T, window: Window): Window;
-export type IPopUpOpener = <T extends PopUpBase<U>, U>(popUp: T, window: Window) => Window;
+export declare function popUpOpener<T extends PopUpBase<U>, U>(popUp: T, window: Window, url?: string): Window;
+export type IPopUpOpener = <T extends PopUpBase<U>, U>(popUp: T, window: Window, url?: string) => Window;
 export type IPopUpMessageEventParser = (event: MessageEvent) => any;
 export declare enum PopUpEvent {
     OPENED = "OPENED",

package/esm/PopUpBase.js

@@ -136,10 +136,13 @@ export class PopUpBase extends LoggerWrapper {
     }
 }
 PopUpBase.ERROR_WINDOW_CLOSED = 'WINDOW_CLOSED';
-export function popUpOpener(popUp, window) {
+export function popUpOpener(popUp, window, url) {
+    if (_.isNil(url)) {
+        url = popUp.popUpUrl();
+    }
     let top = (window.screen.height - popUp.popUpHeight) / 2;
     let left = (window.screen.width - popUp.popUpWidth) / 2;
-    return window.open(popUp.popUpUrl(), popUp.popUpTarget, `scrollbars=yes,width=${popUp.popUpWidth},height=${popUp.popUpHeight},top=${top},left=${left}`);
+    return window.open(url, popUp.popUpTarget, `scrollbars=yes,width=${popUp.popUpWidth},height=${popUp.popUpHeight},top=${top},left=${left}`);
 }
 export var PopUpEvent;
 (function (PopUpEvent) {

package/esm/external/cordovaInAppBrowserTgPlugin.d.ts

@@ -0,0 +1,8 @@
+import type { TgAuth } from '../tg/TgAuth';
+export declare const TgAuthCordovaInAppBrowserPluginPropertiesSet: (item: TgAuth, options: ITgAuthCordovaInAppBrowserOptions) => void;
+export interface ITgAuthCordovaInAppBrowserOptions {
+    origin: string;
+    returnUrl: string;
+    requestAccess?: 'write';
+    inAppBrowserOptions?: string;
+}

package/esm/external/cordovaInAppBrowserTgPlugin.js

@@ -0,0 +1,102 @@
+import { ExtendedError } from '@ts-core/common';
+import { PopUpBase } from '../PopUpBase';
+import { TgUser } from '../tg/TgUser';
+import * as _ from 'lodash';
+export const TgAuthCordovaInAppBrowserPluginPropertiesSet = (item, options) => {
+    let returnUrl = options.returnUrl;
+    let origin = options.origin;
+    let requestAccess = options.requestAccess;
+    let inAppBrowserOptions = !_.isNil(options.inAppBrowserOptions) ? options.inAppBrowserOptions : 'location=no,clearcache=yes,clearsessioncache=yes';
+    item.userProvider = (botId) => new Promise((resolve, reject) => {
+        let cordova = window['cordova'];
+        if (_.isNil(cordova) || _.isNil(cordova.InAppBrowser)) {
+            reject(new ExtendedError(`Cordova InAppBrowser undefined, please check installed plugins`));
+            return;
+        }
+        let url = `https://oauth.telegram.org/auth?bot_id=${botId}`
+            + `&origin=${encodeURIComponent(origin)}`
+            + `&return_to=${encodeURIComponent(returnUrl)}`;
+        if (!_.isNil(requestAccess)) {
+            url += `&request_access=${requestAccess}`;
+        }
+        let popUp = cordova.InAppBrowser.open(url, '_blank', inAppBrowserOptions);
+        let isSettled = false;
+        let cleanup = () => {
+            popUp.removeEventListener('loadstart', onLoad);
+            popUp.removeEventListener('loadstop', onLoad);
+            popUp.removeEventListener('exit', onExit);
+        };
+        let onLoad = (event) => {
+            if (isSettled || _.isNil(event) || _.isNil(event.url) || event.url.indexOf(returnUrl) !== 0) {
+                return;
+            }
+            let user = parseTgAuthResult(event.url);
+            if (_.isNil(user)) {
+                return;
+            }
+            isSettled = true;
+            cleanup();
+            popUp.close();
+            resolve(user);
+        };
+        let onExit = () => {
+            cleanup();
+            if (!isSettled) {
+                reject(new ExtendedError(PopUpBase.ERROR_WINDOW_CLOSED, PopUpBase.ERROR_WINDOW_CLOSED));
+            }
+        };
+        popUp.addEventListener('loadstart', onLoad, false);
+        popUp.addEventListener('loadstop', onLoad, false);
+        popUp.addEventListener('exit', onExit, false);
+    });
+};
+function parseTgAuthResult(url) {
+    let raw = null;
+    let hashIndex = url.indexOf('#');
+    if (hashIndex >= 0) {
+        let value = new URLSearchParams(url.substring(hashIndex + 1)).get('tgAuthResult');
+        if (!_.isEmpty(value)) {
+            try {
+                raw = base64UrlDecode(value);
+            }
+            catch (error) { }
+        }
+    }
+    let data = null;
+    if (!_.isNil(raw)) {
+        try {
+            data = JSON.parse(raw);
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    else {
+        let qIndex = url.indexOf('?');
+        if (qIndex < 0) {
+            return null;
+        }
+        let query = new URLSearchParams(url.substring(qIndex + 1, hashIndex >= 0 ? hashIndex : undefined));
+        if (_.isEmpty(query.get('hash'))) {
+            return null;
+        }
+        data = {};
+        query.forEach((v, k) => data[k] = v);
+    }
+    if (_.isNil(data) || _.isNil(data.hash)) {
+        return null;
+    }
+    let user = new TgUser();
+    user.parse(data);
+    return user;
+}
+function base64UrlDecode(value) {
+    let normalized = value.replace(/-/g, '+').replace(/_/g, '/');
+    let pad = normalized.length % 4;
+    if (pad !== 0) {
+        normalized += '='.repeat(4 - pad);
+    }
+    let binary = atob(normalized);
+    let bytes = Uint8Array.from(binary, c => c.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+}

package/esm/external/index.d.ts

@@ -1,3 +1,4 @@
 export * from './browser';
 export * from './cordovaOAuthPlugin';
 export * from './cordovaInAppBrowserPlugin';
+export * from './cordovaInAppBrowserTgPlugin';

package/esm/external/index.js

@@ -1,3 +1,4 @@
 export * from './browser';
 export * from './cordovaOAuthPlugin';
 export * from './cordovaInAppBrowserPlugin';
+export * from './cordovaInAppBrowserTgPlugin';

package/esm/keycloak/KeycloakAuth.d.ts

@@ -5,9 +5,11 @@ export declare class KeycloakAuth<T extends KeycloakUser = KeycloakUser> extends
     protected _settings: IKeycloakAuthSettings;
     constructor(logger: ILogger, settings: IKeycloakAuthSettings, window?: Window);
     protected getBaseUrl(): string;
+    protected getLogoutRedirectUri(): string;
     popUpUrl(): string;
     getProfile(token: string): Promise<T>;
     getTokenByCode(dto: IOAuthDto, secret: string): Promise<IOAuthToken>;
+    logout(): Promise<void>;
     destroy(): void;
     get settings(): IKeycloakAuthSettings;
 }

package/esm/keycloak/KeycloakAuth.js

@@ -7,7 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { ExtendedError, RandomUtil } from "@ts-core/common";
+import { DateUtil, ExtendedError, RandomUtil } from "@ts-core/common";
 import { OAuthBase } from "../OAuthBase";
 import { KeycloakUser } from "./KeycloakUser";
 import * as _ from 'lodash';
@@ -22,6 +22,9 @@ export class KeycloakAuth extends OAuthBase {
     getBaseUrl() {
         return `${this.settings.url}/realms/${this.settings.realm}/protocol/openid-connect`;
     }
+    getLogoutRedirectUri() {
+        return this.getRedirectUri();
+    }
     popUpUrl() {
         return `${this.getBaseUrl()}/auth?${this.getParams().toString()}`;
     }
@@ -59,6 +62,23 @@ export class KeycloakAuth extends OAuthBase {
             };
         });
     }
+    logout() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let params = new URLSearchParams();
+            params.append('client_id', this.applicationId);
+            params.append('post_logout_redirect_uri', this.getLogoutRedirectUri());
+            let url = `${this.getBaseUrl()}/logout?${params.toString()}`;
+            let popUp = this.popUpOpener(this, this.window, url);
+            return new Promise(resolve => {
+                let timer = setInterval(() => {
+                    if (_.isNil(popUp) || popUp.closed) {
+                        clearInterval(timer);
+                        resolve();
+                    }
+                }, DateUtil.MILLISECONDS_SECOND / 5);
+            });
+        });
+    }
     destroy() {
         if (this.isDestroyed) {
             return;

package/esm/public-api.d.ts

@@ -18,3 +18,4 @@ export * from './keycloak/KeycloakUser';
 export * from './external/browser';
 export * from './external/cordovaOAuthPlugin';
 export * from './external/cordovaInAppBrowserPlugin';
+export * from './external/cordovaInAppBrowserTgPlugin';

package/esm/public-api.js

@@ -18,3 +18,4 @@ export * from './keycloak/KeycloakUser';
 export * from './external/browser';
 export * from './external/cordovaOAuthPlugin';
 export * from './external/cordovaInAppBrowserPlugin';
+export * from './external/cordovaInAppBrowserTgPlugin';

package/esm/tg/TgAuth.d.ts

@@ -8,6 +8,7 @@ export declare class TgAuth extends LoggerWrapper {
     private static urlParseHashParams;
     private static urlParseQueryString;
     private static urlSafeDecode;
+    userProvider: ITgUserProvider;
     protected promise: PromiseHandler<TgUser, ExtendedError>;
     protected settings: ITgAuthSettings;
     constructor(logger: ILogger, settings: ITgAuthSettings);
@@ -18,3 +19,4 @@ export interface ITgAuthSettings {
     api: ITgApiLoader;
     botId: number;
 }
+export type ITgUserProvider = (botId: number) => Promise<TgUser>;

package/esm/tg/TgAuth.js

@@ -82,6 +82,18 @@ export class TgAuth extends LoggerWrapper {
                 return this.promise.promise;
             }
             this.promise = PromiseHandler.create();
+            if (!_.isNil(this.userProvider)) {
+                this.userProvider(this.settings.botId)
+                    .then(user => {
+                    this.promise.resolve(user);
+                })
+                    .catch(error => {
+                    this.promise.reject(error instanceof ExtendedError ? error : new ExtendedError(error.message));
+                }).finally(() => {
+                    this.promise = null;
+                });
+                return this.promise.promise;
+            }
             this.settings.api.getApi()
                 .then(item => {
                 item.Login.auth({ bot_id: this.settings.botId }, item => {

package/esm/vk/VkAuth.js

@@ -18,7 +18,7 @@ export class VkAuth extends OAuthBase {
         this.params.set('scope', 'status,email');
     }
     popUpUrl() {
-        return `https://oauth.vk.com/authorize?${this.getParams().toString()}`;
+        return `https://id.vk.ru/authorize?${this.getParams().toString()}`;
     }
     getProfile(token, fields) {
         return __awaiter(this, void 0, void 0, function* () {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ts-core/oauth",
-    "version": "3.1.16",
+    "version": "3.1.18",
     "description": "Classes and utils for oauth",
     "main": "./cjs/public-api.js",
     "module": "./esm/public-api.js",