@snabcentr/common-lib 2.17.0 → 2.18.1

package/dist/src/date-time/helpers/calendar-helper.d.ts

@@ -0,0 +1,72 @@
+import { IDatePeriod } from '../../system/interfaces/i-date-period';
+/**
+ * Класс-помощник для календарных вычислений, отсутствующих в date-fns: декады (1–10, 11–20, 21–конец месяца),
+ * полугодия и интервалы «до такой же даты». Все возвращаемые периоды имеют заполненные границы.
+ */
+export declare class CalendarHelper {
+    /**
+     * Возвращает границы декады, в которую попадает указанная дата.
+     *
+     * @param date Дата.
+     */
+    static decadeInterval(date: Date): IDatePeriod;
+    /**
+     * Возвращает границы декады, отстоящей от декады указанной даты на заданное число декад.
+     *
+     * @param date Дата.
+     * @param shift Смещение в декадах, может быть отрицательным.
+     */
+    static shiftDecadeInterval(date: Date, shift: number): IDatePeriod;
+    /**
+     * Возвращает начало полугодия, в которое попадает указанная дата.
+     *
+     * @param date Дата.
+     */
+    static startOfHalfYear(date: Date): Date;
+    /**
+     * Возвращает конец полугодия, в которое попадает указанная дата.
+     *
+     * @param date Дата.
+     */
+    static endOfHalfYear(date: Date): Date;
+    /**
+     * Возвращает дату, сдвинутую на указанное число полугодий.
+     *
+     * @param date Дата.
+     * @param amount Смещение в полугодиях, может быть отрицательным.
+     */
+    static addHalfYears(date: Date, amount: number): Date;
+    /**
+     * Возвращает интервал «сдвинутый период до такой же даты»: от начала сдвинутого периода до конца дня
+     * с тем же порядковым номером месяца внутри периода и тем же числом, что у опорной даты.
+     * Если в целевом месяце такого числа нет, берётся его последний день (31-е число в месяце из 30 дней станет 30-м).
+     *
+     * @param currentPeriodStart Начало периода, в который попадает опорная дата.
+     * @param shiftedPeriodStart Начало сдвинутого периода.
+     * @param date Опорная дата.
+     */
+    static intervalTillSameDate(currentPeriodStart: Date, shiftedPeriodStart: Date, date: Date): IDatePeriod;
+    /**
+     * Возвращает интервал «сдвинутая неделя до такого же дня недели»; недели начинаются с понедельника.
+     *
+     * @param date Опорная дата.
+     * @param shiftWeeks Смещение в неделях, может быть отрицательным.
+     */
+    static weekTillSameWeekday(date: Date, shiftWeeks: number): IDatePeriod;
+    /**
+     * Возвращает интервал «сдвинутая декада до такого же номера дня»; если в целевой декаде дня с таким
+     * номером нет, берётся её последний день (третья декада длится от 8 до 11 дней).
+     *
+     * @param date Опорная дата.
+     * @param shift Смещение в декадах, может быть отрицательным.
+     */
+    static decadeTillSameDayNumber(date: Date, shift: number): IDatePeriod;
+    /**
+     * Возвращает пару «начало и конец декады», отстоящей от декады указанной даты на заданное число декад.
+     *
+     * @param date Дата.
+     * @param shift Смещение в декадах, может быть отрицательным.
+     */
+    private static shiftedDecadeBounds;
+}
+//# sourceMappingURL=calendar-helper.d.ts.map

package/dist/src/date-time/helpers/calendar-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-helper.d.ts","sourceRoot":"","sources":["../../../../src/date-time/helpers/calendar-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAiBlE;;;GAGG;AACH,qBAAa,cAAc;IACvB;;;;OAIG;WACW,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW;IAMrD;;;;;OAKG;WACW,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAMzE;;;;OAIG;WACW,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI/C;;;;OAIG;WACW,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI7C;;;;;OAKG;WACW,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5D;;;;;;;;OAQG;WACW,oBAAoB,CAAC,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW;IAQ/G;;;;;OAKG;WACW,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW;IAO9E;;;;;;OAMG;WACW,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAS7E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAmBrC"}

