@alizadefaig/pos-server 1.2.26 → 1.2.27

package/app/core/support/lock.js

@@ -0,0 +1,63 @@
+/**
+ * Очередь по ключу внутри процесса: fn с одним ключом выполняются строго по одной.
+ *
+ * Нужна там, где между чтением и записью есть await (номер чека: MAX(number) → INSERT).
+ * Мастер-касса обслуживает всё заведение, включая события, ретранслированные облаком, —
+ * два одновременных «открыть чек» иначе получили бы один и тот же номер.
+ * Работает в пределах одного процесса Node; для кассы с SQLite этого достаточно.
+ */
+const chains = new Map();
+
+/** Очередь не освободилась за waitMs — fn не запускалась. */
+class LockTimeoutError extends Error {
+    constructor(key) {
+        super(`Lock "${key}" is busy`);
+        this.name = 'LockTimeoutError';
+    }
+}
+
+const settlesWithin = (promise, ms) => new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(false), ms);
+    promise.then(() => {
+        clearTimeout(timer);
+        resolve(true);
+    });
+});
+
+/**
+ * @param {number|null} [options.waitMs] сколько ждать очередь; null — без ограничения.
+ *                                       Не дождались — LockTimeoutError, fn не вызывается.
+ */
+const withLock = async (key, fn, {waitMs = null} = {}) => {
+    const previous = chains.get(key) || Promise.resolve();
+    let release;
+    const current = new Promise((resolve) => {
+        release = resolve;
+    });
+    const tail = previous.then(() => current);
+    chains.set(key, tail);
+
+    if (waitMs !== null && !(await settlesWithin(previous, waitMs))) {
+        // Своё место в очереди отдаём сразу, но предыдущий ещё работает: ключ снимается,
+        // только когда он закончит, иначе следующий вызов прошёл бы мимо очереди.
+        release();
+        tail.then(() => {
+            if (chains.get(key) === tail) {
+                chains.delete(key);
+            }
+        });
+        throw new LockTimeoutError(key);
+    }
+
+    try {
+        await previous;
+        return await fn();
+    } finally {
+        release();
+        if (chains.get(key) === tail) {
+            chains.delete(key);
+        }
+    }
+};
+
+module.exports = {withLock, LockTimeoutError};

package/app/core/support/num.js

@@ -0,0 +1,51 @@
+/**
+ * Числа денег и количеств.
+ *
+ * В Laravel и MoneyCast, и UnitCast — это round($value, 3). Повторяем ровно это:
+ * ядро и облако считают одни и те же чеки, любое расхождение округления вылезет в выручке.
+ * PHP round() округляет «половину от нуля» (0.5 → 1, -0.5 → -1), JS Math.round — к +∞,
+ * поэтому знак обрабатываем отдельно.
+ */
+
+const round = (value, precision = 0) => {
+    const num = typeof value === 'number' ? value : parseFloat(value);
+    if (!Number.isFinite(num)) {
+        return 0;
+    }
+    const factor = Math.pow(10, precision);
+    // toPrecision(15) снимает двоичный «хвост»: 1.005 * 100 === 100.49999999999999
+    const scaled = Number((num * factor).toPrecision(15));
+    const rounded = scaled < 0 ? -Math.round(-scaled) : Math.round(scaled);
+    return rounded / factor;
+};
+
+const money = (value) => round(value, 3);
+const qty = (value) => round(value, 3);
+const round2 = (value) => round(value, 2);
+
+const toFloat = (value, fallback = 0) => {
+    const num = typeof value === 'number' ? value : parseFloat(value);
+    return Number.isFinite(num) ? num : fallback;
+};
+
+const toInt = (value, fallback = 0) => {
+    const num = parseInt(value, 10);
+    return Number.isFinite(num) ? num : fallback;
+};
+
+const toBool = (value) => {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return value !== 0;
+    }
+    if (typeof value === 'string') {
+        return value !== '' && value !== '0' && value.toLowerCase() !== 'false';
+    }
+    return Boolean(value);
+};
+
+const sum = (items, key) => items.reduce((carry, item) => carry + toFloat(item[key]), 0);
+
+module.exports = {round, round2, money, qty, toFloat, toInt, toBool, sum};

package/app/core/support/php.js

