emr-bridge 2.0.1 → 2.1.0

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.
Files changed (75) hide show
  1. package/README.md +8 -0
  2. package/cjs/entries/index.d.ts +1 -0
  3. package/cjs/entries/index.js +19 -0
  4. package/cjs/errors.d.ts +18 -0
  5. package/cjs/errors.js +34 -1
  6. package/cjs/package.json +3 -0
  7. package/cjs/scripts/base-bridge.d.ts +15 -8
  8. package/cjs/scripts/base-bridge.js +88 -42
  9. package/cjs/scripts/helpers/entities-info.d.ts +20 -0
  10. package/cjs/scripts/helpers/entities-info.js +38 -0
  11. package/cjs/scripts/helpers/env.js +1 -1
  12. package/cjs/scripts/helpers/id.d.ts +9 -0
  13. package/cjs/scripts/helpers/id.js +15 -1
  14. package/cjs/scripts/helpers/index.d.ts +3 -0
  15. package/cjs/scripts/helpers/index.js +7 -1
  16. package/cjs/scripts/helpers/ipc-channel.d.ts +10 -0
  17. package/cjs/scripts/helpers/ipc-channel.js +73 -61
  18. package/cjs/scripts/helpers/ipc-event-in-main.d.ts +7 -1
  19. package/cjs/scripts/helpers/ipc-event-in-main.js +27 -2
  20. package/cjs/scripts/helpers/ipc-payload.d.ts +38 -0
  21. package/cjs/scripts/helpers/ipc-payload.js +82 -0
  22. package/cjs/scripts/helpers/ipc-result.d.ts +9 -1
  23. package/cjs/scripts/helpers/ipc-result.js +32 -9
  24. package/cjs/scripts/helpers/names.d.ts +20 -0
  25. package/cjs/scripts/helpers/names.js +77 -0
  26. package/cjs/scripts/helpers/transfer.d.ts +8 -0
  27. package/cjs/scripts/helpers/transfer.js +24 -10
  28. package/cjs/scripts/helpers/web-contents-events-container.d.ts +57 -8
  29. package/cjs/scripts/helpers/web-contents-events-container.js +150 -25
  30. package/cjs/scripts/main/publish.d.ts +2 -2
  31. package/cjs/scripts/main/publish.js +177 -78
  32. package/cjs/scripts/preload/bridge.d.ts +2 -2
  33. package/cjs/scripts/preload/bridge.js +7 -6
  34. package/cjs/scripts/preload/provider.js +113 -18
  35. package/cjs/scripts/renderer/bridge.js +5 -0
  36. package/cjs/scripts/renderer/tunnels.d.ts +19 -2
  37. package/cjs/scripts/renderer/tunnels.js +133 -32
  38. package/cjs/types.d.ts +4 -0
  39. package/esm/entries/index.d.ts +1 -0
  40. package/esm/entries/index.js +5 -1
  41. package/esm/errors.d.ts +18 -0
  42. package/esm/errors.js +30 -0
  43. package/esm/scripts/base-bridge.d.ts +15 -8
  44. package/esm/scripts/base-bridge.js +90 -44
  45. package/esm/scripts/helpers/entities-info.d.ts +20 -0
  46. package/esm/scripts/helpers/entities-info.js +35 -0
  47. package/esm/scripts/helpers/env.js +1 -1
  48. package/esm/scripts/helpers/id.d.ts +9 -0
  49. package/esm/scripts/helpers/id.js +15 -1
  50. package/esm/scripts/helpers/index.d.ts +3 -0
  51. package/esm/scripts/helpers/index.js +3 -0
  52. package/esm/scripts/helpers/ipc-channel.d.ts +10 -0
  53. package/esm/scripts/helpers/ipc-channel.js +74 -63
  54. package/esm/scripts/helpers/ipc-event-in-main.d.ts +7 -1
  55. package/esm/scripts/helpers/ipc-event-in-main.js +24 -2
  56. package/esm/scripts/helpers/ipc-payload.d.ts +38 -0
  57. package/esm/scripts/helpers/ipc-payload.js +79 -0
  58. package/esm/scripts/helpers/ipc-result.d.ts +9 -1
  59. package/esm/scripts/helpers/ipc-result.js +32 -9
  60. package/esm/scripts/helpers/names.d.ts +20 -0
  61. package/esm/scripts/helpers/names.js +74 -0
  62. package/esm/scripts/helpers/transfer.d.ts +8 -0
  63. package/esm/scripts/helpers/transfer.js +24 -10
  64. package/esm/scripts/helpers/web-contents-events-container.d.ts +57 -8
  65. package/esm/scripts/helpers/web-contents-events-container.js +150 -25
  66. package/esm/scripts/main/publish.d.ts +2 -2
  67. package/esm/scripts/main/publish.js +179 -80
  68. package/esm/scripts/preload/bridge.d.ts +2 -2
  69. package/esm/scripts/preload/bridge.js +8 -7
  70. package/esm/scripts/preload/provider.js +114 -19
  71. package/esm/scripts/renderer/bridge.js +5 -0
  72. package/esm/scripts/renderer/tunnels.d.ts +19 -2
  73. package/esm/scripts/renderer/tunnels.js +135 -35
  74. package/esm/types.d.ts +4 -0
  75. package/package.json +35 -13