package/dist/src/date-time/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './calendar-helper';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/date-time/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/date-time/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/src/date-time/index.d.ts

@@ -1,3 +1,6 @@
+export * from './helpers';
 export * from './interfaces';
 export * from './providers';
+export * from './types';
+export * from './values';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/date-time/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/date-time/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/date-time/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/src/date-time/interfaces/i-labeled-period.d.ts

@@ -0,0 +1,11 @@
+import { IDatePeriod } from '../../system/interfaces/i-date-period';
+/**
+ * Период времени с текстовым описанием.
+ */
+export interface ILabeledPeriod extends IDatePeriod {
+    /**
+     * Текстовое описание.
+     */
+    label: string;
+}
+//# sourceMappingURL=i-labeled-period.d.ts.map

package/dist/src/date-time/interfaces/i-labeled-period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-labeled-period.d.ts","sourceRoot":"","sources":["../../../../src/date-time/interfaces/i-labeled-period.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB"}

package/dist/src/date-time/interfaces/i-standard-period.d.ts

@@ -0,0 +1,17 @@
+import { ILabeledPeriod } from './i-labeled-period';
+import { StandardPeriodGroupType } from '../types/standard-period-group-type';
+import { StandardPeriodSectionType } from '../types/standard-period-section-type';
+/**
+ * Стандартный период выбора дат.
+ */
+export interface IStandardPeriod extends ILabeledPeriod {
+    /**
+     * Группа стандартного периода.
+     */
+    group: StandardPeriodGroupType;
+    /**
+     * Раздел внутри группы для раздельного отображения (заполняется только у группы «Прочее»).
+     */
+    section?: StandardPeriodSectionType;
+}
+//# sourceMappingURL=i-standard-period.d.ts.map

package/dist/src/date-time/interfaces/i-standard-period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-standard-period.d.ts","sourceRoot":"","sources":["../../../../src/date-time/interfaces/i-standard-period.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACnD;;OAEG;IACH,KAAK,EAAE,uBAAuB,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACvC"}

package/dist/src/date-time/interfaces/index.d.ts

@@ -1,2 +1,4 @@
+export * from './i-labeled-period';
+export * from './i-standard-period';
 export * from './i-unix-timestamp-period';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/date-time/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/date-time/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/date-time/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/src/date-time/providers/date-time-provider.d.ts

@@ -1,16 +1,22 @@
-import { IDatePeriod } from '../../system/interfaces/i-date-period';
+import { ILabeledPeriod } from '../interfaces/i-labeled-period';
+import { IStandardPeriod } from '../interfaces/i-standard-period';
 /**
  * Провайдер даты и времени.
  */
 export declare class DateTimeProvider {
     /**
-     * Возвращает диапазон дат по умолчанию.
+     * Возвращает предустановленные диапазоны дат.
+     *
+     * @param year Год, от которого считаются годовые периоды (1/3/9 месяцев, кварталы, полугодия, год); по умолчанию текущий.
      */
-    static defaultDateRanges(): Record<string, IDatePeriod & {
-        /**
-         * Текстовое описание.
-         */
-        label: string;
-    }>;
+    static defaultDateRanges(year?: number): Record<string, ILabeledPeriod>;
+    /**
+     * Возвращает стандартные периоды по образцу перечисления 1С «ВариантСтандартногоПериода»,
+     * распределённые по группам {@link STANDARD_PERIOD_GROUPS}, а внутри группы «Прочее» — по разделам
+     * {@link STANDARD_PERIOD_SECTIONS}. Ключи повторяют англоязычные имена значений перечисления платформы.
+     *
+     * @param now Опорная дата «сейчас»; по умолчанию текущая.
+     */
+    static standardPeriods(now?: Date): Record<string, IStandardPeriod>;
 }
 //# sourceMappingURL=date-time-provider.d.ts.map

