@ts-core/oauth 3.1.18 → 3.1.20

package/README.md

@@ -176,7 +176,7 @@ console.log(user.name, user.telegram);
 | Яндекс | `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 |
+| Telegram | `TgAuth` | `TgUser` | Web App + Login Widget + Cordova |
 
 ---
 
@@ -336,25 +336,49 @@ interface ITgAuthSettings {
 
 ### Cordova OAuth Plugin
 
+Требуется `cordova-plugin-oauth`. Redirect URI выставляется в `<packageName>://oauth_callback`.
+
 ```typescript
-import { CordovaOAuthPluginPropertiesSet } from '@ts-core/oauth';
+import { OAuthCordovaOAuthPluginPropertiesSet } from '@ts-core/oauth';
 
 const auth = new GoAuth(logger, 'CLIENT_ID');
-CordovaOAuthPluginPropertiesSet(auth);
+OAuthCordovaOAuthPluginPropertiesSet(auth, 'com.example.app');
 ```
 
 ### Cordova InAppBrowser
 
+Требуется `cordova-plugin-inappbrowser`. Когда InAppBrowser доходит до `redirectUri`, вызывается переданный метод: он по `state` забирает с бэкенда результат авторизации.
+
 ```typescript
-import { CordovaInAppBrowserPluginPropertiesSet } from '@ts-core/oauth';
+import { OAuthCordovaInAppBrowserPluginPropertiesSet } from '@ts-core/oauth';
 
 const auth = new GoAuth(logger, 'CLIENT_ID');
-CordovaInAppBrowserPluginPropertiesSet(auth, async (url) => {
-    // Ваша логика получения токена по URL
-    return { codeOrToken: 'token', redirectUri: 'uri' };
+OAuthCordovaInAppBrowserPluginPropertiesSet(auth, 'https://myapp.com/oauth', async (state) => {
+    // Получить сохранённый бэкендом результат для state
+    return { oAuthCodeOrToken: 'code' };
 });
 ```
 
+### Telegram Login в Cordova (InAppBrowser)
+
+Виджет Telegram внутри Cordova не работает, поэтому `TgAuth` открывает `oauth.telegram.org/auth` в InAppBrowser. Как только браузер переходит на `returnUrl`, из `#tgAuthResult` или query-параметров собирается `TgUser`, окно закрывается. Если пользователь закрыл окно сам, `getUser()` отклоняется с `ERROR_WINDOW_CLOSED`.
+
+Требуется `cordova-plugin-inappbrowser`. Домен из `origin` должен быть привязан к боту через `/setdomain` в @BotFather.
+
+```typescript
+import { TgAuth, TgApiLoader, TgAuthCordovaInAppBrowserPluginPropertiesSet } from '@ts-core/oauth';
+
+const auth = new TgAuth(logger, { api: new TgApiLoader(logger), botId: YOUR_BOT_ID });
+TgAuthCordovaInAppBrowserPluginPropertiesSet(auth, {
+    origin: 'https://myapp.com',             // Домен, привязанный к боту
+    returnUrl: 'https://myapp.com/oauth',    // Куда Telegram вернёт пользователя
+    requestAccess: 'write',                  // Необязательно: разрешение писать пользователю
+    // inAppBrowserOptions: 'location=no'    // Необязательно: опции InAppBrowser
+});
+
+const user = await auth.getUser();
+```
+
 ---
 
 ## Расширенные возможности
@@ -413,7 +437,8 @@ src/
 ├── external/             # Платформенные интеграции
 │   ├── browser.ts
 │   ├── cordovaOAuthPlugin.ts
-│   └── cordovaInAppBrowserPlugin.ts
+│   ├── cordovaInAppBrowserPlugin.ts
+│   └── cordovaInAppBrowserTgPlugin.ts
 ├── go/                   # Google
 ├── vk/                   # VK
 ├── ya/                   # Яндекс

package/cjs/vk/VkAuth.js

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

package/esm/vk/VkAuth.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ts-core/oauth",
-    "version": "3.1.18",
-    "description": "Classes and utils for oauth",
+    "version": "3.1.20",
+    "description": "TypeScript library for OAuth authentication through Google, VK, Yandex, Mail.ru, Keycloak and Telegram, supporting browser, Cordova and Telegram Web App platforms",
     "main": "./cjs/public-api.js",
     "module": "./esm/public-api.js",
     "exports": {
@@ -28,7 +28,20 @@
         "url": "git+https://github.com/ManhattanDoctor/ts-core-oauth.git"
     },
     "keywords": [
-        "typescript"
+        "typescript",
+        "oauth",
+        "oauth2",
+        "authentication",
+        "authorization",
+        "google",
+        "vk",
+        "yandex",
+        "mailru",
+        "keycloak",
+        "telegram",
+        "cordova",
+        "login",
+        "sso"
     ],
     "bugs": {
         "url": "https://github.com/ManhattanDoctor/ts-core-oauth/issues"