@@ -1,12 +1,15 @@
1
1
  import type { WebContents } from 'electron';
2
2
  /**
3
3
  * Обёртка над стандартным `WebContents`, позволяющая использовать события.
4
+ *
5
+ * Хранит только живые `WebContents` и удаляет опустевшие события,
6
+ * чтобы долгоживущий main процесс не накапливал мусор.
4
7
  */
5
8
  export default class WebContentsEventContainer {
6
9
  /**
7
- * Контейнер событий.
10
+ * Контейнеры событий.
8
11
  */
9
- private containers;
12
+ private readonly containers;
10
13
  /**
11
14
  * Добавить многоразового отправителя для события.
12
15
  * @param event - Имя события.
@@ -19,10 +22,22 @@ export default class WebContentsEventContainer {
19
22
  * @param sender - Отправитель.
20
23
  */
21
24
  addOnce(event: string, sender: WebContents): void;
25
+ /**
26
+ * Удалить одну подписку многоразового отправителя.
27
+ * @param event - Имя события.
28
+ * @param sender - Отправитель.
29
+ */
30
+ removeOn(event: string, sender: WebContents): void;
31
+ /**
32
+ * Удалить одну подписку одноразового отправителя.
33
+ * @param event - Имя события.
34
+ * @param sender - Отправитель.
35
+ */
36
+ removeOnce(event: string, sender: WebContents): void;
22
37
  /**
23
38
  * Получить многоразовых отправителей для события.
24
39
  * @param event - Имя события.
25
- * @returns многоразовые отправители для события.
40
+ * @returns Многоразовые отправители для события.
26
41
  */
27
42
  getOn(event: string): WebContents[];
28
43
  /**
@@ -32,7 +47,10 @@ export default class WebContentsEventContainer {
32
47
  */
33
48
  getOnce(event: string): WebContents[];
34
49
  /**
35
- * Получить всех отправителей для события.
50
+ * Получить всех уникальных отправителей для события.
51
+ *
52
+ * Один отправитель получает одно IPC-сообщение, даже если у него
53
+ * есть и многоразовый, и одноразовый обработчик.
36
54
  * @param event - Имя события.
37
55
  * @returns Отправители для события.
38
56
  */
@@ -43,9 +61,40 @@ export default class WebContentsEventContainer {
43
61
  */
44
62
  clearOnce(event: string): void;
45
63
  /**
46
- * Добавить контейнер события.
47
- * @param name - Имя события.
48
- * @returns Добавленный контейнер.
64
+ * Увеличить число подписок отправителя.
65
+ * @param event - Имя события.
66
+ * @param type - Тип подписки.
67
+ * @param sender - Отправитель.
68
+ */
69
+ private increment;
70
+ /**
71
+ * Уменьшить число подписок отправителя.
72
+ * @param event - Имя события.
73
+ * @param type - Тип подписки.
74
+ * @param sender - Отправитель.
75
+ */
76
+ private decrement;
77
+ /**
78
+ * Получить контейнер события или создать его.
79
+ * @param event - Имя события.
80
+ * @returns Контейнер события.
81
+ */
82
+ private getOrCreate;
83
+ /**
84
+ * Удалить уничтоженные отправители.
85
+ * @param event - Имя события.
86
+ * @param container - Контейнер события.
87
+ */
88
+ private prune;
89
+ /**
90
+ * Удалить контейнер события, если в нём не осталось подписчиков.
91
+ * @param event - Имя события.
92
+ * @param container - Контейнер события.
93
+ */
94
+ private deleteIfEmpty;
95
+ /**
96
+ * Жив ли отправитель.
97
+ * @param sender - Отправитель.
49
98
  */
50
- private addEvent;
99
+ private static isAlive;
51
100
  }
@@ -2,21 +2,22 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  /**
4
4
  * Обёртка над стандартным `WebContents`, позволяющая использовать события.
5
+ *
6
+ * Хранит только живые `WebContents` и удаляет опустевшие события,
7
+ * чтобы долгоживущий main процесс не накапливал мусор.
5
8
  */
6
9
  class WebContentsEventContainer {
7
- constructor() {
8
- /**
9
- * Контейнер событий.
10
- */
11
- this.containers = {};
12
- }
10
+ /**
11
+ * Контейнеры событий.
12
+ */
13
+ containers = new Map();
13
14
  /**
14
15
  * Добавить многоразового отправителя для события.
15
16
  * @param event - Имя события.
16
17
  * @param sender - Отправитель.
17
18
  */
18
19
  addOn(event, sender) {
19
- this.addEvent(event).on.push(sender);
20
+ this.increment(event, 'on', sender);
20
21
  }
21
22
  /**
22
23
  * Добавить одноразового отправителя для события.
@@ -24,15 +25,36 @@ class WebContentsEventContainer {
24
25
  * @param sender - Отправитель.
25
26
  */
26
27
  addOnce(event, sender) {
27
- this.addEvent(event).once.push(sender);
28
+ this.increment(event, 'once', sender);
29
+ }
30
+ /**
31
+ * Удалить одну подписку многоразового отправителя.
32
+ * @param event - Имя события.
33
+ * @param sender - Отправитель.
34
+ */
35
+ removeOn(event, sender) {
36
+ this.decrement(event, 'on', sender);
37
+ }
38
+ /**
39
+ * Удалить одну подписку одноразового отправителя.
40
+ * @param event - Имя события.
41
+ * @param sender - Отправитель.
42
+ */
43
+ removeOnce(event, sender) {
44
+ this.decrement(event, 'once', sender);
28
45
  }
29
46
  /**
30
47
  * Получить многоразовых отправителей для события.
31
48
  * @param event - Имя события.
32
- * @returns многоразовые отправители для события.
49
+ * @returns Многоразовые отправители для события.
33
50
  */
34
51
  getOn(event) {
35
- return this.addEvent(event).on;
52
+ const container = this.containers.get(event);
53
+ if (!container) {
54
+ return [];
55
+ }
56
+ this.prune(event, container);
57
+ return [...container.on.keys()];
36
58
  }
37
59
  /**
38
60
  * Получить одноразовых отправителей для события.
@@ -40,36 +62,139 @@ class WebContentsEventContainer {
40
62
  * @returns Одноразовые отправители для события.
41
63
  */
42
64
  getOnce(event) {
43
- return this.addEvent(event).once;
65
+ const container = this.containers.get(event);
66
+ if (!container) {
67
+ return [];
68
+ }
69
+ this.prune(event, container);
70
+ return [...container.once.keys()];
44
71
  }
45
72
  /**
46
- * Получить всех отправителей для события.
73
+ * Получить всех уникальных отправителей для события.
74
+ *
75
+ * Один отправитель получает одно IPC-сообщение, даже если у него
76
+ * есть и многоразовый, и одноразовый обработчик.
47
77
  * @param event - Имя события.
48
78
  * @returns Отправители для события.
49
79
  */
50
80
  getAll(event) {
51
- const container = this.addEvent(event);
52
- return [...container.on, ...container.once];
81
+ const container = this.containers.get(event);
82
+ if (!container) {
83
+ return [];
84
+ }
85
+ this.prune(event, container);
86
+ const senders = [...container.on.keys()];
87
+ for (const sender of container.once.keys()) {
88
+ if (!container.on.has(sender)) {
89
+ senders.push(sender);
90
+ }
91
+ }
92
+ return senders;
53
93
  }
54
94
  /**
55
95
  * Удалить одноразовых отправителей для события.
56
96
  * @param event - Имя события.
57
97
  */
58
98
  clearOnce(event) {
59
- this.addEvent(event).once = [];
99
+ const container = this.containers.get(event);
100
+ if (!container) {
101
+ return;
102
+ }
103
+ container.once.clear();
104
+ this.prune(event, container);
105
+ }
106
+ /**
107
+ * Увеличить число подписок отправителя.
108
+ * @param event - Имя события.
109
+ * @param type - Тип подписки.
110
+ * @param sender - Отправитель.
111
+ */
112
+ increment(event, type, sender) {
113
+ const container = this.getOrCreate(event);
114
+ if (!WebContentsEventContainer.isAlive(sender)) {
115
+ this.deleteIfEmpty(event, container);
116
+ return;
117
+ }
118
+ container[type].set(sender, (container[type].get(sender) ?? 0) + 1);
60
119
  }
61
120
  /**
62
- * Добавить контейнер события.
63
- * @param name - Имя события.
64
- * @returns Добавленный контейнер.
121
+ * Уменьшить число подписок отправителя.
122
+ * @param event - Имя события.
123
+ * @param type - Тип подписки.
124
+ * @param sender - Отправитель.
125
+ */
126
+ decrement(event, type, sender) {
127
+ const container = this.containers.get(event);
128
+ if (!container) {
129
+ return;
130
+ }
131
+ const count = container[type].get(sender);
132
+ if (count === undefined) {
133
+ return;
134
+ }
135
+ if (count <= 1) {
136
+ container[type].delete(sender);
137
+ }
138
+ else {
139
+ container[type].set(sender, count - 1);
140
+ }
141
+ this.deleteIfEmpty(event, container);
142
+ }
143
+ /**
144
+ * Получить контейнер события или создать его.
145
+ * @param event - Имя события.
146
+ * @returns Контейнер события.
147
+ */
148
+ getOrCreate(event) {
149
+ let container = this.containers.get(event);
150
+ if (!container) {
151
+ container = { on: new Map(), once: new Map() };
152
+ this.containers.set(event, container);
153
+ }
154
+ else {
155
+ this.prune(event, container);
156
+ if (!this.containers.has(event)) {
157
+ container = { on: new Map(), once: new Map() };
158
+ this.containers.set(event, container);
159
+ }
160
+ }
161
+ return container;
162
+ }
163
+ /**
164
+ * Удалить уничтоженные отправители.
165
+ * @param event - Имя события.
166
+ * @param container - Контейнер события.
167
+ */
168
+ prune(event, container) {
169
+ for (const sender of container.on.keys()) {
170
+ if (!WebContentsEventContainer.isAlive(sender)) {
171
+ container.on.delete(sender);
172
+ }
173
+ }
174
+ for (const sender of container.once.keys()) {
175
+ if (!WebContentsEventContainer.isAlive(sender)) {
176
+ container.once.delete(sender);
177
+ }
178
+ }
179
+ this.deleteIfEmpty(event, container);
180
+ }
181
+ /**
182
+ * Удалить контейнер события, если в нём не осталось подписчиков.
183
+ * @param event - Имя события.
184
+ * @param container - Контейнер события.
185
+ */
186
+ deleteIfEmpty(event, container) {
187
+ if (container.on.size === 0 && container.once.size === 0) {
188
+ this.containers.delete(event);
189
+ }
190
+ }
191
+ /**
192
+ * Жив ли отправитель.
193
+ * @param sender - Отправитель.
65
194
  */
66
- addEvent(name) {
67
- var _a;
68
- const container = (_a = this.containers)[name] ?? (_a[name] = { on: [], once: [] });
69
- return this.containers[name] = {
70
- on: container.on.filter(item => !item.isDestroyed()),
71
- once: container.once.filter(item => !item.isDestroyed()),
72
- };
195
+ static isAlive(sender) {
196
+ const candidate = sender;
197
+ return typeof candidate.isDestroyed !== 'function' || !candidate.isDestroyed();
73
198
  }
74
199
  }
75
200
  exports.default = WebContentsEventContainer;
@@ -12,7 +12,7 @@ export declare function emitEvent<T = unknown>(name: string, value?: T): void;
12
12
  * @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
13
13
  * @returns Функция отписки от события.
14
14
  */
15
- export declare function on<TValue = any>(name: string, listener: EventListener<TValue>, receives?: HasSnapshotClass<TValue>): EventUnsubscribe;
15
+ export declare function on<TValue = any>(name: string, listener: EventListener<TValue>, receives?: HasSnapshotClass<any>): EventUnsubscribe;
16
16
  /**
17
17
  * Добавить одноразовый обработчик renderer события.
18
18
  * @param name - Имя события.
@@ -20,7 +20,7 @@ export declare function on<TValue = any>(name: string, listener: EventListener<T
20
20
  * @param receives - Класс передаваемого значения, если оно не может быть передано стандартным способом.
21
21
  * @returns Функция отписки от события.
22
22
  */
23
- export declare function once<TValue = any>(name: string, listener: EventListener<TValue>, receives?: HasSnapshotClass<TValue>): EventUnsubscribe;
23
+ export declare function once<TValue = any>(name: string, listener: EventListener<TValue>, receives?: HasSnapshotClass<any>): EventUnsubscribe;
24
24
  /**
25
25
  * Опубликовать (сделать доступной) функцию из main процесса.
26
26
  * @param name - Имя, по которому будет доступна функция в renderer процессе.
@@ -26,10 +26,62 @@ const eventsContainer = new index_js_1.WebContentsEventsContainer();
26
26
  const canThrowError = (index_js_1.Env.hasWindow || !electron_1.ipcMain)
27
27
  ? index_js_1.Errors.getThrower(errors_js_1.PublishMethodsUnavailableError)
28
28
  : () => { };
29
+ /**
30
+ * Безопасно отправить результат в канал `renderer` процесса.
31
+ * @param sender - Получатель.
32
+ * @param channel - IPC канал.
33
+ * @param result - Результат.
34
+ */
35
+ function sendToRenderer(sender, channel, result) {
36
+ if (!sender || sender.isDestroyed()) {
37
+ return;
38
+ }
39
+ try {
40
+ sender.send(channel, result);
41
+ }
42
+ catch {
43
+ // Получатель мог быть уничтожен между проверкой и отправкой.
44
+ }
45
+ }
46
+ /**
47
+ * Создать результат со значением, не выбрасывая исключение наружу.
48
+ * @param value - Значение.
49
+ * @param id - Уникальный идентификатор.
50
+ */
51
+ function createValueResult(value, id) {
52
+ try {
53
+ return index_js_1.IpcResult.createWithValue(value, id);
54
+ }
55
+ catch (error) {
56
+ return index_js_1.IpcResult.createWithError(error, id);
57
+ }
58
+ }
29
59
  if (electron_1.ipcMain) {
30
60
  electron_1.ipcMain.on(index_js_1.IpcChannel.publicInfo.get(), event => new index_js_1.IpcEventInMain(event).return(entitiesInfo));
31
- electron_1.ipcMain.on(index_js_1.IpcChannel.event.on(), (event, { value }) => eventsContainer.addOn(value, event.sender));
32
- electron_1.ipcMain.on(index_js_1.IpcChannel.event.once(), (event, { value }) => eventsContainer.addOn(value, event.sender));
61
+ electron_1.ipcMain.on(index_js_1.IpcChannel.event.on(), (event, payload) => {
62
+ const name = index_js_1.IpcPayload.eventName(payload);
63
+ if (name) {
64
+ eventsContainer.addOn(name, event.sender);
65
+ }
66
+ });
67
+ electron_1.ipcMain.on(index_js_1.IpcChannel.event.once(), (event, payload) => {
68
+ const name = index_js_1.IpcPayload.eventName(payload);
69
+ if (name) {
70
+ eventsContainer.addOnce(name, event.sender);
71
+ }
72
+ });
73
+ electron_1.ipcMain.on(index_js_1.IpcChannel.event.off(), (event, payload) => {
74
+ const name = index_js_1.IpcPayload.eventName(payload);
75
+ if (!name) {
76
+ return;
77
+ }
78
+ if (index_js_1.IpcPayload.eventType(payload) === 'once') {
79
+ eventsContainer.removeOnce(name, event.sender);
80
+ }
81
+ else {
82
+ eventsContainer.removeOn(name, event.sender);
83
+ }
84
+ });
33
85
  }
34
86
  /**
35
87
  * Вызвать событие из main процесса.
@@ -38,31 +90,27 @@ if (electron_1.ipcMain) {
38
90
  */
39
91
  function emitEvent(name, value) {
40
92
  canThrowError();
93
+ index_js_1.Names.validateEvent(name);
41
94
  const emitChannel = index_js_1.IpcChannel.event.emit(name);
42
- try {
43
- if (value instanceof Promise) {
44
- value
45
- .then(val => {
46
- for (const sender of eventsContainer.getAll(name)) {
47
- sender.send(emitChannel, index_js_1.IpcResult.createWithValue(val));
48
- }
49
- eventsContainer.clearOnce(name);
50
- })
51
- .catch(reason => {
52
- eventsContainer.getAll(name).forEach(sender => sender.send(emitChannel, index_js_1.IpcResult.createWithError(reason)));
53
- eventsContainer.clearOnce(name);
54
- });
55
- return;
95
+ // Подписчики фиксируются на момент вызова: слушатель, добавленный
96
+ // после `emitEvent`, не должен получить уже отправленное событие.
97
+ const senders = eventsContainer.getAll(name);
98
+ eventsContainer.clearOnce(name);
99
+ const deliver = (result) => {
100
+ for (const sender of senders) {
101
+ sendToRenderer(sender, emitChannel, result);
56
102
  }
57
- for (const sender of eventsContainer.getAll(name)) {
58
- sender.send(emitChannel, index_js_1.IpcResult.createWithValue(value));
103
+ };
104
+ if (index_js_1.Transfer.isPromiseLike(value)) {
105
+ try {
106
+ value.then(result => deliver(createValueResult(result)), reason => deliver(index_js_1.IpcResult.createWithError(reason)));
59
107
  }
60
- eventsContainer.clearOnce(name);
61
- }
62
- catch (error) {
63
- eventsContainer.getAll(name).forEach(sender => sender.send(emitChannel, index_js_1.IpcResult.createWithError(error)));
64
- eventsContainer.clearOnce(name);
108
+ catch (error) {
109
+ deliver(index_js_1.IpcResult.createWithError(error));
110
+ }
111
+ return;
65
112
  }
113
+ deliver(createValueResult(value));
66
114
  }
67
115
  /**
68
116
  * Добавить обработчик renderer события.
@@ -73,17 +121,8 @@ function emitEvent(name, value) {
73
121
  */
74
122
  function on(name, listener, receives) {
75
123
  canThrowError();
76
- const emitChannel = index_js_1.IpcChannel.event.emit(name);
77
- const handler = (_, { value }) => {
78
- if (index_js_1.Transfer.isSnapshotValue(value) && receives) {
79
- listener(index_js_1.Transfer.getFromSnapshot(value, receives));
80
- }
81
- else {
82
- listener(value);
83
- }
84
- };
85
- electron_1.ipcMain.on(emitChannel, handler);
86
- return () => electron_1.ipcMain.removeListener(emitChannel, handler);
124
+ index_js_1.Names.validateEvent(name);
125
+ return subscribeEvent(name, listener, receives, false);
87
126
  }
88
127
  /**
89
128
  * Добавить одноразовый обработчик renderer события.
@@ -94,16 +133,50 @@ function on(name, listener, receives) {
94
133
  */
95
134
  function once(name, listener, receives) {
96
135
  canThrowError();
136
+ index_js_1.Names.validateEvent(name);
137
+ return subscribeEvent(name, listener, receives, true);
138
+ }
139
+ /**
140
+ * Подписаться на событие из `renderer` процесса.
141
+ * @param name - Имя события.
142
+ * @param listener - Обработчик.
143
+ * @param receives - Класс передаваемого значения.
144
+ * @param isOnce - Одноразовая подписка.
145
+ * @returns Функция отписки от события.
146
+ */
147
+ function subscribeEvent(name, listener, receives, isOnce) {
148
+ if (typeof listener !== 'function') {
149
+ throw new TypeError('Обработчик события должен быть функцией.');
150
+ }
97
151
  const emitChannel = index_js_1.IpcChannel.event.emit(name);
98
- const handler = (_, { value }) => {
99
- if (index_js_1.Transfer.isSnapshotValue(value) && receives) {
100
- listener(index_js_1.Transfer.getFromSnapshot(value, receives));
152
+ const handler = (_, payload) => {
153
+ const result = index_js_1.IpcPayload.result(payload);
154
+ if (!result) {
155
+ return;
101
156
  }
102
- else {
103
- listener(value);
157
+ if (result.error) {
158
+ console.error(`[emr-bridge] Ошибка события '${name}':\n${result.error}`);
159
+ return;
160
+ }
161
+ let value = result.value;
162
+ if (index_js_1.Transfer.isSnapshotValue(result.value) && receives) {
163
+ try {
164
+ value = index_js_1.Transfer.getFromSnapshot(result.value, receives);
165
+ }
166
+ catch (error) {
167
+ // Недоверенный снимок из renderer не должен ронять main процесс.
168
+ console.error(`[emr-bridge] Не удалось восстановить значение события '${name}'.`, error);
169
+ return;
170
+ }
104
171
  }
172
+ listener(value);
105
173
  };
106
- electron_1.ipcMain.once(emitChannel, handler);
174
+ if (isOnce) {
175
+ electron_1.ipcMain.once(emitChannel, handler);
176
+ }
177
+ else {
178
+ electron_1.ipcMain.on(emitChannel, handler);
179
+ }
107
180
  return () => electron_1.ipcMain.removeListener(emitChannel, handler);
108
181
  }
109
182
  /**
@@ -114,30 +187,40 @@ function once(name, listener, receives) {
114
187
  */
115
188
  function publishFunction(name, func, receives = []) {
116
189
  canThrowError();
190
+ index_js_1.Names.validateEntity(name);
191
+ if (typeof func !== 'function') {
192
+ throw new TypeError(`Публикуемая функция '${name}' должна быть функцией.`);
193
+ }
194
+ if (!Array.isArray(receives)) {
195
+ throw new TypeError('`receives` должен быть массивом классов.');
196
+ }
117
197
  const channel = index_js_1.IpcChannel.func.call(name);
118
198
  entitiesInfo.functions.add(name);
119
199
  electron_1.ipcMain.removeAllListeners(channel);
120
- electron_1.ipcMain.on(channel, (e, { args, id }) => {
200
+ electron_1.ipcMain.on(channel, (e, payload) => {
121
201
  const event = new index_js_1.IpcEventInMain(e);
202
+ const request = index_js_1.IpcPayload.request(payload);
203
+ if (!request) {
204
+ event.return(index_js_1.IpcResult.createWithError(new TypeError('Некорректный запрос вызова функции.')));
205
+ return;
206
+ }
122
207
  const receivesCopy = [...receives];
123
208
  try {
124
- const preparedArgs = args.map(arg => (index_js_1.Transfer.isSnapshotValue(arg) && receivesCopy[0]
209
+ const preparedArgs = request.args.map(arg => (index_js_1.Transfer.isSnapshotValue(arg) && receivesCopy[0]
125
210
  ? index_js_1.Transfer.getFromSnapshot(arg, receivesCopy.shift())
126
211
  : arg));
127
212
  const result = func(...preparedArgs);
128
- if (result instanceof Promise) {
213
+ if (index_js_1.Transfer.isPromiseLike(result)) {
129
214
  const promiseChannel = index_js_1.IpcChannel.promise.get(channel);
130
- result
131
- .then(value => event.send(promiseChannel, index_js_1.IpcResult.createWithValue(value, id)))
132
- .catch(reason => event.send(promiseChannel, index_js_1.IpcResult.createWithError(reason, id)));
215
+ result.then(value => event.send(promiseChannel, createValueResult(value, request.id)), reason => event.send(promiseChannel, index_js_1.IpcResult.createWithError(reason, request.id)));
133
216
  event.return(index_js_1.IpcResult.createWithPromise(promiseChannel));
134
217
  }
135
218
  else {
136
- event.return(index_js_1.IpcResult.createWithValue(result));
219
+ event.return(createValueResult(result, request.id));
137
220
  }
138
221
  }
139
222
  catch (error) {
140
- event.return(index_js_1.IpcResult.createWithError(error));
223
+ event.return(index_js_1.IpcResult.createWithError(error, request.id));
141
224
  }
142
225
  });
143
226
  }
@@ -148,37 +231,53 @@ function publishFunction(name, func, receives = []) {
148
231
  */
149
232
  function publishVariable(name, descriptor) {
150
233
  canThrowError();
234
+ index_js_1.Names.validateEntity(name);
235
+ if (!descriptor || typeof descriptor !== 'object') {
236
+ throw new TypeError(`Не задан дескриптор переменной '${name}'.`);
237
+ }
151
238
  const getChannel = index_js_1.IpcChannel.prop.get(name);
152
239
  const setChannel = index_js_1.IpcChannel.prop.set(name);
153
- const { set: setter, value } = descriptor;
154
- let { get: getter } = descriptor;
240
+ const setter = typeof descriptor.set === 'function' ? descriptor.set : undefined;
241
+ const getter = 'value' in descriptor
242
+ ? () => descriptor.value
243
+ : typeof descriptor.get === 'function'
244
+ ? descriptor.get
245
+ : undefined;
155
246
  entitiesInfo.variables.add(name);
156
- if (value) {
157
- getter = () => value;
158
- }
159
- if (getter) {
160
- electron_1.ipcMain.removeAllListeners(getChannel);
161
- electron_1.ipcMain.on(getChannel, e => {
162
- const event = new index_js_1.IpcEventInMain(e);
163
- try {
164
- event.return(index_js_1.IpcResult.createWithValue(getter()));
165
- }
166
- catch (error) {
167
- event.return(index_js_1.IpcResult.createWithError(error));
168
- }
169
- });
170
- }
171
- if (setter) {
172
- electron_1.ipcMain.removeAllListeners(setChannel);
173
- electron_1.ipcMain.on(setChannel, (e, { args }) => {
174
- const event = new index_js_1.IpcEventInMain(e);
175
- try {
176
- setter(args.at(0));
177
- event.return(index_js_1.IpcResult.createWithValue(null));
178
- }
179
- catch (error) {
180
- event.return(index_js_1.IpcResult.createWithError(error));
181
- }
182
- });
183
- }
247
+ // При повторной публикации старые обработчики должны быть удалены,
248
+ // иначе останется висеть доступ к прежнему значению.
249
+ electron_1.ipcMain.removeAllListeners(getChannel);
250
+ electron_1.ipcMain.removeAllListeners(setChannel);
251
+ electron_1.ipcMain.on(getChannel, e => {
252
+ const event = new index_js_1.IpcEventInMain(e);
253
+ if (!getter) {
254
+ event.return(index_js_1.IpcResult.createWithError(new errors_js_1.NoGetAccessError(name)));
255
+ return;
256
+ }
257
+ try {
258
+ event.return(createValueResult(getter()));
259
+ }
260
+ catch (error) {
261
+ event.return(index_js_1.IpcResult.createWithError(error));
262
+ }
263
+ });
264
+ electron_1.ipcMain.on(setChannel, (e, payload) => {
265
+ const event = new index_js_1.IpcEventInMain(e);
266
+ if (!setter) {
267
+ event.return(index_js_1.IpcResult.createWithError(new errors_js_1.TrySetReadonlyError(name)));
268
+ return;
269
+ }
270
+ const request = index_js_1.IpcPayload.request(payload);
271
+ if (!request) {
272
+ event.return(index_js_1.IpcResult.createWithError(new TypeError('Некорректный запрос установки переменной.')));
273
+ return;
274
+ }
275
+ try {
276
+ setter(request.args.at(0));
277
+ event.return(index_js_1.IpcResult.createWithValue(null));
278
+ }
279
+ catch (error) {
280
+ event.return(index_js_1.IpcResult.createWithError(error));
281
+ }
282
+ });
184
283
  }