flamerest 1.0.126 → 1.0.128

package/REST.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Базовый ответ от сервера
+ */
+export declare type BaseResponse<T> = {
+    type: string;
+    status: number;
+    ok: boolean;
+    data?: T;
+    errors: object | undefined;
+    message: string | undefined;
+};
+/**
+ * Часть ответа с пагинацией
+ */
+export declare type Paginated = {
+    pages: {
+        page: number;
+        perPage: number;
+        count: number;
+        total: number;
+    };
+};
+/**
+ * Стандартный ответ от Request с несколькими строками
+ */
+export declare type Rows<T> = BaseResponse<Array<T>> & Paginated;
+export declare type Row<T> = BaseResponse<T> & Paginated;
+export declare type CustomRequest<T> = BaseResponse<T>;
+export declare type CustomAnyRequest = BaseResponse<any>;
+/**
+ * Стандартный ответ от Request с изменённой строкой
+ */
+export declare type SavedObject<T> = BaseResponse<T>;
+/**
+ * Элемент баланса пользователя
+ */
+export interface BalanceItem {
+    name: string;
+    balance_decimal: string;
+    value: number;
+}
+/**
+ * Результат авторизации
+ */
+export declare type Authorized = {
+    isAuthorized: boolean;
+    User: {
+        avatar: string;
+        country: string;
+        id: number;
+        lang: string;
+        name: string;
+        role: string;
+        user_hash?: string;
+        balance: 0;
+        balance_all: {
+            [key: string]: BalanceItem;
+        };
+    };
+    errors: {
+        [key: string]: any;
+    };
+    token: string;
+};
+export declare class FLAMEREST {
+    /**
+     * Адрес серва
+     */
+    SERVER: string;
+    /**
+     * Стандартное число запросов на страницу
+     */
+    perPageDefault: number;
+    /**
+     * Будет вызван, если любой из запросов вернут требование авторизоваться
+     */
+    unauthorized_callback: (() => void) | undefined;
+    /**
+     * Будет вызван, если сервер вернёт статус 503 (Service Unavailable / Maintenance)
+     * Может содержать сообщение об ошибке из JSON ответа
+     */
+    maintenance_callback: ((errorMessage?: string) => void) | undefined;
+    /**
+     * Токен приложения конкретного клиента для отправки пуш уведомлений именно ему
+     */
+    pushNotificationToken: string | null;
+    /**
+     * Версия api
+     */
+    version: string;
+    /**
+     * Версия кода клиента (отправляется в заголовке каждого запроса).
+     * Можно установить извне: REST.VERSION_CODE = "1.2.3"
+     */
+    VERSION_CODE: string;
+    /**
+     * Если авторизация по токену, то он сюда подставляется
+     */
+    isAuthByJWTQuery: boolean;
+    /**
+     * Режим авторизации: Bearer|Link
+     */
+    authMode: "Bearer" | "Link";
+    token: string | null;
+    /**
+     * Конструктор класса FLAMEREST
+     * @param {string} server_address Адрес сервера (опционально)
+     * @param {string} localhost_endpoint Альтернативный адрес для localhost (опционально)
+     * @param {Function} unauthorized_callback Колбек для обработки 401 ошибок (опционально)
+     * @param {string} version Версия API (по умолчанию 'v1')
+     * @param {Function} maintenance_callback Колбек для обработки 503 ошибок (опционально)
+     */
+    constructor(server_address?: string, localhost_endpoint?: string, unauthorized_callback?: () => void, version?: string, maintenance_callback?: (errorMessage?: string) => void);
+    /**
+     * Установка плагина для Vue
+     * @param Vue
+     * @param options
+     */
+    install(Vue: any, options: any): void;
+    /**
+     *
+     * @param {string} url Адрес
+     * @param {object|string|FormData} params Параметры, которые надо передать, могут быть в виде объекта или строки
+     * @param {string} type Тип
+     * @param {string} responseType Тип ответа: json или blob
+     * @param {boolean} isNeedToken нужен ли токен для запроса
+     * @param {Object} customHeaders объект с доп заголовками, которые надо включить в запрос
+     */
+    request(url: string, params: object | string | FormData, type?: 'GET' | 'POST' | 'PUT' | 'DELETE', responseType?: 'json' | 'blob', isNeedToken?: boolean, customHeaders?: Record<string, string>): Promise<BaseResponse<any> & Partial<Paginated>>;
+    /**
+     * Получить выборку из таблицы через REST
+     * @param {string} table
+     * @param {object | string | null} where Позволяет делать выборку из связанных таблиц, надо только их указать через название таблицы sites.id=5, и указать колонку в expand
+     * @param {object | Array<string> | null} extfields
+     * @param {object | Array<string> | string | null} fields
+     * @param {object | Array<string> | string | null} sortfields
+     * @param {number | undefined} page
+     * @param {number | undefined} perPage
+     * @param {boolean | undefined} RemoveDuplicates
+     * @param {any} titles Это чтобы мы могли контроллить какие названия полей мы будет загружать при экспорте, чтобы они были как в таблице
+     * @param {any} tree дерево
+     * @param {any} params Доп параметры для кастомизации запроса на беке
+     * @param {any} exportData имя файла для экспорта
+     * @return Promise<Rows<T>>
+     */
+    get<T>(table: string, where?: object | string | null, extfields?: object | Array<string> | null, fields?: object | Array<string> | string | null, sortfields?: object | Array<string> | string | null, page?: number, perPage?: number, RemoveDuplicates?: boolean, format?: any, titles?: any, tree?: any, params?: any, exportData?: any): Promise<Rows<T>>;
+    /**
+     * Получить все записи по запросу [постранично]
+     * @param {string} table
+     * @param {object} params
+     * @returns {Promise<Rows<T>>}
+     */
+    all<T>(table: string, params?: {
+        where?: object;
+        extfields?: object | Array<string>;
+        fields?: object | Array<string>;
+        sort?: Array<string>;
+        page?: number;
+        perPage?: number;
+        tree?: number;
+        params?: any;
+        export?: {
+            format?: 'xlsx' | 'csv';
+            titles?: Array<string>;
+            filename?: string;
+        };
+    }): Promise<Rows<T>>;
+    /**
+       * Получить одну запись по ID или по условию выборки [первая запись]
+       * @param {string} table
+       * @param {number|string|object} IDOrWhere
+       * @param {object|Array} extfields
+       * @param {object|Array} fields
+       * @param {string} primaryKeyName если указан ID, то указать название первичного ключа, если от id он отличается
+     */
+    one<T>(table: string, IDOrWhere: number | string | object, extfields?: object | Array<string> | null, fields?: object | Array<string> | null, primaryKeyName?: string): Promise<T | null>;
+    /**
+     * Создать новую запись
+     * @param {string} table
+     * @param {object} values
+     * @param {number|string|null} appendTo
+     * @param {number|string|null} insertAfter
+     * @param {boolean|null} insertFirst
+     */
+    create<T>(table: string, values: object, appendTo?: number | string | null, insertAfter?: number | string | null, insertFirst?: number | string | null): Promise<SavedObject<T>>;
+    /**
+     * Удалить запись
+     * @param {string} table
+     * @param {number|string} id
+     * @param {object|null} byFields Если указан, удаляет по этим параметрам
+     */
+    remove(table: string, id?: number | string, byFields?: object | null): Promise<boolean | any>;
+    /**
+     * Редактировать значения
+     * @param {string} table
+     * @param {number|string} ID
+     * @param {object} values
+     * @param {number|string|null} appendTo
+     * @param {number|string|null} insertAfter
+     * @param {boolean|null} insertFirst
+     */
+    edit<T>(table: string, ID: number | string, values: object, appendTo?: number | string | null, insertAfter?: number | string | null, insertFirst?: number | string | null): Promise<SavedObject<T>>;
+    /**
+     * Получить схемы всех таблиц
+     */
+    getCRUDInfo(): Promise<object>;
+    /**
+     * Авторизоваться
+     * @param {string|undefined} username
+     * @param {string|undefined} password
+     * @param {object|string|null} pushNotificationToken
+     */
+    auth(username?: string, password?: string, pushNotificationToken?: object | string | null): Promise<Authorized>;
+    /**
+     * Зарегистрироваться с этим логином и паролем
+     * @param {string|null} email
+     * @param {string|null} username
+     * @param {string} password
+     * @param {string|null} name
+     * @param {object|string|null} pushNotificationToken
+     * @param {any} data
+     */
+    signup(email: string | null, username: string | null, password: string, name?: string | null, pushNotificationToken?: object | string | null, data?: any): Promise<Authorized>;
+    /**
+     * Выйти из системы
+     */
+    logout(): Promise<object>;
+    /**
+     * Восстановление пароля
+     * Запрос на восстановление пароля
+     * @param {*} email
+     * @returns
+     */
+    ResetPasswordRequest(email: string): Promise<any>;
+    /**
+     * Восстановление пароля
+     * Проверка токена восстановления
+     * @param {*} token токен подтверждения
+     * @returns
+     */
+    ResetPasswordTokenCheck(token: string): Promise<any>;
+    /**
+     * Восстановление пароля
+     * Сохранение нового пароля
+     * @param {*} token
+     * @param {*} password
+     * @returns
+     */
+    ResetPasswordSaveNewPassword(token: string, password: string): Promise<any>;
+    /**
+     * Подготовить объект под загрузку: загрузить данные из элементов Input [type=file] / Clipboard / DataTransfer [Drag&Drop/Clipboard]
+     * @param {object} values
+     */
+    prepare(values: {
+        [key: string]: any;
+    }, asFormData?: boolean): Promise<any>;
+    /**
+     * Прочесть файл асинхронно
+     * @param {File} file
+     * @param {'data' | 'text'} readAs
+     * @returns {Promise<string>}
+     */
+    readFileAsync(file: File, readAs?: 'data' | 'text'): Promise<string | ArrayBuffer | null>;
+    /**
+     * Заполнить существующий объект пришедшими из БД данными
+     * сохраняя при этом оригинальные классы и функции
+     * @param {*} object
+     * @param {*} values
+     */
+    fillObject<T extends object>(object: T, values: any): T;
+    generateID(length: number): string;
+    /**
+     * Вычисляет на лету детерминированную строку, которая будет использоваться как часть ключа для подписи.
+     * Ключ генерируется на основе последовательности числовых преобразований, что делает его неочевидным
+     * при статическом анализе кода. Этот метод всегда возвращает один и тот же результат.
+     * @returns {string} Детерминированно сгенерированная строка.
+     */
+    getDeterministicKeyPart(): string;
+    /**
+     * Создаёт подпись для запроса на основе его параметров, используя лучшие практики.
+     * Собирает все GET и POST параметры, сортирует их и формирует каноническую строку для хеширования.
+     * @param url URL запроса, включая GET-параметры.
+     * @param params POST-параметры запроса (в виде объекта).
+     * @returns Promise<string> Строка подписи.
+     */
+    private _generateRequestSignature;
+    /**
+     *
+     * @param {string} data
+     * @param {string} key
+     * @returns
+     */
+    hmac_sha256(message: BodyInit | null | undefined, secret_key: string): Promise<string>;
+}
+/**
+ * Экземпляр-синглтон класса FLAMEREST.
+ * Используйте его для всех запросов в приложении.
+ * `import REST from './REST.ts';`
+ */
+declare const REST: FLAMEREST;
+export default REST;

