@skroz/profile-api 1.0.21 → 1.0.24

package/README.md

@@ -0,0 +1,197 @@
+# @skroz/profile-api
+
+GraphQL-резолверы и сервисы для аутентификации пользователей. Построена на type-graphql + TypeORM + Redis.
+
+## Архитектура
+
+Библиотека предоставляет **фабрики резолверов** — функции, которые принимают зависимости и возвращают класс резолвера для регистрации в GraphQL-схеме. Это позволяет переиспользовать логику в разных приложениях с разными User-сущностями.
+
+## Билд
+
+```bash
+cd libs/utils/packages/profile-api
+yarn build
+```
+
+## Экспорты
+
+### Типы
+
+- **`AuthUser`** — интерфейс пользователя: `id`, `email`, `name`, `avatar`, `password`, `isEmailConfirmed`, `isBanned`, `isTempPassword`, `urlSlug`, `telegramId`, `isEmailNotificationEnabled`, `isTelegramNotificationEnabled`, `lastSeenAt`, `save()`
+- **`ProfileDbAdapter`** — интерфейс БД-адаптера, который нужно реализовать: `findUserByEmail`, `findUserById`, `findUserByTelegramId`, `createUser`, `isEmailTaken`, `findUserByProviderId`, `updateUserProviderId`
+- **`ProfileAuthConfig`** — конфиг токенов/лимитов: `resendEmailLimitSeconds`, `confirmationTokenLifetimeMinutes`, `recoveryTokenLifetimeMinutes`
+- **`EmailConfig`** — extends ProfileAuthConfig + настройки email: `domain`, `websiteUrl`, `primaryBrandColor`, `logoUrl`, `fromEmailUsername`, `templateDir`, `isOnlineSeconds`, `isOnlineRecentlySeconds`
+- **`ProfileEmailTemplate`** — enum шаблонов писем: `CONFIRM_EMAIL`, `FORGOT_PASSWORD`, `TEMP_PASSWORD`, `GENERIC_NOTIFICATION`
+- **`ProfileLocales`** — структура переводов для auth-ошибок и email-шаблонов
+- **`ProfileContext<TUser>`** — GraphQL-контекст: `user?`, `req`, `res`, `t`
+
+### TypeOrmProfileAdapter
+
+Готовая реализация `ProfileDbAdapter` поверх TypeORM.
+
+```ts
+import { TypeOrmProfileAdapter } from '@skroz/profile-api';
+
+const db = new TypeOrmProfileAdapter(() =>
+  getConnection().getRepository(User)
+);
+```
+
+Провайдер-ID ищет по полю `${provider}Id` (т.е. `googleId`, `vkId`, `telegramId` и т.д.) — эти поля должны быть в сущности User.
+
+### TypeOrmBaseUser
+
+Базовая TypeORM-сущность со всеми полями `AuthUser`. Можно наследовать:
+
+```ts
+import { TypeOrmBaseUser } from '@skroz/profile-api';
+
+@Entity()
+export class User extends TypeOrmBaseUser {
+  // дополнительные поля
+}
+```
+
+### ProfileAuthService
+
+Основной сервис. Принимает `(db, email, redis, config)`.
+
+```ts
+import { ProfileAuthService } from '@skroz/profile-api';
+
+const authService = new ProfileAuthService(db, emailService, redis, {
+  resendEmailLimitSeconds: 60,
+  confirmationTokenLifetimeMinutes: 60,
+  recoveryTokenLifetimeMinutes: 30,
+});
+```
+
+Публичные поля: `db`, `email`, `redis`, `config`.
+Методы: `hashPassword`, `verifyPassword`, `setTokenToRedis`, `removeTokenFromRedis`, `getUserByToken`, `sendLink`.
+
+### ProfileEmailService
+
+Отправка писем (confirm email, forgot password, temp password). Передаётся в `ProfileAuthService`.
+
+---
+
+## Резолверы
+
+Все резолверы создаются через фабричные функции. `authService` в deps может быть как экземпляром, так и функцией `(ctx) => ProfileAuthService` (для per-request сервисов).
+
+### createAuthResolver(deps)
+
+Auth-мутации: `register`, `login`, `logout`, `confirmEmail`, `sendToken`, `recoverPassword`.
+
+```ts
+import { createAuthResolver } from '@skroz/profile-api';
+
+const AuthResolver = createAuthResolver({
+  authService,           // ProfileAuthService | (ctx) => ProfileAuthService
+  userType: User,        // GraphQL ObjectType
+  onUserCreated: async (user, ctx) => { /* ... */ },
+  onLogin: async (user, ctx) => { /* ... */ },
+  onLogout: async (user, ctx) => { /* ... */ },
+  onEmailConfirmed: async (user, ctx) => { /* ... */ },
+  onPasswordRecovered: async (user, ctx) => { /* ... */ },
+  logTelegramBot: { sendError: async (msg) => { /* ... */ } },
+});
+```
+
+### createProfileResolver(deps)
+
+Мутации профиля (только для авторизованных): `updateEmail`, `updatePassword`, `updateProfile`, `toggleEmailNotification`.
+
+```ts
+import { createProfileResolver } from '@skroz/profile-api';
+
+const ProfileResolver = createProfileResolver({ authService, userType: User });
+```
+
+### createOauthResolver(deps)
+
+OAuth-авторизация и вход через Telegram-бот.
+
+Мутации:
+- `oauthLogin(input: OauthLoginInput)` — вход через Google/VK/Яндекс/Mail/Apple/Telegram-виджет
+- `generateTelegramAuthToken` → `{ token, url }` — генерирует токен и deep link для бота
+- `confirmTelegramAuthToken(token)` → `{ confirmed, expired }` — polling со стороны фронта
+
+```ts
+import { createOauthResolver, GoogleOauth, VKOauth } from '@skroz/profile-api';
+
+const OauthResolver = createOauthResolver({
+  authService,
+  userType: User,
+  providers: {
+    google: new GoogleOauth(clientId, clientSecret, redirectUri),
+    vk: new VKOauth(clientId, clientSecret, redirectUri),
+    // ya, mail, apple — аналогично
+  },
+  telegramBotToken: process.env.TELEGRAM_BOT_TOKEN, // для Telegram Login Widget
+  telegramBotName: 'MyBot',  // имя бота без @, для deep link авторизации
+  redis: getRedis(),          // клиент с методами get/setex/del
+  onUserCreated: async (user, ctx) => { /* ... */ },
+  onLogin: async (user, ctx) => { /* ... */ },
+});
+```
+
+---
+
+## confirmTelegramBotAuth
+
+Вспомогательная функция для **Telegram-бота** (не для GraphQL-резолвера).
+
+Когда пользователь переходит по deep link `/start tgauth_<token>`, бот вызывает эту функцию — она записывает `telegramUserId` в Redis, и фронт получает `confirmed: true` при следующем polling.
+
+```ts
+import { confirmTelegramBotAuth } from '@skroz/profile-api';
+
+// В обработчике команды /start в Telegram-боте:
+if (text.startsWith('/start tgauth_')) {
+  const token = text.replace('/start tgauth_', '');
+  const confirmed = await confirmTelegramBotAuth(redis, token, user.id);
+  if (confirmed) {
+    // отправить пользователю сообщение об успешной авторизации
+  }
+}
+```
+
+Возвращает `true` если токен найден и подтверждён, `false` если истёк или не существует.
+Использует тот же Redis-префикс (`skroz:profile:tgbotauth`) и TTL (300 сек), что и `generateTelegramAuthToken`.
+
+---
+
+## OAuth-провайдеры
+
+```ts
+import { GoogleOauth, VKOauth, YandexOauth, MailOauth, AppleOauth } from '@skroz/profile-api';
+```
+
+Каждый провайдер реализует интерфейс `OAuthProvider`:
+
+```ts
+interface OAuthProvider {
+  exchangeCode(code: string): Promise<OAuthProfile>;
+  readonly trustedEmail: boolean; // true = email верифицирован провайдером
+}
+
+interface OAuthProfile {
+  providerId: string;
+  email?: string | null;
+  name?: string | null;
+  avatarUrl?: string | null;
+}
+```
+
+`trustedEmail: true` у Google, VK, Яндекс, Mail, Apple — при входе через них `isEmailConfirmed` и `isEmailNotificationEnabled` автоматически выставляются в `true`.
+
+---
+
+## DTO
+
+GraphQL input/output классы для использования в схеме:
+
+`AuthInput`, `UpdateEmailInput`, `UpdatePasswordInput`, `UpdateProfileInput`,
+`ConfirmEmailInput`, `RecoverPasswordInput`, `SendTokenInput`, `SendTokenPayload`,
+`OauthLoginInput`, `TelegramAuthData`

