@escapenavigator/utils 1.10.130 → 1.10.132

package/dist/functional-popover-panel-style.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared chrome for interactive Popover panels (pickers, calendars, menus).
+ * Use on the inner content wrapper (`ref={popoverRef}`), not on Tooltip.
+ */
+export declare const functionalPopoverPanelStyle: {
+    readonly background: "var(--color-bg-primary)";
+    readonly border: "1px solid var(--color-border-primary)";
+    readonly borderRadius: "var(--radius-m)";
+    readonly boxShadow: "var(--shadow-m)";
+    readonly padding: 12;
+    readonly boxSizing: "border-box";
+    readonly color: "var(--color-text-primary)";
+};
+export type FunctionalPopoverPanelStyle = typeof functionalPopoverPanelStyle;
+export declare const functionalPopoverPanel: (extra?: Record<string, string | number>) => Record<string, string | number>;

package/dist/functional-popover-panel-style.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.functionalPopoverPanel = exports.functionalPopoverPanelStyle = void 0;
+/**
+ * Shared chrome for interactive Popover panels (pickers, calendars, menus).
+ * Use on the inner content wrapper (`ref={popoverRef}`), not on Tooltip.
+ */
+exports.functionalPopoverPanelStyle = {
+    background: 'var(--color-bg-primary)',
+    border: '1px solid var(--color-border-primary)',
+    borderRadius: 'var(--radius-m)',
+    boxShadow: 'var(--shadow-m)',
+    padding: 12,
+    boxSizing: 'border-box',
+    color: 'var(--color-text-primary)',
+};
+const functionalPopoverPanel = (extra) => ({
+    ...exports.functionalPopoverPanelStyle,
+    ...extra,
+});
+exports.functionalPopoverPanel = functionalPopoverPanel;

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './convert-minutes-to-hhmm';
 export * from './convert-to-options';
 export * from './date';
 export * from './enum-to-options';
+export * from './functional-popover-panel-style';
 export * from './get-documents-links';
 export * from './get-full-name';
 export * from './get-handled-error-message';
@@ -17,7 +18,9 @@ export * from './promocode-nominal-rules';
 export * from './redirect';
 export * from './serialize-record';
 export * from './serialize-slot';
+export * from './slot-representative-price';
 export * from './tz-date';
+export * from './user-session-permissions';
 export * from './utm-touchpoints';
 export * from './validate-by-dto';
 export * from './validate-promocode';

package/dist/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./convert-minutes-to-hhmm"), exports);
 __exportStar(require("./convert-to-options"), exports);
 __exportStar(require("./date"), exports);
 __exportStar(require("./enum-to-options"), exports);
+__exportStar(require("./functional-popover-panel-style"), exports);
 __exportStar(require("./get-documents-links"), exports);
 __exportStar(require("./get-full-name"), exports);
 __exportStar(require("./get-handled-error-message"), exports);
@@ -33,7 +34,9 @@ __exportStar(require("./promocode-nominal-rules"), exports);
 __exportStar(require("./redirect"), exports);
 __exportStar(require("./serialize-record"), exports);
 __exportStar(require("./serialize-slot"), exports);
+__exportStar(require("./slot-representative-price"), exports);
 __exportStar(require("./tz-date"), exports);
+__exportStar(require("./user-session-permissions"), exports);
 __exportStar(require("./utm-touchpoints"), exports);
 __exportStar(require("./validate-by-dto"), exports);
 __exportStar(require("./validate-promocode"), exports);

