bx-rest 0.23.0 → 0.25.0

package/fesm2022/bx-rest.mjs

@@ -1,4 +1,3 @@
-import { DateTime } from 'luxon';
 import { switchMap, map, catchError, take, mergeMap as mergeMap$1 } from 'rxjs/operators';
 import { Subscription, of, throwError, from, forkJoin, last, shareReplay, mergeMap, concatMap, toArray, map as map$1, tap } from 'rxjs';
 import clone from 'just-clone';
@@ -102,8 +101,154 @@ class ToNumError extends Error {
         ].join('\n');
     }
 }
+/** Соответствие токенов формата регулярным группам захвата. Порядок важен: длинные токены проверяются раньше коротких */
+const DATE_FORMAT_TOKENS = [
+    ['yyyy', '(?<yyyy>\\d{4})'],
+    ['yy', '(?<yy>\\d{2})'],
+    ['MM', '(?<MM>\\d{2})'],
+    ['M', '(?<M>\\d{1,2})'],
+    ['dd', '(?<dd>\\d{2})'],
+    ['d', '(?<d>\\d{1,2})'],
+    ['HH', '(?<HH>\\d{2})'],
+    ['H', '(?<H>\\d{1,2})'],
+    ['mm', '(?<mm>\\d{2})'],
+    ['m', '(?<m>\\d{1,2})'],
+    ['ss', '(?<ss>\\d{2})'],
+    ['s', '(?<s>\\d{1,2})'],
+];
+const DATE_FORMAT_TOKEN_REGEX = new RegExp(DATE_FORMAT_TOKENS.map(([token]) => token).join('|'), 'g');
+const TIME_ONLY_TOKENS = new Set(['HH', 'H', 'mm', 'm', 'ss', 's']);
 /**
- * Преобразует значение в дату
+ * Выводит формат "только дата" из формата даты-и-времени — отрезает время и разделитель перед
+ * ним (например, `'dd.MM.yyyy HH:mm:ss'` → `'dd.MM.yyyy'`). Порядок день/месяц/год у полей
+ * "дата" и "дата-время" на одном портале Bitrix24 всегда согласован — различается только
+ * наличие `HH:mm:ss`, поэтому нет смысла заставлять вызывающего передавать оба формата и
+ * держать их в синхроне вручную.
+ */
+function deriveDateOnlyFormat(dateTimeFormat) {
+    DATE_FORMAT_TOKEN_REGEX.lastIndex = 0;
+    let match;
+    while ((match = DATE_FORMAT_TOKEN_REGEX.exec(dateTimeFormat)) !== null) {
+        if (TIME_ONLY_TOKENS.has(match[0])) {
+            // Отрезаем любой разделитель перед временем, включая буквенный (например 'T' в ISO-стиле
+            // 'dd.MM.yyyyTHH:mm:ss'), а не только пунктуацию — останавливаемся на последнем символе,
+            // который реально относится к токенам даты (y/M/d).
+            const datePart = dateTimeFormat.slice(0, match.index).replace(/[^yMd]+$/, '');
+            return datePart || dateTimeFormat;
+        }
+    }
+    return dateTimeFormat;
+}
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Форматы дат, которые Bitrix24 реально присылает в разных методах REST и на разных
+ * порталах — формат даты/времени в ответе зависит от настроек портала (Настройки → формат
+ * даты и времени), поэтому один захардкоженный шаблон не универсален. Если явный `format`,
+ * переданный в toDate(), не совпал со значением, перед тем как считать строку невалидной,
+ * пробуем эти варианты по очереди — они не пересекаются по разделителям/порядку токенов,
+ * так что ложных совпадений не будет.
+ */
+const FALLBACK_DATE_FORMATS = [
+    'dd.MM.yyyy HH:mm:ss',
+    'yyyy-MM-dd HH:mm:ss',
+    'dd.MM.yyyy',
+    'yyyy-MM-dd',
+];
+/**
+ * Разбирает строку даты по простому шаблону (yyyy, MM, dd, HH, mm, ss и их однобуквенные
+ * варианты, например 'dd.MM.yyyy HH:mm:ss'). Разделители между токенами берутся из шаблона
+ * как есть. Не поддерживает локали, названия месяцев и часовые пояса — для REST-ответов
+ * Bitrix24 они не требуются, значения всегда приходят в фиксированном числовом виде.
+ */
+function parseDateWithFormat(val, format) {
+    const tokenMap = new Map(DATE_FORMAT_TOKENS);
+    let pattern = '';
+    let lastIndex = 0;
+    let match;
+    DATE_FORMAT_TOKEN_REGEX.lastIndex = 0;
+    while ((match = DATE_FORMAT_TOKEN_REGEX.exec(format)) !== null) {
+        pattern += escapeRegExp(format.slice(lastIndex, match.index));
+        pattern += tokenMap.get(match[0]);
+        lastIndex = match.index + match[0].length;
+    }
+    pattern += escapeRegExp(format.slice(lastIndex));
+    const result = new RegExp(`^${pattern}$`).exec(val);
+    if (!result?.groups) {
+        return null;
+    }
+    const g = result.groups;
+    const year = g['yyyy'] ? Number(g['yyyy']) : g['yy'] ? 2000 + Number(g['yy']) : new Date().getFullYear();
+    const month = Number(g['MM'] ?? g['M'] ?? 1);
+    const day = Number(g['dd'] ?? g['d'] ?? 1);
+    const hour = Number(g['HH'] ?? g['H'] ?? 0);
+    const minute = Number(g['mm'] ?? g['m'] ?? 0);
+    const second = Number(g['ss'] ?? g['s'] ?? 0);
+    // Токены — это просто "N цифр", без проверки диапазона (regex не отличит "13" месяца от
+    // "13" дня). Без этой проверки new Date() молча "перекатывает" переполнение на соседний
+    // месяц/год (например, месяц=13 → январь следующего года) вместо того, чтобы считать
+    // строку невалидной.
+    if (month < 1 || month > 12 || day < 1 || day > 31 || hour > 23 || minute > 59 || second > 59) {
+        return null;
+    }
+    const date = new Date(year, month - 1, day, hour, minute, second);
+    return isNaN(date.getTime()) ? null : date;
+}
+/**
+ * Последний резервный разбор — без знания конкретного формата. Работает только для чисто
+ * числовых дат (никаких названий месяцев/дней — для этого нужны locale-таблицы, а это как
+ * раз тот вес, ради ухода от которого luxon был убран из зависимостей).
+ *
+ * Идея: год — единственный сегмент длиной ровно 4 цифры, поэтому его позиция (первый или
+ * последний из трёх сегментов даты) однозначно опознаётся при любом разделителе (`.`, `-`,
+ * `/`, пробел...). Месяц по всем распространённым в мире соглашениям (ISO `yyyy-MM-dd` и
+ * европейское `dd.MM.yyyy`) стоит между годом и днём, поэтому берётся как средний сегмент.
+ * Время, если есть, всегда идёт как `HH:mm:ss` — этот порядок универсален.
+ *
+ * Не решает и не пытается решить неоднозначность день/месяц в чисто числовых форматах вида
+ * `MM/dd/yyyy` (США), где оба сегмента могут быть ≤12 — угадывать это без знания локали
+ * значило бы иногда молча путать день с месяцем, что хуже явной ошибки.
+ */
+function parseDateHeuristically(val) {
+    const parts = val.match(/\d+/g);
+    if (!parts || parts.length < 3 || parts.length > 6) {
+        return null;
+    }
+    const [d0, d1, d2, ...timeParts] = parts;
+    const dateParts = [d0, d1, d2];
+    const yearIdx = dateParts.findIndex(p => p.length === 4);
+    // Год должен быть однозначно найден (ровно 4 цифры) и стоять с края, а не в середине —
+    // иначе позиция месяца/дня не определить безопасно.
+    if (yearIdx !== 0 && yearIdx !== 2) {
+        return null;
+    }
+    const year = Number(dateParts[yearIdx]);
+    const month = Number(dateParts[1]);
+    const day = Number(dateParts[yearIdx === 0 ? 2 : 0]);
+    if (month < 1 || month > 12 || day < 1 || day > 31) {
+        return null;
+    }
+    const [hh, mm, ss] = timeParts;
+    const hour = hh !== undefined ? Number(hh) : 0;
+    const minute = mm !== undefined ? Number(mm) : 0;
+    const second = ss !== undefined ? Number(ss) : 0;
+    if (hour > 23 || minute > 59 || second > 59) {
+        return null;
+    }
+    const date = new Date(year, month - 1, day, hour, minute, second);
+    return isNaN(date.getTime()) ? null : date;
+}
+/**
+ * Преобразует значение в дату.
+ *
+ * Если передан `format`, но значение ему не соответствует (см. FALLBACK_DATE_FORMATS —
+ * актуально для полей, где Bitrix24 отдаёт дату в формате, настроенном на портале, а не в
+ * том, что захардкожен в маппере), перед тем как считать значение невалидным, делаются ещё
+ * две попытки: другие распространённые форматы Bitrix24, а затем — позиционная эвристика
+ * (см. parseDateHeuristically), которая распознаёт практически любой чисто числовой формат
+ * даты независимо от разделителя. Если приложению точно известен формат конкретного портала,
+ * его стоит передавать явным `format` — это всегда приоритетнее угадывания.
  */
 function toDate(val, format, opt, throwError = true) {
     if (val instanceof Date) {
@@ -111,10 +256,22 @@ function toDate(val, format, opt, throwError = true) {
     }
     else if (typeof val === 'string') {
         if (format) {
-            if (opt) {
-                return DateTime.fromFormat(val, format, opt).toJSDate();
+            const parsed = parseDateWithFormat(val, format);
+            if (parsed) {
+                return parsed;
+            }
+            for (const fallbackFormat of FALLBACK_DATE_FORMATS) {
+                if (fallbackFormat === format)
+                    continue;
+                const fallbackParsed = parseDateWithFormat(val, fallbackFormat);
+                if (fallbackParsed) {
+                    return fallbackParsed;
+                }
+            }
+            const heuristicParsed = parseDateHeuristically(val);
+            if (heuristicParsed) {
+                return heuristicParsed;
             }
-            return DateTime.fromFormat(val, format).toJSDate();
         }
         else {
             return new Date(val);
@@ -255,6 +412,7 @@ var base = /*#__PURE__*/Object.freeze({
     __proto__: null,
     ToNumError: ToNumError,
     cropUrl: cropUrl,
+    deriveDateOnlyFormat: deriveDateOnlyFormat,
     getBase64File: getBase64File,
     getBase64FileLikeStr: getBase64FileLikeStr,
     getBaseUrlHttps: getBaseUrlHttps,
@@ -6783,13 +6941,24 @@ class BXRestNavvyLog {
 }
 
 class BXRestMapCalendarEvent {
-    static getById(item) {
-        return (item) ? BXRestMapCalendarEvent.CalendarEventGetAnswerHttpToCalendarEventGetAnswer(item) : undefined;
+    /**
+     * @param item
+     * @param dateTimeFormat Формат полей с датой и временем (`DATE_CREATE`, `DATE_FROM`, `DATE_TO`, `TIMESTAMP_X`
+     *   и т.д.). По умолчанию — распространённый на многих порталах `'dd.MM.yyyy HH:mm:ss'`, но реальный формат
+     *   зависит от настроек портала (Настройки → формат даты и времени) — если он известен, передавайте его явно.
+     *   Формат для полей только с датой (`EXDATE`, `RRULE.UNTIL`) выводится из этого же значения
+     *   (отбрасыванием `HH:mm:ss`) — передавать его отдельно не нужно.
+     */
+    static getById(item, dateTimeFormat = 'dd.MM.yyyy HH:mm:ss') {
+        return (item) ? BXRestMapCalendarEvent.CalendarEventGetAnswerHttpToCalendarEventGetAnswer(item, dateTimeFormat) : undefined;
     }
-    static get(item) {
-        return (item) ? item.map(i => BXRestMapCalendarEvent.CalendarEventGetAnswerHttpToCalendarEventGetAnswer(i)) : undefined;
+    /** @see getById */
+    static get(item, dateTimeFormat = 'dd.MM.yyyy HH:mm:ss') {
+        return (item) ? item.map(i => BXRestMapCalendarEvent.CalendarEventGetAnswerHttpToCalendarEventGetAnswer(i, dateTimeFormat)) : undefined;
     }
-    static CalendarEventGetAnswerHttpToCalendarEventGetAnswer(item) {
+    /** @see getById */
+    static CalendarEventGetAnswerHttpToCalendarEventGetAnswer(item, dateTimeFormat = 'dd.MM.yyyy HH:mm:ss') {
+        const dateFormat = deriveDateOnlyFormat(dateTimeFormat);
         return {
             ...item,
             ID: toNum(item.ID),
@@ -6802,24 +6971,27 @@ class BXRestMapCalendarEvent {
             TZ_OFFSET_FROM: toNum(item.TZ_OFFSET_FROM),
             TZ_OFFSET_TO: toNum(item.TZ_OFFSET_TO),
             VERSION: toNum(item.VERSION),
-            DATE_CREATE: toDate(item.DATE_CREATE, 'dd.MM.yyyy HH:mm:ss'),
-            DATE_FROM: toDate(item.DATE_FROM, 'dd.MM.yyyy HH:mm:ss'),
+            DATE_CREATE: toDate(item.DATE_CREATE, dateTimeFormat),
+            DATE_FROM: toDate(item.DATE_FROM, dateTimeFormat),
             ORIGINAL_DATE_FROM: (item.ORIGINAL_DATE_FROM)
-                ? toDate(item.ORIGINAL_DATE_FROM, 'dd.MM.yyyy HH:mm:ss')
+                ? toDate(item.ORIGINAL_DATE_FROM, dateTimeFormat)
                 : null,
-            DATE_TO: toDate(item.DATE_TO, 'dd.MM.yyyy HH:mm:ss'),
-            TIMESTAMP_X: toDate(item.TIMESTAMP_X, 'dd.MM.yyyy HH:mm:ss'),
+            DATE_TO: toDate(item.DATE_TO, dateTimeFormat),
+            TIMESTAMP_X: toDate(item.TIMESTAMP_X, dateTimeFormat),
             DATE_FROM_TS_UTC: toNum(item.DATE_FROM_TS_UTC),
             DATE_TO_TS_UTC: toNum(item.DATE_TO_TS_UTC),
             DELETED: item.DELETED === 'Y',
             DT_LENGTH: toNum(item.DT_LENGTH),
             DT_SKIP_TIME: item.DT_SKIP_TIME === 'Y',
             MEETING_STATUS: item.MEETING_STATUS === 'Y',
-            EXDATE: item.EXDATE.split(';').map(dateStr => toDate(dateStr, 'dd.MM.yyyy')),
+            // EXDATE и RRULE.UNTIL/'~UNTIL' у Bitrix нередко приходят пустой строкой (нет исключённых
+            // дат повторения / правило повторения ограничено через COUNT, а не датой) — пустую строку
+            // toDate() распарсить не может ни при каком формате, поэтому такие поля пропускаем до вызова
+            EXDATE: item.EXDATE ? item.EXDATE.split(';').filter(Boolean).map(dateStr => toDate(dateStr, dateFormat)) : [],
             RRULE: (item.RRULE && typeof item.RRULE !== 'string') ? {
                 ...item.RRULE,
-                UNTIL: toDate(item.RRULE.UNTIL, 'dd.MM.yyyy'),
-                '~UNTIL': toDate(item.RRULE['~UNTIL'], 'dd.MM.yyyy')
+                UNTIL: item.RRULE.UNTIL ? toDate(item.RRULE.UNTIL, dateFormat) : null,
+                '~UNTIL': item.RRULE['~UNTIL'] ? toDate(item.RRULE['~UNTIL'], dateFormat) : null
             } : null,
             ATTENDEE_LIST: (item.ATTENDEE_LIST) ? item.ATTENDEE_LIST.map(i => {
                 return { id: i.id, entryId: toNum(i.entryId), status: i.status };
@@ -6855,10 +7027,16 @@ class BXRestNavvyRestCalendarEvent {
         //   )
         // }
         this.get = Object.assign(
-        /** Возвращает список событий календаря, всегда весь список, паганации в методе нет да и не нужна */
-        (param) => this.Navvy.simple(this.url.get, param, BXRestMapCalendarEvent.get), {
-            /** Метод получает список будущих событий */
-            nearest: (param) => this.Navvy.simple(this.url.get.nearest, param, BXRestMapCalendarEvent.get),
+        /**
+         * Возвращает список событий календаря, всегда весь список, паганации в методе нет да и не нужна.
+         *
+         * @param param
+         * @param dateTimeFormat Формат полей с датой и временем в ответе (см. {@link BXRestMapCalendarEvent.get}).
+         *   Передавайте явно, если формат дат на портале отличается от значения по умолчанию.
+         */
+        (param, dateTimeFormat) => this.Navvy.simple(this.url.get, param, (raw) => BXRestMapCalendarEvent.get(raw, dateTimeFormat)), {
+            /** Метод получает список будущих событий. @see get */
+            nearest: (param, dateTimeFormat) => this.Navvy.simple(this.url.get.nearest, param, (raw) => BXRestMapCalendarEvent.get(raw, dateTimeFormat)),
         });
     }
     /** Добавляет событие в календарь */
@@ -6873,24 +7051,37 @@ class BXRestNavvyRestCalendarEvent {
     update(param) {
         return this.Navvy.simple(this.url.update, param);
     }
-    /** Метод получает информацию о событии календаря по идентификатору */
-    getById(param) {
-        return this.Navvy.simple(this.url.getById, param, BXRestMapCalendarEvent.getById);
+    /**
+     * Метод получает информацию о событии календаря по идентификатору.
+     *
+     * @param param
+     * @param dateTimeFormat Формат полей с датой и временем в ответе (см. {@link BXRestMapCalendarEvent.getById}).
+     *   Передавайте явно, если формат дат на портале отличается от значения по умолчанию.
+     */
+    getById(param, dateTimeFormat) {
+        return this.Navvy.simple(this.url.getById, param, (raw) => BXRestMapCalendarEvent.getById(raw, dateTimeFormat));
     }
 }
 
 class BXRestMapCalendarSection {
-    static get(item) {
-        return (item) ? item.map(i => BXRestMapCalendarSection.CalendarSectionGetHttpToCalendarSectionGetHttp(i)) : undefined;
+    /**
+     * @param item
+     * @param dateTimeFormat Формат полей `DATE_CREATE`/`TIMESTAMP_X`. По умолчанию — распространённый на многих
+     *   порталах `'dd.MM.yyyy HH:mm:ss'`, но реальный формат зависит от настроек портала (Настройки → формат
+     *   даты и времени) — если он известен, передавайте его явно.
+     */
+    static get(item, dateTimeFormat = 'dd.MM.yyyy HH:mm:ss') {
+        return (item) ? item.map(i => BXRestMapCalendarSection.CalendarSectionGetHttpToCalendarSectionGetHttp(i, dateTimeFormat)) : undefined;
     }
-    static CalendarSectionGetHttpToCalendarSectionGetHttp(item) {
+    /** @see get */
+    static CalendarSectionGetHttpToCalendarSectionGetHttp(item, dateTimeFormat = 'dd.MM.yyyy HH:mm:ss') {
         return {
             ...item,
             ID: toNum(item.ID),
             OWNER_ID: toNum(item.OWNER_ID),
             CREATED_BY: toNum(item.CREATED_BY),
-            DATE_CREATE: toDate(item.DATE_CREATE, 'dd.MM.yyyy HH:mm:ss'),
-            TIMESTAMP_X: toDate(item.TIMESTAMP_X, 'dd.MM.yyyy HH:mm:ss')
+            DATE_CREATE: toDate(item.DATE_CREATE, dateTimeFormat),
+            TIMESTAMP_X: toDate(item.TIMESTAMP_X, dateTimeFormat)
         };
     }
 }
@@ -6909,9 +7100,15 @@ class BXRestNavvyRestCalendarSection {
         };
         this.Navvy = new Navvy();
     }
-    /** Возвращает описание разделов, всегда весь список, паганации в методе нет да и не нужна */
-    get(param) {
-        return this.Navvy.simple(this.url.get, param, BXRestMapCalendarSection.get);
+    /**
+     * Возвращает описание разделов, всегда весь список, паганации в методе нет да и не нужна.
+     *
+     * @param param
+     * @param dateTimeFormat Формат полей `DATE_CREATE`/`TIMESTAMP_X` в ответе (см. {@link BXRestMapCalendarSection.get}).
+     *   Передавайте явно, если формат дат на портале отличается от значения по умолчанию.
+     */
+    get(param, dateTimeFormat) {
+        return this.Navvy.simple(this.url.get, param, (raw) => BXRestMapCalendarSection.get(raw, dateTimeFormat));
     }
     /** Добавляет новый раздел */
     add(param) {
@@ -9309,22 +9506,29 @@ class BXRestMapCrmStatus {
 }
 
 class BXRestMapCrmCallList {
-    /** Преобразует данные списка обзвона из формата Bitrix24 в локальный формат. */
-    static get(value) {
-        return this.mapItem(value);
+    /**
+     * Преобразует данные списка обзвона из формата Bitrix24 в локальный формат.
+     *
+     * @param value
+     * @param dateTimeFormat Формат поля `DATE_CREATE`. По умолчанию — `'yyyy-MM-dd HH:mm:ss'`, но реальный
+     *   формат зависит от настроек портала (Настройки → формат даты и времени) — если он известен,
+     *   передавайте его явно.
+     */
+    static get(value, dateTimeFormat = 'yyyy-MM-dd HH:mm:ss') {
+        return this.mapItem(value, dateTimeFormat);
     }
-    /** Преобразует список обзвонов с учетом полей, выбранных через `SELECT`. */
-    static list(value) {
-        return value?.map(item => this.mapItem(item));
+    /** Преобразует список обзвонов с учетом полей, выбранных через `SELECT`. @see get */
+    static list(value, dateTimeFormat = 'yyyy-MM-dd HH:mm:ss') {
+        return value?.map(item => this.mapItem(item, dateTimeFormat));
     }
-    static mapItem(value) {
+    static mapItem(value, dateTimeFormat = 'yyyy-MM-dd HH:mm:ss') {
         if (!value)
             return undefined;
         const result = clone(value);
         if (value.ID !== undefined)
             result.ID = toNum(value.ID);
         if (value.DATE_CREATE !== undefined) {
-            result.DATE_CREATE = toDate(value.DATE_CREATE, 'yyyy-MM-dd HH:mm:ss');
+            result.DATE_CREATE = toDate(value.DATE_CREATE, dateTimeFormat);
         }
         if (value.CREATED_BY_ID !== undefined)
             result.CREATED_BY_ID = toNum(value.CREATED_BY_ID);
@@ -11331,10 +11535,12 @@ class BXRestNavvyCrmCallList {
      * Участников можно получить через `items.get()`.
      *
      * @param param Идентификатор списка обзвона.
+     * @param dateTimeFormat Формат поля `DATE_CREATE` в ответе (см. {@link BXRestMapCrmCallList.get}).
+     *   Передавайте явно, если формат дат на портале отличается от значения по умолчанию.
      * @see https://apidocs.bitrix24.ru/api-reference/crm/call-list/crm-calllist-get.html
      */
-    get(param) {
-        return this.Navvy.simple(this.url.get, param, BXRestMapCrmCallList.get);
+    get(param, dateTimeFormat) {
+        return this.Navvy.simple(this.url.get, param, (raw) => BXRestMapCrmCallList.get(raw, dateTimeFormat));
     }
     /**
      * Возвращает списки обзвона с выборкой полей, фильтрацией и сортировкой.
@@ -11342,10 +11548,12 @@ class BXRestNavvyCrmCallList {
      * Набор полей каждого элемента результата зависит от `SELECT`.
      *
      * @param param Выбираемые поля, фильтр и порядок сортировки.
+     * @param dateTimeFormat Формат поля `DATE_CREATE` в ответе (см. {@link BXRestMapCrmCallList.list}).
+     *   Передавайте явно, если формат дат на портале отличается от значения по умолчанию.
      * @see https://apidocs.bitrix24.ru/api-reference/crm/call-list/crm-calllist-list.html
      */
-    list(param = {}) {
-        return this.Navvy.simple(this.url.list, param, BXRestMapCrmCallList.list);
+    list(param = {}, dateTimeFormat) {
+        return this.Navvy.simple(this.url.list, param, (raw) => BXRestMapCrmCallList.list(raw, dateTimeFormat));
     }
     /**
      * Возвращает справочник статусов обзвона.