@foxford/sdk 8.0.1 → 8.1.1

package/plugins/types-sRHKQ8xU.d.cts

@@ -0,0 +1,1269 @@
+import { ApiInstance, ApiConfig, CaptchaConfig, ApiResponse, ApiService, CaptchaService } from '@foxford/services';
+import { BusinessUnitAbbreviation, CartItemResourceType, Course } from '@foxford/types';
+
+interface FoxfordAntibotConfig {
+    antibotFrameSrc?: string;
+    antibotOnload?: (e: Event) => void;
+    antibotOnerror?: () => void;
+    debug?: boolean;
+}
+
+type Widget = {
+    name: 'menu' | 'reviews' | 'featuredCoaches' | 'coachEnrollment' | 'shortForm' | 'userTypePrompt' | 'teachersSlider' | 'externshipFormats';
+    options: Record<string, any>;
+    container?: HTMLElement;
+};
+type WidgetsInitConfig = {
+    version?: 'latest' | string;
+    locale?: 'ru';
+};
+interface WidgetsConfig extends WidgetsInitConfig {
+    analyticContext?: {
+        prefix: string;
+        module: string;
+        payload?: Record<any, any>;
+    };
+    rootColors?: boolean;
+    loadFonts?: boolean;
+    widgets: Array<Widget>;
+}
+declare class Widgets {
+    private config;
+    private api;
+    private manifest;
+    static ENTRY: string[];
+    static DEFAULT_CONFIG: WidgetsInitConfig;
+    constructor(config: WidgetsInitConfig | undefined, apiInstance: ApiInstance);
+    create(config: WidgetsConfig): Promise<void>;
+    update(name: string, config: Widget): Promise<void>;
+    private loadManifest;
+    static appendScript(src: string): Promise<unknown>;
+    private loadAssets;
+}
+
+type ProductTypeItem = {
+    type: string;
+    id: number;
+    description: string;
+    title: string;
+    discipline: {
+        id: number;
+        name: string;
+    };
+    teacher: {
+        id: number;
+        long_name: string;
+        description: string;
+        experience: number;
+        photo_url: string;
+        photo_large_url: string;
+    };
+    levels: Array<{
+        id: number;
+        name: string;
+    }>;
+};
+type ProductPack = {
+    name: string;
+    description: string;
+    meta_title: string;
+    meta_description: string;
+    published: true;
+    content_description: string;
+    disciplines_scope: string;
+    guaranteed_admission: true;
+    grade_names: string;
+    is_purchased: false;
+    learning_flow: {
+        title: string;
+        steps: Array<{
+            header: string;
+            description: string;
+        }>;
+    };
+    offers: {
+        intro: string;
+        items: Array<{
+            title: string;
+            description: string;
+        }>;
+    };
+    price_block: {
+        price: number;
+        initial_price: number;
+        title: string;
+        description: string;
+        points: Array<string>;
+        price_per_month: number;
+        initial_price_per_month: number;
+    };
+    product_pack_items: Array<ProductTypeItem>;
+    faq_items: Array<{
+        question: string;
+        answer: string;
+    }>;
+    landing_image_urls: Array<string>;
+};
+interface CartItemDTO {
+    cart_item_type: CartItemResourceType;
+    resource_id: number;
+}
+type FoxfordConfig = {
+    host?: string;
+    /** @deprecated */
+    widgetsVersion?: 'latest' | string;
+    antibot?: boolean;
+    antibotConfig?: FoxfordAntibotConfig;
+    api?: ApiConfig;
+    captchaConfig?: () => CaptchaConfig;
+    /** @deprecated Не используйте инициализацию виджетов через SDK */
+    widgetsConfig?: WidgetsInitConfig;
+};
+type Reasons = 'additional_education_free_period_started' | 'announcement_clicked' | 'catalog_filtered' | 'coach_intro_lesson_scheduled' | 'coach_landing_visited' | 'course_conspect_visited' | 'course_landing_visited' | 'event_scheduled' | 'event_visited' | 'exam_rehearsal_page_visited' | 'exam_rehearsal_passed' | 'externship_contract_draft_created' | 'externship_demo_access' | 'externship_iep_selected' | 'externship_intendance_expressed' | 'interactive_training_course_visited' | 'externship_landing_visited' | 'externship_lead_request' | 'mini_group_landing_visited' | 'olympiad_page_visited' | 'onboarding' | 'onboarding_finished' | 'product_pack_landing_visited' | 'promos_coach_recommendation_clicked' | 'promos_course_recommendation_clicked' | 'promos_results_filtered' | 'subscription_landing_visited' | 'teacher_course_visited' | 'training_page_visited' | 'training_passed' | 'wiki_visited' | 'project_landing_cta_clicked';
+type ProductFormats = 'coach_course' | 'course' | 'event' | 'exam_rehearsal' | 'externship' | 'game' | 'interactive_trainings' | 'mini_group' | 'olympiad' | 'product_pack' | 'teacher_course' | 'trainings';
+type UserInterests = {
+    businessUnitAbbrs?: BusinessUnitAbbreviation[] | null;
+    disciplineId?: number | number[] | null;
+    gradeId?: number | number[] | null;
+    levelId?: number | number[] | null;
+    productId?: number | null;
+    productFormat?: ProductFormats | null;
+    reason?: Reasons | null;
+};
+interface CommunicationSubscriptions {
+    subscriptionNews?: boolean;
+    subscriptionMaterials?: boolean;
+    subscriptionEvents?: boolean;
+    subscriptionPromos?: boolean;
+    subscriptionReminders?: boolean;
+    subscriptionMedia?: boolean;
+    subscriptionExternship?: boolean;
+    subscriptionExternal?: boolean;
+}
+interface LoginByPhoneParams {
+    onEmailRequest: (phoneCheckResponse: {
+        email?: string;
+        fakeEmail?: boolean;
+        state: 'new' | 'confirmed' | 'not_confirmed';
+    }) => Promise<string>;
+    onCodeRequest: () => Promise<string>;
+    onNameRequest: () => Promise<{
+        first_name: string;
+        last_name: string;
+    }>;
+    onConfirmationCodeResponse: (confirmationCodeResponse: {
+        nextDeliveryAt: string;
+    }) => void;
+    onConfirmationCodeError: (error: Error) => void;
+}
+interface LoginOrRegistrationResponse {
+    redirectUrl?: string;
+    registered?: boolean;
+    type?: string;
+}
+
+type PupilRole = '11 класс' | '10 класс' | '9 класс' | '8 класс' | '7 класс' | '6 класс' | '5 класс' | '4 класс' | '3 класс' | '2 класс' | '1 класс';
+type UserRole = 'Ученик' | 'Репетитор' | 'Учитель' | 'Родитель' | 'Выпускник' | 'Дошкольник' | PupilRole;
+type LeaderboardAccessState = 'unavailable' | 'available' | 'vacation' | 'disabled';
+type LeaderboardReadinessState = 'changeable_course_selection' | 'ready' | 'unready' | 'waiting_course_selection';
+type LearningGoalsAccessState = 'enabled' | 'disabled' | 'optional' | 'required';
+interface UserDTO {
+    id: null | number;
+    email: string;
+    firstName: string;
+    middleName: string;
+    lastName: string;
+    fullName: string;
+    shortName: string;
+    createdAt: null | string;
+    timezone: null | string;
+    locale: null | string;
+    grade: {
+        id: null | number;
+        index: null | number;
+        name: null | string;
+        translit: null | string;
+    };
+    phone: null | string;
+    avatarUrl: string;
+    isParent: boolean;
+    isGraduated: boolean;
+    gradeChecked: boolean;
+    type: null | 'pupil' | 'agent';
+    isCoach: boolean;
+    isMiniGroupTeacher: boolean;
+    isExternshipCoach: boolean;
+    isAgent: boolean;
+    methodist: boolean;
+    address: {
+        index: null | string;
+        countryId: null | number;
+        countryName: null | string;
+        regionId: null | number;
+        regionName: null | string;
+        cityId: null | number;
+        cityName: null | string;
+        street: null | string;
+        house: null | string;
+        building: null | string;
+        room: null | string;
+    } | null;
+    socialNets: Array<{
+        provider: 'facebook' | 'google_oauth2' | 'mailru_oauth2' | 'odnoklassniki' | 'vkontakte' | 'yandex';
+        uid: number;
+    }>;
+    skype: null | string;
+    settings?: {
+        calendarUserExperienceFeedback?: boolean;
+        elementaryDashboardUserExperienceFeedback?: boolean;
+        homeSchoolFamilyEducationGuideHidden?: boolean;
+        pageBonusesVisited?: boolean;
+        pageDashboardPaymentsVisited?: boolean;
+        pageSocializationLandingVisited?: boolean;
+        pageSocializationVisited?: boolean;
+        supportButtonIndicatorHidden?: boolean;
+    };
+    bonus: {
+        giftAmount: number;
+        realMoneyAmount: number;
+    };
+    bonusAmount: number;
+    hasActivePurchases: boolean;
+    hasAttemptsSolveExamRehearsals: boolean;
+    hasBookmarks: boolean;
+    tags: null | string[];
+    cartTemplateId: null | number;
+    cartItemsCount: number;
+    onboardingFinished: boolean;
+    onboardingFinishedAt: null | string;
+    emailConfirmed: boolean;
+    phoneConfirmed: boolean;
+    fakeEmail: boolean;
+    fakeUser: boolean;
+    profileEnriched: boolean;
+    recapUuid: string | null;
+    disciplineIds: number[];
+    privacy: {
+        publicProfile: boolean;
+    };
+    parentPhone: null | string;
+    parentPhoneConfirmed: boolean;
+    isCustomer: null | boolean;
+    hasAccessToMultiDaysStreaks: boolean;
+    isElementaryPupil: boolean;
+    webSocketNotificationsJwt: null | string;
+    hasAccessToAttestationSheets: boolean;
+    externshipUser: boolean;
+    hasPurchasedExternshipContracts: boolean;
+    hasExternshipAttestationAccess: boolean;
+    appearanceId?: null | number;
+    hasUnseenRoomFeatures?: boolean;
+    unconfirmedEmail?: null | string;
+    socializationProfile: {
+        id: number;
+        state: 'active' | 'draft' | 'banned';
+    } | null;
+    freeAccessFinishesAt: null | string;
+    purchaseAnyExternshipContracts: boolean;
+    hasExternshipRelation?: boolean;
+    hasExternshipActiveContract?: boolean;
+    canProlongateContract?: boolean;
+    /** Окно пролонгации договора домашней школы: даты, скидка и заголовок следующего года. */
+    prolongation?: {
+        dailyPlanBannerText?: string;
+        endsAt: null | string;
+        maxDiscount: number;
+        prolongationMenuTitleOn: boolean;
+        startsAt: null | string;
+        yearName: string;
+    } | null;
+    /** Текущий интерес посетителя — та же форма, что у `GET /api/user/user_interest`, но из профиля. */
+    currentInterest: UserInterests | null;
+    /** До какой даты открыт приём в домашнюю школу. */
+    admissionFinishesOn: null | string;
+    /** Посетитель пришёл из Алгоритмики. */
+    algoritmika: boolean;
+    bonusesPageVisited: boolean;
+    canChangeSchoolInfo: boolean;
+    externshipDemoAccessActive: boolean;
+    /** Экстернат ждёт оплаты: когда закроется доступ и по какому договору. */
+    externshipPaymentRequired: {
+        accessClosingDate: string;
+        contractId: number;
+    } | null;
+    externshipPromoHeaderOn: boolean;
+    hasExamProgressAccess: boolean;
+    hasYearlyRecapAccess: boolean;
+    isAttestationSchoolManager: null | boolean;
+    isMentor: boolean;
+    isXpStreakAvailable: boolean;
+    leaderboard: {
+        accessState: LeaderboardAccessState;
+        readinessState: LeaderboardReadinessState;
+    } | null;
+    leaderboardAccessState: LeaderboardAccessState;
+    learningGoalsAccessState: LearningGoalsAccessState;
+    /** Мессенджеры, на которые подписан посетитель; `null` — бэкенд не считал. */
+    messengerSubscriptions: null | string[];
+    needToPromoteRenewalWithCoach: boolean;
+    nextYearCoursesBannerAvailable: boolean;
+    passwordSet: null | boolean;
+    referralCode: null | string;
+    targetActionsOnboardingAvailable: boolean;
+}
+
+declare class User {
+    private readonly props;
+    private readonly isDefault;
+    private constructor();
+    /**
+     * Идентификатор посетителя на бэкенде.
+     *
+     * @returns Число либо `null` у гостя.
+     */
+    get id(): UserDTO['id'];
+    /**
+     * Почта посетителя.
+     *
+     * @returns Строка; пустая, если почты нет.
+     */
+    get email(): UserDTO['email'];
+    /**
+     * Имя.
+     *
+     * @returns Строка; пустая, если не заполнено.
+     */
+    get firstName(): UserDTO['firstName'];
+    /**
+     * Отчество.
+     *
+     * @returns Строка; пустая, если не заполнено.
+     */
+    get middleName(): UserDTO['middleName'];
+    /**
+     * Фамилия.
+     *
+     * @returns Строка; пустая, если не заполнено.
+     */
+    get lastName(): UserDTO['lastName'];
+    /**
+     * Полное имя, каким его собрал бэкенд.
+     *
+     * @returns Строка; пустая у гостя.
+     */
+    get fullName(): UserDTO['fullName'];
+    /**
+     * Короткое имя для обращения в интерфейсе.
+     *
+     * @returns Строка; пустая у гостя.
+     */
+    get shortName(): UserDTO['shortName'];
+    /**
+     * Когда заведён профиль.
+     *
+     * @returns Дата ISO либо `null` у гостя.
+     */
+    get createdAt(): UserDTO['createdAt'];
+    /**
+     * Часовой пояс посетителя.
+     *
+     * @returns Имя пояса либо `null`, если не задан.
+     */
+    get timezone(): UserDTO['timezone'];
+    /**
+     * Локаль интерфейса.
+     *
+     * @returns Код локали либо `null`, если не задана.
+     */
+    get locale(): UserDTO['locale'];
+    /**
+     * Класс посетителя: id, порядковый номер, имя и транслит.
+     *
+     * @returns Объект класса; у гостя поля `null` и пустые строки.
+     */
+    get grade(): UserDTO['grade'];
+    /**
+     * Телефон посетителя.
+     *
+     * @returns Строка либо `null`, если не указан.
+     */
+    get phone(): UserDTO['phone'];
+    /**
+     * Адрес аватара.
+     *
+     * @returns Строка; пустая, если аватара нет.
+     */
+    get avatarUrl(): UserDTO['avatarUrl'];
+    /**
+     * Посетитель — родитель.
+     *
+     * @returns `true`, если роль родительская.
+     */
+    get isParent(): UserDTO['isParent'];
+    /**
+     * Посетитель — выпускник.
+     *
+     * @returns `true`, если школу закончил.
+     */
+    get isGraduated(): UserDTO['isGraduated'];
+    /**
+     * Класс подтверждён посетителем.
+     *
+     * @returns `true`, если класс проверен.
+     */
+    get gradeChecked(): UserDTO['gradeChecked'];
+    /**
+     * Тип учётной записи на бэкенде.
+     *
+     * @returns `pupil`, `agent` либо `null` у гостя.
+     */
+    get type(): UserDTO['type'];
+    /**
+     * Посетитель — репетитор.
+     *
+     * @returns `true`, если роль репетитора.
+     */
+    get isCoach(): UserDTO['isCoach'];
+    /**
+     * Ведёт мини-группы.
+     *
+     * @returns `true`, если ведёт.
+     */
+    get isMiniGroupTeacher(): UserDTO['isMiniGroupTeacher'];
+    /**
+     * Репетитор экстерната.
+     *
+     * @returns `true`, если ведёт экстернат.
+     */
+    get isExternshipCoach(): UserDTO['isExternshipCoach'];
+    /**
+     * Посетитель — учитель.
+     *
+     * @returns `true`, если роль учителя.
+     */
+    get isAgent(): UserDTO['isAgent'];
+    /**
+     * Посетитель — методист.
+     *
+     * @returns `true`, если методист.
+     */
+    get methodist(): UserDTO['methodist'];
+    /**
+     * Почтовый адрес: страна, регион, город, улица, дом.
+     *
+     * @returns Объект адреса либо `null`, если не заполнен.
+     */
+    get address(): UserDTO['address'];
+    /**
+     * Привязанные соцсети.
+     *
+     * @returns Список провайдеров с идентификаторами; пустой, если привязок нет.
+     */
+    get socialNets(): UserDTO['socialNets'];
+    /**
+     * Логин в Skype.
+     *
+     * @returns Строка либо `null`.
+     */
+    get skype(): UserDTO['skype'];
+    /**
+     * Настройки интерфейса: показанные подсказки и скрытые баннеры.
+     *
+     * @returns Объект флагов либо `undefined`, если бэкенд их не прислал.
+     */
+    get settings(): UserDTO['settings'];
+    /**
+     * Бонусный счёт: подарочные и реальные бонусы.
+     *
+     * @returns Объект с суммами.
+     */
+    get bonus(): UserDTO['bonus'];
+    /**
+     * Сумма бонусов на счёте.
+     *
+     * @returns Число.
+     */
+    get bonusAmount(): UserDTO['bonusAmount'];
+    /**
+     * Есть действующие покупки.
+     *
+     * @returns `true`, если есть.
+     */
+    get hasActivePurchases(): UserDTO['hasActivePurchases'];
+    /**
+     * Остались попытки пробных экзаменов.
+     *
+     * @returns `true`, если остались.
+     */
+    get hasAttemptsSolveExamRehearsals(): UserDTO['hasAttemptsSolveExamRehearsals'];
+    /**
+     * Есть закладки.
+     *
+     * @returns `true`, если есть.
+     */
+    get hasBookmarks(): UserDTO['hasBookmarks'];
+    /**
+     * Метки посетителя на бэкенде.
+     *
+     * @returns Список строк либо `null`.
+     */
+    get tags(): UserDTO['tags'];
+    /**
+     * Шаблон корзины.
+     *
+     * @returns Число либо `null`.
+     */
+    get cartTemplateId(): UserDTO['cartTemplateId'];
+    /**
+     * Сколько позиций в корзине.
+     *
+     * @returns Число.
+     */
+    get cartItemsCount(): UserDTO['cartItemsCount'];
+    /**
+     * Онбординг пройден.
+     *
+     * @returns `true`, если пройден.
+     */
+    get onboardingFinished(): UserDTO['onboardingFinished'];
+    /**
+     * Когда пройден онбординг.
+     *
+     * @returns Дата ISO либо `null`, пока не пройден.
+     */
+    get onboardingFinishedAt(): UserDTO['onboardingFinishedAt'];
+    /**
+     * Почта подтверждена.
+     *
+     * @returns `true`, если подтверждена.
+     */
+    get emailConfirmed(): UserDTO['emailConfirmed'];
+    /**
+     * Телефон подтверждён.
+     *
+     * @returns `true`, если подтверждён.
+     */
+    get phoneConfirmed(): UserDTO['phoneConfirmed'];
+    /**
+     * Почта выдумана бэкендом при регистрации без почты.
+     *
+     * @returns `true`, если почта ненастоящая.
+     */
+    get fakeEmail(): UserDTO['fakeEmail'];
+    /**
+     * Посетитель заведён бэкендом без его участия (например, по заявке).
+     *
+     * @returns `true`, если учётная запись ненастоящая.
+     */
+    get fakeUser(): UserDTO['fakeUser'];
+    /**
+     * Профиль дополнен данными после регистрации.
+     *
+     * @returns `true`, если дополнен.
+     */
+    get profileEnriched(): UserDTO['profileEnriched'];
+    /**
+     * Идентификатор итогов года.
+     *
+     * @returns Строка либо `null`, если итогов нет.
+     */
+    get recapUuid(): UserDTO['recapUuid'];
+    /**
+     * Дисциплины, которые изучает посетитель.
+     *
+     * @returns Список id; пустой, если не выбраны.
+     */
+    get disciplineIds(): UserDTO['disciplineIds'];
+    /**
+     * Настройки приватности.
+     *
+     * @returns Объект с флагом публичного профиля.
+     */
+    get privacy(): UserDTO['privacy'];
+    /**
+     * Телефон родителя.
+     *
+     * @returns Строка либо `null`.
+     */
+    get parentPhone(): UserDTO['parentPhone'];
+    /**
+     * Телефон родителя подтверждён.
+     *
+     * @returns `true`, если подтверждён.
+     */
+    get parentPhoneConfirmed(): UserDTO['parentPhoneConfirmed'];
+    /**
+     * Посетитель что-то покупал.
+     *
+     * @returns `true`, `false` либо `null`, если бэкенд не считал.
+     */
+    get isCustomer(): UserDTO['isCustomer'];
+    /**
+     * Доступны многодневные серии занятий.
+     *
+     * @returns `true`, если доступны.
+     */
+    get hasAccessToMultiDaysStreaks(): UserDTO['hasAccessToMultiDaysStreaks'];
+    /**
+     * Ученик начальной школы.
+     *
+     * @returns `true`, если начальная школа.
+     */
+    get isElementaryPupil(): UserDTO['isElementaryPupil'];
+    /**
+     * Токен для канала уведомлений по WebSocket.
+     *
+     * @returns Строка либо `null`, если канала нет.
+     */
+    get webSocketNotificationsJwt(): UserDTO['webSocketNotificationsJwt'];
+    /**
+     * Доступны аттестационные листы.
+     *
+     * @returns `true`, если доступны.
+     */
+    get hasAccessToAttestationSheets(): UserDTO['hasAccessToAttestationSheets'];
+    /**
+     * Посетитель учится в экстернате.
+     *
+     * @returns `true`, если экстернат.
+     */
+    get externshipUser(): UserDTO['externshipUser'];
+    /**
+     * Есть оплаченные договоры экстерната.
+     *
+     * @returns `true`, если есть.
+     */
+    get hasPurchasedExternshipContracts(): UserDTO['hasPurchasedExternshipContracts'];
+    /**
+     * Доступна аттестация экстерната.
+     *
+     * @returns `true`, если доступна.
+     */
+    get hasExternshipAttestationAccess(): UserDTO['hasExternshipAttestationAccess'];
+    /**
+     * Профиль в разделе социализации.
+     *
+     * @returns Объект с id и состоянием либо `null`, если профиля нет.
+     */
+    get socializationProfile(): UserDTO['socializationProfile'];
+    /**
+     * Когда заканчивается бесплатный доступ.
+     *
+     * @returns Дата ISO либо `null`, если доступа нет.
+     */
+    get freeAccessFinishesAt(): UserDTO['freeAccessFinishesAt'];
+    /**
+     * В комнате начальной школы есть непросмотренные новинки.
+     *
+     * @returns `true`, если есть; `undefined`, если бэкенд не прислал.
+     */
+    get hasUnseenRoomFeatures(): UserDTO['hasUnseenRoomFeatures'];
+    /**
+     * Покупал договоры экстерната.
+     *
+     * @returns `true`, если покупал.
+     */
+    get purchaseAnyExternshipContracts(): UserDTO['purchaseAnyExternshipContracts'];
+    /**
+     * Связан с экстернатом: ученик, родитель либо репетитор.
+     *
+     * @returns `true`, если связан; `undefined`, если бэкенд не прислал.
+     */
+    get hasExternshipRelation(): UserDTO['hasExternshipRelation'];
+    /**
+     * Есть действующий договор экстерната.
+     *
+     * @returns `true`, если есть; `undefined`, если бэкенд не прислал.
+     */
+    get hasExternshipActiveContract(): UserDTO['hasExternshipActiveContract'];
+    /**
+     * Можно продлить договор домашней школы.
+     *
+     * @returns `true`, если можно; `undefined`, если бэкенд не прислал.
+     */
+    get canProlongateContract(): UserDTO['canProlongateContract'];
+    /**
+     * Окно пролонгации договора: даты, скидка, заголовок следующего года.
+     *
+     * @returns Объект окна, `null` либо `undefined`, если окна нет.
+     */
+    get prolongation(): UserDTO['prolongation'];
+    /**
+     * Текущий интерес посетителя: класс, дисциплина, уровень, формат и причина. Та же форма, что у `GET /api/user/user_interest`, но из профиля, без похода.
+     *
+     * @returns Объект интереса либо `null`, если бэкенд не считал.
+     */
+    get currentInterest(): UserDTO['currentInterest'];
+    /**
+     * До какой даты открыт приём в домашнюю школу.
+     *
+     * @returns Дата либо `null`, если приём не идёт.
+     */
+    get admissionFinishesOn(): UserDTO['admissionFinishesOn'];
+    /**
+     * Посетитель пришёл из Алгоритмики — партнёрский вход с другой площадки.
+     *
+     * @returns `true`, если из Алгоритмики.
+     */
+    get algoritmika(): UserDTO['algoritmika'];
+    /**
+     * Страница бонусов уже открывалась — подсказки на ней больше не показываются.
+     *
+     * @returns `true`, если открывалась.
+     */
+    get bonusesPageVisited(): UserDTO['bonusesPageVisited'];
+    /**
+     * Посетителю разрешено менять школу и класс в профиле.
+     *
+     * @returns `true`, если разрешено.
+     */
+    get canChangeSchoolInfo(): UserDTO['canChangeSchoolInfo'];
+    /**
+     * Идёт демо-доступ к экстернату.
+     *
+     * @returns `true`, пока демо активно.
+     */
+    get externshipDemoAccessActive(): UserDTO['externshipDemoAccessActive'];
+    /**
+     * Экстернат ждёт оплаты: когда закроется доступ и по какому договору.
+     *
+     * @returns Объект с датой и id договора либо `null`, если долга нет.
+     */
+    get externshipPaymentRequired(): UserDTO['externshipPaymentRequired'];
+    /**
+     * Показывать промо-шапку экстерната.
+     *
+     * @returns `true`, если показывать.
+     */
+    get externshipPromoHeaderOn(): UserDTO['externshipPromoHeaderOn'];
+    /**
+     * Доступен раздел прогресса подготовки к экзаменам.
+     *
+     * @returns `true`, если доступен.
+     */
+    get hasExamProgressAccess(): UserDTO['hasExamProgressAccess'];
+    /**
+     * Доступны итоги года; их адрес — `recapUuid`.
+     *
+     * @returns `true`, если доступны.
+     */
+    get hasYearlyRecapAccess(): UserDTO['hasYearlyRecapAccess'];
+    /**
+     * Управляет аттестационной школой.
+     *
+     * @returns `true`, `false` либо `null`, если бэкенд не считал.
+     */
+    get isAttestationSchoolManager(): UserDTO['isAttestationSchoolManager'];
+    /**
+     * Посетитель — наставник.
+     *
+     * @returns `true`, если наставник.
+     */
+    get isMentor(): UserDTO['isMentor'];
+    /**
+     * Доступна серия ежедневных занятий с опытом (XP-стрик).
+     *
+     * @returns `true`, если доступна.
+     */
+    get isXpStreakAvailable(): UserDTO['isXpStreakAvailable'];
+    /**
+     * Таблица лидеров: доступна ли посетителю и готов ли он к ней (выбор курса).
+     *
+     * @returns Объект состояний либо `null`, если посетитель вне программы.
+     */
+    get leaderboard(): UserDTO['leaderboard'];
+    /**
+     * Состояние доступа к таблице лидеров.
+     *
+     * @returns `unavailable`, `available`, `vacation` либо `disabled`.
+     */
+    get leaderboardAccessState(): UserDTO['leaderboardAccessState'];
+    /**
+     * Как устроены учебные цели у посетителя.
+     *
+     * @returns `enabled`, `disabled`, `optional` либо `required`.
+     */
+    get learningGoalsAccessState(): UserDTO['learningGoalsAccessState'];
+    /**
+     * Мессенджеры, на которые посетитель подписан на уведомления.
+     *
+     * @returns Список либо `null`, если бэкенд не считал.
+     */
+    get messengerSubscriptions(): UserDTO['messengerSubscriptions'];
+    /**
+     * Пора предлагать продление занятий с репетитором.
+     *
+     * @returns `true`, если пора.
+     */
+    get needToPromoteRenewalWithCoach(): UserDTO['needToPromoteRenewalWithCoach'];
+    /**
+     * Показывать баннер курсов следующего учебного года.
+     *
+     * @returns `true`, если показывать.
+     */
+    get nextYearCoursesBannerAvailable(): UserDTO['nextYearCoursesBannerAvailable'];
+    /**
+     * Пароль задан — вход не только через код или соцсеть.
+     *
+     * @returns `true`, `false` либо `null`, если бэкенд не считал.
+     */
+    get passwordSet(): UserDTO['passwordSet'];
+    /**
+     * Реферальный код для программы «приведи друга».
+     *
+     * @returns Строка либо `null`, если код не выдан.
+     */
+    get referralCode(): UserDTO['referralCode'];
+    /**
+     * Доступен онбординг целевых действий.
+     *
+     * @returns `true`, если доступен.
+     */
+    get targetActionsOnboardingAvailable(): UserDTO['targetActionsOnboardingAvailable'];
+    /**
+     * Идёт ли сейчас окно пролонгации договора домашней школы.
+     *
+     * Границы включаются: последний день окна ещё считается пролонгацией. Не заданная граница
+     * означает, что окна нет вовсе, а не что оно бесконечно.
+     *
+     * @returns `true`, если сегодня внутри окна включительно
+     */
+    isProlongationBetweenDates(): boolean;
+    /**
+     * Глубокое клонирование объекта с защитой от циклических ссылок
+     * @private
+     * @param obj - объект для клонирования
+     * @param hash - WeakMap для отслеживания уже клонированных объектов
+     * @returns клонированный объект
+     */
+    private static deepClone;
+    /**
+     * Гость — сущность с умолчаниями всех полей и признаком `isDefaultUser()`.
+     *
+     * @returns Новая сущность на каждый вызов: умолчания общие на процесс, копия своя.
+     */
+    static createDefault(): User;
+    /**
+     * Форма посетителя по умолчанию ДАННЫМИ — гость со всеми полями: тому, кто отдаёт `UserDTO`
+     * наружу (хост — приложениям), нужна полная форма, а не сущность с методами. Своя копия на
+     * вызов: умолчания общие на процесс, и правка чужой копии их не тронет.
+     *
+     * @returns Новая копия умолчаний на каждый вызов
+     */
+    static defaultDto(): UserDTO;
+    /**
+     * Санитизирует строку: удаляет null-байты и обрезает пробелы
+     * @private
+     * @param str - исходная строка
+     * @returns санитизированная строка
+     */
+    private static sanitizeString;
+    /**
+     * Сущность из профиля бэкенда (`UserDTO` в camelCase): строковые поля чистятся от null-байтов
+     * и пробелов по краям, остальное берётся как есть.
+     *
+     * @param input - Профиль в форме `UserDTO`
+     * @returns Сущность над копией профиля: исходный объект не трогается
+     */
+    static fromApi(input: unknown): User;
+    /**
+     * Санитизирует данные пользователя
+     * @private
+     * @param data - исходные данные
+     * @returns санитизированные данные
+     */
+    private static sanitizeUserData;
+    /**
+     * Сущность собрана из умолчаний (`createDefault`), а не из профиля бэкенда.
+     *
+     * @returns `true` у гостя по умолчанию
+     */
+    isDefaultUser(): boolean;
+    /**
+     * Посетитель вошёл — у него есть идентификатор на бэкенде.
+     *
+     * @returns `true`, если `id` задан и положителен
+     */
+    isLoggedIn(): boolean;
+    private static getGradeString;
+    /**
+     * Роль либо класс словом — для подписи в интерфейсе.
+     *
+     * @returns «Дошкольник» для нулевого класса, «Выпускник» без класса, иначе класс («5 класс»)
+     */
+    getPupilRole(): UserRole;
+    /**
+     * Роль словом — по флагам профиля, первый совпавший: репетитор, учитель, родитель.
+     *
+     * @returns «Репетитор», «Учитель», «Родитель», иначе роль ученика из `getPupilRole()`
+     */
+    getRole: () => UserRole;
+    /**
+     * Фамилия с инициалами имени и отчества — подпись в списках.
+     *
+     * @returns Строка вида «Пупкин В. И.»; без отчества — «Пупкин В.»
+     */
+    getInitials: () => string;
+    /**
+     * Профиль строкой JSON — для печати в документ и передачи по сети.
+     *
+     * @returns JSON полей сущности
+     */
+    toJson(): string;
+    /**
+     * Посетитель данными — то, что едет по сети и в состояние: сущность с методами не
+     * сериализуется. Своя копия на вызов: сущность неизменяема, и правка копии её не тронет.
+     *
+     * @returns Копия полей сущности данными
+     */
+    toDto(): UserDTO;
+}
+
+type AppOptions = {
+    activePromoBanner?: number;
+    captcha?: {
+        provider: 'recaptcha';
+        siteKey: string;
+    };
+    contactPhoneNumber: null | string;
+    currency: {
+        code: 'RUB';
+        exchangeRate: number;
+    };
+    currentSchoolYear: null | {
+        current: boolean;
+        id: number;
+        startsFrom: number;
+        translit: string;
+    };
+    experiments?: Array<{
+        name: string;
+        value: string;
+    }>;
+    externalReviews?: {
+        pageAvailable: boolean;
+    };
+    featureFlags?: Array<string>;
+    feedbackThemes?: {
+        foxford: {
+            tasks: number;
+        };
+    };
+    flash: {
+        alert?: string;
+        notice?: string;
+        warning?: string;
+    };
+    nextSchoolYearProductsExists: boolean;
+    paymentMethods?: {
+        another?: string;
+        cardPayment?: 'Yandex';
+        creditExternshipPayment?: 'TinkoffCredit';
+        creditPayment?: 'Sberbank' | 'Yandex';
+        internationalCardPayment?: 'Payture' | 'Payanyway';
+        splitPayment?: 'YandexPay';
+        platiChastyamiPayment?: 'PlatiChastyami';
+        sberPayPayment?: 'SberbankEcommerce';
+        sberSpasiboPayment?: 'SberbankEcommerce';
+        sbpPayment?: 'Yandex';
+    };
+    phoneConfirmationType: 'sms' | 'phone_call' | 'cascade_by_call' | 'telegram_cascade';
+    popupAlerts?: number[];
+    prerender?: boolean;
+    requestMetaTags?: boolean;
+    rootMenuItems: Array<{
+        contextOfUse?: 'externat' | 'media' | 'portal';
+        id: number;
+        title: string;
+        url: string;
+    }>;
+    sentry?: {
+        dsn: string;
+    };
+    showPromoBanners: string[];
+    user?: UserDTO;
+    userIdentity?: string;
+    webSocketNotifications?: {
+        clientConnection: null | Array<{
+            endpoint: string;
+            transport: 'websocket' | 'http_stream' | 'sse' | 'sockjs' | 'webtransport';
+        }>;
+        token: string;
+    };
+    contacts: {
+        email: null | string;
+        phone: null | string;
+        telegram: null | string;
+        vkontakte: null | string;
+        whatsapp: null | string;
+    };
+};
+declare class AppOptionsService {
+    private api;
+    private readonly eventName;
+    private appOptions;
+    constructor(apiInstance: ApiInstance, eventName: string);
+    getCurrentAppOptions(): Promise<AppOptions>;
+    /**
+     * Get app options data from api
+     */
+    getAppOptions(): Promise<AppOptions>;
+}
+
+declare class CartService {
+    private api;
+    constructor(apiInstance: ApiInstance);
+    createCartItem(id: number, type: CartItemResourceType): CartItemDTO;
+    addCartItemToCart(cartItem: CartItemDTO): Promise<unknown>;
+}
+
+declare class CourseService {
+    private api;
+    constructor(apiInstance: ApiInstance);
+    getCourse(id: number): Promise<Course>;
+    enrollCourse(id: number): Promise<void>;
+}
+
+type LeadRequestPayload = {
+    email?: string | null;
+    phone?: string | null;
+    school_id?: number | null;
+    contract_id?: number | null;
+    referrer?: string | null;
+    subscription_external?: 'true' | 'false' | null;
+    user_type?: 'pupil' | 'agent' | 'parent' | null;
+    agent_id?: number | null;
+    agreement?: boolean | null;
+    code?: string | null;
+    communication_method?: 'phone' | 'email' | 'whatsapp' | null;
+    course_name?: string | null;
+    discipline_id?: number | null;
+    free_intro_lesson_group_id?: number | null;
+    free_intro_lesson_mini_group_id?: number | null;
+    grade_id?: number | null;
+    group_template_ids?: Array<number> | null;
+    id?: string | null;
+    interests?: Array<string> | null;
+    level_id?: any | null;
+    name?: string | null;
+    parent_phone?: string | null;
+    phone_number?: string | null;
+    placement?: string | null;
+    product_id?: number | null;
+    product_pack_id?: string | null;
+    product_type?: any | null;
+    source?: string | null;
+    school_entry_year?: number | null;
+    total_balance?: number | null;
+    user_id?: number | null;
+    user_phone_number?: string | null;
+    utm_campaign?: string | null;
+    utm_medium?: string | null;
+    utm_source?: string | null;
+    utm_term?: string | null;
+};
+interface LeadRequest extends LeadRequestPayload {
+    type: LeadRequestType;
+    agreement?: boolean;
+    context: 'rep_change_tariff' | 'split_balance' | 'demo_order' | string;
+}
+interface LeadRequestApiResponse {
+    id: string;
+    newUser: boolean;
+}
+interface LeadRequestResponse {
+    leadRequest: LeadRequest;
+    response: LeadRequestApiResponse;
+}
+declare enum LeadRequestType {
+    Algorithmics = "LeadRequests::Algorithmics",
+    External = "LeadRequests::External",
+    Callback = "LeadRequests::Callback",
+    Basic = "LeadRequests::Basic",
+    Main = "LeadRequests::Main",
+    Coach = "LeadRequests::Coach",
+    Media = "LeadRequests::Media",
+    MiniGroup = "LeadRequests::MiniGroup",
+    Externship = "LeadRequests::Externship",
+    CoachUserCoursePlanUpgradeCallback = "LeadRequests::CoachUserCoursePlanUpgradeCallback",
+    ParentCallback = "LeadRequests::ParentCallback",
+    TeacherCallback = "LeadRequests::TeacherCallback",
+    Email = "LeadRequests::EmailSubscription",
+    IThubLead = "LeadRequests::IThubLead"
+}
+declare class LeadRequestService {
+    private api;
+    types: typeof LeadRequestType;
+    constructor(apiInstance: ApiInstance);
+    /**
+     * Create lead request
+     * @param {LeadRequestType} type
+     * @param {LeadRequest['context']} context
+     * @param {LeadRequestPayload} data
+     */
+    createLeadRequest(type: LeadRequestType, context: LeadRequest['context'], data?: LeadRequestPayload): LeadRequest;
+    /**
+     * Send lead request with specific data
+     * @param {LeadRequest} leadRequest
+     */
+    send(leadRequest: LeadRequest): Promise<LeadRequestResponse>;
+    /**
+     * Update lead request with specific data
+     * @param {string} id
+     * @param {LeadRequestPayload} lrData
+     */
+    update(id: string, lrData?: Partial<LeadRequest>): Promise<unknown>;
+}
+
+declare class ProductPackService {
+    private api;
+    constructor(apiInstance: ApiInstance);
+    getProductPack(id: number): Promise<ProductPack>;
+}
+
+declare class PromoService {
+    private api;
+    constructor(apiInstance: ApiInstance);
+    checkPromocode(code: string): Promise<unknown>;
+    /**
+     * Send data if user saw the promo code
+     * @param {string} promoCode
+     * @returns {Promise}
+     */
+    trackCodeCampaign(promoCode: string): Promise<void>;
+}
+
+declare class TagService {
+    private api;
+    constructor(apiInstance: ApiInstance);
+    addTag(id: number): Promise<unknown>;
+}
+
+declare class UserService {
+    private api;
+    private appOptionsService;
+    constructor(apiInstance: ApiInstance, appOptionsService: AppOptionsService);
+    /**
+     * Create user instance
+     * @param {UserDTO} data data of user
+     */
+    static createUser(data: UserDTO): User;
+    /**
+     * Create default user
+     * @returns {User}
+     */
+    static createDefaultUser(): User;
+    /**
+     * Get current user data
+     * @return {Promise} Server response with user data
+     */
+    getUser(): Promise<User>;
+    /**
+     * Логин или регистрация юзера по email
+     * @param email email юзера
+     * @param password пароль
+     * @returns {Promise<{ user: User; result: LoginOrRegistrationResponse }>}
+     */
+    loginByEmail(email: string, password: string): Promise<{
+        user: User;
+        result: LoginOrRegistrationResponse;
+    }>;
+    /**
+     * Запрос кода на подтвеждение телефона
+     */
+    getConfirmationCode(phone: string): Promise<ApiResponse<{
+        nextDeliveryAt: string;
+    }>>;
+    /**
+     * Логин или регистрация юзера по телефону
+     * @param phone номер телефона
+     * @param params
+     * @returns {Promise<{ user: User; result: LoginOrRegistrationResponse }>}
+     */
+    loginByPhone(phone: string, params: LoginByPhoneParams): Promise<any>;
+    /**
+     * Получение покупок текущего пользователя
+     * @param  {Number} params.resourceId     Resource ID
+     * @param  {String} params.resourceType   Resource type
+     * @return {Promise}                      Server response with user purchases
+     */
+    purchases({ resourceId, resourceType }: {
+        resourceId: number;
+        resourceType: string;
+    }): Promise<unknown>;
+    /**
+     * Навигация на страницу входа и перенаправление на указанный путь после успешного входа.
+     * @param  {String} options.redirectUrl URL для редиректа.
+     */
+    signIn({ redirectUrl }: {
+        redirectUrl?: string;
+    }): void;
+    /**
+     * Выход из аккаунта с перезагрузкой страницы
+     */
+    signOut(reloadAfter?: boolean): Promise<unknown>;
+    pushEvent(event: {
+        action: 'experiment' | 'funnel' | 'conversion' | 'click';
+        label: string;
+    }): Promise<void>;
+    /**
+     * Установить подписку пользователю
+     * @param {CommunicationSubscriptions} subscriptions пользовательские подписки
+     */
+    setSubscriptions(subscriptions: CommunicationSubscriptions): Promise<void>;
+    /**
+     * Получение интересов пользователя
+     */
+    getUserInterests(): Promise<UserInterests>;
+    /**
+     * Обновление интересов пользователя
+     * @param {Partial<UserInterests>} data интересы пользователя
+     */
+    updateUserInterests(data: Partial<UserInterests>): Promise<void>;
+    /**
+     * Обновления множества интересов пользователя
+     * @param {Partial<UserInterests>} data интересы пользователя
+     */
+    updateMultipleUserInterests(data: Partial<UserInterests>[]): Promise<void>;
+}
+
+declare class Foxford {
+    foxApi: ReturnType<typeof ApiService.createFoxApiInstance>;
+    api: ReturnType<typeof ApiService.createApiInstance>;
+    staticApi: ReturnType<typeof ApiService.createStaticApiInstance>;
+    user: UserService;
+    tag: TagService;
+    cart: CartService;
+    promo: PromoService;
+    course: CourseService;
+    productPack: ProductPackService;
+    leadrequest: LeadRequestService;
+    widgets: Widgets;
+    appOptions: AppOptionsService;
+    captcha: CaptchaService;
+    private readonly config;
+    static events: {
+        readonly FETCH_APP_OPTIONS: "Foxford.app_options.fetch";
+        readonly LR_REGISTRATION_SET: "LeadRequest.registration.set";
+    };
+    static DEFAULT_CONFIG: FoxfordConfig;
+    constructor(config?: FoxfordConfig);
+    private buildFoxApi;
+    /**
+     * Get short link
+     * @param {string} url link for shortening
+     */
+    shortURL(url: string): Promise<ApiResponse<unknown>>;
+    /**
+     * Applies and throwing itself into plugin for access to Api
+     * @param {SdkPlugin} plugin Plugin to apply
+     */
+    applyPlugin(plugin: SdkPlugin): void;
+}
+
+interface SdkPlugin {
+    apply(sdk: Foxford): void;
+    destroy(): void;
+}
+
+export type { SdkPlugin as S };