szdl-utils-kit 0.2.28 → 0.2.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,177 +1,177 @@
1
- type TAppConst = {
2
- appName: string,
3
- appNameEng: string,
4
- pathApp: string,
5
- zip: string,
6
- chatBotLogo: string,
7
- entity: { key: string, name: string }[],
8
- }
9
- type UserOptionReturnType<T> = T extends undefined ? string | number : void;
10
-
11
- type TCommandParams = Record<string, unknown> | {
12
- select?: string[],
13
- filter?: Record<string, string | string[]>,
14
- } | {
15
- id?: string,
16
- params?: Record<string, string>,
17
- fields?: Record<string, unknown>,
18
- };
19
-
20
- type TUpdateList = {
21
- method: string,
22
- name: string,
23
- list: {
24
- id: string | number,
25
- fields: {
26
- [key: string]: {
27
- oldValue: string | number | string[] | number[],
28
- newValue: string | number | string[] | number[],
29
- }
30
- }
31
- }[]
32
- }[];
33
-
34
- type TCommand = {
35
- method: string,
36
- params:TCommandParams,
37
- }
38
-
39
- declare class BxBoot{
40
- /** В конструктор передаются константы приложения appConst */
41
- constructor(appConst: {
42
- appName: string,
43
- appNameEng: string,
44
- pathApp: string,
45
- zip: string,
46
- chatBotLogo: string,
47
- entity: { key: string, name: string }[],
48
- }): void;
49
-
50
- /** Доменное имя портала */
51
- domain: string;
52
- isAdmin: boolean;
53
-
54
- /** Информация о приложении */
55
- appInfo: {
56
- ID: number,
57
- CODE: string,
58
- VERSION: number,
59
- STATUS: string,
60
- INSTALLED: boolean,
61
- PAYMENT_EXPIRED: string,
62
- DAYS: null | number,
63
- LANGUAGE_ID: string,
64
- LICENSE: string,
65
- LICENSE_TYPE: string,
66
- LICENSE_FAMILY: string
67
- };
68
-
69
- /** Параметры приложения */
70
- appConst: {
71
- appName: string,
72
- appNameEng: string,
73
- pathApp: string,
74
- zip: string,
75
- chatBotLogo: string,
76
- entity: { key: string, name: string }[],
77
- };
78
-
79
- /** Информация о текущем пользователе */
80
- userInfo: Record<string, unknown>;
81
-
82
- /** Информация о встройках */
83
- placeData: Record<string, unknown>[];
84
-
85
- /** Информация о текущем месте встройки */
86
- placeInfo: {
87
- placement: string;
88
- options: Record<string, string>;
89
- };
90
-
91
-
92
-
93
- /** Метод инициализации библиотеки rest api BX24 */
94
- init(): Promise<boolean>;
95
-
96
- /** Получение\изменение опций юзера.
97
- *
98
- * Если передан 'key', то возвращает опцию по ключу. <br>
99
- * Если передан 'key' и 'value', то функция изменяет ключ по переданному значению.
100
- */
101
- userOption<T extends string | number | undefined>(key: string, value?: T): UserOptionReturnType<T>
102
-
103
-
104
- /** Вызывает указанный метод REST-сервиса с указанными параметрам */
105
- call({ method, params, updateList}: {
106
- method: string,
107
- params: TCommandParams,
108
- updateList: TUpdateList,
109
- }): Promise<unknown[] | boolean>;
110
-
111
- /**
112
- * Пакетный запрос данных
113
- * @param commandList - лист команд можно передавать как в виде объекта, так и в виде массива команд
114
- * @param progressCall - принимает callback, в котором возвращается передается статус загрузки данных в процентах
115
- * @param updateList - лист update данных, которые нужно записать в сессию логгера,
116
- * для возможности отката к старым значениям
117
- * @param errorCall - принимает callback, в котором возвращается объект ошибок
118
- * @param limitCommandSerial - лимит команд при котором происходит переключение батча в последовательный режим по дефолту 50
119
- */
120
- batch(
121
- commandList: Record<string, TCommand>,
122
- progressCall?: (data:{ percent: number })=>void,
123
- param:{
124
- updateList: TUpdateList,
125
- errorCall: (errors)=>void,
126
- limitCommandSerial: number,
127
- }
128
- ): Promise<Record<string, unknown[]> | boolean>;
129
-
130
- /**
131
- * Пакетный запрос количества элементов по запрошенным сущностям
132
- * @param commandList - лист команд можно передавать как в виде объекта, так и в виде массива команд
133
- * @param progressCall - принимает callback в который передается статус загрузки данных в процентах
134
- */
135
- batchTotalCount(
136
- commandList: Record<string, TCommand>,
137
- progressCall?: (data:{ percent: number })=>void
138
- ): Promise<Record<string, number> | boolean>;
139
-
140
- /** Запрос данных о местах встройки приложения */
141
- getPlacement(): Promise<unknown[] | boolean>;
142
-
143
- /** Встройка приложения в place
144
- *
145
- * @param place - индификатор места встройки
146
- */
147
- placementBind(place: string): void;
148
-
149
- /** Отвязка встройки из place
150
- *
151
- * @param place - индификатор места встройки
152
- */
153
- placementUnBind(place: string): Promise<boolean>;
154
-
155
- /** Получение списка чат-ботов */
156
- getBotList(): Promise<unknown[] | boolean>;
157
-
158
- /** Регистрация чат-бота
159
- * @param code - Строковой идентификатор бота, уникальный в рамках вашего приложения
160
- * @param type - Тип бота, B - чат-бот, ответы поступают сразу, H - человек, ответы поступают с задержкой от 2-х до 10 секунд, O - чат-бот для Открытых линий, S - чат-бот с повышенными привилегиями (supervisor)
161
- * @param name - Имя чат-бота
162
- */
163
- regBot({ code, type, name }:{
164
- code: string, type: string, name: string
165
- }): Promise<unknown | boolean>;
166
-
167
- /** Удаление чат-бота */
168
- unRegBot(id: number|string): Promise<unknown | boolean>;
169
-
170
- /**
171
- * Получение списка логирования
172
- * @param progressCall - коллбэк
173
- */
174
- async getLoggerList(progressCall: (data:{ percent: number })=>void): Promise<{[key]: any}[]>
175
- }
176
-
1
+ type TAppConst = {
2
+ appName: string,
3
+ appNameEng: string,
4
+ pathApp: string,
5
+ zip: string,
6
+ chatBotLogo: string,
7
+ entity: { key: string, name: string }[],
8
+ }
9
+ type UserOptionReturnType<T> = T extends undefined ? string | number : void;
10
+
11
+ type TCommandParams = Record<string, unknown> | {
12
+ select?: string[],
13
+ filter?: Record<string, string | string[]>,
14
+ } | {
15
+ id?: string,
16
+ params?: Record<string, string>,
17
+ fields?: Record<string, unknown>,
18
+ };
19
+
20
+ type TUpdateList = {
21
+ method: string,
22
+ name: string,
23
+ list: {
24
+ id: string | number,
25
+ fields: {
26
+ [key: string]: {
27
+ oldValue: string | number | string[] | number[],
28
+ newValue: string | number | string[] | number[],
29
+ }
30
+ }
31
+ }[]
32
+ }[];
33
+
34
+ type TCommand = {
35
+ method: string,
36
+ params:TCommandParams,
37
+ }
38
+
39
+ declare class BxBoot{
40
+ /** В конструктор передаются константы приложения appConst */
41
+ constructor(appConst: {
42
+ appName: string,
43
+ appNameEng: string,
44
+ pathApp: string,
45
+ zip: string,
46
+ chatBotLogo: string,
47
+ entity: { key: string, name: string }[],
48
+ }): void;
49
+
50
+ /** Доменное имя портала */
51
+ domain: string;
52
+ isAdmin: boolean;
53
+
54
+ /** Информация о приложении */
55
+ appInfo: {
56
+ ID: number,
57
+ CODE: string,
58
+ VERSION: number,
59
+ STATUS: string,
60
+ INSTALLED: boolean,
61
+ PAYMENT_EXPIRED: string,
62
+ DAYS: null | number,
63
+ LANGUAGE_ID: string,
64
+ LICENSE: string,
65
+ LICENSE_TYPE: string,
66
+ LICENSE_FAMILY: string
67
+ };
68
+
69
+ /** Параметры приложения */
70
+ appConst: {
71
+ appName: string,
72
+ appNameEng: string,
73
+ pathApp: string,
74
+ zip: string,
75
+ chatBotLogo: string,
76
+ entity: { key: string, name: string }[],
77
+ };
78
+
79
+ /** Информация о текущем пользователе */
80
+ userInfo: Record<string, unknown>;
81
+
82
+ /** Информация о встройках */
83
+ placeData: Record<string, unknown>[];
84
+
85
+ /** Информация о текущем месте встройки */
86
+ placeInfo: {
87
+ placement: string;
88
+ options: Record<string, string>;
89
+ };
90
+
91
+
92
+
93
+ /** Метод инициализации библиотеки rest api BX24 */
94
+ init(): Promise<boolean>;
95
+
96
+ /** Получение\изменение опций юзера.
97
+ *
98
+ * Если передан 'key', то возвращает опцию по ключу. <br>
99
+ * Если передан 'key' и 'value', то функция изменяет ключ по переданному значению.
100
+ */
101
+ userOption<T extends string | number | undefined>(key: string, value?: T): UserOptionReturnType<T>
102
+
103
+
104
+ /** Вызывает указанный метод REST-сервиса с указанными параметрам */
105
+ call({ method, params, updateList}: {
106
+ method: string,
107
+ params: TCommandParams,
108
+ updateList: TUpdateList,
109
+ }): Promise<unknown[] | boolean>;
110
+
111
+ /**
112
+ * Пакетный запрос данных
113
+ * @param commandList - лист команд можно передавать как в виде объекта, так и в виде массива команд
114
+ * @param progressCall - принимает callback, в котором возвращается передается статус загрузки данных в процентах
115
+ * @param updateList - лист update данных, которые нужно записать в сессию логгера,
116
+ * для возможности отката к старым значениям
117
+ * @param errorCall - принимает callback, в котором возвращается объект ошибок
118
+ * @param limitCommandSerial - лимит команд при котором происходит переключение батча в последовательный режим по дефолту 50
119
+ */
120
+ batch(
121
+ commandList: Record<string, TCommand>,
122
+ progressCall?: (data:{ percent: number })=>void,
123
+ param:{
124
+ updateList: TUpdateList,
125
+ errorCall: (errors)=>void,
126
+ limitCommandSerial: number,
127
+ }
128
+ ): Promise<Record<string, unknown[]> | boolean>;
129
+
130
+ /**
131
+ * Пакетный запрос количества элементов по запрошенным сущностям
132
+ * @param commandList - лист команд можно передавать как в виде объекта, так и в виде массива команд
133
+ * @param progressCall - принимает callback в который передается статус загрузки данных в процентах
134
+ */
135
+ batchTotalCount(
136
+ commandList: Record<string, TCommand>,
137
+ progressCall?: (data:{ percent: number })=>void
138
+ ): Promise<Record<string, number> | boolean>;
139
+
140
+ /** Запрос данных о местах встройки приложения */
141
+ getPlacement(): Promise<unknown[] | boolean>;
142
+
143
+ /** Встройка приложения в place
144
+ *
145
+ * @param place - индификатор места встройки
146
+ */
147
+ placementBind(place: string): void;
148
+
149
+ /** Отвязка встройки из place
150
+ *
151
+ * @param place - индификатор места встройки
152
+ */
153
+ placementUnBind(place: string): Promise<boolean>;
154
+
155
+ /** Получение списка чат-ботов */
156
+ getBotList(): Promise<unknown[] | boolean>;
157
+
158
+ /** Регистрация чат-бота
159
+ * @param code - Строковой идентификатор бота, уникальный в рамках вашего приложения
160
+ * @param type - Тип бота, B - чат-бот, ответы поступают сразу, H - человек, ответы поступают с задержкой от 2-х до 10 секунд, O - чат-бот для Открытых линий, S - чат-бот с повышенными привилегиями (supervisor)
161
+ * @param name - Имя чат-бота
162
+ */
163
+ regBot({ code, type, name }:{
164
+ code: string, type: string, name: string
165
+ }): Promise<unknown | boolean>;
166
+
167
+ /** Удаление чат-бота */
168
+ unRegBot(id: number|string): Promise<unknown | boolean>;
169
+
170
+ /**
171
+ * Получение списка логирования
172
+ * @param progressCall - коллбэк
173
+ */
174
+ async getLoggerList(progressCall: (data:{ percent: number })=>void): Promise<{[key]: any}[]>
175
+ }
176
+
177
177
  export default BxBoot;
