# на сервере
npm install --save typedapi-core typedapi-server typedapi-server-ws
npm install --save-dev typedapi-parser
# на клиенте
npm install --save typedapi-core typedapi-client typedapi-client-browser-ws

# for server
npm install --save typedapi-core typedapi-server
npm install --save-dev typedapi-parser
# for client
npm install --save typedapi-core typedapi-client typedapi-client-browser-http

export class Api {
    async hello(name: string): Promise<string> {
        return `Hello, ${name}!`
    }
}

typedapi-parse [sourceFilename] [sourceObjectName] [outFilename] [reflectionOutFileName]

import { WebSocketServer } from "typedapi-server-ws"
import { buildMap } from "typedapi-server"
// файл, сгенерированный командой typedapi-parse для сервера
import { reflection } from "./apiReflection"
// Ваш API класс
import { Api } from "./Api"
new WebSocketServer({
    apiMap: buildMap(reflection, new Api),
    port: 8090
})

import { WebSocketTransport } from "typedapi-client-browser-ws"
// файл, сгенерированный командой typedapi-parse для клиента
import { createClient } from "./apiReflection"
const api = createClient({ transport })
// теперь можно вызывать методы API
let result = await api.hello(name)

import { Event } from "typedapi-server"
export class Api {
    someEvent = new Event<string>()
}
// отправляем событие всем продписчикам
api.someEvent.fire(data)
// отправляем событие одному пользователю
api.someEvent.fireForUser(data, userId)
// Отправляем группе пользователей
api.someEvent.fireForGroup(data, groupName)
// отправляем конкретной сессии
api.someEvent.fireForSession(data, sessionId)
// Отправялем конкретному соединению
api.someEvent.fireForConnection(data, connectionId)

// Подписываемся на событие
const subscription = await api.someEvent.subscribe(data => {
    // обработка события
})
// Отписка
await subscription.unsubscribe()

type AuthDataResponse = {
    newAuthData: {
        id?: string | number
        groups?: string[]
        name?: string
        email?: string
        phone?: string
    }
    // ответ, который будет отправлен пользователю
    // newAuthData используется только для внутренних нужд
    response: boolean
}

import { AuthDataResponse } from "typedapi-server"
export class ClientApi {
    /**
     * Проверяем логин и пароль, если подходит авторизуем
    **/
    async login(username: string, password: string): Promise<AuthDataResponse> {
        let user = await usersRepository.login(username, password)
        if(!user) {
            return {
                response: false,
                newAuthData: {}
            }
        } else {
            return {
                response: true,
                newAuthData: {
                    id: user.id,
                    groups: user.groups
                }
            }
        }
    }
    /**
    * Logout
    **/
    async logout(): Promise<AuthDataResponse> {
        return {
            response: true,
            newAuthData: {}
        }
    }
    /**
    * в apiUserID будет автоматически добавлен идентификатор пользователя.
    * Если пользватель не авторизован, он получит NotAuthorizedError
    **/
    async getUserData(apiUserId: number): Promise<SomeUserData> {
        let userData = await usersRespotory.getUserData(apiUserId)
        return userData
    }
}