@@ -0,0 +1,125 @@
+const {toSql, parse} = require('./time');
+const {zonedParts, DEFAULT_TIMEZONE} = require('./tz');
+
+/**
+ * Как Laravel сериализует значения в ответах POS-API. Нужны там, где ответ Node обязан
+ * совпасть с PHP поле в поле: фронт и касса читают один и тот же JSON из обоих контуров.
+ */
+
+/** Дата модели в toArray()/JsonResource (serializeDate): '2026-09-24T10:00:00.000000Z'. */
+const isoDate = (value) => {
+    const sql = toSql(value);
+    return sql ? `${sql.replace(' ', 'T')}.000000Z` : null;
+};
+
+/** Carbon::toIso8601String() в UTC: '2026-09-24T10:00:00+00:00'. */
+const iso8601 = (value) => {
+    const sql = toSql(value);
+    return sql ? `${sql.replace(' ', 'T')}+00:00` : null;
+};
+
+const pad = (value) => String(value).padStart(2, '0');
+
+/** $date->timezone($tz)->format('Y-m-d H:i:s'). Неизвестная зона — зона по умолчанию. */
+const formatInZone = (value, timeZone) => {
+    const date = parse(value);
+    if (!date) {
+        return '';
+    }
+    let parts;
+    try {
+        parts = zonedParts(date, timeZone || DEFAULT_TIMEZONE);
+    } catch (e) {
+        parts = zonedParts(date, DEFAULT_TIMEZONE);
+    }
+    return `${parts.year}-${pad(parts.month)}-${pad(parts.day)} ${pad(parts.hour)}:${pad(parts.minute)}:${pad(parts.second)}`;
+};
+
+const decode = (value) => {
+    if (typeof value !== 'string') {
+        return value === undefined ? null : value;
+    }
+    try {
+        return JSON.parse(value);
+    } catch (e) {
+        return null;
+    }
+};
+
+/**
+ * Каст 'array' → json_encode: JSON-объект стал PHP-массивом. Пустой объект уходит как [],
+ * объект с ключами 0..n-1 по порядку — как список. Строка из БД разбирается (невалидная → null).
+ * ⚠️ JS ставит целочисленные ключи вперёд, поэтому {"1":…,"0":…} станет списком — PHP оставил бы
+ * объект. На реальных настройках таких ключей нет.
+ */
+const phpArray = (value) => {
+    const decoded = decode(value);
+    const walk = (item) => {
+        if (Array.isArray(item)) {
+            return item.map(walk);
+        }
+        if (item === null || typeof item !== 'object') {
+            return item;
+        }
+        const keys = Object.keys(item);
+        if (keys.every((key, index) => key === String(index))) {
+            return keys.map((key) => walk(item[key]));
+        }
+        const result = {};
+        for (const key of keys) {
+            result[key] = walk(item[key]);
+        }
+        return result;
+    };
+    return walk(decoded);
+};
+
+/** Приведение массива '0'/'1' → bool по всему дереву (Table::convertToBoolean). */
+const deepZeroOneToBool = (value) => {
+    if (Array.isArray(value)) {
+        return value.map(deepZeroOneToBool);
+    }
+    if (value !== null && typeof value === 'object') {
+        const result = {};
+        for (const [key, item] of Object.entries(value)) {
+            result[key] = deepZeroOneToBool(item);
+        }
+        return result;
+    }
+    if (value === '0') {
+        return false;
+    }
+    if (value === '1') {
+        return true;
+    }
+    return value;
+};
+
+/** array_map верхнего уровня: '0'/'1' → bool (TeamManageSettingsCast / TeamTerminalSettingsCast). */
+const zeroOneToBool = (value) => {
+    const map = (item) => (item === '0' ? false : item === '1' ? true : item);
+    if (Array.isArray(value)) {
+        return value.map(map);
+    }
+    const result = {};
+    for (const [key, item] of Object.entries(value || {})) {
+        result[key] = map(item);
+    }
+    return result;
+};
+
+/** filter_var($value, FILTER_VALIDATE_BOOLEAN). */
+const filterBool = (value) => {
+    if (value === true) {
+        return true;
+    }
+    if (typeof value === 'number') {
+        return value === 1;
+    }
+    if (typeof value === 'string') {
+        return ['1', 'true', 'on', 'yes'].includes(value.trim().toLowerCase());
+    }
+    return false;
+};
+
+module.exports = {isoDate, iso8601, formatInZone, phpArray, deepZeroOneToBool, zeroOneToBool, filterBool};

package/app/core/support/pin.js