@@ -1,28 +1,28 @@
1
- declare class BxHelper{
2
- /** Уникальная 8-символьная хэш-строка */
3
- get hash(): string
4
-
5
- /** Генератор хеш-кода
6
- * @param length - длина хэш строки
7
- */
8
- createHash(length:number):string
9
-
10
- /** Фильтр часто запускаемых действий
11
- * @param keyTimer - уникальный ключ таймера
12
- * @param duration - время задержки для срабатывания action
13
- * @param action - действие которое должно отработать
14
- */
15
- actionFilter({ keyTimer, duration=10, action }:{
16
- keyTimer: string;
17
- duration: number;
18
- action: ()=>void;
19
- }):void
20
-
21
- /** Включение режима NO-SLEEP */
22
- noSleep(): void
23
-
24
- /** Скачать данные в JSON-файл */
25
- downloadFileJson(data, filename:string ): void
26
- }
27
-
1
+ declare class BxHelper{
2
+ /** Уникальная 8-символьная хэш-строка */
3
+ get hash(): string
4
+
5
+ /** Генератор хеш-кода
6
+ * @param length - длина хэш строки
7
+ */
8
+ createHash(length:number):string
9
+
10
+ /** Фильтр часто запускаемых действий
11
+ * @param keyTimer - уникальный ключ таймера
12
+ * @param duration - время задержки для срабатывания action
13
+ * @param action - действие которое должно отработать
14
+ */
15
+ actionFilter({ keyTimer, duration=10, action }:{
16
+ keyTimer: string;
17
+ duration: number;
18
+ action: ()=>void;
19
+ }):void
20
+
21
+ /** Включение режима NO-SLEEP */
22
+ noSleep(): void
23
+
24
+ /** Скачать данные в JSON-файл */
25
+ downloadFileJson(data, filename:string ): void
26
+ }
27
+
28
28
  export default BxHelper
