emr-bridge 1.7.1 → 2.0.1
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.
- package/LICENCE +1 -1
- package/README.md +173 -366
- package/cjs/entries/index.d.ts +1 -0
- package/cjs/entries/index.js +6 -0
- package/cjs/entries/main.d.ts +2 -0
- package/cjs/entries/main.js +27 -0
- package/cjs/entries/preload.d.ts +3 -0
- package/cjs/entries/preload.js +29 -0
- package/cjs/entries/renderer.d.ts +2 -0
- package/cjs/entries/renderer.js +27 -0
- package/cjs/errors.d.ts +42 -10
- package/cjs/errors.js +77 -23
- package/cjs/scripts/base-bridge.d.ts +95 -0
- package/cjs/scripts/base-bridge.js +128 -0
- package/cjs/scripts/helpers/env.d.ts +19 -0
- package/cjs/scripts/helpers/env.js +28 -0
- package/cjs/scripts/helpers/errors.d.ts +12 -0
- package/cjs/scripts/helpers/errors.js +17 -0
- package/cjs/scripts/helpers/id.d.ts +9 -0
- package/cjs/scripts/helpers/id.js +14 -0
- package/cjs/scripts/helpers/index.d.ts +8 -0
- package/cjs/scripts/helpers/index.js +22 -0
- package/cjs/scripts/helpers/ipc-channel.d.ts +75 -0
- package/cjs/scripts/helpers/ipc-channel.js +78 -0
- package/cjs/scripts/helpers/ipc-event-in-main.d.ts +24 -0
- package/cjs/scripts/helpers/ipc-event-in-main.js +30 -0
- package/cjs/scripts/helpers/ipc-result.d.ts +26 -0
- package/cjs/scripts/helpers/ipc-result.js +48 -0
- package/cjs/scripts/helpers/transfer.d.ts +33 -0
- package/cjs/scripts/helpers/transfer.js +57 -0
- package/cjs/scripts/helpers/web-contents-events-container.d.ts +51 -0
- package/cjs/scripts/helpers/web-contents-events-container.js +75 -0
- package/cjs/scripts/main/publish.d.ts +36 -0
- package/cjs/scripts/main/publish.js +184 -0
- package/cjs/scripts/preload/bridge.d.ts +27 -0
- package/cjs/scripts/preload/bridge.js +85 -0
- package/cjs/scripts/preload/provider.d.ts +7 -0
- package/cjs/scripts/preload/provider.js +89 -0
- package/cjs/scripts/renderer/bridge.d.ts +6 -0
- package/cjs/scripts/renderer/bridge.js +74 -0
- package/cjs/scripts/renderer/tunnels.d.ts +171 -0
- package/cjs/scripts/renderer/tunnels.js +205 -0
- package/cjs/types.d.ts +189 -64
- package/esm/entries/index.d.ts +1 -0
- package/esm/entries/index.js +5 -0
- package/esm/entries/main.d.ts +2 -0
- package/esm/entries/main.js +5 -0
- package/esm/entries/preload.d.ts +3 -0
- package/esm/entries/preload.js +7 -0
- package/esm/entries/renderer.d.ts +2 -0
- package/esm/entries/renderer.js +6 -0
- package/esm/errors.d.ts +42 -10
- package/esm/errors.js +69 -16
- package/esm/scripts/base-bridge.d.ts +95 -0
- package/esm/scripts/base-bridge.js +125 -0
- package/esm/scripts/helpers/env.d.ts +19 -0
- package/esm/scripts/helpers/env.js +25 -0
- package/esm/scripts/helpers/errors.d.ts +12 -0
- package/esm/scripts/helpers/errors.js +14 -0
- package/esm/scripts/helpers/id.d.ts +9 -0
- package/esm/scripts/helpers/id.js +11 -0
- package/esm/scripts/helpers/index.d.ts +8 -0
- package/esm/scripts/helpers/index.js +8 -0
- package/esm/scripts/helpers/ipc-channel.d.ts +75 -0
- package/esm/scripts/helpers/ipc-channel.js +76 -0
- package/esm/scripts/helpers/ipc-event-in-main.d.ts +24 -0
- package/esm/scripts/helpers/ipc-event-in-main.js +27 -0
- package/esm/scripts/helpers/ipc-result.d.ts +26 -0
- package/esm/scripts/helpers/ipc-result.js +42 -0
- package/esm/scripts/helpers/transfer.d.ts +33 -0
- package/esm/scripts/helpers/transfer.js +54 -0
- package/esm/scripts/helpers/web-contents-events-container.d.ts +51 -0
- package/esm/scripts/helpers/web-contents-events-container.js +72 -0
- package/esm/scripts/main/publish.d.ts +36 -0
- package/esm/scripts/main/publish.js +177 -0
- package/esm/scripts/preload/bridge.d.ts +27 -0
- package/esm/scripts/preload/bridge.js +77 -0
- package/esm/scripts/preload/provider.d.ts +7 -0
- package/esm/scripts/preload/provider.js +84 -0
- package/esm/scripts/renderer/bridge.d.ts +6 -0
- package/esm/scripts/renderer/bridge.js +69 -0
- package/esm/scripts/renderer/tunnels.d.ts +171 -0
- package/esm/scripts/renderer/tunnels.js +203 -0
- package/esm/types.d.ts +189 -64
- package/package.json +23 -41
- package/cjs/enums.d.ts +0 -19
- package/cjs/enums.js +0 -25
- package/cjs/exp.d.ts +0 -4
- package/cjs/exp.js +0 -19
- package/cjs/index.d.ts +0 -4
- package/cjs/index.js +0 -18
- package/cjs/main.d.ts +0 -4
- package/cjs/main.js +0 -18
- package/cjs/preload.d.ts +0 -3
- package/cjs/preload.js +0 -10
- package/cjs/renderer.d.ts +0 -2
- package/cjs/renderer.js +0 -8
- package/cjs/scripts/bridge.d.ts +0 -8
- package/cjs/scripts/bridge.js +0 -57
- package/cjs/scripts/main.d.ts +0 -8
- package/cjs/scripts/main.js +0 -72
- package/cjs/scripts/new-decorators.d.ts +0 -150
- package/cjs/scripts/new-decorators.js +0 -141
- package/cjs/scripts/old-decorators.d.ts +0 -185
- package/cjs/scripts/old-decorators.js +0 -132
- package/cjs/scripts/preload-provider.d.ts +0 -7
- package/cjs/scripts/preload-provider.js +0 -96
- package/cjs/scripts/provider.d.ts +0 -25
- package/cjs/scripts/provider.js +0 -116
- package/cjs/scripts/publish.d.ts +0 -40
- package/cjs/scripts/publish.js +0 -232
- package/cjs/scripts/renderer-tunnels.d.ts +0 -47
- package/cjs/scripts/renderer-tunnels.js +0 -115
- package/esm/enums.d.ts +0 -19
- package/esm/enums.js +0 -22
- package/esm/exp.d.ts +0 -4
- package/esm/exp.js +0 -3
- package/esm/index.d.ts +0 -4
- package/esm/index.js +0 -3
- package/esm/main.d.ts +0 -4
- package/esm/main.js +0 -3
- package/esm/preload.d.ts +0 -3
- package/esm/preload.js +0 -2
- package/esm/renderer.d.ts +0 -2
- package/esm/renderer.js +0 -1
- package/esm/scripts/bridge.d.ts +0 -8
- package/esm/scripts/bridge.js +0 -52
- package/esm/scripts/main.d.ts +0 -8
- package/esm/scripts/main.js +0 -67
- package/esm/scripts/new-decorators.d.ts +0 -150
- package/esm/scripts/new-decorators.js +0 -132
- package/esm/scripts/old-decorators.d.ts +0 -185
- package/esm/scripts/old-decorators.js +0 -122
- package/esm/scripts/preload-provider.d.ts +0 -7
- package/esm/scripts/preload-provider.js +0 -91
- package/esm/scripts/provider.d.ts +0 -25
- package/esm/scripts/provider.js +0 -113
- package/esm/scripts/publish.d.ts +0 -40
- package/esm/scripts/publish.js +0 -220
- package/esm/scripts/renderer-tunnels.d.ts +0 -47
- package/esm/scripts/renderer-tunnels.js +0 -109
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для передачи значений через IPC.
|
|
3
|
+
*/
|
|
4
|
+
export default class Transfer {
|
|
5
|
+
/**
|
|
6
|
+
* Получить значение из снимка.
|
|
7
|
+
* @param value - Значение-снимок.
|
|
8
|
+
* @param Class - Класс, экземпляр которого будет создан из снимка.
|
|
9
|
+
* @returns Значение из снимка.
|
|
10
|
+
*/
|
|
11
|
+
static getFromSnapshot(value, Class) {
|
|
12
|
+
const instance = new Class();
|
|
13
|
+
instance.updateFromSnapshot(value.__snapshot__);
|
|
14
|
+
return instance;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Преобразовать значение в передаваемое по IPC.
|
|
18
|
+
*
|
|
19
|
+
* Если возможно, создаст снимок.
|
|
20
|
+
* @param value - Преобразуемое значение.
|
|
21
|
+
* @returns Значение, передаваемое по IPC.
|
|
22
|
+
*/
|
|
23
|
+
static toTransferable(value) {
|
|
24
|
+
if (this.isHasSnapshot(value)) {
|
|
25
|
+
return {
|
|
26
|
+
__type__: 'snapshot',
|
|
27
|
+
__snapshot__: value.takeSnapshot()
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
return value;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Является ли переданное по IPC значение снимком.
|
|
34
|
+
* @param value - Значение из IPC.
|
|
35
|
+
*/
|
|
36
|
+
static isSnapshotValue(value) {
|
|
37
|
+
return (!!value
|
|
38
|
+
&& typeof value === 'object'
|
|
39
|
+
&& '__type__' in value
|
|
40
|
+
&& '__snapshot__' in value
|
|
41
|
+
&& value.__type__ === 'snapshot'
|
|
42
|
+
&& !!value.__snapshot__);
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Может ли значение вернуть снимок.
|
|
46
|
+
* @param value - Значение.
|
|
47
|
+
*/
|
|
48
|
+
static isHasSnapshot(value) {
|
|
49
|
+
return (!!value
|
|
50
|
+
&& typeof value === 'object'
|
|
51
|
+
&& 'takeSnapshot' in value
|
|
52
|
+
&& 'fromSnapshot' in value);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { WebContents } from 'electron';
|
|
2
|
+
/**
|
|
3
|
+
* Обёртка над стандартным `WebContents`, позволяющая использовать события.
|
|
4
|
+
*/
|
|
5
|
+
export default class WebContentsEventContainer {
|
|
6
|
+
/**
|
|
7
|
+
* Контейнер событий.
|
|
8
|
+
*/
|
|
9
|
+
private containers;
|
|
10
|
+
/**
|
|
11
|
+
* Добавить многоразового отправителя для события.
|
|
12
|
+
* @param event - Имя события.
|
|
13
|
+
* @param sender - Отправитель.
|
|
14
|
+
*/
|
|
15
|
+
addOn(event: string, sender: WebContents): void;
|
|
16
|
+
/**
|
|
17
|
+
* Добавить одноразового отправителя для события.
|
|
18
|
+
* @param event - Имя события.
|
|
19
|
+
* @param sender - Отправитель.
|
|
20
|
+
*/
|
|
21
|
+
addOnce(event: string, sender: WebContents): void;
|
|
22
|
+
/**
|
|
23
|
+
* Получить многоразовых отправителей для события.
|
|
24
|
+
* @param event - Имя события.
|
|
25
|
+
* @returns многоразовые отправители для события.
|
|
26
|
+
*/
|
|
27
|
+
getOn(event: string): WebContents[];
|
|
28
|
+
/**
|
|
29
|
+
* Получить одноразовых отправителей для события.
|
|
30
|
+
* @param event - Имя события.
|
|
31
|
+
* @returns Одноразовые отправители для события.
|
|
32
|
+
*/
|
|
33
|
+
getOnce(event: string): WebContents[];
|
|
34
|
+
/**
|
|
35
|
+
* Получить всех отправителей для события.
|
|
36
|
+
* @param event - Имя события.
|
|
37
|
+
* @returns Отправители для события.
|
|
38
|
+
*/
|
|
39
|
+
getAll(event: string): WebContents[];
|
|
40
|
+
/**
|
|
41
|
+
* Удалить одноразовых отправителей для события.
|
|
42
|
+
* @param event - Имя события.
|
|
43
|
+
*/
|
|
44
|
+
clearOnce(event: string): void;
|
|
45
|
+
/**
|
|
46
|
+
* Добавить контейнер события.
|
|
47
|
+
* @param name - Имя события.
|
|
48
|
+
* @returns Добавленный контейнер.
|
|
49
|
+
*/
|
|
50
|
+
private addEvent;
|
|
51
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Обёртка над стандартным `WebContents`, позволяющая использовать события.
|
|
3
|
+
*/
|
|
4
|
+
export default class WebContentsEventContainer {
|
|
5
|
+
constructor() {
|
|
6
|
+
/**
|
|
7
|
+
* Контейнер событий.
|
|
8
|
+
*/
|
|
9
|
+
this.containers = {};
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Добавить многоразового отправителя для события.
|
|
13
|
+
* @param event - Имя события.
|
|
14
|
+
* @param sender - Отправитель.
|
|
15
|
+
*/
|
|
16
|
+
addOn(event, sender) {
|
|
17
|
+
this.addEvent(event).on.push(sender);
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Добавить одноразового отправителя для события.
|
|
21
|
+
* @param event - Имя события.
|
|
22
|
+
* @param sender - Отправитель.
|
|
23
|
+
*/
|
|
24
|
+
addOnce(event, sender) {
|
|
25
|
+
this.addEvent(event).once.push(sender);
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Получить многоразовых отправителей для события.
|
|
29
|
+
* @param event - Имя события.
|
|
30
|
+
* @returns многоразовые отправители для события.
|
|
31
|
+
*/
|
|
32
|
+
getOn(event) {
|
|
33
|
+
return this.addEvent(event).on;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Получить одноразовых отправителей для события.
|
|
37
|
+
* @param event - Имя события.
|
|
38
|
+
* @returns Одноразовые отправители для события.
|
|
39
|
+
*/
|
|
40
|
+
getOnce(event) {
|
|
41
|
+
return this.addEvent(event).once;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Получить всех отправителей для события.
|
|
45
|
+
* @param event - Имя события.
|
|
46
|
+
* @returns Отправители для события.
|
|
47
|
+
*/
|
|
48
|
+
getAll(event) {
|
|
49
|
+
const container = this.addEvent(event);
|
|
50
|
+
return [...container.on, ...container.once];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Удалить одноразовых отправителей для события.
|
|
54
|
+
* @param event - Имя события.
|
|
55
|
+
*/
|
|
56
|
+
clearOnce(event) {
|
|
57
|
+
this.addEvent(event).once = [];
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Добавить контейнер события.
|
|
61
|
+
* @param name - Имя события.
|
|
62
|
+
* @returns Добавленный контейнер.
|
|
63
|
+
*/
|
|
64
|
+
addEvent(name) {
|
|
65
|
+
var _a;
|
|
66
|
+
const container = (_a = this.containers)[name] ?? (_a[name] = { on: [], once: [] });
|
|
67
|
+
return this.containers[name] = {
|
|
68
|
+
on: container.on.filter(item => !item.isDestroyed()),
|
|
69
|
+
once: container.once.filter(item => !item.isDestroyed()),
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { EventListener, EventUnsubscribe, HasSnapshotClass } from '../../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Вызвать событие из main процесса.
|
|
4
|
+
* @param name - Имя события.
|
|
5
|
+
* @param value - Передаваемое значение.
|
|
6
|
+
*/
|
|
7
|
+
export declare function emitEvent<T = unknown>(name: string, value?: T): void;
|
|
8
|
+
/**
|
|
9
|
+
* Добавить обработчик renderer события.
|
|
10
|
+
* @param name - Имя события.
|
|
11
|
+
* @param listener - Обработчик.
|
|
12
|
+
* @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
|
|
13
|
+
* @returns Функция отписки от события.
|
|
14
|
+
*/
|
|
15
|
+
export declare function on<TValue = any>(name: string, listener: EventListener<TValue>, receives?: HasSnapshotClass<TValue>): EventUnsubscribe;
|
|
16
|
+
/**
|
|
17
|
+
* Добавить одноразовый обработчик renderer события.
|
|
18
|
+
* @param name - Имя события.
|
|
19
|
+
* @param listener - Обработчик.
|
|
20
|
+
* @param receives - Класс передаваемого значения, если оно не может быть передано стандартным способом.
|
|
21
|
+
* @returns Функция отписки от события.
|
|
22
|
+
*/
|
|
23
|
+
export declare function once<TValue = any>(name: string, listener: EventListener<TValue>, receives?: HasSnapshotClass<TValue>): EventUnsubscribe;
|
|
24
|
+
/**
|
|
25
|
+
* Опубликовать (сделать доступной) функцию из main процесса.
|
|
26
|
+
* @param name - Имя, по которому будет доступна функция в renderer процессе.
|
|
27
|
+
* @param func - Публикуемая функция.
|
|
28
|
+
* @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
|
|
29
|
+
*/
|
|
30
|
+
export declare function publishFunction<TFunc extends (...args: any[]) => any>(name: string, func: TFunc, receives?: HasSnapshotClass[]): void;
|
|
31
|
+
/**
|
|
32
|
+
* Опубликовать (сделать доступной) переменную из main процесса.
|
|
33
|
+
* @param name - Имя переменной, по которому она будет доступна в renderer процессе.
|
|
34
|
+
* @param descriptor - Дескриптор. Используется только get/set/value.
|
|
35
|
+
*/
|
|
36
|
+
export declare function publishVariable<T>(name: string, descriptor: TypedPropertyDescriptor<T>): void;
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
// Методы публикации в main процессе.
|
|
2
|
+
import { ipcMain } from 'electron';
|
|
3
|
+
import { PublishMethodsUnavailableError } from '../../errors.js';
|
|
4
|
+
import { Env, Errors, IpcChannel, IpcEventInMain, IpcResult, Transfer, WebContentsEventsContainer } from '../helpers/index.js';
|
|
5
|
+
/**
|
|
6
|
+
* Информация о сущностях.
|
|
7
|
+
*/
|
|
8
|
+
const entitiesInfo = {
|
|
9
|
+
variables: new Set(),
|
|
10
|
+
functions: new Set()
|
|
11
|
+
};
|
|
12
|
+
/**
|
|
13
|
+
* Контейнер отправителей для событий.
|
|
14
|
+
*/
|
|
15
|
+
const eventsContainer = new WebContentsEventsContainer();
|
|
16
|
+
/**
|
|
17
|
+
* Выбросить ошибку если есть причина.
|
|
18
|
+
*/
|
|
19
|
+
const canThrowError = (Env.hasWindow || !ipcMain)
|
|
20
|
+
? Errors.getThrower(PublishMethodsUnavailableError)
|
|
21
|
+
: () => { };
|
|
22
|
+
if (ipcMain) {
|
|
23
|
+
ipcMain.on(IpcChannel.publicInfo.get(), event => new IpcEventInMain(event).return(entitiesInfo));
|
|
24
|
+
ipcMain.on(IpcChannel.event.on(), (event, { value }) => eventsContainer.addOn(value, event.sender));
|
|
25
|
+
ipcMain.on(IpcChannel.event.once(), (event, { value }) => eventsContainer.addOn(value, event.sender));
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Вызвать событие из main процесса.
|
|
29
|
+
* @param name - Имя события.
|
|
30
|
+
* @param value - Передаваемое значение.
|
|
31
|
+
*/
|
|
32
|
+
export function emitEvent(name, value) {
|
|
33
|
+
canThrowError();
|
|
34
|
+
const emitChannel = IpcChannel.event.emit(name);
|
|
35
|
+
try {
|
|
36
|
+
if (value instanceof Promise) {
|
|
37
|
+
value
|
|
38
|
+
.then(val => {
|
|
39
|
+
for (const sender of eventsContainer.getAll(name)) {
|
|
40
|
+
sender.send(emitChannel, IpcResult.createWithValue(val));
|
|
41
|
+
}
|
|
42
|
+
eventsContainer.clearOnce(name);
|
|
43
|
+
})
|
|
44
|
+
.catch(reason => {
|
|
45
|
+
eventsContainer.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.createWithError(reason)));
|
|
46
|
+
eventsContainer.clearOnce(name);
|
|
47
|
+
});
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
for (const sender of eventsContainer.getAll(name)) {
|
|
51
|
+
sender.send(emitChannel, IpcResult.createWithValue(value));
|
|
52
|
+
}
|
|
53
|
+
eventsContainer.clearOnce(name);
|
|
54
|
+
}
|
|
55
|
+
catch (error) {
|
|
56
|
+
eventsContainer.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.createWithError(error)));
|
|
57
|
+
eventsContainer.clearOnce(name);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Добавить обработчик renderer события.
|
|
62
|
+
* @param name - Имя события.
|
|
63
|
+
* @param listener - Обработчик.
|
|
64
|
+
* @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
|
|
65
|
+
* @returns Функция отписки от события.
|
|
66
|
+
*/
|
|
67
|
+
export function on(name, listener, receives) {
|
|
68
|
+
canThrowError();
|
|
69
|
+
const emitChannel = IpcChannel.event.emit(name);
|
|
70
|
+
const handler = (_, { value }) => {
|
|
71
|
+
if (Transfer.isSnapshotValue(value) && receives) {
|
|
72
|
+
listener(Transfer.getFromSnapshot(value, receives));
|
|
73
|
+
}
|
|
74
|
+
else {
|
|
75
|
+
listener(value);
|
|
76
|
+
}
|
|
77
|
+
};
|
|
78
|
+
ipcMain.on(emitChannel, handler);
|
|
79
|
+
return () => ipcMain.removeListener(emitChannel, handler);
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Добавить одноразовый обработчик renderer события.
|
|
83
|
+
* @param name - Имя события.
|
|
84
|
+
* @param listener - Обработчик.
|
|
85
|
+
* @param receives - Класс передаваемого значения, если оно не может быть передано стандартным способом.
|
|
86
|
+
* @returns Функция отписки от события.
|
|
87
|
+
*/
|
|
88
|
+
export function once(name, listener, receives) {
|
|
89
|
+
canThrowError();
|
|
90
|
+
const emitChannel = IpcChannel.event.emit(name);
|
|
91
|
+
const handler = (_, { value }) => {
|
|
92
|
+
if (Transfer.isSnapshotValue(value) && receives) {
|
|
93
|
+
listener(Transfer.getFromSnapshot(value, receives));
|
|
94
|
+
}
|
|
95
|
+
else {
|
|
96
|
+
listener(value);
|
|
97
|
+
}
|
|
98
|
+
};
|
|
99
|
+
ipcMain.once(emitChannel, handler);
|
|
100
|
+
return () => ipcMain.removeListener(emitChannel, handler);
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Опубликовать (сделать доступной) функцию из main процесса.
|
|
104
|
+
* @param name - Имя, по которому будет доступна функция в renderer процессе.
|
|
105
|
+
* @param func - Публикуемая функция.
|
|
106
|
+
* @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
|
|
107
|
+
*/
|
|
108
|
+
export function publishFunction(name, func, receives = []) {
|
|
109
|
+
canThrowError();
|
|
110
|
+
const channel = IpcChannel.func.call(name);
|
|
111
|
+
entitiesInfo.functions.add(name);
|
|
112
|
+
ipcMain.removeAllListeners(channel);
|
|
113
|
+
ipcMain.on(channel, (e, { args, id }) => {
|
|
114
|
+
const event = new IpcEventInMain(e);
|
|
115
|
+
const receivesCopy = [...receives];
|
|
116
|
+
try {
|
|
117
|
+
const preparedArgs = args.map(arg => (Transfer.isSnapshotValue(arg) && receivesCopy[0]
|
|
118
|
+
? Transfer.getFromSnapshot(arg, receivesCopy.shift())
|
|
119
|
+
: arg));
|
|
120
|
+
const result = func(...preparedArgs);
|
|
121
|
+
if (result instanceof Promise) {
|
|
122
|
+
const promiseChannel = IpcChannel.promise.get(channel);
|
|
123
|
+
result
|
|
124
|
+
.then(value => event.send(promiseChannel, IpcResult.createWithValue(value, id)))
|
|
125
|
+
.catch(reason => event.send(promiseChannel, IpcResult.createWithError(reason, id)));
|
|
126
|
+
event.return(IpcResult.createWithPromise(promiseChannel));
|
|
127
|
+
}
|
|
128
|
+
else {
|
|
129
|
+
event.return(IpcResult.createWithValue(result));
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
catch (error) {
|
|
133
|
+
event.return(IpcResult.createWithError(error));
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* Опубликовать (сделать доступной) переменную из main процесса.
|
|
139
|
+
* @param name - Имя переменной, по которому она будет доступна в renderer процессе.
|
|
140
|
+
* @param descriptor - Дескриптор. Используется только get/set/value.
|
|
141
|
+
*/
|
|
142
|
+
export function publishVariable(name, descriptor) {
|
|
143
|
+
canThrowError();
|
|
144
|
+
const getChannel = IpcChannel.prop.get(name);
|
|
145
|
+
const setChannel = IpcChannel.prop.set(name);
|
|
146
|
+
const { set: setter, value } = descriptor;
|
|
147
|
+
let { get: getter } = descriptor;
|
|
148
|
+
entitiesInfo.variables.add(name);
|
|
149
|
+
if (value) {
|
|
150
|
+
getter = () => value;
|
|
151
|
+
}
|
|
152
|
+
if (getter) {
|
|
153
|
+
ipcMain.removeAllListeners(getChannel);
|
|
154
|
+
ipcMain.on(getChannel, e => {
|
|
155
|
+
const event = new IpcEventInMain(e);
|
|
156
|
+
try {
|
|
157
|
+
event.return(IpcResult.createWithValue(getter()));
|
|
158
|
+
}
|
|
159
|
+
catch (error) {
|
|
160
|
+
event.return(IpcResult.createWithError(error));
|
|
161
|
+
}
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
if (setter) {
|
|
165
|
+
ipcMain.removeAllListeners(setChannel);
|
|
166
|
+
ipcMain.on(setChannel, (e, { args }) => {
|
|
167
|
+
const event = new IpcEventInMain(e);
|
|
168
|
+
try {
|
|
169
|
+
setter(args.at(0));
|
|
170
|
+
event.return(IpcResult.createWithValue(null));
|
|
171
|
+
}
|
|
172
|
+
catch (error) {
|
|
173
|
+
event.return(IpcResult.createWithError(error));
|
|
174
|
+
}
|
|
175
|
+
});
|
|
176
|
+
}
|
|
177
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { EventListener, EventUnsubscribe, IBridge, IResult } from '../../types.js';
|
|
2
|
+
import BaseBridge from '../base-bridge.js';
|
|
3
|
+
/**
|
|
4
|
+
* Мост preload-main.
|
|
5
|
+
*/
|
|
6
|
+
export declare class PreloadBridge extends BaseBridge {
|
|
7
|
+
protected readonly entitiesInfo: any;
|
|
8
|
+
/**
|
|
9
|
+
* Создать мост preload-main.
|
|
10
|
+
*/
|
|
11
|
+
constructor();
|
|
12
|
+
protected callFunction(name: string, secret: string, args: any[]): IResult;
|
|
13
|
+
protected getVariable(name: string): IResult;
|
|
14
|
+
protected setVariable(name: string, value: any): IResult;
|
|
15
|
+
protected waitPromise(channel: string, id?: string): Promise<any>;
|
|
16
|
+
protected handleEvent(name: string, type: 'on' | 'once', listener: EventListener<IResult>): EventUnsubscribe;
|
|
17
|
+
protected emitEvent(name: string, value: any): void;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Получить мост preload-main.
|
|
21
|
+
*/
|
|
22
|
+
export declare function getBridge(): IBridge;
|
|
23
|
+
/**
|
|
24
|
+
* Мост preload-main.
|
|
25
|
+
*/
|
|
26
|
+
declare const _default: IBridge;
|
|
27
|
+
export default _default;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { ipcRenderer } from 'electron';
|
|
2
|
+
import { NotProvidedFromMainError, TryUseBridgeInMainError } from '../../errors.js';
|
|
3
|
+
import BaseBridge from '../base-bridge.js';
|
|
4
|
+
import { Errors, IpcChannel, Transfer } from '../helpers/index.js';
|
|
5
|
+
import IPCTunnel from '../renderer/tunnels.js';
|
|
6
|
+
/**
|
|
7
|
+
* Мост preload-main.
|
|
8
|
+
*/
|
|
9
|
+
export class PreloadBridge extends BaseBridge {
|
|
10
|
+
/**
|
|
11
|
+
* Создать мост preload-main.
|
|
12
|
+
*/
|
|
13
|
+
constructor() {
|
|
14
|
+
super();
|
|
15
|
+
this.entitiesInfo = ipcRenderer.sendSync(IpcChannel.publicInfo.get());
|
|
16
|
+
if (!this.entitiesInfo) {
|
|
17
|
+
throw new NotProvidedFromMainError();
|
|
18
|
+
}
|
|
19
|
+
this.init();
|
|
20
|
+
}
|
|
21
|
+
callFunction(name, secret, args) {
|
|
22
|
+
return new IPCTunnel.Function(name).call({ args, id: secret });
|
|
23
|
+
}
|
|
24
|
+
getVariable(name) {
|
|
25
|
+
return new IPCTunnel.Variable(name).get();
|
|
26
|
+
}
|
|
27
|
+
setVariable(name, value) {
|
|
28
|
+
return new IPCTunnel.Variable(name).set(value);
|
|
29
|
+
}
|
|
30
|
+
async waitPromise(channel, id) {
|
|
31
|
+
return await new IPCTunnel.Promise(channel).wait(id);
|
|
32
|
+
}
|
|
33
|
+
handleEvent(name, type, listener) {
|
|
34
|
+
const tunnel = new IPCTunnel.Event(name);
|
|
35
|
+
return type === 'on'
|
|
36
|
+
? tunnel.on(listener)
|
|
37
|
+
: tunnel.once(listener);
|
|
38
|
+
}
|
|
39
|
+
emitEvent(name, value) {
|
|
40
|
+
const tunnel = new IPCTunnel.Event(name);
|
|
41
|
+
if (value instanceof Promise) {
|
|
42
|
+
value
|
|
43
|
+
.then(val => tunnel.emit(Transfer.toTransferable(val)))
|
|
44
|
+
.catch(reason => tunnel.error(String(reason)));
|
|
45
|
+
}
|
|
46
|
+
else {
|
|
47
|
+
tunnel.emit(value);
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Получить функцию бросающую исключение если есть повод.
|
|
53
|
+
*/
|
|
54
|
+
function getErrorThrower() {
|
|
55
|
+
if (!ipcRenderer) {
|
|
56
|
+
return Errors.getThrower(TryUseBridgeInMainError);
|
|
57
|
+
}
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Получить мост preload-main.
|
|
62
|
+
*/
|
|
63
|
+
export function getBridge() {
|
|
64
|
+
const throwError = getErrorThrower();
|
|
65
|
+
if (throwError) {
|
|
66
|
+
return new Proxy({}, {
|
|
67
|
+
get: throwError,
|
|
68
|
+
set: throwError,
|
|
69
|
+
apply: throwError
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
return new PreloadBridge();
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Мост preload-main.
|
|
76
|
+
*/
|
|
77
|
+
export default getBridge();
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { contextBridge, ipcRenderer } from 'electron';
|
|
2
|
+
import { NotProvidedFromMainError, TryProvideInMainError, TryProvideInRendererError } from '../../errors.js';
|
|
3
|
+
import { Errors, IpcChannel, Transfer } from '../helpers/index.js';
|
|
4
|
+
import IPCTunnel from '../renderer/tunnels.js';
|
|
5
|
+
/**
|
|
6
|
+
* Бросить ошибку если есть повод.
|
|
7
|
+
*/
|
|
8
|
+
let throwPossibleError = () => { };
|
|
9
|
+
if (!ipcRenderer) {
|
|
10
|
+
throwPossibleError = Errors.getThrower(TryProvideInMainError);
|
|
11
|
+
}
|
|
12
|
+
else if (!contextBridge) {
|
|
13
|
+
throwPossibleError = Errors.getThrower(TryProvideInRendererError);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Добавляет необходимые для работы функции.
|
|
17
|
+
*
|
|
18
|
+
* @param contextIsolation - Изоляция контекста. _По умолчанию_: `true`
|
|
19
|
+
*/
|
|
20
|
+
function provideFromMain(contextIsolation = true) {
|
|
21
|
+
throwPossibleError();
|
|
22
|
+
const entitiesInfo = ipcRenderer.sendSync(IpcChannel.publicInfo.get());
|
|
23
|
+
if (!entitiesInfo) {
|
|
24
|
+
throw new NotProvidedFromMainError();
|
|
25
|
+
}
|
|
26
|
+
const provider = {
|
|
27
|
+
getEntitiesInfo: () => entitiesInfo,
|
|
28
|
+
waitPromise: (channel, resolve, reject, id) => (new IPCTunnel.Promise(channel).wait(id)
|
|
29
|
+
.then(resolve)
|
|
30
|
+
.catch(reject)),
|
|
31
|
+
entities: {
|
|
32
|
+
functions: getFunctions(),
|
|
33
|
+
variables: getVariables(),
|
|
34
|
+
events: {
|
|
35
|
+
emit: (name, value) => {
|
|
36
|
+
const tunnel = new IPCTunnel.Event(name);
|
|
37
|
+
if (value instanceof Promise) {
|
|
38
|
+
value
|
|
39
|
+
.then(val => tunnel.emit(Transfer.toTransferable(val)))
|
|
40
|
+
.catch(reason => tunnel.error(String(reason)));
|
|
41
|
+
}
|
|
42
|
+
else {
|
|
43
|
+
tunnel.emit(value);
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
on: (name, listener) => new IPCTunnel.Event(name).on(listener),
|
|
47
|
+
once: (name, listener) => new IPCTunnel.Event(name).once(listener)
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
if (contextIsolation) {
|
|
52
|
+
contextBridge.exposeInMainWorld('__provider__', provider);
|
|
53
|
+
}
|
|
54
|
+
else {
|
|
55
|
+
window.__provider__ = provider;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Получить доступ к публичным функциям.
|
|
59
|
+
*/
|
|
60
|
+
function getFunctions() {
|
|
61
|
+
const result = {};
|
|
62
|
+
for (const name of entitiesInfo.functions) {
|
|
63
|
+
result[name] = (id, args) => {
|
|
64
|
+
return new IPCTunnel.Function(name).call({ args, id: id });
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
return result;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Получить доступ к публичным переменным.
|
|
71
|
+
*/
|
|
72
|
+
function getVariables() {
|
|
73
|
+
const result = {};
|
|
74
|
+
for (const name of entitiesInfo.variables) {
|
|
75
|
+
const tunnel = new IPCTunnel.Variable(name);
|
|
76
|
+
result[name] = {
|
|
77
|
+
get: () => tunnel.get(),
|
|
78
|
+
set: (value) => tunnel.set(value)
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
return result;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
export default provideFromMain;
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { GlobalProviderNotFoundError, NotProvidedFromMainError, WrongBridgeInPreloadError } from '../../errors.js';
|
|
2
|
+
import { Env, Errors } from '../helpers/index.js';
|
|
3
|
+
import BaseBridge from '../base-bridge.js';
|
|
4
|
+
/**
|
|
5
|
+
* Мост renderer-main.
|
|
6
|
+
*/
|
|
7
|
+
class RendererBridge extends BaseBridge {
|
|
8
|
+
constructor() {
|
|
9
|
+
super();
|
|
10
|
+
if (!Env.hasProvider) {
|
|
11
|
+
throw new NotProvidedFromMainError();
|
|
12
|
+
}
|
|
13
|
+
this.globalProvider = window.__provider__;
|
|
14
|
+
this.entitiesInfo = this.globalProvider.getEntitiesInfo();
|
|
15
|
+
this.init();
|
|
16
|
+
}
|
|
17
|
+
callFunction(name, id, args) {
|
|
18
|
+
return this.globalProvider.entities.functions[name](id, args);
|
|
19
|
+
}
|
|
20
|
+
getVariable(name) {
|
|
21
|
+
return this.globalProvider.entities.variables[name].get();
|
|
22
|
+
}
|
|
23
|
+
setVariable(name, value) {
|
|
24
|
+
return this.globalProvider.entities.variables[name].set(value);
|
|
25
|
+
}
|
|
26
|
+
waitPromise(channel, id) {
|
|
27
|
+
return new Promise((resolve, reject) => {
|
|
28
|
+
this.globalProvider.waitPromise(channel, resolve, reject, id);
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
handleEvent(name, type, listener) {
|
|
32
|
+
return type === 'on'
|
|
33
|
+
? this.globalProvider.entities.events.on(name, listener)
|
|
34
|
+
: this.globalProvider.entities.events.once(name, listener);
|
|
35
|
+
}
|
|
36
|
+
emitEvent(name, value) {
|
|
37
|
+
this.globalProvider.entities.events.emit(name, value);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Получить функцию, бросающую исключение, если есть повод.
|
|
42
|
+
*/
|
|
43
|
+
function getErrorThrower() {
|
|
44
|
+
if (!Env.hasWindow) {
|
|
45
|
+
return Errors.getThrower(WrongBridgeInPreloadError);
|
|
46
|
+
}
|
|
47
|
+
if (!Env.hasProvider) {
|
|
48
|
+
return Errors.getThrower(GlobalProviderNotFoundError);
|
|
49
|
+
}
|
|
50
|
+
return null;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Получить мост renderer-main.
|
|
54
|
+
*/
|
|
55
|
+
function getBridge() {
|
|
56
|
+
const throwError = getErrorThrower();
|
|
57
|
+
if (throwError) {
|
|
58
|
+
return new Proxy({}, {
|
|
59
|
+
get: throwError,
|
|
60
|
+
set: throwError,
|
|
61
|
+
apply: throwError
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
return new RendererBridge();
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Мост renderer-main.
|
|
68
|
+
*/
|
|
69
|
+
export default getBridge();
|