package/dist/quill-clipboard-matchers.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Paste-time matchers для ReactQuill (`modules.clipboard.matchers`).
+ *
+ * Вынесено в общий пакет, чтобы admin и app использовали один и тот же набор
+ * matcher-ов без дублирования. Делает две вещи на входе из буфера обмена:
+ *
+ * 1) Снимает inline-цвета и фоны (`color: false` / `background: false` через
+ *    compose Delta). Это лечит вставку из Word/Google Docs, которая по
+ *    умолчанию приходит с собственной палитрой и часто не читается на наших
+ *    темах (особенно тёмной теме ордеров и контрастных формах админки).
+ *
+ * 2) Заменяет неразрывные пробелы (`\u00A0`) на обычные прямо в Delta до
+ *    того, как Quill сохранит ноду. Без этого ` ` остаётся в HTML и
+ *    ломает word-wrap длинных заголовков и абзацев на странице рендера
+ *    (см. также `sanitizeQuillHtml` на стороне рендеринга — оно ловит то же
+ *    самое, но уже на исторических данных, которые попали в БД до того,
+ *    как paste-matcher появился).
+ *
+ * ELEMENT_NODE matcher срабатывает на всех элементах (страховой случай),
+ * SPAN/FONT — прицельно (Word любит оборачивать раскраску в `<span style="…">`
+ * и `<font color="…">`), TEXT_NODE — для нормализации пробелов в тексте.
+ */
+import Delta from 'quill-delta';
+export type ClipboardMatcher = [number | string, (node: Node, delta: Delta) => Delta];
+/**
+ * Полный набор matcher-ов: и color-strip, и nbsp-normalize. Подключается там,
+ * где редактор не должен принимать цветную раскраску из буфера (waiver, AGB,
+ * локации, контентные модалки).
+ */
+export declare function getStripColorClipboardMatchers(): ClipboardMatcher[];
+/**
+ * Только нормализация пробельных сущностей. Подключается там, где цветную
+ * раскраску в буфере мы готовы пустить дальше (rich email-редактор админа),
+ * но nbsp всё равно надо чистить, чтобы не ломать word-wrap.
+ */
+export declare function getNormalizeWhitespaceClipboardMatchers(): ClipboardMatcher[];
+/**
+ * Готовые `modules` для прямой подстановки в `<ReactQuill modules={…} />`.
+ *
+ * Содержит два изменения относительно дефолтного snow-конфига:
+ *
+ * 1) Тулбар без пикеров `color` / `background`. У нас цветной email-редактор
+ *    живёт ровно в одном месте (`admin/modals/email-send-form`); во всех
+ *    остальных формах цвета только мешают — пользователи случайно красили
+ *    текст оранжевым на белом фоне, а потом он становился нечитаемым в
+ *    тёмной теме клиента (orders/widget) или в письме на чёрном фоне.
+ *
+ * 2) Clipboard-matchers, которые на вставку из буфера снимают inline-цвета
+ *    и нормализуют `\u00A0` → ` ` (см. `getStripColorClipboardMatchers`).
+ */
+export declare const stripColorQuillModules: {
+    toolbar: (string[] | {
+        header: (number | boolean)[];
+    }[] | {
+        list: string;
+    }[] | {
+        indent: string;
+    }[] | {
+        align: any[];
+    }[])[];
+    clipboard: {
+        matchers: ClipboardMatcher[];
+    };
+};