@@ -0,0 +1,34 @@
+const {createHmac} = require('node:crypto');
+
+/**
+ * Порт App\Support\PinExposure: как PIN и IC-карта сотрудников уходят в app.init.
+ *
+ * USER_PIN_EXPOSURE=plain (дефолт) — открытыми, как раньше. `hash` — вместо значений
+ * HMAC-SHA256 с солью команды; соль выводится из APP_KEY так же, как в Laravel, поэтому
+ * хеши облака, кассы и Laravel совпадают и снапшоты можно возить между ними.
+ */
+const hashed = () => String(process.env.USER_PIN_EXPOSURE || 'plain').trim().toLowerCase() === 'hash';
+
+const hmac = (key, value) => createHmac('sha256', String(key)).update(String(value)).digest('hex');
+
+const salt = (teamId) => {
+    const key = process.env.APP_KEY;
+    if (!key) {
+        // Соль без ключа совпала бы у всех инсталляций — лучше явный отказ, чем «хеш» без секрета.
+        throw new Error('APP_KEY is required for USER_PIN_EXPOSURE=hash');
+    }
+    // config('app.key') — строка как есть, вместе с префиксом 'base64:'.
+    return hmac(key, `pin-salt|${teamId ?? ''}`);
+};
+
+const hash = (value, pinSalt) => (value === null || value === undefined || value === '' ? null : hmac(pinSalt, value));
+
+const fields = (pin, icCard, teamId) => {
+    if (!hashed()) {
+        return {pin, ic_card: icCard};
+    }
+    const pinSalt = salt(teamId);
+    return {pin: null, ic_card: null, pin_hash: hash(pin, pinSalt), ic_card_hash: hash(icCard, pinSalt)};
+};
+
+module.exports = {hashed, salt, hash, fields};

package/app/core/support/receipts.js