package/dist/entities/TypeOrmBaseEntity.d.ts

@@ -0,0 +1,6 @@
+import { BaseEntity as TypeORMBaseEntity } from 'typeorm';
+export declare abstract class TypeOrmBaseEntity extends TypeORMBaseEntity {
+    id: number;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/entities/TypeOrmBaseEntity.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeOrmBaseEntity = void 0;
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+let TypeOrmBaseEntity = class TypeOrmBaseEntity extends typeorm_1.BaseEntity {
+};
+exports.TypeOrmBaseEntity = TypeOrmBaseEntity;
+__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.ID),
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], TypeOrmBaseEntity.prototype, "id", void 0);
+__decorate([
+    (0, type_graphql_1.Field)(),
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], TypeOrmBaseEntity.prototype, "createdAt", void 0);
+__decorate([
+    (0, type_graphql_1.Field)(),
+    (0, typeorm_1.UpdateDateColumn)({ type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], TypeOrmBaseEntity.prototype, "updatedAt", void 0);
+exports.TypeOrmBaseEntity = TypeOrmBaseEntity = __decorate([
+    (0, type_graphql_1.ObjectType)({ isAbstract: true })
+], TypeOrmBaseEntity);

package/dist/entities/TypeOrmBaseUser.d.ts

@@ -1,12 +1,9 @@
-import { BaseEntity as TypeORMBaseEntity } from 'typeorm';
-export declare abstract class TypeOrmBaseUser extends TypeORMBaseEntity {
+import { TypeOrmBaseEntity } from './TypeOrmBaseEntity';
+export declare abstract class TypeOrmBaseUser extends TypeOrmBaseEntity {
     static config: {
         isOnlineSeconds: number;
         isOnlineRecentlySeconds: number;
     };
-    id: number;
-    createdAt: Date;
-    updatedAt: Date;
     email: string | null;
     password: string;
     isTempPassword: boolean;

package/dist/entities/TypeOrmBaseUser.js

@@ -13,7 +13,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypeOrmBaseUser = void 0;
 const typeorm_1 = require("typeorm");
 const type_graphql_1 = require("type-graphql");
-let TypeOrmBaseUser = TypeOrmBaseUser_1 = class TypeOrmBaseUser extends typeorm_1.BaseEntity {
+const TypeOrmBaseEntity_1 = require("./TypeOrmBaseEntity");
+let TypeOrmBaseUser = TypeOrmBaseUser_1 = class TypeOrmBaseUser extends TypeOrmBaseEntity_1.TypeOrmBaseEntity {
     checkOnline(seconds) {
         if (!this.lastSeenAt)
             return false;
@@ -33,21 +34,6 @@ TypeOrmBaseUser.config = {
     isOnlineSeconds: 60,
     isOnlineRecentlySeconds: 300,
 };
-__decorate([
-    (0, type_graphql_1.Field)(() => type_graphql_1.ID),
-    (0, typeorm_1.PrimaryGeneratedColumn)(),
-    __metadata("design:type", Number)
-], TypeOrmBaseUser.prototype, "id", void 0);
-__decorate([
-    (0, type_graphql_1.Field)(() => type_graphql_1.GraphQLTimestamp),
-    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
-    __metadata("design:type", Date)
-], TypeOrmBaseUser.prototype, "createdAt", void 0);
-__decorate([
-    (0, type_graphql_1.Field)(() => type_graphql_1.GraphQLTimestamp),
-    (0, typeorm_1.UpdateDateColumn)({ type: 'timestamptz' }),
-    __metadata("design:type", Date)
-], TypeOrmBaseUser.prototype, "updatedAt", void 0);
 __decorate([
     (0, typeorm_1.Column)({ type: 'varchar', nullable: true, unique: true }),
     __metadata("design:type", Object)

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './types';
 export * from './adapters/TypeOrmProfileAdapter';
+export * from './entities/TypeOrmBaseEntity';
 export * from './entities/TypeOrmBaseUser';
 export * from './services/ProfileAuthService';
 export * from './services/ProfileEmailService';

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
 __exportStar(require("./adapters/TypeOrmProfileAdapter"), exports);
+__exportStar(require("./entities/TypeOrmBaseEntity"), exports);
 __exportStar(require("./entities/TypeOrmBaseUser"), exports);
 __exportStar(require("./services/ProfileAuthService"), exports);
 __exportStar(require("./services/ProfileEmailService"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skroz/profile-api",
-  "version": "1.0.21",
+  "version": "1.0.24",
   "license": "MIT",
   "repository": "git@gitlab.com:skroz/libs/utils.git",
   "main": "dist/index.js",
@@ -44,5 +44,5 @@
     "type-graphql": "^1.1.1",
     "typeorm": "^0.2.45"
   },
-  "gitHead": "4d48bd69998725da84ce966a6ab383fb5eb208cc"
+  "gitHead": "b3531fbaf9016d5f69ec9a0d55dd789635c276aa"
 }

package/src/entities/TypeOrmBaseEntity.ts

@@ -0,0 +1,22 @@
+import {
+    BaseEntity as TypeORMBaseEntity,
+    CreateDateColumn,
+    PrimaryGeneratedColumn,
+    UpdateDateColumn,
+} from 'typeorm';
+import { Field, ID, ObjectType } from 'type-graphql';
+
+@ObjectType({ isAbstract: true })
+export abstract class TypeOrmBaseEntity extends TypeORMBaseEntity {
+    @Field(() => ID)
+    @PrimaryGeneratedColumn()
+    public id!: number;
+
+    @Field()
+    @CreateDateColumn({ type: 'timestamptz' })
+    public createdAt!: Date;
+
+    @Field()
+    @UpdateDateColumn({ type: 'timestamptz' })
+    public updatedAt!: Date;
+}

package/src/entities/TypeOrmBaseUser.ts

@@ -1,31 +1,14 @@
-import {
-    Column,
-    CreateDateColumn,
-    PrimaryGeneratedColumn,
-    UpdateDateColumn,
-    BaseEntity as TypeORMBaseEntity,
-} from 'typeorm';
-import { Field, ID, ObjectType, GraphQLTimestamp } from 'type-graphql';
+import { Column } from 'typeorm';
+import { Field, ObjectType, GraphQLTimestamp } from 'type-graphql';
+import { TypeOrmBaseEntity } from './TypeOrmBaseEntity';
 
 @ObjectType({ isAbstract: true })
-export abstract class TypeOrmBaseUser extends TypeORMBaseEntity {
+export abstract class TypeOrmBaseUser extends TypeOrmBaseEntity {
     public static config = {
         isOnlineSeconds: 60,
         isOnlineRecentlySeconds: 300,
     };
 
-    @Field(() => ID)
-    @PrimaryGeneratedColumn()
-    public id!: number;
-
-    @Field(() => GraphQLTimestamp)
-    @CreateDateColumn({ type: 'timestamptz' })
-    public createdAt!: Date;
-
-    @Field(() => GraphQLTimestamp)
-    @UpdateDateColumn({ type: 'timestamptz' })
-    public updatedAt!: Date;
-
     @Column({ type: 'varchar', nullable: true, unique: true })
     public email!: string | null;
 

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from './types';
 export * from './adapters/TypeOrmProfileAdapter';
+export * from './entities/TypeOrmBaseEntity';
 export * from './entities/TypeOrmBaseUser';
 export * from './services/ProfileAuthService';
 export * from './services/ProfileEmailService';