package/dist/src/date-time/providers/date-time-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-time-provider.d.ts","sourceRoot":"","sources":["../../../../src/date-time/providers/date-time-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAGlE;;GAEG;AACH,qBAAa,gBAAgB;IACzB;;OAEG;WACW,iBAAiB,IAAI,MAAM,CACrC,MAAM,EACN,WAAW,GAAG;QACV;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACjB,CACJ;CAYJ"}
+{"version":3,"file":"date-time-provider.d.ts","sourceRoot":"","sources":["../../../../src/date-time/providers/date-time-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AA+B7E;;GAEG;AACH,qBAAa,gBAAgB;IACzB;;;;OAIG;WACW,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IA+B9E;;;;;;OAMG;WACW,eAAe,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;CAgIzF"}

package/dist/src/date-time/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './standard-period-group-type';
+export * from './standard-period-section-type';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/date-time/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/date-time/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC"}

package/dist/src/date-time/types/standard-period-group-type.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Группа стандартного периода.
+ */
+export type StandardPeriodGroupType = 'day' | 'week' | 'decade' | 'month' | 'quarter' | 'halfYear' | 'year' | 'other';
+//# sourceMappingURL=standard-period-group-type.d.ts.map

package/dist/src/date-time/types/standard-period-group-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-period-group-type.d.ts","sourceRoot":"","sources":["../../../../src/date-time/types/standard-period-group-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/src/date-time/types/standard-period-section-type.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Раздел группы «Прочее» стандартных периодов.
+ */
+export type StandardPeriodSectionType = 'fromBeginning' | 'tillEnd' | 'lastTillSame' | 'nextTillSame' | 'rollingDays';
+//# sourceMappingURL=standard-period-section-type.d.ts.map

package/dist/src/date-time/types/standard-period-section-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-period-section-type.d.ts","sourceRoot":"","sources":["../../../../src/date-time/types/standard-period-section-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,CAAC"}

package/dist/src/date-time/values/index.d.ts

@@ -0,0 +1,2 @@
+export * from './standard-period-groups';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/date-time/values/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/date-time/values/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/src/date-time/values/standard-period-groups.d.ts

@@ -0,0 +1,29 @@
+import { StandardPeriodGroupType } from '../types/standard-period-group-type';
+import { StandardPeriodSectionType } from '../types/standard-period-section-type';
+/**
+ * Порядок отображения и названия групп стандартных периодов.
+ */
+export declare const STANDARD_PERIOD_GROUPS: Array<{
+    /**
+     * Ключ группы.
+     */
+    key: StandardPeriodGroupType;
+    /**
+     * Название группы.
+     */
+    label: string;
+}>;
+/**
+ * Порядок отображения и названия разделов группы «Прочее».
+ */
+export declare const STANDARD_PERIOD_SECTIONS: Array<{
+    /**
+     * Ключ раздела.
+     */
+    key: StandardPeriodSectionType;
+    /**
+     * Название раздела.
+     */
+    label: string;
+}>;
+//# sourceMappingURL=standard-period-groups.d.ts.map

package/dist/src/date-time/values/standard-period-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-period-groups.d.ts","sourceRoot":"","sources":["../../../../src/date-time/values/standard-period-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC;IACvC;;OAEG;IACH,GAAG,EAAE,uBAAuB,CAAC;IAE7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB,CASA,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC;IACzC;;OAEG;IACH,GAAG,EAAE,yBAAyB,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB,CAMA,CAAC"}

package/dist/src/user/enums/user-type-enum.d.ts

@@ -18,6 +18,10 @@ export declare enum UserTypeEnum {
      * Клиент.
      */
     Client = "client",
+    /**
+     * Внешний SEO-специалист.
+     */
+    ExternalSeo = "external_seo",
     /**
      * Гость.
      */

package/dist/src/user/enums/user-type-enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-type-enum.d.ts","sourceRoot":"","sources":["../../../../src/user/enums/user-type-enum.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,YAAY;IACpB;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,KAAK,UAAU;CAClB"}
+{"version":3,"file":"user-type-enum.d.ts","sourceRoot":"","sources":["../../../../src/user/enums/user-type-enum.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,YAAY;IACpB;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,WAAW,iBAAiB;IAE5B;;OAEG;IACH,KAAK,UAAU;CAClB"}

package/package.json

@@ -4,7 +4,7 @@
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
     "type": "module",
-    "version": "2.17.0",
+    "version": "2.18.1",
     "license": "ISC",
     "scripts": {
         "dev": "vite",