@@ -0,0 +1,278 @@
+/**
+ * Настройки чеков команды — порт App\Casts\TeamReceiptsSettingsCast (+ хелпер convertToBoolean).
+ *
+ * В Laravel `$team->settings['receipts']` никогда не читается «сырым»: каст подставляет дефолтные
+ * конфиги чеков, символ валюты, строку депозита и приводит '0'/'1' к boolean. Конфиг уезжает на
+ * терминал внутри сокет-запроса печати и там рендерится как есть, поэтому ядро обязано собрать
+ * ТОТ ЖЕ объект, иначе один и тот же чек из облака и из офлайна выглядел бы по-разному.
+ */
+
+const DEFAULT_SYMBOL = '₼';
+
+const lineConfig = () => ({
+    type: {
+        type: 'select',
+        value: 'solid',
+        label: 'Xətt tipi',
+        options: [
+            {value: 'solid', label: 'Düz xətt'},
+            {value: 'dashed', label: 'Qırıq xətt'},
+        ],
+    },
+});
+
+// Дефолты — дословно из каста (порядок ключей тоже: терминал обходит rows по порядку).
+const defaultBillReceiptConfig = (symbol) => ({
+    container: {
+        gutter: 0,
+        symbol,
+        fontWeight: 500,
+        fontFamily: 'monospace',
+    },
+    rows: [
+        {print: true, type: 'logo', label: 'Logo', position: 0},
+        {print: true, type: 'print_name', size: 0, label: 'Space/Məkan adı', position: 1},
+        {print: true, type: 'order_source_type', size: 0, label: 'Sifariş üsulu', position: 2},
+        {print: true, type: 'number', label: 'Çek №', size: 0, position: 3},
+        {print: true, type: 'cashier', size: 0, label: 'Kassir', position: 4},
+        {print: true, type: 'waiter', size: 0, label: 'Qarson', position: 5},
+        {print: true, type: 'opened_at', size: 0, label: 'Açılma tarixi', position: 6},
+        {print: true, type: 'closed_at', size: 0, label: 'Bağlanma tarixi', position: 7},
+        {print: true, type: 'printed_at', size: 0, label: 'Çap tarixi', position: 8},
+        {print: true, type: 'line', config: lineConfig(), label: 'Xətt', position: 9},
+        {
+            print: true,
+            type: 'order_products',
+            size: 0,
+            config: {
+                modifications: {type: 'boolean', label: 'Modifikatorlar', value: false},
+                discount: {type: 'boolean', label: 'Endirim', value: false},
+                service_charge: {type: 'boolean', label: 'Servis haqqı', value: false},
+            },
+            label: 'Məhsullar',
+            position: 10,
+        },
+        {print: true, type: 'line', config: lineConfig(), label: 'Xətt', position: 11},
+        {print: true, type: 'subtotal', size: 1, label: 'Cəm', position: 12},
+        {print: true, type: 'discount', size: 1, label: 'Endirim', position: 13},
+        {print: true, type: 'service_charge', size: 1, label: 'Servis haqqı', position: 14},
+        {print: true, type: 'total', size: 2, label: 'Yekun', position: 15},
+        {print: true, type: 'comment', size: 0, label: 'Şərh', position: 16},
+        {
+            print: true,
+            type: 'payments',
+            size: 1,
+            config: {
+                change: {value: false, label: 'Qalıq', type: 'boolean'},
+            },
+            label: 'Ödənişlər',
+            position: 17,
+        },
+        {print: true, type: 'id', size: 0, label: 'ID', position: 18},
+        {print: true, type: 'delivery_address', size: 0, label: 'Çatdırılma ünvanı', position: 19},
+        {print: true, type: 'courier', size: 0, label: 'Kuryer', position: 20},
+        {print: true, type: 'powered', draggable: false, size: 0, label: 'Powered by 002 Group', position: 21},
+    ],
+});
+
+const defaultWorkshopReceiptConfig = () => ({
+    container: {
+        gutter: 0,
+        fontWeight: 500,
+        fontFamily: 'monospace',
+    },
+    rows: [
+        {print: true, type: 'number', size: 1, label: 'Çek №', position: 0},
+        {print: true, type: 'order_source', size: 1, label: 'Sifariş üsulu/Masa', position: 0},
+        {print: true, type: 'printed_at', size: 1, label: 'Çap tarixi', position: 0},
+        {print: true, type: 'terminal', size: 1, label: 'Terminal', position: 0},
+        {print: true, type: 'comment', size: 1, label: 'Şərh', position: 0},
+        {print: true, type: 'guest_count', size: 1, label: 'Qonaq sayı', position: 0},
+        {print: true, type: 'waiter', size: 1, label: 'Qarson/Kuryer', position: 0},
+        {print: true, type: 'workshop', size: 1, label: 'Şöbə', position: 0},
+        {print: true, type: 'line', config: lineConfig(), label: 'Xətt', position: 9},
+        {
+            print: true,
+            type: 'products',
+            size: 1,
+            config: {
+                modifications: {type: 'boolean', label: 'Modifikatorlar', value: true},
+                comment: {type: 'boolean', label: 'Şərh', value: true},
+                line: {type: 'boolean', label: 'Xətt', value: true},
+            },
+            label: 'Məhsullar',
+            position: 0,
+        },
+    ],
+});
+
+const isPlainObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const isContainer = (value) => value !== null && typeof value === 'object';
+
+/**
+ * Истинность по правилам PHP (`if ($x)`, `(bool)$x`). Отличается от toBool ядра: строка
+ * 'false' в PHP истинна, пустой массив/объект — ложен. Нужна там, где Laravel проверяет
+ * значение настройки или параметра запроса «как есть», — иначе ветка печати разойдётся.
+ */
+const phpTruthy = (value) => {
+    if (value === null || value === undefined || value === false) {
+        return false;
+    }
+    if (typeof value === 'number') {
+        return value !== 0;
+    }
+    if (typeof value === 'string') {
+        return value !== '' && value !== '0';
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    if (typeof value === 'object') {
+        return Object.keys(value).length > 0;
+    }
+    return Boolean(value);
+};
+
+// is_numeric() PHP 8: число или числовая строка (допускает пробелы по краям и экспоненту).
+const NUMERIC_STRING = /^\s*[+-]?(\d+(\.\d*)?|\.\d+)([eE][+-]?\d+)?\s*$/;
+const isNumeric = (value) => (typeof value === 'number' && Number.isFinite(value))
+    || (typeof value === 'string' && NUMERIC_STRING.test(value));
+
+/**
+ * convertToBoolean($array, $booleanKeys, $numberKeys) из bootstrap/helpers.php: рекурсивно,
+ * '0'/'1' под булевыми ключами → false/true, числовое под числовыми ключами → (int).
+ * (int) в PHP отбрасывает дробную часть — отсюда Math.trunc, а не округление.
+ */
+const convertToBoolean = (value, booleanKeys = [], numberKeys = []) => {
+    if (!isContainer(value)) {
+        return value;
+    }
+    const result = Array.isArray(value) ? [] : {};
+    for (const [key, original] of Object.entries(value)) {
+        let item = original;
+        if (isContainer(item)) {
+            item = convertToBoolean(item, booleanKeys, numberKeys);
+        }
+        // Индексы списка — целые числа, а in_array(0, ['print']) в PHP 8 ложно: их не трогаем.
+        const namedKey = !Array.isArray(value);
+        if (namedKey && booleanKeys.includes(key)) {
+            if (item === '0') {
+                item = false;
+            }
+            if (item === '1') {
+                item = true;
+            }
+        }
+        if (namedKey && numberKeys.includes(key) && isNumeric(item)) {
+            item = Math.trunc(Number(item));
+        }
+        result[Array.isArray(value) ? Number(key) : key] = item;
+    }
+    return result;
+};
+
+const rowType = (row) => (isPlainObject(row) && row.type !== undefined ? row.type : null);
+
+/** Строка «Depozit» перед «Yekun», если её ещё нет — бэкфилл старых сохранённых конфигов. */
+const ensureDepositRow = (rows) => {
+    if (rows.some((row) => rowType(row) === 'deposit')) {
+        return rows;
+    }
+    const depositRow = {print: true, type: 'deposit', size: 1, label: 'Depozit', position: 14};
+    const totalIndex = rows.findIndex((row) => rowType(row) === 'total');
+    if (totalIndex === -1) {
+        return [...rows, depositRow];
+    }
+    return [...rows.slice(0, totalIndex), depositRow, ...rows.slice(totalIndex)];
+};
+
+/** У строки «Powered by» обязано быть поле size — иначе конструктор чека не даёт его выбрать. */
+const ensurePoweredSize = (rows) => rows.map((row) => {
+    if (rowType(row) === 'powered' && !Object.prototype.hasOwnProperty.call(row, 'size')) {
+        return {...row, size: 0};
+    }
+    return row;
+});
+
+// rows сохранённого конфига в JSON может оказаться объектом {"0": {...}} — PHP с ним работает
+// как со списком, поэтому и здесь приводим к массиву.
+const asRows = (rows) => {
+    if (Array.isArray(rows)) {
+        return rows;
+    }
+    return isPlainObject(rows) ? Object.values(rows) : [];
+};
+
+const withContainer = (config) => {
+    const next = {...config};
+    next.container = isPlainObject(config.container) ? {...config.container} : {};
+    return next;
+};
+
+const clone = (value) => (value === undefined ? undefined : JSON.parse(JSON.stringify(value)));
+
+/**
+ * Собирает `settings.receipts` так же, как его отдаёт Laravel после каста.
+ *
+ * @param {object|null} rawReceipts  settings.receipts из БД (строка JSON тоже годится)
+ * @param {string|null} currencySymbol символ валюты команды (currencies.symbol). null — валюты в
+ *        этом контуре нет (локальный снапшот без currencies): берём символ из сохранённого
+ *        конфига, иначе манат — других валют у действующих заведений нет.
+ */
+const normalizeReceipts = (rawReceipts, currencySymbol = null) => {
+    let raw = rawReceipts;
+    if (typeof raw === 'string') {
+        try {
+            raw = JSON.parse(raw);
+        } catch (e) {
+            raw = null;
+        }
+    }
+    raw = isContainer(raw) ? clone(raw) : {};
+
+    // array_map верхнего уровня: только строки '0'/'1', вложенное не трогается.
+    const receipts = Array.isArray(raw) ? {...raw} : raw;
+    for (const [key, item] of Object.entries(receipts)) {
+        if (item === '0') {
+            receipts[key] = false;
+        } else if (item === '1') {
+            receipts[key] = true;
+        }
+    }
+
+    const storedBill = isPlainObject(receipts.bill_receipt_config) ? receipts.bill_receipt_config : null;
+    const storedSymbol = storedBill && isPlainObject(storedBill.container) ? storedBill.container.symbol : null;
+    const symbol = currencySymbol ?? storedSymbol ?? DEFAULT_SYMBOL;
+
+    let bill = withContainer(storedBill || defaultBillReceiptConfig(symbol));
+    bill.container.symbol = symbol;
+    bill.container.fontFamily = bill.container.fontFamily ?? 'monospace';
+    bill.container.fontWeight = bill.container.fontWeight ?? 400;
+    bill.rows = ensurePoweredSize(ensureDepositRow(asRows(bill.rows)));
+
+    const storedWorkshop = isPlainObject(receipts.workshop_receipt_config) ? receipts.workshop_receipt_config : null;
+    let workshop = withContainer(storedWorkshop || defaultWorkshopReceiptConfig());
+    workshop.container.fontFamily = workshop.container.fontFamily ?? 'monospace';
+    workshop.container.fontWeight = workshop.container.fontWeight ?? 400;
+
+    receipts.workshop_receipt_config = convertToBoolean(workshop, ['print', 'value'], ['position', 'size']);
+    receipts.bill_receipt_config = convertToBoolean(bill, ['print', 'value'], ['position', 'size']);
+    return receipts;
+};
+
+/** `$config['rows']->where('type', $type)->first()` */
+const findRow = (config, type) => {
+    const rows = config ? asRows(config.rows) : [];
+    return rows.find((row) => rowType(row) === type) || null;
+};
+
+module.exports = {
+    DEFAULT_SYMBOL,
+    phpTruthy,
+    isNumeric,
+    convertToBoolean,
+    normalizeReceipts,
+    findRow,
+    defaultBillReceiptConfig,
+    defaultWorkshopReceiptConfig,
+};

package/app/core/support/rows.js

@@ -0,0 +1,38 @@
+/**
+ * Пакетная загрузка связей так, как это делает Eloquent: отдельный `WHERE … IN (…)` на связь,
+ * без N+1. Мягко удалённые строки отсекаются только под Postgres: в локальном снапшоте колонки
+ * deleted_at у части таблиц нет, как и удалённых строк.
+ */
+
+const IN_CHUNK = 10000;
+
+const unique = (values) => [...new Set(values.filter((value) => value !== null && value !== undefined && value !== '').map(String))];
+
+const groupBy = (rows, key) => {
+    const map = new Map();
+    for (const row of rows) {
+        const id = String(row[key]);
+        if (!map.has(id)) {
+            map.set(id, []);
+        }
+        map.get(id).push(row);
+    }
+    return map;
+};
+
+const indexBy = (rows, key = 'id') => new Map(rows.map((row) => [String(row[key]), row]));
+
+/** ` AND deleted_at IS NULL` под Postgres, пусто в SQLite. */
+const alive = (db, alias = null) => (db.dialect === 'pgsql' ? ` AND ${alias ? `${alias}.` : ''}deleted_at IS NULL` : '');
+
+/** `SELECT … WHERE column IN (:ids)` пачками — Postgres держит не больше 65535 параметров. */
+const whereIn = async (db, sql, ids, params = []) => {
+    const rows = [];
+    for (let i = 0; i < ids.length; i += IN_CHUNK) {
+        const chunk = ids.slice(i, i + IN_CHUNK);
+        rows.push(...await db.all(sql.replace('(:ids)', `(${chunk.map(() => '?').join(', ')})`), [...chunk, ...params]));
+    }
+    return rows;
+};
+
+module.exports = {unique, groupBy, indexBy, alive, whereIn};

package/app/core/support/str.js

@@ -0,0 +1,31 @@
+const {createHash} = require('node:crypto');
+
+// Комментарии к чеку и позициям Laravel прогоняет через htmlspecialchars перед сохранением —
+// значение уезжает в чек и в Telegram как есть, поэтому экранируем идентично.
+const htmlspecialchars = (value) => {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return String(value)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+};
+
+const md5 = (value) => createHash('md5').update(value).digest('hex');
+
+/**
+ * json_encode() в поведении PHP по умолчанию: слэши экранируются, не-ASCII уходит в \uXXXX.
+ *
+ * Нужно именно это, а не голый JSON.stringify: `modifications_sets_hash` = md5(json_encode(...)),
+ * по нему ищется существующая позиция чека для слияния. Названия модификаторов
+ * азербайджанские — при «родном» stringify хеш ядра и хеш Laravel разойдутся, и один и тот же
+ * товар с одними и теми же модификаторами перестанет склеиваться в одну строку чека.
+ */
+const phpJsonEncode = (value) => JSON.stringify(value)
+    .replace(/\//g, '\\/')
+    .replace(/[^\x00-\x7f]/g, (char) => '\\u' + char.charCodeAt(0).toString(16).padStart(4, '0'));
+
+module.exports = {htmlspecialchars, md5, phpJsonEncode};