package/REST.js

@@ -0,0 +1,810 @@
+export class FLAMEREST {
+    /**
+     * Конструктор класса FLAMEREST
+     * @param {string} server_address Адрес сервера (опционально)
+     * @param {string} localhost_endpoint Альтернативный адрес для localhost (опционально)
+     * @param {Function} unauthorized_callback Колбек для обработки 401 ошибок (опционально)
+     * @param {string} version Версия API (по умолчанию 'v1')
+     * @param {Function} maintenance_callback Колбек для обработки 503 ошибок (опционально)
+     */
+    constructor(server_address, localhost_endpoint, unauthorized_callback, version, maintenance_callback) {
+        /**
+         * Стандартное число запросов на страницу
+         */
+        this.perPageDefault = 20;
+        /**
+         * Токен приложения конкретного клиента для отправки пуш уведомлений именно ему
+         */
+        this.pushNotificationToken = null;
+        /**
+         * Версия кода клиента (отправляется в заголовке каждого запроса).
+         * Можно установить извне: REST.VERSION_CODE = "1.2.3"
+         */
+        this.VERSION_CODE = "1.0.0";
+        /**
+         * Если авторизация по токену, то он сюда подставляется
+         */
+        this.isAuthByJWTQuery = true;
+        /**
+         * Режим авторизации: Bearer|Link
+         */
+        this.authMode = "Bearer";
+        this.token = null;
+        if (typeof window === 'undefined') {
+            // SSR: используем предоставленный адрес или дефолтный
+            this.SERVER = server_address ?? "http://localhost/";
+        }
+        else {
+            // Client: определяем адрес по window.location или из параметра
+            if (server_address === undefined) {
+                this.SERVER = window.location.protocol + "//" + window.location.host;
+            }
+            else {
+                this.SERVER = server_address;
+            }
+            if (window.location.hostname === 'localhost' && localhost_endpoint !== undefined) {
+                this.SERVER = localhost_endpoint;
+            }
+        }
+        // Убираем слэш в конце, если он есть
+        this.SERVER = this.SERVER.endsWith('/') ? this.SERVER.substring(0, this.SERVER.length - 1) : this.SERVER;
+        this.unauthorized_callback = unauthorized_callback;
+        this.maintenance_callback = maintenance_callback;
+        this.version = version ?? 'v1';
+    }
+    /**
+     * Установка плагина для Vue
+     * @param Vue
+     * @param options
+     */
+    install(Vue, options) {
+        if (typeof window !== 'undefined') {
+            window.REST = this;
+        }
+    }
+    /**
+     *
+     * @param {string} url Адрес
+     * @param {object|string|FormData} params Параметры, которые надо передать, могут быть в виде объекта или строки
+     * @param {string} type Тип
+     * @param {string} responseType Тип ответа: json или blob
+     * @param {boolean} isNeedToken нужен ли токен для запроса
+     * @param {Object} customHeaders объект с доп заголовками, которые надо включить в запрос
+     */
+    async request(url, params, type = 'GET', responseType = 'json', isNeedToken = true, customHeaders = {}) {
+        // Подставляем сервер автоматом если URL не содержит протокол
+        // Не трогаем URL с явным протоколом (http://, https://) или протокол-независимые (//)
+        if (!url.startsWith('http://') && !url.startsWith('https://') && !url.startsWith('//')) {
+            // Убираем начальный "/" если он есть, т.к. SERVER уже без слэша в конце
+            if (url[0] === '/') {
+                url = url.substring(1);
+            }
+            // Добавляем SERVER с разделителем "/"
+            url = this.SERVER + '/' + url;
+        }
+        // Создаём подпись запроса до его модификации
+        const SIGN = await this._generateRequestSignature(url, params);
+        // Нормализуем параметры, если они есть
+        if (typeof params === "object" && params !== null) {
+            if (!(params instanceof FormData)) {
+                params = JSON.stringify(params);
+            }
+            if (type === 'GET') {
+                type = 'POST';
+            }
+            responseType = 'json';
+        }
+        const that = this;
+        // Фетч поддерживается - получаем через него, это быстрее
+        if (typeof fetch === "function") {
+            return new Promise(async (resolve, reject) => {
+                try {
+                    // Авторизация
+                    if (this.isAuthByJWTQuery && isNeedToken === true && this.token !== null && this.token !== undefined && this.token !== 'undefined') {
+                        switch (this.authMode) {
+                            case 'Link':
+                                url = url + (url.indexOf("?") === -1 ? "?" : "&") + "access-token=" + this.token;
+                                break;
+                            default:
+                                Object.assign(customHeaders, { 'Authorization': 'Bearer ' + this.token });
+                                break;
+                        }
+                    }
+                    // Уникальный user_hash (только на клиенте)
+                    let user_hash = null;
+                    if (typeof window !== 'undefined' && window.localStorage) {
+                        user_hash = window.localStorage.getItem('user_hash');
+                        if (user_hash) {
+                            Object.assign(customHeaders, { udata: user_hash });
+                        }
+                    }
+                    // Тело запроса
+                    const headers = { ...customHeaders };
+                    if (!(params instanceof FormData)) {
+                        headers['Content-type'] = 'application/json; charset=utf-8';
+                    }
+                    // Версия кода клиента — уходит с каждым запросом
+                    headers['version'] = this.VERSION_CODE;
+                    const requestBody = {
+                        method: type,
+                        mode: 'cors',
+                        headers: headers
+                    };
+                    if (type !== 'GET') {
+                        // Принимает и formData тоже и чистую json строку
+                        requestBody.body = params;
+                    }
+                    // Добавляем подпись в заголовки
+                    requestBody.headers['sign'] = SIGN;
+                    // Делаем запрос
+                    const response = await fetch(url, requestBody);
+                    // Тело ответа формируется в два этапа: сперва заголовки, затем ответ
+                    const ResolveBody = {
+                        status: response.status,
+                        ok: response.ok
+                    };
+                    // Ответ с ошибкой
+                    if (!response.ok) {
+                        // Тело ошибки
+                        ResolveBody.message = response.statusText;
+                        try {
+                            ResolveBody.errors = await response.json();
+                            // Ошибки
+                            switch (ResolveBody.status) {
+                                // Ошибка валидации: Собираем все ошибки полей
+                                case 422:
+                                    const Errs = {};
+                                    for (const err of ResolveBody.errors) {
+                                        Errs[err['field']] = Errs[err['field']] === undefined ? err['message'] : Errs[err['field']] + ". " + err['message'];
+                                    }
+                                    ResolveBody.errors = Errs;
+                                    break;
+                                case 401:
+                                    if (typeof this.unauthorized_callback === 'function') {
+                                        this.unauthorized_callback();
+                                    }
+                                    break;
+                                case 503:
+                                    // Обработка режима обслуживания (maintenance)
+                                    let maintenanceMessage = undefined;
+                                    if (ResolveBody.errors && typeof ResolveBody.errors === 'object' && 'error' in ResolveBody.errors) {
+                                        maintenanceMessage = ResolveBody.errors.error;
+                                    }
+                                    if (typeof this.maintenance_callback === 'function') {
+                                        this.maintenance_callback(maintenanceMessage);
+                                    }
+                                    break;
+                            }
+                        }
+                        catch (exjson) {
+                            ResolveBody.errors = await response.text();
+                        }
+                        // Рапортуем об ошибке
+                        console.error('Ошибка загрузки [' + response.status + '] ' + url + ": " + response.statusText, ResolveBody, ResolveBody.errors);
+                        resolve(ResolveBody);
+                        return;
+                    }
+                    // Загрузка успешна
+                    // Если в заголовках указана паджинация
+                    let pages = undefined;
+                    if (response.headers.get('X-Pagination-Current-Page') !== null) {
+                        pages = {
+                            page: parseInt(response.headers.get('X-Pagination-Current-Page')),
+                            perPage: parseInt(response.headers.get('X-Pagination-Per-Page')),
+                            count: parseInt(response.headers.get('X-Pagination-Page-Count')),
+                            total: parseInt(response.headers.get('X-Pagination-Total-Count')),
+                        };
+                    }
+                    // Заполняем тело ответа заголовками
+                    ResolveBody.type = "json";
+                    ResolveBody.data = {};
+                    ResolveBody.pages = pages;
+                    // Получаем тело ответа
+                    switch (responseType) {
+                        case 'json':
+                            ResolveBody.data = await response.text();
+                            break;
+                        case 'blob': {
+                            // Записываем имя файла и mime-тип
+                            ResolveBody.filename = 'file'; // TODO: response.headers.get('content-disposition').split('filename=')[1];
+                            ResolveBody.MimeType = response.headers.get('content-Type');
+                            ResolveBody.data = await response.blob();
+                            // Если ответ в виде блоба, сразу его отдаём без декодировки
+                            resolve(ResolveBody);
+                            return;
+                        }
+                    }
+                    // Декодируем тело ответа, если оно есть
+                    if (ResolveBody.data === undefined) {
+                        ResolveBody.errors = ["Принятый ответ пуст"];
+                        console.error("Принятый ответ пуст", ResolveBody);
+                        resolve(ResolveBody);
+                        return;
+                    }
+                    ;
+                    // Пустой ответ конвертируем в валидный пустой объект
+                    if (ResolveBody.data === "")
+                        ResolveBody.data = "{}";
+                    // Декодируем
+                    try {
+                        ResolveBody.data = JSON.parse(ResolveBody.data);
+                    }
+                    catch (ex) {
+                        ResolveBody.errors = ["Ошибка декодирования"];
+                        console.error("Ошибка декодирования", ResolveBody);
+                        reject(ResolveBody);
+                        return;
+                    }
+                    // Если пришёл ответ: неавторизовано, и указан коллбек авторизации - запускаем его
+                    if (ResolveBody.data.Auth === false) {
+                        if (that.unauthorized_callback !== undefined) {
+                            that.unauthorized_callback();
+                            resolve(ResolveBody);
+                            return;
+                        }
+                    }
+                    // Возвращаем успешную загрузку
+                    resolve(ResolveBody);
+                }
+                catch (err) {
+                    // Ошибка загрузки любого типа
+                    // TODO: на этом этапе стоит сделать, чтобы он пробовал повторить запрос, если это GET
+                    if (typeof err !== 'object' || err.message === undefined) {
+                        err = {
+                            status: 0,
+                            message: '',
+                        };
+                    }
+                    if (typeof err.body === 'object') {
+                        err.body = await err.body;
+                    }
+                    console.error('Ошибка загрузки [' + 0 + '] ' + url + ": " + err.message);
+                    reject(err);
+                }
+            });
+        }
+        else {
+            // Фетч не поддерживается (старые браузеры или окружения) - возвращаем промисифицированный XHR
+            return new Promise((resolve, reject) => {
+                const xhr = new XMLHttpRequest();
+                xhr.open(type, url, true);
+                xhr.responseType = 'json';
+                xhr.setRequestHeader('Content-type', 'application/json; charset=utf-8');
+                // Версия кода клиента — уходит с каждым запросом (fallback без fetch)
+                xhr.setRequestHeader('version', this.VERSION_CODE);
+                xhr.withCredentials = false;
+                xhr.send(params);
+                xhr.onload = function () {
+                    if (xhr.status !== 200) {
+                        console.error('Ошибка загрузки [' + xhr.status + '] ' + url + ": " + xhr.statusText);
+                        return reject({
+                            status: xhr.status,
+                            message: xhr.statusText
+                        });
+                    }
+                    let pages = undefined;
+                    if (xhr.getResponseHeader('X-Pagination-Current-Page') !== null) {
+                        pages = {
+                            page: parseInt(xhr.getResponseHeader('X-Pagination-Current-Page')),
+                            perPage: parseInt(xhr.getResponseHeader('X-Pagination-Per-Page')),
+                            count: parseInt(xhr.getResponseHeader('X-Pagination-Page-Count')),
+                            total: parseInt(xhr.getResponseHeader('X-Pagination-Total-Count')),
+                        };
+                    }
+                    return resolve({
+                        status: xhr.status,
+                        type: xhr.responseType,
+                        data: xhr.response,
+                        pages: pages,
+                        ok: true,
+                        errors: undefined,
+                        message: ''
+                    });
+                };
+                xhr.onerror = function () {
+                    console.error('Ошибка загрузки [' + 0 + '] ' + url + ": Нет соединения с сервером");
+                    return reject({
+                        status: 0,
+                        message: "Нет соединения с сервером"
+                    });
+                };
+            });
+        }
+    }
+    /**
+     * Получить выборку из таблицы через REST
+     * @param {string} table
+     * @param {object | string | null} where Позволяет делать выборку из связанных таблиц, надо только их указать через название таблицы sites.id=5, и указать колонку в expand
+     * @param {object | Array<string> | null} extfields
+     * @param {object | Array<string> | string | null} fields
+     * @param {object | Array<string> | string | null} sortfields
+     * @param {number | undefined} page
+     * @param {number | undefined} perPage
+     * @param {boolean | undefined} RemoveDuplicates
+     * @param {any} titles Это чтобы мы могли контроллить какие названия полей мы будет загружать при экспорте, чтобы они были как в таблице
+     * @param {any} tree дерево
+     * @param {any} params Доп параметры для кастомизации запроса на беке
+     * @param {any} exportData имя файла для экспорта
+     * @return Promise<Rows<T>>
+     */
+    get(table, where, extfields, fields, sortfields, page, perPage, RemoveDuplicates, format, titles, tree, params, exportData) {
+        // Нормализуем имена таблиц
+        table = table.replace(/_/g, "");
+        let responseType = "json";
+        // Генерим запрос
+        const query = this.SERVER + '/api/' + this.version + '/' + table;
+        const json = {};
+        // Генерим условия
+        if (where !== undefined && where !== null)
+            json.where = where;
+        if (tree !== undefined && tree !== null)
+            json.tree = tree;
+        if (fields !== undefined && fields !== null)
+            json.fields = fields;
+        if (sortfields !== undefined && sortfields !== null)
+            json.sort = sortfields;
+        if (extfields !== undefined && extfields !== null)
+            json.extfields = extfields;
+        if (params !== undefined && params !== null)
+            json.params = params;
+        if (RemoveDuplicates !== undefined && RemoveDuplicates !== null)
+            json.RemoveDuplicates = true;
+        if (titles !== undefined && titles !== null)
+            json.titles = titles;
+        // экспорт
+        if (exportData !== undefined && exportData !== null) {
+            json.export = {
+                format: exportData.format ?? 'xlsx',
+                titles: exportData.titles ?? [],
+                filename: exportData.filename ?? 'export_' + Date.now() + ".xlsx",
+            };
+            responseType = "blob";
+        }
+        // Страницы
+        json['per-page'] = perPage === undefined ? this.perPageDefault : perPage;
+        json['page'] = page === undefined ? 1 : page;
+        return this.request(query, JSON.stringify(json), 'POST', responseType);
+    }
+    /**
+     * Получить все записи по запросу [постранично]
+     * @param {string} table
+     * @param {object} params
+     * @returns {Promise<Rows<T>>}
+     */
+    all(table, params) {
+        return this.get(table, params?.where, params?.extfields, params?.fields, params?.sort, params?.page, params?.perPage, undefined, undefined, undefined, params?.tree, params?.params, params?.export);
+    }
+    /**
+       * Получить одну запись по ID или по условию выборки [первая запись]
+       * @param {string} table
+       * @param {number|string|object} IDOrWhere
+       * @param {object|Array} extfields
+       * @param {object|Array} fields
+       * @param {string} primaryKeyName если указан ID, то указать название первичного ключа, если от id он отличается
+     */
+    async one(table, IDOrWhere, extfields = null, fields = null, primaryKeyName = 'id') {
+        let where = {};
+        if (typeof IDOrWhere === 'string' || typeof IDOrWhere === 'number')
+            where = { [primaryKeyName]: IDOrWhere };
+        else if (typeof IDOrWhere === 'object')
+            where = IDOrWhere;
+        else
+            throw new Error("Нужно передавать ID или объект");
+        const resp = await this.get(table, where, extfields, fields, null, 1, 1);
+        if (resp.errors)
+            return Promise.reject(resp);
+        if (!resp.data || resp.data.length === 0)
+            return null;
+        return resp.data[0];
+    }
+    /**
+     * Создать новую запись
+     * @param {string} table
+     * @param {object} values
+     * @param {number|string|null} appendTo
+     * @param {number|string|null} insertAfter
+     * @param {boolean|null} insertFirst
+     */
+    async create(table, values, appendTo = null, insertAfter = null, insertFirst = null) {
+        // Нормализуем имена таблиц
+        table = table.replace(/_/g, "");
+        // Подготовить значения
+        if (!(values instanceof FormData)) {
+            await this.prepare(values);
+        }
+        return this.request(this.SERVER + '/api/' + this.version + '/' + table + '/create?'
+            + (appendTo !== null ? '&appendTo=' + appendTo : '')
+            + (insertAfter !== null ? '&insertAfter=' + insertAfter : '')
+            + (insertFirst !== null ? '&insertFirst=' + insertFirst : ''), (values instanceof FormData ? values : JSON.stringify(values)), 'POST');
+    }
+    /**
+     * Удалить запись
+     * @param {string} table
+     * @param {number|string} id
+     * @param {object|null} byFields Если указан, удаляет по этим параметрам
+     */
+    async remove(table, id = 0, byFields = null) {
+        // Нормализуем имена таблиц
+        table = table.replace(/_/g, "");
+        let params = {};
+        if (byFields instanceof Object)
+            params = byFields;
+        const resp = await this.request(this.SERVER + '/api/' + this.version + '/' + table + '/delete?id=' + id, JSON.stringify(params), 'DELETE');
+        if (resp.status === 204)
+            return true;
+        return resp;
+    }
+    /**
+     * Редактировать значения
+     * @param {string} table
+     * @param {number|string} ID
+     * @param {object} values
+     * @param {number|string|null} appendTo
+     * @param {number|string|null} insertAfter
+     * @param {boolean|null} insertFirst
+     */
+    async edit(table, ID, values, appendTo = null, insertAfter = null, insertFirst = null) {
+        // Нормализуем имена таблиц
+        table = table.replace(/_/g, "");
+        // Подготовить значения
+        if (!(values instanceof FormData)) {
+            await this.prepare(values);
+        }
+        return this.request(this.SERVER + '/api/' + this.version + '/' + table + '/update?id=' + ID
+            + (appendTo !== null ? '&appendTo=' + appendTo : '')
+            + (insertAfter !== null ? '&insertAfter=' + insertAfter : '')
+            + (insertFirst !== null ? '&insertFirst=' + insertFirst : ''), (values instanceof FormData ? values : JSON.stringify(values)), 'POST');
+    }
+    /**
+     * Получить схемы всех таблиц
+     */
+    getCRUDInfo() {
+        if (typeof window !== 'undefined' && window.sessionStorage) {
+            const cachedSchema = window.sessionStorage.getItem("crudschema");
+            if (cachedSchema) {
+                return new Promise((resolve) => { resolve(JSON.parse(cachedSchema)); });
+            }
+        }
+        return this.request(this.SERVER + '/site/crudschema', {}, 'GET')
+            .then(res => {
+            if (typeof window !== 'undefined' && window.sessionStorage) {
+                // Кешируем схему в браузере на время текущей сессии (в пределах ОДНОЙ вкладки)
+                window.sessionStorage.setItem("crudschema", JSON.stringify(res));
+            }
+            return res;
+        });
+    }
+    /**
+     * Авторизоваться
+     * @param {string|undefined} username
+     * @param {string|undefined} password
+     * @param {object|string|null} pushNotificationToken
+     */
+    async auth(username, password, pushNotificationToken) {
+        let resp;
+        if (this.token && !username) {
+            resp = await this.request(this.SERVER + '/auth/auth', JSON.stringify({}), 'POST', 'json', true);
+        }
+        else {
+            resp = await this.request(this.SERVER + '/auth/auth', JSON.stringify({ login: username, password: password, pushNotificationToken: (pushNotificationToken ?? this.pushNotificationToken ?? null) }), 'POST', 'json', false);
+        }
+        if (resp.errors || !resp.data) {
+            return Promise.reject(resp.errors ?? new Error("No data received"));
+        }
+        // после успешной авторизации устанавливаем токен
+        if (typeof resp.data.token === 'string')
+            this.token = resp.data.token;
+        // Сохраняем хеш юзера автоматически (только на клиенте)
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const user_hash = window.localStorage.getItem('user_hash');
+            if (resp?.data?.User?.user_hash && resp.data.User.user_hash !== user_hash) {
+                window.localStorage.setItem('user_hash', resp.data.User.user_hash);
+            }
+        }
+        return resp.data;
+    }
+    /**
+     * Зарегистрироваться с этим логином и паролем
+     * @param {string|null} email
+     * @param {string|null} username
+     * @param {string} password
+     * @param {string|null} name
+     * @param {object|string|null} pushNotificationToken
+     * @param {any} data
+     */
+    async signup(email, username, password, name = null, pushNotificationToken = null, data = null) {
+        const resp = await this.request(this.SERVER + '/auth/signup', JSON.stringify({
+            login: username, email: email, password: password,
+            name: name, data: data, pushNotificationToken: (pushNotificationToken ?? this.pushNotificationToken ?? null)
+        }), 'POST', 'json', false);
+        if (resp.errors || !resp.data) {
+            return Promise.reject(resp.errors ?? new Error("No data received"));
+        }
+        // после успешной авторизации устанавливаем токен
+        if (typeof resp.data.token === 'string')
+            this.token = resp.data.token;
+        return resp.data;
+    }
+    /**
+     * Выйти из системы
+     */
+    logout() {
+        return this.request(this.SERVER + '/auth/logout', '{}', 'POST');
+    }
+    /**
+     * Восстановление пароля
+     * Запрос на восстановление пароля
+     * @param {*} email
+     * @returns
+     */
+    async ResetPasswordRequest(email) {
+        const resp = await this.request(this.SERVER + '/auth/resetpasswordrequest', JSON.stringify({ email: email }), 'POST', 'json', false);
+        if (resp.errors || !resp.data)
+            return Promise.reject(resp.errors ?? new Error("No data received"));
+        return resp.data;
+    }
+    /**
+     * Восстановление пароля
+     * Проверка токена восстановления
+     * @param {*} token токен подтверждения
+     * @returns
+     */
+    async ResetPasswordTokenCheck(token) {
+        const resp = await this.request(this.SERVER + '/auth/resettokencheck', JSON.stringify({ token: token }), 'POST', 'json', false);
+        if (resp.errors || !resp.data)
+            return Promise.reject(resp.errors ?? new Error("No data received"));
+        return resp.data;
+    }
+    /**
+     * Восстановление пароля
+     * Сохранение нового пароля
+     * @param {*} token
+     * @param {*} password
+     * @returns
+     */
+    async ResetPasswordSaveNewPassword(token, password) {
+        const resp = await this.request(this.SERVER + '/auth/resetconfirm', JSON.stringify({ token: token, password: password }), 'POST', 'json', false);
+        if (resp.errors || !resp.data)
+            return Promise.reject(resp.errors ?? new Error("No data received"));
+        return resp.data;
+    }
+    /**
+     * Подготовить объект под загрузку: загрузить данные из элементов Input [type=file] / Clipboard / DataTransfer [Drag&Drop/Clipboard]
+     * @param {object} values
+     */
+    async prepare(values, asFormData = false) {
+        // В SSR этот метод не будет обрабатывать файлы, т.к. DOM и File API недоступны.
+        if (typeof window === 'undefined') {
+            return values;
+        }
+        // Если в один из параметров передан FileList или input[type=file], т.е. нужно загрузить файлы
+        const formData = new FormData();
+        for (let val in values) {
+            // Пустые значения нам не нужны
+            if (values[val] === undefined || values[val] === null)
+                continue;
+            // Любой вариант захода делаем массивом
+            let valuesArr = Array.isArray(values[val]) ? values[val] : [values[val]];
+            // Идём по каждому значению в массиве
+            for (let valueKey in valuesArr) {
+                let value = valuesArr[valueKey];
+                // Преобразуем
+                let isRef = false;
+                if (value instanceof Object
+                    && value.hasOwnProperty('_value')
+                    && (value._value instanceof Event ||
+                        value._value instanceof HTMLInputElement ||
+                        value._value instanceof ClipboardEvent ||
+                        value._value instanceof DataTransfer ||
+                        value._value instanceof FileList)) {
+                    value = value.value;
+                    isRef = true;
+                }
+                if (value instanceof Event && value.target instanceof HTMLInputElement && value.target.type === 'file')
+                    value = value.target.files;
+                if (value instanceof HTMLInputElement && value.type === 'file')
+                    value = value.files;
+                if (value instanceof ClipboardEvent)
+                    value = value.clipboardData?.files;
+                if (value instanceof DataTransfer)
+                    value = value.files;
+                if (value instanceof FileList) {
+                    const newValues = [];
+                    const files = Array.from(value);
+                    for (let index = 0; index < files.length; index++) {
+                        formData.append(val + "[]", files[index]);
+                        newValues.push({
+                            'name': files[index].name,
+                            'data': asFormData ? null : await this.readFileAsync(files[index]),
+                            'number': index,
+                            'id': this.generateID(32)
+                        });
+                    }
+                    if (Array.isArray(values[val])) {
+                        values[val].splice(parseInt(valueKey), 1, ...newValues);
+                    }
+                    else {
+                        values[val] = newValues;
+                    }
+                }
+            }
+        }
+        formData.append("json", JSON.stringify(values));
+        return asFormData ? formData : values;
+    }
+    /**
+     * Прочесть файл асинхронно
+     * @param {File} file
+     * @param {'data' | 'text'} readAs
+     * @returns {Promise<string>}
+     */
+    readFileAsync(file, readAs = 'data') {
+        return new Promise((resolve, reject) => {
+            let reader = new FileReader();
+            reader.onloadend = () => { resolve(reader.result); };
+            reader.onerror = reject;
+            if (readAs === 'data')
+                reader.readAsDataURL(file);
+            if (readAs === 'text')
+                reader.readAsText(file);
+        });
+    }
+    /**
+     * Заполнить существующий объект пришедшими из БД данными
+     * сохраняя при этом оригинальные классы и функции
+     * @param {*} object
+     * @param {*} values
+     */
+    fillObject(object, values) {
+        for (let prop in object) {
+            if (!values.hasOwnProperty(prop))
+                continue;
+            if (typeof values[prop] === 'object' && typeof object[prop] === 'object' && values[prop] !== null && object[prop] !== null) {
+                this.fillObject(object[prop], values[prop]);
+                continue;
+            }
+            object[prop] = values[prop];
+        }
+        return object;
+    }
+    generateID(length) {
+        let result = '';
+        const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        const charactersLength = characters.length;
+        let counter = 0;
+        while (counter < length) {
+            result += characters.charAt(Math.floor(Math.random() * charactersLength));
+            counter += 1;
+        }
+        return result;
+    }
+    /**
+     * Вычисляет на лету детерминированную строку, которая будет использоваться как часть ключа для подписи.
+     * Ключ генерируется на основе последовательности числовых преобразований, что делает его неочевидным
+     * при статическом анализе кода. Этот метод всегда возвращает один и тот же результат.
+     * @returns {string} Детерминированно сгенерированная строка.
+     */
+    getDeterministicKeyPart() {
+        // Начальная последовательность чисел. Она может быть любой, главное - постоянной.
+        const sequence = [5, 12, 23, 8, 17, 3, 29, 14, 31, 2, 11, 28, 7, 20, 1, 16, 22, 5, 13, 19, 4, 25, 10, 30, 9, 21, 6, 18, 27, 15, 24, 26];
+        // "Магическое число" для усложнения преобразований.
+        const magicNumber = 177;
+        let result = '';
+        for (let i = 0; i < sequence.length; i++) {
+            const num = sequence[i];
+            let charCode;
+            // В зависимости от позиции применяем разные преобразования,
+            // чтобы получить символы в разных регистрах и цифры.
+            switch (i % 3) {
+                case 0:
+                    // Генерируем заглавную букву (A-Z)
+                    charCode = (num * magicNumber + i) % 26;
+                    result += String.fromCharCode(65 + charCode);
+                    break;
+                case 1:
+                    // Генерируем строчную букву (a-z)
+                    charCode = (num + magicNumber * (i + 1)) % 26;
+                    result += String.fromCharCode(97 + charCode);
+                    break;
+                case 2:
+                    // Генерируем цифру (0-9)
+                    charCode = (num * (i + 1) + magicNumber) % 10;
+                    result += String.fromCharCode(48 + charCode);
+                    break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Создаёт подпись для запроса на основе его параметров, используя лучшие практики.
+     * Собирает все GET и POST параметры, сортирует их и формирует каноническую строку для хеширования.
+     * @param url URL запроса, включая GET-параметры.
+     * @param params POST-параметры запроса (в виде объекта).
+     * @returns Promise<string> Строка подписи.
+     */
+    async _generateRequestSignature(url, params) {
+        const secretKey = (this.token ?? '') + this.getDeterministicKeyPart();
+        // Если параметры - это FormData или не объект, мы не можем их надежно обработать для подписи.
+        // В этом случае подписываем пустую строку, как и раньше.
+        if (params instanceof FormData || typeof params !== 'object' || params === null) {
+            return this.hmac_sha256('', secretKey);
+        }
+        const allParams = {};
+        // 1. Извлекаем GET-параметры из URL
+        if (url.includes('?')) {
+            const queryString = url.split('?')[1];
+            const urlParams = new URLSearchParams(queryString);
+            urlParams.forEach((value, key) => {
+                allParams[key] = value;
+            });
+        }
+        // 2. Добавляем POST-параметры из тела запроса
+        Object.assign(allParams, params);
+        // 3. Создаём каноническую строку
+        // Сортируем ключи для консистентности
+        const sortedKeys = Object.keys(allParams).sort();
+        // Формируем строку вида "key1=value1&key2=value2..."
+        const canonicalString = sortedKeys
+            .map(key => {
+            const value = allParams[key];
+            // Пропускаем null и undefined значения, они не участвуют в подписи
+            if (value === null || value === undefined) {
+                return '';
+            }
+            // Если значение - объект (включая массив), заменяем его на слово "object" для консистентности подписи.
+            const stringValue = (typeof value === 'object' && value !== null) ? 'object' : String(value);
+            return `${encodeURIComponent(key)}=${encodeURIComponent(stringValue)}`;
+        })
+            .filter(part => part !== '') // Убираем пустые части
+            .join('&');
+        return this.hmac_sha256(canonicalString, secretKey);
+    }
+    /**
+     *
+     * @param {string} data
+     * @param {string} key
+     * @returns
+     */
+    async hmac_sha256(message, secret_key) {
+        if (message === null || message === undefined)
+            message = "";
+        if (typeof message !== 'string')
+            message = JSON.stringify(message);
+        const enc = new TextEncoder();
+        const encodedKey = enc.encode(secret_key);
+        const encodedMessage = enc.encode(message);
+        const data = encodedMessage;
+        const key = encodedKey;
+        if (typeof window === 'undefined') {
+            // Динамически импортируем модуль 'crypto' для Node.js, чтобы избежать ошибок на фронтенде,
+            // где этот модуль недоступен.
+            // @ts-ignore
+            const { createHmac } = await import('crypto');
+            const hash = createHmac('sha256', key).update(data).digest('hex');
+            return Promise.resolve(hash);
+        }
+        else {
+            if (typeof window.crypto?.subtle === 'undefined')
+                return Promise.resolve("");
+            return window.crypto.subtle
+                .importKey('raw', key, { name: 'HMAC', hash: { name: 'SHA-256' } }, false, ['sign', 'verify'])
+                .then(key => window.crypto.subtle.sign('HMAC', key, data))
+                .then(signature => {
+                const signatureArray = new Uint8Array(signature);
+                return Array.from(signatureArray)
+                    .map(byte => byte.toString(16).padStart(2, '0'))
+                    .join('');
+            });
+        }
+    }
+}
+/**
+ * Экземпляр-синглтон класса FLAMEREST.
+ * Используйте его для всех запросов в приложении.
+ * `import REST from './REST.ts';`
+ */
+const REST = new FLAMEREST();
+if (typeof window !== 'undefined') {
+    window.REST = REST;
+}
+export default REST;

package/REST.ts

@@ -103,6 +103,12 @@ export class FLAMEREST {
      */
     public version: string;
 
+    /**
+     * Версия кода клиента (отправляется в заголовке каждого запроса).
+     * Можно установить извне: REST.VERSION_CODE = "1.2.3"
+     */
+    public VERSION_CODE: string = "1.0.0";
+
     /**
      * Если авторизация по токену, то он сюда подставляется
      */
@@ -171,9 +177,15 @@ export class FLAMEREST {
      */
     async request(url: string, params: object | string | FormData, type: 'GET' | 'POST' | 'PUT' | 'DELETE' = 'GET', responseType: 'json' | 'blob' = 'json', isNeedToken = true, customHeaders: Record<string, string> = {}): Promise<BaseResponse<any> & Partial<Paginated>> {
 
-        // Подставляем сервер автоматом в запрос начинающийся с /
-        if (url[0] === '/' && url[1] !== '/') {
-            url = this.SERVER + url;
+        // Подставляем сервер автоматом если URL не содержит протокол
+        // Не трогаем URL с явным протоколом (http://, https://) или протокол-независимые (//)
+        if (!url.startsWith('http://') && !url.startsWith('https://') && !url.startsWith('//')) {
+            // Убираем начальный "/" если он есть, т.к. SERVER уже без слэша в конце
+            if (url[0] === '/') {
+                url = url.substring(1);
+            }
+            // Добавляем SERVER с разделителем "/"
+            url = this.SERVER + '/' + url;
         }
 
         // Создаём подпись запроса до его модификации
@@ -225,6 +237,9 @@ export class FLAMEREST {
                         headers['Content-type'] = 'application/json; charset=utf-8';
                     }
 
+                    // Версия кода клиента — уходит с каждым запросом
+                    headers['version'] = this.VERSION_CODE;
+
                     const requestBody: RequestInit = {
                         method: type,
                         mode: 'cors',
@@ -233,7 +248,7 @@ export class FLAMEREST {
 
                     if (type !== 'GET') {
                         // Принимает и formData тоже и чистую json строку
-                        requestBody.body = params;
+                        requestBody.body = params as any;
                     }
 
                     // Добавляем подпись в заголовки
@@ -376,6 +391,8 @@ export class FLAMEREST {
                 xhr.open(type, url, true);
                 xhr.responseType = 'json';
                 xhr.setRequestHeader('Content-type', 'application/json; charset=utf-8');
+                // Версия кода клиента — уходит с каждым запросом (fallback без fetch)
+                xhr.setRequestHeader('version', this.VERSION_CODE);
                 xhr.withCredentials = false;
                 xhr.send(params as any);
 

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "flamerest",
-  "version": "1.0.126",
+  "version": "1.0.128",
   "description": "",
-  "main": "./REST.ts",
-  "typings": "./REST.ts",
+  "main": "REST.js",
+  "types": "REST.d.ts",
+  "type": "module",
   "exports": {
     ".": {
-      "import": "./REST.ts",
-      "types": "./REST.ts"
+      "import": "./REST.js",
+      "types": "./REST.d.ts"
     }
   },
   "scripts": {
-    "publishx": "git push && npm --no-git-tag-version version patch && npm publish"
+    "build": "tsc REST.ts --declaration --emitDeclarationOnly false --module ESNext --target ES2020",
+    "p": "npm run build && git push && npm --no-git-tag-version version patch && npm publish"
   },
   "repository": {
     "type": "git",

package/tsconfig.json

@@ -8,7 +8,6 @@
     ],
     "module": "ESNext",
     "types": [
-      "node"
     ],
     "moduleResolution": "Bundler",
     "strict": true,