@@ -1,44 +1,44 @@
1
- declare class BxLogger {
2
- /** Очистка хранилища элементов старше 'N' месяцев */
3
- periodClear: number;
4
-
5
- /** Инициализация логгера */
6
- async init(): Promise<boolean>;
7
-
8
- /** Старт сессии логгера
9
- * @param type - тип логирования
10
- * @param data - данные для сохранения сессии логирования
11
- * @return - генерирует уникальный ключ сессии логирования в виде строки
12
- */
13
- start({ type, data }:{
14
- type: 'call'|'batch'|'batch-total-count';
15
- data: {
16
- method: string,
17
- params: { [key]: any }
18
- }|{ commandList: { [key]: any } };
19
- }):string;
20
-
21
- /** Конец сессии логирования
22
- * @param key - уникальный ключ сессии
23
- * @param errorList - массив ошибок
24
- * @param status - статус сессии
25
- * @param answer - служебная информация
26
- */
27
- stop({ key, errorList, status, answer }:{
28
- key: string;
29
- errorList: any[];
30
- status: 'success'|'fail'|'fail-runtime';
31
- answer: { [key]: unknown };
32
- }):void
33
-
34
- /**
35
- * Получение списка логирования
36
- * @param progressCall - коллбэк
37
- */
38
- async getEntityList(progressCall: (data:{ percent: number })=>void): Promise<{[key]: any}[]>
39
-
40
- /** Выгрузка всех данных из хранилища в JSON-файл */
41
- downAllEntityJson(): void
42
- }
43
-
1
+ declare class BxLogger {
2
+ /** Очистка хранилища элементов старше 'N' месяцев */
3
+ periodClear: number;
4
+
5
+ /** Инициализация логгера */
6
+ async init(): Promise<boolean>;
7
+
8
+ /** Старт сессии логгера
9
+ * @param type - тип логирования
10
+ * @param data - данные для сохранения сессии логирования
11
+ * @return - генерирует уникальный ключ сессии логирования в виде строки
12
+ */
13
+ start({ type, data }:{
14
+ type: 'call'|'batch'|'batch-total-count';
15
+ data: {
16
+ method: string,
17
+ params: { [key]: any }
18
+ }|{ commandList: { [key]: any } };
19
+ }):string;
20
+
21
+ /** Конец сессии логирования
22
+ * @param key - уникальный ключ сессии
23
+ * @param errorList - массив ошибок
24
+ * @param status - статус сессии
25
+ * @param answer - служебная информация
26
+ */
27
+ stop({ key, errorList, status, answer }:{
28
+ key: string;
29
+ errorList: any[];
30
+ status: 'success'|'fail'|'fail-runtime';
31
+ answer: { [key]: unknown };
32
+ }):void
33
+
34
+ /**
35
+ * Получение списка логирования
36
+ * @param progressCall - коллбэк
37
+ */
38
+ async getEntityList(progressCall: (data:{ percent: number })=>void): Promise<{[key]: any}[]>
39
+
40
+ /** Выгрузка всех данных из хранилища в JSON-файл */
41
+ downAllEntityJson(): void
42
+ }
43
+
44
44
  export default BxLogger;