package/dist/quill-clipboard-matchers.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Paste-time matchers для ReactQuill (`modules.clipboard.matchers`).
+ *
+ * Вынесено в общий пакет, чтобы admin и app использовали один и тот же набор
+ * matcher-ов без дублирования. Делает две вещи на входе из буфера обмена:
+ *
+ * 1) Снимает inline-цвета и фоны (`color: false` / `background: false` через
+ *    compose Delta). Это лечит вставку из Word/Google Docs, которая по
+ *    умолчанию приходит с собственной палитрой и часто не читается на наших
+ *    темах (особенно тёмной теме ордеров и контрастных формах админки).
+ *
+ * 2) Заменяет неразрывные пробелы (`\u00A0`) на обычные прямо в Delta до
+ *    того, как Quill сохранит ноду. Без этого ` ` остаётся в HTML и
+ *    ломает word-wrap длинных заголовков и абзацев на странице рендера
+ *    (см. также `sanitizeQuillHtml` на стороне рендеринга — оно ловит то же
+ *    самое, но уже на исторических данных, которые попали в БД до того,
+ *    как paste-matcher появился).
+ *
+ * ELEMENT_NODE matcher срабатывает на всех элементах (страховой случай),
+ * SPAN/FONT — прицельно (Word любит оборачивать раскраску в `<span style="…">`
+ * и `<font color="…">`), TEXT_NODE — для нормализации пробелов в тексте.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripColorQuillModules = void 0;
+exports.getStripColorClipboardMatchers = getStripColorClipboardMatchers;
+exports.getNormalizeWhitespaceClipboardMatchers = getNormalizeWhitespaceClipboardMatchers;
+const quill_delta_1 = __importDefault(require("quill-delta"));
+const stripColorFromDelta = (_node, delta) => delta.compose(new quill_delta_1.default().retain(delta.length(), {
+    color: false,
+    background: false,
+}));
+const normalizeWhitespaceInDelta = (_node, delta) => {
+    if (!delta?.ops?.length)
+        return delta;
+    let modified = false;
+    const ops = delta.ops.map((op) => {
+        if (typeof op.insert === 'string' && op.insert.indexOf('\u00A0') !== -1) {
+            modified = true;
+            return { ...op, insert: op.insert.replace(/\u00A0/g, ' ') };
+        }
+        return op;
+    });
+    return modified ? new quill_delta_1.default(ops) : delta;
+};
+/**
+ * Полный набор matcher-ов: и color-strip, и nbsp-normalize. Подключается там,
+ * где редактор не должен принимать цветную раскраску из буфера (waiver, AGB,
+ * локации, контентные модалки).
+ */
+function getStripColorClipboardMatchers() {
+    return [
+        [Node.ELEMENT_NODE, stripColorFromDelta],
+        ['SPAN', stripColorFromDelta],
+        ['FONT', stripColorFromDelta],
+        [Node.TEXT_NODE, normalizeWhitespaceInDelta],
+    ];
+}
+/**
+ * Только нормализация пробельных сущностей. Подключается там, где цветную
+ * раскраску в буфере мы готовы пустить дальше (rich email-редактор админа),
+ * но nbsp всё равно надо чистить, чтобы не ломать word-wrap.
+ */
+function getNormalizeWhitespaceClipboardMatchers() {
+    return [[Node.TEXT_NODE, normalizeWhitespaceInDelta]];
+}
+/**
+ * Готовые `modules` для прямой подстановки в `<ReactQuill modules={…} />`.
+ *
+ * Содержит два изменения относительно дефолтного snow-конфига:
+ *
+ * 1) Тулбар без пикеров `color` / `background`. У нас цветной email-редактор
+ *    живёт ровно в одном месте (`admin/modals/email-send-form`); во всех
+ *    остальных формах цвета только мешают — пользователи случайно красили
+ *    текст оранжевым на белом фоне, а потом он становился нечитаемым в
+ *    тёмной теме клиента (orders/widget) или в письме на чёрном фоне.
+ *
+ * 2) Clipboard-matchers, которые на вставку из буфера снимают inline-цвета
+ *    и нормализуют `\u00A0` → ` ` (см. `getStripColorClipboardMatchers`).
+ */
+exports.stripColorQuillModules = {
+    toolbar: [
+        [{ header: [1, 2, 3, false] }],
+        ['bold', 'italic', 'underline', 'strike'],
+        [{ list: 'ordered' }, { list: 'bullet' }],
+        [{ indent: '-1' }, { indent: '+1' }],
+        ['blockquote', 'code-block'],
+        [{ align: [] }],
+        ['link'],
+        ['clean'],
+    ],
+    clipboard: {
+        matchers: getStripColorClipboardMatchers(),
+    },
+};

package/dist/sanitize-quill-html.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Чистим Quill-HTML, который был сохранён без `clearQuill` или с устаревшей
+ * его версией (исторические waiver/AGB/`importantInfo`/локации/маркетинг-письма).
+ *
+ * Делит ответственность на две задачи, обе доступны и по отдельности:
+ *
+ * 1) `stripQuillColors` — снимает цвета и фоны: `style="color:…/background:…/
+ *    background-color:…"`, атрибуты `color="…"`/`data-color`/`data-background`
+ *    и Quill-классы `ql-color-*` / `ql-background-*`. Нужно везде, где тема
+ *    рендера отличается от темы редактора (тёмная тема ордеров на белом фоне
+ *    админки, инвертированные письма и т.п.).
+ *
+ * 2) `normalizeQuillWhitespace` — лечит неразрывные пробелы (` `, U+00A0)
+ *    и одиночные `<br>` внутри `<p>`/`<h*>`. nbsp браузер не считает точкой
+ *    переноса, и длинный заголовок вроде `14.&nbsp;ФОТО-,&nbsp;ВИДЕОФИКСАЦИЯ…`
+ *    превращается в одно «слово» и вылезает за контейнер. То же самое
+ *    случалось из-за вырезанных `<br>` в старом `clearQuill` — соседние строки
+ *    склеивались без разделителя. Меняем nbsp и одиночные `<br>` на пробел,
+ *    пустые `<p>`/`<p><br></p>` удаляем, дубли пробелов в тексте схлопываем.
+ *
+ * Содержимое `<pre>`/`<code>`/`<style>`/`<script>` не трогаем — там пробелы
+ * значимы.
+ *
+ * Все функции — чистые и идемпотентные: повторный вызов на уже очищенном
+ * HTML возвращает тот же результат (важно для сравнения «изменился ли текст»
+ * на стороне клиентских настроек, см. `client-agreement.tsx`).
+ */
+export type SanitizeQuillHtmlOptions = {
+    /** Снять inline-цвета/фоны и `ql-color-*`/`ql-background-*` классы. */
+    stripColors?: boolean;
+};
+export declare function stripQuillColors(html: string): string;
+export declare function normalizeQuillWhitespace(html: string): string;
+export declare function sanitizeQuillHtml(html: string | null | undefined, options?: SanitizeQuillHtmlOptions): string;