@@ -1,15 +1,15 @@
1
- import Batch from "./batch";
2
- import BxBoot from "./bx-boot";
3
- import BxHelper from "./bx-helper";
4
- import BxLogger from './bx-logger';
5
-
6
- declare function tempus():{
7
- format();
8
- calc();
9
- lang();
10
- valid();
11
- between();
12
- generate();
13
- };
14
-
1
+ import Batch from "./batch";
2
+ import BxBoot from "./bx-boot";
3
+ import BxHelper from "./bx-helper";
4
+ import BxLogger from './bx-logger';
5
+
6
+ declare function tempus():{
7
+ format();
8
+ calc();
9
+ lang();
10
+ valid();
11
+ between();
12
+ generate();
13
+ };
14
+
15
15
  export { Batch, BxBoot, BxHelper, BxLogger, tempus }
package/package.json CHANGED
@@ -1,41 +1,41 @@
1
- {
2
- "name": "szdl-utils-kit",
3
- "description": "utils-kit library",
4
- "private": false,
5
- "version": "0.2.28",
6
- "type": "module",
7
- "author": "Stanislav Ovv",
8
- "license": "BSD",
9
- "module": "./dist/index.js",
10
- "main": "./dist/index.umd.cjs",
11
- "types": "./dist/types/index.d.ts",
12
- "exports": {
13
- ".": {
14
- "import": "./dist/index.js",
15
- "require": "./dist/index.umd.cjs"
16
- }
17
- },
18
- "files": [
19
- "dist"
20
- ],
21
- "keywords": [
22
- "szdl",
23
- "utils",
24
- "szdl-utils-kit"
25
- ],
26
- "scripts": {
27
- "dev": "vite --host",
28
- "watch": "vite build --watch",
29
- "build": "vite build",
30
- "preview": "vite preview",
31
- "pub": "npm version patch && npm publish"
32
- },
33
- "devDependencies": {
34
- "vite": "^4.4.5",
35
- "vite-plugin-dts": "^3.6.0",
36
- "vite-plugin-static-copy": "^0.17.0"
37
- },
38
- "dependencies": {
39
- "tempusjs": "^0.2.18"
40
- }
41
- }
1
+ {
2
+ "name": "szdl-utils-kit",
3
+ "description": "utils-kit library",
4
+ "private": false,
5
+ "version": "0.2.30",
6
+ "type": "module",
7
+ "author": "Stanislav Ovv",
8
+ "license": "BSD",
9
+ "module": "./dist/index.js",
10
+ "main": "./dist/index.umd.cjs",
11
+ "types": "./dist/types/index.d.ts",
12
+ "exports": {
13
+ ".": {
14
+ "import": "./dist/index.js",
15
+ "require": "./dist/index.umd.cjs"
16
+ }
17
+ },
18
+ "files": [
19
+ "dist"
20
+ ],
21
+ "keywords": [
22
+ "szdl",
23
+ "utils",
24
+ "szdl-utils-kit"
25
+ ],
26
+ "scripts": {
27
+ "dev": "vite --host",
28
+ "watch": "vite build --watch",
29
+ "build": "vite build",
30
+ "preview": "vite preview",
31
+ "pub": "npm version patch && npm publish"
32
+ },
33
+ "devDependencies": {
34
+ "vite": "^4.4.5",
35
+ "vite-plugin-dts": "^3.6.0",
36
+ "vite-plugin-static-copy": "^0.17.0"
37
+ },
38
+ "dependencies": {
39
+ "tempusjs": "^0.2.18"
40
+ }
41
+ }