package/dist/sanitize-quill-html.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Чистим Quill-HTML, который был сохранён без `clearQuill` или с устаревшей
+ * его версией (исторические waiver/AGB/`importantInfo`/локации/маркетинг-письма).
+ *
+ * Делит ответственность на две задачи, обе доступны и по отдельности:
+ *
+ * 1) `stripQuillColors` — снимает цвета и фоны: `style="color:…/background:…/
+ *    background-color:…"`, атрибуты `color="…"`/`data-color`/`data-background`
+ *    и Quill-классы `ql-color-*` / `ql-background-*`. Нужно везде, где тема
+ *    рендера отличается от темы редактора (тёмная тема ордеров на белом фоне
+ *    админки, инвертированные письма и т.п.).
+ *
+ * 2) `normalizeQuillWhitespace` — лечит неразрывные пробелы (` `, U+00A0)
+ *    и одиночные `<br>` внутри `<p>`/`<h*>`. nbsp браузер не считает точкой
+ *    переноса, и длинный заголовок вроде `14.&nbsp;ФОТО-,&nbsp;ВИДЕОФИКСАЦИЯ…`
+ *    превращается в одно «слово» и вылезает за контейнер. То же самое
+ *    случалось из-за вырезанных `<br>` в старом `clearQuill` — соседние строки
+ *    склеивались без разделителя. Меняем nbsp и одиночные `<br>` на пробел,
+ *    пустые `<p>`/`<p><br></p>` удаляем, дубли пробелов в тексте схлопываем.
+ *
+ * Содержимое `<pre>`/`<code>`/`<style>`/`<script>` не трогаем — там пробелы
+ * значимы.
+ *
+ * Все функции — чистые и идемпотентные: повторный вызов на уже очищенном
+ * HTML возвращает тот же результат (важно для сравнения «изменился ли текст»
+ * на стороне клиентских настроек, см. `client-agreement.tsx`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripQuillColors = stripQuillColors;
+exports.normalizeQuillWhitespace = normalizeQuillWhitespace;
+exports.sanitizeQuillHtml = sanitizeQuillHtml;
+const COLOR_STYLE_PROPS = new Set(['color', 'background', 'background-color']);
+const COLOR_CLASS_PATTERN = /^ql-(color|background)-/;
+const PRESERVE_BLOCK_PATTERN = /<(pre|code|style|script)\b[^>]*>[\s\S]*?<\/\1>/gi;
+const PRESERVE_TOKEN_PREFIX = '\u2603SANITIZE_QUILL_PRESERVE_';
+const PRESERVE_TOKEN_SUFFIX = '\u2603';
+const PRESERVE_TOKEN_PATTERN = /\u2603SANITIZE_QUILL_PRESERVE_(\d+)\u2603/g;
+function cleanStyleAttribute(style) {
+    return style
+        .split(';')
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .filter((part) => {
+        const prop = part.split(':')[0]?.trim().toLowerCase() ?? '';
+        return prop && !COLOR_STYLE_PROPS.has(prop);
+    })
+        .join('; ');
+}
+function stripQuillColors(html) {
+    return html
+        .replace(/\s*style="([^"]*)"/gi, (_match, styleContent) => {
+        const cleaned = cleanStyleAttribute(styleContent);
+        return cleaned ? ` style="${cleaned}"` : '';
+    })
+        .replace(/\s*color="[^"]*"/gi, '')
+        .replace(/\s*class="([^"]*)"/gi, (_match, classContent) => {
+        const cleaned = classContent
+            .split(/\s+/)
+            .filter((token) => token && !COLOR_CLASS_PATTERN.test(token))
+            .join(' ');
+        return cleaned ? ` class="${cleaned}"` : '';
+    })
+        .replace(/\s*data-color="[^"]*"/gi, '')
+        .replace(/\s*data-background="[^"]*"/gi, '')
+        .replace(/<span>\s*<\/span>/gi, '')
+        .replace(/<font[^>]*>([\s\S]*?)<\/font>/gi, '$1');
+}
+function normalizeQuillWhitespace(html) {
+    const placeholders = [];
+    const withPlaceholders = html.replace(PRESERVE_BLOCK_PATTERN, (match) => {
+        const token = `${PRESERVE_TOKEN_PREFIX}${placeholders.length}${PRESERVE_TOKEN_SUFFIX}`;
+        placeholders.push(match);
+        return token;
+    });
+    const normalized = withPlaceholders
+        .replace(/&nbsp;|&#160;|&#xa0;|\u00A0/gi, ' ')
+        .replace(/<br\s*\/?>(?!\s*<\/p>)/gi, ' ')
+        .replace(/<p><br\s*\/?><\/p>/gi, '')
+        .replace(/<p>\s*<\/p>/gi, '')
+        .replace(/<br\s*\/?>/gi, '')
+        .replace(/>([^<]+)</g, function (_match, text) {
+        return `>${text.replace(/[ \t]{2,}/g, ' ')}<`;
+    });
+    return normalized.replace(PRESERVE_TOKEN_PATTERN, function (_match, idx) {
+        return placeholders[Number(idx)] || '';
+    });
+}
+/**
+ * Кэш результата по композитному ключу (опции + html). За один рендер
+ * страницы один и тот же `importantInfo`/`prepareText` может попасть в
+ * Typography.Text несколько раз (sidebar + основной блок), а контент
+ * договоров — это десятки КБ HTML. Ключи — конкретные строки полей из API,
+ * их за сессию ограниченное число, освобождаются с закрытием вкладки.
+ */
+const cache = new Map();
+function sanitizeQuillHtml(html, options) {
+    if (!html)
+        return '';
+    const stripColors = options?.stripColors ? '1' : '0';
+    const key = `${stripColors}|${html}`;
+    const cached = cache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const colorStripped = options?.stripColors ? stripQuillColors(html) : html;
+    const result = normalizeQuillWhitespace(colorStripped);
+    cache.set(key, result);
+    return result;
+}

package/dist/slot-representative-price.d.ts

@@ -0,0 +1,10 @@
+type SlotPriceSource = {
+    tariff?: unknown;
+    basePrice?: number;
+    discount?: number;
+};
+/** Минимальная положительная цена из тарифа (без скидки слота). */
+export declare const getTariffBasePrice: (tariff: unknown) => number | null;
+/** Цена «от» для слота в расписании (с учётом скидки слота). */
+export declare const getSlotRepresentativePrice: (slot: SlotPriceSource) => number | null;
+export {};

package/dist/slot-representative-price.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSlotRepresentativePrice = exports.getTariffBasePrice = void 0;
+const applySlotDiscount = (base, discount) => {
+    const value = discount || 0;
+    if (!value)
+        return base;
+    return base - Math.floor((base / 10000) * value);
+};
+/** Минимальная положительная цена из тарифа (без скидки слота). */
+const getTariffBasePrice = (tariff) => {
+    if (!tariff || typeof tariff !== 'object')
+        return null;
+    const raw = tariff;
+    const priceMap = raw.price && typeof raw.price === 'object' && raw.price !== null
+        ? raw.price
+        : raw;
+    const keys = Object.keys(priceMap)
+        .filter((k) => k !== 'child' && !Number.isNaN(Number(k)))
+        .map(Number)
+        .sort((a, b) => a - b);
+    for (const key of keys) {
+        const base = Number(priceMap[String(key)]);
+        if (Number.isFinite(base) && base > 0)
+            return base;
+    }
+    return null;
+};
+exports.getTariffBasePrice = getTariffBasePrice;
+/** Цена «от» для слота в расписании (с учётом скидки слота). */
+const getSlotRepresentativePrice = (slot) => {
+    const base = typeof slot.basePrice === 'number' && slot.basePrice > 0
+        ? slot.basePrice
+        : (0, exports.getTariffBasePrice)(slot.tariff);
+    if (base == null)
+        return null;
+    return applySlotDiscount(base, slot.discount);
+};
+exports.getSlotRepresentativePrice = getSlotRepresentativePrice;

package/dist/slot-representative-price.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/slot-representative-price.spec.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const slot_representative_price_1 = require("./slot-representative-price");
+describe('slot-representative-price', () => {
+    it('reads price from tariff.price map', () => {
+        expect((0, slot_representative_price_1.getTariffBasePrice)({
+            id: 1,
+            title: 'Default',
+            price: { 2: 10000, 3: 8000 },
+        })).toBe(10000);
+    });
+    it('reads price from plain price map', () => {
+        expect((0, slot_representative_price_1.getTariffBasePrice)({ 2: 5000, 4: 4000 })).toBe(5000);
+    });
+    it('skips zero min key and uses next positive price', () => {
+        expect((0, slot_representative_price_1.getTariffBasePrice)({ price: { 1: 0, 2: 7500 } })).toBe(7500);
+    });
+    it('uses basePrice and applies slot discount', () => {
+        expect((0, slot_representative_price_1.getSlotRepresentativePrice)({
+            basePrice: 10000,
+            discount: 1000,
+        })).toBe(9000);
+    });
+    it('coerces string amounts in tariff', () => {
+        expect((0, slot_representative_price_1.getTariffBasePrice)({ price: { 2: '9999' } })).toBe(9999);
+    });
+});

package/dist/user-session-permissions.d.ts

@@ -0,0 +1,37 @@
+import { RoleRO } from '@escapenavigator/types/dist/role/role.ro';
+export declare const USER_SESSION_ERROR_KEYS: {
+    readonly shiftLocked: "shiftLocked";
+    readonly noPermission: "noPermission";
+    readonly notShiftAuthor: "notShiftAuthor";
+    readonly ownShiftPastDate: "ownShiftPastDate";
+    readonly cannotAssignOthers: "cannotAssignOthers";
+    readonly cannotCreateUnassigned: "cannotCreateUnassigned";
+    readonly sessionNotFound: "sessionNotFound";
+};
+export type UserSessionErrorKey = keyof typeof USER_SESSION_ERROR_KEYS;
+export declare const USER_SESSION_ERRORS_EN: Record<UserSessionErrorKey, string>;
+export type UserSessionRolePermissions = Pick<RoleRO, 'totalAccess' | 'canEditWorkedHours' | 'canEditOwnWorkedHours'>;
+export type UserSessionPermissionTarget = {
+    hold?: boolean;
+    authorId?: number | null;
+    date: string;
+};
+export declare const canEditOtherUserSessions: (role: UserSessionRolePermissions) => boolean;
+export declare const isSessionDateTodayOrFuture: (date: string, today?: string) => boolean;
+/** Returns an English denial message, or null when edit/delete is allowed. */
+export declare const getUserSessionEditDenial: (params: {
+    session: UserSessionPermissionTarget;
+    role: UserSessionRolePermissions;
+    userId: number;
+}) => string | null;
+/** Returns an English denial message, or null when creating a shift is allowed. */
+export declare const getUserSessionCreateDenial: (params: {
+    assigneeUserId: number | null | undefined;
+    role: UserSessionRolePermissions;
+    actorId: number;
+}) => string | null;
+export declare const canEditUserSession: (params: {
+    session: UserSessionPermissionTarget;
+    role: UserSessionRolePermissions;
+    userId: number;
+}) => boolean;

package/dist/user-session-permissions.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canEditUserSession = exports.getUserSessionCreateDenial = exports.getUserSessionEditDenial = exports.isSessionDateTodayOrFuture = exports.canEditOtherUserSessions = exports.USER_SESSION_ERRORS_EN = exports.USER_SESSION_ERROR_KEYS = void 0;
+exports.USER_SESSION_ERROR_KEYS = {
+    shiftLocked: 'shiftLocked',
+    noPermission: 'noPermission',
+    notShiftAuthor: 'notShiftAuthor',
+    ownShiftPastDate: 'ownShiftPastDate',
+    cannotAssignOthers: 'cannotAssignOthers',
+    cannotCreateUnassigned: 'cannotCreateUnassigned',
+    sessionNotFound: 'sessionNotFound',
+};
+exports.USER_SESSION_ERRORS_EN = {
+    shiftLocked: 'This shift is locked. Unlock it before editing or deleting.',
+    noPermission: 'You do not have permission to manage work shifts.',
+    notShiftAuthor: 'You can only edit shifts that you created. Ask a manager with worked-hours access to change this shift.',
+    ownShiftPastDate: 'You can only edit or delete your own shifts on today or future dates.',
+    cannotAssignOthers: 'You cannot create or assign shifts for other employees. Enable "Can edit logged time" on your role.',
+    cannotCreateUnassigned: 'You cannot create unassigned shifts. Enable "Can edit logged time" on your role.',
+    sessionNotFound: 'Work shift not found.',
+};
+const canEditOtherUserSessions = (role) => !!role.totalAccess || !!role.canEditWorkedHours;
+exports.canEditOtherUserSessions = canEditOtherUserSessions;
+const isSessionDateTodayOrFuture = (date, today = formatTodayYmd()) => today <= date;
+exports.isSessionDateTodayOrFuture = isSessionDateTodayOrFuture;
+const formatTodayYmd = () => {
+    const d = new Date();
+    return `${d.getFullYear()}-${`${d.getMonth() + 1}`.padStart(2, '0')}-${`${d.getDate()}`.padStart(2, '0')}`;
+};
+/** Returns an English denial message, or null when edit/delete is allowed. */
+const getUserSessionEditDenial = (params) => {
+    const { session, role, userId } = params;
+    if (session.hold) {
+        return exports.USER_SESSION_ERRORS_EN.shiftLocked;
+    }
+    if ((0, exports.canEditOtherUserSessions)(role)) {
+        return null;
+    }
+    if (!role.canEditOwnWorkedHours) {
+        return exports.USER_SESSION_ERRORS_EN.noPermission;
+    }
+    if (session.authorId !== userId) {
+        return exports.USER_SESSION_ERRORS_EN.notShiftAuthor;
+    }
+    if (!(0, exports.isSessionDateTodayOrFuture)(session.date)) {
+        return exports.USER_SESSION_ERRORS_EN.ownShiftPastDate;
+    }
+    return null;
+};
+exports.getUserSessionEditDenial = getUserSessionEditDenial;
+/** Returns an English denial message, or null when creating a shift is allowed. */
+const getUserSessionCreateDenial = (params) => {
+    const { assigneeUserId, role, actorId } = params;
+    if ((0, exports.canEditOtherUserSessions)(role)) {
+        return null;
+    }
+    if (!role.canEditOwnWorkedHours) {
+        return exports.USER_SESSION_ERRORS_EN.noPermission;
+    }
+    if (assigneeUserId != null && assigneeUserId !== actorId) {
+        return exports.USER_SESSION_ERRORS_EN.cannotAssignOthers;
+    }
+    if (assigneeUserId == null) {
+        return exports.USER_SESSION_ERRORS_EN.cannotCreateUnassigned;
+    }
+    return null;
+};
+exports.getUserSessionCreateDenial = getUserSessionCreateDenial;
+const canEditUserSession = (params) => (0, exports.getUserSessionEditDenial)(params) === null;
+exports.canEditUserSession = canEditUserSession;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "1.10.130",
+  "version": "1.10.132",
   "publishConfig": {
     "access": "public"
   },
@@ -14,11 +14,12 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^1.10.126",
+    "@escapenavigator/types": "^1.10.128",
     "axios": "^0.21.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
-    "i18next": "^21.6.4"
+    "i18next": "^21.6.4",
+    "quill-delta": "^5.1.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.10",
@@ -26,5 +27,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "725d5bb466c14160683c9b578184c8f432d11915"
+  "gitHead": "f314b83d632fc068719426b472f60ab03213d533"
 }